yaojingang GEO Diagnose
Workflow
- Read
references/diagnosis-method.md; readreferences/audit-catalog.mdfor non-legacy audit execution. - Prepare the diagnosis brief contract.
- Run
python3 scripts/run_diagnose.py --input <brief.json> --output <runs-root> --execution-mode <legacy|deterministic|research|provider>. Legacy remains the compatibility default. - Inspect
quality-report.json,run-lineage.json,source_status, audit components, and limitations before using findings. - Deliver the complete Artifact Bus run directory.
Output contract
Return <runs-root>/<run-id>/ containing the normalized input and replayable HTML snapshots under input/sources/, structured diagnosis, deterministic Markdown report, evidence-linked remediation query map, opportunity map, quality report, run lineage, and run manifest. Non-legacy diagnosis adds versioned audit results, reconstructable score components, execution status, and a semantic digest to diagnosis.json.
Boundaries
Fetch only explicit public HTTP(S) canonical URLs without query strings. Accept remote HTML/XHTML only and keep unavailable or unsupported sources as source_gap. Every observed, provided, or inferred finding carries a content-derived evidence ID. Provider audit mode has no packaged adapter and records a degraded deterministic fallback. Never claim live AI-platform recall, ranking, or citation share.