memor-code-cli 0.2.0

package/dist/amGeneration/generateAMForRepo.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * generateAMForRepo — full pipeline: L1→L2→L3→L4→LLM → writes architecture-map.json
+ * Used by the CLI command and the /api/generate-am server endpoint.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAMForRepo = generateAMForRepo;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs/promises"));
+const child_process_1 = require("child_process");
+const IntentionalStructure_1 = require("../IntentionalStructure");
+const buildCodebaseGraph_1 = require("../graph/buildCodebaseGraph");
+const RuntimeInference_1 = require("../RuntimeInference");
+const SystemSynthesis_1 = require("../SystemSynthesis");
+const generateAM_1 = require("./generateAM");
+const enrichAMEdges_1 = require("./enrichAMEdges");
+const selectStrategicFiles_1 = require("./selectStrategicFiles");
+async function generateAMForRepo(repoRoot, apiKey, onProgress) {
+    const key = apiKey ?? process.env.ANTHROPIC_API_KEY;
+    if (!key)
+        throw new Error("ANTHROPIC_API_KEY not set");
+    const repoName = path.basename(repoRoot);
+    const log = (s) => onProgress?.(s);
+    // Read package.json for human-written description if available
+    let repoDescription;
+    try {
+        const pkg = JSON.parse(await fs.readFile(path.join(repoRoot, "package.json"), "utf8"));
+        const parts = [];
+        if (pkg.description)
+            parts.push(pkg.description);
+        if (pkg.keywords?.length)
+            parts.push(`Keywords: ${pkg.keywords.slice(0, 8).join(", ")}`);
+        if (parts.length)
+            repoDescription = parts.join(". ");
+    }
+    catch { /* no package.json or not parseable — fine */ }
+    log("L1 IntentionalStructure…");
+    const l1 = await (0, IntentionalStructure_1.detectIntentionalStructure)(repoRoot);
+    log("L2 buildCodebaseGraph…");
+    const layer1Paths = l1.systems.filter((s) => s.path !== null).map((s) => s.path);
+    const l2 = await (0, buildCodebaseGraph_1.buildCodebaseGraph)(repoRoot, [], layer1Paths);
+    log("L3 RuntimeInference…");
+    const l3 = await (0, RuntimeInference_1.detectRuntimeInference)(repoRoot, l2, l1);
+    log("L4 mergeLayerOutputs…");
+    const enriched = (0, SystemSynthesis_1.mergeLayerOutputs)(l1, l2, l3, { repoName });
+    // Emit deterministic intel before handing off to LLM
+    try {
+        const codeNodes = enriched.nodes.filter((n) => n.kind === "cluster" || n.kind === "package");
+        const hotspots = [...codeNodes]
+            .sort((a, b) => b.inDegree - a.inDegree)
+            .slice(0, 8)
+            .map((n) => ({ id: n.id, inDegree: n.inDegree }));
+        const routes = codeNodes
+            .flatMap((n) => n.routes)
+            .filter(Boolean)
+            .slice(0, 30);
+        const clusters = codeNodes.map((n) => {
+            let layer = "unknown";
+            if (n.routes.length > 0)
+                layer = "api";
+            else if (n.ormUses.length > 0)
+                layer = "data-client";
+            else if (n.inDegree > 5)
+                layer = "service";
+            return { id: n.id, layer, inDegree: n.inDegree };
+        });
+        const intel = {
+            techStack: enriched.meta.techStack ?? [],
+            dataModels: (enriched.meta.dataModels ?? []).slice(0, 12),
+            totalFiles: enriched.meta.totalFiles,
+            hotspots,
+            routes,
+            clusters,
+        };
+        log(`am-intel:${JSON.stringify(intel)}`);
+    }
+    catch { /* intel extraction is best-effort */ }
+    log("Generating Architecture Map via LLM…");
+    const am = await (0, generateAM_1.generateAM)(enriched, { repoRoot, repoName, repoDescription, apiKey: key });
+    log("Enriching edges deterministically…");
+    const manifests = await (0, selectStrategicFiles_1.readWorkspaceManifests)(repoRoot);
+    const enrichedAM = (0, enrichAMEdges_1.enrichAMEdges)(am, repoRoot, manifests);
+    let generatedAtCommit = "";
+    try {
+        generatedAtCommit = (0, child_process_1.execSync)(`git -C "${repoRoot}" rev-parse HEAD`, { encoding: "utf8" }).trim();
+    }
+    catch { /* not a git repo — fine */ }
+    const enrichedAMWithMeta = {
+        ...enrichedAM,
+        _meta: { generatedAtCommit, generatedAt: new Date().toISOString() },
+    };
+    const memorDir = path.join(repoRoot, ".memor");
+    await fs.mkdir(memorDir, { recursive: true });
+    await fs.writeFile(path.join(memorDir, "architecture-map.json"), JSON.stringify(enrichedAMWithMeta, null, 2), "utf8");
+    log("Done.");
+}
+//# sourceMappingURL=generateAMForRepo.js.map

package/dist/amGeneration/generateAMForRepo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateAMForRepo.js","sourceRoot":"","sources":["../../src/amGeneration/generateAMForRepo.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaH,8CAyFC;AApGD,2CAA6B;AAC7B,gDAAkC;AAClC,iDAAyC;AACzC,kEAAqE;AACrE,oEAAiE;AACjE,0DAA6D;AAC7D,wDAAuD;AACvD,6CAA0C;AAC1C,mDAAgD;AAChD,iEAAgE;AAEzD,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,MAAe,EACf,UAAmC;IAEnC,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACpD,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAE3C,+DAA+D;IAC/D,IAAI,eAAmC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACvF,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,GAAG,CAAC,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,aAAc,GAAG,CAAC,QAAqB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvG,IAAI,KAAK,CAAC,MAAM;YAAE,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC,CAAC,6CAA6C,CAAC,CAAC;IAEzD,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,MAAM,IAAA,iDAA0B,EAAC,QAAQ,CAAC,CAAC;IAEtD,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAC9B,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC;IAC3F,MAAM,EAAE,GAAG,MAAM,IAAA,uCAAkB,EAAC,QAAQ,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;IAE/D,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAC5B,MAAM,EAAE,GAAG,MAAM,IAAA,yCAAsB,EAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAE1D,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAA,mCAAiB,EAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE7D,qDAAqD;IACrD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QAC7F,MAAM,QAAQ,GAAG,CAAC,GAAG,SAAS,CAAC;aAC5B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;aACvC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,SAAS;aACrB,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;aACxB,MAAM,CAAC,OAAO,CAAC;aACf,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChB,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACnC,IAAI,KAAK,GAAkD,SAAS,CAAC;YACrE,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,GAAG,KAAK,CAAC;iBAClC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,GAAG,aAAa,CAAC;iBAChD,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC;gBAAE,KAAK,GAAG,SAAS,CAAC;YAC3C,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG;YACZ,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE;YACxC,UAAU,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACzD,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU;YACpC,QAAQ;YACR,MAAM;YACN,QAAQ;SACT,CAAC;QACF,GAAG,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC,CAAC,qCAAqC,CAAC,CAAC;IAEjD,GAAG,CAAC,sCAAsC,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,MAAM,IAAA,uBAAU,EAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAE5F,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,IAAA,6CAAsB,EAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAE1D,IAAI,iBAAiB,GAAG,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,iBAAiB,GAAG,IAAA,wBAAQ,EAAC,WAAW,QAAQ,kBAAkB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnG,CAAC;IAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;IAEvC,MAAM,kBAAkB,GAAG;QACzB,GAAG,UAAU;QACb,KAAK,EAAE,EAAE,iBAAiB,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;KACpE,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC,EAC5C,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,EAC3C,MAAM,CACP,CAAC;IAEF,GAAG,CAAC,OAAO,CAAC,CAAC;AACf,CAAC"}

package/dist/amGeneration/generateFlows.d.ts

@@ -0,0 +1,27 @@
+/**
+ * generateFlows — LLM narration layer on top of deterministic flow graphs.
+ *
+ * Input: FlowCandidate[] from buildFlowGraph (real traced call chains).
+ * Task:  LLM only assigns human-readable names and action sentences.
+ *        No discovery, no guessing — pure narration.
+ *
+ * Also keeps attachEvidenceFiles for backwards compat with stored flows.
+ */
+import type { RouteMap } from "../analysis/extractRouteMap";
+import type { FlowCandidate } from "./buildFlowGraph";
+export type FlowStep = {
+    system_id: string;
+    action: string;
+    is_external: boolean;
+    evidenceFiles?: string[];
+};
+export type GeneratedFlow = {
+    id: string;
+    name: string;
+    trigger: string;
+    steps: FlowStep[];
+    derivedFrom: "evidence";
+};
+export declare function generateFlows(candidatesOrRouteMap: FlowCandidate[] | RouteMap, systemIds: string[], externalIds: string[], apiKey: string, repoRoot?: string): Promise<GeneratedFlow[]>;
+export declare function attachEvidenceFiles(flows: GeneratedFlow[], routeMap: RouteMap, repoRoot?: string): GeneratedFlow[];
+//# sourceMappingURL=generateFlows.d.ts.map

package/dist/amGeneration/generateFlows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateFlows.d.ts","sourceRoot":"","sources":["../../src/amGeneration/generateFlows.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,WAAW,EAAE,UAAU,CAAC;CACzB,CAAC;AA+BF,wBAAsB,aAAa,CACjC,oBAAoB,EAAE,aAAa,EAAE,GAAG,QAAQ,EAChD,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,EAAE,CAAC,CAiF1B;AAgHD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EAAE,EACtB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,aAAa,EAAE,CAoDjB"}

package/dist/amGeneration/generateFlows.js

@@ -0,0 +1,320 @@
+"use strict";
+/**
+ * generateFlows — LLM narration layer on top of deterministic flow graphs.
+ *
+ * Input: FlowCandidate[] from buildFlowGraph (real traced call chains).
+ * Task:  LLM only assigns human-readable names and action sentences.
+ *        No discovery, no guessing — pure narration.
+ *
+ * Also keeps attachEvidenceFiles for backwards compat with stored flows.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFlows = generateFlows;
+exports.attachEvidenceFiles = attachEvidenceFiles;
+const anthropic_1 = require("../anthropic");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const extractRouteMap_1 = require("../analysis/extractRouteMap");
+// ── Serialise FlowCandidate[] into a compact LLM prompt block ────────────────
+function serializeFlowCandidates(candidates, systemIds, externalIds) {
+    const allSystemIds = [...systemIds, ...externalIds];
+    const lines = [
+        `VALID SYSTEM IDs (use these exactly in system_id fields):`,
+        allSystemIds.join(", "),
+        "",
+        `TRACED FLOWS (${candidates.length} entry points — real call chains from static analysis):`,
+    ];
+    for (const c of candidates) {
+        lines.push(`\nFLOW: ${c.nameSeed}  [${c.framework}]  entry: ${c.entryFile}`);
+        for (let i = 0; i < c.steps.length; i++) {
+            const s = c.steps[i];
+            const sysHint = s.systemId ? ` [system: ${s.systemId}]` : " [system: ???]";
+            const extFlag = s.isExternal ? "  ← EXTERNAL STEP" : "";
+            const db = s.dbAccess.length ? `  DB: ${s.dbAccess.slice(0, 3).join(", ")}` : "";
+            const ext = s.externalCalls.length ? `  sdk: ${s.externalCalls.slice(0, 3).join(", ")}` : "";
+            const ret = s.returnType && s.returnType !== "void" ? `  → ${s.returnType}` : "";
+            lines.push(`  ${i + 1}. ${s.fn}() in ${s.file}${sysHint}${ret}${db}${ext}${extFlag}`);
+        }
+    }
+    return lines.join("\n");
+}
+// ── Main export ───────────────────────────────────────────────────────────────
+async function generateFlows(candidatesOrRouteMap, systemIds, externalIds, apiKey, repoRoot) {
+    const client = (0, anthropic_1.createAnthropicClient)(apiKey);
+    // Support both new FlowCandidate[] path and legacy RouteMap path
+    const isLegacy = !Array.isArray(candidatesOrRouteMap);
+    const inputBlock = isLegacy
+        ? (0, extractRouteMap_1.serializeRouteMap)(candidatesOrRouteMap)
+        : serializeFlowCandidates(candidatesOrRouteMap, systemIds, externalIds);
+    const systemList = [...systemIds, ...externalIds].join(", ");
+    const prompt = isLegacy
+        ? `You are analyzing a codebase. Below is a deterministic route map from static analysis — real file paths, real function names, real DB calls.
+
+SYSTEM IDs available (use these exactly in system_id fields):
+${systemList}
+
+${inputBlock}
+
+Generate 8-12 end-to-end user flows. Include:
+- Read flows (GET) AND write flows (POST, PUT, DELETE, PATCH) — write paths are as important as reads
+- Background job flows for any CRON, QUEUE, INTERVAL, or WORKER entries — these are write paths too
+Each flow must trace from a real page, API route, or background job through to data.
+Use only system_id values from the list above. Set is_external: true only for external service steps.`
+        : `You are given deterministically-traced call chains from a real codebase.
+Each flow already has the exact functions called and files involved — do NOT invent steps.
+
+Your ONLY job:
+1. Give each flow a human-readable "name" (3-5 words, e.g. "User Login", "Create Order")
+2. Write a one-sentence "trigger" describing what user action starts this flow
+3. For each step, write a clear "action" sentence naming the function and what it does
+
+${inputBlock}
+
+Rules:
+- system_id MUST come from the VALID SYSTEM IDs list above — pick the closest match to the [system: hint]
+- is_external is ALREADY DETERMINED — steps marked "← EXTERNAL STEP" get is_external: true, all others get is_external: false. Do not change this.
+- Keep action sentences concise but specific — include function names
+- Do not add or remove steps`;
+    const msg = await client.messages.create({
+        model: "claude-haiku-4-5-20251001",
+        max_tokens: 4096,
+        messages: [{
+                role: "user",
+                content: `${prompt}
+
+Respond with JSON only — no markdown, no explanation:
+{
+  "flows": [
+    {
+      "id": "kebab-case-id",
+      "name": "Human readable name",
+      "trigger": "One sentence trigger description",
+      "steps": [
+        {
+          "system_id": "system-id",
+          "action": "Specific description of what this function does",
+          "is_external": false,
+          "evidenceFile": "relative/path/to/file.ts"
+        }
+      ]
+    }
+  ]
+}`,
+            }],
+    });
+    const raw = msg.content[0].type === "text" ? msg.content[0].text.trim() : "{}";
+    const clean = raw.replace(/^```json?\s*/i, "").replace(/```\s*$/, "").trim();
+    const parsed = JSON.parse(clean);
+    const flows = (parsed.flows ?? []).map(f => ({ ...f, derivedFrom: "evidence" }));
+    // Attach evidence files deterministically
+    if (!isLegacy && Array.isArray(candidatesOrRouteMap)) {
+        return attachEvidenceFromCandidates(flows, candidatesOrRouteMap);
+    }
+    // Legacy: use route-map based evidence attachment
+    const routeMap = candidatesOrRouteMap;
+    return attachEvidenceFiles(flows, routeMap, repoRoot);
+}
+// ── Evidence file attachment (new path — from FlowCandidate steps) ────────────
+function attachEvidenceFromCandidates(flows, candidates) {
+    // Match flows to candidates by position (LLM preserves order)
+    return flows.map((flow, fi) => {
+        const candidate = candidates[fi];
+        if (!candidate)
+            return flow;
+        return {
+            ...flow,
+            steps: flow.steps.map((step, i) => {
+                const cs = candidate.steps[i];
+                if (!cs)
+                    return step;
+                // Lock is_external from deterministic analysis, override LLM value
+                const lockedStep = { ...step, is_external: cs.isExternal };
+                const evidenceFiles = [cs.file].filter(Boolean);
+                return evidenceFiles.length ? { ...lockedStep, evidenceFiles } : lockedStep;
+            }),
+        };
+    });
+}
+// ── Deterministic file attachment ─────────────────────────────────────────────
+const SKIP_SEGMENTS = new Set([
+    "app", "pages", "api", "route", "page", "layout", "src", "lib",
+    "service", "client", "ui", "portal", "interface", "index",
+]);
+const SKIP_ID_PARTS = new Set([
+    "api", "service", "client", "ui", "portal", "interface", "external", "system", "layer", "core",
+]);
+function indexFilePaths(filePaths) {
+    const index = new Map();
+    for (const filePath of filePaths) {
+        const segments = filePath
+            .replace(/\.(ts|tsx|js|jsx)$/, "")
+            .replace(/\\/g, "/")
+            .split("/")
+            .filter(s => s && !SKIP_SEGMENTS.has(s) && !s.startsWith("[[") && !s.startsWith("[") && !s.startsWith("("));
+        for (const seg of segments) {
+            const key = seg.toLowerCase();
+            if (!index.has(key))
+                index.set(key, []);
+            index.get(key).push(filePath);
+        }
+    }
+    return index;
+}
+// Build route-path lookup: normalized path → file
+function buildRoutePathIndex(routeMap) {
+    const index = new Map();
+    for (const r of routeMap.apiRoutes)
+        index.set(r.routePath, r.filePath);
+    for (const p of routeMap.pages)
+        index.set(p.routePath, p.filePath);
+    return index;
+}
+// Scan packages/ and apps/ dirs for .ts/.tsx entry points (monorepo strategy 3)
+function buildPackageFileIndex(repoRoot) {
+    const collected = [];
+    for (const parentName of ["packages", "apps", "libs", "modules"]) {
+        const parentDir = path.join(repoRoot, parentName);
+        if (!fs.existsSync(parentDir))
+            continue;
+        let entries;
+        try {
+            entries = fs.readdirSync(parentDir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            if (!e.isDirectory())
+                continue;
+            const pkgDir = path.join(parentDir, e.name);
+            // Look for index.ts/tsx or main entry files in the package root
+            for (const candidate of ["index.ts", "index.tsx", "src/index.ts", "src/index.tsx"]) {
+                const abs = path.join(pkgDir, candidate);
+                if (fs.existsSync(abs)) {
+                    collected.push(path.relative(repoRoot, abs).replace(/\\/g, "/"));
+                    break;
+                }
+            }
+            // Also index all .ts/.tsx files one level deep in src/ or lib/
+            for (const subDir of ["src", "lib", "."]) {
+                const srcDir = path.join(pkgDir, subDir);
+                if (!fs.existsSync(srcDir))
+                    continue;
+                let srcEntries;
+                try {
+                    srcEntries = fs.readdirSync(srcDir, { withFileTypes: true });
+                }
+                catch {
+                    continue;
+                }
+                for (const sf of srcEntries) {
+                    if (sf.isFile() && /\.(ts|tsx)$/.test(sf.name) && !sf.name.includes(".test.") && !sf.name.includes(".spec.")) {
+                        collected.push(path.relative(repoRoot, path.join(srcDir, sf.name)).replace(/\\/g, "/"));
+                    }
+                }
+            }
+        }
+    }
+    return indexFilePaths(collected);
+}
+// Extract a URL path from free-text action like "POST /api/admin/blocks/create returns block"
+function extractRoutePath(action) {
+    const m = action.match(/\b(GET|POST|PUT|DELETE|PATCH)\s+(\/[^\s,)]+)/i);
+    if (m)
+        return m[2].split("?")[0];
+    const urlM = action.match(/(\/api\/[^\s,)]+|\/v2\/[^\s,)]+)/);
+    if (urlM)
+        return urlM[1].split("?")[0];
+    return null;
+}
+// Collect all matching files from an index for a token (deduped)
+function allFromIndex(index, token) {
+    return index.get(token.toLowerCase()) ?? [];
+}
+const MAX_EVIDENCE_FILES = 4;
+function attachEvidenceFiles(flows, routeMap, repoRoot) {
+    const routePathIndex = buildRoutePathIndex(routeMap);
+    const routeFileIndex = indexFilePaths([
+        ...routeMap.apiRoutes.map(r => r.filePath),
+        ...routeMap.pages.map(p => p.filePath),
+    ]);
+    const pkgFileIndex = repoRoot ? buildPackageFileIndex(repoRoot) : new Map();
+    const fileExists = repoRoot
+        ? (f) => fs.existsSync(path.join(repoRoot, f))
+        : (_f) => true;
+    return flows.map(flow => ({
+        ...flow,
+        steps: flow.steps.map(step => {
+            // Only add paths that actually exist on disk
+            const seen = new Set();
+            const add = (f) => { if (f && !seen.has(f) && fileExists(f))
+                seen.add(f); };
+            if (step.evidenceFile)
+                add(step.evidenceFile);
+            (step.evidenceFiles ?? []).forEach(add);
+            // Strategy 1: parse route URL from action text → all prefix-matching route files
+            const routePath = extractRoutePath(step.action);
+            if (routePath) {
+                const exact = routePathIndex.get(routePath);
+                if (exact)
+                    add(exact);
+                for (const [rp, fp] of routePathIndex) {
+                    if (seen.size >= MAX_EVIDENCE_FILES)
+                        break;
+                    if ((rp.startsWith(routePath) || routePath.startsWith(rp)) && rp !== routePath)
+                        add(fp);
+                }
+            }
+            const parts = step.system_id.split("-").filter(p => !SKIP_ID_PARTS.has(p));
+            // Strategy 2: tokenize system_id → all matching route/page files
+            for (const part of parts) {
+                if (seen.size >= MAX_EVIDENCE_FILES)
+                    break;
+                allFromIndex(routeFileIndex, part).forEach(add);
+            }
+            // Strategy 3: tokenize system_id → all matching package files (monorepo)
+            for (const part of parts) {
+                if (seen.size >= MAX_EVIDENCE_FILES)
+                    break;
+                allFromIndex(pkgFileIndex, part).forEach(add);
+            }
+            const evidenceFiles = [...seen].slice(0, MAX_EVIDENCE_FILES);
+            const { evidenceFile: _drop, evidenceFiles: _drop2, ...rest } = step;
+            return evidenceFiles.length > 0 ? { ...rest, evidenceFiles } : rest;
+        }),
+    }));
+}
+//# sourceMappingURL=generateFlows.js.map

package/dist/amGeneration/generateFlows.js.map

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

package/dist/amGeneration/promptBuilder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * promptBuilder — builds the LLM prompt for AM generation.
+ *
+ * Key upgrades over v1:
+ *  - File tree in context: LLM sees every path, even files it can't read
+ *  - layer field: forces explicit "user-facing | api | service | data-client" per system
+ *  - functions field: real exported function signatures
+ *  - observations field: architectural notes and gotchas
+ *  - db_tables field: actual table/column schema for database externals
+ */
+import type { StrategicFile, WorkspaceManifest } from "./selectStrategicFiles";
+import type { EnrichedGraph } from "../SystemSynthesis/types";
+import type { AMRepoType } from "../amSections";
+export type PromptContext = {
+    strategicFiles: StrategicFile[];
+    enriched: EnrichedGraph;
+    repoName: string;
+    repoDescription?: string;
+    repoType: AMRepoType;
+    fileTree?: string;
+    workspaceManifests?: WorkspaceManifest[];
+};
+export declare function buildAMPrompt(ctx: PromptContext): string;
+//# sourceMappingURL=promptBuilder.d.ts.map

package/dist/amGeneration/promptBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptBuilder.d.ts","sourceRoot":"","sources":["../../src/amGeneration/promptBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C,CAAC;AAyMF,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA2FxD"}