Context
This is a survey leaf of #14800. It follows the survey method (@tobiu, 2026-09-23: the window is roughly 1,500 PRs and the split moved the Brain and the Fleet Manager out of scope).
This leaf owns Tier 2 across the whole engine window: what a 13.1 user must do when they upgrade. It also owns the build, package and deps slice: 172 merged PRs, listed in the first comment.
The Problem
The notes' Upgrade Path line and Continuity section are still pending (#19091). The one fact known is that the three 13.1 Dock* files were removed without a compatibility layer.
A 13.1 consumer could also hit the following, and none of it is measured yet:
- Removed trees. The repository lost
ai/, apps/agentos and apps/devindex in the split (#17806, #17429), and the notes don't yet say what that means for the published package.
package.json changes: scripts, bin, engines, dependencies and postinstall (#19052).- The
dist/esm output (#17932, #19087).
- The
npx neo-app scaffold.
The Architectural Reality
- The baseline is the published
neo.mjs@13.1.0. npm pack --dry-run on dev gives today's file list.
- What ships is governed by
.npmignore and buildScripts/util/check-package-contents.mjs.
- Consumer-facing fields live in
package.json: compare 615d76e7d2 against dev.
The Fix
- Diff the 13.1.0 package file list against
npm pack --dry-run on dev, and group removed and added paths by family.
- Diff the
package.json fields a consumer sees.
- Walk the window's Tier-2 candidates across all areas: removals, renames,
!: subjects, and config or requirement changes.
- Write the
Upgrade Path line and a "Breaking changes and upgrade notes" section in resources/content/release-notes/v13.2.0.md.
Acceptance Criteria
Out of Scope
- The Brain and Institution lines' own upgrade notes.
- Changing what ships. A defect found along the way gets a
defect-note or its own ticket.
Related
#14800 · #19090 / PR #19091 · #17806 · #17429 · #19052 · #19087 · #17932
Live latest-open sweep: the latest 20 open issues at 2026-09-23T09:26:41Z; no survey leaf exists.
A2A claim sweep: the newest messages, all read-states; no claim on a 13.2 notes survey.
MC sweep: "release notes which items matter to external readers since last release" found the v13.1 precedent (selection over enumeration, a curated digest, an actionability section) and no prior decision against surveys.
Own-assignment sweep: #14800 (parent) and #19090 (iteration 1); no overlap.
Origin Session ID: bf94c4a1-fded-4546-87d6-73df33928275
Retrieval Hint: "13.2 release notes survey external readers upgrade path breaking changes package diff"
Context
This is a survey leaf of #14800. It follows the survey method (@tobiu, 2026-09-23: the window is roughly 1,500 PRs and the split moved the Brain and the Fleet Manager out of scope).
This leaf owns Tier 2 across the whole engine window: what a 13.1 user must do when they upgrade. It also owns the build, package and deps slice: 172 merged PRs, listed in the first comment.
The Problem
The notes'
Upgrade Pathline and Continuity section are still pending (#19091). The one fact known is that the three 13.1Dock*files were removed without a compatibility layer.A 13.1 consumer could also hit the following, and none of it is measured yet:
ai/,apps/agentosandapps/devindexin the split (#17806, #17429), and the notes don't yet say what that means for the published package.package.jsonchanges: scripts,bin,engines, dependencies andpostinstall(#19052).dist/esmoutput (#17932, #19087).npx neo-appscaffold.The Architectural Reality
neo.mjs@13.1.0.npm pack --dry-runondevgives today's file list..npmignoreandbuildScripts/util/check-package-contents.mjs.package.json: compare615d76e7d2againstdev.The Fix
npm pack --dry-runondev, and group removed and added paths by family.package.jsonfields a consumer sees.!:subjects, and config or requirement changes.Upgrade Pathline and a "Breaking changes and upgrade notes" section inresources/content/release-notes/v13.2.0.md.Acceptance Criteria
devpackage file-list diff is measured and summarized by family, with counts.package.jsonchanges are listed.Upgrade Pathline is filled.Release TypeandStabilitystay the operator's.Out of Scope
defect-noteor its own ticket.Related
#14800 · #19090 / PR #19091 · #17806 · #17429 · #19052 · #19087 · #17932
Live latest-open sweep: the latest 20 open issues at 2026-09-23T09:26:41Z; no survey leaf exists. A2A claim sweep: the newest messages, all read-states; no claim on a 13.2 notes survey. MC sweep: "release notes which items matter to external readers since last release" found the v13.1 precedent (selection over enumeration, a curated digest, an actionability section) and no prior decision against surveys. Own-assignment sweep: #14800 (parent) and #19090 (iteration 1); no overlap.
Origin Session ID: bf94c4a1-fded-4546-87d6-73df33928275 Retrieval Hint: "13.2 release notes survey external readers upgrade path breaking changes package diff"