@remnic/core 9.69.9 → 9.69.11

package/dist/chunk-VZIAVM72.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-expand-select.ts"],"sourcesContent":["/**\n * Select EXPAND node ids for deep recall (issue #2332).\n *\n * A foreign id refuses the whole selection; an oversized request truncates.\n * Duplicates collapse before the cap. Pure. Surfaces wait.\n */\nexport const DEFAULT_MAX_EXPAND_PER_STEP = 3;\n\nexport type ExpandSelectionResult =\n  | { ok: true; nodeIds: string[]; truncated: boolean }\n  | { ok: false; error: \"invalid_policy_output\"; foreignIds: string[] };\n\nexport function selectExpandNodeIds(input: {\n  frontierIds: readonly string[];\n  requestedIds: unknown;\n  maxExpandPerStep?: number;\n}): ExpandSelectionResult {\n  const max =\n    input.maxExpandPerStep === undefined\n      ? DEFAULT_MAX_EXPAND_PER_STEP\n      : input.maxExpandPerStep;\n  if (!Number.isInteger(max) || max < 1) {\n    throw new RangeError(\n      `maxExpandPerStep must be an integer >= 1; got ${JSON.stringify(max)}`,\n    );\n  }\n\n  if (!Array.isArray(input.requestedIds)) {\n    return { ok: false, error: \"invalid_policy_output\", foreignIds: [] };\n  }\n\n  const frontier = new Set(input.frontierIds);\n  const seen = new Set<string>();\n  const foreign = new Set<string>();\n  const ordered: string[] = [];\n\n  for (const entry of input.requestedIds) {\n    if (typeof entry !== \"string\" || entry.trim().length === 0) {\n      foreign.add(String(entry));\n      continue;\n    }\n    if (!frontier.has(entry)) {\n      foreign.add(entry);\n      continue;\n    }\n    if (seen.has(entry)) continue;\n    seen.add(entry);\n    ordered.push(entry);\n  }\n\n  if (foreign.size > 0) {\n    return {\n      ok: false,\n      error: \"invalid_policy_output\",\n      foreignIds: [...foreign].sort(),\n    };\n  }\n\n  const truncated = ordered.length > max;\n  return {\n    ok: true,\n    nodeIds: truncated ? ordered.slice(0, max) : ordered,\n    truncated,\n  };\n}\n"],"mappings":";AAMO,IAAM,8BAA8B;AAMpC,SAAS,oBAAoB,OAIV;AACxB,QAAM,MACJ,MAAM,qBAAqB,SACvB,8BACA,MAAM;AACZ,MAAI,CAAC,OAAO,UAAU,GAAG,KAAK,MAAM,GAAG;AACrC,UAAM,IAAI;AAAA,MACR,iDAAiD,KAAK,UAAU,GAAG,CAAC;AAAA,IACtE;AAAA,EACF;AAEA,MAAI,CAAC,MAAM,QAAQ,MAAM,YAAY,GAAG;AACtC,WAAO,EAAE,IAAI,OAAO,OAAO,yBAAyB,YAAY,CAAC,EAAE;AAAA,EACrE;AAEA,QAAM,WAAW,IAAI,IAAI,MAAM,WAAW;AAC1C,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,UAAU,oBAAI,IAAY;AAChC,QAAM,UAAoB,CAAC;AAE3B,aAAW,SAAS,MAAM,cAAc;AACtC,QAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,WAAW,GAAG;AAC1D,cAAQ,IAAI,OAAO,KAAK,CAAC;AACzB;AAAA,IACF;AACA,QAAI,CAAC,SAAS,IAAI,KAAK,GAAG;AACxB,cAAQ,IAAI,KAAK;AACjB;AAAA,IACF;AACA,QAAI,KAAK,IAAI,KAAK,EAAG;AACrB,SAAK,IAAI,KAAK;AACd,YAAQ,KAAK,KAAK;AAAA,EACpB;AAEA,MAAI,QAAQ,OAAO,GAAG;AACpB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,YAAY,CAAC,GAAG,OAAO,EAAE,KAAK;AAAA,IAChC;AAAA,EACF;AAEA,QAAM,YAAY,QAAQ,SAAS;AACnC,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,SAAS,YAAY,QAAQ,MAAM,GAAG,GAAG,IAAI;AAAA,IAC7C;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-WTWQA7BB.js

@@ -0,0 +1,28 @@
+// src/recall-deep-rewrite.ts
+var MAX_REFINES_PER_INVOCATION = 2;
+function validateRefineRewrite(input) {
+  if (!Number.isInteger(input.refinesUsed) || input.refinesUsed < 0) {
+    throw new RangeError(
+      `refinesUsed must be a non-negative integer; got ${JSON.stringify(input.refinesUsed)}`
+    );
+  }
+  if (input.refinesUsed >= MAX_REFINES_PER_INVOCATION) {
+    return { ok: false, stop: true, reason: "refine_budget_spent" };
+  }
+  if (typeof input.refinedQuery !== "string" || input.refinedQuery.trim() === "") {
+    return { ok: false, stop: true, reason: "empty_rewrite" };
+  }
+  const trimmed = input.refinedQuery.trim();
+  const currentKey = input.currentQuery.trim().toLowerCase().replace(/\s+/g, " ");
+  const refinedKey = trimmed.toLowerCase().replace(/\s+/g, " ");
+  if (refinedKey === currentKey) {
+    return { ok: false, stop: true, reason: "identical_rewrite" };
+  }
+  return { ok: true, refinedQuery: trimmed };
+}
+
+export {
+  MAX_REFINES_PER_INVOCATION,
+  validateRefineRewrite
+};
+//# sourceMappingURL=chunk-WTWQA7BB.js.map

package/dist/chunk-WTWQA7BB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-rewrite.ts"],"sourcesContent":["/**\n * Validate a deep-recall REFINE rewrite (issue #2332).\n *\n * Pure. The budget check runs before the rewrite is inspected, so an\n * exhausted budget cannot be bypassed by a valid-looking query. An empty\n * or no-progress rewrite is rejected and treated as STOP.\n */\nexport const MAX_REFINES_PER_INVOCATION = 2;\n\nexport type RefineRewriteResult =\n  | { ok: true; refinedQuery: string }\n  | {\n      ok: false;\n      stop: true;\n      reason: \"empty_rewrite\" | \"identical_rewrite\" | \"refine_budget_spent\";\n    };\n\nexport function validateRefineRewrite(input: {\n  currentQuery: string;\n  refinedQuery: unknown;\n  refinesUsed: number;\n}): RefineRewriteResult {\n  if (!Number.isInteger(input.refinesUsed) || input.refinesUsed < 0) {\n    throw new RangeError(\n      `refinesUsed must be a non-negative integer; got ${JSON.stringify(input.refinesUsed)}`,\n    );\n  }\n  if (input.refinesUsed >= MAX_REFINES_PER_INVOCATION) {\n    return { ok: false, stop: true, reason: \"refine_budget_spent\" };\n  }\n  if (\n    typeof input.refinedQuery !== \"string\" ||\n    input.refinedQuery.trim() === \"\"\n  ) {\n    return { ok: false, stop: true, reason: \"empty_rewrite\" };\n  }\n  const trimmed = input.refinedQuery.trim();\n  // Comparison key: case-folded with internal whitespace runs collapsed, so\n  // pure case/spacing drift is not progress. The returned rewrite keeps\n  // internal whitespace as the model wrote it.\n  const currentKey = input.currentQuery\n    .trim()\n    .toLowerCase()\n    .replace(/\\s+/g, \" \");\n  const refinedKey = trimmed.toLowerCase().replace(/\\s+/g, \" \");\n  if (refinedKey === currentKey) {\n    return { ok: false, stop: true, reason: \"identical_rewrite\" };\n  }\n  return { ok: true, refinedQuery: trimmed };\n}\n"],"mappings":";AAOO,IAAM,6BAA6B;AAUnC,SAAS,sBAAsB,OAId;AACtB,MAAI,CAAC,OAAO,UAAU,MAAM,WAAW,KAAK,MAAM,cAAc,GAAG;AACjE,UAAM,IAAI;AAAA,MACR,mDAAmD,KAAK,UAAU,MAAM,WAAW,CAAC;AAAA,IACtF;AAAA,EACF;AACA,MAAI,MAAM,eAAe,4BAA4B;AACnD,WAAO,EAAE,IAAI,OAAO,MAAM,MAAM,QAAQ,sBAAsB;AAAA,EAChE;AACA,MACE,OAAO,MAAM,iBAAiB,YAC9B,MAAM,aAAa,KAAK,MAAM,IAC9B;AACA,WAAO,EAAE,IAAI,OAAO,MAAM,MAAM,QAAQ,gBAAgB;AAAA,EAC1D;AACA,QAAM,UAAU,MAAM,aAAa,KAAK;AAIxC,QAAM,aAAa,MAAM,aACtB,KAAK,EACL,YAAY,EACZ,QAAQ,QAAQ,GAAG;AACtB,QAAM,aAAa,QAAQ,YAAY,EAAE,QAAQ,QAAQ,GAAG;AAC5D,MAAI,eAAe,YAAY;AAC7B,WAAO,EAAE,IAAI,OAAO,MAAM,MAAM,QAAQ,oBAAoB;AAAA,EAC9D;AACA,SAAO,EAAE,IAAI,MAAM,cAAc,QAAQ;AAC3C;","names":[]}

package/dist/{chunk-J55NAXDH.js → chunk-X4FIZAVQ.js}

@@ -22,7 +22,7 @@ import {
 import {
   exportOkfBundle,
   parseIncludeStatus
-} from "./chunk-KAVQ5GYY.js";
+} from "./chunk-I4QAH4SY.js";
 import {
   exportSqlite
 } from "./chunk-BV2TIZ4F.js";
@@ -38,9 +38,6 @@ import {
 import {
   RoutingRulesStore
 } from "./chunk-TBUEE7XF.js";
-import {
-  WebDavServer
-} from "./chunk-PYIFUBRK.js";
 import {
   buildReplayNormalizerRegistry,
   clampBatchSize,
@@ -50,24 +47,24 @@ import {
   isReplaySource,
   normalizeReplaySessionKey
 } from "./chunk-AJVLDJU6.js";
-import {
-  rebuildObservations
-} from "./chunk-DQTCGVFK.js";
 import {
   TailscaleHelper
 } from "./chunk-EEC4PCG5.js";
+import {
+  WebDavServer
+} from "./chunk-PYIFUBRK.js";
 import {
   migrateObservations
 } from "./chunk-IIFFC3RL.js";
 import {
   rebuildMemoryLifecycleLedger
-} from "./chunk-2MW3UQNX.js";
+} from "./chunk-I6DUKBUI.js";
+import {
+  rebuildObservations
+} from "./chunk-DQTCGVFK.js";
 import {
   archiveObservations
 } from "./chunk-YLBE6PLR.js";
-import {
-  lintOkfDir
-} from "./chunk-IWO4HEOL.js";
 import {
   runCompatChecks
 } from "./chunk-CDKHKZL5.js";
@@ -77,6 +74,9 @@ import {
   registerBulkImportSource,
   runBulkImportPipeline
 } from "./chunk-HSSERO3E.js";
+import {
+  lintOkfDir
+} from "./chunk-YWN3GYI2.js";
 import {
   getUtilityLearningStatus,
   learnUtilityPromotionWeights
@@ -87,21 +87,21 @@ import {
 } from "./chunk-6FC3IZ26.js";
 import {
   searchVerifiedEpisodes
-} from "./chunk-QGUFN25Q.js";
+} from "./chunk-LJAP4KSW.js";
 import {
   ThreadingManager
 } from "./chunk-OJP3N7UK.js";
 import {
   promoteSemanticRuleFromMemory
-} from "./chunk-SO73GYOZ.js";
+} from "./chunk-BFDOBESV.js";
 import {
   searchVerifiedSemanticRules
-} from "./chunk-GISV63M2.js";
+} from "./chunk-APZXA4WI.js";
 import {
   buildResumeBundleFromState,
   getResumeBundleStatus,
   recordResumeBundle
-} from "./chunk-SXQZMC7R.js";
+} from "./chunk-GR4C3FHT.js";
 import {
   getWorkProductLedgerStatus,
   recordWorkProductLedgerEntry,
@@ -112,7 +112,7 @@ import {
 } from "./chunk-AM4T6CHX.js";
 import {
   parseXrayCliOptions
-} from "./chunk-X5PIDJ3L.js";
+} from "./chunk-DA4ZMCBU.js";
 import {
   collectPatternMemories,
   explainPatternMemory,
@@ -134,7 +134,7 @@ import {
   runOperatorInventory,
   runOperatorRepair,
   runOperatorSetup
-} from "./chunk-GFGQOZGG.js";
+} from "./chunk-HFRGCNFY.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -157,9 +157,6 @@ import {
 import {
   listConnectorStates
 } from "./chunk-6GUG4YNM.js";
-import {
-  searchHarmonicRetrieval
-} from "./chunk-IGUWU5BD.js";
 import {
   rescoreMemoryImportance
 } from "./chunk-UOBPK2OS.js";
@@ -176,10 +173,7 @@ import {
   rebuildMemoryProjection,
   repairMemoryProjection,
   verifyMemoryProjection
-} from "./chunk-E5WTGEWX.js";
-import {
-  getCueAnchorStoreStatus
-} from "./chunk-ACPCA4NO.js";
+} from "./chunk-BEXFNGQ3.js";
 import {
   GraphDashboardServer
 } from "./chunk-YNDLCWXS.js";
@@ -203,11 +197,11 @@ import {
 } from "./chunk-6TBIWIAG.js";
 import {
   parseConfig
-} from "./chunk-26JWBSWD.js";
+} from "./chunk-PGCZLHRB.js";
 import {
   EngramAccessHttpServer,
   MeetingsInputError
-} from "./chunk-PEOFTEUC.js";
+} from "./chunk-DH3V7RCQ.js";
 import {
   WearablesInputError
 } from "./chunk-V7IZKJI3.js";
@@ -217,13 +211,10 @@ import {
   loadChatSession,
   processChatMessage,
   sessionBelongsToPrincipal
-} from "./chunk-LVYO2HZJ.js";
-import {
-  getAbstractionNodeStoreStatus
-} from "./chunk-DJUKBGAD.js";
+} from "./chunk-5HO3QBAD.js";
 import {
   EngramAccessService
-} from "./chunk-3QWF54M4.js";
+} from "./chunk-5P2KNFJZ.js";
 import {
   WorkStorage
 } from "./chunk-GDB4J2H3.js";
@@ -240,42 +231,48 @@ import {
   parseRecallExplainFormat,
   renderRecallExplain,
   renderXray
-} from "./chunk-H6RSANGQ.js";
+} from "./chunk-ETZ7KKOS.js";
 import {
   readAggregateExtractionWatermark
-} from "./chunk-NDE7CH6C.js";
+} from "./chunk-QUVWFZOU.js";
 import {
   getObjectiveStateStoreStatus
 } from "./chunk-HTP6XRUI.js";
+import {
+  searchHarmonicRetrieval
+} from "./chunk-4WIKMOE3.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact,
   restoreMemoryGovernanceRun,
   runMemoryGovernance
-} from "./chunk-ANN5VMHT.js";
+} from "./chunk-LDOQE34V.js";
 import {
   listNamespaces,
   runNamespaceMigration,
   verifyNamespaces
-} from "./chunk-A3WMMQAH.js";
+} from "./chunk-P7LVYPIX.js";
+import {
+  getCueAnchorStoreStatus
+} from "./chunk-ACPCA4NO.js";
 import {
   resolveNamespaceChildRoot
 } from "./chunk-3UXOZBHV.js";
 import {
   analyzeGraphHealth
-} from "./chunk-OLT3YTDH.js";
+} from "./chunk-BIJAWZYW.js";
 import {
   OKF_RESERVED_BASENAMES,
   meetingIdDate,
   okfTypeForCategory
-} from "./chunk-WF2WCZCR.js";
+} from "./chunk-VYD63IFH.js";
 import {
   isValidTranscriptDate
 } from "./chunk-UHVXE24Y.js";
 import {
   RECALL_DISCLOSURE_LEVELS,
   isRecallDisclosure
-} from "./chunk-XXW32OL7.js";
+} from "./chunk-OYV6RKPM.js";
 import {
   normalizeProjectionPreview
 } from "./chunk-SCU65EZI.js";
@@ -312,7 +309,7 @@ import {
 } from "./chunk-QDW3E4RD.js";
 import {
   getCausalTrajectoryStoreStatus
-} from "./chunk-2Z3DG5CQ.js";
+} from "./chunk-P6GKRT2H.js";
 import {
   padEndDisplay,
   truncateGraphemeSafe
@@ -367,6 +364,9 @@ import {
 import {
   resolveHomeDir
 } from "./chunk-JUC24CTX.js";
+import {
+  getAbstractionNodeStoreStatus
+} from "./chunk-DJUKBGAD.js";
 import {
   SECURE_STORE_ENVELOPE_OVERHEAD_BYTES,
   probeEncryptedRegularFileHeader
@@ -1177,6 +1177,47 @@ function registerMeetingsCommands(cmd, orchestrator) {
   });
 }
 
+// src/cli/deep-recall-commands.ts
+function parseMaxSteps(raw) {
+  if (raw === void 0 || raw === null) return void 0;
+  const value = typeof raw === "string" ? Number(raw) : raw;
+  if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+    throw new Error(`--max-steps must be a non-negative integer; got ${JSON.stringify(raw)}`);
+  }
+  return value;
+}
+function registerDeepRecallCommands(cmd, orchestrator) {
+  cmd.command("deep-recall <query>").description("Budgeted multi-hop retrieval over the anchor graph (slow, thorough; issue #2332)").option("--max-steps <n>", "Policy-step ceiling (cannot exceed the configured deepRecall.maxSteps)").option("--namespace <ns>", "Namespace to scope the retrieval to").option("--json", "JSON output (full entries + trace)").action(async (...args) => {
+    const query = String(args[0] ?? "");
+    const options = args[args.length - 1] ?? {};
+    let maxSteps;
+    try {
+      maxSteps = parseMaxSteps(options.maxSteps);
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : String(err));
+      process.exitCode = 1;
+      return;
+    }
+    const service = new EngramAccessService(orchestrator);
+    try {
+      const result = await service.deepRecall({
+        query,
+        ...maxSteps !== void 0 ? { maxSteps } : {},
+        ...typeof options.namespace === "string" && options.namespace.length > 0 ? { namespace: options.namespace } : {}
+      });
+      if (options.json === true) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(result.rendered);
+      }
+      if (!result.ok) process.exitCode = 1;
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : String(err));
+      process.exitCode = 1;
+    }
+  });
+}
+
 // src/okf/sweep.ts
 import fs from "fs";
 import path from "path";
@@ -6529,6 +6570,7 @@ ${doc.content}` : doc.content,
       registerCreationLedgerCommands(cmd, orchestrator);
       registerMeetingsCommands(cmd, orchestrator);
       registerOkfCommands(cmd, orchestrator);
+      registerDeepRecallCommands(cmd, orchestrator);
       cmd.command("trust-zone-promote").description("Dry-run or apply a trust-zone promotion with provenance enforcement").requiredOption("--record-id <recordId>", "Source trust-zone record id").requiredOption("--target-zone <targetZone>", "Promotion target zone (working|trusted)").requiredOption("--reason <reason>", "Human-readable promotion reason").option("--recorded-at <isoTimestamp>", "Promotion timestamp (defaults to now)").option("--summary <summary>", "Optional replacement summary for the promoted record").option("--dry-run", "Show the promotion plan without writing the promoted record").action(async (...args) => {
         const options = args[0] ?? {};
         const result = await runTrustZonePromoteCliCommand({
@@ -8862,4 +8904,4 @@ export {
   listMemoryMarkdownFilePaths,
   registerCli
 };
-//# sourceMappingURL=chunk-J55NAXDH.js.map
+//# sourceMappingURL=chunk-X4FIZAVQ.js.map