=== RESEARCH ===
{'issue': 303, 'kind': 'docs', 'defect_status': 'decision', 'category': 'nav-arch', 'target_files': [], 'summary': 'Record the gated decision to DEFER (not perform) the manual->var / bayesian->bvar / nongaussian->id_overview filename renames for v0.6.7, since v0.6.7 is not a rename-bundling release and the disambiguating nav labels/titles are already in place; change no source files.', 'current_state': 'This is a "decision" issue, not a code defect. Current tree state confirms the "defer/keep-filenames" branch is the correct outcome and its prerequisites are already met:\n(1) Nav labels already disambiguate the three "lying" filenames -- docs/make.jl:35 `"VAR" => "manual.md"`, :36 `"Bayesian VAR" => "bayesian.md"`, and the "Statistical Identification" section :79 `"Overview" => "nongaussian.md"` / :80 `"Non-Gaussian Methods" => "id_nongaussian.md"`.\n(2) Page titles + stable @id anchors are correct: manual.md:1 `# [VAR](@id var_page)`, bayesian.md:1 `# [Bayesian VAR](@id bvar_page)`, nongaussian.md:1 `# [Statistical Identification](@id nongaussian_page)`, id_nongaussian.md:1 `# [Non-Gaussian Methods](@id id_nongaussian_page)`. So the [T196] skip-prerequisite (labels/titles read as VAR/BVAR/Statistical Identification, and the two "nongaussian" pages are disambiguated) is ALREADY satisfied -- independent of the larger T196 (#295) section-merge restructure, which is NOT yet applied (make.jl still has the old separate Cross-Sectional/Panel/Structural/Statistical/Innovation-Accounting sections).\n(3) The filenames are still referenced by name in docs/make.jl (lines 35,36,79,80), docs/src/index.md:307 (`@contents` Pages list includes manual.md, bayesian.md, nongaussian.md), the CLAUDE.md nav map, and 9 in-body cross-references that resolve via filename-independent @id anchors (var_page/bvar_page/nongaussian_page).\nSTALE-CITATION CORRECTION: the issue body cites "docrule 6.2 rename rules", but docs/docrule.md has NO rename/redirect section (grep for rename|redirect|6.2 returns nothing). The rename rule actually lives in the AUDIT REPORT 6.2 at docs/plans/2026-07-03-documentation-audit-report.md:495-498, which states renames are "Recommended only bundled with the v0.6.0 release announcement; otherwise keep filenames and fix titles/nav labels only."', 'proposed_change': 'DECISION: DEFER the renames for v0.6.7. Do NOT rename manual.md/bayesian.md/nongaussian.md and do NOT edit any docs/src file, make.jl, index.md, or CLAUDE.md for this issue.\n\nRationale to record (per audit report 495-498): Documenter has no redirect mechanism, so renaming breaks every inbound link (bookmarks, external refs, search results, the .html filenames). The audit gates renames to the v0.6.0 release announcement bundle. v0.6.7 is a b-bump docs/test-quality release with NO feature/API changes and is NOT that announcement, so the gate condition is unmet -> keep filenames. The disambiguation goal is already achieved by the corrected sidebar labels (make.jl:35/36/79/80) and page titles/@id anchors (manual.md:1, bayesian.md:1, nongaussian.md:1, id_nongaussian.md:1), so no reader-facing "filenames lie" confusion remains; the two-meaning nongaussian clash is resolved by the distinct nav labels "Statistical Identification" (Overview, nongaussian.md) vs "Non-Gaussian Methods" (id_nongaussian.md).\n\nDELIVERABLE (implementer): record this decision as a short note -- NOT a new published docs page. Put it in the v0.6.7 release PR description and/or append a one-line entry to the release implementation plan (e.g. docs/plans/2026-07-1x-v0.6.7-implementation-plan.md if such a plan file is created for the release). Suggested wording: "T204/#303: Filename renames (manual->var, bayesian->bvar, nongaussian->id_overview) intentionally DEFERRED. Filenames retained for inbound-link stability (Documenter has no redirects). Nav labels + page titles already disambiguate (make.jl:35/36/79/80). Revisit only when bundling a release announcement, and pair with a changelog note (T201/#300)."\n\nALTERNATIVE (only if a future release decides to rename -- NOT for v0.6.7, documented here for completeness): the full change set would be (a) rename docs/src/manual.md->var.md, bayesian.md->bvar.md, nongaussian.md->id_overview.md; (b) update the four docs/make.jl pages= entries at lines 35,36,79,80; (c) update the docs/src/index.md:307 `@contents` Pages= list; (d) update the CLAUDE.md nav map; (e) grep docs/src for any remaining hardcoded `manual.md|bayesian.md|nongaussian.md` link targets (the @id-based @refs var_page/bvar_page/nongaussian_page survive unchanged); (f) add a changelog note (T201/#300); (g) rebuild with 0 broken xrefs. This branch is explicitly out of scope for v0.6.7.', 'verify': "No page content changes, so no build is strictly required for the defer decision. Sanity check that the decision's premise still holds (no rename occurred): confirm files still exist and labels intact via `grep -n 'manual.md\\|bayesian.md\\|nongaussian.md' docs/make.jl docs/src/index.md`. If, and only if, the rename branch were ever taken, prove the site still builds and has zero dangling xrefs with `julia --project=docs docs/make.jl` (full makedocs; not a single-page verify_examples run, because renames affect cross-page @contents/links).", 'dependencies': [295], 'collisions': [], 'effort': 'S', 'risk': 'low'}

=== VERIFY ===
{'issue': 303, 'verdict': 'CONFIRMED', 'assessment': 'This is a genuine "decision" issue (T204), not a code defect, and the DEFER outcome is unambiguously correct. I independently confirmed every load-bearing citation against the current tree: make.jl:35/36/79/80 (VAR / Bayesian VAR / Overview to nongaussian.md / Non-Gaussian Methods to id_nongaussian.md); the four page titles plus @id anchors (manual.md:1 var_page, bayesian.md:1 bvar_page, nongaussian.md:1 nongaussian_page, id_nongaussian.md:1 id_nongaussian_page); index.md:307 @contents list; and audit report lines 495-498 (rename-rule text verbatim). The STALE-CITATION CORRECTION is verified correct: docrule.md has no numbered sections and no rename/redirect/6.2 content at all, so the issue body\'s "docrule 6.2 rename rules" citation is wrong; the rule lives only in the audit report 6.2. The rename gate ("bundle with the v0.6.0 release announcement") is unmet: v0.6.0 already shipped and v0.6.7 is a b-bump docs/test-quality release, so DEFER is the correct branch, and the skip-prerequisite (disambiguating nav labels + titles) is already satisfied independent of the larger, still-unapplied T196/#295 restructure (make.jl still shows separate sections at 42/47/71/77/78; #295 is OPEN). Because the deliverable changes no source files, there is no same-page collision with any prose/sweep issue. One non-load-bearing inaccuracy: the research says "9 in-body cross-references" but my exact grep finds only 3 @ref uses of var_page/bvar_page/nongaussian_page (innovation_accounting.md:91, structural_identification.md:12/325), or 6 counting the @id defs, never 9. That figure is not part of the recorded decision note and does not affect the outcome, so the spec\'s actionable content (defer, change no source files, record a PR/plan note) is correct and complete.', 'corrections': '', 'collision_issues': [], 'discriminating_power': 'n/a - docs decision issue, no test involved.', 'final_effort': 'S'}