memo-grafter 0.2.8 → 0.3.0

package/dist/maintenance/ConflictDetectionPass.js

@@ -0,0 +1,46 @@
+import { findMemoryConflictGroups, getSkippedMaintenanceCounts } from "./memoryMaintenance.js";
+export class ConflictDetectionPass {
+    name = "conflict-detection";
+    async run(context) {
+        if (!context.store) {
+            throw new Error("ConflictDetectionPass requires a crawler maintenance store.");
+        }
+        const memories = await context.store.listMemoryNodesForMaintenance();
+        const conflictGroups = findMemoryConflictGroups(memories);
+        const conflictingNodeIds = new Set();
+        let conflictEdgesCreated = 0;
+        for (const group of conflictGroups) {
+            for (const node of group.nodes) {
+                conflictingNodeIds.add(node.id);
+            }
+            for (let sourceIndex = 0; sourceIndex < group.nodes.length; sourceIndex += 1) {
+                const source = group.nodes[sourceIndex];
+                if (!source)
+                    continue;
+                for (let targetIndex = sourceIndex + 1; targetIndex < group.nodes.length; targetIndex += 1) {
+                    const target = group.nodes[targetIndex];
+                    if (!target)
+                        continue;
+                    const created = await context.store.upsertMemoryEdge({
+                        sourceId: source.id,
+                        targetId: target.id,
+                        edgeType: "conflicts",
+                        weight: 1,
+                    });
+                    if (created)
+                        conflictEdgesCreated += 1;
+                }
+            }
+        }
+        const nodesMarkedConflicting = await context.store.markMemoryNodesConflicting([...conflictingNodeIds]);
+        const skipped = getSkippedMaintenanceCounts(memories);
+        return {
+            inspected: memories.length,
+            conflictsDetected: conflictGroups.length,
+            nodesMarkedConflicting,
+            conflictEdgesCreated,
+            ...skipped,
+        };
+    }
+}
+//# sourceMappingURL=ConflictDetectionPass.js.map

package/dist/maintenance/ConflictDetectionPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConflictDetectionPass.js","sourceRoot":"","sources":["../../src/maintenance/ConflictDetectionPass.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE/F,MAAM,OAAO,qBAAqB;IACvB,IAAI,GAAG,oBAAoB,CAAC;IAErC,KAAK,CAAC,GAAG,CAAC,OAA2B;QACnC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC;QACrE,MAAM,cAAc,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;QAC7C,IAAI,oBAAoB,GAAG,CAAC,CAAC;QAE7B,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACnC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,CAAC;YAED,KAAK,IAAI,WAAW,GAAG,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,IAAI,CAAC,EAAE,CAAC;gBAC7E,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACxC,IAAI,CAAC,MAAM;oBAAE,SAAS;gBAEtB,KAAK,IAAI,WAAW,GAAG,WAAW,GAAG,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,IAAI,CAAC,EAAE,CAAC;oBAC3F,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;oBACxC,IAAI,CAAC,MAAM;wBAAE,SAAS;oBAEtB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC;wBACnD,QAAQ,EAAE,MAAM,CAAC,EAAE;wBACnB,QAAQ,EAAE,MAAM,CAAC,EAAE;wBACnB,QAAQ,EAAE,WAAW;wBACrB,MAAM,EAAE,CAAC;qBACV,CAAC,CAAC;oBACH,IAAI,OAAO;wBAAE,oBAAoB,IAAI,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,sBAAsB,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC;QACvG,MAAM,OAAO,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;QAEtD,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,MAAM;YAC1B,iBAAiB,EAAE,cAAc,CAAC,MAAM;YACxC,sBAAsB;YACtB,oBAAoB;YACpB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;CACF"}

package/dist/maintenance/DecayScoringPass.d.ts

@@ -0,0 +1,17 @@
+import type { CrawlerPass, CrawlerPassContext, CrawlerPassResult } from "./types.js";
+export interface DecayScoringPassOptions {
+    halfLifeDays?: number;
+    minScore?: number;
+    now?: () => Date;
+    updateConfidence?: boolean;
+}
+export declare class DecayScoringPass implements CrawlerPass {
+    readonly name = "decay-scoring";
+    private readonly halfLifeDays;
+    private readonly minScore;
+    private readonly now;
+    private readonly updateConfidence;
+    constructor(options?: DecayScoringPassOptions);
+    run(context: CrawlerPassContext): Promise<CrawlerPassResult>;
+}
+//# sourceMappingURL=DecayScoringPass.d.ts.map

package/dist/maintenance/DecayScoringPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecayScoringPass.d.ts","sourceRoot":"","sources":["../../src/maintenance/DecayScoringPass.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErF,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAKD,qBAAa,gBAAiB,YAAW,WAAW;IAClD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;gBAE/B,OAAO,GAAE,uBAA4B;IAe3C,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA4DnE"}

package/dist/maintenance/DecayScoringPass.js

@@ -0,0 +1,79 @@
+import { computeMemoryDecayScore } from "./decayScoring.js";
+const DEFAULT_HALF_LIFE_DAYS = 90;
+const DEFAULT_MIN_SCORE = 0.25;
+export class DecayScoringPass {
+    name = "decay-scoring";
+    halfLifeDays;
+    minScore;
+    now;
+    updateConfidence;
+    constructor(options = {}) {
+        this.halfLifeDays = options.halfLifeDays ?? DEFAULT_HALF_LIFE_DAYS;
+        this.minScore = options.minScore ?? DEFAULT_MIN_SCORE;
+        this.now = options.now ?? (() => new Date());
+        this.updateConfidence = options.updateConfidence ?? false;
+        if (!Number.isFinite(this.halfLifeDays) || this.halfLifeDays <= 0) {
+            throw new Error("DecayScoringPass halfLifeDays must be greater than 0.");
+        }
+        if (!Number.isFinite(this.minScore) || this.minScore < 0) {
+            throw new Error("DecayScoringPass minScore must be greater than or equal to 0.");
+        }
+    }
+    async run(context) {
+        if (!context.store) {
+            throw new Error("DecayScoringPass requires a crawler maintenance store.");
+        }
+        const memories = await context.store.listMemoryNodesForMaintenance();
+        const now = this.now();
+        let decayScored = 0;
+        let nodesDecayed = 0;
+        let skippedAlreadyDecayed = 0;
+        let skippedSuperseded = 0;
+        let skippedForgotten = 0;
+        let minDecayScore;
+        let maxDecayScore;
+        for (const memory of memories) {
+            if (memory.forgotten) {
+                skippedForgotten += 1;
+                continue;
+            }
+            if (memory.supersededBy != null) {
+                skippedSuperseded += 1;
+                continue;
+            }
+            if (memory.decayed) {
+                skippedAlreadyDecayed += 1;
+                continue;
+            }
+            const score = computeMemoryDecayScore(memory, {
+                now,
+                halfLifeDays: this.halfLifeDays,
+            });
+            decayScored += 1;
+            minDecayScore = minDecayScore === undefined ? score : Math.min(minDecayScore, score);
+            maxDecayScore = maxDecayScore === undefined ? score : Math.max(maxDecayScore, score);
+            if (this.updateConfidence && context.store.updateMemoryNodeConfidence) {
+                await context.store.updateMemoryNodeConfidence(memory.id, clampConfidence(score));
+            }
+            if (score < this.minScore) {
+                const decayed = await context.store.markMemoryNodeDecayed(memory.id);
+                if (decayed)
+                    nodesDecayed += 1;
+            }
+        }
+        return {
+            inspected: memories.length,
+            decayScored,
+            nodesDecayed,
+            skippedAlreadyDecayed,
+            skippedSuperseded,
+            skippedForgotten,
+            ...(minDecayScore !== undefined ? { minDecayScore } : {}),
+            ...(maxDecayScore !== undefined ? { maxDecayScore } : {}),
+        };
+    }
+}
+function clampConfidence(value) {
+    return Math.max(0, Math.min(1, value));
+}
+//# sourceMappingURL=DecayScoringPass.js.map

package/dist/maintenance/DecayScoringPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecayScoringPass.js","sourceRoot":"","sources":["../../src/maintenance/DecayScoringPass.ts"],"names":[],"mappings":"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"}

package/dist/maintenance/MemoGrafterCrawler.d.ts

@@ -0,0 +1,14 @@
+import type { CrawlerConfig, CrawlerReport } from "./types.js";
+export declare class MemoGrafterCrawler {
+    private readonly config;
+    private intervalHandle;
+    private isRunning;
+    private isExecuting;
+    constructor(config?: CrawlerConfig);
+    start(): void;
+    stop(): void;
+    runOnce(): Promise<CrawlerReport>;
+    private runScheduledTick;
+    private runPass;
+}
+//# sourceMappingURL=MemoGrafterCrawler.d.ts.map

package/dist/maintenance/MemoGrafterCrawler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoGrafterCrawler.d.ts","sourceRoot":"","sources":["../../src/maintenance/MemoGrafterCrawler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAGb,aAAa,EACd,MAAM,YAAY,CAAC;AAIpB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CACmB;IAC1C,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,aAAkB;IAStC,KAAK,IAAI,IAAI;IAWb,IAAI,IAAI,IAAI;IASN,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;YA2BzB,gBAAgB;YAahB,OAAO;CA8BtB"}

package/dist/maintenance/MemoGrafterCrawler.js

@@ -0,0 +1,108 @@
+const DEFAULT_INTERVAL_MS = 60_000;
+export class MemoGrafterCrawler {
+    config;
+    intervalHandle;
+    isRunning = false;
+    isExecuting = false;
+    constructor(config = {}) {
+        this.config = {
+            intervalMs: config.intervalMs ?? DEFAULT_INTERVAL_MS,
+            passes: config.passes ?? [],
+            stopOnPassError: config.stopOnPassError ?? false,
+            ...(config.store !== undefined ? { store: config.store } : {}),
+        };
+    }
+    start() {
+        if (this.isRunning) {
+            return;
+        }
+        this.isRunning = true;
+        this.intervalHandle = setInterval(() => {
+            void this.runScheduledTick();
+        }, this.config.intervalMs);
+    }
+    stop() {
+        if (this.intervalHandle !== undefined) {
+            clearInterval(this.intervalHandle);
+            this.intervalHandle = undefined;
+        }
+        this.isRunning = false;
+    }
+    async runOnce() {
+        const startedAtMs = Date.now();
+        const startedAt = new Date(startedAtMs).toISOString();
+        const passes = [];
+        const context = this.config.store !== undefined
+            ? { store: this.config.store }
+            : {};
+        for (const pass of this.config.passes ?? []) {
+            const passReport = await this.runPass(pass.name, () => pass.run(context));
+            passes.push(passReport);
+            if (!passReport.ok && this.config.stopOnPassError) {
+                break;
+            }
+        }
+        const finishedAtMs = Date.now();
+        return {
+            startedAt,
+            finishedAt: new Date(finishedAtMs).toISOString(),
+            durationMs: finishedAtMs - startedAtMs,
+            passes,
+            ok: passes.every((pass) => pass.ok),
+        };
+    }
+    async runScheduledTick() {
+        if (this.isExecuting) {
+            return;
+        }
+        this.isExecuting = true;
+        try {
+            await this.runOnce();
+        }
+        finally {
+            this.isExecuting = false;
+        }
+    }
+    async runPass(name, run) {
+        const startedAtMs = Date.now();
+        const startedAt = new Date(startedAtMs).toISOString();
+        try {
+            const result = await run();
+            const finishedAtMs = Date.now();
+            return {
+                name,
+                ok: true,
+                startedAt,
+                finishedAt: new Date(finishedAtMs).toISOString(),
+                durationMs: finishedAtMs - startedAtMs,
+                result,
+            };
+        }
+        catch (error) {
+            const finishedAtMs = Date.now();
+            return {
+                name,
+                ok: false,
+                startedAt,
+                finishedAt: new Date(finishedAtMs).toISOString(),
+                durationMs: finishedAtMs - startedAtMs,
+                error: serializeError(error),
+            };
+        }
+    }
+}
+function serializeError(error) {
+    if (error instanceof Error) {
+        const serialized = {
+            message: error.message,
+        };
+        if (error.stack !== undefined) {
+            serialized.stack = error.stack;
+        }
+        return serialized;
+    }
+    return {
+        message: String(error),
+    };
+}
+//# sourceMappingURL=MemoGrafterCrawler.js.map

package/dist/maintenance/MemoGrafterCrawler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoGrafterCrawler.js","sourceRoot":"","sources":["../../src/maintenance/MemoGrafterCrawler.ts"],"names":[],"mappings":"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"}

package/dist/maintenance/VersioningPass.d.ts

@@ -0,0 +1,6 @@
+import type { CrawlerPass, CrawlerPassContext, CrawlerPassResult } from "./types.js";
+export declare class VersioningPass implements CrawlerPass {
+    readonly name = "versioning";
+    run(context: CrawlerPassContext): Promise<CrawlerPassResult>;
+}
+//# sourceMappingURL=VersioningPass.d.ts.map

package/dist/maintenance/VersioningPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersioningPass.d.ts","sourceRoot":"","sources":["../../src/maintenance/VersioningPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMrF,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,gBAAgB;IAEvB,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAsCnE"}

package/dist/maintenance/VersioningPass.js

@@ -0,0 +1,40 @@
+import { findMemoryVersionGroups, getSkippedMaintenanceCounts, } from "./memoryMaintenance.js";
+export class VersioningPass {
+    name = "versioning";
+    async run(context) {
+        if (!context.store) {
+            throw new Error("VersioningPass requires a crawler maintenance store.");
+        }
+        const memories = await context.store.listMemoryNodesForMaintenance();
+        const versionGroups = findMemoryVersionGroups(memories);
+        let nodesSuperseded = 0;
+        let updateEdgesCreated = 0;
+        for (const group of versionGroups) {
+            for (const node of group.nodes) {
+                if (node.id === group.replacement.id || node.supersededBy != null)
+                    continue;
+                const superseded = await context.store.markMemoryNodeSuperseded(node.id, group.replacement.id);
+                if (superseded)
+                    nodesSuperseded += 1;
+                // Direction convention: newer memory --updates--> older memory.
+                const edgeCreated = await context.store.upsertMemoryEdge({
+                    sourceId: group.replacement.id,
+                    targetId: node.id,
+                    edgeType: "updates",
+                    weight: 1,
+                });
+                if (edgeCreated)
+                    updateEdgesCreated += 1;
+            }
+        }
+        const skipped = getSkippedMaintenanceCounts(memories);
+        return {
+            inspected: memories.length,
+            versionsDetected: versionGroups.length,
+            nodesSuperseded,
+            updateEdgesCreated,
+            ...skipped,
+        };
+    }
+}
+//# sourceMappingURL=VersioningPass.js.map

package/dist/maintenance/VersioningPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersioningPass.js","sourceRoot":"","sources":["../../src/maintenance/VersioningPass.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,YAAY,CAAC;IAE7B,KAAK,CAAC,GAAG,CAAC,OAA2B;QACnC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC;QACrE,MAAM,aAAa,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,kBAAkB,GAAG,CAAC,CAAC;QAE3B,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,WAAW,CAAC,EAAE,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI;oBAAE,SAAS;gBAE5E,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAC/F,IAAI,UAAU;oBAAE,eAAe,IAAI,CAAC,CAAC;gBAErC,gEAAgE;gBAChE,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC;oBACvD,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE;oBAC9B,QAAQ,EAAE,IAAI,CAAC,EAAE;oBACjB,QAAQ,EAAE,SAAS;oBACnB,MAAM,EAAE,CAAC;iBACV,CAAC,CAAC;gBACH,IAAI,WAAW;oBAAE,kBAAkB,IAAI,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;QAEtD,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,MAAM;YAC1B,gBAAgB,EAAE,aAAa,CAAC,MAAM;YACtC,eAAe;YACf,kBAAkB;YAClB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;CACF"}

package/dist/maintenance/decayScoring.d.ts

@@ -0,0 +1,7 @@
+import type { MemoryNode } from "../core/types.js";
+export interface DecayScoreOptions {
+    now: Date;
+    halfLifeDays: number;
+}
+export declare function computeMemoryDecayScore(memory: Pick<MemoryNode, "confidence" | "createdAt">, options: DecayScoreOptions): number;
+//# sourceMappingURL=decayScoring.d.ts.map

package/dist/maintenance/decayScoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decayScoring.d.ts","sourceRoot":"","sources":["../../src/maintenance/decayScoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,IAAI,CAAC;IACV,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,GAAG,WAAW,CAAC,EACpD,OAAO,EAAE,iBAAiB,GACzB,MAAM,CAOR"}

package/dist/maintenance/decayScoring.js

@@ -0,0 +1,9 @@
+const DAY_MS = 24 * 60 * 60 * 1000;
+export function computeMemoryDecayScore(memory, options) {
+    const ageMs = Math.max(0, options.now.getTime() - memory.createdAt.getTime());
+    const ageDays = ageMs / DAY_MS;
+    const lambda = Math.log(2) / options.halfLifeDays;
+    const recencyFactor = Math.exp(-lambda * ageDays);
+    return memory.confidence * recencyFactor;
+}
+//# sourceMappingURL=decayScoring.js.map

package/dist/maintenance/decayScoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decayScoring.js","sourceRoot":"","sources":["../../src/maintenance/decayScoring.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAOnC,MAAM,UAAU,uBAAuB,CACrC,MAAoD,EACpD,OAA0B;IAE1B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;IAElD,OAAO,MAAM,CAAC,UAAU,GAAG,aAAa,CAAC;AAC3C,CAAC"}

package/dist/maintenance/index.d.ts

@@ -0,0 +1,7 @@
+export { ConflictDetectionPass } from "./ConflictDetectionPass.js";
+export { DecayScoringPass } from "./DecayScoringPass.js";
+export { MemoGrafterCrawler } from "./MemoGrafterCrawler.js";
+export { VersioningPass } from "./VersioningPass.js";
+export type { DecayScoringPassOptions } from "./DecayScoringPass.js";
+export type { CrawlerConfig, CrawlerMaintenanceStore, CrawlerPass, CrawlerPassContext, CrawlerPassReport, CrawlerPassResult, CrawlerReport, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/maintenance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/maintenance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,YAAY,EACV,aAAa,EACb,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/maintenance/index.js

@@ -0,0 +1,5 @@
+export { ConflictDetectionPass } from "./ConflictDetectionPass.js";
+export { DecayScoringPass } from "./DecayScoringPass.js";
+export { MemoGrafterCrawler } from "./MemoGrafterCrawler.js";
+export { VersioningPass } from "./VersioningPass.js";
+//# sourceMappingURL=index.js.map

package/dist/maintenance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/maintenance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/maintenance/memoryMaintenance.d.ts

@@ -0,0 +1,23 @@
+import type { MemoryNode } from "../core/types.js";
+export interface MemoryConflictGroup {
+    key: string;
+    nodes: MemoryNode[];
+}
+export interface MemoryVersionGroup {
+    key: string;
+    nodes: MemoryNode[];
+    replacement: MemoryNode;
+}
+export declare function normalizeMemoryPart(value: string): string;
+export declare function findMemoryConflictGroups(memories: MemoryNode[]): MemoryConflictGroup[];
+export declare function findMemoryVersionGroups(memories: MemoryNode[]): MemoryVersionGroup[];
+export declare function hasExplicitUpdateCue(memory: Pick<MemoryNode, "value">): boolean;
+export declare function isBroadTopicMemory(memory: Pick<MemoryNode, "subject" | "predicate">): boolean;
+export declare function getNewestMemoryNode(nodes: MemoryNode[]): MemoryNode | null;
+export declare function compareNewestFirst(left: MemoryNode, right: MemoryNode): number;
+export declare function getSkippedMaintenanceCounts(memories: MemoryNode[]): {
+    skippedDecayed: number;
+    skippedSuperseded: number;
+    skippedForgotten: number;
+};
+//# sourceMappingURL=memoryMaintenance.d.ts.map

package/dist/maintenance/memoryMaintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryMaintenance.d.ts","sourceRoot":"","sources":["../../src/maintenance/memoryMaintenance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CACzB;AAOD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,mBAAmB,EAAE,CAGtF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,kBAAkB,EAAE,CAOpF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,OAAO,CAG/E;AAsCD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,WAAW,CAAC,GAAG,OAAO,CAG7F;AA8CD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,GAAG,IAAI,CAE1E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAK9E;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAMA"}

package/dist/maintenance/memoryMaintenance.js

@@ -0,0 +1,141 @@
+export function normalizeMemoryPart(value) {
+    return value.trim().toLowerCase().replace(/\s+/g, " ");
+}
+export function findMemoryConflictGroups(memories) {
+    return findCompetingMemoryGroups(memories)
+        .filter((group) => !getExplicitReplacement(group.nodes));
+}
+export function findMemoryVersionGroups(memories) {
+    return findCompetingMemoryGroups(memories)
+        .map((group) => {
+        const replacement = getExplicitReplacement(group.nodes);
+        return replacement ? { ...group, replacement } : null;
+    })
+        .filter((group) => group != null);
+}
+export function hasExplicitUpdateCue(memory) {
+    const value = normalizeMemoryPart(memory.value);
+    return UPDATE_CUE_PATTERNS.some((pattern) => pattern.test(value));
+}
+function findCompetingMemoryGroups(memories) {
+    const byFactKey = new Map();
+    for (const memory of memories) {
+        if (memory.decayed || memory.supersededBy != null || memory.forgotten)
+            continue;
+        const grouping = getConflictGrouping(memory);
+        if (!grouping)
+            continue;
+        const key = grouping.key;
+        const group = byFactKey.get(key);
+        const item = {
+            memory,
+            value: grouping.value,
+        };
+        if (group) {
+            group.push(item);
+        }
+        else {
+            byFactKey.set(key, [item]);
+        }
+    }
+    return [...byFactKey.entries()]
+        .filter(([, items]) => new Set(items.map((item) => item.value)).size > 1)
+        .map(([key, items]) => ({
+        key,
+        nodes: items.map((item) => item.memory),
+    }));
+}
+function getExplicitReplacement(nodes) {
+    const newest = getNewestMemoryNode(nodes);
+    return newest && hasExplicitUpdateCue(newest) ? newest : null;
+}
+export function isBroadTopicMemory(memory) {
+    return GENERIC_SUBJECTS.has(normalizeMemoryPart(memory.subject))
+        && GENERIC_PREDICATES.has(normalizeMemoryPart(memory.predicate));
+}
+function getConflictGrouping(memory) {
+    if (isBroadTopicMemory(memory)) {
+        return getBroadTopicConflictGrouping(memory);
+    }
+    return {
+        key: [
+            memory.sessionId,
+            normalizeMemoryPart(memory.subject),
+            normalizeMemoryPart(memory.predicate),
+        ].join("\u0000"),
+        value: normalizeMemoryPart(memory.value),
+    };
+}
+function getBroadTopicConflictGrouping(memory) {
+    const value = normalizeMemoryPart(memory.value);
+    const destination = extractTravelPlanDestination(value);
+    if (!destination)
+        return null;
+    return {
+        key: [memory.sessionId, "broad-topic", "travel-trip-plan"].join("\u0000"),
+        value: destination,
+    };
+}
+function extractTravelPlanDestination(value) {
+    if (!/\b(trip|travel|itinerary|vacation|holiday)\b/.test(value)) {
+        return null;
+    }
+    const destinationPatterns = [
+        /\b(?:to|for|in)\s+([a-z][a-z\s]+?)(?:\s+(?:trip|travel|itinerary|plan|planning|vacation|holiday)\b|$)/,
+        /^([a-z][a-z\s]+?)\s+(?:trip|travel|itinerary|plan|planning|vacation|holiday)\b/,
+    ];
+    for (const pattern of destinationPatterns) {
+        const destination = value.match(pattern)?.[1]?.trim();
+        if (destination)
+            return destination;
+    }
+    return null;
+}
+export function getNewestMemoryNode(nodes) {
+    return [...nodes].sort(compareNewestFirst)[0] ?? null;
+}
+export function compareNewestFirst(left, right) {
+    const timeDelta = right.createdAt.getTime() - left.createdAt.getTime();
+    if (timeDelta !== 0)
+        return timeDelta;
+    return right.id.localeCompare(left.id);
+}
+export function getSkippedMaintenanceCounts(memories) {
+    return {
+        skippedDecayed: memories.filter((memory) => memory.decayed).length,
+        skippedSuperseded: memories.filter((memory) => memory.supersededBy != null).length,
+        skippedForgotten: memories.filter((memory) => memory.forgotten).length,
+    };
+}
+const GENERIC_SUBJECTS = new Set([
+    "conversation",
+    "memory",
+    "plan",
+    "request",
+    "topic",
+    "user",
+]);
+const GENERIC_PREDICATES = new Set([
+    "asked about",
+    "asked_about",
+    "asks about",
+    "asks_about",
+    "discussed",
+    "interested in",
+    "interested_in",
+    "is",
+    "mentioned",
+    "plan",
+    "wants",
+]);
+const UPDATE_CUE_PATTERNS = [
+    /\bactually\b/,
+    /\bchanged to\b/,
+    /\bcorrect(?:ion|ed)?\b/,
+    /\bcurrent(?:ly)?\b/,
+    /\binstead\b/,
+    /\bnow\b/,
+    /\breplace(?:d|s)?\b/,
+    /\bupdated to\b/,
+];
+//# sourceMappingURL=memoryMaintenance.js.map

package/dist/maintenance/memoryMaintenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryMaintenance.js","sourceRoot":"","sources":["../../src/maintenance/memoryMaintenance.ts"],"names":[],"mappings":"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"}

package/dist/maintenance/types.d.ts

@@ -0,0 +1,65 @@
+import type { MemoryEdge, MemoryNode } from "../core/types.js";
+export interface CrawlerConfig {
+    intervalMs?: number;
+    passes?: CrawlerPass[];
+    stopOnPassError?: boolean;
+    store?: CrawlerMaintenanceStore;
+}
+export interface CrawlerPass {
+    name: string;
+    run(context: CrawlerPassContext): Promise<CrawlerPassResult> | CrawlerPassResult;
+}
+export interface CrawlerPassContext {
+    signal?: AbortSignal;
+    store?: CrawlerMaintenanceStore;
+}
+export interface CrawlerPassResult {
+    inspected?: number;
+    annotated?: number;
+    skipped?: number;
+    conflictsDetected?: number;
+    versionsDetected?: number;
+    nodesMarkedConflicting?: number;
+    conflictEdgesCreated?: number;
+    nodesSuperseded?: number;
+    updateEdgesCreated?: number;
+    decayScored?: number;
+    nodesDecayed?: number;
+    minDecayScore?: number;
+    maxDecayScore?: number;
+    skippedAlreadyDecayed?: number;
+    skippedSuperseded?: number;
+    skippedDecayed?: number;
+    skippedForgotten?: number;
+    notes?: string[];
+}
+export interface CrawlerMaintenanceStore {
+    listMemoryNodesForMaintenance(): Promise<MemoryNode[]>;
+    markMemoryNodesConflicting(memoryNodeIds: string[]): Promise<number>;
+    markMemoryNodeSuperseded(memoryNodeId: string, supersededBy: string): Promise<boolean>;
+    markMemoryNodeDecayed(memoryNodeId: string): Promise<boolean>;
+    updateMemoryNodeConfidence?(memoryNodeId: string, confidence: number): Promise<boolean>;
+    upsertMemoryEdge(edge: Pick<MemoryEdge, "sourceId" | "targetId" | "edgeType"> & {
+        weight?: number;
+    }): Promise<boolean>;
+}
+export interface CrawlerPassReport {
+    name: string;
+    ok: boolean;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    result?: CrawlerPassResult;
+    error?: {
+        message: string;
+        stack?: string;
+    };
+}
+export interface CrawlerReport {
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    passes: CrawlerPassReport[];
+    ok: boolean;
+}
+//# sourceMappingURL=types.d.ts.map