@remnic/core 9.45.3 → 9.45.5

package/dist/external-wiki-search.d.ts

@@ -0,0 +1,42 @@
+import { CitationEntry } from './citations.js';
+import { ExternalWikiRoot } from './external-wiki-config.js';
+
+interface ExternalWikiSearchInput {
+    readonly query: string;
+    readonly limit?: number;
+    readonly wikiId?: string;
+    readonly maxCharsPerHit?: number;
+}
+interface ExternalWikiSearchHit {
+    readonly wikiId: string;
+    readonly title: string;
+    readonly path: string;
+    readonly snippet: string;
+    readonly score: number;
+    readonly rank: number;
+    readonly citations: readonly CitationEntry[];
+    readonly indexBlurb?: string;
+}
+interface ExternalWikiSearchResult {
+    readonly query: string;
+    readonly hits: readonly ExternalWikiSearchHit[];
+    readonly count: number;
+    readonly degradedWikiIds: readonly string[];
+}
+interface ExternalWikiCandidate {
+    readonly path: string;
+    readonly score?: number;
+}
+interface ExternalWikiCandidateProvider {
+    search(root: ExternalWikiRoot, query: string, limit: number): Promise<readonly ExternalWikiCandidate[]>;
+}
+interface ExternalWikiSearchOptions {
+    readonly candidateProvider?: ExternalWikiCandidateProvider;
+    readonly maxCandidateFiles?: number;
+}
+declare class ExternalWikiSearchError extends Error {
+    constructor(message: string);
+}
+declare function searchExternalWikis(roots: readonly ExternalWikiRoot[], input: ExternalWikiSearchInput, options?: ExternalWikiSearchOptions): Promise<ExternalWikiSearchResult>;
+
+export { type ExternalWikiCandidate, type ExternalWikiCandidateProvider, ExternalWikiRoot, ExternalWikiSearchError, type ExternalWikiSearchHit, type ExternalWikiSearchInput, type ExternalWikiSearchOptions, type ExternalWikiSearchResult, searchExternalWikis };

package/dist/external-wiki-search.js

@@ -0,0 +1,11 @@
+import {
+  ExternalWikiSearchError,
+  searchExternalWikis
+} from "./chunk-7T4TOGMS.js";
+import "./chunk-7YQ6ESEA.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  ExternalWikiSearchError,
+  searchExternalWikis
+};
+//# sourceMappingURL=external-wiki-search.js.map

package/dist/external-wiki-search.js.map

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

package/dist/external-wiki.d.ts

@@ -0,0 +1,39 @@
+import { ExternalWikiRoot } from './external-wiki-config.js';
+
+interface ExternalWikiLayout {
+    rootDir: string;
+    pagesDir: string;
+    indexFile: string;
+    indexPresent: boolean;
+    rawDir?: string;
+    outputsDir?: string;
+}
+interface ExternalWikiCatalogEntry {
+    title: string;
+    path: string;
+    indexBlurb?: string;
+    indexLine?: number;
+}
+interface ExternalWikiCatalog {
+    wikiId: string;
+    indexPresent: boolean;
+    entries: ExternalWikiCatalogEntry[];
+}
+interface ExternalWikiCatalogLimits {
+    maxIndexBytes?: number;
+    maxEntries?: number;
+    maxDepth?: number;
+}
+interface ExternalWikiPage {
+    wikiId: string;
+    path: string;
+    title: string;
+    content: string;
+    bytes: number;
+}
+declare function validateExternalWikiLayout(config: ExternalWikiRoot): Promise<ExternalWikiLayout>;
+declare function parseExternalWikiCatalog(content: string, config: ExternalWikiRoot, limits?: Pick<ExternalWikiCatalogLimits, "maxEntries">): ExternalWikiCatalogEntry[];
+declare function loadExternalWikiCatalog(config: ExternalWikiRoot, limits?: ExternalWikiCatalogLimits): Promise<ExternalWikiCatalog>;
+declare function readExternalWikiPage(config: ExternalWikiRoot, relativePath: string, maxBytes?: number): Promise<ExternalWikiPage>;
+
+export { type ExternalWikiCatalog, type ExternalWikiCatalogEntry, type ExternalWikiCatalogLimits, type ExternalWikiLayout, type ExternalWikiPage, ExternalWikiRoot, loadExternalWikiCatalog, parseExternalWikiCatalog, readExternalWikiPage, validateExternalWikiLayout };

package/dist/external-wiki.js

@@ -0,0 +1,14 @@
+import {
+  loadExternalWikiCatalog,
+  parseExternalWikiCatalog,
+  readExternalWikiPage,
+  validateExternalWikiLayout
+} from "./chunk-7YQ6ESEA.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  loadExternalWikiCatalog,
+  parseExternalWikiCatalog,
+  readExternalWikiPage,
+  validateExternalWikiLayout
+};
+//# sourceMappingURL=external-wiki.js.map

package/dist/external-wiki.js.map

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

package/dist/extraction-error-classification.d.ts

@@ -1,7 +1,8 @@
-import { $ as ExtractionFailureClass } from './types-rEwubvim.js';
+import { a0 as ExtractionFailureClass } from './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 /**

package/dist/extraction-faithfulness.d.ts

@@ -1,9 +1,10 @@
-import { F as FaithfulnessFrontmatter, P as PluginConfig, l as MemoryFrontmatter } from './types-rEwubvim.js';
+import { F as FaithfulnessFrontmatter, P as PluginConfig, l as MemoryFrontmatter } from './types-yX_FwERf.js';
 import { LocalLlmClient } from './local-llm.js';
 import { FallbackLlmClient } from './fallback-llm.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 import './model-registry.js';
 import './resolve-provider-secret.js';

package/dist/extraction-judge-telemetry.d.ts

@@ -1,8 +1,9 @@
 import { JudgeVerdictKind } from './extraction-judge.js';
-import './types-rEwubvim.js';
+import './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 import './local-llm.js';
 import './model-registry.js';

package/dist/extraction-judge-training.d.ts

@@ -1,8 +1,9 @@
 import { JudgeVerdictKind } from './extraction-judge.js';
-import './types-rEwubvim.js';
+import './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 import './local-llm.js';
 import './model-registry.js';

package/dist/extraction-judge.d.ts

@@ -1,9 +1,10 @@
-import { a0 as ImportanceLevel, P as PluginConfig } from './types-rEwubvim.js';
+import { a1 as ImportanceLevel, P as PluginConfig } from './types-yX_FwERf.js';
 import { LocalLlmClient } from './local-llm.js';
 import { FallbackLlmClient } from './fallback-llm.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 import './model-registry.js';
 import './resolve-provider-secret.js';

package/dist/extraction-liveness.d.ts

@@ -1,5 +1,6 @@
 import './operator-doctor-types.js';
-export { k as ExtractionBufferSnapshot, ax as ExtractionBufferSource, c1 as ExtractionLivenessConfig, u as ExtractionLivenessStatus, c2 as ExtractionLivenessWarnThrottle, c3 as ExtractionRootStats, c4 as ExtractionWatermarkOrStorage, c5 as ExtractionWatermarkRead, c6 as coerceExtractionWatermark, c7 as computeExtractionLivenessStatus, c8 as evaluateExtractionLiveness, c9 as formatAgeMs, ca as gatherExtractionLivenessStatus, cb as parseExtractionLivenessConfig, cc as renderExtractionLivenessStats, cd as resolveExtractionLivenessConfig, az as summarizeExtractionLiveness } from './types-rEwubvim.js';
+export { k as ExtractionBufferSnapshot, ay as ExtractionBufferSource, c1 as ExtractionLivenessConfig, v as ExtractionLivenessStatus, c2 as ExtractionLivenessWarnThrottle, c3 as ExtractionRootStats, c4 as ExtractionWatermarkOrStorage, c5 as ExtractionWatermarkRead, c6 as coerceExtractionWatermark, c7 as computeExtractionLivenessStatus, c8 as evaluateExtractionLiveness, c9 as formatAgeMs, ca as gatherExtractionLivenessStatus, cb as parseExtractionLivenessConfig, cc as renderExtractionLivenessStats, cd as resolveExtractionLivenessConfig, aA as summarizeExtractionLiveness } from './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
+import './external-wiki-config.js';
 import './types-continuity.js';

package/dist/extraction-source-grounding-helpers.d.ts

@@ -1,16 +1,18 @@
 declare function isInterrogativeSourceSentence(sentence: string): boolean;
 declare function containsContiguousGroundingTokens(candidateTokens: ReadonlyArray<string>, sourceTokens: ReadonlyArray<string>): boolean;
 declare function hasExplicitRoleSubjectToken(candidateRole: string | undefined, sourceTokensBySentence: ReadonlyArray<ReadonlyArray<string>>): boolean;
-declare function splitGroundingClauses(sentences: ReadonlyArray<string>): string[];
+declare function splitGroundingClauses(sentences: ReadonlyArray<string>, inheritCoordinatedSubjects?: boolean): string[];
 declare const GROUNDING_STOPWORDS: Record<string, true>;
 declare const GROUNDING_NEGATION_TOKENS: Set<string>;
 declare const GROUNDING_AUXILIARY_TOKENS: Set<string>;
 declare const GROUNDING_COPULAR_FORMS: Set<string>;
 declare const GROUNDING_SUBJECT_PRONOUNS: Set<string>;
 declare const GROUNDING_ENTITY_TYPE_PREFIXES: Set<string>;
-declare const GROUNDING_COMMON_VERB_FORMS: Set<string>;
+declare const GROUNDING_COMMON_VERB_FORMS: Record<string, true>;
 interface GroundingLexeme {
     token: string;
+    surface: string;
+    isPredicate: boolean;
     preserveTerminalS: boolean;
 }
 declare function groundingLexemes(text: string): GroundingLexeme[];
@@ -21,7 +23,7 @@ declare function isAttachedNegatedAuxiliary(token: string): boolean;
 declare function isNegatedAt(tokens: ReadonlyArray<string>, index: number): boolean;
 declare const GROUNDING_MIN_SHARED_TOKENS = 2;
 declare const GROUNDING_MIN_COVERAGE = 0.5;
-declare function stemToken(token: string, preserveTerminalS?: boolean): string;
+declare function stemToken(token: string, preserveTerminalS?: boolean, markExact?: boolean): string;
 declare function tokenize(text: string): Set<string>;
 declare function normalizeForExactMatch(text: string): string;
 declare function sourceSentences(source: string): string[];

package/dist/extraction-source-grounding-helpers.js

@@ -27,7 +27,7 @@ import {
   stemToken,
   tokenSequence,
   tokenize
-} from "./chunk-P2BM76KT.js";
+} from "./chunk-WAS4HV46.js";
 import "./chunk-PZ5AY32C.js";
 export {
   GROUNDING_AUXILIARY_TOKENS,

package/dist/extraction-source-grounding-rules.d.ts

@@ -1,7 +1,8 @@
-import { J as ExtractionResult } from './types-rEwubvim.js';
+import { K as ExtractionResult } from './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 interface ExtractionSourceGroundingOptions {

package/dist/extraction-source-grounding-rules.js

@@ -1,8 +1,8 @@
 import {
   applyExtractionSourceGrounding,
   filterExtractionResultBySource
-} from "./chunk-WOCNN776.js";
-import "./chunk-P2BM76KT.js";
+} from "./chunk-4POAMKV6.js";
+import "./chunk-WAS4HV46.js";
 import "./chunk-VEWZZM3H.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/extraction-source-grounding.d.ts

@@ -1,8 +1,9 @@
-import { J as ExtractionResult, ao as ProvenanceConfig } from './types-rEwubvim.js';
+import { K as ExtractionResult, ap as ProvenanceConfig } from './types-yX_FwERf.js';
 import { ExtractionGroundingRoleSources, ExtractionSourceGroundingOptions } from './extraction-source-grounding-rules.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 declare function applyExtractionSourceGrounding(result: ExtractionResult, sourceText: string, assertionSourceText: string | undefined, roleAssertionSources: ExtractionGroundingRoleSources | undefined, messageTimestamp: Date | undefined, options: ExtractionSourceGroundingOptions): ExtractionResult;

package/dist/extraction-source-grounding.js

@@ -2,16 +2,16 @@ import {
   applyExtractionSourceGrounding,
   attachExtractionProvenance,
   filterExtractionResultBySource
-} from "./chunk-YIAA2X3D.js";
-import "./chunk-WOCNN776.js";
-import "./chunk-P2BM76KT.js";
+} from "./chunk-NK5RGJ65.js";
+import "./chunk-4POAMKV6.js";
+import "./chunk-WAS4HV46.js";
 import "./chunk-VEWZZM3H.js";
-import "./chunk-5I4M26Q7.js";
+import "./chunk-QBSFOKY6.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-PQVCH2AE.js";
-import "./chunk-JUC24CTX.js";
 import "./chunk-6MKAMLQL.js";
 import "./chunk-JAKIDQB2.js";
+import "./chunk-JUC24CTX.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/extraction.d.ts

@@ -1,12 +1,13 @@
 import { LocalLlmClient } from './local-llm.js';
 import { ContradictionVerificationResult, SuggestedLinks, MemorySummaryResult } from './schemas.js';
-import { P as PluginConfig, G as GatewayConfig, j as BufferTurn, J as ExtractionResult, M as MemoryFile, K as ConsolidationResult, N as DaySummaryResult } from './types-rEwubvim.js';
+import { P as PluginConfig, G as GatewayConfig, j as BufferTurn, K as ExtractionResult, M as MemoryFile, N as ConsolidationResult, O as DaySummaryResult } from './types-yX_FwERf.js';
 import { ModelRegistry } from './model-registry.js';
 import { ProfilingCollector } from './profiling.js';
 export { classifyExtractionThrownError, classifyFallbackParseFailure } from './extraction-error-classification.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 import 'zod';
 

package/dist/extraction.js

@@ -1,79 +1,68 @@
 import {
   ExtractionEngine,
   shouldEnableLocalExtractionThinking
-} from "./chunk-UYLMNVY6.js";
+} from "./chunk-R3KHKU7M.js";
 import "./chunk-4RA3C3EV.js";
-import "./chunk-5ZE7QHTK.js";
+import "./chunk-2X2T2UVE.js";
 import "./chunk-CMQZNEIF.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-2CGLBUW3.js";
 import "./chunk-WLZYGLJ4.js";
-import "./chunk-WFTIGIIS.js";
+import "./chunk-L6CQ7WIW.js";
 import "./chunk-WKDFJXW5.js";
 import "./chunk-JUXOTY6J.js";
-import "./chunk-YIAA2X3D.js";
-import "./chunk-WOCNN776.js";
-import "./chunk-P2BM76KT.js";
+import "./chunk-NK5RGJ65.js";
+import "./chunk-4POAMKV6.js";
+import "./chunk-WAS4HV46.js";
 import {
   classifyExtractionThrownError,
   classifyFallbackParseFailure
 } from "./chunk-BLDBT6HZ.js";
-import "./chunk-VEWZZM3H.js";
 import "./chunk-RPSYDM6C.js";
+import "./chunk-VEWZZM3H.js";
 import "./chunk-C7SRUWBW.js";
 import "./chunk-JLNBQWZ2.js";
 import "./chunk-EI6V5UXY.js";
-import "./chunk-T2TTP3KU.js";
-import "./chunk-7TWUCYER.js";
+import "./chunk-X4IDNPOS.js";
+import "./chunk-PNRA7FAD.js";
 import "./chunk-EMDLM3LW.js";
 import "./chunk-NLE6TSLG.js";
 import "./chunk-QDW3E4RD.js";
-import "./chunk-ECK75GDJ.js";
-import "./chunk-BUE5E2HL.js";
-import "./chunk-PD6O7AXF.js";
-import "./chunk-QJAQNXWI.js";
-import "./chunk-YV32N67O.js";
-import "./chunk-64UDOIMI.js";
-import "./chunk-IUM3VSHI.js";
-import "./chunk-O75CRYGF.js";
-import "./chunk-OD4FM2U7.js";
-import "./chunk-BJKPPZ6Z.js";
+import "./chunk-UW66OZTD.js";
 import "./chunk-KSXJOC4F.js";
-import "./chunk-TBBDFYXW.js";
-import "./chunk-E6PNLPGJ.js";
+import "./chunk-FUCYDRE5.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-ENTCVTQR.js";
-import "./chunk-WIPEXG6R.js";
+import "./chunk-SXIMQLGV.js";
+import "./chunk-S2V7RUCL.js";
 import "./chunk-J6A3CX5N.js";
-import "./chunk-J7VGGECD.js";
-import "./chunk-WUNIWKY4.js";
-import "./chunk-EGGE52UU.js";
-import "./chunk-ZA53AZND.js";
+import "./chunk-DZPFMQZ7.js";
+import "./chunk-S2HLHAZ4.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
-import "./chunk-GCASGYIO.js";
-import "./chunk-7RJUVTVF.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-JYIJNNN3.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-RVLJEII5.js";
-import "./chunk-S5SLVSVY.js";
+import "./chunk-SYUBB3WM.js";
 import "./chunk-CGASUJVP.js";
 import "./chunk-R3DJVOSM.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-3CSX3ETE.js";
-import "./chunk-RL6NEVXT.js";
 import "./chunk-YXZG5TVN.js";
-import "./chunk-W5H6ZRPT.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-DLVPUX7U.js";
+import "./chunk-7YKVM5H3.js";
 import "./chunk-IJ7HK452.js";
 import "./chunk-PDJTHRAW.js";
-import "./chunk-4J7G5SY4.js";
+import "./chunk-NZBZ7IS2.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-FFAZ2XFU.js";
+import "./chunk-N3LL5NEU.js";
+import "./chunk-PD6O7AXF.js";
+import "./chunk-RVO6TCTU.js";
+import "./chunk-URS5GSM7.js";
+import "./chunk-IUM3VSHI.js";
+import "./chunk-ZLQ37WJX.js";
+import "./chunk-OD4FM2U7.js";
 import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-C23BYTJV.js";
@@ -82,27 +71,41 @@ import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
-import "./chunk-MZWSOLMT.js";
 import "./chunk-K6MV3TRQ.js";
-import "./chunk-5I4M26Q7.js";
-import "./chunk-ZIKENA2C.js";
+import "./chunk-QBSFOKY6.js";
 import "./chunk-5GKPFL3S.js";
+import "./chunk-ZIKENA2C.js";
 import "./chunk-PQVCH2AE.js";
-import "./chunk-EYIEWJNI.js";
-import "./chunk-JUC24CTX.js";
 import "./chunk-6MKAMLQL.js";
 import "./chunk-JAKIDQB2.js";
+import "./chunk-TBBDFYXW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
+import "./chunk-ELIL2A37.js";
+import "./chunk-EGGE52UU.js";
+import "./chunk-ZA53AZND.js";
+import "./chunk-7RJUVTVF.js";
+import "./chunk-GCASGYIO.js";
+import "./chunk-BQIFZ2MP.js";
+import "./chunk-3CSX3ETE.js";
+import "./chunk-RL6NEVXT.js";
+import "./chunk-FFAZ2XFU.js";
+import "./chunk-W5H6ZRPT.js";
+import "./chunk-BGLY7EEM.js";
 import "./chunk-P7FMDTKL.js";
+import "./chunk-MZWSOLMT.js";
 import "./chunk-3GD2HFR6.js";
 import "./chunk-U3PN77QT.js";
 import "./chunk-2XRE6FLM.js";
+import "./chunk-J2WC5LF4.js";
+import "./chunk-O75CRYGF.js";
+import "./chunk-EYIEWJNI.js";
+import "./chunk-JUC24CTX.js";
 import "./chunk-2Z24E5W2.js";
-import "./chunk-PVGDJXVK.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-5TFP4CUL.js";
+import "./chunk-XQ3HXAQH.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-VS2IYZRU.js";

package/dist/fallback-llm.d.ts

@@ -1,8 +1,9 @@
-import { G as GatewayConfig, A as AgentPersonaModelConfig, P as PluginConfig } from './types-rEwubvim.js';
+import { G as GatewayConfig, A as AgentPersonaModelConfig, P as PluginConfig } from './types-yX_FwERf.js';
 import { GetRuntimeAuthForModelFn, ResolveApiKeyFn } from './resolve-provider-secret.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 interface FallbackLlmOptions {

package/dist/{first-start-migration-F2QJD66E.js → first-start-migration-ZSHEFEI3.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-LXOM6IQU.js";
 import {
   TierMigrationExecutor
-} from "./chunk-VOUOLGIP.js";
+} from "./chunk-YRFAYOFQ.js";
 import {
   decideTierTransition
 } from "./chunk-S75M5ZRK.js";
@@ -193,17 +193,15 @@ async function runFirstStartMigration(options) {
       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");
+      const result = executor ? await executor.migrateMemory({
+        memory,
+        fromTier: "hot",
+        toTier: "cold",
+        reason: "first-start-lifecycle-migration"
+      }) : await storage.migrateMemoryToTier(memory, "cold");
+      if (result.changed) {
+        demotedCount += 1;
       }
-      demotedCount += 1;
     } catch {
       const targetPath = storage.buildTierMemoryPath(memory, "cold");
       const [targetExists, sourceExists] = await Promise.all([
@@ -266,4 +264,4 @@ export {
   LIFECYCLE_INIT_DONE_MARKER,
   runFirstStartMigration
 };
-//# sourceMappingURL=first-start-migration-F2QJD66E.js.map
+//# sourceMappingURL=first-start-migration-ZSHEFEI3.js.map

package/dist/{first-start-migration-F2QJD66E.js.map → first-start-migration-ZSHEFEI3.js.map}

@@ -1 +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 {\n  resolveMemoryLifecycleCapabilities,\n  resolveQmdCapabilities,\n  resolveUtilityLearningCapabilities} from \"../capabilities.js\";\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: resolveQmdCapabilities(config).qmdTierMigration,\n    demotionMinAgeDays: config.qmdTierDemotionMinAgeDays,\n    demotionValueThreshold: config.qmdTierDemotionValueThreshold,\n    promotionValueThreshold: config.qmdTierPromotionValueThreshold,\n  };\n  const runtime = await loadUtilityRuntimeValues({\n    memoryDir: config.memoryDir,\n    memoryUtilityLearningEnabled: resolveUtilityLearningCapabilities(config).memoryUtilityLearning,\n    promotionByOutcomeEnabled: resolveUtilityLearningCapabilities(config).promotionByOutcome,\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 lifecycleCaps = resolveMemoryLifecycleCapabilities(config);\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 (!lifecycleCaps.lifecyclePolicy) {\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 (!resolveQmdCapabilities(config).qmdTierMigration) {\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":";;;;;;;;;;;;;;;;;;;;;;;AAkBA,OAAO,UAAU;AACjB,SAAS,QAAQ,OAAO,UAAU,QAAQ,iBAAiB;AAkBpD,IAAM,2BAA2B;AACjC,IAAM,6BAA6B;AAC1C,IAAM,uCAAuC;AAsC7C,SAAS,WAAW,WAA2B;AAC7C,SAAO,KAAK,KAAK,WAAW,SAAS,0BAA0B;AACjE;AAEA,SAAS,sBAAsB,WAA2B;AACxD,SAAO,KAAK,KAAK,WAAW,SAAS,oCAAoC;AAC3E;AAEA,eAAe,aAAa,WAAqC;AAC/D,MAAI;AACF,UAAM,OAAO,WAAW,SAAS,CAAC;AAClC,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAe,YAAY,WAAmB,KAA0B;AACtE,QAAM,IAAI,WAAW,SAAS;AAC9B,QAAM,MAAM,KAAK,QAAQ,CAAC,GAAG,EAAE,WAAW,KAAK,CAAC;AAChD,QAAM,UAAU,GAAG,KAAK,UAAU,EAAE,WAAW,IAAI,YAAY,EAAE,CAAC,GAAG,OAAO;AAC9E;AAEA,eAAe,sBAAsB,WAA4D;AAC/F,MAAI;AACF,UAAM,MAAM,MAAM,SAAS,sBAAsB,SAAS,GAAG,OAAO;AACpE,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,QACE,UACA,OAAO,WAAW,YAClB,OAAQ,OAAmC,cAAc,YACzD,OAAQ,OAAoC,eAAe,YAC1D,OAAkC,WAAW,SAAS,GACvD;AACA,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAe,WAAW,GAA6B;AACrD,MAAI;AACF,UAAM,OAAO,CAAC;AACd,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAe,uBAAuB,WAAmB,KAAW,YAAmC;AACrG,QAAM,IAAI,sBAAsB,SAAS;AACzC,QAAM,MAAM,KAAK,QAAQ,CAAC,GAAG,EAAE,WAAW,KAAK,CAAC;AAChD,QAAM,UAAU,GAAG,KAAK,UAAU,EAAE,WAAW,IAAI,YAAY,GAAG,WAAW,CAAC,GAAG,OAAO;AAC1F;AAEA,eAAe,uBAAuB,WAAkC;AACtE,QAAM,OAAO,sBAAsB,SAAS,CAAC,EAAE,MAAM,MAAM;AAAA,EAAC,CAAC;AAC/D;AAEA,eAAe,uBAAuB,QAAkD;AACtF,QAAM,aAAgC;AAAA,IACpC,SAAS,uBAAuB,MAAM,EAAE;AAAA,IACxC,oBAAoB,OAAO;AAAA,IAC3B,wBAAwB,OAAO;AAAA,IAC/B,yBAAyB,OAAO;AAAA,EAClC;AACA,QAAM,UAAU,MAAM,yBAAyB;AAAA,IAC7C,WAAW,OAAO;AAAA,IAClB,8BAA8B,mCAAmC,MAAM,EAAE;AAAA,IACzE,2BAA2B,mCAAmC,MAAM,EAAE;AAAA,EACxE,CAAC;AACD,SAAO,mCAAmC,YAAY,OAAO;AAC/D;AAEA,eAAe,qBACb,KACA,YACA,QACe;AACf,MAAI,OAAO,IAAI,2BAA2B,YAAY;AACpD,UAAM,IAAI,uBAAuB,YAAY,EAAE,OAAO,CAAC;AACvD;AAAA,EACF;AACA,QAAM,IAAI,iBAAiB,YAAY,EAAE,OAAO,CAAC;AACnD;AAUA,eAAsB,uBACpB,SACoC;AACpC,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd,SAAS;AAAA,IACT;AAAA,IACA;AAAA,EACF,IAAI;AACJ,QAAM,OAAO,QAAQ,QAAQ,MAAM,oBAAI,KAAK,IAAI;AAChD,QAAM,gBAAgB,mCAAmC,MAAM;AAC/D,QAAM,gBAAgB,CAACA,kBAAiB,GAAGC,gBAAe,GAAGC,gBAAe,OAAkC;AAAA,IAC5G,SAASF,oBAAmB,KAAKC,kBAAiB,KAAKC,kBAAiB;AAAA,IACxE,YAAYF,oBAAmB,KAAKC,kBAAiB,KAAKC,kBAAiB,IAAI,YAAY;AAAA,IAC3F;AAAA,IACA,gBAAAF;AAAA,IACA,cAAAC;AAAA,IACA,cAAAC;AAAA,IACA,UAAU;AAAA,EACZ;AAEA,MAAI,QAAQ,SAAS;AACnB,WAAO,cAAc;AAAA,EACvB;AAEA,MAAI,CAAC,cAAc,iBAAiB;AAClC,WAAO;AAAA,MACL,SAAS;AAAA,MACT,YAAY;AAAA,MACZ;AAAA,MACA,gBAAgB;AAAA,MAChB,cAAc;AAAA,MACd,cAAc;AAAA,MACd,UAAU;AAAA,IACZ;AAAA,EACF;AAEA,MAAI,CAAC,uBAAuB,MAAM,EAAE,kBAAkB;AACpD,WAAO;AAAA,MACL,SAAS;AAAA,MACT,YAAY;AAAA,MACZ;AAAA,MACA,gBAAgB;AAAA,MAChB,cAAc;AAAA,MACd,cAAc;AAAA,MACd,UAAU;AAAA,IACZ;AAAA,EACF;AAEA,MAAI,MAAM,aAAa,OAAO,SAAS,GAAG;AACxC,WAAO;AAAA,MACL,SAAS;AAAA,MACT,YAAY;AAAA,MACZ;AAAA,MACA,gBAAgB;AAAA,MAChB,cAAc;AAAA,MACd,cAAc;AAAA,MACd,UAAU;AAAA,IACZ;AAAA,EACF;AAEA,MAAI,QAAQ,SAAS;AACnB,WAAO,cAAc;AAAA,EACvB;AAEA,QAAM,SAAS,MAAM,uBAAuB,MAAM;AAClD,MAAI,QAAQ,SAAS;AACnB,WAAO,cAAc;AAAA,EACvB;AAEA,QAAM,cAAc,MAAM,QAAQ,gBAAgB;AAClD,MAAI,QAAQ,SAAS;AACnB,WAAO,cAAc;AAAA,EACvB;AAGA,QAAM,qBAAqB,YAAY,OAAO,CAAC,MAAM;AACnD,UAAM,WAAW,qBAAqB,GAAG,OAAO,QAAQ,GAAG;AAC3D,WAAO,SAAS,WAAW,SAAS,aAAa;AAAA,EACnD,CAAC;AAED,QAAM,iBAAiB,mBAAmB;AAE1C,QAAM,QAAQ,mBAAmB,MAAM,GAAG,WAAW;AAErD,MAAI,QAAQ;AACV,WAAO;AAAA,MACL,SAAS;AAAA,MACT,QAAQ;AAAA,MACR;AAAA,MACA,cAAc;AAAA,MACd,cAAc;AAAA,MACd,UAAU;AAAA,IACZ;AAAA,EACF;AAEA,MAAI,eAAe;AACnB,MAAI,eAAe;AACnB,MAAI,0BAA0B;AAC9B,QAAM,WAAW,MACb,IAAI,sBAAsB;AAAA,IACxB;AAAA,IACA;AAAA,IACA,eAAe,QAAQ,iBAAiB,OAAO,iBAAiB;AAAA,IAChE,gBAAgB,QAAQ,kBAAkB,OAAO,qBAAqB;AAAA,EAC1E,CAAC,IACC;AACJ,QAAM,iBAAiB,QAAQ,kBAAkB,OAAO,qBAAqB;AAE7E,aAAW,UAAU,OAAO;AAC1B,QAAI,QAAQ,SAAS;AACnB,aAAO,cAAc,gBAAgB,cAAc,YAAY;AAAA,IACjE;AACA,QAAI;AACF,UAAI,UAAU;AACZ,cAAM,SAAS,cAAc;AAAA,UAC3B;AAAA,UACA,UAAU;AAAA,UACV,QAAQ;AAAA,UACR,QAAQ;AAAA,QACV,CAAC;AAAA,MACH,OAAO;AACL,cAAM,QAAQ,oBAAoB,QAAQ,MAAM;AAAA,MAClD;AACA,sBAAgB;AAAA,IAClB,QAAQ;AACN,YAAM,aAAa,QAAQ,oBAAoB,QAAQ,MAAM;AAC7D,YAAM,CAAC,cAAc,YAAY,IAAI,MAAM,QAAQ,IAAI;AAAA,QACrD,WAAW,UAAU;AAAA,QACrB,WAAW,OAAO,IAAI;AAAA,MACxB,CAAC;AACD,YAAM,cAAc,gBAAgB,CAAC;AACrC,UAAI,aAAa;AACf,YAAI,CAAC,KAAK;AACR,0BAAgB;AAChB;AAAA,QACF;AACA,YAAI;AACF,gBAAM,qBAAqB,KAAK,gBAAgB,MAAM;AACtD,0BAAgB;AAChB;AAAA,QACF,QAAQ;AACN,oCAA0B;AAC1B,cAAI;AACF,kBAAM,uBAAuB,OAAO,WAAW,KAAK,cAAc;AAAA,UACpE,QAAQ;AAAA,UAGR;AACA,0BAAgB;AAChB;AAAA,QACF;AAAA,MACF;AAKA,sBAAgB;AAAA,IAClB;AAAA,EACF;AAIA,MAAI,QAAQ,SAAS;AACnB,WAAO,cAAc,gBAAgB,cAAc,YAAY;AAAA,EACjE;AACA,QAAM,6BAA6B,MAAM,MAAM,sBAAsB,OAAO,SAAS,IAAI;AACzF,QAAM,gCAAgC,4BAA4B,eAAe;AACjF,MAAI,OAAO,8BAA8B,2BAA2B,eAAe,gBAAgB;AACjG,oBAAgB;AAAA,EAClB;AACA,MAAI,QAAQ,2BAA2B,gCAAgC;AACrE,QAAI;AACF,YAAM,qBAAqB,KAAK,gBAAgB,MAAM;AACtD,YAAM,uBAAuB,OAAO,SAAS;AAAA,IAC/C,QAAQ;AACN,sBAAgB;AAAA,IAClB;AAAA,EACF;AACA,MAAI,iBAAiB,GAAG;AACtB,UAAM,YAAY,OAAO,WAAW,GAAG;AAAA,EACzC;AAEA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU;AAAA,EACZ;AACF;","names":["candidateCount","demotedCount","failureCount"]}
+{"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 {\n  resolveMemoryLifecycleCapabilities,\n  resolveQmdCapabilities,\n  resolveUtilityLearningCapabilities} from \"../capabilities.js\";\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: resolveQmdCapabilities(config).qmdTierMigration,\n    demotionMinAgeDays: config.qmdTierDemotionMinAgeDays,\n    demotionValueThreshold: config.qmdTierDemotionValueThreshold,\n    promotionValueThreshold: config.qmdTierPromotionValueThreshold,\n  };\n  const runtime = await loadUtilityRuntimeValues({\n    memoryDir: config.memoryDir,\n    memoryUtilityLearningEnabled: resolveUtilityLearningCapabilities(config).memoryUtilityLearning,\n    promotionByOutcomeEnabled: resolveUtilityLearningCapabilities(config).promotionByOutcome,\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 lifecycleCaps = resolveMemoryLifecycleCapabilities(config);\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 (!lifecycleCaps.lifecyclePolicy) {\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 (!resolveQmdCapabilities(config).qmdTierMigration) {\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      const result = executor\n        ? await executor.migrateMemory({\n            memory,\n            fromTier: \"hot\",\n            toTier: \"cold\",\n            reason: \"first-start-lifecycle-migration\",\n          })\n        : await storage.migrateMemoryToTier(memory, \"cold\");\n      if (result.changed) {\n        demotedCount += 1;\n      }\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/graph-dashboard-diff.d.ts

@@ -1,10 +1,11 @@
 import { GraphEdge } from './graph.js';
 import { GraphSnapshot } from './graph-dashboard-parser.js';
 import './capabilities.js';
-import './types-rEwubvim.js';
+import './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 interface GraphPatch {

package/dist/graph-dashboard-key.d.ts

@@ -1,9 +1,10 @@
 import { GraphEdge } from './graph.js';
 import './capabilities.js';
-import './types-rEwubvim.js';
+import './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 declare function graphEdgeKey(edge: GraphEdge): string;

package/dist/graph-dashboard-parser.d.ts

@@ -1,9 +1,10 @@
 import { GraphEdge, GraphType } from './graph.js';
 import './capabilities.js';
-import './types-rEwubvim.js';
+import './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 interface GraphSnapshotNode {