Skip to content

docs: doc-claim drift detected on 2026-07-27 - #20

Open
NickCrew wants to merge 1 commit into
mainfrom
docs/drift-2026-07-27
Open

docs: doc-claim drift detected on 2026-07-27#20
NickCrew wants to merge 1 commit into
mainfrom
docs/drift-2026-07-27

Conversation

@NickCrew

Copy link
Copy Markdown
Collaborator

Summary

Automated doc-drift audit of the 12 active doc files on 2026-07-27. Found 23 drift findings across 8 files — no source code was modified. Findings are filed in backlog/tasks/task-18 - Doc-drift-detected-2026-07-27.md for human resolution.

Severity breakdown:

  • 13 P1 — dev-doc errors (wrong claim, will mislead a contributor)
  • 10 P2 — minor staleness (stale paths, internal inconsistencies, broken links)

Top P1 findings:

File Finding
docs/architecture.md:165, docs/developer-guide.md:47, README.md:48, AGENTS.md:95, docs/dockerhub-overview.md:22 DEMO_MODE default documented as strict or trueapp/config.py:31 defaults to 'full'
AGENTS.md:116 "nginx handles the proxy in production" — no nginx in any Dockerfile; uvicorn serves everything
apps/vuln-api/AGENTS.md:6 Claims tests/vulnerability/ and tests/smoke/ subdirs exist — neither does
apps/vuln-api/tests/README.md:66-76 Claims tests/vulnerability/ dir with 4 test files — does not exist
apps/vuln-api/tests/README.md:214 Coverage minimum listed as 90% — justfile enforces 80%
docs/endpoints-catalog.md:15,600 just docs-drift recipe doesn't exist; "469 endpoints" vs "243 Total Routes" internal inconsistency

Backlog task: backlog/tasks/task-18 - Doc-drift-detected-2026-07-27.md — 23 acceptance-criteria checkboxes, one per finding.


Generated by Claude Code

Automated doc-claim audit of 12 active doc files. Found 23 drift
findings across 8 files (13 P1 dev-doc errors, 10 P2 minor staleness).
Filed as TASK-18 in backlog/tasks/.

Co-Authored-By: Claude Code <noreply@anthropic.com>

Copy link
Copy Markdown
Collaborator Author

CI red on Test Backend — pre-existing failure on main, not caused by this PR.

This PR adds a single markdown file (backlog/tasks/task-18 - Doc-drift-detected-2026-07-27.md) and touches no Python, tests, or build config.

The failing check:

  • FAILED tests/unit/test_checkout_routes.py::test_checkout_methods_lists_available_payment_methods — assert 500 == 200
  • Overall coverage: 66% (below the 80% threshold in justfile:48)

The most recent push to main (run #35, commit 07fb2e8, June 9) also concluded as failure with the same CI workflow — this is a pre-existing regression on the base branch, not introduced here.

Will re-run CI once the base branch recovers.


Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant