LearnNewsExamplesServices
Frontmatter
id19159
titleDelete resources/content from the engine once its authored families and readers have moved
stateClosed
labels
enhancementaibuild
assigneesneo-opus-vega
createdAtSep 24, 2026, 2:52 PM
updatedAtSep 29, 2026, 1:21 PM
githubUrlhttps://github.com/neomjs/neo/issues/19159
authorneo-opus-vega
commentsCount1
parentIssue17416
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[x] 19158 Census every resources/content reader and gate new derivations before the deletion
blocking[]
closedAtSep 29, 2026, 1:21 PM

Delete resources/content from the engine once its authored families and readers have moved

Closed v13.2.0/archive-v13-2-0-chunk-23 enhancementaibuild
neo-opus-vega
neo-opus-vega commented on Sep 24, 2026, 2:52 PM

Context

The operator decided on 2026-09-23 to delete the engine's resources/content fully, and asked again on 2026-09-29 for it to be done now. The tree holds 17,930 tracked files (193 MB), last written by the retired data-sync pipeline on 2026-08-26. Its conversations and release notes now publish from neomjs/github-content-sync (neo/{archive,discussions,issues,pulls,release-notes}).

State of the original blockers on 2026-09-29:

  • #19158 (reader census + content-root guard): closed; the guard is live (#19167).
  • neomjs/pages#10 (pages reads conversations from a pinned corpus commit): merged.
  • #19157 (release notes need an authored path): the path is decided there (.github/RELEASE_NOTES/, flat, git mv); the corpus facet it waited on landed (neomjs/neo-agent-brain#491, #494). The move is executed in this ticket's PR.
  • #19093 (concepts): the 59 files under resources/content/concepts/ are unchanged since 2026-05-15, before that ticket's equality receipt, so deleting them loses nothing the plane store lacks. .neo-ai-data/concepts/ and the package surface stay with #19093.

The Problem

Deleting the tree without moving its one authored family and its writers breaks the next release:

  • publish.mjs refuses a release without resources/content/release-notes/v<version>.md, and 13.2's note is staged there.
  • The Brain's post-release sync re-materializes the tree into the engine checkout and pushes it to dev.
  • Pages step 4.1 copies the notes from resources/content/release-notes at the engine's release tag.

The Fix

One engine PR:

  • git mv the 169 notes (chunked archive plus the 13.2 staging note) to .github/RELEASE_NOTES/, flat. The authored file is the archive; publish.mjs reads it there and no longer deletes it after the release.
  • git rm the rest of resources/content.
  • Remove the retired writers and the guards whose whole subject was the tree: the data-sync pipeline and watchdog, check-chore-sync, the logical-identity lint job, and the path rules in check-package-contents and classify-test-scope. .gitignore ignores resources/content/, so a regenerated tree cannot be committed.

Companion tickets, their PRs merged with this one:

  • Brain neomjs/neo-agent-brain#623: the post-release lifecycle keeps the Knowledge Base upload and stops syncing, archiving and committing into the engine checkout.
  • Pages neomjs/pages#11: step 4.1 reads the notes from .github/RELEASE_NOTES at revisions that carry it.
  • Skills neomjs/neo-agent-skills#124: the release-notes workflow names the new authoring path.

Acceptance Criteria

  • AC-1 git ls-files resources/content is empty, and git log --follow on a moved note reaches its authoring commit.
  • AC-2 The engine's CI is green on the deletion, including the content-root guard with its baseline rows for removed files gone.
  • AC-3 No retired writer of the tree survives in the engine. The Brain's post-release lifecycle is neomjs/neo-agent-brain#623.
  • AC-4 publish.mjs requires the staged 13.2 note at its new path, and the release index builds 169 releases from the moved notes. Pages step 4.1 is neomjs/pages#11.

Out of Scope

  • The local portal's content root (#19166). The deployed site is unaffected, because pages populates the served resources/content base itself.
  • .neo-ai-data/concepts/ and the package surface (#19093, gated on neomjs/neo-agent-brain#474).
  • A history rewrite.

Related

#17416 (parent) · #19157 · #19093 · #19166 · neomjs/pages#10 · D#19051

Origin Session ID: 9f7b8241-8b3c-4954-a9e5-2f9c1e41d669

Authored by Vega (Claude Opus 5.5, Claude Code) 🌿

tobiu referenced in commit 2d993a2 - "docs(roadmap): the 13.2 rows read 2026-09-24 — both release decisions graduated, the crash slice shipped, cornerstone 3 stewarded (#19162) (#19164) on Sep 24, 2026, 4:23 PM
tobiu referenced in commit 7ff8467 - "build(content): resources/content leaves the engine (#19159) (#19322) on Sep 29, 2026, 1:21 PM
tobiu closed this issue on Sep 29, 2026, 1:21 PM