0xray 4.0.30 → 4.0.32

package/.grok-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "0xray",
-  "version": "4.0.30",
+  "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

@@ -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/.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",

package/dist/CHANGELOG.md

@@ -7,6 +7,7 @@ The format is based on [Conventional Commits](https://www.conventionalcommits.or
 ## [Unreleased]
 
 ### Features
+- **Goggles.** Proposed plates for goggles, suit, kits, host pack, and glossary. Goggles views one plane. Recall opens a plate when speech names that plate. Plates only. Not a new skill.
 - **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.
@@ -41,6 +42,22 @@ 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.
+
+Goggles looks at one pipeline. Kind 0 name-checks the six outer names and stays quiet when the worn list matches the map. Digest and triage return one card. A leave is denied. Session boot hands the card through `handCard` and normalizes the workspace root, including a trailing slash. The mill path is `scripts/foundry`. Run `node dist/integrations/hooks/goggles-pipeline.mjs`. This cut also carries the plate docs and the live project-file signal count that landed on main after 4.0.30. Calling and confer stay off. Companion `@0xray/grok-bot` is unchanged at 0.1.8.
+
+---
+
 ## [4.0.30] - 2026-09-28
 
 Next patch after npm `4.0.29`. Released 2026-09-28.

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,8 +23,17 @@ 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",
+    "docs-site/docs/plates/suit.md",
+    "docs-site/docs/plates/kits.md",
+    "docs-site/docs/plates/host-pack.md",
+    "docs-site/docs/plates/glossary.md",
 ];
 export const CONSUMER_WEAR_PATHS = [
     "AGENTS.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

@@ -5,7 +5,7 @@
  * Provides commands for installing and managing xray framework
  */
 import { Command } from "commander";
-import { execSync, spawn } from "child_process";
+import { execSync, spawn, spawnSync } from "child_process";
 import { join, resolve } from "path";
 import { fileURLToPath } from "node:url";
 import { readFileSync, existsSync } from "fs";
@@ -76,6 +76,43 @@ program
         process.exit(1);
     }
 });
+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");
+    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")
     .description("Wear the 0xray suit in this git checkout")
@@ -115,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")
@@ -252,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/grok/hooks/grok-hook-utils.js

@@ -28,6 +28,7 @@ import {
   retainCompactFields,
   writeStationMarkdown,
 } from '../../hooks/station-hook-runtime.mjs';
+import { handCard } from '../../hooks/goggles-pipeline.mjs';
 
 export {
   checkPendingDelegationGate,
@@ -86,12 +87,18 @@ const WRITE_TOOLS = new Set([
   'EditNotebook',
 ]);
 
+export function normalizeWorkspaceRoot(root) {
+  const raw = String(root || '').trim();
+  if (!raw) return raw;
+  return path.resolve(raw);
+}
+
 export function workspaceRoot() {
-  return (
+  return normalizeWorkspaceRoot(
     process.env.GROK_WORKSPACE_ROOT ||
     process.env.CLAUDE_PROJECT_DIR ||
     process.env.XRAY_ROOT ||
-    process.cwd()
+    process.cwd(),
   );
 }
 
@@ -198,6 +205,7 @@ export function extractToolContext(event) {
 
   if (toolInput.path) paths.push(String(toolInput.path));
   if (toolInput.file_path) paths.push(String(toolInput.file_path));
+  if (toolInput.target_file) paths.push(String(toolInput.target_file));
   if (toolInput.target_notebook) paths.push(String(toolInput.target_notebook));
   if (Array.isArray(toolInput.paths)) paths.push(...toolInput.paths.map(String));
 
@@ -301,7 +309,7 @@ export function buildSessionBootPayload(root, source = '0xray/grok-session-start
       ? 'xray-orchestrator analyze-complexity optional on frontier (spawn warns, does not deny)'
       : 'xray-orchestrator → analyze-complexity (required before spawn_subagent)',
     enforcement: 'PreToolUse hook — Codex constitution always on; ceremony scales by suit_temperament',
-    workspaceRoot: root,
+    workspaceRoot: normalizeWorkspaceRoot(root),
     ...heat,
     ...(siblingRoots.length > 0 ? { siblingWorkspaceRoots: siblingRoots } : {}),
     ...(conferPending ? { conferPending: true, conferTrigger: 'analyze-complexity at synthesis checkpoint' } : {}),
@@ -322,6 +330,11 @@ export function writeSessionBoot(root, payload) {
     fs.mkdirSync(stateDir, { recursive: true });
     fs.writeFileSync(sessionBootPath(root), JSON.stringify(payload, null, 2));
     writeStationMarkdown(root, payload);
+    try {
+      handCard(root, payload && (payload.cardText || payload.intent));
+    } catch {
+      /* a missed card must not fail the boot */
+    }
     return sessionBootPath(root);
   } catch {
     return null;
@@ -333,9 +346,16 @@ export function sessionBootNeedsRefresh(existing, root) {
   if (existing.lead_dev_mode === undefined) return true;
   if (existing.host !== 'grok') return true;
   if (!existing.suit_profile) return true;
-  if (existing.workspaceRoot && existing.workspaceRoot !== root) return true;
+  if (
+    existing.workspaceRoot &&
+    normalizeWorkspaceRoot(existing.workspaceRoot) !== normalizeWorkspaceRoot(root)
+  ) {
+    return true;
+  }
   if (!existing.repertoireResume) return true;
   if (!existing.stationLine) return true;
+  const liveResume = buildRepertoireResume(root);
+  if (liveResume && existing.repertoireResume !== liveResume) return true;
   return false;
 }
 

package/dist/integrations/grok/hooks/post-tool-use.js

@@ -10,6 +10,7 @@ import {
   isSubagentTool,
   isWriteTool,
   loadFeatures,
+  normalizeWorkspaceRoot,
   readStdinJson,
   resolveSessionId,
   workspaceRoot,
@@ -33,7 +34,7 @@ function extractToolOutput(event) {
 }
 
 export function handlePostToolUse(event, root = workspaceRoot()) {
-  const eventRoot = event.workspaceRoot || event.cwd || root;
+  const eventRoot = normalizeWorkspaceRoot(event.workspaceRoot || event.cwd || root);
   const sessionId = resolveSessionId(event);
   const { toolName, toolInput } = extractToolContext(event);
 

package/dist/integrations/grok/hooks/pre-tool-use.js

@@ -15,11 +15,72 @@ import {
   isShellTool,
   isWriteTool,
   loadFeatures,
+  normalizeWorkspaceRoot,
   readStdinJson,
   resolveSessionId,
   workspaceRoot,
 } from './grok-hook-utils.js';
 import { appendHookActivity } from './grok-hook-activity.js';
+import { cardStop } from '../../hooks/goggles-pipeline.mjs';
+import { createRequire } from 'node:module';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const hookDir = 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(hookDir, '../../../nucleus/thin-dispatch.js'),
+    join(hookDir, '../../../../dist/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.`,
+    },
+  };
+}
+
+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;
+  }
+}
 
 function finish(root, decision, reason, hint, toolName, extra = {}) {
   const out = { decision, ...extra };
@@ -30,6 +91,7 @@ function finish(root, decision, reason, hint, toolName, extra = {}) {
     tool: toolName,
     reason: reason || hint || null,
     gate: extra.gate || null,
+    agent: extra.agent || null,
     livePath: true,
   });
   process.exit(0);
@@ -41,7 +103,7 @@ async function main() {
 
   try {
     const event = await readStdinJson();
-    const eventRoot = event.workspaceRoot || event.cwd || root;
+    const eventRoot = normalizeWorkspaceRoot(event.workspaceRoot || event.cwd || root);
     ensureSessionBoot(eventRoot, '0xray/grok-pre-tool-use-boot');
 
     const features = loadFeatures(eventRoot);
@@ -75,9 +137,28 @@ async function main() {
       if (extraBlock) finish(eventRoot, 'deny', extraBlock, null, toolName);
     }
 
+    const stop = cardStop(
+      eventRoot,
+      toolName,
+      [cmd, content, toolInput.pattern, toolInput.query, ...(ctx.paths || [])].filter(Boolean).join('\n'),
+      ctx.paths || [],
+      toolInput,
+    );
+    if (stop?.decision === 'deny') {
+      finish(eventRoot, 'deny', stop.reason, null, toolName, { gate: stop.gate });
+    }
+    if (stop?.decision === 'allow') {
+      finish(eventRoot, 'allow', null, null, toolName, {
+        gate: stop.gate,
+        hookSpecificOutput: stop.hookSpecificOutput,
+      });
+    }
+
+    const route = repertoireRoute([toolName, cmd, content].filter(Boolean).join(' '));
+
     if (isShellTool(toolName) && cmd) {
       const testHint = checkFullTestSuite(cmd, features);
-      if (testHint) finish(eventRoot, 'allow', null, testHint, toolName);
+      if (testHint) finish(eventRoot, 'allow', null, testHint, toolName, route || {});
     }
 
     if (gateBlock.reason) {
@@ -87,11 +168,11 @@ async function main() {
         gateBlock.reason,
         gateBlock.hint,
         toolName,
-        { gate: gateBlock.gate, warn: true },
+        { gate: gateBlock.gate, warn: true, ...(route || {}) },
       );
     }
 
-    finish(eventRoot, 'allow', null, null, toolName);
+    finish(eventRoot, 'allow', null, null, toolName, route || {});
   } catch (err) {
     appendHookActivity(root, 'grok-pre-tool-use', 'hook-error', 'error', {
       tool: toolName,
@@ -116,6 +197,7 @@ function extractFromEvent(event) {
 
   if (toolInput.path) paths.push(String(toolInput.path));
   if (toolInput.file_path) paths.push(String(toolInput.file_path));
+  if (toolInput.target_file) paths.push(String(toolInput.target_file));
   if (toolInput.target_notebook) paths.push(String(toolInput.target_notebook));
   if (Array.isArray(toolInput.paths)) paths.push(...toolInput.paths.map(String));
 
@@ -133,4 +215,7 @@ function extractFromEvent(event) {
   };
 }
 
-main();
+const launchedAsCli = Boolean(process.argv[1] && process.argv[1].endsWith('pre-tool-use.js'));
+if (launchedAsCli) {
+  main();
+}