trace-mcp 1.14.0 → 1.15.0

package/dist/index.d.ts

@@ -63,6 +63,8 @@ interface RawSymbol {
     metadata?: Record<string, unknown>;
 }
 type SymbolKind = 'class' | 'method' | 'function' | 'constant' | 'property' | 'interface' | 'trait' | 'enum' | 'type' | 'variable' | 'enum_case' | 'namespace' | 'decorator';
+/** How an edge was resolved during indexing — tiers from highest to lowest confidence */
+type EdgeResolution = 'lsp_resolved' | 'ast_resolved' | 'ast_inferred' | 'text_matched';
 interface RawEdge {
     sourceSymbolId?: string;
     sourceNodeType?: string;
@@ -72,6 +74,8 @@ interface RawEdge {
     targetRefId?: number;
     edgeType: string;
     resolved?: boolean;
+    /** How this edge was resolved: ast_resolved (direct AST), ast_inferred (import graph), text_matched (heuristic) */
+    resolution?: EdgeResolution;
     metadata?: Record<string, unknown>;
 }
 interface RawRoute {
@@ -274,6 +278,7 @@ interface EdgeRow {
     resolved: number;
     metadata: string | null;
     is_cross_ws: number;
+    resolution_tier: string;
 }
 interface RouteRow {
     id: number;
@@ -462,7 +467,7 @@ declare class GraphRepository {
     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>;
+    insertEdge(sourceNodeId: number, targetNodeId: number, edgeTypeName: string, resolved?: boolean, metadata?: Record<string, unknown>, isCrossWs?: boolean, resolutionTier?: string): TraceMcpResult<number>;
     deleteEdgesForFileNodes(fileId: number): void;
     deleteOutgoingImportEdges(fileId: number): void;
     deleteOutgoingEdgesForFileNodes(fileId: number): void;
@@ -621,6 +626,7 @@ declare class Store {
     insertSymbols(fileId: number, syms: RawSymbol[]): number[];
     deleteSymbolsByFile(fileId: number): void;
     getSymbolsByFile(fileId: number): SymbolRow[];
+    getSymbolsByFileIds(fileIds: number[]): SymbolRow[];
     getSymbolBySymbolId(symbolId: string): SymbolRow | undefined;
     getSymbolByFqn(fqn: string): SymbolRow | undefined;
     getSymbolById(id: number): SymbolRow | undefined;
@@ -647,7 +653,7 @@ declare class Store {
     }[];
     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>;
+    insertEdge(sourceNodeId: number, targetNodeId: number, edgeTypeName: string, resolved?: boolean, metadata?: Record<string, unknown>, isCrossWs?: boolean, resolutionTier?: string): TraceMcpResult<number>;
     deleteEdgesForFileNodes(fileId: number): void;
     deleteOutgoingImportEdges(fileId: number): void;
     deleteOutgoingEdgesForFileNodes(fileId: number): void;
@@ -816,7 +822,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
     }>>;
     ai: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
-        provider: z.ZodDefault<z.ZodEnum<["ollama", "openai"]>>;
+        provider: z.ZodDefault<z.ZodEnum<["onnx", "ollama", "openai"]>>;
         base_url: z.ZodOptional<z.ZodString>;
         api_key: z.ZodOptional<z.ZodString>;
         inference_model: z.ZodOptional<z.ZodString>;
@@ -834,7 +840,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         reranker_model: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
-        provider: "ollama" | "openai";
+        provider: "onnx" | "ollama" | "openai";
         summarize_on_index: boolean;
         summarize_batch_size: number;
         summarize_kinds: string[];
@@ -848,7 +854,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         reranker_model?: string | undefined;
     }, {
         enabled?: boolean | undefined;
-        provider?: "ollama" | "openai" | undefined;
+        provider?: "onnx" | "ollama" | "openai" | undefined;
         base_url?: string | undefined;
         api_key?: string | undefined;
         inference_model?: string | undefined;
@@ -1155,6 +1161,58 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
             route_patterns?: string[] | undefined;
         } | undefined;
     }>>;
+    lsp: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        servers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            initializationOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            rootUri: z.ZodOptional<z.ZodString>;
+            timeout_ms: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            command: string;
+            args: string[];
+            timeout_ms: number;
+            initializationOptions?: Record<string, unknown> | undefined;
+            rootUri?: string | undefined;
+        }, {
+            command: string;
+            args?: string[] | undefined;
+            initializationOptions?: Record<string, unknown> | undefined;
+            rootUri?: string | undefined;
+            timeout_ms?: number | undefined;
+        }>>>;
+        auto_detect: z.ZodDefault<z.ZodBoolean>;
+        max_concurrent_servers: z.ZodDefault<z.ZodNumber>;
+        enrichment_timeout_ms: z.ZodDefault<z.ZodNumber>;
+        batch_size: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        servers: Record<string, {
+            command: string;
+            args: string[];
+            timeout_ms: number;
+            initializationOptions?: Record<string, unknown> | undefined;
+            rootUri?: string | undefined;
+        }>;
+        auto_detect: boolean;
+        max_concurrent_servers: number;
+        enrichment_timeout_ms: number;
+        batch_size: number;
+    }, {
+        enabled?: boolean | undefined;
+        servers?: Record<string, {
+            command: string;
+            args?: string[] | undefined;
+            initializationOptions?: Record<string, unknown> | undefined;
+            rootUri?: string | undefined;
+            timeout_ms?: number | undefined;
+        }> | undefined;
+        auto_detect?: boolean | undefined;
+        max_concurrent_servers?: number | undefined;
+        enrichment_timeout_ms?: number | undefined;
+        batch_size?: number | undefined;
+    }>>;
     topology: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         repos: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -1163,14 +1221,14 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         contract_globs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
-        repos: string[];
         auto_detect: boolean;
+        repos: string[];
         auto_federation: boolean;
         contract_globs?: string[] | undefined;
     }, {
         enabled?: boolean | undefined;
-        repos?: string[] | undefined;
         auto_detect?: boolean | undefined;
+        repos?: string[] | undefined;
         auto_federation?: boolean | undefined;
         contract_globs?: string[] | undefined;
     }>>;
@@ -1522,12 +1580,12 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         /** 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">]>>;
+        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", "_methodology"]>, "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")[];
+        meta_fields: boolean | ("_hints" | "_budget_warning" | "_budget_level" | "_duplicate_warning" | "_dedup" | "_optimization_hint" | "_meta" | "_duplication_warnings" | "_methodology")[];
         include?: string[] | undefined;
         exclude?: string[] | undefined;
         descriptions?: Record<string, string | Record<string, string>> | undefined;
@@ -1538,7 +1596,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         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;
+        meta_fields?: boolean | ("_hints" | "_budget_warning" | "_budget_level" | "_duplicate_warning" | "_dedup" | "_optimization_hint" | "_meta" | "_duplication_warnings" | "_methodology")[] | undefined;
     }>>;
     watch: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1566,6 +1624,13 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         level?: "error" | "trace" | "debug" | "info" | "warn" | "fatal" | undefined;
         max_size_mb?: number | undefined;
     }>>;
+    git: z.ZodDefault<z.ZodObject<{
+        defaultBaseBranch: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        defaultBaseBranch?: string | undefined;
+    }, {
+        defaultBaseBranch?: string | undefined;
+    }>>;
     children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     root: string;
@@ -1589,6 +1654,9 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         level: "error" | "trace" | "debug" | "info" | "warn" | "fatal";
         max_size_mb: number;
     };
+    git: {
+        defaultBaseBranch?: string | undefined;
+    };
     frameworks?: {
         laravel?: {
             graceful_degradation: boolean;
@@ -1600,7 +1668,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
     } | undefined;
     ai?: {
         enabled: boolean;
-        provider: "ollama" | "openai";
+        provider: "onnx" | "ollama" | "openai";
         summarize_on_index: boolean;
         summarize_batch_size: number;
         summarize_kinds: string[];
@@ -1676,10 +1744,24 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
             route_patterns: string[];
         };
     } | undefined;
+    lsp?: {
+        enabled: boolean;
+        servers: Record<string, {
+            command: string;
+            args: string[];
+            timeout_ms: number;
+            initializationOptions?: Record<string, unknown> | undefined;
+            rootUri?: string | undefined;
+        }>;
+        auto_detect: boolean;
+        max_concurrent_servers: number;
+        enrichment_timeout_ms: number;
+        batch_size: number;
+    } | undefined;
     topology?: {
         enabled: boolean;
-        repos: string[];
         auto_detect: boolean;
+        repos: string[];
         auto_federation: boolean;
         contract_globs?: string[] | undefined;
     } | undefined;
@@ -1741,7 +1823,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         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")[];
+        meta_fields: boolean | ("_hints" | "_budget_warning" | "_budget_level" | "_duplicate_warning" | "_dedup" | "_optimization_hint" | "_meta" | "_duplication_warnings" | "_methodology")[];
         include?: string[] | undefined;
         exclude?: string[] | undefined;
         descriptions?: Record<string, string | Record<string, string>> | undefined;
@@ -1769,7 +1851,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
     } | undefined;
     ai?: {
         enabled?: boolean | undefined;
-        provider?: "ollama" | "openai" | undefined;
+        provider?: "onnx" | "ollama" | "openai" | undefined;
         base_url?: string | undefined;
         api_key?: string | undefined;
         inference_model?: string | undefined;
@@ -1846,10 +1928,24 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
             route_patterns?: string[] | undefined;
         } | undefined;
     } | undefined;
+    lsp?: {
+        enabled?: boolean | undefined;
+        servers?: Record<string, {
+            command: string;
+            args?: string[] | undefined;
+            initializationOptions?: Record<string, unknown> | undefined;
+            rootUri?: string | undefined;
+            timeout_ms?: number | undefined;
+        }> | undefined;
+        auto_detect?: boolean | undefined;
+        max_concurrent_servers?: number | undefined;
+        enrichment_timeout_ms?: number | undefined;
+        batch_size?: number | undefined;
+    } | undefined;
     topology?: {
         enabled?: boolean | undefined;
-        repos?: string[] | undefined;
         auto_detect?: boolean | undefined;
+        repos?: string[] | undefined;
         auto_federation?: boolean | undefined;
         contract_globs?: string[] | undefined;
     } | undefined;
@@ -1914,7 +2010,7 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         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;
+        meta_fields?: boolean | ("_hints" | "_budget_warning" | "_budget_level" | "_duplicate_warning" | "_dedup" | "_optimization_hint" | "_meta" | "_duplication_warnings" | "_methodology")[] | undefined;
     } | undefined;
     watch?: {
         enabled?: boolean | undefined;
@@ -1926,6 +2022,9 @@ declare const TraceMcpConfigSchema: z.ZodObject<{
         level?: "error" | "trace" | "debug" | "info" | "warn" | "fatal" | undefined;
         max_size_mb?: number | undefined;
     } | undefined;
+    git?: {
+        defaultBaseBranch?: string | undefined;
+    } | undefined;
     children?: string[] | undefined;
 }>;
 type TraceMcpConfig = z.infer<typeof TraceMcpConfigSchema>;
@@ -1961,12 +2060,16 @@ interface ProgressSnapshot {
     summarization: PipelineProgressSnapshot;
     embedding: PipelineProgressSnapshot;
 }
+type ProgressListener = (name: PipelineName, progress: PipelineProgress) => void;
 declare class ProgressState {
     indexing: PipelineProgress;
     summarization: PipelineProgress;
     embedding: PipelineProgress;
     private db;
+    private listeners;
     constructor(db?: Database.Database);
+    /** Register a callback for progress updates. Returns unsubscribe function. */
+    onUpdate(listener: ProgressListener): () => void;
     update(name: PipelineName, partial: Partial<PipelineProgress>): void;
     snapshot(): ProgressSnapshot;
     private persist;