@remnic/core 1.1.1 → 1.1.3

package/dist/{engine-F3GOXGE5.js → engine-ICC2DSQF.js}

@@ -1,23 +1,26 @@
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "./chunk-RGLL5SPU.js";
-import "./chunk-F5VP6YCB.js";
-import "./chunk-LTCGGW2D.js";
+} from "./chunk-LVYGDT5V.js";
+import "./chunk-DCE6SQLA.js";
+import "./chunk-YNJHCGDT.js";
 import "./chunk-4KAN3GZ3.js";
-import "./chunk-6PFRXT4K.js";
-import "./chunk-TP4FZJIZ.js";
+import "./chunk-43EKP2UK.js";
+import "./chunk-PFV5C235.js";
+import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-BOUYNNYD.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-M62O4P4T.js";
 import "./chunk-4DJQYKMN.js";
-import "./chunk-X6GF3FX2.js";
+import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";
 import "./chunk-2ODBA7MQ.js";
+import "./chunk-A6XUJE5D.js";
+import "./chunk-PZ5AY32C.js";
 export {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
 };
-//# sourceMappingURL=engine-F3GOXGE5.js.map
+//# sourceMappingURL=engine-ICC2DSQF.js.map

package/dist/engine-ICC2DSQF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/entity-retrieval.d.ts

@@ -2,7 +2,7 @@ import { StorageManager } from './storage.js';
 import { PluginConfig, TranscriptEntry } from './types.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-DeSXPh1j.js';
+import './memory-projection-store-D3vBHS4J.js';
 import 'better-sqlite3';
 
 interface BuildEntityRecallSectionOptions {

package/dist/entity-retrieval.js

@@ -3,22 +3,25 @@ import {
   entityIndexVersion,
   entityRecentTranscriptLookbackHours,
   readRecentEntityTranscriptEntries
-} from "./chunk-FVA6TGI3.js";
+} from "./chunk-Y3WQ4ZWK.js";
 import "./chunk-7SEAZFFB.js";
-import "./chunk-F5VP6YCB.js";
-import "./chunk-LTCGGW2D.js";
+import "./chunk-DCE6SQLA.js";
+import "./chunk-YNJHCGDT.js";
 import "./chunk-4KAN3GZ3.js";
-import "./chunk-6PFRXT4K.js";
-import "./chunk-TP4FZJIZ.js";
+import "./chunk-43EKP2UK.js";
+import "./chunk-PFV5C235.js";
+import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-BOUYNNYD.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-M62O4P4T.js";
 import "./chunk-4DJQYKMN.js";
-import "./chunk-X6GF3FX2.js";
+import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";
 import "./chunk-2ODBA7MQ.js";
+import "./chunk-A6XUJE5D.js";
+import "./chunk-PZ5AY32C.js";
 export {
   buildEntityRecallSection,
   entityIndexVersion,

package/dist/entity-schema.js

@@ -7,6 +7,7 @@ import {
   resolveRequestedEntitySectionKeys,
   sortStructuredSectionsBySchema
 } from "./chunk-4DJQYKMN.js";
+import "./chunk-PZ5AY32C.js";
 export {
   getEntitySchema,
   matchEntitySchemaSection,

package/dist/evals.js

@@ -14,6 +14,7 @@ import {
   validateEvalShadowRecallRecord
 } from "./chunk-K6WK37A6.js";
 import "./chunk-LPSF4OQH.js";
+import "./chunk-PZ5AY32C.js";
 export {
   createEvalBaselineSnapshot,
   getEvalHarnessStatus,

package/dist/evidence-pack.d.ts

@@ -0,0 +1,16 @@
+interface EvidencePackItem {
+    id?: string;
+    sessionId?: string;
+    turnIndex?: number;
+    role?: string;
+    content: string;
+    score?: number;
+}
+interface EvidencePackOptions {
+    title?: string;
+    maxChars: number;
+    maxItemChars?: number;
+}
+declare function buildEvidencePack(items: readonly EvidencePackItem[], options: EvidencePackOptions): string;
+
+export { type EvidencePackItem, type EvidencePackOptions, buildEvidencePack };

package/dist/evidence-pack.js

@@ -0,0 +1,8 @@
+import {
+  buildEvidencePack
+} from "./chunk-74WWN7ZW.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  buildEvidencePack
+};
+//# sourceMappingURL=evidence-pack.js.map

package/dist/evidence-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/explicit-capture.d.ts

@@ -1,25 +1,27 @@
-import { O as Orchestrator } from './orchestrator-CmJ-NTdJ.js';
+import { O as Orchestrator } from './orchestrator-ChkesB8U.js';
 import { MemoryCategory, PluginConfig } from './types.js';
 import './buffer.js';
 import './storage.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-DeSXPh1j.js';
+import './memory-projection-store-D3vBHS4J.js';
 import 'better-sqlite3';
-import './port-BADbLZU5.js';
+import './port-hqGnoStS.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
 import './model-registry.js';
 import './local-llm.js';
 import './fallback-llm.js';
+import './live-connectors-runner.js';
+import './framework-CyHYDcri.js';
 import './relevance.js';
 import './negative.js';
 import './recall-state.js';
 import './recall-xray.js';
 import './session-observer-state.js';
 import './embedding-fallback.js';
-import './semantic-consolidation-CxJU6MJk.js';
+import './semantic-consolidation-ByBXb-sf.js';
 import './codex-materialize-CQlLTzke.js';
 import './logger.js';
 import 'zod';

package/dist/explicit-capture.js

@@ -10,6 +10,7 @@ import {
 } from "./chunk-3FPTCC3Z.js";
 import "./chunk-2LGMW3DJ.js";
 import "./chunk-M62O4P4T.js";
+import "./chunk-PZ5AY32C.js";
 export {
   hasInlineExplicitCaptureMarkup,
   parseInlineExplicitCaptureNotes,

package/dist/extraction-judge-telemetry.js

@@ -5,6 +5,7 @@ import {
   recordJudgeVerdict
 } from "./chunk-AJU4PJGY.js";
 import "./chunk-2ODBA7MQ.js";
+import "./chunk-PZ5AY32C.js";
 export {
   EXTRACTION_JUDGE_VERDICT_CATEGORY,
   judgeTelemetryPath,

package/dist/extraction-judge-training.js

@@ -6,6 +6,7 @@ import {
   trainingFilePathFor
 } from "./chunk-DF3RVK3X.js";
 import "./chunk-2ODBA7MQ.js";
+import "./chunk-PZ5AY32C.js";
 export {
   isValidTrainingPair,
   readJudgeTrainingPairs,

package/dist/extraction-judge.js

@@ -13,6 +13,7 @@ import {
 import "./chunk-UZB5KHKX.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-2ODBA7MQ.js";
+import "./chunk-PZ5AY32C.js";
 export {
   clearVerdictCache,
   createDeferCountMap,

package/dist/extraction.js

@@ -1,25 +1,26 @@
 import {
   ExtractionEngine
-} from "./chunk-S3EEFKNY.js";
-import "./chunk-NZLQTHS5.js";
+} from "./chunk-N7X62G74.js";
+import "./chunk-WW3QQF4H.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-NBNN5GOB.js";
 import "./chunk-FEMOX5AD.js";
-import "./chunk-JL2PU6AI.js";
-import "./chunk-VEWZZM3H.js";
+import "./chunk-R2XRID2N.js";
 import "./chunk-GZCUW5IC.js";
-import "./chunk-LK6SGL53.js";
+import "./chunk-VEWZZM3H.js";
 import "./chunk-EJI5XIBB.js";
-import "./chunk-3GXCSUXR.js";
-import "./chunk-XZ2TIKGC.js";
+import "./chunk-CRU27Q4J.js";
+import "./chunk-Q7FJ5ZHM.js";
 import "./chunk-ODWDQNRE.js";
 import "./chunk-Y27UJK6V.js";
 import "./chunk-UZB5KHKX.js";
-import "./chunk-MARWOCVP.js";
 import "./chunk-EEQLFRUM.js";
+import "./chunk-OR64ZGRZ.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-M62O4P4T.js";
+import "./chunk-MARWOCVP.js";
 import "./chunk-2ODBA7MQ.js";
+import "./chunk-PZ5AY32C.js";
 export {
   ExtractionEngine
 };

package/dist/fallback-llm.js

@@ -1,12 +1,13 @@
 import {
   FallbackLlmClient
-} from "./chunk-3GXCSUXR.js";
-import "./chunk-XZ2TIKGC.js";
+} from "./chunk-CRU27Q4J.js";
+import "./chunk-Q7FJ5ZHM.js";
 import "./chunk-ODWDQNRE.js";
 import "./chunk-Y27UJK6V.js";
 import "./chunk-UZB5KHKX.js";
 import "./chunk-MARWOCVP.js";
 import "./chunk-2ODBA7MQ.js";
+import "./chunk-PZ5AY32C.js";
 export {
   FallbackLlmClient
 };

package/dist/first-start-migration-4MHQEOSD.js

@@ -0,0 +1,263 @@
+import {
+  applyUtilityPromotionRuntimePolicy,
+  loadUtilityRuntimeValues
+} from "./chunk-FSFEQI74.js";
+import {
+  TierMigrationExecutor
+} from "./chunk-Z5AAYHUC.js";
+import {
+  decideTierTransition
+} from "./chunk-S75M5ZRK.js";
+import "./chunk-PYXS46O7.js";
+import "./chunk-3QKK7QOS.js";
+import "./chunk-TBBDFYXW.js";
+import "./chunk-DGXUHMOV.js";
+import "./chunk-LPSF4OQH.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/maintenance/first-start-migration.ts
+import path from "path";
+import { access, mkdir, readFile, unlink, writeFile } from "fs/promises";
+var FIRST_START_DEMOTION_CAP = 50;
+var LIFECYCLE_INIT_DONE_MARKER = ".lifecycle-init-done";
+var LIFECYCLE_QMD_REFRESH_PENDING_MARKER = ".lifecycle-qmd-refresh-pending";
+function markerPath(memoryDir) {
+  return path.join(memoryDir, "state", LIFECYCLE_INIT_DONE_MARKER);
+}
+function qmdRefreshPendingPath(memoryDir) {
+  return path.join(memoryDir, "state", LIFECYCLE_QMD_REFRESH_PENDING_MARKER);
+}
+async function markerExists(memoryDir) {
+  try {
+    await access(markerPath(memoryDir));
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function writeMarker(memoryDir, now) {
+  const p = markerPath(memoryDir);
+  await mkdir(path.dirname(p), { recursive: true });
+  await writeFile(p, JSON.stringify({ createdAt: now.toISOString() }), "utf-8");
+}
+async function readQmdRefreshPending(memoryDir) {
+  try {
+    const raw = await readFile(qmdRefreshPendingPath(memoryDir), "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && typeof parsed.createdAt === "string" && typeof parsed.collection === "string" && parsed.collection.length > 0) {
+      return parsed;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+async function pathExists(p) {
+  try {
+    await access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function writeQmdRefreshPending(memoryDir, now, collection) {
+  const p = qmdRefreshPendingPath(memoryDir);
+  await mkdir(path.dirname(p), { recursive: true });
+  await writeFile(p, JSON.stringify({ createdAt: now.toISOString(), collection }), "utf-8");
+}
+async function clearQmdRefreshPending(memoryDir) {
+  await unlink(qmdRefreshPendingPath(memoryDir)).catch(() => {
+  });
+}
+async function buildTierRoutingPolicy(config) {
+  const basePolicy = {
+    enabled: config.qmdTierMigrationEnabled,
+    demotionMinAgeDays: config.qmdTierDemotionMinAgeDays,
+    demotionValueThreshold: config.qmdTierDemotionValueThreshold,
+    promotionValueThreshold: config.qmdTierPromotionValueThreshold
+  };
+  const runtime = await loadUtilityRuntimeValues({
+    memoryDir: config.memoryDir,
+    memoryUtilityLearningEnabled: config.memoryUtilityLearningEnabled,
+    promotionByOutcomeEnabled: config.promotionByOutcomeEnabled
+  });
+  return applyUtilityPromotionRuntimePolicy(basePolicy, runtime);
+}
+async function refreshQmdCollection(qmd, collection, signal) {
+  if (typeof qmd.updateCollectionStrict === "function") {
+    await qmd.updateCollectionStrict(collection, { signal });
+    return;
+  }
+  await qmd.updateCollection(collection, { signal });
+}
+async function runFirstStartMigration(options) {
+  const {
+    storage,
+    config,
+    demotionCap = FIRST_START_DEMOTION_CAP,
+    dryRun = false,
+    qmd,
+    signal
+  } = options;
+  const now = (options.now ?? (() => /* @__PURE__ */ new Date()))();
+  const abortedResult = (candidateCount2 = 0, demotedCount2 = 0, failureCount2 = 0) => ({
+    skipped: candidateCount2 === 0 && demotedCount2 === 0 && failureCount2 === 0,
+    skipReason: candidateCount2 === 0 && demotedCount2 === 0 && failureCount2 === 0 ? "aborted" : void 0,
+    dryRun,
+    candidateCount: candidateCount2,
+    demotedCount: demotedCount2,
+    failureCount: failureCount2,
+    cappedAt: demotionCap
+  });
+  if (signal?.aborted) {
+    return abortedResult();
+  }
+  if (!config.lifecyclePolicyEnabled) {
+    return {
+      skipped: true,
+      skipReason: "lifecyclePolicyEnabled is false",
+      dryRun,
+      candidateCount: 0,
+      demotedCount: 0,
+      failureCount: 0,
+      cappedAt: demotionCap
+    };
+  }
+  if (!config.qmdTierMigrationEnabled) {
+    return {
+      skipped: true,
+      skipReason: "qmdTierMigrationEnabled is false",
+      dryRun,
+      candidateCount: 0,
+      demotedCount: 0,
+      failureCount: 0,
+      cappedAt: demotionCap
+    };
+  }
+  if (await markerExists(config.memoryDir)) {
+    return {
+      skipped: true,
+      skipReason: "lifecycle-init-done marker already present",
+      dryRun,
+      candidateCount: 0,
+      demotedCount: 0,
+      failureCount: 0,
+      cappedAt: demotionCap
+    };
+  }
+  if (signal?.aborted) {
+    return abortedResult();
+  }
+  const policy = await buildTierRoutingPolicy(config);
+  if (signal?.aborted) {
+    return abortedResult();
+  }
+  const hotMemories = await storage.readAllMemories();
+  if (signal?.aborted) {
+    return abortedResult();
+  }
+  const demotionCandidates = hotMemories.filter((m) => {
+    const decision = decideTierTransition(m, "hot", policy, now);
+    return decision.changed && decision.nextTier === "cold";
+  });
+  const candidateCount = demotionCandidates.length;
+  const batch = demotionCandidates.slice(0, demotionCap);
+  if (dryRun) {
+    return {
+      skipped: false,
+      dryRun: true,
+      candidateCount,
+      demotedCount: 0,
+      failureCount: 0,
+      cappedAt: demotionCap
+    };
+  }
+  let demotedCount = 0;
+  let failureCount = 0;
+  let qmdRefreshPendingForRun = false;
+  const executor = qmd ? new TierMigrationExecutor({
+    storage,
+    qmd,
+    hotCollection: options.hotCollection ?? config.qmdCollection ?? "openclaw-engram",
+    coldCollection: options.coldCollection ?? config.qmdColdCollection ?? "openclaw-engram-cold"
+  }) : null;
+  const coldCollection = options.coldCollection ?? config.qmdColdCollection ?? "openclaw-engram-cold";
+  for (const memory of batch) {
+    if (signal?.aborted) {
+      return abortedResult(candidateCount, demotedCount, failureCount);
+    }
+    try {
+      if (executor) {
+        await executor.migrateMemory({
+          memory,
+          fromTier: "hot",
+          toTier: "cold",
+          reason: "first-start-lifecycle-migration"
+        });
+      } else {
+        await storage.migrateMemoryToTier(memory, "cold");
+      }
+      demotedCount += 1;
+    } catch {
+      const targetPath = storage.buildTierMemoryPath(memory, "cold");
+      const [targetExists, sourceExists] = await Promise.all([
+        pathExists(targetPath),
+        pathExists(memory.path)
+      ]);
+      const movedToCold = targetExists && !sourceExists;
+      if (movedToCold) {
+        if (!qmd) {
+          demotedCount += 1;
+          continue;
+        }
+        try {
+          await refreshQmdCollection(qmd, coldCollection, signal);
+          demotedCount += 1;
+          continue;
+        } catch {
+          qmdRefreshPendingForRun = true;
+          try {
+            await writeQmdRefreshPending(config.memoryDir, now, coldCollection);
+          } catch {
+          }
+          demotedCount += 1;
+          continue;
+        }
+      }
+      failureCount += 1;
+    }
+  }
+  if (signal?.aborted) {
+    return abortedResult(candidateCount, demotedCount, failureCount);
+  }
+  const persistedQmdRefreshPending = qmd ? await readQmdRefreshPending(config.memoryDir) : null;
+  const hasPersistedQmdRefreshPending = persistedQmdRefreshPending?.collection === coldCollection;
+  if (qmd && persistedQmdRefreshPending && persistedQmdRefreshPending.collection !== coldCollection) {
+    failureCount += 1;
+  }
+  if (qmd && (qmdRefreshPendingForRun || hasPersistedQmdRefreshPending)) {
+    try {
+      await refreshQmdCollection(qmd, coldCollection, signal);
+      await clearQmdRefreshPending(config.memoryDir);
+    } catch {
+      failureCount += 1;
+    }
+  }
+  if (failureCount === 0) {
+    await writeMarker(config.memoryDir, now);
+  }
+  return {
+    skipped: false,
+    dryRun: false,
+    candidateCount,
+    demotedCount,
+    failureCount,
+    cappedAt: demotionCap
+  };
+}
+export {
+  FIRST_START_DEMOTION_CAP,
+  LIFECYCLE_INIT_DONE_MARKER,
+  runFirstStartMigration
+};
+//# sourceMappingURL=first-start-migration-4MHQEOSD.js.map

package/dist/first-start-migration-4MHQEOSD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/maintenance/first-start-migration.ts"],"sourcesContent":["/**\n * First-start lifecycle migration (issue #686 retention-completion).\n *\n * When `lifecyclePolicyEnabled` is true but the memoryDir has never been\n * touched by the lifecycle policy (i.e. the state marker\n * `.lifecycle-init-done` does not exist), run a one-time, rate-limited\n * demotion sweep so the hot tier isn't flooded on the first real cron pass.\n *\n * Design constraints:\n *   - Capped at `FIRST_START_DEMOTION_CAP` (default 50) demotions per run\n *     so a large pre-existing corpus doesn't stall startup.\n *   - Resumable: subsequent invocations see the marker and skip.\n *   - The marker is written AFTER all mutations succeed so a crash during\n *     migration doesn't leave a false \"done\" marker (CLAUDE.md rule #12).\n *   - Dry-run mode reports candidates without mutating anything or writing\n *     the marker (safe to call from tests).\n */\n\nimport path from \"node:path\";\nimport { access, mkdir, readFile, unlink, writeFile } from \"node:fs/promises\";\nimport type { StorageManager } from \"../storage.js\";\nimport type { PluginConfig } from \"../types.js\";\nimport {\n  decideTierTransition,\n  type TierRoutingPolicy,\n} from \"../tier-routing.js\";\nimport { TierMigrationExecutor } from \"../tier-migration.js\";\nimport type { SearchBackend } from \"../search/port.js\";\nimport {\n  applyUtilityPromotionRuntimePolicy,\n  loadUtilityRuntimeValues,\n} from \"../utility-runtime.js\";\n\nexport const FIRST_START_DEMOTION_CAP = 50;\nexport const LIFECYCLE_INIT_DONE_MARKER = \".lifecycle-init-done\";\nconst LIFECYCLE_QMD_REFRESH_PENDING_MARKER = \".lifecycle-qmd-refresh-pending\";\n\ntype QmdRefreshPendingMarker = {\n  createdAt: string;\n  collection: string;\n};\n\nexport interface FirstStartMigrationOptions {\n  storage: StorageManager;\n  config: PluginConfig;\n  /** Override the per-run demotion cap (default: FIRST_START_DEMOTION_CAP). */\n  demotionCap?: number;\n  /** When true, report candidates but do not mutate or write the marker. */\n  dryRun?: boolean;\n  /** Optional QMD backend used to journal demotions and refresh tier collections. */\n  qmd?: SearchBackend;\n  /** Hot-tier QMD collection name. Defaults to config.qmdCollection. */\n  hotCollection?: string;\n  /** Cold-tier QMD collection name. Defaults to config.qmdColdCollection. */\n  coldCollection?: string;\n  /** Optional shutdown signal. When aborted, the migration stops without writing the done marker. */\n  signal?: AbortSignal;\n  /** Override clock for tests. */\n  now?: () => Date;\n}\n\nexport interface FirstStartMigrationResult {\n  skipped: boolean;\n  skipReason?: string;\n  dryRun: boolean;\n  candidateCount: number;\n  demotedCount: number;\n  /** Number of individual demotion failures. When > 0, the init-done marker is\n   *  NOT written so the next start can retry the failed demotions. */\n  failureCount: number;\n  cappedAt: number;\n}\n\nfunction markerPath(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", LIFECYCLE_INIT_DONE_MARKER);\n}\n\nfunction qmdRefreshPendingPath(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", LIFECYCLE_QMD_REFRESH_PENDING_MARKER);\n}\n\nasync function markerExists(memoryDir: string): Promise<boolean> {\n  try {\n    await access(markerPath(memoryDir));\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function writeMarker(memoryDir: string, now: Date): Promise<void> {\n  const p = markerPath(memoryDir);\n  await mkdir(path.dirname(p), { recursive: true });\n  await writeFile(p, JSON.stringify({ createdAt: now.toISOString() }), \"utf-8\");\n}\n\nasync function readQmdRefreshPending(memoryDir: string): Promise<QmdRefreshPendingMarker | null> {\n  try {\n    const raw = await readFile(qmdRefreshPendingPath(memoryDir), \"utf-8\");\n    const parsed = JSON.parse(raw) as unknown;\n    if (\n      parsed &&\n      typeof parsed === \"object\" &&\n      typeof (parsed as { createdAt?: unknown }).createdAt === \"string\" &&\n      typeof (parsed as { collection?: unknown }).collection === \"string\" &&\n      (parsed as { collection: string }).collection.length > 0\n    ) {\n      return parsed as QmdRefreshPendingMarker;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\nasync function pathExists(p: string): Promise<boolean> {\n  try {\n    await access(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function writeQmdRefreshPending(memoryDir: string, now: Date, collection: string): Promise<void> {\n  const p = qmdRefreshPendingPath(memoryDir);\n  await mkdir(path.dirname(p), { recursive: true });\n  await writeFile(p, JSON.stringify({ createdAt: now.toISOString(), collection }), \"utf-8\");\n}\n\nasync function clearQmdRefreshPending(memoryDir: string): Promise<void> {\n  await unlink(qmdRefreshPendingPath(memoryDir)).catch(() => {});\n}\n\nasync function buildTierRoutingPolicy(config: PluginConfig): Promise<TierRoutingPolicy> {\n  const basePolicy: TierRoutingPolicy = {\n    enabled: config.qmdTierMigrationEnabled,\n    demotionMinAgeDays: config.qmdTierDemotionMinAgeDays,\n    demotionValueThreshold: config.qmdTierDemotionValueThreshold,\n    promotionValueThreshold: config.qmdTierPromotionValueThreshold,\n  };\n  const runtime = await loadUtilityRuntimeValues({\n    memoryDir: config.memoryDir,\n    memoryUtilityLearningEnabled: config.memoryUtilityLearningEnabled,\n    promotionByOutcomeEnabled: config.promotionByOutcomeEnabled,\n  });\n  return applyUtilityPromotionRuntimePolicy(basePolicy, runtime);\n}\n\nasync function refreshQmdCollection(\n  qmd: SearchBackend,\n  collection: string,\n  signal?: AbortSignal,\n): Promise<void> {\n  if (typeof qmd.updateCollectionStrict === \"function\") {\n    await qmd.updateCollectionStrict(collection, { signal });\n    return;\n  }\n  await qmd.updateCollection(collection, { signal });\n}\n\n/**\n * Run the first-start migration sweep.  No-ops when:\n *   - `lifecyclePolicyEnabled` is false, or\n *   - `qmdTierMigrationEnabled` is false (no tier migration configured), or\n *   - the state marker already exists (already ran).\n *\n * Returns a structured result describing what happened.\n */\nexport async function runFirstStartMigration(\n  options: FirstStartMigrationOptions,\n): Promise<FirstStartMigrationResult> {\n  const {\n    storage,\n    config,\n    demotionCap = FIRST_START_DEMOTION_CAP,\n    dryRun = false,\n    qmd,\n    signal,\n  } = options;\n  const now = (options.now ?? (() => new Date()))();\n  const abortedResult = (candidateCount = 0, demotedCount = 0, failureCount = 0): FirstStartMigrationResult => ({\n    skipped: candidateCount === 0 && demotedCount === 0 && failureCount === 0,\n    skipReason: candidateCount === 0 && demotedCount === 0 && failureCount === 0 ? \"aborted\" : undefined,\n    dryRun,\n    candidateCount,\n    demotedCount,\n    failureCount,\n    cappedAt: demotionCap,\n  });\n\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  if (!config.lifecyclePolicyEnabled) {\n    return {\n      skipped: true,\n      skipReason: \"lifecyclePolicyEnabled is false\",\n      dryRun,\n      candidateCount: 0,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  if (!config.qmdTierMigrationEnabled) {\n    return {\n      skipped: true,\n      skipReason: \"qmdTierMigrationEnabled is false\",\n      dryRun,\n      candidateCount: 0,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  if (await markerExists(config.memoryDir)) {\n    return {\n      skipped: true,\n      skipReason: \"lifecycle-init-done marker already present\",\n      dryRun,\n      candidateCount: 0,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  const policy = await buildTierRoutingPolicy(config);\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  const hotMemories = await storage.readAllMemories();\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  // Find hot memories that should be demoted to cold\n  const demotionCandidates = hotMemories.filter((m) => {\n    const decision = decideTierTransition(m, \"hot\", policy, now);\n    return decision.changed && decision.nextTier === \"cold\";\n  });\n\n  const candidateCount = demotionCandidates.length;\n  // Apply cap\n  const batch = demotionCandidates.slice(0, demotionCap);\n\n  if (dryRun) {\n    return {\n      skipped: false,\n      dryRun: true,\n      candidateCount,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  let demotedCount = 0;\n  let failureCount = 0;\n  let qmdRefreshPendingForRun = false;\n  const executor = qmd\n    ? new TierMigrationExecutor({\n        storage,\n        qmd,\n        hotCollection: options.hotCollection ?? config.qmdCollection ?? \"openclaw-engram\",\n        coldCollection: options.coldCollection ?? config.qmdColdCollection ?? \"openclaw-engram-cold\",\n    })\n    : null;\n  const coldCollection = options.coldCollection ?? config.qmdColdCollection ?? \"openclaw-engram-cold\";\n\n  for (const memory of batch) {\n    if (signal?.aborted) {\n      return abortedResult(candidateCount, demotedCount, failureCount);\n    }\n    try {\n      if (executor) {\n        await executor.migrateMemory({\n          memory,\n          fromTier: \"hot\",\n          toTier: \"cold\",\n          reason: \"first-start-lifecycle-migration\",\n        });\n      } else {\n        await storage.migrateMemoryToTier(memory, \"cold\");\n      }\n      demotedCount += 1;\n    } catch {\n      const targetPath = storage.buildTierMemoryPath(memory, \"cold\");\n      const [targetExists, sourceExists] = await Promise.all([\n        pathExists(targetPath),\n        pathExists(memory.path),\n      ]);\n      const movedToCold = targetExists && !sourceExists;\n      if (movedToCold) {\n        if (!qmd) {\n          demotedCount += 1;\n          continue;\n        }\n        try {\n          await refreshQmdCollection(qmd, coldCollection, signal);\n          demotedCount += 1;\n          continue;\n        } catch {\n          qmdRefreshPendingForRun = true;\n          try {\n            await writeQmdRefreshPending(config.memoryDir, now, coldCollection);\n          } catch {\n            // The end-of-run retry below still gets a chance to repair the QMD\n            // state before we decide whether the init marker is safe to write.\n          }\n          demotedCount += 1;\n          continue;\n        }\n      }\n      // Non-fatal — individual migration failures are counted but do not abort\n      // the sweep. We track them so the marker is only written when ALL\n      // attempted demotions succeeded (CLAUDE.md rule #12: don't write a\n      // success marker after a partial failure).\n      failureCount += 1;\n    }\n  }\n\n  // Write marker AFTER all mutations succeed (CLAUDE.md rule #12).\n  // If any demotion failed, skip the marker so the next start retries.\n  if (signal?.aborted) {\n    return abortedResult(candidateCount, demotedCount, failureCount);\n  }\n  const persistedQmdRefreshPending = qmd ? await readQmdRefreshPending(config.memoryDir) : null;\n  const hasPersistedQmdRefreshPending = persistedQmdRefreshPending?.collection === coldCollection;\n  if (qmd && persistedQmdRefreshPending && persistedQmdRefreshPending.collection !== coldCollection) {\n    failureCount += 1;\n  }\n  if (qmd && (qmdRefreshPendingForRun || hasPersistedQmdRefreshPending)) {\n    try {\n      await refreshQmdCollection(qmd, coldCollection, signal);\n      await clearQmdRefreshPending(config.memoryDir);\n    } catch {\n      failureCount += 1;\n    }\n  }\n  if (failureCount === 0) {\n    await writeMarker(config.memoryDir, now);\n  }\n\n  return {\n    skipped: false,\n    dryRun: false,\n    candidateCount,\n    demotedCount,\n    failureCount,\n    cappedAt: demotionCap,\n  };\n}\n"],"mappings":"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","names":["candidateCount","demotedCount","failureCount"]}

package/dist/forget-PLR6J5DN.js

@@ -0,0 +1,69 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/maintenance/forget.ts
+var ForgetMemoryNotFoundError = class extends Error {
+  code = "memory_not_found";
+  constructor(id) {
+    super(`memory not found: ${id}`);
+    this.name = "ForgetMemoryNotFoundError";
+  }
+};
+var ForgetMemoryAlreadyForgottenError = class extends Error {
+  code = "already_forgotten";
+  constructor(id, forgottenAt) {
+    super(`memory ${id} was already forgotten at ${forgottenAt}`);
+    this.name = "ForgetMemoryAlreadyForgottenError";
+  }
+};
+async function forgetMemory(storage, request) {
+  const id = typeof request.id === "string" ? request.id.trim() : "";
+  if (id.length === 0) {
+    throw new Error("forget: memory id is required and must be non-empty");
+  }
+  const memory = await findMemoryById(storage, id);
+  if (!memory) {
+    throw new ForgetMemoryNotFoundError(id);
+  }
+  if (memory.frontmatter.status === "forgotten") {
+    throw new ForgetMemoryAlreadyForgottenError(
+      id,
+      memory.frontmatter.forgottenAt ?? "(unknown)"
+    );
+  }
+  const priorStatus = typeof memory.frontmatter.status === "string" ? memory.frontmatter.status : "active";
+  const now = (request.now ?? (() => /* @__PURE__ */ new Date()))();
+  const forgottenAt = now.toISOString();
+  const reason = typeof request.reason === "string" ? request.reason.trim() : "";
+  await storage.writeMemoryFrontmatter(memory, {
+    status: "forgotten",
+    forgottenAt,
+    forgottenReason: reason.length > 0 ? reason : void 0,
+    updated: forgottenAt
+  }, {
+    actor: "remnic-forget",
+    reasonCode: "operator_forget"
+  });
+  return {
+    id,
+    path: memory.path,
+    priorStatus,
+    forgottenAt,
+    reason
+  };
+}
+async function findMemoryById(storage, id) {
+  const hot = await storage.readAllMemories();
+  const hotMatch = hot.find((m) => m.frontmatter.id === id);
+  if (hotMatch) return hotMatch;
+  const archived = await storage.readArchivedMemories();
+  const archivedMatch = archived.find((m) => m.frontmatter.id === id);
+  if (archivedMatch) return archivedMatch;
+  const cold = await storage.readAllColdMemories();
+  return cold.find((m) => m.frontmatter.id === id) ?? null;
+}
+export {
+  ForgetMemoryAlreadyForgottenError,
+  ForgetMemoryNotFoundError,
+  forgetMemory
+};
+//# sourceMappingURL=forget-PLR6J5DN.js.map

package/dist/forget-PLR6J5DN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/maintenance/forget.ts"],"sourcesContent":["/**\n * Operator-facing memory forgetting (issue #686 PR 4/6).\n *\n * `remnic forget <id>` marks a memory as forgotten — a soft-delete that:\n *\n *   1. Sets `status: \"forgotten\"`, `forgottenAt`, optional\n *      `forgottenReason` in YAML frontmatter via the existing\n *      `storage.writeMemoryFrontmatter` path (which logs the change\n *      to the lifecycle ledger and invalidates caches).\n *   2. Returns a structured result describing what changed so the\n *      CLI and downstream telemetry can render it.\n *\n * Memories with `status === \"forgotten\"` are excluded from recall,\n * browse, and entity attribution by the status filters that serve\n * active user context.  A future maintenance cron will hard-delete\n * forgotten memories after a configurable retention window (default\n * 90 days) — for this PR the file stays on disk and the act is\n * reversible by editing the YAML directly.\n *\n * This module ships the pure helper; the CLI wires it in `cli.ts` as\n * a new `remnic forget` subcommand.\n */\n\nimport type { StorageManager } from \"../storage.js\";\nimport type { MemoryFile } from \"../types.js\";\n\nexport interface ForgetMemoryRequest {\n  /** Memory id (frontmatter `id`) to forget. */\n  id: string;\n  /** Optional human-readable reason. */\n  reason?: string;\n  /** Override the timestamp written to `forgottenAt`. Defaults to `new Date().toISOString()`. */\n  now?: () => Date;\n}\n\nexport interface ForgetMemoryResult {\n  /** Memory id that was forgotten. */\n  id: string;\n  /** Filesystem path of the forgotten memory. */\n  path: string;\n  /** Prior status before the forget call, for audit. */\n  priorStatus: string;\n  /** Timestamp written to `forgottenAt`. */\n  forgottenAt: string;\n  /** Reason captured (or empty string if none). */\n  reason: string;\n}\n\nexport class ForgetMemoryNotFoundError extends Error {\n  readonly code = \"memory_not_found\" as const;\n  constructor(id: string) {\n    super(`memory not found: ${id}`);\n    this.name = \"ForgetMemoryNotFoundError\";\n  }\n}\n\nexport class ForgetMemoryAlreadyForgottenError extends Error {\n  readonly code = \"already_forgotten\" as const;\n  constructor(id: string, forgottenAt: string) {\n    super(`memory ${id} was already forgotten at ${forgottenAt}`);\n    this.name = \"ForgetMemoryAlreadyForgottenError\";\n  }\n}\n\n/**\n * Mark a memory as forgotten.  Pure orchestration over storage —\n * caller supplies the storage instance and the request.  Status\n * filters elsewhere in the codebase exclude `status: \"forgotten\"`\n * from recall/browse surfaces before they serve active user context.\n */\nexport async function forgetMemory(\n  storage: StorageManager,\n  request: ForgetMemoryRequest,\n): Promise<ForgetMemoryResult> {\n  const id = typeof request.id === \"string\" ? request.id.trim() : \"\";\n  if (id.length === 0) {\n    throw new Error(\"forget: memory id is required and must be non-empty\");\n  }\n  const memory = await findMemoryById(storage, id);\n  if (!memory) {\n    throw new ForgetMemoryNotFoundError(id);\n  }\n  if (memory.frontmatter.status === \"forgotten\") {\n    throw new ForgetMemoryAlreadyForgottenError(\n      id,\n      memory.frontmatter.forgottenAt ?? \"(unknown)\",\n    );\n  }\n  const priorStatus =\n    typeof memory.frontmatter.status === \"string\" ? memory.frontmatter.status : \"active\";\n  const now = (request.now ?? (() => new Date()))();\n  const forgottenAt = now.toISOString();\n  const reason = typeof request.reason === \"string\" ? request.reason.trim() : \"\";\n  await storage.writeMemoryFrontmatter(memory, {\n    status: \"forgotten\",\n    forgottenAt,\n    forgottenReason: reason.length > 0 ? reason : undefined,\n    updated: forgottenAt,\n  }, {\n    actor: \"remnic-forget\",\n    reasonCode: \"operator_forget\",\n  });\n  return {\n    id,\n    path: memory.path,\n    priorStatus,\n    forgottenAt,\n    reason,\n  };\n}\n\nasync function findMemoryById(\n  storage: StorageManager,\n  id: string,\n): Promise<MemoryFile | null> {\n  const hot = await storage.readAllMemories();\n  const hotMatch = hot.find((m) => m.frontmatter.id === id);\n  if (hotMatch) return hotMatch;\n\n  const archived = await storage.readArchivedMemories();\n  const archivedMatch = archived.find((m) => m.frontmatter.id === id);\n  if (archivedMatch) return archivedMatch;\n\n  const cold = await storage.readAllColdMemories();\n  return cold.find((m) => m.frontmatter.id === id) ?? null;\n}\n"],"mappings":";;;AAgDO,IAAM,4BAAN,cAAwC,MAAM;AAAA,EAC1C,OAAO;AAAA,EAChB,YAAY,IAAY;AACtB,UAAM,qBAAqB,EAAE,EAAE;AAC/B,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,oCAAN,cAAgD,MAAM;AAAA,EAClD,OAAO;AAAA,EAChB,YAAY,IAAY,aAAqB;AAC3C,UAAM,UAAU,EAAE,6BAA6B,WAAW,EAAE;AAC5D,SAAK,OAAO;AAAA,EACd;AACF;AAQA,eAAsB,aACpB,SACA,SAC6B;AAC7B,QAAM,KAAK,OAAO,QAAQ,OAAO,WAAW,QAAQ,GAAG,KAAK,IAAI;AAChE,MAAI,GAAG,WAAW,GAAG;AACnB,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,QAAM,SAAS,MAAM,eAAe,SAAS,EAAE;AAC/C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,0BAA0B,EAAE;AAAA,EACxC;AACA,MAAI,OAAO,YAAY,WAAW,aAAa;AAC7C,UAAM,IAAI;AAAA,MACR;AAAA,MACA,OAAO,YAAY,eAAe;AAAA,IACpC;AAAA,EACF;AACA,QAAM,cACJ,OAAO,OAAO,YAAY,WAAW,WAAW,OAAO,YAAY,SAAS;AAC9E,QAAM,OAAO,QAAQ,QAAQ,MAAM,oBAAI,KAAK,IAAI;AAChD,QAAM,cAAc,IAAI,YAAY;AACpC,QAAM,SAAS,OAAO,QAAQ,WAAW,WAAW,QAAQ,OAAO,KAAK,IAAI;AAC5E,QAAM,QAAQ,uBAAuB,QAAQ;AAAA,IAC3C,QAAQ;AAAA,IACR;AAAA,IACA,iBAAiB,OAAO,SAAS,IAAI,SAAS;AAAA,IAC9C,SAAS;AAAA,EACX,GAAG;AAAA,IACD,OAAO;AAAA,IACP,YAAY;AAAA,EACd,CAAC;AACD,SAAO;AAAA,IACL;AAAA,IACA,MAAM,OAAO;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,eAAe,eACb,SACA,IAC4B;AAC5B,QAAM,MAAM,MAAM,QAAQ,gBAAgB;AAC1C,QAAM,WAAW,IAAI,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE;AACxD,MAAI,SAAU,QAAO;AAErB,QAAM,WAAW,MAAM,QAAQ,qBAAqB;AACpD,QAAM,gBAAgB,SAAS,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE;AAClE,MAAI,cAAe,QAAO;AAE1B,QAAM,OAAO,MAAM,QAAQ,oBAAoB;AAC/C,SAAO,KAAK,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE,KAAK;AACtD;","names":[]}