0xray 4.0.39 → 4.0.41

package/.grok-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "0xray",
-  "version": "4.0.39",
+  "version": "4.0.41",
   "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/.xray/features.json

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

package/dist/CHANGELOG.md

@@ -42,6 +42,35 @@ 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.41] - 2026-10-07
+
+### 🔄 Changes
+
+- Wake cascade. Station and the notes page stay on the station module. Heat writes `Cascade: record-map · notes N current` on the card. A memory-recall look returns that plane, the matched law names, and the current lines from the session-note index beside the laws.
+- Session notes sit in `.xray/state/repertoire/session-notes.json` beside the laws. A replaced note stays history. The short index returns the current line. A stale page does not revive a replaced line.
+- `Sleeve: on` means the previous ticket came back, the worn plate matched the package, the previous ticket matched the working record, and inspect passed. Session start and compact run that check. The card keeps the named plane. Judgement is continue, retry N, stop, or start. The same miss keeps its retry. A different ticket stops. Payments is on only when the ticket is a payment.
+- A fresh wear fastens mill and inspect. The durable copy is staged beside the live wear. Hooks and MCP launchers are not pinned at a temporary checkout.
+- Goggles. A checkout named `0xray` records `scripts/mjs/run-goggles-mcp.mjs`. A consumer records `node_modules/0xray`. An upgrade that removes a self-install no longer leaves the handshake on a missing file.
+- A machine-level Grok plugin does not fail the mill and is not stored in the mill receipt. A change to the worn skills drops that pass until the next session start or compact. When the plate or the mill is the miss, that miss is the plan until the line is on again. A copied role skill whose text was edited still stops wear.
+- A SessionStart event that carries the opening prompt stays a session start, so the check runs before that first card is read.
+- Live page. The mesh plays in the browser, with rewind and seat images. The watch survives a dropped connection. Fleet pushes go out as packets.
+- The Playwright release-gate smoke stays on the Playwright battery. The unit runner does not load that spec.
+
+---
+
+## [4.0.40] - 2026-10-05
+
+### 🔄 Changes
+
+### 🔎 Other Changes
+- house/live-mesh: full loop — feed watch, mesh render, direction, deploy, `/health`, X ledger both ways (#214, #215).
+- house: define Ping-pong in OP-PROC lexicon (#213).
+- house: OP-PROC cadence cleanup — muse-house lock, fleet forge0x1-merge, quiet/budget, sudo-copy seats (#216).
+- house: OP-PROC eng PR coach stack + 2026-10-04 eng state lock (#210, #212).
+- docs/dist: Dist packet note for 0xray 4.0.39 / repertoire 0.2.9 (#211).
+
+---
+
 ## [4.0.39] - 2026-10-03
 
 ### 🔄 Changes

package/dist/integrations/grok/hooks/grok-hook-utils.js

@@ -282,6 +282,25 @@ export function loadConferPending(root = workspaceRoot(), sessionId = null) {
   }
 }
 
+export function resolveGrokHookEvent(event = {}, argv = process.argv, env = process.env) {
+  if (env && env.GROK_HOOK_EVENT) return env.GROK_HOOK_EVENT;
+  const flag = (argv || []).find((arg) => String(arg).startsWith('--hook-event='));
+  if (flag) return String(flag).slice('--hook-event='.length);
+  const named = String((event && (event.hookEventName || event.hook)) || '')
+    .toLowerCase()
+    .replace(/[-_\s]/g, '');
+  if (named === 'precompact') return 'pre_compact';
+  if (named === 'postcompact') return 'post_compact';
+  if (named === 'sessionstart') return 'session_start';
+  if (
+    (event && (event.prompt != null || event.userMessage != null || event.user_prompt != null)) ||
+    named === 'userpromptsubmit'
+  ) {
+    return 'user_prompt_submit';
+  }
+  return 'session_start';
+}
+
 export function buildSessionBootPayload(root, source = '0xray/grok-session-start', extra = {}) {
   const features = loadFeatures(root);
   const blockingTerms = loadBlockingCodexTerms();
@@ -318,6 +337,7 @@ export function buildSessionBootPayload(root, source = '0xray/grok-session-start
     ...extra,
     ...heat,
     ...compactHold,
+    arrivedHook: extra && extra.hookEvent ? String(extra.hookEvent) : "",
     hook: source,
     source,
     timestamp: new Date().toISOString(),
@@ -328,8 +348,8 @@ export function writeSessionBoot(root, payload) {
   try {
     const stateDir = path.join(root, '.xray', 'state');
     fs.mkdirSync(stateDir, { recursive: true });
-    fs.writeFileSync(sessionBootPath(root), JSON.stringify(payload, null, 2));
     writeStationMarkdown(root, payload);
+    fs.writeFileSync(sessionBootPath(root), JSON.stringify(payload, null, 2));
     const hook = String((payload && (payload.hookEvent || payload.source)) || "");
     if (!/compact/i.test(hook)) {
       try {

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

@@ -9,6 +9,7 @@ import {
   clearPendingDelegationsForSessionChange,
   ensureSessionBoot,
   readStdinJson,
+  resolveGrokHookEvent,
   resolveSessionId,
   normalizeWorkspaceRoot,
   workspaceRoot,
@@ -25,25 +26,6 @@ import {
 import { maintainLens } from '../../hooks/goggles-pipeline.mjs';
 import { readSavedFreshness, refreshFreshness } from '../../../nucleus/work-freshness.mjs';
 
-function resolveHookEvent(event) {
-  if (process.env.GROK_HOOK_EVENT) return process.env.GROK_HOOK_EVENT;
-  const flag = process.argv.find((a) => a.startsWith('--hook-event='));
-  if (flag) return flag.slice('--hook-event='.length);
-  const named = event.hookEventName || event.hook;
-  if (named === 'PreCompact' || named === 'pre_compact') return 'pre_compact';
-  if (named === 'PostCompact' || named === 'post_compact') return 'post_compact';
-  if (
-    event.prompt != null ||
-    event.userMessage != null ||
-    event.user_prompt != null ||
-    named === 'UserPromptSubmit' ||
-    named === 'user_prompt_submit'
-  ) {
-    return 'user_prompt_submit';
-  }
-  return 'session_start';
-}
-
 function extractIntent(event) {
   return event.prompt || event.userMessage || event.user_prompt || event.compactContext || null;
 }
@@ -117,7 +99,7 @@ async function main() {
   let HOOK_EVENT = 'session_start';
   try {
     const event = await readStdinJson();
-    HOOK_EVENT = resolveHookEvent(event);
+    HOOK_EVENT = resolveGrokHookEvent(event);
     const eventRoot = normalizeWorkspaceRoot(event.workspaceRoot || event.cwd || root);
     const sessionId = resolveSessionId(event);
     if (HOOK_EVENT === 'user_prompt_submit' && sessionId) {

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

@@ -2,8 +2,8 @@
  * Goggles MCP. Stdio. Server name `goggles`.
  * Tools: look, status_lens. Same organ as the CLI.
  */
-import { existsSync, readFileSync, realpathSync } from 'node:fs';
-import { basename, join, resolve } from 'node:path';
+import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
 import { pathToFileURL, fileURLToPath } from 'node:url';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -162,6 +162,29 @@ function publicCard(view) {
     if (view.exam) notes.push(view.exam);
   }
   const skills = view.skills ? basename(String(view.skills)) : '';
+  const cascade = view.cascade
+    ? {
+      plane: view.cascade.plane,
+      station: view.cascade.station,
+      notesPage: view.cascade.notesPage,
+      index: view.cascade.index,
+      laws: Array.isArray(view.cascade.laws) ? view.cascade.laws : [],
+      notes: Array.isArray(view.cascade.notes) ? view.cascade.notes : [],
+    }
+    : null;
+  const sleeve = view.sleeve
+    ? {
+      on: Boolean(view.sleeve.on),
+      missing: Array.isArray(view.sleeve.missing) ? view.sleeve.missing : [],
+      stitches: Array.isArray(view.sleeve.stitches)
+        ? view.sleeve.stitches.map((row) => ({
+          name: String(row && row.name || ''),
+          on: Boolean(row && row.on),
+          at: Array.isArray(row && row.at) ? row.at.map((item) => String(item)) : [],
+        }))
+        : [],
+    }
+    : null;
   if (view.narrow) {
     return {
       plane: view.plane,
@@ -169,6 +192,8 @@ function publicCard(view) {
       digest: view.digest || '',
       files: Array.isArray(view.files) ? view.files : [],
       notes,
+      ...(cascade ? { cascade } : {}),
+      ...(sleeve ? { sleeve } : {}),
     };
   }
   return {
@@ -185,6 +210,8 @@ function publicCard(view) {
     teardown: view.teardown || '',
     worn: view.worn || '',
     notes,
+    ...(cascade ? { cascade } : {}),
+    ...(sleeve ? { sleeve } : {}),
   };
 }
 
@@ -205,11 +232,16 @@ export async function answerLook(raw, root) {
     return { ok: true, quiet: false, mode: 'kind0', content: line };
   }
   const argv = argvFrom(args);
-  const text = api.look(argv).text;
+  const text = api.look(argv, here).text;
   if (text === 'Name one plane.') return deny('name_one', 'Name one plane.');
-  const cards = api.lookCards(argv);
+  const cards = api.lookCards(argv, here);
   if (Array.isArray(cards) && cards.length) {
     const shown = cards.map(publicCard);
+    if (shown.length === 1 && shown[0] && typeof shown[0].plane === 'string') {
+      const dest = join(here, '.xray', 'state', 'goggles-plane.json');
+      mkdirSync(dirname(dest), { recursive: true });
+      writeFileSync(dest, `${JSON.stringify({ plane: shown[0].plane })}\n`);
+    }
     return {
       ok: true,
       quiet: false,

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

@@ -18,7 +18,7 @@ import { fileURLToPath } from 'node:url';
 const FIELD_ORDER = ['plate', 'entry', 'exit', 'files', 'skills', 'setup', 'teardown', 'worn'];
 const HERE = dirname(fileURLToPath(import.meta.url));
 const WORN_PLANES = ['dichotomy', 'syncopate', 'synthesis', 'digest', 'triage', 'loop'];
-const CARD_PLANES = ['ground', 'routing', 'house', 'boot', 'governance', 'memory-recall', 'orchestration', 'processor', 'reporting', 'stamp-plate', 'record-map', 'write-home', 'activity-log', 'session-capture', 'suit-wear', 'suit-organs', 'station-card', 'notes-page', 'reflection-page', 'site-manual', 'package-face', 'suit-settings', 'trail-state', 'inference-files', 'grok-compact', 'payload-heat', 'station-heat', 'pickup-stamp', 'cursor-compact', 'work-fresh', 'kept-line', 'lens-gate', 'pre-tool', 'lens-page'];
+const CARD_PLANES = ['ground', 'routing', 'house', 'boot', 'governance', 'memory-recall', 'orchestration', 'processor', 'reporting', 'stamp-plate', 'record-map', 'write-home', 'activity-log', 'session-capture', 'suit-wear', 'suit-organs', 'station-card', 'notes-page', 'reflection-page', 'site-manual', 'package-face', 'suit-settings', 'trail-state', 'inference-files', 'grok-compact', 'payload-heat', 'station-heat', 'pickup-stamp', 'cursor-compact', 'work-fresh', 'kept-line', 'lens-gate', 'pre-tool', 'lens-page', 'centrifuge'];
 const CARD_FLAVORS = ['digest', 'triage'];
 const SCOPE_ZOOM = ['ecosystem', 'part', 'one flow', 'one artifact'];
 
@@ -211,7 +211,7 @@ function namesTheSet(lower) {
   return planes.length === 1 && planes[0] === 'loop' && findScopes(lower).length === 0;
 }
 
-function gogglesAnswer(argv) {
+function gogglesAnswer(argv, projectRoot) {
   const words = [];
   for (const raw of argv || []) {
     const arg = String(raw || '').trim();
@@ -234,14 +234,14 @@ function gogglesAnswer(argv) {
   if (flavors.length === 1) {
     const others = acceptedPlanes().filter((name) => name !== flavors[0] && lower.includes(name));
     if (others.length) return none('');
-    const cards = collectCards(flavors[0], lower);
+    const cards = collectCards(flavors[0], lower, projectRoot);
     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) {
     if (!planes.length && cardPlanesNamed(lower).length) {
-      const cards = collectCards('digest', lower);
+      const cards = collectCards('digest', lower, projectRoot);
       if (cards && cards.length) {
         return { text: cards.map((card) => formatCardText(card)).join('\n\n'), cards };
       }
@@ -255,12 +255,12 @@ function gogglesAnswer(argv) {
   return none(file ? `${line} File: ${file}` : line);
 }
 
-export function readGoggles(argv) {
-  return ok(gogglesAnswer(argv).text);
+export function readGoggles(argv, projectRoot) {
+  return ok(gogglesAnswer(argv, projectRoot).text);
 }
 
-export function lookCards(argv) {
-  return gogglesAnswer(argv).cards;
+export function lookCards(argv, projectRoot) {
+  return gogglesAnswer(argv, projectRoot).cards;
 }
 
 function cardPlanesNamed(lower) {
@@ -271,7 +271,22 @@ function listedFiles(plane) {
   return Array.isArray(plane.files) ? plane.files.map(String) : [];
 }
 
-function cardView(plane, scope, flavor, root) {
+function cascadeApi() {
+  return createRequire(import.meta.url)('./wake-cascade.cjs');
+}
+
+function sleeveApi() {
+  return createRequire(import.meta.url)('./sleeve.cjs');
+}
+
+function appendLining(text, view) {
+  let next = text;
+  if (view.cascade) next = `${next}\n${cascadeApi().formatCascadeReading(view.cascade)}`;
+  if (view.sleeve) next = `${next}\n${sleeveApi().formatSleeveReading(view.sleeve)}`;
+  return next;
+}
+
+function cardView(plane, scope, flavor, root, cascadeRoot) {
   const listed = listedFiles(plane);
   const view = {
     plane: plane.id,
@@ -290,6 +305,20 @@ function cardView(plane, scope, flavor, root) {
     worn: plane.worn || '',
   };
   view.exam = examinePlane(plane, root).text;
+  if (cascadeApi().isCascadePlane(plane.id)) {
+    try {
+      view.cascade = cascadeApi().readWakeCascade(cascadeRoot || stateRoot());
+    } catch {
+      view.cascade = null;
+    }
+  }
+  if (sleeveApi().isSleevePlane(plane.id)) {
+    try {
+      view.sleeve = sleeveApi().readSleeve(cascadeRoot || stateRoot());
+    } catch {
+      view.sleeve = null;
+    }
+  }
   if (flavor === 'triage') {
     const filled = new Set(filledOf(plane));
     view.empty = FIELD_ORDER.filter((name) => !filled.has(name));
@@ -328,7 +357,7 @@ function formatCardText(view) {
   } else if (typeof view.exam === 'string' && view.exam.startsWith('Drift:')) {
     text = `${text}\n${view.exam}`;
   }
-  return text;
+  return appendLining(text, view);
 }
 
 export function formatCardPane(view) {
@@ -345,10 +374,11 @@ export function formatCardPane(view) {
   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');
+  const pane = [top, ...mid, bot].join('\n');
+  return appendLining(pane, view);
 }
 
-function collectCards(flavor, lower) {
+function collectCards(flavor, lower, projectRoot) {
   const named = cardPlanesNamed(lower);
   const scopes = findScopes(lower.filter((word) => word !== flavor && !named.includes(word)));
   if (scopes.length > 1) return null;
@@ -359,7 +389,7 @@ function collectCards(flavor, lower) {
   const cards = [];
   for (const id of ids) {
     const plane = growPlane(id, platesDir, stateRoot());
-    cards.push(cardView(plane, scope, flavor, root));
+    cards.push(cardView(plane, scope, flavor, root, projectRoot));
   }
   return cards;
 }
@@ -929,6 +959,15 @@ function lensPage(root, names) {
   return parts.join('\n\n');
 }
 
+
+export function holdPlane(root, id) {
+  const plane = String(id || "").trim();
+  if (!plane || plane.includes(" ")) return;
+  const dest = join(root, ".xray", "state", "goggles-plane.json");
+  mkdirSync(dirname(dest), { recursive: true });
+  writeFileSync(dest, `${JSON.stringify({ plane })}\n`);
+}
+
 function stampPlane(root, id) {
   try {
     const plates = createRequire(import.meta.url)('./plates.cjs');
@@ -953,6 +992,7 @@ export function lensBeforeResearch(root, toolName, text) {
   if (!research) return null;
   const names = CARD_PLANES.filter((name) => intentWords(spoken).includes(name));
   if (names.length === 1) {
+    holdPlane(root, names[0]);
     stampPlane(root, names[0]);
     rememberOpened(root, spoken);
     return null;
@@ -1095,8 +1135,8 @@ export function examinePlane(plane, root) {
 }
 
 
-export function look(argv) {
-  return readGoggles(argv);
+export function look(argv, projectRoot) {
+  return readGoggles(argv, projectRoot);
 }
 
 

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

@@ -8,7 +8,7 @@
       "src",
       "grok-bot/OP-PROC.md",
       "src/opencode/agents",
-      "Agents.md",
+      "AGENTS.md",
       "src/integrations",
       "package.json",
       "scripts/foundry"
@@ -68,7 +68,7 @@
     "plates": ["review"]
   },
   "record-map": {
-    "files": ["docs-site/docs/plates/record-map.md"],
+    "files": ["docs-site/docs/plates/record-map.md", "src/integrations/hooks/wake-cascade.cjs", "src/integrations/hooks/session-note-index.cjs"],
     "skills": ".agents/skills/record-map/SKILL.md",
     "plates": ["station-card", "notes-page", "reflection-page", "site-manual", "package-face", "write-home", "activity-log", "session-capture", "lens-page"]
   },
@@ -103,13 +103,13 @@
     "plates": ["activity-log", "session-capture", "inference-files", "trail-state"]
   },
   "station-card": {
-    "files": ["src/integrations/hooks/station-hook-runtime.cjs"],
+    "files": ["src/integrations/hooks/station-hook-runtime.cjs", "src/integrations/hooks/wake-cascade.cjs"],
     "mark": "formatStationMarkdown",
     "skills": ".agents/skills/station-card/SKILL.md",
     "plates": ["notes-page", "record-map", "kept-line"]
   },
   "notes-page": {
-    "files": ["src/integrations/hooks/station-hook-runtime.cjs"],
+    "files": ["src/integrations/hooks/station-hook-runtime.cjs", "src/integrations/hooks/session-note-index.cjs"],
     "mark": "stampNotesPickup",
     "skills": ".agents/skills/notes-page/SKILL.md",
     "plates": ["station-card", "record-map"]
@@ -210,6 +210,12 @@
     "mark": "export function formatCardPane",
     "skills": ".agents/skills/lens-page/SKILL.md",
     "plates": ["record-map", "lens-gate"]
+  },
+  "centrifuge": {
+    "files": ["src/integrations/hooks/station-hook-runtime.cjs"],
+    "mark": "function wakeOrder",
+    "skills": ".agents/skills/centrifuge/SKILL.md",
+    "plates": ["station-card", "goggles"]
   }
 }
 

package/dist/integrations/hooks/plates.cjs

@@ -46,6 +46,7 @@ const PLATE_IDS = Object.freeze([
   "lens-gate",
   "pre-tool",
   "lens-page",
+  "centrifuge",
 ]);
 
 /** Id token, then extra phrases. Equal top scores recall nothing. */
@@ -229,6 +230,11 @@ const CUES = {
     [/lens page/i, 6],
     [/plates\/lens-page/i, 6],
   ],
+  centrifuge: [
+    [/centrifuge plate/i, 6],
+    [/the centrifuge/i, 5],
+    [/plates\/centrifuge/i, 6],
+  ],
 };
 
 function platesDir() {
@@ -317,6 +323,21 @@ function stampPlateIfMissing(projectRoot, id) {
   return { id, path, written: true };
 }
 
+function ensureWornPlate(projectRoot, id) {
+  const path = wornPlatePath(projectRoot, id);
+  const source = readFileSync(plateSourcePath(id), "utf8");
+  if (existsSync(path)) {
+    try {
+      if (readFileSync(path, "utf8") === source) return { id, path, written: false };
+    } catch {
+      /* rewrite a plate the process cannot keep */
+    }
+  }
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, source);
+  return { id, path, written: true };
+}
+
 function organFile(intent) {
   try {
     const { suitHint } = require("./goggles-pipeline.mjs");
@@ -342,6 +363,7 @@ module.exports = {
   loadPlate,
   recallPlate,
   stampPlateIfMissing,
+  ensureWornPlate,
   plateStockLine,
   wornPlatePath,
 };