@aicodepulse/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,142 @@
+import BetterSqlite3 from 'better-sqlite3';
+
+interface IndexMeta {
+    schemaVersion: number;
+    lastIndexedCommit: string;
+    lastIndexedAt: number;
+    repoRoot: string;
+    totalFiles: number;
+    totalSymbols: number;
+}
+type SymbolKind = 'function' | 'class' | 'interface' | 'type' | 'enum' | 'variable' | 'constant' | 'method' | 'property' | 'module';
+interface FileRecord {
+    id: number;
+    path: string;
+    language: string;
+    contentHash: string;
+    sizeBytes: number;
+    linesTotal: number;
+    indexedAt: number;
+    isDeleted: boolean;
+}
+interface CodeSymbol {
+    id: number;
+    fileId: number;
+    filePath: string;
+    name: string;
+    kind: SymbolKind;
+    line: number;
+    endLine: number;
+    isExported: boolean;
+    signature: string | null;
+    docComment: string | null;
+    parentName: string | null;
+}
+interface ImportEdge {
+    id: number;
+    fromFileId: number;
+    fromPath: string;
+    toPath: string | null;
+    toPackage: string | null;
+    importedNames: string[];
+    isTypeOnly: boolean;
+}
+type LayerName = 'repo_overview' | 'directory_map' | 'symbol_table' | 'import_graph' | 'focus';
+interface ContextRequest {
+    budgetTokens: number;
+    focusPath?: string;
+    format: 'markdown' | 'xml';
+    layers?: LayerName[];
+}
+interface LayerResult {
+    layer: LayerName;
+    tokensUsed: number;
+    content: string;
+    truncated: boolean;
+}
+interface ContextResult {
+    totalTokens: number;
+    budgetTokens: number;
+    layers: LayerResult[];
+    rendered: string;
+}
+interface CodePulseConfig {
+    exclude: string[];
+    maxFileSizeBytes: number;
+    defaultBudgetTokens: number;
+    layerWeights: Record<LayerName, number>;
+    languages?: string[];
+}
+declare const DEFAULT_CONFIG: CodePulseConfig;
+
+type DB = BetterSqlite3.Database;
+declare function openDatabase(dbPath: string): DB;
+
+declare class FileRepository {
+    private db;
+    constructor(db: DB);
+    upsert(file: Omit<FileRecord, 'id'>): number;
+    getByPath(path: string): FileRecord | null;
+    markDeleted(path: string): void;
+    getAllActive(): FileRecord[];
+    getLanguageStats(): {
+        language: string;
+        count: number;
+    }[];
+}
+
+declare class SymbolRepository {
+    private db;
+    constructor(db: DB);
+    insertSymbols(fileId: number, symbols: Omit<CodeSymbol, 'id'>[]): void;
+    insertImports(fileId: number, edges: Omit<ImportEdge, 'id'>[]): void;
+    deleteByFileId(fileId: number): void;
+    getExportedByFile(filePath: string): CodeSymbol[];
+    getAllExported(): CodeSymbol[];
+    search(query: string, limit?: number): CodeSymbol[];
+    getImportsFrom(filePath: string): ImportEdge[];
+    getImportersOf(filePath: string): string[];
+    getTopImportedFiles(limit?: number): {
+        path: string;
+        importerCount: number;
+    }[];
+}
+
+declare class MetaRepository {
+    private db;
+    constructor(db: DB);
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    getIndexMeta(): IndexMeta;
+    saveIndexMeta(commit: string, repoRoot: string): void;
+}
+
+interface IndexStats {
+    filesAdded: number;
+    filesUpdated: number;
+    filesDeleted: number;
+    filesSkipped: number;
+    symbolsTotal: number;
+    durationMs: number;
+    mode: 'full' | 'incremental';
+}
+declare class Indexer {
+    private db;
+    private repoRoot;
+    private config;
+    private parser;
+    private files;
+    private symbols;
+    private meta;
+    constructor(db: DB, repoRoot: string, config: CodePulseConfig);
+    runFull(): Promise<IndexStats>;
+    runIncremental(): Promise<IndexStats>;
+    private indexFile;
+    parseAndIndex(absolutePath: string, relativePath: string): Promise<void>;
+    runFullWithParsing(onProgress?: (done: number, total: number) => void): Promise<IndexStats>;
+    runIncrementalWithParsing(onProgress?: (done: number, total: number) => void): Promise<IndexStats>;
+}
+
+declare function generateContext(db: DB, request: ContextRequest, config: CodePulseConfig): ContextResult;
+
+export { type CodePulseConfig, type CodeSymbol, type ContextRequest, type ContextResult, DEFAULT_CONFIG, type FileRecord, FileRepository, type ImportEdge, type IndexMeta, type IndexStats, Indexer, type LayerName, type LayerResult, MetaRepository, type SymbolKind, SymbolRepository, generateContext, openDatabase };