@vohongtho.infotech/code-intel 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { Language as Language$1, Parser, Tree, Node } from 'web-tree-sitter';
+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 express from 'express';
 
@@ -64,17 +65,41 @@ declare function createKnowledgeGraph(): KnowledgeGraph;
 declare function generateNodeId(kind: NodeKind, filePath: string, qualifiedName: string): string;
 declare function generateEdgeId(source: string, target: string, kind: string): string;
 
+/** Initialize web-tree-sitter (idempotent). */
 declare function initParser(): Promise<void>;
-declare function getParser(lang: Language): Promise<Parser>;
+/**
+ * Load and cache the TSLanguage WASM for a given language.
+ * Returns null when no WASM grammar is available for this language.
+ */
 declare function getLanguage(lang: Language): Promise<Language$1 | null>;
-declare function parseSource(lang: Language, source: string): Promise<Tree | null>;
+/**
+ * Get a Parser instance configured for the given language.
+ * Returns null when no WASM grammar is available.
+ */
+declare function getParser(lang: Language): Promise<Parser | null>;
+/**
+ * Parse source code for the given language.
+ * Returns a Tree or null when the language is unsupported / WASM fails.
+ */
+declare function parseSource(lang: Language, source: string): Promise<web_tree_sitter.Tree | null>;
+/** Return true if tree-sitter is available for the given language. */
+declare function isTreeSitterAvailable(lang: Language): Promise<boolean>;
 
 interface QueryCapture {
     name: string;
     node: Node;
     text: string;
 }
+interface QueryMatch {
+    patternIndex: number;
+    captures: QueryCapture[];
+}
 declare function runQuery(tree: Tree, language: Language$1, querySource: string): QueryCapture[];
+/**
+ * Return all captures grouped by match, so callers can correlate captures
+ * within the same pattern match (e.g. "def.func" + "def.func.name").
+ */
+declare function runQueryMatches(tree: Tree, language: Language$1, querySource: string): QueryMatch[];
 
 declare class AstCache {
     private cache;
@@ -183,6 +208,8 @@ interface PipelineContext {
     /** Per-phase progress callback — called with (phase, done, total) for each processed item */
     onPhaseProgress?: (phase: string, done: number, total: number) => void;
     verbose?: boolean;
+    /** Set by parse-phase after execution: which parser was used */
+    parserUsed?: 'tree-sitter' | 'regex';
 }
 interface Phase {
     name: string;
@@ -281,6 +308,19 @@ declare function startMcpStdio(graph: KnowledgeGraph, repoName: string, workspac
 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).
+ *
+ * Strategy:
+ *  1. Create tables
+ *  2. Write all nodes to per-table CSV files in a temp dir
+ *  3. Write all edges to per-fromTable→toTable CSV files
+ *  4. COPY each CSV file into the corresponding table
+ *  5. Clean up temp dir
+ *
+ * Falls back to individual CREATE statements per table if COPY fails.
+ */
 declare function loadGraphToDB(graph: KnowledgeGraph, dbManager: DbManager): Promise<{
     nodeCount: number;
     edgeCount: number;
@@ -304,6 +344,10 @@ interface IndexMetadata {
     indexedAt: string;
     indexVersion?: string;
     commitHash?: string;
+    /** Parser used during analysis: 'tree-sitter' | 'regex' */
+    parser?: 'tree-sitter' | 'regex';
+    /** mtime (ms since epoch) for each indexed file path (relative to workspace root) */
+    lastAnalyzedMtimes?: Record<string, number>;
     stats: {
         nodes: number;
         edges: number;
@@ -394,4 +438,4 @@ declare function queryGroup(group: RepoGroup, query: string, limit?: number): Pr
 
 declare function mergeSearchResults(...perRepoResults: SearchResult[][]): SearchResult[];
 
-export { AstCache, BindingTracker, type CallKind, type CallSite, type ClusterResult, type Contract, type ContractLink, DbManager, type EntryPoint, type FileSet, type FlowTrace, type GroupMember, type GroupQueryResult, type GroupSyncResult, type HeritageInfo, type ImportBinding, type ImportInfo, type ImportResolutionResult, type IndexMetadata, type KnowledgeGraph, type LanguageModule, type MroStrategy, type Phase, type PhaseResult, type PipelineContext, type PipelineRunResult, type QueryCapture, type RepoEntry, type RepoGroup, type Scope, type ScopeBinding, type SearchResult, addBinding, addClustersToGraph, addMember, buildCallEdges, buildHeritageEdges, classifyCall, clusterPhase, computeMRO, createApp, createKnowledgeGraph, createMcpServer, createScope, deleteGroup, detectCommunities, detectOverrides, findEntryPoints, flowPhase, generateEdgeId, generateNodeId, getAllLanguageModules, getDbPath, getLanguage, getLanguageModule, getParser, groupExists, initParser, listGroups, loadGraphToDB, loadGroup, loadMetadata, loadRegistry, loadSyncResult, mergeSearchResults, parsePhase, parseSource, queryGroup, reciprocalRankFusion, removeMember, removeRepo, resolveBinding, resolveImports, resolvePhase, runPipeline, runQuery, saveGroup, saveMetadata, saveSyncResult, scanPhase, startHttpServer, startMcpStdio, structurePhase, syncGroup, textSearch, topologicalSort, traceFlow, upsertRepo, validateDAG };
+export { AstCache, BindingTracker, type CallKind, type CallSite, type ClusterResult, type Contract, type ContractLink, DbManager, type EntryPoint, type FileSet, type FlowTrace, type GroupMember, type GroupQueryResult, type GroupSyncResult, type HeritageInfo, type ImportBinding, type ImportInfo, type ImportResolutionResult, type IndexMetadata, type KnowledgeGraph, type LanguageModule, type MroStrategy, type Phase, type PhaseResult, type PipelineContext, type PipelineRunResult, type QueryCapture, type QueryMatch, type RepoEntry, type RepoGroup, type Scope, type ScopeBinding, type SearchResult, addBinding, addClustersToGraph, addMember, buildCallEdges, buildHeritageEdges, classifyCall, clusterPhase, computeMRO, createApp, createKnowledgeGraph, createMcpServer, createScope, deleteGroup, detectCommunities, detectOverrides, findEntryPoints, flowPhase, generateEdgeId, generateNodeId, getAllLanguageModules, getDbPath, getLanguage, getLanguageModule, getParser, groupExists, initParser, isTreeSitterAvailable, listGroups, loadGraphToDB, loadGroup, loadMetadata, loadRegistry, loadSyncResult, mergeSearchResults, parsePhase, parseSource, queryGroup, reciprocalRankFusion, removeMember, removeRepo, resolveBinding, resolveImports, resolvePhase, runPipeline, runQuery, runQueryMatches, saveGroup, saveMetadata, saveSyncResult, scanPhase, startHttpServer, startMcpStdio, structurePhase, syncGroup, textSearch, topologicalSort, traceFlow, upsertRepo, validateDAG };