trace-mcp 1.6.1 → 1.8.0

package/dist/index.d.ts

@@ -194,7 +194,7 @@ interface LanguagePlugin {
     manifest: PluginManifest;
     supportedExtensions: string[];
     supportedVersions?: string[];
-    extractSymbols(filePath: string, content: Buffer): TraceMcpResult<FileParseResult>;
+    extractSymbols(filePath: string, content: Buffer): TraceMcpResult<FileParseResult> | Promise<TraceMcpResult<FileParseResult>>;
 }
 interface FrameworkPlugin {
     manifest: PluginManifest;
@@ -437,6 +437,8 @@ declare class SymbolRepository {
     getSymbolsByIds(ids: number[]): Map<number, SymbolRow>;
     findSymbolByRole(name: string, frameworkRole?: string): SymbolRow | undefined;
     updateSymbolSummary(symbolId: number, summary: string): void;
+    countUnsummarizedSymbols(kinds: string[]): number;
+    countUnembeddedSymbols(): number;
     getUnsummarizedSymbols(kinds: string[], limit: number): {
         id: number;
         name: string;
@@ -631,6 +633,8 @@ declare class Store {
     getSymbolsByIds(ids: number[]): Map<number, SymbolRow>;
     findSymbolByRole(name: string, frameworkRole?: string): SymbolRow | undefined;
     updateSymbolSummary(symbolId: number, summary: string): void;
+    countUnsummarizedSymbols(kinds: string[]): number;
+    countUnembeddedSymbols(): number;
     getUnsummarizedSymbols(kinds: string[], limit: number): {
         id: number;
         name: string;
@@ -1904,7 +1908,44 @@ type TraceMcpConfig = z.infer<typeof TraceMcpConfigSchema>;
  */
 declare function loadConfig(searchFrom?: string): Promise<TraceMcpResult<TraceMcpConfig>>;
 
-declare function createServer(store: Store, registry: PluginRegistry, config: TraceMcpConfig, rootPath?: string): McpServer;
+/**
+ * Indexing progress tracking.
+ * Shared mutable state object — pipelines write, MCP tools + CLI read.
+ * Progress is also persisted to SQLite for cross-process access (CLI `status` command).
+ */
+
+type PipelinePhase = 'idle' | 'running' | 'completed' | 'error';
+type PipelineName = 'indexing' | 'summarization' | 'embedding';
+interface PipelineProgress {
+    phase: PipelinePhase;
+    processed: number;
+    total: number;
+    startedAt: number;
+    completedAt: number;
+    error?: string;
+}
+interface PipelineProgressSnapshot extends PipelineProgress {
+    percentage: number | null;
+    elapsedMs: number;
+}
+interface ProgressSnapshot {
+    indexing: PipelineProgressSnapshot;
+    summarization: PipelineProgressSnapshot;
+    embedding: PipelineProgressSnapshot;
+}
+declare class ProgressState {
+    indexing: PipelineProgress;
+    summarization: PipelineProgress;
+    embedding: PipelineProgress;
+    private db;
+    constructor(db?: Database.Database);
+    update(name: PipelineName, partial: Partial<PipelineProgress>): void;
+    snapshot(): ProgressSnapshot;
+    private persist;
+    private loadFromDb;
+}
+
+declare function createServer(store: Store, registry: PluginRegistry, config: TraceMcpConfig, rootPath?: string, progress?: ProgressState): McpServer;
 
 declare function initializeDatabase(dbPath: string): Database.Database;