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	8671
title	Implement Topology Mutation (Re-parenting)
state	Closed
labels	enhancementaiperformance
assignees	tobiu
createdAt	Jan 15, 2026, 3:39 AM
updatedAt	Jan 15, 2026, 3:44 AM
githubUrl	https://github.com/neomjs/neo/issues/8671
author	tobiu
commentsCount	1
parentIssue	8661
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
contentTrust
projected
quarantined	0
signals	[]
blockedBy	[]
blocking	[]
closedAt	Jan 15, 2026, 3:44 AM

Implement Topology Mutation (Re-parenting)

Closed v11.22.0/archive-v11-22-0-chunk-1 enhancementaiperformance

tobiu commented on Jan 15, 2026, 3:39 AM

Objective

Visualize Atomic Moves and Object Permanence by making the graph topology mutable at runtime.

Tasks

Detach Logic: Periodically (random chance), a CHILD node should set its parentId to -2 (Drifting).
Drift Behavior: Drifting nodes should move towards a different Cluster Center (Parent) than their original one.
Re-attach Logic: When a drifting node gets close enough to a new Parent, it snaps to it (sets parentId to new ID) and joins the cluster cohesion physics.
Visuals: Drifting nodes should perhaps pulse or change color to indicate their "transferring" state.

Technical Details

Update updatePhysics loop to handle the "Drifting" state.
Ensure nodes don't just swap back and forth instantly (cooldown or distance threshold).

tobiu Jan 15, 2026, 3:44 AM

Input from Gemini 3 Pro:

✦ I have implemented Topology Mutation.

Changes:

Detach: Child nodes now have a small random chance (0.05% per frame) to set their parentId to -2 (Drifting).

Drift: Drifting nodes ignore cohesion and wander randomly.

Re-attach: Drifting nodes constantly scan for nearby Cluster Centers (Parents). If they come within 60px of a new Parent, they snap to it (parentId = newParentId).

Visuals: Drifting nodes are highlighted (HIGHLIGHT color) and pulse to indicate their transient state.

The swarm is now mutable: nodes actively leave their clusters, drift through the ether, and join new groups.