@remnic/core 9.9.3 → 9.9.4

package/dist/{chunk-XPR7572Y.js → chunk-7PY55HMI.js}

@@ -329,7 +329,7 @@ import {
   clusterByKey,
   createCorrectionService,
   detectPassiveCorrections
-} from "./chunk-KQILYXND.js";
+} from "./chunk-3HYWNJDA.js";
 import {
   importCapsule
 } from "./chunk-ALSGMEJR.js";
@@ -24004,4 +24004,4 @@ export {
   blendGraphExpandedRecallScore,
   Orchestrator
 };
-//# sourceMappingURL=chunk-XPR7572Y.js.map
+//# sourceMappingURL=chunk-7PY55HMI.js.map

package/dist/{chunk-B4C3JSJT.js → chunk-I4NJ2CDY.js}

@@ -9,7 +9,7 @@ import {
   DECISION_SUBCOMMANDS,
   DELTA_SUBCOMMANDS,
   isCodegraphToolName
-} from "./chunk-KQILYXND.js";
+} from "./chunk-3HYWNJDA.js";
 import {
   serializeMutations,
   withHeldFileLock
@@ -1807,4 +1807,4 @@ export {
   codegraphIngestTracesOperation,
   REGISTERED_OPERATIONS
 };
-//# sourceMappingURL=chunk-B4C3JSJT.js.map
+//# sourceMappingURL=chunk-I4NJ2CDY.js.map

package/dist/{chunk-DZQZHQQ4.js → chunk-UDIJMITR.js}

@@ -19,7 +19,7 @@ import {
 } from "./chunk-XRNU7OEQ.js";
 import {
   RelayMissionStoreError
-} from "./chunk-B4C3JSJT.js";
+} from "./chunk-I4NJ2CDY.js";
 import {
   executeResolution,
   isValidResolutionVerb
@@ -37,7 +37,7 @@ import {
 } from "./chunk-KF5EUVKQ.js";
 import {
   CorrectionContractError
-} from "./chunk-KQILYXND.js";
+} from "./chunk-3HYWNJDA.js";
 import {
   isTrustZoneName
 } from "./chunk-JGSKJHF7.js";
@@ -3132,4 +3132,4 @@ function positiveIntQueryParam(value, label) {
 export {
   EngramAccessHttpServer
 };
-//# sourceMappingURL=chunk-DZQZHQQ4.js.map
+//# sourceMappingURL=chunk-UDIJMITR.js.map

package/dist/cli.js

@@ -90,7 +90,7 @@ import {
   runWorkProductStatusCliCommand,
   runWorkProjectCliCommand,
   runWorkTaskCliCommand
-} from "./chunk-SOTYFJOA.js";
+} from "./chunk-226RNKRU.js";
 import "./chunk-MMACM5G2.js";
 import "./chunk-54BGIBCR.js";
 import "./chunk-H4CKS5B2.js";
@@ -170,7 +170,7 @@ import "./chunk-K6MV3TRQ.js";
 import "./chunk-PIG4WJFQ.js";
 import "./chunk-KFZY2OFH.js";
 import "./chunk-LBJBNWS2.js";
-import "./chunk-DZQZHQQ4.js";
+import "./chunk-UDIJMITR.js";
 import "./chunk-V7IZKJI3.js";
 import "./chunk-MKQBXQKU.js";
 import "./chunk-SEDEKFYQ.js";
@@ -183,7 +183,7 @@ import "./chunk-7RXCMVFQ.js";
 import "./chunk-XRNU7OEQ.js";
 import "./chunk-IC2TCZJ2.js";
 import "./chunk-D24OXEPB.js";
-import "./chunk-B4C3JSJT.js";
+import "./chunk-I4NJ2CDY.js";
 import "./chunk-YO3ZB3PJ.js";
 import "./chunk-HNZKVLAN.js";
 import "./chunk-EQWEIIKQ.js";
@@ -196,7 +196,7 @@ import "./chunk-TC5HBIIT.js";
 import "./chunk-5RUE3GHQ.js";
 import "./chunk-OADWQ5CR.js";
 import "./chunk-KF5EUVKQ.js";
-import "./chunk-KQILYXND.js";
+import "./chunk-3HYWNJDA.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-ALSGMEJR.js";

package/dist/index.js

@@ -96,7 +96,7 @@ import {
   validateTaxonomy,
   watchForChanges,
   writeManifest
-} from "./chunk-XPR7572Y.js";
+} from "./chunk-7PY55HMI.js";
 import {
   WEARABLE_SOURCE_PREFIX,
   buildExtractionTurns,
@@ -350,7 +350,7 @@ import {
   registerTrainingExportAdapter,
   runBulkImportCliCommand,
   runWearablesCliCommand
-} from "./chunk-SOTYFJOA.js";
+} from "./chunk-226RNKRU.js";
 import "./chunk-MMACM5G2.js";
 import "./chunk-54BGIBCR.js";
 import "./chunk-H4CKS5B2.js";
@@ -554,7 +554,7 @@ import {
 import "./chunk-H3FZVNRN.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-DZQZHQQ4.js";
+} from "./chunk-UDIJMITR.js";
 import {
   WearablesInputError,
   describeErrorForOperator
@@ -598,7 +598,7 @@ import {
   relayMissionAppendOperation,
   relayMissionReadOperation,
   relayMissionReceiptDigest
-} from "./chunk-B4C3JSJT.js";
+} from "./chunk-I4NJ2CDY.js";
 import "./chunk-YO3ZB3PJ.js";
 import "./chunk-HNZKVLAN.js";
 import "./chunk-EQWEIIKQ.js";
@@ -647,7 +647,7 @@ import {
   EngramAccessService,
   computeProcedureStats,
   formatProcedureStatsText
-} from "./chunk-KQILYXND.js";
+} from "./chunk-3HYWNJDA.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-ALSGMEJR.js";

package/dist/orchestrator.js

@@ -41,7 +41,7 @@ import {
   throwIfRecallAborted,
   tokenizeRecallQuery,
   utcDateKeysForLocalDay
-} from "./chunk-XPR7572Y.js";
+} from "./chunk-7PY55HMI.js";
 import "./chunk-5SB7SC2G.js";
 import "./chunk-3332THSR.js";
 import "./chunk-I74SUMNI.js";
@@ -125,7 +125,7 @@ import "./chunk-Q6IP2ARR.js";
 import "./chunk-6HEM6HTQ.js";
 import "./chunk-6QYST5XN.js";
 import "./chunk-YUQOAKPX.js";
-import "./chunk-SOTYFJOA.js";
+import "./chunk-226RNKRU.js";
 import "./chunk-MMACM5G2.js";
 import "./chunk-54BGIBCR.js";
 import "./chunk-H4CKS5B2.js";
@@ -218,7 +218,7 @@ import "./chunk-LBJBNWS2.js";
 import "./chunk-KD3QD3A5.js";
 import "./chunk-MYVPLJOO.js";
 import "./chunk-H3FZVNRN.js";
-import "./chunk-DZQZHQQ4.js";
+import "./chunk-UDIJMITR.js";
 import "./chunk-V7IZKJI3.js";
 import "./chunk-MKQBXQKU.js";
 import "./chunk-SEDEKFYQ.js";
@@ -231,7 +231,7 @@ import "./chunk-7RXCMVFQ.js";
 import "./chunk-XRNU7OEQ.js";
 import "./chunk-IC2TCZJ2.js";
 import "./chunk-D24OXEPB.js";
-import "./chunk-B4C3JSJT.js";
+import "./chunk-I4NJ2CDY.js";
 import "./chunk-YO3ZB3PJ.js";
 import "./chunk-HNZKVLAN.js";
 import "./chunk-EQWEIIKQ.js";
@@ -247,7 +247,7 @@ import "./chunk-KF5EUVKQ.js";
 import {
   hasIdentityRecoveryIntent,
   resolveEffectiveIdentityInjectionMode
-} from "./chunk-KQILYXND.js";
+} from "./chunk-3HYWNJDA.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-ALSGMEJR.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.9.3",
+  "version": "9.9.4",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3045,7 +3045,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.9.3"
+    "@remnic/coding-graph": "^9.9.4"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/access-recall-response.ts

@@ -15,7 +15,7 @@ import { type BudgetDecision, toBudgetWarning } from "./cross-namespace-budget.j
 import { decideDisclosureEscalation } from "./recall-disclosure-escalation.js";
 import { type TagMatchMode, applyTagFilter, normalizeTags, parseTagMatch } from "./recall-tag-filter.js";
 import type { RecallDisclosure, RecallPlanMode } from "./types.js";
-import { displaySafeBudgetsApplied } from "./orchestration/recall-result-formatter.js";
+import { displaySafeBudgetsApplied, displaySafeRecallSnapshot } from "./orchestration/recall-result-formatter.js";
 
 /**
  * Build the recall response from the completed pipeline (issue #1906 review
@@ -238,6 +238,15 @@ export async function assembleRecallResponse(
     request.includeDebug === true,
     request.sessionKey,
   );
+  // Relativize the debug snapshot's absolute internal paths (#2077). The
+  // snapshot returned by buildRecallDebug is the LIVE cached object (kept
+  // absolute for tracking/x-ray), so build a display-safe COPY rather than
+  // mutating it — mirroring the top-level `budgetsApplied` relativization.
+  const debugSnapshot = debug?.snapshot;
+  const safeDebug =
+    debug && debugSnapshot
+      ? { ...debug, snapshot: displaySafeRecallSnapshot(debugSnapshot, deps.orchestrator.config.memoryDir) }
+      : debug;
 
   // Fire-and-forget audit recording. Must never block or crash recall.
   let auditAnomalies: AccessAuditResult["anomalies"] | undefined;
@@ -295,7 +304,7 @@ export async function assembleRecallResponse(
       auditAnomalies,
       budgetWarning: toBudgetWarning(budgetDecision),
       latencyMs: snapshot?.latencyMs ?? (Date.now() - startedAt),
-      debug,
+      debug: safeDebug,
     },
     // Non-null when this recall reserved a cross-namespace budget event at
     // admission (#1906). Single-flight followers use it to record their OWN

package/src/orchestration/recall-result-formatter-display-safe.test.ts

@@ -0,0 +1,51 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { displaySafeRecallSnapshot } from "./recall-result-formatter.js";
+
+test("displaySafeRecallSnapshot relativizes result, budget, and tier-anchor paths without mutating input (#2077)", () => {
+  const memoryDir = "/srv/memory";
+  const flatAbs = `${memoryDir}/facts/2026-07-19/b.md`;
+  const nsResultAbs = `${memoryDir}/namespaces/tok-team/facts/2026-07-19/r.md`;
+  // An anchor that is NOT among the returned results — no authoritative owner.
+  const unmatchedAnchorAbs = `${memoryDir}/namespaces/ns-616c706861/facts/2026-07-19/a.md`;
+  const snapshot = {
+    resultPaths: [flatAbs, nsResultAbs],
+    resultNamespaces: [undefined, "team-alpha"],
+    budgetsApplied: {
+      includedMemoryPaths: [flatAbs, nsResultAbs],
+      includedMemoryNamespaces: [undefined, "team-alpha"],
+    },
+    tierExplain: {
+      tier: "direct-answer",
+      tierReason: "single high-confidence hit",
+      filteredBy: [],
+      candidatesConsidered: 2,
+      latencyMs: 1,
+      sourceAnchors: [
+        { path: nsResultAbs, lineRange: [1, 2] as [number, number] },
+        { path: unmatchedAnchorAbs },
+        { path: flatAbs },
+      ],
+    },
+  };
+
+  const safe = displaySafeRecallSnapshot(snapshot, memoryDir);
+
+  assert.deepEqual(safe.resultPaths, ["facts/2026-07-19/b.md", "team-alpha/facts/2026-07-19/r.md"]);
+  assert.deepEqual(safe.budgetsApplied.includedMemoryPaths, [
+    "facts/2026-07-19/b.md",
+    "team-alpha/facts/2026-07-19/r.md",
+  ]);
+  assert.deepEqual(safe.tierExplain.sourceAnchors, [
+    // Anchor coincides with a namespaced result → reuses its authoritative namespace.
+    { path: "team-alpha/facts/2026-07-19/r.md", lineRange: [1, 2] },
+    // Anchor not among the results → truthful storage-relative segment, never a decode.
+    { path: "namespaces/ns-616c706861/facts/2026-07-19/a.md" },
+    // Anchor coincides with a default-namespace result → memoryDir-relative.
+    { path: "facts/2026-07-19/b.md" },
+  ]);
+
+  // The input snapshot must not be mutated — the live cache keeps absolute paths.
+  assert.equal(snapshot.tierExplain.sourceAnchors[0].path, nsResultAbs);
+  assert.equal(snapshot.resultPaths[1], nsResultAbs);
+});

package/src/orchestration/recall-result-formatter.ts

@@ -114,6 +114,65 @@ export function displaySafeBudgetsApplied<
   };
 }
 
+/**
+ * Return a display-safe copy of a recall snapshot for the `includeDebug=true`
+ * surface (#2077). `resultPaths` and `budgetsApplied.includedMemoryPaths` are
+ * rendered namespace-relative from their aligned namespace metadata; a
+ * `tierExplain.sourceAnchors[]` entry reuses that SAME authoritative metadata
+ * when its absolute path matches a result/included path, and otherwise falls
+ * back to the memoryDir-relative on-disk form. Either way the debug flag never
+ * leaks absolute operator paths, and an anchor is never attributed to a decoded
+ * (guessed) namespace — an anchor carries no owner of its own. Returns a
+ * shallow copy; the input snapshot is never mutated.
+ */
+export function displaySafeRecallSnapshot<
+  T extends {
+    resultPaths?: string[];
+    resultNamespaces?: Array<string | undefined>;
+    budgetsApplied?: {
+      includedMemoryPaths?: string[];
+      includedMemoryNamespaces?: Array<string | undefined>;
+    };
+    tierExplain?: {
+      sourceAnchors?: Array<{ path: string; lineRange?: [number, number] }>;
+    };
+  },
+>(snapshot: T, memoryDir: string): T {
+  const resultPaths = snapshot.resultPaths?.map((p, i) =>
+    displayResultPath(p, memoryDir, snapshot.resultNamespaces?.[i]),
+  );
+  // Authoritative absolute-path -> namespace map recorded at capture time, so a
+  // tier anchor that coincides with a returned result renders under the SAME
+  // namespace as that result instead of the raw storage segment (#2077).
+  const namespaceByPath = new Map<string, string | undefined>();
+  snapshot.resultPaths?.forEach((p, i) => {
+    if (!namespaceByPath.has(p)) namespaceByPath.set(p, snapshot.resultNamespaces?.[i]);
+  });
+  snapshot.budgetsApplied?.includedMemoryPaths?.forEach((p, i) => {
+    if (!namespaceByPath.has(p)) {
+      namespaceByPath.set(p, snapshot.budgetsApplied?.includedMemoryNamespaces?.[i]);
+    }
+  });
+  const tierExplain =
+    snapshot.tierExplain?.sourceAnchors
+      ? {
+          ...snapshot.tierExplain,
+          sourceAnchors: snapshot.tierExplain.sourceAnchors.map((anchor) => ({
+            ...anchor,
+            path: displayResultPath(anchor.path, memoryDir, namespaceByPath.get(anchor.path)),
+          })),
+        }
+      : undefined;
+  return {
+    ...snapshot,
+    ...(resultPaths ? { resultPaths } : {}),
+    ...(snapshot.budgetsApplied
+      ? { budgetsApplied: displaySafeBudgetsApplied(snapshot.budgetsApplied, memoryDir) }
+      : {}),
+    ...(tierExplain ? { tierExplain } : {}),
+  };
+}
+
 // ---------------------------------------------------------------------------
 // Coordinator
 // ---------------------------------------------------------------------------