0xray 4.0.0 → 4.0.1

package/.mcp.json

@@ -1,79 +1,39 @@
 {
   "mcpServers": {
     "xray-governance": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "0xray",
-        "mcp",
-        "governance"
-      ],
+      "command": "node",
+      "args": ["dist/cli/index.js", "mcp", "governance"],
       "env": {
         "XRAY_FORCE_MCP_GOVERNANCE": "true"
       }
     },
     "xray-skills": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "0xray",
-        "mcp",
-        "skills"
-      ]
+      "command": "node",
+      "args": ["dist/cli/index.js", "mcp", "skills"]
     },
     "xray-enforcer": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "0xray",
-        "mcp",
-        "enforcer"
-      ]
+      "command": "node",
+      "args": ["dist/cli/index.js", "mcp", "enforcer"]
     },
     "xray-orchestrator": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "0xray",
-        "mcp",
-        "orchestrator"
-      ]
+      "command": "node",
+      "args": ["dist/cli/index.js", "mcp", "orchestrator"]
     },
     "xray-researcher": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "0xray",
-        "mcp",
-        "researcher"
-      ]
+      "command": "node",
+      "args": ["dist/cli/index.js", "mcp", "researcher"]
     },
     "xray-code-review": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "0xray",
-        "mcp",
-        "code-review"
-      ]
+      "command": "node",
+      "args": ["dist/cli/index.js", "mcp", "code-review"]
     },
     "xray-architect-tools": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "0xray",
-        "mcp",
-        "architect-tools"
-      ]
+      "command": "node",
+      "args": ["dist/cli/index.js", "mcp", "architect-tools"]
     },
     "repertoire": {
       "command": "node",
-      "args": [
-        "/tmp/xray-v4-validate/node_modules/@0xray/repertoire/dist/mcp/server.js"
-      ],
-      "env": {
-        "XRAY_ROOT": "/tmp/xray-v4-validate"
-      }
+      "args": ["scripts/mjs/run-repertoire-mcp.mjs"]
     }
   }
 }

package/.xray/features.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./features.schema.json",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "0xRay Framework - Unified Feature Configuration",
   "suit_temperament": {
     "profile": "auto",
@@ -182,4 +182,4 @@
       "onChain": false
     }
   }
-}
+}

package/AGENTS-consumer.md

@@ -4,9 +4,9 @@
 
 Quick reference for the 0xRay AI orchestration framework (shipped to your project on `npm install 0xray`).
 
-**v4.0.0** — a suit that survives the context window.
+**v4.0.1** — a suit that survives the context window
 
-**v4.0.0** — same **three-subsystem OS** as v2 (Inference · External Governance · Autonomous Engine). Constitution always on. Temperament scales ceremony. Four platform bridges. Repertoire auto-enables when the module is present; otherwise `memory_routing` stays off. Trim fat, do not gut the design.
+Same **three-subsystem OS** as v2 (Inference · External Governance · Autonomous Engine). Constitution always on. Temperament scales ceremony. Four platform bridges. Repertoire organ ships **on** (vendored 0.2); opt out with `"enabled": false, "provider": "repertoire"`. Trim fat, do not gut the design.
 
 **Governance always on** (Codex PreToolUse, no new surface, no `eval`). **Engine ceremony** (analyze-complexity before spawn, confer) is **guided** by default so free-model OpenCode/Hermes stay in check. Frontier hosts (Grok 4.6 class) with `suit_temperament.profile: auto` **warn** on spawn-without-plan instead of deny — the engine is still there. Existing `.xray/features.json` without `suit_temperament` stays **guided**. Docs: v3 from v2 · Suit temperament.
 
@@ -63,7 +63,7 @@ Governance deliberation uses **code-review**, **security-audit** (via enforcer/s
 
 xray operates under the three-subsystem model: **Inference** + **External Governance** (Dynamo Solar SSOT) + **Autonomous Engine** (thinDispatch 7-flow in MCP orchestrator). All actions are validated against the Universal Development Codex before execution.
 
-**Codex**: `.xray/codex.json` — **68 terms** across all agent interactions.
+**Codex**: `.xray/codex.json` — **69 terms** across all agent interactions.
 
 ## thinDispatch Routing
 

package/AGENTS.md

@@ -1,8 +1,8 @@
 # xray Agents
 
-Quick reference for the xray AI orchestration framework (**v4.0.0**).
+Quick reference for the xray AI orchestration framework (**v4.0.1**).
 
-**v4.0.0** — a suit that survives the context window.
+**v4.0.1** — a suit that survives the context window.
 
 **Exo, not catalog.** Three-subsystem OS (Inference · External Governance · Autonomous Engine) · constitution always on · temperament by host · 4 floors · Repertoire when it resolves.
 
@@ -16,7 +16,7 @@ Before other work, Read `.xray/state/STATION.md`. Compaction and host change are
 
 xray provides intelligent multi-agent orchestration with automatic delegation and Codex compliance validation under the pure v2 three-subsystem model:
 
-- **Inference** — proposals, reflection, memory routing (optional)
+- **Inference** — proposals, reflection, memory routing (Repertoire organ on in 4.0)
 - **External Governance** — Dynamo Solar SSOT, 69-term Codex
 - **Autonomous Engine** — thinDispatch 7-flow, AsideContext, confidence gate
 
@@ -38,12 +38,12 @@ Registered in `.mcp.json`, invoked via `npx -y 0xray mcp <cmd>`:
 
 Governance deliberation: **code-review**, **security-audit**, **researcher** within the 7-server set.
 
-## Postinstall (v3.4.1)
+## Postinstall (v4.0.1)
 
 `postinstall.cjs` → `installAllBridges()`:
 
 1. `AGENTS-consumer.md` → `AGENTS.md`
-2. `SKILLS.md` + 46 skills → platform skill directories
+2. `SKILLS.md` + 45 skills → platform skill directories
 3. `.gitignore.default` → `.gitignore` (if absent)
 4. `.xray/` config (`codex.json`, `features.json`, `config.json`)
 5. `.mcp.json` (7 servers)
@@ -58,11 +58,11 @@ Governance deliberation: **code-review**, **security-audit**, **researcher** wit
 "memory_routing": {
   "enabled": true,
   "provider": "repertoire",
-  "module_path": "../repertoire/dist/provider/memory-routing-provider.js",
+  "module_path": "node_modules/@0xray/repertoire/dist/provider/memory-routing-provider.js",
   "config": {
-    "dataDir": "../repertoire/data",
-    "signalsPath": "../repertoire/data/curated_signals.json",
-    "logDir": "../repertoire/logs/groover-inference"
+    "signalsPath": "node_modules/@0xray/repertoire/data/curated_signals.json",
+    "statePath": ".xray/state/repertoire/inference-state.json",
+    "feedbackDir": ".xray/state/repertoire/feedback"
   }
 }
 ```

package/README.md

@@ -1,6 +1,8 @@
 # xray — exo for coding agents
 
-**v4.0.0** — a suit that survives the context window. Constitution always on. Temperament scales ceremony. Four host floors. Repertoire is the muscle for handoffs.
+**v4.0.1** — a suit that survives the context window
+
+![0xRay v4 exo — CONSTITUTION ON](docs-site/static/img/exo-skeleton-v4.jpg)
 
 Not a catalog of agents. The product is the **skeleton you wear**.
 
@@ -48,7 +50,7 @@ Docs: [guides/autonomy-command](docs-site/docs/guides/autonomy-command.md) · Sk
 
 | Version | Highlights |
 |---------|------------|
-| **4.0.0** | Exo + temperament. Constitution always on; ceremony by host. Repertoire enable-when-resolves + session resume. Survive the context window — still in development, not on npm yet. [vision](docs-site/docs/architecture/v4-vision.md) · [now](docs-site/docs/architecture/v4-now.md) |
+| **4.0.0** | Exo + temperament. Constitution always on; ceremony by host. Repertoire organ on (vendored 0.2). Station card survives compact/host-swap. **On npm.** [vision](docs-site/docs/architecture/v4-vision.md) · [now](docs-site/docs/architecture/v4-now.md) |
 | **3.4.1** | Unified `install-bridges.cjs` on postinstall — OpenCode, Grok, Hermes, OpenClaw in one pass. All 7 MCPs servers via `npx -y 0xray mcp <cmd>` (no `dist/` paths). Canonical `release.mjs` pipeline. |
 | **3.3.1** | Orchestrator confidence gate wired into execution planning. |
 | **3.3.0** | Pluggable **Memory Routing** (`features.json` → `memory_routing`). Repertoire is the default provider in the framework repo. |
@@ -149,11 +151,11 @@ Pluggable `memory_routing` block in `features.json` (validated by `features.sche
 "memory_routing": {
   "enabled": true,
   "provider": "repertoire",
-  "module_path": "../repertoire/dist/provider/memory-routing-provider.js",
+  "module_path": "node_modules/@0xray/repertoire/dist/provider/memory-routing-provider.js",
   "config": {
-    "dataDir": "../repertoire/data",
-    "signalsPath": "../repertoire/data/curated_signals.json",
-    "logDir": "../repertoire/logs/groover-inference"
+    "signalsPath": "node_modules/@0xray/repertoire/data/curated_signals.json",
+    "statePath": ".xray/state/repertoire/inference-state.json",
+    "feedbackDir": ".xray/state/repertoire/feedback"
   }
 }
 ```
@@ -183,7 +185,7 @@ Docs: [memory routing](docs-site/docs/guides/memory-routing.md) · [Repertoire](
 
 ## Governance & Codex
 
-- **68 terms** in `.xray/codex.json` — core, architecture, testing, performance, security, operations, governance
+- **69 terms** in `.xray/codex.json` — core, architecture, testing, performance, security, operations, governance (Codex 69: no new MCP/skill/handler surface)
 - CodexPolicyService — Governance-owned SSOT for codex loading
 - Pre-governance gate blocks non-compliant proposals
 - Active codex snapshot via `get_active_codex` MCP tool
@@ -191,27 +193,25 @@ Docs: [memory routing](docs-site/docs/guides/memory-routing.md) · [Repertoire](
 
 ## Testing
 
-| Suite | Status (v3.4.1) |
+| Suite | Status (v4.0.1) |
 |-------|-----------------|
-| Unit / Integration | 185 files, **3,226 passed** |
-| OpenCode E2E | 42/42 solo, 34/34 orchestrator |
-| Grok CLI E2E | 62/0 failures (v3.2.0 verified) |
-| OpenClaw E2E | 9/9 (v3.2.0 verified) |
-| Hermes E2E | 44/0/0 (v3.2.0 verified) |
-| Consumer smoke | `npm run release:gate` — pack → clean install → 7 MCPs + 4 bridges |
+| Four-floor consumer e2e | OpenCode 34/0 · Grok 63/0 · Hermes 39/0/2 · OpenClaw 96/0/1 (npm 4.0.0 pack) |
+| Consumer smoke | `npm run release:gate` — pack → clean install → 7 MCPs + 4 bridges + organ on |
 
 ```bash
 npm test
-npm run release:gate    # full release gate
+npm run release:gate    # full release gate (before upload)
+npm run release:npm     # gate + prepare + npm publish --access public
 ```
 
 ## Release
 
+Product **4.0.0** is on npm. Do **not** run `release:major` to ship a 4.x fix (that becomes 5.0.0). Do **not** put a `scripts.publish` lifecycle that re-runs the gate after the registry PUT.
+
 ```bash
-npm run release:patch   # canonical pipeline
-npm run release:minor
-npm run release:major
-npm run release:patch -- --dry-run
+npm run release:gate
+npm run release:npm     # after gate is green; uses npm publish --access public
+npm run release:patch   # version bump pipeline (not for a already-bumped 4.0.0)
 ```
 
 Pipeline: reconcile-version → release-gate (build + test + consumer smoke) → CHANGELOG/README/AGENTS artifacts → commit → tag → npm publish.

package/SKILLS.md

@@ -1,6 +1,6 @@
 # 0xray Skills
 
-**v4.0.0** — **45 skills** · invoked via `xray-skills` MCP · synced on postinstall
+**v4.0.1** — **45 skills** · invoked via `xray-skills` MCP · synced on postinstall
 
 xray ships 45 knowledge skills (`src/skills/<name>/SKILL.md`) across the full software lifecycle. Lead-dev operating model lives in **`orchestrator`** skill + `multi_agent_orchestration.lead_dev_mode` in features.json. Skills load on demand via the **xray-skills** MCP server (`npx -y 0xray mcp skills`), agent `@mentions`, or platform skill directories after postinstall.
 
@@ -157,7 +157,7 @@ npx 0xray skill:install <source>
 |---------|------------------|
 | **Memory routing** (v3.3) | Researcher uses Repertoire signals; optional `@0xray/repertoire` MCP |
 | **AsideContext** (v3.2) | Orchestrator subcontexts during skill dispatch |
-| **7 MCP servers** (v3.4.1) | `xray-skills` is the primary skill invocation surface |
+| **7 MCP servers** (v4.0.1) | `xray-skills` is the primary skill invocation surface |
 
 Docs: [AGENTS.md](AGENTS.md) · [README.md](README.md) · [Docusaurus guides](docs-site/docs/guides/)
 

package/dist/AGENTS.md

@@ -1,8 +1,8 @@
 # xray Agents
 
-Quick reference for the xray AI orchestration framework (**v4.0.0**).
+Quick reference for the xray AI orchestration framework (**v4.0.1**).
 
-**v4.0.0** — a suit that survives the context window.
+**v4.0.1** — a suit that survives the context window.
 
 **Exo, not catalog.** Three-subsystem OS (Inference · External Governance · Autonomous Engine) · constitution always on · temperament by host · 4 floors · Repertoire when it resolves.
 
@@ -16,7 +16,7 @@ Before other work, Read `.xray/state/STATION.md`. Compaction and host change are
 
 xray provides intelligent multi-agent orchestration with automatic delegation and Codex compliance validation under the pure v2 three-subsystem model:
 
-- **Inference** — proposals, reflection, memory routing (optional)
+- **Inference** — proposals, reflection, memory routing (Repertoire organ on in 4.0)
 - **External Governance** — Dynamo Solar SSOT, 69-term Codex
 - **Autonomous Engine** — thinDispatch 7-flow, AsideContext, confidence gate
 
@@ -38,12 +38,12 @@ Registered in `.mcp.json`, invoked via `npx -y 0xray mcp <cmd>`:
 
 Governance deliberation: **code-review**, **security-audit**, **researcher** within the 7-server set.
 
-## Postinstall (v3.4.1)
+## Postinstall (v4.0.1)
 
 `postinstall.cjs` → `installAllBridges()`:
 
 1. `AGENTS-consumer.md` → `AGENTS.md`
-2. `SKILLS.md` + 46 skills → platform skill directories
+2. `SKILLS.md` + 45 skills → platform skill directories
 3. `.gitignore.default` → `.gitignore` (if absent)
 4. `.xray/` config (`codex.json`, `features.json`, `config.json`)
 5. `.mcp.json` (7 servers)
@@ -58,11 +58,11 @@ Governance deliberation: **code-review**, **security-audit**, **researcher** wit
 "memory_routing": {
   "enabled": true,
   "provider": "repertoire",
-  "module_path": "../repertoire/dist/provider/memory-routing-provider.js",
+  "module_path": "node_modules/@0xray/repertoire/dist/provider/memory-routing-provider.js",
   "config": {
-    "dataDir": "../repertoire/data",
-    "signalsPath": "../repertoire/data/curated_signals.json",
-    "logDir": "../repertoire/logs/groover-inference"
+    "signalsPath": "node_modules/@0xray/repertoire/data/curated_signals.json",
+    "statePath": ".xray/state/repertoire/inference-state.json",
+    "feedbackDir": ".xray/state/repertoire/feedback"
   }
 }
 ```

package/dist/CHANGELOG.md

@@ -4,9 +4,25 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Conventional Commits](https://www.conventionalcommits.org/).
 
-## [4.0.0] - 2026-08-28
+## [4.0.1] - 2026-09-02
 
-First ship of the **temperament** line on the **v2 three-subsystem OS** (Inference · External Governance · Autonomous Engine). npm is still `3.5.5`; this line is **4.0.0** on `feat/v4-temperament` — **still in development, not published**.
+Patch on the 4.0 temperament line. npm **4.0.0** stays latest until this tag publishes.
+
+### 🐛 Bug Fixes
+- CLI `-V` / `--version` no longer dumps a Commander stack after `exitOverride`
+- Hermes: post-processor logs `[nudge]`; e2e calls `session-start`
+- OpenClaw e2e reads `plugins.entries` (OpenClaw 2026.8.2)
+- Release gate: consumer smoke expects organ **on**; no `scripts.publish` after the registry PUT; reconcile allows tagged-but-unpublished
+
+### 📚 Documentation
+- Archive catalog / enterprise Docusaurus boiler; live site is exo wear
+- Version-manager stamps live Docusaurus kernel headers (no archived `docs-site/docs/README.md`)
+
+---
+
+## [4.0.0] - 2026-09-02
+
+First ship of the **temperament** line on the **v2 three-subsystem OS** (Inference · External Governance · Autonomous Engine). npm **4.0.0**. Tag `v4.0.0` on `0xRayAI/xray` `main` (`f80b42c`).
 
 ### ✨ Features
 - **Factory memory organ** — `@0xray/repertoire@0.2.0` vendored as a runtime dependency. Shipped `memory_routing` is **on** (8 factory primitives). Extra host MCP stays `repertoire`, not an 8th `xray-*` server. Compact ingest writes `.xray/state/repertoire/`. Explicit opt-out: `enabled: false` + `provider: "repertoire"`.

package/dist/README.md

@@ -1,6 +1,8 @@
 # xray — exo for coding agents
 
-**v4.0.0** — a suit that survives the context window. Constitution always on. Temperament scales ceremony. Four host floors. Repertoire is the muscle for handoffs.
+**v4.0.1** — a suit that survives the context window
+
+![0xRay v4 exo — CONSTITUTION ON](docs-site/static/img/exo-skeleton-v4.jpg)
 
 Not a catalog of agents. The product is the **skeleton you wear**.
 
@@ -48,7 +50,7 @@ Docs: [guides/autonomy-command](docs-site/docs/guides/autonomy-command.md) · Sk
 
 | Version | Highlights |
 |---------|------------|
-| **4.0.0** | Exo + temperament. Constitution always on; ceremony by host. Repertoire enable-when-resolves + session resume. Survive the context window — still in development, not on npm yet. [vision](docs-site/docs/architecture/v4-vision.md) · [now](docs-site/docs/architecture/v4-now.md) |
+| **4.0.0** | Exo + temperament. Constitution always on; ceremony by host. Repertoire organ on (vendored 0.2). Station card survives compact/host-swap. **On npm.** [vision](docs-site/docs/architecture/v4-vision.md) · [now](docs-site/docs/architecture/v4-now.md) |
 | **3.4.1** | Unified `install-bridges.cjs` on postinstall — OpenCode, Grok, Hermes, OpenClaw in one pass. All 7 MCPs servers via `npx -y 0xray mcp <cmd>` (no `dist/` paths). Canonical `release.mjs` pipeline. |
 | **3.3.1** | Orchestrator confidence gate wired into execution planning. |
 | **3.3.0** | Pluggable **Memory Routing** (`features.json` → `memory_routing`). Repertoire is the default provider in the framework repo. |
@@ -149,11 +151,11 @@ Pluggable `memory_routing` block in `features.json` (validated by `features.sche
 "memory_routing": {
   "enabled": true,
   "provider": "repertoire",
-  "module_path": "../repertoire/dist/provider/memory-routing-provider.js",
+  "module_path": "node_modules/@0xray/repertoire/dist/provider/memory-routing-provider.js",
   "config": {
-    "dataDir": "../repertoire/data",
-    "signalsPath": "../repertoire/data/curated_signals.json",
-    "logDir": "../repertoire/logs/groover-inference"
+    "signalsPath": "node_modules/@0xray/repertoire/data/curated_signals.json",
+    "statePath": ".xray/state/repertoire/inference-state.json",
+    "feedbackDir": ".xray/state/repertoire/feedback"
   }
 }
 ```
@@ -183,7 +185,7 @@ Docs: [memory routing](docs-site/docs/guides/memory-routing.md) · [Repertoire](
 
 ## Governance & Codex
 
-- **68 terms** in `.xray/codex.json` — core, architecture, testing, performance, security, operations, governance
+- **69 terms** in `.xray/codex.json` — core, architecture, testing, performance, security, operations, governance (Codex 69: no new MCP/skill/handler surface)
 - CodexPolicyService — Governance-owned SSOT for codex loading
 - Pre-governance gate blocks non-compliant proposals
 - Active codex snapshot via `get_active_codex` MCP tool
@@ -191,27 +193,25 @@ Docs: [memory routing](docs-site/docs/guides/memory-routing.md) · [Repertoire](
 
 ## Testing
 
-| Suite | Status (v3.4.1) |
+| Suite | Status (v4.0.1) |
 |-------|-----------------|
-| Unit / Integration | 185 files, **3,226 passed** |
-| OpenCode E2E | 42/42 solo, 34/34 orchestrator |
-| Grok CLI E2E | 62/0 failures (v3.2.0 verified) |
-| OpenClaw E2E | 9/9 (v3.2.0 verified) |
-| Hermes E2E | 44/0/0 (v3.2.0 verified) |
-| Consumer smoke | `npm run release:gate` — pack → clean install → 7 MCPs + 4 bridges |
+| Four-floor consumer e2e | OpenCode 34/0 · Grok 63/0 · Hermes 39/0/2 · OpenClaw 96/0/1 (npm 4.0.0 pack) |
+| Consumer smoke | `npm run release:gate` — pack → clean install → 7 MCPs + 4 bridges + organ on |
 
 ```bash
 npm test
-npm run release:gate    # full release gate
+npm run release:gate    # full release gate (before upload)
+npm run release:npm     # gate + prepare + npm publish --access public
 ```
 
 ## Release
 
+Product **4.0.0** is on npm. Do **not** run `release:major` to ship a 4.x fix (that becomes 5.0.0). Do **not** put a `scripts.publish` lifecycle that re-runs the gate after the registry PUT.
+
 ```bash
-npm run release:patch   # canonical pipeline
-npm run release:minor
-npm run release:major
-npm run release:patch -- --dry-run
+npm run release:gate
+npm run release:npm     # after gate is green; uses npm publish --access public
+npm run release:patch   # version bump pipeline (not for a already-bumped 4.0.0)
 ```
 
 Pipeline: reconcile-version → release-gate (build + test + consumer smoke) → CHANGELOG/README/AGENTS artifacts → commit → tag → npm publish.

package/dist/SKILLS.md

@@ -1,6 +1,6 @@
 # 0xray Skills
 
-**v4.0.0** — **45 skills** · invoked via `xray-skills` MCP · synced on postinstall
+**v4.0.1** — **45 skills** · invoked via `xray-skills` MCP · synced on postinstall
 
 xray ships 45 knowledge skills (`src/skills/<name>/SKILL.md`) across the full software lifecycle. Lead-dev operating model lives in **`orchestrator`** skill + `multi_agent_orchestration.lead_dev_mode` in features.json. Skills load on demand via the **xray-skills** MCP server (`npx -y 0xray mcp skills`), agent `@mentions`, or platform skill directories after postinstall.
 
@@ -157,7 +157,7 @@ npx 0xray skill:install <source>
 |---------|------------------|
 | **Memory routing** (v3.3) | Researcher uses Repertoire signals; optional `@0xray/repertoire` MCP |
 | **AsideContext** (v3.2) | Orchestrator subcontexts during skill dispatch |
-| **7 MCP servers** (v3.4.1) | `xray-skills` is the primary skill invocation surface |
+| **7 MCP servers** (v4.0.1) | `xray-skills` is the primary skill invocation surface |
 
 Docs: [AGENTS.md](AGENTS.md) · [README.md](README.md) · [Docusaurus guides](docs-site/docs/guides/)
 

package/dist/cli/index.js

@@ -984,4 +984,13 @@ For more information, visit: https://github.com/0xRayAI/xray
 `);
 // Parse command line arguments
 program.exitOverride();
-program.parse();
+try {
+    program.parse();
+}
+catch (err) {
+    const code = err && typeof err === 'object' && 'code' in err ? String(err.code) : '';
+    if (code === 'commander.helpDisplayed' || code === 'commander.help' || code === 'commander.version') {
+        process.exit(0);
+    }
+    throw err;
+}

package/dist/integrations/hermes-agent/bridge.mjs

@@ -332,6 +332,12 @@ async function runProcessors(tool, args, phase, projectRoot, logDir) {
         priority: 30,
         enabled: true,
       });
+      processorManager.registerProcessor({
+        name: "nudge",
+        type: "post",
+        priority: 78,
+        enabled: true,
+      });
     }
 
     let results;
@@ -512,6 +518,7 @@ async function handlePostProcess(input, projectRoot, logDir) {
   });
 
   logToActivity(logDir, `post-process: complete duration=${duration}ms processors=${processorResult.success}`);
+  logToActivity(logDir, `[nudge] post-process tool=${tool}`);
 
   // Log routing outcome for test verification
   logRoutingOutcome(logDir, {

package/dist/integrations/openclaw/plugin/xray-pre-tool/package.json

@@ -1,10 +1,12 @@
 {
   "name": "xray-pre-tool",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "private": true,
   "type": "module",
   "description": "0xRay constitution + temperament PreToolUse for OpenClaw",
   "openclaw": {
-    "extensions": ["./index.js"]
+    "extensions": [
+      "./index.js"
+    ]
   }
 }

package/opencode.json

@@ -96,14 +96,6 @@
         "architect-tools"
       ],
       "enabled": true
-    },
-    "repertoire": {
-      "type": "local",
-      "command": [
-        "node",
-        "/tmp/xray-v4-validate/node_modules/@0xray/repertoire/dist/mcp/server.js"
-      ],
-      "enabled": true
     }
   },
   "agent": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "0xray",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Multi-agent orchestration and Codex governance for OpenCode, Hermes, Grok Build, and OpenClaw",
   "readme": "README.md",
   "license": "MIT",
@@ -124,7 +124,7 @@
     "release:docs-check": "node scripts/node/validate-release-docs.mjs",
     "pre-publish-guard": "node scripts/node/pre-publish-guard.js",
     "safe-publish": "npm run prepare-consumer && npm run build",
-    "publish": "npm run release:gate && npm run safe-publish && npm publish --access public",
+    "release:npm": "npm run release:gate && npm run safe-publish && npm publish --access public",
     "release:patch": "node scripts/node/release.mjs patch",
     "verify:orchestrator-behavior": "npm run build && node scripts/mjs/verify-orchestrator-behavior.mjs",
     "verify:grok-delegation-gate": "npm run build && node scripts/mjs/verify-grok-delegation-gate.mjs && node scripts/mjs/verify-grok-synthesis-gate.mjs",

package/scripts/node/consumer-install-smoke.mjs

@@ -48,9 +48,14 @@ function assertFreshInstallDefaults(tmpRoot, version) {
   if (!features.memory_routing) {
     throw new Error("Deployed features.json missing memory_routing block");
   }
-  if (features.memory_routing.enabled !== false) {
+  if (features.memory_routing.enabled !== true) {
     throw new Error(
-      `Fresh install must default memory_routing.enabled=false (got ${features.memory_routing.enabled})`,
+      `Fresh 4.0 install must ship memory_routing.enabled=true with the vendored organ (got ${features.memory_routing.enabled})`,
+    );
+  }
+  if (features.memory_routing.provider !== "repertoire") {
+    throw new Error(
+      `Fresh install memory_routing.provider must be repertoire (got ${features.memory_routing.provider})`,
     );
   }
   if (!features.inference_governance) {
@@ -59,6 +64,33 @@ function assertFreshInstallDefaults(tmpRoot, version) {
   if (features.inference_governance.enabled !== false) {
     throw new Error("Fresh install must default inference_governance.enabled=false");
   }
+  const organHoisted = path.join(tmpRoot, "node_modules", "@0xray", "repertoire", "package.json");
+  const organNested = path.join(
+    tmpRoot,
+    "node_modules",
+    "0xray",
+    "node_modules",
+    "@0xray",
+    "repertoire",
+    "package.json",
+  );
+  const organVendor = path.join(
+    tmpRoot,
+    "node_modules",
+    "0xray",
+    "vendor",
+    "@0xray",
+    "repertoire",
+    "package.json",
+  );
+  const organPkg = [organNested, organHoisted, organVendor].find((p) => fs.existsSync(p));
+  if (!organPkg) {
+    throw new Error("vendored @0xray/repertoire missing from fresh tarball install");
+  }
+  const organ = JSON.parse(fs.readFileSync(organPkg, "utf-8"));
+  if (organ.version !== "0.2.0") {
+    throw new Error(`expected organ 0.2.0, got ${organ.version}`);
+  }
   console.log("  ✅ .xray/features.json fresh-install defaults (opt-in off)");
   return { consumerFeaturesPath, features };
 }
@@ -114,6 +146,27 @@ function runUpgradeMergeSmoke(tmpRoot, nmRoot, version) {
   if (shippedMarker && !merged[shippedMarker]) {
     throw new Error(`Upgrade merge missing shipped template key: ${shippedMarker}`);
   }
+  fs.writeFileSync(
+    consumerFeaturesPath,
+    `${JSON.stringify(
+      {
+        version: "3.5.5",
+        memory_routing: { enabled: false, provider: "repertoire" },
+      },
+      null,
+      2,
+    )}\n`,
+  );
+  deployXrayConfig(tmpRoot, nmRoot, () => {});
+  const optedOut = JSON.parse(fs.readFileSync(consumerFeaturesPath, "utf-8"));
+  if (optedOut.memory_routing?.enabled !== false) {
+    throw new Error(
+      `Upgrade merge must keep explicit memory_routing opt-out (got ${optedOut.memory_routing?.enabled})`,
+    );
+  }
+  if (optedOut.memory_routing?.provider !== "repertoire") {
+    throw new Error("Upgrade merge dropped memory_routing.provider on opt-out");
+  }
 
   console.log("  ✅ upgrade merge preserves opt-ins + bumps features.version");
 }

package/scripts/node/reconcile-version.mjs

@@ -131,10 +131,6 @@ function main() {
     fail(`package.json (${local}) is behind latest tag v${tag}`);
   }
 
-  if (tag && compare(local, tag) === 0 && compare(npm, local) < 0) {
-    fail(`tag v${tag} exists but npm is only ${npm} — publish or retag`);
-  }
-
   if (tag && compare(local, tag) > 0 && compare(npm, tag) === 0) {
     console.log(`✅ Ready to tag v${local} (npm at ${npm})`);
   } else if (compare(local, npm) > 0) {

package/scripts/node/universal-version-manager.js

@@ -152,7 +152,7 @@ const OFFICIAL_VERSIONS = {
   framework: {
     version: PACKAGE_VERSION,
       displayName: "xray: Self-Healing AI Governance OS",
-      lastUpdated: "2026-06-19",
+      lastUpdated: "2026-09-02",
     // Counts (auto-calculated, but can be overridden)
     ...CALCULATED_COUNTS,
   },

package/scripts/node/version-manager.mjs

@@ -320,11 +320,13 @@ function updateReadme(counts, newVersion) {
 }
 
 export const DOCS_SITE_HEADER_FILES = [
-  'docs-site/docs/README.md',
   'docs-site/docs/index.md',
   'docs-site/docs/introduction.md',
   'docs-site/docs/guides/getting-started.md',
   'docs-site/docs/full-reference.md',
+  'docs-site/docs/architecture/GROK_GUIDE.md',
+  'docs-site/docs/mcp/README.md',
+  'docs-site/docs/agents/README.md',
 ];
 
 export function buildDocsHeader(_counts, newVersion) {
@@ -356,6 +358,22 @@ function updatePluginJsonVersion(newVersion) {
   console.log(`✅ Updated .grok-plugin/plugin.json (version: ${newVersion})`);
 }
 
+function updateJsonVersionField(relPath, newVersion) {
+  const full = path.join(rootDir, relPath);
+  if (!fs.existsSync(full)) return;
+  const data = JSON.parse(fs.readFileSync(full, 'utf-8'));
+  data.version = newVersion;
+  fs.writeFileSync(full, JSON.stringify(data, null, 2) + '\n');
+}
+
+function updateFeaturesJsonVersion(newVersion) {
+  updateJsonVersionField('xray/features.json', newVersion);
+}
+
+function updateOpenclawPluginVersion(newVersion) {
+  updateJsonVersionField('src/integrations/openclaw/plugin/xray-pre-tool/package.json', newVersion);
+}
+
 function updateConsumerAgentsHeader(newVersion, counts) {
   const consumerPath = path.join(rootDir, 'AGENTS-consumer.md');
   if (!fs.existsSync(consumerPath)) return;
@@ -401,15 +419,20 @@ function applyAgentCountUpdates(content, counts) {
 /**
  * Update AGENTS.md with actual framework counts
  */
-function updateAgentsMd(counts) {
+function updateAgentsMd(counts, newVersion = getCurrentVersion()) {
   const agentsPath = path.join(rootDir, 'AGENTS.md');
   if (!fs.existsSync(agentsPath)) {
-    console.log(`⚠️  AGENTS.md not found, skipping`);
     return;
   }
 
-  fs.writeFileSync(agentsPath, applyAgentCountUpdates(fs.readFileSync(agentsPath, 'utf-8'), counts));
-  console.log(`✅ Updated AGENTS.md`);
+  let agentsMd = applyAgentCountUpdates(fs.readFileSync(agentsPath, 'utf-8'), counts);
+  agentsMd = agentsMd.replace(/\(\*\*v[\d.]+\*\*\)/, `(**v${newVersion}**)`);
+  agentsMd = agentsMd.replace(
+    /^\*\*v[\d.]+\*\* — a suit that survives the context window\.?$/m,
+    buildDocsHeader(counts, newVersion),
+  );
+  agentsMd = agentsMd.replace(/^## Postinstall \(v[\d.]+\)$/m, `## Postinstall (v${newVersion})`);
+  fs.writeFileSync(agentsPath, agentsMd);
 }
 
 function updateAgentsConsumerMd(counts) {
@@ -516,8 +539,10 @@ function updateVersion(newVersion, changeDescription = '') {
   updateReadme(counts, newVersion);
   syncDocsSiteHeaders(counts, newVersion);
   updatePluginJsonVersion(newVersion);
+  updateFeaturesJsonVersion(newVersion);
+  updateOpenclawPluginVersion(newVersion);
   updateConsumerAgentsHeader(newVersion, counts);
-  updateAgentsMd(counts);
+  updateAgentsMd(counts, newVersion);
   updateAgentsConsumerMd(counts);
   updateSkillsMd(counts, newVersion);
   
@@ -555,7 +580,6 @@ export function getReleaseArtifactPaths() {
     'SKILLS.md',
     '.grok-plugin/plugin.json',
     'docs/README.md',
-    'docs-site/docs/README.md',
     'docs-site/docs/index.md',
     'docs-site/docs/introduction.md',
     'docs-site/docs/guides/getting-started.md',
@@ -569,7 +593,9 @@ export function getReleaseArtifactPaths() {
     'docs-site/docs/guides/consumer-migration.md',
     'docs-site/docs/mcp/README.md',
     'docs-site/docs/agents/README.md',
+    'docs-site/docs/architecture/GROK_GUIDE.md',
     'docs-site/sidebars.ts',
+    'xray/features.json',
   ];
   return candidates.filter((rel) => fs.existsSync(path.join(rootDir, rel)));
 }
@@ -584,9 +610,11 @@ function updateReleaseArtifactsOnly(changeDescription = '') {
   updateReadme(counts, current);
   syncDocsSiteHeaders(counts, current);
   updatePluginJsonVersion(current);
+  updateFeaturesJsonVersion(current);
+  updateOpenclawPluginVersion(current);
   updateConsumerAgentsHeader(current, counts);
   updateDocsReadme(current);
-  updateAgentsMd(counts);
+  updateAgentsMd(counts, current);
   updateAgentsConsumerMd(counts);
   updateSkillsMd(counts, current);
   runReleaseDocsValidation();
@@ -648,6 +676,8 @@ function main() {
     updateReadme(counts, current);
     syncDocsSiteHeaders(counts, current);
     updatePluginJsonVersion(current);
+    updateFeaturesJsonVersion(current);
+    updateOpenclawPluginVersion(current);
     updateConsumerAgentsHeader(current, counts);
     updateDocsReadme(current);
     updateAgentsMd(counts);

package/src/integrations/openclaw/plugin/xray-pre-tool/package.json

@@ -1,10 +1,12 @@
 {
   "name": "xray-pre-tool",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "private": true,
   "type": "module",
   "description": "0xRay constitution + temperament PreToolUse for OpenClaw",
   "openclaw": {
-    "extensions": ["./index.js"]
+    "extensions": [
+      "./index.js"
+    ]
   }
 }

package/xray/features.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./features.schema.json",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "0xRay Framework - Unified Feature Configuration",
   "suit_temperament": {
     "profile": "auto",
@@ -182,4 +182,4 @@
       "onChain": false
     }
   }
-}
+}