@coreyuan/vector-mind 1.0.49 → 1.0.52

package/dist/tool-handlers/context-recovery.js

@@ -0,0 +1,319 @@
+import { CreateCheckpointArgsSchema, ListCheckpointsArgsSchema, MemoryTimelineArgsSchema, RestoreCheckpointContextArgsSchema, } from "../tool-schemas.js";
+import { flushPendingChangeBuffer } from "../file-indexing.js";
+import { isHiddenFromDefaultRecall, parseMetadataJson, toChangeLogPreview, toMemoryItemPreview, toRequirementPreview } from "../memory-recall.js";
+import { mergePendingWithGit } from "../pending-changes.js";
+import { logActivity } from "../activity-log.js";
+import { oneLine, safeJson, toolJson } from "../tool-output.js";
+import { toolCompactOrJson } from "../token-savings.js";
+function compactTimelineText(data) {
+    const filters = Object.entries(data.basis)
+        .filter(([, v]) => v !== undefined && v !== null && v !== "")
+        .map(([k, v]) => `${k}=${String(v)}`)
+        .join(" ");
+    const lines = [
+        `memory_timeline returned=${data.returned} hidden_skipped=${data.hidden_skipped}${filters ? ` ${filters}` : ""}`,
+    ];
+    for (const item of data.items.slice(0, 100)) {
+        const loc = item.file_path ? ` ${item.file_path}${item.start_line != null ? `:${item.start_line}` : ""}` : "";
+        lines.push(`- ${item.updated_at ?? ""} #${item.id} ${item.kind}${item.title ? ` ${oneLine(item.title, 70)}` : ""}${loc}: ${oneLine(item.preview ?? "", 180)}`);
+    }
+    if (!data.items.length)
+        lines.push("- no timeline items");
+    lines.push("hint: memory_timeline is read-only context evidence; use model judgment when evidence is incomplete");
+    return lines.join("\n");
+}
+function compactCheckpointText(data) {
+    if (data.checkpoints) {
+        const lines = [`checkpoints returned=${data.checkpoints.length}${data.count != null ? ` total_hint=${data.count}` : ""}`];
+        for (const c of data.checkpoints.slice(0, 100)) {
+            lines.push(`- ${c.updated_at ?? ""} #${c.id} ${oneLine(c.title ?? "checkpoint", 80)}: ${oneLine(c.preview ?? "", 180)}`);
+        }
+        if (!data.checkpoints.length)
+            lines.push("- no checkpoints");
+        return lines.join("\n");
+    }
+    const cp = data.checkpoint;
+    const active = data.snapshot?.active_requirement;
+    const pending = Array.isArray(data.snapshot?.pending_changes) ? data.snapshot.pending_changes.length : 0;
+    const recent = Array.isArray(data.snapshot?.recent_memory) ? data.snapshot.recent_memory.length : 0;
+    const decisions = Array.isArray(data.snapshot?.decisions) ? data.snapshot.decisions.length : 0;
+    const lines = [
+        `${data.restored ? "restore_checkpoint_context" : "create_checkpoint"} #${cp?.id ?? ""} ${oneLine(cp?.title ?? "", 100)}`,
+        `active=${active?.id ? `req#${active.id} ${oneLine(active.title ?? "", 80)}` : "none"} decisions=${decisions} recent=${recent} pending=${pending}`,
+    ];
+    if (cp?.preview)
+        lines.push(oneLine(cp.preview, 220));
+    lines.push("hint: checkpoints restore context only; they do not mutate active requirements or override model judgment");
+    return lines.join("\n");
+}
+function getVisibleRecentCoreMemory(db, limit) {
+    if (limit <= 0)
+        return [];
+    const pageSize = 200;
+    const scanCap = 10_000;
+    const stmt = db.prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+     FROM memory_items
+     WHERE kind IN ('requirement', 'change_intent', 'note', 'decision', 'checkpoint', 'memory_compaction', 'project_summary', 'convention')
+     ORDER BY updated_at DESC, id DESC
+     LIMIT ? OFFSET ?`);
+    const visible = [];
+    let offset = 0;
+    while (visible.length < limit && offset < scanCap) {
+        const rows = stmt.all(pageSize, offset);
+        if (!rows.length)
+            break;
+        for (const row of rows) {
+            if (!isHiddenFromDefaultRecall(row))
+                visible.push(row);
+            if (visible.length >= limit)
+                break;
+        }
+        offset += rows.length;
+        if (rows.length < pageSize)
+            break;
+    }
+    return visible.slice(0, limit);
+}
+export async function handleMemoryTimeline(rawArgs, context) {
+    const args = MemoryTimelineArgsSchema.parse(rawArgs);
+    const db = context.getDb();
+    const clauses = [
+        "kind IN ('requirement', 'change_intent', 'note', 'decision', 'checkpoint', 'memory_compaction', 'project_summary', 'convention')",
+    ];
+    const params = [];
+    const anchor = args.memory_id
+        ? context.getStatements().getMemoryItemByIdStmt.get(args.memory_id)
+        : undefined;
+    const reqId = args.req_id ?? anchor?.req_id ?? undefined;
+    const filePath = args.file ? context.normalizeToDbPath(args.file) : anchor?.file_path ?? undefined;
+    const aroundTime = args.around_time ?? anchor?.updated_at ?? undefined;
+    if (args.memory_id && !args.req_id && !args.file && !args.query) {
+        const subClauses = ["id = ?"];
+        params.push(args.memory_id);
+        if (reqId != null) {
+            subClauses.push("req_id = ?");
+            params.push(reqId);
+        }
+        if (filePath) {
+            subClauses.push("file_path = ?");
+            params.push(filePath);
+        }
+        clauses.push(`(${subClauses.join(" OR ")})`);
+    }
+    else {
+        if (reqId != null) {
+            clauses.push("req_id = ?");
+            params.push(reqId);
+        }
+        if (filePath) {
+            clauses.push("file_path = ?");
+            params.push(filePath);
+        }
+    }
+    if (args.query) {
+        const like = `%${context.escapeLike(args.query)}%`;
+        clauses.push("(title LIKE ? ESCAPE '\\' OR content LIKE ? ESCAPE '\\' OR metadata_json LIKE ? ESCAPE '\\')");
+        params.push(like, like, like);
+    }
+    const fetchLimit = Math.min(Math.max(args.window * 4, args.window), 400);
+    const orderBy = aroundTime
+        ? "ORDER BY ABS(strftime('%s', updated_at) - strftime('%s', ?)) ASC, updated_at DESC, id DESC"
+        : "ORDER BY updated_at DESC, id DESC";
+    if (aroundTime)
+        params.push(aroundTime);
+    params.push(fetchLimit);
+    const rows = db
+        .prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+       FROM memory_items
+       WHERE ${clauses.join(" AND ")}
+       ${orderBy}
+       LIMIT ?`)
+        .all(...params);
+    let hiddenSkipped = 0;
+    const visible = rows.filter((row) => {
+        if (args.include_hidden || !isHiddenFromDefaultRecall(row))
+            return true;
+        hiddenSkipped += 1;
+        return false;
+    });
+    const ordered = visible
+        .slice(0, args.window)
+        .sort((a, b) => `${a.updated_at}:${a.id}`.localeCompare(`${b.updated_at}:${b.id}`));
+    const items = ordered.map((row) => toMemoryItemPreview(row, args.include_content, args.preview_chars, args.content_max_chars));
+    const outputValue = {
+        ok: true,
+        basis: {
+            memory_id: args.memory_id ?? null,
+            req_id: reqId ?? null,
+            file: filePath ?? null,
+            query: args.query ?? null,
+            around_time: aroundTime ?? null,
+            window: args.window,
+            include_hidden: args.include_hidden,
+        },
+        returned: items.length,
+        hidden_skipped: hiddenSkipped,
+        items,
+    };
+    logActivity("memory_timeline", {
+        memory_id: args.memory_id ?? null,
+        req_id: reqId ?? null,
+        file: filePath ?? null,
+        query: args.query ?? null,
+        returned: items.length,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: toolCompactOrJson("memory_timeline", outputValue, compactTimelineText(outputValue), args.format),
+            },
+        ],
+    };
+}
+export async function handleCreateCheckpoint(rawArgs, context) {
+    const args = CreateCheckpointArgsSchema.parse(rawArgs);
+    flushPendingChangeBuffer();
+    const db = context.getDb();
+    const { getActiveRequirementStmt, getProjectSummaryStmt, insertMemoryItemStmt, listChangeLogsForRequirementStmt, listCurrentDecisionsStmt, listPendingChangesStmt, } = context.getStatements();
+    const active = getActiveRequirementStmt.get();
+    const projectSummary = getProjectSummaryStmt.get();
+    const decisions = listCurrentDecisionsStmt.all(10)
+        .filter((row) => !isHiddenFromDefaultRecall(row))
+        .map((row) => toMemoryItemPreview(row, false, 180, 1200));
+    const recentRows = getVisibleRecentCoreMemory(db, args.recent_limit)
+        .map((row) => toMemoryItemPreview(row, false, 180, 1200));
+    const pendingRows = listPendingChangesStmt.all();
+    const pending = args.pending_limit > 0
+        ? mergePendingWithGit(pendingRows, { offset: 0, limit: args.pending_limit }).page
+        : [];
+    const recentChanges = active
+        ? listChangeLogsForRequirementStmt.all(active.id, 10).map((row) => toChangeLogPreview(row, false, 180, 1200))
+        : [];
+    const snapshot = {
+        created_at: new Date().toISOString(),
+        advisory_only: true,
+        note: "Checkpoint is context evidence only; it does not mutate active requirements or override model judgment.",
+        active_requirement: active ? toRequirementPreview(active, false, 180, 1200) : null,
+        project_summary: projectSummary ? toMemoryItemPreview(projectSummary, false, 180, 1200) : null,
+        decisions,
+        recent_memory: recentRows,
+        recent_changes: recentChanges,
+        pending_changes: pending,
+    };
+    const summary = args.summary.trim();
+    const content = [
+        args.title,
+        summary ? `Summary: ${summary}` : "",
+        active ? `Active requirement: #${active.id} ${active.title}` : "Active requirement: none",
+        `Decisions: ${decisions.map((d) => d.title ?? `#${d.id}`).join(", ") || "none"}`,
+        `Pending: ${pending.map((p) => p.file_path).join(", ") || "none"}`,
+    ]
+        .filter(Boolean)
+        .join("\n");
+    const meta = {
+        status: "current",
+        type: "checkpoint",
+        advisory_only: true,
+        snapshot,
+    };
+    const info = insertMemoryItemStmt.run("checkpoint", args.title, content, null, null, null, active?.id ?? null, safeJson(meta), context.sha256Hex(`${args.title}\n${content}\n${JSON.stringify(snapshot)}`));
+    const checkpointId = Number(info.lastInsertRowid);
+    const checkpoint = context.getStatements().getMemoryItemByIdStmt.get(checkpointId);
+    const checkpointPreview = toMemoryItemPreview(checkpoint, false, 180, 1200);
+    const outputValue = {
+        ok: true,
+        checkpoint: checkpointPreview,
+        snapshot,
+    };
+    logActivity("create_checkpoint", {
+        checkpoint_id: checkpointId,
+        title: args.title,
+        active_requirement_id: active?.id ?? null,
+        pending: pending.length,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: toolCompactOrJson("create_checkpoint", outputValue, compactCheckpointText(outputValue), args.format),
+            },
+        ],
+    };
+}
+export async function handleListCheckpoints(rawArgs, context) {
+    const args = ListCheckpointsArgsSchema.parse(rawArgs);
+    const db = context.getDb();
+    const rows = db
+        .prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+       FROM memory_items
+       WHERE kind = 'checkpoint'
+       ORDER BY updated_at DESC, id DESC
+       LIMIT ? OFFSET ?`)
+        .all(args.limit, args.offset);
+    const checkpoints = rows.map((row) => toMemoryItemPreview(row, args.include_content, args.preview_chars, args.content_max_chars));
+    const outputValue = {
+        ok: true,
+        offset: args.offset,
+        limit: args.limit,
+        checkpoints,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: toolCompactOrJson("list_checkpoints", outputValue, compactCheckpointText(outputValue), args.format),
+            },
+        ],
+    };
+}
+export async function handleRestoreCheckpointContext(rawArgs, context) {
+    const args = RestoreCheckpointContextArgsSchema.parse(rawArgs);
+    const db = context.getDb();
+    const params = [];
+    const clauses = ["kind = 'checkpoint'"];
+    if (args.checkpoint_id) {
+        clauses.push("id = ?");
+        params.push(args.checkpoint_id);
+    }
+    if (args.title) {
+        clauses.push("title = ?");
+        params.push(args.title);
+    }
+    const row = db
+        .prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+       FROM memory_items
+       WHERE ${clauses.join(" AND ")}
+       ORDER BY updated_at DESC, id DESC
+       LIMIT 1`)
+        .get(...params);
+    if (!row) {
+        return {
+            isError: true,
+            content: [{ type: "text", text: toolJson({ ok: false, error: "checkpoint not found" }) }],
+        };
+    }
+    const meta = parseMetadataJson(row.metadata_json);
+    const snapshot = (meta.snapshot && typeof meta.snapshot === "object" ? meta.snapshot : {});
+    const checkpoint = toMemoryItemPreview(row, args.include_content, args.preview_chars, args.content_max_chars);
+    const outputValue = {
+        ok: true,
+        restored: true,
+        read_only: true,
+        checkpoint,
+        snapshot,
+    };
+    logActivity("restore_checkpoint_context", {
+        checkpoint_id: row.id,
+        title: row.title,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: toolCompactOrJson("restore_checkpoint_context", outputValue, compactCheckpointText(outputValue), args.format),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=context-recovery.js.map

package/dist/tool-handlers/context-recovery.js.map

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

package/dist/tool-handlers/context.d.ts

@@ -0,0 +1,34 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type Database from "better-sqlite3";
+import type { ExtractedSymbol, RootSource } from "../types.js";
+export type ToolStatements = Record<string, Database.Statement>;
+export type ProjectContextAdvisory = {
+    code: "cross_project_reference";
+    severity: "info";
+    advisory_only: true;
+    previous_project_root: string;
+    current_project_root: string;
+    external_reference: true;
+    read_only_reference: true;
+    not_current_requirement_scope: true;
+    message: string;
+};
+export type ToolHandlerContext = {
+    ensureInitializedForArgs: (rawArgs: Record<string, unknown>) => Promise<void>;
+    consumeProjectContextAdvisory: () => ProjectContextAdvisory | null;
+    getDb: () => Database.Database;
+    getProjectRoot: () => string;
+    getRootSource: () => RootSource;
+    getDbPath: () => string;
+    isWatcherEnabled: () => boolean;
+    isWatcherReady: () => boolean;
+    isFtsAvailable: () => boolean;
+    ftsTableName: string;
+    getIndexFileSymbolsTx: () => ((filePath: string, symbols: ExtractedSymbol[]) => void) | null;
+    getStatements: () => ToolStatements;
+    normalizeToDbPath: (inputPath: string) => string;
+    sha256Hex: (input: string) => string;
+    escapeLike: (pattern: string) => string;
+    getFileStateHash: (dbOrAbsPath: string) => string | null;
+};
+export type ToolHandler = (rawArgs: Record<string, unknown>, context: ToolHandlerContext) => CallToolResult | Promise<CallToolResult>;

package/dist/tool-handlers/context.js

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

package/dist/tool-handlers/context.js.map

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

package/dist/tool-handlers/diagnostics.d.ts

@@ -0,0 +1,8 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { ToolHandlerContext } from "./context.js";
+export declare function handleGetActivityLog(rawArgs: Record<string, unknown>, _context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleGetActivitySummary(rawArgs: Record<string, unknown>, _context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleClearActivityLog(rawArgs: Record<string, unknown>, _context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleDetectRtk(rawArgs: Record<string, unknown>, _context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleInstallRtk(rawArgs: Record<string, unknown>, _context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleGetTokenSavings(rawArgs: Record<string, unknown>, _context: ToolHandlerContext): Promise<CallToolResult>;

package/dist/tool-handlers/diagnostics.js

@@ -0,0 +1,114 @@
+import { debugLogEnabled, debugLogMaxEntries } from "../config.js";
+import { ClearActivityLogArgsSchema, DetectRtkArgsSchema, GetActivityLogArgsSchema, GetActivitySummaryArgsSchema, GetTokenSavingsArgsSchema, InstallRtkArgsSchema } from "../tool-schemas.js";
+import { compactInstallRtkText, detectRtk, installRtk } from "../rtk-tools.js";
+import { tokenSavingsSummary } from "../token-savings.js";
+import { flushPendingChangeBuffer } from "../file-indexing.js";
+import { clearActivityLog, snapshotActivityLog, summarizeActivityEvent } from "../activity-log.js";
+import { compactTokenSavingsText, toolJson } from "../tool-output.js";
+export async function handleGetActivityLog(rawArgs, _context) {
+    const args = GetActivityLogArgsSchema.parse(rawArgs);
+    flushPendingChangeBuffer();
+    const { events, last_id } = snapshotActivityLog({ sinceId: args.since_id, limit: args.limit });
+    const outEvents = args.verbose
+        ? events
+        : events.map((e) => ({ id: e.id, ts: e.ts, type: e.type, summary: summarizeActivityEvent(e) }));
+    return {
+        content: [
+            {
+                type: "text",
+                text: toolJson({
+                    ok: true,
+                    enabled: debugLogEnabled,
+                    max_entries: debugLogMaxEntries,
+                    last_id,
+                    events: outEvents,
+                }),
+            },
+        ],
+    };
+}
+export async function handleGetActivitySummary(rawArgs, _context) {
+    const args = GetActivitySummaryArgsSchema.parse(rawArgs);
+    flushPendingChangeBuffer();
+    const { events, last_id } = snapshotActivityLog({ sinceId: args.since_id, limit: 500 });
+    const counts = {};
+    const indexedFiles = new Set();
+    let semanticCount = 0;
+    let queryCodebaseCount = 0;
+    let pendingFlushes = 0;
+    let pendingPrunes = 0;
+    let lastSemantic = null;
+    let lastQueryCodebase = null;
+    for (const e of events) {
+        counts[e.type] = (counts[e.type] ?? 0) + 1;
+        if (e.type === "index_file") {
+            const fp = String(e.data.file_path ?? "");
+            if (fp)
+                indexedFiles.add(fp);
+        }
+        if (e.type === "semantic_search") {
+            semanticCount += 1;
+            lastSemantic = e.data;
+        }
+        if (e.type === "query_codebase") {
+            queryCodebaseCount += 1;
+            lastQueryCodebase = e.data;
+        }
+        if (e.type === "pending_flush")
+            pendingFlushes += 1;
+        if (e.type === "pending_prune")
+            pendingPrunes += 1;
+    }
+    const sampleFiles = Array.from(indexedFiles).slice(0, args.max_files);
+    return {
+        content: [
+            {
+                type: "text",
+                text: toolJson({
+                    ok: true,
+                    enabled: debugLogEnabled,
+                    last_id,
+                    since_id: args.since_id,
+                    counts,
+                    indexed_files: { unique: indexedFiles.size, sample: sampleFiles },
+                    searches: {
+                        semantic_search: { count: semanticCount, last: lastSemantic },
+                        query_codebase: { count: queryCodebaseCount, last: lastQueryCodebase },
+                    },
+                    pending: { flushes: pendingFlushes, prunes: pendingPrunes },
+                }),
+            },
+        ],
+    };
+}
+export async function handleClearActivityLog(rawArgs, _context) {
+    ClearActivityLogArgsSchema.parse(rawArgs);
+    clearActivityLog();
+    return { content: [{ type: "text", text: toolJson({ ok: true }) }] };
+}
+export async function handleDetectRtk(rawArgs, _context) {
+    DetectRtkArgsSchema.parse(rawArgs);
+    const result = detectRtk();
+    const text = result.available
+        ? `rtk available: ${result.version ?? result.command}\ncommand=${result.command} source=${result.source ?? "unknown"} gain_ok=${result.gain_ok ?? false}${result.path ? ` path=${result.path}` : ""}\n${result.note}`
+        : `rtk unavailable: ${result.command}\nsource=${result.source ?? "none"} gain_ok=${result.gain_ok ?? false}${result.version ? ` version=${result.version}` : ""}${result.path ? ` path=${result.path}` : ""}\n${result.note}`;
+    return { content: [{ type: "text", text }] };
+}
+export async function handleInstallRtk(rawArgs, _context) {
+    const args = InstallRtkArgsSchema.parse(rawArgs);
+    const result = installRtk(args);
+    return { content: [{ type: "text", text: compactInstallRtkText(result) }] };
+}
+export async function handleGetTokenSavings(rawArgs, _context) {
+    const args = GetTokenSavingsArgsSchema.parse(rawArgs);
+    const result = tokenSavingsSummary(args.limit);
+    return {
+        content: [
+            {
+                type: "text",
+                text: args.format === "json" ? toolJson(result) : compactTokenSavingsText(result),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/tool-handlers/diagnostics.js.map

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

package/dist/tool-handlers/files.d.ts

@@ -0,0 +1,8 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { ToolHandlerContext } from "./context.js";
+export declare function handleGrep(rawArgs: Record<string, unknown>, context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleListProjectFiles(rawArgs: Record<string, unknown>, context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleReadFileText(rawArgs: Record<string, unknown>, context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleReadCodexTextFile(rawArgs: Record<string, unknown>, _context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleReadFileLines(rawArgs: Record<string, unknown>, context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleQueryCodebase(rawArgs: Record<string, unknown>, context: ToolHandlerContext): Promise<CallToolResult>;