@remnic/core 9.3.715 → 9.3.717

package/dist/{chunk-MECU6WSH.js → chunk-2B43BYYZ.js}

@@ -89,7 +89,7 @@ import {
   runOperatorInventory,
   runOperatorRepair,
   runOperatorSetup
-} from "./chunk-RBHANGVX.js";
+} from "./chunk-BZAK3RBN.js";
 import {
   listNamespaces,
   runNamespaceMigration,
@@ -141,7 +141,7 @@ import {
 } from "./chunk-GY3SKOS4.js";
 import {
   formatNamespaceMaintenanceHealthText
-} from "./chunk-GM3BMWKR.js";
+} from "./chunk-KHQ433G5.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -215,7 +215,7 @@ import {
 } from "./chunk-OADWQ5CR.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-CTAHKIG6.js";
+} from "./chunk-EM22PCQR.js";
 import {
   WearablesInputError
 } from "./chunk-7WV3F5DQ.js";
@@ -228,10 +228,10 @@ import {
   createProductionChatLlmAdapter,
   loadChatSession,
   sessionBelongsToPrincipal
-} from "./chunk-SYDHFFAW.js";
+} from "./chunk-OUDAU3T5.js";
 import {
   EngramAccessService
-} from "./chunk-BNOAB5HH.js";
+} from "./chunk-YAINYEM3.js";
 import {
   WorkStorage
 } from "./chunk-GDB4J2H3.js";
@@ -7496,4 +7496,4 @@ export {
   listMemoryMarkdownFilePaths,
   registerCli
 };
-//# sourceMappingURL=chunk-MECU6WSH.js.map
+//# sourceMappingURL=chunk-2B43BYYZ.js.map

package/dist/chunk-2KF4HDG2.js

@@ -0,0 +1,24 @@
+// src/procedural/reinforcement-core.ts
+function clusterByKey(items, keyFn) {
+  const clusters = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const key = keyFn(item);
+    if (typeof key !== "string") {
+      throw new TypeError(
+        `clusterByKey: keyFn must return a string, got ${key === null ? "null" : typeof key}`
+      );
+    }
+    const existing = clusters.get(key);
+    if (existing) {
+      existing.push(item);
+    } else {
+      clusters.set(key, [item]);
+    }
+  }
+  return clusters;
+}
+
+export {
+  clusterByKey
+};
+//# sourceMappingURL=chunk-2KF4HDG2.js.map

package/dist/chunk-2KF4HDG2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/procedural/reinforcement-core.ts"],"sourcesContent":["/**\n * Generic reinforcement-core primitives extracted from `procedure-miner.ts`\n * (issue #687 PR 1/4). Procedure-specific scoring (success rate, step\n * normalization) intentionally stays in the miner — this module only\n * exposes category-agnostic clustering and cluster summarization helpers\n * so future PRs can run reinforcement across non-procedural categories.\n *\n * Pure refactor — no behavior change.\n */\n\n/**\n * Group `items` into clusters keyed by `keyFn(item)`.\n *\n * - Preserves the original input order within each cluster's array.\n * - The returned `Map` insertion order matches first-seen key order, so\n *   downstream iteration is deterministic for a given input.\n * - Throws `TypeError` if `keyFn` returns a non-string (e.g. `undefined`,\n *   `null`, or a number). Callers must produce a stable string key.\n */\nexport function clusterByKey<T>(items: readonly T[], keyFn: (item: T) => string): Map<string, T[]> {\n  const clusters = new Map<string, T[]>();\n  for (const item of items) {\n    const key = keyFn(item);\n    if (typeof key !== \"string\") {\n      throw new TypeError(\n        `clusterByKey: keyFn must return a string, got ${key === null ? \"null\" : typeof key}`,\n      );\n    }\n    const existing = clusters.get(key);\n    if (existing) {\n      existing.push(item);\n    } else {\n      clusters.set(key, [item]);\n    }\n  }\n  return clusters;\n}\n\nexport interface ClusterSummary {\n  /** Number of items in the cluster. */\n  count: number;\n  /** Earliest timestamp seen in the cluster (string min via `localeCompare`). */\n  firstSeen: string;\n  /** Latest timestamp seen in the cluster (string max via `localeCompare`). */\n  lastSeen: string;\n}\n\n/**\n * Summarize a cluster by counting items and tracking earliest/latest\n * timestamps. Timestamp comparison uses `String#localeCompare`, which is\n * correct for ISO-8601 strings (lexicographic order matches chronological\n * order).\n *\n * - Throws `RangeError` on empty clusters — `firstSeen`/`lastSeen` are not\n *   meaningful without at least one item.\n * - When all timestamps are equal, `firstSeen === lastSeen`.\n */\nexport function summarizeCluster<T>(\n  cluster: readonly T[],\n  extractTimestamp: (item: T) => string,\n): ClusterSummary {\n  if (cluster.length === 0) {\n    throw new RangeError(\"summarizeCluster: cluster must contain at least one item\");\n  }\n  let firstSeen = extractTimestamp(cluster[0]);\n  let lastSeen = firstSeen;\n  for (let i = 1; i < cluster.length; i += 1) {\n    const ts = extractTimestamp(cluster[i]);\n    if (ts.localeCompare(firstSeen) < 0) firstSeen = ts;\n    if (ts.localeCompare(lastSeen) > 0) lastSeen = ts;\n  }\n  return { count: cluster.length, firstSeen, lastSeen };\n}\n"],"mappings":";AAmBO,SAAS,aAAgB,OAAqB,OAA8C;AACjG,QAAM,WAAW,oBAAI,IAAiB;AACtC,aAAW,QAAQ,OAAO;AACxB,UAAM,MAAM,MAAM,IAAI;AACtB,QAAI,OAAO,QAAQ,UAAU;AAC3B,YAAM,IAAI;AAAA,QACR,iDAAiD,QAAQ,OAAO,SAAS,OAAO,GAAG;AAAA,MACrF;AAAA,IACF;AACA,UAAM,WAAW,SAAS,IAAI,GAAG;AACjC,QAAI,UAAU;AACZ,eAAS,KAAK,IAAI;AAAA,IACpB,OAAO;AACL,eAAS,IAAI,KAAK,CAAC,IAAI,CAAC;AAAA,IAC1B;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/{chunk-HHLWSWWF.js → chunk-BF2426TN.js}

@@ -1,6 +1,6 @@
 import {
   EngramAccessInputError
-} from "./chunk-BNOAB5HH.js";
+} from "./chunk-YAINYEM3.js";
 import {
   expandTildePath
 } from "./chunk-EYIEWJNI.js";
@@ -104,4 +104,4 @@ export {
   listRegisteredOperations,
   __resetRegistryForTest
 };
-//# sourceMappingURL=chunk-HHLWSWWF.js.map
+//# sourceMappingURL=chunk-BF2426TN.js.map

package/dist/{chunk-RBHANGVX.js → chunk-BZAK3RBN.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-YBPYIAA5.js";
 import {
   summarizeNamespaceMaintenanceHealth
-} from "./chunk-GM3BMWKR.js";
+} from "./chunk-KHQ433G5.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -1440,4 +1440,4 @@ export {
   runBenchmarkRecall,
   runOperatorRepair
 };
-//# sourceMappingURL=chunk-RBHANGVX.js.map
+//# sourceMappingURL=chunk-BZAK3RBN.js.map

package/dist/{chunk-YUJL27ET.js → chunk-CTUWGJRI.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-DGTDRIUO.js";
 import {
   MaintenanceScheduler
-} from "./chunk-O62P2LFL.js";
+} from "./chunk-VZQXJNBD.js";
 import {
   migrateFromEngram
 } from "./chunk-7HYPN2GC.js";
@@ -168,7 +168,7 @@ import {
 } from "./chunk-XHYGJVXL.js";
 import {
   tryDirectAnswer
-} from "./chunk-OQH5XUH3.js";
+} from "./chunk-Q6IP2ARR.js";
 import {
   EmbeddingFallback
 } from "./chunk-ZA2S2VLL.js";
@@ -206,11 +206,11 @@ import {
 import {
   runNamespaceMaintenanceFanout,
   summarizeNamespaceMaintenanceHealth
-} from "./chunk-GM3BMWKR.js";
+} from "./chunk-KHQ433G5.js";
 import {
   NamespaceCatalog,
   planNamespaceMaintenance
-} from "./chunk-6QUPUTT7.js";
+} from "./chunk-DZYARLJ7.js";
 import {
   NamespaceStorageRouter
 } from "./chunk-MPHDVHIB.js";
@@ -295,12 +295,8 @@ import {
   describeErrorForOperator
 } from "./chunk-7WV3F5DQ.js";
 import {
-  clusterByKey,
-  combineNamespaces,
-  resolveCodingNamespaceOverlay,
-  resolveScopePlan,
-  resolveScopeProfilePlan
-} from "./chunk-SHRRWOVY.js";
+  clusterByKey
+} from "./chunk-2KF4HDG2.js";
 import {
   listTrustZoneRecords,
   searchTrustZoneRecords
@@ -311,6 +307,14 @@ import {
 import {
   buildXraySnapshot
 } from "./chunk-AJOIM6UR.js";
+import {
+  combineNamespaces,
+  getConfiguredNamespaces,
+  resolveCodingNamespaceOverlay,
+  resolveNamespaceFromStorageDir,
+  resolveScopePlan,
+  resolveScopeProfilePlan
+} from "./chunk-J6BH2OBA.js";
 import {
   NamespaceSearchRouter
 } from "./chunk-CTOQEZSN.js";
@@ -2081,7 +2085,7 @@ function resolveRecallModeDecision(options) {
 }
 async function resolveRecallModeDecisionAsync(options) {
   const heuristicDecision = resolveRecallModeDecision(options);
-  const plannerLlmEnabled = options.caps?.recallPlannerLlm ?? options.config.recallPlannerLlmEnabled;
+  const plannerLlmEnabled = options.caps.recallPlannerLlm;
   if (!options.plannerEnabled || !plannerLlmEnabled) {
     return heuristicDecision;
   }
@@ -2090,9 +2094,9 @@ async function resolveRecallModeDecisionAsync(options) {
     options.prompt,
     options.hints,
     options.config,
+    options.caps,
     options.llm,
-    options.signal,
-    options.caps
+    options.signal
   );
   if (options.config.recallPlannerShadowMode) {
     return {
@@ -2779,16 +2783,8 @@ var Orchestrator = class _Orchestrator {
     const ns = typeof namespace === "string" && namespace.trim().length > 0 ? namespace.trim() : this.config.defaultNamespace;
     return this.storageRouter.storageFor(ns);
   }
-  configuredNamespaces() {
-    return Array.from(
-      new Set(
-        [
-          this.config.defaultNamespace,
-          this.config.sharedNamespace,
-          ...this.config.namespacePolicies.map((policy) => policy.name)
-        ].map((value) => value.trim()).filter(Boolean)
-      )
-    );
+  configuredNamespaceList() {
+    return getConfiguredNamespaces(this.config);
   }
   rememberNamespaceStorageDirHint(namespace, storageDir) {
     if (!this.config.namespacesEnabled || !storageDir) return;
@@ -2880,7 +2876,7 @@ var Orchestrator = class _Orchestrator {
       }
     }
     const configured = new Set(
-      this.configuredNamespaces().map((namespace) => normalizeNamespaceIdentity(namespace))
+      this.configuredNamespaceList().map((namespace) => normalizeNamespaceIdentity(namespace))
     );
     const preferredByStorageDir = /* @__PURE__ */ new Map();
     for (const record of compactedByNamespace.values()) {
@@ -2959,7 +2955,7 @@ var Orchestrator = class _Orchestrator {
     }
     const namespaces = this.config.namespacesEnabled ? Array.from(
       new Set(
-        (options.namespaces?.length ? options.namespaces : this.configuredNamespaces()).map((value) => value.trim()).filter(Boolean)
+        (options.namespaces?.length ? options.namespaces : this.configuredNamespaceList()).map((value) => value.trim()).filter(Boolean)
       )
     ) : [this.config.defaultNamespace];
     if (!this.config.namespacesEnabled) {
@@ -4089,7 +4085,7 @@ ${doc.content}` : doc.content,
     if (options?.dryRun !== true) {
       try {
         await this.processEntitySynthesisQueue(
-          this.namespaceFromStorageDir(targetStorage.dir),
+          this.storageDirNamespace(targetStorage.dir),
           5
         );
       } catch (error) {
@@ -11274,7 +11270,7 @@ ${normalized}`).digest("hex");
     const shouldPromoteToShared = (targetStorage, category, confidence) => {
       if (!this.config.namespacesEnabled || !profileAllowsSharedWrites || !sharedAutoPromotionAllows(category, confidence))
         return false;
-      if (this.namespaceFromStorageDir(targetStorage.dir) === this.config.sharedNamespace)
+      if (this.storageDirNamespace(targetStorage.dir) === this.config.sharedNamespace)
         return false;
       return true;
     };
@@ -11714,7 +11710,7 @@ ${normalized}`).digest("hex");
       const biTemporal = this.config.temporalBiTemporal && sourceContext?.validAt ? resolveFactEventTime(fact.eventTime, sourceContext.validAt) : void 0;
       let writeCategory = fact.category;
       let targetStorage = storage;
-      let targetNamespaceName = baseNamespace && baseNamespace.length > 0 ? baseNamespace : this.namespaceFromStorageDir(targetStorage.dir);
+      let targetNamespaceName = baseNamespace && baseNamespace.length > 0 ? baseNamespace : this.storageDirNamespace(targetStorage.dir);
       let routedRuleId;
       let routedNamespaceExplicit = false;
       if (routeRules.length > 0) {
@@ -11741,7 +11737,7 @@ ${normalized}`).digest("hex");
         }
       }
       if (this.config.extractionScopeClassificationEnabled && this.config.namespacesEnabled && fact.scope === "global" && !routedNamespaceExplicit) {
-        const currentNs = this.namespaceFromStorageDir(targetStorage.dir);
+        const currentNs = this.storageDirNamespace(targetStorage.dir);
         if (currentNs !== this.config.sharedNamespace && profileAllowsSharedWrites) {
           try {
             targetStorage = await this.storageRouter.storageFor(
@@ -11889,7 +11885,7 @@ ${normalized}`).digest("hex");
       let links = [];
       let contradictionDetected = false;
       if (this.config.contradictionDetectionEnabled && this.qmd.isAvailable() && faithfulnessEnforceStatus !== "pending_review") {
-        const targetNamespace = this.namespaceFromStorageDir(targetStorage.dir);
+        const targetNamespace = this.storageDirNamespace(targetStorage.dir);
         const contradiction = await this.checkForContradiction(
           fact.content,
           writeCategory,
@@ -12154,7 +12150,7 @@ ${normalized}`).digest("hex");
               memoryId: parentId,
               category: writeCategory,
               content: fact.content,
-              namespace: this.namespaceFromStorageDir(targetStorage.dir),
+              namespace: this.storageDirNamespace(targetStorage.dir),
               confidence: fact.confidence,
               source: "extraction"
             })
@@ -12163,7 +12159,7 @@ ${normalized}`).digest("hex");
         }
       }
       if (this.config.memoryLinkingEnabled && this.qmd.isAvailable()) {
-        const targetNamespace = this.namespaceFromStorageDir(targetStorage.dir);
+        const targetNamespace = this.storageDirNamespace(targetStorage.dir);
         const suggestedLinks = await this.suggestLinksForMemory(
           fact.content,
           writeCategory,
@@ -12232,7 +12228,7 @@ ${normalized}`).digest("hex");
             memoryId,
             category: writeCategory,
             content: fact.content,
-            namespace: this.namespaceFromStorageDir(targetStorage.dir),
+            namespace: this.storageDirNamespace(targetStorage.dir),
             confidence: fact.confidence,
             source: "extraction"
           })
@@ -12330,7 +12326,7 @@ ${normalized}`).digest("hex");
     let durableNonFactWritten = false;
     let durableNonFactTouchRecorded = false;
     const touchBaseNonFactNamespace = () => {
-      const baseTouchNamespace = baseNamespace && baseNamespace.length > 0 ? baseNamespace : this.namespaceFromStorageDir(storage.dir);
+      const baseTouchNamespace = baseNamespace && baseNamespace.length > 0 ? baseNamespace : this.storageDirNamespace(storage.dir);
     };
     const recordDurableNonFactWrite = () => {
       durableNonFactWritten = true;
@@ -13905,7 +13901,7 @@ ${lines.join("\n\n")}`;
         seenStorageDirs.add(storageKey);
         storages.push(storage);
       };
-      const fallbackNamespace = fallbackStorageDir !== null ? this.namespaceFromStorageDir(fallbackStorageDir) : this.config.defaultNamespace;
+      const fallbackNamespace = fallbackStorageDir !== null ? this.storageDirNamespace(fallbackStorageDir) : this.config.defaultNamespace;
       if (recallNamespaces.length === 0 || !this.config.namespacesEnabled || recallNamespaces.includes(fallbackNamespace)) {
         addStorage(fallbackStorage);
       }
@@ -14052,7 +14048,7 @@ ${lines.join("\n\n")}`;
       seenDirs.add(candidateRoot);
       matches.push({ storage, dir: candidateRoot, namespace });
     };
-    const fallbackNamespace = fallbackStorageDir !== null ? this.namespaceFromStorageDir(fallbackStorageDir) : this.config.defaultNamespace;
+    const fallbackNamespace = fallbackStorageDir !== null ? this.storageDirNamespace(fallbackStorageDir) : this.config.defaultNamespace;
     maybeAddStorage(fallbackStorage, fallbackNamespace);
     const candidateNamespaces = /* @__PURE__ */ new Set();
     candidateNamespaces.add(this.config.defaultNamespace);
@@ -15324,32 +15320,13 @@ ${lines.join("\n\n")}`;
     if (!m?.[1]) return this.config.defaultNamespace;
     return namespaceIdentityFromToken(m[1]) ?? m[1];
   }
-  namespaceFromStorageDir(storageDir) {
-    if (!this.config.namespacesEnabled) return this.config.defaultNamespace;
-    const resolvedStorageDir = path2.resolve(storageDir);
-    const resolvedMemoryDir = path2.resolve(this.config.memoryDir);
-    if (resolvedStorageDir === resolvedMemoryDir)
-      return this.config.defaultNamespace;
-    const m = resolvedStorageDir.match(/[\\/]namespaces[\\/]([^\\/]+)$/);
-    if (!m?.[1]) return this.config.defaultNamespace;
-    const dirName = m[1];
-    if (this.configuredNamespaces().includes(dirName)) {
-      return dirName;
-    }
-    this.loadNamespaceStorageDirHintsFromCatalog();
-    const hintedNamespaces = this.namespaceStorageDirHints.get(resolvedStorageDir);
-    if (hintedNamespaces?.has(dirName)) {
-      return dirName;
-    }
-    if (hintedNamespaces?.size === 1) {
-      const [hintedNamespace] = hintedNamespaces;
-      if (hintedNamespace) return hintedNamespace;
-    }
-    const decoded = namespaceIdentityFromToken(dirName);
-    if (decoded && namespaceIdentityToken(decoded) === dirName) {
-      return decoded;
-    }
-    return dirName;
+  storageDirNamespace(storageDir) {
+    return resolveNamespaceFromStorageDir(storageDir, {
+      config: this.config,
+      configuredNamespaces: this.configuredNamespaceList(),
+      hints: this.namespaceStorageDirHints,
+      loadHints: () => this.loadNamespaceStorageDirHintsFromCatalog()
+    });
   }
   // #1522: catalog touch methods removed — touches now happen at the storage chokepoint.
   /**
@@ -15437,4 +15414,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-YUJL27ET.js.map
+//# sourceMappingURL=chunk-CTUWGJRI.js.map