0xray 4.0.30 → 4.0.32

package/scripts/mjs/run-goggles-mcp.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * CWD-proof Goggles MCP launcher.
+ * Resolves the organ server from this file, not from the caller's cwd.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const xrayRoot = join(dirname(fileURLToPath(import.meta.url)), '../..');
+const candidates = [
+  join(xrayRoot, 'dist', 'integrations', 'hooks', 'goggles-mcp.mjs'),
+  join(xrayRoot, 'src', 'integrations', 'hooks', 'goggles-mcp.mjs'),
+];
+const server = candidates.find((file) => existsSync(file));
+if (!server) {
+  process.stderr.write('goggles MCP missing\n');
+  process.exit(1);
+}
+
+const env = { ...process.env };
+if (!env.GOGGLES_ROOT || env.GOGGLES_ROOT === '.') {
+  env.GOGGLES_ROOT = resolve(process.cwd());
+}
+
+const child = spawn(process.execPath, [server], {
+  stdio: 'inherit',
+  env,
+});
+child.on('error', (err) => {
+  process.stderr.write(`goggles MCP spawn failed: ${err.message}\n`);
+  process.exit(1);
+});
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 1);
+});

package/scripts/node/bridge-mcp-wiring.cjs

@@ -139,31 +139,70 @@ function enableMemoryRoutingIfResolves(features, targetDir) {
   };
 }
 
+function resolveGogglesMcp(targetDir) {
+  const candidates = [
+    path.join(targetDir, "node_modules", "0xray", "scripts", "mjs", "run-goggles-mcp.mjs"),
+    path.join(targetDir, "scripts", "mjs", "run-goggles-mcp.mjs"),
+  ];
+  return candidates.find((file) => fs.existsSync(file)) || null;
+}
+
+function gogglesScopedLaunch(targetDir, launcher) {
+  return wrapScopedLaunch(
+    { command: "node", args: [launcher] },
+    mergeScopedEnv([
+      baseScopedEnv(targetDir),
+      { GOGGLES_ROOT: targetDir, GOGGLES_PLANES_PATH: "" },
+    ]),
+  );
+}
+
 function detectConsumerExtraMcpServers(targetDir) {
   const extras = { hermes: {}, opencode: {}, openclaw: {} };
   try {
     const repertoireMcp = resolveRepertoireMcp(targetDir);
-    if (!repertoireMcp) return extras;
-    const launch = wrapScopedLaunch(
-      { command: "node", args: [repertoireMcp] },
-      baseScopedEnv(targetDir),
-    );
-    extras.hermes.repertoire = {
-      command: launch.command,
-      args: launch.args,
-      env: launch.env,
-    };
-    extras.opencode.repertoire = {
-      type: "local",
-      command: launch.commandList,
-      enabled: true,
-      environment: launch.env,
-    };
-    extras.openclaw.repertoire = {
-      command: launch.command,
-      args: launch.args,
-      env: launch.env,
-    };
+    if (repertoireMcp) {
+      const launch = wrapScopedLaunch(
+        { command: "node", args: [repertoireMcp] },
+        baseScopedEnv(targetDir),
+      );
+      extras.hermes.repertoire = {
+        command: launch.command,
+        args: launch.args,
+        env: launch.env,
+      };
+      extras.opencode.repertoire = {
+        type: "local",
+        command: launch.commandList,
+        enabled: true,
+        environment: launch.env,
+      };
+      extras.openclaw.repertoire = {
+        command: launch.command,
+        args: launch.args,
+        env: launch.env,
+      };
+    }
+    const gogglesMcp = resolveGogglesMcp(targetDir);
+    if (gogglesMcp) {
+      const launch = gogglesScopedLaunch(targetDir, gogglesMcp);
+      extras.hermes.goggles = {
+        command: launch.command,
+        args: launch.args,
+        env: launch.env,
+      };
+      extras.opencode.goggles = {
+        type: "local",
+        command: launch.commandList,
+        enabled: true,
+        environment: launch.env,
+      };
+      extras.openclaw.goggles = {
+        command: launch.command,
+        args: launch.args,
+        env: launch.env,
+      };
+    }
   } catch {
     // best-effort
   }
@@ -880,6 +919,7 @@ module.exports = {
   detectConsumerExtraMcpServers,
   isRepertoirePackageRoot,
   resolveRepertoireMcp,
+  resolveGogglesMcp,
   resolveRepertoireProvider,
   isDefaultMemoryRoutingOff,
   enableMemoryRoutingIfResolves,

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

@@ -60,6 +60,11 @@ const REQUIRED_TARBALL_DIST = [
   "package/dist/integrations/hooks/plates.cjs",
   "package/docs-site/docs/plates/memory-recall.md",
   "package/docs-site/docs/plates/processor.md",
+  "package/docs-site/docs/plates/goggles.md",
+  "package/docs-site/docs/plates/suit.md",
+  "package/docs-site/docs/plates/kits.md",
+  "package/docs-site/docs/plates/host-pack.md",
+  "package/docs-site/docs/plates/glossary.md",
 ];
 
 function assertPackedDistCliInTarball(tarballPath) {

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

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

package/src/mcps/orchestrator/config/agent-capabilities.ts

@@ -14,6 +14,7 @@ import {
   fromMemoryCapabilityMap,
 } from './memory-routing-bridge.js';
 import { routeSubagent } from '../../../nucleus/autonomy-kernel.js';
+import { scoreAndRoute } from '../../../nucleus/thin-dispatch.js';
 
 /** routeSubagent names → AGENT_REGISTRY keys */
 const ROUTE_AGENT_ALIASES: Record<string, string> = {
@@ -102,6 +103,13 @@ export class AgentCapabilitiesManager {
     operationDescription = '',
     taskType = '',
   ): string | null {
+    if (operationDescription.trim()) {
+      const routed = scoreAndRoute(operationDescription, {});
+      if (routed.memoryRouting?.overridden && this.capabilities.has(routed.agent)) {
+        return routed.agent;
+      }
+    }
+
     if (taskType.trim()) {
       const routed = routeSubagent(taskType);
       const resolved = resolveRoutedAgent(routed, this.capabilities);

package/src/skills/orchestrator/SKILL.md

@@ -53,6 +53,18 @@ When `multi_agent_orchestration.lead_dev_mode` is true in `features.json` (defau
 | Test failures | bug-triage |
 | Review | code-review |
 
+## Goggles
+
+The command is `0xray look`. `0xray goggles` is the same organ. A pipe keeps the line card. A terminal shows that card as a pane. Chat seats without hooks use the `goggles` MCP tools `look` and `status_lens`. Same organ.
+
+Kind 0 is actuality. It compares the list in the file to the same six names in the code. It speaks only when those lists differ. A match is quiet. It does not read the suit that is running. It is not a plate type.
+
+Kind 1 names one plane: dichotomy, syncopate, synthesis, or loop. The lens holds that plane. An action on that plane is quiet. An action on another plane, or on a pipeline drawing, is stopped. A pipeline drawing is not a scope stop. Ground is not a scope stop. Scope, when named, is ecosystem, part, one flow, or one artifact, and an action wider than that scope is stopped. One kind and one scope level at a time. Two planes, calling, ground, and a pipeline name do not arm the lens. `outer` without one plane is `Name one plane.` After 1 is empty. Nothing is picked.
+
+`digest` and `triage` return the card already built by `assemblePlane`. The fields are from, digest, plate, entry, exit, files, skills, setup, teardown, and worn. Empty stays empty. The rows are ground, routing, house, boot, governance, memory-recall, orchestration, processor, and reporting. Those nine are not Kind 0. `digest` fills the card. Entry and exit are the plate's input and output box titles when that plate has them. Setup and teardown stay empty unless the row names them. The mill path is `scripts/foundry`. `triage` adds the empty fields and whether the row holds. Zoom after the card is the same ladder: ecosystem, part, one flow, one artifact. One file is one artifact. Several files are not narrowed to a guessed file.
+
+The hold lasts for the work that named the plane. It does not stop one tool and then forget. Work that says goggles clears the hold and stays quiet. The suit does not invent the plane.
+
 ## Hooks (rewired, not new MCPs)
 
 - **SessionStart** → `session-start.js` boots lead_dev_mode

package/vendor/@0xray/repertoire/dist/paths.js

@@ -421,6 +421,10 @@ export function reloadOpProc(cwd = process.cwd()) {
 }
 function mergeProjectOverlays(destPath) {
     mergeStackOverlay(destPath);
+    // Suit heat keeps repo-* off the project file. A wake that merges them
+    // and then prunes them records a fake 59 → 45 drop on every compact.
+    if (process.env.REPERTOIRE_SUBJECT_OVERLAY === '0')
+        return;
     mergeSubjectOverlay(destPath);
 }
 export function hydrateWritableSignals(seedPath, cwd = process.cwd()) {

package/xray/features.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./features.schema.json",
-  "version": "4.0.30",
+  "version": "4.0.32",
   "description": "0xRay Framework - Unified Feature Configuration",
   "suit_temperament": {
     "profile": "auto",