@flaid/devmap 0.2.0

package/dist/commands/flow.d.ts

@@ -0,0 +1,34 @@
+import type { AiClient } from "../ai/types.js";
+import { type FlowInfo } from "../analyzers/pipeline/index.js";
+import { type DevmapConfig } from "../utils/config.js";
+export type FlowOptions = {
+    json?: boolean;
+    projectRoot?: string;
+    all?: boolean;
+};
+export type FlowDependencies = {
+    loadConfig?: () => Promise<DevmapConfig | null>;
+    createAiClient?: (config: DevmapConfig) => AiClient;
+};
+export type FlowResult = {
+    status: "ok";
+    flows: Array<{
+        name: string;
+        purpose: string;
+        type: FlowInfo["type"];
+        markdown: string;
+        mermaid: string;
+        narrated: boolean;
+    }>;
+    writtenPaths: Array<{
+        name: string;
+        markdown: string;
+        mermaid: string;
+    }>;
+    snapshot: {
+        generatedAt: string;
+        stale: boolean;
+    };
+};
+export declare function flowCommand(target: string | undefined, options?: FlowOptions, dependencies?: FlowDependencies): Promise<void>;
+//# sourceMappingURL=flow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/commands/flow.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAIL,KAAK,QAAQ,EAEd,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAM/E,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,QAAQ,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,QAAQ,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CACnD,CAAC;AAEF,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,GAAE,WAAgB,EACzB,YAAY,GAAE,gBAAqB,GAClC,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/commands/flow.js

@@ -0,0 +1,151 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { completeWithOptionalStreaming } from "../ai/completion.js";
+import { createAiClient as createDefaultAiClient, resolveAiRouting } from "../ai/provider.js";
+import { buildFlowNarrationMessages } from "../ai/prompts.js";
+import { generateFeatureFlows, generateRequestFlows, renderMermaidFlow } from "../analyzers/pipeline/index.js";
+import { isSnapshotStale, readSnapshotOrThrow } from "../cache/snapshot.js";
+import { resolveEffectiveConfig } from "../utils/config.js";
+import { DevmapError } from "../utils/errors.js";
+import { buildMapMarkdown } from "../utils/mapRenderer.js";
+import { output, withJsonOutput } from "../utils/output.js";
+import { slugifyMapName } from "../utils/slug.js";
+export async function flowCommand(target, options = {}, dependencies = {}) {
+    if (options.json) {
+        await withJsonOutput(async () => {
+            output.json(await runFlow(target, options, dependencies));
+        });
+        return;
+    }
+    const result = await runFlow(target, options, dependencies);
+    output.section("DevMap — flows");
+    if (result.snapshot.stale) {
+        output.warning("Snapshot is stale: these flows may not reflect the latest code.");
+        output.note("Run devmap analyze --fresh, then repeat devmap flow.");
+    }
+    if (!target && result.flows.length > 1) {
+        output.section("Flows written");
+        for (const flow of result.flows) {
+            output.item(`${flow.name} — ${flow.purpose}`);
+        }
+    }
+    for (const path of result.writtenPaths) {
+        output.success(`Wrote ${path.markdown}`);
+        output.success(`Wrote ${path.mermaid}`);
+    }
+}
+async function runFlow(target, options, dependencies) {
+    const projectRoot = resolve(options.projectRoot ?? ".");
+    const snapshot = await readSnapshotOrThrow(projectRoot);
+    const stale = await isSnapshotStale(projectRoot, snapshot);
+    const flows = options.all
+        ? buildAllFlows(snapshot)
+        : snapshot.flows;
+    const resolved = resolveFlowTarget(flows, target);
+    const loadConfig = dependencies.loadConfig
+        ?? (() => resolveEffectiveConfig(projectRoot));
+    const config = await loadConfig();
+    let client;
+    let routing;
+    if (!config?.apiKey) {
+        output.note("AI flow narration is not configured. Run devmap init to enable it.");
+    }
+    else {
+        const createAiClient = dependencies.createAiClient ?? createDefaultAiClient;
+        client = createAiClient(config);
+        routing = resolveAiRouting(config, "flowNarration");
+    }
+    const flowsDir = join(projectRoot, ".devmap", "flows");
+    await mkdir(flowsDir, { recursive: true });
+    const built = [];
+    for (const flow of resolved) {
+        const narration = client && routing
+            ? await narrateFlow(client, routing.model, routing.fallbackModels, flow, options.json ?? false)
+            : undefined;
+        const markdown = buildMapMarkdown({
+            title: flow.name,
+            sections: [
+                { heading: "Purpose", body: flow.purpose },
+                ...(narration ? [{ heading: "How it works", body: narration }] : []),
+                {
+                    heading: "Steps",
+                    body: flow.steps.map((step, index) => `${index + 1}. ${step.label}${step.file ? ` (\`${step.file}\`)` : ""}`).join("\n")
+                }
+            ],
+            mermaid: flow.mermaid ?? renderMermaidFlow(flow.steps)
+        });
+        const mermaid = flow.mermaid ?? renderMermaidFlow(flow.steps);
+        const slug = slugifyMapName(flow.name);
+        await writeFile(join(flowsDir, `${slug}.md`), markdown, "utf8");
+        await writeFile(join(flowsDir, `${slug}.mermaid`), `${mermaid}\n`, "utf8");
+        built.push({
+            name: flow.name,
+            purpose: flow.purpose,
+            type: flow.type,
+            markdown,
+            mermaid,
+            narrated: Boolean(narration),
+            slug
+        });
+    }
+    return {
+        status: "ok",
+        flows: built.map(({ slug: _slug, ...rest }) => rest),
+        writtenPaths: built.map(({ name, slug }) => ({
+            name,
+            markdown: `.devmap/flows/${slug}.md`,
+            mermaid: `.devmap/flows/${slug}.mermaid`
+        })),
+        snapshot: { generatedAt: snapshot.generatedAt, stale }
+    };
+}
+function buildAllFlows(snapshot) {
+    return [
+        ...generateFeatureFlows(snapshot.features, snapshot.fileIndex, {
+            limit: Infinity,
+            minConfidence: "medium"
+        }),
+        ...generateRequestFlows(snapshot.routes, snapshot.fileIndex, snapshot.fileGraph, {
+            limit: Infinity,
+            includeAllRouteKinds: true
+        })
+    ];
+}
+function resolveFlowTarget(flows, target) {
+    if (!target || target.trim() === "")
+        return flows;
+    const exact = flows.filter(f => f.name.toLowerCase() === target.toLowerCase());
+    if (exact.length > 0)
+        return exact;
+    const partial = flows.filter(f => f.name.toLowerCase().includes(target.toLowerCase()));
+    if (partial.length === 1)
+        return partial;
+    if (partial.length > 1) {
+        throw new DevmapError(`"${target}" matches multiple flows.`, `Be more specific — options: ${partial.map(f => f.name).join(", ")}`);
+    }
+    const names = flows.map(f => f.name).join(", ") || "(none detected)";
+    throw new DevmapError(`"${target}" isn't a known flow.`, `Known flows: ${names}. Run devmap flow --all to see the full list.`);
+}
+async function narrateFlow(client, model, fallbackModels, flow, json) {
+    try {
+        const execution = await completeWithOptionalStreaming(client, {
+            messages: buildFlowNarrationMessages(flow),
+            model,
+            fallbackModels,
+            maxCompletionTokens: 400,
+            temperature: 0.2
+        }, !json, () => output.section("How it works"));
+        return execution.result.content;
+    }
+    catch (error) {
+        if (!(error instanceof DevmapError)) {
+            throw error;
+        }
+        output.warning(error.message);
+        if (error.hint) {
+            output.note(`Tip: ${error.hint}`);
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=flow.js.map

package/dist/commands/flow.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,16 @@
+import { type DevmapConfig } from "../utils/config.js";
+import { type Prompt } from "../utils/prompt.js";
+export type InitDependencies = {
+    json?: boolean;
+    projectRoot?: string;
+    prompt?: Prompt;
+    validateApiKey?: (apiKey: string, provider: DevmapConfig["provider"]) => Promise<void>;
+    listGroqModels?: (apiKey: string) => Promise<string[]>;
+    isInteractive?: boolean;
+    environmentApiKey?: string;
+    environmentOpenRouterApiKey?: string;
+    loadConfig?: () => Promise<DevmapConfig | null>;
+    persistConfig?: (config: DevmapConfig) => Promise<void>;
+};
+export declare function initCommand(dependencies?: InitDependencies): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAQA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUhF,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG/D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,CACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,KAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD,CAAC;AAEF,wBAAsB,WAAW,CAAC,YAAY,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF"}

package/dist/commands/init.js

@@ -0,0 +1,197 @@
+import { mkdir } from "node:fs/promises";
+import { resolve } from "node:path";
+import { listGroqModels, validateGroqApiKey } from "../ai/groq.js";
+import { OPENROUTER_FREE_MODEL, validateOpenRouterApiKey } from "../ai/openrouter.js";
+import { providerDisplayName } from "../ai/provider.js";
+import { readConfig, writeConfig } from "../utils/config.js";
+import { ensureAgentsFile, inspectAgentsFile } from "../utils/agentsFile.js";
+import { ensureDevmapFile } from "../utils/devmapFile.js";
+import { DevmapError } from "../utils/errors.js";
+import { ensureDevmapIgnored } from "../utils/gitignore.js";
+import { output, withJsonOutput } from "../utils/output.js";
+import { createPrompt } from "../utils/prompt.js";
+import { renderWelcomeBrandPanel } from "../utils/welcome.js";
+export async function initCommand(dependencies = {}) {
+    if (dependencies.json) {
+        await withJsonOutput(async () => {
+            output.json(await runInit(dependencies));
+        });
+        return;
+    }
+    await runInit(dependencies);
+}
+async function runInit(dependencies) {
+    const projectRoot = resolve(dependencies.projectRoot ?? process.cwd());
+    const interactive = dependencies.json
+        ? false
+        : dependencies.isInteractive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    const loadConfig = dependencies.loadConfig ?? readConfig;
+    const persistConfig = dependencies.persistConfig ?? writeConfig;
+    const existingConfig = await loadConfig();
+    const prompt = dependencies.prompt ?? (interactive ? createPrompt() : null);
+    if (!dependencies.json) {
+        console.log(renderWelcomeBrandPanel(process.stdout.columns ?? 80));
+        console.log("");
+    }
+    output.section("DevMap Init");
+    try {
+        const provider = await resolveProvider(prompt, interactive, existingConfig);
+        const providerName = providerDisplayName(provider);
+        const environmentApiKey = dependencies.environmentApiKey
+            ?? (provider === "openrouter"
+                ? dependencies.environmentOpenRouterApiKey ?? process.env.OPENROUTER_API_KEY
+                : process.env.GROQ_API_KEY);
+        const validateApiKey = dependencies.validateApiKey
+            ?? ((key, selectedProvider) => (selectedProvider === "openrouter"
+                ? validateOpenRouterApiKey(key)
+                : validateGroqApiKey(key)));
+        output.keyValue("Provider", providerName);
+        const apiKey = await resolveApiKey({
+            prompt,
+            interactive,
+            environmentApiKey,
+            existingApiKey: existingConfig?.provider === provider
+                ? existingConfig.apiKey
+                : undefined,
+            provider
+        });
+        output.step(`Validating ${providerName} API key`);
+        await validateApiKey(apiKey, provider);
+        output.success(`${providerName} API key is valid`);
+        const model = await resolveInitialModel({
+            provider,
+            apiKey,
+            prompt,
+            interactive,
+            existingConfig,
+            listModels: dependencies.listGroqModels ?? listGroqModels
+        });
+        const agentsStatus = await inspectAgentsFile(projectRoot);
+        const appendToExistingAgents = agentsStatus === "existing"
+            && interactive
+            && prompt
+            ? isAffirmative(await prompt.ask("AGENTS.md exists. Append DevMap instructions? [y/N]: "))
+            : false;
+        await mkdir(resolve(projectRoot, ".devmap"), { recursive: true });
+        await persistConfig({
+            provider,
+            apiKey,
+            model
+        });
+        const ignored = await ensureDevmapIgnored(projectRoot);
+        const devmapFileCreated = await ensureDevmapFile(projectRoot);
+        const agentsResult = await ensureAgentsFile(projectRoot, appendToExistingAgents);
+        output.success("Config saved to ~/.devmap/config.json");
+        if (provider === "openrouter") {
+            output.note(`OpenRouter model: ${model}`);
+            output.note("Change it later with: devmap config model <model-id>");
+        }
+        else if (model !== "auto") {
+            output.note(`Groq model: ${model}`);
+            output.note("Change it later with: devmap config model <model-id>");
+        }
+        output.success(ignored ? "Added .devmap/ to .gitignore" : ".devmap/ already ignored");
+        output.success(devmapFileCreated ? "Created DEVMAP.md" : "DEVMAP.md already exists");
+        printAgentsResult(agentsResult);
+        output.step("Next: devmap analyze");
+        return {
+            status: "ok",
+            provider,
+            model,
+            files: {
+                gitignoreUpdated: ignored,
+                devmapFileCreated,
+                agentsFile: agentsResult
+            },
+            next: "devmap analyze"
+        };
+    }
+    finally {
+        prompt?.close();
+    }
+}
+function isAffirmative(answer) {
+    return ["y", "yes"].includes(answer.trim().toLowerCase());
+}
+function printAgentsResult(result) {
+    if (result === "created") {
+        output.success("Created AGENTS.md");
+        return;
+    }
+    if (result === "appended") {
+        output.success("Added DevMap instructions to AGENTS.md");
+        return;
+    }
+    if (result === "unchanged") {
+        output.success("AGENTS.md already includes DevMap context");
+        return;
+    }
+    output.warning("Skipped AGENTS.md update; run devmap init interactively to confirm.");
+}
+async function resolveApiKey(options) {
+    if (options.environmentApiKey?.trim()) {
+        return options.environmentApiKey.trim();
+    }
+    if (!options.interactive || !options.prompt) {
+        if (options.existingApiKey?.trim()) {
+            return options.existingApiKey.trim();
+        }
+        throw new DevmapError(`An ${providerDisplayName(options.provider)} API key is required to initialize DevMap.`, `Run devmap init in an interactive terminal or set ${readProviderEnvName(options.provider)}.`);
+    }
+    const providerName = providerDisplayName(options.provider);
+    const keyPrompt = options.existingApiKey
+        ? `${providerName} API key [press Enter to keep existing]: `
+        : `${providerName} API key: `;
+    const answer = (await options.prompt.ask(keyPrompt)).trim();
+    const apiKey = answer || options.existingApiKey?.trim();
+    if (!apiKey) {
+        throw new DevmapError(`An ${providerName} API key is required.`, options.provider === "openrouter"
+            ? "Create one at https://openrouter.ai/keys."
+            : "Create one at https://console.groq.com/keys.");
+    }
+    return apiKey;
+}
+async function resolveProvider(prompt, interactive, existingConfig) {
+    if (!interactive || !prompt) {
+        if (existingConfig)
+            return existingConfig.provider;
+        return process.env.OPENROUTER_API_KEY && !process.env.GROQ_API_KEY
+            ? "openrouter"
+            : "groq";
+    }
+    return prompt.select("AI provider", [
+        { label: "Groq", value: "groq" },
+        { label: "OpenRouter", value: "openrouter" }
+    ], existingConfig?.provider ?? "groq");
+}
+async function resolveInitialModel(options) {
+    if (options.provider === "groq") {
+        const existingModel = options.existingConfig?.provider === "groq"
+            ? options.existingConfig.model
+            : undefined;
+        if (!options.interactive || !options.prompt)
+            return existingModel ?? "auto";
+        const models = await options.listModels(options.apiKey);
+        if (models.length === 0) {
+            throw new DevmapError("Groq did not return any available models.", "Try again shortly or run devmap doctor.");
+        }
+        const defaultModel = existingModel && models.includes(existingModel)
+            ? existingModel
+            : models[0];
+        return options.prompt.select("Groq model", models.map((model) => ({ label: model, value: model })), defaultModel);
+    }
+    const existingModel = options.existingConfig?.provider === "openrouter"
+        ? options.existingConfig.model
+        : undefined;
+    const defaultModel = existingModel && existingModel !== "auto"
+        ? existingModel
+        : OPENROUTER_FREE_MODEL;
+    if (!options.interactive || !options.prompt)
+        return defaultModel;
+    const answer = await options.prompt.ask(`OpenRouter model [${defaultModel}]: `);
+    return answer.trim() || defaultModel;
+}
+function readProviderEnvName(provider) {
+    return provider === "openrouter" ? "OPENROUTER_API_KEY" : "GROQ_API_KEY";
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/map.d.ts

@@ -0,0 +1,24 @@
+export type MapOptions = {
+    json?: boolean;
+    projectRoot?: string;
+    target?: string;
+    depth?: number;
+    all?: boolean;
+};
+export type MapResult = {
+    status: "ok";
+    mode: "file" | "feature" | "project";
+    target: string;
+    markdown: string;
+    mermaid: string;
+    writtenPaths: {
+        markdown: string;
+        mermaid: string;
+    };
+    snapshot: {
+        generatedAt: string;
+        stale: boolean;
+    };
+};
+export declare function mapCommand(target: string | undefined, options?: MapOptions): Promise<void>;
+//# sourceMappingURL=map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/commands/map.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,IAAI,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,QAAQ,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CACnD,CAAC;AAEF,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAiBf"}