contextpro-mcp 0.0.0-stage → 1.4.0

package/build/core/context-metadata.js

@@ -0,0 +1,118 @@
+// Shared repo, freshness, and trust metadata for agent-facing JSON responses
+// FEATURE: Trust envelope — explicit index state, evidence, and confidence
+import { getDB, hashContent } from "./db.js";
+import { stat } from "node:fs/promises";
+import { matchesFileFingerprint, readSourceSnapshot } from "./file-fingerprint.js";
+import { walkDirectory } from "./walker.js";
+import { isSupportedFile } from "./parser.js";
+function parseNumber(value) {
+    if (!value)
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function toIso(timestamp) {
+    return timestamp ? new Date(timestamp).toISOString() : null;
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+export async function getIndexState(rootDir) {
+    const db = await getDB(rootDir);
+    const latestIndexedAt = db.getLatestIndexedAt();
+    const indexedSourceFiles = db.getAllFiles().filter((file) => isSupportedFile(file.path));
+    const indexedFiles = indexedSourceFiles.length;
+    const indexedPaths = new Set(indexedSourceFiles.map((file) => file.path));
+    const entries = await walkDirectory({ rootDir, depthLimit: 0 });
+    const sourceEntries = entries.filter((entry) => !entry.isDirectory && isSupportedFile(entry.path));
+    const sourcePaths = new Set(sourceEntries.map((entry) => entry.relativePath));
+    const missingIndexedFiles = sourceEntries.filter((entry) => !indexedPaths.has(entry.relativePath)).length;
+    const removedIndexedFiles = db.getRemovedFiles(sourcePaths).length;
+    const indexedByPath = new Map(indexedSourceFiles.map(file => [file.path, file]));
+    let changedIndexedFiles = 0;
+    for (const entry of sourceEntries) {
+        const indexed = indexedByPath.get(entry.relativePath);
+        if (!indexed)
+            continue;
+        try {
+            if (matchesFileFingerprint(indexed, await stat(entry.path)))
+                continue;
+            if (hashContent((await readSourceSnapshot(entry.path)).content) !== indexed.content_hash)
+                changedIndexedFiles++;
+        }
+        catch {
+            changedIndexedFiles++;
+        }
+    }
+    const generation = db.getIndexGeneration();
+    const activeStatus = db.getMeta("index_status");
+    const state = activeStatus === "indexing"
+        ? "indexing"
+        : indexedFiles === 0
+            ? "empty"
+            : db.getMeta("index_repair_required") === "1" || generation === 0 || changedIndexedFiles > 0 || missingIndexedFiles > 0 || removedIndexedFiles > 0 || sourceEntries.length !== indexedFiles
+                ? "stale"
+                : "fresh";
+    return {
+        generation,
+        indexedFiles,
+        sourceFiles: sourceEntries.length,
+        missingIndexedFiles,
+        removedIndexedFiles,
+        changedIndexedFiles,
+        lastIndexedAt: toIso(latestIndexedAt),
+        lastReindexAt: toIso(parseNumber(db.getMeta("last_reindex_at"))),
+        lastReindexDurationMs: parseNumber(db.getMeta("last_reindex_duration_ms")),
+        autoHubCount: parseNumber(db.getMeta("last_auto_hub_count")),
+        indexStartedAt: toIso(parseNumber(db.getMeta("index_started_at"))),
+        state,
+    };
+}
+export function buildFreshnessMetadata(indexState, input) {
+    const indexStateLabel = indexState.state === "empty"
+        ? "empty"
+        : indexState.state === "indexing"
+            ? "indexing"
+            : input.complete === false || (input.remainingStaleCount ?? 0) > 0 || indexState.state === "stale"
+                ? "stale"
+                : input.staleCount > 0
+                    ? input.refreshed ? "refreshed" : "stale"
+                    : "fresh";
+    return {
+        staleCount: input.staleCount,
+        refreshed: input.refreshed,
+        warning: input.warning,
+        indexGeneration: indexState.generation,
+        indexedFiles: indexState.indexedFiles,
+        lastIndexedAt: indexState.lastIndexedAt,
+        lastReindexAt: indexState.lastReindexAt,
+        lastReindexDurationMs: indexState.lastReindexDurationMs,
+        autoHubCount: indexState.autoHubCount,
+        indexState: indexStateLabel,
+    };
+}
+export function buildTrustMetadata(input) {
+    const evidence = [...new Set((input.evidence ?? []).filter(Boolean))];
+    const ambiguities = [...new Set((input.ambiguities ?? []).filter(Boolean))];
+    let confidence = input.baseConfidence ?? 0.72;
+    confidence += Math.min(evidence.length, 4) * 0.04;
+    confidence -= Math.min(ambiguities.length, 3) * 0.08;
+    if (input.freshness.indexState === "empty")
+        confidence -= 0.25;
+    if (input.freshness.indexState === "indexing")
+        confidence -= 0.14;
+    if (input.freshness.indexState === "stale")
+        confidence -= 0.18;
+    if (input.freshness.indexState === "refreshed")
+        confidence -= 0.08;
+    if (input.freshness.warning)
+        confidence -= 0.03;
+    return {
+        confidence: clamp(Number(confidence.toFixed(2)), 0.1, 0.99),
+        evidence,
+        ambiguities,
+        freshness: input.freshness,
+        artifact: input.artifact ?? null,
+    };
+}
+//# sourceMappingURL=context-metadata.js.map

package/build/core/context-metadata.js.map

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

package/build/core/data-dir.d.ts

@@ -0,0 +1,5 @@
+export declare const CONTEXTPRO_DIR = ".contextpro";
+export declare const LEGACY_CONTEXT_DIRS: readonly [".contextplus", ".mcp_data"];
+export declare function migrateLegacyProjectData(rootDir: string): Promise<string | null>;
+export declare function ensureContextProDir(rootDir: string): Promise<string | null>;
+//# sourceMappingURL=data-dir.d.ts.map

package/build/core/data-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-dir.d.ts","sourceRoot":"","sources":["../../src/core/data-dir.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,eAAO,MAAM,mBAAmB,wCAAyC,CAAC;AAc1E,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBtF;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKjF"}

package/build/core/data-dir.js

@@ -0,0 +1,53 @@
+// Canonical ContextPro project storage and one-way migration from legacy names.
+import { cp, mkdir, rename, rm, stat } from "fs/promises";
+import { join } from "path";
+import { resolveProjectPath } from "./path-guard.js";
+export const CONTEXTPRO_DIR = ".contextpro";
+export const LEGACY_CONTEXT_DIRS = [".contextplus", ".mcp_data"];
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`[contextpro/data-dir] stat failed for ${path}: ${message}\n`);
+        return false;
+    }
+}
+export async function migrateLegacyProjectData(rootDir) {
+    const destination = resolveProjectPath(rootDir, CONTEXTPRO_DIR);
+    if (await pathExists(destination))
+        return null;
+    for (const legacyName of LEGACY_CONTEXT_DIRS) {
+        const source = resolveProjectPath(rootDir, legacyName);
+        if (!(await pathExists(source)))
+            continue;
+        try {
+            await rename(source, destination);
+        }
+        catch (renameError) {
+            const renameMessage = renameError instanceof Error ? renameError.message : String(renameError);
+            process.stderr.write(`[contextpro/data-dir] rename ${legacyName} → ${CONTEXTPRO_DIR} failed (${renameMessage}); falling back to recursive copy\n`);
+            try {
+                await cp(source, destination, { recursive: true, force: true });
+                await rm(source, { recursive: true, force: true });
+            }
+            catch (copyError) {
+                const copyMessage = copyError instanceof Error ? copyError.message : String(copyError);
+                throw new Error(`Failed to migrate legacy directory ${legacyName} to ${CONTEXTPRO_DIR}: ${copyMessage}`);
+            }
+        }
+        return legacyName;
+    }
+    return null;
+}
+export async function ensureContextProDir(rootDir) {
+    const migratedFrom = await migrateLegacyProjectData(rootDir);
+    await mkdir(resolveProjectPath(rootDir, join(CONTEXTPRO_DIR, "backups")), { recursive: true });
+    await mkdir(resolveProjectPath(rootDir, join(CONTEXTPRO_DIR, "hubs")), { recursive: true });
+    return migratedFrom;
+}
+//# sourceMappingURL=data-dir.js.map

package/build/core/data-dir.js.map

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

package/build/core/db-native.d.ts

@@ -0,0 +1,28 @@
+type DatabaseType = import("better-sqlite3").Database;
+export type BetterSqlite3Constructor = new (path: string, options?: unknown) => DatabaseType;
+export type SqliteVecModule = {
+    load: (db: DatabaseType) => void;
+};
+export interface NativeStorageDiagnostic {
+    code: string;
+    message: string;
+    remediation: string[];
+}
+export interface NativeStorageProbe {
+    ok: boolean;
+    runtime: {
+        nodeVersion: string;
+        nodeAbi: string;
+        execPath: string;
+    };
+    diagnostic?: NativeStorageDiagnostic;
+}
+export declare function describeNativeStorageError(error: unknown): NativeStorageDiagnostic;
+export declare function loadNativeStorageBindings(): {
+    Database: BetterSqlite3Constructor;
+    sqliteVec: SqliteVecModule;
+};
+export declare function ensureNativeStorage(): Promise<void>;
+export declare function probeNativeStorage(): NativeStorageProbe;
+export {};
+//# sourceMappingURL=db-native.d.ts.map

package/build/core/db-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-native.d.ts","sourceRoot":"","sources":["../../src/core/db-native.ts"],"names":[],"mappings":"AAWA,KAAK,YAAY,GAAG,OAAO,gBAAgB,EAAE,QAAQ,CAAC;AACtD,MAAM,MAAM,wBAAwB,GAAG,KAAK,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,YAAY,CAAC;AAC7F,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,CAAC,EAAE,EAAE,YAAY,KAAK,IAAI,CAAA;CAAE,CAAC;AAEnE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC;AAqBD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAelF;AAED,wBAAgB,yBAAyB,IAAI;IAAE,QAAQ,EAAE,wBAAwB,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAmC9G;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMzD;AAED,wBAAgB,kBAAkB,IAAI,kBAAkB,CAiBvD"}

package/build/core/db-native.js

@@ -0,0 +1,120 @@
+// Native SQLite module loader — probes and loads better-sqlite3 and sqlite-vec
+// FEATURE: Isolated bootstrap so DB class stays free of ABI error-handling noise
+import { createRequire } from "module";
+import { existsSync } from "fs";
+import { join } from "path";
+import { getNativeRuntime } from "./native-runtime.js";
+import { attemptNativeAutoRepair, getContextPlusPackageRoot } from "./native-repair.js";
+const requireFromHere = createRequire(import.meta.url);
+let cachedBindings = null;
+function normalizeBetterSqliteModule(candidate) {
+    if (typeof candidate === "function")
+        return candidate;
+    if (candidate && typeof candidate.default === "function") {
+        return candidate.default;
+    }
+    throw new Error("better-sqlite3 did not expose a database constructor.");
+}
+function normalizeSqliteVecModule(candidate) {
+    const maybeModule = candidate && typeof candidate.load === "function"
+        ? candidate
+        : candidate?.default;
+    if (maybeModule && typeof maybeModule.load === "function")
+        return maybeModule;
+    throw new Error("sqlite-vec did not expose a load(db) function.");
+}
+export function describeNativeStorageError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const remediation = [
+        `Run ContextPro doctor --fix with the failing host's Node runtime (${process.execPath}).`,
+        `Repair installs ABI-specific dependencies in the user cache without rebuilding shared node_modules.`,
+        `Restart the MCP host after fixing native dependencies so it respawns the server cleanly.`,
+    ];
+    if (message.includes("Cannot find module") || message.includes("Could not locate the bindings file")) {
+        return { code: "native_module_missing", message, remediation };
+    }
+    if (message.includes("NODE_MODULE_VERSION") || message.includes("compiled against a different Node.js version")) {
+        return { code: "native_module_abi_mismatch", message, remediation };
+    }
+    return { code: "native_module_error", message, remediation };
+}
+export function loadNativeStorageBindings() {
+    if (cachedBindings)
+        return cachedBindings;
+    const candidates = [];
+    try {
+        const { directory } = getNativeRuntime(getContextPlusPackageRoot());
+        if (existsSync(join(directory, "package.json")))
+            candidates.push(() => ({
+                Database: normalizeBetterSqliteModule(requireFromHere(join(directory, "node_modules/better-sqlite3"))),
+                sqliteVec: normalizeSqliteVecModule(requireFromHere(join(directory, "node_modules/sqlite-vec"))),
+            }));
+    }
+    catch { /* A working bundled installation does not need a repair descriptor. */ }
+    candidates.push(() => ({
+        Database: normalizeBetterSqliteModule(requireFromHere("better-sqlite3")),
+        sqliteVec: normalizeSqliteVecModule(requireFromHere("sqlite-vec")),
+    }));
+    let lastError;
+    for (const load of candidates) {
+        try {
+            const bindings = load();
+            // better-sqlite3 loads its addon lazily. Do not cache a constructor until
+            // opening SQLite and loading its vector extension actually succeed.
+            const db = new bindings.Database(":memory:");
+            try {
+                bindings.sqliteVec.load(db);
+                db.prepare("SELECT vec_version()").get();
+            }
+            finally {
+                db.close();
+            }
+            cachedBindings = bindings;
+            return bindings;
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    const diagnostic = describeNativeStorageError(lastError);
+    throw new Error(`ContextPro storage engine is unavailable [${diagnostic.code}]. ` +
+        `Runtime: ${process.execPath} (${process.version}, ABI ${process.versions.modules}). ` +
+        `Automatic repair uses an isolated per-ABI cache; CONTEXTPRO_NATIVE_AUTO_REPAIR=false disables it. ` +
+        `doctor --fix retries explicitly.\n${diagnostic.remediation.map((step) => `  - ${step}`).join("\n")}\n` +
+        `Underlying error: ${diagnostic.message}`);
+}
+export async function ensureNativeStorage() {
+    try {
+        loadNativeStorageBindings();
+    }
+    catch (error) {
+        if (!await attemptNativeAutoRepair(describeNativeStorageError(error).code))
+            throw error;
+        loadNativeStorageBindings();
+    }
+}
+export function probeNativeStorage() {
+    try {
+        const { Database, sqliteVec } = loadNativeStorageBindings();
+        const db = new Database(":memory:");
+        try {
+            sqliteVec.load(db);
+            db.prepare("SELECT 1").get();
+        }
+        finally {
+            db.close();
+        }
+        return {
+            ok: true,
+            runtime: { nodeVersion: process.version, nodeAbi: process.versions.modules ?? "unknown", execPath: process.execPath },
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            runtime: { nodeVersion: process.version, nodeAbi: process.versions.modules ?? "unknown", execPath: process.execPath },
+            diagnostic: describeNativeStorageError(error),
+        };
+    }
+}
+//# sourceMappingURL=db-native.js.map

package/build/core/db-native.js.map

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

package/build/core/db.d.ts

@@ -0,0 +1,294 @@
+export interface FileRow {
+    id: number;
+    path: string;
+    content_hash: string;
+    header: string | null;
+    language: string | null;
+    symbol_count: number;
+    last_indexed_at: number;
+    file_size: number;
+    file_mtime_ms: number;
+    file_ctime_ms: number;
+}
+export interface ToolCallEfficiency {
+    inputTokens?: number;
+    outputTokens?: number;
+    sourceTokens?: number;
+    savedTokens?: number;
+    representedFiles?: number;
+}
+export interface ToolCallHistoryRow {
+    tool: string;
+    status: string;
+    durationMs: number;
+    calledAt: number;
+    inputTokens: number;
+    outputTokens: number;
+    sourceTokens: number;
+    savedTokens: number;
+    representedFiles: number;
+}
+export interface ToolEfficiencyAggregate {
+    tool: string;
+    calls: number;
+    errors: number;
+    avgMs: number;
+    maxMs: number;
+    lastAt: number;
+    inputTokens: number;
+    outputTokens: number;
+    sourceTokens: number;
+    savedTokens: number;
+    representedFiles: number;
+}
+export interface SymbolRow {
+    id: number;
+    file_id: number;
+    name: string;
+    kind: string;
+    line_start: number;
+    line_end: number | null;
+    signature: string | null;
+    parent_symbol_id: number | null;
+}
+export interface ParsedSymbol {
+    name: string;
+    kind: string;
+    lineStart: number;
+    lineEnd?: number;
+    signature?: string;
+    parentSymbolId?: number;
+    /** Index into the same `symbols` array passed to upsertSymbols, resolved to a real row id at insert time. */
+    parentIndex?: number;
+}
+export interface EmbeddingMatch {
+    rowid: number;
+    sourceType: string;
+    sourceId: string;
+    contentHash: string;
+    distance: number;
+}
+export interface MemoryNodeInput {
+    id?: string;
+    type: "concept" | "file" | "symbol" | "note";
+    label: string;
+    content: string;
+    metadata?: Record<string, string>;
+}
+export interface MemoryNodeRow {
+    id: string;
+    type: string;
+    label: string;
+    content: string;
+    created_at: number;
+    last_accessed: number;
+    access_count: number;
+    metadata: string;
+}
+export interface MemoryEdgeInput {
+    id?: string;
+    source: string;
+    target: string;
+    relation: string;
+    weight?: number;
+    metadata?: Record<string, string>;
+}
+export interface MemoryEdgeRow {
+    id: string;
+    source: string;
+    target: string;
+    relation: string;
+    weight: number;
+    created_at: number;
+    metadata: string;
+}
+export interface MemorySearchResult {
+    node: MemoryNodeRow;
+    distance: number;
+}
+export interface TraversalResult {
+    node: MemoryNodeRow;
+    depth: number;
+    pathRelations: string[];
+    relevanceScore: number;
+}
+export interface ImportRow {
+    id: number;
+    source_file_id: number;
+    target_path: string;
+    target_file_id: number | null;
+    import_type: string;
+    symbols_imported: string | null;
+}
+export interface CallSiteRow {
+    id: number;
+    file_id: number;
+    callee: string;
+    line: number;
+    context: string;
+}
+export interface FileTextSearchMatch {
+    path: string;
+    score: number;
+}
+export type { NativeStorageDiagnostic, NativeStorageProbe } from "./db-native.js";
+export { describeNativeStorageError, probeNativeStorage } from "./db-native.js";
+export declare function hashContent(content: string): string;
+export declare function bufferToVec(buf: Buffer): number[];
+export declare class ContextPlusDB {
+    private db;
+    private get vecDimension();
+    private rootDir;
+    constructor(rootDir: string);
+    private initMeta;
+    private runMigrations;
+    private ensureVecTables;
+    private createVecTablesIfNeeded;
+    private ensureVecDimension;
+    recordEmbeddingProvider(provider: string, model: string): void;
+    private recordEmbeddingProviderInTransaction;
+    isEmbeddingsStale(): {
+        stale: boolean;
+        reason: string | null;
+    };
+    clearEmbeddingsStaleFlag(): void;
+    private hasVectorTables;
+    private tableExists;
+    private columnExists;
+    private hasUsableEmbedding;
+    upsertFile(path: string, hash: string, header: string | null, language: string | null, fileSize?: number, fileMtimeMs?: number, fileCtimeMs?: number): number;
+    updateFileFingerprint(path: string, fileSize: number, fileMtimeMs: number, fileCtimeMs?: number, expectedHash?: string): void;
+    getFile(path: string): FileRow | null;
+    getFileById(id: number): FileRow | null;
+    getAllFiles(): FileRow[];
+    getStaleFiles(currentHashes: Map<string, string>): string[];
+    getRemovedFiles(currentPaths: Set<string>): string[];
+    deleteFile(path: string): void;
+    upsertSymbols(fileId: number, symbols: ParsedSymbol[]): void;
+    getSymbolsByFile(fileId: number): SymbolRow[];
+    searchSymbolsByName(query: string): SymbolRow[];
+    upsertEmbedding(sourceType: string, sourceId: number | string, vector: number[] | Float32Array, hash: string): void;
+    upsertEmbeddingsBatch(sourceType: string, entries: Array<{
+        sourceId: string;
+        vector: number[] | Float32Array;
+        hash: string;
+    }>): void;
+    private bumpEmbeddingRevision;
+    getEmbeddingsByType(sourceType: string): Array<{
+        sourceId: string;
+        contentHash: string;
+        vector: Buffer;
+    }>;
+    getEmbeddingStats(): {
+        vectorTablesReady: boolean;
+        dimension: number | null;
+        total: number;
+        fileSearch: number;
+        identifiers: number;
+        memory: number;
+    };
+    deleteEmbeddingsByPrefix(sourceType: string, prefix: string): void;
+    searchEmbeddings(queryVector: number[] | Float32Array, topK: number, sourceType?: string): EmbeddingMatch[];
+    getEmbeddingBySource(sourceType: string, sourceId: number): {
+        vector: Buffer;
+        hash: string;
+    } | null;
+    getEmbeddingHash(sourceType: string, sourceId: number): string | null;
+    getMemoryRevision(): number;
+    private bumpMemoryRevision;
+    upsertMemoryNode(input: MemoryNodeInput, embedding?: number[], model?: {
+        provider: string;
+        model: string;
+    }): string;
+    private upsertMemoryNodeInTransaction;
+    peekMemoryNode(id: string): MemoryNodeRow | null;
+    findMemoryNodeByLabel(type: string, label: string): MemoryNodeRow | null;
+    getMemoryNode(id: string): MemoryNodeRow | null;
+    listMemoryNodes(): MemoryNodeRow[];
+    listMemoryNodesWithoutEmbeddings(): MemoryNodeRow[];
+    setMemoryEmbedding(node: Pick<MemoryNodeRow, "id" | "label" | "content">, embedding: number[]): boolean;
+    deleteMemoryNode(id: string): void;
+    upsertMemoryEdge(input: MemoryEdgeInput): string;
+    deleteMemoryEdge(id: string): void;
+    getMemoryEdgesForNode(id: string): MemoryEdgeRow[];
+    searchMemoryNodes(queryVector: number[], topK?: number): MemorySearchResult[];
+    getNeighbors(nodeId: string, maxDepth?: number, edgeFilter?: string[]): TraversalResult[];
+    pruneStaleEdges(threshold?: number): {
+        edgesRemoved: number;
+        nodesRemoved: number;
+    };
+    ensureGraphFresh(): void;
+    upsertImport(sourceFileId: number, targetPath: string, targetFileId: number | null, importType?: string, symbolsImported?: string[]): void;
+    deleteImportsForFile(fileId: number): void;
+    getImportsFrom(fileId: number): ImportRow[];
+    getImportersOf(fileId: number): ImportRow[];
+    getAllImports(): ImportRow[];
+    updateImportTarget(importId: number, targetFileId: number | null): void;
+    upsertCallSites(fileId: number, sites: Array<{
+        callee: string;
+        line: number;
+        context: string;
+    }>): void;
+    getCallSitesByFile(fileId: number): CallSiteRow[];
+    getCallersOf(callee: string): CallSiteRow[];
+    upsertFileSearchDocument(input: {
+        path: string;
+        header?: string | null;
+        language?: string | null;
+        symbols?: Array<{
+            name: string;
+            kind?: string;
+            signature?: string | null;
+        }>;
+        content?: string;
+    }): void;
+    deleteFileSearchDocument(path: string): void;
+    searchFileText(query: string, topK?: number, phraseOnly?: boolean, requireAllTerms?: boolean): FileTextSearchMatch[];
+    getGraphStats(): {
+        totalNodes: number;
+        totalEdges: number;
+    };
+    /** Append one tool-call event. Best-effort telemetry — callers must not let a
+     * failure here break the tool itself. Prunes opportunistically to a bounded size. */
+    recordToolCall(tool: string, status: "ok" | "error", durationMs: number, calledAt: number, efficiency?: ToolCallEfficiency, sessionId?: string): void;
+    /** Most-recent tool calls, newest first. */
+    getToolCallHistory(limit?: number): ToolCallHistoryRow[];
+    /** Recent calls with a positive savings estimate, optionally bounded by time. */
+    getToolSavingsHistory(limit?: number, sinceMs?: number, sessionId?: string): ToolCallHistoryRow[];
+    /** Per-tool aggregates over the whole history (or since a timestamp). */
+    getToolCallAggregates(sinceMs?: number, sessionId?: string): ToolEfficiencyAggregate[];
+    getEfficiencyTotals(sinceMs?: number, sessionId?: string): Omit<ToolEfficiencyAggregate, "tool" | "avgMs" | "maxMs"> & {
+        avgMs: number;
+        maxMs: number;
+    };
+    getToolCallTotal(): number;
+    /** Keep the table bounded: delete all but the newest `keep` rows. */
+    pruneToolCalls(keep?: number): number;
+    getLatestIndexedAt(): number | null;
+    getIndexGeneration(): number;
+    bumpIndexGeneration(): number;
+    getMeta(key: string): string | null;
+    setMeta(key: string, value: string): void;
+    /**
+     * Atomic compare-and-set on the meta table. Returns true if the previous value matched
+     * `expected` and `next` was written; false otherwise. Both reads and writes happen inside
+     * an IMMEDIATE transaction so concurrent callers cannot race past the guard.
+     */
+    compareAndSetMeta(key: string, expected: string | null, next: string | null, extra?: Array<[string, string]>): boolean;
+    setMetaBatch(entries: Array<[string, string]>): void;
+    close(): void;
+    vacuum(): void;
+    /** Commit a synchronous group of related index writes, or roll them all back. */
+    transaction<T>(operation: () => T): T;
+    /**
+     * Flush the WAL into the main index.db so an on-disk copy of the file is fully
+     * current. Used before seeding a worktree from this base index. TRUNCATE resets
+     * the WAL after checkpointing. Best-effort: a busy checkpoint is non-fatal.
+     */
+    checkpoint(): void;
+}
+/** Checkpoint the base DB (if open) so a file copy captures all committed rows. */
+export declare function checkpointDB(rootDir: string): void;
+export declare function getDB(rootDir: string): Promise<ContextPlusDB>;
+export declare function closeDB(rootDir?: string): void;
+//# sourceMappingURL=db.d.ts.map