@anhnguyen02/catlas 0.1.2

package/dist/scanner/tree-walker.js

@@ -0,0 +1,43 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import ignore from 'ignore';
+export class TreeWalker {
+    ig = ignore();
+    rootDir;
+    constructor(rootDir) {
+        this.rootDir = rootDir;
+        // Basic defaults
+        // Generic defaults — framework output dirs and dependency dirs
+        this.ig.add(['node_modules', '.git', 'dist', 'build', '.output', '.nuxt', '.next', '__pycache__', '.venv', 'venv', 'target', 'vendor', '.idea', '.vscode', 'coverage']);
+        const gitignorePath = path.join(rootDir, '.gitignore');
+        if (fs.existsSync(gitignorePath)) {
+            this.ig.add(fs.readFileSync(gitignorePath, 'utf-8'));
+        }
+    }
+    walk(dir = this.rootDir) {
+        let results = [];
+        const list = fs.readdirSync(dir, { withFileTypes: true });
+        for (const file of list) {
+            const fullPath = path.join(dir, file.name);
+            const relPath = path.relative(this.rootDir, fullPath);
+            const isDir = file.isDirectory();
+            // Always use POSIX paths for ignore matching
+            const posixPath = relPath.split(path.sep).join('/');
+            const checkPath = isDir ? posixPath + '/' : posixPath;
+            if (this.ig.ignores(checkPath)) {
+                continue;
+            }
+            if (isDir) {
+                results = results.concat(this.walk(fullPath));
+            }
+            else {
+                // Only keep code files for now
+                if (posixPath.match(/\.(ts|js|tsx|jsx|vue|py|go|php|java|kt|rs|rb|swift|c|cpp|h)$/)) {
+                    results.push(relPath.split(path.sep).join('/'));
+                }
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=tree-walker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree-walker.js","sourceRoot":"","sources":["../../src/scanner/tree-walker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B,MAAM,OAAO,UAAU;IACb,EAAE,GAAG,MAAM,EAAE,CAAA;IACb,OAAO,CAAQ;IAEvB,YAAY,OAAe;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,iBAAiB;QACjB,+DAA+D;QAC/D,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAA;QAEvK,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;QACtD,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IAEM,IAAI,CAAC,MAAc,IAAI,CAAC,OAAO;QACpC,IAAI,OAAO,GAAa,EAAE,CAAA;QAC1B,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QAEzD,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YAErD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;YAEhC,6CAA6C;YAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACnD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;YAErD,IAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/B,SAAQ;YACV,CAAC;YAED,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;YAC/C,CAAC;iBAAM,CAAC;gBACN,+BAA+B;gBAC/B,IAAI,SAAS,CAAC,KAAK,CAAC,8DAA8D,CAAC,EAAE,CAAC;oBACpF,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;gBACjD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+export type FileRole = 'entry' | 'page' | 'api-route' | 'service' | 'repository' | 'composable' | 'component' | 'config' | 'internal' | 'util' | 'unknown';
+export interface ProjectProfile {
+    language: string;
+    framework: string;
+    projectName?: string;
+    description?: string;
+    entryPoints?: string[];
+    dependencies?: Record<string, string>;
+    scripts?: Record<string, string>;
+}
+export interface ModuleNode {
+    path: string;
+    fileCount: number;
+    dependsOn: string[];
+    dependedBy: string[];
+}
+export interface ExtractedSymbol {
+    name: string;
+    kind: 'function' | 'class' | 'interface' | 'type' | 'variable' | 'method' | 'component' | 'alias' | 'constant' | 'unknown';
+    signature: string;
+    line: number;
+    isExported: boolean;
+    fileRole: FileRole;
+    path: string;
+    inDegree: number;
+}
+export interface FileData {
+    path: string;
+    role: FileRole;
+    symbols: ExtractedSymbol[];
+    imports: string[];
+    inDegree: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,MAAM,GACN,WAAW,GACX,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,UAAU,GACV,MAAM,GACN,SAAS,CAAA;AAEb,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAA;IAC1H,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,QAAQ,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/cache.d.ts

@@ -0,0 +1,18 @@
+export interface CacheEntry {
+    hash: string;
+    timestamp: string;
+    result: unknown;
+}
+/**
+ * Get SHA-256 hash of file content
+ */
+export declare function hashFile(filePath: string): string;
+/**
+ * Read cached result for a file. Returns null if cache miss or file changed.
+ */
+export declare function readCache(rootDir: string, relativePath: string, currentHash: string): unknown | null;
+/**
+ * Write result to cache for a file.
+ */
+export declare function writeCache(rootDir: string, relativePath: string, hash: string, result: unknown): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjD;AAUD;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAWpG;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAWrG"}

package/dist/utils/cache.js

@@ -0,0 +1,50 @@
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const CACHE_DIR = '.code-atlas/cache';
+/**
+ * Get SHA-256 hash of file content
+ */
+export function hashFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return crypto.createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Get cache file path for a given source file
+ */
+function getCachePath(rootDir, relativePath) {
+    const safeName = relativePath.replace(/[/\\]/g, '__');
+    return path.join(rootDir, CACHE_DIR, `${safeName}.json`);
+}
+/**
+ * Read cached result for a file. Returns null if cache miss or file changed.
+ */
+export function readCache(rootDir, relativePath, currentHash) {
+    const cachePath = getCachePath(rootDir, relativePath);
+    if (!fs.existsSync(cachePath))
+        return null;
+    try {
+        const entry = JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
+        if (entry.hash === currentHash)
+            return entry.result;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write result to cache for a file.
+ */
+export function writeCache(rootDir, relativePath, hash, result) {
+    const cachePath = getCachePath(rootDir, relativePath);
+    const cacheDir = path.dirname(cachePath);
+    fs.mkdirSync(cacheDir, { recursive: true });
+    const entry = {
+        hash,
+        timestamp: new Date().toISOString(),
+        result,
+    };
+    fs.writeFileSync(cachePath, JSON.stringify(entry, null, 2));
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,MAAM,SAAS,GAAG,mBAAmB,CAAA;AAQrC;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAClD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAClE,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,OAAe,EAAE,YAAoB;IACzD,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAA;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,YAAoB,EAAE,WAAmB;IAClF,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAA;IAE1C,IAAI,CAAC;QACH,MAAM,KAAK,GAAe,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;QACzE,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,KAAK,CAAC,MAAM,CAAA;QACnD,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,YAAoB,EAAE,IAAY,EAAE,MAAe;IAC7F,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACxC,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE3C,MAAM,KAAK,GAAe;QACxB,IAAI;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM;KACP,CAAA;IACD,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAC7D,CAAC"}

package/dist/utils/diff.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Get list of files changed since last scan (git diff).
+ * Returns null if no previous scan or not a git repo.
+ */
+export declare function getChangedFiles(rootDir: string): string[] | null;
+/**
+ * Save current HEAD commit hash as the last scan reference.
+ */
+export declare function saveScanMeta(rootDir: string): void;
+//# sourceMappingURL=diff.d.ts.map

package/dist/utils/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/utils/diff.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAehE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAkBlD"}

package/dist/utils/diff.js

@@ -0,0 +1,43 @@
+import { execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const META_FILE = '.code-atlas/meta.json';
+/**
+ * Get list of files changed since last scan (git diff).
+ * Returns null if no previous scan or not a git repo.
+ */
+export function getChangedFiles(rootDir) {
+    const metaPath = path.join(rootDir, META_FILE);
+    if (!fs.existsSync(metaPath))
+        return null;
+    try {
+        const meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+        const output = execSync(`git diff --name-only ${meta.lastScanCommit} HEAD`, { cwd: rootDir, encoding: 'utf-8' });
+        return output.trim().split('\n').filter(Boolean);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save current HEAD commit hash as the last scan reference.
+ */
+export function saveScanMeta(rootDir) {
+    try {
+        const commit = execSync('git rev-parse HEAD', {
+            cwd: rootDir,
+            encoding: 'utf-8'
+        }).trim();
+        const meta = {
+            lastScanCommit: commit,
+            lastScanDate: new Date().toISOString(),
+        };
+        const metaDir = path.dirname(path.join(rootDir, META_FILE));
+        fs.mkdirSync(metaDir, { recursive: true });
+        fs.writeFileSync(path.join(rootDir, META_FILE), JSON.stringify(meta, null, 2));
+    }
+    catch {
+        // Not a git repo — skip
+    }
+}
+//# sourceMappingURL=diff.js.map

package/dist/utils/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/utils/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,MAAM,SAAS,GAAG,uBAAuB,CAAA;AAOzC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAE9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAA;IAEzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAa,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;QACrE,MAAM,MAAM,GAAG,QAAQ,CACrB,wBAAwB,IAAI,CAAC,cAAc,OAAO,EAClD,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CACpC,CAAA;QACD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,oBAAoB,EAAE;YAC5C,GAAG,EAAE,OAAO;YACZ,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC,IAAI,EAAE,CAAA;QAET,MAAM,IAAI,GAAa;YACrB,cAAc,EAAE,MAAM;YACtB,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACvC,CAAA;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;QAC3D,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;AACH,CAAC"}

package/dist/utils/gitignore.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Parse .gitignore file and return an `ignore` instance
+ */
+export declare function parseGitignore(rootDir: string): string[];
+/**
+ * Auto-append `.code-atlas/raw/` to .gitignore if not present.
+ */
+export declare function ensureGitignore(rootDir: string): void;
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/utils/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/utils/gitignore.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CASxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAarD"}

package/dist/utils/gitignore.js

@@ -0,0 +1,35 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const GITIGNORE_MARKER = '# code-atlas';
+const RAW_DIR_ENTRY = '.code-atlas/raw/';
+/**
+ * Parse .gitignore file and return an `ignore` instance
+ */
+export function parseGitignore(rootDir) {
+    const gitignorePath = path.join(rootDir, '.gitignore');
+    if (!fs.existsSync(gitignorePath))
+        return [];
+    const content = fs.readFileSync(gitignorePath, 'utf-8');
+    return content
+        .split('\n')
+        .map(line => line.trim())
+        .filter(line => line && !line.startsWith('#'));
+}
+/**
+ * Auto-append `.code-atlas/raw/` to .gitignore if not present.
+ */
+export function ensureGitignore(rootDir) {
+    const gitignorePath = path.join(rootDir, '.gitignore');
+    if (fs.existsSync(gitignorePath)) {
+        const content = fs.readFileSync(gitignorePath, 'utf-8');
+        if (content.includes(RAW_DIR_ENTRY))
+            return;
+        const appendText = `\n${GITIGNORE_MARKER}\n${RAW_DIR_ENTRY}\n`;
+        fs.appendFileSync(gitignorePath, appendText);
+    }
+    else {
+        const content = `${GITIGNORE_MARKER}\n${RAW_DIR_ENTRY}\n`;
+        fs.writeFileSync(gitignorePath, content);
+    }
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/utils/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../src/utils/gitignore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,MAAM,gBAAgB,GAAG,cAAc,CAAA;AACvC,MAAM,aAAa,GAAG,kBAAkB,CAAA;AAExC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IACtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,CAAA;IAE5C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IACvD,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IAEtD,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;QACvD,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;YAAE,OAAM;QAE3C,MAAM,UAAU,GAAG,KAAK,gBAAgB,KAAK,aAAa,IAAI,CAAA;QAC9D,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,UAAU,CAAC,CAAA;IAC9C,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,GAAG,gBAAgB,KAAK,aAAa,IAAI,CAAA;QACzD,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+type LogLevel = 'info' | 'success' | 'warn' | 'error' | 'debug';
+export declare function setVerbose(v: boolean): void;
+export declare function log(level: LogLevel, message: string, detail?: string): void;
+export declare function logStep(step: number, total: number, message: string): void;
+export declare function logDivider(): void;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,KAAK,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAY/D,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,QAEpC;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,QAepE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,QAEnE;AAED,wBAAgB,UAAU,SAEzB"}

package/dist/utils/logger.js

@@ -0,0 +1,33 @@
+import chalk from 'chalk';
+const ICONS = {
+    info: '📋',
+    success: '✅',
+    warn: '⚠️',
+    error: '❌',
+    debug: '🔍',
+};
+let verbose = false;
+export function setVerbose(v) {
+    verbose = v;
+}
+export function log(level, message, detail) {
+    if (level === 'debug' && !verbose)
+        return;
+    const icon = ICONS[level];
+    const colorFn = level === 'error' ? chalk.red :
+        level === 'warn' ? chalk.yellow :
+            level === 'success' ? chalk.green :
+                level === 'debug' ? chalk.gray :
+                    chalk.blue;
+    console.log(`${icon} ${colorFn(message)}`);
+    if (detail) {
+        console.log(chalk.gray(`   ${detail}`));
+    }
+}
+export function logStep(step, total, message) {
+    console.log(chalk.cyan(`[${step}/${total}]`) + ` ${message}`);
+}
+export function logDivider() {
+    console.log(chalk.gray('─'.repeat(50)));
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,MAAM,KAAK,GAA6B;IACtC,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,GAAG;IACZ,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,IAAI;CACZ,CAAA;AAED,IAAI,OAAO,GAAG,KAAK,CAAA;AAEnB,MAAM,UAAU,UAAU,CAAC,CAAU;IACnC,OAAO,GAAG,CAAC,CAAA;AACb,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,MAAe;IACnE,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,OAAO;QAAE,OAAM;IAEzC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;IACzB,MAAM,OAAO,GACX,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACnC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAChC,KAAK,CAAC,IAAI,CAAA;IAEZ,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC1C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAA;IACzC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,KAAa,EAAE,OAAe;IAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC,CAAA;AAC/D,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AACzC,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@anhnguyen02/catlas",
+  "version": "0.1.2",
+  "description": "AI-First Codebase Context Generator — instantly maps your codebase for Cursor, Claude, and Aider",
+  "type": "module",
+  "bin": {
+    "catlas": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prepack": "npm run build",
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anhnv02/catlas.git"
+  },
+  "keywords": [
+    "ai",
+    "codebase",
+    "context",
+    "atlas",
+    "llm",
+    "cursor",
+    "aider",
+    "claude",
+    "static-analysis"
+  ],
+  "author": "Anh Nguyen",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/anhnv02/catlas/issues"
+  },
+  "homepage": "https://github.com/anhnv02/catlas#readme",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/picomatch": "^4.0.2",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^13.0.0",
+    "ignore": "^7.0.5"
+  }
+}