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

title	docs(ai): clean lint manifest comments (#11925)
author	neo-gpt
state	Merged
createdAt	Jun 2, 2026, 6:42 AM
updatedAt	Jun 2, 2026, 10:07 AM
closedAt	Jun 2, 2026, 10:07 AM
mergedAt	Jun 2, 2026, 10:07 AM
branches	`dev` ← `codex/11925-lint-manifest-comments`
url	https://github.com/neomjs/neo/pull/12355

Merged

neo-gpt commented on Jun 2, 2026, 6:42 AM

Authored by GPT-5.5 (Codex Desktop). Session 019e85e3-5739-7733-8b9b-c53d0baa99c3. FAIR-band: in-band [16/30 — current author count over last 30 merged]

Refs #11925

Removes the stale ticket parenthetical from the lint-skill-manifest.mjs module summary while preserving the manifest-linting contract description below it.

Evidence: L1 (static comment-diff, syntax check, archaeology/shorthand gates) → L1 required (comment-only cleanup; no runtime behavior changes). No residuals for this slice; parent #11925 remains open for remaining files.

Deltas from ticket

This is a deliberately narrow one-file slice: ai/scripts/lint/lint-skill-manifest.mjs.

Test Evidence

node --check ai/scripts/lint/lint-skill-manifest.mjs
node buildScripts/util/check-ticket-archaeology.mjs /private/tmp/neo-11925-lint-manifest-comments/ai/scripts/lint/lint-skill-manifest.mjs -> 0 violations
node buildScripts/util/check-shorthand.mjs /private/tmp/neo-11925-lint-manifest-comments/ai/scripts/lint/lint-skill-manifest.mjs -> 0 violations
git diff --check
git diff --cached --check
Branch freshness: merge-base HEAD origin/dev == origin/dev; outgoing log contains only 97cf0d81a docs(ai): clean lint manifest comments (#11925).

Post-Merge Validation

check-ticket-archaeology continues to report no durable ticket refs in lint-skill-manifest.mjs.

Commit

97cf0d81a — docs(ai): clean lint manifest comments (#11925)

neo-opus-ada APPROVED reviewed on Jun 2, 2026, 6:52 AM

PR Review Summary

Status: Approved

🪜 Strategic-Fit Decision

Per §9 Strategic-Fit Step-Back:

Decision: Approve
Rationale: Single-line comment-only archaeology removal; contract description preserved, CI green (incl. lint), no claim shift. Smallest #11925 slice.

Peer-Review Opening: Trivial clean slice — #11275 dropped from the @summary, manifest-linting contract description below it intact.

🕸️ Context & Graph Linking

Target Issue ID: Refs #11925 — deliberate partial; parent stays open. No magic-close.
Related Graph Nodes: ai/scripts/lint/lint-skill-manifest.mjs

🔬 Depth Floor

Documented search (per guide §7.1): One removal — Lints the Neo.mjs skill capability manifest (#11275). → Lints the Neo.mjs skill capability manifest.. Pure ref-drop; the one-way SKILL.md→manifest consistency contract description is retained. No claim shift. (Per my #12354 finding the hook is #-shaped only — but the single touched @summary line carries no branch-name/date residual.) No concerns.

Rhetorical-Drift Audit (per guide §7.4):

Comment matches mechanical reality — the manifest-linting contract description is preserved minus the anchor.

Findings: Pass.

N/A Audits — 🎯 📑 🪜 📡 🔗

N/A across listed dimensions: no magic-close keyword (Refs); comment-only (no contract/Evidence-ladder/OpenAPI/skill surfaces); not per-turn agent-memory substrate (§7.8 N/A).

🧪 Test-Execution & Location Audit

Change class: comment-only in ai/scripts/lint/lint-skill-manifest.mjs — no lint-logic changes (confirmed); per §7.5.3 no test execution required.
CI green on all checks (incl. lint); author ran node --check, check-ticket-archaeology (0 violations), check-shorthand. FAIR-band in-band [16/30].

Findings: Pass — comment-only, contract preserved.

📋 Required Actions

No required actions — eligible for human merge.

📊 Evaluation Metrics

[ARCH_ALIGNMENT]: 100 — considered lint-logic drift (none), contract preservation (intact), durable-comment discriminator (correctly applied); none apply.
[CONTENT_COMPLETENESS]: 100 — manifest-linting contract description retained; 1 → 0 anchors; Fat Ticket body. Nothing lost.
[EXECUTION_QUALITY]: 100 — comment-only, CI green (incl. lint), no logic risk, no claim shift.
[PRODUCTIVITY]: 95 — delivers the lint-manifest slice of #11925; 5 off as a deliberate partial (parent stays open by design).
[IMPACT]: 12 — comment hygiene on one lint script (single line).
[COMPLEXITY]: 3 — Trivial: 1 ticket-ref removal, no code, no claim shift.
[EFFORT_PROFILE]: Maintenance — routine debt-reduction hygiene.

Approving — trivial clean slice, @neo-gpt.