trace-mcp 1.4.1 → 1.5.3

package/dist/index.d.ts

@@ -234,161 +234,8 @@ interface ResolveContext {
     readFile(relPath: string): string | undefined;
 }
 
-declare class Store {
-    readonly db: Database.Database;
-    constructor(db: Database.Database);
-    private readonly _stmts;
-    insertFile(path: string, language: string | null, contentHash: string | null, byteLength: number | null, workspace?: string | null, mtimeMs?: number | null): number;
-    getFile(path: string): FileRow | undefined;
-    getFileById(id: number): FileRow | undefined;
-    getAllFiles(): FileRow[];
-    updateFileWorkspace(fileId: number, workspace: string): void;
-    getFilesByWorkspace(workspace: string): FileRow[];
-    updateFileHash(fileId: number, hash: string, byteLength: number, mtimeMs?: number | null): void;
-    updateFileStatus(fileId: number, status: string, frameworkRole?: string): void;
-    updateFileGitignored(fileId: number, gitignored: boolean): void;
-    deleteFile(fileId: number): void;
-    /** Delete routes, components, migrations, ORM models, and RN screens for a file (and their nodes). */
-    deleteEntitiesByFile(fileId: number): void;
-    insertSymbol(fileId: number, sym: RawSymbol, parentIdOverride?: number | null): number;
-    insertSymbols(fileId: number, symbols: RawSymbol[]): number[];
-    deleteSymbolsByFile(fileId: number): void;
-    getSymbolsByFile(fileId: number): SymbolRow[];
-    getSymbolBySymbolId(symbolId: string): SymbolRow | undefined;
-    getSymbolByFqn(fqn: string): SymbolRow | undefined;
-    createNode(nodeType: string, refId: number): number;
-    getNodeId(nodeType: string, refId: number): number | undefined;
-    insertEdge(sourceNodeId: number, targetNodeId: number, edgeTypeName: string, resolved?: boolean, metadata?: Record<string, unknown>, isCrossWs?: boolean): TraceMcpResult<number>;
-    deleteEdgesForFileNodes(fileId: number): void;
-    /** Delete outgoing import edges from a file node — used by fast-path re-indexing
-     *  to clear stale specifiers before re-inserting consolidated imports. */
-    deleteOutgoingImportEdges(fileId: number): void;
-    /** Delete only outgoing edges from a file's nodes — used by incremental indexing
-     *  to preserve incoming edges (e.g. imports from other files into this file). */
-    deleteOutgoingEdgesForFileNodes(fileId: number): void;
-    traverseEdges(startNodeId: number, direction: 'outgoing' | 'incoming', depth: number): EdgeRow[];
-    insertRoute(route: RawRoute, fileId: number): number;
-    insertComponent(comp: RawComponent, fileId: number): number;
-    getComponentByFileId(fileId: number): ComponentRow | undefined;
-    getComponentByName(name: string): ComponentRow | undefined;
-    getAllComponents(): ComponentRow[];
-    /** Ensure an edge type exists in the database, inserting if missing. */
-    ensureEdgeType(name: string, category: string, description: string): void;
-    /** Get the edge type name by its id */
-    getEdgeTypeName(edgeTypeId: number): string | undefined;
-    /** Reverse-lookup: find which symbol/file a node refers to */
-    getNodeRef(nodeId: number): {
-        nodeType: string;
-        refId: number;
-    } | undefined;
-    insertMigration(mig: RawMigration, fileId: number): number;
-    getRouteByUriAndMethod(uri: string, method: string): RouteRow | undefined;
-    getAllRoutes(): RouteRow[];
-    findRouteByPattern(uri: string, method: string): RouteRow | undefined;
-    getMigrationsByTable(tableName: string): MigrationRow[];
-    getAllMigrations(): MigrationRow[];
-    getEdgesByType(edgeTypeName: string): EdgeRow[];
-    getOutgoingEdges(nodeId: number): (EdgeRow & {
-        edge_type_name: string;
-    })[];
-    getIncomingEdges(nodeId: number): (EdgeRow & {
-        edge_type_name: string;
-    })[];
-    insertOrmModel(model: RawOrmModel, fileId: number): number;
-    getOrmModelByName(name: string): OrmModelRow | undefined;
-    getOrmModelsByOrm(orm: string): OrmModelRow[];
-    getAllOrmModels(): OrmModelRow[];
-    insertOrmAssociation(sourceModelId: number, targetModelId: number | null, targetModelName: string, kind: string, options?: Record<string, unknown>, fileId?: number, line?: number): number;
-    getAllOrmAssociations(fileIds?: number[]): OrmAssociationRow[];
-    getOrmAssociationsByModel(modelId: number): OrmAssociationRow[];
-    insertRnScreen(screen: RawRnScreen, fileId: number): number;
-    getRnScreenByName(name: string): RnScreenRow | undefined;
-    getAllRnScreens(): RnScreenRow[];
-    getSymbolById(id: number): SymbolRow | undefined;
-    getNodeByNodeId(nodeId: number): {
-        node_type: string;
-        ref_id: number;
-    } | undefined;
-    findImplementors(name: string): SymbolWithFilePath[];
-    getExportedSymbols(filePattern?: string): SymbolWithFilePath[];
-    getEdgeTypes(): EdgeTypeRow[];
-    /**
-     * Get all symbols that have heritage metadata (extends/implements).
-     * Used by the TypeScript heritage resolver in the pipeline.
-     */
-    getSymbolsWithHeritage(fileIds?: number[]): (SymbolRow & {
-        file_path: string;
-    })[];
-    /**
-     * Find a symbol by name and optional kind.
-     * Returns the first match (prefers exact name match over substring).
-     */
-    getSymbolByName(name: string, kind?: string): SymbolRow | undefined;
-    /** Resolve multiple node IDs in one query. Returns Map<refId, nodeId>. */
-    getNodeIdsBatch(nodeType: string, refIds: number[]): Map<number, number>;
-    /** Resolve multiple node refs in one query. Returns Map<nodeId, {nodeType, refId}>. */
-    getNodeRefsBatch(nodeIds: number[]): Map<number, {
-        nodeType: string;
-        refId: number;
-    }>;
-    /** Batch-fetch symbols by internal IDs. Returns Map<id, SymbolRow>. */
-    getSymbolsByIds(ids: number[]): Map<number, SymbolRow>;
-    /** Batch-fetch files by internal IDs. Returns Map<id, FileRow>. */
-    getFilesByIds(ids: number[]): Map<number, FileRow>;
-    /**
-     * Fetch all edges where any of the given node IDs appear as source or target.
-     * Returns edges annotated with edge_type_name and the pivot node id (the one from the input set).
-     */
-    getEdgesForNodesBatch(nodeIds: number[]): Array<EdgeRow & {
-        edge_type_name: string;
-        pivot_node_id: number;
-    }>;
-    /** Find a class/interface symbol by name with optional framework_role filter. Single query with JOIN. */
-    findSymbolByRole(name: string, frameworkRole?: string): SymbolRow | undefined;
-    insertEnvVar(fileId: number, entry: {
-        key: string;
-        valueType: string;
-        valueFormat: string | null;
-        comment: string | null;
-        quoted: boolean;
-        line: number;
-    }): number;
-    deleteEnvVarsByFile(fileId: number): void;
-    getEnvVarsByFile(fileId: number): EnvVarRow[];
-    getAllEnvVars(): (EnvVarRow & {
-        file_path: string;
-    })[];
-    searchEnvVars(pattern: string): (EnvVarRow & {
-        file_path: string;
-    })[];
-    updateSymbolSummary(symbolId: number, summary: string): void;
-    getUnsummarizedSymbols(kinds: string[], limit: number): {
-        id: number;
-        name: string;
-        fqn: string | null;
-        kind: string;
-        signature: string | null;
-        file_path: string;
-        byte_start: number;
-        byte_end: number;
-    }[];
-    /** Get all distinct workspaces with file/symbol counts. */
-    getWorkspaceStats(): WorkspaceStats[];
-    /** Get all cross-workspace edges with resolved source/target workspace info. */
-    getCrossWorkspaceEdges(): CrossWorkspaceEdge[];
-    /** Get workspace dependency summary: which workspaces depend on which. */
-    getWorkspaceDependencyGraph(): WorkspaceDependency[];
-    /** Get symbols in a workspace that are used by other workspaces (public API surface). */
-    getWorkspaceExports(workspace: string): SymbolWithFilePath[];
-    getStats(): IndexStats;
-    insertGraphSnapshot(snapshotType: string, data: Record<string, unknown>, commitHash?: string, filePath?: string): number;
-    getGraphSnapshots(snapshotType: string, options?: {
-        filePath?: string;
-        since?: string;
-        limit?: number;
-    }): GraphSnapshotRow[];
-    pruneGraphSnapshots(maxAge?: number): number;
-}
+/** Row type interfaces for all database tables.
+ *  Extracted from store.ts to break circular dependencies between Store and repository classes. */
 interface FileRow {
     id: number;
     path: string;
@@ -490,7 +337,7 @@ interface RnScreenRow {
     deep_link: string | null;
     metadata: string | null;
 }
-interface EnvVarRow {
+interface EnvVarRow$1 {
     id: number;
     file_id: number;
     key: string;
@@ -503,11 +350,186 @@ interface EnvVarRow {
 interface SymbolWithFilePath extends SymbolRow {
     file_path: string;
 }
+interface EdgeTypeRow$1 {
+    name: string;
+    category: string;
+    description: string;
+}
+interface IndexStats {
+    totalFiles: number;
+    totalSymbols: number;
+    totalEdges: number;
+    totalNodes: number;
+    totalRoutes: number;
+    totalComponents: number;
+    totalMigrations: number;
+    partialFiles: number;
+    errorFiles: number;
+}
+interface GraphSnapshotRow$1 {
+    id: number;
+    commit_hash: string | null;
+    created_at: string;
+    snapshot_type: string;
+    file_path: string | null;
+    data: string;
+}
+interface WorkspaceStats$1 {
+    workspace: string;
+    file_count: number;
+    symbol_count: number;
+    languages: string | null;
+}
+interface CrossWorkspaceEdge$1 {
+    id: number;
+    edge_type: string;
+    source_workspace: string | null;
+    source_path: string | null;
+    source_symbol: string | null;
+    source_kind: string | null;
+    target_workspace: string | null;
+    target_path: string | null;
+    target_symbol: string | null;
+    target_kind: string | null;
+}
+interface WorkspaceDependency$1 {
+    from_workspace: string;
+    to_workspace: string;
+    edge_count: number;
+    edge_types: string;
+}
+
+declare class FileRepository {
+    private readonly db;
+    private readonly _stmts;
+    constructor(db: Database.Database);
+    insertFile(path: string, language: string | null, contentHash: string | null, byteLength: number | null, workspace: string | null, mtimeMs: number | null, createNode: (nodeType: string, refId: number) => number): number;
+    getFile(path: string): FileRow | undefined;
+    getFileById(id: number): FileRow | undefined;
+    getAllFiles(): FileRow[];
+    updateFileWorkspace(fileId: number, workspace: string): void;
+    getFilesByWorkspace(workspace: string): FileRow[];
+    updateFileHash(fileId: number, hash: string, byteLength: number, mtimeMs: number | null): void;
+    updateFileStatus(fileId: number, status: string, frameworkRole: string | null): void;
+    updateFileGitignored(fileId: number, gitignored: boolean): void;
+    deleteFile(fileId: number, deleteEdgesForFileNodes: (fileId: number) => void, deleteEntitiesByFile: (fileId: number) => void): void;
+    deleteEntitiesByFile(fileId: number): void;
+    getFilesByIds(ids: number[]): Map<number, FileRow>;
+}
+
+declare class SymbolRepository {
+    private readonly db;
+    private readonly _stmts;
+    constructor(db: Database.Database);
+    insertSymbol(fileId: number, sym: RawSymbol, parentIdOverride: number | null | undefined, createNode: (nodeType: string, refId: number) => number): number;
+    insertSymbols(fileId: number, symbols: RawSymbol[], insertSymbolFn: (fileId: number, sym: RawSymbol, parentIdOverride?: number | null) => number): number[];
+    deleteSymbolsByFile(fileId: number): void;
+    getSymbolsByFile(fileId: number): SymbolRow[];
+    getSymbolBySymbolId(symbolId: string): SymbolRow | undefined;
+    getSymbolByFqn(fqn: string): SymbolRow | undefined;
+    getSymbolById(id: number): SymbolRow | undefined;
+    getSymbolByName(name: string, kind?: string): SymbolRow | undefined;
+    getExportedSymbols(filePattern?: string): SymbolWithFilePath[];
+    findImplementors(name: string): SymbolWithFilePath[];
+    getSymbolsWithHeritage(fileIds?: number[]): (SymbolRow & {
+        file_path: string;
+    })[];
+    getSymbolsByIds(ids: number[]): Map<number, SymbolRow>;
+    findSymbolByRole(name: string, frameworkRole?: string): SymbolRow | undefined;
+    updateSymbolSummary(symbolId: number, summary: string): void;
+    getUnsummarizedSymbols(kinds: string[], limit: number): {
+        id: number;
+        name: string;
+        fqn: string | null;
+        kind: string;
+        signature: string | null;
+        file_path: string;
+        byte_start: number;
+        byte_end: number;
+    }[];
+}
+
 interface EdgeTypeRow {
     name: string;
     category: string;
     description: string;
 }
+declare class GraphRepository {
+    private readonly db;
+    private readonly _stmts;
+    constructor(db: Database.Database);
+    createNode(nodeType: string, refId: number): number;
+    getNodeId(nodeType: string, refId: number): number | undefined;
+    insertEdge(sourceNodeId: number, targetNodeId: number, edgeTypeName: string, resolved?: boolean, metadata?: Record<string, unknown>, isCrossWs?: boolean): TraceMcpResult<number>;
+    deleteEdgesForFileNodes(fileId: number): void;
+    deleteOutgoingImportEdges(fileId: number): void;
+    deleteOutgoingEdgesForFileNodes(fileId: number): void;
+    traverseEdges(startNodeId: number, direction: 'outgoing' | 'incoming', depth: number): EdgeRow[];
+    getEdgesByType(edgeTypeName: string): EdgeRow[];
+    getOutgoingEdges(nodeId: number): (EdgeRow & {
+        edge_type_name: string;
+    })[];
+    getIncomingEdges(nodeId: number): (EdgeRow & {
+        edge_type_name: string;
+    })[];
+    ensureEdgeType(name: string, category: string, description: string): void;
+    getEdgeTypeName(edgeTypeId: number): string | undefined;
+    getNodeRef(nodeId: number): {
+        nodeType: string;
+        refId: number;
+    } | undefined;
+    getNodeByNodeId(nodeId: number): {
+        node_type: string;
+        ref_id: number;
+    } | undefined;
+    getNodeIdsBatch(nodeType: string, refIds: number[]): Map<number, number>;
+    getNodeRefsBatch(nodeIds: number[]): Map<number, {
+        nodeType: string;
+        refId: number;
+    }>;
+    getEdgesForNodesBatch(nodeIds: number[]): Array<EdgeRow & {
+        edge_type_name: string;
+        pivot_node_id: number;
+    }>;
+    getEdgeTypes(): EdgeTypeRow[];
+}
+
+declare class DomainRepository {
+    private readonly db;
+    constructor(db: Database.Database);
+    insertRoute(route: RawRoute, fileId: number, createNode: (nodeType: string, refId: number) => number): number;
+    getRouteByUriAndMethod(uri: string, method: string): RouteRow | undefined;
+    getAllRoutes(): RouteRow[];
+    findRouteByPattern(uri: string, method: string): RouteRow | undefined;
+    insertComponent(comp: RawComponent, fileId: number, createNode: (nodeType: string, refId: number) => number): number;
+    getComponentByFileId(fileId: number): ComponentRow | undefined;
+    getComponentByName(name: string): ComponentRow | undefined;
+    getAllComponents(): ComponentRow[];
+    insertMigration(mig: RawMigration, fileId: number, createNode: (nodeType: string, refId: number) => number): number;
+    getMigrationsByTable(tableName: string): MigrationRow[];
+    getAllMigrations(): MigrationRow[];
+    insertOrmModel(model: RawOrmModel, fileId: number, createNode: (nodeType: string, refId: number) => number): number;
+    getOrmModelByName(name: string): OrmModelRow | undefined;
+    getOrmModelsByOrm(orm: string): OrmModelRow[];
+    getAllOrmModels(): OrmModelRow[];
+    insertOrmAssociation(sourceModelId: number, targetModelId: number | null, targetModelName: string, kind: string, options?: Record<string, unknown>, fileId?: number, line?: number): number;
+    getAllOrmAssociations(fileIds?: number[]): OrmAssociationRow[];
+    getOrmAssociationsByModel(modelId: number): OrmAssociationRow[];
+    insertRnScreen(screen: RawRnScreen, fileId: number, createNode: (nodeType: string, refId: number) => number): number;
+    getRnScreenByName(name: string): RnScreenRow | undefined;
+    getAllRnScreens(): RnScreenRow[];
+}
+
+interface EnvVarRow {
+    id: number;
+    file_id: number;
+    key: string;
+    value_type: string;
+    value_format: string | null;
+    comment: string | null;
+    quoted: number;
+    line: number | null;
+}
 interface WorkspaceStats {
     workspace: string;
     file_count: number;
@@ -532,17 +554,6 @@ interface WorkspaceDependency {
     edge_count: number;
     edge_types: string;
 }
-interface IndexStats {
-    totalFiles: number;
-    totalSymbols: number;
-    totalEdges: number;
-    totalNodes: number;
-    totalRoutes: number;
-    totalComponents: number;
-    totalMigrations: number;
-    partialFiles: number;
-    errorFiles: number;
-}
 interface GraphSnapshotRow {
     id: number;
     commit_hash: string | null;
@@ -551,6 +562,169 @@ interface GraphSnapshotRow {
     file_path: string | null;
     data: string;
 }
+declare class AnalyticsRepository {
+    private readonly db;
+    constructor(db: Database.Database);
+    insertEnvVar(fileId: number, entry: {
+        key: string;
+        valueType: string;
+        valueFormat: string | null;
+        comment: string | null;
+        quoted: boolean;
+        line: number;
+    }): number;
+    deleteEnvVarsByFile(fileId: number): void;
+    getEnvVarsByFile(fileId: number): EnvVarRow[];
+    getAllEnvVars(): (EnvVarRow & {
+        file_path: string;
+    })[];
+    searchEnvVars(pattern: string): (EnvVarRow & {
+        file_path: string;
+    })[];
+    getWorkspaceStats(): WorkspaceStats[];
+    getCrossWorkspaceEdges(): CrossWorkspaceEdge[];
+    getWorkspaceDependencyGraph(): WorkspaceDependency[];
+    getWorkspaceExports(workspace: string): SymbolWithFilePath[];
+    getStats(): IndexStats;
+    insertGraphSnapshot(snapshotType: string, data: Record<string, unknown>, commitHash?: string, filePath?: string): number;
+    getGraphSnapshots(snapshotType: string, options?: {
+        filePath?: string;
+        since?: string;
+        limit?: number;
+    }): GraphSnapshotRow[];
+    pruneGraphSnapshots(maxAge?: number): number;
+}
+
+declare class Store {
+    readonly db: Database.Database;
+    readonly files: FileRepository;
+    readonly symbols: SymbolRepository;
+    readonly graph: GraphRepository;
+    readonly domain: DomainRepository;
+    readonly analytics: AnalyticsRepository;
+    constructor(db: Database.Database);
+    insertFile(path: string, language: string | null, contentHash: string | null, byteLength: number | null, workspace?: string | null, mtimeMs?: number | null): number;
+    getFile(path: string): FileRow | undefined;
+    getFileById(id: number): FileRow | undefined;
+    getAllFiles(): FileRow[];
+    updateFileWorkspace(fileId: number, workspace: string): void;
+    getFilesByWorkspace(workspace: string): FileRow[];
+    updateFileHash(fileId: number, hash: string, byteLength: number, mtimeMs?: number | null): void;
+    updateFileStatus(fileId: number, status: string, frameworkRole?: string): void;
+    updateFileGitignored(fileId: number, gitignored: boolean): void;
+    deleteFile(fileId: number): void;
+    deleteEntitiesByFile(fileId: number): void;
+    getFilesByIds(ids: number[]): Map<number, FileRow>;
+    insertSymbol(fileId: number, sym: RawSymbol, parentIdOverride?: number | null): number;
+    insertSymbols(fileId: number, syms: RawSymbol[]): number[];
+    deleteSymbolsByFile(fileId: number): void;
+    getSymbolsByFile(fileId: number): SymbolRow[];
+    getSymbolBySymbolId(symbolId: string): SymbolRow | undefined;
+    getSymbolByFqn(fqn: string): SymbolRow | undefined;
+    getSymbolById(id: number): SymbolRow | undefined;
+    getSymbolByName(name: string, kind?: string): SymbolRow | undefined;
+    getExportedSymbols(filePattern?: string): SymbolWithFilePath[];
+    findImplementors(name: string): SymbolWithFilePath[];
+    getSymbolsWithHeritage(fileIds?: number[]): (SymbolRow & {
+        file_path: string;
+    })[];
+    getSymbolsByIds(ids: number[]): Map<number, SymbolRow>;
+    findSymbolByRole(name: string, frameworkRole?: string): SymbolRow | undefined;
+    updateSymbolSummary(symbolId: number, summary: string): void;
+    getUnsummarizedSymbols(kinds: string[], limit: number): {
+        id: number;
+        name: string;
+        fqn: string | null;
+        kind: string;
+        signature: string | null;
+        file_path: string;
+        byte_start: number;
+        byte_end: number;
+    }[];
+    createNode(nodeType: string, refId: number): number;
+    getNodeId(nodeType: string, refId: number): number | undefined;
+    insertEdge(sourceNodeId: number, targetNodeId: number, edgeTypeName: string, resolved?: boolean, metadata?: Record<string, unknown>, isCrossWs?: boolean): TraceMcpResult<number>;
+    deleteEdgesForFileNodes(fileId: number): void;
+    deleteOutgoingImportEdges(fileId: number): void;
+    deleteOutgoingEdgesForFileNodes(fileId: number): void;
+    traverseEdges(startNodeId: number, direction: 'outgoing' | 'incoming', depth: number): EdgeRow[];
+    getEdgesByType(edgeTypeName: string): EdgeRow[];
+    getOutgoingEdges(nodeId: number): (EdgeRow & {
+        edge_type_name: string;
+    })[];
+    getIncomingEdges(nodeId: number): (EdgeRow & {
+        edge_type_name: string;
+    })[];
+    ensureEdgeType(name: string, category: string, description: string): void;
+    getEdgeTypeName(edgeTypeId: number): string | undefined;
+    getNodeRef(nodeId: number): {
+        nodeType: string;
+        refId: number;
+    } | undefined;
+    getNodeByNodeId(nodeId: number): {
+        node_type: string;
+        ref_id: number;
+    } | undefined;
+    getNodeIdsBatch(nodeType: string, refIds: number[]): Map<number, number>;
+    getNodeRefsBatch(nodeIds: number[]): Map<number, {
+        nodeType: string;
+        refId: number;
+    }>;
+    getEdgesForNodesBatch(nodeIds: number[]): Array<EdgeRow & {
+        edge_type_name: string;
+        pivot_node_id: number;
+    }>;
+    getEdgeTypes(): EdgeTypeRow$1[];
+    insertRoute(route: RawRoute, fileId: number): number;
+    getRouteByUriAndMethod(uri: string, method: string): RouteRow | undefined;
+    getAllRoutes(): RouteRow[];
+    findRouteByPattern(uri: string, method: string): RouteRow | undefined;
+    insertComponent(comp: RawComponent, fileId: number): number;
+    getComponentByFileId(fileId: number): ComponentRow | undefined;
+    getComponentByName(name: string): ComponentRow | undefined;
+    getAllComponents(): ComponentRow[];
+    insertMigration(mig: RawMigration, fileId: number): number;
+    getMigrationsByTable(tableName: string): MigrationRow[];
+    getAllMigrations(): MigrationRow[];
+    insertOrmModel(model: RawOrmModel, fileId: number): number;
+    getOrmModelByName(name: string): OrmModelRow | undefined;
+    getOrmModelsByOrm(orm: string): OrmModelRow[];
+    getAllOrmModels(): OrmModelRow[];
+    insertOrmAssociation(sourceModelId: number, targetModelId: number | null, targetModelName: string, kind: string, options?: Record<string, unknown>, fileId?: number, line?: number): number;
+    getAllOrmAssociations(fileIds?: number[]): OrmAssociationRow[];
+    getOrmAssociationsByModel(modelId: number): OrmAssociationRow[];
+    insertRnScreen(screen: RawRnScreen, fileId: number): number;
+    getRnScreenByName(name: string): RnScreenRow | undefined;
+    getAllRnScreens(): RnScreenRow[];
+    insertEnvVar(fileId: number, entry: {
+        key: string;
+        valueType: string;
+        valueFormat: string | null;
+        comment: string | null;
+        quoted: boolean;
+        line: number;
+    }): number;
+    deleteEnvVarsByFile(fileId: number): void;
+    getEnvVarsByFile(fileId: number): EnvVarRow$1[];
+    getAllEnvVars(): (EnvVarRow$1 & {
+        file_path: string;
+    })[];
+    searchEnvVars(pattern: string): (EnvVarRow$1 & {
+        file_path: string;
+    })[];
+    getWorkspaceStats(): WorkspaceStats$1[];
+    getCrossWorkspaceEdges(): CrossWorkspaceEdge$1[];
+    getWorkspaceDependencyGraph(): WorkspaceDependency$1[];
+    getWorkspaceExports(workspace: string): SymbolWithFilePath[];
+    getStats(): IndexStats;
+    insertGraphSnapshot(snapshotType: string, data: Record<string, unknown>, commitHash?: string, filePath?: string): number;
+    getGraphSnapshots(snapshotType: string, options?: {
+        filePath?: string;
+        since?: string;
+        limit?: number;
+    }): GraphSnapshotRow$1[];
+    pruneGraphSnapshots(maxAge?: number): number;
+}
 
 declare class PluginRegistry {
     private languagePlugins;
@@ -581,6 +755,18 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
     }>>;
     include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    ignore: z.ZodDefault<z.ZodObject<{
+        /** Extra directory names to skip during indexing (added to built-in list). */
+        directories: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Extra gitignore-style patterns to exclude from indexing. */
+        patterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        directories: string[];
+        patterns: string[];
+    }, {
+        directories?: string[] | undefined;
+        patterns?: string[] | undefined;
+    }>>;
     frameworks: z.ZodOptional<z.ZodObject<{
         laravel: z.ZodOptional<z.ZodObject<{
             artisan: z.ZodOptional<z.ZodObject<{
@@ -636,6 +822,11 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         summarize_on_index: z.ZodDefault<z.ZodBoolean>;
         summarize_batch_size: z.ZodDefault<z.ZodNumber>;
         summarize_kinds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Max parallel requests to the AI provider (embedding + inference).
+         *  Ollama-side: set OLLAMA_NUM_PARALLEL env var to match this value.
+         *  On macOS desktop app: `launchctl setenv OLLAMA_NUM_PARALLEL <N>` + restart app.
+         *  Or run from terminal: `OLLAMA_NUM_PARALLEL=<N> ollama serve`. */
+        concurrency: z.ZodDefault<z.ZodNumber>;
         reranker_model: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
@@ -643,6 +834,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         summarize_on_index: boolean;
         summarize_batch_size: number;
         summarize_kinds: string[];
+        concurrency: number;
         base_url?: string | undefined;
         api_key?: string | undefined;
         inference_model?: string | undefined;
@@ -662,6 +854,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         summarize_on_index?: boolean | undefined;
         summarize_batch_size?: number | undefined;
         summarize_kinds?: string[] | undefined;
+        concurrency?: number | undefined;
         reranker_model?: string | undefined;
     }>>;
     plugins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -1320,8 +1513,17 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         descriptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>>;
+        /** Global description verbosity: full (default), minimal (first sentence only), none (empty) */
+        description_verbosity: z.ZodDefault<z.ZodEnum<["full", "minimal", "none"]>>;
+        /** Server instructions verbosity: full (default ~2K tokens), minimal (~200 tokens), none (empty) */
+        instructions_verbosity: z.ZodDefault<z.ZodEnum<["full", "minimal", "none"]>>;
+        /** Control which meta fields appear in responses. true = all (default), false = none, or list specific fields to include */
+        meta_fields: z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodArray<z.ZodEnum<["_hints", "_budget_warning", "_budget_level", "_duplicate_warning", "_dedup", "_optimization_hint", "_meta", "_duplication_warnings"]>, "many">]>>;
     }, "strip", z.ZodTypeAny, {
         preset: string;
+        description_verbosity: "none" | "full" | "minimal";
+        instructions_verbosity: "none" | "full" | "minimal";
+        meta_fields: boolean | ("_hints" | "_budget_warning" | "_budget_level" | "_duplicate_warning" | "_dedup" | "_optimization_hint" | "_meta" | "_duplication_warnings")[];
         include?: string[] | undefined;
         exclude?: string[] | undefined;
         descriptions?: Record<string, string | Record<string, string>> | undefined;
@@ -1330,6 +1532,9 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         exclude?: string[] | undefined;
         preset?: string | undefined;
         descriptions?: Record<string, string | Record<string, string>> | undefined;
+        description_verbosity?: "none" | "full" | "minimal" | undefined;
+        instructions_verbosity?: "none" | "full" | "minimal" | undefined;
+        meta_fields?: boolean | ("_hints" | "_budget_warning" | "_budget_level" | "_duplicate_warning" | "_dedup" | "_optimization_hint" | "_meta" | "_duplication_warnings")[] | undefined;
     }>>;
     watch: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1348,6 +1553,10 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
     };
     include: string[];
     exclude: string[];
+    ignore: {
+        directories: string[];
+        patterns: string[];
+    };
     plugins: string[];
     watch: {
         enabled: boolean;
@@ -1368,6 +1577,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         summarize_on_index: boolean;
         summarize_batch_size: number;
         summarize_kinds: string[];
+        concurrency: number;
         base_url?: string | undefined;
         api_key?: string | undefined;
         inference_model?: string | undefined;
@@ -1502,6 +1712,9 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
     } | undefined;
     tools?: {
         preset: string;
+        description_verbosity: "none" | "full" | "minimal";
+        instructions_verbosity: "none" | "full" | "minimal";
+        meta_fields: boolean | ("_hints" | "_budget_warning" | "_budget_level" | "_duplicate_warning" | "_dedup" | "_optimization_hint" | "_meta" | "_duplication_warnings")[];
         include?: string[] | undefined;
         exclude?: string[] | undefined;
         descriptions?: Record<string, string | Record<string, string>> | undefined;
@@ -1513,6 +1726,10 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
     } | undefined;
     include?: string[] | undefined;
     exclude?: string[] | undefined;
+    ignore?: {
+        directories?: string[] | undefined;
+        patterns?: string[] | undefined;
+    } | undefined;
     frameworks?: {
         laravel?: {
             artisan?: {
@@ -1534,6 +1751,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         summarize_on_index?: boolean | undefined;
         summarize_batch_size?: number | undefined;
         summarize_kinds?: string[] | undefined;
+        concurrency?: number | undefined;
         reranker_model?: string | undefined;
     } | undefined;
     plugins?: string[] | undefined;
@@ -1666,6 +1884,9 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         exclude?: string[] | undefined;
         preset?: string | undefined;
         descriptions?: Record<string, string | Record<string, string>> | undefined;
+        description_verbosity?: "none" | "full" | "minimal" | undefined;
+        instructions_verbosity?: "none" | "full" | "minimal" | undefined;
+        meta_fields?: boolean | ("_hints" | "_budget_warning" | "_budget_level" | "_duplicate_warning" | "_dedup" | "_optimization_hint" | "_meta" | "_duplication_warnings")[] | undefined;
     } | undefined;
     watch?: {
         enabled?: boolean | undefined;