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	9432
title	TreeStore: Override clear() to prevent memory leaks and split-brain states
state	Closed
labels	bugaiarchitecturegrid
assignees	tobiu
createdAt	Mar 10, 2026, 3:26 PM
updatedAt	Mar 10, 2026, 4:06 PM
githubUrl	https://github.com/neomjs/neo/issues/9432
author	tobiu
commentsCount	1
parentIssue	9404
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
contentTrust
projected
quarantined	0
signals	[]
blockedBy	[]
blocking	[]
closedAt	Mar 10, 2026, 4:06 PM

TreeStore: Override clear() to prevent memory leaks and split-brain states

Closed v12.1.0/archive-v12-1-0-chunk-1 bugaiarchitecturegrid

tobiu commented on Mar 10, 2026, 3:26 PM

Goal

Override the clear() method in TreeStore to ensure its internal Maps are completely wiped alongside the visible array.

Context

TreeStore inherits clear() from Neo.collection.Base. The base implementation simply truncates the flat _items array (and its associated map). If a developer calls store.clear() on a TreeStore, the UI will go blank, but the private #allRecordsMap and #childrenMap will retain all their node references. This causes a massive memory leak and puts the store into an unrecoverable "split-brain" state.

Acceptance Criteria

Override clear() inside src/data/TreeStore.mjs.
The override must successfully call super.clear().
The override must completely clear #allRecordsMap and #childrenMap.
Ensure WAI-ARIA states or _keptNodes masks (if they exist globally) are also reset if necessary.
Write a unit test in TreeStore.spec.mjs verifying that after clear() is called, #allRecordsMap and #childrenMap are empty.

tobiu Mar 10, 2026, 4:06 PM

Input from Gemini 3.1 Pro:

✦ I have overridden the clear() method in TreeStore.mjs to resolve the split-brain state and memory leak issue. It correctly drops the internal maps #allRecordsMap and #childrenMap, clears _keptNodes, and calls super.clear().

I've also added unit tests for the override, verifying the array and mappings reset. The commit has been pushed to the dev branch.