aspectcode 0.2.2 → 0.3.0

package/node_modules/@aspectcode/emitters/dist/kb/kbEmitter.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * KB Emitter — orchestrates generation of a single `kb.md` file.
+ *
+ * Implements the Emitter interface. Consumes an AnalysisModel and writes
+ * a combined KB file via the EmitterHost abstraction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KB_FILENAME = void 0;
+exports.createKBEmitter = createKBEmitter;
+const depData_1 = require("./depData");
+const architectureEmitter_1 = require("./architectureEmitter");
+const mapEmitter_1 = require("./mapEmitter");
+const contextEmitter_1 = require("./contextEmitter");
+const manifest_1 = require("../manifest");
+const stableJson_1 = require("../stableJson");
+/** The default KB output filename. */
+exports.KB_FILENAME = 'kb.md';
+/**
+ * Create a KB emitter that generates a single `kb.md` knowledge base file.
+ *
+ * @param kbOptions  Optional KB-specific options (e.g. tree-sitter grammars).
+ */
+function createKBEmitter(kbOptions) {
+    return {
+        name: 'aspect-kb',
+        async emit(model, host, options) {
+            const generatedAt = options.generatedAt ?? new Date().toISOString();
+            const workspaceRoot = options.workspaceRoot;
+            const outDir = options.outDir ?? workspaceRoot;
+            // ── Derive shared data from the AnalysisModel ────────
+            // Absolute file paths
+            const files = model.files.map((f) => host.join(workspaceRoot, f.relativePath));
+            // Build file content cache from options or empty.
+            // Normalize keys so both CLI (relative paths) and extension (absolute paths)
+            // resolve consistently in downstream KB builders.
+            const fileContentCache = normalizeFileContentCache(options.fileContents, workspaceRoot, model.files.map((f) => f.relativePath), host);
+            // Build dependency links (absolute paths)
+            const allLinks = model.graph.edges.map((e) => ({
+                ...e,
+                source: host.join(workspaceRoot, e.source),
+                target: host.join(workspaceRoot, e.target),
+            }));
+            // Per-file in/out degree stats
+            const depData = (0, depData_1.buildDepStats)(files, allLinks);
+            const grammars = kbOptions?.grammars ?? null;
+            // ── Generate all three files in parallel ─────────────
+            const [archContent, mapContent, ctxContent] = await Promise.all([
+                Promise.resolve((0, architectureEmitter_1.buildArchitectureContent)({
+                    files,
+                    depData,
+                    allLinks,
+                    fileContentCache,
+                    workspaceRoot,
+                    generatedAt,
+                })),
+                Promise.resolve((0, mapEmitter_1.buildMapContent)({
+                    files,
+                    depData,
+                    allLinks,
+                    grammars,
+                    fileContentCache,
+                    workspaceRoot,
+                    generatedAt,
+                })),
+                Promise.resolve((0, contextEmitter_1.buildContextContent)({
+                    files,
+                    allLinks,
+                    fileContentCache,
+                    workspaceRoot,
+                    generatedAt,
+                })),
+            ]);
+            // ── Build manifest metadata as HTML comment ─────────
+            const manifest = (0, manifest_1.buildManifest)(model, generatedAt);
+            const manifestComment = `<!-- aspectcode: ${(0, stableJson_1.stableStringify)(manifest)} -->\n`;
+            // ── Combine into single kb.md ────────────────────────
+            const combined = [
+                archContent,
+                '\n---\n\n',
+                mapContent,
+                '\n---\n\n',
+                ctxContent,
+                '\n',
+                manifestComment,
+            ].join('');
+            const kbPath = host.join(outDir, exports.KB_FILENAME);
+            await host.writeFile(kbPath, combined);
+            return {
+                filesWritten: [kbPath],
+            };
+        },
+    };
+}
+function normalizeFileContentCache(source, workspaceRoot, relativePaths, host) {
+    const normalized = new Map();
+    if (!source || source.size === 0)
+        return normalized;
+    for (const [key, value] of source.entries()) {
+        normalized.set(key, value);
+    }
+    for (const relPath of relativePaths) {
+        const relPosix = relPath.replace(/\\/g, '/');
+        const relWindows = relPath.replace(/\//g, '\\');
+        const absPath = host.join(workspaceRoot, relPath);
+        const absPosix = absPath.replace(/\\/g, '/');
+        const absWindows = absPath.replace(/\//g, '\\');
+        const content = normalized.get(absPath) ??
+            normalized.get(absPosix) ??
+            normalized.get(absWindows) ??
+            normalized.get(relPath) ??
+            normalized.get(relPosix) ??
+            normalized.get(relWindows);
+        if (content === undefined)
+            continue;
+        normalized.set(absPath, content);
+        normalized.set(absPosix, content);
+        normalized.set(absWindows, content);
+        normalized.set(relPath, content);
+        normalized.set(relPosix, content);
+        normalized.set(relWindows, content);
+    }
+    return normalized;
+}
+//# sourceMappingURL=kbEmitter.js.map

package/node_modules/@aspectcode/emitters/dist/kb/kbEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kbEmitter.js","sourceRoot":"","sources":["../../src/kb/kbEmitter.ts"],"names":[],"mappings":"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"}

package/node_modules/@aspectcode/emitters/dist/kb/mapEmitter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Map emitter — generates `map.md` content.
+ *
+ * Pure function: takes data, returns a markdown string.
+ * No I/O, no vscode.
+ */
+import type { DependencyLink } from '@aspectcode/core';
+import type { LoadedGrammars } from './symbols';
+export interface MapEmitterInput {
+    files: string[];
+    depData: Map<string, {
+        inDegree: number;
+        outDegree: number;
+    }>;
+    allLinks: DependencyLink[];
+    grammars: LoadedGrammars | null | undefined;
+    fileContentCache: Map<string, string>;
+    workspaceRoot: string;
+    generatedAt: string;
+}
+/**
+ * Build the full `map.md` content string.
+ * Deterministic for the same inputs.
+ */
+export declare function buildMapContent(input: MapEmitterInput): string;
+//# sourceMappingURL=mapEmitter.d.ts.map

package/node_modules/@aspectcode/emitters/dist/kb/mapEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapEmitter.d.ts","sourceRoot":"","sources":["../../src/kb/mapEmitter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA6P9D"}

package/node_modules/@aspectcode/emitters/dist/kb/mapEmitter.js

@@ -0,0 +1,255 @@
+"use strict";
+/**
+ * Map emitter — generates `map.md` content.
+ *
+ * Pure function: takes data, returns a markdown string.
+ * No I/O, no vscode.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMapContent = buildMapContent;
+const path = __importStar(require("path"));
+const constants_1 = require("./constants");
+const helpers_1 = require("./helpers");
+const classifiers_1 = require("./classifiers");
+const entryPoints_1 = require("./entryPoints");
+const detectors_1 = require("./detectors");
+const symbols_1 = require("./symbols");
+const conventions_1 = require("./conventions");
+/**
+ * Build the full `map.md` content string.
+ * Deterministic for the same inputs.
+ */
+function buildMapContent(input) {
+    const { files, depData: _depData, allLinks, grammars, fileContentCache, workspaceRoot, generatedAt } = input;
+    let content = '# Map\n\n';
+    content +=
+        '_Symbol index with signatures and conventions. Use to find types, functions, and coding patterns._\n\n';
+    const appFiles = files.filter((f) => (0, classifiers_1.classifyFile)(f, workspaceRoot) === 'app');
+    // ── DATA MODELS ──────────────────────────────────────────
+    const dataModels = (0, detectors_1.getKBEnrichments)('DATA_MODEL', appFiles, workspaceRoot, fileContentCache);
+    if (dataModels.length > 0) {
+        content += '## Data Models\n\n';
+        content += '_Core data structures. Check these before modifying data handling._\n\n';
+        // Group by type
+        const ormModels = dataModels.filter((f) => f.message.includes('ORM') || f.message.includes('Entity') || f.message.includes('SQLModel'));
+        const dataClasses = dataModels.filter((f) => f.message.includes('Data Class') ||
+            f.message.includes('dataclass') ||
+            f.message.includes('Pydantic') ||
+            f.message.includes('BaseModel'));
+        const interfaces = dataModels.filter((f) => f.message.includes('Interface') ||
+            f.message.includes('Type Alias') ||
+            f.message.includes('type '));
+        const other = dataModels.filter((f) => !ormModels.includes(f) && !dataClasses.includes(f) && !interfaces.includes(f));
+        // Pre-extract model signatures
+        const allModelsToExtract = [
+            ...ormModels.slice(0, 15).map((m) => ({ model: m, type: 'orm' })),
+            ...dataClasses.slice(0, 15).map((m) => ({ model: m, type: 'dataclass' })),
+            ...interfaces.slice(0, 15).map((m) => ({ model: m, type: 'interface' })),
+        ];
+        const signatureMap = new Map();
+        for (const { model } of allModelsToExtract) {
+            const modelInfo = model.message.replace('Data model: ', '').replace('ORM model: ', '');
+            const signature = (0, symbols_1.extractModelSignature)(model.file, modelInfo, fileContentCache);
+            signatureMap.set(model.file, { modelInfo, signature });
+        }
+        if (ormModels.length > 0) {
+            content += '### ORM / Database Models\n\n';
+            for (const model of ormModels.slice(0, 15)) {
+                const relPath = (0, helpers_1.makeRelativePath)(model.file, workspaceRoot);
+                const data = signatureMap.get(model.file);
+                if (data?.signature) {
+                    content += `**\`${relPath}\`**: \`${data.signature}\`\n\n`;
+                }
+                else {
+                    const modelInfo = model.message.replace('Data model: ', '').replace('ORM model: ', '');
+                    content += `**\`${relPath}\`**: ${modelInfo}\n\n`;
+                }
+            }
+        }
+        if (dataClasses.length > 0) {
+            content += '### Pydantic / Data Classes\n\n';
+            for (const model of dataClasses.slice(0, 15)) {
+                const relPath = (0, helpers_1.makeRelativePath)(model.file, workspaceRoot);
+                const data = signatureMap.get(model.file);
+                if (data?.signature) {
+                    content += `**\`${relPath}\`**: \`${data.signature}\`\n\n`;
+                }
+                else {
+                    let modelInfo = model.message.replace('Data model: ', '');
+                    modelInfo = modelInfo.replace(/\s*\([^)]+\)\s*-\s*\w+\s*$/, '');
+                    content += `**\`${relPath}\`**: ${modelInfo}\n\n`;
+                }
+            }
+        }
+        if (interfaces.length > 0) {
+            content += '### TypeScript Interfaces & Types\n\n';
+            for (const model of interfaces.slice(0, 15)) {
+                const relPath = (0, helpers_1.makeRelativePath)(model.file, workspaceRoot);
+                const data = signatureMap.get(model.file);
+                if (data?.signature) {
+                    content += `**\`${relPath}\`**: \`${data.signature}\`\n\n`;
+                }
+                else {
+                    const modelInfo = model.message.replace('Data model: ', '');
+                    content += `**\`${relPath}\`**: ${modelInfo}\n\n`;
+                }
+            }
+        }
+        if (other.length > 0) {
+            content += '### Other Data Structures\n\n';
+            for (const model of other.slice(0, 10)) {
+                const relPath = (0, helpers_1.makeRelativePath)(model.file, workspaceRoot);
+                content += `- \`${relPath}\`: ${model.message}\n`;
+            }
+            content += '\n';
+        }
+    }
+    // ── SYMBOL INDEX ─────────────────────────────────────────
+    const relevantFiles = new Set();
+    for (const link of allLinks) {
+        relevantFiles.add(link.source);
+        relevantFiles.add(link.target);
+    }
+    if (relevantFiles.size > 0) {
+        content += '## Symbol Index\n\n';
+        content += '_Functions, classes, and exports with call relationships._\n\n';
+        // Build set of architecturally important files
+        const archFiles = new Set();
+        for (const model of dataModels) {
+            if ((0, classifiers_1.classifyFile)(model.file, workspaceRoot) === 'app') {
+                archFiles.add(model.file);
+            }
+        }
+        const entryPointFindings = (0, entryPoints_1.detectEntryPointsWithContent)(appFiles, workspaceRoot, fileContentCache).map((e) => ({ file: path.join(workspaceRoot, e.path), message: e.reason }));
+        const integrationFindings = (0, detectors_1.getKBEnrichments)('EXTERNAL_INTEGRATION', appFiles, workspaceRoot, fileContentCache);
+        for (const f of entryPointFindings) {
+            if ((0, classifiers_1.classifyFile)(f.file, workspaceRoot) === 'app')
+                archFiles.add(f.file);
+        }
+        for (const f of integrationFindings) {
+            if ((0, classifiers_1.classifyFile)(f.file, workspaceRoot) === 'app')
+                archFiles.add(f.file);
+        }
+        // Score files by importance
+        const fileScores = new Map();
+        for (const file of relevantFiles) {
+            const kind = (0, classifiers_1.classifyFile)(file, workspaceRoot);
+            if (kind === 'third_party')
+                continue;
+            const base = kind === 'test' ? -10 : 0;
+            const archBoost = archFiles.has(file) ? 25 : 0;
+            const outLinks = allLinks.filter((l) => l.source === file).length;
+            const inLinks = allLinks.filter((l) => l.target === file).length;
+            const score = base + archBoost + inLinks * 2 + outLinks;
+            fileScores.set(file, score);
+        }
+        const sortedFiles = Array.from(fileScores.entries())
+            .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+            .slice(0, 40)
+            .map(([file]) => file);
+        // Extract symbols
+        const symbolExtractionResults = [];
+        for (const file of sortedFiles) {
+            const symbols = (0, symbols_1.extractFileSymbolsWithSignatures)(file, allLinks, workspaceRoot, grammars, fileContentCache);
+            symbolExtractionResults.push({ file, symbols });
+        }
+        for (const { file, symbols } of symbolExtractionResults) {
+            if (symbols.length === 0)
+                continue;
+            const relPath = (0, helpers_1.makeRelativePath)(file, workspaceRoot);
+            content += `### \`${relPath}\`\n\n`;
+            content += '| Symbol | Kind | Signature | Used In (files) |\n';
+            content += '|--------|------|-----------|----------------|\n';
+            for (const symbol of symbols.slice(0, 12)) {
+                const sig = symbol.signature ? `\`${symbol.signature}\`` : '—';
+                const sortedCallers = [...symbol.calledBy].sort();
+                const usedIn = sortedCallers
+                    .slice(0, 2)
+                    .map((c) => `\`${c}\``)
+                    .join(', ') || '—';
+                content += `| \`${symbol.name}\` | ${symbol.kind} | ${sig} | ${usedIn} |\n`;
+            }
+            if (symbols.length > 12) {
+                content += `\n_+${symbols.length - 12} more symbols_\n`;
+            }
+            content += '\n';
+        }
+    }
+    // ── CONVENTIONS ──────────────────────────────────────────
+    if (appFiles.length > 0) {
+        content += '---\n\n';
+        content += '## Conventions\n\n';
+        content += '_Naming patterns and styles. Follow these for consistency._\n\n';
+        // File naming
+        const fileNaming = (0, conventions_1.analyzeFileNaming)(appFiles, workspaceRoot);
+        if (fileNaming.patterns.length > 0) {
+            content += '### File Naming\n\n';
+            content += '| Pattern | Example | Count |\n';
+            content += '|---------|---------|-------|\n';
+            for (const pattern of fileNaming.patterns.slice(0, 4)) {
+                content += `| ${pattern.style} | \`${pattern.example}\` | ${pattern.count} |\n`;
+            }
+            content += '\n';
+            if (fileNaming.dominant) {
+                content += `**Use:** ${fileNaming.dominant} for new files.\n\n`;
+            }
+        }
+        // Function naming patterns
+        const funcNaming = (0, conventions_1.analyzeFunctionNaming)(appFiles, fileContentCache);
+        if (funcNaming.patterns.length > 0) {
+            content += '### Function Naming\n\n';
+            for (const pattern of funcNaming.patterns.slice(0, 5)) {
+                content += `- \`${pattern.pattern}\` → \`${pattern.example}\` (${pattern.usage})\n`;
+            }
+            content += '\n';
+        }
+        // Framework patterns
+        const frameworkPatterns = (0, conventions_1.detectFrameworkPatterns)(appFiles, workspaceRoot);
+        if (frameworkPatterns.length > 0) {
+            content += '### Framework Patterns\n\n';
+            for (const fw of frameworkPatterns) {
+                content += `**${fw.name}:**\n`;
+                for (const pattern of fw.patterns.slice(0, 3)) {
+                    content += `- ${pattern}\n`;
+                }
+                content += '\n';
+            }
+        }
+    }
+    content += `\n_Generated: ${generatedAt}_\n`;
+    return (0, helpers_1.enforceLineBudget)(content, constants_1.KB_SIZE_LIMITS.map, 'map.md', generatedAt);
+}
+//# sourceMappingURL=mapEmitter.js.map

package/node_modules/@aspectcode/emitters/dist/kb/mapEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapEmitter.js","sourceRoot":"","sources":["../../src/kb/mapEmitter.ts"],"names":[],"mappings":"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"}

package/node_modules/@aspectcode/emitters/dist/kb/policy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared KB output policy.
+ *
+ * Centralizes:
+ * - newline normalization
+ * - line counting
+ * - truncation footer wording
+ */
+export declare function normalizeNewlines(text: string): string;
+export declare function splitLines(text: string): string[];
+export declare function truncationFooter(maxLines: number, omittedLines: number, generatedAt: string): string[];
+//# sourceMappingURL=policy.d.ts.map

package/node_modules/@aspectcode/emitters/dist/kb/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/kb/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOtG"}

package/node_modules/@aspectcode/emitters/dist/kb/policy.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Shared KB output policy.
+ *
+ * Centralizes:
+ * - newline normalization
+ * - line counting
+ * - truncation footer wording
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeNewlines = normalizeNewlines;
+exports.splitLines = splitLines;
+exports.truncationFooter = truncationFooter;
+function normalizeNewlines(text) {
+    // Normalize CRLF and CR-only to LF for stable line counting.
+    return text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+}
+function splitLines(text) {
+    return normalizeNewlines(text).split('\n');
+}
+function truncationFooter(maxLines, omittedLines, generatedAt) {
+    return [
+        '',
+        `_[Content truncated at ${maxLines} lines. ${omittedLines} lines omitted.]_`,
+        '',
+        `_Generated: ${generatedAt}_`,
+    ];
+}
+//# sourceMappingURL=policy.js.map

package/node_modules/@aspectcode/emitters/dist/kb/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/kb/policy.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAEH,8CAGC;AAED,gCAEC;AAED,4CAOC;AAhBD,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,6DAA6D;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAAgB,EAAE,YAAoB,EAAE,WAAmB;IAC1F,OAAO;QACL,EAAE;QACF,0BAA0B,QAAQ,WAAW,YAAY,mBAAmB;QAC5E,EAAE;QACF,eAAe,WAAW,GAAG;KAC9B,CAAC;AACJ,CAAC"}

package/node_modules/@aspectcode/emitters/dist/kb/symbols.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Symbol-extraction helpers for the KB emitter.
+ *
+ * - extractModelSignature  – one-line model signature from content
+ * - extractFileSymbolsWithSignatures – all exported symbols in a file
+ *
+ * Regex-based fallback; tree-sitter support is injected via `grammars`
+ * parameter following the existing kb.ts contract.
+ *
+ * All functions are pure (no I/O, no vscode).
+ */
+import { DependencyLink, ExtractedSymbol } from '@aspectcode/core';
+export interface LoadedGrammars {
+    python?: unknown;
+    typescript?: unknown;
+    tsx?: unknown;
+    javascript?: unknown;
+    java?: unknown;
+    csharp?: unknown;
+}
+export type SymbolExtractor = (grammar: unknown, text: string) => ExtractedSymbol[];
+export interface SymbolExtractors {
+    extractPythonSymbols?: SymbolExtractor;
+    extractTSJSSymbols?: SymbolExtractor;
+    extractJavaSymbols?: SymbolExtractor;
+    extractCSharpSymbols?: SymbolExtractor;
+}
+/**
+ * Extract a one-line signature for a named model/class/interface
+ * from the file content cache.
+ */
+export declare function extractModelSignature(filePath: string, modelName: string, fileContentCache: Map<string, string>): string | null;
+/**
+ * Extract all exported symbols from a file with optional tree-sitter support.
+ * Falls back to regex-based extraction when grammars are not available.
+ */
+export declare function extractFileSymbolsWithSignatures(filePath: string, allLinks: DependencyLink[], workspaceRoot: string, grammars: LoadedGrammars | null | undefined, fileContentCache: Map<string, string>, extractors?: SymbolExtractors): Array<{
+    name: string;
+    kind: string;
+    signature: string | null;
+    calledBy: string[];
+}>;
+//# sourceMappingURL=symbols.d.ts.map

package/node_modules/@aspectcode/emitters/dist/kb/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/kb/symbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAW,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAK5E,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,eAAe,EAAE,CAAC;AAEpF,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB,CAAC,EAAE,eAAe,CAAC;IACvC,kBAAkB,CAAC,EAAE,eAAe,CAAC;IACrC,kBAAkB,CAAC,EAAE,eAAe,CAAC;IACrC,oBAAoB,CAAC,EAAE,eAAe,CAAC;CACxC;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM,GAAG,IAAI,CAwBf;AAuGD;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,EAAE,EAC1B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,EAC3C,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,UAAU,CAAC,EAAE,gBAAgB,GAC5B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqDrF"}