docs-drift 0.1.0__py3-none-any.whl

docs_drift/web/examples/judge-fixture.json

@@ -0,0 +1,226 @@
+{
+  "schema_version": 1,
+  "package_version": "0.1.0.dev7+gd6e96eb92.d20261018",
+  "repo_path": "judge-fixture",
+  "head_sha": "66f495fa2e34b38bf32b8351447339d77739a7a5",
+  "scan_time": "2026-10-02T09:00:00Z",
+  "config_used": {
+    "docs": [
+      "README.md",
+      "docs/**/*.md",
+      "*.md"
+    ],
+    "exclude": [
+      "node_modules/**",
+      ".venv/**",
+      "vendor/**",
+      "CHANGELOG.md",
+      "**/CHANGELOG.md"
+    ],
+    "languages": "auto",
+    "ignore": [],
+    "min_confidence": 0.6,
+    "llm": {
+      "enabled": false,
+      "model": null,
+      "max_claims": 40,
+      "concurrency": 4,
+      "timeout": 60.0,
+      "budget": 0.5,
+      "redact_paths": []
+    },
+    "history": {
+      "max_commits": 2000,
+      "show_emails": false
+    }
+  },
+  "docs": [
+    {
+      "path": "README.md",
+      "content_hash": "892b6597b6b082904b26163e9fd7347ce720020c645b159e8d9c9abae35b807e",
+      "format": "markdown"
+    }
+  ],
+  "sections": [
+    {
+      "section_id": "section_0a7347ab74c8690afd4f53f0ac362a559981d421fbc1be7c0dc4fb9c42108008",
+      "doc_path": "README.md",
+      "heading": "Synthetic CLI fixture",
+      "heading_level": 1,
+      "heading_path": [
+        "Synthetic CLI fixture"
+      ],
+      "start_line": 1,
+      "end_line": 3,
+      "context": "current",
+      "historical_spans": []
+    }
+  ],
+  "claims": [
+    {
+      "claim_id": "claim_04babea50df488dbdb661aecf025c9e472cb08ec92ecb56a563af15e1c2252a6",
+      "kind": "cli_flag",
+      "raw_text": "--port",
+      "value": "--port",
+      "qualifier": null,
+      "expected_default": null,
+      "doc_path": "README.md",
+      "line": 3,
+      "column": 5,
+      "section_id": "section_0a7347ab74c8690afd4f53f0ac362a559981d421fbc1be7c0dc4fb9c42108008",
+      "extraction": "inline_code",
+      "extraction_confidence": 0.9,
+      "locations": [
+        {
+          "line": 3,
+          "column": 5,
+          "raw_text": "--port",
+          "extraction": "inline_code"
+        }
+      ],
+      "extraction_sources": [
+        "inline_code"
+      ],
+      "group_key": "38d0b0f2836bee9baca4f6bcfc6fe61622b4764c5b1b5789af6518fb0e760fb5"
+    }
+  ],
+  "symbols": [
+    {
+      "symbol_id": "symbol_d68f6f2b6102e2db0355b3d6f7e0df36bf541a225121e61cb7429282ef7d38bd",
+      "kind": "cli_flag",
+      "name": "--listen",
+      "qualified_name": "cli.root.--listen",
+      "aliases": [],
+      "default": null,
+      "file": "cli.py",
+      "line": 4,
+      "language": "python",
+      "framework": "argparse",
+      "parent_id": null,
+      "exported": false,
+      "decorators": [],
+      "derived": false,
+      "setting_group": null,
+      "authoritative": true,
+      "raw_path": null,
+      "handler": null,
+      "partial_prefix": false,
+      "ts_type": false
+    }
+  ],
+  "findings": [
+    {
+      "claim": {
+        "claim_id": "claim_04babea50df488dbdb661aecf025c9e472cb08ec92ecb56a563af15e1c2252a6",
+        "kind": "cli_flag",
+        "raw_text": "--port",
+        "value": "--port",
+        "qualifier": null,
+        "expected_default": null,
+        "doc_path": "README.md",
+        "line": 3,
+        "column": 5,
+        "section_id": "section_0a7347ab74c8690afd4f53f0ac362a559981d421fbc1be7c0dc4fb9c42108008",
+        "extraction": "inline_code",
+        "extraction_confidence": 0.9,
+        "locations": [
+          {
+            "line": 3,
+            "column": 5,
+            "raw_text": "--port",
+            "extraction": "inline_code"
+          }
+        ],
+        "extraction_sources": [
+          "inline_code"
+        ],
+        "group_key": "38d0b0f2836bee9baca4f6bcfc6fe61622b4764c5b1b5789af6518fb0e760fb5"
+      },
+      "matched_symbol": {
+        "symbol_id": "symbol_d68f6f2b6102e2db0355b3d6f7e0df36bf541a225121e61cb7429282ef7d38bd",
+        "kind": "cli_flag",
+        "name": "--listen",
+        "qualified_name": "cli.root.--listen",
+        "aliases": [],
+        "default": null,
+        "file": "cli.py",
+        "line": 4,
+        "language": "python",
+        "framework": "argparse",
+        "parent_id": null,
+        "exported": false,
+        "decorators": [],
+        "derived": false,
+        "setting_group": null,
+        "authoritative": true,
+        "raw_path": null,
+        "handler": null,
+        "partial_prefix": false,
+        "ts_type": false
+      },
+      "verdict": "renamed",
+      "suggestion": "--listen",
+      "evidence": [
+        {
+          "file": "README.md",
+          "line": 3,
+          "text": "--port",
+          "end_line": null
+        },
+        {
+          "file": "cli.py",
+          "line": 1,
+          "text": "import argparse\n\nparser = argparse.ArgumentParser()\nparser.add_argument(\"--listen\", type=int)\n",
+          "end_line": null
+        },
+        {
+          "file": "cli.py",
+          "line": 1,
+          "text": "-parser.add_argument(\"--port\", type=int)\n+parser.add_argument(\"--listen\", type=int)",
+          "end_line": null
+        }
+      ],
+      "introduced_by": {
+        "sha": "66f495fa2e34b38bf32b8351447339d77739a7a5",
+        "short_sha": "66f495f",
+        "author_name": "Priya Shah",
+        "author_email": null,
+        "date": "2026-10-02T09:00:00Z",
+        "summary": "Rename port to listen without updating README"
+      },
+      "confidence": 0.92,
+      "reasons": [
+        "No indexed cli_flag named --port was found. Closest indexed candidates: --listen (cli.py:4).",
+        "Git history confirms this name changed to --listen.",
+        "Git history changed this name in 66f495f."
+      ],
+      "decided_by": "rules",
+      "replayed": false,
+      "package": "judge-fixture",
+      "doc_text": "Use `--port` to select the listening port."
+    }
+  ],
+  "timings": {
+    "docs": 0.26383970002643764,
+    "index": 0.12528340000426397,
+    "match": 0.2292884000344202,
+    "history": 0.2897374000167474
+  },
+  "warnings": [
+    "SYNTHETIC FIXTURE / precomputed static scan. One intentionally stale claim; not a real-world accuracy result. Review the proposed replacement before editing. Rebuild and inspect the two commits with scripts/build_judge_demo.py."
+  ],
+  "suppressed": [],
+  "historical_ignored": 0,
+  "llm_usage": {},
+  "packages": [
+    {
+      "name": "judge-fixture",
+      "root": ".",
+      "language": "unknown",
+      "commands": []
+    }
+  ],
+  "docs_repo_path": null,
+  "remote_url": null,
+  "baselined": 0
+}

docs_drift/web/examples/manifest.json

@@ -0,0 +1,89 @@
+[
+  {
+    "scan_id": "example-judge",
+    "name": "One stale claim (synthetic fixture)",
+    "repo_url": "synthetic:judge-fixture",
+    "file": "judge-fixture.json",
+    "kind": "fixture",
+    "verified": false,
+    "note": "SYNTHETIC FIXTURE / precomputed static scan. One intentionally stale claim; not a real-world accuracy result. Review the proposed replacement before editing. Rebuild and inspect the two commits with scripts/build_judge_demo.py."
+  },
+  {
+    "scan_id": "example-rich-cli-reviewed",
+    "name": "rich-cli reviewed case",
+    "repo_url": "https://github.com/Textualize/rich-cli",
+    "file": "rich-cli-reviewed.json",
+    "kind": "public",
+    "sha": "46f4d2469097be395558768714a5f07ebccf1412",
+    "verified": false,
+    "reviewer": "Codex (agent-assisted; not independent human labels)",
+    "note": "Two runtime-reproduced option defects; see /case-study. Precomputed snapshot.",
+    "verified_values": [
+      "--line-number",
+      "--p"
+    ]
+  },
+  {
+    "scan_id": "example-py-cli",
+    "name": "py-cli demo",
+    "repo_url": "https://github.com/docs-drift/py-cli-demo",
+    "file": "py-cli.json",
+    "kind": "fixture",
+    "verified": true,
+    "note": "Synthetic fixture with a deterministic Git history."
+  },
+  {
+    "scan_id": "example-fastapi-svc",
+    "name": "fastapi-svc demo",
+    "repo_url": "https://github.com/docs-drift/fastapi-svc-demo",
+    "file": "fastapi-svc.json",
+    "kind": "fixture",
+    "verified": true,
+    "note": "Synthetic fixture with a deterministic Git history."
+  },
+  {
+    "scan_id": "example-node-tool",
+    "name": "node-tool demo",
+    "repo_url": "https://github.com/docs-drift/node-tool-demo",
+    "file": "node-tool.json",
+    "kind": "fixture",
+    "verified": true,
+    "note": "Synthetic fixture with a deterministic Git history."
+  },
+  {
+    "scan_id": "example-clean-repo",
+    "name": "clean-repo demo",
+    "repo_url": "https://github.com/docs-drift/clean-repo-demo",
+    "file": "clean-repo.json",
+    "kind": "fixture",
+    "verified": true,
+    "note": "Synthetic fixture with a deterministic Git history."
+  },
+  {
+    "scan_id": "example-rich-cli",
+    "name": "rich-cli",
+    "repo_url": "https://github.com/textualize/rich-cli",
+    "file": "rich-cli.json",
+    "kind": "public",
+    "sha": "46f4d2469097be395558768714a5f07ebccf1412",
+    "verified": true,
+    "note": "Manually checked README.md:61 (--line-number) against src/rich_cli/__main__.py:358 (--line-numbers), and README.md:180 (--p) against the --print/-p declaration. Other static findings are not manually certified.",
+    "verified_values": [
+      "--line-number",
+      "--p"
+    ]
+  },
+  {
+    "scan_id": "example-files-to-prompt",
+    "name": "files-to-prompt \u00b7 historical",
+    "repo_url": "https://github.com/simonw/files-to-prompt",
+    "file": "files-to-prompt.json",
+    "kind": "public",
+    "sha": "ae06f2039f3a1dc1c9f3b4657fb51459490768f2",
+    "verified": true,
+    "note": "Historical snapshot, intentionally pinned before the upstream fix: README.md:55 says c/--cxml; files_to_prompt/cli.py declares -c/--cxml. Fixed upstream by f7cf729babc92604b9cd06c3d9cad32daff0f276. Other findings may reflect scanner limitations, not real defects.",
+    "verified_values": [
+      "c/--cxml"
+    ]
+  }
+]