0xray 4.0.42 → 4.1.0

package/dist/integrations/hooks/goggles-mcp.mjs

@@ -3,7 +3,7 @@
  * Tools: look, status_lens. Same organ as the CLI.
  */
 import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs';
-import { basename, dirname, join, resolve } from 'node:path';
+import { dirname, join, resolve } from 'node:path';
 import { pathToFileURL, fileURLToPath } from 'node:url';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -12,17 +12,9 @@ import * as bundled from './goggles-pipeline.mjs';
 
 const HERE = fileURLToPath(new URL('.', import.meta.url));
 const SERVER_NAME = 'goggles';
-const CARD_PLANES = [
-  'ground',
-  'routing',
-  'house',
-  'boot',
-  'governance',
-  'memory-recall',
-  'orchestration',
-  'processor',
-  'reporting',
-];
+/** Card planes come from the organ, not a hand-kept copy. */
+const CARD_PLANES = Array.isArray(bundled.CARD_PLANES) ? bundled.CARD_PLANES : [];
+const CARD_OUTERS = ['digest', 'triage'];
 const SCOPES = ['ecosystem', 'part', 'one flow', 'one artifact'];
 
 const LOOK_SCHEMA = {
@@ -31,7 +23,7 @@ const LOOK_SCHEMA = {
   properties: {
     kind: {
       type: 'string',
-      description: 'Optional. Use "0" or "actuality" for the lens. Omit when naming an outer.',
+      description: 'Use "0" or "actuality" for the lens. Send kind, outer, or plane: an empty look is refused. Never with outer: kind and outer together is refused.',
       enum: ['0', 'actuality'],
     },
     outer: {
@@ -46,7 +38,7 @@ const LOOK_SCHEMA = {
     },
     plane: {
       type: 'string',
-      description: 'Card plane for digest or triage only. Not the lens.',
+      description: 'Card plane for digest or triage only. Not the lens. A plane with any other outer is refused.',
       enum: CARD_PLANES,
     },
   },
@@ -55,7 +47,7 @@ const LOOK_SCHEMA = {
 export const TOOLS = [
   {
     name: 'look',
-    description: 'Kind 0 is quiet on a match. It checks the six outer names. One outer is a reading. digest and triage return a card.',
+    description: 'Kind 0 is quiet on a match. It checks the six outer names, then sweeps every card plane for missing shipped files and names the first drift. One outer is a reading. digest and triage return a card. Refused: an empty look; kind with outer; a plane with an outer other than digest or triage.',
     inputSchema: LOOK_SCHEMA,
   },
   {
@@ -152,6 +144,15 @@ function checkArgs(args) {
   if (args.plane != null && !CARD_PLANES.includes(args.plane)) {
     return deny('invalid_args', 'plane is a card plane.');
   }
+  if (args.kind == null && args.outer == null && args.plane == null) {
+    return deny('invalid_args', 'Name a kind, one outer, or one plane.');
+  }
+  if (args.kind != null && args.outer != null) {
+    return deny('invalid_args', 'Send kind or outer, not both.');
+  }
+  if (args.plane != null && args.outer != null && !CARD_OUTERS.includes(args.outer)) {
+    return deny('invalid_args', 'plane goes with digest or triage only.');
+  }
   return null;
 }
 
@@ -161,7 +162,7 @@ function publicCard(view) {
     if (Array.isArray(view.empty) && view.empty.length) notes.push(`Empty: ${view.empty.join(', ')}`);
     if (view.exam) notes.push(view.exam);
   }
-  const skills = view.skills ? basename(String(view.skills)) : '';
+  const skills = view.skills ? String(view.skills) : '';
   const cascade = view.cascade
     ? {
       plane: view.cascade.plane,
@@ -227,7 +228,8 @@ export async function answerLook(raw, root) {
   const here = projectRoot(root);
   if (pureKind0(args)) {
     api.maintainLens(here);
-    const line = api.actualityLine();
+    const line = api.actualityLine() || cardDrift(api, here);
+    if (line) writeLens(api, here, line);
     if (!line) return quiet('kind0');
     return { ok: true, quiet: false, mode: 'kind0', content: line };
   }
@@ -269,6 +271,22 @@ export async function answerLook(raw, root) {
   };
 }
 
+/** Kind 0 card sweep: triage's file check on every card plane, shipped paths only. */
+function cardDrift(api, here) {
+  if (typeof api.shippedDrift !== 'function') return '';
+  try {
+    return api.shippedDrift(here);
+  } catch {
+    return '';
+  }
+}
+
+function writeLens(api, here, line) {
+  const file = api.lensPath(here);
+  mkdirSync(dirname(file), { recursive: true });
+  writeFileSync(file, `${line}\n`);
+}
+
 function lensBody(root) {
   const file = join(root, '.xray', 'state', 'LENS.md');
   if (!existsSync(file)) return { found: false, text: '' };

package/dist/integrations/hooks/goggles-pipeline.mjs

@@ -18,7 +18,7 @@ import { fileURLToPath } from 'node:url';
 const FIELD_ORDER = ['plate', 'entry', 'exit', 'files', 'skills', 'setup', 'teardown', 'worn'];
 const HERE = dirname(fileURLToPath(import.meta.url));
 const WORN_PLANES = ['dichotomy', 'syncopate', 'synthesis', 'digest', 'triage', 'loop'];
-const CARD_PLANES = ['ground', 'routing', 'house', 'boot', 'governance', 'memory-recall', 'orchestration', 'processor', 'reporting', 'stamp-plate', 'record-map', 'write-home', 'activity-log', 'session-capture', 'suit-wear', 'suit-organs', 'station-card', 'notes-page', 'reflection-page', 'site-manual', 'package-face', 'suit-settings', 'trail-state', 'inference-files', 'grok-compact', 'payload-heat', 'station-heat', 'pickup-stamp', 'cursor-compact', 'work-fresh', 'kept-line', 'lens-gate', 'pre-tool', 'lens-page', 'centrifuge'];
+export const CARD_PLANES = ['ground', 'routing', 'house', 'boot', 'governance', 'memory-recall', 'orchestration', 'processor', 'reporting', 'stamp-plate', 'record-map', 'write-home', 'activity-log', 'session-capture', 'suit-wear', 'suit-organs', 'station-card', 'notes-page', 'reflection-page', 'site-manual', 'package-face', 'suit-settings', 'trail-state', 'inference-files', 'grok-compact', 'payload-heat', 'station-heat', 'pickup-stamp', 'cursor-compact', 'work-fresh', 'kept-line', 'lens-gate', 'pre-tool', 'lens-page', 'centrifuge'];
 const CARD_FLAVORS = ['digest', 'triage'];
 const SCOPE_ZOOM = ['ecosystem', 'part', 'one flow', 'one artifact'];
 
@@ -1065,6 +1065,51 @@ export function growPlane(id, platesDir, root) {
   return { ...base, ...grown };
 }
 
+/** Paths the package ships: package.json files, plus what npm always packs. */
+function shippedSet(root) {
+  try {
+    const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+    if (!Array.isArray(pkg.files)) return null;
+    return pkg.files
+      .map(String)
+      .filter((entry) => entry && !entry.startsWith('!'))
+      .map((entry) => entry.replace(/\/+$/, ''))
+      .concat(['package.json', 'README.md', 'LICENSE']);
+  } catch {
+    return null;
+  }
+}
+
+function ships(shipped, rel) {
+  if (!shipped) return true;
+  const path = String(rel || '').replace(/\/+$/, '');
+  if (!path) return false;
+  return shipped.some((entry) => path === entry || path.startsWith(`${entry}/`) || entry.startsWith(`${path}/`));
+}
+
+/**
+ * Kind 0 card sweep: triage's file check on every card plane, limited to
+ * paths the package ships, so a packed install and the repo read the same.
+ * Returns the first drift line, or '' when every card holds.
+ */
+export function shippedDrift(projectRoot) {
+  const platesDir = findPlatesDir(HERE);
+  const root = sourceRoot(platesDir);
+  const shipped = shippedSet(root);
+  for (const id of CARD_PLANES) {
+    const plane = growPlane(id, platesDir, projectRoot || stateRoot());
+    const kept = {
+      ...plane,
+      files: (Array.isArray(plane.files) ? plane.files : []).filter((rel) => ships(shipped, rel)),
+      skills: ships(shipped, plane.skills) ? plane.skills : '',
+      worn: ships(shipped, plane.worn) ? plane.worn : '',
+    };
+    const exam = examinePlane(kept, root);
+    if (exam.kind === 'drift') return `Actuality. ${id}: ${exam.text}`;
+  }
+  return '';
+}
+
 function repoRootFrom(platesDir) {
   return dirname(dirname(dirname(platesDir)));
 }

package/dist/integrations/hooks/goggles-planes.json

@@ -7,6 +7,7 @@
     "files": [
       "src",
       "grok-bot/OP-PROC.md",
+      "grok-bot/LEXICON.md",
       "src/opencode/agents",
       "AGENTS.md",
       "src/integrations",
@@ -28,7 +29,7 @@
     "plates": ["orchestration", "processor"]
   },
   "house": {
-    "files": ["grok-bot/lib/seat-doctor.cjs"],
+    "files": ["grok-bot/lib/seat-doctor.cjs", "grok-bot/templates/house/fleet/WAKE-ROUTINE.md", "grok-bot/templates/house/HOUSE.md", "src/__tests__/unit/grok-bot-house-template.test.ts", "src/__tests__/unit/grok-bot-house-migrate.test.ts"],
     "skills": ".agents/skills/house/SKILL.md",
     "plates": ["suit-wear"]
   },
@@ -45,7 +46,7 @@
     "skills": ".agents/skills/governance/SKILL.md"
   },
   "memory-recall": {
-    "files": ["src/integrations/hooks/plates.cjs"],
+    "files": ["src/integrations/hooks/plates.cjs", "src/__tests__/unit/plates.test.ts"],
     "skills": ".agents/skills/memory-recall/SKILL.md",
     "plates": ["record-map"]
   },
@@ -94,7 +95,7 @@
     "plates": ["write-home", "inference-files", "suit-organs"]
   },
   "suit-wear": {
-    "files": ["src/core/features-config.ts"],
+    "files": ["src/core/features-config.ts", "scripts/node/install-bridges.cjs", "scripts/node/setup.cjs", "src/integrations/cursor/hooks/xray-cloud-hook.sh"],
     "mark": "log_path",
     "skills": ".agents/skills/suit-wear/SKILL.md",
     "plates": ["suit-settings", "write-home", "package-face"]
@@ -124,13 +125,13 @@
     "plates": ["record-map"]
   },
   "site-manual": {
-    "files": ["docs-site/docs/introduction.md"],
+    "files": ["docs-site/docs/introduction.md", "docs-site/docs/index.md", "docs-site/docs/full-reference.md", "docs-site/docs/guides/features-since-3.1.md"],
     "mark": "survives the context window",
     "skills": ".agents/skills/site-manual/SKILL.md",
     "plates": ["record-map"]
   },
   "package-face": {
-    "files": ["package.json"],
+    "files": ["package.json", "grok-bot/README.md", "grok-bot/llms.txt", "grok-bot/CHANGELOG.md", "src/cli/index.ts", "src/cli/commands/plugin-commands.ts", "src/__tests__/unit/plugin-commands.test.ts"],
     "mark": "\"name\": \"0xray\"",
     "skills": ".agents/skills/package-face/SKILL.md",
     "plates": ["record-map", "suit-wear"]
@@ -197,7 +198,7 @@
     "plates": ["station-card", "work-fresh"]
   },
   "lens-gate": {
-    "files": ["src/integrations/hooks/goggles-pipeline.mjs"],
+    "files": ["src/integrations/hooks/goggles-pipeline.mjs", "src/__tests__/unit/goggles-pipeline.test.ts"],
     "mark": "export function lensBeforeResearch",
     "skills": ".agents/skills/lens-gate/SKILL.md",
     "plates": ["pre-tool"]

package/dist/integrations/hooks/pre-tool-speak.mjs

@@ -0,0 +1,76 @@
+/**
+ * One pre-tool speak for every host.
+ * The lens denies an unnamed plane. The route speaks only when Repertoire changes the agent.
+ */
+import { createRequire } from 'node:module';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { lensBeforeResearch } from './goggles-pipeline.mjs';
+
+const here = dirname(fileURLToPath(import.meta.url));
+let scoreAndRouteFn;
+
+function loadScoreAndRoute() {
+  if (scoreAndRouteFn !== undefined) return scoreAndRouteFn;
+  scoreAndRouteFn = null;
+  const require = createRequire(import.meta.url);
+  const candidates = [
+    join(here, '../../nucleus/thin-dispatch.js'),
+    join(here, '../../../dist/nucleus/thin-dispatch.js'),
+    join(here, '../../../nucleus/thin-dispatch.js'),
+  ];
+  for (const candidate of candidates) {
+    if (!existsSync(candidate)) continue;
+    try {
+      const loaded = require(candidate);
+      if (typeof loaded.scoreAndRoute === 'function') {
+        scoreAndRouteFn = loaded.scoreAndRoute;
+        return scoreAndRouteFn;
+      }
+    } catch {
+      /* next built copy */
+    }
+  }
+  return null;
+}
+
+/** Speak only when the organ changes the agent. A match that leaves the agent is quiet. */
+export function repertoireDecisionFields(routed) {
+  if (!routed?.memoryRouting?.overridden || !routed.agent) return null;
+  const signals = Array.isArray(routed.memoryRouting.signals)
+    ? routed.memoryRouting.signals.slice(0, 4).filter(Boolean)
+    : [];
+  const why = signals.length ? ` on ${signals.join(', ')}` : '';
+  return {
+    agent: routed.agent,
+    gate: 'repertoire',
+    hookSpecificOutput: {
+      hookEventName: 'PreToolUse',
+      additionalContext: `Repertoire changed the route to ${routed.agent}${why}. Follow that agent for this work.`,
+    },
+  };
+}
+
+export function repertoireRoute(operation) {
+  const text = String(operation || '').slice(0, 500).trim();
+  if (!text) return null;
+  try {
+    const scoreAndRoute = loadScoreAndRoute();
+    if (!scoreAndRoute) return null;
+    return repertoireDecisionFields(scoreAndRoute(text, {}));
+  } catch {
+    return null;
+  }
+}
+
+/** Deny when the lens stops the tool. Any other lens result is quiet. */
+export function lensDecision(root, toolName, spoken) {
+  try {
+    const stop = lensBeforeResearch(root, toolName, spoken);
+    if (stop?.decision === 'deny') return stop;
+    return null;
+  } catch {
+    return null;
+  }
+}

package/dist/integrations/openclaw/hooks/pre-tool-gate-runtime.mjs

@@ -23,7 +23,7 @@ function resolveGate() {
   ].filter(Boolean);
   const found = candidates.find((p) => existsSync(p));
   if (!found) {
-    throw new Error('delegation-gate.js missing — build 0xray or npm install 0xray');
+    throw Object.assign(new Error('delegation-gate.js missing — build 0xray or npm install 0xray'), { code: 'ERR_MODULE_NOT_FOUND' });
   }
   return require(found);
 }
@@ -49,7 +49,7 @@ function readStdin() {
   });
 }
 
-function decide(event, gate) {
+async function decide(event, gate) {
   const projectRoot =
     event.cwd || event.workspaceRoot || event.projectRoot || process.cwd();
   const sessionId = event.sessionId || event.session_id || 'openclaw';
@@ -70,20 +70,37 @@ function decide(event, gate) {
       gate: outcome.gate,
     };
   }
-  return {
+
+  const spoken = `${toolName} ${JSON.stringify(args)}`.slice(0, 500);
+  const { lensDecision, repertoireRoute } = await import('../../hooks/pre-tool-speak.mjs');
+  const lens = lensDecision(projectRoot, toolName, spoken);
+  if (lens) {
+    return {
+      action: 'block',
+      allow: false,
+      reason: lens.reason,
+      gate: lens.gate || 'lens',
+    };
+  }
+  const route = repertoireRoute(spoken);
+  const allowed = {
     action: 'allow',
     allow: true,
     reason: outcome.reason,
     gate: outcome.gate,
     warn: Boolean(outcome.reason),
   };
+  if (route?.hookSpecificOutput) {
+    allowed.hookSpecificOutput = route.hookSpecificOutput;
+  }
+  return allowed;
 }
 
 async function main() {
   try {
     const event = await readStdin();
     const gate = resolveGate();
-    const decision = decide(event, gate);
+    const decision = await decide(event, gate);
     console.log(JSON.stringify(decision));
     process.exit(decision.action === 'block' ? 2 : 0);
   } catch (err) {

package/dist/integrations/openclaw/plugin/xray-pre-tool/index.js

@@ -2,7 +2,7 @@ import { createRequire } from 'node:module';
 import { existsSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { definePluginEntry } from 'openclaw/plugin-sdk/plugin-entry';
 
 const require = createRequire(import.meta.url);
@@ -39,7 +39,7 @@ export default definePluginEntry({
   register(api) {
     api.on(
       'before_tool_call',
-      (event, ctx) => {
+      async (event, ctx) => {
         try {
           const xrayRoot = resolveXrayRoot();
           if (!xrayRoot) {
@@ -61,6 +61,21 @@ export default definePluginEntry({
           if (!outcome.allow) {
             return { block: true, blockReason: outcome.reason || '0xRay constitution' };
           }
+          const spoken = `${event.toolName} ${JSON.stringify(event.params || {})}`.slice(0, 500);
+          const speakPath = [
+            join(xrayRoot, 'dist/integrations/hooks/pre-tool-speak.mjs'),
+            join(xrayRoot, 'src/integrations/hooks/pre-tool-speak.mjs'),
+          ].find((candidate) => existsSync(candidate));
+          if (!speakPath) return undefined;
+          const speak = await import(pathToFileURL(speakPath).href);
+          const lens = speak.lensDecision(projectRoot, event.toolName, spoken);
+          if (lens) {
+            return { block: true, blockReason: lens.reason };
+          }
+          const route = speak.repertoireRoute(spoken);
+          if (route?.hookSpecificOutput) {
+            return { block: false, hookSpecificOutput: route.hookSpecificOutput };
+          }
           return undefined;
         } catch (err) {
           return {

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

@@ -1,6 +1,6 @@
 {
   "name": "xray-pre-tool",
-  "version": "4.0.42",
+  "version": "4.1.0",
   "private": true,
   "type": "module",
   "description": "0xRay constitution + temperament PreToolUse for OpenClaw",

package/dist/monitoring/{nudge-watchdog.d.ts → nudge-monitor.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Nudge Watchdog - Detects and breaks stuck AI patterns
+ * Nudge Monitor - Detects and breaks stuck AI patterns
  *
  * Monitors agent actions and detects common failure patterns:
  * - think-loop: AI keeps outputting thinking tags but no progress
@@ -8,7 +8,7 @@
  * - tool-loop: Same tool called with similar args repeatedly
  * - repair-failure: Processor indicates fix but error persists
  *
- * @module monitoring/nudge-watchdog
+ * @module monitoring/nudge-monitor
  */
 import { EventEmitter } from "events";
 export interface NudgeConfig {
@@ -33,7 +33,16 @@ export interface NudgeAction {
     suggestion: string;
     priority: number;
 }
-declare class NudgeWatchdog extends EventEmitter {
+/** Old config key from before the rename to nudge_monitor; still read as a deprecated alias. */
+export declare const LEGACY_NUDGE_CONFIG_KEY = "nudge_watchdog";
+/**
+ * features.nudge_monitor, or the deprecated features.nudge_watchdog when nudge_monitor is unset (the new key wins
+ * when both are set). Using the old key logs a one-time deprecation warning.
+ */
+export declare function resolveNudgeConfig(features: Record<string, unknown> | undefined | null, warn?: (message: string) => void): Record<string, unknown> | undefined;
+/** Test hook: let the one-time deprecation warning fire again. */
+export declare function resetLegacyNudgeWarning(): void;
+declare class NudgeMonitor extends EventEmitter {
     private config;
     private patterns;
     private lastNudgeTime;
@@ -75,13 +84,13 @@ declare class NudgeWatchdog extends EventEmitter {
     };
     private log;
 }
-export declare const nudgeWatchdog: NudgeWatchdog;
+export declare const nudgeMonitor: NudgeMonitor;
 export declare function recordThinkTag(): void;
 export declare function recordCodeChange(): void;
 export declare function recordToolCall(tool: string, args: string): void;
 export declare function recordFixAttempt(filePath: string, error: string): void;
 export declare function recordExplanation(): void;
 export declare function getNudgeSuggestion(type: NudgeType, context?: Record<string, unknown>): string;
-export declare function getNudgeWatchdog(): NudgeWatchdog;
+export declare function getNudgeMonitor(): NudgeMonitor;
 export declare function recordProcessorFix(filePath: string, fixed: boolean, errorPersisted: boolean): void;
 export {};

package/dist/monitoring/{nudge-watchdog.js → nudge-monitor.js}

@@ -1,5 +1,5 @@
 /**
- * Nudge Watchdog - Detects and breaks stuck AI patterns
+ * Nudge Monitor - Detects and breaks stuck AI patterns
  *
  * Monitors agent actions and detects common failure patterns:
  * - think-loop: AI keeps outputting thinking tags but no progress
@@ -8,7 +8,7 @@
  * - tool-loop: Same tool called with similar args repeatedly
  * - repair-failure: Processor indicates fix but error persists
  *
- * @module monitoring/nudge-watchdog
+ * @module monitoring/nudge-monitor
  */
 import { EventEmitter } from "events";
 import { frameworkLogger } from "../core/framework-logger.js";
@@ -53,7 +53,32 @@ const NUDGE_MESSAGES = {
         priority: 5,
     },
 };
-class NudgeWatchdog extends EventEmitter {
+/** Old config key from before the rename to nudge_monitor; still read as a deprecated alias. */
+export const LEGACY_NUDGE_CONFIG_KEY = "nudge_watchdog";
+let legacyKeyWarned = false;
+/**
+ * features.nudge_monitor, or the deprecated features.nudge_watchdog when nudge_monitor is unset (the new key wins
+ * when both are set). Using the old key logs a one-time deprecation warning.
+ */
+export function resolveNudgeConfig(features, warn = (m) => frameworkLogger.log("nudge-monitor", "deprecated-config-key", "warning", { message: m })) {
+    const current = features?.nudge_monitor;
+    if (current !== undefined && current !== null)
+        return current;
+    const legacy = features?.[LEGACY_NUDGE_CONFIG_KEY];
+    if (legacy !== undefined && legacy !== null) {
+        if (!legacyKeyWarned) {
+            legacyKeyWarned = true;
+            warn(`features.${LEGACY_NUDGE_CONFIG_KEY} is deprecated; rename it to features.nudge_monitor`);
+        }
+        return legacy;
+    }
+    return undefined;
+}
+/** Test hook: let the one-time deprecation warning fire again. */
+export function resetLegacyNudgeWarning() {
+    legacyKeyWarned = false;
+}
+class NudgeMonitor extends EventEmitter {
     config;
     patterns = new Map();
     lastNudgeTime = 0;
@@ -73,7 +98,7 @@ class NudgeWatchdog extends EventEmitter {
     loadConfigFromFeatures() {
         try {
             const features = featuresConfigLoader.loadConfig();
-            const nudgeConfig = features?.nudge_watchdog;
+            const nudgeConfig = resolveNudgeConfig(features);
             if (nudgeConfig) {
                 this.config = { ...this.config, ...nudgeConfig };
             }
@@ -86,10 +111,10 @@ class NudgeWatchdog extends EventEmitter {
         if (!this.config.enabled) {
             return;
         }
-        this.log("nudge-watchdog", "started", "info", { config: this.config });
+        this.log("nudge-monitor", "started", "info", { config: this.config });
     }
     stop() {
-        this.log("nudge-watchdog", "stopped", "info");
+        this.log("nudge-monitor", "stopped", "info");
     }
     recordThinkTag() {
         const now = Date.now();
@@ -256,7 +281,7 @@ class NudgeWatchdog extends EventEmitter {
         if (!action)
             return null;
         this.emit("nudge", action);
-        this.log("nudge-watchdog", "nudge-triggered", "warning", {
+        this.log("nudge-monitor", "nudge-triggered", "warning", {
             type: action.type,
             message: action.message,
             suggestion: action.suggestion,
@@ -328,28 +353,28 @@ class NudgeWatchdog extends EventEmitter {
         }
     }
 }
-export const nudgeWatchdog = new NudgeWatchdog();
+export const nudgeMonitor = new NudgeMonitor();
 export function recordThinkTag() {
-    nudgeWatchdog.recordThinkTag();
+    nudgeMonitor.recordThinkTag();
 }
 export function recordCodeChange() {
-    nudgeWatchdog.recordCodeChange();
+    nudgeMonitor.recordCodeChange();
 }
 export function recordToolCall(tool, args) {
-    nudgeWatchdog.recordToolCall(tool, args);
+    nudgeMonitor.recordToolCall(tool, args);
 }
 export function recordFixAttempt(filePath, error) {
-    nudgeWatchdog.recordFixAttempt(filePath, error);
+    nudgeMonitor.recordFixAttempt(filePath, error);
 }
 export function recordExplanation() {
-    nudgeWatchdog.recordExplanation();
+    nudgeMonitor.recordExplanation();
 }
 export function getNudgeSuggestion(type, context) {
-    return nudgeWatchdog.getNudgeSuggestion(type, context);
+    return nudgeMonitor.getNudgeSuggestion(type, context);
 }
-export function getNudgeWatchdog() {
-    return nudgeWatchdog;
+export function getNudgeMonitor() {
+    return nudgeMonitor;
 }
 export function recordProcessorFix(filePath, fixed, errorPersisted) {
-    nudgeWatchdog.recordProcessorFix(filePath, fixed, errorPersisted);
+    nudgeMonitor.recordProcessorFix(filePath, fixed, errorPersisted);
 }

package/dist/plugin/xray-codex-injection.js

@@ -114,6 +114,24 @@ export default async function xrayCodexPlugin(input) {
                 logger.error(`🚫 Delegation gate: ${delegationGate.reason}`);
                 throw new Error(`DELEGATION GATE: ${delegationGate.reason}`);
             }
+            let speak = null;
+            try {
+                speak = (await import(new URL("../integrations/hooks/pre-tool-speak.mjs", import.meta.url).href));
+            }
+            catch {
+                speak = null;
+            }
+            if (speak) {
+                const spoken = `${tool} ${JSON.stringify(args ?? {})}`.slice(0, 500);
+                const lens = speak.lensDecision(directory, tool, spoken);
+                if (lens) {
+                    throw new Error(`DELEGATION GATE: ${lens.reason ?? "lens"}`);
+                }
+                const additional = speak.repertoireRoute(spoken)?.hookSpecificOutput?.additionalContext;
+                if (additional) {
+                    logger.log(additional);
+                }
+            }
             if (isWriteEditOperation(tool)) {
                 const _ProcessorManager = getProcessorManager();
                 const _XrayStateManager = getXrayStateManager();

package/dist/processors/implementations/nudge-processor.d.ts

@@ -1,5 +1,5 @@
 /**
- * Nudge Processor - Integrates Nudge Watchdog with processor system
+ * Nudge Processor - Integrates Nudge Monitor with processor system
  *
  * Post-processor that monitors agent actions and triggers nudges
  * when stuck patterns are detected.

package/dist/processors/implementations/nudge-processor.js

@@ -1,5 +1,5 @@
 /**
- * Nudge Processor - Integrates Nudge Watchdog with processor system
+ * Nudge Processor - Integrates Nudge Monitor with processor system
  *
  * Post-processor that monitors agent actions and triggers nudges
  * when stuck patterns are detected.
@@ -8,7 +8,7 @@
  */
 import { PostProcessor } from "../processor-interfaces.js";
 import { frameworkLogger } from "../../core/framework-logger.js";
-import { nudgeWatchdog, recordThinkTag, recordCodeChange, recordToolCall, recordFixAttempt, recordExplanation, getNudgeSuggestion, } from "../../monitoring/nudge-watchdog.js";
+import { nudgeMonitor, resolveNudgeConfig, recordThinkTag, recordCodeChange, recordToolCall, recordFixAttempt, recordExplanation, getNudgeSuggestion, } from "../../monitoring/nudge-monitor.js";
 import { featuresConfigLoader } from "../../core/features-config.js";
 export class NudgeProcessor extends PostProcessor {
     name = "nudge";
@@ -21,7 +21,7 @@ export class NudgeProcessor extends PostProcessor {
     loadConfig() {
         try {
             const features = featuresConfigLoader.loadConfig();
-            const nudgeConfig = features?.nudge_watchdog;
+            const nudgeConfig = resolveNudgeConfig(features);
             if (nudgeConfig) {
                 this.nudgeEnabled = nudgeConfig.enabled !== false;
             }
@@ -71,7 +71,7 @@ export class NudgeProcessor extends PostProcessor {
                 }
             }
         }
-        const stats = nudgeWatchdog.getStats();
+        const stats = nudgeMonitor.getStats();
         if (stats.activePatterns > 0) {
             const nudge = this.detectMostUrgentNudge(stats);
             if (nudge) {

package/docs-site/docs/plates/activity-log.md

@@ -35,4 +35,4 @@ Today those writers append `logs/framework/activity.log`. The features default s
 
 When: on the tool hook, on framework logger flush, and on boot when file logging is on. Why: the report and the pulse read one tail, not a pile of copies.
 
-stamped · 0xray 4.0.42
+stamped · 0xray 4.1.0