@remnic/core 1.0.3 → 1.1.1

package/dist/chunk-ZZTOURJI.js

@@ -0,0 +1,91 @@
+// src/reasoning-trace-recall.ts
+function looksLikeProblemSolvingQuery(query) {
+  if (typeof query !== "string") return false;
+  const q = query.trim().toLowerCase();
+  if (q.length === 0) return false;
+  const startsWithPatterns = [
+    /^how\s+do\s+i\b/,
+    /^how\s+can\s+i\b/,
+    /^how\s+would\s+i\b/,
+    /^how\s+should\s+i\b/,
+    /^how\s+to\b/,
+    /^what'?s?\s+the\s+best\s+way\s+to\b/,
+    /^can\s+you\s+walk\s+me\s+through\b/,
+    /^walk\s+me\s+through\b/,
+    /^help\s+me\s+debug\b/,
+    /^help\s+me\s+figure\s+out\b/,
+    /^why\s+(does|is|did)\b/
+  ];
+  for (const re of startsWithPatterns) {
+    if (re.test(q)) return true;
+  }
+  const phrases = [
+    "step by step",
+    "step-by-step",
+    "work through",
+    "walk through",
+    "walk me through",
+    "reason through",
+    "think through",
+    "figure out",
+    "chain of thought",
+    "reasoning trace",
+    "solution chain",
+    "troubleshoot",
+    "debug this",
+    "debug the",
+    " debug "
+  ];
+  for (const phrase of phrases) {
+    if (q.includes(phrase)) return true;
+  }
+  return false;
+}
+function isReasoningTracePath(candidatePath) {
+  if (typeof candidatePath !== "string") return false;
+  return /(^|[\\/])reasoning-traces([\\/]|$)/.test(candidatePath);
+}
+var DEFAULT_REASONING_TRACE_BOOST = 0.15;
+function applyReasoningTraceBoost(results, options) {
+  if (!options.enabled) return [...results];
+  if (!Array.isArray(results) || results.length === 0) return [...results];
+  if (!looksLikeProblemSolvingQuery(options.query)) return [...results];
+  const boostAmount = typeof options.boost === "number" && Number.isFinite(options.boost) && options.boost >= 0 ? options.boost : DEFAULT_REASONING_TRACE_BOOST;
+  const boosted = [];
+  let changed = false;
+  for (const r of results) {
+    if (isReasoningTracePath(r.path)) {
+      changed = true;
+      const baseScore = typeof r.score === "number" && Number.isFinite(r.score) ? r.score : 0;
+      boosted.push({ ...r, score: baseScore + boostAmount });
+    } else {
+      boosted.push(r);
+    }
+  }
+  if (!changed) return boosted;
+  const out = boosted.slice();
+  for (let i = 0; i < out.length; i++) {
+    if (!isReasoningTracePath(out[i].path)) continue;
+    const trace = out[i];
+    const traceScore = typeof trace.score === "number" && Number.isFinite(trace.score) ? trace.score : 0;
+    let j = i;
+    while (j > 0) {
+      const prev = out[j - 1];
+      if (isReasoningTracePath(prev.path)) break;
+      const prevScore = typeof prev.score === "number" && Number.isFinite(prev.score) ? prev.score : 0;
+      if (prevScore >= traceScore) break;
+      out[j] = prev;
+      j -= 1;
+    }
+    if (j !== i) out[j] = trace;
+  }
+  return out;
+}
+
+export {
+  looksLikeProblemSolvingQuery,
+  isReasoningTracePath,
+  DEFAULT_REASONING_TRACE_BOOST,
+  applyReasoningTraceBoost
+};
+//# sourceMappingURL=chunk-ZZTOURJI.js.map

package/dist/chunk-ZZTOURJI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/reasoning-trace-recall.ts"],"sourcesContent":["/**\n * Reasoning-trace recall boost (issue #564 PR 3).\n *\n * Pure helpers for:\n * - detecting whether a user query looks like a problem-solving ask\n *   (\"how do I…\", \"step by step\", etc.)\n * - boosting stored reasoning_trace memories within a result list when that\n *   condition matches.\n *\n * Callers gate these helpers behind the `recallReasoningTraceBoostEnabled`\n * config flag (default false); the helpers themselves are also no-ops when\n * `enabled` is false so they can be safely chained into the recall pipeline.\n */\n\n/**\n * Heuristic: does the incoming query read like the user wants a stored\n * solution chain (reasoning trace)?\n *\n * Positive signals:\n *  - starts with \"how do I\", \"how can I\", \"how would I\", \"how to\"\n *  - contains \"step by step\", \"walk me through\", \"work through\"\n *  - contains \"reasoning\", \"think through\", \"figure out\", \"debug\"\n *  - explicitly mentions \"trace\" or \"chain of thought\"\n *\n * This is intentionally conservative — the boost is OFF by default, so false\n * negatives are cheap, but false positives would shift retrieval for ordinary\n * queries on an opt-in install.\n */\nexport function looksLikeProblemSolvingQuery(query: string): boolean {\n  if (typeof query !== \"string\") return false;\n  const q = query.trim().toLowerCase();\n  if (q.length === 0) return false;\n\n  // Starts-with patterns.\n  const startsWithPatterns = [\n    /^how\\s+do\\s+i\\b/,\n    /^how\\s+can\\s+i\\b/,\n    /^how\\s+would\\s+i\\b/,\n    /^how\\s+should\\s+i\\b/,\n    /^how\\s+to\\b/,\n    /^what'?s?\\s+the\\s+best\\s+way\\s+to\\b/,\n    /^can\\s+you\\s+walk\\s+me\\s+through\\b/,\n    /^walk\\s+me\\s+through\\b/,\n    /^help\\s+me\\s+debug\\b/,\n    /^help\\s+me\\s+figure\\s+out\\b/,\n    /^why\\s+(does|is|did)\\b/,\n  ];\n  for (const re of startsWithPatterns) {\n    if (re.test(q)) return true;\n  }\n\n  // Anywhere-in-string phrases. These mirror the doc-comment's stated\n  // positive signals: broader variants (\"work through\", \"figure out\",\n  // \"debug this\") are included so \"how do I debug this\" doesn't have to\n  // lean on the `help me debug` starts-with entry alone, and so queries\n  // like \"work through the problem\" or \"figure out why it broke\" trigger\n  // the heuristic as the docstring claims.\n  const phrases = [\n    \"step by step\",\n    \"step-by-step\",\n    \"work through\",\n    \"walk through\",\n    \"walk me through\",\n    \"reason through\",\n    \"think through\",\n    \"figure out\",\n    \"chain of thought\",\n    \"reasoning trace\",\n    \"solution chain\",\n    \"troubleshoot\",\n    \"debug this\",\n    \"debug the\",\n    \" debug \",\n  ];\n  for (const phrase of phrases) {\n    if (q.includes(phrase)) return true;\n  }\n\n  return false;\n}\n\n/**\n * Minimal shape the boost helper needs to read from a recall result. Matches\n * QmdSearchResult as of issue #564 but kept structural so tests and future\n * callers don't have to import orchestrator-level types.\n */\nexport interface BoostableResult {\n  path: string;\n  score: number;\n  docid?: string;\n}\n\n/**\n * Path-based marker for memories that live in the dedicated\n * reasoning-traces/ subtree. Using a path segment keeps this cheap: no\n * frontmatter parsing or extra I/O is needed.\n */\nexport function isReasoningTracePath(candidatePath: string): boolean {\n  if (typeof candidatePath !== \"string\") return false;\n  // Match \"/reasoning-traces/\" as a full path segment to avoid false\n  // positives like \"my-reasoning-traces-notes/\".\n  return /(^|[\\\\/])reasoning-traces([\\\\/]|$)/.test(candidatePath);\n}\n\n/**\n * Default additive boost applied to a reasoning_trace candidate when the\n * current query looks like a problem-solving ask.\n *\n * Chosen to be roughly the same magnitude as the existing CATEGORY_BOOSTS\n * entry for reasoning_trace (0.09 in importance scoring), keeping the signal\n * visible but not overwhelming stronger lexical/vector matches.\n */\nexport const DEFAULT_REASONING_TRACE_BOOST = 0.15;\n\nexport interface ApplyReasoningTraceBoostOptions {\n  enabled: boolean;\n  query: string;\n  boost?: number;\n}\n\n/**\n * Apply a score boost to results whose path sits under reasoning-traces/\n * when the query looks like a problem-solving ask. Returns a new array;\n * the input array is not mutated.\n *\n * Ordering policy: the helper walks the results in order, boosts every\n * matching reasoning trace in place, then promotes each boosted trace\n * upward PAST any non-boosted neighbor whose score is strictly lower\n * than the trace's boosted score. Non-matching results keep their\n * incoming relative order — so reranker-driven path ordering and any\n * other upstream nudges on non-trace items are preserved. We do NOT\n * re-sort the full list, which would wipe out rerank priority on\n * non-trace items (whose numeric scores may have been left stale by the\n * rerank pass). This matters because MMR runs immediately after and\n * truncates to a topN window — globally re-sorting would silently drop\n * reranker-promoted items below the cutoff.\n *\n * No-ops (returns a copy of the input unchanged) when:\n *  - `enabled` is false,\n *  - `query` is empty / not a problem-solving ask,\n *  - the result list contains no reasoning-trace paths.\n *\n * Note on legacy paths: this helper intentionally only matches paths\n * under the dedicated `reasoning-traces/` subtree introduced by PR 3.\n * Historical reasoning_trace memories (if any) written before that\n * subtree existed were routed to `facts/<date>/` and are NOT\n * boost-eligible. Operators upgrading across that boundary should run\n * the migration CLI or rewrite old paths before enabling the boost.\n */\nexport function applyReasoningTraceBoost<R extends BoostableResult>(\n  results: readonly R[],\n  options: ApplyReasoningTraceBoostOptions,\n): R[] {\n  if (!options.enabled) return [...results];\n  if (!Array.isArray(results) || results.length === 0) return [...results];\n  if (!looksLikeProblemSolvingQuery(options.query)) return [...results];\n\n  const boostAmount =\n    typeof options.boost === \"number\" && Number.isFinite(options.boost) && options.boost >= 0\n      ? options.boost\n      : DEFAULT_REASONING_TRACE_BOOST;\n\n  // Step 1: boost the scores of matching traces, preserving positions.\n  const boosted: R[] = [];\n  let changed = false;\n  for (const r of results) {\n    if (isReasoningTracePath(r.path)) {\n      changed = true;\n      const baseScore = typeof r.score === \"number\" && Number.isFinite(r.score) ? r.score : 0;\n      boosted.push({ ...r, score: baseScore + boostAmount } as R);\n    } else {\n      boosted.push(r);\n    }\n  }\n  if (!changed) return boosted;\n\n  // Step 2: promote each boosted trace upward past any non-trace neighbor\n  // whose score is strictly lower than the boosted score. Non-trace items\n  // never move past each other, so reranker-driven ordering on non-trace\n  // items is preserved.\n  const out = boosted.slice();\n  for (let i = 0; i < out.length; i++) {\n    if (!isReasoningTracePath(out[i].path)) continue;\n    const trace = out[i];\n    const traceScore =\n      typeof trace.score === \"number\" && Number.isFinite(trace.score) ? trace.score : 0;\n    let j = i;\n    while (j > 0) {\n      const prev = out[j - 1];\n      if (isReasoningTracePath(prev.path)) break; // don't reorder traces vs each other\n      const prevScore =\n        typeof prev.score === \"number\" && Number.isFinite(prev.score) ? prev.score : 0;\n      if (prevScore >= traceScore) break;\n      out[j] = prev;\n      j -= 1;\n    }\n    if (j !== i) out[j] = trace;\n  }\n\n  return out;\n}\n"],"mappings":";AA4BO,SAAS,6BAA6B,OAAwB;AACnE,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,IAAI,MAAM,KAAK,EAAE,YAAY;AACnC,MAAI,EAAE,WAAW,EAAG,QAAO;AAG3B,QAAM,qBAAqB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,aAAW,MAAM,oBAAoB;AACnC,QAAI,GAAG,KAAK,CAAC,EAAG,QAAO;AAAA,EACzB;AAQA,QAAM,UAAU;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,aAAW,UAAU,SAAS;AAC5B,QAAI,EAAE,SAAS,MAAM,EAAG,QAAO;AAAA,EACjC;AAEA,SAAO;AACT;AAkBO,SAAS,qBAAqB,eAAgC;AACnE,MAAI,OAAO,kBAAkB,SAAU,QAAO;AAG9C,SAAO,qCAAqC,KAAK,aAAa;AAChE;AAUO,IAAM,gCAAgC;AAqCtC,SAAS,yBACd,SACA,SACK;AACL,MAAI,CAAC,QAAQ,QAAS,QAAO,CAAC,GAAG,OAAO;AACxC,MAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,QAAQ,WAAW,EAAG,QAAO,CAAC,GAAG,OAAO;AACvE,MAAI,CAAC,6BAA6B,QAAQ,KAAK,EAAG,QAAO,CAAC,GAAG,OAAO;AAEpE,QAAM,cACJ,OAAO,QAAQ,UAAU,YAAY,OAAO,SAAS,QAAQ,KAAK,KAAK,QAAQ,SAAS,IACpF,QAAQ,QACR;AAGN,QAAM,UAAe,CAAC;AACtB,MAAI,UAAU;AACd,aAAW,KAAK,SAAS;AACvB,QAAI,qBAAqB,EAAE,IAAI,GAAG;AAChC,gBAAU;AACV,YAAM,YAAY,OAAO,EAAE,UAAU,YAAY,OAAO,SAAS,EAAE,KAAK,IAAI,EAAE,QAAQ;AACtF,cAAQ,KAAK,EAAE,GAAG,GAAG,OAAO,YAAY,YAAY,CAAM;AAAA,IAC5D,OAAO;AACL,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACA,MAAI,CAAC,QAAS,QAAO;AAMrB,QAAM,MAAM,QAAQ,MAAM;AAC1B,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;AACnC,QAAI,CAAC,qBAAqB,IAAI,CAAC,EAAE,IAAI,EAAG;AACxC,UAAM,QAAQ,IAAI,CAAC;AACnB,UAAM,aACJ,OAAO,MAAM,UAAU,YAAY,OAAO,SAAS,MAAM,KAAK,IAAI,MAAM,QAAQ;AAClF,QAAI,IAAI;AACR,WAAO,IAAI,GAAG;AACZ,YAAM,OAAO,IAAI,IAAI,CAAC;AACtB,UAAI,qBAAqB,KAAK,IAAI,EAAG;AACrC,YAAM,YACJ,OAAO,KAAK,UAAU,YAAY,OAAO,SAAS,KAAK,KAAK,IAAI,KAAK,QAAQ;AAC/E,UAAI,aAAa,WAAY;AAC7B,UAAI,CAAC,IAAI;AACT,WAAK;AAAA,IACP;AACA,QAAI,MAAM,EAAG,KAAI,CAAC,IAAI;AAAA,EACxB;AAEA,SAAO;AACT;","names":[]}

package/dist/{cli-DwIBnp2g.d.ts → cli-BkeRaYfk.d.ts}

@@ -1,9 +1,9 @@
-import { R as ReplaySource, a as ReplayWarning, b as ImportTurn, B as BulkImportSource, c as BulkImportOptions, d as BulkImportResult, e as ReplayTurn, O as Orchestrator, C as CompoundingPromotionReport } from './orchestrator-B9kwlCep.js';
+import { R as ReplaySource, a as ReplayWarning, b as ImportTurn, B as BulkImportSource, c as BulkImportOptions, d as BulkImportResult, e as ReplayTurn, O as Orchestrator, C as CompoundingPromotionReport } from './orchestrator-CmJ-NTdJ.js';
 import { M as MemoryGovernanceRunResult, c as MemoryGovernanceSummary, d as MemoryGovernanceMetrics, e as MemoryGovernanceQualityScore, f as MemoryGovernanceReviewQueueEntry, g as MemoryGovernanceAppliedAction, h as MemoryGovernanceTransitionReport, i as MemoryGovernanceManifest, j as MemoryGovernanceRestoreManifest, R as RestoreMemoryGovernanceRunResult } from './memory-projection-store-DeSXPh1j.js';
 import { MemoryStatus, MemoryFile, BehaviorSignalEvent, MemoryActionEvent, MemoryLifecycleEvent } from './types.js';
 import { Writable, Readable } from 'node:stream';
 import { DashboardStatus } from './dashboard-runtime.js';
-import { EngramAccessService } from './access-service.js';
+import { E as EngramAccessService } from './access-service-Br8ZydTK.js';
 import { EvalBaselineDeltaReport, EvalBaselineSnapshot, EvalCiGateReport, EvalBenchmarkPackSummary, EvalHarnessStatus, EvalStoredBaselineCiGateReport } from './evals.js';
 import { GraphHealthReport } from './graph.js';
 import { CausalTrajectoryStoreStatus } from './causal-trajectory.js';

package/dist/cli.d.ts

@@ -1,10 +1,10 @@
-import './orchestrator-B9kwlCep.js';
-export { A as AccessHttpServeCliCommandOptions, c as ArchiveObservationsCliCommandOptions, B as BulkImportCliCommandOptions, C as CompatCliCommandOptions, d as ConversationIndexHealthCliOrchestrator, D as DashboardStartCliCommandOptions, e as DedupeCandidate, E as ExactDedupePlan, G as GraphHealthCliCommandOptions, M as MemoryActionAuditCliCommandOptions, g as MemoryActionAuditCliNamespaceSummary, h as MemoryActionAuditCliReport, i as MemoryGovernanceCliCommandOptions, j as MemoryGovernanceReportCliCommandOptions, k as MemoryGovernanceRestoreCliCommandOptions, l as MemoryReviewDispositionCliCommandOptions, m as MemoryTimelineCliCommandOptions, n as MigrateCliOrchestrator, o as MigrateCliReport, q as MigrateObservationsCliCommandOptions, s as PolicyDiffCliReport, t as PolicyDiffEntry, u as PolicyRollbackCliReport, v as PolicyStatusCliReport, w as PolicyTuningCliOrchestrator, R as RebuildMemoryLifecycleLedgerCliCommandOptions, x as RebuildMemoryProjectionCliCommandOptions, y as RebuildObservationsCliCommandOptions, z as RepairMemoryProjectionCliCommandOptions, F as ReplayCliCommandOptions, H as ReplayCliOrchestrator, I as RouteCliCommandOptions, S as SessionIntegrityCliCommandOptions, J as SessionRepairCliCommandOptions, T as TailscaleStatusCliCommandOptions, K as TailscaleSyncCliCommandOptions, L as TierMigrationCliOrchestrator, N as TrainingExportCliCommandOptions, V as VerifyMemoryProjectionCliCommandOptions, W as WebDavServeCliCommandOptions, O as WorkProjectCliCommandOptions, Q as WorkTaskCliCommandOptions, U as parseStrictCliDate, X as planAggressiveDuplicateDeletions, Y as planExactDuplicateDeletions, Z as registerCli, _ as resolveAccessPrincipalOverride, $ as resolveMemoryDirForNamespace, a0 as runAbstractionNodeStatusCliCommand, a1 as runAccessHttpServeCliCommand, a2 as runAccessHttpStatusCliCommand, a3 as runAccessHttpStopCliCommand, a4 as runAccessMcpServeCliCommand, a5 as runArchiveObservationsCliCommand, a6 as runBenchmarkBaselineReportCliCommand, a7 as runBenchmarkBaselineSnapshotCliCommand, a8 as runBenchmarkCiGateCliCommand, a9 as runBenchmarkImportCliCommand, aa as runBenchmarkStatusCliCommand, ab as runBenchmarkStoredBaselineCiGateCliCommand, ac as runBenchmarkValidateCliCommand, r as runBulkImportCliCommand, ad as runCausalTrajectoryStatusCliCommand, ae as runCommitmentLifecycleCliCommand, af as runCommitmentRecordCliCommand, ag as runCommitmentSetStateCliCommand, ah as runCommitmentStatusCliCommand, ai as runCompatCliCommand, aj as runCompoundingPromoteCliCommand, ak as runConversationIndexHealthCliCommand, al as runConversationIndexInspectCliCommand, am as runConversationIndexRebuildCliCommand, an as runCueAnchorStatusCliCommand, ao as runDashboardStartCliCommand, ap as runDashboardStatusCliCommand, aq as runDashboardStopCliCommand, ar as runGraphHealthCliCommand, as as runHarmonicSearchCliCommand, at as runMemoryActionAuditCliCommand, au as runMemoryGovernanceCliCommand, av as runMemoryGovernanceReportCliCommand, aw as runMemoryGovernanceRestoreCliCommand, ax as runMemoryReviewDispositionCliCommand, ay as runMemoryTimelineCliCommand, az as runMigrateNormalizeFrontmatterCliCommand, aA as runMigrateObservationsCliCommand, aB as runMigrateRechunkCliCommand, aC as runMigrateReextractCliCommand, aD as runMigrateRescoreImportanceCliCommand, aE as runObjectiveStateStatusCliCommand, aF as runPolicyDiffCliCommand, aG as runPolicyRollbackCliCommand, aH as runPolicyStatusCliCommand, aI as runRebuildMemoryLifecycleLedgerCliCommand, aJ as runRebuildMemoryProjectionCliCommand, aK as runRebuildObservationsCliCommand, aL as runRepairMemoryProjectionCliCommand, aM as runReplayCliCommand, aN as runResumeBundleBuildCliCommand, aO as runResumeBundleRecordCliCommand, aP as runResumeBundleStatusCliCommand, aQ as runRouteCliCommand, aR as runSemanticRulePromoteCliCommand, aS as runSemanticRuleVerifyCliCommand, aT as runSessionCheckCliCommand, aU as runSessionRepairCliCommand, aV as runTailscaleStatusCliCommand, aW as runTailscaleSyncCliCommand, aX as runTierMigrateCliCommand, aY as runTierStatusCliCommand, aZ as runTrainingExportCliCommand, a_ as runTrustZoneDemoSeedCliCommand, a$ as runTrustZonePromoteCliCommand, b0 as runTrustZoneStatusCliCommand, b1 as runUtilityLearningCliCommand, b2 as runUtilityLearningStatusCliCommand, b3 as runUtilityTelemetryRecordCliCommand, b4 as runUtilityTelemetryStatusCliCommand, b5 as runVerifiedRecallSearchCliCommand, b6 as runVerifyMemoryProjectionCliCommand, b7 as runWebDavServeCliCommand, b8 as runWebDavStopCliCommand, b9 as runWorkProductRecallSearchCliCommand, ba as runWorkProductRecordCliCommand, bb as runWorkProductStatusCliCommand, bc as runWorkProjectCliCommand, bd as runWorkTaskCliCommand } from './cli-DwIBnp2g.js';
+import './orchestrator-CmJ-NTdJ.js';
+export { A as AccessHttpServeCliCommandOptions, c as ArchiveObservationsCliCommandOptions, B as BulkImportCliCommandOptions, C as CompatCliCommandOptions, d as ConversationIndexHealthCliOrchestrator, D as DashboardStartCliCommandOptions, e as DedupeCandidate, E as ExactDedupePlan, G as GraphHealthCliCommandOptions, M as MemoryActionAuditCliCommandOptions, g as MemoryActionAuditCliNamespaceSummary, h as MemoryActionAuditCliReport, i as MemoryGovernanceCliCommandOptions, j as MemoryGovernanceReportCliCommandOptions, k as MemoryGovernanceRestoreCliCommandOptions, l as MemoryReviewDispositionCliCommandOptions, m as MemoryTimelineCliCommandOptions, n as MigrateCliOrchestrator, o as MigrateCliReport, q as MigrateObservationsCliCommandOptions, s as PolicyDiffCliReport, t as PolicyDiffEntry, u as PolicyRollbackCliReport, v as PolicyStatusCliReport, w as PolicyTuningCliOrchestrator, R as RebuildMemoryLifecycleLedgerCliCommandOptions, x as RebuildMemoryProjectionCliCommandOptions, y as RebuildObservationsCliCommandOptions, z as RepairMemoryProjectionCliCommandOptions, F as ReplayCliCommandOptions, H as ReplayCliOrchestrator, I as RouteCliCommandOptions, S as SessionIntegrityCliCommandOptions, J as SessionRepairCliCommandOptions, T as TailscaleStatusCliCommandOptions, K as TailscaleSyncCliCommandOptions, L as TierMigrationCliOrchestrator, N as TrainingExportCliCommandOptions, V as VerifyMemoryProjectionCliCommandOptions, W as WebDavServeCliCommandOptions, O as WorkProjectCliCommandOptions, Q as WorkTaskCliCommandOptions, U as parseStrictCliDate, X as planAggressiveDuplicateDeletions, Y as planExactDuplicateDeletions, Z as registerCli, _ as resolveAccessPrincipalOverride, $ as resolveMemoryDirForNamespace, a0 as runAbstractionNodeStatusCliCommand, a1 as runAccessHttpServeCliCommand, a2 as runAccessHttpStatusCliCommand, a3 as runAccessHttpStopCliCommand, a4 as runAccessMcpServeCliCommand, a5 as runArchiveObservationsCliCommand, a6 as runBenchmarkBaselineReportCliCommand, a7 as runBenchmarkBaselineSnapshotCliCommand, a8 as runBenchmarkCiGateCliCommand, a9 as runBenchmarkImportCliCommand, aa as runBenchmarkStatusCliCommand, ab as runBenchmarkStoredBaselineCiGateCliCommand, ac as runBenchmarkValidateCliCommand, r as runBulkImportCliCommand, ad as runCausalTrajectoryStatusCliCommand, ae as runCommitmentLifecycleCliCommand, af as runCommitmentRecordCliCommand, ag as runCommitmentSetStateCliCommand, ah as runCommitmentStatusCliCommand, ai as runCompatCliCommand, aj as runCompoundingPromoteCliCommand, ak as runConversationIndexHealthCliCommand, al as runConversationIndexInspectCliCommand, am as runConversationIndexRebuildCliCommand, an as runCueAnchorStatusCliCommand, ao as runDashboardStartCliCommand, ap as runDashboardStatusCliCommand, aq as runDashboardStopCliCommand, ar as runGraphHealthCliCommand, as as runHarmonicSearchCliCommand, at as runMemoryActionAuditCliCommand, au as runMemoryGovernanceCliCommand, av as runMemoryGovernanceReportCliCommand, aw as runMemoryGovernanceRestoreCliCommand, ax as runMemoryReviewDispositionCliCommand, ay as runMemoryTimelineCliCommand, az as runMigrateNormalizeFrontmatterCliCommand, aA as runMigrateObservationsCliCommand, aB as runMigrateRechunkCliCommand, aC as runMigrateReextractCliCommand, aD as runMigrateRescoreImportanceCliCommand, aE as runObjectiveStateStatusCliCommand, aF as runPolicyDiffCliCommand, aG as runPolicyRollbackCliCommand, aH as runPolicyStatusCliCommand, aI as runRebuildMemoryLifecycleLedgerCliCommand, aJ as runRebuildMemoryProjectionCliCommand, aK as runRebuildObservationsCliCommand, aL as runRepairMemoryProjectionCliCommand, aM as runReplayCliCommand, aN as runResumeBundleBuildCliCommand, aO as runResumeBundleRecordCliCommand, aP as runResumeBundleStatusCliCommand, aQ as runRouteCliCommand, aR as runSemanticRulePromoteCliCommand, aS as runSemanticRuleVerifyCliCommand, aT as runSessionCheckCliCommand, aU as runSessionRepairCliCommand, aV as runTailscaleStatusCliCommand, aW as runTailscaleSyncCliCommand, aX as runTierMigrateCliCommand, aY as runTierStatusCliCommand, aZ as runTrainingExportCliCommand, a_ as runTrustZoneDemoSeedCliCommand, a$ as runTrustZonePromoteCliCommand, b0 as runTrustZoneStatusCliCommand, b1 as runUtilityLearningCliCommand, b2 as runUtilityLearningStatusCliCommand, b3 as runUtilityTelemetryRecordCliCommand, b4 as runUtilityTelemetryStatusCliCommand, b5 as runVerifiedRecallSearchCliCommand, b6 as runVerifyMemoryProjectionCliCommand, b7 as runWebDavServeCliCommand, b8 as runWebDavStopCliCommand, b9 as runWorkProductRecallSearchCliCommand, ba as runWorkProductRecordCliCommand, bb as runWorkProductStatusCliCommand, bc as runWorkProjectCliCommand, bd as runWorkTaskCliCommand } from './cli-BkeRaYfk.js';
 import './memory-projection-store-DeSXPh1j.js';
 import './types.js';
 import 'node:stream';
 import './dashboard-runtime.js';
-import './access-service.js';
+import './access-service-Br8ZydTK.js';
 import './evals.js';
 import './graph.js';
 import './causal-trajectory.js';
@@ -27,20 +27,28 @@ import './policy-runtime.js';
 import './buffer.js';
 import './storage.js';
 import './page-versioning.js';
+import './consolidation-operator.js';
 import 'better-sqlite3';
-import './port-C1GZFv8h.js';
+import './port-BADbLZU5.js';
 import './transcript.js';
 import './summarizer.js';
 import './model-registry.js';
 import './local-llm.js';
+import './fallback-llm.js';
 import './relevance.js';
 import './negative.js';
+import './recall-xray.js';
 import './session-observer-state.js';
 import './embedding-fallback.js';
-import './semantic-consolidation-DrvSYRdB.js';
+import './semantic-consolidation-CxJU6MJk.js';
 import './codex-materialize-CQlLTzke.js';
 import './logger.js';
 import 'zod';
 import './profiling.js';
+import './recall-explain-renderer.js';
+import './recall-audit-anomaly.js';
+import './recall-audit.js';
 import './explicit-capture.js';
+import './cross-namespace-budget.js';
+import './memory-worth-outcomes.js';
 import './boxes.js';

package/dist/cli.js

@@ -84,76 +84,88 @@ import {
   runWorkProductStatusCliCommand,
   runWorkProjectCliCommand,
   runWorkTaskCliCommand
-} from "./chunk-YFYL2SIJ.js";
-import "./chunk-KWP7T3DP.js";
-import "./chunk-AYPYCLR7.js";
-import "./chunk-X4WESCKA.js";
+} from "./chunk-INXV5JBT.js";
+import "./chunk-VDX363PS.js";
+import "./chunk-KUB6JU6H.js";
+import "./chunk-PVPWZSSI.js";
+import "./chunk-B5WXLVDY.js";
 import "./chunk-HL4DB7TO.js";
+import "./chunk-ULYOGL6R.js";
 import "./chunk-ZPKBYX2F.js";
 import "./chunk-3SLRNYNG.js";
 import "./chunk-LIRZNNUP.js";
 import "./chunk-Y4Z4I6WK.js";
-import "./chunk-PAORGQRI.js";
+import "./chunk-ASAITVLA.js";
+import "./chunk-EPQJM2GC.js";
 import "./chunk-PYXS46O7.js";
 import "./chunk-3QKK7QOS.js";
-import "./chunk-GJQPH5G3.js";
+import "./chunk-CUPFXL3J.js";
 import "./chunk-JRNQ3RNA.js";
-import "./chunk-MYQWXITD.js";
+import "./chunk-SPI27QT6.js";
 import "./chunk-CULXMQJH.js";
 import "./chunk-E6K4NIEU.js";
-import "./chunk-EABGC2TL.js";
-import "./chunk-LOBRX7VD.js";
-import "./chunk-HITJFT7E.js";
+import "./chunk-7I7FKFZH.js";
 import "./chunk-YRMVARQP.js";
+import "./chunk-YNQKWQT4.js";
 import "./chunk-U66YHYC7.js";
-import "./chunk-7PA4OZEU.js";
-import "./chunk-J4IYOZZ5.js";
-import "./chunk-AAI7JARD.js";
+import "./chunk-EABGC2TL.js";
+import "./chunk-LOBRX7VD.js";
+import "./chunk-HMDCOMYU.js";
+import "./chunk-JXS5PDQ7.js";
+import "./chunk-LK6SGL53.js";
 import "./chunk-7SEAZFFB.js";
 import "./chunk-K6WK37A6.js";
-import "./chunk-LK6SGL53.js";
-import "./chunk-FYIYMQ5N.js";
-import "./chunk-OJFGVJS6.js";
+import "./chunk-BK2EFTE2.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-C6QPK5GG.js";
 import "./chunk-C2EFFULQ.js";
+import "./chunk-FYIYMQ5N.js";
 import "./chunk-4WMCPJWX.js";
 import "./chunk-6HZ6AO2P.js";
 import "./chunk-URB2WSKZ.js";
+import "./chunk-PVGDJXVK.js";
 import "./chunk-NGAVDO7E.js";
-import "./chunk-PMB3WGDL.js";
-import "./chunk-NSB3WSYS.js";
+import "./chunk-DFTTJYSO.js";
+import "./chunk-HK3FGIEW.js";
 import "./chunk-IQT3XTKW.js";
 import "./chunk-MARWOCVP.js";
-import "./chunk-MTLYEMJB.js";
-import "./chunk-V7XCAHIB.js";
+import "./chunk-GKFXUTJ2.js";
+import "./chunk-ZAIM4TUE.js";
+import "./chunk-SOBJ6NEY.js";
+import "./chunk-3OGMS3PE.js";
 import "./chunk-EQINRHYR.js";
-import "./chunk-POBPGDWI.js";
-import "./chunk-QDYXG4CS.js";
-import "./chunk-QNJMBKFK.js";
+import "./chunk-EIR5VLIH.js";
 import "./chunk-EEQLFRUM.js";
 import "./chunk-QDW3E4RD.js";
-import "./chunk-4NRAJUDS.js";
+import "./chunk-3FPTCC3Z.js";
+import "./chunk-2LGMW3DJ.js";
+import "./chunk-GDFS42HT.js";
+import "./chunk-RBBWYEFJ.js";
 import "./chunk-DT5TVLJE.js";
+import "./chunk-N5AKDXAI.js";
 import "./chunk-TBBDFYXW.js";
-import "./chunk-DGXUHMOV.js";
-import "./chunk-LPSF4OQH.js";
-import "./chunk-XKECPATV.js";
-import "./chunk-ECKDIK5F.js";
-import "./chunk-POMSFKTB.js";
-import "./chunk-U2IQTSBY.js";
+import "./chunk-WVVA7F5A.js";
+import "./chunk-F5VP6YCB.js";
+import "./chunk-LTCGGW2D.js";
 import "./chunk-4KAN3GZ3.js";
-import "./chunk-6ZH4TU6I.js";
 import "./chunk-6PFRXT4K.js";
 import "./chunk-TP4FZJIZ.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-BOUYNNYD.js";
-import "./chunk-QSVPYQPG.js";
 import "./chunk-DM2T26WE.js";
+import "./chunk-QSVPYQPG.js";
 import "./chunk-M62O4P4T.js";
 import "./chunk-4DJQYKMN.js";
+import "./chunk-X6GF3FX2.js";
+import "./chunk-FAAFWE4G.js";
 import "./chunk-2ODBA7MQ.js";
-import "./chunk-N5AKDXAI.js";
+import "./chunk-DGXUHMOV.js";
+import "./chunk-LPSF4OQH.js";
+import "./chunk-TVVEYCNW.js";
+import "./chunk-RFYAYKTD.js";
+import "./chunk-LBLXEFWK.js";
+import "./chunk-XKECPATV.js";
+import "./chunk-WCLICCGB.js";
 export {
   parseStrictCliDate,
   planAggressiveDuplicateDeletions,

package/dist/config.js

@@ -1,7 +1,7 @@
 import {
   VALID_MEMORY_CATEGORIES,
   parseConfig
-} from "./chunk-OJFGVJS6.js";
+} from "./chunk-BK2EFTE2.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-MARWOCVP.js";
 import "./chunk-4DJQYKMN.js";

package/dist/consolidation-operator.d.ts

@@ -0,0 +1,41 @@
+/**
+ * consolidation-operator.ts — Standalone operator vocabulary + validators
+ * for the consolidation subsystem (issue #561, All-Mem paper
+ * arxiv:2603.19595).
+ *
+ * This module is intentionally dependency-free so storage, the `remnic
+ * doctor` check (PR 4), and the undo CLI (PR 5) can import the validators
+ * without dragging in the full consolidation engine — which in turn pulls
+ * in the Codex materialize runner and creates a `storage → consolidation
+ * → codex-materialize-runner → storage` import cycle.
+ *
+ * The `semantic-consolidation.ts` module re-exports these symbols so
+ * existing import paths continue to work.
+ */
+/**
+ * Operator algebra for non-destructive consolidation.
+ *
+ * - `split`  — one source memory is rewritten as multiple smaller memories.
+ * - `merge`  — multiple source memories are collapsed into one canonical
+ *   memory.
+ * - `update` — a newer value supersedes an older value within the same
+ *   logical fact.
+ */
+type ConsolidationOperator = "split" | "merge" | "update";
+/**
+ * Allowed values for the `derived_via` frontmatter field.  Used by storage
+ * validation to reject unknown operator values on write.
+ */
+declare const CONSOLIDATION_OPERATORS: readonly ConsolidationOperator[];
+/**
+ * Validate a `derived_from` entry string.  Returns `true` if the entry
+ * parses as `<non-empty path>:<integer >= 0>`.  Kept pure so storage and
+ * future CLI/doctor paths can share the same validator.
+ */
+declare function isValidDerivedFromEntry(entry: unknown): entry is string;
+/**
+ * Type guard for `ConsolidationOperator`.
+ */
+declare function isConsolidationOperator(value: unknown): value is ConsolidationOperator;
+
+export { CONSOLIDATION_OPERATORS, type ConsolidationOperator, isConsolidationOperator, isValidDerivedFromEntry };

package/dist/consolidation-operator.js

@@ -0,0 +1,11 @@
+import {
+  CONSOLIDATION_OPERATORS,
+  isConsolidationOperator,
+  isValidDerivedFromEntry
+} from "./chunk-X6GF3FX2.js";
+export {
+  CONSOLIDATION_OPERATORS,
+  isConsolidationOperator,
+  isValidDerivedFromEntry
+};
+//# sourceMappingURL=consolidation-operator.js.map

package/dist/consolidation-operator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/consolidation-provenance-check.d.ts

@@ -0,0 +1,68 @@
+import { StorageManager } from './storage.js';
+import './page-versioning.js';
+import './consolidation-operator.js';
+import './types.js';
+import './memory-projection-store-DeSXPh1j.js';
+import 'better-sqlite3';
+
+/**
+ * Consolidation provenance integrity check (issue #561 PR 4).
+ *
+ * Validates that every memory carrying consolidation provenance frontmatter
+ * (`derived_from`, `derived_via`) resolves to real data:
+ *
+ *   - Each `derived_from` entry `"<path>:<version>"` must name a
+ *     page-version snapshot that exists on disk (via the sidecar layout
+ *     documented in `page-versioning.ts`).
+ *   - Each `derived_via` must be one of the known
+ *     `ConsolidationOperator` values — malformed values are surfaced as
+ *     warnings rather than crashes so legacy or future operators survive a
+ *     rollback.
+ *
+ * Non-fatal: every failure renders a warning with the offending file path
+ * and a human-readable reason.  Integrity problems are informational for
+ * now — we do not auto-heal or archive broken memories.
+ */
+
+/**
+ * One integrity warning attached to a specific memory.
+ */
+interface ConsolidationProvenanceIssue {
+    /** Absolute path to the memory markdown file. */
+    memoryPath: string;
+    /** Memory id from frontmatter. */
+    memoryId: string;
+    /** Type of integrity issue. */
+    kind: "derived_from_missing_snapshot" | "derived_from_malformed_entry" | "derived_via_unknown_operator";
+    /** Human-readable detail — includes the offending value when relevant. */
+    detail: string;
+}
+/**
+ * Summary of a provenance-integrity scan.  Used by the operator-doctor
+ * report and surfaced in the CLI output.
+ */
+interface ConsolidationProvenanceReport {
+    /** Total memories inspected. */
+    scanned: number;
+    /** Memories that carry `derived_from` and/or `derived_via`. */
+    withProvenance: number;
+    /** One entry per problem detected (may be empty). */
+    issues: ConsolidationProvenanceIssue[];
+}
+/**
+ * Scan every memory under `storage` and flag consolidation-provenance
+ * problems.  Does not throw on individual failures — collects them in the
+ * returned report.
+ */
+declare function runConsolidationProvenanceCheck(options: {
+    storage: StorageManager;
+    memoryDir: string;
+    /**
+     * Page-versioning sidecar directory name.  Defaults to `.versions` —
+     * matches the baked-in default used by `setVersioningConfig` when
+     * versioning is enabled via config.
+     */
+    sidecarDir?: string;
+}): Promise<ConsolidationProvenanceReport>;
+
+export { type ConsolidationProvenanceIssue, type ConsolidationProvenanceReport, runConsolidationProvenanceCheck };

package/dist/consolidation-provenance-check.js

@@ -0,0 +1,9 @@
+import {
+  runConsolidationProvenanceCheck
+} from "./chunk-ULYOGL6R.js";
+import "./chunk-X6GF3FX2.js";
+import "./chunk-FAAFWE4G.js";
+export {
+  runConsolidationProvenanceCheck
+};
+//# sourceMappingURL=consolidation-provenance-check.js.map

package/dist/consolidation-provenance-check.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/consolidation-undo.d.ts

@@ -0,0 +1,123 @@
+import { StorageManager } from './storage.js';
+import { VersioningConfig } from './page-versioning.js';
+import './consolidation-operator.js';
+import './types.js';
+import './memory-projection-store-DeSXPh1j.js';
+import 'better-sqlite3';
+
+/**
+ * Consolidation undo (issue #561 PR 5).
+ *
+ * Reverts a consolidated memory by restoring each source memory from its
+ * `derived_from` snapshot and archiving the target.
+ *
+ * Contract:
+ *   - Load the target memory markdown file via its absolute path.
+ *   - For every `"<rel>:<version>"` entry in `derived_from`, fetch the
+ *     snapshot content via `page-versioning.getVersion` and restore it
+ *     to the original relative path.  If the restore target file
+ *     already exists, we skip overwriting it (the source was never
+ *     archived, or was re-created since) and record the skip.
+ *   - Archive the target with reason code `"consolidation-undo"` so the
+ *     lifecycle ledger records the undo.
+ *   - Dry-run mode produces the same plan without touching disk.
+ *
+ * The helper is kept pure over `StorageManager` so the CLI can reuse it
+ * without additional wiring, and tests can exercise the plan logic
+ * directly.
+ */
+
+/**
+ * Outcome of restoring a single `derived_from` source.
+ */
+interface ConsolidationUndoRestore {
+    /** The raw `"<relpath>:<version>"` entry from `derived_from`. */
+    entry: string;
+    /** Absolute path where the source would be / was restored. */
+    sourcePath: string;
+    /** What actually happened. */
+    outcome: "restored" | "skipped_file_exists" | "skipped_non_regular_file" | "skipped_snapshot_missing" | "skipped_malformed_entry" | "skipped_outside_memory_dir" | "skipped_non_active_path" | "skipped_self_referential" | "skipped_write_failed" | "skipped_blocked_by_other_failures" | "skipped_dry_run";
+    /** Human-readable detail. */
+    detail?: string;
+}
+/**
+ * Plan + result of a `remnic consolidate undo` invocation.
+ */
+interface ConsolidationUndoResult {
+    /** Absolute path to the target memory. */
+    targetPath: string;
+    /** True when the target was archived successfully. */
+    targetArchived: boolean;
+    /** Per-source restore outcomes. */
+    restores: ConsolidationUndoRestore[];
+    /** Whether the run was a dry-run plan only. */
+    dryRun: boolean;
+    /** Fatal error, if any — the run bails early. */
+    error?: string;
+}
+/**
+ * Verify that `candidate` resolves inside `root` (defense against
+ * path-traversal in `derived_from` entries and user-facing target
+ * paths).  Path-string normalization only; for symlink-aware checks
+ * use `isInsideDirectoryRealpath`.  Both paths are resolved to
+ * absolute form before comparison so `..` segments, symlinks-as-
+ * strings, and relative prefixes are normalized.
+ */
+declare function isInsideDirectory(candidate: string, root: string): boolean;
+/**
+ * Symlink-aware containment check (PR #637 round-2 review, codex P1).
+ *
+ * `isInsideDirectory` only normalizes path strings — if a `derived_from`
+ * entry resolves through a symlink inside `memoryDir` that points
+ * outside, the string check passes but the subsequent `writeFile` would
+ * land outside the memory tree.  Use this guard for any path that is
+ * about to be written.
+ *
+ * Walks every parent directory between `candidate` and `root`,
+ * `realpath`-ing each segment that exists and rejecting when any
+ * segment escapes `root`.  Non-existent parents are resolved as the
+ * canonicalized deepest-existing ancestor plus the trailing segments,
+ * so a not-yet-created target file still gets the symlink check on its
+ * existing parent directories.
+ */
+declare function isInsideDirectoryRealpath(candidate: string, root: string): Promise<boolean>;
+/**
+ * Check that a relative path (relative to memoryDir) points to an
+ * active memory location rather than an internal/archive directory.
+ * Returns `true` when the normalised `pagePath` does NOT start with
+ * a known non-active prefix.
+ *
+ * @param pagePath   Relative path from `derived_from` entry.
+ * @param sidecarDir Optional versioning sidecar directory name
+ *                   (e.g. `".versions"`).  When provided, paths
+ *                   under this directory are also rejected as
+ *                   non-active.
+ */
+declare function isActiveMemoryRelativePath(pagePath: string, sidecarDir?: string): boolean;
+/**
+ * Perform a consolidation-undo operation.
+ *
+ * @param options.storage        Storage manager for the memory directory.
+ * @param options.memoryDir      Absolute memory directory root.
+ * @param options.targetPath     Absolute path to the consolidated memory.
+ * @param options.versioning     Page-versioning config (sidecarDir must
+ *                               match the sidecar layout used when the
+ *                               snapshots were created).
+ * @param options.dryRun         When true, compute the plan but do not
+ *                               write or archive.
+ */
+declare function runConsolidationUndo(options: {
+    storage: StorageManager;
+    memoryDir: string;
+    targetPath: string;
+    versioning: VersioningConfig;
+    dryRun?: boolean;
+}): Promise<ConsolidationUndoResult>;
+/**
+ * Render a consolidation-undo result as a human-readable multi-line
+ * string for the CLI.  Extracted so tests can snapshot the formatting
+ * without parsing stdout.
+ */
+declare function formatConsolidationUndoResult(result: ConsolidationUndoResult): string;
+
+export { type ConsolidationUndoRestore, type ConsolidationUndoResult, formatConsolidationUndoResult, isActiveMemoryRelativePath, isInsideDirectory, isInsideDirectoryRealpath, runConsolidationUndo };