@flaid/devmap 0.2.0

package/dist/index.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { analyzeCommand } from "./commands/analyze.js";
+import { configModelCommand } from "./commands/config.js";
+import { doctorCommand } from "./commands/doctor.js";
+import { explainCommand } from "./commands/explain.js";
+import { flowCommand } from "./commands/flow.js";
+import { initCommand } from "./commands/init.js";
+import { mapCommand } from "./commands/map.js";
+import { onboardingCommand } from "./commands/onboarding.js";
+import { printHelp } from "./utils/help.js";
+import { printWelcome } from "./utils/welcome.js";
+import { runSafely } from "./utils/errors.js";
+import { DEVMAP_VERSION } from "./utils/packageMetadata.js";
+const program = new Command();
+program
+    .name("devmap")
+    .description("Understand any codebase in minutes, not days.")
+    .version(DEVMAP_VERSION);
+program
+    .command("init")
+    .description("Initialize DevMap configuration")
+    .option("--json", "output machine-readable JSON")
+    .action((options) => initCommand({ json: options.json }));
+program
+    .command("analyze")
+    .description("Analyze project structure and generate a static project map")
+    .argument("[target]", "folder to analyze", ".")
+    .option("--fresh", "ignore cache and run a fresh analysis")
+    .option("--json", "output machine-readable JSON")
+    .action((target, options) => analyzeCommand(target, options));
+program
+    .command("onboarding")
+    .alias("onboard")
+    .description("Generate a project onboarding guide from the DevMap snapshot")
+    .argument("[target]", "folder with a DevMap snapshot", ".")
+    .option("--write", "write ONBOARDING.md")
+    .option("--language <language>", "language for generated onboarding markdown (en or id)")
+    .option("--json", "output machine-readable JSON")
+    .action((target, options) => onboardingCommand({
+    target,
+    language: options.language,
+    write: options.write,
+    json: options.json
+}));
+program
+    .command("map")
+    .description("Map dependencies: full project, one feature, or one file")
+    .argument("[target]", "feature name or file path — omit for a full project map")
+    .option("--depth <n>", "override traversal depth for file/feature mode", (value) => Number.parseInt(value, 10))
+    .option("--all", "show everything, untruncated — full file-level dump in project mode; uncapped fan-in/fan-out lists in file/feature mode")
+    .option("--json", "output machine-readable JSON")
+    .action((target, options) => mapCommand(target, {
+    json: options.json,
+    depth: options.depth,
+    all: options.all
+}));
+program
+    .command("flow")
+    .description("Trace how a feature or API route works end to end")
+    .argument("[target]", "feature or flow name — omit for curated top flows")
+    .option("--all", "include lower-confidence features and non-API routes, uncapped")
+    .option("--json", "output machine-readable JSON")
+    .action((target, options) => flowCommand(target, { json: options.json, all: options.all }));
+program
+    .command("explain")
+    .description("Ask what a specific file, feature, or function does")
+    .argument("<target>", "file path, feature name, or function name")
+    .option("--write", "also write .devmap/explain/<name>.md")
+    .option("--json", "output machine-readable JSON")
+    .action((target, options) => explainCommand(target, {
+    json: options.json,
+    write: options.write
+}));
+const configCommand = program
+    .command("config")
+    .description("Update DevMap configuration");
+configCommand
+    .command("model")
+    .description("Set a model override or restore automatic routing")
+    .argument("<model>", "Groq model ID or auto")
+    .option("--local", "write a project-local override to .devmap/config.local.json")
+    .option("--json", "output machine-readable JSON")
+    .action((model, options) => configModelCommand(model, {
+    json: options.json,
+    local: options.local
+}));
+program
+    .command("doctor")
+    .description("Diagnose DevMap setup")
+    .option("--json", "output machine-readable JSON")
+    .action((options) => doctorCommand({ json: options.json }));
+await runSafely(async () => {
+    if (process.argv.length === 2) {
+        printWelcome(process.cwd());
+        return;
+    }
+    if (process.argv.length === 3 && ["--help", "-h", "help"].includes(process.argv[2])) {
+        printHelp(program);
+        return;
+    }
+    await program.parseAsync(process.argv);
+});
+//# 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/onboarding/model.d.ts

@@ -0,0 +1,27 @@
+export type OnboardingLanguage = "en" | "id";
+export interface StartHereItem {
+    path: string;
+    reason: string;
+    order: number;
+}
+export interface FeatureSummary {
+    name: string;
+    what: string;
+    entryFile?: string;
+}
+export interface ConceptualStep {
+    step: string;
+}
+export interface OnboardingModel {
+    language: OnboardingLanguage;
+    projectName: string;
+    tagline: string;
+    stackLine: string;
+    whatThisIs: string;
+    howItWorks: ConceptualStep[];
+    features: FeatureSummary[];
+    startHere: StartHereItem[];
+    generatedAt: string;
+    isStale: boolean;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/onboarding/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/onboarding/model.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,CAAC;IAE7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAElB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,EAAE,aAAa,EAAE,CAAC;IAE3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/onboarding/model.js

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

package/dist/onboarding/model.js.map

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

package/dist/onboarding/modelBuilder.d.ts

@@ -0,0 +1,4 @@
+import type { ProjectMap } from "../analyzers/pipeline/index.js";
+import type { OnboardingLanguage, OnboardingModel } from "./model.js";
+export declare function buildOnboardingModel(snapshot: ProjectMap, language: OnboardingLanguage): OnboardingModel;
+//# sourceMappingURL=modelBuilder.d.ts.map

package/dist/onboarding/modelBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelBuilder.d.ts","sourceRoot":"","sources":["../../src/onboarding/modelBuilder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EAIhB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,kBAAkB,GAC3B,eAAe,CAajB"}

package/dist/onboarding/modelBuilder.js

@@ -0,0 +1,330 @@
+import { REASON_TAGS } from "../analyzers/pipeline/reasonTags.js";
+export function buildOnboardingModel(snapshot, language) {
+    return {
+        language,
+        projectName: snapshot.project.name || "project",
+        tagline: buildTagline(snapshot, language),
+        stackLine: buildStackLine(snapshot),
+        whatThisIs: buildWhatThisIs(snapshot, language),
+        howItWorks: buildHowItWorks(snapshot, language),
+        features: buildFeatureSummaries(snapshot, language),
+        startHere: buildStartHere(snapshot, language),
+        generatedAt: snapshot.generatedAt,
+        isStale: false,
+    };
+}
+function buildTagline(snapshot, language) {
+    if (snapshot.domain?.summary && snapshot.domain.summary.trim().length > 0) {
+        const firstSentence = snapshot.domain.summary.split(/\.\s+/)[0];
+        return firstSentence.endsWith(".") ? firstSentence : `${firstSentence}.`;
+    }
+    const ownershipHint = resolveOwnershipHint(snapshot, language);
+    const primaryFeature = snapshot.features[0];
+    if (ownershipHint && primaryFeature) {
+        return language === "id"
+            ? `${ownershipHint} dengan ${primaryFeature.name.toLowerCase()} sebagai fitur utama.`
+            : `${ownershipHint} with ${primaryFeature.name.toLowerCase()} as the core feature.`;
+    }
+    if (primaryFeature && snapshot.project.framework !== "unknown") {
+        return language === "id"
+            ? `Aplikasi ${snapshot.project.framework} untuk ${primaryFeature.name.toLowerCase()}.`
+            : `${snapshot.project.framework} app for ${primaryFeature.name.toLowerCase()}.`;
+    }
+    const fw = snapshot.project.framework !== "unknown" ? snapshot.project.framework : "application";
+    return language === "id"
+        ? `${snapshot.project.name || "Project"} — aplikasi ${fw}.`
+        : `${snapshot.project.name || "Project"} — ${fw} application.`;
+}
+function resolveOwnershipHint(snapshot, language) {
+    const caps = snapshot.capabilities ?? [];
+    const hasSharing = caps.some((c) => c.kind === "sharing" || c.kind === "collaboration");
+    const hasRealtime = caps.some((c) => c.kind === "real-time");
+    const hasSocial = caps.some((c) => c.kind === "social");
+    const domainPattern = snapshot.domain?.ownershipPattern;
+    if (domainPattern === "single_user_isolated" || (!hasSharing && !hasRealtime && !hasSocial)) {
+        return language === "id" ? "Aplikasi personal" : "Personal app";
+    }
+    if (domainPattern === "direct_messaging") {
+        return language === "id" ? "Platform pesan langsung" : "Direct messaging platform";
+    }
+    if (hasSharing || hasRealtime || hasSocial) {
+        return language === "id" ? "Aplikasi kolaborasi" : "Collaborative app";
+    }
+    return null;
+}
+function buildStackLine(snapshot) {
+    const parts = [];
+    if (snapshot.project.language && snapshot.project.language !== "unknown") {
+        parts.push(capitalize(snapshot.project.language));
+    }
+    if (snapshot.project.framework && snapshot.project.framework !== "unknown") {
+        parts.push(capitalize(snapshot.project.framework));
+    }
+    if (snapshot.database?.provider) {
+        parts.push(capitalize(snapshot.database.provider));
+    }
+    for (const service of snapshot.externalServices.slice(0, 2)) {
+        parts.push(capitalize(service));
+    }
+    return parts.slice(0, 5).join(" · ");
+}
+function buildWhatThisIs(snapshot, language) {
+    const sentences = [];
+    const name = snapshot.project.name || (language === "id" ? "Project ini" : "This project");
+    const features = snapshot.features.map((f) => f.name);
+    if (snapshot.ai?.architecture) {
+        sentences.push(snapshot.ai.architecture);
+    }
+    else if (features.length > 0) {
+        const topFeatures = features.slice(0, 3).map((f) => f.toLowerCase()).join(", ");
+        sentences.push(language === "id"
+            ? `${name} menangani ${topFeatures}.`
+            : `${name} handles ${topFeatures}.`);
+    }
+    const domainPattern = snapshot.domain?.ownershipPattern;
+    if (domainPattern === "single_user_isolated") {
+        sentences.push(language === "id"
+            ? "Semua data terisolasi per user — tidak ada fitur sharing atau kolaborasi antar akun."
+            : "All data is user-isolated — there is no sharing or cross-account collaboration.");
+    }
+    else if (domainPattern === "shared_access") {
+        sentences.push(language === "id"
+            ? "Project ini mendukung akses bersama — beberapa user bisa berkolaborasi pada data yang sama."
+            : "This project supports shared access — multiple users can collaborate on the same data.");
+    }
+    const entityNames = snapshot.entityGraph?.entityNames ?? [];
+    const hasMisleadingChat = entityNames.includes("Message") && domainPattern === "single_user_isolated";
+    if (hasMisleadingChat) {
+        const roomEntity = entityNames.find((e) => e === "Room" || e === "Channel" || e === "Thread");
+        if (roomEntity) {
+            sentences.push(language === "id"
+                ? `"${roomEntity}" adalah wadah (seperti folder), dan "Message" adalah isinya — bukan komunikasi antar user.`
+                : `"${roomEntity}" acts as a container (like a folder), and "Message" is its content — not inter-user communication.`);
+        }
+    }
+    if (snapshot.externalServices.length > 0) {
+        const services = snapshot.externalServices.slice(0, 2).join(", ");
+        sentences.push(language === "id"
+            ? `Terhubung ke ${services}.`
+            : `Integrates with ${services}.`);
+    }
+    return sentences.slice(0, 4).join(" ");
+}
+function buildHowItWorks(snapshot, language) {
+    const hasAuth = snapshot.features.some((f) => f.name === "Authentication");
+    const hasRoutes = snapshot.routes.length > 0 || snapshot.apiRoutes.length > 0;
+    const hasDatabase = Boolean(snapshot.database);
+    const isCli = snapshot.project.projectTypes.includes("node-cli")
+        || Object.values(snapshot.fileIndex).some((e) => e.scope === "cli");
+    const domainPattern = snapshot.domain?.ownershipPattern;
+    if (isCli) {
+        return buildCliFlow(snapshot, language);
+    }
+    if (hasAuth && hasRoutes) {
+        return buildAuthWebAppFlow(snapshot, language, domainPattern, hasDatabase);
+    }
+    if (hasRoutes) {
+        return buildPublicWebAppFlow(snapshot, language, hasDatabase);
+    }
+    return buildGenericFlow(snapshot, language);
+}
+function buildCliFlow(snapshot, language) {
+    const commands = snapshot.features
+        .filter((f) => f.name === "CLI Commands" || f.name.toLowerCase().includes("command"))
+        .map((f) => f.name);
+    if (language === "id") {
+        return [
+            { step: "User menjalankan command dari terminal." },
+            { step: "CLI membaca konfigurasi dan menentukan proses yang dibutuhkan." },
+            { step: commands.length > 0 ? `Command yang tersedia: ${commands.slice(0, 3).join(", ")}.` : "Command memproses input dan menghasilkan output." },
+            { step: "Hasil disimpan atau ditampilkan sesuai flag yang diberikan." },
+        ];
+    }
+    return [
+        { step: "User runs a command from the terminal." },
+        { step: "The CLI reads configuration and determines the required process." },
+        { step: commands.length > 0 ? `Available commands include: ${commands.slice(0, 3).join(", ")}.` : "Commands process input and produce output." },
+        { step: "Results are saved or displayed based on the given flags." },
+    ];
+}
+function buildAuthWebAppFlow(snapshot, language, ownershipPattern, hasDatabase) {
+    const entities = snapshot.entityGraph?.entityNames
+        .filter((e) => !["User", "Session", "Account", "VerificationToken"].includes(e))
+        .slice(0, 2) ?? [];
+    if (language === "id") {
+        const steps = [
+            { step: "User login — semua aksi butuh sesi aktif." },
+        ];
+        if (entities.length > 0) {
+            steps.push({ step: `User membuat atau mengelola ${entities[0].toLowerCase()}${entities[1] ? ` yang berisi ${entities[1].toLowerCase()}` : ""}.` });
+        }
+        if (ownershipPattern === "single_user_isolated") {
+            steps.push({ step: "Semua data milik user yang login — tidak ada akses lintas akun." });
+        }
+        else if (ownershipPattern === "shared_access") {
+            steps.push({ step: "Data bisa diakses bersama antar user yang punya izin." });
+        }
+        if (hasDatabase) {
+            steps.push({ step: "Perubahan data disimpan langsung ke database — tidak ada state sementara." });
+        }
+        steps.push({ step: "Response dikembalikan ke client — UI diperbarui sesuai hasil operasi." });
+        return steps.slice(0, 5);
+    }
+    const steps = [
+        { step: "User logs in — all actions require an active session." },
+    ];
+    if (entities.length > 0) {
+        steps.push({ step: `User creates or manages ${entities[0].toLowerCase()}${entities[1] ? ` that contain ${entities[1].toLowerCase()}` : ""}.` });
+    }
+    if (ownershipPattern === "single_user_isolated") {
+        steps.push({ step: "All data belongs to the logged-in user — no cross-account access." });
+    }
+    else if (ownershipPattern === "shared_access") {
+        steps.push({ step: "Data can be shared across users with appropriate permissions." });
+    }
+    if (hasDatabase) {
+        steps.push({ step: "Data changes are persisted directly to the database." });
+    }
+    steps.push({ step: "A response is returned to the client — UI updates to reflect the result." });
+    return steps.slice(0, 5);
+}
+function buildPublicWebAppFlow(snapshot, language, hasDatabase) {
+    if (language === "id") {
+        return [
+            { step: "User membuka halaman atau mengirim request ke API." },
+            { step: "Server memproses request dan menjalankan logic yang sesuai." },
+            ...(hasDatabase ? [{ step: "Data dibaca dari atau ditulis ke database." }] : []),
+            { step: "Response dikembalikan — halaman dirender atau data dikirim ke client." },
+        ].slice(0, 5);
+    }
+    return [
+        { step: "User opens a page or sends a request to the API." },
+        { step: "The server processes the request and runs the relevant logic." },
+        ...(hasDatabase ? [{ step: "Data is read from or written to the database." }] : []),
+        { step: "A response is returned — the page renders or data is sent to the client." },
+    ].slice(0, 5);
+}
+function buildGenericFlow(snapshot, language) {
+    if (language === "id") {
+        return [
+            { step: "Program dimulai dari entry point utama." },
+            { step: "Module dan dependency dimuat sesuai kebutuhan." },
+            { step: "Logic utama dijalankan berdasarkan input atau konfigurasi." },
+            { step: "Output dihasilkan sesuai tujuan program." },
+        ];
+    }
+    return [
+        { step: "The program starts from the main entry point." },
+        { step: "Modules and dependencies are loaded as needed." },
+        { step: "Core logic runs based on input or configuration." },
+        { step: "Output is produced according to the program's purpose." },
+    ];
+}
+function buildFeatureSummaries(snapshot, language) {
+    return snapshot.features.map((feature) => ({
+        name: feature.name,
+        what: buildFeatureWhat(feature, language),
+        entryFile: feature.entryPoint ?? feature.entryPoints?.[0],
+    }));
+}
+function buildFeatureWhat(feature, language) {
+    if (feature.purpose && !isBoilerplatePurpose(feature.purpose)) {
+        return feature.purpose.split(/\.\s+/)[0] + ".";
+    }
+    const name = feature.name.toLowerCase();
+    if (language === "id") {
+        return `Menangani ${name} dalam project.`;
+    }
+    return `Handles ${name} for the project.`;
+}
+function isBoilerplatePurpose(purpose) {
+    return /\b(exposes|contains project code|identifies .* capability|detected as)\b/i.test(purpose);
+}
+function buildStartHere(snapshot, language) {
+    const items = new Map();
+    let order = 1;
+    const add = (path, reason) => {
+        if (!path || items.has(path))
+            return;
+        if (!isReadableSourceFile(path))
+            return;
+        items.set(path, { path, reason, order: order++ });
+    };
+    const authFeature = snapshot.features.find((f) => f.name === "Authentication");
+    if (authFeature?.entryPoint) {
+        add(authFeature.entryPoint, language === "id"
+            ? "Pahami siapa yang boleh akses apa sebelum membaca yang lain"
+            : "Understand who can access what before reading anything else");
+    }
+    const schemaFile = Object.keys(snapshot.fileIndex).find((p) => /schema\.prisma$/.test(p));
+    if (schemaFile) {
+        add(schemaFile, language === "id"
+            ? "Pahami struktur data dan relasi antar entity"
+            : "Understand the data model and entity relationships");
+    }
+    for (const ep of snapshot.entryPoints.slice(0, 2)) {
+        add(ep, language === "id"
+            ? "Titik awal eksekusi — lihat command atau route yang tersedia"
+            : "Execution entry point — see available commands or routes");
+    }
+    const sortedFeatures = [...snapshot.features]
+        .filter((f) => f.name !== "Authentication")
+        .filter((f) => f.confidence === "high" || f.confidence === "medium")
+        .slice(0, 5);
+    for (const feature of sortedFeatures) {
+        const ep = feature.entryPoint ?? feature.entryPoints?.[0];
+        if (ep) {
+            add(ep, language === "id"
+                ? `Entry point untuk ${feature.name.toLowerCase()}`
+                : `Entry point for ${feature.name.toLowerCase()}`);
+        }
+    }
+    for (const critical of snapshot.criticalFiles.slice(0, 4)) {
+        if (!items.has(critical.path)) {
+            const reason = buildCriticalFileReason(critical, snapshot, language);
+            add(critical.path, reason);
+        }
+    }
+    for (const path of snapshot.onboarding.recommendedPath) {
+        if (!items.has(path)) {
+            add(path, language === "id"
+                ? "File penting untuk memahami konteks project"
+                : "Important file for understanding project context");
+        }
+    }
+    return Array.from(items.values());
+}
+function buildCriticalFileReason(critical, snapshot, language) {
+    const reasons = critical.reasons;
+    if (reasons.includes(REASON_TAGS.CORE_EXECUTION_RESPONSIBILITY)) {
+        return language === "id"
+            ? "File ini dijalankan pertama kali saat project start"
+            : "This file runs first when the project starts";
+    }
+    if (reasons.includes(REASON_TAGS.CORE_PROJECT_CONCERN)) {
+        return language === "id"
+            ? "Concern inti project — banyak bagian lain bergantung ke sini"
+            : "Core project concern — many other parts depend on this";
+    }
+    if (critical.referencedBy > 5) {
+        return language === "id"
+            ? `Diimport oleh ${critical.referencedBy} file lain — sangat central`
+            : `Imported by ${critical.referencedBy} other files — highly central`;
+    }
+    return language === "id"
+        ? "File penting berdasarkan struktur dependency project"
+        : "Important file based on the project dependency structure";
+}
+function isReadableSourceFile(path) {
+    const lower = path.toLowerCase();
+    return !(/\/(prisma\/)?migrations?\//.test(lower)
+        || /\.sql$/.test(lower)
+        || /\/generated\//.test(lower)
+        || /\.generated\./.test(lower)
+        || /\.(lock|log|map|d\.ts)$/.test(lower)
+        || /\.(png|jpg|jpeg|gif|svg|ico|webp)$/.test(lower));
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=modelBuilder.js.map

package/dist/onboarding/modelBuilder.js.map

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

package/dist/utils/agentsFile.d.ts

@@ -0,0 +1,6 @@
+export declare const DEVMAP_AGENTS_BLOCK = "<!-- DevMap Instruction Block -->\n## DevMap Context\n\nBefore working in this repository, read `DEVMAP.md` for project metadata and available commands.\n\n### Navigation\n\n1. Read `.devmap/index.json`.\n2. Pick the relevant feature by name or keywords.\n3. Open the matching `.devmap/features/*.json` map.\n4. Inspect only files listed in `sourcePriority` first.\n5. Fall back to `.devmap/snapshot.json` only when index and feature maps are insufficient.\n\nDo not scan the whole repository. Open source files only when:\n- the snapshot is missing or stale\n- the snapshot lacks enough detail for the task\n- the task requires edit, debug, or refactor\n- the user explicitly asks for code changes\n\nWhen source inspection is needed, inspect the smallest relevant set first.\n\n### Maintenance\n\n- If `.devmap/index.json` is missing, run `devmap analyze`.\n- If the snapshot may be stale, run `devmap analyze --fresh`.\n- Use `--json` when calling DevMap programmatically.\n- Do not edit files inside `.devmap/`.\n- Never commit API keys or provider credentials.\n<!-- End DevMap Instruction Block -->";
+export type AgentsFileStatus = "missing" | "existing" | "integrated";
+export type AgentsFileResult = "created" | "appended" | "unchanged" | "skipped";
+export declare function inspectAgentsFile(projectRoot: string): Promise<AgentsFileStatus>;
+export declare function ensureAgentsFile(projectRoot: string, appendToExisting: boolean): Promise<AgentsFileResult>;
+//# sourceMappingURL=agentsFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentsFile.d.ts","sourceRoot":"","sources":["../../src/utils/agentsFile.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,mBAAmB,qlCA4BM,CAAC;AAEvC,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAEhF,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0BtF;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAiC3B"}

package/dist/utils/agentsFile.js

@@ -0,0 +1,85 @@
+import { appendFile, lstat, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { DevmapError } from "./errors.js";
+const DEVMAP_AGENTS_MARKER = "<!-- DevMap Instruction Block -->";
+const LEGACY_DEVMAP_AGENTS_MARKER = "<!-- DEVMap Instruction Block -->";
+export const DEVMAP_AGENTS_BLOCK = `${DEVMAP_AGENTS_MARKER}
+## DevMap Context
+
+Before working in this repository, read \`DEVMAP.md\` for project metadata and available commands.
+
+### Navigation
+
+1. Read \`.devmap/index.json\`.
+2. Pick the relevant feature by name or keywords.
+3. Open the matching \`.devmap/features/*.json\` map.
+4. Inspect only files listed in \`sourcePriority\` first.
+5. Fall back to \`.devmap/snapshot.json\` only when index and feature maps are insufficient.
+
+Do not scan the whole repository. Open source files only when:
+- the snapshot is missing or stale
+- the snapshot lacks enough detail for the task
+- the task requires edit, debug, or refactor
+- the user explicitly asks for code changes
+
+When source inspection is needed, inspect the smallest relevant set first.
+
+### Maintenance
+
+- If \`.devmap/index.json\` is missing, run \`devmap analyze\`.
+- If the snapshot may be stale, run \`devmap analyze --fresh\`.
+- Use \`--json\` when calling DevMap programmatically.
+- Do not edit files inside \`.devmap/\`.
+- Never commit API keys or provider credentials.
+<!-- End DevMap Instruction Block -->`;
+;
+export async function inspectAgentsFile(projectRoot) {
+    const path = join(projectRoot, "AGENTS.md");
+    try {
+        const metadata = await lstat(path);
+        if (metadata.isSymbolicLink()) {
+            throw new DevmapError("Refusing to update a symlinked AGENTS.md.", "Replace the symlink with a regular file before running devmap init.");
+        }
+        const content = await readFile(path, "utf8");
+        return (content.includes(DEVMAP_AGENTS_MARKER)
+            || content.includes(LEGACY_DEVMAP_AGENTS_MARKER))
+            ? "integrated"
+            : "existing";
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return "missing";
+        }
+        throw error;
+    }
+}
+export async function ensureAgentsFile(projectRoot, appendToExisting) {
+    const path = join(projectRoot, "AGENTS.md");
+    const status = await inspectAgentsFile(projectRoot);
+    if (status === "integrated") {
+        return "unchanged";
+    }
+    if (status === "existing") {
+        if (!appendToExisting) {
+            return "skipped";
+        }
+        const content = await readFile(path, "utf8");
+        const separator = content.endsWith("\n") ? "\n" : "\n\n";
+        await appendFile(path, `${separator}${DEVMAP_AGENTS_BLOCK}\n`, "utf8");
+        return "appended";
+    }
+    try {
+        await writeFile(path, `# AI Agent Instructions\n\n${DEVMAP_AGENTS_BLOCK}\n`, { encoding: "utf8", flag: "wx" });
+        return "created";
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "EEXIST") {
+            return ensureAgentsFile(projectRoot, appendToExisting);
+        }
+        throw error;
+    }
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=agentsFile.js.map

package/dist/utils/agentsFile.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,20 @@
+export type DevmapConfig = {
+    provider: "groq" | "openrouter";
+    apiKey?: string;
+    model: "auto" | string;
+};
+export type LocalDevmapConfig = {
+    model?: string;
+};
+export declare function getConfigPath(): string;
+export declare function readConfig(): Promise<DevmapConfig | null>;
+export declare function writeConfig(config: DevmapConfig): Promise<void>;
+export declare function getLocalConfigPath(projectRoot: string): string;
+export declare function readLocalConfig(projectRoot: string): Promise<LocalDevmapConfig | null>;
+export declare function writeLocalConfig(projectRoot: string, config: LocalDevmapConfig): Promise<void>;
+export type ConfigReaders = {
+    readGlobal?: () => Promise<DevmapConfig | null>;
+    readLocal?: (projectRoot: string) => Promise<LocalDevmapConfig | null>;
+};
+export declare function resolveEffectiveConfig(projectRoot: string, readers?: ConfigReaders): Promise<DevmapConfig | null>;
+//# sourceMappingURL=config.d.ts.map