@remnic/core 9.3.665 → 9.3.667

package/dist/search/meilisearch-backend.js

@@ -3,8 +3,8 @@ import {
 } from "../chunk-DOCTITOP.js";
 import "../chunk-AER6MT24.js";
 import "../chunk-CINZGPSJ.js";
-import "../chunk-5GPPACXK.js";
 import "../chunk-YNQ6DFSV.js";
+import "../chunk-5GPPACXK.js";
 import "../chunk-2ODBA7MQ.js";
 import "../chunk-PVGDJXVK.js";
 import "../chunk-VS2IYZRU.js";

package/dist/search/orama-backend.js

@@ -4,8 +4,8 @@ import {
 } from "../chunk-Q5ZU3RNY.js";
 import "../chunk-AER6MT24.js";
 import "../chunk-CINZGPSJ.js";
-import "../chunk-5GPPACXK.js";
 import "../chunk-YNQ6DFSV.js";
+import "../chunk-5GPPACXK.js";
 import "../chunk-2ODBA7MQ.js";
 import "../chunk-PVGDJXVK.js";
 import "../chunk-VS2IYZRU.js";

package/dist/semantic-consolidation.js

@@ -7,16 +7,17 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-XW3W4PV4.js";
-import "./chunk-C7AF236A.js";
+} from "./chunk-JTPXSXHC.js";
+import "./chunk-AARDBQTA.js";
 import "./chunk-LN4YGHTM.js";
 import {
   resolveExtensionsRoot
 } from "./chunk-JLNBQWZ2.js";
 import "./chunk-3UXOZBHV.js";
-import "./chunk-VH6EIKVS.js";
+import "./chunk-WKMCC4NQ.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
+import "./chunk-5GPPACXK.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-AZBV4RRY.js";
 import "./chunk-AWJ2FHCF.js";
@@ -28,13 +29,13 @@ import "./chunk-6KYMPV2O.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-FVQJYWH7.js";
+import "./chunk-VF4XKTX3.js";
 import {
   CONSOLIDATION_OPERATORS,
   isConsolidationOperator,
   isSemanticConsolidationLlmOperator,
   isValidDerivedFromEntry
 } from "./chunk-G7D6GZ5J.js";
-import "./chunk-VF4XKTX3.js";
 import "./chunk-U3PN77QT.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-EYIEWJNI.js";

package/dist/semantic-rule-promotion.js

@@ -1,10 +1,11 @@
 import {
   promoteSemanticRuleFromMemory,
   setSemanticRulePromotionTestHooks
-} from "./chunk-IHG6CC7T.js";
-import "./chunk-VH6EIKVS.js";
+} from "./chunk-BQJUPECT.js";
+import "./chunk-WKMCC4NQ.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
+import "./chunk-5GPPACXK.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-AZBV4RRY.js";
 import "./chunk-AWJ2FHCF.js";
@@ -16,8 +17,8 @@ import "./chunk-6KYMPV2O.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-FVQJYWH7.js";
-import "./chunk-G7D6GZ5J.js";
 import "./chunk-VF4XKTX3.js";
+import "./chunk-G7D6GZ5J.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-J2HSAU72.js";

package/dist/semantic-rule-verifier.js

@@ -1,10 +1,11 @@
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-DSLUOQDY.js";
-import "./chunk-VH6EIKVS.js";
+} from "./chunk-XMWF6AU3.js";
+import "./chunk-WKMCC4NQ.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
+import "./chunk-5GPPACXK.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-AZBV4RRY.js";
 import "./chunk-AWJ2FHCF.js";
@@ -16,8 +17,8 @@ import "./chunk-6KYMPV2O.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-FVQJYWH7.js";
-import "./chunk-G7D6GZ5J.js";
 import "./chunk-VF4XKTX3.js";
+import "./chunk-G7D6GZ5J.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-ZBJMUXZH.js";
 import "./chunk-2ODBA7MQ.js";

package/dist/shared-context/manager.d.ts

@@ -22,9 +22,9 @@ declare const SharedFeedbackEntrySchema: z.ZodObject<{
     date: string;
     agent: string;
     reason: string;
-    confidence?: number | undefined;
     workflow?: string | undefined;
     tags?: string[] | undefined;
+    confidence?: number | undefined;
     severity?: "high" | "low" | "medium" | undefined;
     outcome?: string | undefined;
     refs?: string[] | undefined;
@@ -36,9 +36,9 @@ declare const SharedFeedbackEntrySchema: z.ZodObject<{
     date: string;
     agent: string;
     reason: string;
-    confidence?: number | undefined;
     workflow?: string | undefined;
     tags?: string[] | undefined;
+    confidence?: number | undefined;
     severity?: "high" | "low" | "medium" | undefined;
     outcome?: string | undefined;
     refs?: string[] | undefined;

package/dist/storage.js

@@ -9,9 +9,10 @@ import {
   parseEntityFile,
   serializeEntityFile,
   stripAttributesSuffix
-} from "./chunk-VH6EIKVS.js";
+} from "./chunk-WKMCC4NQ.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
+import "./chunk-5GPPACXK.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-AZBV4RRY.js";
 import "./chunk-AWJ2FHCF.js";
@@ -23,8 +24,8 @@ import "./chunk-6KYMPV2O.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-FVQJYWH7.js";
-import "./chunk-G7D6GZ5J.js";
 import "./chunk-VF4XKTX3.js";
+import "./chunk-G7D6GZ5J.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-J2HSAU72.js";

package/dist/transfer/backup.js

@@ -4,11 +4,11 @@ import {
 import "../chunk-765K3SAT.js";
 import "../chunk-X7Y7WX73.js";
 import "../chunk-J4EB7DNW.js";
+import "../chunk-UI3NYK34.js";
+import "../chunk-GCGJW34D.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";
-import "../chunk-UI3NYK34.js";
-import "../chunk-GCGJW34D.js";
 import "../chunk-A6XUJE5D.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/transfer/capsule-export.js

@@ -5,11 +5,11 @@ import {
 import "../chunk-WEHSQBFR.js";
 import "../chunk-X7Y7WX73.js";
 import "../chunk-J4EB7DNW.js";
+import "../chunk-UI3NYK34.js";
+import "../chunk-GCGJW34D.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";
-import "../chunk-UI3NYK34.js";
-import "../chunk-GCGJW34D.js";
 import "../chunk-A6XUJE5D.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/transfer/capsule-import.js

@@ -4,10 +4,10 @@ import {
 import "../chunk-VF4XKTX3.js";
 import "../chunk-WEHSQBFR.js";
 import "../chunk-X7Y7WX73.js";
+import "../chunk-GCGJW34D.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";
-import "../chunk-GCGJW34D.js";
 import "../chunk-A6XUJE5D.js";
 import "../chunk-VS2IYZRU.js";
 import "../chunk-PZ5AY32C.js";

package/dist/transfer/types.d.ts

@@ -313,13 +313,13 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         peerProfiles: boolean;
     }>;
 }, "strip", z.ZodTypeAny, {
+    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
-    schemaVersion: string;
     id: string;
     description: string;
     version: string;
@@ -334,13 +334,13 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         directAnswerEnabled: boolean;
     };
 }, {
+    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
-    schemaVersion: string;
     id: string;
     description: string;
     version: string;
@@ -464,13 +464,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             peerProfiles: boolean;
         }>;
     }, "strip", z.ZodTypeAny, {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -485,13 +485,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             directAnswerEnabled: boolean;
         };
     }, {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -518,13 +518,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -551,13 +551,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -683,13 +683,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 peerProfiles: boolean;
             }>;
         }, "strip", z.ZodTypeAny, {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -704,13 +704,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         }, {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -737,13 +737,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -770,13 +770,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -815,13 +815,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -854,13 +854,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;

package/dist/verified-recall.js

@@ -1,11 +1,12 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-YW52BQSU.js";
+} from "./chunk-2TCHDANJ.js";
 import "./chunk-HQ6NIBL6.js";
-import "./chunk-VH6EIKVS.js";
+import "./chunk-WKMCC4NQ.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
+import "./chunk-5GPPACXK.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-AZBV4RRY.js";
 import "./chunk-AWJ2FHCF.js";
@@ -17,8 +18,8 @@ import "./chunk-6KYMPV2O.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-FVQJYWH7.js";
-import "./chunk-G7D6GZ5J.js";
 import "./chunk-VF4XKTX3.js";
+import "./chunk-G7D6GZ5J.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-ZBJMUXZH.js";
 import "./chunk-2ODBA7MQ.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.3.665",
+  "version": "9.3.667",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",

package/src/capabilities.test.ts

@@ -0,0 +1,97 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { parseConfig } from "./config.js";
+import { resolveCapabilities, type CapabilitySet } from "./capabilities.js";
+
+/**
+ * Characterization tests for the recall-operation CapabilitySet (issue #1523).
+ *
+ * These guard against composition drift: every capability field must project
+ * from its `<field>Enabled` config flag, so a future edit to
+ * `resolveCapabilities` that accidentally maps a field to the wrong flag (the
+ * rule-39 gate-divergence class, moved up one layer) fails loudly here.
+ */
+
+/**
+ * Map of CapabilitySet field → the PluginConfig flag it projects from.
+ * Kept explicit (rather than derived by string concat) so the two graph flags
+ * with non-`<field>Enabled` names are covered too.
+ */
+const FIELD_TO_FLAG: Record<keyof CapabilitySet, string> = {
+  rerankCache: "rerankCacheEnabled",
+  recallDirectAnswer: "recallDirectAnswerEnabled",
+  recallMemoryWorthFilter: "recallMemoryWorthFilterEnabled",
+  recallMmr: "recallMmrEnabled",
+  recallReasoningTraceBoost: "recallReasoningTraceBoostEnabled",
+  recallPlannerLlm: "recallPlannerLlmEnabled",
+  recallPlanner: "recallPlannerEnabled",
+  recallConfidenceGate: "recallConfidenceGateEnabled",
+  graphRecall: "graphRecallEnabled",
+  graphAssistInFullMode: "graphAssistInFullModeEnabled",
+  graphExpandedIntent: "graphExpandedIntentEnabled",
+};
+
+const FIELDS = Object.keys(FIELD_TO_FLAG) as Array<keyof CapabilitySet>;
+
+test("resolveCapabilities projects every field from its <field>Enabled flag (true variant)", () => {
+  // Build a config where every migrated flag is explicitly true.
+  const overrides: Record<string, boolean> = {};
+  for (const flag of Object.values(FIELD_TO_FLAG)) overrides[flag] = true;
+  const config = parseConfig(overrides);
+  const caps = resolveCapabilities(config);
+
+  for (const field of FIELDS) {
+    const flag = FIELD_TO_FLAG[field];
+    assert.equal(
+      caps[field],
+      (config as unknown as Record<string, boolean>)[flag],
+      `caps.${field} must equal config.${flag} (true variant)`,
+    );
+    assert.equal(caps[field], true, `caps.${field} should be true here`);
+  }
+});
+
+test("resolveCapabilities projects every field from its <field>Enabled flag (false variant)", () => {
+  const overrides: Record<string, boolean> = {};
+  for (const flag of Object.values(FIELD_TO_FLAG)) overrides[flag] = false;
+  const config = parseConfig(overrides);
+  const caps = resolveCapabilities(config);
+
+  for (const field of FIELDS) {
+    const flag = FIELD_TO_FLAG[field];
+    // The two optional graph flags carry default-when-undefined semantics, but
+    // when explicitly set to a concrete boolean the projection must match it.
+    assert.equal(
+      caps[field],
+      (config as unknown as Record<string, boolean>)[flag],
+      `caps.${field} must equal config.${flag} (false variant)`,
+    );
+    assert.equal(caps[field], false, `caps.${field} should be false here`);
+  }
+});
+
+test("resolveCapabilities preserves optional-flag defaults when the flag is undefined", () => {
+  // parseConfig with no overrides exercises the documented defaults. The two
+  // optional graph flags encode asymmetric defaults on purpose:
+  //   graphAssistInFullModeEnabled → default-ON  (`!== false`)
+  //   graphExpandedIntentEnabled    → default-OFF (`=== true`)
+  const config = parseConfig({});
+  const caps = resolveCapabilities(config);
+
+  assert.equal(
+    caps.graphAssistInFullMode,
+    config.graphAssistInFullModeEnabled !== false,
+    "graphAssistInFullMode must be default-on unless explicitly false",
+  );
+  assert.equal(
+    caps.graphExpandedIntent,
+    config.graphExpandedIntentEnabled === true,
+    "graphExpandedIntent must be default-off unless explicitly true",
+  );
+});
+
+test("resolveCapabilities returns a frozen object", () => {
+  const caps = resolveCapabilities(parseConfig({}));
+  assert.equal(Object.isFrozen(caps), true, "CapabilitySet must be frozen");
+});

package/src/capabilities.ts

@@ -0,0 +1,86 @@
+/**
+ * CapabilitySet — recall-operation feature gates resolved once, then threaded.
+ *
+ * Issue #1523 (Phase 1 of epic #1520). Root cause this addresses: 161+
+ * scattered `config.<flag>Enabled` reads mean each gate is re-derived at every
+ * call site, and reviews keep finding parallel code paths where one branch
+ * checks a gate the other forgot (CLAUDE.md rule 39 — the "gate divergence"
+ * defect class). The fix is to resolve a frozen capability projection ONCE at
+ * the top of the recall operation and pass it down explicitly.
+ *
+ * Scope of THIS module (first migration PR): only the recall-operation-scoped
+ * flags below. Flags that are also read in graph construction, writes, CLI, or
+ * the summarizer are deliberately deferred to a follow-up so we never leave a
+ * single flag half-migrated (some sites on `caps.`, some on `config.`).
+ *
+ * Field naming: each field is the config flag name with the trailing `Enabled`
+ * removed (`recallMmrEnabled` → `recallMmr`).
+ *
+ * This is plumbing, not a feature — there is deliberately NO `enabled` gate for
+ * the CapabilitySet itself (rule 30 governs behavior changes; resolving and
+ * threading a capability projection must stay behavior-preserving).
+ */
+
+import type { PluginConfig } from "./types.js";
+
+/**
+ * Frozen projection of recall-operation feature gates.
+ *
+ * Every field is `readonly boolean`. The composition that maps a config flag to
+ * a capability (including default-when-undefined semantics for optional flags)
+ * lives ONLY in {@link resolveCapabilities} — call sites must read the
+ * capability, never re-derive it from raw config.
+ */
+export interface CapabilitySet {
+  /** `rerankCacheEnabled` — cache reranker scores across recall passes. */
+  readonly rerankCache: boolean;
+  /** `recallDirectAnswerEnabled` — observation-mode direct-answer tier. */
+  readonly recallDirectAnswer: boolean;
+  /** `recallMemoryWorthFilterEnabled` — Memory-Worth score reweighting. */
+  readonly recallMemoryWorthFilter: boolean;
+  /** `recallMmrEnabled` — maximal-marginal-relevance diversification. */
+  readonly recallMmr: boolean;
+  /** `recallReasoningTraceBoostEnabled` — boost reasoning-trace memories. */
+  readonly recallReasoningTraceBoost: boolean;
+  /** `recallPlannerLlmEnabled` — LLM-backed recall-mode planner. */
+  readonly recallPlannerLlm: boolean;
+  /** `recallPlannerEnabled` — recall-mode planner (heuristic + optional LLM). */
+  readonly recallPlanner: boolean;
+  /** `recallConfidenceGateEnabled` — Synapse-style confidence gate. */
+  readonly recallConfidenceGate: boolean;
+  /** `graphRecallEnabled` — graph-mode recall tier (gates planner graph mode). */
+  readonly graphRecall: boolean;
+  /** `graphAssistInFullModeEnabled` — graph-assist overlay in full mode. */
+  readonly graphAssistInFullMode: boolean;
+  /** `graphExpandedIntentEnabled` — promote broad-intent asks to graph mode. */
+  readonly graphExpandedIntent: boolean;
+}
+
+/**
+ * Resolve the recall-operation {@link CapabilitySet} from parsed config.
+ *
+ * Call this ONCE per recall operation (at the `recall()` / `recallInternal`
+ * entry) and thread the result down. Composition lives here and only here.
+ *
+ * Session toggles are intentionally not a parameter yet: `session-toggles.ts`
+ * is agent-scoped (per session/agent enable-disable of the whole plugin), not
+ * flag-scoped — none of the flags projected here have a per-session override,
+ * so there is nothing for a toggle argument to compose at this layer.
+ */
+export function resolveCapabilities(config: PluginConfig): CapabilitySet {
+  return Object.freeze({
+    rerankCache: config.rerankCacheEnabled,
+    recallDirectAnswer: config.recallDirectAnswerEnabled,
+    recallMemoryWorthFilter: config.recallMemoryWorthFilterEnabled,
+    recallMmr: config.recallMmrEnabled,
+    recallReasoningTraceBoost: config.recallReasoningTraceBoostEnabled,
+    recallPlannerLlm: config.recallPlannerLlmEnabled,
+    recallPlanner: config.recallPlannerEnabled,
+    recallConfidenceGate: config.recallConfidenceGateEnabled,
+    graphRecall: config.graphRecallEnabled,
+    // Optional flags: preserve the exact default-when-undefined semantics the
+    // migrated call sites used (`!== false` = default-on, `=== true` = default-off).
+    graphAssistInFullMode: config.graphAssistInFullModeEnabled !== false,
+    graphExpandedIntent: config.graphExpandedIntentEnabled === true,
+  });
+}