@flaid/devmap 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAQ/D;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrE;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAuBnC;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACxE,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAM9B"}

package/dist/utils/config.js

@@ -0,0 +1,88 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { output } from "./output.js";
+export function getConfigPath() {
+    return join(homedir(), ".devmap", "config.json");
+}
+export async function readConfig() {
+    try {
+        const raw = await readFile(getConfigPath(), "utf8");
+        const parsed = JSON.parse(raw);
+        return normalizeConfig(parsed);
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeConfig(config) {
+    const configPath = getConfigPath();
+    await mkdir(dirname(configPath), { recursive: true });
+    await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+export function getLocalConfigPath(projectRoot) {
+    return join(projectRoot, ".devmap", "config.local.json");
+}
+export async function readLocalConfig(projectRoot) {
+    try {
+        const raw = await readFile(getLocalConfigPath(projectRoot), "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            return null;
+        }
+        const record = parsed;
+        if ("apiKey" in record || "provider" in record) {
+            output.warning("config.local.json only supports \"model\", apiKey/provider are always read from the global config and were ignored here.");
+        }
+        return typeof record.model === "string"
+            ? { model: record.model }
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeLocalConfig(projectRoot, config) {
+    const configPath = getLocalConfigPath(projectRoot);
+    await mkdir(dirname(configPath), { recursive: true });
+    await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+export async function resolveEffectiveConfig(projectRoot, readers = {}) {
+    const global = await (readers.readGlobal ?? readConfig)();
+    if (!global)
+        return null;
+    const local = await (readers.readLocal ?? readLocalConfig)(projectRoot);
+    return local?.model ? { ...global, model: local.model } : global;
+}
+function normalizeConfig(value) {
+    if (typeof value !== "object"
+        || value === null
+        || Array.isArray(value)) {
+        return null;
+    }
+    const record = value;
+    const provider = record.provider === undefined
+        ? "groq"
+        : record.provider;
+    const model = record.model === undefined
+        ? "auto"
+        : record.model;
+    if (provider !== "groq" && provider !== "openrouter") {
+        return null;
+    }
+    if (typeof model !== "string") {
+        return null;
+    }
+    const config = {
+        provider,
+        model
+    };
+    if (record.apiKey !== undefined) {
+        if (typeof record.apiKey !== "string") {
+            return null;
+        }
+        config.apiKey = record.apiKey;
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/devmapFile.d.ts

@@ -0,0 +1,3 @@
+export declare function ensureDevmapFile(projectRoot: string): Promise<boolean>;
+export declare function buildDevmapFile(): string;
+//# sourceMappingURL=devmapFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"devmapFile.d.ts","sourceRoot":"","sources":["../../src/utils/devmapFile.ts"],"names":[],"mappings":"AAGA,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU5E;AAED,wBAAgB,eAAe,WA6B9B"}

package/dist/utils/devmapFile.js

@@ -0,0 +1,43 @@
+import { access, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+export async function ensureDevmapFile(projectRoot) {
+    const path = join(projectRoot, "DEVMAP.md");
+    try {
+        await access(path);
+        return false;
+    }
+    catch {
+        await writeFile(path, buildDevmapFile(), "utf8");
+        return true;
+    }
+}
+export function buildDevmapFile() {
+    return `# DevMap
+
+This repository uses DevMap to create reusable project context for developers and AI agents.
+
+## Project Context
+
+- Agent navigation index: \`.devmap/index.json\`
+- Feature maps: \`.devmap/features/*.json\`
+- Full analysis archive: \`.devmap/snapshot.json\`
+- DevMap config: \`~/.devmap/config.json\`
+
+## Commands
+
+\`\`\`bash
+devmap analyze
+devmap analyze --fresh
+devmap analyze --json
+devmap doctor
+devmap doctor --json
+\`\`\`
+
+## Navigation Order
+
+1. \`.devmap/index.json\` — entry point, pick relevant feature
+2. \`.devmap/features/*.json\` — focused feature map
+3. \`.devmap/snapshot.json\` — full archive, only when above is insufficient
+`;
+}
+//# sourceMappingURL=devmapFile.js.map

package/dist/utils/devmapFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devmapFile.js","sourceRoot":"","sources":["../../src/utils/devmapFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,SAAS,CAAC,IAAI,EAAC,eAAe,EAAE,EAAE,MAAM,CAAC,CAAA;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAE7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BR,CAAC;AACF,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class DevmapError extends Error {
+    readonly hint?: string | undefined;
+    readonly exitCode: number;
+    constructor(message: string, hint?: string | undefined, exitCode?: number);
+}
+export declare function handleError(error: unknown, json?: boolean): number;
+export declare function runSafely(action: () => Promise<void>): Promise<void>;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,WAAY,SAAQ,KAAK;aAGlB,IAAI,CAAC,EAAE,MAAM;aACb,QAAQ;gBAFxB,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,QAAQ,SAAI;CAK/B;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,UAAQ,GAAG,MAAM,CA0ChE;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1E"}

package/dist/utils/errors.js

@@ -0,0 +1,92 @@
+import { output } from "./output.js";
+export class DevmapError extends Error {
+    hint;
+    exitCode;
+    constructor(message, hint, exitCode = 1) {
+        super(message);
+        this.hint = hint;
+        this.exitCode = exitCode;
+        this.name = "DevmapError";
+    }
+}
+export function handleError(error, json = false) {
+    if (json) {
+        const normalized = normalizeError(error);
+        output.json({
+            status: "error",
+            error: normalized.message,
+            hint: normalized.hint ?? null
+        });
+        return normalized.exitCode;
+    }
+    if (error instanceof DevmapError) {
+        output.error(error.message);
+        if (error.hint) {
+            output.note(`Tip: ${error.hint}`);
+        }
+        return error.exitCode;
+    }
+    if (isNodeError(error)) {
+        if (error.code === "ENOENT") {
+            output.error("The requested project path could not be found.");
+            output.note("Tip: Check the path and run the command again.");
+            return 1;
+        }
+        if (error.code === "EACCES" || error.code === "EPERM") {
+            output.error("DevMap does not have permission to access a required file.");
+            output.note("Tip: Check folder permissions or run DevMap from a writable project directory.");
+            return 1;
+        }
+    }
+    if (error instanceof Error) {
+        output.error("DevMap could not complete the command.");
+        output.note(`Reason: ${error.message}`);
+    }
+    else {
+        output.error("DevMap could not complete the command due to an unknown error.");
+    }
+    output.note("Tip: Run devmap doctor and include its output when reporting this issue.");
+    return 1;
+}
+export async function runSafely(action) {
+    try {
+        await action();
+    }
+    catch (error) {
+        process.exitCode = handleError(error, process.argv.includes("--json"));
+    }
+}
+function normalizeError(error) {
+    if (error instanceof DevmapError) {
+        return {
+            message: error.message,
+            hint: error.hint,
+            exitCode: error.exitCode
+        };
+    }
+    if (isNodeError(error) && error.code === "ENOENT") {
+        return {
+            message: "The requested project path could not be found.",
+            hint: "Check the path and run the command again.",
+            exitCode: 1
+        };
+    }
+    if (isNodeError(error) && (error.code === "EACCES" || error.code === "EPERM")) {
+        return {
+            message: "DevMap does not have permission to access a required file.",
+            hint: "Check folder permissions or run DevMap from a writable project directory.",
+            exitCode: 1
+        };
+    }
+    return {
+        message: error instanceof Error
+            ? error.message
+            : "DevMap could not complete the command due to an unknown error.",
+        hint: "Run devmap doctor --json and include its output when reporting this issue.",
+        exitCode: 1
+    };
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/gitignore.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureDevmapIgnored(projectRoot: string): Promise<boolean>;
+//# 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":"AAGA,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqB/E"}

package/dist/utils/gitignore.js

@@ -0,0 +1,22 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+export async function ensureDevmapIgnored(projectRoot) {
+    const gitignorePath = join(projectRoot, ".gitignore");
+    let current = "";
+    try {
+        current = await readFile(gitignorePath, "utf8");
+    }
+    catch {
+        current = "";
+    }
+    const lines = current.split(/\r?\n/).map((line) => line.trim());
+    if (lines.includes(".devmap/") || lines.includes(".devmap")) {
+        return false;
+    }
+    const next = current.length > 0 && !current.endsWith("\n")
+        ? `${current}\n.devmap/\n`
+        : `${current}.devmap/\n`;
+    await writeFile(gitignorePath, next, "utf8");
+    return true;
+}
+//# 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,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAEtD,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,EAAE,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QACxD,CAAC,CAAC,GAAG,OAAO,cAAc;QAC1B,CAAC,CAAC,GAAG,OAAO,YAAY,CAAC;IAE3B,MAAM,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/help.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function printHelp(program: Command): void;
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/utils/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkBhD"}

package/dist/utils/help.js

@@ -0,0 +1,19 @@
+import { theme } from "./output.js";
+export function printHelp(program) {
+    console.log(`\n${theme.aqua}devmap${theme.reset} - Understand any codebase.\n`);
+    console.log(`${theme.aqua}USAGE${theme.reset}`);
+    console.log(`  devmap <command> [options]\n`);
+    console.log(`${theme.aqua}COMMANDS${theme.reset}`);
+    for (const cmd of program.commands) {
+        const args = cmd.registeredArguments
+            .map((argument) => (argument.required ? `<${argument.name()}>` : `[${argument.name()}]`))
+            .join(" ");
+        const usage = args ? `${cmd.name()} ${args}` : cmd.name();
+        console.log(`  ${theme.aqua}${usage.padEnd(16)}${theme.reset} ${theme.gray}${cmd.description()}${theme.reset}`);
+    }
+    console.log(`\n${theme.aqua}OPTIONS${theme.reset}`);
+    console.log(`  ${theme.aqua}-V, --version${theme.reset}   ${theme.gray}Show version number${theme.reset}`);
+    console.log(`  ${theme.aqua}-h, --help${theme.reset}      ${theme.gray}Show help message${theme.reset}`);
+    console.log(`\n${theme.gray}More info: ${theme.aqua}https://github.com/itsflaid/devmap${theme.reset}\n`);
+}
+//# sourceMappingURL=help.js.map

package/dist/utils/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/utils/help.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,UAAU,SAAS,CAAC,OAAgB;IACxC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,KAAK,+BAA+B,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAEnD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,GAAG,CAAC,mBAAmB;aACjC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;aACxF,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAClH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,IAAI,sBAAsB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3G,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,KAAK,SAAS,KAAK,CAAC,IAAI,oBAAoB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACzG,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,cAAc,KAAK,CAAC,IAAI,qCAAqC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;AAC3G,CAAC"}

package/dist/utils/mapRenderer.d.ts

@@ -0,0 +1,39 @@
+import type { MapTreeNode } from "../analyzers/graph/dependencyMap.js";
+/**
+ * renderTree — render a MapTreeNode as an indented, box-drawing tree
+ * (same visual convention as the Unix `tree` command). Cycle-closing nodes
+ * are suffixed with "(cycle)" instead of being expanded further.
+ */
+export declare function renderTree(node: MapTreeNode, prefix?: string): string;
+/**
+ * renderFlatList — simple bullet list for cases (feature/project mode) where
+ * a flat "these files are involved" view reads better than a nested tree.
+ */
+export declare function renderFlatList(paths: string[], options?: {
+    cap?: number;
+}): string;
+export type MermaidEdge = {
+    from: string;
+    to: string;
+};
+/**
+ * renderMermaid — render a set of file-to-file edges as a Mermaid
+ * flowchart. Mermaid node IDs can't contain slashes/dots, so each real path
+ * gets a sanitized ID with the real path kept as the visible label.
+ */
+export declare function renderMermaid(edges: MermaidEdge[], options?: {
+    direction?: "LR" | "TD";
+}): string;
+/**
+ * buildMapMarkdown — wrap a text tree + Mermaid diagram into a single .md
+ * body, in the same style as the rest of DevMap's generated docs.
+ */
+export declare function buildMapMarkdown(options: {
+    title: string;
+    sections: Array<{
+        heading: string;
+        body: string;
+    }>;
+    mermaid?: string;
+}): string;
+//# sourceMappingURL=mapRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapRenderer.d.ts","sourceRoot":"","sources":["../../src/utils/mapRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,SAAK,GAAG,MAAM,CAIjE;AA2BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAUtF;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CAAO,GACxC,MAAM,CAyBR;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAYT"}

package/dist/utils/mapRenderer.js

@@ -0,0 +1,90 @@
+/**
+ * renderTree — render a MapTreeNode as an indented, box-drawing tree
+ * (same visual convention as the Unix `tree` command). Cycle-closing nodes
+ * are suffixed with "(cycle)" instead of being expanded further.
+ */
+export function renderTree(node, prefix = "") {
+    const lines = [];
+    renderTreeLines(node, prefix, lines);
+    return lines.length > 0 ? lines.join("\n") : "(no connections found)";
+}
+function renderTreeLines(node, prefix, lines) {
+    const { children, truncatedCount } = node;
+    const hasMore = Boolean(truncatedCount);
+    children.forEach((child, index) => {
+        const isLast = index === children.length - 1 && !hasMore;
+        const branch = isLast ? "└── " : "├── ";
+        const nextPrefix = prefix + (isLast ? "    " : "│   ");
+        const suffix = child.isCycle ? " (cycle)" : "";
+        lines.push(`${prefix}${branch}${child.path}${suffix}`);
+        if (!child.isCycle) {
+            renderTreeLines(child, nextPrefix, lines);
+        }
+    });
+    if (hasMore) {
+        lines.push(`${prefix}└── … +${truncatedCount} more (truncated for readability — pass --all to see everything)`);
+    }
+}
+/**
+ * renderFlatList — simple bullet list for cases (feature/project mode) where
+ * a flat "these files are involved" view reads better than a nested tree.
+ */
+export function renderFlatList(paths, options = {}) {
+    if (paths.length === 0)
+        return "(none)";
+    const cap = options.cap ?? Infinity;
+    const shown = paths.slice(0, cap);
+    const lines = shown.map((path) => `  - ${path}`);
+    const omitted = paths.length - shown.length;
+    if (omitted > 0) {
+        lines.push(`  - … +${omitted} more (truncated for readability — pass --all to see everything)`);
+    }
+    return lines.join("\n");
+}
+/**
+ * renderMermaid — render a set of file-to-file edges as a Mermaid
+ * flowchart. Mermaid node IDs can't contain slashes/dots, so each real path
+ * gets a sanitized ID with the real path kept as the visible label.
+ */
+export function renderMermaid(edges, options = {}) {
+    const direction = options.direction ?? "LR";
+    const ids = new Map();
+    const idFor = (path) => {
+        const existing = ids.get(path);
+        if (existing)
+            return existing;
+        const id = `n${ids.size}`;
+        ids.set(path, id);
+        return id;
+    };
+    const lines = [`graph ${direction}`];
+    const seenEdges = new Set();
+    for (const edge of edges) {
+        const key = `${edge.from}=>${edge.to}`;
+        if (seenEdges.has(key))
+            continue;
+        seenEdges.add(key);
+        const fromId = idFor(edge.from);
+        const toId = idFor(edge.to);
+        lines.push(`  ${fromId}["${escapeMermaidLabel(edge.from)}"] --> ${toId}["${escapeMermaidLabel(edge.to)}"]`);
+    }
+    return lines.join("\n");
+}
+function escapeMermaidLabel(label) {
+    return label.replace(/"/g, "#quot;");
+}
+/**
+ * buildMapMarkdown — wrap a text tree + Mermaid diagram into a single .md
+ * body, in the same style as the rest of DevMap's generated docs.
+ */
+export function buildMapMarkdown(options) {
+    const parts = [`# ${options.title}`, ""];
+    for (const section of options.sections) {
+        parts.push(`## ${section.heading}`, "", section.body, "");
+    }
+    if (options.mermaid) {
+        parts.push("## Diagram", "", "```mermaid", options.mermaid, "```", "");
+    }
+    return parts.join("\n").trimEnd() + "\n";
+}
+//# sourceMappingURL=mapRenderer.js.map

package/dist/utils/mapRenderer.js.map

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

package/dist/utils/markdownTerminal.d.ts

@@ -0,0 +1,6 @@
+export type MarkdownRenderOptions = {
+    width?: number;
+    colors?: boolean;
+};
+export declare function renderTerminalMarkdown(markdown: string, options?: MarkdownRenderOptions): string;
+//# sourceMappingURL=markdownTerminal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdownTerminal.d.ts","sourceRoot":"","sources":["../../src/utils/markdownTerminal.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AASF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAiER"}

package/dist/utils/markdownTerminal.js

@@ -0,0 +1,153 @@
+const ANSI = {
+    aqua: "\x1b[38;2;46;230;214m",
+    bold: "\x1b[1m",
+    gray: "\x1b[90m",
+    reset: "\x1b[0m"
+};
+export function renderTerminalMarkdown(markdown, options = {}) {
+    const width = Math.max(32, options.width ?? 80);
+    const colors = options.colors ?? true;
+    const lines = markdown.replace(/\r\n?/g, "\n").split("\n");
+    const rendered = [];
+    let index = 0;
+    let inCodeBlock = false;
+    while (index < lines.length) {
+        const line = lines[index];
+        if (/^\s*```/.test(line)) {
+            inCodeBlock = !inCodeBlock;
+            index += 1;
+            continue;
+        }
+        if (inCodeBlock) {
+            rendered.push(style(`  ${line}`, "gray", colors));
+            index += 1;
+            continue;
+        }
+        if (isTableStart(lines, index)) {
+            const tableEnd = findTableEnd(lines, index);
+            rendered.push(...renderTable(lines.slice(index, tableEnd), width, colors));
+            index = tableEnd;
+            continue;
+        }
+        const heading = line.match(/^\s{0,3}#{1,6}\s+(.+?)\s*#*\s*$/);
+        if (heading) {
+            const title = cleanInline(heading[1]);
+            rendered.push(style(title, "heading", colors));
+            rendered.push(style("-".repeat(Math.min(width, Math.max(12, title.length))), "gray", colors));
+            index += 1;
+            continue;
+        }
+        const listItem = line.match(/^(\s*)([-+*]|\d+\.)\s+(.+)$/);
+        if (listItem) {
+            const marker = /^\d/.test(listItem[2]) ? listItem[2] : "-";
+            const indent = listItem[1].length + (marker === "-" ? 0 : 0);
+            rendered.push(...wrapWithPrefix(cleanInline(listItem[3]), `${" ".repeat(indent)}${marker} `, width));
+            index += 1;
+            continue;
+        }
+        if (line.trim() === "") {
+            if (rendered.at(-1) !== "") {
+                rendered.push("");
+            }
+            index += 1;
+            continue;
+        }
+        rendered.push(...wrapText(cleanInline(line.trim()), width));
+        index += 1;
+    }
+    return trimBlankLines(rendered).join("\n");
+}
+function isTableStart(lines, index) {
+    return (index + 1 < lines.length
+        && lines[index].includes("|")
+        && /^\s*\|?\s*:?-{3,}/.test(lines[index + 1]));
+}
+function findTableEnd(lines, start) {
+    let index = start + 2;
+    while (index < lines.length && lines[index].includes("|") && lines[index].trim() !== "") {
+        index += 1;
+    }
+    return index;
+}
+function renderTable(tableLines, width, colors) {
+    const headers = parseTableRow(tableLines[0]).map(cleanInline);
+    const rows = tableLines.slice(2).map((line) => parseTableRow(line).map(cleanInline));
+    const labelWidth = Math.min(18, Math.max(8, ...headers.slice(1).map((header) => header.length)));
+    const rendered = [];
+    for (const row of rows) {
+        const title = row[0] || "Item";
+        rendered.push(style(title, "heading", colors));
+        for (let index = 1; index < headers.length; index += 1) {
+            const label = headers[index] || `Column ${index + 1}`;
+            const value = row[index] || "-";
+            rendered.push(...wrapWithPrefix(value, `  ${label.padEnd(labelWidth)}  `, width));
+        }
+        rendered.push("");
+    }
+    return trimBlankLines(rendered);
+}
+function parseTableRow(line) {
+    return line
+        .trim()
+        .replace(/^\|/, "")
+        .replace(/\|$/, "")
+        .split("|")
+        .map((cell) => cell.trim());
+}
+function cleanInline(value) {
+    return value
+        .replace(/!\[([^\]]*)]\([^)]*\)/g, "$1")
+        .replace(/\[([^\]]+)]\(([^)]+)\)/g, "$1 ($2)")
+        .replace(/(\*\*|__)(.*?)\1/g, "$2")
+        .replace(/\*([^*]+)\*/g, "$1")
+        .replace(/~~(.*?)~~/g, "$1")
+        .replace(/`([^`]+)`/g, "$1")
+        .replace(/\\([\\`*_[\]{}()#+\-.!|>])/g, "$1");
+}
+function wrapText(value, width) {
+    return wrapWithPrefix(value, "", width);
+}
+function wrapWithPrefix(value, prefix, width) {
+    const continuation = " ".repeat(prefix.length);
+    const available = Math.max(12, width - prefix.length);
+    const words = value.split(/\s+/).filter(Boolean);
+    const lines = [];
+    let current = "";
+    for (const word of words) {
+        if (!current) {
+            current = word;
+            continue;
+        }
+        if (`${current} ${word}`.length <= available) {
+            current = `${current} ${word}`;
+            continue;
+        }
+        lines.push(`${lines.length === 0 ? prefix : continuation}${current}`);
+        current = word;
+    }
+    if (current || lines.length === 0) {
+        lines.push(`${lines.length === 0 ? prefix : continuation}${current}`);
+    }
+    return lines;
+}
+function style(value, tone, colors) {
+    if (!colors) {
+        return value;
+    }
+    if (tone === "heading") {
+        return `${ANSI.bold}${ANSI.aqua}${value}${ANSI.reset}`;
+    }
+    return `${ANSI.gray}${value}${ANSI.reset}`;
+}
+function trimBlankLines(lines) {
+    let start = 0;
+    let end = lines.length;
+    while (start < end && lines[start] === "") {
+        start += 1;
+    }
+    while (end > start && lines[end - 1] === "") {
+        end -= 1;
+    }
+    return lines.slice(start, end);
+}
+//# sourceMappingURL=markdownTerminal.js.map