@yoinkingfish/codecarto 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CodeCarto Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/browser/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Browser launcher — uses `open` but waits until server is ready.
+ */
+export declare function openBrowser(url: string): Promise<void>;
+export declare function waitForServer(url: string, timeoutMs?: number): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5D;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAahF"}

package/dist/browser/index.js

@@ -0,0 +1,32 @@
+/**
+ * Browser launcher — uses `open` but waits until server is ready.
+ */
+import { logger } from "../utils/logger.js";
+export async function openBrowser(url) {
+    try {
+        const { default: open } = await import("open");
+        await open(url, { wait: false });
+        logger.verbose(`Opened browser: ${url}`);
+    }
+    catch (err) {
+        logger.warn(`Could not open browser automatically. Please open ${url} manually.`);
+        logger.verbose(String(err));
+    }
+}
+export async function waitForServer(url, timeoutMs = 5000) {
+    const start = Date.now();
+    const healthUrl = new URL("/api/health", url).toString();
+    while (Date.now() - start < timeoutMs) {
+        try {
+            const res = await fetch(healthUrl);
+            if (res.ok)
+                return;
+        }
+        catch {
+            // retry
+        }
+        await new Promise((r) => setTimeout(r, 150));
+    }
+    logger.verbose(`Health check timed out for ${healthUrl}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,OAAO,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,qDAAqD,GAAG,YAAY,CAAC,CAAC;QAClF,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,SAAS,GAAG,IAAI;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IACzD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;YACnC,IAAI,GAAG,CAAC,EAAE;gBAAE,OAAO;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ;QACV,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,8BAA8B,SAAS,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/commands/default.d.ts

@@ -0,0 +1,9 @@
+export interface DefaultOptions {
+    port: string;
+    open: boolean;
+    verbose?: boolean;
+    ignore?: string[];
+    output?: string;
+}
+export declare function defaultCommand(opts: DefaultOptions): Promise<void>;
+//# sourceMappingURL=default.d.ts.map

package/dist/commands/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/commands/default.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA+GxE"}

package/dist/commands/default.js

@@ -0,0 +1,103 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import chalk from "chalk";
+import ora from "ora";
+import { runPipeline } from "../utils/pipeline.js";
+import { logger, setLogLevel } from "../utils/logger.js";
+import { resolveRoot } from "../utils/paths.js";
+import { printBanner } from "../utils/banner.js";
+import { startServer } from "../server/index.js";
+import { openBrowser, waitForServer } from "../browser/index.js";
+export async function defaultCommand(opts) {
+    setLogLevel(opts.verbose ? "verbose" : "info");
+    printBanner();
+    const root = resolveRoot("."); // Use current working directory
+    const preferredPort = Number(opts.port);
+    if (!Number.isFinite(preferredPort) || preferredPort < 1 || preferredPort > 65535) {
+        console.error(chalk.red(`\n✗ Invalid port: ${opts.port}\n`));
+        process.exit(1);
+    }
+    try {
+        const st = await fs.stat(root);
+        if (!st.isDirectory())
+            throw new Error(`Not a directory: ${root}`);
+    }
+    catch (err) {
+        console.error(chalk.red(`\n✗ Could not read repository\n\n  Path:\n  ${root}\n\n  Reason:\n  ${err.message}\n\n  Try:\n  codecarto --path <directory>\n`));
+        process.exit(1);
+    }
+    const spinner = ora({ text: "Discovering repository...", color: "cyan" }).start();
+    logger.verbose("CodeCarto analyzes your project locally. Your source code is not uploaded.");
+    try {
+        spinner.text = "Scanning files...";
+        const { graph, diagnostics } = await runPipeline({
+            root,
+            ignore: opts.ignore,
+            verbose: opts.verbose,
+        });
+        spinner.text = `Analyzing ${graph.stats.totalFiles} files...`;
+        await new Promise((r) => setTimeout(r, 30));
+        spinner.text = "Building architecture graph...";
+        spinner.succeed(chalk.green("Repository scanned"));
+        console.log(chalk.dim(`  Root: ${root}`));
+        console.log(chalk.dim(`  Files: ${graph.stats.totalFiles}  Links: ${graph.stats.totalLinks}  Dirs: ${graph.stats.totalDirectories}  Isolated: ${graph.stats.isolatedFiles}`));
+        if (Object.keys(graph.stats.languages).length) {
+            const langStr = Object.entries(graph.stats.languages)
+                .sort((a, b) => b[1] - a[1])
+                .map(([k, v]) => `${k} ${v}`)
+                .join(" · ");
+            logger.info(chalk.dim(`  Languages: ${langStr}`));
+        }
+        if (graph.stats.totalFiles > 0) {
+            console.log("");
+            const langs = Object.entries(graph.stats.languages).sort((a, b) => b[1] - a[1]);
+            const maxCount = Math.max(...langs.map(([, c]) => c));
+            for (const [lang, count] of langs) {
+                const pct = Math.round((count / graph.stats.totalFiles) * 100);
+                const width = Math.max(2, Math.round((count / maxCount) * 16));
+                const bar = "█".repeat(width);
+                const label = lang.padEnd(12);
+                console.log(`  ${label} ${chalk.cyan(bar)} ${pct}%`);
+            }
+            console.log("");
+        }
+        if (diagnostics.parseFailures.length) {
+            logger.warn(`${diagnostics.parseFailures.length} parse failures`);
+            if (opts.verbose)
+                for (const f of diagnostics.parseFailures.slice(0, 5))
+                    logger.dim(`  ! ${f.path}: ${f.reason}`);
+        }
+        if (opts.output) {
+            const outPath = path.resolve(opts.output);
+            await fs.mkdir(path.dirname(outPath), { recursive: true });
+            await fs.writeFile(outPath, JSON.stringify(graph, null, 2), "utf-8");
+            logger.success(`Graph written to ${outPath}`);
+            console.log(chalk.dim("\n  Tip: codecarto serve --input <file> to visualize the exported graph.\n"));
+            return;
+        }
+        console.log(chalk.dim("  Starting visualization...\n"));
+        const { url, server } = await startServer({ graph, preferredPort });
+        console.log(chalk.green(`✓ Visualization running\n`));
+        console.log(`  ${chalk.bold.cyan(url)}\n`);
+        console.log(chalk.dim("  Press Ctrl+C to stop.\n"));
+        await waitForServer(url);
+        if (opts.open)
+            await openBrowser(url);
+        await new Promise((resolve) => {
+            const close = () => server.close(() => resolve());
+            process.on("SIGINT", close);
+            process.on("SIGTERM", close);
+        });
+        logger.info("Server stopped.");
+    }
+    catch (err) {
+        spinner.fail(chalk.red("Failed to analyze repository"));
+        console.error(chalk.red(err.message));
+        if (opts.verbose)
+            console.error(err);
+        else
+            console.error(chalk.dim("  Run with --verbose for details.\n"));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=default.js.map

package/dist/commands/default.js.map

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

package/dist/commands/export.d.ts

@@ -0,0 +1,9 @@
+export interface ExportOptions {
+    path: string;
+    output: string;
+    format: string;
+    verbose?: boolean;
+    ignore?: string[];
+}
+export declare function exportCommand(opts: ExportOptions): Promise<void>;
+//# sourceMappingURL=export.d.ts.map

package/dist/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDtE"}

package/dist/commands/export.js

@@ -0,0 +1,62 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import chalk from "chalk";
+import ora from "ora";
+import { runPipeline } from "../utils/pipeline.js";
+import { logger, setLogLevel } from "../utils/logger.js";
+import { resolveRoot } from "../utils/paths.js";
+export async function exportCommand(opts) {
+    setLogLevel(opts.verbose ? "verbose" : "info");
+    const root = resolveRoot(opts.path);
+    const format = opts.format.toLowerCase();
+    if (!["json", "html"].includes(format)) {
+        console.error(chalk.red(`\n✗ Unknown format: ${opts.format} (expected json | html)\n`));
+        process.exit(1);
+    }
+    const spinner = ora("Exporting architecture...").start();
+    try {
+        await fs.stat(root);
+    }
+    catch (err) {
+        spinner.fail(chalk.red("Could not read repository"));
+        console.error(chalk.dim(err.message));
+        process.exit(1);
+    }
+    try {
+        const { graph } = await runPipeline({ root, ignore: opts.ignore, verbose: opts.verbose });
+        if (format === "json") {
+            const json = JSON.stringify(graph, null, 2);
+            const outPath = path.resolve(opts.output);
+            await fs.mkdir(path.dirname(outPath), { recursive: true });
+            await fs.writeFile(outPath, json, "utf-8");
+            spinner.succeed(chalk.green(`Exported JSON -> ${outPath}`));
+        }
+        else {
+            const statsLine = `${graph.stats.totalFiles} files · ${graph.stats.totalLinks} links · ${Object.keys(graph.stats.languages).length} languages`;
+            const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width,initial-scale=1"/><title>CodeCarto - ${escapeHtml(path.basename(root))}</title><style>body{margin:0;background:#050505;color:#e6e8ec;font-family:system-ui;padding:32px}pre{background:#0f0f12;border:1px solid #1e1e24;padding:16px;border-radius:8px;overflow:auto;max-width:960px}a{color:#00d9ff}</style></head><body><h1 style="color:#00d9ff">CodeCarto</h1><p>Architecture of <strong>${escapeHtml(root)}</strong></p><p>${statsLine}</p><pre>${escapeHtml(JSON.stringify(graph, null, 2))}</pre><p><a href="#" onclick="navigator.clipboard.writeText(document.querySelector('pre').textContent);return false">Copy JSON</a></p></body></html>`;
+            const out = opts.output.endsWith(".html")
+                ? opts.output
+                : opts.output.replace(/\.json$/, "") + ".html";
+            const outPath = path.resolve(out);
+            await fs.mkdir(path.dirname(outPath), { recursive: true });
+            await fs.writeFile(outPath, html, "utf-8");
+            spinner.succeed(chalk.green(`Exported HTML -> ${outPath}`));
+        }
+        logger.dim("  Tip: codecarto serve --input <file> to visualize an exported graph.\n");
+    }
+    catch (err) {
+        spinner.fail(chalk.red("Export failed"));
+        console.error(chalk.red(err.message));
+        if (opts.verbose)
+            console.error(err);
+        process.exit(1);
+    }
+}
+function escapeHtml(s) {
+    return s
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;");
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

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

package/dist/commands/scan.d.ts

@@ -0,0 +1,8 @@
+export interface ScanOptions {
+    path: string;
+    output?: string;
+    verbose?: boolean;
+    ignore?: string[];
+}
+export declare function scanCommand(opts: ScanOptions): Promise<void>;
+//# sourceMappingURL=scan.d.ts.map

package/dist/commands/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFlE"}

package/dist/commands/scan.js

@@ -0,0 +1,81 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import chalk from "chalk";
+import ora from "ora";
+import { runPipeline } from "../utils/pipeline.js";
+import { logger, setLogLevel } from "../utils/logger.js";
+import { resolveRoot } from "../utils/paths.js";
+export async function scanCommand(opts) {
+    setLogLevel(opts.verbose ? "verbose" : "info");
+    const root = resolveRoot(opts.path);
+    try {
+        const st = await fs.stat(root);
+        if (!st.isDirectory())
+            throw new Error(`Not a directory: ${root}`);
+    }
+    catch (err) {
+        console.error(chalk.red(`\n✗ Could not read repository\n\n  Path:\n  ${root}\n\n  Reason:\n  ${err.message}\n\n  Try:\n  codecarto --path <directory>\n`));
+        process.exit(1);
+    }
+    const spinner = ora({ text: "Discovering repository...", color: "cyan" }).start();
+    try {
+        spinner.text = "Scanning files...";
+        const { graph, diagnostics } = await runPipeline({
+            root,
+            ignore: opts.ignore,
+            verbose: opts.verbose,
+        });
+        spinner.text = `Analyzing ${graph.stats.totalFiles} files...`;
+        await new Promise((r) => setTimeout(r, 50));
+        spinner.text = "Building architecture graph...";
+        spinner.succeed(chalk.green("Repository scanned"));
+        logger.info(chalk.dim(`  Root: ${root}`));
+        logger.info(chalk.dim(`  Files: ${graph.stats.totalFiles}  Links: ${graph.stats.totalLinks}  Dirs: ${graph.stats.totalDirectories}  Isolated: ${graph.stats.isolatedFiles}`));
+        if (Object.keys(graph.stats.languages).length) {
+            const langStr = Object.entries(graph.stats.languages)
+                .sort((a, b) => b[1] - a[1])
+                .map(([k, v]) => `${k} ${v}`)
+                .join(" · ");
+            logger.info(chalk.dim(`  Languages: ${langStr}`));
+        }
+        if (diagnostics.parseFailures.length) {
+            logger.warn(`${diagnostics.parseFailures.length} parse failures (see --verbose)`);
+            if (opts.verbose) {
+                for (const f of diagnostics.parseFailures.slice(0, 10))
+                    logger.dim(`  ! ${f.path}: ${f.reason}`);
+            }
+        }
+        if (diagnostics.unsupported)
+            logger.dim(`  Unsupported: ${diagnostics.unsupported} files (parser unavailable)`);
+        console.log("");
+        if (graph.stats.totalFiles > 0) {
+            const langs = Object.entries(graph.stats.languages).sort((a, b) => b[1] - a[1]);
+            for (const [lang, count] of langs) {
+                const pct = Math.round((count / graph.stats.totalFiles) * 100);
+                const bar = "█".repeat(Math.max(1, Math.round(pct / 5)));
+                logger.info(`  ${lang.padEnd(12)} ${bar} ${pct}%`);
+            }
+            console.log("");
+        }
+        const json = JSON.stringify(graph, null, 2);
+        if (opts.output) {
+            const outPath = path.resolve(opts.output);
+            await fs.mkdir(path.dirname(outPath), { recursive: true });
+            await fs.writeFile(outPath, json, "utf-8");
+            logger.success(`Graph written to ${outPath}`);
+        }
+        else {
+            console.log(json);
+        }
+    }
+    catch (err) {
+        spinner.fail(chalk.red("Scan failed"));
+        console.error(chalk.red(err.message));
+        if (opts.verbose)
+            console.error(err);
+        else
+            console.error(chalk.dim("  Run with --verbose for details.\n"));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

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

package/dist/commands/serve.d.ts

@@ -0,0 +1,8 @@
+export interface ServeOptions {
+    input: string;
+    port: string;
+    open: boolean;
+    verbose?: boolean;
+}
+export declare function serveCommand(opts: ServeOptions): Promise<void>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CpE"}

package/dist/commands/serve.js

@@ -0,0 +1,47 @@
+import fs from "node:fs/promises";
+import chalk from "chalk";
+import { parseCodeGraph } from "@yoinkingfish/shared";
+import { logger, setLogLevel } from "../utils/logger.js";
+import { startServer } from "../server/index.js";
+import { openBrowser, waitForServer } from "../browser/index.js";
+export async function serveCommand(opts) {
+    setLogLevel(opts.verbose ? "verbose" : "info");
+    const port = Number(opts.port);
+    if (!Number.isFinite(port) || port < 1 || port > 65535) {
+        console.error(chalk.red(`\n✗ Invalid port: ${opts.port}\n`));
+        process.exit(1);
+    }
+    let raw;
+    try {
+        raw = await fs.readFile(opts.input, "utf-8");
+    }
+    catch (err) {
+        console.error(chalk.red(`\n✗ Could not read graph file\n\n  Path: ${opts.input}\n  Reason: ${err.message}\n`));
+        process.exit(1);
+    }
+    let graph;
+    try {
+        graph = parseCodeGraph(JSON.parse(raw));
+    }
+    catch (err) {
+        console.error(chalk.red(`\n✗ Invalid graph JSON: ${err.message}\n`));
+        process.exit(1);
+    }
+    const { url, server } = await startServer({ graph, preferredPort: port });
+    console.log(chalk.green(`\n✓ Visualization running\n`));
+    console.log(`  ${chalk.bold(url)}\n`);
+    console.log(chalk.dim("  Press Ctrl+C to stop.\n"));
+    await waitForServer(url);
+    if (opts.open)
+        await openBrowser(url);
+    // Keep process alive until SIGINT
+    await new Promise((resolve) => {
+        const close = () => {
+            server.close(() => resolve());
+        };
+        process.on("SIGINT", close);
+        process.on("SIGTERM", close);
+    });
+    logger.info("Server stopped.");
+}
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * CodeCarto CLI entry point.
+ * Local-first, offline-capable. Never executes repository code.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+/**
+ * CodeCarto CLI entry point.
+ * Local-first, offline-capable. Never executes repository code.
+ */
+import { Command } from "commander";
+import chalk from "chalk";
+import { createRequire } from "node:module";
+import { scanCommand } from "./commands/scan.js";
+import { serveCommand } from "./commands/serve.js";
+import { exportCommand } from "./commands/export.js";
+import { defaultCommand } from "./commands/default.js";
+const require = createRequire(import.meta.url);
+// Read version without importing JSON with assertions (Node 18 compat)
+let version = "0.1.0";
+try {
+    const pkg = require("../../package.json");
+    if (pkg.version)
+        version = pkg.version;
+}
+catch {
+    // fallback — will be replaced by workspace package version at build time
+    try {
+        const cliPkg = require("../package.json");
+        if (cliPkg.version)
+            version = cliPkg.version;
+    }
+    catch {
+        /* noop */
+    }
+}
+const program = new Command();
+program
+    .name("codecarto")
+    .description("See your codebase — local-first 3D architecture visualization")
+    .version(version, "-V, --version", "output the version number")
+    .helpOption("-h, --help", "display help for command");
+// Default: scan + serve + open browser
+program
+    .option("--port <number>", "preferred port (auto-increments if busy)", String(3000))
+    .option("--no-open", "do not automatically open browser")
+    .option("--verbose", "verbose logging", false)
+    .option("--ignore <pattern>", "additional ignore glob (repeatable)", collect, [])
+    .option("--output <file>", "write graph JSON to file instead of serving")
+    .action(defaultCommand);
+// Subcommands
+program
+    .command("scan")
+    .description("scan repository and print graph JSON to stdout or file")
+    .option("--path <dir>", "repository root", ".")
+    .option("--output <file>", "write graph JSON to file")
+    .option("--verbose", "verbose logging", false)
+    .option("--ignore <pattern>", "additional ignore glob (repeatable)", collect, [])
+    .action(scanCommand);
+program
+    .command("serve")
+    .description("serve an existing graph JSON file in the visualizer")
+    .option("--input <file>", "graph JSON file to serve", "codecarto-data.json")
+    .option("--port <number>", "preferred port", String(3000))
+    .option("--no-open", "do not automatically open browser")
+    .option("--verbose", "verbose logging", false)
+    .action(serveCommand);
+program
+    .command("export")
+    .description("export portable architecture artifact (JSON / HTML)")
+    .option("--path <dir>", "repository root", ".")
+    .option("--output <file>", "output file", "codecarto-data.json")
+    .option("--format <format>", "export format: json | html", "json")
+    .option("--verbose", "verbose logging", false)
+    .option("--ignore <pattern>", "additional ignore glob (repeatable)", collect, [])
+    .action(exportCommand);
+function collect(value, previous) {
+    return previous.concat([value]);
+}
+// Friendly error handling — never dump stack in normal mode
+program.exitOverride();
+try {
+    await program.parseAsync(process.argv);
+}
+catch (err) {
+    const e = err;
+    // Commander help/version exits with code 0 — pass through
+    if (e.code === "commander.helpDisplayed" || e.code === "commander.version") {
+        process.exit(0);
+    }
+    if (e.message) {
+        console.error(chalk.red(`\n✗ ${e.message}\n`));
+        if (process.argv.includes("--verbose")) {
+            console.error(e);
+        }
+        else {
+            console.error(chalk.dim("  Run with --verbose for details.  See --help.\n"));
+        }
+    }
+    process.exit(e.exitCode ?? 1);
+}
+// Graceful termination
+process.on("SIGINT", () => {
+    console.log(chalk.dim("\n  Shutting down…\n"));
+    process.exit(0);
+});
+process.on("SIGTERM", () => {
+    process.exit(0);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Local HTTP server — serves visualizer static assets + graph JSON.
+ * Binds to 127.0.0.1 only. Tries ports incrementally.
+ */
+import http from "node:http";
+import type { CodeGraph } from "@yoinkingfish/shared";
+export interface ServeOptions {
+    graph: CodeGraph;
+    preferredPort?: number;
+    verbose?: boolean;
+}
+export interface ServeResult {
+    url: string;
+    port: number;
+    server: http.Server;
+}
+export declare function startServer(options: ServeOptions): Promise<ServeResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAiCtD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;CACrB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAwF7E"}

package/dist/server/index.js

@@ -0,0 +1,115 @@
+/**
+ * Local HTTP server — serves visualizer static assets + graph JSON.
+ * Binds to 127.0.0.1 only. Tries ports incrementally.
+ */
+import http from "node:http";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { DEFAULT_PORT, MAX_PORT_ATTEMPTS } from "@yoinkingfish/shared";
+import { logger } from "../utils/logger.js";
+function findVisualizerDist() {
+    const base = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        // monorepo dev: packages/cli/dist/server -> apps/visualizer/dist (4 levels up)
+        path.resolve(base, "../../../../apps/visualizer/dist"),
+        // alternative dev layout
+        path.resolve(base, "../../../apps/visualizer/dist"),
+        // published npm: node_modules/codecarto/dist/server -> node_modules/codecarto/visualizer
+        path.resolve(base, "../../visualizer"),
+        path.resolve(base, "../visualizer"),
+        path.resolve(base, "../../visualizer/dist"),
+    ];
+    for (const c of candidates) {
+        if (fs.existsSync(c))
+            return c;
+    }
+    return null;
+}
+const MIME = {
+    ".html": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".ico": "image/x-icon",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+};
+export async function startServer(options) {
+    const { graph, preferredPort = DEFAULT_PORT } = options;
+    const graphJson = JSON.stringify(graph);
+    // Inline fallback HTML if visualizer not yet built — still proves server works
+    const fallbackHtml = `<!doctype html><html lang="en"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width,initial-scale=1"/><title>CodeCarto</title><style>body{margin:0;background:#050505;color:#e6e8ec;font-family:ui-monospace,monospace;display:grid;place-items:center;height:100vh}pre{background:#0f0f12;border:1px solid #1e1e24;padding:24px;border-radius:12px;max-width:720px;overflow:auto}a{color:#00d9ff}</style></head><body><div><h1>CodeCarto</h1><p>Visualizer build not found. Run <code>pnpm build</code> in <code>apps/visualizer</code>.</p><p>Graph API: <a href="/api/graph">/api/graph</a></p><pre id="stats"></pre><script>fetch('/api/graph').then(r=>r.json()).then(g=>{document.getElementById('stats').textContent=JSON.stringify(g.stats,null,2)}).catch(e=>{document.getElementById('stats').textContent=String(e)})</script></div></body></html>`;
+    const distDir = findVisualizerDist();
+    const handler = (req, res) => {
+        const url = new URL(req.url ?? "/", `http://127.0.0.1`);
+        const pathname = url.pathname;
+        // CORS locked to localhost — no wildcard
+        res.setHeader("X-Content-Type-Options", "nosniff");
+        res.setHeader("Content-Security-Policy", "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:;");
+        if (pathname === "/api/graph") {
+            res.writeHead(200, { "Content-Type": MIME[".json"] });
+            res.end(graphJson);
+            return;
+        }
+        if (pathname === "/api/health") {
+            res.writeHead(200, { "Content-Type": MIME[".json"] });
+            res.end(JSON.stringify({ ok: true, version: graph.version }));
+            return;
+        }
+        if (distDir) {
+            const filePath = path.join(distDir, pathname === "/" ? "index.html" : pathname.replace(/^\//, ""));
+            // Prevent traversal
+            if (!filePath.startsWith(distDir)) {
+                res.writeHead(403);
+                res.end("Forbidden");
+                return;
+            }
+            if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
+                const ext = path.extname(filePath);
+                res.writeHead(200, { "Content-Type": MIME[ext] ?? "application/octet-stream" });
+                fs.createReadStream(filePath).pipe(res);
+                return;
+            }
+            // SPA fallback
+            const indexHtml = path.join(distDir, "index.html");
+            if (fs.existsSync(indexHtml)) {
+                res.writeHead(200, { "Content-Type": MIME[".html"] });
+                fs.createReadStream(indexHtml).pipe(res);
+                return;
+            }
+        }
+        // Fallback
+        res.writeHead(200, { "Content-Type": MIME[".html"] });
+        res.end(fallbackHtml);
+    };
+    let lastError = null;
+    for (let attempt = 0; attempt < MAX_PORT_ATTEMPTS; attempt++) {
+        const port = preferredPort + attempt;
+        const server = http.createServer(handler);
+        try {
+            await new Promise((resolve, reject) => {
+                server.once("error", reject);
+                server.listen(port, "127.0.0.1", () => {
+                    server.off("error", reject);
+                    resolve();
+                });
+            });
+            const url = `http://localhost:${port}`;
+            logger.verbose(`Server listening on ${url} (distDir=${distDir ?? "fallback"})`);
+            return { url, port, server };
+        }
+        catch (err) {
+            lastError = err;
+            const code = err.code;
+            if (code !== "EADDRINUSE" && code !== "EACCES")
+                throw err;
+            logger.verbose(`Port ${port} unavailable (${code}), trying next…`);
+            continue;
+        }
+    }
+    throw new Error(`Could not bind to any port from ${preferredPort} to ${preferredPort + MAX_PORT_ATTEMPTS - 1}. Last error: ${lastError?.message}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,SAAS,kBAAkB;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG;QACjB,+EAA+E;QAC/E,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,kCAAkC,CAAC;QACtD,yBAAyB;QACzB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,+BAA+B,CAAC;QACnD,yFAAyF;QACzF,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,uBAAuB,CAAC;KAC5C,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,IAAI,GAA2B;IACnC,OAAO,EAAE,0BAA0B;IACnC,KAAK,EAAE,gCAAgC;IACvC,MAAM,EAAE,yBAAyB;IACjC,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,YAAY;CACvB,CAAC;AAcF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAqB;IACrD,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAExC,+EAA+E;IAC/E,MAAM,YAAY,GAAG,w1BAAw1B,CAAC;IAE92B,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IAErC,MAAM,OAAO,GAAG,CAAC,GAAyB,EAAE,GAAwB,EAAE,EAAE;QACtE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAE9B,yCAAyC;QACzC,GAAG,CAAC,SAAS,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;QACnD,GAAG,CAAC,SAAS,CACX,yBAAyB,EACzB,gHAAgH,CACjH,CAAC;QAEF,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9B,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACtD,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC/B,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACtD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACxB,OAAO,EACP,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAC9D,CAAC;YACF,oBAAoB;YACpB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACnB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACnC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,0BAA0B,EAAE,CAAC,CAAC;gBAChF,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACxC,OAAO;YACT,CAAC;YACD,eAAe;YACf,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACnD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7B,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACtD,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACzC,OAAO;YACT,CAAC;QACH,CAAC;QAED,WAAW;QACX,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtD,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,IAAI,SAAS,GAAiB,IAAI,CAAC;IACnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,iBAAiB,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,aAAa,GAAG,OAAO,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;oBACpC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBAC5B,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,MAAM,GAAG,GAAG,oBAAoB,IAAI,EAAE,CAAC;YACvC,MAAM,CAAC,OAAO,CAAC,uBAAuB,GAAG,aAAa,OAAO,IAAI,UAAU,GAAG,CAAC,CAAC;YAChF,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAY,CAAC;YACzB,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;YACjD,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;YAC1D,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,iBAAiB,IAAI,iBAAiB,CAAC,CAAC;YACnE,SAAS;QACX,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,mCAAmC,aAAa,OAAO,aAAa,GAAG,iBAAiB,GAAG,CAAC,iBAAiB,SAAS,EAAE,OAAO,EAAE,CAClI,CAAC;AACJ,CAAC"}

package/dist/utils/banner.d.ts

@@ -0,0 +1,2 @@
+export declare function printBanner(): void;
+//# sourceMappingURL=banner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/utils/banner.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,SAiB1B"}

package/dist/utils/banner.js

@@ -0,0 +1,17 @@
+import chalk from "chalk";
+export function printBanner() {
+    // CODECARTO — ANSI Shadow figlet, verified spelling (last char is O, not P/D)
+    // Generated via `figlet -f 'ANSI Shadow' CODECARTO` — do not edit manually
+    const art = `
+ ██████╗ ██████╗ ██████╗ ███████╗ ██████╗ █████╗ ██████╗ ████████╗ ██████╗
+██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔════╝██╔══██╗██╔══██╗╚══██╔══╝██╔═══██╗
+██║     ██║   ██║██║  ██║█████╗  ██║     ███████║██████╔╝   ██║   ██║   ██║
+██║     ██║   ██║██║  ██║██╔══╝  ██║     ██╔══██║██╔══██╗   ██║   ██║   ██║
+╚██████╗╚██████╔╝██████╔╝███████╗╚██████╗██║  ██║██║  ██║   ██║   ╚██████╔╝
+ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝   ╚═╝    ╚═════╝`;
+    console.log(chalk.cyan(art));
+    console.log(chalk.bold("  CodeCarto"));
+    console.log(chalk.dim("  See your codebase.  ") +
+        chalk.dim.italic("Local \u00b7 Fast \u00b7 Private \u00b7 Visual\n"));
+}
+//# sourceMappingURL=banner.js.map

package/dist/utils/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/utils/banner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,WAAW;IACzB,8EAA8E;IAC9E,2EAA2E;IAC3E,MAAM,GAAG,GAAG;;;;;;2EAM6D,CAAC;IAE1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC;QACjC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,kDAAkD,CAAC,CACvE,CAAC;AACJ,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,12 @@
+export type LogLevel = "silent" | "info" | "verbose";
+export declare function setLogLevel(l: LogLevel): void;
+export declare function getLogLevel(): LogLevel;
+export declare const logger: {
+    info(msg: string): void;
+    verbose(msg: string): void;
+    success(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    dim(msg: string): void;
+};
+//# 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,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAIrD,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,QAEtC;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,eAAO,MAAM,MAAM;cACP,MAAM;iBAGH,MAAM;iBAGN,MAAM;cAGT,MAAM;eAGL,MAAM;aAGR,MAAM;CAGhB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,34 @@
+import chalk from "chalk";
+let level = "info";
+export function setLogLevel(l) {
+    level = l;
+}
+export function getLogLevel() {
+    return level;
+}
+export const logger = {
+    info(msg) {
+        if (level !== "silent")
+            console.log(msg);
+    },
+    verbose(msg) {
+        if (level === "verbose")
+            console.log(chalk.dim(msg));
+    },
+    success(msg) {
+        if (level !== "silent")
+            console.log(chalk.green(msg));
+    },
+    warn(msg) {
+        if (level !== "silent")
+            console.warn(chalk.yellow(`⚠ ${msg}`));
+    },
+    error(msg) {
+        console.error(chalk.red(`✗ ${msg}`));
+    },
+    dim(msg) {
+        if (level !== "silent")
+            console.log(chalk.dim(msg));
+    },
+};
+//# 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,CAAC;AAI1B,IAAI,KAAK,GAAa,MAAM,CAAC;AAE7B,MAAM,UAAU,WAAW,CAAC,CAAW;IACrC,KAAK,GAAG,CAAC,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,CAAC,GAAW;QACd,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,GAAW;QACjB,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,CAAC,GAAW;QACjB,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,GAAW;QACd,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,KAAK,CAAC,GAAW;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,GAAG,CAAC,GAAW;QACb,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;CACF,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,6 @@
+/** Normalize to POSIX, prevent traversal outside root */
+export declare function sanitizePath(root: string, p: string): string;
+export declare function ensureDirectoryExists(dir: string): Promise<void>;
+export declare function toPosix(p: string): string;
+export declare function resolveRoot(input: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAGA,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtE;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/utils/paths.js

@@ -0,0 +1,27 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+/** Normalize to POSIX, prevent traversal outside root */
+export function sanitizePath(root, p) {
+    const normalized = path.posix.normalize(p.replaceAll("\\", "/"));
+    if (normalized.includes("..")) {
+        throw new Error(`Invalid path traversal: ${p}`);
+    }
+    return normalized;
+}
+export async function ensureDirectoryExists(dir) {
+    // Validate that parent is accessible and dir is inside allowed root — caller checks existence
+    const abs = path.resolve(dir);
+    try {
+        await fs.access(path.dirname(abs));
+    }
+    catch {
+        throw new Error(`Parent directory does not exist: ${path.dirname(abs)}\n  Try: codecarto --path <existing-directory>`);
+    }
+}
+export function toPosix(p) {
+    return p.split(path.sep).join(path.posix.sep);
+}
+export function resolveRoot(input) {
+    return path.resolve(input);
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,CAAS;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACjE,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAW;IACrD,8FAA8F;IAC9F,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,oCAAoC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gDAAgD,CACtG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/utils/pipeline.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Pipeline — orchestrates scan → parse → resolve → graph.
+ * This is the core that CLI `scan` and `default` commands use.
+ */
+import type { CodeGraph } from "@yoinkingfish/shared";
+export interface PipelineOptions {
+    root: string;
+    ignore?: string[];
+    verbose?: boolean;
+    maxFileSizeBytes?: number;
+    concurrency?: number;
+}
+export interface PipelineResult {
+    graph: CodeGraph;
+    diagnostics: {
+        scanned: number;
+        parsed: number;
+        unsupported: number;
+        parseFailures: Array<{
+            path: string;
+            reason: string;
+        }>;
+        unresolvedLocals: number;
+        externals: number;
+    };
+}
+export declare function runPipeline(options: PipelineOptions): Promise<PipelineResult>;
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/utils/pipeline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,sBAAsB,CAAC;AAGhE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACvD,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA+MnF"}

package/dist/utils/pipeline.js

@@ -0,0 +1,234 @@
+/**
+ * Pipeline — orchestrates scan → parse → resolve → graph.
+ * This is the core that CLI `scan` and `default` commands use.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { scanRepositoryDetailed, getParserForExtension, resolveImport, parseTsconfigPaths, } from "@yoinkingfish/parser";
+import { buildGraph } from "@yoinkingfish/graph";
+import { LANGUAGE_BY_EXTENSION } from "@yoinkingfish/shared";
+export async function runPipeline(options) {
+    const root = path.resolve(options.root);
+    const ignore = options.ignore ?? [];
+    // Load tsconfig paths if present
+    const { tsConfigPaths, tsConfigBaseUrl } = await loadTsconfig(root);
+    // 1. Scan
+    const scan = await scanRepositoryDetailed({
+        root,
+        ignore,
+        maxFileSizeBytes: options.maxFileSizeBytes,
+        concurrency: options.concurrency,
+    });
+    const files = scan.files;
+    const existingFilesSet = new Set(files.map((f) => f.relativePath));
+    const existingAbsSet = new Set(files.map((f) => f.absolutePath));
+    // 2. Parse + build nodes + collect raw dependencies
+    const nodes = [];
+    const rawEdges = [];
+    const parseFailures = [];
+    const unsupported = [];
+    let externals = 0;
+    let unresolvedLocals = 0;
+    // Read files concurrently with limit
+    const concurrency = options.concurrency ?? 32;
+    const queue = [...files];
+    const workers = [];
+    async function worker() {
+        while (queue.length) {
+            const file = queue.pop();
+            let source;
+            try {
+                source = await fs.readFile(file.absolutePath, "utf-8");
+            }
+            catch (err) {
+                parseFailures.push({ path: file.relativePath, reason: err.message });
+                continue;
+            }
+            const parser = getParserForExtension(file.extension);
+            if (!parser) {
+                unsupported.push({ path: file.relativePath, reason: `no parser for .${file.extension}` });
+                continue;
+            }
+            let result;
+            try {
+                result = await parser.parseFile(source, {
+                    filePath: file.absolutePath,
+                    relativePath: file.relativePath,
+                    root,
+                    tsConfigPaths,
+                });
+            }
+            catch (err) {
+                parseFailures.push({ path: file.relativePath, reason: err.message });
+                continue;
+            }
+            if (result.parseError) {
+                parseFailures.push({ path: file.relativePath, reason: result.parseError });
+            }
+            // Build node
+            const dir = path.posix.dirname(file.relativePath);
+            const depth = dir === "." ? 0 : dir.split("/").length;
+            const lines = source.split("\n").length;
+            const category = inferCategory(file.relativePath);
+            nodes.push({
+                id: file.relativePath,
+                type: "file",
+                path: file.relativePath,
+                name: path.posix.basename(file.relativePath),
+                extension: file.extension,
+                language: file.language ?? LANGUAGE_BY_EXTENSION[file.extension],
+                category,
+                sizeBytes: file.sizeBytes,
+                linesOfCode: lines,
+                directory: dir,
+                depth,
+                inboundDependencies: 0,
+                outboundDependencies: 0,
+            });
+            // Collect dependencies for later resolution
+            for (const dep of result.dependencies) {
+                const resolved = resolveImport(dep.specifier, {
+                    importerPath: file.absolutePath,
+                    importerRelative: file.relativePath,
+                    root,
+                    existingFiles: existingFilesSet,
+                    existingAbsFiles: existingAbsSet,
+                    tsConfigPaths,
+                    tsConfigBaseUrl,
+                });
+                if (resolved.resolved && resolved.resolvedPath) {
+                    // Will be added as link after nodes built
+                    rawEdges.push({
+                        source: file.relativePath,
+                        specifier: dep.specifier,
+                        type: dep.type,
+                        resolved: false,
+                    });
+                    // Store resolved mapping for later
+                    dep._resolvedPath = resolved.resolvedPath;
+                    // Keep dep for link creation
+                    file._deps ??= [];
+                    file._deps.push({
+                        ...dep,
+                        _resolvedPath: resolved.resolvedPath,
+                    });
+                }
+                else {
+                    if (resolved.external)
+                        externals++;
+                    else
+                        unresolvedLocals++;
+                    // Still track unresolved? MVP omits external nodes, but we could keep meta
+                }
+            }
+            // Attach deps to file object for link phase
+            file._rawDeps = result.dependencies;
+        }
+    }
+    const workerCount = Math.min(concurrency, Math.max(1, Math.ceil(files.length / 16)));
+    for (let i = 0; i < workerCount; i++)
+        workers.push(worker());
+    await Promise.all(workers);
+    // If any unsupported files from scan, merge
+    for (const s of scan.skipped) {
+        if (s.reason.startsWith("unsupported"))
+            unsupported.push(s);
+    }
+    // 3. Build links from resolved deps
+    // We need to re-derive links from file._rawDeps that had resolved path
+    const links = [];
+    for (const file of files) {
+        const rawDeps = file._rawDeps;
+        if (!rawDeps)
+            continue;
+        for (const dep of rawDeps) {
+            const depWithResolved = dep;
+            const resolvedPath = depWithResolved._resolvedPath;
+            if (!resolvedPath)
+                continue;
+            // Only include if target exists (we already checked)
+            links.push({
+                source: file.relativePath,
+                target: resolvedPath,
+                type: dep.type,
+                resolved: true,
+                rawSpecifier: dep.specifier,
+                weight: 1,
+            });
+        }
+    }
+    // Deduplicate links (A->B may appear multiple times via multiple imports)
+    const linkMap = new Map();
+    for (const l of links) {
+        const key = `${l.source}::${l.target}::${l.type}`;
+        const existing = linkMap.get(key);
+        if (existing) {
+            existing.weight = (existing.weight ?? 1) + 1;
+        }
+        else {
+            linkMap.set(key, { ...l });
+        }
+    }
+    const dedupedLinks = [...linkMap.values()];
+    // 4. Build graph
+    const graph = buildGraph({ root, nodes, links: dedupedLinks });
+    // Enrich stats with scan/parse diagnostics
+    graph.stats.parseFailures = parseFailures;
+    graph.stats.unsupportedFiles = unsupported.map((s) => ({
+        path: s.path,
+        language: s.reason.includes(".") ? s.reason.split(".").pop() : undefined,
+    }));
+    // Recompute isolated after dedupe? buildGraph already does
+    return {
+        graph,
+        diagnostics: {
+            scanned: scan.stats.totalDiscovered,
+            parsed: nodes.length,
+            unsupported: unsupported.length,
+            parseFailures,
+            unresolvedLocals,
+            externals,
+        },
+    };
+}
+async function loadTsconfig(root) {
+    const candidates = ["tsconfig.json", "jsconfig.json"];
+    for (const name of candidates) {
+        const p = path.join(root, name);
+        try {
+            const content = await fs.readFile(p, "utf-8");
+            const parsed = parseTsconfigPaths(content, root);
+            if (parsed.paths || parsed.baseUrl)
+                return { tsConfigPaths: parsed.paths, tsConfigBaseUrl: parsed.baseUrl };
+        }
+        catch {
+            continue;
+        }
+    }
+    // Also check for tsconfig via workspaces? For monorepo, check root + packages/*/tsconfig
+    return {};
+}
+function inferCategory(relPath) {
+    const p = relPath.toLowerCase();
+    if (p.includes("__tests__") ||
+        p.endsWith(".test.ts") ||
+        p.endsWith(".test.tsx") ||
+        p.endsWith(".spec.ts") ||
+        p.includes("/test/"))
+        return "test";
+    if (p.includes("/components/") || p.includes("/ui/") || p.endsWith(".css") || p.endsWith(".scss"))
+        return p.endsWith(".css") || p.endsWith(".scss") ? "style" : "ui";
+    if (p.includes("/api/") ||
+        p.includes("/routes/") ||
+        p.includes("/pages/api/") ||
+        p.startsWith("api/"))
+        return "api";
+    if (p.includes("/config/") || p.endsWith(".config.ts") || p.endsWith(".config.js"))
+        return "config";
+    if (p.includes("/utils/") || p.includes("/helpers/") || p.includes("/lib/"))
+        return "util";
+    if (p.includes("/data/") || p.includes("/db/") || p.includes("/models/"))
+        return "data";
+    return "other";
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/utils/pipeline.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@yoinkingfish/codecarto",
+  "version": "0.1.1",
+  "description": "See your codebase — local-first 3D architecture visualization",
+  "type": "module",
+  "bin": {
+    "codecarto": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fast-glob": "^3.3.2",
+    "open": "^10.1.0",
+    "ora": "^8.0.1",
+    "zod": "^3.23.8",
+    "@yoinkingfish/graph": "0.1.1",
+    "@yoinkingfish/parser": "0.1.1",
+    "@yoinkingfish/shared": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.4",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "architecture",
+    "visualization",
+    "3d",
+    "ast",
+    "graph",
+    "cli",
+    "developer-tools"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OpKnock/codecarto.git"
+  },
+  "author": "Mehul Wagde <yoinkingfish@gmail.com>",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "clean": "rimraf dist",
+    "test": "vitest run"
+  }
+}