docs(audit): remove dated point-in-time receipts; receipts no longer tracked - #100
Open
docxology wants to merge 2 commits into
Open
docs(audit): remove dated point-in-time receipts; receipts no longer tracked#100docxology wants to merge 2 commits into
docxology wants to merge 2 commits into
Conversation
…tracked
Delete the August/September transient report documents (REVIEW_LOG_*,
REVIEW_2026-09-*, BACKLOG-CLOSURE-*, AUDIT_2026-08-30*, PROJECT_STATE_REPORT_*,
_FLEET_REPORT_*, executable-bundle offline receipt) from docs/audit/ and the
tracked root REVIEW_LOG_2026-08-31.md; they remain recoverable from git
history. Rewrite docs/audit/{README,AGENTS}.md for the receipt-free contract
(only the regenerable filepath audit report is tracked), cut over the live
references (STATUS.md render row, START_HERE.md wall-clock note,
docs/maintenance/software-heritage-archival.md census pointer, two CHANGELOG
links now inline-code), and regenerate docs/_generated/status_evidence.json
and docs/audit/filepath-audit-report.md.
…nerated facts
Deep-dive accuracy pass over every doc surface, driven by five read-only
audit lenses (root entry docs, docs/{core,guides,development,maintenance},
docs/{operational,reference,security,plans,prompts}, Layer-1 directory docs,
and all 24 exemplar trees) cross-checked against disk, ci.yml, and
pipeline.yaml:
- Stale pre-split src paths corrected across ~50 hand-authored files:
docs/guides (testing-and-reproducibility walkthrough rebased on live
modules, figures-and-analysis, extending-and-automation,
new-project-one-shot-prompt, fork-an-exemplar +5 missing exemplars),
docs/reference (api-project-modules, quick-start-cheatsheet),
docs/operational (build-performance, benchmarking-guide,
performance-optimization function_profiler repoint), docs/prompts
(test-creation), docs/rules (type_hints_standards core/testing path), and
the template_code_project, search_project, prose_project,
pools_rules_tools, methods_paper, madlib, sia, eda_notebook,
autoresearch_project exemplar docs (full nested src/<pkg>/ convention,
re-export surfaces repointed at the nested package __init__, ISA
historical cross-refs annotated).
- Layer-1 docs reconciled: ci.yml is 19 jobs (ci-gate + test-infra-slow +
test-integration rows added), pipeline is 17 stages / stage_00...stage_13,
25-package literal dropped in favor of docs/_generated/COUNTS.md,
project coverage '100%' -> '>= 90%', infrastructure SKILL.md index
completed (10 missing rows), flat core/testing paths and infra_tests
subpackage lists fixed, core/AGENTS.md shim paragraph rewritten to
fail-fast wording.
- Root docs: TO-DO.md six landed rows removed with evidence recorded in
CHANGELOG [Unreleased] (shim cutoffs, cache-gate logging, stage-01 CLI
policy, doc-module-ref gate, T20 print ban); TEST-ISOLATION-SYSPATH-1
reframed post-split; README stage range 00-13; CLAUDE/START_HERE tlmgr
lists aligned to the canonical sty->tlmgr mapping (caption, tools) and
the import-error recipe updated for the subpackaged exemplars.
- Snapshot framing: doc-mega-decomposition watch list marked historical;
review-remediation-2026-07/08 carry snapshot banners;
exemplar-backlog-history refresh commands marked historical;
maintenance/AGENTS.md row corrected; documentation-index gains
audit/README.md, publishing-export-pipeline, exemplar-backlog-history
entries and states the filepath-audit retention exception.
- Regenerated: docs/_generated/COUNTS.md + coverage_snapshot.json
(counts.py --refresh-coverage-provenance --write; --check OK),
docs/audit/filepath-audit-report.md (0 actionable issues).
Gates: check_backlog --strict 0/0, status_evidence OK, exemplar_roster OK
(24), counts --check OK, lint_docs 0 broken links/mermaid/consistency,
check_template_drift --strict clean, check_doc_module_refs clean.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Deletes the transient dated report documents per maintainer instruction and updates the audit-directory contract.
docs/audit/:REVIEW_LOG_2026-08-31.md,REVIEW_LOG_2026-09-02.md,REVIEW_2026-09-04.md,REVIEW_2026-09-05.md,BACKLOG-CLOSURE-2026-09-05.md,BACKLOG-CLOSURE-2026-09-06.md,AUDIT_2026-08-30.md+ 3 lane addenda,PROJECT_STATE_REPORT_2026-08-28.md,_FLEET_REPORT_2026-08-30.md,executable-bundle-offline-receipt-2026-08-26.md; plus tracked rootREVIEW_LOG_2026-08-31.md. All recoverable from git history.docs/audit/filepath-audit-report.md(regenerated 2026-09-11, now reflecting the deletions; 1 actionable yellow flag queued for follow-up) and the directoryREADME.md/AGENTS.md, rewritten for the receipt-free contract.STATUS.mdrender row,START_HERE.mdwall-clock note,docs/maintenance/software-heritage-archival.mdcensus pointer, two CHANGELOG links converted to inline code with removal note.docs/_generated/status_evidence.json(status_evidence.py --write,--checkOK).Verification
uv run python scripts/docgen/status_evidence.py --check→ OKuv run python scripts/audit/audit_filepaths.py→ 2193 files scanned, 0 red flags, 1 yellow (pre-splitinfrastructure/core/test_runner.pyreference in docs/rules/type_hints_standards.md — fixed in follow-up)