0xray 4.0.31 → 4.0.33

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 || lens.text === "quiet (match)") {
+            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/governance/governance-service.js

@@ -21,6 +21,7 @@ import { getGovernanceIntegration, } from '../integrations/governance/index.js';
 import { applyDecisionMatrix, calculateMetamorphosisScore, mergeVotes, } from './governance-core.js';
 import { frameworkLogger } from '../core/framework-logger.js';
 import { featuresConfigLoader } from '../core/features-config.js';
+import { lensPlane } from '../integrations/hooks/goggles-pipeline.mjs';
 export class GovernanceService {
     constructor() {
         // We deliberately do *not* cache the integration here.
@@ -187,12 +188,21 @@ export class GovernanceService {
                         finalDecision = 'needs_revision';
                     }
                 }
+                const plane = lensPlane(`${proposal.title} ${proposal.description}`);
+                const about = [proposal.title, proposal.description, ...(proposal.evidence ?? [])].join('\n');
+                let reasoningSummary = merged.reasoningSummary;
+                if (plane.files.length > 0 &&
+                    finalDecision === 'approve' &&
+                    !plane.files.some((file) => about.includes(file))) {
+                    finalDecision = 'needs_revision';
+                    reasoningSummary = `${reasoningSummary} Not about ${plane.files[0]}.`.trim();
+                }
                 return {
                     proposalId: proposal.id,
                     finalDecision,
                     averageConfidence,
                     votes,
-                    reasoningSummary: merged.reasoningSummary,
+                    reasoningSummary,
                     moralOverride,
                     ...(metamorphosisScore != null ? { metamorphosisScore } : {}),
                 };

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

@@ -330,10 +330,13 @@ 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 */
+    const hook = String((payload && (payload.hookEvent || payload.source)) || "");
+    if (!/compact/i.test(hook)) {
+      try {
+        handCard(root, payload && (payload.cardText || payload.intent));
+      } catch {
+        /* a missed card must not fail the boot */
+      }
     }
     return sessionBootPath(root);
   } catch {

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

@@ -21,7 +21,7 @@ import {
   workspaceRoot,
 } from './grok-hook-utils.js';
 import { appendHookActivity } from './grok-hook-activity.js';
-import { cardStop } from '../../hooks/goggles-pipeline.mjs';
+import { cardStop, lensBeforeResearch } from '../../hooks/goggles-pipeline.mjs';
 import { createRequire } from 'node:module';
 import { existsSync } from 'node:fs';
 import { dirname, join } from 'node:path';
@@ -154,6 +154,12 @@ async function main() {
       });
     }
 
+    const spoken = [cmd, content, toolInput.pattern, toolInput.query, ...(ctx.paths || [])].filter(Boolean).join('\n');
+    const lensStop = lensBeforeResearch(eventRoot, toolName, spoken);
+    if (lensStop?.decision === 'deny') {
+      finish(eventRoot, 'deny', lensStop.reason, null, toolName, { gate: lensStop.gate });
+    }
+
     const route = repertoireRoute([toolName, cmd, content].filter(Boolean).join(' '));
 
     if (isShellTool(toolName) && cmd) {

package/dist/integrations/grok/hooks/session-start.js

@@ -147,11 +147,14 @@ async function main() {
           : '0xray/grok-session-start';
 
     const intent = extractIntent(event);
-    const matchedSignals = await matchStationSignals(eventRoot, intent);
+    const matchedSignals =
+      HOOK_EVENT === 'user_prompt_submit' ? [] : await matchStationSignals(eventRoot, intent);
+    const compact = COMPACT_EVENTS.has(HOOK_EVENT);
     const payload = buildSessionBootPayload(eventRoot, source, {
       hookEvent: HOOK_EVENT,
       sessionId: event.sessionId || process.env.GROK_SESSION_ID || null,
-      ...(intent ? { intent, cardText: intent } : {}),
+      ...(intent ? { intent } : {}),
+      ...(!compact && intent ? { cardText: intent } : {}),
       ...(matchedSignals.length ? { matchedSignals } : {}),
     });