@remnic/core 9.69.49 → 9.69.51

package/dist/who-knows-cli.d.ts

@@ -1,5 +1,5 @@
-import { W as WhoKnowsResult } from './access-service-70VHaltr.js';
-import './types-DQ2H8gAC.js';
+import { W as WhoKnowsResult } from './access-service-BZaC-RZw.js';
+import './types-DCB90q3g.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -10,19 +10,20 @@ import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
 import './recall-navigation-config.js';
+import './recall-recognition-tier.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';
 import './local-llm-config.js';
 import './semantic-merge-config.js';
 import './types-continuity.js';
-import './orchestrator-Kx5zwNUm.js';
+import './orchestrator-BTqT3F6X.js';
 import './recall-state.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';
 import './included-memories.js';
 import './briefing.js';
-import './storage-BS7ux8F7.js';
+import './storage-DNQWtOSM.js';
 import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './active-context-transform.js';
@@ -38,7 +39,7 @@ import './write-envelope.js';
 import './structured-attributes.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
-import './local-llm-B0vd_rp9.js';
+import './local-llm-BXYC-mbU.js';
 import './model-registry.js';
 import './fallback-llm.js';
 import './fallback-llm-codex-subscription.js';
@@ -47,8 +48,8 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-DJgQkoLh.js';
-import './catalog-Byi9prz9.js';
+import './maintenance-zJiLsKBY.js';
+import './catalog-DK2eHhax.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';
@@ -58,7 +59,7 @@ import './utility-runtime.js';
 import './tier-routing.js';
 import './lifecycle.js';
 import './orchestration/compression-guideline-coordinator.js';
-import './semantic-consolidation-DMzhKRYl.js';
+import './semantic-consolidation-DEzRyeyn.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './embedding-fallback.js';
@@ -80,17 +81,17 @@ import './conversation-index/chunker.js';
 import './conversation-index/backend.js';
 import './faiss-adapter-BHecI1fF.js';
 import './runtime/child-process.js';
-import './dependency-propagation-delivery-BgHy44WX.js';
+import './dependency-propagation-delivery-BMkR4gmY.js';
 import './namespaces/storage.js';
 import './threading.js';
-import './scope-profiles-DPegZtRf.js';
+import './scope-profiles-Bg1rB-Dp.js';
 import './graph-DRkl22KE.js';
 import './graph-write-lock.js';
 import './recall-xray.js';
 import './memory-provenance.js';
 import './user-model.js';
 import './recall-context-composition.js';
-import './generic-recall-paths-BoueWXYr.js';
+import './generic-recall-paths-BCRtXU32.js';
 import './live-connectors-runner.js';
 import './framework-CNDn2164.js';
 import './relevance.js';
@@ -98,7 +99,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-BalR6EXU.js';
 import './replay/types.js';
-import './service-E99KuPvi.js';
+import './service-DGEIDOeD.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';
@@ -121,7 +122,7 @@ import './types-B1VHaf2w.js';
 import './transfer/capsule-import.js';
 import './transfer/types.js';
 import './recall-navigation.js';
-import './access-namespace-preflight-DqRw_g-8.js';
+import './access-namespace-preflight-C1q3XuAc.js';
 import './access-token-capabilities.js';
 import 'node:async_hooks';
 import './recall-explain-renderer.js';
@@ -129,7 +130,7 @@ import './access-citation.js';
 import './access-health-types.js';
 import './corpus-watermark.js';
 import './replica-divergence.js';
-import './tagging-BhOEcSXP.js';
+import './tagging-CPVwgadt.js';
 import './explicit-capture.js';
 import './access-wearables-meetings-surface.js';
 import './deep-recall.js';

package/dist/who-knows-cli.js

@@ -4,28 +4,28 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-KHLNIDWB.js";
-import "./chunk-LX32KV2C.js";
-import "./chunk-AJLQH4RO.js";
-import "./chunk-46WM6JX2.js";
+} from "./chunk-7TTOX6NW.js";
+import "./chunk-ETNC6TT6.js";
+import "./chunk-RIP2AOZW.js";
 import "./chunk-UHVXE24Y.js";
+import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-T3F2HWIG.js";
-import "./chunk-C3YEB7CR.js";
+import "./chunk-AIVRD66I.js";
+import "./chunk-PLJ2MQFT.js";
+import "./chunk-KVO2BTA4.js";
+import "./chunk-CYEPCZN5.js";
 import "./chunk-G6NQ3L4T.js";
 import "./chunk-WPGR3RW4.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-D7MAYFQP.js";
-import "./chunk-KVO2BTA4.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-CYEPCZN5.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
-import "./chunk-DNAD57VY.js";
+import "./chunk-PQWICTRO.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";

package/dist/who-knows.d.ts

@@ -1,6 +1,6 @@
-export { bA as WHO_KNOWS_AUTHORSHIP_BONUS, bB as WHO_KNOWS_DEFAULT_LIMIT, bC as WHO_KNOWS_MAX_EVIDENCE, bD as WHO_KNOWS_MAX_LIMIT, bE as WHO_KNOWS_MCP_TOOLS, bF as WhoKnowsEntity, bG as WhoKnowsEvidence, bH as WhoKnowsHit, bI as WhoKnowsHttpOutcome, W as WhoKnowsResult, bJ as WhoKnowsStorage, bT as computeWhoKnows, bZ as handleWhoKnowsHttpQuery, c2 as loadWhoKnowsEntities, c9 as tokenizeTopic, ca as validateWhoKnowsInput } from './access-service-70VHaltr.js';
-import './types-DQ2H8gAC.js';
-import './orchestrator-Kx5zwNUm.js';
+export { bA as WHO_KNOWS_AUTHORSHIP_BONUS, bB as WHO_KNOWS_DEFAULT_LIMIT, bC as WHO_KNOWS_MAX_EVIDENCE, bD as WHO_KNOWS_MAX_LIMIT, bE as WHO_KNOWS_MCP_TOOLS, bF as WhoKnowsEntity, bG as WhoKnowsEvidence, bH as WhoKnowsHit, bI as WhoKnowsHttpOutcome, W as WhoKnowsResult, bJ as WhoKnowsStorage, bT as computeWhoKnows, bZ as handleWhoKnowsHttpQuery, c2 as loadWhoKnowsEntities, c9 as tokenizeTopic, ca as validateWhoKnowsInput } from './access-service-BZaC-RZw.js';
+import './types-DCB90q3g.js';
+import './orchestrator-BTqT3F6X.js';
 import './recall-state.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';
@@ -14,6 +14,7 @@ import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
 import './recall-navigation-config.js';
+import './recall-recognition-tier.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';
@@ -22,7 +23,7 @@ import './semantic-merge-config.js';
 import './types-continuity.js';
 import './included-memories.js';
 import './briefing.js';
-import './storage-BS7ux8F7.js';
+import './storage-DNQWtOSM.js';
 import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './active-context-transform.js';
@@ -38,7 +39,7 @@ import './write-envelope.js';
 import './structured-attributes.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
-import './local-llm-B0vd_rp9.js';
+import './local-llm-BXYC-mbU.js';
 import './model-registry.js';
 import './fallback-llm.js';
 import './fallback-llm-codex-subscription.js';
@@ -47,8 +48,8 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-DJgQkoLh.js';
-import './catalog-Byi9prz9.js';
+import './maintenance-zJiLsKBY.js';
+import './catalog-DK2eHhax.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';
@@ -58,7 +59,7 @@ import './utility-runtime.js';
 import './tier-routing.js';
 import './lifecycle.js';
 import './orchestration/compression-guideline-coordinator.js';
-import './semantic-consolidation-DMzhKRYl.js';
+import './semantic-consolidation-DEzRyeyn.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './embedding-fallback.js';
@@ -80,17 +81,17 @@ import './conversation-index/chunker.js';
 import './conversation-index/backend.js';
 import './faiss-adapter-BHecI1fF.js';
 import './runtime/child-process.js';
-import './dependency-propagation-delivery-BgHy44WX.js';
+import './dependency-propagation-delivery-BMkR4gmY.js';
 import './namespaces/storage.js';
 import './threading.js';
-import './scope-profiles-DPegZtRf.js';
+import './scope-profiles-Bg1rB-Dp.js';
 import './graph-DRkl22KE.js';
 import './graph-write-lock.js';
 import './recall-xray.js';
 import './memory-provenance.js';
 import './user-model.js';
 import './recall-context-composition.js';
-import './generic-recall-paths-BoueWXYr.js';
+import './generic-recall-paths-BCRtXU32.js';
 import './live-connectors-runner.js';
 import './framework-CNDn2164.js';
 import './relevance.js';
@@ -98,7 +99,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-BalR6EXU.js';
 import './replay/types.js';
-import './service-E99KuPvi.js';
+import './service-DGEIDOeD.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';
@@ -121,7 +122,7 @@ import './types-B1VHaf2w.js';
 import './transfer/capsule-import.js';
 import './transfer/types.js';
 import './recall-navigation.js';
-import './access-namespace-preflight-DqRw_g-8.js';
+import './access-namespace-preflight-C1q3XuAc.js';
 import './access-token-capabilities.js';
 import 'node:async_hooks';
 import './recall-explain-renderer.js';
@@ -129,7 +130,7 @@ import './access-citation.js';
 import './access-health-types.js';
 import './corpus-watermark.js';
 import './replica-divergence.js';
-import './tagging-BhOEcSXP.js';
+import './tagging-CPVwgadt.js';
 import './explicit-capture.js';
 import './access-wearables-meetings-surface.js';
 import './deep-recall.js';

package/dist/who-knows.js

@@ -9,27 +9,27 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-LX32KV2C.js";
-import "./chunk-AJLQH4RO.js";
-import "./chunk-46WM6JX2.js";
+} from "./chunk-ETNC6TT6.js";
+import "./chunk-RIP2AOZW.js";
 import "./chunk-UHVXE24Y.js";
+import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-T3F2HWIG.js";
-import "./chunk-C3YEB7CR.js";
+import "./chunk-AIVRD66I.js";
+import "./chunk-PLJ2MQFT.js";
+import "./chunk-KVO2BTA4.js";
+import "./chunk-CYEPCZN5.js";
 import "./chunk-G6NQ3L4T.js";
 import "./chunk-WPGR3RW4.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-D7MAYFQP.js";
-import "./chunk-KVO2BTA4.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-CYEPCZN5.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
-import "./chunk-DNAD57VY.js";
+import "./chunk-PQWICTRO.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";

package/dist/write-envelope.d.ts

@@ -1,4 +1,4 @@
-import { u as MemoryCategory, N as MemorySubject } from './types-DQ2H8gAC.js';
+import { u as MemoryCategory, N as MemorySubject } from './types-DCB90q3g.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -9,6 +9,7 @@ import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
 import './recall-navigation-config.js';
+import './recall-recognition-tier.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/package.json

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

package/src/access-mcp-output-schemas.ts

@@ -83,7 +83,20 @@ const TOOL_OUTPUT_SCHEMAS: Readonly<Record<string, Record<string, unknown>>> = {
     query: T_STRING,
     namespace: T_STRING,
     context: T_STRING,
-    contextComposition: objectSchema({ context: T_STRING, footer: T_STRING }),
+    contextComposition: objectSchema({
+      context: T_STRING,
+      footer: T_STRING,
+      degradation: objectSchema({
+        state: T_STRING,
+        reason: T_STRING,
+        detail: T_STRING,
+        budget: objectSchema({
+          contextBudget: T_NUMBER,
+          fullChars: T_NUMBER,
+          deliveredChars: T_NUMBER,
+        }),
+      }),
+    }),
     count: T_NUMBER,
     memoryIds: T_ARRAY,
     results: T_ARRAY,

package/src/access-recall-response.ts

@@ -276,6 +276,9 @@ export async function assembleRecallResponse(
         plannerMode: snapshot?.plannerMode ?? mode,
         requestedMode: mode,
         fallbackUsed: snapshot?.fallbackUsed ?? false,
+        ...(effectiveComposition.degradation
+          ? { degradation: effectiveComposition.degradation }
+          : {}),
       };
       const auditResult = await deps.auditAdapter.record(
         resolvedAgentId || "__anonymous__",

package/src/config.ts

@@ -46,6 +46,7 @@ import {
   parseStandingBlockFreshDays,
   parseStandingBlockMaxChars,
 } from "./standing-memory-block.js";
+import { parseRecognitionIndexMaxEntries, parseRecallRecognitionTier } from "./recall-recognition-tier.js";
 import { parseRecallConcurrencyConfig } from "./recall-concurrency-config.js";
 import { parseExtractionFields } from "./extraction-span-config.js";
 import { parseReplicaPeersConfig } from "./replica-peers-config.js";
@@ -1967,6 +1968,10 @@ export function parseConfig(
     recallStandingBlock: parseRecallStandingBlock(cfg.recallStandingBlock),
     standingBlockFreshDays: parseStandingBlockFreshDays(cfg.standingBlockFreshDays),
     standingBlockMaxChars: parseStandingBlockMaxChars(cfg.standingBlockMaxChars),
+    // Full-index recognition tier (issue #2975). Default false; nothing on the
+    // recall path reads these keys until the wiring slice lands.
+    recallRecognitionTier: parseRecallRecognitionTier(cfg.recallRecognitionTier),
+    recognitionIndexMaxEntries: parseRecognitionIndexMaxEntries(cfg.recognitionIndexMaxEntries),
     // Disclosure auto-escalation (issue #677 PR 4/4).  Default `manual`
     // so pre-#677 callers see unchanged behavior.  Reject anything
     // outside the allow-list rather than silently defaulting (CLAUDE.md

package/src/directory-sidecars.test.ts

@@ -10,6 +10,8 @@ import {
   DIRECTORY_SIDECAR_MARKER,
   findDirectorySidecarsForQuery,
   loadDirectorySidecar,
+  parseDirectorySidecarsEnabled,
+  refreshDirectorySidecarsAfterWrite,
   runDirectorySidecarMaintenance,
 } from "./directory-sidecars.js";
 import {
@@ -266,3 +268,120 @@ test("user-authored sidecar-named files are never clobbered or removed", async (
     rmSync(root, { recursive: true, force: true });
   }
 });
+
+test("parseDirectorySidecarsEnabled defaults off and rejects nothing silently", () => {
+  assert.equal(parseDirectorySidecarsEnabled(undefined), false);
+  assert.equal(parseDirectorySidecarsEnabled(null), false);
+  assert.equal(parseDirectorySidecarsEnabled(false), false);
+  assert.equal(parseDirectorySidecarsEnabled("false"), false);
+  assert.equal(parseDirectorySidecarsEnabled(0), false);
+  assert.equal(parseDirectorySidecarsEnabled(true), true);
+  assert.equal(parseDirectorySidecarsEnabled("true"), true);
+  assert.equal(parseDirectorySidecarsEnabled(1), true);
+});
+
+test("write-path refresh is a zero-write no-op when disabled", async () => {
+  const root = store();
+  try {
+    const written = await writeMemory(
+      root,
+      "facts/2026-01-02/fact-1.md",
+      "North dome shutter cycle completed.",
+    );
+    const report = await refreshDirectorySidecarsAfterWrite(root, written, false);
+    assert.deepEqual(report.written, []);
+    assert.deepEqual(report.removed, []);
+    assert.equal(await exists(path.join(root, "facts", "2026-01-02", DIRECTORY_SIDECAR_BASENAME)), false);
+    assert.equal(await exists(path.join(root, "facts", DIRECTORY_SIDECAR_BASENAME)), false);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test("write-path refresh populates the day sidecar and the parent abstract", async () => {
+  const root = store();
+  try {
+    const written = await writeMemory(
+      root,
+      "facts/2026-01-02/fact-1.md",
+      "Telescope calibration log for the north dome.",
+    );
+    const report = await refreshDirectorySidecarsAfterWrite(root, written, true);
+    const daySidecar = path.join(root, "facts", "2026-01-02", DIRECTORY_SIDECAR_BASENAME);
+    const parentSidecar = path.join(root, "facts", DIRECTORY_SIDECAR_BASENAME);
+    assert.ok(report.written.includes(daySidecar), "day sidecar written on the write path");
+    assert.ok(report.written.includes(parentSidecar), "parent sidecar written after the child");
+    assert.ok(
+      report.written.indexOf(daySidecar) < report.written.indexOf(parentSidecar),
+      "child sidecar written before parent (bottom-up)",
+    );
+
+    const day = await loadDirectorySidecar(path.join(root, "facts", "2026-01-02"), { refresh: false });
+    assert.equal(day?.fresh, true, "write-path reuse of fingerprints leaves the sidecar fresh");
+    assert.match(day?.overview ?? "", /Telescope calibration/);
+
+    const parent = await readFile(parentSidecar, "utf8");
+    assert.match(parent, /2026-01-02/);
+    assert.ok(parent.startsWith(DIRECTORY_SIDECAR_MARKER));
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test("write-path refresh after delete updates the parent and prunes an emptied directory", async () => {
+  const root = store();
+  try {
+    const fact1 = await writeMemory(root, "facts/2026-01-02/fact-1.md", "First observation run.");
+    await writeMemory(root, "facts/2026-01-02/fact-2.md", "Second observation run.");
+    await refreshDirectorySidecarsAfterWrite(root, fact1, true);
+
+    rmSync(fact1);
+    const report = await refreshDirectorySidecarsAfterWrite(root, fact1, true);
+    const dayDir = path.join(root, "facts", "2026-01-02");
+    const daySidecar = await readFile(path.join(dayDir, DIRECTORY_SIDECAR_BASENAME), "utf8");
+    assert.doesNotMatch(daySidecar, /First observation/, "deleted child leaves the sidecar");
+    assert.match(daySidecar, /Second observation/);
+    assert.ok(report.written.some((p) => p === path.join(dayDir, DIRECTORY_SIDECAR_BASENAME)));
+    assert.ok(report.written.some((p) => p === path.join(root, "facts", DIRECTORY_SIDECAR_BASENAME)));
+
+    rmSync(path.join(dayDir, "fact-2.md"));
+    const pruned = await refreshDirectorySidecarsAfterWrite(root, path.join(dayDir, "fact-2.md"), true);
+    assert.ok(pruned.removed.some((p) => p === path.join(dayDir, DIRECTORY_SIDECAR_BASENAME)));
+    assert.equal(await exists(path.join(dayDir, DIRECTORY_SIDECAR_BASENAME)), false);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test("write-path refresh stays inside the changed namespace and skips unrelated categories", async () => {
+  const root = store();
+  try {
+    const alpha = await writeMemory(
+      root,
+      "namespaces/alpha/facts/2026-05-01/a-1.md",
+      "Alpha wing telescope mirror audit.",
+    );
+    await writeMemory(root, "namespaces/beta/facts/2026-05-01/b-1.md", "Beta wing spectrograph dark frames.");
+    await writeMemory(root, "entities/obs-1.md", "The north dome observer rotation schedule.");
+
+    const report = await refreshDirectorySidecarsAfterWrite(root, alpha, true);
+    assert.ok(
+      report.written.every((p) => p.includes(`${path.sep}namespaces${path.sep}alpha${path.sep}`)),
+      "write-path only touches the changed namespace ancestry",
+    );
+    assert.equal(
+      await exists(path.join(root, "namespaces", "beta", "facts", "2026-05-01", DIRECTORY_SIDECAR_BASENAME)),
+      false,
+    );
+    assert.equal(await exists(path.join(root, "entities", DIRECTORY_SIDECAR_BASENAME)), false);
+
+    const scoped = await loadDirectorySidecar(
+      path.join(root, "namespaces", "alpha", "facts", "2026-05-01"),
+      { refresh: false },
+    );
+    assert.equal(scoped?.fresh, true);
+    assert.match(scoped?.overview ?? "", /telescope mirror/);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});