@remnic/core 1.1.0 → 1.1.2

package/dist/{chunk-WBSAYXVI.js → chunk-LOIMBRDE.js}

@@ -1,11 +1,14 @@
 import {
   promoteSemanticRuleFromMemory
-} from "./chunk-7ECD5ATE.js";
+} from "./chunk-VDX363PS.js";
 import {
   buildResumeBundleFromState,
   getResumeBundleStatus,
   recordResumeBundle
-} from "./chunk-6LX5ORAS.js";
+} from "./chunk-TMYO7B5P.js";
+import {
+  parseXrayCliOptions
+} from "./chunk-PVPWZSSI.js";
 import {
   listNamespaces,
   runBenchmarkRecall,
@@ -16,7 +19,7 @@ import {
   runOperatorRepair,
   runOperatorSetup,
   verifyNamespaces
-} from "./chunk-3QHL5ABG.js";
+} from "./chunk-6YJHX2DL.js";
 import {
   compareVersions
 } from "./chunk-HL4DB7TO.js";
@@ -25,16 +28,14 @@ import {
 } from "./chunk-ZPKBYX2F.js";
 import {
   RoutingRulesStore,
+  expandTildePath,
   isReplayRole,
   isReplaySource,
   normalizeReplaySessionKey,
   parseIsoOffsetTimestamp,
   parseIsoTimestamp,
   validateReplayTurn
-} from "./chunk-PAORGQRI.js";
-import {
-  searchVerifiedEpisodes
-} from "./chunk-6UJ47TVX.js";
+} from "./chunk-GA5P7RST.js";
 import {
   getUtilityLearningStatus,
   learnUtilityPromotionWeights
@@ -43,12 +44,15 @@ import {
   getUtilityTelemetryStatus,
   recordUtilityTelemetryEvent
 } from "./chunk-3QKK7QOS.js";
+import {
+  searchVerifiedEpisodes
+} from "./chunk-CUPFXL3J.js";
 import {
   ThreadingManager
 } from "./chunk-JRNQ3RNA.js";
 import {
   searchVerifiedSemanticRules
-} from "./chunk-JIU55F3X.js";
+} from "./chunk-SPI27QT6.js";
 import {
   getWorkProductLedgerStatus,
   recordWorkProductLedgerEntry,
@@ -75,10 +79,10 @@ import {
 } from "./chunk-HMDCOMYU.js";
 import {
   rescoreMemoryImportance
-} from "./chunk-J4IYOZZ5.js";
+} from "./chunk-JXS5PDQ7.js";
 import {
   launchProcess
-} from "./chunk-LK6SGL53.js";
+} from "./chunk-OR64ZGRZ.js";
 import {
   loadPersistedNativeKnowledgeChunks
 } from "./chunk-7SEAZFFB.js";
@@ -91,21 +95,21 @@ import {
   runEvalStoredBaselineCiGate,
   validateEvalBenchmarkPack
 } from "./chunk-K6WK37A6.js";
-import {
-  applyCommitmentLedgerLifecycle,
-  getCommitmentLedgerStatus,
-  recordCommitmentLedgerEntry,
-  transitionCommitmentLedgerEntryState
-} from "./chunk-FYIYMQ5N.js";
 import {
   parseConfig
-} from "./chunk-MBJHSA7F.js";
+} from "./chunk-BECYBZLX.js";
 import {
   getCueAnchorStoreStatus
 } from "./chunk-C6QPK5GG.js";
 import {
   analyzeGraphHealth
 } from "./chunk-C2EFFULQ.js";
+import {
+  applyCommitmentLedgerLifecycle,
+  getCommitmentLedgerStatus,
+  recordCommitmentLedgerEntry,
+  transitionCommitmentLedgerEntryState
+} from "./chunk-FYIYMQ5N.js";
 import {
   chunkContent
 } from "./chunk-4WMCPJWX.js";
@@ -114,23 +118,25 @@ import {
 } from "./chunk-NGAVDO7E.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-37UIFYWO.js";
+} from "./chunk-UWB5LMWY.js";
 import {
   EngramMcpServer
-} from "./chunk-NQEVYWX6.js";
-import {
-  resolveHomeDir
-} from "./chunk-MARWOCVP.js";
+} from "./chunk-OC5OXUQ4.js";
 import {
   EngramAccessService,
   WorkStorage
-} from "./chunk-MVTHXUBX.js";
+} from "./chunk-STGWEHYR.js";
+import {
+  parseRecallExplainFormat,
+  renderRecallExplain,
+  renderXray
+} from "./chunk-ZAIM4TUE.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact,
   restoreMemoryGovernanceRun,
   runMemoryGovernance
-} from "./chunk-ITRLGI2T.js";
+} from "./chunk-3OGMS3PE.js";
 import {
   getTrustZoneStoreStatus,
   promoteTrustZoneRecord,
@@ -139,13 +145,20 @@ import {
 import {
   selectRouteRule,
   validateRouteTarget
-} from "./chunk-QNJMBKFK.js";
+} from "./chunk-2LGMW3DJ.js";
 import {
   getCausalTrajectoryStoreStatus
-} from "./chunk-4NRAJUDS.js";
+} from "./chunk-RBBWYEFJ.js";
 import {
   StorageManager
-} from "./chunk-GV6NLQ4X.js";
+} from "./chunk-F5VP6YCB.js";
+import {
+  MEMORY_LIFECYCLE_EVENT_SORT_ORDER,
+  buildLifecycleEventsForMemory,
+  inferMemoryStatus,
+  sortMemoryLifecycleEvents,
+  toMemoryPathRel
+} from "./chunk-TP4FZJIZ.js";
 import {
   normalizeProjectionPreview,
   normalizeProjectionTags
@@ -163,12 +176,8 @@ import {
   readProjectedNativeKnowledgeChunks
 } from "./chunk-BOUYNNYD.js";
 import {
-  MEMORY_LIFECYCLE_EVENT_SORT_ORDER,
-  buildLifecycleEventsForMemory,
-  inferMemoryStatus,
-  sortMemoryLifecycleEvents,
-  toMemoryPathRel
-} from "./chunk-TP4FZJIZ.js";
+  resolveHomeDir
+} from "./chunk-MARWOCVP.js";
 
 // src/cli.ts
 import path19 from "path";
@@ -3785,13 +3794,6 @@ function isWorkTaskPriority(value) {
 function isWorkProjectStatus(value) {
   return value === "active" || value === "on_hold" || value === "completed" || value === "archived";
 }
-function expandTildePath(p) {
-  if (p === "~") return resolveHomeDir();
-  if (p.startsWith("~/") || p.startsWith("~\\")) {
-    return path19.join(resolveHomeDir(), p.slice(2));
-  }
-  return p;
-}
 async function runTrainingExportCliCommand(opts) {
   const expandedMemoryDir = expandTildePath(opts.memoryDir);
   const expandedOutput = expandTildePath(opts.output);
@@ -4121,7 +4123,7 @@ async function runSemanticRulePromoteCliCommand(options) {
   });
 }
 async function runCompoundingPromoteCliCommand(options) {
-  const { CompoundingEngine } = await import("./engine-5TIQBYZR.js");
+  const { CompoundingEngine } = await import("./engine-72LSIWQP.js");
   const config = parseConfig({
     memoryDir: options.memoryDir,
     qmdEnabled: false,
@@ -5531,6 +5533,68 @@ function registerCli(api, orchestrator) {
           }
         }
       });
+      cmd.command("judge-stats").description(
+        "Show extraction-judge verdict stats from the observation ledger"
+      ).option("--since <iso>", "Start timestamp (inclusive, ISO-8601)").option("--until <iso>", "End timestamp (exclusive, ISO-8601)").option("--json", "Emit machine-readable JSON only").action(async (...args) => {
+        const options = args[0] ?? {};
+        const sinceRaw = typeof options.since === "string" ? options.since : void 0;
+        const untilRaw = typeof options.until === "string" ? options.until : void 0;
+        const sinceMs = sinceRaw ? Date.parse(sinceRaw) : void 0;
+        const untilMs = untilRaw ? Date.parse(untilRaw) : void 0;
+        if (sinceRaw && !Number.isFinite(sinceMs)) {
+          throw new Error(
+            `Invalid --since value: ${sinceRaw}. Use ISO-8601, e.g. 2026-04-01T00:00:00Z`
+          );
+        }
+        if (untilRaw && !Number.isFinite(untilMs)) {
+          throw new Error(
+            `Invalid --until value: ${untilRaw}. Use ISO-8601, e.g. 2026-04-15T00:00:00Z`
+          );
+        }
+        const { readJudgeVerdictStats } = await import("./extraction-judge-telemetry.js");
+        const stats = await readJudgeVerdictStats(
+          orchestrator.config.memoryDir,
+          {
+            ...typeof sinceMs === "number" && Number.isFinite(sinceMs) ? { sinceMs } : {},
+            ...typeof untilMs === "number" && Number.isFinite(untilMs) ? { untilMs } : {}
+          }
+        );
+        if (options.json === true) {
+          console.log(JSON.stringify(stats, null, 2));
+          return;
+        }
+        console.log("=== Extraction Judge Verdict Stats ===\n");
+        console.log(`Total verdicts: ${stats.total}`);
+        if (stats.total === 0) {
+          if (!orchestrator.config.extractionJudgeTelemetryEnabled) {
+            console.log(
+              "\nNote: extractionJudgeTelemetryEnabled is OFF. Enable it in plugin config to collect verdict telemetry."
+            );
+          }
+          return;
+        }
+        console.log(
+          `  accept: ${stats.accept} (${(stats.accept / stats.total * 100).toFixed(1)}%)`
+        );
+        console.log(
+          `  reject: ${stats.reject} (${(stats.reject / stats.total * 100).toFixed(1)}%)`
+        );
+        console.log(
+          `  defer:  ${stats.defer} (${(stats.deferRate * 100).toFixed(1)}%)`
+        );
+        if (stats.deferCapTriggered > 0) {
+          console.log(
+            `    of which ${stats.deferCapTriggered} cap-rejected (defer \u2192 reject)`
+          );
+        }
+        console.log(`  mean elapsed: ${stats.meanElapsedMs.toFixed(1)} ms`);
+        if (stats.firstTs && stats.lastTs) {
+          console.log(`  window: ${stats.firstTs} \u2026 ${stats.lastTs}`);
+        }
+        if (stats.malformed > 0) {
+          console.log(`  malformed rows skipped: ${stats.malformed}`);
+        }
+      });
       cmd.command("setup").description("Validate config, scaffold directories, and print first-run next steps").option("--install-capture-instructions", "Create workspace MEMORY.md when explicit capture is enabled and missing").option("--preview-capture-instructions", "Print the managed explicit-capture instruction snippet without writing files").option("--remove-capture-instructions", "Remove the managed explicit-capture instruction snippet from MEMORY.md").option("--json", "Emit machine-readable JSON only").action(async (...args) => {
         const options = args[0] ?? {};
         const captureInstructionsMode = options.removeCaptureInstructions === true ? "remove" : options.previewCaptureInstructions === true ? "preview" : options.installCaptureInstructions === true ? "install" : void 0;
@@ -5950,6 +6014,59 @@ function registerCli(api, orchestrator) {
         }
         if (!reportHasMachineReadableOutput(options)) console.log("OK");
       });
+      cmd.command("recall-explain").description(
+        "Show tier explain for the most recent recall (or a specific session)"
+      ).option(
+        "--session <key>",
+        "Session key to look up; omit to use the most recent snapshot"
+      ).option("--format <fmt>", "Output format: text (default) or json", "text").action(async (...args) => {
+        const options = args[0] ?? {};
+        const format = parseRecallExplainFormat(options.format);
+        await orchestrator.lastRecall.load();
+        const sessionKey = typeof options.session === "string" && options.session.length > 0 ? options.session : void 0;
+        let snapshot = null;
+        try {
+          snapshot = sessionKey ? orchestrator.lastRecall.get(sessionKey) : orchestrator.lastRecall.getMostRecent();
+        } catch {
+          snapshot = null;
+        }
+        console.log(renderRecallExplain(snapshot, format));
+      });
+      cmd.command("xray").description(
+        "Run a recall with X-ray capture and print the unified snapshot (tier + audit + MMR + filters).  Part of #570."
+      ).argument("<query>", "Query to recall against").option(
+        "--format <fmt>",
+        "Output format: text (default), markdown, or json",
+        "text"
+      ).option(
+        "--budget <chars>",
+        "Override recall character budget for this call (positive integer)"
+      ).option(
+        "--namespace <ns>",
+        "Namespace to scope the recall to (defaults to configured namespace)"
+      ).option(
+        "--out <path>",
+        "Write the rendered snapshot to a file instead of stdout"
+      ).action(async (...args) => {
+        const parsed = parseXrayCliOptions(
+          args[0],
+          args[1] ?? {}
+        );
+        const xrayService = new EngramAccessService(orchestrator);
+        const response = await xrayService.recallXray({
+          query: parsed.query,
+          ...parsed.namespace ? { namespace: parsed.namespace } : {},
+          ...parsed.budget !== void 0 ? { budget: parsed.budget } : {}
+        });
+        const snapshot = response.snapshotFound ? response.snapshot ?? null : null;
+        const rendered = renderXray(snapshot, parsed.format);
+        if (parsed.outPath) {
+          const { writeFile: fsWriteFile } = await import("fs/promises");
+          await fsWriteFile(expandTildePath(parsed.outPath), rendered, "utf8");
+        } else {
+          console.log(rendered);
+        }
+      });
       cmd.command("benchmark-validate").description("Validate a benchmark manifest file or pack directory without importing it").argument("<path>", "Path to a benchmark manifest JSON file or a directory with manifest.json").action(async (...args) => {
         const inputPath = args[0];
         const summary = await runBenchmarkValidateCliCommand({
@@ -7336,6 +7453,36 @@ Clusters found: ${result.clustersFound}`);
 Semantic consolidation complete. clusters=${result.clustersFound}, consolidated=${result.memoriesConsolidated}, archived=${result.memoriesArchived}, errors=${result.errors}`
         );
       });
+      cmd.command("consolidate-undo <target>").description(
+        "Undo a consolidation: restore source memories from their derived_from snapshots and archive the target"
+      ).option("--dry-run", "Show the restore plan without modifying files").action(async (...args) => {
+        const rawTarget = typeof args[0] === "string" ? args[0] : "";
+        const options = args[1] ?? {};
+        const dryRun = options.dryRun === true;
+        if (!rawTarget) {
+          console.error("consolidate-undo: missing <target> argument");
+          process.exitCode = 1;
+          return;
+        }
+        const expandedTarget = expandTildePath(rawTarget);
+        const targetPath = path19.isAbsolute(expandedTarget) ? expandedTarget : path19.join(orchestrator.config.memoryDir, expandedTarget);
+        const { runConsolidationUndo, formatConsolidationUndoResult } = await import("./consolidation-undo.js");
+        const result = await runConsolidationUndo({
+          storage: orchestrator.storage,
+          memoryDir: orchestrator.config.memoryDir,
+          targetPath,
+          versioning: {
+            enabled: orchestrator.config.versioningEnabled,
+            maxVersionsPerPage: orchestrator.config.versioningMaxPerPage,
+            sidecarDir: orchestrator.config.versioningSidecarDir
+          },
+          dryRun
+        });
+        console.log(formatConsolidationUndoResult(result));
+        if (result.error) {
+          process.exitCode = 1;
+        }
+      });
       cmd.command("questions").description("List open questions from memory extraction").option("-a, --all", "Show all questions including resolved").action(async (...args) => {
         const options = args[0] ?? {};
         const showAll = options.all === true;
@@ -7802,15 +7949,24 @@ Semantic consolidation complete. clusters=${result.clustersFound}, consolidated=
       });
       reviewCmd.command("scan").description("Run an on-demand contradiction scan").option("--namespace <ns>", "Namespace to scan").action(async (...args) => {
         const options = args[0] ?? {};
-        const { runContradictionScan } = await import("./contradiction-scan-GR33PONM.js");
+        const { runContradictionScan } = await import("./contradiction-scan-E3GJTI4F.js");
         console.log("Running contradiction scan...");
         const result = await runContradictionScan({
           storage: orchestrator.storage,
           config: orchestrator.config,
           memoryDir: orchestrator.config.memoryDir,
-          embeddingLookup: void 0,
+          embeddingLookupFactory: (storage) => {
+            if (!orchestrator.config.embeddingFallbackEnabled) return void 0;
+            return async (content, limit) => {
+              try {
+                return await orchestrator.semanticDedupLookup(content, limit, storage);
+              } catch {
+                return [];
+              }
+            };
+          },
           localLlm: orchestrator.localLlm ?? null,
-          fallbackLlm: null,
+          fallbackLlm: orchestrator.fastGatewayLlm ?? null,
           namespace: options.namespace
         });
         console.log(`Scan complete in ${result.elapsedMs}ms:`);
@@ -7942,4 +8098,4 @@ export {
   resolveMemoryDirForNamespace,
   registerCli
 };
-//# sourceMappingURL=chunk-WBSAYXVI.js.map
+//# sourceMappingURL=chunk-LOIMBRDE.js.map