@remnic/core 10.0.12 → 10.0.14

package/dist/who-knows-cli.js

@@ -4,21 +4,21 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-A2L3P2IY.js";
-import "./chunk-OM3RWZQK.js";
-import "./chunk-BD5QEP3T.js";
+} from "./chunk-5WCJLQTM.js";
+import "./chunk-4KY5GSMB.js";
+import "./chunk-PAZ35RJ4.js";
 import "./chunk-UHVXE24Y.js";
-import "./chunk-LZKOVXMX.js";
+import "./chunk-TRMJ6BYC.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-7UX44C4N.js";
-import "./chunk-MB5EJ2CT.js";
+import "./chunk-N4C7QKOG.js";
+import "./chunk-O2IPAX26.js";
+import "./chunk-S7LWX2PQ.js";
+import "./chunk-T2YX56QI.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-5BUCKFRE.js";
-import "./chunk-S7LWX2PQ.js";
-import "./chunk-T2YX56QI.js";
 import "./chunk-4O6WRBGE.js";
+import "./chunk-VOKHZRHW.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
@@ -28,36 +28,37 @@ import "./chunk-S2V7RUCL.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-LDXUBPMO.js";
 import "./chunk-DM2T26WE.js";
-import "./chunk-FF6N7BXC.js";
+import "./chunk-LDXUBPMO.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-YYO447A7.js";
+import "./chunk-FF6N7BXC.js";
+import "./chunk-JNIVZNIB.js";
+import "./chunk-YXZG5TVN.js";
 import "./chunk-ZIKENA2C.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-3ONXXHQO.js";
-import "./chunk-YXZG5TVN.js";
-import "./chunk-3WU7XOFN.js";
 import "./chunk-6MKLMEBE.js";
-import "./chunk-QZZPUREO.js";
+import "./chunk-3WU7XOFN.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-3GYSZHMT.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-4NDWE44P.js";
+import "./chunk-NZFFGO5O.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
-import "./chunk-G7D6GZ5J.js";
-import "./chunk-DGRMWDQY.js";
+import "./chunk-6EDW54SQ.js";
+import "./chunk-66BCOVW2.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-SWWHIJUJ.js";
+import "./chunk-TPSLVZHS.js";
 import "./chunk-SIGAGKNE.js";
 import "./chunk-IUM3VSHI.js";
-import "./chunk-WVHRNAXL.js";
-import "./chunk-TPSLVZHS.js";
-import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
+import "./chunk-23G5P7TA.js";
 import "./chunk-TKC5LZ43.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
@@ -70,33 +71,34 @@ import "./chunk-YCVB7X56.js";
 import "./chunk-PQVCH2AE.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
-import "./chunk-QWWMS4AE.js";
+import "./chunk-3MO4LWYU.js";
 import "./chunk-YBA52OKG.js";
-import "./chunk-OFCHT2TN.js";
+import "./chunk-5LRV557D.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-VFTK5WKI.js";
+import "./chunk-STBX5X6B.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-FQD2KPQH.js";
+import "./chunk-P55FACBG.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
+import "./chunk-YET735EZ.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-C7HJ3NEI.js";
-import "./chunk-KI6UOSNR.js";
-import "./chunk-BTNNL7ZW.js";
+import "./chunk-DEY7B77Y.js";
 import "./chunk-5FVVY2EB.js";
+import "./chunk-BTNNL7ZW.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-EHRE7ZG3.js";
+import "./chunk-5B5WYAHQ.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VUFL7X3H.js";
-import "./chunk-2EMROIXS.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-C5LWPYS3.js";
+import "./chunk-PGRZ3FYC.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/who-knows.js

@@ -9,20 +9,20 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-OM3RWZQK.js";
-import "./chunk-BD5QEP3T.js";
+} from "./chunk-4KY5GSMB.js";
+import "./chunk-PAZ35RJ4.js";
 import "./chunk-UHVXE24Y.js";
-import "./chunk-LZKOVXMX.js";
+import "./chunk-TRMJ6BYC.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-7UX44C4N.js";
-import "./chunk-MB5EJ2CT.js";
+import "./chunk-N4C7QKOG.js";
+import "./chunk-O2IPAX26.js";
+import "./chunk-S7LWX2PQ.js";
+import "./chunk-T2YX56QI.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-5BUCKFRE.js";
-import "./chunk-S7LWX2PQ.js";
-import "./chunk-T2YX56QI.js";
 import "./chunk-4O6WRBGE.js";
+import "./chunk-VOKHZRHW.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
@@ -32,36 +32,37 @@ import "./chunk-S2V7RUCL.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-LDXUBPMO.js";
 import "./chunk-DM2T26WE.js";
-import "./chunk-FF6N7BXC.js";
+import "./chunk-LDXUBPMO.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-YYO447A7.js";
+import "./chunk-FF6N7BXC.js";
+import "./chunk-JNIVZNIB.js";
+import "./chunk-YXZG5TVN.js";
 import "./chunk-ZIKENA2C.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-3ONXXHQO.js";
-import "./chunk-YXZG5TVN.js";
-import "./chunk-3WU7XOFN.js";
 import "./chunk-6MKLMEBE.js";
-import "./chunk-QZZPUREO.js";
+import "./chunk-3WU7XOFN.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-3GYSZHMT.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-4NDWE44P.js";
+import "./chunk-NZFFGO5O.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
-import "./chunk-G7D6GZ5J.js";
-import "./chunk-DGRMWDQY.js";
+import "./chunk-6EDW54SQ.js";
+import "./chunk-66BCOVW2.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-SWWHIJUJ.js";
+import "./chunk-TPSLVZHS.js";
 import "./chunk-SIGAGKNE.js";
 import "./chunk-IUM3VSHI.js";
-import "./chunk-WVHRNAXL.js";
-import "./chunk-TPSLVZHS.js";
-import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
+import "./chunk-23G5P7TA.js";
 import "./chunk-TKC5LZ43.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
@@ -74,33 +75,34 @@ import "./chunk-YCVB7X56.js";
 import "./chunk-PQVCH2AE.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
-import "./chunk-QWWMS4AE.js";
+import "./chunk-3MO4LWYU.js";
 import "./chunk-YBA52OKG.js";
-import "./chunk-OFCHT2TN.js";
+import "./chunk-5LRV557D.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-VFTK5WKI.js";
+import "./chunk-STBX5X6B.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-FQD2KPQH.js";
+import "./chunk-P55FACBG.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
+import "./chunk-YET735EZ.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-C7HJ3NEI.js";
-import "./chunk-KI6UOSNR.js";
-import "./chunk-BTNNL7ZW.js";
+import "./chunk-DEY7B77Y.js";
 import "./chunk-5FVVY2EB.js";
+import "./chunk-BTNNL7ZW.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-EHRE7ZG3.js";
+import "./chunk-5B5WYAHQ.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VUFL7X3H.js";
-import "./chunk-2EMROIXS.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-C5LWPYS3.js";
+import "./chunk-PGRZ3FYC.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/write-envelope.js

@@ -12,17 +12,18 @@ import {
   isMemoryCategory,
   isSealedMemoryEnvelope,
   sealedWriteToLegacyArgs
-} from "./chunk-OFCHT2TN.js";
+} from "./chunk-5LRV557D.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-VFTK5WKI.js";
-import "./chunk-KI6UOSNR.js";
+import "./chunk-STBX5X6B.js";
+import "./chunk-DEY7B77Y.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-EHRE7ZG3.js";
+import "./chunk-5B5WYAHQ.js";
 import "./chunk-P7FMDTKL.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-PGRZ3FYC.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-MAAL6OZV.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-VS2IYZRU.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "10.0.12",
+  "version": "10.0.14",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -61,6 +61,26 @@
       "remnic-source": "./src/http-retry.ts",
       "import": "./dist/http-retry.js"
     },
+    "./capture-write-lock-backoff": {
+      "types": "./dist/capture-write-lock-backoff.d.ts",
+      "remnic-source": "./src/capture-write-lock-backoff.ts",
+      "import": "./dist/capture-write-lock-backoff.js"
+    },
+    "./capture-write-lock-backoff.js": {
+      "types": "./dist/capture-write-lock-backoff.d.ts",
+      "remnic-source": "./src/capture-write-lock-backoff.ts",
+      "import": "./dist/capture-write-lock-backoff.js"
+    },
+    "./capture-write-lock": {
+      "types": "./dist/capture-write-lock.d.ts",
+      "remnic-source": "./src/capture-write-lock.ts",
+      "import": "./dist/capture-write-lock.js"
+    },
+    "./capture-write-lock.js": {
+      "types": "./dist/capture-write-lock.d.ts",
+      "remnic-source": "./src/capture-write-lock.ts",
+      "import": "./dist/capture-write-lock.js"
+    },
     "./abort-error.js": {
       "types": "./dist/abort-error.d.ts",
       "remnic-source": "./src/abort-error.ts",
@@ -3327,7 +3347,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^10.0.12"
+    "@remnic/coding-graph": "^10.0.14"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/calibration.test.ts

@@ -1,9 +1,33 @@
 import assert from "node:assert/strict";
+import { mkdtemp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
 import test from "node:test";
 
-import { synthesizeCalibrationRules, type CorrectionMemory } from "./calibration.js";
+import {
+  readCalibrationIndex,
+  runCalibrationConsolidation,
+  synthesizeCalibrationRules,
+  withAppliedCalibrationWeek,
+  type CalibrationRule,
+  type CorrectionMemory,
+} from "./calibration.js";
 import type { FallbackLlmClient } from "./fallback-llm.js";
 
+const existingRule: CalibrationRule = {
+  id: "cal-existing",
+  ruleType: "model_tendency",
+  condition: "When reporting status",
+  modelTendency: "It overstates progress",
+  userExpectation: "Report what finished",
+  calibration: "Name the checks that finished.",
+  confidence: 0.8,
+  evidenceCount: 2,
+  evidenceCorrectionIds: ["c1", "c2"],
+  createdAt: "2026-03-16T00:00:00.000Z",
+  lastReinforcedAt: "2026-03-16T00:00:00.000Z",
+};
+
 const corrections: CorrectionMemory[] = [
   {
     id: "c1",
@@ -97,3 +121,58 @@ test("synthesizeCalibrationRules clamps confidence and filters evidence IDs", as
   assert.deepEqual(rules[1]?.evidenceCorrectionIds, []);
   assert.equal(rules[1]?.evidenceCount, 0);
 });
+
+test("withAppliedCalibrationWeek commits the week stamp with the reinforced index", () => {
+  const stamped = withAppliedCalibrationWeek({
+    rules: [existingRule],
+    updatedAt: "2026-03-16T00:00:00.000Z",
+    totalCorrectionsAnalyzed: 4,
+  }, " 2026-W11 ");
+  assert.deepEqual(stamped.appliedWeekIds, ["2026-W11"]);
+  assert.equal(stamped.rules[0]?.evidenceCount, 2);
+
+  const preserved = withAppliedCalibrationWeek(stamped, " ");
+  assert.deepEqual(preserved.appliedWeekIds, ["2026-W11"]);
+  assert.deepEqual(withAppliedCalibrationWeek(stamped, "x".repeat(33)).appliedWeekIds, ["2026-W11"]);
+
+  // A later week keeps the earlier stamp: an out-of-order retry of week A
+  // after week B must still be recognized as already applied.
+  assert.deepEqual(withAppliedCalibrationWeek(stamped, "2026-W13").appliedWeekIds, ["2026-W11", "2026-W13"]);
+});
+
+test("runCalibrationConsolidation does not reinforce an already-applied week", async () => {
+  const memoryDir = await mkdtemp(path.join(tmpdir(), "calibration-week-"));
+  try {
+    // Legacy on-disk shape: the pre-list index persisted a single appliedWeekId.
+    const indexDir = path.join(memoryDir, "state", "calibration");
+    await mkdir(indexDir, { recursive: true });
+    const indexPath = path.join(indexDir, "calibration-index.json");
+    const body = JSON.stringify(
+      {
+        rules: [existingRule],
+        updatedAt: "2026-03-16T00:00:00.000Z",
+        totalCorrectionsAnalyzed: 3,
+        appliedWeekId: "2026-W11",
+      },
+      null,
+      2
+    );
+    await writeFile(indexPath, body, "utf8");
+
+    // Retry of the stamped week: no reinforcement, no rewrite.
+    const rules = await runCalibrationConsolidation({
+      memoryDir,
+      idempotencyKey: "2026-W11",
+    });
+    assert.equal(rules[0]?.evidenceCount, 2);
+    assert.equal(await readFile(indexPath, "utf8"), body);
+
+    // A retry of an older week stays recognized after a newer week applied:
+    // the reader folds the legacy single stamp into the applied-week list.
+    const reread = await readCalibrationIndex(memoryDir);
+    assert.deepEqual(reread.appliedWeekIds, ["2026-W11"]);
+    assert.equal(reread.rules[0]?.evidenceCount, 2);
+  } finally {
+    await rm(memoryDir, { recursive: true, force: true });
+  }
+});

package/src/calibration.ts

@@ -13,7 +13,7 @@
  */
 
 import { createHash } from "node:crypto";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { mkdir, readFile } from "node:fs/promises";
 import path from "node:path";
 import { resolveLocalLlmCapabilities } from "./capabilities.js";
 import { OUTPUT_LANGUAGE_POLICY } from "./extraction-prompt.js";
@@ -21,6 +21,7 @@ import { FallbackLlmClient } from "./fallback-llm.js";
 import { listJsonFiles } from "./json-store.js";
 import { LocalLlmClient } from "./local-llm.js";
 import { log } from "./logger.js";
+import { writeFileAtomically } from "./maintenance/atomic-file.js";
 import type { AgentPersonaModelConfig, GatewayConfig, PluginConfig } from "./types.js";
 
 // ─── Types ───────────────────────────────────────────────────────────────────
@@ -43,6 +44,12 @@ export interface CalibrationIndex {
   rules: CalibrationRule[];
   updatedAt: string;
   totalCorrectionsAnalyzed: number;
+  /**
+   * Weeks whose rule reinforcement is already committed. A retry of any of
+   * these weeks must not increment `evidenceCount` again. Older indexes
+   * persisted a single `appliedWeekId`; reads fold it into this list.
+   */
+  appliedWeekIds?: string[];
 }
 
 // ─── Storage ─────────────────────────────────────────────────────────────────
@@ -55,24 +62,74 @@ function calibrationIndexPath(memoryDir: string): string {
   return path.join(calibrationDir(memoryDir), "calibration-index.json");
 }
 
+/** Week ids are short (`YYYY-Www`). Longer values are not used as stamps. */
+const MAX_APPLIED_WEEK_ID_LENGTH = 32;
+
+export function appliedCalibrationWeekId(value: unknown): string | undefined {
+  if (typeof value !== "string") return undefined;
+  const trimmed = value.trim();
+  if (trimmed.length === 0 || trimmed.length > MAX_APPLIED_WEEK_ID_LENGTH) return undefined;
+  return trimmed;
+}
+
 export async function readCalibrationIndex(memoryDir: string): Promise<CalibrationIndex> {
   try {
     const raw = JSON.parse(await readFile(calibrationIndexPath(memoryDir), "utf8"));
+    const appliedWeekIds = normalizeAppliedWeekIds(raw.appliedWeekIds, raw.appliedWeekId);
     return {
       rules: Array.isArray(raw.rules) ? raw.rules : [],
       updatedAt: typeof raw.updatedAt === "string" ? raw.updatedAt : new Date().toISOString(),
       totalCorrectionsAnalyzed: typeof raw.totalCorrectionsAnalyzed === "number" ? raw.totalCorrectionsAnalyzed : 0,
+      ...(appliedWeekIds.length > 0 ? { appliedWeekIds } : {}),
     };
   } catch {
     return { rules: [], updatedAt: new Date().toISOString(), totalCorrectionsAnalyzed: 0 };
   }
 }
 
+function normalizeAppliedWeekIds(list: unknown, additional: unknown): string[] {
+  const weeks: string[] = [];
+  if (Array.isArray(list)) {
+    for (const entry of list) {
+      const week = appliedCalibrationWeekId(entry);
+      if (week && !weeks.includes(week)) weeks.push(week);
+    }
+  }
+  const extra = appliedCalibrationWeekId(additional);
+  if (extra && !weeks.includes(extra)) weeks.push(extra);
+  return weeks;
+}
+
+/**
+ * Attach the week stamp to the index that will be written with the reinforced
+ * rules. The stamp and the evidence increment commit together. Every
+ * previously applied week stays in the list so an out-of-order retry of an
+ * older week is still recognized as already applied.
+ */
+export function withAppliedCalibrationWeek(
+  index: CalibrationIndex,
+  idempotencyKey: string | undefined,
+): CalibrationIndex {
+  const appliedWeekIds = normalizeAppliedWeekIds(index.appliedWeekIds, idempotencyKey);
+  return {
+    rules: index.rules,
+    updatedAt: index.updatedAt,
+    totalCorrectionsAnalyzed: index.totalCorrectionsAnalyzed,
+    ...(appliedWeekIds.length > 0 ? { appliedWeekIds } : {}),
+  };
+}
+
 async function writeCalibrationIndex(memoryDir: string, index: CalibrationIndex): Promise<void> {
   const dir = calibrationDir(memoryDir);
   await mkdir(dir, { recursive: true });
-  index.updatedAt = new Date().toISOString();
-  await writeFile(calibrationIndexPath(memoryDir), JSON.stringify(index, null, 2), "utf8");
+  const appliedWeekIds = normalizeAppliedWeekIds(index.appliedWeekIds, undefined);
+  const stamped: CalibrationIndex = {
+    rules: index.rules,
+    updatedAt: new Date().toISOString(),
+    totalCorrectionsAnalyzed: index.totalCorrectionsAnalyzed,
+    ...(appliedWeekIds.length > 0 ? { appliedWeekIds } : {}),
+  };
+  await writeFileAtomically(calibrationIndexPath(memoryDir), JSON.stringify(stamped, null, 2));
 }
 
 // ─── Correction Reading ──────────────────────────────────────────────────────
@@ -432,8 +489,21 @@ export async function runCalibrationConsolidation(options: {
   modelChain?: AgentPersonaModelConfig;
   workspaceDir?: string;
   pluginConfig?: PluginConfig;
+  /**
+   * When set, a week whose reinforcement is already in the index is returned
+   * as-is. Weekly synthesis passes the ISO week id so a retry after a later
+   * artifact failure does not count the same corrections twice.
+   */
+  idempotencyKey?: string;
 }): Promise<CalibrationRule[]> {
   try {
+    const idempotencyKey = appliedCalibrationWeekId(options.idempotencyKey);
+    const existingIndex = await readCalibrationIndex(options.memoryDir);
+    if (idempotencyKey && (existingIndex.appliedWeekIds ?? []).includes(idempotencyKey)) {
+      log.debug(`[calibration] week ${idempotencyKey} already applied — skipping`);
+      return existingIndex.rules;
+    }
+
     const llm = resolveCalibrationChatClient(options);
     if (!llm) return [];
 
@@ -443,8 +513,6 @@ export async function runCalibrationConsolidation(options: {
       return [];
     }
 
-    const existingIndex = await readCalibrationIndex(options.memoryDir);
-
     const newRules = await synthesizeCalibrationRules(
       corrections,
       llm,
@@ -472,11 +540,12 @@ export async function runCalibrationConsolidation(options: {
     }
 
     const allRules = [...ruleMap.values()];
-    await writeCalibrationIndex(options.memoryDir, {
+    await writeCalibrationIndex(options.memoryDir, withAppliedCalibrationWeek({
       rules: allRules,
-      updatedAt: new Date().toISOString(),
+      updatedAt: existingIndex.updatedAt,
       totalCorrectionsAnalyzed: corrections.length,
-    });
+      appliedWeekIds: existingIndex.appliedWeekIds,
+    }, idempotencyKey));
 
     log.debug(`[calibration] synthesized ${newRules.length} new rule(s), ${allRules.length} total`);
     return allRules;

package/src/capabilities.test.ts

@@ -1090,6 +1090,7 @@ const CONSOLIDATION_FIELD_TO_FLAG: Record<keyof ConsolidationCapabilitySet, stri
   compoundingSemantic: "compoundingSemanticEnabled",
   abstractionAnchors: "abstractionAnchorsEnabled",
   compounding: "compoundingEnabled",
+  compoundingWeeklyCron: "compoundingWeeklyCronEnabled",
   calibration: "calibrationEnabled",
   semanticConsolidation: "semanticConsolidationEnabled",
   patternReinforcement: "patternReinforcementEnabled",

package/src/capabilities.ts

@@ -898,8 +898,8 @@ export interface ConsolidationCapabilitySet {
   readonly compoundingSemantic: boolean;
   /** `abstractionAnchorsEnabled` — abstraction-anchor extraction. */
   readonly abstractionAnchors: boolean;
-  /** `compoundingEnabled` — master compounding switch. */
-  readonly compounding: boolean;
+  /** `compoundingEnabled` master switch; `compoundingWeeklyCronEnabled` daemon weekly run. */
+  readonly compounding: boolean; readonly compoundingWeeklyCron: boolean;
   /** `calibrationEnabled` — memory calibration pass. */
   readonly calibration: boolean;
   /** `semanticConsolidationEnabled` — semantic consolidation pass. */
@@ -919,7 +919,7 @@ export type ConsolidationConfigProjection = Pick<
   PluginConfig,
   "compoundingSemanticEnabled" |
   "abstractionAnchorsEnabled" |
-  "compoundingEnabled" |
+  "compoundingEnabled" | "compoundingWeeklyCronEnabled" |
   "calibrationEnabled" |
   "semanticConsolidationEnabled" |
   "patternReinforcementEnabled" |
@@ -934,7 +934,7 @@ export function resolveConsolidationCapabilities(config: ConsolidationConfigProj
   return Object.freeze({
     compoundingSemantic: config.compoundingSemanticEnabled,
     abstractionAnchors: config.abstractionAnchorsEnabled,
-    compounding: config.compoundingEnabled,
+    compounding: config.compoundingEnabled, compoundingWeeklyCron: config.compoundingWeeklyCronEnabled,
     calibration: config.calibrationEnabled,
     semanticConsolidation: config.semanticConsolidationEnabled,
     patternReinforcement: config.patternReinforcementEnabled,