0xray 4.0.23 → 4.0.25

package/.grok-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "0xray",
-  "version": "4.0.23",
+  "version": "4.0.25",
   "description": "0xRay suit for Grok, Hermes, OpenClaw, OpenCode: mill+inspect, Codex, 7 MCP servers. Costume 45/42 is opt-in foundry, not the default wear.",
   "author": {
     "name": "0xRay AI",

package/.xray/features.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./features.schema.json",
-  "version": "4.0.23",
+  "version": "4.0.25",
   "description": "0xRay Framework - Unified Feature Configuration",
   "suit_temperament": {
     "profile": "auto",
@@ -173,6 +173,16 @@
     "every_n_turns": 0,
     "every_n_todos_completed": 0
   },
+  "inference": {
+    "description": "Self-improvement cycle that grades a new named session into repertoire",
+    "enabled": true,
+    "workflow_dir": ".xray/inference",
+    "reports_dir": ".xray/reports",
+    "pattern_matching": {
+      "enabled": true,
+      "confidence_threshold": 0.7
+    }
+  },
   "inference_governance": {
     "enabled": false,
     "request_timeout_ms": 10000,

package/.xray/features.schema.json

@@ -97,6 +97,23 @@
         "lookback_commits": { "type": "integer", "minimum": 1 }
       }
     },
+    "inference": {
+      "type": "object",
+      "description": "Self-improvement cycle. A missing key is on. Explicit enabled false turns inference:run off unless --force.",
+      "properties": {
+        "description": { "type": "string" },
+        "enabled": { "type": "boolean" },
+        "workflow_dir": { "type": "string" },
+        "reports_dir": { "type": "string" },
+        "pattern_matching": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "confidence_threshold": { "type": "number" }
+          }
+        }
+      }
+    },
     "suit_temperament": {
       "type": "object",
       "description": "0xRay 4.0 — constitution always on; ceremony scales by host. Missing key = guided (existing consumers unchanged).",

package/AGENTS-consumer.md

@@ -6,7 +6,7 @@ Quick reference for the 0xRay AI orchestration framework worn on **{{CONSUMER_NA
 
 **4.0** — a suit that survives the context window
 
-Same **three-subsystem OS** as v2 (Inference · External Governance · Autonomous Engine). Constitution always on. Temperament scales ceremony. Four chat bridges plus Cursor project hooks. **Repertoire is preferred** — vendored 0.2.5 ships **on**. Dest is named laws, not keywords. Station is the compact ticket, not a substitute. Explicit opt-out only: `"enabled": false, "provider": "repertoire"`. 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 chat bridges plus Cursor project hooks. **Repertoire is preferred** — vendored 0.2.8 ships **on**. Dest is named laws, not keywords. Station is the compact ticket, not a substitute. Explicit opt-out only: `"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.
 

package/AGENTS.md

@@ -4,7 +4,7 @@ Quick reference for the xray AI orchestration framework (**4.0**).
 
 **4.0** — 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 preferred** (vendored 0.2.5, dest = laws).
+**Exo, not catalog.** Three-subsystem OS (Inference · External Governance · Autonomous Engine) · constitution always on · temperament by host · 4 floors · **Repertoire preferred** (vendored 0.2.8, dest = laws).
 
 **Temperament:** 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; Codex 11/29/69 still **deny**. Missing `suit_temperament` stays guided. See `docs-site/docs/architecture/v3-from-v2.md`.
 

package/README.md

@@ -14,13 +14,13 @@ Not a catalog of agents. The product is the **skeleton you wear**.
 - **Always on** — Codex 11 / 29 / 69, destructive shell, no new MCP/skill/handler surface
 - **Temperament** — `frontier` | `guided` | `strict` | `auto` — how loud the engine is, not whether governance exists
 - **Wear** — Grok, OpenCode, Hermes, OpenClaw, plus Cursor project hooks. One SSOT gate
-- **Muscle** — **Repertoire is preferred.** Vendored 0.2.5 ships **on**. Dest is named laws, not hangar `repo-*` or git slugs. Station is the compact-survival ticket — not a substitute for Repertoire.
+- **Muscle** — **Repertoire is preferred.** Vendored 0.2.8 ships **on**. Dest is named laws, not hangar `repo-*` or git slugs. Station is the compact-survival ticket — not a substitute for Repertoire.
 
 ```bash
 npm install 0xray
 ```
 
-Consumer `npm install 0xray` auto-wires four chat bridges, Cursor project hooks, and seven MCP servers. **Repertoire is preferred** — vendored **0.2.5** ships on: factory + stack laws, in-process routing, extra host MCP `repertoire`. Not an eighth `xray-*` server. Dest is a judgment index. Explicit opt-out only: `"enabled": false, "provider": "repertoire"`. Do not pin 0.1.8.
+Consumer `npm install 0xray` auto-wires four chat bridges, Cursor project hooks, and seven MCP servers. **Repertoire is preferred** — vendored **0.2.8** ships on: factory + stack laws, in-process routing, extra host MCP `repertoire`. Not an eighth `xray-*` server. Dest is a judgment index. Explicit opt-out only: `"enabled": false, "provider": "repertoire"`. Do not pin 0.1.8.
 
 ## Quick Start
 

package/SKILLS.md

@@ -4,7 +4,7 @@
 
 **45 skills** in this exo catalog. Default consumer plant is **`mill` + `inspect`**, not this dump. `npm install 0xray` does **not** sync 45 skills unless `foundry.json` `"costume": true`. Factory shop plant (`shop-extract`, `shop-witness`, `shop-pin`) coexists with mill plant when a hangar wears those shops. Extra shops: `foundry.json` `shopPlant`. Fasten is **foundry-plant/0**: builtin plant is mill+inspect only. `foundry.json` `"plant": "@0xray/blip"` (aliases `"plant": "blip"` / `"plant": "sound"`) fastens whatever that mill package declares — organs (looker, vibe, mixer) live in the mill, not this catalog. Nested mill `@0xray/foundry@0.1.12`. CLI shims `foundry blip|sound` still exist on foundry 0.1.11+. Agent map: [llms.txt](llms.txt).
 
-xray ships 45 knowledge skills (`src/skills/<name>/SKILL.md`) as the **costume / self-plant catalog**. Lead-dev operating model lives in **`orchestrator`** skill + `multi_agent_orchestration.lead_dev_mode` in features.json. **Repertoire is preferred** for long-term judgment (vendored 0.2.5, dest = named laws). Station is the compact ticket, not a skill and not a keyword store. Skills load on demand via the **xray-skills** MCP server (`npx -y 0xray mcp skills`) or when you plant them. This file is the exo catalog — mill does **not** write it to the consumer root.
+xray ships 45 knowledge skills (`src/skills/<name>/SKILL.md`) as the **costume / self-plant catalog**. Lead-dev operating model lives in **`orchestrator`** skill + `multi_agent_orchestration.lead_dev_mode` in features.json. **Repertoire is preferred** for long-term judgment (vendored 0.2.8, dest = named laws). Station is the compact ticket, not a skill and not a keyword store. Skills load on demand via the **xray-skills** MCP server (`npx -y 0xray mcp skills`) or when you plant them. This file is the exo catalog — mill does **not** write it to the consumer root.
 
 ---
 

package/dist/AGENTS.md

@@ -4,7 +4,7 @@ Quick reference for the xray AI orchestration framework (**4.0**).
 
 **4.0** — 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 preferred** (vendored 0.2.5, dest = laws).
+**Exo, not catalog.** Three-subsystem OS (Inference · External Governance · Autonomous Engine) · constitution always on · temperament by host · 4 floors · **Repertoire preferred** (vendored 0.2.8, dest = laws).
 
 **Temperament:** 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; Codex 11/29/69 still **deny**. Missing `suit_temperament` stays guided. See `docs-site/docs/architecture/v3-from-v2.md`.
 

package/dist/CHANGELOG.md

@@ -7,9 +7,13 @@ The format is based on [Conventional Commits](https://www.conventionalcommits.or
 ## [Unreleased]
 
 ### Features
+- **Plates.** Pipeline schematics live in `docs-site/docs/plates/` (routing, governance, boot, orchestration, processor, reporting, memory-recall). Station keeps one pointer line. Pre-compact and the `MEMORY_ROUTING` inject carry that one schematic. A lesson is an episode. A plate is the machine. Not a new skill.
+- **Vendored Repertoire 0.2.8.** `vendor/@0xray/repertoire` is that package. Lesson lines and retained ids stay at 20. Speech that names nothing mints a learned signal, and only those mints evict past 24. Not a new skill.
 - **Feat rebase.** When the mandated work turns into mantra, or the job has split across planes that no longer share one present, stop and answer the original message again from this seat. On `LEAD-CADENCE.md`, the orchestrator skill, and the ship-ready mill gate. Project dest grows the name `feat-rebase` from the stack overlay. Not a new skill.
 
 ### Fixed
+- **Lesson caps and speech mint.** `LESSON_LINE_CAP` is 20. `RETAINED_LESSON_ID_CAP` is 20 in insertion order. Speech that names no stored signal mints one `proposed` signal tagged `learned`. `LEARNED_SIGNAL_CAP` is 24 and evicts only those mints. Factory signals stay. Not a new skill.
+- **External grade writes the line.** `governExternalProposals` grades the signals a proposal already named, the same way the local cycle does. Needs-revision and a governance error still do not write. The vendored organ puts a missing lesson ledger back when dest still has its lines, so an aged task id does not step the average again. Not a new skill.
 - **A governed proposal teaches.** A route lookup does not write a lesson. When a vote finishes, the cycle grades the signals that proposal's sessions already named. A session that names a stored signal is graded even when that name appears once. Landed approaches and no wrong turn clear the solid band. A wrong turn stays below the cutoff. Earlier rejects of other codify proposals do not pull that grade down. Approve steps those signals up by a tenth. Reject steps them down by a tenth. Needs-revision, an abstain, a governance error, and a proposal whose sessions named nothing do not write. Proposal ids stay on the signal and the sessions not yet graded, so a later cycle does not teach those sessions again. A new session is a new id. Those ids remain after the history window of 50 fills, including with empty cycles. A proposal that carries an empty name list does not fall through to matching its text. A grade that passes appends one line — the task, the decision, and the approaches, solutions, or wrong turn from the sessions that named the law — on that signal and beside the average. The same task does not append again. The route for a law above 0.55 includes the law text and those lines, and Station's lessons section is refreshed from dest. Not a new skill.
 - **Dynamo client on a required external call.** `govern_proposals` with external governance required starts `InferenceGovernanceIntegration` even when `inference_governance.enabled` is false. Boot still skips that client while the flag is off, and the inference cycle still uses the local matrix unless the flag is on or `XRAY_FORCE_MCP_GOVERNANCE=true`. An unreadable MCP payload is stored as the error text, not an abstain at 0.5. The MCP wait matches the governance budget (90s). Not a new skill.
 - **Subsystem pass.** A session file with no `metrics.commits` is not a session, and a captured pattern with no `evidence` array is empty evidence, so the inference cycle no longer dies before it writes state. `scoreAndRoute` loads the memory organ on the first call with a synchronous require, before any dynamic import of that module. A cached null provider does not block that load, and a late null load does not replace an organ already in hand. Not a new skill.
@@ -37,6 +41,45 @@ The format is based on [Conventional Commits](https://www.conventionalcommits.or
 - Archive root `integrations/` costume SKILL dump → `docs/archive/integrations-costume/`. Live wear is `src/integrations`.
 - Archive root `commands/` stale copy → `docs/archive/commands-copy/`. Live wear is `src/opencode/commands`.
 
+## [4.0.25] - 2026-09-24
+
+`0xray@4.0.25` ships the plate schematics in the package. `docs-site/docs/plates/` is on the npm `files` list. A worn suit resolves `memory-recall` and `processor` from `dist/integrations/hooks/plates.cjs`.
+
+### 🔄 Changes
+
+### 🐛 Bug Fixes
+- fix: ship plate schematics in the npm package (b1bdd7415)
+
+### 📚 Documentation
+- docs: announce 4.0.24 — hot-swap, memory organ, plates (b04b80a15)
+
+---
+
+## [4.0.24] - 2026-09-24
+
+`0xray@4.0.24` is on npm. `npm install 0xray`.
+
+Exo, not a catalog. A factory stamps a skeleton (Inference, External Governance, Autonomous Engine) and fastens a mill. Code mill, music mill (`@0xray/blip` sound), agents across TUIs and LLMs wear it and operate.
+
+- **Hot-swappable compaction.** Compaction and host change are the same cut. The station card (`.xray/state/STATION.md`) is the handoff. The next turn continues the card.
+- **Memory organ.** Finished speech and reflections become lessons on signals. Kernel and activity logs are heat (`last_seen`) only. Unnamed speech mints a signal. Caps: 20 hot lesson lines, 20 retained ids (insertion order), 24 learned proposed signals. Factory laws stay.
+- **Plates.** One INPUT/PROCESSING/OUTPUT schematic per pipeline in `docs-site/docs/plates/`. Station keeps one pointer line. Recall injects that one schematic. A lesson is an episode. A plate is the machine.
+- **Repertoire 0.2.8** is the organ package, vendored in 4.0.24.
+
+### 🔄 Changes
+
+### 🐛 Bug Fixes
+- fix: put matched lesson speech on the MEMORY_ROUTING block (2a2f0411d)
+- fix: process reflection markdown as inference speech (64d7a6eee)
+- fix: run discovered processors and keep commit subjects off the session log (d9fb2ee15)
+- fix: grade a captured operation before the wake ends (c5760000b)
+- fix: heat no longer writes a gradeable lesson from commit subjects (ceeb3a536)
+- fix: grade a new session when another proposal already named the signal (bf4d5e59a)
+- fix: let inference:run enter the cycle and exit (12c3e5142)
+- fix: grade named signals on an external vote (5fc21d174)
+
+---
+
 ## [4.0.23] - 2026-09-23
 
 ### 🔄 Changes

package/dist/README.md

@@ -14,13 +14,13 @@ Not a catalog of agents. The product is the **skeleton you wear**.
 - **Always on** — Codex 11 / 29 / 69, destructive shell, no new MCP/skill/handler surface
 - **Temperament** — `frontier` | `guided` | `strict` | `auto` — how loud the engine is, not whether governance exists
 - **Wear** — Grok, OpenCode, Hermes, OpenClaw, plus Cursor project hooks. One SSOT gate
-- **Muscle** — **Repertoire is preferred.** Vendored 0.2.5 ships **on**. Dest is named laws, not hangar `repo-*` or git slugs. Station is the compact-survival ticket — not a substitute for Repertoire.
+- **Muscle** — **Repertoire is preferred.** Vendored 0.2.8 ships **on**. Dest is named laws, not hangar `repo-*` or git slugs. Station is the compact-survival ticket — not a substitute for Repertoire.
 
 ```bash
 npm install 0xray
 ```
 
-Consumer `npm install 0xray` auto-wires four chat bridges, Cursor project hooks, and seven MCP servers. **Repertoire is preferred** — vendored **0.2.5** ships on: factory + stack laws, in-process routing, extra host MCP `repertoire`. Not an eighth `xray-*` server. Dest is a judgment index. Explicit opt-out only: `"enabled": false, "provider": "repertoire"`. Do not pin 0.1.8.
+Consumer `npm install 0xray` auto-wires four chat bridges, Cursor project hooks, and seven MCP servers. **Repertoire is preferred** — vendored **0.2.8** ships on: factory + stack laws, in-process routing, extra host MCP `repertoire`. Not an eighth `xray-*` server. Dest is a judgment index. Explicit opt-out only: `"enabled": false, "provider": "repertoire"`. Do not pin 0.1.8.
 
 ## Quick Start
 

package/dist/SKILLS.md

@@ -4,7 +4,7 @@
 
 **45 skills** in this exo catalog. Default consumer plant is **`mill` + `inspect`**, not this dump. `npm install 0xray` does **not** sync 45 skills unless `foundry.json` `"costume": true`. Factory shop plant (`shop-extract`, `shop-witness`, `shop-pin`) coexists with mill plant when a hangar wears those shops. Extra shops: `foundry.json` `shopPlant`. Fasten is **foundry-plant/0**: builtin plant is mill+inspect only. `foundry.json` `"plant": "@0xray/blip"` (aliases `"plant": "blip"` / `"plant": "sound"`) fastens whatever that mill package declares — organs (looker, vibe, mixer) live in the mill, not this catalog. Nested mill `@0xray/foundry@0.1.12`. CLI shims `foundry blip|sound` still exist on foundry 0.1.11+. Agent map: [llms.txt](llms.txt).
 
-xray ships 45 knowledge skills (`src/skills/<name>/SKILL.md`) as the **costume / self-plant catalog**. Lead-dev operating model lives in **`orchestrator`** skill + `multi_agent_orchestration.lead_dev_mode` in features.json. **Repertoire is preferred** for long-term judgment (vendored 0.2.5, dest = named laws). Station is the compact ticket, not a skill and not a keyword store. Skills load on demand via the **xray-skills** MCP server (`npx -y 0xray mcp skills`) or when you plant them. This file is the exo catalog — mill does **not** write it to the consumer root.
+xray ships 45 knowledge skills (`src/skills/<name>/SKILL.md`) as the **costume / self-plant catalog**. Lead-dev operating model lives in **`orchestrator`** skill + `multi_agent_orchestration.lead_dev_mode` in features.json. **Repertoire is preferred** for long-term judgment (vendored 0.2.8, dest = named laws). Station is the compact ticket, not a skill and not a keyword store. Skills load on demand via the **xray-skills** MCP server (`npx -y 0xray mcp skills`) or when you plant them. This file is the exo catalog — mill does **not** write it to the consumer root.
 
 ---
 

package/dist/cli/commands/validate.js

@@ -22,6 +22,9 @@ export const VALIDATE_PACK_PATHS = [
     "dist/integrations/cursor/hooks/pre-tool-use.sh",
     "dist/integrations/cursor/hooks/pre-compact.sh",
     "dist/integrations/cursor/hooks/after-file-edit.sh",
+    "dist/integrations/hooks/plates.cjs",
+    "docs-site/docs/plates/memory-recall.md",
+    "docs-site/docs/plates/processor.md",
 ];
 export const CONSUMER_WEAR_PATHS = [
     "AGENTS.md",

package/dist/cli/index.js

@@ -11,6 +11,7 @@ import { fileURLToPath } from "node:url";
 import { readFileSync, existsSync } from "fs";
 import { getConfigDir } from "../core/config-paths.js";
 import { frameworkLogger } from "../core/framework-logger.js";
+import { inferenceRunMayEnter } from "../inference/inference-run-gate.js";
 // Get package root relative to this script location
 const packageRoot = resolve(fileURLToPath(new URL("../..", import.meta.url)));
 // Read version dynamically from package.json
@@ -249,6 +250,16 @@ program
         process.exit(1);
     }
 });
+function cliReportType(value) {
+    if (value === "orchestration" ||
+        value === "agent-usage" ||
+        value === "context-awareness" ||
+        value === "performance" ||
+        value === "full-analysis") {
+        return value;
+    }
+    return "full-analysis";
+}
 program
     .command("report")
     .description("Generate framework activity and health reports")
@@ -268,7 +279,7 @@ program
         session: "full-analysis",
         ci: "full-analysis",
     };
-    let reportType = options.type;
+    let reportType = cliReportType(typeof options.type === "string" ? options.type : undefined);
     let outputFormat = "json";
     // Convenience flags override --type
     for (const [flag, mappedType] of Object.entries(typeMap)) {
@@ -629,6 +640,11 @@ program
     console.log('  --run-once  Run a single tuning cycle');
     console.log('  --status    Show tuner status');
 });
+function exitWhenFlushed(code) {
+    process.stdout.write("", () => {
+        process.exit(code);
+    });
+}
 // Inference cycle run command
 program
     .command('inference:run')
@@ -639,118 +655,133 @@ program
     .option('--no-researcher-review', 'Skip downstream researcher review of PRs')
     .option('--json', 'Output raw JSON result')
     .action(async (options) => {
-    const { InferenceCycle } = await import('../inference/inference-cycle.js');
-    const { shouldTriggerCycle } = await import('../inference/inference-accumulator.js');
-    const { accumulateCorpus } = await import('../inference/inference-accumulator.js');
-    const { featuresConfigLoader } = await import('../core/features-config.js');
-    const { initializeGovernanceIntegration, shutdownGovernanceIntegration } = await import('../integrations/governance/index.js');
-    // Guard: inference:run is internal to xray development only
-    const isxrayRepo = (() => {
-        try {
-            const pkg = JSON.parse(readFileSync(join(process.cwd(), 'package.json'), 'utf-8'));
-            return pkg.name === '0xray' && process.env.NODE_ENV !== 'consumer';
-        }
-        catch {
-            return false;
-        }
-    })();
-    if (!isxrayRepo) {
-        if (options.json) {
-            console.log(JSON.stringify({ triggered: false, reason: 'inference:run is for xray development only (internal tool)' }));
-        }
-        else {
-            console.log('The inference:run command is for xray framework development only.');
-            console.log('It is not intended for consumer projects.');
-        }
-        return;
-    }
-    const features = featuresConfigLoader.loadConfig();
-    const inferenceConfig = features?.inference;
-    if (!inferenceConfig?.enabled) {
-        if (options.json) {
-            console.log(JSON.stringify({ triggered: false, reason: 'Inference feature disabled in features.json' }));
-        }
-        else {
-            console.log('Inference feature is disabled in features.json.');
-            console.log('Enable it by setting inference.enabled = true in .opencode/plugins/features.json (min compat .xray/ fallback for prior 0xRay consumer runtime per Scope Rule)');
+    let code = 0;
+    try {
+        const { InferenceCycle } = await import('../inference/inference-cycle.js');
+        const { shouldTriggerCycle } = await import('../inference/inference-accumulator.js');
+        const { accumulateCorpus } = await import('../inference/inference-accumulator.js');
+        const { featuresConfigLoader } = await import('../core/features-config.js');
+        const { initializeGovernanceIntegration, shutdownGovernanceIntegration } = await import('../integrations/governance/index.js');
+        // Guard: inference:run is internal to xray development only
+        const isxrayRepo = (() => {
+            try {
+                const pkg = JSON.parse(readFileSync(join(process.cwd(), 'package.json'), 'utf-8'));
+                return pkg.name === '0xray' && process.env.NODE_ENV !== 'consumer';
+            }
+            catch {
+                return false;
+            }
+        })();
+        if (!isxrayRepo) {
+            if (options.json) {
+                console.log(JSON.stringify({ triggered: false, reason: 'inference:run is for xray development only (internal tool)' }));
+            }
+            else {
+                console.log('The inference:run command is for xray framework development only.');
+                console.log('It is not intended for consumer projects.');
+            }
+            return;
         }
-        return;
-    }
-    const projectRoot = process.cwd();
-    const inferenceDir = `${projectRoot}/docs/inference`;
-    const stateDir = `${projectRoot}/.xray/inference`;
-    const stateFile = `${stateDir}/inference-cycle-state.json`;
-    if (!options.json) {
-        console.log('xray Inference Cycle');
-        console.log('====================');
-    }
-    if (!options.force) {
-        const threshold = shouldTriggerCycle(inferenceDir, stateFile);
-        if (!threshold.trigger) {
+        const features = featuresConfigLoader.loadConfig();
+        if (!inferenceRunMayEnter(features.inference, options.force === true)) {
             if (options.json) {
-                console.log(JSON.stringify({ triggered: false, reason: threshold.reason }));
+                console.log(JSON.stringify({ triggered: false, reason: 'Inference feature disabled in features.json' }));
             }
             else {
-                console.log(`Not triggered: ${threshold.reason}`);
-                console.log('Use --force to override.');
+                console.log('Inference feature is disabled in features.json.');
+                console.log('Set inference.enabled to true in xray/features.json, or pass --force.');
             }
             return;
         }
+        const projectRoot = process.cwd();
+        const inferenceDir = `${projectRoot}/docs/inference`;
+        const stateDir = `${projectRoot}/.xray/inference`;
+        const stateFile = `${stateDir}/inference-cycle-state.json`;
         if (!options.json) {
-            console.log(`Triggered: ${threshold.reason}`);
+            console.log('xray Inference Cycle');
+            console.log('====================');
+        }
+        if (!options.force) {
+            const threshold = shouldTriggerCycle(inferenceDir, stateFile);
+            if (!threshold.trigger) {
+                if (options.json) {
+                    console.log(JSON.stringify({ triggered: false, reason: threshold.reason }));
+                }
+                else {
+                    console.log(`Not triggered: ${threshold.reason}`);
+                    console.log('Use --force to override.');
+                }
+                return;
+            }
+            if (!options.json) {
+                console.log(`Triggered: ${threshold.reason}`);
+            }
         }
-    }
-    else if (!options.json) {
-        console.log('Force mode — skipping threshold check');
-    }
-    if (!options.json) {
-        const corpus = accumulateCorpus(inferenceDir);
-        console.log(`\nCorpus: ${corpus.sessions.length} sessions, ${corpus.totalCommits} commits`);
-        console.log(`  Recurring problems: ${corpus.recurringProblems.length}`);
-        console.log(`  Recurring patterns: ${corpus.recurringPatterns.length}`);
-    }
-    // Initialize external governance integration for two-oscillator governance
-    const govConfig = features?.inference_governance;
-    if (govConfig?.enabled) {
-        await shutdownGovernanceIntegration();
-        await initializeGovernanceIntegration();
-    }
-    const cycle = InferenceCycle.getInstance(projectRoot, { skipDeployVerify: options.noVerify ?? true, skipApply: options.noApply ?? false, skipResearcherReview: options.noResearcherReview ?? false, force: options.force ?? false });
-    const result = await cycle.maybeRunCycle();
-    if (options.json) {
-        console.log(JSON.stringify(result, null, 2));
-        return;
-    }
-    console.log(`\nCycle: ${result.cycleId}`);
-    console.log(`Phase: ${result.phase}`);
-    console.log(`Duration: ${(result.duration / 1000).toFixed(1)}s`);
-    if (result.proposals.length > 0) {
-        console.log(`\nProposals (${result.proposals.length}):`);
-        for (const p of result.proposals) {
-            const icon = p.status === 'approved' || p.status === 'applied' ? 'APPROVED' : p.status === 'rejected' ? 'REJECTED' : p.status === 'failed' ? 'FAILED' : 'PENDING';
-            console.log(`  [${icon}] ${p.type}: ${p.title} (${(p.confidence * 100).toFixed(0)}%)`);
-        }
-    }
-    else {
-        console.log('\nNo proposals generated.');
-    }
-    if (result.votes.length > 0) {
-        console.log(`\nGovernance votes (${result.votes.length}):`);
-        for (const v of result.votes) {
-            console.log(`  ${v.proposalId}: ${v.decision} (${(v.confidence * 100).toFixed(0)}%)`);
-            for (const d of v.details) {
-                console.log(`    ${d}`);
+        else if (!options.json) {
+            console.log('Force mode — skipping threshold check');
+        }
+        if (!options.json) {
+            const corpus = accumulateCorpus(inferenceDir);
+            console.log(`\nCorpus: ${corpus.sessions.length} sessions, ${corpus.totalCommits} commits`);
+            console.log(`  Recurring problems: ${corpus.recurringProblems.length}`);
+            console.log(`  Recurring patterns: ${corpus.recurringPatterns.length}`);
+        }
+        // Initialize external governance integration for two-oscillator governance
+        const govConfig = features.inference_governance;
+        if (govConfig?.enabled) {
+            await shutdownGovernanceIntegration();
+            await initializeGovernanceIntegration();
+        }
+        const cycle = InferenceCycle.getInstance(projectRoot, { skipDeployVerify: options.noVerify ?? true, skipApply: options.noApply ?? false, skipResearcherReview: options.noResearcherReview ?? false, force: options.force ?? false });
+        const result = await cycle.maybeRunCycle();
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\nCycle: ${result.cycleId}`);
+        console.log(`Phase: ${result.phase}`);
+        console.log(`Duration: ${(result.duration / 1000).toFixed(1)}s`);
+        if (result.proposals.length > 0) {
+            console.log(`\nProposals (${result.proposals.length}):`);
+            for (const p of result.proposals) {
+                const icon = p.status === 'approved' || p.status === 'applied' ? 'APPROVED' : p.status === 'rejected' ? 'REJECTED' : p.status === 'failed' ? 'FAILED' : 'PENDING';
+                console.log(`  [${icon}] ${p.type}: ${p.title} (${(p.confidence * 100).toFixed(0)}%)`);
             }
         }
-    }
-    if (result.deployVerification) {
-        console.log(`\nDeploy verification: ${result.deployVerification.success ? 'PASSED' : 'FAILED'}`);
-        const failedChecks = result.deployVerification.checks.filter((c) => !c.passed);
-        if (failedChecks.length > 0) {
-            for (const c of failedChecks) {
-                console.log(`  Failed: ${c.name} — ${c.output?.substring(0, 200)}`);
+        else {
+            console.log('\nNo proposals generated.');
+        }
+        if (result.votes.length > 0) {
+            console.log(`\nGovernance votes (${result.votes.length}):`);
+            for (const v of result.votes) {
+                console.log(`  ${v.proposalId}: ${v.decision} (${(v.confidence * 100).toFixed(0)}%)`);
+                for (const d of v.details) {
+                    console.log(`    ${d}`);
+                }
             }
         }
+        if (result.deployVerification) {
+            console.log(`\nDeploy verification: ${result.deployVerification.success ? 'PASSED' : 'FAILED'}`);
+            const failedChecks = result.deployVerification.checks.filter((check) => !check.passed);
+            if (failedChecks.length > 0) {
+                for (const c of failedChecks) {
+                    console.log(`  Failed: ${c.name} — ${c.output?.substring(0, 200)}`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        code = 1;
+        const message = error instanceof Error ? error.message : String(error);
+        if (options.json) {
+            console.log(JSON.stringify({ triggered: false, reason: message }));
+        }
+        else {
+            console.log(message);
+        }
+    }
+    finally {
+        exitWhenFlushed(code);
     }
 });
 // Publish agent command

package/dist/core/features-config.d.ts

@@ -401,6 +401,10 @@ export interface FeaturesConfig {
     storytelling?: StorytellingConfig;
     auto_reflection?: AutoReflectionConfig;
     inference?: InferenceConfig;
+    /** External Dynamo pass. Off uses the local decision matrix. */
+    inference_governance?: {
+        enabled?: boolean;
+    };
     memory_routing?: MemoryRoutingConfig;
     /** P2.2 — lightweight Grok write-tool postprocessor marker */
     grok_postprocessor_light?: boolean;

package/dist/core/features-config.js

@@ -409,6 +409,16 @@ export class FeaturesConfigLoader {
                 cache_ttl_seconds: 300,
                 max_cache_size_mb: 50,
             },
+            inference: {
+                description: "Self-improvement cycle that grades a new named session into repertoire",
+                enabled: true,
+                workflow_dir: ".xray/inference",
+                reports_dir: ".xray/reports",
+                pattern_matching: {
+                    enabled: true,
+                    confidence_threshold: 0.7,
+                },
+            },
             synthesis: {
                 enabled: false,
                 every_n_gates: 12,

package/dist/inference/inference-accumulator.d.ts

@@ -26,4 +26,6 @@ export declare function shouldTriggerCycle(inferenceDir: string, lastCycleFile:
     reason: string;
 };
 export declare function accumulateCorpus(inferenceDir: string): InferenceCorpus;
+/** Reflection files are graded in memory. They are not copied into session-*.json. */
+export declare function loadReflectionInferences(inferenceDir: string): SessionInference[];
 export declare function loadSessionInferences(dir: string): SessionInference[];