@anhnguyen02/catlas 0.1.2

package/dist/extractor/ctags-runner.js

@@ -0,0 +1,99 @@
+import { spawnSync } from 'node:child_process';
+import os from 'node:os';
+import fs from 'node:fs';
+import { log } from '../utils/logger.js';
+export class CtagsRunner {
+    ctagsPath;
+    constructor() {
+        this.ctagsPath = this.findCtags();
+    }
+    findCtags() {
+        // macOS Homebrew paths (ARM and Intel)
+        const brewPaths = ['/opt/homebrew/bin/ctags', '/usr/local/bin/ctags'];
+        if (os.platform() === 'darwin') {
+            for (const p of brewPaths) {
+                if (fs.existsSync(p))
+                    return p;
+            }
+        }
+        return 'ctags';
+    }
+    extract(fileDataList, rootDir) {
+        const files = fileDataList.map(f => f.path);
+        if (files.length === 0)
+            return;
+        // Run ctags:
+        // --output-format=json: Easy to parse
+        // --fields=+nKZS: n=line, K=long kind, Z=scope, S=signature
+        // Language-specific kinds to extract
+        const baseArgs = [
+            '--output-format=json',
+            '--fields=+nKZS',
+            '--kinds-TypeScript=fcima', // function, class, interface, method, alias
+            '--kinds-JavaScript=fcm', // function, class, method
+            '--kinds-Python=fcm', // function, class, method
+            '--kinds-Go=fstim', // function, struct, type, interface, method
+            '--kinds-Rust=fstPim', // function, struct, type, implementation, method
+            '--kinds-Java=cim', // class, interface, method
+            '--kinds-Kotlin=cim' // class, interface, method
+        ];
+        const CHUNK_SIZE = 200;
+        const lines = [];
+        for (let i = 0; i < files.length; i += CHUNK_SIZE) {
+            const chunk = files.slice(i, i + CHUNK_SIZE);
+            const args = [...baseArgs, ...chunk];
+            const result = spawnSync(this.ctagsPath, args, { cwd: rootDir, encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 });
+            if (result.error || result.status !== 0) {
+                const errMsg = result.error ? result.error.message : `Process exited with status ${result.status}`;
+                log('warn', `Failed to run ctags cleanly. Error: ${errMsg}`);
+                if (result.error)
+                    return; // stop if totally missing
+            }
+            lines.push(...result.stdout.split('\n').filter(l => l.trim()));
+        }
+        // Group symbols by file path
+        const symbolsByFile = new Map();
+        for (const line of lines) {
+            if (!line.startsWith('{'))
+                continue;
+            try {
+                const tag = JSON.parse(line);
+                // Skip local scope variables/functions if possible (ctags 'scope' field helps)
+                // If it has a "scope" and scopeKind is "function", it's a local closure/variable. Skip.
+                if (tag.scopeKind === 'function' || tag.scopeKind === 'method') {
+                    continue;
+                }
+                // Safely determine kind
+                const validKinds = ['function', 'class', 'interface', 'type', 'variable', 'method', 'component', 'alias', 'constant', 'unknown'];
+                const kind = validKinds.includes(tag.kind) ? tag.kind : 'unknown';
+                // Basic heuristic for isExported (ctags may provide access: 'public' or roles string)
+                const isExported = tag.access === 'public' || (tag.roles && tag.roles.includes('exported')) || false;
+                const sym = {
+                    name: tag.name,
+                    kind,
+                    signature: tag.signature || '',
+                    line: tag.line || 0,
+                    isExported,
+                    fileRole: 'unknown',
+                    path: tag.path,
+                    inDegree: 0
+                };
+                if (!symbolsByFile.has(tag.path)) {
+                    symbolsByFile.set(tag.path, []);
+                }
+                symbolsByFile.get(tag.path).push(sym);
+            }
+            catch (e) {
+                // ignore malformed json lines
+            }
+        }
+        // Attach back to FileData
+        for (const fd of fileDataList) {
+            const syms = symbolsByFile.get(fd.path) || [];
+            // set file role to the symbol
+            syms.forEach(s => s.fileRole = fd.role);
+            fd.symbols = syms;
+        }
+    }
+}
+//# sourceMappingURL=ctags-runner.js.map

package/dist/extractor/ctags-runner.js.map

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

package/dist/extractor/import-graph.d.ts

@@ -0,0 +1,6 @@
+import type { FileData } from '../types.js';
+export declare class ImportGraph {
+    build(fileDataList: FileData[], language: string, rootDir: string): void;
+    private parseImports;
+}
+//# sourceMappingURL=import-graph.d.ts.map

package/dist/extractor/import-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-graph.d.ts","sourceRoot":"","sources":["../../src/extractor/import-graph.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,qBAAa,WAAW;IACf,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA+E/E,OAAO,CAAC,YAAY;CAiDrB"}

package/dist/extractor/import-graph.js

@@ -0,0 +1,127 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export class ImportGraph {
+    build(fileDataList, language, rootDir) {
+        const importMap = new Map(); // path -> array of imported relative paths
+        const inDegreeMap = new Map();
+        // Initialize inDegree map for all known files
+        fileDataList.forEach(fd => inDegreeMap.set(fd.path, 0));
+        // Pre-calculate stripped paths to avoid regex inside the loop
+        const strippedPaths = fileDataList.map(f => ({
+            path: f.path,
+            stripped: f.path.replace(/\.[a-z]+$/, '')
+        }));
+        // Fast exact match lookup
+        const exactLookup = new Map();
+        for (const f of strippedPaths) {
+            exactLookup.set(f.stripped, f.path);
+            exactLookup.set(`${f.stripped}/index`, f.path);
+        }
+        // 1. Parse imports
+        for (const fd of fileDataList) {
+            const content = fs.readFileSync(path.join(rootDir, fd.path), 'utf-8');
+            const imports = this.parseImports(content, language);
+            fd.imports = imports;
+            const dir = path.dirname(fd.path);
+            const resolvedImports = [];
+            for (const imp of imports) {
+                let resolvedPath = '';
+                let isAbsolute = false;
+                if (imp.startsWith('.')) {
+                    let normalizedImp = imp;
+                    if (language === 'python' && imp.match(/^\.+[a-zA-Z0-9_]/)) {
+                        normalizedImp = imp.replace(/^(\.+)(.*)$/, (m, dots, rest) => {
+                            if (dots.length === 1)
+                                return `./${rest}`;
+                            return '../'.repeat(dots.length - 1) + rest;
+                        });
+                    }
+                    resolvedPath = path.posix.join(dir, normalizedImp).replace(/\\/g, '/');
+                }
+                else if (imp.startsWith('~/') || imp.startsWith('@/')) {
+                    resolvedPath = imp.substring(2);
+                }
+                else {
+                    // absolute or node_module. Ex: python domain.models
+                    resolvedPath = imp.replace(/\./g, '/');
+                    isAbsolute = true;
+                }
+                // Drop extensions or try to match exactly
+                const rp = resolvedPath.replace(/\.[a-z]+$/, '');
+                let matchPath = exactLookup.get(rp);
+                if (!matchPath && isAbsolute) {
+                    // Fallback to suffix matching for absolute imports (e.g. Python imports missing src/ prefix)
+                    const target = strippedPaths.find(f => {
+                        return f.stripped.endsWith(`/${rp}`) || f.stripped.endsWith(`/${rp}/index`);
+                    });
+                    if (target)
+                        matchPath = target.path;
+                }
+                if (matchPath) {
+                    resolvedImports.push(matchPath);
+                    // Increment in-degree
+                    inDegreeMap.set(matchPath, (inDegreeMap.get(matchPath) || 0) + 1);
+                }
+            }
+            importMap.set(fd.path, resolvedImports);
+        }
+        // 2. Attach inDegree
+        for (const fd of fileDataList) {
+            fd.inDegree = inDegreeMap.get(fd.path) || 0;
+        }
+    }
+    parseImports(rawContent, language) {
+        // Strip comments to prevent false positive regex matches on strings/comments
+        const content = rawContent.replace(/\/\*[\s\S]*?\*\/|\/\/.*|#.*/g, '');
+        const imports = [];
+        if (language === 'typescript' || language === 'javascript') {
+            const es6Regex = /import\s+.*?\s+from\s+['"]([^'"]+)['"]/gs;
+            const exportRegex = /export\s+.*?\s+from\s+['"]([^'"]+)['"]/gs;
+            // side-effect imports: import 'y'
+            const sideEffectRegex = /import\s+['"]([^'"]+)['"]/g;
+            // dynamic imports: import('y')
+            const dynRegex = /import\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+            let match;
+            while ((match = es6Regex.exec(content)) !== null)
+                imports.push(match[1]);
+            while ((match = exportRegex.exec(content)) !== null)
+                imports.push(match[1]);
+            while ((match = sideEffectRegex.exec(content)) !== null)
+                imports.push(match[1]);
+            while ((match = dynRegex.exec(content)) !== null)
+                imports.push(match[1]);
+        }
+        else if (language === 'python') {
+            // from x import y
+            const pyRegex1 = /from\s+([^\s]+)\s+import/g;
+            // import x (only at start of line or after semicolon, to avoid matching 'from x import y')
+            const pyRegex2 = /(?:^|[\n;])\s*import\s+([^\r\n]+)/g;
+            let match;
+            while ((match = pyRegex1.exec(content)) !== null)
+                imports.push(match[1]);
+            while ((match = pyRegex2.exec(content)) !== null) {
+                const modules = match[1].split(',').map(m => m.trim().split(/\s+as\s+/)[0].trim());
+                imports.push(...modules);
+            }
+        }
+        else if (language === 'go') {
+            // Single import: import "fmt"
+            const goSingleRegex = /import\s+"([^"]+)"/g;
+            // Grouped import: import ( "fmt"\n "net/http" )
+            const goGroupRegex = /import\s*\(\s*([\s\S]*?)\)/g;
+            let match;
+            while ((match = goSingleRegex.exec(content)) !== null)
+                imports.push(match[1]);
+            while ((match = goGroupRegex.exec(content)) !== null) {
+                const block = match[1];
+                const lineRegex = /"([^"]+)"/g;
+                let lineMatch;
+                while ((lineMatch = lineRegex.exec(block)) !== null)
+                    imports.push(lineMatch[1]);
+            }
+        }
+        // Ensure uniqueness
+        return [...new Set(imports)];
+    }
+}
+//# sourceMappingURL=import-graph.js.map

package/dist/extractor/import-graph.js.map

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

package/dist/extractor/module-graph.d.ts

@@ -0,0 +1,16 @@
+import type { FileData, ModuleNode } from '../types.js';
+export declare class ModuleGraph {
+    /**
+     * Build a module-level (directory-level) dependency graph.
+     * Aggregates file-level import relationships into directory-level dependencies.
+     * This shows the high-level architecture: which modules depend on which.
+     */
+    build(fileDataList: FileData[]): ModuleNode[];
+    /**
+     * Get the module directory for a file path.
+     * Uses first 2 segments as grouping key (e.g., "server/api" for "server/api/payment.ts").
+     * Root-level files get "." as their module.
+     */
+    private getModuleDir;
+}
+//# sourceMappingURL=module-graph.d.ts.map

package/dist/extractor/module-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-graph.d.ts","sourceRoot":"","sources":["../../src/extractor/module-graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEvD,qBAAa,WAAW;IACtB;;;;OAIG;IACI,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE;IAqGpD;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAMrB"}

package/dist/extractor/module-graph.js

@@ -0,0 +1,108 @@
+import path from 'node:path';
+export class ModuleGraph {
+    /**
+     * Build a module-level (directory-level) dependency graph.
+     * Aggregates file-level import relationships into directory-level dependencies.
+     * This shows the high-level architecture: which modules depend on which.
+     */
+    build(fileDataList) {
+        // Map: module path → set of modules it depends on
+        const dependsOnMap = new Map();
+        // Map: module path → file count
+        const fileCountMap = new Map();
+        // 1. Count files per module and collect dependencies
+        for (const fd of fileDataList) {
+            const moduleDir = this.getModuleDir(fd.path);
+            fileCountMap.set(moduleDir, (fileCountMap.get(moduleDir) || 0) + 1);
+            if (!dependsOnMap.has(moduleDir)) {
+                dependsOnMap.set(moduleDir, new Set());
+            }
+        }
+        // 1.5 Pre-calculate lookups for fast import resolution
+        const strippedPaths = fileDataList.map(f => ({
+            path: f.path,
+            stripped: f.path.replace(/\.[a-z]+$/, '')
+        }));
+        const exactLookup = new Map();
+        for (const f of strippedPaths) {
+            exactLookup.set(f.stripped, f.path);
+            exactLookup.set(`${f.stripped}/index`, f.path);
+        }
+        // 2. Resolve imports to module-level dependencies
+        for (const fd of fileDataList) {
+            const sourceModule = this.getModuleDir(fd.path);
+            const deps = dependsOnMap.get(sourceModule);
+            for (const imp of fd.imports) {
+                let resolvedPath = '';
+                let isAbsolute = false;
+                if (imp.startsWith('.')) {
+                    resolvedPath = path.posix.join(path.dirname(fd.path), imp).replace(/\\/g, '/');
+                }
+                else if (imp.startsWith('~/') || imp.startsWith('@/')) {
+                    resolvedPath = imp.substring(2);
+                }
+                else {
+                    resolvedPath = imp.replace(/\./g, '/');
+                    isAbsolute = true;
+                }
+                const rp = resolvedPath.replace(/\.[a-z]+$/, '');
+                let targetPath = exactLookup.get(rp);
+                if (!targetPath && isAbsolute) {
+                    const target = strippedPaths.find(f => f.stripped.endsWith(`/${rp}`) || f.stripped.endsWith(`/${rp}/index`));
+                    if (target)
+                        targetPath = target.path;
+                }
+                if (targetPath) {
+                    const targetModule = this.getModuleDir(targetPath);
+                    // Skip self-references (same module)
+                    if (targetModule !== sourceModule) {
+                        deps.add(targetModule);
+                    }
+                }
+            }
+        }
+        // 3. Build reverse map (dependedBy)
+        const dependedByMap = new Map();
+        for (const moduleDir of dependsOnMap.keys()) {
+            dependedByMap.set(moduleDir, new Set());
+        }
+        for (const [moduleDir, deps] of dependsOnMap) {
+            for (const dep of deps) {
+                if (!dependedByMap.has(dep)) {
+                    dependedByMap.set(dep, new Set());
+                }
+                dependedByMap.get(dep).add(moduleDir);
+            }
+        }
+        // 4. Build ModuleNode list (only modules with dependencies)
+        const nodes = [];
+        for (const [moduleDir, deps] of dependsOnMap) {
+            const dependedBy = dependedByMap.get(moduleDir) || new Set();
+            // Only include modules that have relationships
+            if (deps.size > 0 || dependedBy.size > 0) {
+                nodes.push({
+                    path: moduleDir,
+                    fileCount: fileCountMap.get(moduleDir) || 0,
+                    dependsOn: [...deps].sort(),
+                    dependedBy: [...dependedBy].sort(),
+                });
+            }
+        }
+        // Sort by most depended-on first
+        nodes.sort((a, b) => b.dependedBy.length - a.dependedBy.length);
+        return nodes;
+    }
+    /**
+     * Get the module directory for a file path.
+     * Uses first 2 segments as grouping key (e.g., "server/api" for "server/api/payment.ts").
+     * Root-level files get "." as their module.
+     */
+    getModuleDir(filePath) {
+        const dir = path.dirname(filePath);
+        if (dir === '.')
+            return '.';
+        const segments = dir.split('/');
+        return segments.length <= 2 ? dir : segments.slice(0, 2).join('/');
+    }
+}
+//# sourceMappingURL=module-graph.js.map

package/dist/extractor/module-graph.js.map

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

package/dist/ranker/priority-ranker.d.ts

@@ -0,0 +1,15 @@
+import type { FileData, ExtractedSymbol } from '../types.js';
+export declare class PriorityRanker {
+    private readonly FILE_BUDGET;
+    private readonly SYMBOL_BUDGET;
+    /**
+     * Rank and return the top most-imported files.
+     */
+    rankFiles(fileDataList: FileData[]): FileData[];
+    /**
+     * Rank and return the top most-impactful symbols.
+     * Focuses on exported functions, classes, interfaces from high-impact files.
+     */
+    rankSymbols(fileDataList: FileData[]): ExtractedSymbol[];
+}
+//# sourceMappingURL=priority-ranker.d.ts.map

package/dist/ranker/priority-ranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-ranker.d.ts","sourceRoot":"","sources":["../../src/ranker/priority-ranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE5D,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAK;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAM;IAEpC;;OAEG;IACI,SAAS,CAAC,YAAY,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE;IAOtD;;;OAGG;IACI,WAAW,CAAC,YAAY,EAAE,QAAQ,EAAE,GAAG,eAAe,EAAE;CAkChE"}

package/dist/ranker/priority-ranker.js

@@ -0,0 +1,49 @@
+export class PriorityRanker {
+    FILE_BUDGET = 30;
+    SYMBOL_BUDGET = 100;
+    /**
+     * Rank and return the top most-imported files.
+     */
+    rankFiles(fileDataList) {
+        return [...fileDataList]
+            .filter(fd => fd.inDegree >= 1)
+            .sort((a, b) => b.inDegree - a.inDegree)
+            .slice(0, this.FILE_BUDGET);
+    }
+    /**
+     * Rank and return the top most-impactful symbols.
+     * Focuses on exported functions, classes, interfaces from high-impact files.
+     */
+    rankSymbols(fileDataList) {
+        const keptSymbols = [];
+        for (const fd of fileDataList) {
+            // Keep files with at least 1 importer, or api-route handlers (always kept)
+            const isExempt = fd.role === 'api-route' || fd.role === 'entry';
+            if (!isExempt && fd.inDegree < 1)
+                continue;
+            for (const sym of fd.symbols) {
+                // Only keep high-value symbol kinds
+                const validKinds = ['function', 'class', 'interface', 'type', 'method', 'alias', 'component'];
+                if (!validKinds.includes(sym.kind) && sym.kind !== 'constant' && sym.kind !== 'variable') {
+                    continue;
+                }
+                // Skip noise
+                if (sym.name.startsWith('_') || sym.name.toLowerCase().includes('helper')) {
+                    continue;
+                }
+                const clonedSym = { ...sym, inDegree: fd.inDegree };
+                keptSymbols.push({ sym: clonedSym, inDegree: fd.inDegree, isExempt });
+            }
+        }
+        // Sort: exempt (api-routes) first, then by in-degree descending
+        keptSymbols.sort((a, b) => {
+            if (a.isExempt && !b.isExempt)
+                return -1;
+            if (!a.isExempt && b.isExempt)
+                return 1;
+            return b.inDegree - a.inDegree;
+        });
+        return keptSymbols.slice(0, this.SYMBOL_BUDGET).map(item => item.sym);
+    }
+}
+//# sourceMappingURL=priority-ranker.js.map

package/dist/ranker/priority-ranker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-ranker.js","sourceRoot":"","sources":["../../src/ranker/priority-ranker.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAc;IACR,WAAW,GAAG,EAAE,CAAA;IAChB,aAAa,GAAG,GAAG,CAAA;IAEpC;;OAEG;IACI,SAAS,CAAC,YAAwB;QACvC,OAAO,CAAC,GAAG,YAAY,CAAC;aACrB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,IAAI,CAAC,CAAC;aAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;aACvC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;IAC/B,CAAC;IAED;;;OAGG;IACI,WAAW,CAAC,YAAwB;QACzC,MAAM,WAAW,GAAyE,EAAE,CAAA;QAE5F,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,2EAA2E;YAC3E,MAAM,QAAQ,GAAG,EAAE,CAAC,IAAI,KAAK,WAAW,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,CAAA;YAC/D,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,QAAQ,GAAG,CAAC;gBAAE,SAAQ;YAE1C,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;gBAC7B,oCAAoC;gBACpC,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;gBAC7F,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBACzF,SAAQ;gBACV,CAAC;gBAED,aAAa;gBACb,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC1E,SAAQ;gBACV,CAAC;gBAED,MAAM,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAA;gBACnD,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAA;YACvE,CAAC;QACH,CAAC;QAED,gEAAgE;QAChE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACxB,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,QAAQ;gBAAE,OAAO,CAAC,CAAC,CAAA;YACxC,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ;gBAAE,OAAO,CAAC,CAAA;YACvC,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAA;QAChC,CAAC,CAAC,CAAA;QAEF,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACvE,CAAC;CACF"}

package/dist/scanner/file-classifier.d.ts

@@ -0,0 +1,9 @@
+import type { FileRole, ProjectProfile } from '../types.js';
+export declare class FileClassifier {
+    private matchers;
+    constructor(profile: ProjectProfile);
+    classify(filePath: string): {
+        role: FileRole;
+    };
+}
+//# sourceMappingURL=file-classifier.d.ts.map

package/dist/scanner/file-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-classifier.d.ts","sourceRoot":"","sources":["../../src/scanner/file-classifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE3D,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAuE;gBAE3E,OAAO,EAAE,cAAc;IAS5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE;CAQtD"}

package/dist/scanner/file-classifier.js

@@ -0,0 +1,21 @@
+import picomatch from 'picomatch';
+export class FileClassifier {
+    matchers = [];
+    constructor(profile) {
+        for (const [pattern, role] of Object.entries(profile.rolePatterns)) {
+            this.matchers.push({
+                matcher: picomatch(pattern),
+                role
+            });
+        }
+    }
+    classify(filePath) {
+        for (const { matcher, role } of this.matchers) {
+            if (matcher(filePath)) {
+                return { role };
+            }
+        }
+        return { role: 'unknown' };
+    }
+}
+//# sourceMappingURL=file-classifier.js.map

package/dist/scanner/file-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-classifier.js","sourceRoot":"","sources":["../../src/scanner/file-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAA;AAGjC,MAAM,OAAO,cAAc;IACjB,QAAQ,GAAqE,EAAE,CAAA;IAEvF,YAAY,OAAuB;QACjC,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACjB,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC;gBAC3B,IAAI;aACL,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAEM,QAAQ,CAAC,QAAgB;QAC9B,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9C,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtB,OAAO,EAAE,IAAI,EAAE,CAAA;YACjB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;IAC5B,CAAC;CACF"}

package/dist/scanner/role-detector.d.ts

@@ -0,0 +1,9 @@
+import type { FileRole } from '../types.js';
+export declare class RoleDetector {
+    /**
+     * Classify a file's role based on its path using generic heuristics.
+     * Works for any language/framework — no hardcoded convention files.
+     */
+    classify(filePath: string): FileRole;
+}
+//# sourceMappingURL=role-detector.d.ts.map

package/dist/scanner/role-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-detector.d.ts","sourceRoot":"","sources":["../../src/scanner/role-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AA2B3C,qBAAa,YAAY;IACvB;;;OAGG;IACI,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ;CAQ5C"}

package/dist/scanner/role-detector.js

@@ -0,0 +1,39 @@
+const ROLE_PATTERNS = [
+    // Entry points
+    { test: /^(app|main|index)\.(ts|js|tsx|jsx|vue|py|go|rs|kt|java)$/, role: 'entry' },
+    // Config files
+    { test: /\.config\.(ts|js|mjs|cjs)$/, role: 'config' },
+    { test: /^(tsconfig|vite\.config|nuxt\.config|next\.config|webpack\.config|jest\.config|vitest\.config)/, role: 'config' },
+    { test: /^config\//, role: 'config' },
+    // API routes / handlers
+    { test: /\b(api|routes|endpoints|handlers|controllers)\b\/.*\.(ts|js|tsx|py|go|rs|kt|java)$/, role: 'api-route' },
+    // Pages / views
+    { test: /\b(pages|views)\b\//, role: 'page' },
+    // Components
+    { test: /\b(components)\b\//, role: 'component' },
+    // Services / business logic
+    { test: /\b(services|common|domain|usecases|use-cases)\b\//, role: 'service' },
+    // Composables / hooks
+    { test: /\b(composables|hooks)\b\//, role: 'composable' },
+    // Repository / data layer
+    { test: /\b(repositories|repos|models|entities|dal|database|db)\b\//, role: 'repository' },
+    // Internal
+    { test: /\b(internal|__internal__|private)\b\//, role: 'internal' },
+    // Utilities
+    { test: /\b(utils|helpers|lib|shared|pkg|support)\b\//, role: 'util' },
+];
+export class RoleDetector {
+    /**
+     * Classify a file's role based on its path using generic heuristics.
+     * Works for any language/framework — no hardcoded convention files.
+     */
+    classify(filePath) {
+        for (const { test, role } of ROLE_PATTERNS) {
+            if (test.test(filePath)) {
+                return role;
+            }
+        }
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=role-detector.js.map

package/dist/scanner/role-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-detector.js","sourceRoot":"","sources":["../../src/scanner/role-detector.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAA4C;IAC7D,eAAe;IACf,EAAE,IAAI,EAAE,0DAA0D,EAAE,IAAI,EAAE,OAAO,EAAE;IACnF,eAAe;IACf,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE;IACtD,EAAE,IAAI,EAAE,gGAAgG,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC1H,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;IACrC,wBAAwB;IACxB,EAAE,IAAI,EAAE,oFAAoF,EAAE,IAAI,EAAE,WAAW,EAAE;IACjH,gBAAgB;IAChB,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,EAAE;IAC7C,aAAa;IACb,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,EAAE;IACjD,4BAA4B;IAC5B,EAAE,IAAI,EAAE,mDAAmD,EAAE,IAAI,EAAE,SAAS,EAAE;IAC9E,sBAAsB;IACtB,EAAE,IAAI,EAAE,2BAA2B,EAAE,IAAI,EAAE,YAAY,EAAE;IACzD,0BAA0B;IAC1B,EAAE,IAAI,EAAE,4DAA4D,EAAE,IAAI,EAAE,YAAY,EAAE;IAC1F,WAAW;IACX,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,UAAU,EAAE;IACnE,YAAY;IACZ,EAAE,IAAI,EAAE,8CAA8C,EAAE,IAAI,EAAE,MAAM,EAAE;CACvE,CAAA;AAED,MAAM,OAAO,YAAY;IACvB;;;OAGG;IACI,QAAQ,CAAC,QAAgB;QAC9B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,aAAa,EAAE,CAAC;YAC3C,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxB,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;CACF"}

package/dist/scanner/tree-builder.d.ts

@@ -0,0 +1,8 @@
+export declare class TreeBuilder {
+    /**
+     * Build a complete, unrolled list of all file paths.
+     * This provides an exact "X-Ray" mapping so AI agents can target files precisely.
+     */
+    build(filePaths: string[]): string;
+}
+//# sourceMappingURL=tree-builder.d.ts.map

package/dist/scanner/tree-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-builder.d.ts","sourceRoot":"","sources":["../../src/scanner/tree-builder.ts"],"names":[],"mappings":"AAEA,qBAAa,WAAW;IACtB;;;OAGG;IACI,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM;CAM1C"}

package/dist/scanner/tree-builder.js

@@ -0,0 +1,13 @@
+export class TreeBuilder {
+    /**
+     * Build a complete, unrolled list of all file paths.
+     * This provides an exact "X-Ray" mapping so AI agents can target files precisely.
+     */
+    build(filePaths) {
+        return filePaths
+            .slice()
+            .sort((a, b) => a.localeCompare(b))
+            .join('\n');
+    }
+}
+//# sourceMappingURL=tree-builder.js.map

package/dist/scanner/tree-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-builder.js","sourceRoot":"","sources":["../../src/scanner/tree-builder.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAW;IACtB;;;OAGG;IACI,KAAK,CAAC,SAAmB;QAC9B,OAAO,SAAS;aACb,KAAK,EAAE;aACP,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;aAClC,IAAI,CAAC,IAAI,CAAC,CAAA;IACf,CAAC;CACF"}

package/dist/scanner/tree-walker.d.ts

@@ -0,0 +1,7 @@
+export declare class TreeWalker {
+    private ig;
+    private rootDir;
+    constructor(rootDir: string);
+    walk(dir?: string): string[];
+}
+//# sourceMappingURL=tree-walker.d.ts.map

package/dist/scanner/tree-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-walker.d.ts","sourceRoot":"","sources":["../../src/scanner/tree-walker.ts"],"names":[],"mappings":"AAIA,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,OAAO,CAAQ;gBAEX,OAAO,EAAE,MAAM;IAYpB,IAAI,CAAC,GAAG,GAAE,MAAqB,GAAG,MAAM,EAAE;CA8BlD"}