What is the Neural Link?

The Neural Link is a bi-directional bridge that connects AI agents directly to the Neo.mjs runtime. It lets agents inspect the Scene Graph, component state, event listeners, computed styles, and DOM rectangles, and mutate the running application in real time.

Why is Neo.mjs called an Application Engine instead of a framework?

Neo.mjs maintains persistent application objects in a worker-backed Scene Graph instead of compiling application state away into ephemeral DOM nodes. That architecture enables multi-window orchestration, runtime permutation, and deep AI introspection.

What is Context Engineering?

Context Engineering shapes the information and tool environment around AI agents. Neo.mjs implements it through Knowledge Base, Memory Core, GitHub Workflow, and Neural Link MCP servers for frontier harnesses, plus a File System MCP server for internal Neo.ai.Agent local loops.

What is the Neo.mjs Agent OS?

The Neo.mjs Agent OS is the repository Brain: source code and services for Memory Core, Knowledge Base, Active Hybrid GraphRAG, DreamService, Golden Path synthesis, A2A coordination, and Neural Link tooling.

Frontmatter

id	19631
title	The Engine's ADRs still describe the pre-split Brain and Fleet Manager
state	Open
labels	documentationenhancementaiarchitecture
assignees	neo-opus-grace
createdAt	Oct 11, 2026, 9:36 PM
updatedAt	Oct 11, 2026, 10:10 PM
githubUrl	https://github.com/neomjs/neo/issues/19631
author	neo-opus-grace
commentsCount	1
parentIssue	null
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
contentTrust
projected
quarantined	0
signals	[]
blockedBy	[]
blocking	[]

The Engine's ADRs still describe the pre-split Brain and Fleet Manager

Open v13.2.0/archive-v13-2-0-chunk-25 documentationenhancementaiarchitecture

neo-opus-grace commented on Oct 11, 2026, 9:36 PM

Context

The operator, 2026-10-11 ~19:30Z (relayed by Ada as lanes, A–E): the README and the ADRs still carry pre-split, even pre-Fleet-Manager content. Update what no longer matches, against one apex: Body = neomjs/neo (the Engine); Brain = neomjs/neo-agent-brain (the Agent OS, the backend: MCP servers, Memory Core, Knowledge Base, graph, Dream Mode), where nobody "lives"; Institution = neomjs/neo-agent-institution (the Fleet Manager, the app that starts the harnesses and connects through the Neural Link). The team builds all three. This is lane B: the ADRs in the Engine.

The Problem

Twelve ADRs remain in learn/agentos/decisions:

ADR 0018, the identity model, defines the structure beneath the apex as Body /src/ + Brain /ai/, with the Brain holding "the entire Agent OS (… institution …)" (OD-1), and the Swarm inside the Brain (OD-3).
Five are Fleet Manager decisions in the Engine's record: 0020 (agent harness), 0032 (cockpit render model), 0034 (Electron shell), 0037 (FM outward door; it still says "all engine, Fleet Manager, and Electron-wrapper product source stays in neomjs/neo") and 0038 (FM client topology).
0031 composes the seam table on the 0018 scaffold.
0004 names ai/ paths for a content pipeline that moved to github-content-sync.

The Fix

ADR 0018: an OD-4 amendment recording the post-split structure from the operator's words, superseding OD-1's BRAIN (/ai/) structure line and OD-3's "Swarm inside the Brain". It also gets a Status-table row. The apex line itself is untouched.
0004, 0020, 0031, 0032, 0034, 0037, 0038: one "After the split" row in each metadata table: where the product or path lives now, with the split PR as the anchor. History is not rewritten.

Scope: learn/agentos/decisions/*.md only.

Acceptance Criteria

AC-1 ADR 0018 carries OD-4 and an Amended row, worded from the operator's apex. The PR asks the operator to confirm the wording (§2.7: operator-decision points).
AC-2 The seven ADRs above each carry an "After the split" row, citing #17806, #17810 or #17416 / #19322 as applicable.
AC-3 No ADR body text is rewritten beyond the rows and OD-4.
AC-4 The ADR guards in CI pass (the seam-table id guard among them).

Out of Scope

The README and learn/benefits (lane A, Ada), the Brain's README (lane C), the Fleet Manager's README (lane D), the AGENTS identity anchor's generator source (lane E, the operator's), and moving the Fleet Manager ADRs into the Institution's repository.

#19629, #19630, ADR 0018, #17806, #17810, #17416.

Sweeps: the latest open neo issues at 19:36Z hold no ADR-drift item. The A2A lane board (Ada, 19:33Z) lists lane B as open, and I claimed it at 19:35Z.