trace-mcp 0.1.0 → 1.0.10

package/dist/index.d.ts

@@ -139,11 +139,25 @@ interface FileParseResult {
     warnings?: string[];
     metadata?: Record<string, unknown>;
 }
+type PluginCategory = 'framework' | 'orm' | 'validation' | 'state' | 'api' | 'realtime' | 'testing' | 'tooling' | 'view';
 interface PluginManifest {
     name: string;
     version: string;
     priority: number;
     dependencies?: string[];
+    category?: PluginCategory;
+}
+/** Detected runtime/language version from manifest files. */
+interface DetectedVersion {
+    runtime: string;
+    version?: string;
+    source: string;
+}
+/** Parsed dependency entry from any manifest. */
+interface ParsedDependency {
+    name: string;
+    version?: string;
+    dev?: boolean;
 }
 interface ProjectContext {
     rootPath: string;
@@ -151,11 +165,35 @@ interface ProjectContext {
     packageJson?: Record<string, unknown>;
     pyprojectToml?: Record<string, unknown>;
     requirementsTxt?: string[];
+    goMod?: {
+        module: string;
+        goVersion?: string;
+        deps: ParsedDependency[];
+    };
+    cargoToml?: {
+        package?: Record<string, unknown>;
+        deps: ParsedDependency[];
+    };
+    gemfile?: {
+        deps: ParsedDependency[];
+    };
+    pomXml?: {
+        groupId?: string;
+        artifactId?: string;
+        version?: string;
+        deps: ParsedDependency[];
+    };
+    buildGradle?: {
+        deps: ParsedDependency[];
+    };
+    detectedVersions: DetectedVersion[];
+    allDependencies: ParsedDependency[];
     configFiles: string[];
 }
 interface LanguagePlugin {
     manifest: PluginManifest;
     supportedExtensions: string[];
+    supportedVersions?: string[];
     extractSymbols(filePath: string, content: Buffer): TraceMcpResult<FileParseResult>;
 }
 interface FrameworkPlugin {
@@ -199,6 +237,7 @@ interface ResolveContext {
 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): number;
     getFile(path: string): FileRow | undefined;
     getFileById(id: number): FileRow | undefined;
@@ -207,10 +246,11 @@ declare class Store {
     getFilesByWorkspace(workspace: string): FileRow[];
     updateFileHash(fileId: number, hash: string, byteLength: number): 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): number;
+    insertSymbol(fileId: number, sym: RawSymbol, parentIdOverride?: number | null): number;
     insertSymbols(fileId: number, symbols: RawSymbol[]): number[];
     deleteSymbolsByFile(fileId: number): void;
     getSymbolsByFile(fileId: number): SymbolRow[];
@@ -220,6 +260,9 @@ declare class Store {
     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 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;
@@ -326,7 +369,22 @@ declare class Store {
         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;
 }
 interface FileRow {
     id: number;
@@ -339,6 +397,7 @@ interface FileRow {
     indexed_at: string;
     metadata: string | null;
     workspace: string | null;
+    gitignored: number;
 }
 interface SymbolRow {
     id: number;
@@ -445,6 +504,30 @@ interface EdgeTypeRow {
     category: string;
     description: string;
 }
+interface WorkspaceStats {
+    workspace: string;
+    file_count: number;
+    symbol_count: number;
+    languages: string | null;
+}
+interface CrossWorkspaceEdge {
+    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 {
+    from_workspace: string;
+    to_workspace: string;
+    edge_count: number;
+    edge_types: string;
+}
 interface IndexStats {
     totalFiles: number;
     totalSymbols: number;
@@ -456,24 +539,35 @@ interface IndexStats {
     partialFiles: number;
     errorFiles: number;
 }
+interface GraphSnapshotRow {
+    id: number;
+    commit_hash: string | null;
+    created_at: string;
+    snapshot_type: string;
+    file_path: string | null;
+    data: string;
+}
 
 declare class PluginRegistry {
     private languagePlugins;
     private frameworkPlugins;
+    private _extMap;
+    private _activeFrameworkCache;
     registerLanguagePlugin(plugin: LanguagePlugin): void;
     registerFrameworkPlugin(plugin: FrameworkPlugin): void;
     getLanguagePlugins(): LanguagePlugin[];
     getActiveFrameworkPlugins(ctx: ProjectContext): TraceMcpResult<FrameworkPlugin[]>;
+    /** Clear per-pipeline-run caches. Call at start of each indexing run. */
+    clearCaches(): void;
     getAllFrameworkPlugins(): FrameworkPlugin[];
     getLanguagePluginForFile(filePath: string): LanguagePlugin | undefined;
+    private getExtensionMap;
     private sortByPriority;
     private topologicalSort;
 }
 
 declare const TraceMcpConfigSchema: z.ZodObject<{
     root: z.ZodDefault<z.ZodString>;
-    include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     db: z.ZodDefault<z.ZodObject<{
         path: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -481,6 +575,8 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
     }, {
         path?: string | undefined;
     }>>;
+    include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     frameworks: z.ZodOptional<z.ZodObject<{
         laravel: z.ZodOptional<z.ZodObject<{
             artisan: z.ZodOptional<z.ZodObject<{
@@ -568,20 +664,338 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
     security: z.ZodOptional<z.ZodObject<{
         secret_patterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         max_file_size_bytes: z.ZodOptional<z.ZodNumber>;
+        max_files: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         secret_patterns?: string[] | undefined;
         max_file_size_bytes?: number | undefined;
+        max_files?: number | undefined;
     }, {
         secret_patterns?: string[] | undefined;
         max_file_size_bytes?: number | undefined;
+        max_files?: number | undefined;
+    }>>;
+    predictive: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        weights: z.ZodDefault<z.ZodObject<{
+            bug: z.ZodDefault<z.ZodObject<{
+                churn: z.ZodDefault<z.ZodNumber>;
+                fix_ratio: z.ZodDefault<z.ZodNumber>;
+                complexity: z.ZodDefault<z.ZodNumber>;
+                coupling: z.ZodDefault<z.ZodNumber>;
+                pagerank: z.ZodDefault<z.ZodNumber>;
+                authors: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                churn: number;
+                fix_ratio: number;
+                complexity: number;
+                coupling: number;
+                pagerank: number;
+                authors: number;
+            }, {
+                churn?: number | undefined;
+                fix_ratio?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                pagerank?: number | undefined;
+                authors?: number | undefined;
+            }>>;
+            tech_debt: z.ZodDefault<z.ZodObject<{
+                complexity: z.ZodDefault<z.ZodNumber>;
+                coupling: z.ZodDefault<z.ZodNumber>;
+                test_gap: z.ZodDefault<z.ZodNumber>;
+                churn: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                churn: number;
+                complexity: number;
+                coupling: number;
+                test_gap: number;
+            }, {
+                churn?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                test_gap?: number | undefined;
+            }>>;
+            change_risk: z.ZodDefault<z.ZodObject<{
+                blast_radius: z.ZodDefault<z.ZodNumber>;
+                complexity: z.ZodDefault<z.ZodNumber>;
+                churn: z.ZodDefault<z.ZodNumber>;
+                test_gap: z.ZodDefault<z.ZodNumber>;
+                coupling: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                churn: number;
+                complexity: number;
+                coupling: number;
+                test_gap: number;
+                blast_radius: number;
+            }, {
+                churn?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                test_gap?: number | undefined;
+                blast_radius?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            bug: {
+                churn: number;
+                fix_ratio: number;
+                complexity: number;
+                coupling: number;
+                pagerank: number;
+                authors: number;
+            };
+            tech_debt: {
+                churn: number;
+                complexity: number;
+                coupling: number;
+                test_gap: number;
+            };
+            change_risk: {
+                churn: number;
+                complexity: number;
+                coupling: number;
+                test_gap: number;
+                blast_radius: number;
+            };
+        }, {
+            bug?: {
+                churn?: number | undefined;
+                fix_ratio?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                pagerank?: number | undefined;
+                authors?: number | undefined;
+            } | undefined;
+            tech_debt?: {
+                churn?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                test_gap?: number | undefined;
+            } | undefined;
+            change_risk?: {
+                churn?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                test_gap?: number | undefined;
+                blast_radius?: number | undefined;
+            } | undefined;
+        }>>;
+        cache_ttl_minutes: z.ZodDefault<z.ZodNumber>;
+        git_since_days: z.ZodDefault<z.ZodNumber>;
+        module_depth: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        weights: {
+            bug: {
+                churn: number;
+                fix_ratio: number;
+                complexity: number;
+                coupling: number;
+                pagerank: number;
+                authors: number;
+            };
+            tech_debt: {
+                churn: number;
+                complexity: number;
+                coupling: number;
+                test_gap: number;
+            };
+            change_risk: {
+                churn: number;
+                complexity: number;
+                coupling: number;
+                test_gap: number;
+                blast_radius: number;
+            };
+        };
+        cache_ttl_minutes: number;
+        git_since_days: number;
+        module_depth: number;
+    }, {
+        enabled?: boolean | undefined;
+        weights?: {
+            bug?: {
+                churn?: number | undefined;
+                fix_ratio?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                pagerank?: number | undefined;
+                authors?: number | undefined;
+            } | undefined;
+            tech_debt?: {
+                churn?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                test_gap?: number | undefined;
+            } | undefined;
+            change_risk?: {
+                churn?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                test_gap?: number | undefined;
+                blast_radius?: number | undefined;
+            } | undefined;
+        } | undefined;
+        cache_ttl_minutes?: number | undefined;
+        git_since_days?: number | undefined;
+        module_depth?: number | undefined;
+    }>>;
+    intent: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        domain_hints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+        custom_domains: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            parent: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            path_patterns: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            path_patterns: string[];
+            parent?: string | undefined;
+            description?: string | undefined;
+        }, {
+            name: string;
+            path_patterns: string[];
+            parent?: string | undefined;
+            description?: string | undefined;
+        }>, "many">>;
+        auto_classify_on_index: z.ZodDefault<z.ZodBoolean>;
+        classify_batch_size: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        auto_classify_on_index: boolean;
+        classify_batch_size: number;
+        domain_hints?: Record<string, string[]> | undefined;
+        custom_domains?: {
+            name: string;
+            path_patterns: string[];
+            parent?: string | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        domain_hints?: Record<string, string[]> | undefined;
+        custom_domains?: {
+            name: string;
+            path_patterns: string[];
+            parent?: string | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        auto_classify_on_index?: boolean | undefined;
+        classify_batch_size?: number | undefined;
+    }>>;
+    runtime: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        otlp: z.ZodDefault<z.ZodObject<{
+            port: z.ZodDefault<z.ZodNumber>;
+            host: z.ZodDefault<z.ZodString>;
+            max_body_bytes: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            port: number;
+            host: string;
+            max_body_bytes: number;
+        }, {
+            port?: number | undefined;
+            host?: string | undefined;
+            max_body_bytes?: number | undefined;
+        }>>;
+        retention: z.ZodDefault<z.ZodObject<{
+            max_span_age_days: z.ZodDefault<z.ZodNumber>;
+            max_aggregate_age_days: z.ZodDefault<z.ZodNumber>;
+            prune_interval: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            max_span_age_days: number;
+            max_aggregate_age_days: number;
+            prune_interval: number;
+        }, {
+            max_span_age_days?: number | undefined;
+            max_aggregate_age_days?: number | undefined;
+            prune_interval?: number | undefined;
+        }>>;
+        mapping: z.ZodDefault<z.ZodObject<{
+            fqn_attributes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            route_patterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            fqn_attributes: string[];
+            route_patterns: string[];
+        }, {
+            fqn_attributes?: string[] | undefined;
+            route_patterns?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        otlp: {
+            port: number;
+            host: string;
+            max_body_bytes: number;
+        };
+        retention: {
+            max_span_age_days: number;
+            max_aggregate_age_days: number;
+            prune_interval: number;
+        };
+        mapping: {
+            fqn_attributes: string[];
+            route_patterns: string[];
+        };
+    }, {
+        enabled?: boolean | undefined;
+        otlp?: {
+            port?: number | undefined;
+            host?: string | undefined;
+            max_body_bytes?: number | undefined;
+        } | undefined;
+        retention?: {
+            max_span_age_days?: number | undefined;
+            max_aggregate_age_days?: number | undefined;
+            prune_interval?: number | undefined;
+        } | undefined;
+        mapping?: {
+            fqn_attributes?: string[] | undefined;
+            route_patterns?: string[] | undefined;
+        } | undefined;
+    }>>;
+    topology: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        repos: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        auto_detect: z.ZodDefault<z.ZodBoolean>;
+        auto_federation: z.ZodDefault<z.ZodBoolean>;
+        contract_globs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        repos: string[];
+        auto_detect: boolean;
+        auto_federation: boolean;
+        contract_globs?: string[] | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        repos?: string[] | undefined;
+        auto_detect?: boolean | undefined;
+        auto_federation?: boolean | undefined;
+        contract_globs?: string[] | undefined;
+    }>>;
+    tools: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodDefault<z.ZodString>;
+        include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        descriptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        preset: string;
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+        descriptions?: Record<string, string> | undefined;
+    }, {
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+        preset?: string | undefined;
+        descriptions?: Record<string, string> | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     root: string;
-    include: string[];
-    exclude: string[];
     db: {
         path: string;
     };
+    include: string[];
+    exclude: string[];
     plugins: string[];
     frameworks?: {
         laravel?: {
@@ -609,14 +1023,86 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
     security?: {
         secret_patterns?: string[] | undefined;
         max_file_size_bytes?: number | undefined;
+        max_files?: number | undefined;
+    } | undefined;
+    predictive?: {
+        enabled: boolean;
+        weights: {
+            bug: {
+                churn: number;
+                fix_ratio: number;
+                complexity: number;
+                coupling: number;
+                pagerank: number;
+                authors: number;
+            };
+            tech_debt: {
+                churn: number;
+                complexity: number;
+                coupling: number;
+                test_gap: number;
+            };
+            change_risk: {
+                churn: number;
+                complexity: number;
+                coupling: number;
+                test_gap: number;
+                blast_radius: number;
+            };
+        };
+        cache_ttl_minutes: number;
+        git_since_days: number;
+        module_depth: number;
+    } | undefined;
+    intent?: {
+        enabled: boolean;
+        auto_classify_on_index: boolean;
+        classify_batch_size: number;
+        domain_hints?: Record<string, string[]> | undefined;
+        custom_domains?: {
+            name: string;
+            path_patterns: string[];
+            parent?: string | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    } | undefined;
+    runtime?: {
+        enabled: boolean;
+        otlp: {
+            port: number;
+            host: string;
+            max_body_bytes: number;
+        };
+        retention: {
+            max_span_age_days: number;
+            max_aggregate_age_days: number;
+            prune_interval: number;
+        };
+        mapping: {
+            fqn_attributes: string[];
+            route_patterns: string[];
+        };
+    } | undefined;
+    topology?: {
+        enabled: boolean;
+        repos: string[];
+        auto_detect: boolean;
+        auto_federation: boolean;
+        contract_globs?: string[] | undefined;
+    } | undefined;
+    tools?: {
+        preset: string;
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+        descriptions?: Record<string, string> | undefined;
     } | undefined;
 }, {
     root?: string | undefined;
-    include?: string[] | undefined;
-    exclude?: string[] | undefined;
     db?: {
         path?: string | undefined;
     } | undefined;
+    include?: string[] | undefined;
+    exclude?: string[] | undefined;
     frameworks?: {
         laravel?: {
             artisan?: {
@@ -644,9 +1130,86 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
     security?: {
         secret_patterns?: string[] | undefined;
         max_file_size_bytes?: number | undefined;
+        max_files?: number | undefined;
+    } | undefined;
+    predictive?: {
+        enabled?: boolean | undefined;
+        weights?: {
+            bug?: {
+                churn?: number | undefined;
+                fix_ratio?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                pagerank?: number | undefined;
+                authors?: number | undefined;
+            } | undefined;
+            tech_debt?: {
+                churn?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                test_gap?: number | undefined;
+            } | undefined;
+            change_risk?: {
+                churn?: number | undefined;
+                complexity?: number | undefined;
+                coupling?: number | undefined;
+                test_gap?: number | undefined;
+                blast_radius?: number | undefined;
+            } | undefined;
+        } | undefined;
+        cache_ttl_minutes?: number | undefined;
+        git_since_days?: number | undefined;
+        module_depth?: number | undefined;
+    } | undefined;
+    intent?: {
+        enabled?: boolean | undefined;
+        domain_hints?: Record<string, string[]> | undefined;
+        custom_domains?: {
+            name: string;
+            path_patterns: string[];
+            parent?: string | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        auto_classify_on_index?: boolean | undefined;
+        classify_batch_size?: number | undefined;
+    } | undefined;
+    runtime?: {
+        enabled?: boolean | undefined;
+        otlp?: {
+            port?: number | undefined;
+            host?: string | undefined;
+            max_body_bytes?: number | undefined;
+        } | undefined;
+        retention?: {
+            max_span_age_days?: number | undefined;
+            max_aggregate_age_days?: number | undefined;
+            prune_interval?: number | undefined;
+        } | undefined;
+        mapping?: {
+            fqn_attributes?: string[] | undefined;
+            route_patterns?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+    topology?: {
+        enabled?: boolean | undefined;
+        repos?: string[] | undefined;
+        auto_detect?: boolean | undefined;
+        auto_federation?: boolean | undefined;
+        contract_globs?: string[] | undefined;
+    } | undefined;
+    tools?: {
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+        preset?: string | undefined;
+        descriptions?: Record<string, string> | undefined;
     } | undefined;
 }>;
 type TraceMcpConfig = z.infer<typeof TraceMcpConfigSchema>;
+/**
+ * Load config for a project.
+ * Merge order: global defaults → per-project overrides → Zod schema defaults.
+ * The `projectRoot` key in the global config (keyed by absolute path) is also checked.
+ */
 declare function loadConfig(searchFrom?: string): Promise<TraceMcpResult<TraceMcpConfig>>;
 
 declare function createServer(store: Store, registry: PluginRegistry, config: TraceMcpConfig, rootPath?: string): McpServer;