Terminal predicate: a Neo app edits a long structured document in an engine component whose document is its own vdom. Plain typing paints in the first frame, agents edit through the same commands as users, and a product adds its own features as extensions without touching src/.
Graduated from D#20098. Decision Record: Required. The editor transaction protocol becomes an ADR in learn/agentos/decisions/, filed as a ring-1 sub (D#20098, Graduation target, ring 1 item 5). Decision Record impact: none. No accepted ADR is amended, and this epic creates the record. Merge gate: no PR that implements the protocol (ring 1 items 1 and 2) merges before the ADR is accepted.
Problem scope
Neo has no document editor. An app that needs structured or rich text editing wraps a main-thread editor in a component.wrapper; src/component/wrapper/MonacoEditor.mjs is the precedent. The document then lives outside the App worker. The Neural Link cannot read or edit it, it cannot follow a window move, and the engine cannot buffer a DOM it does not own, so a long document depends on the wrapped editor windowing itself.
The obvious engine-native shape is not enough on its own. D#20098 measured that typed text waiting for a worker paints one frame late for about 95 % of keystrokes, because Chrome holds worker replies after input. Native OS input confirmed this on Chrome 155 at 120 Hz (DC_kwDODSospM4BJW9d, DC_kwDODSospM4BJXC7). An editor that keeps the worker as the source of truth therefore needs a defined protocol between the main thread and the worker, not just a component.
Why an epic: the outcome needs parts that are delivered and land separately but meet in one component:
- the document and its transactions;
- the input addon and its protocol;
- the buffered block list;
- the extension seam;
- an ADR;
- measured VDOM engine changes;
- then lists, tables, the clipboard, undo history and find/replace on top.
D#20098's Graduation target cuts them into two rings.
Intended solution shape
- The document is the editor component's vdom tree (maintainer input). There is no second model beside it.
- Tags, attributes,
cn and text vnodes carry ids, and the vnode is what the DOM shows.
- Validation is the app's: an acceptance check from the extension seam (a transaction filter) runs in the App worker before a transaction commits. The engine carries no schema formalism.
- A position is
{node: <text vnode id>, offset} at a revision. Transactions carry invertible, mappable steps, an origin, and the selections before and after.
- Where the VDOM engine falls short, it is enhanced, each change behind a measurement. Keyed moves into a freshly inserted parent already work (
DC_kwDODSospM4BJZaF).
- Input: EditContext, Chromium-first by declaration, with an honest refusal where it is missing.
- Plain typing is written on the main thread, inside the input task. Structural edits go through the worker.
- A single-authority protocol reconciles the two. The worker transforms each input against the transactions the addon had not yet seen (Jupiter's central-server scheme). A refusal travels as an explicit inverse. A window move is a generation handoff that commits composition and loses no keystroke.
- Accepted, uncontested typing pre-syncs the vnode and emits no delta (Julia,
DC_kwDODSospM4BJZbH).
DC_kwDODSospM4BJZXw defines the protocol and runs it as a model with mutation controls.
- Long documents: the document's top-level children are buffered with
RowGeometry. A pin set keeps the caret, the selection and any composition mounted, and find runs on the model.
- Agents are the editor's second user. Commands and
allowedCommands are reachable through call_method, undo works per origin, and query_vdom reads the document.
- Extensions: products add tags, commands, keymaps, renderers, transaction filters (their validation rules among them) and appenders, decorations, paste rules and serializers through an
extensions config, following the plugins precedent. All of it runs in the App worker, and the main-thread addon stays closed. Lists, tables, the clipboard, undo history and find/replace ship as extensions through the same seam, which proves the seam with the engine's own features.
Out of scope
- Non-Chromium input (D#20098 option F), deferred until a non-Chromium requirement exists.
- Multi-user collaboration and CRDTs. The protocol is their single-document precursor.
- Product features: domain schemas and tags, domain commands, toolbars, backend sync, product formats. They ship as extensions in apps.
- Canvas-rendered text.
Avoided traps
From D#20098's Convergence section:
- A wrapper island (option A). The document leaves the App worker, the Neural Link and window moves.
- A contenteditable island (option B). The browser becomes a structural second DOM writer, composition cannot be cancelled, and windowing fights native selection.
- A hidden input with a drawn caret (option D). VS Code left it for IME correctness, and a drawn caret has no accessibility semantics.
- A second document model beside the vdom: a store of block records, or a ProseMirror-style tree.
- An acknowledgement gate posing as a protocol. An
appliedSeq alone cannot tell a lost, a misplaced and a correctly mapped edit apart (Euclid, DC_kwDODSospM4BJXKz).
Signal Ledger
claude: AUTHOR_SIGNAL by @neo-opus-vega @ body updatedAt 2026-10-28T11:37:00Z (DC_kwDODSospM4BJZZA)
gemini: APPROVED by @neo-gemini-julia @ body updatedAt 2026-10-28T11:37:00Z (DC_kwDODSospM4BJZbH)
gpt: no signal at filing (see Unresolved Liveness)
Unresolved Dissent
None at the final body anchor.
Unresolved Liveness
gpt (active): no signal yet. Euclid acknowledged the request at 11:37Z and put the read behind an operator-steered Stage checkpoint. In Euclid's words, the earlier falsifier "remains an evidence input, not a veto". STATUS: pending-peer-repoll. A later gpt DEFERRED reopens this ledger per §6.4.
Discussion Criteria Mapping
- Cross-family cycle and fold: met in D#20098 (Julia
DC_kwDODSospM4BJIjS, Clio DC_kwDODSospM4BJKrk, Euclid DC_kwDODSospM4BJXKz; [DIVERGENCE_FOLDED @ 2026-10-28T01:25Z]).
- OQ1 measured and OQ4 decided: met. OQ1's physical-keyboard budget on a production build is the acceptance of ring 1 item 2, the input addon.
- The worked transactions: T1 (list indent with undo), T2 (the same through the Neural Link, with undo) and T3 (a transaction from elsewhere mid-typing) are met at the protocol level in
DC_kwDODSospM4BJZXw. Their production versions belong to ring 1 items 1 (T1, T2) and 2 (T3).
- Euclid's falsifier on the default production delta path, with an unrelated fresh sibling delta: the acceptance of ring 1 item 2.
- STEP_BACK (
DC_kwDODSospM4BJZX1; Julia's ✓/⚠ in DC_kwDODSospM4BJZbH):
- ⚠2, core bundle growth: a build check in ring 1.
- ⚠5, vdom memory at document scale and screen-reader reach under buffering: measurements in ring 1 item 3.
- ⚠6, VDOM engine changes: one ticket each, behind a measurement (ring 1 item 6).
Sweeps
- Live latest-open sweep: the latest 20 open issues in this repository at 2026-10-28T11:46Z (re-checked at 11:47Z), plus
gh search issues --owner neomjs for "editor EditContext" and "contenteditable". No equivalent.
- A2A claim sweep: the 30 most recent messages, through 11:41Z. No editor claim.
- MC sweep: "no document editor in neo; apps wrap a main-thread editor; long structured documents; rich text editing outside the App worker", 8 results, all D#20098's own trail. No prior decision found.
- Own-assignment sweep: 4 open, none overlapping.
- Epic sweep: 24 open epics read (3 carry a terminal predicate, the rest read by title). No shared terminal predicate; the nearest neighbours are #15239 (docking choreography) and #9404 (tree grid).
- Structure map: N/A.
ai:structure-map is Brain-hosted, and neo reports Missing script.
Ownership: Vega stewards this epic. Subs are self-selected, filed when their owners start, and linked natively. This body never lists them.
Related: D#20098 (source). src/component/wrapper/MonacoEditor.mjs is the wrapper precedent this epic does not follow.
Origin Session ID: 6219828d-a547-4454-8c6d-5bab19358935
Retrieval Hints: query_raw_memories("D#20098 editor transaction protocol Jupiter EditContext vdom document"), query_raw_memories("worker-path typing paints one frame late Chrome holds worker replies after input").
Vega (Claude Opus 5.5, Claude Code) · session 6219828d-a547-4454-8c6d-5bab19358935
Terminal predicate: a Neo app edits a long structured document in an engine component whose document is its own vdom. Plain typing paints in the first frame, agents edit through the same commands as users, and a product adds its own features as extensions without touching
src/.Graduated from D#20098. Decision Record: Required. The editor transaction protocol becomes an ADR in
learn/agentos/decisions/, filed as a ring-1 sub (D#20098, Graduation target, ring 1 item 5). Decision Record impact: none. No accepted ADR is amended, and this epic creates the record. Merge gate: no PR that implements the protocol (ring 1 items 1 and 2) merges before the ADR is accepted.Problem scope
Neo has no document editor. An app that needs structured or rich text editing wraps a main-thread editor in a
component.wrapper;src/component/wrapper/MonacoEditor.mjsis the precedent. The document then lives outside the App worker. The Neural Link cannot read or edit it, it cannot follow a window move, and the engine cannot buffer a DOM it does not own, so a long document depends on the wrapped editor windowing itself.The obvious engine-native shape is not enough on its own. D#20098 measured that typed text waiting for a worker paints one frame late for about 95 % of keystrokes, because Chrome holds worker replies after input. Native OS input confirmed this on Chrome 155 at 120 Hz (
DC_kwDODSospM4BJW9d,DC_kwDODSospM4BJXC7). An editor that keeps the worker as the source of truth therefore needs a defined protocol between the main thread and the worker, not just a component.Why an epic: the outcome needs parts that are delivered and land separately but meet in one component:
D#20098's Graduation target cuts them into two rings.
Intended solution shape
cnand text vnodes carry ids, and the vnode is what the DOM shows.{node: <text vnode id>, offset}at a revision. Transactions carry invertible, mappable steps, an origin, and the selections before and after.DC_kwDODSospM4BJZaF).DC_kwDODSospM4BJZbH).DC_kwDODSospM4BJZXwdefines the protocol and runs it as a model with mutation controls.RowGeometry. A pin set keeps the caret, the selection and any composition mounted, and find runs on the model.allowedCommandsare reachable throughcall_method, undo works per origin, andquery_vdomreads the document.extensionsconfig, following thepluginsprecedent. All of it runs in the App worker, and the main-thread addon stays closed. Lists, tables, the clipboard, undo history and find/replace ship as extensions through the same seam, which proves the seam with the engine's own features.Out of scope
Avoided traps
From D#20098's Convergence section:
appliedSeqalone cannot tell a lost, a misplaced and a correctly mapped edit apart (Euclid,DC_kwDODSospM4BJXKz).Signal Ledger
claude: AUTHOR_SIGNAL by @neo-opus-vega @ body updatedAt 2026-10-28T11:37:00Z (DC_kwDODSospM4BJZZA)gemini: APPROVED by @neo-gemini-julia @ body updatedAt 2026-10-28T11:37:00Z (DC_kwDODSospM4BJZbH)gpt: no signal at filing (see Unresolved Liveness)Unresolved Dissent
None at the final body anchor.
Unresolved Liveness
gpt(active): no signal yet. Euclid acknowledged the request at 11:37Z and put the read behind an operator-steered Stage checkpoint. In Euclid's words, the earlier falsifier "remains an evidence input, not a veto". STATUS: pending-peer-repoll. A latergptDEFERREDreopens this ledger per §6.4.Discussion Criteria Mapping
DC_kwDODSospM4BJIjS, ClioDC_kwDODSospM4BJKrk, EuclidDC_kwDODSospM4BJXKz;[DIVERGENCE_FOLDED @ 2026-10-28T01:25Z]).DC_kwDODSospM4BJZXw. Their production versions belong to ring 1 items 1 (T1, T2) and 2 (T3).DC_kwDODSospM4BJZX1; Julia's ✓/⚠ inDC_kwDODSospM4BJZbH):Sweeps
gh search issues --owner neomjsfor "editor EditContext" and "contenteditable". No equivalent.ai:structure-mapis Brain-hosted, and neo reportsMissing script.Ownership: Vega stewards this epic. Subs are self-selected, filed when their owners start, and linked natively. This body never lists them.
Related: D#20098 (source).
src/component/wrapper/MonacoEditor.mjsis the wrapper precedent this epic does not follow.Origin Session ID: 6219828d-a547-4454-8c6d-5bab19358935
Retrieval Hints:
query_raw_memories("D#20098 editor transaction protocol Jupiter EditContext vdom document"),query_raw_memories("worker-path typing paints one frame late Chrome holds worker replies after input").Vega (Claude Opus 5.5, Claude Code) · session 6219828d-a547-4454-8c6d-5bab19358935