Clarify historical docs status

Author: code5717

CHANGELOG.md

@@ -62,6 +62,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Added explicit regression tests for return type mismatches inside if branches, match branches, and nested blocks.
   - Updated the tracked backlog to reflect existing bool/enum match exhaustiveness diagnostics.
 
+- **Documentation state**
+  - Marked the old error-analysis report as historical and corrected the archive index so it no longer points at removed generated artifacts.
+
 - **Semantic and preprocessing correctness**
   - `defer` now traverses its parsed `statement` payload in both type checking and semantic validation.
   - `ret` semantic validation now traverses the parser's `value` payload.

README.md

@@ -163,6 +163,7 @@ All AST traversals are iterative with no recursion. The pipeline works with Pyth
 - `examples/` - 36 sample programs
 - `MISSING_FEATURES.md` - Feature status and roadmap
 - `CHANGELOG.md` - Change history
+- `docs/ERROR_ANALYSIS.md` - Historical error-analysis snapshot, not current status
 
 ## Docs Development
 

RELEASE_READINESS_REVIEW.md

@@ -56,6 +56,8 @@ not factually provable from local tests alone.
   inside if branches, match branches, and nested blocks.
 - Bool and enum match exhaustiveness diagnostics are covered for statements and
   expressions.
+- Historical error-analysis docs are labeled as non-current and no longer
+  conflict with release status.
 - GitHub Pages deploy now uses `npm ci` with `site/package-lock.json`.
 - README, SPEC, release docs, status docs, and agent docs describe the same
   release commands.

TODO.md

@@ -250,5 +250,6 @@ These are entire subsystems. Each needs a design decision before implementation
   Files: `README.md`, `MISSING_FEATURES.md`, `docs/SPEC.md`, `plan.md`
   Notes: README, SPEC, site status/testing pages, and release docs now describe current backend/build gates and open caveats.
 
-- [ ] Fix broken documentation links and mark historical docs as archived.
+- [x] Fix broken documentation links and mark historical docs as archived.
   Files: `README.md`, `docs/SPEC.md`, `docs/archive/README.md`, `docs/ERROR_ANALYSIS.md`
+  Notes: `docs/ERROR_ANALYSIS.md` is now labeled as historical, README describes it as non-current, and the archive index no longer points to removed generated artifacts.

docs/ERROR_ANALYSIS.md

@@ -1,5 +1,13 @@
 # A7 Compiler Error Analysis
 
+> Historical snapshot.
+>
+> This report records an older compiler state and is kept only as debugging
+> history. It does not describe the current release status. For current example
+> verification, run `uv run python scripts/verify_examples_e2e.py`,
+> `uv run python scripts/verify_examples_e2e_c.py`, or `./run_all_tests.sh`.
+> Current gaps are tracked in `MISSING_FEATURES.md` and `TODO.md`.
+
 Analysis of semantic/type errors across all 36 example files.
 
 ## Summary Statistics

docs/archive/README.md

@@ -4,12 +4,12 @@ This folder stores old or non-essential project artifacts that were moved out of
 
 Moved on 2026-02-21:
 
-- `ERROR_ANALYSIS.md` -> `docs/ERROR_ANALYSIS.md`
 - `run.sh` -> `docs/archive/tools/run.sh`
 - `fix_types.py` -> `docs/archive/tools/fix_types.py`
-- `__pycache__/main.cpython-313.pyc` -> `docs/archive/pycache/__pycache__/main.cpython-313.pyc`
-- `site/` -> `docs/archive/site/`
 
 Notes:
 
-- `docs/archive/site/node_modules` was intentionally removed because it is generated dependency output.
+- `docs/ERROR_ANALYSIS.md` is a historical error-analysis snapshot kept under
+  `docs/` for reference; it is not current release status.
+- Generated cache output and the old archived site copy were removed from the
+  repository. The current documentation site lives in `site/`.