0xray 4.0.31 → 4.0.32

package/.grok-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "0xray",
-  "version": "4.0.31",
+  "version": "4.0.32",
   "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/.mcp.json

@@ -34,6 +34,14 @@
     "repertoire": {
       "command": "node",
       "args": ["scripts/mjs/run-repertoire-mcp.mjs"]
+    },
+    "goggles": {
+      "command": "node",
+      "args": ["scripts/mjs/run-goggles-mcp.mjs"],
+      "env": {
+        "GOGGLES_ROOT": ".",
+        "GOGGLES_PLANES_PATH": ""
+      }
     }
   }
 }

package/.opencode/skills/orchestrator/SKILL.md

@@ -55,11 +55,11 @@ When `multi_agent_orchestration.lead_dev_mode` is true in `features.json` (defau
 
 ## Goggles
 
-Pushed on `feat/goggles-look`. Not merged. Not published. Grok CLI has not shipped this. Wear the local build. From the worn checkout run `node dist/integrations/hooks/goggles-pipeline.mjs`. Do not run `npx 0xray goggles`. If `dist` is older than `src/integrations/hooks/goggles-pipeline.mjs`, build that tree and wear that `dist`. A subagent wears this same local build.
+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. Calling stays off.
+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.
 

package/.xray/features.json

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

package/dist/CHANGELOG.md

@@ -42,6 +42,14 @@ 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.32] - 2026-10-01
+
+Next patch after npm `4.0.31`. Not published from this commit.
+
+Organ bolster for goggles-pipeline after #167. `0xray look` (and `goggles`) opens one plane through the organ. Digest and triage return the card pane. Status and health show the organ worn and Kind 0 quiet/match. Bot Plugin MCP `goggles` exposes lean tools `look` and `status_lens` over stdio on the same organ. Kind 0 name-checks the six outers and stays quiet on match; reading stays a dichotomy; digest/triage stay the card. Calling and confer stay off. Companion `@0xray/grok-bot` is unchanged at 0.1.8.
+
+---
+
 ## [4.0.31] - 2026-10-01
 
 Next patch after npm `4.0.30`. Not published from this commit.

package/dist/cli/commands/status.d.ts

@@ -10,6 +10,7 @@
  *
  * Usage: npx 0xray status
  */
+import type { GogglesStatus } from "../goggles-status.js";
 interface StatusReport {
     opencode: {
         installed: boolean;
@@ -34,8 +35,9 @@ interface StatusReport {
         outcomesCount: number;
         patternsCount: number;
     };
+    goggles: GogglesStatus;
 }
-export declare function getStatusReport(cwd?: string): StatusReport;
+export declare function getStatusReport(cwd?: string, packageRoot?: string): StatusReport;
 export declare function printStatus(report: StatusReport): void;
-export declare function statusCommand(): Promise<void>;
+export declare function statusCommand(packageRoot?: string): Promise<void>;
 export default statusCommand;

package/dist/cli/commands/status.js

@@ -14,6 +14,7 @@ import { readdirSync, existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { getConfigDir } from "../../core/config-paths.js";
 import { featuresConfigLoader } from "../../core/features-config.js";
+import { formatGogglesStatus, probeGoggles } from "../goggles-status.js";
 function getSkillsList(cwd) {
     const skills = [];
     const configDir = getConfigDir(cwd);
@@ -119,7 +120,7 @@ function getInferenceStatus(cwd) {
     catch { /* ignore */ }
     return { active, lastTuning, outcomesCount, patternsCount };
 }
-export function getStatusReport(cwd = process.cwd()) {
+export function getStatusReport(cwd = process.cwd(), packageRoot = cwd) {
     const opencodeConfigPath = join(cwd, "opencode.json");
     const cwdSkills = getSkillsList(cwd);
     const agents = getAgentsList(cwd);
@@ -134,6 +135,7 @@ export function getStatusReport(cwd = process.cwd()) {
         agents,
         health,
         inference,
+        goggles: probeGoggles(packageRoot, cwd),
     };
 }
 export function printStatus(report) {
@@ -166,6 +168,7 @@ export function printStatus(report) {
     console.log(`⚙️  Inference: ${inferenceStatus} (${report.inference.outcomesCount} outcomes, ${report.inference.patternsCount} patterns)`);
     console.log(`📊 Health:  ${healthStatus}`);
     console.log("");
+    process.stdout.write(`${formatGogglesStatus(report.goggles).join("\n")}\n`);
     if (report.skills.names.length > 0) {
         console.log("Installed Skills:");
         const cols = 4;
@@ -191,9 +194,9 @@ export function printStatus(report) {
         console.log("");
     }
 }
-export async function statusCommand() {
+export async function statusCommand(packageRoot = process.cwd()) {
     const cwd = process.cwd();
-    const report = getStatusReport(cwd);
+    const report = getStatusReport(cwd, packageRoot);
     printStatus(report);
 }
 export default statusCommand;

package/dist/cli/commands/validate.js

@@ -23,6 +23,10 @@ export const VALIDATE_PACK_PATHS = [
     "dist/integrations/cursor/hooks/pre-compact.sh",
     "dist/integrations/cursor/hooks/after-file-edit.sh",
     "dist/integrations/hooks/plates.cjs",
+    "dist/integrations/hooks/goggles-pipeline.mjs",
+    "dist/integrations/hooks/goggles-planes.json",
+    "dist/integrations/hooks/goggles-mcp.mjs",
+    "scripts/mjs/run-goggles-mcp.mjs",
     "docs-site/docs/plates/memory-recall.md",
     "docs-site/docs/plates/processor.md",
     "docs-site/docs/plates/goggles.md",

package/dist/cli/goggles-status.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Goggles on status and health.
+ * Organ present is not Kind 0. Quiet is a match. No phone-home.
+ */
+export type GogglesStatus = {
+    organPresent: boolean;
+    kind0Text: string;
+    kind0Quiet: boolean;
+    kind0Label: string;
+    organLine: string;
+};
+export declare function probeGoggles(packageRoot: string, cwd: string): GogglesStatus;
+export declare function formatGogglesStatus(probe: GogglesStatus): string[];

package/dist/cli/goggles-status.js

@@ -0,0 +1,76 @@
+/**
+ * Goggles on status and health.
+ * Organ present is not Kind 0. Quiet is a match. No phone-home.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const WORN_PLANES = ["dichotomy", "syncopate", "synthesis", "digest", "triage", "loop"];
+const ORGAN_PAIRS = [
+    ["dist/integrations/hooks/goggles-pipeline.mjs", "dist/integrations/hooks/goggles-planes.json"],
+    ["src/integrations/hooks/goggles-pipeline.mjs", "src/integrations/hooks/goggles-planes.json"],
+];
+function organPair(packageRoot) {
+    for (const pair of ORGAN_PAIRS) {
+        if (existsSync(join(packageRoot, pair[0])) && existsSync(join(packageRoot, pair[1]))) {
+            return pair;
+        }
+    }
+    return null;
+}
+function lensText(cwd) {
+    const file = join(cwd, ".xray", "state", "LENS.md");
+    if (!existsSync(file))
+        return { found: false, text: "" };
+    try {
+        return { found: true, text: readFileSync(file, "utf8").trim() };
+    }
+    catch {
+        return { found: false, text: "" };
+    }
+}
+function mapDrift(packageRoot, planesRel) {
+    try {
+        const data = JSON.parse(readFileSync(join(packageRoot, planesRel), "utf8"));
+        const map = Array.isArray(data.planes) ? data.planes.map((name) => String(name)) : [];
+        const same = map.length === WORN_PLANES.length && map.every((name, index) => name === WORN_PLANES[index]);
+        return same ? "" : "Actuality. Drift: worn is not the map.";
+    }
+    catch {
+        return "";
+    }
+}
+export function probeGoggles(packageRoot, cwd) {
+    const pair = organPair(packageRoot);
+    const organPresent = pair !== null;
+    const lens = lensText(cwd);
+    let kind0Text = "";
+    let kind0Label = "(no LENS yet)";
+    let kind0Quiet = false;
+    if (lens.found) {
+        kind0Text = lens.text;
+        if (!lens.text) {
+            kind0Quiet = true;
+            kind0Label = "quiet (match)";
+        }
+        else {
+            kind0Label = lens.text;
+        }
+    }
+    else if (pair) {
+        const drift = mapDrift(packageRoot, pair[1]);
+        if (drift) {
+            kind0Text = drift;
+            kind0Label = drift;
+        }
+    }
+    return {
+        organPresent,
+        kind0Text,
+        kind0Quiet,
+        kind0Label,
+        organLine: organPresent ? "Goggles: worn" : "Goggles: not found",
+    };
+}
+export function formatGogglesStatus(probe) {
+    return [probe.organLine, `Kind 0: ${probe.kind0Label}`];
+}

package/dist/cli/index.js

@@ -76,20 +76,42 @@ program
         process.exit(1);
     }
 });
-program
-    .command("goggles")
-    .argument("[args...]", "plane, then examine, triage, cascade, or teardown")
-    .description("Glimpse every plane, or one plane's way in. A hit does not open the plane.")
-    .action((args) => {
+const LOOK_HELP = "Kind 0 is quiet on a match. One outer is a reading. digest and triage return a card.";
+function gogglesScript() {
     const built = join(packageRoot, "dist", "integrations", "hooks", "goggles-pipeline.mjs");
     const source = join(packageRoot, "src", "integrations", "hooks", "goggles-pipeline.mjs");
-    const script = existsSync(built) ? built : source;
+    return existsSync(built) ? built : source;
+}
+function runGoggles(args) {
+    const script = gogglesScript();
+    if (!existsSync(script)) {
+        process.stderr.write("Goggles: not found\n");
+        process.exit(1);
+    }
+    if (process.stdout.isTTY) {
+        const result = spawnSync(process.execPath, [script, ...(args ?? [])], { stdio: "inherit" });
+        process.exit(result.status ?? 1);
+    }
     const result = spawnSync(process.execPath, [script, ...(args ?? [])], { encoding: "utf8" });
     if (result.stdout)
         process.stdout.write(result.stdout);
     if (result.stderr)
         process.stderr.write(result.stderr);
     process.exit(result.status ?? 1);
+}
+program
+    .command("look")
+    .argument("[args...]", "kind 0, one outer, or digest/triage and one card plane")
+    .description(LOOK_HELP)
+    .action((args) => {
+    runGoggles(args);
+});
+program
+    .command("goggles")
+    .argument("[args...]", "same words as look")
+    .description(`Same organ as look. ${LOOK_HELP}`)
+    .action((args) => {
+    runGoggles(args);
 });
 program
     .command("wear")
@@ -130,7 +152,7 @@ program
     .description("Show comprehensive xray framework status")
     .action(async () => {
     const { statusCommand } = await import("./commands/status.js");
-    await statusCommand();
+    await statusCommand(packageRoot);
 });
 program
     .command("validate")
@@ -267,6 +289,8 @@ program
             }
         }
         console.log("");
+        const { probeGoggles, formatGogglesStatus } = await import("./goggles-status.js");
+        process.stdout.write(`${formatGogglesStatus(probeGoggles(packageRoot, process.cwd())).join("\n")}\n\n`);
         if (allHealthy) {
             console.log("🎉 Framework is healthy and ready to use!");
             console.log("");

package/dist/integrations/grok/grok-cli.d.ts

@@ -24,8 +24,11 @@ export interface GrokInstallOptions {
 export declare function installForGrokCLI(options?: GrokInstallOptions): Promise<void>;
 /** Grok TUI reads <project>/.grok/config.toml, not the package copy. */
 export declare function writeProjectRepertoireMcp(projectRoot: string): string | null;
+/** Grok TUI reads <project>/.grok/config.toml. The launcher fills GOGGLES_ROOT from cwd. */
+export declare function writeProjectGogglesMcp(projectRoot: string): string | null;
 declare const _default: {
     installForGrokCLI: typeof installForGrokCLI;
     writeProjectRepertoireMcp: typeof writeProjectRepertoireMcp;
+    writeProjectGogglesMcp: typeof writeProjectGogglesMcp;
 };
 export default _default;

package/dist/integrations/grok/grok-cli.js

@@ -27,7 +27,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = path.resolve(__dirname, '..', '..', '..');
 const requireCjs = createRequire(import.meta.url);
 const { resolveConsumerTargetDir, patchGrokHooks } = requireCjs(path.join(packageRoot, 'scripts/node/install-bridges.cjs'));
-const { XRAY_MCP_SERVERS, resolveRepertoireMcp } = requireCjs(path.join(packageRoot, 'scripts/node/bridge-mcp-wiring.cjs'));
+const { XRAY_MCP_SERVERS, resolveRepertoireMcp, resolveGogglesMcp } = requireCjs(path.join(packageRoot, 'scripts/node/bridge-mcp-wiring.cjs'));
 function registerGrokMcpServers(targetDir) {
     try {
         execSync('which grok', { stdio: 'ignore' });
@@ -113,6 +113,7 @@ export async function installForGrokCLI(options = {}) {
             }
         }
         writeProjectRepertoireMcp(targetDir);
+        writeProjectGogglesMcp(targetDir);
         mintAfterWear(targetDir);
         const primary = dests[0];
         try {
@@ -177,6 +178,7 @@ function pinGrokPluginToInstalledDist(pluginDir, xrayRoot, targetDir) {
         }
     }
     const repertoireMcp = resolveRepertoireMcp(targetDir);
+    const gogglesMcp = resolveGogglesMcp(targetDir);
     if (mcp.mcpServers) {
         if (repertoireMcp) {
             mcp.mcpServers.repertoire = {
@@ -187,6 +189,16 @@ function pinGrokPluginToInstalledDist(pluginDir, xrayRoot, targetDir) {
         else {
             delete mcp.mcpServers.repertoire;
         }
+        if (gogglesMcp) {
+            mcp.mcpServers.goggles = {
+                command: 'node',
+                args: [gogglesMcp],
+                env: { GOGGLES_ROOT: targetDir, GOGGLES_PLANES_PATH: '' },
+            };
+        }
+        else {
+            delete mcp.mcpServers.goggles;
+        }
     }
     fs.writeFileSync(mcpPath, `${JSON.stringify(mcp, null, 2)}\n`);
 }
@@ -217,7 +229,35 @@ enabled = true
     }
     return tomlPath;
 }
+/** Grok TUI reads <project>/.grok/config.toml. The launcher fills GOGGLES_ROOT from cwd. */
+export function writeProjectGogglesMcp(projectRoot) {
+    const gogglesMcp = resolveGogglesMcp(projectRoot);
+    if (!gogglesMcp)
+        return null;
+    const grokDir = path.join(projectRoot, '.grok');
+    fs.mkdirSync(grokDir, { recursive: true });
+    const tomlPath = path.join(grokDir, 'config.toml');
+    const block = `[mcp_servers.goggles]
+command = "node"
+args = [${JSON.stringify(gogglesMcp)}]
+enabled = true
+`;
+    let existing = '';
+    if (fs.existsSync(tomlPath)) {
+        existing = fs.readFileSync(tomlPath, 'utf8');
+    }
+    if (/\[mcp_servers\.goggles\]/.test(existing)) {
+        existing = existing.replace(/\[mcp_servers\.goggles\][\s\S]*?(?=\n\[|$)/, block.trim());
+        fs.writeFileSync(tomlPath, existing.endsWith('\n') ? existing : `${existing}\n`);
+    }
+    else {
+        const prefix = existing.trim() ? `${existing.trim()}\n\n` : '';
+        fs.writeFileSync(tomlPath, `${prefix}${block}`);
+    }
+    return tomlPath;
+}
 export default {
     installForGrokCLI,
     writeProjectRepertoireMcp,
+    writeProjectGogglesMcp,
 };

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

@@ -0,0 +1,371 @@
+/**
+ * Goggles MCP. Stdio. Server name `goggles`.
+ * Tools: look, status_lens. Same organ as the CLI.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, 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';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import * as bundled from './goggles-pipeline.mjs';
+
+const HERE = fileURLToPath(new URL('.', import.meta.url));
+const SERVER_NAME = 'goggles';
+const DRAWING = /docs-site\/docs\/plates\/[a-z0-9-]+\.md/i;
+const CARD_PLANES = [
+  'ground',
+  'routing',
+  'house',
+  'boot',
+  'governance',
+  'memory-recall',
+  'orchestration',
+  'processor',
+  'reporting',
+];
+const SCOPES = ['ecosystem', 'part', 'one flow', 'one artifact'];
+
+const LOOK_SCHEMA = {
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    kind: {
+      type: 'string',
+      description: 'Optional. Use "0" or "actuality" for the lens. Omit when naming an outer.',
+      enum: ['0', 'actuality'],
+    },
+    outer: {
+      type: 'string',
+      description: 'One outer name. digest and triage return a card. The others return a reading.',
+      enum: ['dichotomy', 'syncopate', 'synthesis', 'digest', 'triage', 'loop'],
+    },
+    scope: {
+      type: 'string',
+      description: 'Zoom only. Not a kind. One level.',
+      enum: SCOPES,
+    },
+    plane: {
+      type: 'string',
+      description: 'Card plane for digest or triage only. Not the lens.',
+      enum: CARD_PLANES,
+    },
+  },
+};
+
+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.',
+    inputSchema: LOOK_SCHEMA,
+  },
+  {
+    name: 'status_lens',
+    description: 'Whether the organ is worn, and the last Kind 0. Quiet is a match. A missing organ is not drift.',
+    inputSchema: { type: 'object', additionalProperties: false, properties: {} },
+  },
+];
+
+function serverVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync(join(HERE, '../../../package.json'), 'utf8'));
+    return typeof pkg.version === 'string' && pkg.version ? pkg.version : 'local';
+  } catch {
+    return 'local';
+  }
+}
+
+function deny(code, reason) {
+  return {
+    ok: false,
+    quiet: false,
+    mode: 'deny',
+    content: '',
+    error: { gate: 'goggles', decision: 'deny', code, reason },
+  };
+}
+
+function quiet(mode) {
+  return { ok: true, quiet: true, mode, content: '' };
+}
+
+async function organApi() {
+  const override = typeof process.env.GOGGLES_ORGAN_PATH === 'string'
+    ? process.env.GOGGLES_ORGAN_PATH.trim()
+    : '';
+  if (!override) return bundled;
+  if (!existsSync(override)) return null;
+  return import(pathToFileURL(override).href);
+}
+
+function projectRoot(root) {
+  if (typeof root === 'string' && root.trim()) return root;
+  const env = process.env.GOGGLES_ROOT;
+  if (typeof env === 'string' && env.trim() && env.trim() !== '.') return env.trim();
+  return process.cwd();
+}
+
+function heldReading(root) {
+  try {
+    const data = JSON.parse(readFileSync(join(root, '.xray', 'state', 'goggles-reading.json'), 'utf8'));
+    if (!data || typeof data !== 'object') return null;
+    if (typeof data.drift === 'string' && data.drift) return { drift: data.drift };
+    if (typeof data.plane !== 'string' || !data.plane) return null;
+    return { plane: data.plane, scope: typeof data.scope === 'string' ? data.scope : '' };
+  } catch {
+    return null;
+  }
+}
+
+function denyCode(reason) {
+  if (/wider|crosses parts|not one flow/i.test(reason)) return 'scope_wider';
+  if (/Name one plane/i.test(reason)) return 'name_one';
+  return 'leave_plane';
+}
+
+function drawingPaths(args) {
+  const hits = [];
+  for (const value of Object.values(args)) {
+    if (typeof value === 'string' && DRAWING.test(value)) hits.push(value);
+  }
+  return hits;
+}
+
+function argvFrom(args) {
+  const words = [];
+  if (args.kind === '0') words.push('kind', '0');
+  else if (args.kind === 'actuality') words.push('actuality');
+  else if (args.kind === '1' || args.kind === '2') words.push('kind', String(args.kind));
+  else if (typeof args.kind === 'string') words.push(args.kind);
+  if (args.outer === 'outer loop') words.push('outer', 'loop');
+  else if (typeof args.outer === 'string') words.push(args.outer);
+  if (typeof args.plane === 'string' && !DRAWING.test(args.plane)) words.push(args.plane);
+  if (args.scope === 'one flow') words.push('one', 'flow');
+  else if (args.scope === 'one artifact') words.push('one', 'artifact');
+  else if (typeof args.scope === 'string') words.push(args.scope);
+  return words;
+}
+
+function pureKind0(args) {
+  return (args.kind === '0' || args.kind === 'actuality')
+    && args.outer == null
+    && args.plane == null
+    && args.scope == null;
+}
+
+function checkArgs(args) {
+  if (!args || typeof args !== 'object' || Array.isArray(args)) {
+    return deny('invalid_args', 'look takes an object.');
+  }
+  const allowed = new Set(['kind', 'outer', 'scope', 'plane']);
+  for (const key of Object.keys(args)) {
+    if (!allowed.has(key)) return deny('invalid_args', 'Unknown argument.');
+  }
+  for (const key of ['kind', 'outer', 'scope', 'plane']) {
+    if (args[key] != null && typeof args[key] !== 'string') {
+      return deny('invalid_args', `${key} must be a string.`);
+    }
+  }
+  if (args.kind != null && !['0', 'actuality', '1', '2'].includes(args.kind)) {
+    return deny('invalid_args', 'kind is 0 or actuality.');
+  }
+  if (args.outer != null && !LOOK_SCHEMA.properties.outer.enum.includes(args.outer)) {
+    const setName = args.outer === 'outer' || args.outer === 'outer-loop' || args.outer === 'outer loop';
+    if (!setName) return deny('invalid_args', 'Name one outer.');
+  }
+  if (args.scope != null && !SCOPES.includes(args.scope)) {
+    return deny('invalid_args', 'scope is one zoom level.');
+  }
+  if (args.plane != null && !CARD_PLANES.includes(args.plane) && !DRAWING.test(args.plane)) {
+    return deny('invalid_args', 'plane is a card plane.');
+  }
+  return null;
+}
+
+function publicCard(view) {
+  const notes = [];
+  if (view.flavor === 'triage') {
+    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)) : '';
+  if (view.narrow) {
+    return {
+      plane: view.plane,
+      flavor: view.flavor,
+      digest: view.digest || '',
+      files: Array.isArray(view.files) ? view.files : [],
+      notes,
+    };
+  }
+  return {
+    plane: view.plane,
+    flavor: view.flavor,
+    from: view.from || '',
+    digest: view.digest || '',
+    plate: view.plate || '',
+    entry: view.entry || '',
+    exit: view.exit || '',
+    files: Array.isArray(view.files) ? view.files : [],
+    skills,
+    setup: view.setup || '',
+    teardown: view.teardown || '',
+    worn: view.worn || '',
+    notes,
+  };
+}
+
+export async function answerLook(raw, root) {
+  if (raw != null && (typeof raw !== 'object' || Array.isArray(raw))) {
+    return deny('invalid_args', 'look takes an object.');
+  }
+  const args = raw && typeof raw === 'object' ? raw : {};
+  const bad = checkArgs(args);
+  if (bad) return bad;
+  const api = await organApi();
+  if (!api) return deny('invalid_args', 'Goggles organ not found.');
+  const here = projectRoot(root);
+  const drawings = drawingPaths(args);
+  if (drawings.length) {
+    const stop = api.organStop(heldReading(here), { text: drawings.join('\n'), paths: drawings, tool: 'look' });
+    if (stop && stop.reason) return deny(denyCode(stop.reason), stop.reason);
+    return quiet('reading');
+  }
+  if (pureKind0(args)) {
+    api.maintainLens(here);
+    const line = api.actualityLine();
+    if (!line) return quiet('kind0');
+    return { ok: true, quiet: false, mode: 'kind0', content: line };
+  }
+  const argv = argvFrom(args);
+  const text = api.look(argv).text;
+  if (text === 'Name one plane.') return deny('name_one', 'Name one plane.');
+  const cards = api.lookCards(argv);
+  if (Array.isArray(cards) && cards.length) {
+    const shown = cards.map(publicCard);
+    return {
+      ok: true,
+      quiet: false,
+      mode: 'card',
+      content: shown.length === 1 ? shown[0] : shown,
+      outer: args.outer,
+      scope: args.scope || null,
+    };
+  }
+  if (!text) {
+    if (args.kind === '0' || args.kind === 'actuality') return quiet('kind0');
+    if (args.outer === 'digest' || args.outer === 'triage') return quiet('card');
+    return quiet('reading');
+  }
+  if (text.startsWith('Actuality. Drift:')) {
+    return { ok: true, quiet: false, mode: 'kind0', content: text };
+  }
+  return {
+    ok: true,
+    quiet: false,
+    mode: 'reading',
+    content: text,
+    outer: args.outer ?? null,
+    scope: args.scope || null,
+  };
+}
+
+function lensBody(root) {
+  const file = join(root, '.xray', 'state', 'LENS.md');
+  if (!existsSync(file)) return { found: false, text: '' };
+  try {
+    return { found: true, text: readFileSync(file, 'utf8').trim() };
+  } catch {
+    return { found: false, text: '' };
+  }
+}
+
+export async function answerStatus(root) {
+  const api = await organApi();
+  const override = typeof process.env.GOGGLES_ORGAN_PATH === 'string'
+    ? process.env.GOGGLES_ORGAN_PATH.trim()
+    : '';
+  const organPath = override || fileURLToPath(new URL('./goggles-pipeline.mjs', import.meta.url));
+  const planesPath = api ? api.planesFile() : '';
+  const organOk = existsSync(organPath);
+  const planesOk = Boolean(planesPath) && existsSync(planesPath);
+  const worn = Boolean(api) && organOk && planesOk;
+  const here = projectRoot(root);
+  const lens = lensBody(here);
+  let kind0 = 'none';
+  let kind0Text = '';
+  if (lens.found && !lens.text) kind0 = 'quiet';
+  else if (lens.found) {
+    kind0 = 'drift';
+    kind0Text = lens.text;
+  } else if (worn) {
+    const line = api.actualityLine();
+    if (line) {
+      kind0 = 'drift';
+      kind0Text = line;
+    }
+  }
+  return {
+    ok: true,
+    organ: worn ? 'worn' : 'not_found',
+    organPath: organOk ? organPath : '',
+    planesPath: planesOk ? planesPath : '',
+    kind0,
+    kind0Text,
+    lensPath: '.xray/state/LENS.md',
+  };
+}
+
+export async function dispatchTool(name, args, root) {
+  const bare = String(name || '').replace(/^goggles__/, '');
+  if (bare === 'status_lens') {
+    const input = args && typeof args === 'object' ? args : {};
+    if (Object.keys(input).length) {
+      return { payload: deny('invalid_args', 'status_lens takes no arguments.'), isError: true };
+    }
+    return { payload: await answerStatus(root), isError: false };
+  }
+  if (bare === 'look') {
+    const payload = await answerLook(args, root);
+    return { payload, isError: payload.mode === 'deny' };
+  }
+  return { payload: deny('invalid_args', 'Unknown tool.'), isError: true };
+}
+
+export function createGogglesServer() {
+  const server = new Server(
+    { name: SERVER_NAME, version: serverVersion() },
+    { capabilities: { tools: {} } },
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS.map((tool) => ({
+      name: tool.name,
+      description: tool.description,
+      inputSchema: tool.inputSchema,
+    })),
+  }));
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const args = request.params.arguments ?? {};
+    const { payload, isError } = await dispatchTool(request.params.name, args, projectRoot());
+    return {
+      content: [{ type: 'text', text: JSON.stringify(payload) }],
+      isError,
+    };
+  });
+  return server;
+}
+
+async function main() {
+  const server = createGogglesServer();
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+const thisFile = fileURLToPath(import.meta.url);
+const invoked = process.argv[1] ? resolve(process.argv[1]) : '';
+if (invoked && resolve(thisFile) === invoked) {
+  main().catch((err) => {
+    process.stderr.write(`goggles MCP failed: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+  });
+}

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

@@ -14,9 +14,16 @@ const CARD_PLANES = ['ground', 'routing', 'house', 'boot', 'governance', 'memory
 const CARD_FLAVORS = ['digest', 'triage'];
 const SCOPE_ZOOM = ['ecosystem', 'part', 'one flow', 'one artifact'];
 
+/** Empty GOGGLES_PLANES_PATH keeps the file beside the organ. */
+export function planesFile() {
+  const override = process.env.GOGGLES_PLANES_PATH;
+  if (typeof override === 'string' && override.trim()) return override.trim();
+  return join(HERE, 'goggles-planes.json');
+}
+
 function drawnPlanes() {
   try {
-    const data = JSON.parse(readFileSync(join(HERE, 'goggles-planes.json'), 'utf8'));
+    const data = JSON.parse(readFileSync(planesFile(), 'utf8'));
     return Array.isArray(data.planes) ? data.planes.map((name) => String(name)) : [];
   } catch {
     return [];
@@ -169,7 +176,7 @@ function namesTheSet(lower) {
   return planes.length === 1 && planes[0] === 'loop' && findScopes(lower).length === 0;
 }
 
-export function readGoggles(argv) {
+function gogglesAnswer(argv) {
   const words = [];
   for (const raw of argv || []) {
     const arg = String(raw || '').trim();
@@ -177,102 +184,157 @@ export function readGoggles(argv) {
     words.push(arg);
   }
   const lower = words.map((word) => word.toLowerCase());
-  if (lower.includes('calling')) return ok('');
-  if (kindPastOne(words)) return ok('');
-  if (words.length === 0) return ok('');
-  if (namesTheSet(lower)) return ok('Name one plane.');
+  const none = (text) => ({ text, cards: null });
+  if (lower.includes('calling')) return none('');
+  if (kindPastOne(words)) return none('');
+  if (words.length === 0) return none('');
+  if (namesTheSet(lower)) return none('Name one plane.');
   if (isKindZero(lower)) {
-    if (findScopes(words).length) return ok('');
-    if (acceptedPlanes().some((name) => lower.includes(name))) return ok('');
-    return ok(actualityLine());
+    if (findScopes(words).length) return none('');
+    if (acceptedPlanes().some((name) => lower.includes(name))) return none('');
+    return none(actualityLine());
   }
   const flavors = CARD_FLAVORS.filter((name) => lower.includes(name));
-  if (flavors.length > 1) return ok('');
+  if (flavors.length > 1) return none('');
   if (flavors.length === 1) {
     const others = acceptedPlanes().filter((name) => name !== flavors[0] && lower.includes(name));
-    if (others.length) return ok('');
-    return ok(cardLook(flavors[0], lower));
+    if (others.length) return none('');
+    const cards = collectCards(flavors[0], lower);
+    if (!cards) return none('');
+    return { text: cards.map((card) => formatCardText(card)).join('\n\n'), cards };
   }
   const planes = acceptedPlanes().filter((name) => lower.includes(name));
-  if (planes.length !== 1) return ok('');
+  if (planes.length !== 1) return none('');
   const scopes = findScopes(words.filter((word) => word.toLowerCase() !== planes[0]));
-  if (scopes.length > 1) return ok('');
-  return ok(readingLine(planes[0], scopes[0] || ''));
+  if (scopes.length > 1) return none('');
+  return none(readingLine(planes[0], scopes[0] || ''));
+}
+
+export function readGoggles(argv) {
+  return ok(gogglesAnswer(argv).text);
+}
+
+export function lookCards(argv) {
+  return gogglesAnswer(argv).cards;
 }
 
 function cardPlanesNamed(lower) {
   return CARD_PLANES.filter((name) => lower.includes(name));
 }
 
-function fileList(plane) {
-  const files = Array.isArray(plane.files) ? plane.files : [];
+function listedFiles(plane, scope) {
+  const files = Array.isArray(plane.files) ? plane.files.map(String) : [];
+  if (scope === 'one artifact') return files.length === 1 ? [files[0]] : null;
   const unpathed = Array.isArray(plane.unpathed) ? plane.unpathed : [];
-  const parts = [...files];
-  for (const name of unpathed) {
-    parts.push(name === 'mill' ? 'mill has no path' : name);
+  const parts = files.slice();
+  for (const name of unpathed) parts.push(name === 'mill' ? 'mill has no path' : String(name));
+  return parts;
+}
+
+function cardView(plane, scope, flavor, root) {
+  const listed = listedFiles(plane, scope);
+  if (!listed) return null;
+  const view = {
+    plane: plane.id,
+    flavor,
+    scope: scope || '',
+    from: plane.id === 'ground' ? '' : 'ground',
+    digest: plane.digest || '',
+    plate: plane.plate || '',
+    entry: plane.entry || '',
+    exit: plane.exit || '',
+    files: listed,
+    skills: plane.skills || '',
+    setup: plane.setup || '',
+    teardown: plane.teardown || '',
+    worn: plane.worn || '',
+    narrow: scope === 'one flow' || scope === 'one artifact',
+  };
+  if (flavor === 'triage') {
+    const filled = new Set(filledOf(plane));
+    view.empty = FIELD_ORDER.filter((name) => !filled.has(name));
+    view.exam = examinePlane(plane, root).text;
   }
-  return parts.join(', ');
+  return view;
 }
 
-function cardRows(plane, scope) {
-  const files = Array.isArray(plane.files) ? plane.files : [];
-  if (scope === 'one artifact' && files.length !== 1) return null;
+function formatCardText(view) {
   const rows = [
-    ['Plane', plane.id],
-    ['From', plane.id === 'ground' ? '' : 'ground'],
-    ['Digest', plane.digest || ''],
-    ['Plate', plane.plate || ''],
-    ['Entry', plane.entry || ''],
-    ['Exit', plane.exit || ''],
-    ['Files', scope === 'one artifact' ? files[0] : fileList(plane)],
-    ['Skills', plane.skills || ''],
-    ['Setup', plane.setup || ''],
-    ['Teardown', plane.teardown || ''],
-    ['Worn', plane.worn || ''],
+    ['Plane', view.plane],
+    ['From', view.from],
+    ['Digest', view.digest],
+    ['Plate', view.plate],
+    ['Entry', view.entry],
+    ['Exit', view.exit],
+    ['Files', view.files.join(', ')],
+    ['Skills', view.skills],
+    ['Setup', view.setup],
+    ['Teardown', view.teardown],
+    ['Worn', view.worn],
   ];
-  if (scope === 'one flow' || scope === 'one artifact') {
-    return rows.filter(([key]) => key === 'Plane' || key === 'Digest' || key === 'Files');
+  const shown = view.narrow
+    ? rows.filter(([key]) => key === 'Plane' || key === 'Digest' || key === 'Files')
+    : rows;
+  let text = shown.map(([key, value]) => `${key}: ${value}`.trimEnd()).join('\n');
+  if (view.flavor === 'triage') {
+    const lines = [];
+    if (view.empty.length) lines.push(`Empty: ${view.empty.join(', ')}`);
+    lines.push(view.exam);
+    text = `${text}\n${lines.join('\n')}`;
   }
-  return rows;
-}
-
-function triageNote(plane, root) {
-  const filled = new Set(filledOf(plane));
-  const empty = FIELD_ORDER.filter((name) => !filled.has(name));
-  const exam = examinePlane(plane, root);
-  const lines = [];
-  if (empty.length) lines.push(`Empty: ${empty.join(', ')}`);
-  lines.push(exam.text);
-  return lines.join('\n');
+  return text;
 }
 
-function formatPlaneCard(plane, scope, flavor, root) {
-  const rows = cardRows(plane, scope);
-  if (!rows) return null;
-  let text = rows.map(([key, value]) => `${key}: ${value}`.trimEnd()).join('\n');
-  if (flavor === 'triage') text = `${text}\n${triageNote(plane, root)}`;
-  return text;
+export function formatCardPane(view) {
+  const rows = [['Plane', view.plane]];
+  if (!view.narrow) rows.push(['From', view.from]);
+  rows.push(['Digest', view.digest]);
+  if (!view.narrow) {
+    rows.push(
+      ['Plate', view.plate],
+      ['Entry', view.entry],
+      ['Exit', view.exit],
+      ['Files', view.files.join(', ')],
+      ['Skills', view.skills],
+      ['Setup', view.setup],
+      ['Teardown', view.teardown],
+      ['Worn', view.worn],
+    );
+  } else {
+    rows.push(['Files', view.files.join(', ')]);
+  }
+  if (view.flavor === 'triage') {
+    if (Array.isArray(view.empty) && view.empty.length) rows.push(['Empty', view.empty.join(', ')]);
+    if (view.exam) rows.push(['', view.exam]);
+  }
+  const body = rows.map(([label, value]) => (label ? `${label.padEnd(8)} ${value}` : value).trimEnd());
+  const title = `${view.flavor} · ${view.plane}`;
+  const width = Math.max(title.length + 2, ...body.map((line) => line.length));
+  const top = `┌ ${title} ${'─'.repeat(Math.max(0, width - title.length - 1))}┐`;
+  const mid = body.map((line) => `│ ${line.padEnd(width)} │`);
+  const bot = `└${'─'.repeat(width + 2)}┘`;
+  return [top, ...mid, bot].join('\n');
 }
 
-function cardLook(flavor, lower) {
+function collectCards(flavor, lower) {
   const named = cardPlanesNamed(lower);
   const scopes = findScopes(lower.filter((word) => word !== flavor && !named.includes(word)));
-  if (named.length > 1 || scopes.length > 1) return '';
+  if (named.length > 1 || scopes.length > 1) return null;
   const scope = scopes[0] || '';
-  if (!named.length && (scope === 'part' || scope === 'one flow' || scope === 'one artifact')) return '';
+  if (!named.length && (scope === 'part' || scope === 'one flow' || scope === 'one artifact')) return null;
   const platesDir = findPlatesDir(HERE);
-  if (!platesDir) return '';
+  if (!platesDir) return null;
   const ids = named.length ? named : CARD_PLANES;
   const root = repoRootFrom(platesDir);
-  const blocks = [];
+  const cards = [];
   for (const id of ids) {
     const plane = assemblePlane(id, platesDir);
     if (!plane) continue;
-    const text = formatPlaneCard(plane, scope, flavor, root);
-    if (text === null) return '';
-    blocks.push(text);
+    const view = cardView(plane, scope, flavor, root);
+    if (!view) return null;
+    cards.push(view);
   }
-  return blocks.join('\n\n');
+  return cards;
 }
 
 export function findPlatesDir(start) {
@@ -347,7 +409,7 @@ function takeOf(body) {
 
 
 function overlayTable() {
-  const file = join(HERE, 'goggles-planes.json');
+  const file = planesFile();
   if (!existsSync(file)) return {};
   return JSON.parse(readFileSync(file, 'utf8'));
 }
@@ -562,7 +624,9 @@ export function maintainLens(root) {
 
 const isMain = Boolean(process.argv[1]) && resolve(process.argv[1]) === fileURLToPath(import.meta.url);
 if (isMain) {
-  const result = readGoggles(process.argv.slice(2));
-  process.stdout.write(`${result.text}\n`);
-  process.exit(result.ok ? 0 : 1);
+  const answered = gogglesAnswer(process.argv.slice(2));
+  const pane = process.stdout.isTTY && Array.isArray(answered.cards) && answered.cards.length > 0;
+  const text = pane ? answered.cards.map((card) => formatCardPane(card)).join('\n\n') : answered.text;
+  process.stdout.write(`${text}\n`);
+  process.exit(0);
 }

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

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

package/dist/skills/orchestrator/SKILL.md

@@ -55,11 +55,11 @@ When `multi_agent_orchestration.lead_dev_mode` is true in `features.json` (defau
 
 ## Goggles
 
-Pushed on `feat/goggles-look`. Not merged. Not published. Grok CLI has not shipped this. Wear the local build. From the worn checkout run `node dist/integrations/hooks/goggles-pipeline.mjs`. Do not run `npx 0xray goggles`. If `dist` is older than `src/integrations/hooks/goggles-pipeline.mjs`, build that tree and wear that `dist`. A subagent wears this same local build.
+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. Calling stays off.
+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.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "0xray",
-  "version": "4.0.31",
+  "version": "4.0.32",
   "description": "Multi-agent orchestration and Codex governance for OpenCode, Hermes, Grok Build, and OpenClaw",
   "readme": "README.md",
   "license": "MIT",
@@ -170,6 +170,7 @@
     "scripts/mjs/verify-temperament-live.mjs",
     "scripts/mjs/verify-four-floor-compact.mjs",
     "scripts/mjs/run-repertoire-mcp.mjs",
+    "scripts/mjs/run-goggles-mcp.mjs",
     "scripts/mjs/verify-delegation-gate-core.mjs",
     "scripts/mjs/delegation-gate-fixture.mjs",
     "src/opencode/",

package/scripts/foundry/assert-packed-dist-cli.mjs

@@ -29,6 +29,10 @@ export const REQUIRED_PACK_PATHS = [
   "dist/integrations/cursor/hooks/pre-compact.sh",
   "dist/integrations/cursor/hooks/after-file-edit.sh",
   "dist/integrations/hooks/plates.cjs",
+  "dist/integrations/hooks/goggles-pipeline.mjs",
+  "dist/integrations/hooks/goggles-planes.json",
+  "dist/integrations/hooks/goggles-mcp.mjs",
+  "scripts/mjs/run-goggles-mcp.mjs",
   "docs-site/docs/plates/memory-recall.md",
   "docs-site/docs/plates/processor.md",
   "docs-site/docs/plates/goggles.md",

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/src/integrations/openclaw/plugin/xray-pre-tool/package.json

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

package/src/skills/orchestrator/SKILL.md

@@ -55,11 +55,11 @@ When `multi_agent_orchestration.lead_dev_mode` is true in `features.json` (defau
 
 ## Goggles
 
-Pushed on `feat/goggles-look`. Not merged. Not published. Grok CLI has not shipped this. Wear the local build. From the worn checkout run `node dist/integrations/hooks/goggles-pipeline.mjs`. Do not run `npx 0xray goggles`. If `dist` is older than `src/integrations/hooks/goggles-pipeline.mjs`, build that tree and wear that `dist`. A subagent wears this same local build.
+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. Calling stays off.
+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.
 

package/xray/features.json

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