@flaid/devmap 0.2.0

package/dist/cache/agentNavigation.js

@@ -0,0 +1,253 @@
+import { mkdir, readdir, unlink, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+export async function writeAgentNavigationFiles(projectRoot, snapshot) {
+    const devmapDirectory = join(projectRoot, ".devmap");
+    const featureDirectory = join(devmapDirectory, "features");
+    await mkdir(featureDirectory, { recursive: true });
+    await removeStaleFeatureMaps(featureDirectory);
+    // Dedup by id — safety net for features that generate the same id,
+    // e.g. "Checklist Item Management" and "checklist-item Management"
+    // both resolve to "checklist-item-management". First-seen wins.
+    const seenIds = new Set();
+    const dedupedFeatures = snapshot.features.filter((feature) => {
+        const id = featureId(feature.name);
+        if (seenIds.has(id))
+            return false;
+        seenIds.add(id);
+        return true;
+    });
+    const featureIndexes = dedupedFeatures.map((feature) => createFeatureIndex(feature, snapshot));
+    const featurePaths = [];
+    for (const feature of dedupedFeatures) {
+        const id = featureId(feature.name);
+        const path = join(featureDirectory, `${id}.json`);
+        await writeJson(path, createFeatureMap(id, feature, snapshot));
+        featurePaths.push(path);
+    }
+    const indexPath = join(devmapDirectory, "index.json");
+    await writeJson(indexPath, {
+        project: {
+            name: snapshot.project.name,
+            framework: snapshot.project.framework,
+            frameworks: snapshot.project.frameworks,
+            language: snapshot.project.language,
+            packageManager: snapshot.project.packageManager,
+            projectTypes: snapshot.project.projectTypes,
+            workspaceType: snapshot.project.workspaceType,
+            summary: createProjectSummary(snapshot)
+        },
+        generatedAt: snapshot.generatedAt,
+        entryPoints: snapshot.entryPoints.slice(0, 8),
+        criticalFiles: selectIndexCriticalFiles(snapshot),
+        features: featureIndexes,
+        snapshot: {
+            path: ".devmap/snapshot.json",
+            usage: "last_resort_or_web_ai_copy_context"
+        },
+        agentInstructions: "Read this file first. Pick the relevant feature by keywords, open its feature map, then inspect only source files listed in sourcePriority. Do not read snapshot.json unless index.json and feature maps are insufficient."
+    });
+    return { indexPath, featurePaths };
+}
+function createFeatureIndex(feature, snapshot) {
+    const id = featureId(feature.name);
+    return {
+        id,
+        name: feature.name,
+        summary: feature.purpose,
+        keywords: feature.searchTerms.slice(0, 8),
+        criticalFiles: selectCriticalFiles(feature, snapshot),
+        map: `.devmap/features/${id}.json`
+    };
+}
+function createFeatureMap(id, feature, snapshot) {
+    const entryPoints = [...new Set([
+            ...(feature.entryPoint ? [feature.entryPoint] : []),
+            ...feature.entryPoints
+        ])];
+    const relatedFiles = feature.files
+        .filter((path) => snapshot.fileIndex[path])
+        .map((path) => ({
+        path,
+        role: snapshot.fileIndex[path]?.purpose ?? `Supports ${feature.name}.`
+    }));
+    const featureOrder = new Map(feature.files.map((path, index) => [path, index]));
+    const sourcePriority = [...relatedFiles]
+        .sort((left, right) => {
+        const leftEntry = Number(entryPoints.includes(left.path));
+        const rightEntry = Number(entryPoints.includes(right.path));
+        return rightEntry - leftEntry
+            || (featureOrder.get(left.path) ?? Number.MAX_SAFE_INTEGER)
+                - (featureOrder.get(right.path) ?? Number.MAX_SAFE_INTEGER)
+            || (snapshot.fileIndex[right.path]?.importance ?? 0)
+                - (snapshot.fileIndex[left.path]?.importance ?? 0)
+            || left.path.localeCompare(right.path);
+    })
+        .map((file) => file.path)
+        .slice(0, 8);
+    const flow = feature.businessFlow.filter((step) => !/^Identify files related to /i.test(step));
+    return {
+        id,
+        name: feature.name,
+        summary: feature.purpose,
+        entryPoints,
+        criticalFiles: selectCriticalFiles(feature, snapshot),
+        relatedFiles,
+        ...(flow.length > 1 ? { flow } : {}),
+        keywords: feature.searchTerms.slice(0, 12),
+        sourcePriority,
+        confidence: feature.confidence
+    };
+}
+function selectIndexCriticalFiles(snapshot) {
+    const candidates = new Set();
+    for (const path of snapshot.entryPoints) {
+        candidates.add(path);
+    }
+    for (const feature of snapshot.features) {
+        if (feature.name === "Documentation")
+            continue;
+        if (feature.entryPoint)
+            candidates.add(feature.entryPoint);
+        feature.entryPoints.forEach((path) => candidates.add(path));
+        feature.files.forEach((path) => candidates.add(path));
+    }
+    for (const flow of snapshot.flows) {
+        if (flow.entryPoint)
+            candidates.add(flow.entryPoint);
+        flow.steps.forEach((step) => {
+            if (step.file)
+                candidates.add(step.file);
+        });
+    }
+    for (const critical of snapshot.criticalFiles) {
+        candidates.add(critical.path);
+    }
+    const entryDistance = computeEntryDistance(snapshot);
+    return [...candidates]
+        .filter((path) => {
+        const metadata = snapshot.fileIndex[path];
+        return metadata && metadata.scope !== "docs" && metadata.scope !== "test";
+    })
+        .sort((left, right) => calculateStartHereScore(right, snapshot, entryDistance) - calculateStartHereScore(left, snapshot, entryDistance)
+        || left.localeCompare(right))
+        .slice(0, 8);
+}
+// BFS distance from the nearest entry point over the resolved dependency graph.
+// Without this, calculateStartHereScore had no way to prefer "the file the
+// entry point calls directly" over "some file three imports deeper" — both
+// only differed by generic importance, which doesn't track call-graph order.
+function computeEntryDistance(snapshot) {
+    const distance = new Map();
+    const queue = [];
+    for (const entry of snapshot.entryPoints) {
+        if (!distance.has(entry)) {
+            distance.set(entry, 0);
+            queue.push(entry);
+        }
+    }
+    while (queue.length > 0) {
+        const current = queue.shift();
+        const currentDistance = distance.get(current) ?? 0;
+        for (const dependency of snapshot.fileGraph[current] ?? []) {
+            if (!distance.has(dependency)) {
+                distance.set(dependency, currentDistance + 1);
+                queue.push(dependency);
+            }
+        }
+    }
+    return distance;
+}
+function calculateStartHereScore(path, snapshot, entryDistance) {
+    const metadata = snapshot.fileIndex[path];
+    const entryIndex = snapshot.entryPoints.indexOf(path);
+    const flowOwnership = snapshot.flows.filter((flow) => flow.entryPoint === path || flow.steps.some((step) => step.file === path)).length;
+    const featureOwnership = snapshot.features.filter((feature) => feature.entryPoint === path || feature.entryPoints.includes(path)).length;
+    const commandBonus = metadata?.scope === "cli" ? 500 : 0;
+    const commandPathBonus = /(^|\/)commands?\//.test(path) ? 300 : 0;
+    const distance = entryDistance.get(path);
+    const entryProximityBonus = distance === undefined ? 0 : Math.max(0, 200 - distance * 60);
+    return (entryIndex >= 0 ? 1_000_000 - entryIndex * 10_000 : 0)
+        + commandBonus
+        + commandPathBonus
+        + entryProximityBonus
+        + flowOwnership * 120
+        + featureOwnership * 100
+        + (metadata?.featureRefs.length ?? 0) * 40
+        + (metadata?.importance ?? 0);
+}
+function selectCriticalFiles(feature, snapshot) {
+    const featureFiles = new Set(feature.files);
+    const critical = snapshot.criticalFiles
+        .filter((file) => featureFiles.has(file.path))
+        .map((file) => file.path);
+    if (critical.length > 0) {
+        return critical.slice(0, 5);
+    }
+    return [...feature.files]
+        .filter((path) => snapshot.fileIndex[path])
+        .sort((left, right) => (snapshot.fileIndex[right]?.importance ?? 0)
+        - (snapshot.fileIndex[left]?.importance ?? 0)
+        || left.localeCompare(right))
+        .slice(0, 5);
+}
+function createProjectSummary(snapshot) {
+    const language = formatLabel(snapshot.project.language);
+    const projectKind = describeProjectKind(snapshot);
+    const featureNames = snapshot.features
+        .filter((feature) => feature.confidence !== "low")
+        .map((feature) => feature.name)
+        .slice(0, 4);
+    const featureText = featureNames.length > 0
+        ? ` Main capabilities: ${featureNames.join(", ")}.`
+        : "";
+    const description = snapshot.project.description?.trim();
+    const descriptionText = description
+        ? ` ${description.replace(/[.!?]+$/, "")}.`
+        : "";
+    return `${snapshot.project.name} is a ${language} ${projectKind}.${descriptionText}${featureText}`;
+}
+function describeProjectKind(snapshot) {
+    const workspace = snapshot.project.workspaceType === "monorepo" ? "monorepo" : "project";
+    const types = snapshot.project.projectTypes;
+    const kinds = [];
+    if (types.includes("node-cli"))
+        kinds.push("Node.js CLI");
+    if (types.includes("web-app"))
+        kinds.push("web application");
+    if (types.includes("api-service"))
+        kinds.push("API service");
+    if (types.includes("library"))
+        kinds.push("reusable library");
+    if (kinds.length === 0)
+        return workspace;
+    if (kinds.length === 1) {
+        const kind = kinds[0];
+        if (kind === "Node.js CLI")
+            return `${workspace} centered on a ${kind}`;
+        return `${workspace} containing a ${kind}`;
+    }
+    return `${workspace} containing ${kinds.slice(0, -1).join(", ")} and ${kinds[kinds.length - 1]}`;
+}
+function formatLabel(value) {
+    if (value === "typescript")
+        return "TypeScript";
+    if (value === "javascript")
+        return "JavaScript";
+    return value.charAt(0).toUpperCase() + value.slice(1);
+}
+function featureId(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "") || "feature";
+}
+async function removeStaleFeatureMaps(directory) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    await Promise.all(entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
+        .map((entry) => unlink(join(directory, entry.name))));
+}
+async function writeJson(path, value) {
+    await writeFile(path, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+//# sourceMappingURL=agentNavigation.js.map

package/dist/cache/agentNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentNavigation.js","sourceRoot":"","sources":["../../src/cache/agentNavigation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAkBjC,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,QAAoB;IAEpB,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,KAAK,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAE/C,mEAAmE;IACnE,mEAAmE;IACnE,gEAAgE;IAChE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,eAAe,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3D,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACrD,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CACtC,CAAC;IACF,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,SAAS,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/D,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IACtD,MAAM,SAAS,CAAC,SAAS,EAAE;QACzB,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI;YAC3B,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS;YACrC,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU;YACvC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ;YACnC,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc;YAC/C,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,YAAY;YAC3C,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,aAAa;YAC7C,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC;SACxC;QACD,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7C,aAAa,EAAE,wBAAwB,CAAC,QAAQ,CAAC;QACjD,QAAQ,EAAE,cAAc;QACxB,QAAQ,EAAE;YACR,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE,oCAAoC;SAC5C;QACD,iBAAiB,EAAE,4NAA4N;KAChP,CAAC,CAAC;IAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAoB,EAAE,QAAoB;IACpE,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACzC,aAAa,EAAE,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC;QACrD,GAAG,EAAE,oBAAoB,EAAE,OAAO;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAU,EAAE,OAAoB,EAAE,QAAoB;IAC9E,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;YAC9B,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,OAAO,CAAC,WAAW;SACvB,CAAC,CAAC,CAAC;IACJ,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK;SAC/B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;SAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,IAAI;QACJ,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,IAAI,YAAY,OAAO,CAAC,IAAI,GAAG;KACvE,CAAC,CAAC,CAAC;IACN,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChF,MAAM,cAAc,GAAG,CAAC,GAAG,YAAY,CAAC;SACrC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,OAAO,UAAU,GAAG,SAAS;eACxB,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,gBAAgB,CAAC;kBACvD,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,gBAAgB,CAAC;eAC1D,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;kBAChD,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;eACjD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAChD,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,CAC3C,CAAC;IAEF,OAAO;QACL,EAAE;QACF,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW;QACX,aAAa,EAAE,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC;QACrD,YAAY;QACZ,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1C,cAAc;QACd,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAoB;IACpD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe;YAAE,SAAS;QAC/C,IAAI,OAAO,CAAC,UAAU;YAAE,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3D,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,UAAU;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1B,IAAI,IAAI,CAAC,IAAI;gBAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC9C,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,aAAa,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAErD,OAAO,CAAC,GAAG,UAAU,CAAC;SACnB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,QAAQ,IAAI,QAAQ,CAAC,KAAK,KAAK,MAAM,IAAI,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC;IAC5E,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACpB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,GAAG,uBAAuB,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC;WAC7G,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAC7B;SACA,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,2EAA2E;AAC3E,2EAA2E;AAC3E,6EAA6E;AAC7E,SAAS,oBAAoB,CAAC,QAAoB;IAChD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAY,CAAC;QACxC,MAAM,eAAe,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,eAAe,GAAG,CAAC,CAAC,CAAC;gBAC9C,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,uBAAuB,CAC9B,IAAY,EACZ,QAAoB,EACpB,aAAkC;IAElC,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACnD,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAC1E,CAAC,MAAM,CAAC;IACT,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5D,OAAO,CAAC,UAAU,KAAK,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAClE,CAAC,MAAM,CAAC;IACT,MAAM,YAAY,GAAG,QAAQ,EAAE,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,mBAAmB,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,QAAQ,GAAG,EAAE,CAAC,CAAC;IAE1F,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;UAC1D,YAAY;UACZ,gBAAgB;UAChB,mBAAmB;UACnB,aAAa,GAAG,GAAG;UACnB,gBAAgB,GAAG,GAAG;UACtB,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE;UACxC,CAAC,QAAQ,EAAE,UAAU,IAAI,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAoB,EAAE,QAAoB;IACrE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa;SACpC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC7C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5B,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;SACtB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;SAC1C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACpB,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;UAC1C,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;WAC1C,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAC7B;SACA,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjB,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAoB;IAChD,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ;SACnC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,KAAK,KAAK,CAAC;SACjD,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;SAC9B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC;QACzC,CAAC,CAAC,uBAAuB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACnD,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACzD,MAAM,eAAe,GAAG,WAAW;QACjC,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG;QAC3C,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,SAAS,QAAQ,IAAI,WAAW,IAAI,eAAe,GAAG,WAAW,EAAE,CAAC;AACrG,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAoB;IAC/C,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAE9D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,aAAa;YAAE,OAAO,GAAG,SAAS,kBAAkB,IAAI,EAAE,CAAC;QACxE,OAAO,GAAG,SAAS,iBAAiB,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,GAAG,SAAS,eAAe,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;AACnG,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IAChD,IAAI,KAAK,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IAChD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,SAAiB;IACrD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO;SACtB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SACjE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,KAAc;IACnD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC"}

package/dist/cache/fileHash.d.ts

@@ -0,0 +1,2 @@
+export declare function hashContent(content: string): string;
+//# sourceMappingURL=fileHash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileHash.d.ts","sourceRoot":"","sources":["../../src/cache/fileHash.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/cache/fileHash.js

@@ -0,0 +1,5 @@
+import { createHash } from "node:crypto";
+export function hashContent(content) {
+    return createHash("md5").update(content).digest("hex");
+}
+//# sourceMappingURL=fileHash.js.map

package/dist/cache/fileHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileHash.js","sourceRoot":"","sources":["../../src/cache/fileHash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/cache/snapshot.d.ts

@@ -0,0 +1,20 @@
+import { type ProjectMap } from "../analyzers/pipeline/index.js";
+export type SnapshotStatus = {
+    status: "missing";
+} | {
+    status: "valid";
+    snapshot: ProjectMap;
+} | {
+    status: "corrupt";
+    error: string;
+} | {
+    status: "unsupported";
+    version: string;
+};
+export declare function getSnapshotPath(projectRoot: string): string;
+export declare function saveSnapshot(projectRoot: string, snapshot: ProjectMap): Promise<void>;
+export declare function isSnapshotStale(projectRoot: string, snapshot: ProjectMap): Promise<boolean>;
+export declare function readSnapshot(projectRoot: string): Promise<ProjectMap | null>;
+export declare function readSnapshotOrThrow(projectRoot: string): Promise<ProjectMap>;
+export declare function inspectSnapshot(projectRoot: string): Promise<SnapshotStatus>;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/cache/snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,gCAAgC,CAAC;AAQxC,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3F;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,UAAU,GACnB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAGlF;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAyBlF;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAgDlF"}

package/dist/cache/snapshot.js

@@ -0,0 +1,184 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createProjectFingerprint, SNAPSHOT_SCHEMA_VERSION } from "../analyzers/pipeline/index.js";
+import { scanFiles } from "../analyzers/analysis/index.js";
+import { BACKEND_FRAMEWORK_SET, FRONTEND_FRAMEWORK_SET, } from "../analyzers/detectors/frameworkDetector.js";
+import { DevmapError } from "../utils/errors.js";
+export function getSnapshotPath(projectRoot) {
+    return join(projectRoot, ".devmap", "snapshot.json");
+}
+export async function saveSnapshot(projectRoot, snapshot) {
+    const path = getSnapshotPath(projectRoot);
+    await mkdir(join(projectRoot, ".devmap"), { recursive: true });
+    await writeFile(path, `${JSON.stringify(snapshot, null, 2)}\n`, "utf8");
+}
+export async function isSnapshotStale(projectRoot, snapshot) {
+    const files = await scanFiles(projectRoot);
+    return createProjectFingerprint(files) !== snapshot.fingerprint;
+}
+export async function readSnapshot(projectRoot) {
+    const result = await inspectSnapshot(projectRoot);
+    return result.status === "valid" ? result.snapshot : null;
+}
+export async function readSnapshotOrThrow(projectRoot) {
+    const result = await inspectSnapshot(projectRoot);
+    if (result.status === "valid") {
+        return result.snapshot;
+    }
+    if (result.status === "unsupported") {
+        throw new DevmapError(`Snapshot schema ${result.version} is not supported by this DevMap version.`, "Run devmap analyze --fresh to regenerate the snapshot.");
+    }
+    if (result.status === "corrupt") {
+        throw new DevmapError("The DevMap snapshot is corrupt or incomplete.", "Run devmap analyze --fresh to regenerate .devmap/snapshot.json.");
+    }
+    throw new DevmapError("No DevMap snapshot was found.", "Run devmap analyze first.");
+}
+export async function inspectSnapshot(projectRoot) {
+    try {
+        const raw = await readFile(getSnapshotPath(projectRoot), "utf8");
+        const parsed = JSON.parse(raw);
+        if (!isRecord(parsed)) {
+            return { status: "corrupt", error: "Snapshot root must be an object." };
+        }
+        if (typeof parsed.version !== "string") {
+            return { status: "corrupt", error: "Snapshot version is missing." };
+        }
+        if (parsed.version !== SNAPSHOT_SCHEMA_VERSION) {
+            return { status: "unsupported", version: parsed.version };
+        }
+        if (typeof parsed.generatedAt !== "string"
+            || typeof parsed.fingerprint !== "string"
+            || !isRecord(parsed.project)
+            || !isRecord(parsed.fileIndex)
+            || !Array.isArray(parsed.entryPoints)
+            || !Array.isArray(parsed.criticalFiles)
+            || !Array.isArray(parsed.routes)
+            || !Array.isArray(parsed.apiRoutes)
+            || !Array.isArray(parsed.features)) {
+            return { status: "corrupt", error: "Snapshot is missing required fields." };
+        }
+        if (!Object.values(parsed.fileIndex).every(isFileIndexEntry)) {
+            return { status: "corrupt", error: "fileIndex contains invalid entries." };
+        }
+        normalizeSnapshotDefaults(parsed);
+        return { status: "valid", snapshot: parsed };
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return { status: "missing" };
+        }
+        return {
+            status: "corrupt",
+            error: error instanceof Error ? error.message : "Unknown snapshot error."
+        };
+    }
+}
+function normalizeSnapshotDefaults(snapshot) {
+    if (!isRecord(snapshot.agentInstructions)) {
+        snapshot.agentInstructions = {
+            navigationPolicy: "index-first",
+            defaultMode: "feature-map-first",
+            maxInitialFiles: 3,
+            missingSnapshotAction: "run-devmap-analyze",
+            staleSnapshotAction: "run-devmap-analyze-fresh",
+            fallbackRule: "Read snapshot.json only when index.json and feature maps are insufficient; inspect extra source only when exact implementation is required."
+        };
+    }
+    else if (snapshot.agentInstructions.navigationPolicy === "snapshot-first") {
+        snapshot.agentInstructions.navigationPolicy = "index-first";
+        snapshot.agentInstructions.defaultMode = "feature-map-first";
+        snapshot.agentInstructions.fallbackRule = "Read snapshot.json only when index.json and feature maps are insufficient; inspect extra source only when exact implementation is required.";
+    }
+    if (!Array.isArray(snapshot.flows)) {
+        snapshot.flows = [];
+    }
+    if (!isRecord(snapshot.onboarding)) {
+        snapshot.onboarding = { recommendedPath: [] };
+    }
+    if (!isRecord(snapshot.changeImpact)) {
+        snapshot.changeImpact = {};
+    }
+    if (isRecord(snapshot.project)) {
+        // Migration shim for snapshots that predate `projectTypes`. The canonical
+        // field is now an array so a single project can be both a CLI and a web
+        // app (mixed workspaces). Mirrors the framework-first classification in
+        // `detectProjectTypes()` (analyzers/pipeline/projectMetadata.ts) — keep
+        // the two in sync.
+        if (!Array.isArray(snapshot.project.projectTypes)) {
+            const framework = String(snapshot.project.framework);
+            const legacyType = typeof snapshot.project.projectType === "string"
+                ? snapshot.project.projectType
+                : FRONTEND_FRAMEWORK_SET.has(framework)
+                    ? "web-app"
+                    : BACKEND_FRAMEWORK_SET.has(framework)
+                        ? "api-service"
+                        : "unknown";
+            snapshot.project.projectTypes = [legacyType];
+        }
+        if (typeof snapshot.project.workspaceType !== "string") {
+            snapshot.project.workspaceType = "single-package";
+        }
+        if (!Array.isArray(snapshot.project.frameworks)) {
+            snapshot.project.frameworks = snapshot.project.framework === "unknown"
+                ? []
+                : [snapshot.project.framework];
+        }
+    }
+    const fileIndex = snapshot.fileIndex;
+    for (const entry of Object.values(fileIndex)) {
+        if (typeof entry.analyzer !== "string")
+            entry.analyzer = "heuristic";
+        if (!["high", "medium", "low"].includes(String(entry.analysisConfidence))) {
+            entry.analysisConfidence = "medium";
+        }
+        if (!Array.isArray(entry.symbols))
+            entry.symbols = [];
+        if (typeof entry.scope !== "string")
+            entry.scope = "unknown";
+        if (!Array.isArray(entry.featureRefs))
+            entry.featureRefs = [];
+        if (!Array.isArray(entry.searchTerms))
+            entry.searchTerms = [];
+        if (!Array.isArray(entry.topFunctions))
+            entry.topFunctions = [];
+        if (typeof entry.importance !== "number")
+            entry.importance = 0;
+    }
+    for (const feature of snapshot.features) {
+        if (!isRecord(feature)) {
+            continue;
+        }
+        if (typeof feature.purpose !== "string") {
+            feature.purpose = typeof feature.name === "string"
+                ? `Identifies ${feature.name.toLowerCase()} capability in the project.`
+                : "Identifies a project capability.";
+        }
+        if (!Array.isArray(feature.files))
+            feature.files = Array.isArray(feature.evidence) ? feature.evidence : [];
+        if (!Array.isArray(feature.entryPoints))
+            feature.entryPoints = [];
+        if (typeof feature.entryPoint !== "string")
+            delete feature.entryPoint;
+        if (!Array.isArray(feature.businessFlow))
+            feature.businessFlow = [];
+        if (!Array.isArray(feature.searchTerms))
+            feature.searchTerms = [];
+        if (!["high", "medium", "low"].includes(String(feature.confidence))) {
+            feature.confidence = "medium";
+        }
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isFileIndexEntry(value) {
+    return (isRecord(value)
+        && typeof value.hash === "string"
+        && Array.isArray(value.imports)
+        && Array.isArray(value.exportedSymbols)
+        && typeof value.lines === "number");
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/cache/snapshot.js.map

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

package/dist/commands/analyze.d.ts

@@ -0,0 +1,12 @@
+import type { AiClient } from "../ai/types.js";
+import { type DevmapConfig } from "../utils/config.js";
+export type AnalyzeOptions = {
+    fresh?: boolean;
+    json?: boolean;
+};
+export type AnalyzeDependencies = {
+    loadConfig?: () => Promise<DevmapConfig | null>;
+    createAiClient?: (config: DevmapConfig) => AiClient;
+};
+export declare function analyzeCommand(target?: string, options?: AnalyzeOptions, dependencies?: AnalyzeDependencies): Promise<void>;
+//# sourceMappingURL=analyze.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAI/E,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,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,wBAAsB,cAAc,CAClC,MAAM,SAAM,EACZ,OAAO,GAAE,cAAmB,EAC5B,YAAY,GAAE,mBAAwB,GACrC,OAAO,CAAC,IAAI,CAAC,CAUf"}