0xray 4.0.36 → 4.0.38

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

@@ -23,29 +23,193 @@
     "worn": "dist/nucleus/thin-dispatch.js",
     "mark": "export function scoreAndRoute",
     "wornMark": "function scoreAndRoute",
-    "pick": "resolveThinDispatch"
+    "pick": "resolveThinDispatch",
+    "skills": ".agents/skills/routing/SKILL.md",
+    "plates": ["orchestration", "processor"]
   },
   "house": {
-    "files": ["grok-bot/lib/seat-doctor.cjs"]
+    "files": ["grok-bot/lib/seat-doctor.cjs"],
+    "skills": ".agents/skills/house/SKILL.md",
+    "plates": ["suit-wear"]
   },
   "boot": {
     "files": ["src/core/boot-orchestrator.ts"],
-    "skills": "src/skills/boot-orchestrator/SKILL.md"
+    "skills": "src/skills/boot-orchestrator/SKILL.md",
+    "plates": ["suit-wear"]
   },
   "governance": {
-    "files": ["src/governance/governance-service.ts"]
+    "files": ["src/governance/governance-service.ts"],
+    "skills": ".agents/skills/governance/SKILL.md"
   },
   "memory-recall": {
-    "files": ["src/integrations/hooks/plates.cjs"]
+    "files": ["src/integrations/hooks/plates.cjs"],
+    "skills": ".agents/skills/memory-recall/SKILL.md",
+    "plates": ["record-map"]
   },
   "orchestration": {
-    "files": ["src/mcps/orchestrator/server.ts"]
+    "files": ["src/mcps/orchestrator/server.ts"],
+    "skills": ".agents/skills/orchestration/SKILL.md",
+    "plates": ["routing", "processor"]
   },
   "processor": {
     "files": ["src/processors/processor-manager.ts"],
-    "skills": "src/skills/processor-pipeline/SKILL.md"
+    "skills": "src/skills/processor-pipeline/SKILL.md",
+    "plates": ["orchestration"]
   },
   "reporting": {
-    "files": ["src/reporting/framework-reporting-system.ts"]
+    "files": ["src/reporting/framework-reporting-system.ts"],
+    "skills": ".agents/skills/reporting/SKILL.md",
+    "plates": ["activity-log", "suit-organs"]
+  },
+  "stamp-plate": {
+    "files": [".agents/skills/stamp-plate/SKILL.md"],
+    "mark": "Stamp a plate or a lens",
+    "skills": ".agents/skills/stamp-plate/SKILL.md",
+    "plates": ["review"]
+  },
+  "record-map": {
+    "files": ["docs-site/docs/plates/record-map.md"],
+    "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"]
+  },
+  "write-home": {
+    "files": ["src/integrations/hooks/write-home.cjs"],
+    "mark": "function activityLog",
+    "skills": ".agents/skills/write-home/SKILL.md",
+    "plates": ["activity-log", "session-capture", "inference-files", "trail-state", "suit-wear"]
+  },
+  "activity-log": {
+    "files": ["src/core/activity-logger.ts"],
+    "mark": "activity.log",
+    "skills": ".agents/skills/activity-log/SKILL.md",
+    "plates": ["write-home", "reporting", "suit-organs"]
+  },
+  "session-capture": {
+    "files": ["src/inference/session-capture.ts"],
+    "mark": "saveSessionInference",
+    "skills": ".agents/skills/session-capture/SKILL.md",
+    "plates": ["write-home", "inference-files", "suit-organs"]
+  },
+  "suit-wear": {
+    "files": ["src/core/features-config.ts"],
+    "mark": "log_path",
+    "skills": ".agents/skills/suit-wear/SKILL.md",
+    "plates": ["suit-settings", "write-home", "package-face"]
+  },
+  "suit-organs": {
+    "files": ["src/reporting/framework-reporting-system.ts"],
+    "mark": "activity.log",
+    "skills": ".agents/skills/suit-organs/SKILL.md",
+    "plates": ["activity-log", "session-capture", "inference-files", "trail-state"]
+  },
+  "station-card": {
+    "files": ["src/integrations/hooks/station-hook-runtime.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"],
+    "mark": "stampNotesPickup",
+    "skills": ".agents/skills/notes-page/SKILL.md",
+    "plates": ["station-card", "record-map"]
+  },
+  "reflection-page": {
+    "files": ["src/inference/inference-accumulator.ts"],
+    "mark": "loadReflectionInferences",
+    "skills": ".agents/skills/reflection-page/SKILL.md",
+    "plates": ["record-map"]
+  },
+  "site-manual": {
+    "files": ["docs-site/docs/introduction.md"],
+    "mark": "survives the context window",
+    "skills": ".agents/skills/site-manual/SKILL.md",
+    "plates": ["record-map"]
+  },
+  "package-face": {
+    "files": ["package.json"],
+    "mark": "\"name\": \"0xray\"",
+    "skills": ".agents/skills/package-face/SKILL.md",
+    "plates": ["record-map", "suit-wear"]
+  },
+  "suit-settings": {
+    "files": ["xray/features.json"],
+    "mark": "log_path",
+    "skills": ".agents/skills/suit-settings/SKILL.md",
+    "plates": ["suit-wear", "record-map"]
+  },
+  "trail-state": {
+    "files": ["src/integrations/hooks/station-hook-runtime.cjs"],
+    "mark": "session-boot.json",
+    "skills": ".agents/skills/trail-state/SKILL.md",
+    "plates": ["write-home", "suit-organs"]
+  },
+  "inference-files": {
+    "files": ["src/inference/inference-accumulator.ts"],
+    "mark": "loadSessionInferences",
+    "skills": ".agents/skills/inference-files/SKILL.md",
+    "plates": ["session-capture", "write-home", "suit-organs"]
+  },
+  "grok-compact": {
+    "files": ["src/integrations/grok/hooks/session-start.js"],
+    "mark": "pre_compact",
+    "skills": ".agents/skills/grok-compact/SKILL.md",
+    "plates": ["payload-heat", "cursor-compact", "work-fresh"]
+  },
+  "payload-heat": {
+    "files": ["src/integrations/grok/hooks/grok-hook-utils.js"],
+    "mark": "function buildSessionBootPayload",
+    "skills": ".agents/skills/payload-heat/SKILL.md",
+    "plates": ["station-heat", "pickup-stamp"]
+  },
+  "station-heat": {
+    "files": ["src/integrations/hooks/station-hook-runtime.cjs"],
+    "mark": "function applyStationHeat",
+    "skills": ".agents/skills/station-heat/SKILL.md",
+    "plates": ["pickup-stamp", "notes-page"]
+  },
+  "pickup-stamp": {
+    "files": ["src/integrations/hooks/station-hook-runtime.cjs"],
+    "mark": "One pickup line",
+    "skills": ".agents/skills/pickup-stamp/SKILL.md",
+    "plates": ["notes-page"]
+  },
+  "cursor-compact": {
+    "files": ["src/integrations/cursor/hooks/pre-compact.js"],
+    "mark": "cannot block",
+    "skills": ".agents/skills/cursor-compact/SKILL.md",
+    "plates": ["payload-heat", "station-heat"]
+  }
+,
+  "work-fresh": {
+    "files": ["src/nucleus/work-freshness.mjs"],
+    "mark": "export function refreshFreshness",
+    "skills": ".agents/skills/work-fresh/SKILL.md",
+    "plates": ["station-card", "grok-compact"]
+  },
+  "kept-line": {
+    "files": ["src/integrations/hooks/station-hook-runtime.cjs"],
+    "mark": "function withOneFreshLine",
+    "skills": ".agents/skills/kept-line/SKILL.md",
+    "plates": ["station-card", "work-fresh"]
+  },
+  "lens-gate": {
+    "files": ["src/integrations/hooks/goggles-pipeline.mjs"],
+    "mark": "export function lensBeforeResearch",
+    "skills": ".agents/skills/lens-gate/SKILL.md",
+    "plates": ["pre-tool"]
+  },
+  "pre-tool": {
+    "files": ["src/integrations/grok/hooks/pre-tool-use.js"],
+    "mark": "function extractFromEvent",
+    "skills": ".agents/skills/pre-tool/SKILL.md",
+    "plates": ["lens-gate"]
+  },
+  "lens-page": {
+    "files": ["src/integrations/hooks/goggles-pipeline.mjs"],
+    "mark": "export function formatCardPane",
+    "skills": ".agents/skills/lens-page/SKILL.md",
+    "plates": ["record-map", "lens-gate"]
   }
 }
+

package/dist/integrations/hooks/plates.cjs

@@ -14,12 +14,38 @@ const PLATE_IDS = Object.freeze([
   "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",
 ]);
 
 /** Id token, then extra phrases. Equal top scores recall nothing. */
@@ -73,6 +99,13 @@ const CUES = {
     [/GROK_BOT_HOUSE/i, 4],
     [/setup-house/i, 4],
   ],
+  review: [
+    [/review plate/i, 6],
+    [/plates\/review\b/i, 6],
+    [/re-review/i, 5],
+    [/critic\s+FAIL/i, 5],
+    [/critic\s+PASS/i, 5],
+  ],
   goggles: [
     [/\bgoggles\b/i, 6],
   ],
@@ -91,6 +124,111 @@ const CUES = {
   glossary: [
     [/\bglossary\b/i, 6],
   ],
+  "stamp-plate": [
+    [/stamp plate/i, 6],
+    [/plates\/stamp-plate/i, 6],
+  ],
+  "record-map": [
+    [/record map/i, 6],
+    [/five pages the agent/i, 6],
+    [/plates\/record-map/i, 6],
+  ],
+  "write-home": [
+    [/write home/i, 6],
+    [/\.xray\/logs/i, 6],
+    [/plates\/write-home/i, 6],
+  ],
+  "activity-log": [
+    [/activity log pipeline/i, 6],
+    [/plates\/activity-log/i, 6],
+  ],
+  "session-capture": [
+    [/session capture/i, 6],
+    [/latest-session\.json/i, 5],
+    [/plates\/session-capture/i, 6],
+  ],
+  "suit-wear": [
+    [/suit wear/i, 6],
+    [/consumer gitignore/i, 5],
+    [/plates\/suit-wear/i, 6],
+  ],
+  "suit-organs": [
+    [/suit organs/i, 6],
+    [/plates\/suit-organs/i, 6],
+  ],
+  "station-card": [
+    [/station card/i, 6],
+    [/plates\/station-card/i, 6],
+  ],
+  "notes-page": [
+    [/notes page/i, 6],
+    [/plates\/notes-page/i, 6],
+  ],
+  "reflection-page": [
+    [/reflection page/i, 6],
+    [/plates\/reflection-page/i, 6],
+  ],
+  "site-manual": [
+    [/site manual/i, 6],
+    [/plates\/site-manual/i, 6],
+  ],
+  "package-face": [
+    [/package face/i, 6],
+    [/plates\/package-face/i, 6],
+  ],
+  "suit-settings": [
+    [/suit settings/i, 6],
+    [/plates\/suit-settings/i, 6],
+  ],
+  "trail-state": [
+    [/trail state/i, 6],
+    [/plates\/trail-state/i, 6],
+  ],
+  "inference-files": [
+    [/inference files/i, 6],
+    [/plates\/inference-files/i, 6],
+  ],
+  "grok-compact": [
+    [/grok compact/i, 6],
+    [/plates\/grok-compact/i, 6],
+  ],
+  "payload-heat": [
+    [/payload heat/i, 6],
+    [/plates\/payload-heat/i, 6],
+  ],
+  "station-heat": [
+    [/station heat/i, 6],
+    [/plates\/station-heat/i, 6],
+  ],
+  "pickup-stamp": [
+    [/pickup stamp/i, 6],
+    [/plates\/pickup-stamp/i, 6],
+  ],
+  "cursor-compact": [
+    [/cursor compact/i, 6],
+    [/plates\/cursor-compact/i, 6],
+  ],
+  "work-fresh": [
+    [/work fresh/i, 6],
+    [/freshness line/i, 6],
+    [/plates\/work-fresh/i, 6],
+  ],
+  "kept-line": [
+    [/kept line/i, 6],
+    [/plates\/kept-line/i, 6],
+  ],
+  "lens-gate": [
+    [/lens gate/i, 6],
+    [/plates\/lens-gate/i, 6],
+  ],
+  "pre-tool": [
+    [/pre tool/i, 6],
+    [/plates\/pre-tool/i, 6],
+  ],
+  "lens-page": [
+    [/lens page/i, 6],
+    [/plates\/lens-page/i, 6],
+  ],
 };
 
 function platesDir() {

package/dist/integrations/hooks/station-hook-runtime.cjs

@@ -526,6 +526,19 @@ function stampNotesPickup(root, line) {
   return text;
 }
 
+function notesMark(root) {
+  let body = "";
+  const dest = notesPath(root);
+  if (existsSync(dest)) {
+    try {
+      body = readFileSync(dest, "utf8");
+    } catch {
+      body = "";
+    }
+  }
+  return /^## Working notes\b/m.test(body) ? "Notes: present" : "Notes: THIN";
+}
+
 function readLatestSessionApproaches(root) {
   const latest = join(root, "docs", "inference", "latest-session.json");
   if (!existsSync(latest)) return null;
@@ -995,9 +1008,13 @@ function applyStationHeat(root, host, extra = {}, existing = {}) {
   const resolved = resolveHeatIntent(root, extra, existing);
   const intent = resolved.intent;
   const rematch = resolved.rematch;
-  if (isCompactHook(extra) && intent && (readStationTicketField(root, "Intent") || pickup || clipIntent(extra.intent))) {
-    const stamped = stampNotesPickup(root, intent);
-    if (stamped) pickup = stamped;
+  let notesLine = null;
+  if (isCompactHook(extra)) {
+    if (intent && (readStationTicketField(root, "Intent") || pickup || clipIntent(extra.intent))) {
+      const stamped = stampNotesPickup(root, intent);
+      if (stamped) pickup = stamped;
+    }
+    notesLine = notesMark(root);
   }
   const matchText = clipIntent([intent, pickup, approaches].filter(Boolean).join(" "));
   const git = readGitBrief(root);
@@ -1089,6 +1106,7 @@ function applyStationHeat(root, host, extra = {}, existing = {}) {
     repertoireResume,
     workingLine,
     stationLine,
+    ...(notesLine ? { notesLine } : {}),
     ...compactHold,
   };
 }
@@ -1099,9 +1117,12 @@ const STOCK_STATION_PREFIXES = [
   "intent:",
   "plan:",
   "git:",
+  "fresh:",
   "repertoire:",
   "working:",
   "plate:",
+  "library:",
+  "notes:",
 ];
 
 /** Stock design map. Exact lines so a later heat does not preserve a second copy. */
@@ -1222,10 +1243,45 @@ function extractPreservedStationLines(existing) {
   return preserved;
 }
 
+function latestFreshLine(existingMd) {
+  const lines = String(existingMd || "").split(/\r?\n/).map((line) => line.trim()).filter((line) => /^Fresh:/.test(line));
+  return lines.length ? lines[lines.length - 1] : "";
+}
+
+function withOneFreshLine(stockMd, existingMd) {
+  const stock = String(stockMd || "");
+  if (/^Fresh:/m.test(stock)) return stock;
+  const fresh = latestFreshLine(existingMd);
+  if (!fresh) return stock;
+  const rows = stock.split(/\r?\n/);
+  const at = rows.findIndex((row) => row.startsWith("Repertoire:"));
+  if (at >= 0) rows.splice(at, 0, fresh);
+  else rows.splice(Math.min(rows.length, 6), 0, fresh);
+  return rows.join("\n");
+}
+
+function latestNotesLine(existingMd) {
+  const lines = String(existingMd || "").split(/\r?\n/).map((line) => line.trim()).filter((line) => /^Notes:/.test(line));
+  return lines.length ? lines[lines.length - 1] : "";
+}
+
+function withOneNotesLine(stockMd, existingMd) {
+  const stock = String(stockMd || "");
+  if (/^Notes:/m.test(stock)) return stock;
+  const notes = latestNotesLine(existingMd);
+  if (!notes) return stock;
+  const rows = stock.split(/\r?\n/);
+  const at = rows.findIndex((row) => row.startsWith("Library:"));
+  if (at >= 0) rows.splice(at + 1, 0, notes);
+  else rows.splice(Math.min(rows.length, 8), 0, notes);
+  return rows.join("\n");
+}
+
 function mergeStationMarkdown(stockMd, existingMd) {
+  const stockWithFresh = withOneNotesLine(withOneFreshLine(stockMd, existingMd), existingMd);
   const preserved = extractPreservedStationLines(existingMd);
-  if (!preserved.length) return stockMd;
-  const stock = String(stockMd || "");
+  if (!preserved.length) return stockWithFresh;
+  const stock = stockWithFresh;
   const block = preserved.join("\n");
   const marker = "Continue this card.";
   const idx = stock.indexOf(marker);
@@ -1261,6 +1317,8 @@ function formatStationMarkdown(fields) {
   }
   const plateLine = plateStockLine(fields.intent);
   if (plateLine) lines.push(plateLine);
+  lines.push("Library: record-map — .agents/skills/record-map/SKILL.md");
+  if (fields.notesLine) lines.push(fields.notesLine);
   lines.push("");
   lines.push(...DESIGN_MAP_LINES);
   lines.push("");

package/dist/integrations/hooks/write-home.cjs

@@ -0,0 +1,59 @@
+/**
+ * Where the suit writes. One home, under .xray.
+ * Readers still open the old path when the new file is not there yet.
+ */
+const { existsSync } = require("fs");
+const { join } = require("path");
+
+function logsDir(root) {
+  return join(root, ".xray", "logs");
+}
+
+function activityLog(root) {
+  return join(logsDir(root), "activity.log");
+}
+
+function inferenceDir(root) {
+  return join(root, ".xray", "inference");
+}
+
+function latestSession(root) {
+  return join(inferenceDir(root), "latest-session.json");
+}
+
+function activityLogForRead(root) {
+  const next = activityLog(root);
+  const prev = join(root, "logs", "framework", "activity.log");
+  if (existsSync(next) || !existsSync(prev)) return next;
+  return prev;
+}
+
+function latestSessionForRead(root) {
+  const next = latestSession(root);
+  const prev = join(root, "docs", "inference", "latest-session.json");
+  if (existsSync(next) || !existsSync(prev)) return next;
+  return prev;
+}
+
+/** Old feature values that used to scatter writes. */
+function isLegacyLogPath(logPath) {
+  if (!logPath) return true;
+  const normalized = String(logPath).replace(/\\/g, "/").replace(/\/$/, "");
+  return (
+    normalized === ".opencode/logs" ||
+    normalized === ".opencode" ||
+    normalized === "logs" ||
+    normalized === "logs/framework" ||
+    normalized.endsWith("/logs/framework")
+  );
+}
+
+module.exports = {
+  logsDir,
+  activityLog,
+  inferenceDir,
+  latestSession,
+  activityLogForRead,
+  latestSessionForRead,
+  isLegacyLogPath,
+};

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

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

package/dist/mcps/architect-tools.server.d.ts

@@ -5,6 +5,12 @@
  * Provides contextual analysis capabilities via MCP protocol
  */
 import { XrayKnowledgeSkillBase } from "./shared/knowledge-skill-base.js";
+export declare function renderArchitectureAssessment(args: Record<string, unknown> | undefined): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
 declare class XrayArchitectToolsServer extends XrayKnowledgeSkillBase {
     constructor();
     setupToolHandlers(): void;

package/dist/mcps/architect-tools.server.js

@@ -8,7 +8,24 @@ import { CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { XrayKnowledgeSkillBase } from "./shared/knowledge-skill-base.js";
 import * as fs from "fs";
 import { frameworkLogger } from "../core/framework-logger.js";
-import { contextAnalysis as architectContextAnalysis, codebaseStructure as architectCodebaseStructure, dependencyAnalysis as architectDependencyAnalysis, architectureAssessment as architectArchitectureAssessment, } from "../architect/architect-tools.js";
+import { contextAnalysis as architectContextAnalysis, codebaseStructure as architectCodebaseStructure, dependencyAnalysis as architectDependencyAnalysis, architectureAssessment as architectArchitectureAssessment, formatConferArchitectureText, } from "../architect/architect-tools.js";
+export async function renderArchitectureAssessment(args) {
+    const projectRoot = typeof args?.projectRoot === "string" ? args.projectRoot : "";
+    const assessmentType = args?.assessmentType === "quick" || args?.assessmentType === "comprehensive"
+        ? args.assessmentType
+        : "comprehensive";
+    const conferPrompt = typeof args?.conferPrompt === "string" ? args.conferPrompt : "";
+    frameworkLogger.log("mcps/architect-tools", "architecture-assessment", "info", { projectRoot });
+    const result = await architectArchitectureAssessment(projectRoot, assessmentType);
+    return {
+        content: [
+            {
+                type: "text",
+                text: formatConferArchitectureText(conferPrompt, result),
+            },
+        ],
+    };
+}
 class XrayArchitectToolsServer extends XrayKnowledgeSkillBase {
     constructor() {
         super("architect-tools", "3.1.0");
@@ -191,23 +208,7 @@ class XrayArchitectToolsServer extends XrayKnowledgeSkillBase {
         };
     }
     async architectureAssessment(args) {
-        const projectRoot = args?.projectRoot || "";
-        const assessmentType = args?.assessmentType || "comprehensive";
-        const conferPrompt = typeof args?.conferPrompt === "string" ? args.conferPrompt : "";
-        frameworkLogger.log("mcps/architect-tools", "architecture-assessment", "info", { projectRoot });
-        const result = await architectArchitectureAssessment(projectRoot, assessmentType);
-        const assessmentJson = JSON.stringify(result, null, 2);
-        const text = conferPrompt.trim()
-            ? `${conferPrompt.trim()}\n\n## Architecture assessment\n${assessmentJson}\n\nVerdict: CONDITIONAL\nTop risks: review assessment metrics above\nHardening: address high-complexity or coupling findings before resuming`
-            : assessmentJson;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text,
-                },
-            ],
-        };
+        return renderArchitectureAssessment(args);
     }
 }
 if (import.meta.url === `file://${fs.realpathSync(process.argv[1])}`) {

package/dist/mcps/orchestrator/server.d.ts

@@ -12,11 +12,12 @@ export declare class OrchestratorServer {
     private server;
     private activeTasks;
     private taskHistory;
-    private taskHandler;
-    private complexityHandler;
+    private taskHandlerPromise;
+    private complexityHandlerPromise;
     private statusHandler;
-    private coordinator;
     constructor();
+    private loadTaskHandler;
+    private loadComplexityHandler;
     /**
      * Initialize tool definitions
      */