0xray 4.0.40 → 4.0.41

package/dist/integrations/hooks/wake-cascade.cjs

@@ -0,0 +1,102 @@
+/**
+ * One wake hands the lens, the ticket, the laws, and the current notes.
+ * Goggles names plane record-map.
+ * The station module writes STATION.md and NOTES.md.
+ * Repertoire keeps the law list.
+ * The current session-note index sits beside that list.
+ * The card carries the count. A memory look carries the current lines.
+ */
+const { existsSync, readFileSync } = require("fs");
+const { join } = require("path");
+const { shortSessionIndex } = require("./session-note-index.cjs");
+
+const CASCADE_PLANE = "record-map";
+const MEMORY_PLANES = ["record-map", "station-card", "notes-page", "memory-recall"];
+
+function isCascadePlane(id) {
+  return MEMORY_PLANES.includes(String(id || ""));
+}
+
+function clipNames(names) {
+  if (!Array.isArray(names)) return [];
+  const out = [];
+  for (const raw of names) {
+    const name = String(raw || "").trim();
+    if (!name || out.includes(name)) continue;
+    out.push(name);
+    if (out.length >= 8) break;
+  }
+  return out;
+}
+
+function lawNamesFromWorking(root) {
+  const file = join(root, ".xray", "state", "repertoire-working.json");
+  if (!existsSync(file)) return [];
+  try {
+    const data = JSON.parse(readFileSync(file, "utf8"));
+    return clipNames(data && data.matchedSignals);
+  } catch {
+    return [];
+  }
+}
+
+function currentNotes(root) {
+  try {
+    return shortSessionIndex(root).map((note) => {
+      const row = { id: note.id, text: note.text };
+      if (note.slot) row.slot = note.slot;
+      return row;
+    });
+  } catch {
+    return [];
+  }
+}
+
+/** Laws come from this wake when passed. Otherwise the working file. Notes are current lines only. */
+function readWakeCascade(root, opts = {}) {
+  const laws = Array.isArray(opts.laws) ? clipNames(opts.laws) : lawNamesFromWorking(root);
+  return {
+    plane: CASCADE_PLANE,
+    station: ".xray/state/STATION.md",
+    notesPage: ".xray/state/NOTES.md",
+    index: ".xray/state/repertoire/session-notes.json",
+    laws,
+    notes: currentNotes(root),
+  };
+}
+
+function formatCascadePointer(cascade) {
+  const count = cascade && Array.isArray(cascade.notes) ? cascade.notes.length : 0;
+  const plane = cascade && cascade.plane ? cascade.plane : CASCADE_PLANE;
+  return `Cascade: ${plane} · notes ${count} current`;
+}
+
+function formatCascadeReading(cascade) {
+  const plane = cascade && cascade.plane ? cascade.plane : CASCADE_PLANE;
+  const laws = cascade && Array.isArray(cascade.laws) && cascade.laws.length
+    ? cascade.laws.join(", ")
+    : "(none yet)";
+  const notes = cascade && Array.isArray(cascade.notes) ? cascade.notes : [];
+  const lines = [
+    `Cascade: ${plane}`,
+    `Station: ${cascade && cascade.station ? cascade.station : ".xray/state/STATION.md"}`,
+    `Notes page: ${cascade && cascade.notesPage ? cascade.notesPage : ".xray/state/NOTES.md"}`,
+    `Index: ${cascade && cascade.index ? cascade.index : ".xray/state/repertoire/session-notes.json"}`,
+    `Laws: ${laws}`,
+    `Notes: ${notes.length} current`,
+  ];
+  for (const note of notes) {
+    const slot = note.slot ? `${note.slot} ` : "";
+    lines.push(`- ${note.id} ${slot}${note.text}`);
+  }
+  return lines.join("\n");
+}
+
+module.exports = {
+  CASCADE_PLANE,
+  MEMORY_PLANES,
+  isCascadePlane,
+  readWakeCascade,
+  formatCascadePointer,
+  formatCascadeReading,
+};

package/dist/integrations/hooks/wake-cascade.mjs

@@ -0,0 +1,16 @@
+/**
+ * ESM face for wake-cascade.cjs.
+ */
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const require = createRequire(import.meta.url);
+const impl = require(join(dirname(fileURLToPath(import.meta.url)), "wake-cascade.cjs"));
+
+export const CASCADE_PLANE = impl.CASCADE_PLANE;
+export const MEMORY_PLANES = impl.MEMORY_PLANES;
+export const isCascadePlane = impl.isCascadePlane;
+export const readWakeCascade = impl.readWakeCascade;
+export const formatCascadePointer = impl.formatCascadePointer;
+export const formatCascadeReading = impl.formatCascadeReading;

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

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

package/dist/memory-routing/plates.d.ts

@@ -1,4 +1,4 @@
-export declare const PLATE_IDS: readonly ["routing", "governance", "boot", "orchestration", "processor", "reporting", "memory-recall", "stamp-plate", "house", "review", "goggles", "suit", "kits", "host-pack", "glossary", "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"];
+export declare const PLATE_IDS: readonly ["routing", "governance", "boot", "orchestration", "processor", "reporting", "memory-recall", "stamp-plate", "house", "review", "goggles", "suit", "kits", "host-pack", "glossary", "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"];
 export type PlateId = (typeof PLATE_IDS)[number];
 export interface PlateStamp {
     id: PlateId;

package/dist/memory-routing/plates.js

@@ -45,6 +45,7 @@ export const PLATE_IDS = [
     'lens-gate',
     'pre-tool',
     'lens-page',
+    'centrifuge',
 ];
 function isPlateId(value) {
     return PLATE_IDS.includes(value);

package/docs-site/docs/plates/activity-log.md

@@ -35,4 +35,4 @@ Today those writers append `logs/framework/activity.log`. The features default s
 
 When: on the tool hook, on framework logger flush, and on boot when file logging is on. Why: the report and the pulse read one tail, not a pile of copies.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/boot.md

@@ -65,3 +65,5 @@ sidebar_label: Boot
 │   └────────────────────────────────────────────────────┘ │
 └────────────────────────────────────────────────────────────┘
 ```
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/centrifuge.md

@@ -0,0 +1,30 @@
+---
+title: Centrifuge
+sidebar_label: Centrifuge
+plate_type: domain model
+---
+
+# Centrifuge
+
+One wake is one turn. Station is the axle. The gap stays open.
+
+```
+                         CENTRIFUGE
+                    ┌──── VISOR ────┐
+                    │    GOGGLES    │
+                    └───────┬───────┘
+                            │ looks down
+         ┌──────────────────┴──────────────────┐
+         │               DOMAIN                │
+         │                                     │
+JUDGEMENT│   LOOP                   STATE      │PAYMENTS
+ · off   │            STATION                  │ · off
+ · fixed │                          FOUNDRY    │ · fixed
+         │               MEMORY                │
+         └────────────── ONE TURN ─────────────┘
+                    the gap stays open
+```
+
+Loop, domain, state, foundry, and memory ride that turn. Judgement and payments stay off the rotor. Goggles looks on and does not spin. The next turn waits for the next session or compact.
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/cursor-compact.md

@@ -32,4 +32,4 @@ Cursor preCompact writes the station card and cannot block the compact.
 
 The file is `src/integrations/cursor/hooks/pre-compact.js`. The message tells the seat to read STATION.md. The plates that belong here are payload-heat and station-heat.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/glossary.md

@@ -23,5 +23,4 @@ What the words mean.
   │ grok-bot · the package you install                         │
   └────────────────────────────────────────────────────────────┘
 ```
-
-
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/goggles.md

@@ -16,3 +16,7 @@ It views one plane.
   │ · not every plane at once                                  │
   └────────────────────────────────────────────────────────────┘
 ```
+
+A checkout named `0xray` records `scripts/mjs/run-goggles-mcp.mjs`. Any other project records `node_modules/0xray/scripts/mjs/run-goggles-mcp.mjs`.
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/governance.md

@@ -49,3 +49,5 @@ A proposal is deliberated inside the suit, filtered by Dynamo Solar, then merged
 │   └──────────────────────┘      └──────────────────────┘ │
 └────────────────────────────────────────────────────────────┘
 ```
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/grok-compact.md

@@ -32,4 +32,4 @@ Grok PreCompact runs session-start.js with the pre_compact event.
 
 The hook is `session-start.js --hook-event=pre_compact`. It calls `buildSessionBootPayload`, writes the station card, and prints nothing. It does not match the conversation. Grok ignores hook stdout. The plates that belong here are payload-heat, cursor-compact, and work-fresh.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/grokbot.md

@@ -38,4 +38,4 @@ Give your bots a house: shared rules, one board for the work, and memory that st
   code links: suit → memory, house → doctor, memory → station. Other lines show reading order only.
 ```
 
-stamped · 0xray 4.0.40 · @0xray/grok-bot 0.1.8
+stamped · 0xray 4.0.41 · @0xray/grok-bot 0.1.8

package/docs-site/docs/plates/host-pack.md

@@ -30,3 +30,5 @@ Run it in the tool you already open. Same suit. No new app.
 ```
 
 These six already run.
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/house.md

@@ -50,4 +50,4 @@ A state flow plate: the stages a house goes through before doctor says House: PA
   └──────────────────────────────┘
 ```
 
-stamped · 0xray 4.0.40 · @0xray/grok-bot 0.1.8
+stamped · 0xray 4.0.41 · @0xray/grok-bot 0.1.8

package/docs-site/docs/plates/index.md

@@ -17,7 +17,7 @@ Plates have a type. A domain model plate shows how named parts fit. A state flow
 
 ## Domain model
 
-[Goggles](./goggles.md) · [Suit](./suit.md) · [Kits](./kits.md) · [Host Pack](./host-pack.md) · [Glossary](./glossary.md) · [Grok Bot](./grokbot.md)
+[Goggles](./goggles.md) · [Suit](./suit.md) · [Kits](./kits.md) · [Host Pack](./host-pack.md) · [Glossary](./glossary.md) · [Grok Bot](./grokbot.md) · [Centrifuge](./centrifuge.md)
 
 ## State flow
 
@@ -50,3 +50,5 @@ These eight are the pages the file ref names. Each one is a search lens. Each le
 [Work fresh](./work-fresh.md) · [Kept line](./kept-line.md) · [Lens gate](./lens-gate.md) · [Pre tool](./pre-tool.md) · [Lens page](./lens-page.md)
 
 These five are the compact path that was opened. Each one is a search lens. Each lens lists one skill and the plates that belong with it.
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/inference-files.md

@@ -32,4 +32,4 @@ Inference cycle state already lives under .xray/inference.
 
 Cycle state, history, graded ids, and governance state are already there. Session files still fall back to `docs/inference` until the writers move.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/kept-line.md

@@ -32,4 +32,4 @@ A station rewrite keeps one Fresh line and drops the copies.
 
 mergeStationMarkdown in src/integrations/hooks/station-hook-runtime.cjs treats a Fresh line as stock. Copies are not preserved. When the new card has no Fresh line, the latest one is kept. The plates that belong here are station-card and work-fresh.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/kits.md

@@ -26,3 +26,5 @@ Add a power. Memory, judgment, or payments.
 ```
 
 Three. That's the set.
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/lens-gate.md

@@ -32,4 +32,4 @@ A search names one plane or it stops.
 
 lensBeforeResearch in src/integrations/hooks/goggles-pipeline.mjs returns null when the call is not research, and when the spoken text names exactly one card plane. Zero names, or more than one, deny with Name one plane. A shell that reads a project source file is research. The first open of a source file that no lens lists is allowed and remembered. The next search stops until that file is on a lens and the plate is on disk. The hook does not author the plate. The plate that belongs here is pre-tool.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/lens-page.md

@@ -32,4 +32,4 @@ The lens page is the card for one plane.
 
 `formatCardPane` in `src/integrations/hooks/goggles-pipeline.mjs` draws the card. Read the card instead of searching the tree. The plates that belong here are record-map and lens-gate.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/live-mesh.md

@@ -38,4 +38,4 @@ Ping-pong eng events become one ordered JSON feed, then a mesh render. Markdown
 
 Paths live under `house/live-mesh/`. Schema is `schema.json`. The plate that belongs here is house.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/memory-recall.md

@@ -38,3 +38,7 @@ Intent names one plate. Equal top scores recall nothing. A missing worn copy is
 │   └────────────────────┘        └────────────────────────┘ │
 └──────────────────────────────────────────────────────────────┘
 ```
+
+A look returns the named plane, the matched law names, and the current lines from the session-note index. It does not write a law.
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/notes-page.md

@@ -32,4 +32,5 @@ Notes are the body the station card cannot hold.
 
 The page is `.xray/state/NOTES.md`. The pickup line equals the station intent. The default depth is the working notes: the point, the coverage, the library, the open pull requests, the rituals, and the next cut. A pickup line alone does not survive a compact. PreCompact calls `stampNotesPickup`, which updates only that line and leaves the body alone. The hook does not check the body. The seat writes it before the compact. Do not commit this file. Do not feed it to Repertoire.
 
-stamped · 0xray 4.0.40
+The station module writes this page. Heat keeps the current lines in `.xray/state/repertoire/session-notes.json` beside the laws. The wake cascade reads that index and does not write a law. A replaced note stays in that index as history. The short index returns the current line.
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/orchestration.md

@@ -57,3 +57,5 @@ Each tool is its own call. `spawnAside` opens around `orchestrate-task`, `analyz
 │   └─────────────────────┘    └─────────────────────────┘ │
 └────────────────────────────────────────────────────────────┘
 ```
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/package-face.md

@@ -32,4 +32,4 @@ A release writes the package face, and the agent reads it.
 
 The face is `README.md`, `package.json`, `AGENTS.md`, `llms.txt`, `CHANGELOG.md`, and `SKILLS.md`. Do not hand-bump the version.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/payload-heat.md

@@ -32,4 +32,4 @@ buildSessionBootPayload calls applyStationHeat and writes the station card.
 
 The function is in `src/integrations/grok/hooks/grok-hook-utils.js`. The plates that belong here are station-heat and pickup-stamp.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/pickup-stamp.md

@@ -32,4 +32,4 @@ stampNotesPickup writes one pickup line and leaves the rest of NOTES.md alone.
 
 The comment on the function is one pickup line. There is no check that the working notes are present. The plate that belongs here is notes-page.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/pre-tool.md

@@ -32,4 +32,4 @@ The tool hook is where the lens gate runs.
 
 pre-tool-use.js joins the command, the written content, and the paths, then calls lensBeforeResearch. A deny ends the hook. The plate that belongs here is lens-gate.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/processor.md

@@ -42,3 +42,5 @@ sidebar_label: Processor
 │   └──────────────────────────┘   └───────────────────────┘ │
 └──────────────────────────────────────────────────────────────┘
 ```
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/record-map.md

@@ -38,4 +38,5 @@ Trail: state and logs under `.xray`. Codex is already loaded. This plate is the
 
 The published manual is `docs-site/docs/`. The rule sheet is `grok-bot/OP-PROC.md`. Neither is one of the five pages.
 
-stamped · 0xray 4.0.40
+Goggles plane `record-map` is the lens over this map. Station and the notes page belong to the station module. Repertoire laws stay in the law file. The session-note index sits beside that file.
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/reflection-page.md

@@ -32,4 +32,4 @@ A reflection is one episode written under docs/reflections.
 
 The loader is `loadReflectionInferences` in `src/inference/inference-accumulator.ts`. A reflection is not a repertoire law.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/reporting.md

@@ -35,3 +35,5 @@ Logs become a report. A valid cache returns the formatted report and does not wr
 │   └──────────────────────────┘   └─────────────────────┘ │
 └────────────────────────────────────────────────────────────┘
 ```
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/review.md

@@ -54,4 +54,4 @@ A state flow plate: one critic pass, one fix, one re-review, then stop.
 
 A FAIL names the file and a test that fails on the old code. One author fixes that hole. A second session waits while the verdict is open. Re-review that new head. A hole the new test did not lock returns to ONE FIX. A PASS ends the plate. A note stays a note and does not open another lap.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/routing.md

@@ -58,3 +58,5 @@ Task text becomes an agent. `scoreAndRoute` scores the work, then `routeToAgent`
 │   └────────────┘                                            │
 └──────────────────────────────────────────────────────────────┘
 ```
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/session-capture.md

@@ -35,4 +35,4 @@ Today that file is `docs/inference/latest-session.json`. The home is `.xray/infe
 
 Station reads the file for heat. The inference accumulator reads `session-*.json` beside it. Do not mint a `session-<date>-<sha>` file for the station note.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/site-manual.md

@@ -32,4 +32,4 @@ The published manual is docs-site/docs.
 
 Guides, architecture, and introduction live here. Factory notes under `docs/` are a different set. Reflections stay in `docs/reflections/`.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/stamp-plate.md

@@ -32,4 +32,4 @@ A stamped plate is one drawing for one plane.
 
 The file is `docs-site/docs/plates/<id>.md`. Each opened segue gets its own plate. The hook does not author this file. The plate that belongs here is review.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/station-card.md

@@ -32,4 +32,7 @@ The station card is the one-line ticket at .xray/state/STATION.md.
 
 Read it after a compact. Leave Intent alone. The plan is the next cut. The long body belongs in notes.
 
-stamped · 0xray 4.0.40
+The station module writes this card. Heat adds `Cascade: record-map · notes N current`. The count is the current index. The body stays on the notes page.
+
+The card keeps the named plane. `Sleeve: on` means the previous ticket came back, the worn plate matched the package, the previous ticket matched the working record, and inspect passed. 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.
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/station-heat.md

@@ -32,4 +32,4 @@ On a compact event applyStationHeat stamps the notes pickup line.
 
 `isCompactHook` is true when the hook name contains compact. The body of NOTES.md is left alone. The plates that belong here are pickup-stamp and notes-page.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/suit-organs.md

@@ -35,4 +35,4 @@ Reporting reads the activity log and may write a report. Station reads `latest-s
 
 Repertoire already keeps `inference-state.json` and the day log under `.xray/state/repertoire/`. Goggles does not write these files. It reads a plate when one plane is named.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/suit-settings.md

@@ -32,4 +32,4 @@ Suit settings are features, config, and codex.
 
 There is no settings.json. The files are `.xray/features.json`, `.xray/config.json`, and `.xray/codex.json`. The package copies live under `xray/`.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/suit-wear.md

@@ -34,4 +34,6 @@ Wear copies hooks, features.json, and the consumer gitignore into the project, a
 
 A worn project is a consumer. Its writes go to its own `.xray/logs` and `.xray/inference`, not into `docs/` and not into `.opencode/logs`.
 
-stamped · 0xray 4.0.40
+A fresh wear fastens mill and inspect. Grok's Goggles launcher stays on that install: the checkout script when the package name is `0xray`, and `node_modules/0xray` for every other project.
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/suit.md

@@ -38,3 +38,5 @@ Give your agent a suit. The rules stay on, you add powers, and it runs in the to
 ```
 
 Same rules in the repo. You are not locked into one app.
+
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/trail-state.md

@@ -32,4 +32,4 @@ The suit writes its trail under .xray.
 
 Session boot, the lens match line, and the station card are state. The agent reads them. Do not commit `.xray/state`.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/work-fresh.md

@@ -32,4 +32,4 @@ Refresh writes one Fresh line from git and the published package.
 
 refreshFreshness in src/nucleus/work-freshness.mjs fetches origin, reads npm view 0xray version, and returns that one line. A compact hook does not call it. The plate that belongs here is station-card.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/docs-site/docs/plates/write-home.md

@@ -35,4 +35,4 @@ The path table is `src/integrations/hooks/write-home.cjs`. Writers use it. Reade
 
 Still on the old path until each caller is rewired: the activity logger, the framework logger, the pipeline hook, the Grok hook, the Hermes bridge, station capture, `saveSessionInference`, reporting, pulse, monitor, and `features.json` `log_path`.
 
-stamped · 0xray 4.0.40
+stamped · 0xray 4.0.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "0xray",
-  "version": "4.0.40",
+  "version": "4.0.41",
   "description": "Multi-agent orchestration and Codex governance for OpenCode, Hermes, Grok Build, and OpenClaw",
   "readme": "README.md",
   "license": "MIT",

package/scripts/node/bridge-mcp-wiring.cjs

@@ -139,11 +139,32 @@ function enableMemoryRoutingIfResolves(features, targetDir) {
   };
 }
 
+function isDogfoodXrayPackage(targetDir) {
+  try {
+    const pkgPath = path.join(targetDir, "package.json");
+    if (!fs.existsSync(pkgPath)) return false;
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    return pkg && pkg.name === "0xray";
+  } catch {
+    return false;
+  }
+}
+
 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"),
-  ];
+  const installed = path.join(
+    targetDir,
+    "node_modules",
+    "0xray",
+    "scripts",
+    "mjs",
+    "run-goggles-mcp.mjs",
+  );
+  const checkout = path.join(targetDir, "scripts", "mjs", "run-goggles-mcp.mjs");
+  // The factory package is not installed into its own node_modules. npm upgrade
+  // removes that folder, and a recorded node_modules path then fails the handshake.
+  const candidates = isDogfoodXrayPackage(targetDir)
+    ? [checkout, installed]
+    : [installed, checkout];
   return candidates.find((file) => fs.existsSync(file)) || null;
 }
 
@@ -315,7 +336,18 @@ function pinnedMcpLaunch(targetDir, mcpCmd) {
  */
 const LIVE_ENV_NAMES = ["PATH", "HOME"];
 
+let launcherPackageRoot = "";
+
+/** Wear sets this so a /tmp checkout is not the path written into a real project. */
+function pinLauncherPackageRoot(packageRoot) {
+  launcherPackageRoot = packageRoot ? path.resolve(packageRoot) : "";
+}
+
 function mcpLauncherPath() {
+  if (launcherPackageRoot) {
+    const candidate = path.join(launcherPackageRoot, "scripts", "node", "mcp-launch.cjs");
+    if (fs.existsSync(candidate)) return candidate;
+  }
   return path.join(__dirname, "mcp-launch.cjs");
 }
 
@@ -988,6 +1020,7 @@ module.exports = {
   enableMemoryRoutingIfResolves,
   isEphemeralInstallRoot,
   isIsolatedHome,
+  pinLauncherPackageRoot,
   copyHermesHookRuntimes,
   resolveOpenClawPreToolHookSource,
   resolveOpenClawPluginDir,