@remnic/core 1.1.0 → 1.1.2

package/dist/chunk-DF3RVK3X.js

@@ -0,0 +1,119 @@
+import {
+  log
+} from "./chunk-2ODBA7MQ.js";
+
+// src/extraction-judge-training.ts
+import path from "path";
+import { homedir } from "os";
+import { appendFile, mkdir, readFile, readdir } from "fs/promises";
+function expandTilde(p) {
+  const home = homedir();
+  if (p === "~" || p.startsWith("~/") || p.startsWith("~\\")) {
+    return home + p.slice(1);
+  }
+  if (p === "$HOME" || p.startsWith("$HOME/") || p.startsWith("$HOME\\")) {
+    return home + p.slice(5);
+  }
+  if (p === "${HOME}" || p.startsWith("${HOME}/") || p.startsWith("${HOME}\\")) {
+    return home + p.slice(7);
+  }
+  return p;
+}
+function resolveTrainingDir(options) {
+  if (options.directory && options.directory.length > 0) {
+    return expandTilde(options.directory);
+  }
+  return path.join(homedir(), ".remnic", "judge-training");
+}
+function dateStamp(iso) {
+  const ms = Date.parse(iso);
+  const d = Number.isFinite(ms) ? new Date(ms) : /* @__PURE__ */ new Date();
+  const yyyy = d.getUTCFullYear().toString().padStart(4, "0");
+  const mm = (d.getUTCMonth() + 1).toString().padStart(2, "0");
+  const dd = d.getUTCDate().toString().padStart(2, "0");
+  return `${yyyy}-${mm}-${dd}`;
+}
+function trainingFilePathFor(directory, iso) {
+  return path.join(directory, `${dateStamp(iso)}.jsonl`);
+}
+async function recordJudgeTrainingPair(row, options) {
+  if (!options.enabled) return;
+  const dir = resolveTrainingDir(options);
+  const filePath = trainingFilePathFor(dir, row.ts);
+  try {
+    await mkdir(dir, { recursive: true });
+    await appendFile(filePath, `${JSON.stringify(row)}
+`, "utf-8");
+  } catch (err) {
+    log.debug(
+      `extraction-judge-training: append failed (non-fatal): ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+async function readJudgeTrainingPairs(options) {
+  const dir = resolveTrainingDir({ enabled: true, ...options });
+  let entries;
+  try {
+    entries = await readdir(dir);
+  } catch (err) {
+    const code = err.code;
+    if (code === "ENOENT") return { rows: [], malformed: 0 };
+    throw err;
+  }
+  const rows = [];
+  let malformed = 0;
+  entries.sort();
+  for (const name of entries) {
+    if (!name.endsWith(".jsonl")) continue;
+    const raw = await readFile(path.join(dir, name), "utf-8");
+    for (const line of raw.split("\n")) {
+      if (!line.trim()) continue;
+      let parsed;
+      try {
+        parsed = JSON.parse(line);
+      } catch {
+        malformed += 1;
+        continue;
+      }
+      if (!isValidTrainingPair(parsed)) {
+        malformed += 1;
+        continue;
+      }
+      rows.push(parsed);
+    }
+  }
+  return { rows, malformed };
+}
+function isValidTrainingPair(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  const p = value;
+  if (p.version !== 1) return false;
+  if (typeof p.ts !== "string") return false;
+  if (typeof p.candidateText !== "string") return false;
+  if (typeof p.candidateCategory !== "string") return false;
+  if (p.verdictKind !== "accept" && p.verdictKind !== "reject" && p.verdictKind !== "defer") {
+    return false;
+  }
+  if (typeof p.reason !== "string") return false;
+  if (p.candidateConfidence !== void 0 && typeof p.candidateConfidence !== "number") {
+    return false;
+  }
+  if (p.priorDeferrals !== void 0 && typeof p.priorDeferrals !== "number") {
+    return false;
+  }
+  if (p.groundTruthLabel !== void 0 && p.groundTruthLabel !== "accept" && p.groundTruthLabel !== "reject" && p.groundTruthLabel !== "defer") {
+    return false;
+  }
+  return true;
+}
+
+export {
+  resolveTrainingDir,
+  trainingFilePathFor,
+  recordJudgeTrainingPair,
+  readJudgeTrainingPairs,
+  isValidTrainingPair
+};
+//# sourceMappingURL=chunk-DF3RVK3X.js.map

package/dist/chunk-DF3RVK3X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/extraction-judge-training.ts"],"sourcesContent":["/**\n * Extraction Judge Training Data Shim (issue #562, PR 4).\n *\n * Opt-in collector for `(candidate_text, verdict_kind, reason,\n * ground_truth_label?)` tuples. Rows are appended to JSONL files under\n * `~/.remnic/judge-training/<YYYY-MM-DD>.jsonl` so operators can ship the\n * data into a future GRPO training pipeline without exfiltrating live\n * memory content through the regular observation ledger.\n *\n * Gating:\n *   - Off by default. Must be explicitly enabled via\n *     `collectJudgeTrainingPairs: true` in plugin config.\n *   - The ground-truth label is always optional — labels are added out-of-\n *     band once reviewers disambiguate the candidate's fate.\n *\n * Privacy: the row carries only what the judge already sees — the\n * candidate text and its metadata. It does NOT carry session keys,\n * principal IDs, or any user identifiers. The file lives in the user's\n * home directory rather than the shared memory directory so it is never\n * committed, sync'd, or bundled into exports.\n */\n\nimport path from \"node:path\";\nimport { homedir } from \"node:os\";\nimport { appendFile, mkdir, readFile, readdir } from \"node:fs/promises\";\nimport { log } from \"./logger.js\";\nimport type { JudgeVerdictKind } from \"./extraction-judge.js\";\n\n/**\n * Persisted training row. Intentionally minimal: just the signal needed\n * to train a judge replacement policy. Schema version is tagged so future\n * readers can migrate older rows.\n */\nexport interface JudgeTrainingPair {\n  version: 1;\n  ts: string; // ISO-8601\n  candidateText: string;\n  candidateCategory: string;\n  candidateConfidence?: number;\n  verdictKind: JudgeVerdictKind;\n  reason: string;\n  /**\n   * Number of prior deferrals when the verdict was resolved. `0` for the\n   * first resolution; only set when known (defer pathway).\n   */\n  priorDeferrals?: number;\n  /**\n   * Optional human-applied ground-truth label. Added after the fact by a\n   * reviewer / labelling script; not present on fresh rows.\n   */\n  groundTruthLabel?: JudgeVerdictKind;\n}\n\nexport interface JudgeTrainingOptions {\n  enabled: boolean;\n  /**\n   * Override for the output directory. Defaults to\n   * `~/.remnic/judge-training`. Tests pass a temp path here.\n   */\n  directory?: string;\n}\n\n/**\n * Expand a leading `~` / `~/` / `$HOME/` / `${HOME}/` to the process home\n * directory. Node's `fs` APIs do not expand `~` themselves (CLAUDE.md\n * gotcha 17), so every user-facing path input must be funnelled through\n * this helper before it reaches the filesystem.\n */\nfunction expandTilde(p: string): string {\n  const home = homedir();\n  if (p === \"~\" || p.startsWith(\"~/\") || p.startsWith(\"~\\\\\")) {\n    return home + p.slice(1);\n  }\n  if (p === \"$HOME\" || p.startsWith(\"$HOME/\") || p.startsWith(\"$HOME\\\\\")) {\n    return home + p.slice(5);\n  }\n  if (p === \"${HOME}\" || p.startsWith(\"${HOME}/\") || p.startsWith(\"${HOME}\\\\\")) {\n    return home + p.slice(7);\n  }\n  return p;\n}\n\nexport function resolveTrainingDir(options: JudgeTrainingOptions): string {\n  if (options.directory && options.directory.length > 0) {\n    // Expand `~` / `$HOME` in the override so operators can write the\n    // config as the user sees it (CLAUDE.md gotcha 17).\n    return expandTilde(options.directory);\n  }\n  return path.join(homedir(), \".remnic\", \"judge-training\");\n}\n\nfunction dateStamp(iso: string): string {\n  // `YYYY-MM-DD` from an ISO-8601 string. Falls back to today on a parse\n  // failure rather than throwing — the caller already wrote a row and the\n  // timestamp is best-effort.\n  const ms = Date.parse(iso);\n  const d = Number.isFinite(ms) ? new Date(ms) : new Date();\n  const yyyy = d.getUTCFullYear().toString().padStart(4, \"0\");\n  const mm = (d.getUTCMonth() + 1).toString().padStart(2, \"0\");\n  const dd = d.getUTCDate().toString().padStart(2, \"0\");\n  return `${yyyy}-${mm}-${dd}`;\n}\n\nexport function trainingFilePathFor(\n  directory: string,\n  iso: string,\n): string {\n  return path.join(directory, `${dateStamp(iso)}.jsonl`);\n}\n\n/**\n * Append a single training row. Fails open — write errors are logged at\n * debug level and swallowed, same policy as the telemetry emitter.\n * No-op when `options.enabled` is false.\n */\nexport async function recordJudgeTrainingPair(\n  row: JudgeTrainingPair,\n  options: JudgeTrainingOptions,\n): Promise<void> {\n  if (!options.enabled) return;\n  const dir = resolveTrainingDir(options);\n  const filePath = trainingFilePathFor(dir, row.ts);\n  try {\n    await mkdir(dir, { recursive: true });\n    await appendFile(filePath, `${JSON.stringify(row)}\\n`, \"utf-8\");\n  } catch (err) {\n    log.debug(\n      `extraction-judge-training: append failed (non-fatal): ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n}\n\n/**\n * Read all training rows from the configured directory. Returns an empty\n * array when the directory is missing. Malformed lines are skipped and\n * counted in the returned `malformed` tally.\n */\nexport async function readJudgeTrainingPairs(\n  options: Pick<JudgeTrainingOptions, \"directory\">,\n): Promise<{ rows: JudgeTrainingPair[]; malformed: number }> {\n  const dir = resolveTrainingDir({ enabled: true, ...options });\n  let entries: string[];\n  try {\n    entries = await readdir(dir);\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException).code;\n    if (code === \"ENOENT\") return { rows: [], malformed: 0 };\n    throw err;\n  }\n\n  const rows: JudgeTrainingPair[] = [];\n  let malformed = 0;\n  // Sort so reads are deterministic across platforms.\n  entries.sort();\n  for (const name of entries) {\n    if (!name.endsWith(\".jsonl\")) continue;\n    const raw = await readFile(path.join(dir, name), \"utf-8\");\n    for (const line of raw.split(\"\\n\")) {\n      if (!line.trim()) continue;\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(line);\n      } catch {\n        malformed += 1;\n        continue;\n      }\n      if (!isValidTrainingPair(parsed)) {\n        malformed += 1;\n        continue;\n      }\n      rows.push(parsed);\n    }\n  }\n  return { rows, malformed };\n}\n\n/**\n * Structural validator matching the persisted schema. Forward-compat: an\n * unknown `verdictKind` string is treated as malformed (strict training\n * signal — we do not want to admit unlabelled gibberish into a trainer).\n */\nexport function isValidTrainingPair(value: unknown): value is JudgeTrainingPair {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return false;\n  }\n  const p = value as Record<string, unknown>;\n  if (p.version !== 1) return false;\n  if (typeof p.ts !== \"string\") return false;\n  if (typeof p.candidateText !== \"string\") return false;\n  if (typeof p.candidateCategory !== \"string\") return false;\n  if (\n    p.verdictKind !== \"accept\" &&\n    p.verdictKind !== \"reject\" &&\n    p.verdictKind !== \"defer\"\n  ) {\n    return false;\n  }\n  if (typeof p.reason !== \"string\") return false;\n  if (\n    p.candidateConfidence !== undefined &&\n    typeof p.candidateConfidence !== \"number\"\n  ) {\n    return false;\n  }\n  if (p.priorDeferrals !== undefined && typeof p.priorDeferrals !== \"number\") {\n    return false;\n  }\n  if (\n    p.groundTruthLabel !== undefined &&\n    p.groundTruthLabel !== \"accept\" &&\n    p.groundTruthLabel !== \"reject\" &&\n    p.groundTruthLabel !== \"defer\"\n  ) {\n    return false;\n  }\n  return true;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-N42IWANG.js → chunk-DG6YMRDC.js}

@@ -8,10 +8,10 @@ import {
 } from "./chunk-FEMOX5AD.js";
 import {
   LocalLlmClient
-} from "./chunk-JL2PU6AI.js";
+} from "./chunk-R2XRID2N.js";
 import {
   FallbackLlmClient
-} from "./chunk-44ICJRF3.js";
+} from "./chunk-AYXIPSZO.js";
 import {
   extractJsonCandidates
 } from "./chunk-UZB5KHKX.js";
@@ -618,4 +618,4 @@ ${truncatedConversation}`;
 export {
   HourlySummarizer
 };
-//# sourceMappingURL=chunk-N42IWANG.js.map
+//# sourceMappingURL=chunk-DG6YMRDC.js.map

package/dist/chunk-DGVM5SFL.js

@@ -0,0 +1,69 @@
+import {
+  DEFAULT_PPR_DAMPING,
+  DEFAULT_PPR_ITERATIONS,
+  buildGraphFromMemories,
+  queryGraph
+} from "./chunk-64NJRYU2.js";
+
+// src/graph-recall.ts
+function runGraphRecall(config, options) {
+  if (!config.recallGraphEnabled) {
+    return {
+      ran: false,
+      results: [],
+      graph: null,
+      reason: "disabled",
+      iterations: 0,
+      converged: true
+    };
+  }
+  const topK = typeof config.recallGraphTopK === "number" && Number.isFinite(config.recallGraphTopK) ? config.recallGraphTopK : 50;
+  if (topK <= 0) {
+    return {
+      ran: false,
+      results: [],
+      graph: null,
+      reason: "topk-zero",
+      iterations: 0,
+      converged: true
+    };
+  }
+  if (options.memories.length === 0) {
+    return {
+      ran: false,
+      results: [],
+      graph: null,
+      reason: "empty-input",
+      iterations: 0,
+      converged: true
+    };
+  }
+  const graph = buildGraphFromMemories(options.memories);
+  const damping = typeof config.recallGraphDamping === "number" && Number.isFinite(config.recallGraphDamping) ? config.recallGraphDamping : DEFAULT_PPR_DAMPING;
+  const iterations = typeof config.recallGraphIterations === "number" && Number.isFinite(config.recallGraphIterations) ? config.recallGraphIterations : DEFAULT_PPR_ITERATIONS;
+  const ppr = queryGraph(graph, options.seedIds, {
+    damping,
+    iterations,
+    seedWeights: options.seedWeights
+  });
+  const memoryResults = [];
+  for (const node of ppr.rankedNodes) {
+    const graphNode = graph.nodes.get(node.id);
+    if (!graphNode || graphNode.type !== "memory") continue;
+    memoryResults.push({ id: node.id, score: node.score });
+    if (memoryResults.length >= topK) break;
+  }
+  return {
+    ran: true,
+    results: memoryResults,
+    graph,
+    reason: "ran",
+    iterations: ppr.iterations,
+    converged: ppr.converged
+  };
+}
+
+export {
+  runGraphRecall
+};
+//# sourceMappingURL=chunk-DGVM5SFL.js.map

package/dist/chunk-DGVM5SFL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graph-recall.ts"],"sourcesContent":["/**\n * Graph-based retrieval integration (issue #559 PR 4 of 5).\n *\n * Pure helper that composes `extractGraphEdges` (PR 2) and `queryGraph`\n * (PR 3) into a single retrieval surface. Operators opt in via the\n * `recallGraphEnabled` config flag; until the `retrieval-graph` bench in\n * PR 5 justifies flipping the default, this tier ships disabled.\n *\n * Kept as a pure function so the orchestrator can call it with whatever\n * candidate pool it has (hot cache, recent window, QMD first-pass, etc.)\n * without forcing a specific storage contract on this module.\n */\n\nimport {\n  DEFAULT_PPR_DAMPING,\n  DEFAULT_PPR_ITERATIONS,\n  type MemoryEdgeSource,\n  type RemnicGraph,\n  buildGraphFromMemories,\n  queryGraph,\n} from \"./graph-retrieval.js\";\n\n/**\n * Subset of `PluginConfig` that governs the graph retrieval tier. Kept\n * as a local interface so this module does not pull in the full\n * `PluginConfig` import — `orchestrator.ts` can pass the fields directly.\n */\nexport interface GraphRecallConfig {\n  /** Master enable flag. When false, `runGraphRecall` is a no-op. */\n  recallGraphEnabled: boolean;\n  /** PPR damping factor (default 0.85). */\n  recallGraphDamping: number;\n  /** PPR power-iteration cap (default 20). */\n  recallGraphIterations: number;\n  /**\n   * Max memories the graph tier returns. `0` disables the tier's\n   * contribution without touching `recallGraphEnabled`.\n   */\n  recallGraphTopK: number;\n}\n\n/** Per-invocation options for `runGraphRecall`. */\nexport interface GraphRecallOptions {\n  /**\n   * Candidate memories to build the graph from. Typically the caller's\n   * recall candidate pool (hot cache + QMD first-pass). The extractor\n   * reads only the fields declared on `MemoryEdgeSource` — callers can\n   * safely pass richer memory objects.\n   */\n  memories: readonly MemoryEdgeSource[];\n  /**\n   * Seed memory / entity ids produced by the query-to-graph matcher.\n   * Typically the ids of the top QMD hits plus any entity-exact matches.\n   * If empty, PPR falls back to a uniform distribution over graph nodes.\n   */\n  seedIds: readonly string[];\n  /**\n   * Optional per-seed weights. When provided, PPR starts from the\n   * weighted distribution instead of uniform-over-seeds.\n   */\n  seedWeights?: ReadonlyMap<string, number> | Readonly<Record<string, number>>;\n}\n\n/** A single result from the graph tier. */\nexport interface GraphRecallResult {\n  /** Memory id (the `to` of the highest-scoring `memory`-typed node). */\n  id: string;\n  /** PPR score in [0, 1]. Higher is better. */\n  score: number;\n}\n\n/** The full shape returned by `runGraphRecall`. */\nexport interface GraphRecallRun {\n  /**\n   * Whether the graph tier actually ran. `false` when `recallGraphEnabled`\n   * is `false` or `recallGraphTopK <= 0` — in both cases `results` is `[]`\n   * and `reason` indicates which gate short-circuited.\n   */\n  ran: boolean;\n  /**\n   * Memory-typed ranked results. Entity / agent nodes are filtered out\n   * because the orchestrator merges this list with memory-typed QMD\n   * results via MMR.\n   */\n  results: GraphRecallResult[];\n  /** The graph that was built (or `null` if the tier did not run). */\n  graph: RemnicGraph | null;\n  /** Debugging tag for tier-explain surfaces. */\n  reason: \"ran\" | \"disabled\" | \"topk-zero\" | \"empty-input\";\n  /** Number of power-iteration rounds that executed. */\n  iterations: number;\n  /** Whether PPR's L1 delta fell below tolerance before the iter cap. */\n  converged: boolean;\n}\n\n/**\n * Pure graph retrieval run.\n *\n * 1. Short-circuits to `{ ran: false }` when the feature flag is off,\n *    `topK <= 0`, or the memory pool is empty. No graph is built, no\n *    PPR runs — this preserves the zero-cost guarantee for\n *    `recallGraphEnabled: false` (the default).\n * 2. Otherwise builds the retrieval graph from the candidate pool via\n *    `buildGraphFromMemories` (PR 2 extractor).\n * 3. Runs Personalized PageRank via `queryGraph` (PR 3).\n * 4. Projects ranked nodes to memory-typed ids only — entity and agent\n *    nodes never appear in the recall result set.\n */\nexport function runGraphRecall(\n  config: GraphRecallConfig,\n  options: GraphRecallOptions,\n): GraphRecallRun {\n  if (!config.recallGraphEnabled) {\n    return {\n      ran: false,\n      results: [],\n      graph: null,\n      reason: \"disabled\",\n      iterations: 0,\n      converged: true,\n    };\n  }\n\n  // `isFinite` guard on `topK` mirrors the checks on `damping` and\n  // `iterations` below. Without it a `NaN` topK would pass the typeof\n  // check, then `NaN <= 0` is false (bypassing the short-circuit) and\n  // the downstream `memoryResults.length >= topK` never triggers.\n  const topK =\n    typeof config.recallGraphTopK === \"number\" && Number.isFinite(config.recallGraphTopK)\n      ? config.recallGraphTopK\n      : 50;\n  if (topK <= 0) {\n    return {\n      ran: false,\n      results: [],\n      graph: null,\n      reason: \"topk-zero\",\n      iterations: 0,\n      converged: true,\n    };\n  }\n\n  if (options.memories.length === 0) {\n    return {\n      ran: false,\n      results: [],\n      graph: null,\n      reason: \"empty-input\",\n      iterations: 0,\n      converged: true,\n    };\n  }\n\n  const graph = buildGraphFromMemories(options.memories);\n\n  const damping =\n    typeof config.recallGraphDamping === \"number\" && Number.isFinite(config.recallGraphDamping)\n      ? config.recallGraphDamping\n      : DEFAULT_PPR_DAMPING;\n  const iterations =\n    typeof config.recallGraphIterations === \"number\" && Number.isFinite(config.recallGraphIterations)\n      ? config.recallGraphIterations\n      : DEFAULT_PPR_ITERATIONS;\n\n  // PPR runs without a topK so we can post-filter non-memory nodes without\n  // the trim dropping memory-typed results. We apply topK after projection.\n  const ppr = queryGraph(graph, options.seedIds, {\n    damping,\n    iterations,\n    seedWeights: options.seedWeights,\n  });\n\n  const memoryResults: GraphRecallResult[] = [];\n  for (const node of ppr.rankedNodes) {\n    const graphNode = graph.nodes.get(node.id);\n    if (!graphNode || graphNode.type !== \"memory\") continue;\n    memoryResults.push({ id: node.id, score: node.score });\n    if (memoryResults.length >= topK) break;\n  }\n\n  return {\n    ran: true,\n    results: memoryResults,\n    graph,\n    reason: \"ran\",\n    iterations: ppr.iterations,\n    converged: ppr.converged,\n  };\n}\n"],"mappings":";;;;;;;;AA4GO,SAAS,eACd,QACA,SACgB;AAChB,MAAI,CAAC,OAAO,oBAAoB;AAC9B,WAAO;AAAA,MACL,KAAK;AAAA,MACL,SAAS,CAAC;AAAA,MACV,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,YAAY;AAAA,MACZ,WAAW;AAAA,IACb;AAAA,EACF;AAMA,QAAM,OACJ,OAAO,OAAO,oBAAoB,YAAY,OAAO,SAAS,OAAO,eAAe,IAChF,OAAO,kBACP;AACN,MAAI,QAAQ,GAAG;AACb,WAAO;AAAA,MACL,KAAK;AAAA,MACL,SAAS,CAAC;AAAA,MACV,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,YAAY;AAAA,MACZ,WAAW;AAAA,IACb;AAAA,EACF;AAEA,MAAI,QAAQ,SAAS,WAAW,GAAG;AACjC,WAAO;AAAA,MACL,KAAK;AAAA,MACL,SAAS,CAAC;AAAA,MACV,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,YAAY;AAAA,MACZ,WAAW;AAAA,IACb;AAAA,EACF;AAEA,QAAM,QAAQ,uBAAuB,QAAQ,QAAQ;AAErD,QAAM,UACJ,OAAO,OAAO,uBAAuB,YAAY,OAAO,SAAS,OAAO,kBAAkB,IACtF,OAAO,qBACP;AACN,QAAM,aACJ,OAAO,OAAO,0BAA0B,YAAY,OAAO,SAAS,OAAO,qBAAqB,IAC5F,OAAO,wBACP;AAIN,QAAM,MAAM,WAAW,OAAO,QAAQ,SAAS;AAAA,IAC7C;AAAA,IACA;AAAA,IACA,aAAa,QAAQ;AAAA,EACvB,CAAC;AAED,QAAM,gBAAqC,CAAC;AAC5C,aAAW,QAAQ,IAAI,aAAa;AAClC,UAAM,YAAY,MAAM,MAAM,IAAI,KAAK,EAAE;AACzC,QAAI,CAAC,aAAa,UAAU,SAAS,SAAU;AAC/C,kBAAc,KAAK,EAAE,IAAI,KAAK,IAAI,OAAO,KAAK,MAAM,CAAC;AACrD,QAAI,cAAc,UAAU,KAAM;AAAA,EACpC;AAEA,SAAO;AAAA,IACL,KAAK;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA,QAAQ;AAAA,IACR,YAAY,IAAI;AAAA,IAChB,WAAW,IAAI;AAAA,EACjB;AACF;","names":[]}

package/dist/{chunk-3SV6CQHO.js → chunk-DIXB44VE.js}

@@ -6,7 +6,10 @@ import {
   ProactiveExtractionResultSchema,
   ProactiveQuestionsResultSchema,
   buildProfileConsolidationResultSchema
-} from "./chunk-UEYA6UC7.js";
+} from "./chunk-NZLQTHS5.js";
+import {
+  normalizeReasoningTrace
+} from "./chunk-54V4BZWP.js";
 import {
   ProfilingCollector
 } from "./chunk-NBNN5GOB.js";
@@ -15,18 +18,18 @@ import {
 } from "./chunk-FEMOX5AD.js";
 import {
   LocalLlmClient
-} from "./chunk-JL2PU6AI.js";
+} from "./chunk-R2XRID2N.js";
+import {
+  delinearize
+} from "./chunk-VEWZZM3H.js";
 import {
   buildExtensionsFooterForSummary,
   formatDaySummaryMemories,
   loadDaySummaryPrompt
 } from "./chunk-GZCUW5IC.js";
-import {
-  delinearize
-} from "./chunk-VEWZZM3H.js";
 import {
   FallbackLlmClient
-} from "./chunk-44ICJRF3.js";
+} from "./chunk-AYXIPSZO.js";
 import {
   buildChatCompletionTokenLimit,
   shouldAssumeOpenAiChatCompletions
@@ -50,6 +53,22 @@ import {
 // src/extraction.ts
 import OpenAI from "openai";
 var PROACTIVE_MIN_CONFIDENCE = 0.8;
+var CONSOLIDATION_RESPONSE_SCHEMA = `{
+  "items": [
+    {
+      "existingId": "id",
+      "action": "ADD",
+      "mergeWith": "optional-existing-id",
+      "updatedContent": "optional replacement content",
+      "reason": "brief reason for this action"
+    }
+  ],
+  "profileUpdates": ["optional profile update"],
+  "entityUpdates": [{"name": "person-jane-doe", "type": "person", "facts": ["Now leads the backend team", "Recently migrated the user service to TypeScript"]}]
+}`;
+function isPlainRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function normalizeQuestion(question) {
   const priority = Number.isFinite(question.priority) ? Math.max(0, Math.min(1, question.priority)) : 0.5;
   return {
@@ -168,7 +187,11 @@ var ExtractionEngine = class {
       structuredAttributes: f?.structuredAttributes && typeof f.structuredAttributes === "object" && !Array.isArray(f.structuredAttributes) ? Object.fromEntries(
         Object.entries(f.structuredAttributes).filter(([k, v]) => typeof k === "string" && typeof v === "string")
       ) : void 0,
-      procedureSteps: Array.isArray(f?.procedureSteps) ? normalizeProcedureSteps(f.procedureSteps) : void 0
+      procedureSteps: Array.isArray(f?.procedureSteps) ? normalizeProcedureSteps(f.procedureSteps) : void 0,
+      reasoningTrace: (() => {
+        const candidate = f?.reasoningTrace && typeof f.reasoningTrace === "object" && !Array.isArray(f.reasoningTrace) ? f.reasoningTrace : f?.reasoning_trace && typeof f.reasoning_trace === "object" && !Array.isArray(f.reasoning_trace) ? f.reasoning_trace : null;
+        return candidate ? normalizeReasoningTrace(candidate) ?? void 0 : void 0;
+      })()
     })).filter((f) => f.content.length > 0) : [];
     const questions = Array.isArray(parsed?.questions) ? parsed.questions.map((q) => {
       if (typeof q === "string") return { question: q, context: "", priority: 0.5 };
@@ -195,16 +218,32 @@ var ExtractionEngine = class {
     };
   }
   normalizeEntityUpdate(entity) {
+    const rawUpdates = isPlainRecord(entity?.updates) ? entity.updates : null;
+    const directFacts = Array.isArray(entity?.facts) ? entity.facts.filter((fact) => typeof fact === "string").map((fact) => fact.trim()).filter((fact) => fact.length > 0) : [];
+    const updateFacts = rawUpdates && Array.isArray(rawUpdates.facts) ? rawUpdates.facts.filter((fact) => typeof fact === "string").map((fact) => fact.trim()).filter((fact) => fact.length > 0) : [];
+    const scalarUpdateFacts = rawUpdates ? Object.keys(rawUpdates).sort((a, b) => a.localeCompare(b)).filter((key) => !["facts", "name", "promptedByQuestion", "structuredSections", "type"].includes(key)).flatMap((key) => {
+      const value = rawUpdates[key];
+      if (typeof value === "string" && value.trim().length > 0) {
+        return [`${key}: ${value.trim()}`];
+      }
+      if (typeof value === "number" || typeof value === "boolean") {
+        return [`${key}: ${String(value)}`];
+      }
+      return [];
+    }) : [];
+    const structuredSectionsSource = Array.isArray(entity?.structuredSections) ? entity.structuredSections : Array.isArray(rawUpdates?.structuredSections) ? rawUpdates.structuredSections : [];
+    const name = typeof entity?.name === "string" ? entity.name.trim() : typeof entity?.entityId === "string" ? entity.entityId.trim() : typeof rawUpdates?.name === "string" ? rawUpdates.name.trim() : "";
+    const type = typeof entity?.type === "string" && entity.type.trim().length > 0 ? entity.type.trim() : typeof rawUpdates?.type === "string" && rawUpdates.type.trim().length > 0 ? rawUpdates.type.trim() : "other";
     return {
-      name: typeof entity?.name === "string" ? entity.name : "",
-      type: typeof entity?.type === "string" ? entity.type : "other",
-      facts: Array.isArray(entity?.facts) ? entity.facts.filter((fact) => typeof fact === "string") : [],
-      structuredSections: Array.isArray(entity?.structuredSections) ? entity.structuredSections.map((section) => ({
+      name,
+      type,
+      facts: [...directFacts, ...updateFacts, ...scalarUpdateFacts],
+      structuredSections: structuredSectionsSource.length > 0 ? structuredSectionsSource.map((section) => ({
         key: typeof section?.key === "string" ? section.key.trim() : "",
         title: typeof section?.title === "string" ? section.title.trim() : "",
         facts: Array.isArray(section?.facts) ? section.facts.filter((fact) => typeof fact === "string").map((fact) => fact.trim()).filter((fact) => fact.length > 0) : []
       })).filter((section) => section.key.length > 0 && section.title.length > 0 && section.facts.length > 0) : void 0,
-      promptedByQuestion: typeof entity?.promptedByQuestion === "string" ? entity.promptedByQuestion : void 0
+      promptedByQuestion: typeof entity?.promptedByQuestion === "string" ? entity.promptedByQuestion : typeof rawUpdates?.promptedByQuestion === "string" ? rawUpdates.promptedByQuestion : void 0
     };
   }
   parseJsonObject(content) {
@@ -264,15 +303,36 @@ var ExtractionEngine = class {
     return normalized.summary.length > 0 ? normalized : null;
   }
   sanitizeConsolidationResult(result) {
-    const items = result.items.map((item) => {
-      if (!item.updatedContent) return item;
-      const sanitized = sanitizeMemoryContent(item.updatedContent);
+    const items = [];
+    for (const item of Array.isArray(result.items) ? result.items : []) {
+      const rawAction = typeof item?.action === "string" ? item.action.toUpperCase() : "SKIP";
+      const action = rawAction === "ADD" || rawAction === "MERGE" || rawAction === "UPDATE" || rawAction === "INVALIDATE" || rawAction === "SKIP" ? rawAction : "SKIP";
+      const existingId = typeof item?.existingId === "string" ? item.existingId.trim() : typeof item?.newMemoryId === "string" ? item.newMemoryId.trim() : typeof item?.memoryId === "string" ? item.memoryId.trim() : "";
+      if (!existingId) continue;
+      const mergeWith = typeof item?.mergeWith === "string" ? item.mergeWith : void 0;
+      const reason = typeof item?.reason === "string" ? item.reason : "";
+      const rawUpdatedContent = typeof item?.updatedContent === "string" ? item.updatedContent : void 0;
+      if (!rawUpdatedContent) {
+        items.push({ existingId, action, mergeWith, updatedContent: void 0, reason });
+        continue;
+      }
+      const sanitized = sanitizeMemoryContent(rawUpdatedContent);
       if (!sanitized.clean) {
-        log.warn(`consolidation item sanitized (${item.existingId}); violations=${sanitized.violations.join(", ")}`);
+        log.warn(`consolidation item sanitized (${existingId}); violations=${sanitized.violations.join(", ")}`);
       }
-      return { ...item, updatedContent: sanitized.text };
-    });
-    return { ...result, items };
+      items.push({
+        existingId,
+        action,
+        mergeWith,
+        updatedContent: sanitized.text,
+        reason
+      });
+    }
+    const profileUpdates = (Array.isArray(result.profileUpdates) ? result.profileUpdates : []).map(
+      (update) => typeof update === "string" ? update.trim() : typeof update?.content === "string" ? update.content.trim() : ""
+    ).filter((update) => update.length > 0);
+    const entityUpdates = (Array.isArray(result.entityUpdates) ? result.entityUpdates : []).map((entity) => this.normalizeEntityUpdate(entity)).filter((entity) => entity.name.length > 0);
+    return { items, profileUpdates, entityUpdates };
   }
   async applyProactiveQuestionPass(conversation, base) {
     if (!this.config.proactiveExtractionEnabled) return base;
@@ -762,8 +822,16 @@ var ExtractionEngine = class {
           log.debug(
             `extracted ${result.facts.length} facts, ${result.entities.length} entities, ${(result.questions ?? []).length} questions via fallback (${detailed.modelUsed})`
           );
+          const normalizedFacts = result.facts.map((f) => {
+            if (!f?.reasoningTrace) return f;
+            return {
+              ...f,
+              reasoningTrace: normalizeReasoningTrace(f.reasoningTrace) ?? void 0
+            };
+          });
           const sanitized = this.sanitizeExtractionResult({
             ...result,
+            facts: normalizedFacts,
             questions: result.questions ?? [],
             identityReflection: result.identityReflection ?? void 0
           }, messageTimestamp);
@@ -831,6 +899,7 @@ Memory categories \u2014 use the MOST SPECIFIC category that fits:
 - skill: Demonstrated capabilities
 - rule: Explicit operational rules or constraints
 - procedure: Repeatable workflows \u2014 use when the user describes a multi-step play (\u22652 ordered steps). Put the human-readable trigger/context in "content" (e.g. "When you deploy\u2026") and list steps in "procedureSteps" as [{"order":1,"intent":"\u2026"}, \u2026] mirroring the gateway extraction schema.
+- reasoning_trace: Stored solution chains \u2014 use when the user narrates HOW they solved a specific problem step-by-step ("here's how I figured out\u2026", "the debugging went like this\u2026"). Put a short title in "content" (e.g. "How I debugged the staging latency spike") and the chain in "reasoningTrace": {"steps":[{"order":1,"description":"\u2026"}, \u2026], "finalAnswer":"\u2026", "observedOutcome":"\u2026" (optional)}. Require \u22652 ordered steps and a finalAnswer. Do NOT use for ordinary decisions (prefer "decision") or reusable workflows (prefer "procedure").
 
 IMPORTANT: Do NOT label everything as "fact". Use "decision" for architectural choices, "commitment" for deadlines/promises, "principle" for reusable rules, "correction" for when the user rejects a suggestion, etc.
 
@@ -892,7 +961,7 @@ Also generate:
 
 Output JSON:
 {
-  "facts": [{"category": "decision", "content": "Chose PostgreSQL over MongoDB for the user service", "importance": 8, "confidence": 0.9, "structuredAttributes": {"chosen": "PostgreSQL", "rejected": "MongoDB"}}, {"category": "procedure", "content": "When you cut a hotfix release, follow the checklist", "importance": 8, "confidence": 0.9, "procedureSteps": [{"order": 1, "intent": "Branch from main and cherry-pick the fix"}, {"order": 2, "intent": "Run CI and tag the release"}]}, {"category": "commitment", "content": "Must ship v2.0 API by end of March", "importance": 10, "confidence": 1.0, "structuredAttributes": {"deadline": "end of March", "deliverable": "v2.0 API"}}, {"category": "fact", "content": "The store backend uses Redis for session caching", "importance": 6, "confidence": 0.95, "entityRef": "project-acme-store"}, {"category": "principle", "content": "Always run migrations in a transaction to avoid partial schema updates", "importance": 8, "confidence": 0.9}],
+  "facts": [{"category": "decision", "content": "Chose PostgreSQL over MongoDB for the user service", "importance": 8, "confidence": 0.9, "structuredAttributes": {"chosen": "PostgreSQL", "rejected": "MongoDB"}}, {"category": "procedure", "content": "When you cut a hotfix release, follow the checklist", "importance": 8, "confidence": 0.9, "procedureSteps": [{"order": 1, "intent": "Branch from main and cherry-pick the fix"}, {"order": 2, "intent": "Run CI and tag the release"}]}, {"category": "reasoning_trace", "content": "How I debugged the staging latency spike", "importance": 7, "confidence": 0.9, "reasoningTrace": {"steps": [{"order": 1, "description": "Checked CPU/memory dashboards \u2014 both were flat"}, {"order": 2, "description": "Ran a traceroute and saw retries against the cache tier"}, {"order": 3, "description": "Tailed cache-tier logs and spotted eviction storms"}], "finalAnswer": "Root cause was an undersized eviction policy on the session cache", "observedOutcome": "Increased cache size, p95 returned to baseline within 10 minutes"}}, {"category": "commitment", "content": "Must ship v2.0 API by end of March", "importance": 10, "confidence": 1.0, "structuredAttributes": {"deadline": "end of March", "deliverable": "v2.0 API"}}, {"category": "fact", "content": "The store backend uses Redis for session caching", "importance": 6, "confidence": 0.95, "entityRef": "project-acme-store"}, {"category": "principle", "content": "Always run migrations in a transaction to avoid partial schema updates", "importance": 8, "confidence": 0.9}],
   "entities": [{"name": "person-jane-doe", "type": "person", "facts": ["Works at Acme Corp", "Prefers Python over JavaScript"], "structuredSections": [{"key": "beliefs", "title": "Beliefs", "facts": ["Python is a better fit than JavaScript for backend work."]}]}, {"name": "project-acme-store", "type": "project", "facts": ["Built with Next.js", "Deployed on Vercel"]}],
   "profileUpdates": ["User prefers dark mode in all editors"],
   "questions": [{"question": "Which cloud provider hosts the staging environment?", "context": "Came up during deployment discussion", "priority": 0.5}],
@@ -969,7 +1038,7 @@ ${truncatedConversation}`;
 
 Respond with valid JSON matching this schema:
 {
-  "facts": [{"category": "decision", "content": "Chose React over Vue for the dashboard rewrite", "importance": 8, "confidence": 0.9, "tags": ["frontend"], "structuredAttributes": {"chosen": "React", "rejected": "Vue"}}, {"category": "fact", "content": "The API gateway uses rate limiting at 1000 req/min", "importance": 6, "confidence": 0.95, "tags": ["infra"], "entityRef": "project-dashboard", "structuredAttributes": {"rate_limit": "1000 req/min"}}],
+  "facts": [{"category": "decision", "content": "Chose React over Vue for the dashboard rewrite", "importance": 8, "confidence": 0.9, "tags": ["frontend"], "structuredAttributes": {"chosen": "React", "rejected": "Vue"}}, {"category": "fact", "content": "The API gateway uses rate limiting at 1000 req/min", "importance": 6, "confidence": 0.95, "tags": ["infra"], "entityRef": "project-dashboard", "structuredAttributes": {"rate_limit": "1000 req/min"}}, {"category": "reasoning_trace", "content": "How I chose the dashboard rewrite framework", "confidence": 0.9, "tags": ["frontend"], "reasoningTrace": {"steps": [{"order": 1, "description": "Listed constraints: SSR needed, team mostly JS"}, {"order": 2, "description": "Ran a spike in Vue 3 \u2014 worked, but ecosystem felt thin for our needs"}, {"order": 3, "description": "Ran the same spike in React \u2014 integrated faster with Next.js"}], "finalAnswer": "Picked React with Next.js for SSR + ecosystem fit"}}],
   "entities": [{"name": "person-sarah-chen", "type": "person", "facts": ["Leads the backend team", "Joined from Google in 2024"], "structuredSections": [{"key": "beliefs", "title": "Beliefs", "facts": ["Small teams should own whole systems."]}]}, {"name": "project-dashboard", "type": "project", "facts": ["React-based admin panel", "Deployed on AWS ECS"]}],
   "profileUpdates": ["User prefers TypeScript over plain JavaScript"],
   "questions": [{"question": "What database does the analytics service use?", "context": "Came up during discussion of migration plan", "priority": 0.5}],
@@ -1015,7 +1084,8 @@ Respond with valid JSON matching this schema:
       "moment",
       "skill",
       "rule",
-      "procedure"
+      "procedure",
+      "reasoning_trace"
     ]);
     const allowedEntityTypes = /* @__PURE__ */ new Set([
       "person",
@@ -1073,6 +1143,7 @@ Memory categories:
 - skill: Capabilities the user or agent has demonstrated (e.g., "user is proficient with Kubernetes")${this.config.causalRuleExtractionEnabled ? `
 - rule: Causal rules discovered through experience (format: "IF <condition> THEN <action/outcome>", e.g., "IF Shopify API returns 401 THEN the admin token is missing read_products scope")` : ""}
 - procedure: A reusable workflow the user wants remembered the same way across sessions. Set category to "procedure". Use "content" for a short title that includes explicit trigger phrasing (e.g. "When you deploy to production\u2026", "Whenever you ship a release\u2026"). Add "procedureSteps": an array of at least two objects {"order": number, "intent": "concrete step description"} in execution order. Optional per-step "toolCall": {"kind": "\u2026", "signature": "\u2026"}, "expectedOutcome", "optional": true.
+- reasoning_trace: A stored solution chain / chain-of-thought the user walked through to solve a problem (e.g. "Here's how I debugged the latency spike: first I checked\u2026, then I\u2026, finally I\u2026"). Set category to "reasoning_trace". Use "content" for a short title summarising the problem (e.g. "How I debugged the staging latency spike"). Add "reasoningTrace": {"steps": [{"order": number, "description": "what happened at this step"}, \u2026], "finalAnswer": "the conclusion or answer", "observedOutcome": "optional confirmation of how it played out"}. Require at least two ordered steps AND a finalAnswer. Use this category only when the user explicitly narrates their reasoning \u2014 not for ordinary decisions (use "decision") or reusable workflows (use "procedure").
 
 Rules:
 - Only extract genuinely NEW information worth remembering across sessions
@@ -1193,15 +1264,10 @@ Consolidate the new memories against existing ones.`
     );
     if (fallbackResult) {
       log.debug(`consolidation: ${fallbackResult.items.length} decisions via fallback`);
-      const normalizedEntityUpdates = fallbackResult.entityUpdates.map((entity) => this.normalizeEntityUpdate(entity));
       return this.sanitizeConsolidationResult({
-        items: fallbackResult.items.map((item) => ({
-          ...item,
-          mergeWith: item.mergeWith ?? void 0,
-          updatedContent: item.updatedContent ?? void 0
-        })),
+        items: fallbackResult.items,
         profileUpdates: fallbackResult.profileUpdates,
-        entityUpdates: normalizedEntityUpdates
+        entityUpdates: fallbackResult.entityUpdates
       });
     }
     if (!this.client) {
@@ -1233,19 +1299,7 @@ New memories to consolidate:
 ${newList}
 
 Respond with valid JSON only, matching this schema:
-{
-  "items": [
-    {
-      "existingId": "id",
-      "action": "ADD",
-      "mergeWith": "optional-existing-id",
-      "updatedContent": "optional replacement content",
-      "reason": "brief reason for this action"
-    }
-  ],
-  "profileUpdates": ["optional profile update"],
-  "entityUpdates": [{"name": "person-jane-doe", "type": "person", "facts": ["Now leads the backend team", "Recently migrated the user service to TypeScript"]}]
-}`;
+${CONSOLIDATION_RESPONSE_SCHEMA}`;
       const response = await this.client.chat.completions.create({
         model: this.config.model,
         messages: [
@@ -1280,25 +1334,13 @@ Respond with valid JSON only, matching this schema:
         tokenUsage: cUsage ? { input: cUsage.prompt_tokens, output: cUsage.completion_tokens, total: cUsage.total_tokens } : void 0
       });
       if (parsed && Array.isArray(parsed.items)) {
-        const normalizedItems = parsed.items.map((item) => {
-          const rawAction = typeof item?.action === "string" ? item.action.toUpperCase() : "SKIP";
-          const action = rawAction === "ADD" || rawAction === "MERGE" || rawAction === "UPDATE" || rawAction === "INVALIDATE" || rawAction === "SKIP" ? rawAction : "SKIP";
-          return {
-            existingId: typeof item?.existingId === "string" ? item.existingId : typeof item?.newMemoryId === "string" ? item.newMemoryId : "",
-            action,
-            mergeWith: typeof item?.mergeWith === "string" ? item.mergeWith : void 0,
-            updatedContent: typeof item?.updatedContent === "string" ? item.updatedContent : void 0,
-            reason: typeof item?.reason === "string" ? item.reason : ""
-          };
-        }).filter((item) => item.existingId.length > 0);
-        const normalizedEntityUpdates = Array.isArray(parsed.entityUpdates) ? parsed.entityUpdates.map((entity) => this.normalizeEntityUpdate(entity)).filter((entity) => entity.name.length > 0) : [];
         log.debug(
-          `consolidation: ${normalizedItems.length} decisions`
+          `consolidation: ${parsed.items.length} decisions`
         );
         return this.sanitizeConsolidationResult({
-          items: normalizedItems,
-          profileUpdates: Array.isArray(parsed.profileUpdates) ? parsed.profileUpdates.filter((update) => typeof update === "string" && update.trim().length > 0) : [],
-          entityUpdates: normalizedEntityUpdates
+          items: parsed.items,
+          profileUpdates: Array.isArray(parsed.profileUpdates) ? parsed.profileUpdates : [],
+          entityUpdates: Array.isArray(parsed.entityUpdates) ? parsed.entityUpdates : []
         });
       }
       log.warn("consolidation returned no parsed output");
@@ -1349,13 +1391,7 @@ New memories to consolidate:
 ${newList}
 
 Respond with valid JSON matching this schema:
-{
-  "items": [
-    {"memoryId": "id", "action": "ADD|MERGE|UPDATE|INVALIDATE|SKIP", "reason": "why", "updatedContent": "optional new content"}
-  ],
-  "profileUpdates": [{"section": "section name", "content": "new bullet"}],
-  "entityUpdates": [{"entityId": "id", "updates": {"field": "value"}}]
-}`;
+${CONSOLIDATION_RESPONSE_SCHEMA}`;
     const response = await this.localLlm.chatCompletion(
       [
         { role: "system", content: "You are a memory consolidation system. Output valid JSON only." },
@@ -2224,4 +2260,4 @@ ${memoryList}` }
 export {
   ExtractionEngine
 };
-//# sourceMappingURL=chunk-3SV6CQHO.js.map
+//# sourceMappingURL=chunk-DIXB44VE.js.map