@joshuaswarren/openclaw-engram 9.0.92 → 9.0.94

package/bin/engram-access.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import("../dist/access-cli.js")
+  .then(({ runCli }) => runCli(process.argv.slice(2)))
+  .catch((error) => {
+    const message = error instanceof Error ? error.message : "unknown load error";
+    console.error(`access-cli failed to load dist/access-cli.js: ${message}`);
+    process.exit(1);
+  });

package/dist/access-cli.js

@@ -0,0 +1,219 @@
+// openclaw-engram: Local-first memory plugin
+import {
+  EngramAccessService,
+  Orchestrator,
+  parseConfig
+} from "./chunk-AHYRVKIJ.js";
+import "./chunk-R2BJ47PU.js";
+import "./chunk-WSXU2GHQ.js";
+import "./chunk-H7LMMCVZ.js";
+import "./chunk-BNBG2XP6.js";
+import "./chunk-AFMNQR7H.js";
+import "./chunk-PW5V7OJH.js";
+import "./chunk-DEIBZP3O.js";
+import "./chunk-SSIIJJKA.js";
+
+// src/access-cli.ts
+import fs from "fs";
+import os from "os";
+import path from "path";
+var UsageError = class extends Error {
+  constructor(kind, optionName) {
+    super("invalid access-cli arguments");
+    this.kind = kind;
+    this.optionName = optionName;
+  }
+};
+function formatUsageError(error) {
+  switch (error.kind) {
+    case "unsupported-command":
+      return "unsupported command";
+    case "unexpected-positional":
+      return "unexpected positional argument";
+    case "missing-option":
+      return `missing required option: --${error.optionName ?? "unknown"}`;
+    case "missing-content":
+      return "missing required option: --content or --content-file";
+    case "invalid-integer":
+      return `invalid integer for --${error.optionName ?? "unknown"}`;
+    case "invalid-number":
+      return `invalid number for --${error.optionName ?? "unknown"}`;
+  }
+}
+function writeCliOutput(text = "") {
+  process.stdout.write(`${text}
+`);
+}
+function usage() {
+  return [
+    "Usage:",
+    "  engram-access browse [options]",
+    "  engram-access store [options]",
+    "",
+    "Browse options:",
+    "  --namespace <name>",
+    "  --query <text>",
+    "  --category <name>",
+    "  --status <name>",
+    "  --sort <updated_desc|updated_asc|created_desc|created_asc>",
+    "  --limit <n>",
+    "  --offset <n>",
+    "",
+    "Store options:",
+    "  --namespace <name>",
+    "  --session-key <key>",
+    "  --principal <principal>",
+    "  --content <text> | --content-file <path>",
+    "  --category <name>",
+    "  --confidence <0-1>",
+    "  --tag <tag> (repeatable)",
+    "  --entity-ref <ref>",
+    "  --ttl <duration>",
+    "  --source-reason <text>",
+    "  --idempotency-key <key>",
+    "  --dry-run"
+  ].join("\n");
+}
+function parseArgs(argv) {
+  const [commandRaw, ...rest] = argv;
+  if (commandRaw !== "browse" && commandRaw !== "store") {
+    throw new UsageError("unsupported-command");
+  }
+  const options = {};
+  const flags = /* @__PURE__ */ new Set();
+  for (let i = 0; i < rest.length; i += 1) {
+    const token = rest[i];
+    if (!token.startsWith("--")) {
+      throw new UsageError("unexpected-positional");
+    }
+    const key = token.slice(2);
+    const next = rest[i + 1];
+    if (!next || next.startsWith("--")) {
+      flags.add(key);
+      continue;
+    }
+    if (!options[key]) {
+      options[key] = [];
+    }
+    options[key].push(next);
+    i += 1;
+  }
+  return {
+    command: commandRaw,
+    options,
+    flags
+  };
+}
+function getLastOption(args, name) {
+  const values = args.options[name];
+  if (!values || values.length === 0) return void 0;
+  return values[values.length - 1];
+}
+function getAllOptions(args, name) {
+  return args.options[name] ?? [];
+}
+function requireOption(args, name) {
+  const value = getLastOption(args, name);
+  if (!value || value.trim().length === 0) {
+    throw new UsageError("missing-option", name);
+  }
+  return value;
+}
+function parseIntegerOption(args, name) {
+  const raw = getLastOption(args, name);
+  if (!raw) return void 0;
+  const value = parseInt(raw, 10);
+  if (!Number.isFinite(value)) {
+    throw new UsageError("invalid-integer", name);
+  }
+  return value;
+}
+function parseFloatOption(args, name) {
+  const raw = getLastOption(args, name);
+  if (!raw) return void 0;
+  const value = Number.parseFloat(raw);
+  if (!Number.isFinite(value)) {
+    throw new UsageError("invalid-number", name);
+  }
+  return value;
+}
+function loadPluginConfig() {
+  const configPath = process.env.OPENCLAW_ENGRAM_CONFIG_PATH || process.env.OPENCLAW_CONFIG_PATH || path.join(process.env.HOME ?? os.homedir(), ".openclaw", "openclaw.json");
+  const raw = JSON.parse(fs.readFileSync(configPath, "utf8"));
+  return raw?.plugins?.entries?.["openclaw-engram"]?.config ?? {};
+}
+function buildRuntime() {
+  const config = parseConfig(loadPluginConfig());
+  return {
+    config,
+    service: new EngramAccessService(new Orchestrator(config))
+  };
+}
+async function runBrowse(args) {
+  const { service } = buildRuntime();
+  const result = await service.memoryBrowse({
+    namespace: getLastOption(args, "namespace"),
+    query: getLastOption(args, "query"),
+    category: getLastOption(args, "category"),
+    status: getLastOption(args, "status"),
+    sort: getLastOption(args, "sort"),
+    limit: parseIntegerOption(args, "limit"),
+    offset: parseIntegerOption(args, "offset")
+  });
+  console.log(JSON.stringify(result, null, 2));
+}
+async function runStore(args) {
+  const { config, service } = buildRuntime();
+  const contentFile = getLastOption(args, "content-file");
+  const inlineContent = getLastOption(args, "content");
+  const content = contentFile ? fs.readFileSync(contentFile, "utf8") : inlineContent;
+  if (!content || content.trim().length === 0) {
+    throw new UsageError("missing-content");
+  }
+  const result = await service.memoryStore({
+    namespace: getLastOption(args, "namespace"),
+    sessionKey: getLastOption(args, "session-key"),
+    authenticatedPrincipal: getLastOption(args, "principal") ?? config.agentAccessHttp.principal,
+    content,
+    category: requireOption(args, "category"),
+    confidence: parseFloatOption(args, "confidence"),
+    tags: getAllOptions(args, "tag"),
+    entityRef: getLastOption(args, "entity-ref"),
+    ttl: getLastOption(args, "ttl"),
+    sourceReason: getLastOption(args, "source-reason"),
+    idempotencyKey: getLastOption(args, "idempotency-key"),
+    dryRun: args.flags.has("dry-run")
+  });
+  console.log(JSON.stringify(result, null, 2));
+}
+async function main(argv = process.argv.slice(2)) {
+  const args = parseArgs(argv);
+  if (args.command === "browse") {
+    await runBrowse(args);
+    return;
+  }
+  await runStore(args);
+}
+function printUsage() {
+  writeCliOutput(usage());
+}
+async function runCli(argv = process.argv.slice(2)) {
+  try {
+    await main(argv);
+  } catch (error) {
+    if (error instanceof UsageError) {
+      writeCliOutput(formatUsageError(error));
+      writeCliOutput();
+      printUsage();
+      process.exit(1);
+    }
+    console.error("access-cli failed");
+    process.exit(1);
+  }
+}
+export {
+  main,
+  printUsage,
+  runCli
+};
+//# sourceMappingURL=access-cli.js.map

package/dist/access-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/access-cli.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { parseConfig } from \"./config.js\";\nimport type { PluginConfig } from \"./types.js\";\nimport { Orchestrator } from \"./orchestrator.js\";\nimport { EngramAccessService } from \"./access-service.js\";\n\ntype CommandName = \"browse\" | \"store\";\n\ntype ParsedArgs = {\n  command: CommandName;\n  options: Record<string, string[]>;\n  flags: Set<string>;\n};\n\ntype Runtime = {\n  config: PluginConfig;\n  service: EngramAccessService;\n};\n\ntype UsageErrorKind =\n  | \"unsupported-command\"\n  | \"unexpected-positional\"\n  | \"missing-option\"\n  | \"missing-content\"\n  | \"invalid-integer\"\n  | \"invalid-number\";\n\nclass UsageError extends Error {\n  constructor(\n    readonly kind: UsageErrorKind,\n    readonly optionName?: string,\n  ) {\n    super(\"invalid access-cli arguments\");\n  }\n}\n\nfunction formatUsageError(error: UsageError): string {\n  switch (error.kind) {\n    case \"unsupported-command\":\n      return \"unsupported command\";\n    case \"unexpected-positional\":\n      return \"unexpected positional argument\";\n    case \"missing-option\":\n      return `missing required option: --${error.optionName ?? \"unknown\"}`;\n    case \"missing-content\":\n      return \"missing required option: --content or --content-file\";\n    case \"invalid-integer\":\n      return `invalid integer for --${error.optionName ?? \"unknown\"}`;\n    case \"invalid-number\":\n      return `invalid number for --${error.optionName ?? \"unknown\"}`;\n  }\n}\n\nfunction writeCliOutput(text: string = \"\"): void {\n  process.stdout.write(`${text}\\n`);\n}\n\nfunction usage(): string {\n  return [\n    \"Usage:\",\n    \"  engram-access browse [options]\",\n    \"  engram-access store [options]\",\n    \"\",\n    \"Browse options:\",\n    \"  --namespace <name>\",\n    \"  --query <text>\",\n    \"  --category <name>\",\n    \"  --status <name>\",\n    \"  --sort <updated_desc|updated_asc|created_desc|created_asc>\",\n    \"  --limit <n>\",\n    \"  --offset <n>\",\n    \"\",\n    \"Store options:\",\n    \"  --namespace <name>\",\n    \"  --session-key <key>\",\n    \"  --principal <principal>\",\n    \"  --content <text> | --content-file <path>\",\n    \"  --category <name>\",\n    \"  --confidence <0-1>\",\n    \"  --tag <tag> (repeatable)\",\n    \"  --entity-ref <ref>\",\n    \"  --ttl <duration>\",\n    \"  --source-reason <text>\",\n    \"  --idempotency-key <key>\",\n    \"  --dry-run\",\n  ].join(\"\\n\");\n}\n\nfunction parseArgs(argv: string[]): ParsedArgs {\n  const [commandRaw, ...rest] = argv;\n  if (commandRaw !== \"browse\" && commandRaw !== \"store\") {\n    throw new UsageError(\"unsupported-command\");\n  }\n\n  const options: Record<string, string[]> = {};\n  const flags = new Set<string>();\n\n  for (let i = 0; i < rest.length; i += 1) {\n    const token = rest[i];\n    if (!token.startsWith(\"--\")) {\n      throw new UsageError(\"unexpected-positional\");\n    }\n    const key = token.slice(2);\n    const next = rest[i + 1];\n    if (!next || next.startsWith(\"--\")) {\n      flags.add(key);\n      continue;\n    }\n    if (!options[key]) {\n      options[key] = [];\n    }\n    options[key].push(next);\n    i += 1;\n  }\n\n  return {\n    command: commandRaw,\n    options,\n    flags,\n  };\n}\n\nfunction getLastOption(args: ParsedArgs, name: string): string | undefined {\n  const values = args.options[name];\n  if (!values || values.length === 0) return undefined;\n  return values[values.length - 1];\n}\n\nfunction getAllOptions(args: ParsedArgs, name: string): string[] {\n  return args.options[name] ?? [];\n}\n\nfunction requireOption(args: ParsedArgs, name: string): string {\n  const value = getLastOption(args, name);\n  if (!value || value.trim().length === 0) {\n    throw new UsageError(\"missing-option\", name);\n  }\n  return value;\n}\n\nfunction parseIntegerOption(args: ParsedArgs, name: string): number | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  const value = parseInt(raw, 10);\n  if (!Number.isFinite(value)) {\n    throw new UsageError(\"invalid-integer\", name);\n  }\n  return value;\n}\n\nfunction parseFloatOption(args: ParsedArgs, name: string): number | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  const value = Number.parseFloat(raw);\n  if (!Number.isFinite(value)) {\n    throw new UsageError(\"invalid-number\", name);\n  }\n  return value;\n}\n\nfunction loadPluginConfig(): Record<string, unknown> {\n  const configPath =\n    process.env.OPENCLAW_ENGRAM_CONFIG_PATH ||\n    process.env.OPENCLAW_CONFIG_PATH ||\n    path.join(process.env.HOME ?? os.homedir(), \".openclaw\", \"openclaw.json\");\n  const raw = JSON.parse(fs.readFileSync(configPath, \"utf8\"));\n  return raw?.plugins?.entries?.[\"openclaw-engram\"]?.config ?? {};\n}\n\nfunction buildRuntime(): Runtime {\n  const config = parseConfig(loadPluginConfig());\n  return {\n    config,\n    service: new EngramAccessService(new Orchestrator(config)),\n  };\n}\n\nasync function runBrowse(args: ParsedArgs): Promise<void> {\n  const { service } = buildRuntime();\n  const result = await service.memoryBrowse({\n    namespace: getLastOption(args, \"namespace\"),\n    query: getLastOption(args, \"query\"),\n    category: getLastOption(args, \"category\"),\n    status: getLastOption(args, \"status\"),\n    sort: getLastOption(args, \"sort\") as \"updated_desc\" | \"updated_asc\" | \"created_desc\" | \"created_asc\" | undefined,\n    limit: parseIntegerOption(args, \"limit\"),\n    offset: parseIntegerOption(args, \"offset\"),\n  });\n  console.log(JSON.stringify(result, null, 2));\n}\n\nasync function runStore(args: ParsedArgs): Promise<void> {\n  const { config, service } = buildRuntime();\n  const contentFile = getLastOption(args, \"content-file\");\n  const inlineContent = getLastOption(args, \"content\");\n  const content = contentFile ? fs.readFileSync(contentFile, \"utf8\") : inlineContent;\n  if (!content || content.trim().length === 0) {\n    throw new UsageError(\"missing-content\");\n  }\n\n  const result = await service.memoryStore({\n    namespace: getLastOption(args, \"namespace\"),\n    sessionKey: getLastOption(args, \"session-key\"),\n    authenticatedPrincipal: getLastOption(args, \"principal\") ?? config.agentAccessHttp.principal,\n    content,\n    category: requireOption(args, \"category\"),\n    confidence: parseFloatOption(args, \"confidence\"),\n    tags: getAllOptions(args, \"tag\"),\n    entityRef: getLastOption(args, \"entity-ref\"),\n    ttl: getLastOption(args, \"ttl\"),\n    sourceReason: getLastOption(args, \"source-reason\"),\n    idempotencyKey: getLastOption(args, \"idempotency-key\"),\n    dryRun: args.flags.has(\"dry-run\"),\n  });\n  console.log(JSON.stringify(result, null, 2));\n}\n\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<void> {\n  const args = parseArgs(argv);\n  if (args.command === \"browse\") {\n    await runBrowse(args);\n    return;\n  }\n  await runStore(args);\n}\n\nexport function printUsage(): void {\n  writeCliOutput(usage());\n}\n\nexport async function runCli(argv: string[] = process.argv.slice(2)): Promise<void> {\n  try {\n    await main(argv);\n  } catch (error) {\n    if (error instanceof UsageError) {\n      writeCliOutput(formatUsageError(error));\n      writeCliOutput();\n      printUsage();\n      process.exit(1);\n    }\n\n    console.error(\"access-cli failed\");\n    process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/calibration-TLGCHI7D.js

@@ -0,0 +1,236 @@
+// openclaw-engram: Local-first memory plugin
+import {
+  FallbackLlmClient
+} from "./chunk-PW5V7OJH.js";
+import {
+  listJsonFiles
+} from "./chunk-DEIBZP3O.js";
+import {
+  log
+} from "./chunk-SSIIJJKA.js";
+
+// src/calibration.ts
+import { createHash } from "crypto";
+import path from "path";
+import { mkdir, readFile, writeFile } from "fs/promises";
+function calibrationDir(memoryDir) {
+  return path.join(memoryDir, "state", "calibration");
+}
+function calibrationIndexPath(memoryDir) {
+  return path.join(calibrationDir(memoryDir), "calibration-index.json");
+}
+async function readCalibrationIndex(memoryDir) {
+  try {
+    const raw = JSON.parse(await readFile(calibrationIndexPath(memoryDir), "utf8"));
+    return {
+      rules: Array.isArray(raw.rules) ? raw.rules : [],
+      updatedAt: typeof raw.updatedAt === "string" ? raw.updatedAt : (/* @__PURE__ */ new Date()).toISOString(),
+      totalCorrectionsAnalyzed: typeof raw.totalCorrectionsAnalyzed === "number" ? raw.totalCorrectionsAnalyzed : 0
+    };
+  } catch {
+    return { rules: [], updatedAt: (/* @__PURE__ */ new Date()).toISOString(), totalCorrectionsAnalyzed: 0 };
+  }
+}
+async function writeCalibrationIndex(memoryDir, index) {
+  const dir = calibrationDir(memoryDir);
+  await mkdir(dir, { recursive: true });
+  index.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  await writeFile(calibrationIndexPath(memoryDir), JSON.stringify(index, null, 2), "utf8");
+}
+async function readCorrections(memoryDir) {
+  const correctionsDir = path.join(memoryDir, "corrections");
+  const files = await listJsonFiles(correctionsDir).catch(() => {
+    return [];
+  });
+  const factsDir = path.join(memoryDir, "facts");
+  try {
+    const { readdir } = await import("fs/promises");
+    const dayDirs = (await readdir(factsDir)).filter((d) => /^\d{4}-\d{2}-\d{2}$/.test(d));
+    for (const day of dayDirs) {
+      const dayPath = path.join(factsDir, day);
+      const dayFiles = (await readdir(dayPath)).filter((f) => f.startsWith("correction-") && f.endsWith(".md")).map((f) => path.join(dayPath, f));
+      files.push(...dayFiles);
+    }
+  } catch {
+  }
+  try {
+    const { readdir } = await import("fs/promises");
+    const corrFiles = (await readdir(correctionsDir)).filter((f) => f.endsWith(".md")).map((f) => path.join(correctionsDir, f));
+    files.push(...corrFiles);
+  } catch {
+  }
+  const corrections = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const filePath of files) {
+    try {
+      const raw = await readFile(filePath, "utf8");
+      const fmMatch = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+      if (!fmMatch) continue;
+      const content = fmMatch[2].trim();
+      if (!content || content.length < 10) continue;
+      const idMatch = fmMatch[1].match(/^id:\s*(.+)$/m);
+      const id = idMatch?.[1]?.trim() ?? path.basename(filePath, ".md");
+      if (seen.has(id)) continue;
+      seen.add(id);
+      const confMatch = fmMatch[1].match(/^confidence:\s*(.+)$/m);
+      const confidence = confMatch ? parseFloat(confMatch[1]) : 0.9;
+      const entityMatch = fmMatch[1].match(/^entityRef:\s*(.+)$/m);
+      const entityRefs = entityMatch ? [entityMatch[1].trim()] : [];
+      corrections.push({ id, content, created: "", confidence, entityRefs, tags: [] });
+    } catch {
+    }
+  }
+  return corrections;
+}
+var CLUSTER_PROMPT = `You are analyzing user corrections to an AI assistant. Each correction represents a moment where the assistant's prediction of what the user wanted was WRONG.
+
+Your job: Group these corrections into clusters where the SAME TYPE of misunderstanding is happening. Then for each cluster, synthesize a CalibrationRule.
+
+A CalibrationRule describes:
+- condition: When does this type of mistake happen?
+- modelTendency: What does the model tend to assume or do wrong?
+- userExpectation: What does the user actually want instead?
+- calibration: How should the model adjust its behavior?
+- ruleType: One of "model_tendency", "user_expectation", "scope_boundary", "verification_required"
+
+Focus on PATTERNS, not individual corrections. A cluster needs at least 2 corrections to be worth a rule.
+
+Output valid JSON only:
+{
+  "rules": [
+    {
+      "ruleType": "model_tendency",
+      "condition": "When discussing project scope or task boundaries",
+      "modelTendency": "The model tends to assume broader scope than the user intends",
+      "userExpectation": "The user prefers narrow, specific task definitions and wants to be asked before scope expansion",
+      "calibration": "When uncertain about scope, ask for clarification rather than assuming. Default to the narrower interpretation.",
+      "confidence": 0.85,
+      "evidenceIds": ["correction-id-1", "correction-id-2"]
+    }
+  ]
+}`;
+async function synthesizeCalibrationRules(corrections, llm, existingRules) {
+  if (corrections.length < 2) return [];
+  const correctionText = corrections.slice(0, 50).map((c, i) => `[${c.id}] ${c.content}`).join("\n\n");
+  const existingRulesText = existingRules.length > 0 ? `
+
+Existing calibration rules (avoid duplicating these):
+${existingRules.map((r) => `- ${r.condition}: ${r.calibration}`).join("\n")}` : "";
+  const response = await llm.chatCompletion(
+    [
+      { role: "system", content: CLUSTER_PROMPT },
+      { role: "user", content: `Here are ${corrections.length} corrections from this user:
+
+${correctionText}${existingRulesText}` }
+    ],
+    { temperature: 0.3, maxTokens: 3e3 }
+  );
+  if (!response?.content) return [];
+  try {
+    let jsonStr = response.content.trim();
+    const fenceMatch = jsonStr.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+    if (fenceMatch) jsonStr = fenceMatch[1];
+    const parsed = JSON.parse(jsonStr);
+    if (!Array.isArray(parsed.rules)) return [];
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    return parsed.rules.filter((r) => r.condition && r.calibration && r.modelTendency).map((r) => ({
+      id: `cal-${createHash("sha256").update(r.condition + r.calibration).digest("hex").slice(0, 12)}`,
+      ruleType: r.ruleType ?? "model_tendency",
+      condition: String(r.condition),
+      modelTendency: String(r.modelTendency),
+      userExpectation: String(r.userExpectation ?? ""),
+      calibration: String(r.calibration),
+      confidence: typeof r.confidence === "number" ? r.confidence : 0.7,
+      evidenceCount: Array.isArray(r.evidenceIds) ? r.evidenceIds.length : 1,
+      evidenceCorrectionIds: Array.isArray(r.evidenceIds) ? r.evidenceIds : [],
+      createdAt: now,
+      lastReinforcedAt: now
+    }));
+  } catch {
+    log.warn("[calibration] failed to parse LLM response");
+    return [];
+  }
+}
+function buildCalibrationRecallSection(rules, query, maxChars = 1200) {
+  if (rules.length === 0) return null;
+  const lines = [
+    "## Model Calibration (learned from past corrections)",
+    "",
+    "Adjustments for this specific user, learned from patterns in their corrections:",
+    ""
+  ];
+  let totalChars = lines.join("\n").length;
+  for (const rule of rules) {
+    const line = `- **${rule.condition}**: ${rule.modelTendency} \u2192 Instead: ${rule.calibration}`;
+    if (totalChars + line.length + 1 > maxChars) break;
+    lines.push(line);
+    totalChars += line.length + 1;
+  }
+  if (lines.length <= 4) return null;
+  lines.push("");
+  return lines.join("\n");
+}
+async function runCalibrationConsolidation(options) {
+  try {
+    const llm = new FallbackLlmClient(options.gatewayConfig);
+    if (!llm.isAvailable()) {
+      log.debug("[calibration] no LLM available \u2014 skipping consolidation");
+      return [];
+    }
+    const corrections = await readCorrections(options.memoryDir);
+    if (corrections.length < 3) {
+      log.debug(`[calibration] only ${corrections.length} corrections \u2014 need at least 3`);
+      return [];
+    }
+    const existingIndex = await readCalibrationIndex(options.memoryDir);
+    const newRules = await synthesizeCalibrationRules(corrections, llm, existingIndex.rules);
+    if (newRules.length === 0) {
+      log.debug("[calibration] no new calibration rules synthesized");
+      return existingIndex.rules;
+    }
+    const ruleMap = new Map(existingIndex.rules.map((r) => [r.id, r]));
+    for (const rule of newRules) {
+      if (ruleMap.has(rule.id)) {
+        const existing = ruleMap.get(rule.id);
+        existing.lastReinforcedAt = (/* @__PURE__ */ new Date()).toISOString();
+        existing.evidenceCount += rule.evidenceCount;
+        existing.confidence = Math.min(1, existing.confidence + 0.05);
+      } else {
+        ruleMap.set(rule.id, rule);
+      }
+    }
+    const allRules = [...ruleMap.values()];
+    await writeCalibrationIndex(options.memoryDir, {
+      rules: allRules,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      totalCorrectionsAnalyzed: corrections.length
+    });
+    log.debug(`[calibration] synthesized ${newRules.length} new rule(s), ${allRules.length} total`);
+    return allRules;
+  } catch (error) {
+    log.warn(`[calibration] consolidation failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);
+    return [];
+  }
+}
+async function runCalibrationIfEnabled(options) {
+  if (!options.calibrationEnabled) {
+    return [];
+  }
+  return runCalibrationConsolidation({
+    memoryDir: options.memoryDir,
+    gatewayConfig: options.gatewayConfig
+  });
+}
+async function getCalibrationRulesForRecall(memoryDir) {
+  const index = await readCalibrationIndex(memoryDir);
+  return index.rules;
+}
+export {
+  buildCalibrationRecallSection,
+  getCalibrationRulesForRecall,
+  readCalibrationIndex,
+  runCalibrationConsolidation,
+  runCalibrationIfEnabled,
+  synthesizeCalibrationRules
+};
+//# sourceMappingURL=calibration-TLGCHI7D.js.map

package/dist/calibration-TLGCHI7D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/calibration.ts"],"sourcesContent":["/**\n * calibration.ts — Prediction-Error-Driven Model-User Calibration\n *\n * Analyzes patterns in user corrections to identify systematic miscalibration\n * between the model's predictions and the user's actual expectations.\n * During consolidation, replays chains of similar corrections through an LLM\n * to synthesize CalibrationRules that adjust model behavior for this specific user.\n *\n * Inspired by:\n * - Cerebellar motor calibration (prediction errors drive lasting adjustments)\n * - Temporal difference learning (dopamine signals prediction error)\n * - Tesla FSD shadow mode (divergence between prediction and reality = training signal)\n */\n\nimport { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { FallbackLlmClient } from \"./fallback-llm.js\";\nimport type { GatewayConfig, MemoryFile } from \"./types.js\";\nimport { listJsonFiles, readJsonFile } from \"./json-store.js\";\nimport { isRecord } from \"./store-contract.js\";\nimport { log } from \"./logger.js\";\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface CalibrationRule {\n  id: string;\n  ruleType: \"model_tendency\" | \"user_expectation\" | \"scope_boundary\" | \"verification_required\";\n  condition: string;\n  modelTendency: string;\n  userExpectation: string;\n  calibration: string;\n  confidence: number;\n  evidenceCount: number;\n  evidenceCorrectionIds: string[];\n  createdAt: string;\n  lastReinforcedAt: string;\n}\n\nexport interface CalibrationIndex {\n  rules: CalibrationRule[];\n  updatedAt: string;\n  totalCorrectionsAnalyzed: number;\n}\n\n// ─── Storage ─────────────────────────────────────────────────────────────────\n\nfunction calibrationDir(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", \"calibration\");\n}\n\nfunction calibrationIndexPath(memoryDir: string): string {\n  return path.join(calibrationDir(memoryDir), \"calibration-index.json\");\n}\n\nexport async function readCalibrationIndex(memoryDir: string): Promise<CalibrationIndex> {\n  try {\n    const raw = JSON.parse(await readFile(calibrationIndexPath(memoryDir), \"utf8\"));\n    return {\n      rules: Array.isArray(raw.rules) ? raw.rules : [],\n      updatedAt: typeof raw.updatedAt === \"string\" ? raw.updatedAt : new Date().toISOString(),\n      totalCorrectionsAnalyzed: typeof raw.totalCorrectionsAnalyzed === \"number\" ? raw.totalCorrectionsAnalyzed : 0,\n    };\n  } catch {\n    return { rules: [], updatedAt: new Date().toISOString(), totalCorrectionsAnalyzed: 0 };\n  }\n}\n\nasync function writeCalibrationIndex(memoryDir: string, index: CalibrationIndex): Promise<void> {\n  const dir = calibrationDir(memoryDir);\n  await mkdir(dir, { recursive: true });\n  index.updatedAt = new Date().toISOString();\n  await writeFile(calibrationIndexPath(memoryDir), JSON.stringify(index, null, 2), \"utf8\");\n}\n\n// ─── Correction Reading ──────────────────────────────────────────────────────\n\ninterface CorrectionMemory {\n  id: string;\n  content: string;\n  created: string;\n  confidence: number;\n  entityRefs: string[];\n  tags: string[];\n}\n\nasync function readCorrections(memoryDir: string): Promise<CorrectionMemory[]> {\n  const correctionsDir = path.join(memoryDir, \"corrections\");\n  const files = await listJsonFiles(correctionsDir).catch(() => {\n    // Corrections might be in facts/ directories too\n    return [] as string[];\n  });\n\n  // Also scan facts directories for correction-category files\n  const factsDir = path.join(memoryDir, \"facts\");\n  try {\n    const { readdir } = await import(\"node:fs/promises\");\n    const dayDirs = (await readdir(factsDir)).filter((d: string) => /^\\d{4}-\\d{2}-\\d{2}$/.test(d));\n    for (const day of dayDirs) {\n      const dayPath = path.join(factsDir, day);\n      const dayFiles = (await readdir(dayPath))\n        .filter((f: string) => f.startsWith(\"correction-\") && f.endsWith(\".md\"))\n        .map((f: string) => path.join(dayPath, f));\n      files.push(...dayFiles);\n    }\n  } catch {\n    // facts dir might not exist\n  }\n\n  // Also check the dedicated corrections directory\n  try {\n    const { readdir } = await import(\"node:fs/promises\");\n    const corrFiles = (await readdir(correctionsDir))\n      .filter((f: string) => f.endsWith(\".md\"))\n      .map((f: string) => path.join(correctionsDir, f));\n    files.push(...corrFiles);\n  } catch {\n    // corrections dir might not exist\n  }\n\n  const corrections: CorrectionMemory[] = [];\n  const seen = new Set<string>();\n\n  for (const filePath of files) {\n    try {\n      const raw = await readFile(filePath, \"utf8\");\n\n      // Parse frontmatter\n      const fmMatch = raw.match(/^---\\n([\\s\\S]*?)\\n---\\n([\\s\\S]*)$/);\n      if (!fmMatch) continue;\n\n      const content = fmMatch[2].trim();\n      if (!content || content.length < 10) continue;\n\n      // Extract id from frontmatter\n      const idMatch = fmMatch[1].match(/^id:\\s*(.+)$/m);\n      const id = idMatch?.[1]?.trim() ?? path.basename(filePath, \".md\");\n\n      if (seen.has(id)) continue;\n      seen.add(id);\n\n      const confMatch = fmMatch[1].match(/^confidence:\\s*(.+)$/m);\n      const confidence = confMatch ? parseFloat(confMatch[1]) : 0.9;\n\n      const entityMatch = fmMatch[1].match(/^entityRef:\\s*(.+)$/m);\n      const entityRefs = entityMatch ? [entityMatch[1].trim()] : [];\n\n      corrections.push({ id, content, created: \"\", confidence, entityRefs, tags: [] });\n    } catch {\n      // skip unparseable files\n    }\n  }\n\n  return corrections;\n}\n\n// ─── LLM-Assisted Clustering and Replay ──────────────────────────────────────\n\nconst CLUSTER_PROMPT = `You are analyzing user corrections to an AI assistant. Each correction represents a moment where the assistant's prediction of what the user wanted was WRONG.\n\nYour job: Group these corrections into clusters where the SAME TYPE of misunderstanding is happening. Then for each cluster, synthesize a CalibrationRule.\n\nA CalibrationRule describes:\n- condition: When does this type of mistake happen?\n- modelTendency: What does the model tend to assume or do wrong?\n- userExpectation: What does the user actually want instead?\n- calibration: How should the model adjust its behavior?\n- ruleType: One of \"model_tendency\", \"user_expectation\", \"scope_boundary\", \"verification_required\"\n\nFocus on PATTERNS, not individual corrections. A cluster needs at least 2 corrections to be worth a rule.\n\nOutput valid JSON only:\n{\n  \"rules\": [\n    {\n      \"ruleType\": \"model_tendency\",\n      \"condition\": \"When discussing project scope or task boundaries\",\n      \"modelTendency\": \"The model tends to assume broader scope than the user intends\",\n      \"userExpectation\": \"The user prefers narrow, specific task definitions and wants to be asked before scope expansion\",\n      \"calibration\": \"When uncertain about scope, ask for clarification rather than assuming. Default to the narrower interpretation.\",\n      \"confidence\": 0.85,\n      \"evidenceIds\": [\"correction-id-1\", \"correction-id-2\"]\n    }\n  ]\n}`;\n\nexport async function synthesizeCalibrationRules(\n  corrections: CorrectionMemory[],\n  llm: FallbackLlmClient,\n  existingRules: CalibrationRule[],\n): Promise<CalibrationRule[]> {\n  if (corrections.length < 2) return [];\n\n  // Format corrections for the LLM\n  const correctionText = corrections\n    .slice(0, 50) // limit to avoid huge prompts\n    .map((c, i) => `[${c.id}] ${c.content}`)\n    .join(\"\\n\\n\");\n\n  const existingRulesText = existingRules.length > 0\n    ? `\\n\\nExisting calibration rules (avoid duplicating these):\\n${existingRules.map((r) => `- ${r.condition}: ${r.calibration}`).join(\"\\n\")}`\n    : \"\";\n\n  const response = await llm.chatCompletion(\n    [\n      { role: \"system\", content: CLUSTER_PROMPT },\n      { role: \"user\", content: `Here are ${corrections.length} corrections from this user:\\n\\n${correctionText}${existingRulesText}` },\n    ],\n    { temperature: 0.3, maxTokens: 3000 },\n  );\n\n  if (!response?.content) return [];\n\n  try {\n    let jsonStr = response.content.trim();\n    const fenceMatch = jsonStr.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```/);\n    if (fenceMatch) jsonStr = fenceMatch[1];\n\n    const parsed = JSON.parse(jsonStr);\n    if (!Array.isArray(parsed.rules)) return [];\n\n    const now = new Date().toISOString();\n    return parsed.rules\n      .filter((r: any) => r.condition && r.calibration && r.modelTendency)\n      .map((r: any) => ({\n        id: `cal-${createHash(\"sha256\").update(r.condition + r.calibration).digest(\"hex\").slice(0, 12)}`,\n        ruleType: r.ruleType ?? \"model_tendency\",\n        condition: String(r.condition),\n        modelTendency: String(r.modelTendency),\n        userExpectation: String(r.userExpectation ?? \"\"),\n        calibration: String(r.calibration),\n        confidence: typeof r.confidence === \"number\" ? r.confidence : 0.7,\n        evidenceCount: Array.isArray(r.evidenceIds) ? r.evidenceIds.length : 1,\n        evidenceCorrectionIds: Array.isArray(r.evidenceIds) ? r.evidenceIds : [],\n        createdAt: now,\n        lastReinforcedAt: now,\n      }));\n  } catch {\n    log.warn(\"[calibration] failed to parse LLM response\");\n    return [];\n  }\n}\n\n// ─── Recall Section ──────────────────────────────────────────────────────────\n\n/**\n * Build a recall section from calibration rules relevant to the current query.\n * Uses the LLM to select which rules apply to the current context.\n */\nexport function buildCalibrationRecallSection(\n  rules: CalibrationRule[],\n  query: string,\n  maxChars: number = 1200,\n): string | null {\n  if (rules.length === 0) return null;\n\n  // Simple relevance: include all rules (they're already filtered to this user)\n  // In production, could use embedding similarity to filter\n  const lines: string[] = [\n    \"## Model Calibration (learned from past corrections)\",\n    \"\",\n    \"Adjustments for this specific user, learned from patterns in their corrections:\",\n    \"\",\n  ];\n\n  let totalChars = lines.join(\"\\n\").length;\n\n  for (const rule of rules) {\n    const line = `- **${rule.condition}**: ${rule.modelTendency} → Instead: ${rule.calibration}`;\n    if (totalChars + line.length + 1 > maxChars) break;\n    lines.push(line);\n    totalChars += line.length + 1;\n  }\n\n  if (lines.length <= 4) return null;\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n// ─── Public API ──────────────────────────────────────────────────────────────\n\n/**\n * Run the full calibration pipeline:\n * 1. Read all corrections\n * 2. Send to LLM for clustering and rule synthesis\n * 3. Merge with existing rules\n * 4. Write updated index\n */\nexport async function runCalibrationConsolidation(options: {\n  memoryDir: string;\n  gatewayConfig?: GatewayConfig;\n}): Promise<CalibrationRule[]> {\n  try {\n    const llm = new FallbackLlmClient(options.gatewayConfig);\n    if (!llm.isAvailable()) {\n      log.debug(\"[calibration] no LLM available — skipping consolidation\");\n      return [];\n    }\n\n    const corrections = await readCorrections(options.memoryDir);\n    if (corrections.length < 3) {\n      log.debug(`[calibration] only ${corrections.length} corrections — need at least 3`);\n      return [];\n    }\n\n    const existingIndex = await readCalibrationIndex(options.memoryDir);\n\n    const newRules = await synthesizeCalibrationRules(corrections, llm, existingIndex.rules);\n    if (newRules.length === 0) {\n      log.debug(\"[calibration] no new calibration rules synthesized\");\n      return existingIndex.rules;\n    }\n\n    // Merge: keep existing rules, add new ones (deduplicate by id)\n    const ruleMap = new Map(existingIndex.rules.map((r) => [r.id, r]));\n    for (const rule of newRules) {\n      if (ruleMap.has(rule.id)) {\n        // Reinforce existing rule\n        const existing = ruleMap.get(rule.id)!;\n        existing.lastReinforcedAt = new Date().toISOString();\n        existing.evidenceCount += rule.evidenceCount;\n        existing.confidence = Math.min(1, existing.confidence + 0.05);\n      } else {\n        ruleMap.set(rule.id, rule);\n      }\n    }\n\n    const allRules = [...ruleMap.values()];\n    await writeCalibrationIndex(options.memoryDir, {\n      rules: allRules,\n      updatedAt: new Date().toISOString(),\n      totalCorrectionsAnalyzed: corrections.length,\n    });\n\n    log.debug(`[calibration] synthesized ${newRules.length} new rule(s), ${allRules.length} total`);\n    return allRules;\n  } catch (error) {\n    log.warn(`[calibration] consolidation failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);\n    return [];\n  }\n}\n\n/**\n * Standalone entry point for calibration consolidation that can be called\n * independently of weekly compounding. The compounding engine's\n * `synthesizeWeekly()` is one trigger, but orchestrators or periodic\n * maintenance jobs should call this directly so calibration is not gated\n * on weekly compounding being enabled.\n */\nexport async function runCalibrationIfEnabled(options: {\n  memoryDir: string;\n  calibrationEnabled: boolean;\n  gatewayConfig?: GatewayConfig;\n}): Promise<CalibrationRule[]> {\n  if (!options.calibrationEnabled) {\n    return [];\n  }\n  return runCalibrationConsolidation({\n    memoryDir: options.memoryDir,\n    gatewayConfig: options.gatewayConfig,\n  });\n}\n\n/**\n * Get calibration rules for recall injection.\n * Reads the pre-computed calibration index.\n */\nexport async function getCalibrationRulesForRecall(\n  memoryDir: string,\n): Promise<CalibrationRule[]> {\n  const index = await readCalibrationIndex(memoryDir);\n  return index.rules;\n}\n"],"mappings":";;;;;;;;;;;;AAcA,SAAS,kBAAkB;AAC3B,OAAO,UAAU;AACjB,SAAS,OAAO,UAAU,iBAAiB;AA+B3C,SAAS,eAAe,WAA2B;AACjD,SAAO,KAAK,KAAK,WAAW,SAAS,aAAa;AACpD;AAEA,SAAS,qBAAqB,WAA2B;AACvD,SAAO,KAAK,KAAK,eAAe,SAAS,GAAG,wBAAwB;AACtE;AAEA,eAAsB,qBAAqB,WAA8C;AACvF,MAAI;AACF,UAAM,MAAM,KAAK,MAAM,MAAM,SAAS,qBAAqB,SAAS,GAAG,MAAM,CAAC;AAC9E,WAAO;AAAA,MACL,OAAO,MAAM,QAAQ,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC;AAAA,MAC/C,WAAW,OAAO,IAAI,cAAc,WAAW,IAAI,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,MACtF,0BAA0B,OAAO,IAAI,6BAA6B,WAAW,IAAI,2BAA2B;AAAA,IAC9G;AAAA,EACF,QAAQ;AACN,WAAO,EAAE,OAAO,CAAC,GAAG,YAAW,oBAAI,KAAK,GAAE,YAAY,GAAG,0BAA0B,EAAE;AAAA,EACvF;AACF;AAEA,eAAe,sBAAsB,WAAmB,OAAwC;AAC9F,QAAM,MAAM,eAAe,SAAS;AACpC,QAAM,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AACpC,QAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AACzC,QAAM,UAAU,qBAAqB,SAAS,GAAG,KAAK,UAAU,OAAO,MAAM,CAAC,GAAG,MAAM;AACzF;AAaA,eAAe,gBAAgB,WAAgD;AAC7E,QAAM,iBAAiB,KAAK,KAAK,WAAW,aAAa;AACzD,QAAM,QAAQ,MAAM,cAAc,cAAc,EAAE,MAAM,MAAM;AAE5D,WAAO,CAAC;AAAA,EACV,CAAC;AAGD,QAAM,WAAW,KAAK,KAAK,WAAW,OAAO;AAC7C,MAAI;AACF,UAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,aAAkB;AACnD,UAAM,WAAW,MAAM,QAAQ,QAAQ,GAAG,OAAO,CAAC,MAAc,sBAAsB,KAAK,CAAC,CAAC;AAC7F,eAAW,OAAO,SAAS;AACzB,YAAM,UAAU,KAAK,KAAK,UAAU,GAAG;AACvC,YAAM,YAAY,MAAM,QAAQ,OAAO,GACpC,OAAO,CAAC,MAAc,EAAE,WAAW,aAAa,KAAK,EAAE,SAAS,KAAK,CAAC,EACtE,IAAI,CAAC,MAAc,KAAK,KAAK,SAAS,CAAC,CAAC;AAC3C,YAAM,KAAK,GAAG,QAAQ;AAAA,IACxB;AAAA,EACF,QAAQ;AAAA,EAER;AAGA,MAAI;AACF,UAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,aAAkB;AACnD,UAAM,aAAa,MAAM,QAAQ,cAAc,GAC5C,OAAO,CAAC,MAAc,EAAE,SAAS,KAAK,CAAC,EACvC,IAAI,CAAC,MAAc,KAAK,KAAK,gBAAgB,CAAC,CAAC;AAClD,UAAM,KAAK,GAAG,SAAS;AAAA,EACzB,QAAQ;AAAA,EAER;AAEA,QAAM,cAAkC,CAAC;AACzC,QAAM,OAAO,oBAAI,IAAY;AAE7B,aAAW,YAAY,OAAO;AAC5B,QAAI;AACF,YAAM,MAAM,MAAM,SAAS,UAAU,MAAM;AAG3C,YAAM,UAAU,IAAI,MAAM,mCAAmC;AAC7D,UAAI,CAAC,QAAS;AAEd,YAAM,UAAU,QAAQ,CAAC,EAAE,KAAK;AAChC,UAAI,CAAC,WAAW,QAAQ,SAAS,GAAI;AAGrC,YAAM,UAAU,QAAQ,CAAC,EAAE,MAAM,eAAe;AAChD,YAAM,KAAK,UAAU,CAAC,GAAG,KAAK,KAAK,KAAK,SAAS,UAAU,KAAK;AAEhE,UAAI,KAAK,IAAI,EAAE,EAAG;AAClB,WAAK,IAAI,EAAE;AAEX,YAAM,YAAY,QAAQ,CAAC,EAAE,MAAM,uBAAuB;AAC1D,YAAM,aAAa,YAAY,WAAW,UAAU,CAAC,CAAC,IAAI;AAE1D,YAAM,cAAc,QAAQ,CAAC,EAAE,MAAM,sBAAsB;AAC3D,YAAM,aAAa,cAAc,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC;AAE5D,kBAAY,KAAK,EAAE,IAAI,SAAS,SAAS,IAAI,YAAY,YAAY,MAAM,CAAC,EAAE,CAAC;AAAA,IACjF,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,SAAO;AACT;AAIA,IAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4BvB,eAAsB,2BACpB,aACA,KACA,eAC4B;AAC5B,MAAI,YAAY,SAAS,EAAG,QAAO,CAAC;AAGpC,QAAM,iBAAiB,YACpB,MAAM,GAAG,EAAE,EACX,IAAI,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EACtC,KAAK,MAAM;AAEd,QAAM,oBAAoB,cAAc,SAAS,IAC7C;AAAA;AAAA;AAAA,EAA8D,cAAc,IAAI,CAAC,MAAM,KAAK,EAAE,SAAS,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,IAAI,CAAC,KACvI;AAEJ,QAAM,WAAW,MAAM,IAAI;AAAA,IACzB;AAAA,MACE,EAAE,MAAM,UAAU,SAAS,eAAe;AAAA,MAC1C,EAAE,MAAM,QAAQ,SAAS,YAAY,YAAY,MAAM;AAAA;AAAA,EAAmC,cAAc,GAAG,iBAAiB,GAAG;AAAA,IACjI;AAAA,IACA,EAAE,aAAa,KAAK,WAAW,IAAK;AAAA,EACtC;AAEA,MAAI,CAAC,UAAU,QAAS,QAAO,CAAC;AAEhC,MAAI;AACF,QAAI,UAAU,SAAS,QAAQ,KAAK;AACpC,UAAM,aAAa,QAAQ,MAAM,uCAAuC;AACxE,QAAI,WAAY,WAAU,WAAW,CAAC;AAEtC,UAAM,SAAS,KAAK,MAAM,OAAO;AACjC,QAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,EAAG,QAAO,CAAC;AAE1C,UAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AACnC,WAAO,OAAO,MACX,OAAO,CAAC,MAAW,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAClE,IAAI,CAAC,OAAY;AAAA,MAChB,IAAI,OAAO,WAAW,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,KAAK,EAAE,MAAM,GAAG,EAAE,CAAC;AAAA,MAC9F,UAAU,EAAE,YAAY;AAAA,MACxB,WAAW,OAAO,EAAE,SAAS;AAAA,MAC7B,eAAe,OAAO,EAAE,aAAa;AAAA,MACrC,iBAAiB,OAAO,EAAE,mBAAmB,EAAE;AAAA,MAC/C,aAAa,OAAO,EAAE,WAAW;AAAA,MACjC,YAAY,OAAO,EAAE,eAAe,WAAW,EAAE,aAAa;AAAA,MAC9D,eAAe,MAAM,QAAQ,EAAE,WAAW,IAAI,EAAE,YAAY,SAAS;AAAA,MACrE,uBAAuB,MAAM,QAAQ,EAAE,WAAW,IAAI,EAAE,cAAc,CAAC;AAAA,MACvE,WAAW;AAAA,MACX,kBAAkB;AAAA,IACpB,EAAE;AAAA,EACN,QAAQ;AACN,QAAI,KAAK,4CAA4C;AACrD,WAAO,CAAC;AAAA,EACV;AACF;AAQO,SAAS,8BACd,OACA,OACA,WAAmB,MACJ;AACf,MAAI,MAAM,WAAW,EAAG,QAAO;AAI/B,QAAM,QAAkB;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,MAAI,aAAa,MAAM,KAAK,IAAI,EAAE;AAElC,aAAW,QAAQ,OAAO;AACxB,UAAM,OAAO,OAAO,KAAK,SAAS,OAAO,KAAK,aAAa,oBAAe,KAAK,WAAW;AAC1F,QAAI,aAAa,KAAK,SAAS,IAAI,SAAU;AAC7C,UAAM,KAAK,IAAI;AACf,kBAAc,KAAK,SAAS;AAAA,EAC9B;AAEA,MAAI,MAAM,UAAU,EAAG,QAAO;AAC9B,QAAM,KAAK,EAAE;AACb,SAAO,MAAM,KAAK,IAAI;AACxB;AAWA,eAAsB,4BAA4B,SAGnB;AAC7B,MAAI;AACF,UAAM,MAAM,IAAI,kBAAkB,QAAQ,aAAa;AACvD,QAAI,CAAC,IAAI,YAAY,GAAG;AACtB,UAAI,MAAM,8DAAyD;AACnE,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,cAAc,MAAM,gBAAgB,QAAQ,SAAS;AAC3D,QAAI,YAAY,SAAS,GAAG;AAC1B,UAAI,MAAM,sBAAsB,YAAY,MAAM,qCAAgC;AAClF,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,gBAAgB,MAAM,qBAAqB,QAAQ,SAAS;AAElE,UAAM,WAAW,MAAM,2BAA2B,aAAa,KAAK,cAAc,KAAK;AACvF,QAAI,SAAS,WAAW,GAAG;AACzB,UAAI,MAAM,oDAAoD;AAC9D,aAAO,cAAc;AAAA,IACvB;AAGA,UAAM,UAAU,IAAI,IAAI,cAAc,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACjE,eAAW,QAAQ,UAAU;AAC3B,UAAI,QAAQ,IAAI,KAAK,EAAE,GAAG;AAExB,cAAM,WAAW,QAAQ,IAAI,KAAK,EAAE;AACpC,iBAAS,oBAAmB,oBAAI,KAAK,GAAE,YAAY;AACnD,iBAAS,iBAAiB,KAAK;AAC/B,iBAAS,aAAa,KAAK,IAAI,GAAG,SAAS,aAAa,IAAI;AAAA,MAC9D,OAAO;AACL,gBAAQ,IAAI,KAAK,IAAI,IAAI;AAAA,MAC3B;AAAA,IACF;AAEA,UAAM,WAAW,CAAC,GAAG,QAAQ,OAAO,CAAC;AACrC,UAAM,sBAAsB,QAAQ,WAAW;AAAA,MAC7C,OAAO;AAAA,MACP,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MAClC,0BAA0B,YAAY;AAAA,IACxC,CAAC;AAED,QAAI,MAAM,6BAA6B,SAAS,MAAM,iBAAiB,SAAS,MAAM,QAAQ;AAC9F,WAAO;AAAA,EACT,SAAS,OAAO;AACd,QAAI,KAAK,mDAAmD,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AACpH,WAAO,CAAC;AAAA,EACV;AACF;AASA,eAAsB,wBAAwB,SAIf;AAC7B,MAAI,CAAC,QAAQ,oBAAoB;AAC/B,WAAO,CAAC;AAAA,EACV;AACA,SAAO,4BAA4B;AAAA,IACjC,WAAW,QAAQ;AAAA,IACnB,eAAe,QAAQ;AAAA,EACzB,CAAC;AACH;AAMA,eAAsB,6BACpB,WAC4B;AAC5B,QAAM,QAAQ,MAAM,qBAAqB,SAAS;AAClD,SAAO,MAAM;AACf;","names":[]}

package/dist/causal-chain-OJCLNNEH.js

@@ -0,0 +1,23 @@
+// openclaw-engram: Local-first memory plugin
+import {
+  makeEdgeId,
+  readChainIndex,
+  resolveChainsDir,
+  scoreStitchCandidate,
+  stitchCausalChain,
+  validateCausalEdge,
+  writeChainIndex
+} from "./chunk-3GARBXWR.js";
+import "./chunk-AFMNQR7H.js";
+import "./chunk-DEIBZP3O.js";
+import "./chunk-SSIIJJKA.js";
+export {
+  makeEdgeId,
+  readChainIndex,
+  resolveChainsDir,
+  scoreStitchCandidate,
+  stitchCausalChain,
+  validateCausalEdge,
+  writeChainIndex
+};
+//# sourceMappingURL=causal-chain-OJCLNNEH.js.map