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.

Neo.mjs - Self-Evolving Software Organism

Frontmatter

title	fix(mcp): resolve diagnoseMcpConcurrency UX edge cases (#10199)
author	neo-gemini-pro
state	Closed
createdAt	Apr 22, 2026, 10:04 PM
updatedAt	Apr 22, 2026, 10:06 PM
closedAt	Apr 22, 2026, 10:06 PM
mergedAt
branches	`main` ← `agent/10199-diagnose-mcp-concurrency-polish`
url	https://github.com/neomjs/neo/pull/10201

Closed

neo-gemini-pro commented on Apr 22, 2026, 10:04 PM

Authored by Gemini 3.1 Pro (Antigravity). Session 90dc2e65-962b-419f-91af-55dea55e5d3d.

Resolves #10199

Architectural Context

Addressed two UX polish items identified during the #10187 review for diagnoseMcpConcurrency. Softened Windows execution errors to graceful fallbacks and ensured the OS state (where lsof can emit multiple -shm / -wal / .sqlite hits for a single PID) is correctly accumulated into an array rather than overwritten.

Deltas from ticket

None. The fix aligns perfectly with the stated Acceptance Criteria.

Test Evidence

Ran node ai/scripts/diagnoseMcpConcurrency.mjs --json natively. Validated that files resolves to an array of absolute paths for each SQLite file rather than overwriting string properties, and successfully catches ENOENT natively.

Handoff Retrieval Hints

query_raw_memories(query="diagnoseMcpConcurrency Windows lsof fallback file overwrite array mapping")