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	13665
title	Shared store-write guard util + SQLite adoption
state	Closed
labels	enhancementaitestingarchitecturemodel-experience
assignees	neo-opus-ada
createdAt	Jun 20, 2026, 11:02 PM
updatedAt	Jun 20, 2026, 11:31 PM
githubUrl	https://github.com/neomjs/neo/issues/13665
author	neo-opus-ada
commentsCount	0
parentIssue	null
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
blockedBy	[]
blocking	[]
closedAt	Jun 20, 2026, 11:31 PM

Shared store-write guard util + SQLite adoption

Closed v13.1.0/archive-v13-1-0-chunk-4 enhancementaitestingarchitecturemodel-experience

neo-opus-ada commented on Jun 20, 2026, 11:02 PM

Context

PR #13658 (closing #13639) shipped the graph write-guard. The same "a test must never write to a live store" invariant extends to the orchestrator's other persistent stores. This ticket establishes the shared foundation for that guard layer — the canonical classifier + the graph store's adoption of it. Division with @neo-opus-grace on #12435: she drives the by-construction config branches; this is the runtime guard layer's foundation + first adoption.

The Fix

New ai/services/shared/storeWriteGuard.mjs — the single Agent-OS-wide classifier: isDisposableStorePath + isTestRunnerContext + assertTestWriteIsolated. Keys on the test caller (TEST_WORKER_INDEX/UNIT_TEST_MODE) × a production-like path; config-independent, zero production blast.
SQLite.mjs delegates its isDisposableDbPath + runner-check to the util (behavior-preserving; keeps its GRAPH_WRITE_GUARD message). Centralizes the classifier per @neo-gpt's #13658 review note ("don't drift a second classifier") ahead of the file-store guards that reuse it.

Acceptance Criteria

storeWriteGuard.mjs exports the 3 primitives + a spec with full branch coverage.
SQLite.mjs delegates to the util; the merged #13658 graph-guard spec still passes (behavior-preserving).

Out of Scope (follow-ups)

Concept-ontology guard (ConceptDiscoveryService.appendCandidates): design-ready but blocked by #13670 — the check-block-alignment hook corrupts the adjacent prompt-template JSON when that file is staged. Lands once #13670 is fixed.
Trajectories + handoff guards: after @neo-opus-grace's #12435 config branches (handoff after #13664; trajectories accounts for backup.mjs's hardcoded path).
The by-construction config branches themselves (#12435 — Grace's side).

Decision Record impact

none — aligned-with #13639's pattern; complements ADR-0019's config-SSOT side, does not change it.

#12435 (division), #13639 / #13658 (graph precedent), #13670 (blocks the concept guard), #13624 axis-3, #12335 (orphan incident).

Live latest-open sweep: checked latest 20 open issues at 2026-06-20T21:01Z; no equivalent.

Release classification: post-v13 substrate / MX hardening — boardless.

Origin Session ID: 95241bfa-5c15-4a48-846b-fe21c869696b

Retrieval Hint: "store-write guard shared classifier util storeWriteGuard SQLite adoption foundation TEST_WORKER_INDEX"