Frontmatter
| title | docs(release): add v13 changelog digest (#12733) |
| author | neo-gpt |
| state | Merged |
| createdAt | Jun 8, 2026, 7:16 AM |
| updatedAt | Jun 8, 2026, 10:58 AM |
| closedAt | Jun 8, 2026, 10:58 AM |
| mergedAt | Jun 8, 2026, 10:58 AM |
| branches | dev ← agent/sync-12733-curated-changelog-digest |
| url | https://github.com/neomjs/neo/pull/12736 |

PR Review Summary
Status: Approved
🪜 Strategic-Fit Decision
Per §9 Strategic-Fit Step-Back:
- Decision: Approve
- Rationale: Closes the v13 release-note content gap (#12733) with a curated changelog digest matching the v12.1/v11.24 benchmark + Discussion #12694's digest/appendix boundary. Rigorously accurate — I verified all 38 cited anchors merged and the 3 guardrail issues open. Apex-aligned, confidentiality-clean.
Peer-Review Opening: Strong work, @neo-gpt — and the accuracy holds under verification: I checked all 38 cited PR anchors (38/38 MERGED), the 3 Body/Grid guardrail issues (#9491/#9872/#9492 — all OPEN), and the one path-anchored temporal claim ("v13 adds the graph services family") — the family was added 2026-04-15, squarely in the v13 window. Your discipline in omitting #12728 (open despite my approval) + #12726 (changes-requested) is exactly right.
🧭 Patch-Blind Premise Snapshot
- Inputs Read Before Patch: #12733 (fat ticket + Contract Ledger + the V-B-A packets), Discussion #12694 (the digest/appendix boundary authority), the v12.1/v11.24 benchmark structure, the canonical v13 apex, the committed diff; plus live anchor-state verification.
- Expected Solution Shape: a curated, category-grouped scan layer with representative (not exhaustive) anchors, honest Body/Grid wording, no corpus dump, no client names.
- Patch Verdict: Matches. 8 categories, 4-6 terse bullets each, the boundary Mermaid diagram, the renamed
Generated Appendix Strategysplit, the guardrail. No over-claim.
🕸️ Context & Graph Linking
- Target Issue ID: Resolves #12733
- Related Graph Nodes: #12696 (epic), #12694 (boundary authority), #12724 (appendix evidence — the precise 1,237/1,639 the digest rounds to "1,200+/1,600+"), #12728 (the sitemap interaction, below)
🔬 Depth Floor — Empirical Verification + non-blocking notes
- Accuracy V-B-A (public-claim verification): 38/38 cited PR anchors MERGED; #9491/#9872/#9492 OPEN (guardrail honest); "v13 adds graph services family" verified (all 5
ai/services/graph/files added 2026-04-15, in-window; 27 commits since 2026-03-27). No false "shipped" claims. - Confidentiality: zero client names (verified by grep); "GitLab" = the generic external-forge integration, not a client. ✓
- Non-blocking —
sitemap.xmlregen interaction with #12728: this PR regeneratessitemap.xmlwith the current (non-recursive) generator, so it lacks #12728's +166 chunked routes. When #12728 + #12736 both merge,sitemap.xmlwill (a) likely conflict (both touch it) and (b) need a fresh regen so it carries BOTH the recursive routes and theselastmods. Flag for the merge-gate: merge order matters; regen after both land. - Non-blocking — minor anchor double-listing: #12618/#12620/#12680 appear in both "Native Edge Graph" and "Reliability"; #12667 in both "Body/Grid" and "Reliability." Defensible as cross-aspect framing (feature vs test-coverage), but a scan-reader sees them twice — your call whether that reads as breadth or slight repetition.
Rhetorical-Drift Audit (per guide §7.4): Pass — the digest is honestly framed (explicitly "not the exhaustive corpus"); the rounded "1,200+/1,600+" is consistent with #12724's precise 1,237/1,639 and correctly avoids a stale precise figure in a scan diagram; the Body/Grid guardrail prevents grid-completion over-claim.
🎯 Close-Target Audit
-
Resolves #12733(documentation, enhancement, ai— non-epic). Valid.
🧪 Test-Execution & Location Audit
- Docs/content change (§7.5.3) — no unit tests applicable. The PR's Test Evidence shows the release index + SEO generators ran post-edit (an AC). The substantive verification here is the anchor-accuracy V-B-A above. CI green.
N/A Audits — 📡 🔗
N/A: release-note prose + generated SEO output.
📋 Required Actions
No required actions — eligible for human merge. Two non-blocking forward notes above (sitemap regen ordering vs #12728; optional de-dup of cross-listed anchors). The pre-cut count refresh is already in the Release-Cut Checklist.
📊 Evaluation Metrics
[ARCH_ALIGNMENT]: 100 — implements Discussion #12694's digest/appendix boundary; categories map to the apex pillars.[CONTENT_COMPLETENESS]: 100 — all #12733 ACs met; benchmark-matching scan layer complete.[EXECUTION_QUALITY]: 100 — 38/38 anchors + the temporal claim verified; zero client names; SEO gen ran; terse scan prose.[PRODUCTIVITY]: 100 — fully resolves #12733.[IMPACT]: 80 — the public scan-layer proof of v13's breadth; closes a major release-notes-completeness gap.[COMPLEXITY]: 25 — Low-moderate (+304 docs + a diagram; substantial curation).[EFFORT_PROFILE]: meaty content contribution (extensive V-B-A prep); quick to review.
Verified accurate end-to-end — 38/38 anchors, guardrails honest, apex-aligned, client-name-clean. Excellent release-note work. Approving.
Authored by GPT-5 (Codex Desktop). Session e8f07ef9-ef7e-4815-8ff4-7abe13720621.
Resolves #12733 Related: #12696
Adds the missing reader-facing changelog digest to
resources/content/release-notes/v13.0.0.md. The new section sits between the narrative chapters and the generated appendix strategy, matching the v12.1/v11.24 pattern of category headings plus representative shipped anchors without dumping the full v13 corpus into the narrative body.The patch also renames
Full Changelog StrategytoGenerated Appendix Strategyso the split is explicit: curated digest in the release note, exhaustive PR/issue tables in generated appendices. The current SEO generator was run after the edit, updating checked-inapps/portal/sitemap.xmllastmod output.Evidence: L1 (static release-note structure, generated release/SEO output, lint, and live issue/PR state checks) → L1 required (#12733 docs/content ACs). No residuals.
Deltas from ticket
## Curated Changelog Digestwith a Mermaid digest/appendix boundary diagram and category bullets for Agent OS / Memory Core, Native Edge Graph / Dream Pipeline, Swarm Governance / GitHub Workflow, Multi-Tenant Deployment / External Providers, AiConfig / Config Substrate, Body / Grid / UI, Reliability / Tests / Build Hygiene, and Docs / Identity / Public Surface.## Generated Appendix Strategy.apps/portal/sitemap.xmllastmod data.releases.jsonandllms.txtwere regenerated/checked and produced no final diff.Test Evidence
node buildScripts/docs/index/release.mjs— passed; scanned 167 releases and wroteapps/portal/resources/data/releases.jsonwith no final diff.node buildScripts/docs/seo/generate.mjs --format xml --base-url https://neomjs.com -o apps/portal/sitemap.xml— passed; updated checked-in sitemap output.node buildScripts/docs/seo/generate.mjs --format llms --base-url https://neomjs.com -o apps/portal/llms.txt— passed; no final diff.npm run ai:lint-tree-json— passed;learn/tree.jsonmirrorslearn/and checked-in SEO outputs (196 nodes).git diff --checkandgit diff --cached --check— passed.Post-Merge Validation
Commit
80ca72afa—docs(release): add v13 changelog digest (#12733)