@remnic/core 1.1.30 → 9.3.515

package/dist/{chunk-ZPKBYX2F.js → chunk-YNDLCWXS.js}

@@ -1,14 +1,14 @@
 import {
   diffGraphSnapshots
-} from "./chunk-3SLRNYNG.js";
+} from "./chunk-AUDJPF4N.js";
 import {
   graphSnapshotFromMemoryDir
-} from "./chunk-LIRZNNUP.js";
+} from "./chunk-44442YCH.js";
 
 // src/dashboard-runtime.ts
-import { createHash } from "crypto";
+import { createHash, timingSafeEqual } from "crypto";
 import { createServer } from "http";
-import { watch } from "fs";
+import { mkdirSync, watch } from "fs";
 import { readFile } from "fs/promises";
 import path from "path";
 var LOOPBACK_HOSTS = /* @__PURE__ */ new Set(["127.0.0.1", "localhost", "::1"]);
@@ -18,6 +18,22 @@ function normalizeOriginHostname(hostname) {
   }
   return hostname;
 }
+function isLoopbackBindHost(host) {
+  return LOOPBACK_HOSTS.has(normalizeOriginHostname(host.trim().toLowerCase()));
+}
+function constantTimeEquals(a, b) {
+  const aBuffer = Buffer.from(a);
+  const bBuffer = Buffer.from(b);
+  if (aBuffer.length !== bBuffer.length) return false;
+  return timingSafeEqual(aBuffer, bBuffer);
+}
+function parseDashboardPort(port) {
+  if (port === void 0) return 0;
+  if (!Number.isInteger(port) || port < 0 || port > 65535) {
+    throw new Error("dashboard port must be an integer from 0 to 65535");
+  }
+  return port;
+}
 function websocketAcceptKey(clientKey) {
   return createHash("sha1").update(`${clientKey}258EAFA5-E914-47DA-95CA-C5AB0DC85B11`).digest("base64");
 }
@@ -42,6 +58,7 @@ var GraphDashboardServer = class {
   requestedPort;
   publicDir;
   watchDebounceMs;
+  authToken;
   server = null;
   watcher = null;
   clients = /* @__PURE__ */ new Map();
@@ -57,14 +74,19 @@ var GraphDashboardServer = class {
   constructor(options) {
     this.memoryDir = options.memoryDir;
     this.host = options.host?.trim() || "127.0.0.1";
-    this.requestedPort = Number.isFinite(options.port) ? Math.max(0, Math.floor(options.port ?? 0)) : 0;
+    this.requestedPort = parseDashboardPort(options.port);
     this.publicDir = options.publicDir ?? path.join(process.cwd(), "dashboard", "public");
     this.watchDebounceMs = Math.max(50, Math.floor(options.watchDebounceMs ?? 300));
+    const authToken = options.authToken?.trim();
+    this.authToken = authToken && authToken.length > 0 ? authToken : null;
   }
   async start() {
     if (this.server) {
       return this.status();
     }
+    if (!isLoopbackBindHost(this.host) && !this.authToken) {
+      throw new Error("dashboard auth token is required when binding to a non-loopback host");
+    }
     await this.rebuildSnapshot();
     const candidate = createServer((req, res) => {
       void this.handleHttp(req, res);
@@ -142,6 +164,7 @@ var GraphDashboardServer = class {
   async handleHttp(req, res) {
     const url = req.url ?? "/";
     if (req.method === "GET" && url === "/api/health") {
+      if (!this.authorizeHttpApi(req, res)) return;
       this.respondJson(res, 200, {
         ok: true,
         running: this.server !== null,
@@ -153,6 +176,7 @@ var GraphDashboardServer = class {
       return;
     }
     if (req.method === "GET" && url === "/api/graph") {
+      if (!this.authorizeHttpApi(req, res)) return;
       this.respondJson(res, 200, this.graphSnapshot);
       return;
     }
@@ -173,6 +197,21 @@ var GraphDashboardServer = class {
     res.setHeader("content-length", String(Buffer.byteLength(body)));
     res.end(body);
   }
+  authorizeHttpApi(req, res) {
+    if (!this.authToken) return true;
+    const header = req.headers.authorization;
+    const value = Array.isArray(header) ? header[0] : header;
+    const prefix = "Bearer ";
+    if (typeof value === "string" && value.startsWith(prefix)) {
+      const supplied = value.slice(prefix.length);
+      if (constantTimeEquals(supplied, this.authToken)) {
+        return true;
+      }
+    }
+    res.setHeader("www-authenticate", "Bearer");
+    this.respondJson(res, 401, { error: "Unauthorized" });
+    return false;
+  }
   async respondStatic(res, filePath, contentType) {
     try {
       const body = await readFile(filePath, "utf-8");
@@ -198,6 +237,11 @@ var GraphDashboardServer = class {
       socket.destroy();
       return;
     }
+    if (!this.authorizeWebSocketUpgrade(req)) {
+      socket.write("HTTP/1.1 401 Unauthorized\r\nWWW-Authenticate: Bearer\r\n\r\n");
+      socket.destroy();
+      return;
+    }
     const accept = websocketAcceptKey(key);
     socket.write(
       [
@@ -228,14 +272,45 @@ var GraphDashboardServer = class {
     try {
       const parsed = new URL(origin);
       const hostname = normalizeOriginHostname(parsed.hostname);
-      if (!LOOPBACK_HOSTS.has(hostname)) return false;
       if (parsed.protocol !== "http:") return false;
       const originPort = parsed.port ? Number(parsed.port) : 80;
-      return Number.isFinite(originPort) && originPort === this.boundPort;
+      if (!Number.isFinite(originPort) || originPort !== this.boundPort) return false;
+      if (LOOPBACK_HOSTS.has(hostname)) return true;
+      return this.authToken !== null;
     } catch {
       return false;
     }
   }
+  authorizeWebSocketUpgrade(req) {
+    if (!this.authToken) return true;
+    const supplied = this.webSocketTokenFromUrl(req.url) ?? this.webSocketTokenFromProtocol(req);
+    return typeof supplied === "string" && constantTimeEquals(supplied, this.authToken);
+  }
+  webSocketTokenFromUrl(rawUrl) {
+    if (!rawUrl) return null;
+    try {
+      const parsed = new URL(rawUrl, `http://${this.host}:${this.boundPort}`);
+      const token = parsed.searchParams.get("token");
+      return token && token.length > 0 ? token : null;
+    } catch {
+      return null;
+    }
+  }
+  webSocketTokenFromProtocol(req) {
+    const raw = req.headers["sec-websocket-protocol"];
+    const values = Array.isArray(raw) ? raw : typeof raw === "string" ? raw.split(",") : [];
+    for (const value of values) {
+      const trimmed = value.trim();
+      const prefix = "remnic-token.";
+      if (!trimmed.startsWith(prefix)) continue;
+      try {
+        return Buffer.from(trimmed.slice(prefix.length), "base64url").toString("utf8");
+      } catch {
+        return null;
+      }
+    }
+    return null;
+  }
   broadcast(payload) {
     const frame = encodeTextFrame(JSON.stringify(payload));
     for (const [id, client] of this.clients.entries()) {
@@ -249,6 +324,7 @@ var GraphDashboardServer = class {
   startWatcher() {
     const graphDir = path.join(this.memoryDir, "state", "graphs");
     try {
+      mkdirSync(graphDir, { recursive: true });
       this.watcher = watch(graphDir, { persistent: false }, () => {
         this.scheduleRebuild();
       });
@@ -271,7 +347,7 @@ var GraphDashboardServer = class {
     const previous = this.graphSnapshot;
     await this.rebuildSnapshot();
     const patch = diffGraphSnapshots(previous, this.graphSnapshot);
-    if (patch.addedEdges.length === 0 && patch.removedEdges.length === 0 && patch.addedNodes.length === 0 && patch.removedNodes.length === 0) {
+    if (patch.addedEdges.length === 0 && patch.removedEdges.length === 0 && patch.updatedEdges.length === 0 && patch.addedNodes.length === 0 && patch.removedNodes.length === 0) {
       return;
     }
     this.broadcast({
@@ -294,4 +370,4 @@ var GraphDashboardServer = class {
 export {
   GraphDashboardServer
 };
-//# sourceMappingURL=chunk-ZPKBYX2F.js.map
+//# sourceMappingURL=chunk-YNDLCWXS.js.map

package/dist/chunk-YNDLCWXS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dashboard-runtime.ts"],"sourcesContent":["import { createHash, timingSafeEqual } from \"node:crypto\";\nimport { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport { mkdirSync, watch, type FSWatcher } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { Duplex } from \"node:stream\";\nimport { graphSnapshotFromMemoryDir, type GraphSnapshot } from \"./graph-dashboard-parser.js\";\nimport { diffGraphSnapshots } from \"./graph-dashboard-diff.js\";\n\nexport interface DashboardServerOptions {\n  memoryDir: string;\n  host?: string;\n  port?: number;\n  publicDir?: string;\n  watchDebounceMs?: number;\n  authToken?: string;\n}\n\nexport interface DashboardStatus {\n  running: boolean;\n  host: string;\n  port: number;\n  watching: boolean;\n  lastUpdatedAt?: string;\n  graphNodeCount: number;\n  graphEdgeCount: number;\n}\n\ntype WsClient = {\n  id: string;\n  socket: Duplex;\n};\n\nconst LOOPBACK_HOSTS = new Set([\"127.0.0.1\", \"localhost\", \"::1\"]);\n\nfunction normalizeOriginHostname(hostname: string): string {\n  if (hostname.startsWith(\"[\") && hostname.endsWith(\"]\")) {\n    return hostname.slice(1, -1);\n  }\n  return hostname;\n}\n\nfunction isLoopbackBindHost(host: string): boolean {\n  return LOOPBACK_HOSTS.has(normalizeOriginHostname(host.trim().toLowerCase()));\n}\n\nfunction constantTimeEquals(a: string, b: string): boolean {\n  const aBuffer = Buffer.from(a);\n  const bBuffer = Buffer.from(b);\n  if (aBuffer.length !== bBuffer.length) return false;\n  return timingSafeEqual(aBuffer, bBuffer);\n}\n\nfunction parseDashboardPort(port: number | undefined): number {\n  if (port === undefined) return 0;\n  if (!Number.isInteger(port) || port < 0 || port > 65535) {\n    throw new Error(\"dashboard port must be an integer from 0 to 65535\");\n  }\n  return port;\n}\n\nfunction websocketAcceptKey(clientKey: string): string {\n  return createHash(\"sha1\")\n    .update(`${clientKey}258EAFA5-E914-47DA-95CA-C5AB0DC85B11`)\n    .digest(\"base64\");\n}\n\nfunction encodeTextFrame(payload: string): Buffer {\n  const payloadBuffer = Buffer.from(payload, \"utf-8\");\n  const len = payloadBuffer.length;\n  const header: number[] = [0x81];\n  if (len <= 125) {\n    header.push(len);\n  } else if (len <= 0xffff) {\n    header.push(126, (len >> 8) & 0xff, len & 0xff);\n  } else {\n    const high = Math.floor(len / 2 ** 32);\n    const low = len >>> 0;\n    header.push(127, (high >> 24) & 0xff, (high >> 16) & 0xff, (high >> 8) & 0xff, high & 0xff, (low >> 24) & 0xff, (low >> 16) & 0xff, (low >> 8) & 0xff, low & 0xff);\n  }\n  return Buffer.concat([Buffer.from(header), payloadBuffer]);\n}\n\nexport class GraphDashboardServer {\n  private readonly memoryDir: string;\n  private readonly host: string;\n  private readonly requestedPort: number;\n  private readonly publicDir: string;\n  private readonly watchDebounceMs: number;\n  private readonly authToken: string | null;\n  private server: ReturnType<typeof createServer> | null = null;\n  private watcher: FSWatcher | null = null;\n  private clients = new Map<string, WsClient>();\n  private graphSnapshot: GraphSnapshot = {\n    generatedAt: new Date(0).toISOString(),\n    nodes: [],\n    edges: [],\n    stats: { nodes: 0, edges: 0, malformedLines: 0, filesMissing: [] },\n  };\n  private debounceTimer: NodeJS.Timeout | null = null;\n  private lastError: string | null = null;\n  private boundPort = 0;\n\n  constructor(options: DashboardServerOptions) {\n    this.memoryDir = options.memoryDir;\n    this.host = options.host?.trim() || \"127.0.0.1\";\n    this.requestedPort = parseDashboardPort(options.port);\n    this.publicDir = options.publicDir ?? path.join(process.cwd(), \"dashboard\", \"public\");\n    this.watchDebounceMs = Math.max(50, Math.floor(options.watchDebounceMs ?? 300));\n    const authToken = options.authToken?.trim();\n    this.authToken = authToken && authToken.length > 0 ? authToken : null;\n  }\n\n  async start(): Promise<DashboardStatus> {\n    if (this.server) {\n      return this.status();\n    }\n    if (!isLoopbackBindHost(this.host) && !this.authToken) {\n      throw new Error(\"dashboard auth token is required when binding to a non-loopback host\");\n    }\n\n    await this.rebuildSnapshot();\n    const candidate = createServer((req, res) => {\n      void this.handleHttp(req, res);\n    });\n    candidate.on(\"upgrade\", (req, socket) => {\n      this.handleUpgrade(req, socket);\n    });\n    try {\n      await new Promise<void>((resolve, reject) => {\n        const onError = (err: Error) => {\n          candidate.off(\"listening\", onListening);\n          reject(err);\n        };\n        const onListening = () => {\n          candidate.off(\"error\", onError);\n          resolve();\n        };\n        candidate.once(\"error\", onError);\n        candidate.once(\"listening\", onListening);\n        candidate.listen(this.requestedPort, this.host);\n      });\n    } catch (err) {\n      this.lastError = err instanceof Error ? err.message : String(err);\n      try {\n        candidate.close();\n      } catch {\n        // no-op\n      }\n      throw err;\n    }\n    this.server = candidate;\n    const addr = candidate.address();\n    this.boundPort = typeof addr === \"object\" && addr ? addr.port : this.requestedPort;\n    this.startWatcher();\n    return this.status();\n  }\n\n  async stop(): Promise<void> {\n    const closeServer = this.server;\n    this.server = null;\n    this.boundPort = 0;\n\n    if (this.debounceTimer) {\n      clearTimeout(this.debounceTimer);\n      this.debounceTimer = null;\n    }\n    if (this.watcher) {\n      this.watcher.close();\n      this.watcher = null;\n    }\n    for (const client of this.clients.values()) {\n      try {\n        client.socket.destroy();\n      } catch {\n        // no-op\n      }\n    }\n    this.clients.clear();\n\n    if (closeServer) {\n      await new Promise<void>((resolve, reject) => {\n        closeServer.close((err) => {\n          if (err) reject(err);\n          else resolve();\n        });\n      });\n    }\n  }\n\n  status(): DashboardStatus {\n    return {\n      running: this.server !== null,\n      host: this.host,\n      port: this.boundPort,\n      watching: this.watcher !== null,\n      lastUpdatedAt: this.graphSnapshot.generatedAt,\n      graphNodeCount: this.graphSnapshot.stats.nodes,\n      graphEdgeCount: this.graphSnapshot.stats.edges,\n    };\n  }\n\n  private async handleHttp(req: IncomingMessage, res: ServerResponse): Promise<void> {\n    const url = req.url ?? \"/\";\n    if (req.method === \"GET\" && url === \"/api/health\") {\n      if (!this.authorizeHttpApi(req, res)) return;\n      this.respondJson(res, 200, {\n        ok: true,\n        running: this.server !== null,\n        watching: this.watcher !== null,\n        graph: this.graphSnapshot.stats,\n        clients: this.clients.size,\n        lastError: this.lastError ?? undefined,\n      });\n      return;\n    }\n    if (req.method === \"GET\" && url === \"/api/graph\") {\n      if (!this.authorizeHttpApi(req, res)) return;\n      this.respondJson(res, 200, this.graphSnapshot);\n      return;\n    }\n    if (req.method === \"GET\" && url === \"/app.js\") {\n      await this.respondStatic(res, path.join(this.publicDir, \"app.js\"), \"application/javascript; charset=utf-8\");\n      return;\n    }\n    if (req.method === \"GET\" && (url === \"/\" || url === \"/index.html\")) {\n      await this.respondStatic(res, path.join(this.publicDir, \"index.html\"), \"text/html; charset=utf-8\");\n      return;\n    }\n    this.respondJson(res, 404, { error: \"Not found\" });\n  }\n\n  private respondJson(res: ServerResponse, status: number, payload: unknown): void {\n    const body = JSON.stringify(payload, null, 2);\n    res.statusCode = status;\n    res.setHeader(\"content-type\", \"application/json; charset=utf-8\");\n    res.setHeader(\"content-length\", String(Buffer.byteLength(body)));\n    res.end(body);\n  }\n\n  private authorizeHttpApi(req: IncomingMessage, res: ServerResponse): boolean {\n    if (!this.authToken) return true;\n    const header = req.headers.authorization;\n    const value = Array.isArray(header) ? header[0] : header;\n    const prefix = \"Bearer \";\n    if (typeof value === \"string\" && value.startsWith(prefix)) {\n      const supplied = value.slice(prefix.length);\n      if (constantTimeEquals(supplied, this.authToken)) {\n        return true;\n      }\n    }\n    res.setHeader(\"www-authenticate\", \"Bearer\");\n    this.respondJson(res, 401, { error: \"Unauthorized\" });\n    return false;\n  }\n\n  private async respondStatic(res: ServerResponse, filePath: string, contentType: string): Promise<void> {\n    try {\n      const body = await readFile(filePath, \"utf-8\");\n      res.statusCode = 200;\n      res.setHeader(\"content-type\", contentType);\n      res.setHeader(\"content-length\", String(Buffer.byteLength(body)));\n      res.end(body);\n    } catch {\n      this.respondJson(res, 404, { error: \"Not found\" });\n    }\n  }\n\n  private handleUpgrade(req: IncomingMessage, socket: Duplex): void {\n    const upgrade = typeof req.headers.upgrade === \"string\" ? req.headers.upgrade.toLowerCase() : \"\";\n    const key = req.headers[\"sec-websocket-key\"];\n    const origin = typeof req.headers.origin === \"string\" ? req.headers.origin : \"\";\n    if (upgrade !== \"websocket\" || typeof key !== \"string\") {\n      socket.write(\"HTTP/1.1 400 Bad Request\\r\\n\\r\\n\");\n      socket.destroy();\n      return;\n    }\n    if (!this.isAllowedOrigin(origin)) {\n      socket.write(\"HTTP/1.1 403 Forbidden\\r\\n\\r\\n\");\n      socket.destroy();\n      return;\n    }\n    if (!this.authorizeWebSocketUpgrade(req)) {\n      socket.write(\"HTTP/1.1 401 Unauthorized\\r\\nWWW-Authenticate: Bearer\\r\\n\\r\\n\");\n      socket.destroy();\n      return;\n    }\n    const accept = websocketAcceptKey(key);\n    socket.write(\n      [\n        \"HTTP/1.1 101 Switching Protocols\",\n        \"Upgrade: websocket\",\n        \"Connection: Upgrade\",\n        `Sec-WebSocket-Accept: ${accept}`,\n        \"\",\n        \"\",\n      ].join(\"\\r\\n\"),\n    );\n    const id = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n    this.clients.set(id, { id, socket });\n    socket.on(\"close\", () => {\n      this.clients.delete(id);\n    });\n    socket.on(\"error\", () => {\n      this.clients.delete(id);\n    });\n\n    const hello = JSON.stringify({\n      type: \"hello\",\n      graph: this.graphSnapshot,\n    });\n    socket.write(encodeTextFrame(hello));\n  }\n\n  private isAllowedOrigin(origin: string): boolean {\n    if (!origin) return false;\n    try {\n      const parsed = new URL(origin);\n      const hostname = normalizeOriginHostname(parsed.hostname);\n      if (parsed.protocol !== \"http:\") return false;\n      const originPort = parsed.port ? Number(parsed.port) : 80;\n      if (!Number.isFinite(originPort) || originPort !== this.boundPort) return false;\n      if (LOOPBACK_HOSTS.has(hostname)) return true;\n      return this.authToken !== null;\n    } catch {\n      return false;\n    }\n  }\n\n  private authorizeWebSocketUpgrade(req: IncomingMessage): boolean {\n    if (!this.authToken) return true;\n    const supplied = this.webSocketTokenFromUrl(req.url) ?? this.webSocketTokenFromProtocol(req);\n    return typeof supplied === \"string\" && constantTimeEquals(supplied, this.authToken);\n  }\n\n  private webSocketTokenFromUrl(rawUrl: string | undefined): string | null {\n    if (!rawUrl) return null;\n    try {\n      const parsed = new URL(rawUrl, `http://${this.host}:${this.boundPort}`);\n      const token = parsed.searchParams.get(\"token\");\n      return token && token.length > 0 ? token : null;\n    } catch {\n      return null;\n    }\n  }\n\n  private webSocketTokenFromProtocol(req: IncomingMessage): string | null {\n    const raw = req.headers[\"sec-websocket-protocol\"];\n    const values = Array.isArray(raw) ? raw : typeof raw === \"string\" ? raw.split(\",\") : [];\n    for (const value of values) {\n      const trimmed = value.trim();\n      const prefix = \"remnic-token.\";\n      if (!trimmed.startsWith(prefix)) continue;\n      try {\n        return Buffer.from(trimmed.slice(prefix.length), \"base64url\").toString(\"utf8\");\n      } catch {\n        return null;\n      }\n    }\n    return null;\n  }\n\n  private broadcast(payload: unknown): void {\n    const frame = encodeTextFrame(JSON.stringify(payload));\n    for (const [id, client] of this.clients.entries()) {\n      try {\n        client.socket.write(frame);\n      } catch {\n        this.clients.delete(id);\n      }\n    }\n  }\n\n  private startWatcher(): void {\n    const graphDir = path.join(this.memoryDir, \"state\", \"graphs\");\n    try {\n      mkdirSync(graphDir, { recursive: true });\n      this.watcher = watch(graphDir, { persistent: false }, () => {\n        this.scheduleRebuild();\n      });\n      this.watcher.on(\"error\", (err) => {\n        this.lastError = err instanceof Error ? err.message : String(err);\n      });\n    } catch (err) {\n      this.lastError = err instanceof Error ? err.message : String(err);\n      this.watcher = null;\n    }\n  }\n\n  private scheduleRebuild(): void {\n    if (this.debounceTimer) clearTimeout(this.debounceTimer);\n    this.debounceTimer = setTimeout(() => {\n      this.debounceTimer = null;\n      void this.rebuildAndBroadcast();\n    }, this.watchDebounceMs);\n  }\n\n  private async rebuildAndBroadcast(): Promise<void> {\n    const previous = this.graphSnapshot;\n    await this.rebuildSnapshot();\n    const patch = diffGraphSnapshots(previous, this.graphSnapshot);\n    if (\n      patch.addedEdges.length === 0 &&\n      patch.removedEdges.length === 0 &&\n      patch.updatedEdges.length === 0 &&\n      patch.addedNodes.length === 0 &&\n      patch.removedNodes.length === 0\n    ) {\n      return;\n    }\n    this.broadcast({\n      type: \"graph_patch\",\n      generatedAt: new Date().toISOString(),\n      patch,\n      graph: this.graphSnapshot,\n    });\n  }\n\n  private async rebuildSnapshot(): Promise<void> {\n    try {\n      this.graphSnapshot = await graphSnapshotFromMemoryDir(this.memoryDir);\n      this.lastError = null;\n    } catch (err) {\n      this.lastError = err instanceof Error ? err.message : String(err);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-VLXA6PI2.js → chunk-YQMZ7IH2.js}

@@ -1,9 +1,9 @@
 import {
   topicOverlapScore
-} from "./chunk-NZL6GGQE.js";
+} from "./chunk-HQ6NIBL6.js";
 import {
   resolveCausalTrajectoryStoreDir
-} from "./chunk-MY6TPVXW.js";
+} from "./chunk-LMPHTYJC.js";
 import {
   countRecallTokenOverlap,
   normalizeRecallTokens
@@ -16,7 +16,7 @@ import {
   assertString,
   isRecord,
   recordStoreDay
-} from "./chunk-DGXUHMOV.js";
+} from "./chunk-A2IYSXDQ.js";
 import {
   listJsonFiles,
   readJsonFile
@@ -301,4 +301,4 @@ export {
   scoreStitchCandidate,
   stitchCausalChain
 };
-//# sourceMappingURL=chunk-VLXA6PI2.js.map
+//# sourceMappingURL=chunk-YQMZ7IH2.js.map

package/dist/{chunk-TMM4S4IJ.js → chunk-YR6GIWWY.js}

@@ -1,10 +1,6 @@
 import {
   compareVersions
 } from "./chunk-HL4DB7TO.js";
-import {
-  LEGACY_PLUGIN_ID,
-  PLUGIN_ID
-} from "./chunk-U66YHYC7.js";
 import {
   launchProcess
 } from "./chunk-NNVTUXEB.js";
@@ -14,6 +10,8 @@ import { access, readFile } from "fs/promises";
 import path from "path";
 var REQUIRED_HOOKS_LEGACY = ["before_agent_start", "agent_end"];
 var REQUIRED_HOOKS_NEW = ["before_prompt_build", "agent_end"];
+var OPENCLAW_REMNIC_PLUGIN_ID = "openclaw-remnic";
+var OPENCLAW_REMNIC_LEGACY_PLUGIN_ID = "openclaw-engram";
 function isSafeCommandToken(command) {
   return /^[a-zA-Z0-9._-]+$/.test(command);
 }
@@ -166,7 +164,59 @@ function parseHookRegistrations(source) {
   return hooks;
 }
 function hasServiceStartRegistration(source) {
-  return /api\.registerService\s*\(\s*\{[\s\S]*?\bstart\s*(?::|\()/m.test(source);
+  let i = 0;
+  while (i < source.length) {
+    const callIndex = source.indexOf("api.registerService", i);
+    if (callIndex === -1) return false;
+    if (callIndex > 0 && /[a-zA-Z0-9_$\.]/.test(source[callIndex - 1])) {
+      i = callIndex + 1;
+      continue;
+    }
+    let cursor = callIndex + "api.registerService".length;
+    while (cursor < source.length && /\s/.test(source[cursor])) cursor += 1;
+    if (source[cursor] !== "(") {
+      i = callIndex + 1;
+      continue;
+    }
+    cursor += 1;
+    while (cursor < source.length && /\s/.test(source[cursor])) cursor += 1;
+    if (source[cursor] !== "{") {
+      i = callIndex + 1;
+      continue;
+    }
+    if (objectLiteralHasTopLevelStart(source, cursor)) return true;
+    i = cursor + 1;
+  }
+  return false;
+}
+function objectLiteralHasTopLevelStart(source, objectStart) {
+  let depth = 0;
+  let i = objectStart;
+  while (i < source.length) {
+    const ch = source[i];
+    if (ch === "{") {
+      depth += 1;
+      i += 1;
+      continue;
+    }
+    if (ch === "}") {
+      depth -= 1;
+      if (depth === 0) return false;
+      i += 1;
+      continue;
+    }
+    if (depth === 1 && source.startsWith("start", i)) {
+      const before = source[i - 1];
+      const after = source[i + "start".length];
+      if ((!before || !/[a-zA-Z0-9_$]/.test(before)) && (!after || !/[a-zA-Z0-9_$]/.test(after))) {
+        let cursor = i + "start".length;
+        while (cursor < source.length && /\s/.test(source[cursor])) cursor += 1;
+        if (source[cursor] === ":" || source[cursor] === "(") return true;
+      }
+    }
+    i += 1;
+  }
+  return false;
 }
 function hasCliRegistration(source) {
   return /registerCli\s*\([^)]*\borchestrator\b[^)]*\)/m.test(source);
@@ -423,7 +473,7 @@ async function runCompatChecks(options) {
   if (pluginManifestPresent) {
     try {
       const plugin = JSON.parse(pluginRaw);
-      const isValidId = plugin.id === PLUGIN_ID || plugin.id === LEGACY_PLUGIN_ID;
+      const isValidId = plugin.id === OPENCLAW_REMNIC_PLUGIN_ID || plugin.id === OPENCLAW_REMNIC_LEGACY_PLUGIN_ID;
       if (isValidId && plugin.kind === "memory") {
         checks.push({
           id: "plugin-manifest-shape",
@@ -437,7 +487,7 @@ async function runCompatChecks(options) {
           title: "Plugin manifest ID and kind",
           level: "error",
           message: `Unexpected manifest values (id=${String(plugin.id)}, kind=${String(plugin.kind)})`,
-          remediation: `Set manifest id=${PLUGIN_ID} (or ${LEGACY_PLUGIN_ID} for the shim) and kind=memory.`
+          remediation: `Set manifest id=${OPENCLAW_REMNIC_PLUGIN_ID} (or ${OPENCLAW_REMNIC_LEGACY_PLUGIN_ID} for the shim) and kind=memory.`
         });
       }
     } catch {
@@ -594,4 +644,4 @@ async function runCompatChecks(options) {
 export {
   runCompatChecks
 };
-//# sourceMappingURL=chunk-TMM4S4IJ.js.map
+//# sourceMappingURL=chunk-YR6GIWWY.js.map

package/dist/chunk-YR6GIWWY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/compat/checks.ts"],"sourcesContent":["import { access, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { CompatCheckOptions, CompatCheckResult, CompatReport, CompatRunner } from \"./types.js\";\nimport { compareVersions } from \"../version-utils.js\";\nimport { launchProcess } from \"../runtime/child-process.js\";\n\nconst REQUIRED_HOOKS_LEGACY = [\"before_agent_start\", \"agent_end\"];\nconst REQUIRED_HOOKS_NEW = [\"before_prompt_build\", \"agent_end\"];\nconst OPENCLAW_REMNIC_PLUGIN_ID = \"openclaw-remnic\";\nconst OPENCLAW_REMNIC_LEGACY_PLUGIN_ID = \"openclaw-engram\";\n\nfunction isSafeCommandToken(command: string): boolean {\n  return /^[a-zA-Z0-9._-]+$/.test(command);\n}\n\nconst defaultRunner: CompatRunner = {\n  async commandExists(command: string): Promise<boolean> {\n    if (!isSafeCommandToken(command)) return false;\n    const binary = process.platform === \"win32\" ? \"where\" : \"which\";\n    const args = [command];\n    return new Promise<boolean>((resolve) => {\n      const child = launchProcess(binary, args, { stdio: \"ignore\" });\n      child.on(\"error\", () => resolve(false));\n      child.on(\"close\", (code) => resolve(code === 0));\n    });\n  },\n};\n\nfunction summarize(checks: CompatCheckResult[]): { ok: number; warn: number; error: number } {\n  const out = { ok: 0, warn: 0, error: 0 };\n  for (const check of checks) {\n    out[check.level] += 1;\n  }\n  return out;\n}\n\nfunction stripCommentsAndStrings(source: string): string {\n  const out: string[] = [];\n  let i = 0;\n  while (i < source.length) {\n    const ch = source[i];\n    const next = source[i + 1];\n\n    if (ch === \"/\" && next === \"/\") {\n      out.push(\" \", \" \");\n      i += 2;\n      while (i < source.length && source[i] !== \"\\n\") {\n        out.push(\" \");\n        i += 1;\n      }\n      continue;\n    }\n\n    if (ch === \"/\" && next === \"*\") {\n      out.push(\" \", \" \");\n      i += 2;\n      while (i < source.length) {\n        const c = source[i];\n        const n = source[i + 1];\n        out.push(c === \"\\n\" ? \"\\n\" : \" \");\n        i += 1;\n        if (c === \"*\" && n === \"/\") {\n          out.push(\" \");\n          i += 1;\n          break;\n        }\n      }\n      continue;\n    }\n\n    if (ch === '\"' || ch === \"'\" || ch === \"`\") {\n      const quote = ch;\n      out.push(\" \");\n      i += 1;\n      while (i < source.length) {\n        const c = source[i];\n        if (c === \"\\\\\") {\n          out.push(\" \");\n          i += 1;\n          if (i < source.length) {\n            out.push(source[i] === \"\\n\" ? \"\\n\" : \" \");\n            i += 1;\n          }\n          continue;\n        }\n        out.push(c === \"\\n\" ? \"\\n\" : \" \");\n        i += 1;\n        if (c === quote) break;\n      }\n      continue;\n    }\n\n    out.push(ch);\n    i += 1;\n  }\n  return out.join(\"\");\n}\n\nfunction parseHookRegistrations(source: string): Set<string> {\n  const hooks = new Set<string>();\n  let i = 0;\n\n  while (i < source.length) {\n    const ch = source[i];\n    const next = source[i + 1];\n\n    if (ch === \"/\" && next === \"/\") {\n      i += 2;\n      while (i < source.length && source[i] !== \"\\n\") i += 1;\n      continue;\n    }\n\n    if (ch === \"/\" && next === \"*\") {\n      i += 2;\n      while (i + 1 < source.length) {\n        if (source[i] === \"*\" && source[i + 1] === \"/\") {\n          i += 2;\n          break;\n        }\n        i += 1;\n      }\n      continue;\n    }\n\n    if (ch === '\"' || ch === \"'\" || ch === \"`\") {\n      const quote = ch;\n      i += 1;\n      while (i < source.length) {\n        if (source[i] === \"\\\\\") {\n          i += 2;\n          continue;\n        }\n        if (source[i] === quote) {\n          i += 1;\n          break;\n        }\n        i += 1;\n      }\n      continue;\n    }\n\n    if (source.startsWith(\"api.on\", i) && (i === 0 || !/[a-zA-Z0-9_$\\.]/.test(source[i - 1]))) {\n      let j = i + \"api.on\".length;\n      while (j < source.length && /\\s/.test(source[j])) j += 1;\n      if (source[j] !== \"(\") {\n        i += 1;\n        continue;\n      }\n\n      j += 1;\n      while (j < source.length && /\\s/.test(source[j])) j += 1;\n      const quote = source[j];\n      if (quote !== '\"' && quote !== \"'\") {\n        i += 1;\n        continue;\n      }\n\n      j += 1;\n      const start = j;\n      while (j < source.length && source[j] !== quote) {\n        if (source[j] === \"\\\\\") {\n          j += 2;\n        } else {\n          j += 1;\n        }\n      }\n      if (j < source.length) {\n        const hook = source.slice(start, j);\n        if (/^[a-z_]+$/.test(hook)) hooks.add(hook);\n        i = j + 1;\n        continue;\n      }\n    }\n\n    i += 1;\n  }\n\n  return hooks;\n}\n\nfunction hasServiceStartRegistration(source: string): boolean {\n  let i = 0;\n  while (i < source.length) {\n    const callIndex = source.indexOf(\"api.registerService\", i);\n    if (callIndex === -1) return false;\n    if (callIndex > 0 && /[a-zA-Z0-9_$\\.]/.test(source[callIndex - 1])) {\n      i = callIndex + 1;\n      continue;\n    }\n\n    let cursor = callIndex + \"api.registerService\".length;\n    while (cursor < source.length && /\\s/.test(source[cursor])) cursor += 1;\n    if (source[cursor] !== \"(\") {\n      i = callIndex + 1;\n      continue;\n    }\n\n    cursor += 1;\n    while (cursor < source.length && /\\s/.test(source[cursor])) cursor += 1;\n    if (source[cursor] !== \"{\") {\n      i = callIndex + 1;\n      continue;\n    }\n\n    if (objectLiteralHasTopLevelStart(source, cursor)) return true;\n    i = cursor + 1;\n  }\n  return false;\n}\n\nfunction objectLiteralHasTopLevelStart(source: string, objectStart: number): boolean {\n  let depth = 0;\n  let i = objectStart;\n  while (i < source.length) {\n    const ch = source[i];\n    if (ch === \"{\") {\n      depth += 1;\n      i += 1;\n      continue;\n    }\n    if (ch === \"}\") {\n      depth -= 1;\n      if (depth === 0) return false;\n      i += 1;\n      continue;\n    }\n    if (depth === 1 && source.startsWith(\"start\", i)) {\n      const before = source[i - 1];\n      const after = source[i + \"start\".length];\n      if (\n        (!before || !/[a-zA-Z0-9_$]/.test(before)) &&\n        (!after || !/[a-zA-Z0-9_$]/.test(after))\n      ) {\n        let cursor = i + \"start\".length;\n        while (cursor < source.length && /\\s/.test(source[cursor])) cursor += 1;\n        if (source[cursor] === \":\" || source[cursor] === \"(\") return true;\n      }\n    }\n    i += 1;\n  }\n  return false;\n}\n\nfunction hasCliRegistration(source: string): boolean {\n  return /registerCli\\s*\\([^)]*\\borchestrator\\b[^)]*\\)/m.test(source);\n}\n\nfunction parseCurrentNodeVersion(raw: string): [number, number, number] | null {\n  const normalized = raw.startsWith(\"v\") ? raw.slice(1) : raw;\n  const match = normalized.match(/^(\\d+)\\.(\\d+)\\.(\\d+)/);\n  if (!match) return null;\n  return [Number(match[1]), Number(match[2]), Number(match[3])];\n}\n\ntype NodeEngineEvaluation =\n  | { status: \"satisfied\" }\n  | { status: \"unsatisfied\" }\n  | { status: \"unsupported\"; reason: string };\n\ntype ComparatorOperator = \">\" | \">=\" | \"<\" | \"<=\" | \"=\";\n\ninterface ParsedRangeVersion {\n  version: [number, number, number];\n  specifiedParts: number;\n}\n\nfunction parseRangeVersion(raw: string): ParsedRangeVersion | null {\n  const match = raw.trim().match(/^v?(\\d+)(?:\\.(\\d+|x|\\*))?(?:\\.(\\d+|x|\\*))?$/i);\n  if (!match) return null;\n\n  const minor = match[2];\n  const patch = match[3];\n  if (minor && /^(x|\\*)$/i.test(minor)) {\n    return { version: [Number(match[1]), 0, 0], specifiedParts: 1 };\n  }\n  if (patch && /^(x|\\*)$/i.test(patch)) {\n    return {\n      version: [Number(match[1]), Number(minor ?? 0), 0],\n      specifiedParts: 2,\n    };\n  }\n\n  return {\n    version: [Number(match[1]), Number(minor ?? 0), Number(patch ?? 0)],\n    specifiedParts: patch ? 3 : minor ? 2 : 1,\n  };\n}\n\nfunction upperBoundForPartial(\n  parsed: ParsedRangeVersion,\n): [number, number, number] | null {\n  if (parsed.specifiedParts === 1) {\n    return [parsed.version[0] + 1, 0, 0];\n  }\n  if (parsed.specifiedParts === 2) {\n    return [parsed.version[0], parsed.version[1] + 1, 0];\n  }\n  return null;\n}\n\nfunction upperBoundForCaret(\n  parsed: ParsedRangeVersion,\n): [number, number, number] {\n  const [major, minor, patch] = parsed.version;\n  if (parsed.specifiedParts === 1) {\n    return [major + 1, 0, 0];\n  }\n  if (major > 0) return [major + 1, 0, 0];\n  if (parsed.specifiedParts === 2) {\n    return [0, minor + 1, 0];\n  }\n  if (minor > 0) return [0, minor + 1, 0];\n  return [0, 0, patch + 1];\n}\n\nfunction upperBoundForTilde(\n  parsed: ParsedRangeVersion,\n): [number, number, number] {\n  const [major, minor] = parsed.version;\n  if (parsed.specifiedParts === 1) {\n    return [major + 1, 0, 0];\n  }\n  return [major, minor + 1, 0];\n}\n\nfunction compareWithOperator(\n  current: [number, number, number],\n  operator: ComparatorOperator,\n  target: [number, number, number],\n): boolean {\n  const comparison = compareVersions(current, target);\n  switch (operator) {\n    case \">\":\n      return comparison > 0;\n    case \">=\":\n      return comparison >= 0;\n    case \"<\":\n      return comparison < 0;\n    case \"<=\":\n      return comparison <= 0;\n    case \"=\":\n      return comparison === 0;\n  }\n}\n\nfunction evaluateComparatorToken(\n  token: string,\n  current: [number, number, number],\n): NodeEngineEvaluation {\n  const trimmed = token.trim();\n  if (!trimmed || trimmed === \"*\" || /^x$/i.test(trimmed)) {\n    return { status: \"satisfied\" };\n  }\n\n  const shorthand = trimmed.match(/^([~^])\\s*(.+)$/);\n  if (shorthand) {\n    const parsed = parseRangeVersion(shorthand[2]);\n    if (!parsed) {\n      return {\n        status: \"unsupported\",\n        reason: `unsupported node engine comparator \"${trimmed}\"`,\n      };\n    }\n    const upper = shorthand[1] === \"^\"\n      ? upperBoundForCaret(parsed)\n      : upperBoundForTilde(parsed);\n    return compareWithOperator(current, \">=\", parsed.version)\n      && compareWithOperator(current, \"<\", upper)\n      ? { status: \"satisfied\" }\n      : { status: \"unsatisfied\" };\n  }\n\n  const comparator = trimmed.match(/^(>=|<=|>|<|=)?\\s*(.+)$/);\n  if (!comparator) {\n    return {\n      status: \"unsupported\",\n      reason: `unsupported node engine comparator \"${trimmed}\"`,\n    };\n  }\n  const operator = (comparator[1] ?? \"=\") as ComparatorOperator;\n  const parsed = parseRangeVersion(comparator[2]);\n  if (!parsed) {\n    return {\n      status: \"unsupported\",\n      reason: `unsupported node engine comparator \"${trimmed}\"`,\n    };\n  }\n\n  if (!comparator[1]) {\n    const upper = upperBoundForPartial(parsed);\n    if (upper) {\n      return compareWithOperator(current, \">=\", parsed.version)\n        && compareWithOperator(current, \"<\", upper)\n        ? { status: \"satisfied\" }\n        : { status: \"unsatisfied\" };\n    }\n  }\n\n  const partialUpper = upperBoundForPartial(parsed);\n  if (partialUpper) {\n    switch (operator) {\n      case \"=\":\n        return compareWithOperator(current, \">=\", parsed.version)\n          && compareWithOperator(current, \"<\", partialUpper)\n          ? { status: \"satisfied\" }\n          : { status: \"unsatisfied\" };\n      case \">=\":\n        return compareWithOperator(current, \">=\", parsed.version)\n          ? { status: \"satisfied\" }\n          : { status: \"unsatisfied\" };\n      case \">\":\n        return compareWithOperator(current, \">=\", partialUpper)\n          ? { status: \"satisfied\" }\n          : { status: \"unsatisfied\" };\n      case \"<=\":\n        return compareWithOperator(current, \"<\", partialUpper)\n          ? { status: \"satisfied\" }\n          : { status: \"unsatisfied\" };\n      case \"<\":\n        return compareWithOperator(current, \"<\", parsed.version)\n          ? { status: \"satisfied\" }\n          : { status: \"unsatisfied\" };\n    }\n  }\n\n  return compareWithOperator(current, operator, parsed.version)\n    ? { status: \"satisfied\" }\n    : { status: \"unsatisfied\" };\n}\n\nfunction tokenizeRangeAlternative(alternative: string): string[] {\n  const tokens: string[] = [];\n  let i = 0;\n\n  while (i < alternative.length) {\n    while (i < alternative.length && /\\s/.test(alternative[i])) i += 1;\n    if (i >= alternative.length) break;\n\n    let operator = \"\";\n    const ch = alternative[i];\n    if (ch === \">\" || ch === \"<\") {\n      operator = ch;\n      i += 1;\n      if (alternative[i] === \"=\") {\n        operator += \"=\";\n        i += 1;\n      }\n    } else if (ch === \"=\" || ch === \"^\" || ch === \"~\") {\n      operator = ch;\n      i += 1;\n    }\n\n    while (i < alternative.length && /\\s/.test(alternative[i])) i += 1;\n    const versionStart = i;\n    while (i < alternative.length && !/\\s/.test(alternative[i])) i += 1;\n    const version = alternative.slice(versionStart, i);\n    tokens.push(`${operator}${version}`);\n  }\n\n  return tokens;\n}\n\nfunction evaluateHyphenRange(\n  alternative: string,\n  current: [number, number, number],\n): NodeEngineEvaluation | null {\n  const match = alternative.match(/^(.+?)\\s+-\\s+(.+)$/);\n  if (!match) return null;\n\n  const lower = parseRangeVersion(match[1]);\n  const upper = parseRangeVersion(match[2]);\n  if (!lower || !upper) {\n    return {\n      status: \"unsupported\",\n      reason: `unsupported node engine hyphen range \"${alternative}\"`,\n    };\n  }\n\n  const lowerSatisfied = compareWithOperator(current, \">=\", lower.version);\n  const upperBound = upperBoundForPartial(upper);\n  const upperSatisfied = upperBound\n    ? compareWithOperator(current, \"<\", upperBound)\n    : compareWithOperator(current, \"<=\", upper.version);\n  return lowerSatisfied && upperSatisfied\n    ? { status: \"satisfied\" }\n    : { status: \"unsatisfied\" };\n}\n\nfunction evaluateNodeEngineRange(\n  rawRange: string | undefined,\n  currentVersion: [number, number, number],\n): NodeEngineEvaluation {\n  if (!rawRange || rawRange.trim().length === 0) {\n    return { status: \"unsupported\", reason: \"missing node engine range\" };\n  }\n\n  const alternatives = rawRange.split(\"||\").map((part) => part.trim()).filter(Boolean);\n  if (alternatives.length === 0) {\n    return { status: \"unsupported\", reason: \"missing node engine range\" };\n  }\n\n  let firstUnsupported: string | undefined;\n  let hasUnsatisfiedAlternative = false;\n  for (const alternative of alternatives) {\n    const hyphenResult = evaluateHyphenRange(alternative, currentVersion);\n    if (hyphenResult) {\n      if (hyphenResult.status === \"satisfied\") {\n        return { status: \"satisfied\" };\n      }\n      if (hyphenResult.status === \"unsupported\") {\n        firstUnsupported ??= hyphenResult.reason;\n      } else {\n        hasUnsatisfiedAlternative = true;\n      }\n      continue;\n    }\n\n    const tokens = tokenizeRangeAlternative(alternative).filter(Boolean);\n    if (tokens.length === 0) continue;\n    let alternativeSatisfied = true;\n    for (const token of tokens) {\n      const result = evaluateComparatorToken(token, currentVersion);\n      if (result.status === \"unsupported\") {\n        firstUnsupported ??= result.reason;\n        alternativeSatisfied = false;\n        break;\n      }\n      if (result.status === \"unsatisfied\") {\n        hasUnsatisfiedAlternative = true;\n        alternativeSatisfied = false;\n        break;\n      }\n    }\n    if (alternativeSatisfied) {\n      return { status: \"satisfied\" };\n    }\n  }\n\n  if (hasUnsatisfiedAlternative) {\n    return { status: \"unsatisfied\" };\n  }\n  if (firstUnsupported) {\n    return { status: \"unsupported\", reason: firstUnsupported };\n  }\n  return { status: \"unsatisfied\" };\n}\n\nfunction hasMemoryPromptSectionRegistration(source: string): boolean {\n  const apiReceiver = String.raw`(?:\\bapi|\\(\\s*api\\s*\\)|\\(\\s*api\\s+as\\s+[^)]+\\)|\\(\\s*<[^>]+>\\s*api\\s*\\))`;\n  return new RegExp(\n    `${apiReceiver}\\\\s*\\\\??\\\\.\\\\s*registerMemoryPromptSection\\\\s*(?:\\\\?\\\\.)?\\\\s*\\\\(`,\n  ).test(source);\n}\n\nexport async function runCompatChecks(options: CompatCheckOptions): Promise<CompatReport> {\n  const checks: CompatCheckResult[] = [];\n  const runner = options.runner ?? defaultRunner;\n  const pluginJsonPath = path.join(options.repoRoot, \"openclaw.plugin.json\");\n  const packageJsonPath = path.join(options.repoRoot, \"package.json\");\n  const indexPath = path.join(options.repoRoot, \"src\", \"index.ts\");\n\n  let pluginRaw = \"\";\n  let pluginManifestPresent = false;\n  try {\n    pluginRaw = await readFile(pluginJsonPath, \"utf-8\");\n    pluginManifestPresent = true;\n    checks.push({\n      id: \"plugin-manifest-present\",\n      title: \"Plugin manifest present\",\n      level: \"ok\",\n      message: \"Found openclaw.plugin.json\",\n    });\n  } catch {\n    checks.push({\n      id: \"plugin-manifest-present\",\n      title: \"Plugin manifest present\",\n      level: \"error\",\n      message: \"openclaw.plugin.json is missing\",\n      remediation: \"Restore openclaw.plugin.json at repo root with plugin metadata.\",\n    });\n  }\n\n  if (pluginManifestPresent) {\n    try {\n      const plugin = JSON.parse(pluginRaw) as { id?: string; kind?: string };\n      const isValidId = plugin.id === OPENCLAW_REMNIC_PLUGIN_ID || plugin.id === OPENCLAW_REMNIC_LEGACY_PLUGIN_ID;\n      if (isValidId && plugin.kind === \"memory\") {\n        checks.push({\n          id: \"plugin-manifest-shape\",\n          title: \"Plugin manifest ID and kind\",\n          level: \"ok\",\n          message: \"Plugin manifest id/kind match expected values.\",\n        });\n      } else {\n        checks.push({\n          id: \"plugin-manifest-shape\",\n          title: \"Plugin manifest ID and kind\",\n          level: \"error\",\n          message: `Unexpected manifest values (id=${String(plugin.id)}, kind=${String(plugin.kind)})`,\n          remediation: `Set manifest id=${OPENCLAW_REMNIC_PLUGIN_ID} (or ${OPENCLAW_REMNIC_LEGACY_PLUGIN_ID} for the shim) and kind=memory.`,\n        });\n      }\n    } catch {\n      checks.push({\n        id: \"plugin-manifest-shape\",\n        title: \"Plugin manifest ID and kind\",\n        level: \"error\",\n        message: \"openclaw.plugin.json is not valid JSON\",\n        remediation: \"Fix JSON syntax in openclaw.plugin.json.\",\n      });\n    }\n  }\n\n  let packageRaw = \"\";\n  let packageJsonPresent = false;\n  try {\n    packageRaw = await readFile(packageJsonPath, \"utf-8\");\n    packageJsonPresent = true;\n  } catch {\n    checks.push({\n      id: \"package-json-present\",\n      title: \"package.json present\",\n      level: \"error\",\n      message: \"package.json is missing\",\n      remediation: \"Restore package.json at repo root.\",\n    });\n  }\n\n  if (packageJsonPresent) {\n    try {\n      const pkg = JSON.parse(packageRaw) as {\n        openclaw?: { plugin?: string; extensions?: string[] };\n        engines?: { node?: string };\n      };\n      const pluginPathOk = pkg.openclaw?.plugin === \"./openclaw.plugin.json\";\n      const extOk = Array.isArray(pkg.openclaw?.extensions)\n        && pkg.openclaw?.extensions.includes(\"./dist/index.js\");\n      if (pluginPathOk && extOk) {\n        checks.push({\n          id: \"package-openclaw-exports\",\n          title: \"package.json OpenClaw export wiring\",\n          level: \"ok\",\n          message: \"package.json openclaw.plugin/extensions wiring looks valid.\",\n        });\n      } else {\n        checks.push({\n          id: \"package-openclaw-exports\",\n          title: \"package.json OpenClaw export wiring\",\n          level: \"error\",\n          message: \"package.json openclaw plugin/extension wiring is missing or invalid.\",\n          remediation: \"Set openclaw.plugin to ./openclaw.plugin.json and include ./dist/index.js in openclaw.extensions.\",\n        });\n      }\n\n      const currentNode = options.currentNodeVersion ?? process.version;\n      const currentVersion = parseCurrentNodeVersion(currentNode);\n      const engineEvaluation: NodeEngineEvaluation = currentVersion\n        ? evaluateNodeEngineRange(pkg.engines?.node, currentVersion)\n        : { status: \"unsupported\", reason: \"unable to parse current Node version\" };\n      if (engineEvaluation.status === \"unsupported\") {\n        checks.push({\n          id: \"node-version-compat\",\n          title: \"Node runtime compatibility\",\n          level: \"warn\",\n          message: `Unable to evaluate node engine/current version: ${engineEvaluation.reason}.`,\n          remediation: \"Confirm Node version meets package.json engines.node requirement.\",\n          metadata: { enginesNode: pkg.engines?.node, currentNode },\n        });\n      } else if (engineEvaluation.status === \"satisfied\") {\n        checks.push({\n          id: \"node-version-compat\",\n          title: \"Node runtime compatibility\",\n          level: \"ok\",\n          message: `Current Node ${currentNode} satisfies engines requirement ${pkg.engines?.node}.`,\n        });\n      } else {\n        checks.push({\n          id: \"node-version-compat\",\n          title: \"Node runtime compatibility\",\n          level: \"error\",\n          message: `Current Node ${currentNode} does not satisfy engines requirement ${pkg.engines?.node}.`,\n          remediation: \"Upgrade Node runtime to meet package.json engines.node minimum.\",\n        });\n      }\n    } catch {\n      checks.push({\n        id: \"package-json-parse\",\n        title: \"package.json parse\",\n        level: \"error\",\n        message: \"package.json is not valid JSON\",\n        remediation: \"Fix JSON syntax in package.json.\",\n      });\n    }\n  }\n\n  try {\n    await access(indexPath);\n    const indexRaw = await readFile(indexPath, \"utf-8\");\n    const structuralSource = stripCommentsAndStrings(indexRaw);\n    const hooks = parseHookRegistrations(indexRaw);\n    const missingLegacy = REQUIRED_HOOKS_LEGACY.filter((hook) => !hooks.has(hook));\n    const missingNew = REQUIRED_HOOKS_NEW.filter((hook) => !hooks.has(hook));\n    // registerMemoryPromptSection is a valid alternative to the recall hook only\n    // when it is registered on the OpenClaw plugin API object.\n    const hasMemoryPromptSection = hasMemoryPromptSectionRegistration(structuralSource);\n    const missingLegacyAdj = hasMemoryPromptSection\n      ? missingLegacy.filter((h) => h !== \"before_agent_start\")\n      : missingLegacy;\n    const missingNewAdj = hasMemoryPromptSection\n      ? missingNew.filter((h) => h !== \"before_prompt_build\")\n      : missingNew;\n    // Accept whichever hook set has fewer missing entries\n    const missingHooks = missingNewAdj.length <= missingLegacyAdj.length ? missingNewAdj : missingLegacyAdj;\n    const hasGatewayStartHook = hooks.has(\"gateway_start\");\n    const hasServiceStart = hasServiceStartRegistration(structuralSource);\n    if (missingHooks.length === 0 && (hasGatewayStartHook || hasServiceStart)) {\n      checks.push({\n        id: \"hook-registration-core\",\n        title: \"Core hook registration\",\n        level: \"ok\",\n        message: \"Core recall/extraction hooks and startup wiring are registered in src/index.ts.\",\n      });\n    } else {\n      const missingParts: string[] = [];\n      if (missingHooks.length > 0) {\n        missingParts.push(`hooks: ${missingHooks.join(\", \")}`);\n      }\n      if (!hasGatewayStartHook && !hasServiceStart) {\n        missingParts.push(\"startup wiring: gateway_start hook or api.registerService({ start })\");\n      }\n      checks.push({\n        id: \"hook-registration-core\",\n        title: \"Core hook registration\",\n        level: \"error\",\n        message: `Missing expected registration(s): ${missingParts.join(\"; \")}`,\n        remediation: \"Ensure src/index.ts registers before_prompt_build (or before_agent_start) and agent_end, plus either gateway_start or api.registerService({ start }).\",\n      });\n    }\n\n    const cliWired = hasCliRegistration(structuralSource);\n    checks.push({\n      id: \"cli-registration\",\n      title: \"CLI registration wiring\",\n      level: cliWired ? \"ok\" : \"warn\",\n      message: cliWired\n        ? \"CLI registration is wired in plugin bootstrap.\"\n        : \"CLI registration call not found in src/index.ts.\",\n      remediation: cliWired ? undefined : \"Call registerCli(api, orchestrator) during plugin registration.\",\n    });\n  } catch {\n    checks.push({\n      id: \"hook-registration-core\",\n      title: \"Core hook registration\",\n      level: \"error\",\n      message: \"src/index.ts is missing; cannot validate hook wiring.\",\n      remediation: \"Restore src/index.ts and register required hooks.\",\n    });\n  }\n\n  const qmdAvailable = await runner.commandExists(\"qmd\");\n  checks.push({\n    id: \"qmd-binary-availability\",\n    title: \"QMD binary availability\",\n    level: qmdAvailable ? \"ok\" : \"warn\",\n    message: qmdAvailable\n      ? \"qmd binary is available in PATH.\"\n      : \"qmd binary is not available in PATH.\",\n    remediation: qmdAvailable ? undefined : \"Install qmd or configure qmdPath in plugin config.\",\n  });\n\n  return {\n    generatedAt: (options.now ?? new Date()).toISOString(),\n    checks,\n    summary: summarize(checks),\n  };\n}\n"],"mappings":"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","names":["parsed"]}

package/dist/{chunk-DK5LDEQM.js → chunk-YR7XMOWK.js}

@@ -2,11 +2,11 @@ import {
   computeMemoryContentHash,
   computePairId,
   isCoolingDown,
-  listPairs,
   memoryHashesChanged,
   migrateUnscopedPairsToNamespace,
+  readPair,
   writePairs
-} from "./chunk-APO3DCMU.js";
+} from "./chunk-HLAVGJ62.js";
 import {
   extractJsonCandidates
 } from "./chunk-UZB5KHKX.js";
@@ -43,10 +43,14 @@ function pairKey(idA, idB) {
 }
 function contentHash(a) {
   const sides = [
-    [a.textA.trim(), (a.categoryA ?? "").trim()].join("|"),
-    [a.textB.trim(), (a.categoryB ?? "").trim()].join("|")
-  ].sort();
-  const normalized = sides.join("|||");
+    { text: a.textA.trim(), category: (a.categoryA ?? "").trim() },
+    { text: a.textB.trim(), category: (a.categoryB ?? "").trim() }
+  ].sort((left, right) => {
+    const leftKey = JSON.stringify(left);
+    const rightKey = JSON.stringify(right);
+    return leftKey.localeCompare(rightKey);
+  });
+  const normalized = JSON.stringify(sides);
   return createHash("sha256").update(normalized).digest("hex").slice(0, 16);
 }
 function createVerdictCache() {
@@ -159,6 +163,7 @@ async function callLlm(client, config, userMessage) {
 }
 function parseJudgeResponse(candidates, inputs) {
   const VALID_VERDICTS = ["contradicts", "independent", "duplicates", "needs-user"];
+  let conservativeFallback = null;
   for (const candidate of candidates) {
     try {
       const parsed = JSON.parse(candidate);
@@ -193,11 +198,15 @@ function parseJudgeResponse(candidates, inputs) {
           });
         }
       }
-      if (results.length > 0) return results;
+      if (matchedKeys.size > 0) return results;
+      if (results.length > 0 && conservativeFallback === null) {
+        conservativeFallback = results;
+      }
     } catch {
       continue;
     }
   }
+  if (conservativeFallback !== null) return conservativeFallback;
   return inputs.map((p) => ({
     memoryIdA: p.memoryIdA,
     memoryIdB: p.memoryIdB,
@@ -239,12 +248,14 @@ async function runContradictionScan(deps) {
   if (memories.length < 2) {
     return { scanned: memories.length, candidates: 0, judged: 0, queued: 0, cooledDown: 0, elapsedMs: Date.now() - startTime };
   }
-  const existingPairs = listPairs(memoryDir, { filter: "all", namespace, limit: 1e4 }).pairs;
-  const existingMap = /* @__PURE__ */ new Map();
-  for (const p of existingPairs) {
-    existingMap.set(p.pairId, p);
-  }
-  const candidates = await generatePairs(memories, existingMap, scanConfig, namespace, scopedEmbeddingLookup);
+  const existingPairCache = /* @__PURE__ */ new Map();
+  const getExistingPair = (pairId) => {
+    if (!existingPairCache.has(pairId)) {
+      existingPairCache.set(pairId, readPair(memoryDir, pairId) ?? void 0);
+    }
+    return existingPairCache.get(pairId);
+  };
+  const candidates = await generatePairs(memories, getExistingPair, scanConfig, namespace, scopedEmbeddingLookup);
   const cooledDown = candidates.skipped;
   log.info("[contradiction-scan] generated %d candidates (%d cooled down)", candidates.pairs.length, cooledDown);
   if (candidates.pairs.length === 0) {
@@ -295,7 +306,7 @@ async function runContradictionScan(deps) {
     elapsedMs: elapsed
   };
 }
-async function generatePairs(memories, existingPairs, scanConfig, namespace, embeddingLookup) {
+async function generatePairs(memories, getExistingPair, scanConfig, namespace, embeddingLookup) {
   const pairs = [];
   let skipped = 0;
   const seen = /* @__PURE__ */ new Set();
@@ -332,7 +343,7 @@ async function generatePairs(memories, existingPairs, scanConfig, namespace, emb
           const pairId = computePairId(a.frontmatter.id, b.frontmatter.id, namespace);
           if (seen.has(pairId)) continue;
           seen.add(pairId);
-          const existing = existingPairs.get(pairId);
+          const existing = getExistingPair(pairId);
           if (isSkippedByCooldown(existing)) {
             skipped++;
             continue;
@@ -348,13 +359,13 @@ async function generatePairs(memories, existingPairs, scanConfig, namespace, emb
         }
       }
     }
-  const noEntity = orderedMemories.filter((m) => !m.frontmatter.entityRef);
   topicPairs:
-    for (let i = 0; i < noEntity.length; i++) {
-      for (let j = i + 1; j < noEntity.length; j++) {
+    for (let i = 0; i < orderedMemories.length; i++) {
+      for (let j = i + 1; j < orderedMemories.length; j++) {
         if (!hasCapacity()) break topicPairs;
-        const a = noEntity[i];
-        const b = noEntity[j];
+        const a = orderedMemories[i];
+        const b = orderedMemories[j];
+        if (shareEntityRef(a, b)) continue;
         const overlap = jaccardOverlap(
           a.frontmatter.tags ?? [],
           b.frontmatter.tags ?? []
@@ -363,7 +374,7 @@ async function generatePairs(memories, existingPairs, scanConfig, namespace, emb
         const pairId = computePairId(a.frontmatter.id, b.frontmatter.id, namespace);
         if (seen.has(pairId)) continue;
         seen.add(pairId);
-        const existing = existingPairs.get(pairId);
+        const existing = getExistingPair(pairId);
         if (isSkippedByCooldown(existing)) {
           skipped++;
           continue;
@@ -397,7 +408,7 @@ async function generatePairs(memories, existingPairs, scanConfig, namespace, emb
             const pairId = computePairId(id, hit.id, namespace);
             if (seen.has(pairId)) continue;
             seen.add(pairId);
-            const existing = existingPairs.get(pairId);
+            const existing = getExistingPair(pairId);
             if (isSkippedByCooldown(existing)) {
               skipped++;
               continue;
@@ -497,6 +508,11 @@ function jaccardOverlap(a, b) {
   const union = setA.size + setB.size - intersection;
   return union === 0 ? 0 : intersection / union;
 }
+function shareEntityRef(a, b) {
+  const entityA = a.frontmatter.entityRef?.trim();
+  const entityB = b.frontmatter.entityRef?.trim();
+  return Boolean(entityA && entityB && entityA === entityB);
+}
 function compareMemoryId(a, b) {
   return (a.frontmatter.id ?? "").localeCompare(b.frontmatter.id ?? "");
 }
@@ -527,4 +543,4 @@ export {
   ACTIVE_STATUSES,
   runContradictionScan
 };
-//# sourceMappingURL=chunk-DK5LDEQM.js.map
+//# sourceMappingURL=chunk-YR7XMOWK.js.map