0xray 4.0.39 → 4.0.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/.grok-plugin/plugin.json +1 -1
  2. package/.xray/features.json +1 -1
  3. package/dist/CHANGELOG.md +29 -0
  4. package/dist/integrations/grok/hooks/grok-hook-utils.js +21 -1
  5. package/dist/integrations/grok/hooks/session-start.js +2 -20
  6. package/dist/integrations/hooks/goggles-mcp.mjs +36 -4
  7. package/dist/integrations/hooks/goggles-pipeline.mjs +55 -15
  8. package/dist/integrations/hooks/goggles-planes.json +10 -4
  9. package/dist/integrations/hooks/plates.cjs +22 -0
  10. package/dist/integrations/hooks/session-note-index.cjs +298 -0
  11. package/dist/integrations/hooks/session-note-index.mjs +22 -0
  12. package/dist/integrations/hooks/sleeve.cjs +335 -0
  13. package/dist/integrations/hooks/sleeve.mjs +18 -0
  14. package/dist/integrations/hooks/station-hook-runtime.cjs +205 -9
  15. package/dist/integrations/hooks/wake-cascade.cjs +102 -0
  16. package/dist/integrations/hooks/wake-cascade.mjs +16 -0
  17. package/dist/integrations/openclaw/plugin/xray-pre-tool/package.json +1 -1
  18. package/dist/memory-routing/plates.d.ts +1 -1
  19. package/dist/memory-routing/plates.js +1 -0
  20. package/docs-site/docs/plates/activity-log.md +1 -1
  21. package/docs-site/docs/plates/boot.md +2 -0
  22. package/docs-site/docs/plates/centrifuge.md +30 -0
  23. package/docs-site/docs/plates/cursor-compact.md +1 -1
  24. package/docs-site/docs/plates/glossary.md +1 -2
  25. package/docs-site/docs/plates/goggles.md +4 -0
  26. package/docs-site/docs/plates/governance.md +2 -0
  27. package/docs-site/docs/plates/grok-compact.md +1 -1
  28. package/docs-site/docs/plates/grokbot.md +1 -1
  29. package/docs-site/docs/plates/host-pack.md +2 -0
  30. package/docs-site/docs/plates/house.md +1 -1
  31. package/docs-site/docs/plates/index.md +4 -2
  32. package/docs-site/docs/plates/inference-files.md +1 -1
  33. package/docs-site/docs/plates/kept-line.md +1 -1
  34. package/docs-site/docs/plates/kits.md +2 -0
  35. package/docs-site/docs/plates/lens-gate.md +1 -1
  36. package/docs-site/docs/plates/lens-page.md +1 -1
  37. package/docs-site/docs/plates/live-mesh.md +41 -0
  38. package/docs-site/docs/plates/memory-recall.md +4 -0
  39. package/docs-site/docs/plates/notes-page.md +2 -1
  40. package/docs-site/docs/plates/orchestration.md +2 -0
  41. package/docs-site/docs/plates/package-face.md +1 -1
  42. package/docs-site/docs/plates/payload-heat.md +1 -1
  43. package/docs-site/docs/plates/pickup-stamp.md +1 -1
  44. package/docs-site/docs/plates/pre-tool.md +1 -1
  45. package/docs-site/docs/plates/processor.md +2 -0
  46. package/docs-site/docs/plates/record-map.md +2 -1
  47. package/docs-site/docs/plates/reflection-page.md +1 -1
  48. package/docs-site/docs/plates/reporting.md +2 -0
  49. package/docs-site/docs/plates/review.md +1 -1
  50. package/docs-site/docs/plates/routing.md +2 -0
  51. package/docs-site/docs/plates/session-capture.md +1 -1
  52. package/docs-site/docs/plates/site-manual.md +1 -1
  53. package/docs-site/docs/plates/stamp-plate.md +1 -1
  54. package/docs-site/docs/plates/station-card.md +4 -1
  55. package/docs-site/docs/plates/station-heat.md +1 -1
  56. package/docs-site/docs/plates/suit-organs.md +1 -1
  57. package/docs-site/docs/plates/suit-settings.md +1 -1
  58. package/docs-site/docs/plates/suit-wear.md +3 -1
  59. package/docs-site/docs/plates/suit.md +2 -0
  60. package/docs-site/docs/plates/trail-state.md +1 -1
  61. package/docs-site/docs/plates/work-fresh.md +1 -1
  62. package/docs-site/docs/plates/write-home.md +1 -1
  63. package/package.json +2 -1
  64. package/scripts/node/bridge-mcp-wiring.cjs +37 -4
  65. package/scripts/node/install-bridges.cjs +172 -19
  66. package/scripts/node/playwright-smoke-server.cjs +27 -0
  67. package/scripts/node/setup.cjs +2 -46
  68. package/src/integrations/openclaw/plugin/xray-pre-tool/package.json +1 -1
  69. package/vendor/@0xray/repertoire/dist/orchestrator-bridge/RepertoireOrchestratorBridge.js +4 -1
  70. package/vendor/@0xray/repertoire/dist/paths.js +3 -0
  71. package/xray/features.json +1 -1
@@ -20,7 +20,10 @@ const {
20
20
  const { join, resolve } = require("path");
21
21
 
22
22
  const HOOKS_DIR = __dirname;
23
- const { plateStockLine, recallPlate, stampPlateIfMissing } = require("./plates.cjs");
23
+ const { ensureWornPlate, plateStockLine, recallPlate } = require("./plates.cjs");
24
+ const { rememberSessionNote, retainProjectNotes } = require("./session-note-index.cjs");
25
+ const { formatCascadePointer, readWakeCascade } = require("./wake-cascade.cjs");
26
+ const { formatSleevePointer, readSleeve, runFoundryMill } = require("./sleeve.cjs");
24
27
 
25
28
  const INTENT_MAX = 240;
26
29
 
@@ -111,6 +114,12 @@ function isStockTicket(value) {
111
114
  return !text || text === "(none)" || text === "(none yet)";
112
115
  }
113
116
 
117
+ function readStationHostToken(root) {
118
+ const md = readExistingStationMarkdown(root);
119
+ const match = md.match(/^Host:\s*(\S+)/m);
120
+ return match ? match[1] : "";
121
+ }
122
+
114
123
  function readStationTicketField(root, field) {
115
124
  const md = readExistingStationMarkdown(root);
116
125
  const re = field === "Plan" ? /^Plan:\s*(.*)$/im : /^Intent:\s*(.*)$/im;
@@ -136,9 +145,20 @@ function resolveHeatIntent(root, extra, existing) {
136
145
  const pickup = clipIntent(readNotesPickup(root));
137
146
  const bootIntent = typeof existing.intent === "string" ? clipIntent(existing.intent) : null;
138
147
  const cardIsBootEcho = Boolean(card && bootIntent && card === bootIntent);
139
- const hook = String(extra.hookEvent || extra.source || "");
140
- const keepsTicket = /user_prompt|compact/i.test(hook);
141
- const compact = /compact/i.test(hook);
148
+ const named = String(extra.hookEvent || "");
149
+ const channel = String(extra.hookEvent || extra.source || "");
150
+ const keepsTicket = /user_prompt|compact/i.test(channel);
151
+ const compact = /compact/i.test(channel);
152
+ let receipt = null;
153
+ try {
154
+ receipt = readSleeve(root);
155
+ } catch {
156
+ receipt = null;
157
+ }
158
+ // A proved receipt keeps the ticket. A new session must not restate it.
159
+ if (receipt && receipt.on && card && /^(session_start|session-start)$/i.test(named)) {
160
+ return { intent: card, rematch: false, kept: true };
161
+ }
142
162
  // A chat sentence or a compact summary does not replace a ticket already on disk.
143
163
  if (incoming && !(keepsTicket && (card || pickup))) {
144
164
  return { intent: incoming, rematch: true };
@@ -520,6 +540,7 @@ function stampNotesPickup(root, line) {
520
540
  : body
521
541
  ? `${marker}\n\n${body.replace(/^\n+/, "")}`
522
542
  : `${marker}\n`;
543
+ rememberSessionNote(root, text, { source: "NOTES.md", slot: "pickup" });
523
544
  if (next === body) return text;
524
545
  mkdirSync(join(root, ".xray", "state"), { recursive: true });
525
546
  writeFileSync(dest, next.endsWith("\n") ? next : `${next}\n`);
@@ -973,6 +994,7 @@ function buildRepertoireResume(root) {
973
994
  }
974
995
 
975
996
  function applyStationHeat(root, host, extra = {}, existing = {}) {
997
+ retainProjectNotes(root);
976
998
  const mr = readMemoryRoutingConfig(root);
977
999
  const memoryOff = isExplicitMemoryRoutingOptOut(mr);
978
1000
  const promptHook = isPromptHook(extra);
@@ -1005,6 +1027,8 @@ function applyStationHeat(root, host, extra = {}, existing = {}) {
1005
1027
  ? existing.hotSwap
1006
1028
  : null;
1007
1029
  const hotSwap = nextSwap || keptSwap;
1030
+ const priorIntent = readStationTicketField(root, "Intent");
1031
+ const priorHost = readStationHostToken(root);
1008
1032
  const resolved = resolveHeatIntent(root, extra, existing);
1009
1033
  const intent = resolved.intent;
1010
1034
  const rematch = resolved.rematch;
@@ -1018,7 +1042,10 @@ function applyStationHeat(root, host, extra = {}, existing = {}) {
1018
1042
  }
1019
1043
  const matchText = clipIntent([intent, pickup, approaches].filter(Boolean).join(" "));
1020
1044
  const git = readGitBrief(root);
1021
- const planLine = resolveHeatPlan(root, extra, existing);
1045
+ let planLine = resolveHeatPlan(root, extra, existing);
1046
+ if (priorIntent && intent && intent !== priorIntent && !(extra.plan || extra.planLine)) {
1047
+ planLine = null;
1048
+ }
1022
1049
  // A passed string is the previous card. Count the project file after this wake.
1023
1050
  const repertoireResume = buildRepertoireResume(root);
1024
1051
  const swapBit = hotSwap ? `hot-swap ${hotSwap.from} → ${hotSwap.to}` : `host ${host}`;
@@ -1056,11 +1083,20 @@ function applyStationHeat(root, host, extra = {}, existing = {}) {
1056
1083
  if (!matchedSignals.length && priorWorking) {
1057
1084
  matchedSignals = stationSafeSignals(priorWorking.matchedSignals);
1058
1085
  }
1086
+ if (resolved.kept) {
1087
+ matchedSignals = preferLawHits(priorWorking && priorWorking.matchedSignals, 8);
1088
+ }
1059
1089
  const compactHold = retainCompactFields(existing, extra);
1060
1090
  const nextHook = compactHold.hookEvent || extra.hookEvent || extra.source || null;
1061
1091
  const workingSnapshot = {
1062
1092
  host,
1063
1093
  intent,
1094
+ priorIntent: priorIntent || null,
1095
+ priorHost: priorHost || null,
1096
+ priorWorkingIntent: priorWorking && typeof priorWorking.intent === "string" ? priorWorking.intent : null,
1097
+ priorWorkingHost: priorWorking && typeof priorWorking.host === "string"
1098
+ ? (priorWorking.host.split(/\s+/)[0] || null)
1099
+ : null,
1064
1100
  git,
1065
1101
  hotSwap,
1066
1102
  memoryRouting: repertoireResume.startsWith("Repertoire: on") ? "on" : "off",
@@ -1074,6 +1110,13 @@ function applyStationHeat(root, host, extra = {}, existing = {}) {
1074
1110
  const growReceipt = workingGrowSnapshot(grow);
1075
1111
  if (growReceipt) workingSnapshot.grow = growReceipt;
1076
1112
  if (matchedSignals.length) workingSnapshot.matchedSignals = matchedSignals.slice(0, 8);
1113
+ const cascade = readWakeCascade(root, { laws: matchedSignals });
1114
+ workingSnapshot.cascade = {
1115
+ plane: cascade.plane,
1116
+ laws: cascade.laws,
1117
+ notes: cascade.notes.length,
1118
+ };
1119
+ const cascadeLine = formatCascadePointer(cascade);
1077
1120
  const opProcNames = readOpProcNames(root);
1078
1121
  if (opProcNames.length) workingSnapshot.opProcNames = opProcNames;
1079
1122
  const pickupChanged = Boolean(pickup && (!priorWorking || priorWorking.pickup !== pickup));
@@ -1106,8 +1149,10 @@ function applyStationHeat(root, host, extra = {}, existing = {}) {
1106
1149
  repertoireResume,
1107
1150
  workingLine,
1108
1151
  stationLine,
1152
+ cascadeLine,
1109
1153
  ...(notesLine ? { notesLine } : {}),
1110
1154
  ...compactHold,
1155
+ arrivedHook: extra && extra.hookEvent ? String(extra.hookEvent) : "",
1111
1156
  };
1112
1157
  }
1113
1158
 
@@ -1122,7 +1167,12 @@ const STOCK_STATION_PREFIXES = [
1122
1167
  "working:",
1123
1168
  "plate:",
1124
1169
  "library:",
1170
+ "cascade:",
1171
+ "sleeve:",
1125
1172
  "notes:",
1173
+ "plane:",
1174
+ "judgement:",
1175
+ "payments:",
1126
1176
  ];
1127
1177
 
1128
1178
  /** Stock design map. Exact lines so a later heat does not preserve a second copy. */
@@ -1318,6 +1368,11 @@ function formatStationMarkdown(fields) {
1318
1368
  const plateLine = plateStockLine(fields.intent);
1319
1369
  if (plateLine) lines.push(plateLine);
1320
1370
  lines.push("Library: record-map — .agents/skills/record-map/SKILL.md");
1371
+ if (fields.cascadeLine) lines.push(fields.cascadeLine);
1372
+ if (fields.sleeveLine) lines.push(fields.sleeveLine);
1373
+ lines.push(`Plane: ${fields.plane || "(none)"}`);
1374
+ lines.push(`Judgement: ${fields.judgement || "start"}`);
1375
+ lines.push(`Payments: ${fields.payments === "on" ? "on" : "off"}`);
1321
1376
  if (fields.notesLine) lines.push(fields.notesLine);
1322
1377
  lines.push("");
1323
1378
  lines.push(...DESIGN_MAP_LINES);
@@ -1338,19 +1393,160 @@ function readExistingStationMarkdown(root) {
1338
1393
  }
1339
1394
  }
1340
1395
 
1396
+
1397
+
1398
+ function ticketIsPayment(intent) {
1399
+ return /\b(pay|payment|payments|x402|invoice)\b/i.test(String(intent || ""));
1400
+ }
1401
+
1402
+ function readHeldPlane(root) {
1403
+ try {
1404
+ const data = JSON.parse(readFileSync(join(root, ".xray", "state", "goggles-plane.json"), "utf8"));
1405
+ return data && typeof data.plane === "string" ? data.plane : "";
1406
+ } catch {
1407
+ return "";
1408
+ }
1409
+ }
1410
+
1411
+ function missKey(proved) {
1412
+ const missing = proved && Array.isArray(proved.missing) ? proved.missing.slice() : [];
1413
+ const rows = proved && Array.isArray(proved.stitches) ? proved.stitches : [];
1414
+ const at = {};
1415
+ for (const row of rows) {
1416
+ if (!row || !missing.includes(row.name)) continue;
1417
+ at[row.name] = Array.isArray(row.at) ? row.at.slice() : [];
1418
+ }
1419
+ return JSON.stringify({ missing, at });
1420
+ }
1421
+
1422
+ function judgementLine(order, saved, proved) {
1423
+ const wake = order && order.wake ? order.wake : "start";
1424
+ if (wake === "repair") {
1425
+ const prior = saved && Number.isFinite(saved.retries) ? saved.retries : 0;
1426
+ const key = missKey(proved);
1427
+ if (saved && saved.missKey === key && prior > 0) return `retry ${prior}`;
1428
+ const next = prior + 1;
1429
+ if (saved) {
1430
+ saved.retries = next;
1431
+ saved.missKey = key;
1432
+ }
1433
+ return `retry ${next}`;
1434
+ }
1435
+ if (saved) {
1436
+ saved.retries = 0;
1437
+ delete saved.missKey;
1438
+ }
1439
+ if (wake === "continue" || wake === "stop" || wake === "start") return wake;
1440
+ return "start";
1441
+ }
1442
+
1443
+ function isMissPlan(line) {
1444
+ return typeof line === "string" && line.startsWith("The work is ");
1445
+ }
1446
+
1447
+ function missWork(missing) {
1448
+ const words = { loop: "the ticket", domain: "the plate", state: "the record", foundry: "the mill" };
1449
+ const parts = (Array.isArray(missing) ? missing : []).map((name) => words[name]).filter(Boolean);
1450
+ if (parts.length === 1) return `The work is ${parts[0]}.`;
1451
+ if (parts.length > 1) {
1452
+ const last = parts[parts.length - 1];
1453
+ return `The work is ${parts.slice(0, -1).join(", ")} and ${last}.`;
1454
+ }
1455
+ return "The work is the suit.";
1456
+ }
1457
+
1458
+ function wakeOrder(saved, proved, fields) {
1459
+ const missing = proved && Array.isArray(proved.missing) ? proved.missing : [];
1460
+ const sameJob = Boolean(saved && saved.priorIntent && saved.intent === saved.priorIntent);
1461
+ const suitMiss = missing.some((name) => name === "domain" || name === "foundry" || name === "state");
1462
+ if (proved && proved.on) {
1463
+ const paused = saved && typeof saved.pausedPlan === "string" ? saved.pausedPlan : "";
1464
+ if (isMissPlan(fields && fields.planLine) && saved && Object.prototype.hasOwnProperty.call(saved, "pausedPlan")) {
1465
+ return { wake: "continue", planLine: paused, pausedPlan: undefined };
1466
+ }
1467
+ return { wake: "continue", pausedPlan: undefined };
1468
+ }
1469
+ if (!saved || !saved.priorIntent) return { wake: "start" };
1470
+ if (saved.intent && saved.priorIntent && saved.intent !== saved.priorIntent) {
1471
+ return { wake: "stop", pausedPlan: undefined };
1472
+ }
1473
+ if (sameJob && !missing.includes("loop") && suitMiss) {
1474
+ const current = fields && fields.planLine ? String(fields.planLine) : "";
1475
+ const paused = isMissPlan(current)
1476
+ ? (typeof saved.pausedPlan === "string" ? saved.pausedPlan : "")
1477
+ : current;
1478
+ return { wake: "repair", planLine: missWork(missing), pausedPlan: paused };
1479
+ }
1480
+ return { wake: "start" };
1481
+ }
1482
+
1341
1483
  function writeStationMarkdown(root, fields) {
1342
1484
  try {
1343
1485
  const dir = join(root, ".xray", "state");
1344
1486
  mkdirSync(dir, { recursive: true });
1487
+ const arrivedKnown = Boolean(fields && Object.prototype.hasOwnProperty.call(fields, "arrivedHook"));
1488
+ const wake = arrivedKnown
1489
+ ? String(fields.arrivedHook || "")
1490
+ : String((fields && fields.hookEvent) || "");
1491
+ if (/^(session_start|session-start|pre_compact|post_compact)$/i.test(wake)) {
1492
+ try {
1493
+ runFoundryMill(root);
1494
+ } catch {
1495
+ /* the card still writes when the mill does not */
1496
+ }
1497
+ }
1498
+ const dest = stationMarkdownPath(root);
1499
+ const base = { ...(fields || {}) };
1500
+ delete base.sleeveLine;
1501
+ writeFileSync(dest, mergeStationMarkdown(formatStationMarkdown(base), readExistingStationMarkdown(root)));
1502
+ // Solar phase is not this judgement. The moral overlay cannot pass alone.
1503
+ fields.plane = readHeldPlane(root);
1504
+ fields.payments = ticketIsPayment(fields.intent) ? "on" : "off";
1505
+ let sleeveLine = "Sleeve: off loop, domain, state, foundry";
1506
+ try {
1507
+ const proved = readSleeve(root);
1508
+ sleeveLine = formatSleevePointer(proved);
1509
+ const workingPath = join(root, ".xray", "state", "repertoire-working.json");
1510
+ if (existsSync(workingPath)) {
1511
+ const saved = JSON.parse(readFileSync(workingPath, "utf8"));
1512
+ if (saved && typeof saved === "object") {
1513
+ const order = wakeOrder(saved, proved, fields);
1514
+ fields.wake = order.wake;
1515
+ if (Object.prototype.hasOwnProperty.call(order, "planLine")) {
1516
+ fields.planLine = order.planLine;
1517
+ }
1518
+ fields.judgement = judgementLine(order, saved, proved);
1519
+ saved.wake = order.wake;
1520
+ saved.retries = saved.retries || 0;
1521
+ saved.judgement = fields.judgement;
1522
+ saved.plane = fields.plane;
1523
+ saved.payments = fields.payments;
1524
+ if (order.pausedPlan !== undefined) saved.pausedPlan = order.pausedPlan;
1525
+ else delete saved.pausedPlan;
1526
+ saved.sleeve = {
1527
+ on: proved.on,
1528
+ missing: proved.missing,
1529
+ stitches: proved.stitches,
1530
+ };
1531
+ writeFileSync(workingPath, `${JSON.stringify(saved)}\n`);
1532
+ }
1533
+ }
1534
+ } catch {
1535
+ /* the card still writes; the sleeve stays off */
1536
+ }
1537
+ writeFileSync(
1538
+ dest,
1539
+ mergeStationMarkdown(
1540
+ formatStationMarkdown({ ...(fields || {}), sleeveLine }),
1541
+ readExistingStationMarkdown(root),
1542
+ ),
1543
+ );
1345
1544
  try {
1346
1545
  const plate = recallPlate(fields && fields.intent);
1347
- if (plate) stampPlateIfMissing(root, plate.id);
1546
+ if (plate) ensureWornPlate(root, plate.id);
1348
1547
  } catch {
1349
1548
  /* a missing plate doc must not block the card */
1350
1549
  }
1351
- const dest = stationMarkdownPath(root);
1352
- const next = mergeStationMarkdown(formatStationMarkdown(fields), readExistingStationMarkdown(root));
1353
- writeFileSync(dest, next);
1354
1550
  return dest;
1355
1551
  } catch {
1356
1552
  return null;
@@ -0,0 +1,102 @@
1
+ /**
2
+ * One wake hands the lens, the ticket, the laws, and the current notes.
3
+ * Goggles names plane record-map.
4
+ * The station module writes STATION.md and NOTES.md.
5
+ * Repertoire keeps the law list.
6
+ * The current session-note index sits beside that list.
7
+ * The card carries the count. A memory look carries the current lines.
8
+ */
9
+ const { existsSync, readFileSync } = require("fs");
10
+ const { join } = require("path");
11
+ const { shortSessionIndex } = require("./session-note-index.cjs");
12
+
13
+ const CASCADE_PLANE = "record-map";
14
+ const MEMORY_PLANES = ["record-map", "station-card", "notes-page", "memory-recall"];
15
+
16
+ function isCascadePlane(id) {
17
+ return MEMORY_PLANES.includes(String(id || ""));
18
+ }
19
+
20
+ function clipNames(names) {
21
+ if (!Array.isArray(names)) return [];
22
+ const out = [];
23
+ for (const raw of names) {
24
+ const name = String(raw || "").trim();
25
+ if (!name || out.includes(name)) continue;
26
+ out.push(name);
27
+ if (out.length >= 8) break;
28
+ }
29
+ return out;
30
+ }
31
+
32
+ function lawNamesFromWorking(root) {
33
+ const file = join(root, ".xray", "state", "repertoire-working.json");
34
+ if (!existsSync(file)) return [];
35
+ try {
36
+ const data = JSON.parse(readFileSync(file, "utf8"));
37
+ return clipNames(data && data.matchedSignals);
38
+ } catch {
39
+ return [];
40
+ }
41
+ }
42
+
43
+ function currentNotes(root) {
44
+ try {
45
+ return shortSessionIndex(root).map((note) => {
46
+ const row = { id: note.id, text: note.text };
47
+ if (note.slot) row.slot = note.slot;
48
+ return row;
49
+ });
50
+ } catch {
51
+ return [];
52
+ }
53
+ }
54
+
55
+ /** Laws come from this wake when passed. Otherwise the working file. Notes are current lines only. */
56
+ function readWakeCascade(root, opts = {}) {
57
+ const laws = Array.isArray(opts.laws) ? clipNames(opts.laws) : lawNamesFromWorking(root);
58
+ return {
59
+ plane: CASCADE_PLANE,
60
+ station: ".xray/state/STATION.md",
61
+ notesPage: ".xray/state/NOTES.md",
62
+ index: ".xray/state/repertoire/session-notes.json",
63
+ laws,
64
+ notes: currentNotes(root),
65
+ };
66
+ }
67
+
68
+ function formatCascadePointer(cascade) {
69
+ const count = cascade && Array.isArray(cascade.notes) ? cascade.notes.length : 0;
70
+ const plane = cascade && cascade.plane ? cascade.plane : CASCADE_PLANE;
71
+ return `Cascade: ${plane} · notes ${count} current`;
72
+ }
73
+
74
+ function formatCascadeReading(cascade) {
75
+ const plane = cascade && cascade.plane ? cascade.plane : CASCADE_PLANE;
76
+ const laws = cascade && Array.isArray(cascade.laws) && cascade.laws.length
77
+ ? cascade.laws.join(", ")
78
+ : "(none yet)";
79
+ const notes = cascade && Array.isArray(cascade.notes) ? cascade.notes : [];
80
+ const lines = [
81
+ `Cascade: ${plane}`,
82
+ `Station: ${cascade && cascade.station ? cascade.station : ".xray/state/STATION.md"}`,
83
+ `Notes page: ${cascade && cascade.notesPage ? cascade.notesPage : ".xray/state/NOTES.md"}`,
84
+ `Index: ${cascade && cascade.index ? cascade.index : ".xray/state/repertoire/session-notes.json"}`,
85
+ `Laws: ${laws}`,
86
+ `Notes: ${notes.length} current`,
87
+ ];
88
+ for (const note of notes) {
89
+ const slot = note.slot ? `${note.slot} ` : "";
90
+ lines.push(`- ${note.id} ${slot}${note.text}`);
91
+ }
92
+ return lines.join("\n");
93
+ }
94
+
95
+ module.exports = {
96
+ CASCADE_PLANE,
97
+ MEMORY_PLANES,
98
+ isCascadePlane,
99
+ readWakeCascade,
100
+ formatCascadePointer,
101
+ formatCascadeReading,
102
+ };
@@ -0,0 +1,16 @@
1
+ /**
2
+ * ESM face for wake-cascade.cjs.
3
+ */
4
+ import { createRequire } from "node:module";
5
+ import { fileURLToPath } from "node:url";
6
+ import { dirname, join } from "node:path";
7
+
8
+ const require = createRequire(import.meta.url);
9
+ const impl = require(join(dirname(fileURLToPath(import.meta.url)), "wake-cascade.cjs"));
10
+
11
+ export const CASCADE_PLANE = impl.CASCADE_PLANE;
12
+ export const MEMORY_PLANES = impl.MEMORY_PLANES;
13
+ export const isCascadePlane = impl.isCascadePlane;
14
+ export const readWakeCascade = impl.readWakeCascade;
15
+ export const formatCascadePointer = impl.formatCascadePointer;
16
+ export const formatCascadeReading = impl.formatCascadeReading;
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xray-pre-tool",
3
- "version": "4.0.39",
3
+ "version": "4.0.41",
4
4
  "private": true,
5
5
  "type": "module",
6
6
  "description": "0xRay constitution + temperament PreToolUse for OpenClaw",
@@ -1,4 +1,4 @@
1
- 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"];
1
+ 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"];
2
2
  export type PlateId = (typeof PLATE_IDS)[number];
3
3
  export interface PlateStamp {
4
4
  id: PlateId;
@@ -45,6 +45,7 @@ export const PLATE_IDS = [
45
45
  'lens-gate',
46
46
  'pre-tool',
47
47
  'lens-page',
48
+ 'centrifuge',
48
49
  ];
49
50
  function isPlateId(value) {
50
51
  return PLATE_IDS.includes(value);
@@ -35,4 +35,4 @@ Today those writers append `logs/framework/activity.log`. The features default s
35
35
 
36
36
  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.
37
37
 
38
- stamped · 0xray 4.0.36
38
+ stamped · 0xray 4.0.41
@@ -65,3 +65,5 @@ sidebar_label: Boot
65
65
  │ └────────────────────────────────────────────────────┘ │
66
66
  └────────────────────────────────────────────────────────────┘
67
67
  ```
68
+
69
+ stamped · 0xray 4.0.41
@@ -0,0 +1,30 @@
1
+ ---
2
+ title: Centrifuge
3
+ sidebar_label: Centrifuge
4
+ plate_type: domain model
5
+ ---
6
+
7
+ # Centrifuge
8
+
9
+ One wake is one turn. Station is the axle. The gap stays open.
10
+
11
+ ```
12
+ CENTRIFUGE
13
+ ┌──── VISOR ────┐
14
+ │ GOGGLES │
15
+ └───────┬───────┘
16
+ │ looks down
17
+ ┌──────────────────┴──────────────────┐
18
+ │ DOMAIN │
19
+ │ │
20
+ JUDGEMENT│ LOOP STATE │PAYMENTS
21
+ · off │ STATION │ · off
22
+ · fixed │ FOUNDRY │ · fixed
23
+ │ MEMORY │
24
+ └────────────── ONE TURN ─────────────┘
25
+ the gap stays open
26
+ ```
27
+
28
+ 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.
29
+
30
+ stamped · 0xray 4.0.41
@@ -32,4 +32,4 @@ Cursor preCompact writes the station card and cannot block the compact.
32
32
 
33
33
  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.
34
34
 
35
- stamped · 0xray 4.0.36
35
+ stamped · 0xray 4.0.41
@@ -23,5 +23,4 @@ What the words mean.
23
23
  │ grok-bot · the package you install │
24
24
  └────────────────────────────────────────────────────────────┘
25
25
  ```
26
-
27
-
26
+ stamped · 0xray 4.0.41
@@ -16,3 +16,7 @@ It views one plane.
16
16
  │ · not every plane at once │
17
17
  └────────────────────────────────────────────────────────────┘
18
18
  ```
19
+
20
+ A checkout named `0xray` records `scripts/mjs/run-goggles-mcp.mjs`. Any other project records `node_modules/0xray/scripts/mjs/run-goggles-mcp.mjs`.
21
+
22
+ stamped · 0xray 4.0.41
@@ -49,3 +49,5 @@ A proposal is deliberated inside the suit, filtered by Dynamo Solar, then merged
49
49
  │ └──────────────────────┘ └──────────────────────┘ │
50
50
  └────────────────────────────────────────────────────────────┘
51
51
  ```
52
+
53
+ stamped · 0xray 4.0.41
@@ -32,4 +32,4 @@ Grok PreCompact runs session-start.js with the pre_compact event.
32
32
 
33
33
  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.
34
34
 
35
- stamped · 0xray 4.0.36
35
+ stamped · 0xray 4.0.41
@@ -38,4 +38,4 @@ Give your bots a house: shared rules, one board for the work, and memory that st
38
38
  code links: suit → memory, house → doctor, memory → station. Other lines show reading order only.
39
39
  ```
40
40
 
41
- stamped · 0xray 4.0.30 · @0xray/grok-bot 0.1.8
41
+ stamped · 0xray 4.0.41 · @0xray/grok-bot 0.1.8
@@ -30,3 +30,5 @@ Run it in the tool you already open. Same suit. No new app.
30
30
  ```
31
31
 
32
32
  These six already run.
33
+
34
+ stamped · 0xray 4.0.41
@@ -50,4 +50,4 @@ A state flow plate: the stages a house goes through before doctor says House: PA
50
50
  └──────────────────────────────┘
51
51
  ```
52
52
 
53
- stamped · 0xray 4.0.30 · @0xray/grok-bot 0.1.8
53
+ stamped · 0xray 4.0.41 · @0xray/grok-bot 0.1.8
@@ -17,11 +17,11 @@ Plates have a type. A domain model plate shows how named parts fit. A state flow
17
17
 
18
18
  ## Domain model
19
19
 
20
- [Goggles](./goggles.md) · [Suit](./suit.md) · [Kits](./kits.md) · [Host Pack](./host-pack.md) · [Glossary](./glossary.md) · [Grok Bot](./grokbot.md)
20
+ [Goggles](./goggles.md) · [Suit](./suit.md) · [Kits](./kits.md) · [Host Pack](./host-pack.md) · [Glossary](./glossary.md) · [Grok Bot](./grokbot.md) · [Centrifuge](./centrifuge.md)
21
21
 
22
22
  ## State flow
23
23
 
24
- [House](./house.md) · [Review](./review.md)
24
+ [House](./house.md) · [Live mesh](./live-mesh.md) · [Review](./review.md)
25
25
 
26
26
  ## Pipeline
27
27
 
@@ -50,3 +50,5 @@ These eight are the pages the file ref names. Each one is a search lens. Each le
50
50
  [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)
51
51
 
52
52
  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.
53
+
54
+ stamped · 0xray 4.0.41
@@ -32,4 +32,4 @@ Inference cycle state already lives under .xray/inference.
32
32
 
33
33
  Cycle state, history, graded ids, and governance state are already there. Session files still fall back to `docs/inference` until the writers move.
34
34
 
35
- stamped · 0xray 4.0.36
35
+ stamped · 0xray 4.0.41
@@ -32,4 +32,4 @@ A station rewrite keeps one Fresh line and drops the copies.
32
32
 
33
33
  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.
34
34
 
35
- stamped · 0xray 4.0.36
35
+ stamped · 0xray 4.0.41
@@ -26,3 +26,5 @@ Add a power. Memory, judgment, or payments.
26
26
  ```
27
27
 
28
28
  Three. That's the set.
29
+
30
+ stamped · 0xray 4.0.41
@@ -32,4 +32,4 @@ A search names one plane or it stops.
32
32
 
33
33
  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.
34
34
 
35
- stamped · 0xray 4.0.36
35
+ stamped · 0xray 4.0.41
@@ -32,4 +32,4 @@ The lens page is the card for one plane.
32
32
 
33
33
  `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.
34
34
 
35
- stamped · 0xray 4.0.36
35
+ stamped · 0xray 4.0.41