@coreyuan/vector-mind 1.0.53 → 1.1.0

package/dist/memory-maintenance/runner.js

@@ -0,0 +1,182 @@
+import { MAINTENANCE_AUTO_ENABLED, MAINTENANCE_CHECKPOINT_WAL, MAINTENANCE_COMPACT_AFTER_DAYS, MAINTENANCE_INTERVAL_HOURS, MAINTENANCE_MAX_INDEX_FILES, MAINTENANCE_MAX_MEMORY_ITEMS, MAINTENANCE_PURGE_HIDDEN_AFTER_DAYS, MAINTENANCE_TOKEN_SAVINGS_RETENTION_DAYS, } from "../config.js";
+import { logActivity } from "../activity-log.js";
+import { compactOldMemoryItems } from "./compaction.js";
+import { getDb, getDbPath, getProjectRoot, hasDb } from "./context.js";
+import { countFilenameNoiseIndexDeletes, countIgnoredIndexDeletes, pruneFilenameNoiseIndexes, pruneIgnoredIndexesByPathPatterns, pruneStaleFileIndexes, } from "./index-prune.js";
+import { pruneMetrics } from "./metrics.js";
+import { prunePendingNoise } from "./pending.js";
+import { purgeHiddenMemory } from "./purge.js";
+import { checkpointWal, getDbSize, kvGet, kvSet, optimizeFts } from "./sqlite.js";
+let autoMaintenanceSuppressionDepth = 0;
+export async function withAutoMaintenanceSuppressed(task) {
+    autoMaintenanceSuppressionDepth += 1;
+    try {
+        return await task();
+    }
+    finally {
+        autoMaintenanceSuppressionDepth -= 1;
+    }
+}
+export function runMemoryMaintenance(args, trigger = "manual") {
+    const dbSizeBefore = getDbSize();
+    const compactedMemory = args.compact_old_memories
+        ? compactOldMemoryItems({
+            dryRun: args.dry_run,
+            compactAfterDays: args.compact_after_days,
+            maxMemoryItems: args.max_memory_items,
+            compactNotes: args.compact_notes,
+        })
+        : {
+            cutoff: new Date(Date.now() - args.compact_after_days * 86_400_000).toISOString(),
+            candidates: 0,
+            compacted: 0,
+            summary_memory_id: null,
+            archived: 0,
+            samples: [],
+        };
+    const ignoredPaths = args.prune_ignored_paths
+        ? args.dry_run
+            ? countIgnoredIndexDeletes()
+            : pruneIgnoredIndexesByPathPatterns()
+        : { chunks_deleted: 0, symbols_deleted: 0 };
+    const filenameNoise = args.prune_filename_noise
+        ? args.dry_run
+            ? countFilenameNoiseIndexDeletes()
+            : pruneFilenameNoiseIndexes()
+        : { chunks_deleted: 0, symbols_deleted: 0 };
+    const staleFiles = args.prune_stale_indexes
+        ? pruneStaleFileIndexes({
+            dryRun: args.dry_run,
+            maxIndexFiles: args.max_index_files,
+            skipReasons: [
+                ...(args.prune_ignored_paths ? ["ignored_path"] : []),
+                ...(args.prune_filename_noise ? ["filename_noise"] : []),
+            ],
+        })
+        : { files_checked: 0, files_matched: 0, chunks_deleted: 0, symbols_deleted: 0, samples: [] };
+    const pendingPruned = args.prune_pending_noise
+        ? prunePendingNoise({ dryRun: args.dry_run })
+        : { ignored_deleted: 0, old_deleted: 0, overflow_deleted: 0 };
+    const purgedHiddenMemory = args.purge_hidden_memories
+        ? purgeHiddenMemory({
+            dryRun: args.dry_run,
+            purgeAfterDays: args.purge_after_days,
+            maxMemoryItems: args.max_memory_items,
+            purgeArchives: args.purge_archives,
+        })
+        : {
+            cutoff: new Date(Date.now() - args.purge_after_days * 86_400_000).toISOString(),
+            memory_candidates: 0,
+            memory_deleted: 0,
+            archive_candidates: 0,
+            archives_deleted: 0,
+            samples: [],
+        };
+    const metricsPruned = args.prune_token_savings
+        ? pruneMetrics({ dryRun: args.dry_run, retentionDays: args.token_savings_retention_days })
+        : {
+            cutoff: new Date(Date.now() - args.token_savings_retention_days * 86_400_000).toISOString(),
+            token_savings_deleted: 0,
+            mcp_tool_metrics_deleted: 0,
+        };
+    const ftsOptimized = args.optimize_fts ? optimizeFts({ dryRun: args.dry_run }) : false;
+    let walCheckpointed = args.checkpoint_wal ? checkpointWal({ dryRun: args.dry_run }) : false;
+    let vacuumed = false;
+    if (!args.dry_run && args.vacuum) {
+        try {
+            getDb().exec("VACUUM");
+            vacuumed = true;
+            if (args.checkpoint_wal)
+                walCheckpointed = checkpointWal({ dryRun: false }) || walCheckpointed;
+        }
+        catch (err) {
+            console.error("[vectormind] maintenance vacuum failed:", err);
+        }
+    }
+    const result = {
+        ok: true,
+        dry_run: args.dry_run,
+        trigger,
+        generated_at: new Date().toISOString(),
+        project_root: getProjectRoot(),
+        db_path: getDbPath(),
+        config: {
+            compact_after_days: args.compact_after_days,
+            max_memory_items: args.max_memory_items,
+            max_index_files: args.max_index_files,
+            compact_notes: args.compact_notes,
+            purge_hidden_after_days: args.purge_after_days,
+            token_savings_retention_days: args.token_savings_retention_days,
+        },
+        compacted_memory: compactedMemory,
+        pruned: {
+            ignored_paths: ignoredPaths,
+            filename_noise: filenameNoise,
+            stale_files: staleFiles,
+        },
+        pending_pruned: pendingPruned,
+        purged_hidden_memory: purgedHiddenMemory,
+        metrics_pruned: metricsPruned,
+        fts_optimized: ftsOptimized,
+        wal_checkpointed: walCheckpointed,
+        vacuumed,
+        db_size_before: dbSizeBefore,
+        db_size_after: getDbSize(),
+    };
+    logActivity("memory_maintenance", {
+        trigger,
+        dry_run: args.dry_run,
+        compacted: result.compacted_memory.compacted,
+        purged_hidden: result.purged_hidden_memory.memory_deleted,
+        purged_archives: result.purged_hidden_memory.archives_deleted,
+        pending_pruned: result.pending_pruned.ignored_deleted +
+            result.pending_pruned.old_deleted +
+            result.pending_pruned.overflow_deleted,
+        stale_files: result.pruned.stale_files.files_matched,
+        chunks_deleted: result.pruned.ignored_paths.chunks_deleted +
+            result.pruned.filename_noise.chunks_deleted +
+            result.pruned.stale_files.chunks_deleted,
+        db_bytes_before: result.db_size_before.total_bytes,
+        db_bytes_after: result.db_size_after.total_bytes,
+    });
+    return result;
+}
+export function runAutoMaintenanceIfDue() {
+    if (autoMaintenanceSuppressionDepth > 0 || !MAINTENANCE_AUTO_ENABLED || !hasDb())
+        return;
+    const lastRaw = kvGet("maintenance.last_auto_at");
+    const last = lastRaw ? Date.parse(lastRaw) : 0;
+    const dueMs = MAINTENANCE_INTERVAL_HOURS * 3_600_000;
+    if (Number.isFinite(last) && last > 0 && Date.now() - last < dueMs)
+        return;
+    try {
+        runMemoryMaintenance({
+            project_root: getProjectRoot(),
+            project_root_mode: "canonical",
+            dry_run: false,
+            format: "compact",
+            compact_old_memories: true,
+            compact_notes: false,
+            prune_stale_indexes: true,
+            prune_ignored_paths: true,
+            prune_filename_noise: true,
+            prune_pending_noise: true,
+            purge_hidden_memories: true,
+            purge_archives: true,
+            prune_token_savings: true,
+            optimize_fts: true,
+            checkpoint_wal: MAINTENANCE_CHECKPOINT_WAL,
+            compact_after_days: MAINTENANCE_COMPACT_AFTER_DAYS,
+            purge_after_days: MAINTENANCE_PURGE_HIDDEN_AFTER_DAYS,
+            max_memory_items: MAINTENANCE_MAX_MEMORY_ITEMS,
+            max_index_files: MAINTENANCE_MAX_INDEX_FILES,
+            token_savings_retention_days: MAINTENANCE_TOKEN_SAVINGS_RETENTION_DAYS,
+            vacuum: false,
+        }, "auto");
+        kvSet("maintenance.last_auto_at", new Date().toISOString());
+    }
+    catch (err) {
+        console.error("[vectormind] auto maintenance failed:", err);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/memory-maintenance/runner.js.map

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

package/dist/memory-maintenance/sqlite.d.ts

@@ -0,0 +1,10 @@
+import type { MaintenanceDbSize } from "./types.js";
+export declare function kvGet(key: string): string | null;
+export declare function kvSet(key: string, value: string): void;
+export declare function getDbSize(): MaintenanceDbSize;
+export declare function optimizeFts(opts: {
+    dryRun: boolean;
+}): boolean;
+export declare function checkpointWal(opts: {
+    dryRun: boolean;
+}): boolean;

package/dist/memory-maintenance/sqlite.js

@@ -0,0 +1,67 @@
+import fs from "node:fs";
+import { MEMORY_ITEMS_FTS_TABLE } from "../memory-recall.js";
+import { getDb, getDbPath, getKvStatement, getSetKvStatement } from "./context.js";
+export function kvGet(key) {
+    try {
+        const row = getKvStatement()?.get(key);
+        return row?.value ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function kvSet(key, value) {
+    try {
+        getSetKvStatement()?.run(key, value);
+    }
+    catch (err) {
+        console.error("[vectormind] kv set failed:", err);
+    }
+}
+function fileSizeOrZero(filePath) {
+    try {
+        return fs.statSync(filePath).size;
+    }
+    catch {
+        return 0;
+    }
+}
+export function getDbSize() {
+    const dbFile = getDbPath();
+    const walFile = `${dbFile}-wal`;
+    const shmFile = `${dbFile}-shm`;
+    const dbBytes = fileSizeOrZero(dbFile);
+    const walBytes = fileSizeOrZero(walFile);
+    const shmBytes = fileSizeOrZero(shmFile);
+    return {
+        db_bytes: dbBytes,
+        wal_bytes: walBytes,
+        shm_bytes: shmBytes,
+        total_bytes: dbBytes + walBytes + shmBytes,
+    };
+}
+export function optimizeFts(opts) {
+    if (opts.dryRun)
+        return false;
+    try {
+        getDb().exec(`INSERT INTO ${MEMORY_ITEMS_FTS_TABLE}(${MEMORY_ITEMS_FTS_TABLE}) VALUES('optimize')`);
+        return true;
+    }
+    catch (err) {
+        console.error("[vectormind] fts optimize failed:", err);
+        return false;
+    }
+}
+export function checkpointWal(opts) {
+    if (opts.dryRun)
+        return false;
+    try {
+        getDb().pragma("wal_checkpoint(TRUNCATE)");
+        return true;
+    }
+    catch (err) {
+        console.error("[vectormind] wal checkpoint failed:", err);
+        return false;
+    }
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/memory-maintenance/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/memory-maintenance/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGnF,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,cAAc,EAAE,EAAE,GAAG,CAAC,GAAG,CAAkC,CAAC;QACxE,OAAO,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AACD,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,KAAa;IAC9C,IAAI,CAAC;QACH,iBAAiB,EAAE,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AACD,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AACD,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,GAAG,MAAM,MAAM,CAAC;IAChC,MAAM,OAAO,GAAG,GAAG,MAAM,MAAM,CAAC;IAChC,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,QAAQ;QACnB,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAyB;IACnD,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,CAAC;QACH,KAAK,EAAE,CAAC,IAAI,CAAC,eAAe,sBAAsB,IAAI,sBAAsB,sBAAsB,CAAC,CAAC;QACpG,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAyB;IACrD,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,CAAC;QACH,KAAK,EAAE,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;QAC1D,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/memory-maintenance/types.d.ts

@@ -0,0 +1,87 @@
+export type MaintenanceIndexPruneResult = {
+    ignored_paths: {
+        chunks_deleted: number;
+        symbols_deleted: number;
+    };
+    filename_noise: {
+        chunks_deleted: number;
+        symbols_deleted: number;
+    };
+    stale_files: {
+        files_checked: number;
+        files_matched: number;
+        chunks_deleted: number;
+        symbols_deleted: number;
+        samples: string[];
+    };
+};
+export type MaintenanceCompactionResult = {
+    cutoff: string;
+    candidates: number;
+    compacted: number;
+    summary_memory_id: number | null;
+    archived: number;
+    samples: Array<{
+        id: number;
+        kind: string;
+        title: string | null;
+        file_path: string | null;
+        updated_at: string;
+    }>;
+};
+export type MaintenancePendingPruneResult = {
+    ignored_deleted: number;
+    old_deleted: number;
+    overflow_deleted: number;
+};
+export type MaintenancePurgeHiddenResult = {
+    cutoff: string;
+    memory_candidates: number;
+    memory_deleted: number;
+    archive_candidates: number;
+    archives_deleted: number;
+    samples: Array<{
+        id: number;
+        kind: string;
+        title: string | null;
+        file_path: string | null;
+        updated_at: string;
+    }>;
+};
+export type MaintenanceMetricsPruneResult = {
+    cutoff: string;
+    token_savings_deleted: number;
+    mcp_tool_metrics_deleted: number;
+};
+export type MaintenanceDbSize = {
+    db_bytes: number;
+    wal_bytes: number;
+    shm_bytes: number;
+    total_bytes: number;
+};
+export type MaintenanceResult = {
+    ok: true;
+    dry_run: boolean;
+    trigger: "manual" | "auto";
+    generated_at: string;
+    project_root: string;
+    db_path: string;
+    config: {
+        compact_after_days: number;
+        max_memory_items: number;
+        max_index_files: number;
+        compact_notes: boolean;
+        purge_hidden_after_days: number;
+        token_savings_retention_days: number;
+    };
+    compacted_memory: MaintenanceCompactionResult;
+    pruned: MaintenanceIndexPruneResult;
+    pending_pruned: MaintenancePendingPruneResult;
+    purged_hidden_memory: MaintenancePurgeHiddenResult;
+    metrics_pruned: MaintenanceMetricsPruneResult;
+    fts_optimized: boolean;
+    wal_checkpointed: boolean;
+    vacuumed: boolean;
+    db_size_before: MaintenanceDbSize;
+    db_size_after: MaintenanceDbSize;
+};

package/dist/memory-maintenance/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory-maintenance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory-maintenance/types.ts"],"names":[],"mappings":""}

package/dist/memory-maintenance.d.ts

@@ -1,80 +1,5 @@
-import Database from "better-sqlite3";
-import type { MaintainMemoryArgs } from "./tool-schemas.js";
-type MemoryMaintenanceContext = {
-    getDb: () => Database.Database | undefined;
-    getProjectRoot: () => string;
-    getDbPath: () => string;
-    getKvStatement: () => Database.Statement | undefined;
-    getSetKvStatement: () => Database.Statement | undefined;
-    getDeleteFileChunkItemsStatement: () => Database.Statement;
-    getDeleteSymbolsForFileStatement: () => Database.Statement;
-    getInsertMemoryItemStatement: () => Database.Statement;
-    sha256Hex: (input: string) => string;
-    parseMetadataJson: (raw: string | null | undefined) => Record<string, unknown>;
-    metadataStatus: (row: {
-        metadata_json: string | null | undefined;
-    }) => string | null;
-    isHiddenFromDefaultRecall: (row: {
-        metadata_json: string | null | undefined;
-    }) => boolean;
-};
-export declare function configureMemoryMaintenance(context: MemoryMaintenanceContext): void;
-export declare function pruneIgnoredIndexesByPathPatterns(): {
-    chunks_deleted: number;
-    symbols_deleted: number;
-};
-export declare function pruneFilenameNoiseIndexes(): {
-    chunks_deleted: number;
-    symbols_deleted: number;
-};
-type MaintenanceIndexPruneResult = {
-    ignored_paths: {
-        chunks_deleted: number;
-        symbols_deleted: number;
-    };
-    filename_noise: {
-        chunks_deleted: number;
-        symbols_deleted: number;
-    };
-    stale_files: {
-        files_checked: number;
-        files_matched: number;
-        chunks_deleted: number;
-        symbols_deleted: number;
-        samples: string[];
-    };
-};
-type MaintenanceCompactionResult = {
-    cutoff: string;
-    candidates: number;
-    compacted: number;
-    summary_memory_id: number | null;
-    archived: number;
-    samples: Array<{
-        id: number;
-        kind: string;
-        title: string | null;
-        file_path: string | null;
-        updated_at: string;
-    }>;
-};
-type MaintenanceResult = {
-    ok: true;
-    dry_run: boolean;
-    trigger: "manual" | "auto";
-    generated_at: string;
-    project_root: string;
-    db_path: string;
-    config: {
-        compact_after_days: number;
-        max_memory_items: number;
-        max_index_files: number;
-        compact_notes: boolean;
-    };
-    compacted_memory: MaintenanceCompactionResult;
-    pruned: MaintenanceIndexPruneResult;
-    vacuumed: boolean;
-};
-export declare function runMemoryMaintenance(args: MaintainMemoryArgs, trigger?: "manual" | "auto"): MaintenanceResult;
-export declare function runAutoMaintenanceIfDue(): void;
-export {};
+export { configureMemoryMaintenance } from "./memory-maintenance/context.js";
+export { pruneFilenameNoiseIndexes, pruneIgnoredIndexesByPathPatterns } from "./memory-maintenance/index-prune.js";
+export { runAutoMaintenanceIfDue, runMemoryMaintenance } from "./memory-maintenance/runner.js";
+export type { MemoryMaintenanceContext } from "./memory-maintenance/context.js";
+export type { MaintenanceResult } from "./memory-maintenance/types.js";