@vohongtho.infotech/code-intel 0.3.1 → 0.4.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import * as web_tree_sitter from 'web-tree-sitter';
 import { Language as Language$1, Parser, Node, Tree } from 'web-tree-sitter';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { Server as Server$1 } from 'node:http';
 import express from 'express';
 
 declare enum Language {
@@ -186,6 +187,20 @@ declare function computeMRO(classId: string, parentMap: Map<string, string[]>, s
 
 declare function detectOverrides(graph: KnowledgeGraph): CodeEdge[];
 
+interface LLMConfig {
+    /** Which provider to use. Default: 'ollama'. */
+    provider?: 'openai' | 'anthropic' | 'ollama';
+    /** Model name / ID passed to the provider. Each provider has its own default. */
+    model?: string;
+    /** Max concurrent LLM calls per batch. Default: 20. */
+    batchSize?: number;
+    /**
+     * Cost guard: stop after summarising this many nodes per run.
+     * Undefined = no limit.
+     */
+    maxNodesPerRun?: number;
+}
+
 type PipelinePhaseStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
 interface PhaseResult {
     status: PipelinePhaseStatus;
@@ -210,6 +225,13 @@ interface PipelineContext {
     verbose?: boolean;
     /** Set by parse-phase after execution: which parser was used */
     parserUsed?: 'tree-sitter' | 'regex';
+    /**
+     * v0.4.0 — opt-in summarize phase.
+     * Set to true via `--summarize` flag or `analysis.summarizeOnAnalyze: true` config.
+     */
+    summarize?: boolean;
+    /** LLM provider config used by the summarize phase. */
+    llmConfig?: LLMConfig;
 }
 interface Phase {
     name: string;
@@ -290,6 +312,54 @@ interface SearchResult {
 declare function textSearch(graph: KnowledgeGraph, query: string, limit?: number): SearchResult[];
 declare function reciprocalRankFusion(...rankings: SearchResult[][]): SearchResult[];
 
+declare function createMcpServer(graph: KnowledgeGraph, repoName: string, workspaceRoot?: string): Server;
+declare function startMcpStdio(graph: KnowledgeGraph, repoName: string, workspaceRoot?: string): Promise<void>;
+
+/**
+ * WsServer — WebSocket push server for live graph-update notifications.
+ *
+ * Attaches to an existing Node.js HTTP server (same port as Express).
+ * Auth: checks the `code_intel_session` cookie, `Authorization: Bearer <token>`,
+ *       or `?token=<token>` query param via the existing websocket-auth module.
+ *
+ * On file change: caller calls broadcast() to push a `graph:updated` message
+ * to all authenticated connected clients.
+ *
+ * Client auto-reconnect is the client's responsibility.
+ */
+
+interface GraphUpdatedMessage {
+    type: 'graph:updated';
+    indexVersion: string;
+    stats: {
+        nodes: number;
+        edges: number;
+    };
+    changedFiles: string[];
+    timestamp: string;
+}
+declare class WsServer {
+    private readonly wss;
+    private readonly clients;
+    constructor(httpServer: Server$1);
+    /** Broadcast a message to all authenticated connected clients. */
+    broadcast(msg: GraphUpdatedMessage): void;
+    get clientCount(): number;
+    close(): void;
+}
+
+declare function createApp(graph: KnowledgeGraph, repoName: string, workspaceRoot?: string, watcherState?: {
+    watching: boolean;
+    lastEventAt: number | null;
+}): express.Application;
+interface HttpServerInstance {
+    wsServer: WsServer | null;
+}
+declare function startHttpServer(graph: KnowledgeGraph, repoName: string, port?: number, workspaceRoot?: string, watcherState?: {
+    watching: boolean;
+    lastEventAt: number | null;
+}): Promise<HttpServerInstance>;
+
 declare class DbManager {
     private db;
     private conn;
@@ -302,12 +372,6 @@ declare class DbManager {
     get isOpen(): boolean;
 }
 
-declare function createMcpServer(graph: KnowledgeGraph, repoName: string, workspaceRoot?: string): Server;
-declare function startMcpStdio(graph: KnowledgeGraph, repoName: string, workspaceRoot?: string): Promise<void>;
-
-declare function createApp(graph: KnowledgeGraph, repoName: string, workspaceRoot?: string): express.Application;
-declare function startHttpServer(graph: KnowledgeGraph, repoName: string, port?: number, workspaceRoot?: string): void;
-
 /**
  * Load graph into DB using bulk CSV COPY — dramatically faster than
  * individual CREATE statements (10-100× speedup for large repos).