LearnNewsExamplesConnect
Frontmatter
assigneesneo-opus-vega
createdAtSep 23, 2026, 11:05 AM
updatedAtNov 8, 2026, 6:04 AM
githubUrlhttps://github.com/neomjs/neo/issues/19093
authorneo-opus-vega
commentsCount2
parentIssue471
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[ ] 474 The KB projects admitted concepts from the plane store, [x] 472 ADR 0023 and ADR 0024 name the plane store as the concept source
blocking[]
closedAtNov 8, 2026, 6:04 AM

Delete the engine's concept files and JSONL copy

Closed v13.4.0/archive-v13-4-0-chunk-2 enhancementaiarchitecture
neo-opus-vega
neo-opus-vega commented on Sep 23, 2026, 11:05 AM

Rescope 2026-11-08 (operator context, Vega). The plane owns the concept graph, and Brain's generators enhance it (A2A parsing among them). Today's concepts mostly came from guide names. Deleting the engine copy cannot touch plane data, so a diverging row no longer blocks the deletion: the one diverging edge from the 2026-11-06 comparison is recorded on neomjs/neo-agent-brain#471 for the plane to take. AC-4 is dropped as a merge gate.

Rescope 2026-11-06 (householding, Vega).

Delivered and met: the Markdown half left with neomjs/neo#19159 (PR neomjs/neo#19322). The pin-route prerequisite was met by neomjs/neo-agent-brain#1356, not neomjs/neo-agent-brain#474. The orchestrator reads plane.dataRoot/concepts, and no org repository reads the engine copy (grep at Engine 268b527d30, Brain ac4320fd, Institution 0b77645, Skills 69782b6, Stage 0f98bfa).

Blocked: what remains is .neo-ai-data/concepts/ and its package surface, and AC-1 blocks it. Against the newest plane bundle (backup 2026-11-06T14:51Z), 65 of 65 nodes and 181 of 182 edges are field-identical. The one conflict is dream-pipeline IMPLEMENTED_BY. The engine copy says file:src/evolution/RemDigestion.mjs, corrected by neomjs/neo#19236 on 2026-09-26. The plane still says file:ai/daemons/orchestrator/services/DreamService.mjs, a file the Brain no longer has. The engine row is the right one, so the plane takes it first; neomjs/neo-agent-brain#471 records that correction.

Context

neomjs/neo#19096 graduated option E′ into neomjs/neo-agent-brain#471: concepts are tenant-scoped plane data, and neomjs is one instance of that mechanism. This ticket was the provisional shell for the engine's half. Under E′ the engine copies are imported, which is a no-op while they are equal, and then deleted, never moved. Roadmap cornerstone 3 (#17416) ends with the engine no longer carrying the resources/content mirror, and this is that family's leaf.

The Problem

The engine still carries both halves of neomjs' concepts:

  • The explanations: 59 files in resources/content/concepts/, under a root that ADR 0004 §1.3 defines as a regeneratable cache and that neomjs/neo#19159 deletes.
  • The graph copy: nodes.jsonl (65 rows) and edges.jsonl (182) at .neo-ai-data/concepts/. It is a strict, field-identical subset of the plane store, per @neo-opus-ada's row-by-row check (neomjs/neo#19096 fact 9), and the npm package ships it.

The Architectural Reality

  • The copies are equal today. 59 docs against 65 nodes: 0 missing, 0 mismatches (@neo-gpt, DC 18565631). The engine JSONL holds 65 of 65 nodes and 182 of 182 edges, field-identical to the plane store.
  • Package surface (@neo-opus-grace's STEP_BACK, point 2):
    • .gitignore:108 negates .neo-ai-data/concepts/. No .npmignore is committed: prepack composes it from .gitignore (buildScripts/util/npmIgnoreComposition.mjs), so that one negation is also the package's.
    • buildScripts/util/check-package-contents.mjs:59 allows it.
    • test/playwright/unit/buildScripts/checkPackageContents.spec.mjs (L46–47, L133–134) and gitignoreNegationReachability.spec.mjs (L161) pin it.
    • (Re-measured on dev 2026-11-06 from @neo-gpt-sophie's corrections: the earlier .npmignore:140 negation and check-chore-sync.mjs:102 are gone, the latter deleted with #19322.)
  • No engine code reads either copy. The content-root guard baseline (#19167) has no concept rows. The Brain's interim route over the engine pin retired with neomjs/neo-agent-brain#1356.

The Fix

  • Equality receipt, taken at execution time. Compare each engine node by id, and each edge by source|target|type, with the newest plane bundle. The Markdown files are gone, and the JSONL rows carry the same descriptions.

    • If they are equal, the import is a no-op.
    • Any difference is a source-authority conflict. Report it; never let a frozen engine file overwrite a newer plane description.
  • Delete, never move:

    • resources/content/concepts/ (59 files), delivered by neomjs/neo#19159;
    • .neo-ai-data/concepts/ (2 files).

    The PR re-runs the id-by-id comparison against the newest bundle and prints the counts as its receipt.

  • Package surface. Remove the .gitignore negation, the allow entry, and the spec cases that pin them.

Decision Record impact: aligned-with ADR 0004 §1.3; depends-on the ADR 0023 / 0024 amendment (neomjs/neo-agent-brain#472). Decision Record: Required: neomjs/neo-agent-brain#472.

Acceptance Criteria

  • AC-1 The PR body carries the equality receipt: the files compared, the equal count, and the conflicts, 0 or listed. A conflict is recorded on neomjs/neo-agent-brain#471 rather than blocking the deletion (rescope 2026-11-08).
  • AC-2 .neo-ai-data/concepts/ is deleted (resources/content/concepts/ already left with neomjs/neo#19159). The receipt is the 2026-11-06 id-by-id comparison against the newest plane bundle: 65 of 65 nodes and 181 of 182 edges, the one conflict named.
  • AC-3 The published package no longer ships .neo-ai-data/concepts/:
    • the .gitignore negation is removed (the published .npmignore is composed from it, so there is no second copy);
    • the check-package-contents allow entry is removed, along with the spec cases pinning it;
    • check-package-contents passes.
  • AC-4 The PR merges once the plane carries dream-pipeline IMPLEMENTED_BY file:src/evolution/RemDigestion.mjs, so the receipt reads 182 of 182 edges. Both original prerequisites have landed: neomjs/neo-agent-brain#1356 retired the pin route, and neomjs/neo-agent-brain#472 amended the ADRs. The "before neomjs/neo#19159" ordering lapsed when neomjs/neo#19159 merged. Dropped 2026-11-08: the plane owns concepts, and the edge is recorded on neomjs/neo-agent-brain#471.

Discussion Criteria Mapping

G4 → AC-1 to AC-4. The Epic neomjs/neo-agent-brain#471 carries the graduation's Signal Ledger, Unresolved Dissent, Unresolved Liveness and full mapping.

Out of Scope

  • The other resources/content families (the other blockers of neomjs/neo#19159, such as neomjs/neo#19157).
  • The Brain-side route (neomjs/neo-agent-brain#474).
  • The legacy concept vectors (neomjs/neo-agent-brain#419).

unowned-rationale: blocked by the plane's stale dream-pipeline edge (AC-1, AC-4). Whoever lands that plane correction claims it.

Related

neomjs/neo-agent-brain#471 (the graduated Epic) · neomjs/github-content-sync#26 (parent) · neomjs/neo#19159 (blocked) · neomjs/neo#19096 · neomjs/neo-agent-brain#472 · neomjs/neo-agent-brain#474 · neomjs/neo#11373 · ADR 0004 §1.3

Update 2026-09-24 20:40Z: promoted at graduation. It was a provisional shell, [PROVISIONAL_UNGRADUATED: D#19096], with a destination still to be decided. It is now the deletion leaf of option E′. The divergence table moved to the source Discussion, and A–D were rejected there.

Origin Session ID: db85836e-f7c2-4da0-a614-fa0e93e8e727 (filed) · 9f7b8241-8b3c-4954-a9e5-2f9c1e41d669 (promoted) Retrieval Hint: query_raw_memories("concept files resources/content/concepts delete engine JSONL copy equality receipt package surface D#19096")

Authored by Vega (Opus 5.5, Claude Code) 🌿

tobiu referenced in commit c6614ab - "chore(build): delete the engine's concept JSONL copy and its package carve-out (#19093) (#20580) on Nov 8, 2026, 6:04 AM
tobiu closed this issue on Nov 8, 2026, 6:04 AM