aspectcode 0.2.1 → 0.3.0

package/node_modules/@aspectcode/core/dist/parsers/tsJsExtractors.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * TypeScript/JavaScript import and symbol extraction using tree-sitter AST.
+ *
+ * Pure functions — no vscode dependency, only web-tree-sitter.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTSJSImports = extractTSJSImports;
+exports.extractTSJSSymbols = extractTSJSSymbols;
+const web_tree_sitter_1 = __importDefault(require("web-tree-sitter"));
+const utils_1 = require("./utils");
+// ── Import extraction ────────────────────────────────────────
+/**
+ * Extract TS/JS import module specifiers from source code.
+ *
+ * Handles ES `import … from "…"`, CommonJS `require("…")`,
+ * and dynamic `import("…")`.
+ */
+function extractTSJSImports(lang, code) {
+    const parser = new web_tree_sitter_1.default();
+    parser.setLanguage(lang);
+    const tree = parser.parse(code);
+    const root = tree.rootNode;
+    const out = [];
+    const walk = (n) => {
+        if (n.type === 'import_statement' || n.type === 'import_declaration') {
+            const source = n.namedChildren.find((ch) => ch.type === 'string' || ch.type === 'string_literal');
+            if (source) {
+                const txt = (0, utils_1.textFor)(code, source).trim();
+                const m = txt.match(/^['"](.+?)['"]$/);
+                if (m)
+                    out.push(m[1]);
+            }
+        }
+        if (n.type === 'call_expression') {
+            const callee = n.child(0);
+            if (callee && callee.type === 'identifier' && (0, utils_1.textFor)(code, callee) === 'require') {
+                const arg = n.namedChildren.find((ch) => ch.type === 'string' || ch.type === 'string_literal');
+                if (arg) {
+                    const m = (0, utils_1.textFor)(code, arg)
+                        .trim()
+                        .match(/^['"](.+?)['"]$/);
+                    if (m)
+                        out.push(m[1]);
+                }
+            }
+        }
+        for (const ch of n.namedChildren) {
+            walk(ch);
+        }
+    };
+    walk(root);
+    tree.delete();
+    return out;
+}
+// ── Symbol extraction ────────────────────────────────────────
+/**
+ * Extract symbols from TypeScript/JavaScript code.
+ *
+ * Covers: functions, classes, interfaces, type aliases, const
+ * declarations (including arrow functions), and abstract classes.
+ */
+function extractTSJSSymbols(lang, code) {
+    const parser = new web_tree_sitter_1.default();
+    parser.setLanguage(lang);
+    const tree = parser.parse(code);
+    const root = tree.rootNode;
+    const symbols = [];
+    const walk = (n) => {
+        if (n.type === 'export_statement') {
+            const declaration = n.namedChildren.find((ch) => ch.type === 'function_declaration' ||
+                ch.type === 'class_declaration' ||
+                ch.type === 'interface_declaration' ||
+                ch.type === 'type_alias_declaration' ||
+                ch.type === 'lexical_declaration' ||
+                ch.type === 'abstract_class_declaration');
+            if (declaration) {
+                extractDeclaration(declaration, true);
+            }
+        }
+        if ([
+            'function_declaration',
+            'class_declaration',
+            'interface_declaration',
+            'abstract_class_declaration',
+        ].includes(n.type)) {
+            if (n.parent?.type !== 'export_statement') {
+                extractDeclaration(n, false);
+            }
+        }
+        for (const ch of n.namedChildren) {
+            walk(ch);
+        }
+    };
+    const extractDeclaration = (n, exported) => {
+        if (n.type === 'function_declaration') {
+            const nameNode = n.namedChildren.find((ch) => ch.type === 'identifier');
+            const paramsNode = n.namedChildren.find((ch) => ch.type === 'formal_parameters');
+            if (nameNode) {
+                const name = (0, utils_1.textFor)(code, nameNode);
+                const params = paramsNode ? extractTSJSParams(code, paramsNode) : [];
+                symbols.push({
+                    name,
+                    kind: 'function',
+                    signature: `function ${name}(${params.join(', ')})`,
+                    exported,
+                });
+            }
+        }
+        if (n.type === 'class_declaration' || n.type === 'abstract_class_declaration') {
+            const nameNode = n.namedChildren.find((ch) => ch.type === 'type_identifier');
+            const heritageNode = n.namedChildren.find((ch) => ch.type === 'class_heritage');
+            if (nameNode) {
+                const name = (0, utils_1.textFor)(code, nameNode);
+                let inherits;
+                if (heritageNode) {
+                    const extendsClause = heritageNode.namedChildren.find((ch) => ch.type === 'extends_clause');
+                    if (extendsClause) {
+                        const typeId = extendsClause.namedChildren.find((ch) => ch.type === 'type_identifier' || ch.type === 'identifier');
+                        if (typeId) {
+                            inherits = (0, utils_1.textFor)(code, typeId);
+                        }
+                    }
+                }
+                symbols.push({
+                    name,
+                    kind: 'class',
+                    signature: inherits ? `class ${name} extends ${inherits}` : `class ${name}`,
+                    inherits,
+                    exported,
+                });
+            }
+        }
+        if (n.type === 'interface_declaration') {
+            const nameNode = n.namedChildren.find((ch) => ch.type === 'type_identifier');
+            const extendsClause = n.namedChildren.find((ch) => ch.type === 'extends_type_clause');
+            if (nameNode) {
+                const name = (0, utils_1.textFor)(code, nameNode);
+                let inherits;
+                if (extendsClause) {
+                    const typeId = extendsClause.namedChildren.find((ch) => ch.type === 'type_identifier' || ch.type === 'generic_type');
+                    if (typeId) {
+                        inherits = (0, utils_1.textFor)(code, typeId);
+                    }
+                }
+                symbols.push({
+                    name,
+                    kind: 'interface',
+                    signature: inherits ? `interface ${name} extends ${inherits}` : `interface ${name}`,
+                    inherits,
+                    exported,
+                });
+            }
+        }
+        if (n.type === 'type_alias_declaration') {
+            const nameNode = n.namedChildren.find((ch) => ch.type === 'type_identifier');
+            if (nameNode) {
+                const name = (0, utils_1.textFor)(code, nameNode);
+                symbols.push({
+                    name,
+                    kind: 'type',
+                    signature: `type ${name}`,
+                    exported,
+                });
+            }
+        }
+        if (n.type === 'lexical_declaration') {
+            for (const declarator of n.namedChildren) {
+                if (declarator.type === 'variable_declarator') {
+                    const nameNode = declarator.namedChildren.find((ch) => ch.type === 'identifier');
+                    if (nameNode) {
+                        const name = (0, utils_1.textFor)(code, nameNode);
+                        const arrowFn = declarator.namedChildren.find((ch) => ch.type === 'arrow_function');
+                        if (arrowFn) {
+                            const paramsNode = arrowFn.namedChildren.find((ch) => ch.type === 'formal_parameters' || ch.type === 'identifier');
+                            let params = [];
+                            if (paramsNode) {
+                                if (paramsNode.type === 'formal_parameters') {
+                                    params = extractTSJSParams(code, paramsNode);
+                                }
+                                else if (paramsNode.type === 'identifier') {
+                                    params = [(0, utils_1.textFor)(code, paramsNode)];
+                                }
+                            }
+                            const paramStr = params.length > 0 ? params.join(', ') : '';
+                            symbols.push({
+                                name,
+                                kind: 'const',
+                                signature: `const ${name} = (${paramStr}) =>`,
+                                exported,
+                            });
+                        }
+                        else {
+                            symbols.push({
+                                name,
+                                kind: 'const',
+                                signature: `const ${name}`,
+                                exported,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+    };
+    walk(root);
+    tree.delete();
+    return symbols;
+}
+// ── Helpers ──────────────────────────────────────────────────
+function extractTSJSParams(code, paramsNode) {
+    const params = [];
+    for (const ch of paramsNode.namedChildren) {
+        if (ch.type === 'identifier') {
+            params.push((0, utils_1.textFor)(code, ch));
+        }
+        else if (ch.type === 'required_parameter' || ch.type === 'optional_parameter') {
+            const pattern = ch.namedChildren.find((c) => c.type === 'identifier' || c.type === 'object_pattern' || c.type === 'array_pattern');
+            if (pattern) {
+                if (pattern.type === 'identifier') {
+                    params.push((0, utils_1.textFor)(code, pattern));
+                }
+                else {
+                    params.push('...');
+                }
+            }
+        }
+        else if (ch.type === 'rest_pattern') {
+            const idNode = ch.namedChildren.find((c) => c.type === 'identifier');
+            if (idNode) {
+                params.push('...' + (0, utils_1.textFor)(code, idNode));
+            }
+        }
+    }
+    return params.slice(0, 4);
+}
+//# sourceMappingURL=tsJsExtractors.js.map

package/node_modules/@aspectcode/core/dist/parsers/tsJsExtractors.js.map

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

package/node_modules/@aspectcode/core/dist/parsers/utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared utility functions for tree-sitter AST extractors.
+ */
+import Parser from 'web-tree-sitter';
+/** Extract the source text for a syntax node. */
+export declare function textFor(source: string, node: Parser.SyntaxNode): string;
+//# sourceMappingURL=utils.d.ts.map

package/node_modules/@aspectcode/core/dist/parsers/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/parsers/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,MAAM,MAAM,iBAAiB,CAAC;AAErC,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAEvE"}

package/node_modules/@aspectcode/core/dist/parsers/utils.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Shared utility functions for tree-sitter AST extractors.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.textFor = textFor;
+/** Extract the source text for a syntax node. */
+function textFor(source, node) {
+    return source.slice(node.startIndex, node.endIndex);
+}
+//# sourceMappingURL=utils.js.map

package/node_modules/@aspectcode/core/dist/parsers/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/parsers/utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAKH,0BAEC;AAHD,iDAAiD;AACjD,SAAgB,OAAO,CAAC,MAAc,EAAE,IAAuB;IAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC"}

package/node_modules/@aspectcode/core/dist/paths.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Posix-path normalization — the single source of truth for path format
+ * at the model boundary.
+ *
+ * Every path stored in AnalysisModel (relativePath, graph node ids, edge
+ * source/target, hub file, FileSymbols.file) MUST pass through `toPosix()`
+ * before being written into the model. This prevents platform-dependent
+ * backslash paths from leaking into JSON output.
+ */
+/**
+ * Convert any path to forward-slash (posix) form.
+ *
+ * - Replaces all backslashes with forward slashes
+ * - Strips leading `./`
+ * - Collapses consecutive slashes
+ *
+ * Safe to call on paths that are already posix — idempotent.
+ */
+export declare function toPosix(p: string): string;
+/**
+ * Convert an absolute path to a workspace-relative posix path.
+ *
+ * If the path starts with `workspaceRoot` the prefix is stripped; otherwise
+ * the filename (basename) is returned as a fallback.
+ */
+export declare function makeRelativePath(absPath: string, workspaceRoot: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/node_modules/@aspectcode/core/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKzC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAS/E"}

package/node_modules/@aspectcode/core/dist/paths.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Posix-path normalization — the single source of truth for path format
+ * at the model boundary.
+ *
+ * Every path stored in AnalysisModel (relativePath, graph node ids, edge
+ * source/target, hub file, FileSymbols.file) MUST pass through `toPosix()`
+ * before being written into the model. This prevents platform-dependent
+ * backslash paths from leaking into JSON output.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPosix = toPosix;
+exports.makeRelativePath = makeRelativePath;
+/**
+ * Convert any path to forward-slash (posix) form.
+ *
+ * - Replaces all backslashes with forward slashes
+ * - Strips leading `./`
+ * - Collapses consecutive slashes
+ *
+ * Safe to call on paths that are already posix — idempotent.
+ */
+function toPosix(p) {
+    return p
+        .replace(/\\/g, '/')
+        .replace(/\/\/+/g, '/')
+        .replace(/^\.\//, '');
+}
+/**
+ * Convert an absolute path to a workspace-relative posix path.
+ *
+ * If the path starts with `workspaceRoot` the prefix is stripped; otherwise
+ * the filename (basename) is returned as a fallback.
+ */
+function makeRelativePath(absPath, workspaceRoot) {
+    const normalizedAbs = toPosix(absPath);
+    const normalizedRoot = toPosix(workspaceRoot).replace(/\/$/, '');
+    if (normalizedAbs.startsWith(normalizedRoot)) {
+        return normalizedAbs.substring(normalizedRoot.length).replace(/^\//, '');
+    }
+    // Fallback: return the basename
+    const parts = normalizedAbs.split('/');
+    return parts[parts.length - 1];
+}
+//# sourceMappingURL=paths.js.map

package/node_modules/@aspectcode/core/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAWH,0BAKC;AAQD,4CASC;AA/BD;;;;;;;;GAQG;AACH,SAAgB,OAAO,CAAC,CAAS;IAC/B,OAAO,CAAC;SACL,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,OAAe,EAAE,aAAqB;IACrE,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjE,IAAI,aAAa,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7C,OAAO,aAAa,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,gCAAgC;IAChC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC"}

package/node_modules/@aspectcode/core/dist/stats.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Model statistics — derived read-only summaries from an AnalysisModel.
+ *
+ * Emitters (markdown, HTML, JSON, etc.) should use these helpers instead
+ * of re-implementing counting/ranking logic.
+ */
+import type { AnalysisModel, GraphEdge, HubMetric } from './model';
+export interface ModelStats {
+    /** Total number of analyzed files */
+    fileCount: number;
+    /** Total lines of code across all files */
+    totalLines: number;
+    /** Count of files per detected language */
+    languageCounts: Record<string, number>;
+    /** Number of distinct languages */
+    languageCount: number;
+    /** Total number of graph edges (dependencies) */
+    edgeCount: number;
+    /** Number of circular dependency edges */
+    circularCount: number;
+    /** Number of bidirectional edges */
+    bidirectionalCount: number;
+    /** Total extracted symbols across all files */
+    symbolCount: number;
+    /** Top N hub files ranked by total degree (in + out) */
+    topHubs: HubMetric[];
+}
+/**
+ * Compute summary statistics from an AnalysisModel.
+ *
+ * @param model  The analysis model to summarize
+ * @param topN   How many top hubs to include (default 10)
+ */
+export declare function computeModelStats(model: AnalysisModel, topN?: number): ModelStats;
+/**
+ * Derive top-N hub files from graph edges, ranked by total degree.
+ *
+ * Also used by analysis/repo.ts when building the initial model.
+ */
+export declare function deriveHubs(edges: GraphEdge[], topN?: number): HubMetric[];
+//# sourceMappingURL=stats.d.ts.map

package/node_modules/@aspectcode/core/dist/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAInE,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,IAAI,SAAK,GACR,UAAU,CA4CZ;AAID;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,IAAI,SAAK,GAAG,SAAS,EAAE,CAsBrE"}

package/node_modules/@aspectcode/core/dist/stats.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Model statistics — derived read-only summaries from an AnalysisModel.
+ *
+ * Emitters (markdown, HTML, JSON, etc.) should use these helpers instead
+ * of re-implementing counting/ranking logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeModelStats = computeModelStats;
+exports.deriveHubs = deriveHubs;
+// ── Public API ───────────────────────────────────────────────
+/**
+ * Compute summary statistics from an AnalysisModel.
+ *
+ * @param model  The analysis model to summarize
+ * @param topN   How many top hubs to include (default 10)
+ */
+function computeModelStats(model, topN = 10) {
+    // Language counts & total lines
+    const languageCounts = {};
+    let totalLines = 0;
+    for (const f of model.files) {
+        languageCounts[f.language] = (languageCounts[f.language] ?? 0) + 1;
+        totalLines += f.lineCount;
+    }
+    // Edge classification
+    let circularCount = 0;
+    let bidirectionalCount = 0;
+    for (const e of model.graph.edges) {
+        if (e.type === 'circular')
+            circularCount++;
+        if (e.bidirectional)
+            bidirectionalCount++;
+    }
+    // Symbol count
+    let symbolCount = 0;
+    for (const fs of model.symbols) {
+        symbolCount += fs.symbols.length;
+    }
+    // Hubs — use model.metrics.hubs if populated, otherwise derive from edges
+    let topHubs;
+    if (model.metrics.hubs.length > 0) {
+        topHubs = [...model.metrics.hubs]
+            .sort((a, b) => b.inDegree + b.outDegree - (a.inDegree + a.outDegree))
+            .slice(0, topN);
+    }
+    else {
+        topHubs = deriveHubs(model.graph.edges, topN);
+    }
+    return {
+        fileCount: model.files.length,
+        totalLines,
+        languageCounts,
+        languageCount: Object.keys(languageCounts).length,
+        edgeCount: model.graph.edges.length,
+        circularCount,
+        bidirectionalCount,
+        symbolCount,
+        topHubs,
+    };
+}
+// ── Hub computation ──────────────────────────────────────────
+/**
+ * Derive top-N hub files from graph edges, ranked by total degree.
+ *
+ * Also used by analysis/repo.ts when building the initial model.
+ */
+function deriveHubs(edges, topN = 10) {
+    const inDeg = new Map();
+    const outDeg = new Map();
+    for (const e of edges) {
+        outDeg.set(e.source, (outDeg.get(e.source) ?? 0) + 1);
+        inDeg.set(e.target, (inDeg.get(e.target) ?? 0) + 1);
+    }
+    const allFiles = new Set([...inDeg.keys(), ...outDeg.keys()]);
+    const hubs = [];
+    for (const file of allFiles) {
+        hubs.push({
+            file,
+            inDegree: inDeg.get(file) ?? 0,
+            outDegree: outDeg.get(file) ?? 0,
+        });
+    }
+    return hubs
+        .sort((a, b) => b.inDegree + b.outDegree - (a.inDegree + a.outDegree))
+        .slice(0, topN);
+}
+//# sourceMappingURL=stats.js.map

package/node_modules/@aspectcode/core/dist/stats.js.map

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

package/node_modules/@aspectcode/core/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@aspectcode/core",
+  "version": "0.3.0",
+  "private": true,
+  "description": "Pure-logic core for Aspect Code — no VS Code dependency",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "parsers"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/asashepard/aspectcode.git",
+    "directory": "packages/core"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "test": "mocha --require ts-node/register 'test/**/*.test.ts'",
+    "test:snapshot": "mocha --require ts-node/register 'test/snapshot.test.ts'"
+  },
+  "dependencies": {
+    "web-tree-sitter": "^0.21.0"
+  },
+  "devDependencies": {
+    "@types/mocha": "^10.0.0",
+    "@types/node": "^22.0.0",
+    "mocha": "^10.4.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.5.4"
+  }
+}

package/node_modules/@aspectcode/emitters/dist/emitter.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Emitter interface — the contract for all artifact generators.
+ *
+ * Each emitter takes an AnalysisModel + options and writes files
+ * via the EmitterHost abstraction. Emitters MUST produce deterministic
+ * output for the same input (modulo `generatedAt` timestamps).
+ */
+import type { AnalysisModel } from '@aspectcode/core';
+import type { EmitterHost } from './host';
+/** Mode for instruction content generation. */
+export type InstructionsMode = 'safe' | 'permissive' | 'custom' | 'off';
+/** Options passed to every emitter. */
+export interface EmitOptions {
+    /** Absolute path to the workspace root. */
+    workspaceRoot: string;
+    /**
+     * Absolute path to the output root where generated artifacts are written.
+     *
+     * Defaults to `workspaceRoot`.
+     *
+     * This allows generating into a temp directory (tests/CLI/GitHub Action)
+     * without depending on CWD or VS Code workspace filesystem roots.
+     */
+    outDir?: string;
+    /**
+     * ISO-8601 timestamp to embed in outputs.
+     * Defaults to `new Date().toISOString()` if omitted.
+     * Pass a fixed value in tests for determinism.
+     */
+    generatedAt?: string;
+    /** Instruction content mode. */
+    instructionsMode?: InstructionsMode;
+    /** Pre-loaded file contents (avoids re-reading from disk). */
+    fileContents?: Map<string, string>;
+    /**
+     * Whether to generate the KB file (`kb.md`).
+     *
+     * Defaults to `false`. When `false`, only instruction files are emitted.
+     * Set to `true` to generate the knowledge base.
+     */
+    generateKb?: boolean;
+    /**
+     * List of output format IDs to emit instruction files for.
+     *
+     * When omitted or empty, only `AGENTS.md` is written (the universal target).
+     * Supported values: 'agents', 'copilot', 'cursor', 'claudeCode',
+     * 'windsurf', 'cline', 'gemini', 'aider', 'amazonq', 'codex'.
+     *
+     * AGENTS.md is always written regardless of this list.
+     */
+    outputFormats?: string[];
+}
+/** Result returned by an emitter after writing artifacts. */
+export interface EmitResult {
+    /** Absolute paths of all files written or updated. */
+    filesWritten: string[];
+}
+/** A named artifact generator. */
+export interface Emitter {
+    /** Human-readable name (e.g. "aspect-kb", "instructions"). */
+    readonly name: string;
+    /**
+     * Generate and write artifacts.
+     *
+     * @param model   The analysis model to consume.
+     * @param host    File I/O abstraction.
+     * @param options Generation options.
+     * @returns       Paths of all files written.
+     */
+    emit(model: AnalysisModel, host: EmitterHost, options: EmitOptions): Promise<EmitResult>;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/node_modules/@aspectcode/emitters/dist/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAI1C,+CAA+C;AAC/C,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExE,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAID,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAID,kCAAkC;AAClC,MAAM,WAAW,OAAO;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,IAAI,CACF,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB"}

package/node_modules/@aspectcode/emitters/dist/emitter.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Emitter interface — the contract for all artifact generators.
+ *
+ * Each emitter takes an AnalysisModel + options and writes files
+ * via the EmitterHost abstraction. Emitters MUST produce deterministic
+ * output for the same input (modulo `generatedAt` timestamps).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=emitter.js.map