=== RESEARCH ===
{'issue': 300, 'kind': 'docs', 'defect_status': 'confirmed', 'category': 'new-page', 'target_files': ['docs/src/changelog.md', 'docs/src/citation.md', 'docs/make.jl', 'docs/src/index.md', 'CLAUDE.md', 'docs/docrule.md'], 'summary': 'Create two new Project/ pages — changelog.md (per-release highlights) and citation.md (How-to-Cite: package citation + refs() pointer) — register both in make.jl and index.md @contents, and wire a "update changelog each release" reminder into the release process.', 'current_state': 'Both pages are absent: `ls docs/src/` shows no changelog.md, no citation.md, and no bibliography.md. make.jl `pages=` (docs/make.jl lines ~29-131) has no "Project" section at all — it ends at "API Reference"; there is no entry for changelog/citation. index.md `@contents` (docs/src/index.md:306-308, Pages list) lists 43 pages ending at api_functions.md and includes neither new page nor any Project/ page. CLAUDE.md "Release Process" (lines ~299-321) has no reminder to update a changelog, and docrule.md "Verification" section (lines 385+) does not mention changelog maintenance. So the defect (missing Changelog and How-to-Cite pages) is real and unfixed at the release/v0.6.6 tip. Note the two named dependencies are ALSO still unbuilt: there is no Project/ nav section (created by #295/T196) and no bibliography.md (created by #299/T200) — this issue cannot register pages "under Project/" or link bibliography.md until those land.', 'proposed_change': 'Create docs/src/changelog.md: H1 `# Changelog / What\'s New {#changelog}`, prose-only (no @example blocks — nothing to execute). Structure by version, newest first. Do NOT trust the issue\'s seed list verbatim — it stops at v0.6.0. Re-derive the version list: git tags only reach v0.5.1 (v0.6.x is untagged/"in progress" per CLAUDE.md:327), and the current version is 0.6.6 (Project.toml:3), bumped to 0.6.7 for this release. So seed entries for: v0.6.7 (this release — docs + test-suite quality, no API changes), v0.6.6 and any intervening v0.6.1–v0.6.5 b-bumps (highlights-level; derive from CLAUDE.md session-log bullets / git log), v0.6.0 (Input-Output module — link io.md and its 4 children), v0.5.1 (continuous-time/OLG/Huggett — link dsge_continuous.md, dsge_olg.md; source CLAUDE.md:330), v0.5.0 (HA-DSGE, Dynare replication suite, order≥2 unconditional FEVD, model(linear=true), DSGE linear-solver rewrite, X-13 — source CLAUDE.md:328; link dsge_ha.md, dsge_linear.md, x13.md). Each entry links the pages it introduced via `[label](@ref target)`. Keep highlights-level, not a commit log.\n\nCreate docs/src/citation.md: H1 `# How to Cite {#citation}`, prose-only. Include the package citation with source-of-truth-verified fields (do NOT copy from issue body): author "Wookyung Chung <chung@friedman.jp>" (Project.toml:4), package name "MacroEconometricModels.jl", repo "https://github.com/FriedmanJP/MacroEconometricModels.jl" (make.jl repo/repolink), license "GPL-3.0-or-later" (README.md:494), version 0.6.7 (Project.toml:3, bumped for this release). Provide both a plain-text/AEA-style citation and a BibTeX @software/@misc block. Add a note that `refs(model)` (and `refs(io, :method)`) exports method-specific references in 4 formats — :text, :latex, :bibtex, :html (source of truth src/summary_refs.jl:1269-1278) — and link the API entry (api.md:308-309) and, once #299/T200 lands, `[Bibliography](@ref bibliography)`. If bibliography.md is not yet merged when this is implemented, sequence after #299 or stub the link.\n\nmake.jl: add a `"Project" => [ ... ]` section to `pages=` after "API Reference" (coordinate with #295/T196 which introduces this section; if T196 has landed, append into its existing vector rather than creating a duplicate). Entries: `"Changelog" => "changelog.md"` and `"How to Cite" => "citation.md"` (plus Notation/Bibliography if owned by T196/T200).\n\nindex.md: append "changelog.md" and "citation.md" to the `@contents` `Pages = [...]` array at docs/src/index.md:307 (same commit, per docrule new-page checklist).\n\nCLAUDE.md: add a bullet to the "Release Process" list (after line ~321) reminding to update docs/src/changelog.md with the new version\'s highlights each release. Optionally mirror in docrule.md Verification section (line 385+).', 'verify': 'Prose-only pages have no @example blocks, so run the full build to catch broken @ref cross-references: `julia --project=docs docs/make.jl` (warnonly currently includes :cross_references at make.jl:~135, so broken xrefs WARN but do not fail — manually inspect the build log for "cross_references" warnings from changelog.md/citation.md). Also run `julia --project=docs docs/verify_examples.jl docs/src/changelog.md docs/src/citation.md` (will report no executable blocks, which is expected). Do NOT run deploy_local.jl.', 'dependencies': [295, 299], 'collisions': ['docs/make.jl — #295 (T196, creates the Project/ nav section this issue registers into)', 'docs/make.jl — #299 (T200, adds notation.md/bibliography.md to same Project/ section)', 'docs/make.jl — #296 #297 #298 (T197/T198/T199, add gmm/getting_started/method_guide to pages=)', 'docs/make.jl — #301 (T202, restructures API Reference section)', 'docs/src/index.md — #295 #296 #297 #298 #299 (all edit the @contents Pages array at index.md:307)', 'docs/docrule.md — #304 (T205, adds lint_docs checks; may edit Verification section)'], 'effort': 'M', 'risk': 'low'}

=== VERIFY ===
{'issue': 300, 'verdict': 'CORRECTED', 'assessment': 'Core defect is REAL and unfixed at the release/v0.6.6 tip. Verified directly: (a) docs/src/ has no changelog.md, citation.md, bibliography.md, or notation.md (ls); (b) docs/make.jl pages= ends at "API Reference" (lines 100-104), no "Project" section; (c) docs/src/index.md:307 @contents lists 43 pages ending at api_functions.md, no new/Project pages; (d) CLAUDE.md "## Release Process" (lines 317-323, numbered 1-5) has no changelog-update reminder; docrule.md Verification (385-402) doesn\'t mention changelog maintenance; (e) hard deps #295 (Project nav) and #299 (bibliography.md) confirmed unbuilt. All citation.md source-of-truth fields VERIFIED EXACTLY: author "Wookyung Chung <chung@friedman.jp>" (Project.toml:4, make.jl:12), repo https://github.com/FriedmanJP/MacroEconometricModels.jl (make.jl:22), license "GPL-3.0-or-later" (README.md:494), version 0.6.6->0.6.7 (Project.toml:3), refs formats :text/:latex/:bibtex/:html (summary_refs.jl:1268-1280 dispatch + docstring 1286-1293 "four output formats"), api.md:308-309 refs entries. HOWEVER the proposed fix has three load-bearing errors requiring correction (see corrections), so not CONFIRMED.', 'corrections': '1) ANCHOR SYNTAX (blocking): The spec\'s H1s `# Changelog / What\'s New {#changelog}` and `# How to Cite {#citation}` use `{#id}` attribute syntax that does NOT exist anywhere in this repo (grep: 0 occurrences of `{#`) and is NOT supported by Documenter 1.0 (docs/Project.toml:9) — it would render literally and any `@ref changelog`/`@ref citation` from #299/#295 would fail to resolve (cross_references warning). The repo\'s ACTUAL convention is Documenter\'s `@id` link inside the H1, used 54 times, e.g. `# [DSGE Models](@id dsge_page)`, `# [API Types](@id api_types)`. So the H1s MUST be `# [Changelog / What\'s New](@id changelog)` and `# [How to Cite](@id citation)`.\n\n2) IO CROSS-REFS: The spec says "link io.md and its 4 children" and "link dsge_ha.md ... x13.md" via `[label](@ref target)`. Verified anchors exist for dsge_ha (@id dsge_ha), dsge_olg (@id dsge_olg), dsge_linear (@id dsge_linear), dsge_continuous (@id dsge_continuous), x13 (@id x13_page) — good. BUT io.md and all four IO children have PLAIN H1s with NO @id anchor (`# Input-Output Analysis`, `# Classical IO Analysis`, `# Environmental Extensions`, `# Baqaee & Farhi (2019) Nonlinear IO`, `# Downloading IO/MRIO Data`). There is NO `io_page` anchor. The changelog must link these via header-TEXT @ref (e.g. `[Input-Output Analysis](@ref)`) or the v0.6.0 IO entry will emit broken-xref warnings.\n\n3) VERSION-HISTORY SOURCE: The spec says derive v0.6.1–v0.6.5 highlights "from CLAUDE.md session-log bullets / git log." CLAUDE.md\'s "Release Status & Roadmap" (lines 325-330) is STALE — it still says "v0.6.0 in progress" and documents only through v0.5.1, with NO entries for v0.6.1–v0.6.6, and its framing that these are all docs/test b-bumps is wrong. Use git log/PR titles instead: v0.6.0 IO module (PR #374), v0.6.1 Phase-0 correctness criticals + test-runner restructure (#375), v0.6.2 Stage 4 Bayesian DSGE validity #128–#150 (#376), v0.6.3 README/plots (#377), v0.6.4 solver/filter fixes §10 (#378), v0.6.5 (#380), v0.6.6 display goldens/test harness [T176]. Note v0.6.1/v0.6.2/v0.6.4 contain correctness fixes, not just docs.\n\n4) MINOR (non-blocking): docrule.md has no explicit "new-page checklist" enumerating make.jl+@contents registration (spec overstates); only the Verification section (385-402) exists, which correctly requires verify_examples.jl after a new .md. The make.jl/index.md registration steps themselves are correct/standard. CLAUDE.md Release Process is at 317-323 (spec said ~299-321) — add the changelog-update step there.', 'collision_issues': [295, 296, 297, 298, 299, 301, 304], 'discriminating_power': 'n/a', 'final_effort': 'M'}