@anhnguyen02/catlas 0.1.2

package/README.md

@@ -0,0 +1,59 @@
+# 🗺️ Catlas
+
+[![npm version](https://badge.fury.io/js/%40anhnguyen02%2Fcatlas.svg)](https://www.npmjs.com/package/@anhnguyen02/catlas)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> **AI-First Codebase Context Generator.** 
+> Instantly build a deterministic, token-optimized `ATLAS.md` mapped for AI Agents like Claude, Cursor, and Aider.
+
+**Catlas** is a blazing-fast CLI tool that bridges the gap between your massive codebase and AI coding assistants. Instead of relying on LLMs to guess your project's structure, Catlas uses strictly deterministic **Static Analysis** to generate a highly compressed (`<700 tokens`) knowledge graph of your project.
+
+## ✨ Features
+
+- ⚡️ **Zero LLM Dependency:** Runs locally, instantly, and deterministically without arbitrary API calls or hallucinations.
+- 🎯 **AI-Optimized Output:** Strict token budgeting. Delivers a perfectly dense knowledge file without wasting your LLM context window.
+- ⚙️ **Deterministic Detection:** Automatically recognizes your stack (e.g., Nuxt, Next.js, FastAPI, Golang) and maps your application architecture precisely without hallucinating framework rules.
+- 🧠 **Smart Ctags Extraction:** Interrogates your project with Universal Ctags to pull out core signatures, interfaces, and module boundaries.
+- 📉 **Impact-Based Filtering:** Cuts through the noise. Catlas identifies and retains only the Top-20 most impactful entry points and core services using internal graph ranking.
+
+---
+
+## 📦 Installation
+
+Install globally via npm to use `catlas` across all your projects:
+
+```bash
+npm install -g @anhnguyen02/catlas
+```
+
+### System Requirements
+You must have `universal-ctags` installed on your machine for the symbol extractor to work.
+- **macOS:** `brew install universal-ctags`
+- **Linux:** `sudo apt-get install universal-ctags`
+- **Windows:** Install via [ctags.io](https://ctags.io/) or use WSL.
+
+---
+
+## 🚀 Usage
+
+Navigate to any project directory and run the scanner to map your codebase:
+
+```bash
+cd /path/to/your/project
+catlas scan -d .
+```
+
+### Run via npx (No Installation)
+If you prefer not to install globally, you can execute it directly:
+
+```bash
+npx @anhnguyen02/catlas scan -d .
+```
+
+### What Happens Next?
+Catlas will output a highly structured `ATLAS.md` file in the root of your directory. Whenever you start a new AI coding session (e.g., in Cursor or with Claude), simply point the AI to this file, and it will instantly understand the context, architecture, and core dependencies of your project!
+
+---
+
+## 📄 License
+MIT

package/dist/assembler/context-assembler.d.ts

@@ -0,0 +1,17 @@
+import type { FileData, ExtractedSymbol, ModuleNode, ProjectProfile } from '../types.js';
+export interface ProjectMap {
+    projectName: string;
+    description?: string;
+    entryPoints: string[];
+    dependencies: Record<string, string>;
+    scripts: Record<string, string>;
+    stack: string;
+    fileTree: string;
+    moduleGraph: ModuleNode[];
+    hotFiles: FileData[];
+    coreSignatures: ExtractedSymbol[];
+}
+export declare class ContextAssembler {
+    assemble(rootDir: string, profile: ProjectProfile, stack: string, fileTree: string, moduleGraph: ModuleNode[], hotFiles: FileData[], coreSignatures: ExtractedSymbol[]): ProjectMap;
+}
+//# sourceMappingURL=context-assembler.d.ts.map

package/dist/assembler/context-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembler.d.ts","sourceRoot":"","sources":["../../src/assembler/context-assembler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAExF,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,QAAQ,EAAE,QAAQ,EAAE,CAAA;IACpB,cAAc,EAAE,eAAe,EAAE,CAAA;CAClC;AAED,qBAAa,gBAAgB;IACpB,QAAQ,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,QAAQ,EAAE,EACpB,cAAc,EAAE,eAAe,EAAE,GAChC,UAAU;CAcd"}

package/dist/assembler/context-assembler.js

@@ -0,0 +1,18 @@
+import path from 'node:path';
+export class ContextAssembler {
+    assemble(rootDir, profile, stack, fileTree, moduleGraph, hotFiles, coreSignatures) {
+        return {
+            projectName: profile.projectName || path.basename(rootDir),
+            description: profile.description,
+            entryPoints: profile.entryPoints || [],
+            dependencies: profile.dependencies || {},
+            scripts: profile.scripts || {},
+            stack,
+            fileTree,
+            moduleGraph,
+            hotFiles,
+            coreSignatures,
+        };
+    }
+}
+//# sourceMappingURL=context-assembler.js.map

package/dist/assembler/context-assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembler.js","sourceRoot":"","sources":["../../src/assembler/context-assembler.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAgB5B,MAAM,OAAO,gBAAgB;IACpB,QAAQ,CACb,OAAe,EACf,OAAuB,EACvB,KAAa,EACb,QAAgB,EAChB,WAAyB,EACzB,QAAoB,EACpB,cAAiC;QAEjC,OAAO;YACL,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC1D,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;YACtC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;YACxC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,KAAK;YACL,QAAQ;YACR,WAAW;YACX,QAAQ;YACR,cAAc;SACf,CAAA;IACH,CAAC;CACF"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import fs from 'node:fs';
+import path from 'node:path';
+import { log, logStep, logDivider, setVerbose } from './utils/logger.js';
+import { ProjectDetector } from './detector/project-detector.js';
+import { TreeWalker } from './scanner/tree-walker.js';
+import { RoleDetector } from './scanner/role-detector.js';
+const program = new Command();
+const TOTAL_STEPS = 9;
+// Read version from package.json dynamically
+const pkgMeta = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
+program
+    .name('catlas')
+    .description('AI-First static codebase mapper')
+    .version(pkgMeta.version);
+program
+    .command('scan')
+    .description('Static analysis scan to generate ATLAS.md')
+    .option('-d, --dir <path>', 'Project root directory', '.')
+    .option('-v, --verbose', 'Enable verbose debug logging', false)
+    .action(async (options) => {
+    if (options.verbose)
+        setVerbose(true);
+    const rootDir = path.resolve(options.dir);
+    try {
+        await scan(rootDir);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        log('error', `Scan failed: ${message}`);
+        process.exit(1);
+    }
+});
+async function scan(rootDir) {
+    const projectName = path.basename(rootDir);
+    logDivider();
+    log('info', `Catlas — Scanning "${projectName}"`);
+    logDivider();
+    // 1. Project Detector
+    logStep(1, TOTAL_STEPS, 'Detecting language & framework...');
+    const detector = new ProjectDetector();
+    const profile = detector.detect(rootDir);
+    log('success', `Detected: ${profile.language} / ${profile.framework}`);
+    const stack = `${profile.language.toUpperCase()} | ${profile.framework.toUpperCase()}`;
+    // 2. Tree Walker
+    logStep(2, TOTAL_STEPS, 'Walking directory tree...');
+    const walker = new TreeWalker(rootDir);
+    const files = walker.walk();
+    log('success', `Found ${files.length} code files`);
+    // 3. Role Detector (generic, path-based)
+    logStep(3, TOTAL_STEPS, 'Classifying file roles...');
+    const roleDetector = new RoleDetector();
+    const fileData = files.map(filePath => {
+        const role = roleDetector.classify(filePath);
+        return {
+            path: filePath,
+            role,
+            symbols: [],
+            imports: [],
+            inDegree: 0
+        };
+    });
+    // Group by role for logging
+    const roleCounts = {};
+    fileData.forEach(fd => {
+        roleCounts[fd.role] = (roleCounts[fd.role] || 0) + 1;
+    });
+    log('success', `Classified roles:`);
+    for (const [role, count] of Object.entries(roleCounts)) {
+        log('info', `  - ${role}: ${count}`, undefined);
+    }
+    logDivider();
+    // 4. File Tree Builder
+    logStep(4, TOTAL_STEPS, 'Building compact file tree...');
+    const { TreeBuilder } = await import('./scanner/tree-builder.js');
+    const treeBuilder = new TreeBuilder();
+    const fileTree = treeBuilder.build(files);
+    // 5. Ctags Runner
+    logStep(5, TOTAL_STEPS, 'Extracting symbols with Universal Ctags...');
+    const { CtagsRunner } = await import('./extractor/ctags-runner.js');
+    const ctags = new CtagsRunner();
+    ctags.extract(fileData, rootDir);
+    // 6. Import Graph
+    logStep(6, TOTAL_STEPS, 'Building import graph...');
+    const { ImportGraph } = await import('./extractor/import-graph.js');
+    const graph = new ImportGraph();
+    graph.build(fileData, profile.language, rootDir);
+    // 7. Module Graph
+    logStep(7, TOTAL_STEPS, 'Building module dependency graph...');
+    const { ModuleGraph } = await import('./extractor/module-graph.js');
+    const moduleGraph = new ModuleGraph();
+    const moduleNodes = moduleGraph.build(fileData);
+    // 8. Priority Ranker
+    logStep(8, TOTAL_STEPS, 'Ranking files and symbols...');
+    const { PriorityRanker } = await import('./ranker/priority-ranker.js');
+    const ranker = new PriorityRanker();
+    const hotFiles = ranker.rankFiles(fileData);
+    const coreSignatures = ranker.rankSymbols(fileData);
+    // 9. Assemble & Export
+    logStep(9, TOTAL_STEPS, 'Generating ATLAS.md...');
+    const { ContextAssembler } = await import('./assembler/context-assembler.js');
+    const assembler = new ContextAssembler();
+    const projectMap = assembler.assemble(rootDir, profile, stack, fileTree, moduleNodes, hotFiles, coreSignatures);
+    const { MarkdownExporter } = await import('./exporter/markdown.js');
+    const exporter = new MarkdownExporter();
+    const outputPath = path.join(rootDir, 'ATLAS.md');
+    exporter.export(projectMap, outputPath);
+    logDivider();
+    log('success', `ATLAS.md generated: ${outputPath}`);
+}
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/detector/project-detector.d.ts

@@ -0,0 +1,10 @@
+import type { ProjectProfile } from '../types.js';
+export declare class ProjectDetector {
+    /**
+     * Detects the project language and framework.
+     * Returns only { language, framework } — no convention loading.
+     * AI agents already know framework conventions, so we only need the name.
+     */
+    detect(rootDir: string): ProjectProfile;
+}
+//# sourceMappingURL=project-detector.d.ts.map

package/dist/detector/project-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../../src/detector/project-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGjD,qBAAa,eAAe;IAC1B;;;;OAIG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;CA2I/C"}

package/dist/detector/project-detector.js

@@ -0,0 +1,171 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { log } from '../utils/logger.js';
+export class ProjectDetector {
+    /**
+     * Detects the project language and framework.
+     * Returns only { language, framework } — no convention loading.
+     * AI agents already know framework conventions, so we only need the name.
+     */
+    detect(rootDir) {
+        let framework = 'unknown';
+        let language = 'unknown';
+        let projectName;
+        let description;
+        let entryPoints = [];
+        let dependencies = {};
+        let scripts = {};
+        // 1. Check Node.js (package.json)
+        const pkgPath = path.join(rootDir, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            language = 'typescript';
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8') || '{}');
+                const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+                if (pkg.name)
+                    projectName = pkg.name;
+                if (pkg.description)
+                    description = pkg.description;
+                if (pkg.dependencies)
+                    dependencies = pkg.dependencies;
+                if (pkg.scripts)
+                    scripts = pkg.scripts;
+                if (pkg.bin) {
+                    if (typeof pkg.bin === 'string')
+                        entryPoints.push(pkg.bin);
+                    else
+                        Object.values(pkg.bin).forEach(v => entryPoints.push(String(v)));
+                }
+                if (pkg.main)
+                    entryPoints.push(pkg.main);
+                if (pkg.exports) {
+                    if (typeof pkg.exports === 'string')
+                        entryPoints.push(pkg.exports);
+                    else if (pkg.exports['.']) {
+                        const e = pkg.exports['.'];
+                        if (typeof e === 'string')
+                            entryPoints.push(e);
+                        else if (e.import)
+                            entryPoints.push(e.import);
+                        else if (e.require)
+                            entryPoints.push(e.require);
+                        else if (e.default)
+                            entryPoints.push(e.default);
+                    }
+                }
+                if (deps['nuxt'])
+                    framework = 'nuxt';
+                else if (deps['next'])
+                    framework = 'next';
+                else if (deps['@nestjs/core'])
+                    framework = 'nestjs';
+                else if (deps['express'])
+                    framework = 'express';
+                else if (deps['@angular/core'])
+                    framework = 'angular';
+                else if (deps['react'])
+                    framework = 'react';
+                else if (deps['vue'])
+                    framework = 'vue';
+                else if (deps['svelte'])
+                    framework = 'svelte';
+                else
+                    framework = 'node';
+            }
+            catch (e) {
+                log('warn', `Failed to parse package.json (${e?.message || 'Invalid Format'}), falling back generic analysis`);
+                framework = 'generic';
+                language = 'typescript';
+            }
+        }
+        // 2. Check Python (requirements.txt or pyproject.toml)
+        else {
+            const reqPath = path.join(rootDir, 'requirements.txt');
+            const pyprojectPath = path.join(rootDir, 'pyproject.toml');
+            if (fs.existsSync(reqPath) || fs.existsSync(pyprojectPath)) {
+                language = 'python';
+                const content = fs.existsSync(reqPath)
+                    ? fs.readFileSync(reqPath, 'utf-8')
+                    : fs.readFileSync(pyprojectPath, 'utf-8');
+                const lowerContent = content.toLowerCase();
+                if (lowerContent.includes('fastapi'))
+                    framework = 'fastapi';
+                else if (lowerContent.includes('django'))
+                    framework = 'django';
+                else if (lowerContent.includes('flask'))
+                    framework = 'flask';
+                else
+                    framework = 'python';
+            }
+            // 3. Check Go (go.mod)
+            else {
+                const goModPath = path.join(rootDir, 'go.mod');
+                if (fs.existsSync(goModPath)) {
+                    language = 'go';
+                    const content = fs.readFileSync(goModPath, 'utf-8');
+                    const moduleMatch = content.match(/^module\s+(.+)$/m);
+                    if (moduleMatch)
+                        projectName = moduleMatch[1].trim().split('/').pop() || projectName;
+                    if (content.includes('github.com/gin-gonic/gin'))
+                        framework = 'gin';
+                    else if (content.includes('github.com/gofiber/fiber'))
+                        framework = 'fiber';
+                    else if (content.includes('github.com/labstack/echo'))
+                        framework = 'echo';
+                    else
+                        framework = 'go';
+                }
+                // 4. Check Rust (Cargo.toml)
+                else {
+                    const cargoPath = path.join(rootDir, 'Cargo.toml');
+                    if (fs.existsSync(cargoPath)) {
+                        language = 'rust';
+                        const content = fs.readFileSync(cargoPath, 'utf-8').toLowerCase();
+                        if (content.includes('actix'))
+                            framework = 'actix';
+                        else if (content.includes('axum'))
+                            framework = 'axum';
+                        else
+                            framework = 'rust';
+                    }
+                    // 5. Check Java/Kotlin (pom.xml or build.gradle)
+                    else {
+                        const pomPath = path.join(rootDir, 'pom.xml');
+                        const gradlePath = path.join(rootDir, 'build.gradle');
+                        const gradleKtsPath = path.join(rootDir, 'build.gradle.kts');
+                        if (fs.existsSync(pomPath) || fs.existsSync(gradlePath) || fs.existsSync(gradleKtsPath)) {
+                            const hasPom = fs.existsSync(pomPath);
+                            const content = hasPom
+                                ? fs.readFileSync(pomPath, 'utf-8')
+                                : fs.readFileSync(fs.existsSync(gradleKtsPath) ? gradleKtsPath : gradlePath, 'utf-8');
+                            language = fs.existsSync(gradleKtsPath) ? 'kotlin' : 'java';
+                            const lowerContent = content.toLowerCase();
+                            if (lowerContent.includes('spring'))
+                                framework = 'spring';
+                            else
+                                framework = language;
+                        }
+                    }
+                }
+            }
+        }
+        if (framework === 'unknown') {
+            log('warn', 'Could not detect project framework. Output will use generic analysis.');
+            framework = 'generic';
+            language = 'generic';
+        }
+        if (!projectName) {
+            projectName = path.basename(rootDir);
+        }
+        return {
+            language,
+            framework,
+            projectName,
+            description,
+            entryPoints,
+            dependencies,
+            scripts
+        };
+    }
+}
+//# sourceMappingURL=project-detector.js.map

package/dist/detector/project-detector.js.map

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

package/dist/exporter/markdown.d.ts

@@ -0,0 +1,5 @@
+import type { ProjectMap } from '../assembler/context-assembler.js';
+export declare class MarkdownExporter {
+    export(projectMap: ProjectMap, exportPath: string): void;
+}
+//# sourceMappingURL=markdown.d.ts.map

package/dist/exporter/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/exporter/markdown.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,qBAAa,gBAAgB;IACpB,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;CAgHhE"}

package/dist/exporter/markdown.js

@@ -0,0 +1,106 @@
+import fs from 'node:fs';
+export class MarkdownExporter {
+    export(projectMap, exportPath) {
+        const lines = [];
+        // 1. Header
+        lines.push(`# ${projectMap.projectName}`);
+        if (projectMap.description) {
+            lines.push(`> ${projectMap.description}`);
+        }
+        lines.push(`> Stack: ${projectMap.stack}`);
+        lines.push('');
+        // 1.1 Entry Points
+        if (projectMap.entryPoints && projectMap.entryPoints.length > 0) {
+            lines.push('## ENTRY POINTS');
+            const uniqueEntries = Array.from(new Set(projectMap.entryPoints));
+            for (const entry of uniqueEntries) {
+                lines.push(`- \`${entry}\``);
+            }
+            lines.push('');
+        }
+        // 1.2 Core Dependencies
+        const depKeys = Object.keys(projectMap.dependencies || {});
+        if (depKeys.length > 0) {
+            lines.push('## CORE DEPENDENCIES');
+            for (const dep of depKeys.slice(0, 10)) {
+                lines.push(`- \`${dep}\`: ${projectMap.dependencies[dep]}`);
+            }
+            if (depKeys.length > 10)
+                lines.push(`- ...and ${depKeys.length - 10} more`);
+            lines.push('');
+        }
+        // 1.3 Scripts
+        const scriptKeys = Object.keys(projectMap.scripts || {});
+        if (scriptKeys.length > 0) {
+            const importantScripts = ['dev', 'build', 'test', 'start'];
+            const matchedScripts = importantScripts.filter(s => projectMap.scripts[s]);
+            if (matchedScripts.length > 0) {
+                lines.push('## SCRIPTS');
+                for (const req of matchedScripts) {
+                    lines.push(`- \`${req}\`: ${projectMap.scripts[req]}`);
+                }
+                lines.push('');
+            }
+        }
+        // 2. File Tree
+        lines.push('## FILE TREE');
+        lines.push('```');
+        lines.push(projectMap.fileTree);
+        lines.push('```');
+        lines.push('');
+        // 3. Module Graph
+        if (projectMap.moduleGraph.length > 0) {
+            lines.push('## MODULE GRAPH');
+            for (const node of projectMap.moduleGraph) {
+                if (node.dependsOn.length > 0) {
+                    lines.push(`${node.path}/ → ${node.dependsOn.map(d => d + '/').join(', ')}`);
+                }
+            }
+            lines.push('');
+        }
+        // 4. Core Architecture (X-Ray of most-imported files with their symbols)
+        lines.push('## CORE ARCHITECTURE (X-RAY)');
+        if (projectMap.hotFiles.length === 0 && projectMap.coreSignatures.length === 0) {
+            lines.push('> No high-impact files detected.');
+        }
+        else {
+            // Build a set of files to render (hot files + any file having core signatures)
+            const filesToRender = new Map();
+            for (const fd of projectMap.hotFiles) {
+                filesToRender.set(fd.path, fd);
+            }
+            // Group signatures by file for clean display
+            const sigsByFile = new Map();
+            for (const sig of projectMap.coreSignatures) {
+                if (!sigsByFile.has(sig.path))
+                    sigsByFile.set(sig.path, []);
+                sigsByFile.get(sig.path).push(sig);
+                // Ensure file is in filesToRender even if not in hotFiles
+                if (!filesToRender.has(sig.path)) {
+                    filesToRender.set(sig.path, {
+                        path: sig.path,
+                        role: sig.fileRole,
+                        symbols: [],
+                        imports: [],
+                        inDegree: sig.inDegree
+                    });
+                }
+            }
+            // Sort files by inDegree descending
+            const sortedFiles = Array.from(filesToRender.values()).sort((a, b) => b.inDegree - a.inDegree);
+            for (const fd of sortedFiles) {
+                const label = fd.inDegree > 0 ? ` (${fd.inDegree} importers)` : '';
+                lines.push(`🔥 ${fd.path}${label}`);
+                const sigs = sigsByFile.get(fd.path) || [];
+                for (const sig of sigs) {
+                    const kindLabel = `[${sig.kind}]`;
+                    const display = sig.signature ? `${kindLabel} ${sig.name}${sig.signature}` : `${kindLabel} ${sig.name}`;
+                    lines.push(`   → ${display}`);
+                }
+            }
+        }
+        lines.push('');
+        fs.writeFileSync(exportPath, lines.join('\n'), 'utf-8');
+    }
+}
+//# sourceMappingURL=markdown.js.map

package/dist/exporter/markdown.js.map

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

package/dist/extractor/ctags-runner.d.ts

@@ -0,0 +1,8 @@
+import type { FileData } from '../types.js';
+export declare class CtagsRunner {
+    private ctagsPath;
+    constructor();
+    private findCtags;
+    extract(fileDataList: FileData[], rootDir: string): void;
+}
+//# sourceMappingURL=ctags-runner.d.ts.map

package/dist/extractor/ctags-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctags-runner.d.ts","sourceRoot":"","sources":["../../src/extractor/ctags-runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA6B,QAAQ,EAAE,MAAM,aAAa,CAAA;AAGtE,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAQ;;IAMzB,OAAO,CAAC,SAAS;IAWV,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAsFhE"}