0xray 4.0.40 → 4.0.42

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

@@ -17,7 +17,6 @@
 import { frameworkLogger } from '../../core/framework-logger.js';
 import fs from 'fs';
 import path from 'path';
-import { execSync } from 'child_process';
 import { createRequire } from 'module';
 import { fileURLToPath } from 'node:url';
 import { syncBuiltinSkills } from '../../cli/commands/skill-install.js';
@@ -27,27 +26,13 @@ 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, resolveGogglesMcp } = requireCjs(path.join(packageRoot, 'scripts/node/bridge-mcp-wiring.cjs'));
-function registerGrokMcpServers(targetDir) {
-    try {
-        execSync('which grok', { stdio: 'ignore' });
-    }
-    catch {
-        console.log('[Grok] grok CLI not on PATH — plugin .mcp.json still configured');
-        return;
-    }
-    for (const s of XRAY_MCP_SERVERS) {
-        try {
-            const envEntries = { ...s.env, XRAY_ROOT: targetDir };
-            const envFlags = Object.entries(envEntries)
-                .map(([k, v]) => `--env "${k}=${v}"`)
-                .join(' ');
-            execSync(`grok mcp add ${s.name} --command npx --args "-y" "0xray" "mcp" "${s.mcpCmd}" ${envFlags}`, { stdio: 'pipe' });
-        }
-        catch {
-            // already registered or grok config conflict — non-blocking
-        }
-    }
+const { resolveRepertoireMcp, resolveGogglesMcp } = requireCjs(path.join(packageRoot, 'scripts/node/bridge-mcp-wiring.cjs'));
+function registerGrokMcpServers(targetDir, env) {
+    const wiring = requireCjs(path.join(packageRoot, 'scripts/node/bridge-mcp-wiring.cjs'));
+    const tomlPath = wiring.writeProjectSuitMcp(targetDir);
+    const trustPath = wiring.trustGrokFolder(targetDir, env);
+    process.stdout.write(`Project Grok MCP written to ${tomlPath}\n`);
+    process.stdout.write(`Grok folder trust written to ${trustPath}\n`);
 }
 export async function installForGrokCLI(options = {}) {
     frameworkLogger.log('grok-integration', 'install-start', 'info', {
@@ -115,21 +100,9 @@ export async function installForGrokCLI(options = {}) {
         writeProjectRepertoireMcp(targetDir);
         writeProjectGogglesMcp(targetDir);
         mintAfterWear(targetDir);
-        const primary = dests[0];
-        try {
-            execSync(`grok plugins trust "${primary}"`, { stdio: 'ignore' });
-            console.log('\x1b[32m✓ Auto-trusted the 0xray plugin with Grok CLI\x1b[0m');
-        }
-        catch {
-            console.log('\nPlease run this command to fully trust the plugin:');
-            console.log(`  grok plugins trust "${primary}"`);
-        }
-        if (isolated) {
-            registerGrokMcpServers(targetDir);
-            console.log('\x1b[32m✓ Registered 7 xray MCP servers with Grok CLI (npx)\x1b[0m');
-        }
-        else {
-            console.log('\x1b[32m✓ Project-scoped Grok plugin worn (machine ~/.grok/plugins/0xray not written)\x1b[0m');
+        registerGrokMcpServers(targetDir, env);
+        if (!isolated) {
+            process.stdout.write('Project-scoped Grok plugin worn (machine ~/.grok/plugins/0xray not written)\n');
         }
         console.log('\n✅ 0xRay is now installed as a first-class Grok CLI plugin!');
         console.log('Restart Grok or run `grok` to load the new hooks and MCP servers.');

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

@@ -19,7 +19,7 @@ import {
   updatePlanTodoStatusInPlace,
   loadDelegationGateFeatures,
 } from '../../hooks/delegation-gate-runtime.mjs';
-import { isConferPendingForSession } from '../../hooks/confer-hook-runtime.mjs';
+import { isConferPendingForSession, readConferReviewHint } from '../../hooks/confer-hook-runtime.mjs';
 import { getActiveUserAsideBoot } from '../../hooks/user-aside-hook-runtime.mjs';
 import {
   applyStationHeat,
@@ -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();
@@ -289,6 +308,7 @@ export function buildSessionBootPayload(root, source = '0xray/grok-session-start
   const sessionId =
     extra.sessionId || process.env.GROK_SESSION_ID || process.env.GROK_SESSION || null;
   const conferPending = loadConferPending(root, sessionId);
+  const conferReview = readConferReviewHint(root);
   const userAsideBoot = getActiveUserAsideBoot(root, sessionId);
   const gateFeatures = loadDelegationGateFeatures(root, 'grok');
   const frontier = gateFeatures.ceremony === 'lite';
@@ -313,11 +333,18 @@ export function buildSessionBootPayload(root, source = '0xray/grok-session-start
     ...heat,
     ...(siblingRoots.length > 0 ? { siblingWorkspaceRoots: siblingRoots } : {}),
     ...(conferPending ? { conferPending: true, conferTrigger: 'analyze-complexity at synthesis checkpoint' } : {}),
+    ...(conferReview
+      ? {
+          conferReview,
+          conferReviewHint: 'UNREVIEWED — abstain without a governance LLM blocks the consult todo',
+        }
+      : {}),
     ...(userAsideBoot ?? {}),
     sessionId,
     ...extra,
     ...heat,
     ...compactHold,
+    arrivedHook: extra && extra.hookEvent ? String(extra.hookEvent) : "",
     hook: source,
     source,
     timestamp: new Date().toISOString(),
@@ -328,8 +355,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/confer-hook-runtime.mjs

@@ -3,7 +3,7 @@
  * Lazy-load confer SSOT for Grok session-boot hints.
  */
 import { createRequire } from 'node:module';
-import { existsSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -46,4 +46,26 @@ export function isConferPendingForSession(projectRoot, sessionId = null) {
   const mod = loadConfer();
   if (!mod?.isConferPending) return false;
   return mod.isConferPending(projectRoot, sessionId);
+}
+
+/** 'UNREVIEWED' when a consult receipt recorded abstain-without-model. */
+export function readConferReviewHint(projectRoot) {
+  const stateDir = join(projectRoot, '.xray', 'state');
+  if (!existsSync(stateDir)) return null;
+  let names;
+  try {
+    names = readdirSync(stateDir);
+  } catch {
+    return null;
+  }
+  for (const name of names) {
+    if (!name.startsWith('synthesis-consult-') || !name.endsWith('.json')) continue;
+    try {
+      const receipt = JSON.parse(readFileSync(join(stateDir, name), 'utf8'));
+      if (receipt && receipt.verdict === 'UNREVIEWED') return 'UNREVIEWED';
+    } catch {
+      /* unreadable receipt is not a hint */
+    }
+  }
+  return null;
 }

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

@@ -38,7 +38,10 @@
     "plates": ["suit-wear"]
   },
   "governance": {
-    "files": ["src/governance/governance-service.ts"],
+    "files": [
+      "src/governance/governance-service.ts",
+      "src/governance/llm-governance-provider.ts"
+    ],
     "skills": ".agents/skills/governance/SKILL.md"
   },
   "memory-recall": {
@@ -68,7 +71,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 +106,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 +213,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,
 };