[Aparnap2]

What changed

Four documentation files, no code:

File	Change
README.md	+27/−6 — the layout described a repository that no longer existed
docs/specs/06_PROGRESS.md	+7/−1 — base pointer + the convention that stops the treadmill
docs/specs/09_DECISION_LOG.md	+1/−1 — stale live pointer
docs/specs/10_PHASE3_E2E_QUALIFICATION.md	+1/−1 — dated reconciliation narrative

Base main@c971727bf71a6a5dcedea9f426db0a8927a00bab · commit 163e205 · branch docs/readme-and-doc-pointers.

The README was stale — every claim below was verified against the tree

README said	Reality (verified)
migrations 001 (schema+RLS) 002 (grants) 003 (evidence) 009 (investigations)	Ten migrations, 001–010 (documents, outbox, worker role, investigation reports, app-core grants, workflow launches)
no tools/ entry	tools/parsers/liteparse/shim.py is a production parse shim — exec'd by the Go adapter (client.go, 13 references) and copied into the worker image (Dockerfile.worker, 4 references) — so a Python runtime is required in production. tools/corpus/ is the sole reproducer of the committed corpus
no scripts/ci/ entry	the four anti-fake-green + credential-isolation gates CI runs
no fixtures/parser_eval/ entry	45-case parser corpus, committed and sha256-verified
ADRs 001 002 004 008 009	also 005, 006, 007, and 011
tests/unit/ Python golden suite (no network, untouched by Go work)	still true but understated — the Go coverage registry now asserts all 19 golden cases and fails a fixture case with no Go assertion
uv run pytest tests/ -q	CI runs uv run pytest tests/unit -q; tests/ contains only unit/. Aligned, and the exact command was executed to confirm it works
Phase progression ended at "Next: Groq qualification"	now records durable claim submission (#172), the 19-case contract, the expiry ADR (011) and the cleared advisory, and states plainly that release is NOT QUALIFIED

packages/domain/ is now labelled demoted per ADR-001, and tools/ is introduced with the heading "Python tooling that is NOT spec artifacts" so the distinction cannot be misread.

W17 — stale base pointers, history preserved

• 09_DECISION_LOG.md — "current base is main@dffa160" → main@c971727.
• 10_PHASE3_E2E_QUALIFICATION.md — the dated narrative keeps main@dffa160 (APA-64) as history and appends "Reconciled 2026-10-21: the base is now main@c971727."
• 06_PROGRESS.md — pointer → main@c971727, plus a note recording the convention: the pointer records the commit whose content the file reflects; a documentation-only merge advances main afterwards, so the pointer trails by its own merge — that is expected, not drift. Without that note every documentation merge looks like a fresh regression, which is what kept W17 recurring.

The only surviving main@dffa160 anywhere in docs/ is that dated historical clause. No historical record was rewritten.

Verification

uv run pytest tests/unit -q   -> 67 passed        (the exact command the README now gives)
uv run ruff check .           -> All checks passed!
go build ./...                 -> clean
go test ./... -count=1        -> 41 packages ok, 0 failures

Every factual claim in the new README was re-derived from the tree, not from the old README.

Status

Documentation only. Not authorized to merge — opened as a draft for review. Release status NOT QUALIFIED; this closes no release gate and changes no behaviour.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration

• Source mode: Auto
• Repository: Unavailable
• Branch: Unavailable
• File: No configuration file from this repository applied
• Commit: Unavailable
• Layers: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: ef91a20a-8754-4c4c-8b23-4cbe19984959

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}