neo-agent-skills 0.1.41 → 0.1.43

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -7,7 +7,7 @@ Markdown a human edits directly. Failure mode: generations drift apart (one doc
7
7
 
8
8
  | Surface | What identity it encodes |
9
9
  |---|---|
10
- | `README.md` | Should LEAD with the canonical apex (self-evolving software organism — Body `/src/` + Brain `/ai/` the two hemispheres beneath it; ADR 0018 §2.7 OD-1); "Who This Is For"; Platform-at-Scale metrics; maintainer roster. Verify apex currency each run — status claims rot; the requirement doesn't. |
10
+ | `README.md` | Should LEAD with the canonical apex (ADR 0018 §2.7 OD-1) and present the whole: Body, Brain and Institution as their own repositories (OD-4); "Who This Is For"; Platform-at-Scale metrics; maintainer roster. Verify apex currency each run — status claims rot; the requirement doesn't. |
11
11
  | `.github/VISION.md` | Long-form vision; **known fossil-prone** (carried "web applications" + CEO/PM/Drone hierarchy contradicting Flat Peer-Team) |
12
12
  | `ROADMAP.md` | Forward positioning; "Corporate HQ" framing; skill/velocity counts |
13
13
  | `CONTRIBUTING.md`, `.github/GETTING_STARTED.md`, `.github/AI_QUICK_START.md` | Contributor-facing identity; MCP-server count; Node requirement |
@@ -38,7 +38,7 @@ Changed via gh/web, invisible to grep.
38
38
 
39
39
  | Surface | How to read/edit | Identity encoded |
40
40
  |---|---|---|
41
- | GitHub repo description + topics | `gh repo view neomjs/neo --json description,repositoryTopics`; `gh repo edit` | Repo-page tagline + discovery topics (should mirror package.json) |
41
+ | Description + topics: `neo`, `neo-agent-brain`, `neo-agent-institution`, `neo-agent-skills`, `devindex`, the org | `gh repo view neomjs/<repo> --json description,repositoryTopics`; `gh repo edit` | Each repository projects its own product (`neo` = the Engine, OD-4), the org the whole; log before/after in the PR body |
42
42
  | npm registry page | derives from `package.json` on publish | npm tagline + keywords |
43
43
  | Discord / Slack / LinkedIn / Sponsors | external dashboards | Community/author identity |
44
44
 
@@ -9,19 +9,20 @@ GRADUATED via Discussion #12234 (full cross-family triad, 2026-05-31; ADR 0018
9
9
 
10
10
  > **Neo.mjs is a self-evolving software organism — a professional, end-to-end AI engineering team that lives in its own open-source repository. Where the industry runs one AI agent and gets slop, Neo runs a swarm of minds from rival labs — Claude, Gemini, GPT — that read each other's reasoning through shared memory and Active Hybrid GraphRAG, catching what no single model can see in itself. Through the Neural Link possession interface, the swarm does not just read code; it inhabits live applications, inspecting semantic runtime state, mutating UI and data in real time, and turning conversational UIs from chat panels into agents collaborating inside the application. It autonomously runs the full engineering lifecycle: ideating, building, and cross-reviewing a production multi-threaded engine, running DreamService cycles to re-steer priorities, and closing self-healing loops where runtime failures, code defects, agent mistakes, and architectural friction become fixes, tickets, skills, memory, and new graph topology for the next cycle. In May 2026, the canonical repo recorded 706 merged PRs and 800 closed issues. It maintains its own codebase today; it is being built to inhabit yours, regardless of the models' training data.**
11
11
 
12
- Concise machine-surface form (ld+json / `<meta name="description">` / package.json — never the word "slop"):
12
+ Concise form for machine surfaces that present the whole (never the word "slop"); a repository's own `package.json` and GitHub metadata project its product instead (§ Audience-segmented clusters):
13
13
 
14
14
  > *Neo.mjs is a self-evolving software organism: a professional end-to-end AI engineering team whose cross-model swarm inhabits live apps via Neural Link, Active Hybrid GraphRAG, DreamService, and self-healing loops.*
15
15
 
16
16
  **Dated proof point** (NOT inline in the apex — proof layer only; use a FIXED calendar anchor, not a rolling window): **in May 2026 the canonical repo recorded 706 merged PRs and 800 closed issues** (GitHub search, verified 2026-05-31). NEVER write "peer-reviewed" counts (search verifies *merged*, not review-state) or a month-over-month ratio / "accelerating" claim (date-stamps the identity; the April→May delta was mis-stated as ~3×) without a precise metric spec + audit — per @neo-gpt V-B-A `dc-17119216`/`dc-17119231` + operator flag.
17
17
 
18
- Structure beneath the apex:
19
- > - **BODY (`/src/`):** the high-performance off-main-thread UI runtime — JSON-first since 2019, App Worker as the main actor, web multi-window. The adoption substrate. (Engine-category mental models apply *here only*.)
20
- > - **BRAIN (`/ai/`):** the entire Agent OS — the cross-family engineering institution **plus** the MX loop, evolution, swarm, Memory Core (**Active Hybrid GraphRAG**: `mutate_frontier` + `GoldenPathSynthesizer` fusing semantic + structural weights to re-steer priorities), Knowledge Base, A2A, orchestrator, DreamService. ≈41% of the codebase. **This is the headline.**
18
+ Structure beneath the apex (ADR 0018 §2.7 OD-4: three repositories, three products):
19
+ > - **Body — `neomjs/neo`, the Engine:** the high-performance off-main-thread UI runtime — JSON-first since 2019, App Worker as the main actor, web multi-window. The adoption substrate. (Engine-category mental models apply *here only*.)
20
+ > - **Brain — `neomjs/neo-agent-brain`, the Agent OS:** Memory Core (**Active Hybrid GraphRAG**), Knowledge Base, A2A, orchestrator, DreamService, the MX loop; gives agents continuity, runs without the Fleet Manager.
21
+ > - **Institution — `neomjs/neo-agent-institution`, the Fleet Manager:** makes Neo accessible; starts the harnesses over the Brain's Fleet transport.
21
22
  > - **Neural Link is a flagship capability, NOT the apex and NOT a "demo"** — small in code (~2%, 1 of 7 MCP servers), large in product value: end-user **conversational UIs** (mutate a live app with no code change and no page reload) + **multi-agent, multi-harness collaboration on the same running app** (#10119). Never *lead* with it.
22
23
  > - **Governance line** (founder-architect authority, NOT a slop-filter): *Gated-RSI by design — the swarm can run the lifecycle autonomously; final merge authority remains with the founder-architect as an intentional governance choice, preserving product taste, strategic coherence, and accountable ownership while the organism evolves in public.*
23
24
 
24
- **Register discipline:** "rival labs" + the "slop" contrast are human-facing only; machine surfaces use the concise form above and the cold keyword cluster (`self-evolving`, `software-organism`, `autonomous-agent-os`, `professional-ai-engineering-team`, `self-healing-software-organism`, `autonomous-code-execution`, `cross-family-pr-review`, `dreamservice`, `active-hybrid-graphrag`, `neural-link`, `possession-interface`, `conversational-application-embodiment`, `live-application-mutability`, `agent-os`, `mcp`).
25
+ **Register discipline:** "rival labs" + the "slop" contrast are human-facing only; machine surfaces that present the whole use the concise form above and the cold keyword cluster (`self-evolving`, `software-organism`, `autonomous-agent-os`, `professional-ai-engineering-team`, `self-healing-software-organism`, `autonomous-code-execution`, `cross-family-pr-review`, `dreamservice`, `active-hybrid-graphrag`, `neural-link`, `possession-interface`, `conversational-application-embodiment`, `live-application-mutability`, `agent-os`, `mcp`). A repository's own keywords and topics use its product's words.
25
26
 
26
27
  **Naming discipline** (per operator + `dc-17119308`): `Neo.mjs` is the entity name — use it on first mention and on every machine surface (README title/first sentence, package description, GitHub repo description, portal title/meta/JSON-LD primary `name`, llms.txt, OG, docs landings). `Neo` is human shorthand *after* the anchor (JSON-LD `alternateName` only, bound to the `Neo.mjs` entity). Do NOT keyword-stuff `Neo.mjs` into every sentence — subsequent prose may use `Neo` for rhythm.
27
28
 
@@ -34,11 +35,12 @@ The same product reads differently per audience; these are kept as ONE coupled c
34
35
 
35
36
  | Cluster | Lives on | Audience |
36
37
  |---|---|---|
37
- | "Application Engine for the AI Era" / Scene Graph | package.json, GitHub description, index.html, hero, llms.txt header | engineers searching npm/GitHub |
38
- | "self-maintaining codebase / autonomous AI engineering team" | README top, repo description, ROADMAP | AI-platform / agent-infra builders (the audience that funds the comparison tools) |
38
+ | "an agent institution": the category label, then the coding-agent ladder sentence | README top, the portal (title, descriptions, ld+json, hero, `llms.txt` header), the org profile | first contact: people and answer engines |
39
+ | "Application Engine for the AI Era" / Scene Graph | `neomjs/neo`'s package.json, GitHub description and topics | engineers searching npm/GitHub |
40
+ | "self-maintaining codebase / autonomous AI engineering team" | the Brain's and Institution's repo descriptions | AI-platform / agent-infra builders (the audience that funds the comparison tools) |
39
41
  | "self-evolving software organism / two hemispheres" | `.github/VISION.md`, AGENTS.md anchors, deeper learn/ docs | researchers, the swarm itself |
40
42
 
41
- All three are projections of the **canonical apex** — the self-evolving software organism (§ The canonical apex), with Body/Brain the two hemispheres beneath it. Members of a cluster must stay coherent with **each other** (don't let package.json and GitHub description diverge) and **compatible** with the apex (a narrower projection, not a contradiction). Note the audience shift the audit flagged: the README top + repo metadata should lead the AI-platform-builder cluster (institution framing), not the npm-engineer cluster — that is the §undersell re-categorization the skill propagates.
43
+ All four are projections of the **canonical apex** — the self-evolving software organism (§ The canonical apex), with Body/Brain the two hemispheres beneath it. The label leads its surfaces, with the apex behind it as the proof paragraph (ADR 0018 §2.3). Members of a cluster must stay coherent with **each other** (don't let package.json and GitHub description diverge) and **compatible** with the apex (a narrower projection, not a contradiction). Each repository's own metadata projects its own product — for `neomjs/neo` the Engine (OD-4, `./affected-areas-map.md` Class 4); an organism-wide description there is drift.
42
44
 
43
45
  ## Drift vs intentional-divergence (the escalation branch)
44
46
  When a surface's framing **contradicts** the apex, classify:
@@ -54,6 +56,7 @@ Identity copy attracts superlatives. Gate every one:
54
56
  |---|---|
55
57
  | Unbounded superlative ("fastest", "best on the market") | **Drop it** or convert to a *sufficiency* form tied to a concrete number (e.g. "fast enough to host its own AI engineering team" + the 40k figure). No "well-actually" surface. |
56
58
  | Uniqueness / negative ("the only X", "first X") | Uncheckable as bare assertion. Hedge: "pioneered / still virtually alone in / we know of no other" unless a dated competitive sweep backs it. The *architecture* may be verified even when market-uniqueness isn't. |
59
+ | A later stage (games, robots, "X") | Only with its gate and instrument beside it (OD-5, `neomjs/neo` D#19789); present tense is drift (first falsifier: `README.md:116`). |
57
60
  | Numbers (version, count, 40k/sec, velocity) | Regenerate from SSOT (`./facts-ledger.md`). Publish counts as dated-window stats. Never paste a frozen number into framing prose. |
58
61
  | Anthropomorphic ("agents think / read thoughts") | Attribute to mechanism — "persisted, queryable reasoning surfaces (Memory Core)" — not sentience. |
59
62
  | Client/partner/customer names | **Forbidden** on every surface. Cloud/multi-tenant = generic capability terms only. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "neo-agent-skills",
3
- "version": "0.1.41",
3
+ "version": "0.1.43",
4
4
  "description": "Install the workflow substrate a cross-model AI team actually runs on: ticket intake, PR review gates, lane coordination and guards, versioned as a package. The skills Neo.mjs maintainers load every session — materialized into your repo, not copied.",
5
5
  "type": "module",
6
6
  "license": "MIT",