@remnic/core 9.65.0 → 9.65.2

package/dist/chunk-AAXJNINV.js

@@ -0,0 +1,55 @@
+import {
+  PROMOTION_CANDIDATES_DEFAULT_MIN_ACCESS,
+  isSubjectGuardMode
+} from "./chunk-RIAM7DND.js";
+import {
+  coerceBool,
+  coerceNumber
+} from "./chunk-PQVCH2AE.js";
+
+// src/subject-config.ts
+function assertObjectBlock(value, key, shape) {
+  if (value === void 0) return;
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new Error(
+      `${key} must be an object (got ${JSON.stringify(value)}). Use ${shape} (issue #2372).`
+    );
+  }
+}
+function parseSubjectRuntimeConfig(cfg) {
+  assertObjectBlock(cfg.subjectClassification, "subjectClassification", "subjectClassification: { enabled: true }");
+  const classification = cfg.subjectClassification ?? {};
+  const rawEnabled = classification.enabled;
+  const enabledCoerced = coerceBool(rawEnabled);
+  if (rawEnabled !== void 0 && enabledCoerced === void 0) {
+    throw new Error(
+      `subjectClassification.enabled must be a boolean or one of "true"/"false"/"1"/"0"/"yes"/"no"/"on"/"off" (got ${JSON.stringify(rawEnabled)}) \u2014 rejected, not defaulted (issue #2372).`
+    );
+  }
+  const rawGuard = cfg.subjectGuard;
+  if (rawGuard !== void 0 && !isSubjectGuardMode(rawGuard)) {
+    throw new Error(
+      `subjectGuard must be one of: off, warn, enforce (got ${JSON.stringify(rawGuard)}) \u2014 rejected, not defaulted (issue #2372; checklist \xA71/\xA739).`
+    );
+  }
+  assertObjectBlock(cfg.promotionCandidates, "promotionCandidates", "promotionCandidates: { minAccessCount: 3 }");
+  const candidates = cfg.promotionCandidates ?? {};
+  const minAccessRaw = coerceNumber(candidates.minAccessCount);
+  if (candidates.minAccessCount !== void 0 && (minAccessRaw === void 0 || !Number.isFinite(minAccessRaw) || minAccessRaw < 0)) {
+    throw new Error(
+      `promotionCandidates.minAccessCount must be a non-negative number (got ${JSON.stringify(candidates.minAccessCount)}) \u2014 rejected, not defaulted (issue #2372).`
+    );
+  }
+  return {
+    subjectClassification: { enabled: rawEnabled === void 0 ? false : enabledCoerced === true },
+    subjectGuard: isSubjectGuardMode(rawGuard) ? rawGuard : "warn",
+    promotionCandidates: {
+      minAccessCount: minAccessRaw !== void 0 ? Math.floor(minAccessRaw) : PROMOTION_CANDIDATES_DEFAULT_MIN_ACCESS
+    }
+  };
+}
+
+export {
+  parseSubjectRuntimeConfig
+};
+//# sourceMappingURL=chunk-AAXJNINV.js.map

package/dist/chunk-AAXJNINV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/subject-config.ts"],"sourcesContent":["/**\n * Config parsing for the memory-subject runtime knobs (issue #2372).\n *\n * Extracted from config.ts (its structural-ratchet ceiling forbids growth);\n * `parseConfig` spreads `parseSubjectRuntimeConfig(cfg)` into the plugin\n * config literal.\n *\n * Validation posture (Review Prevention Checklist §1/§24/§39): invalid\n * values are REJECTED loudly, never silently reinterpreted — but an omitted\n * key takes the documented default. The deliberate asymmetry from the issue\n * stands: classification defaults OFF while the guard defaults \"warn\", so\n * enabling classification later immediately yields promotion warnings\n * without a second flag flip, and with classification off, unstamped\n * memories still only warn (never silently promote) at shared targets.\n */\n\nimport { coerceBool, coerceNumber } from \"./connectors/coerce.js\";\nimport {\n  isSubjectGuardMode,\n  PROMOTION_CANDIDATES_DEFAULT_MIN_ACCESS,\n} from \"./memory-subject.js\";\nimport type { SubjectGuardMode } from \"./types.js\";\n\nexport interface SubjectRuntimeConfig {\n  subjectClassification: { enabled: boolean };\n  subjectGuard: SubjectGuardMode;\n  promotionCandidates: { minAccessCount: number };\n}\n\n/**\n * Reject a non-object block loudly (rule 51 / §1): a shorthand like\n * `subjectClassification: false` must never normalize silently to `{}`.\n * Returns void so callers read the block through a DIRECT `cfg.<key>`\n * member access — the config-contract parser walker derives nested key\n * paths from those accesses, and a helper return value hides them.\n */\nfunction assertObjectBlock(value: unknown, key: string, shape: string): void {\n  if (value === undefined) return;\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new Error(\n      `${key} must be an object (got ${JSON.stringify(value)}). Use ${shape} (issue #2372).`,\n    );\n  }\n}\n\nexport function parseSubjectRuntimeConfig(cfg: Record<string, unknown>): SubjectRuntimeConfig {\n  assertObjectBlock(cfg.subjectClassification, \"subjectClassification\", \"subjectClassification: { enabled: true }\");\n  const classification = (cfg.subjectClassification ?? {}) as Record<string, unknown>;\n  const rawEnabled = classification.enabled;\n  const enabledCoerced = coerceBool(rawEnabled);\n  if (rawEnabled !== undefined && enabledCoerced === undefined) {\n    throw new Error(\n      `subjectClassification.enabled must be a boolean or one of \"true\"/\"false\"/\"1\"/\"0\"/` +\n        `\"yes\"/\"no\"/\"on\"/\"off\" (got ${JSON.stringify(rawEnabled)}) — rejected, not defaulted (issue #2372).`,\n    );\n  }\n  const rawGuard = cfg.subjectGuard;\n  if (rawGuard !== undefined && !isSubjectGuardMode(rawGuard)) {\n    throw new Error(\n      `subjectGuard must be one of: off, warn, enforce (got ${JSON.stringify(rawGuard)}) — ` +\n        `rejected, not defaulted (issue #2372; checklist §1/§39).`,\n    );\n  }\n  assertObjectBlock(cfg.promotionCandidates, \"promotionCandidates\", \"promotionCandidates: { minAccessCount: 3 }\");\n  const candidates = (cfg.promotionCandidates ?? {}) as Record<string, unknown>;\n  const minAccessRaw = coerceNumber(candidates.minAccessCount);\n  if (candidates.minAccessCount !== undefined && (minAccessRaw === undefined || !Number.isFinite(minAccessRaw) || minAccessRaw < 0)) {\n    throw new Error(\n      `promotionCandidates.minAccessCount must be a non-negative number (got ${JSON.stringify(candidates.minAccessCount)}) — rejected, not defaulted (issue #2372).`,\n    );\n  }\n  return {\n    subjectClassification: { enabled: rawEnabled === undefined ? false : enabledCoerced === true },\n    subjectGuard: isSubjectGuardMode(rawGuard) ? rawGuard : \"warn\",\n    promotionCandidates: {\n      minAccessCount:\n        minAccessRaw !== undefined ? Math.floor(minAccessRaw) : PROMOTION_CANDIDATES_DEFAULT_MIN_ACCESS,\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;AAoCA,SAAS,kBAAkB,OAAgB,KAAa,OAAqB;AAC3E,MAAI,UAAU,OAAW;AACzB,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAAG;AACvE,UAAM,IAAI;AAAA,MACR,GAAG,GAAG,2BAA2B,KAAK,UAAU,KAAK,CAAC,UAAU,KAAK;AAAA,IACvE;AAAA,EACF;AACF;AAEO,SAAS,0BAA0B,KAAoD;AAC5F,oBAAkB,IAAI,uBAAuB,yBAAyB,0CAA0C;AAChH,QAAM,iBAAkB,IAAI,yBAAyB,CAAC;AACtD,QAAM,aAAa,eAAe;AAClC,QAAM,iBAAiB,WAAW,UAAU;AAC5C,MAAI,eAAe,UAAa,mBAAmB,QAAW;AAC5D,UAAM,IAAI;AAAA,MACR,+GACgC,KAAK,UAAU,UAAU,CAAC;AAAA,IAC5D;AAAA,EACF;AACA,QAAM,WAAW,IAAI;AACrB,MAAI,aAAa,UAAa,CAAC,mBAAmB,QAAQ,GAAG;AAC3D,UAAM,IAAI;AAAA,MACR,wDAAwD,KAAK,UAAU,QAAQ,CAAC;AAAA,IAElF;AAAA,EACF;AACA,oBAAkB,IAAI,qBAAqB,uBAAuB,4CAA4C;AAC9G,QAAM,aAAc,IAAI,uBAAuB,CAAC;AAChD,QAAM,eAAe,aAAa,WAAW,cAAc;AAC3D,MAAI,WAAW,mBAAmB,WAAc,iBAAiB,UAAa,CAAC,OAAO,SAAS,YAAY,KAAK,eAAe,IAAI;AACjI,UAAM,IAAI;AAAA,MACR,yEAAyE,KAAK,UAAU,WAAW,cAAc,CAAC;AAAA,IACpH;AAAA,EACF;AACA,SAAO;AAAA,IACL,uBAAuB,EAAE,SAAS,eAAe,SAAY,QAAQ,mBAAmB,KAAK;AAAA,IAC7F,cAAc,mBAAmB,QAAQ,IAAI,WAAW;AAAA,IACxD,qBAAqB;AAAA,MACnB,gBACE,iBAAiB,SAAY,KAAK,MAAM,YAAY,IAAI;AAAA,IAC5D;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-YMOPYG3K.js → chunk-BIJAWZYW.js}

@@ -1,14 +1,14 @@
+import {
+  ActivationPathTracker,
+  compareActivationPathCandidates,
+  reconstructActivationPath
+} from "./chunk-LXY5VVGM.js";
 import {
   readEdgeConfidence
 } from "./chunk-2LSZVONP.js";
 import {
   emitGraphEvent
 } from "./chunk-DEUNUKTD.js";
-import {
-  ActivationPathTracker,
-  compareActivationPathCandidates,
-  reconstructActivationPath
-} from "./chunk-LXY5VVGM.js";
 
 // src/graph.ts
 import { appendFile, mkdir, readFile, stat } from "fs/promises";
@@ -745,4 +745,4 @@ export {
   applyPageRankRefinement,
   applyLateralInhibition
 };
-//# sourceMappingURL=chunk-YMOPYG3K.js.map
+//# sourceMappingURL=chunk-BIJAWZYW.js.map

package/dist/{chunk-YQ3CBLL4.js → chunk-BWLRUMOG.js}

@@ -11,6 +11,9 @@ import {
 import {
   parseLocationConfig
 } from "./chunk-7PHI6GUI.js";
+import {
+  parseSubjectRuntimeConfig
+} from "./chunk-AAXJNINV.js";
 import {
   cloneDefaultSessionObserverBands
 } from "./chunk-Z5LAYHGJ.js";
@@ -96,6 +99,74 @@ import {
 // src/config.ts
 import path from "path";
 
+// src/procedural/maintenance-config.ts
+function parseProceduralMaintenanceConfig(raw) {
+  if (raw !== void 0 && (raw === null || typeof raw !== "object" || Array.isArray(raw))) {
+    throw new Error(
+      `procedural.maintenance must be an object (got ${JSON.stringify(raw)}). Omit the key to keep maintenance disabled (issue #2370).`
+    );
+  }
+  const rawMaintenance = raw && typeof raw === "object" ? raw : {};
+  let enabled = false;
+  if (rawMaintenance.enabled !== void 0) {
+    const coerced = coerceBool(rawMaintenance.enabled);
+    if (coerced === void 0) {
+      throw new Error(
+        `procedural.maintenance.enabled must be a boolean or one of "true"/"false"/"1"/"0"/"yes"/"no"/"on"/"off" (got ${JSON.stringify(rawMaintenance.enabled)}).`
+      );
+    }
+    enabled = coerced;
+  }
+  const parseInteger = (key, fallback, min, max) => {
+    const value = rawMaintenance[key];
+    if (value === void 0) return fallback;
+    const coerced = coerceNumber(value);
+    if (coerced === void 0 || !Number.isFinite(coerced)) {
+      throw new Error(
+        `procedural.maintenance.${key} must be a finite number (got ${JSON.stringify(value)}).`
+      );
+    }
+    if (!Number.isInteger(coerced)) {
+      throw new Error(
+        `procedural.maintenance.${key} must be an integer (got ${JSON.stringify(value)}).`
+      );
+    }
+    if (coerced < min || coerced > max) {
+      throw new Error(
+        `procedural.maintenance.${key} must be between ${min} and ${max} (got ${JSON.stringify(value)}).`
+      );
+    }
+    return coerced;
+  };
+  let retireFailRatio = 2;
+  if (rawMaintenance.retireFailRatio !== void 0) {
+    const coerced = coerceNumber(rawMaintenance.retireFailRatio);
+    if (coerced === void 0 || !Number.isFinite(coerced) || coerced <= 0) {
+      throw new Error(
+        `procedural.maintenance.retireFailRatio must be a positive finite number (got ${JSON.stringify(rawMaintenance.retireFailRatio)}).`
+      );
+    }
+    retireFailRatio = coerced;
+  }
+  let mergeEnabled = true;
+  if (rawMaintenance.mergeEnabled !== void 0) {
+    const coerced = coerceBool(rawMaintenance.mergeEnabled);
+    if (coerced === void 0) {
+      throw new Error(
+        `procedural.maintenance.mergeEnabled must be a boolean or one of "true"/"false"/"1"/"0"/"yes"/"no"/"on"/"off" (got ${JSON.stringify(rawMaintenance.mergeEnabled)}).`
+      );
+    }
+    mergeEnabled = coerced;
+  }
+  return {
+    enabled,
+    retireIdleDays: parseInteger("retireIdleDays", 90, 0, 36500),
+    retireMinOutcomes: parseInteger("retireMinOutcomes", 5, 1, 1e5),
+    retireFailRatio,
+    mergeEnabled
+  };
+}
+
 // src/wearables/config.ts
 var KNOWN_WEARABLE_SOURCE_IDS = ["limitless", "bee", "omi"];
 var MEMORY_MODES = ["off", "review", "auto", "smart"];
@@ -1688,6 +1759,7 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
   const lookbackDays = lookbackCoerced !== void 0 && Number.isFinite(lookbackCoerced) ? Math.min(3650, Math.max(1, Math.floor(lookbackCoerced))) : 14;
   const recallMaxCoerced = coerceNumber(rawProcedural.recallMaxProcedures);
   const recallMaxProcedures = recallMaxCoerced !== void 0 && Number.isFinite(recallMaxCoerced) ? Math.min(10, Math.max(1, Math.floor(recallMaxCoerced))) : 2;
+  const maintenance = parseProceduralMaintenanceConfig(rawProcedural.maintenance);
   const rawEnabledValue = rawProcedural.enabled;
   let proceduralEnabled;
   if (rawEnabledValue === void 0) {
@@ -1702,6 +1774,7 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
     proceduralEnabled = enabledCoerced;
   }
   const procedural = {
+    maintenance,
     enabled: proceduralEnabled,
     /** `0` skips all mining (`minOccurrences_zero`); otherwise clusters need at least this many members. */
     minOccurrences: Math.min(1e3, Math.max(0, proceduralMinRaw)),
@@ -2789,10 +2862,10 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
       }
       return "low";
     })(),
-    // Extraction scope classification. When enabled, the extraction prompt
-    // asks the LLM to classify each fact as "project" or "global". Global
-    // facts are promoted to the shared namespace. Default true (rule 30 gate).
+    // Extraction scope classification (rule 30 gate): "global" facts promote
+    // to the shared namespace. Default true.
     extractionScopeClassificationEnabled: coerceBool(cfg.extractionScopeClassificationEnabled) !== false,
+    ...parseSubjectRuntimeConfig(cfg),
     // Extraction judge (issue #376). Opt-in LLM-as-judge fact-worthiness gate.
     extractionJudgeEnabled: cfg.extractionJudgeEnabled === true,
     extractionJudgeModel: typeof cfg.extractionJudgeModel === "string" ? cfg.extractionJudgeModel : "",
@@ -2802,10 +2875,7 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
     // text before the verdict is forcibly converted to reject.
     extractionJudgeMaxDeferrals: typeof cfg.extractionJudgeMaxDeferrals === "number" && Number.isFinite(cfg.extractionJudgeMaxDeferrals) && cfg.extractionJudgeMaxDeferrals >= 1 ? Math.floor(cfg.extractionJudgeMaxDeferrals) : 2,
     // Judge telemetry (issue #562 PR 3): opt-in structured emit to the
-    // observation ledger for defer-rate / latency metrics.
-    // Uses `coerceBool` so CLI-style string inputs (`"true"`, `"false"`,
-    // `"1"`, `"0"`) are accepted consistently with the rest of the
-    // codebase (CLAUDE.md gotcha 36).
+    // observation ledger; `coerceBool` accepts CLI-style strings (gotcha 36).
     extractionJudgeTelemetryEnabled: coerceBool(cfg.extractionJudgeTelemetryEnabled) === true,
     // Judge training-pair collection (issue #562 PR 4): opt-in shim for a
     // future GRPO training pipeline. Rows land under ~/.remnic/judge-
@@ -3936,4 +4006,4 @@ export {
   VALID_MEMORY_CATEGORIES,
   parseConfig
 };
-//# sourceMappingURL=chunk-YQ3CBLL4.js.map
+//# sourceMappingURL=chunk-BWLRUMOG.js.map