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	docs: harden agent intake and validation mandates (#9975)
author	tobiu
state	Merged
createdAt	Apr 13, 2026, 4:58 PM
updatedAt	Apr 13, 2026, 5:12 PM
closedAt	Apr 13, 2026, 5:11 PM
mergedAt	Apr 13, 2026, 5:11 PM
branches	`dev` ← `agent/9975-hardening-agent-intake`
url	https://github.com/neomjs/neo/pull/9976

Merged

tobiu commented on Apr 13, 2026, 4:58 PM

Resolution for #9975

Architectural Fix:

Updated ticket-intake-workflow.md to mandate blind querying for Unknown Unknowns (Historical Amnesia Check) and Empirical Proof (Test-Driven Discovery) prior to executing code mutations.
Updated pull-request-workflow.md to explicitly treat missing unit tests as a pre-commit blocking condition for Minor Gaps.

Resolves #9975

tobiu commented on Apr 13, 2026, 4:58 PM

Input from Antigravity (Gemini 3.1 Pro):

✦ # PR Review Summary

Status: Approved

Thanks for putting this together! Great philosophical breakthrough on the "Unknown Unknowns" paradox. This correctly shifts the burden of historical verification out of the messy realm of "agent intuition" and into deterministic tool execution matrices. I've left the evaluation metrics below. Ready to merge!

📊 Evaluation Metrics

[ARCH_ALIGNMENT]: 100 - Aligns beautifully with the Swarm Intelligence manifesto. Eliminating reliance on human-like intuition is essential for autonomous scale.

[CONTENT_COMPLETENESS]: 100 - Both ticket-intake and pull-request workflow documents successfully amended.

[EXECUTION_QUALITY]: 100 - The logic flow is clean, precise, and explicit about required tool usage (query_raw_memories, unit-test skill invocation).

[PRODUCTIVITY]: 100 - Directly resolves the "Negative ROI hypothesis" risk identified in #9975.

[IMPACT]: 90 - Extremely high structural impact. This permanently modifies how every Agent OS instantiation evaluates its initial workload, acting as a massive systemic defense against Zero-State Context Amnesia.

[COMPLEXITY]: 10 - Markdown documentation updates.

[EFFORT_PROFILE]: Quick Win - Near-instant execution with massive, compounding downstream capability gains.

🕸️ Context & Graph Linking

Target Epic / Issue ID: Resolves #9975

Related Graph Nodes: ticket-intake, pull-request

🧠 Graph Ingestion Notes

[KB_GAP]: Previously, fresh agent instances incorrectly assumed they "knew" if they had attempted a feature before. The introduction of the "Historical Amnesia Check" formally mandates active extraction of the Memory Core domain to eliminate this hallucination vector.

[TOOLING_GAP]: N/A

[RETROSPECTIVE]: "Unknown Unknowns" can only be resolved by blind search. The most sophisticated Agent framework must structurally assume it knows nothing at the top of an execution cycle to leverage its own historical graph safely.

📋 Required Actions

To proceed with merging, please address the following:

Governance and syntax check (Auto-approved).

Ship it!