memor-code-cli 0.2.0

package/dist/amGeneration/promptBuilder.js

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAMPrompt = buildAMPrompt;
+const amSections_1 = require("../amSections");
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function buildSectionReference(repoType) {
+    const sections = (0, amSections_1.getSectionsForRepoType)(repoType);
+    return sections.map((s) => `  - "${s.id}" (${s.name}): ${s.description}`).join("\n");
+}
+function buildGraphSignals(enriched) {
+    const nodes = enriched.nodes.filter((n) => n.kind === "cluster" || n.kind === "package");
+    const routeOwners = nodes
+        .filter((n) => n.routes.length > 0)
+        .map((n) => `  ${n.id} → [${n.routes.slice(0, 5).join(", ")}${n.routes.length > 5 ? ", ..." : ""}]`);
+    const ormOwners = nodes
+        .filter((n) => n.ormUses.length > 0)
+        .map((n) => `  ${n.id} (${n.ormUses.join(", ")})`);
+    const envOwners = nodes
+        .filter((n) => n.envConsumes.length > 0)
+        .map((n) => `  ${n.id}: ${n.envConsumes.slice(0, 4).join(", ")}`);
+    const topByImports = [...nodes]
+        .sort((a, b) => b.inDegree - a.inDegree)
+        .slice(0, 6)
+        .map((n) => `  ${n.id} (imported by ${n.inDegree})`);
+    const lines = [];
+    if (routeOwners.length > 0)
+        lines.push(`Route owners:\n${routeOwners.join("\n")}`);
+    if (ormOwners.length > 0)
+        lines.push(`ORM / database users:\n${ormOwners.join("\n")}`);
+    if (envOwners.length > 0)
+        lines.push(`Env var consumers:\n${envOwners.join("\n")}`);
+    if (topByImports.length > 0)
+        lines.push(`Most-imported modules:\n${topByImports.join("\n")}`);
+    if ((enriched.meta.techStack ?? []).length > 0)
+        lines.push(`Detected tech stack: ${(enriched.meta.techStack ?? []).join(", ")}`);
+    if ((enriched.meta.dataModels ?? []).length > 0)
+        lines.push(`Detected data models: ${(enriched.meta.dataModels ?? []).slice(0, 10).join(", ")}`);
+    return lines.join("\n\n");
+}
+function buildFilesBlock(files) {
+    return files
+        .map((f, i) => `### File ${i + 1}: ${f.relPath}\nReason selected: ${f.reason}\n\`\`\`\n${f.content}\n\`\`\``)
+        .join("\n\n");
+}
+function buildWorkspaceManifestsBlock(manifests) {
+    if (!manifests.length)
+        return "";
+    const lines = [
+        `This is a monorepo with ${manifests.length} workspace packages.`,
+        `DO NOT create one system per package — that produces useless noise.`,
+        `Instead, GROUP related packages into 10-18 DOMAIN SYSTEMS based on:`,
+        `  - Shared naming prefix (e.g. cohort-*, chart-*, dataset-*)`,
+        `  - Shared purpose (UI components, data fetching, auth, API routing)`,
+        `  - Inter-package dependency clusters (tightly coupled packages = one system)`,
+        `Example groupings for a clinical analytics app:`,
+        `  Cohort Analysis system ← cohort-selection, cohort-header, cohort-results-filters`,
+        `  Visualization system   ← charts, chart-container, chart-tooltips, d3-sunburst`,
+        `  API Layer system       ← api, fetch-helper, aggregator packages`,
+        `Inter-package dependencies reveal which systems call which — they ARE the edges.`,
+        `Foundation packages (no internal deps) belong in lower layers (service / data-client).`,
+        ``,
+    ];
+    for (const m of manifests) {
+        lines.push(`${m.relDir}  [${m.name}]${m.isPrivate ? " (internal)" : ""}`);
+        if (m.description)
+            lines.push(`  Description: ${m.description}`);
+        if (m.internalDeps.length)
+            lines.push(`  Depends on (internal): ${m.internalDeps.join(", ")}`);
+        if (m.externalDeps.length)
+            lines.push(`  Depends on (external): ${m.externalDeps.join(", ")}`);
+        if (m.exports.length)
+            lines.push(`  Exports: ${m.exports.join("  ")}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+// ── JSON Schema ───────────────────────────────────────────────────────────────
+const JSON_SCHEMA = `{
+  "repo": {
+    "name": "string",
+    "type": "full-stack | frontend-app | backend-api | library | cli | serverless | mobile | monorepo",
+    "description": "string — 2-3 sentences: what this product does and who uses it",
+    "tech": ["string array — detected tech"]
+  },
+  "systems": [
+    {
+      "id": "string — kebab-case unique id",
+      "name": "string — human name",
+      "section": "string — one section id from VALID SECTIONS list",
+      "tier": "core | primary | secondary | support",
+      "layer": "user-facing | api | service | data-client",
+      "description": "string — one clear sentence: what it does and why it matters",
+      "owns_routes": ["optional — HTTP routes, e.g. GET /api/events, POST /api/events/[id]"],
+      "owns_models": ["optional — data models/entities this system owns"],
+      "key_files": ["2-4 actual source file paths with .ts/.js/.tsx extension — NEVER directory paths"],
+      "functions": ["optional — actual exported function signatures, e.g. getAllEvents() → EventWithId[]"],
+      "observations": ["optional — notable architectural decisions or gotchas, e.g. RSC direct call bypasses API hop"],
+      "tech": ["REQUIRED — 2-5 primary technologies, e.g. Next.js, Prisma, Stripe SDK, Zod"]
+    }
+  ],
+  "edges": [
+    {
+      "from": "system id",
+      "to": "system id or external id",
+      "label": "string — e.g. getAllEvents() direct RSC call, assertAdmin() cookie check",
+      "type": "data | import | event | auth | config",
+      "critical": "boolean — true = skeleton edge, false = show on click"
+    }
+  ],
+  "external": [
+    {
+      "id": "string — e.g. postgres, redis, stripe",
+      "name": "string — display name",
+      "type": "database | cache | queue | api | auth | storage | cloud | monitoring",
+      "used_by": ["system ids"],
+      "db_tables": [
+        {
+          "name": "table name — only for database type",
+          "columns": [
+            { "col": "column name", "type": "pg type e.g. uuid, text, timestamptz, jsonb, int", "pk": true, "fk": false }
+          ]
+        }
+      ]
+    }
+  ],
+  "flows": [
+    {
+      "id": "string — kebab-case",
+      "name": "string — e.g. User Views Calendar",
+      "trigger": "string — e.g. Browser hits /calendar route",
+      "steps": [
+        { "system_id": "system or external id", "action": "string — specific action, e.g. getAllEvents() queries events table", "is_external": false }
+      ]
+    }
+  ],
+  "meta": {
+    "total_files": 0,
+    "generated_at": "ISO timestamp",
+    "strategic_files_read": ["paths"]
+  }
+}`;
+// ── Guidance sections ─────────────────────────────────────────────────────────
+const LAYER_GUIDANCE = `LAYER assignment is mandatory. Assign exactly one layer per system:
+
+  "user-facing"  — pages, React components, admin dashboards, anything a browser hits as a URL (not an API endpoint)
+  "api"          — HTTP route handlers, REST endpoints, GraphQL resolvers, Next.js Route Handlers (app/api/*)
+  "service"      — business logic, lib/ functions, server-side helpers, data access logic NOT directly exposed as routes
+  "data-client"  — database clients, ORM config, SDK wrappers (e.g. supabaseAdmin, prismaClient)
+
+Critical rule: if a system contains BOTH pages AND API routes, split it or assign the dominant role.
+Never assign "user-facing" to something that only handles /api/* routes.
+Never assign "api" to a lib/ service function that isn't directly routable.
+
+The layer field drives the spatial layout:
+  Row 0 (top)    — user-facing
+  Row 1          — api
+  Row 2          — service
+  Row 3 (bottom) — data-client
+  External row   — external nodes (databases, third-party APIs)`;
+const TIER_GUIDANCE = `System count: identify 8-18 systems. A real codebase has many distinct concerns.
+Tier rules:
+  "core": 1-2 MAX — the runtime product heart. For a UI library: the main component package and styling engine.
+          NEVER core: documentation sites, dev tools, CLI tools, codemods, test infrastructure, storybook, config.
+          These are ALWAYS "primary" or "secondary" at most — they are not the product.
+  "primary": 3-6 — load-bearing systems that users or developers directly depend on.
+  "secondary": specific concerns that support primary layer.
+  "support": infrastructure, config, types. Never business logic.`;
+const EDGE_GUIDANCE = `Edge labels must be specific — name the actual function call or relationship:
+  GOOD: "getAllEvents() — direct RSC call", "assertAdmin() cookie check", "SELECT from events table"
+  BAD: "calls", "uses", "connects to"
+
+Mark critical=true for 4-7 edges that form the skeleton a new developer MUST understand.
+Always draw edges FROM higher layers TO lower layers (user-facing → api → service → data-client → external).
+STRICT RULE: Never generate circular edges. If A→B exists, B→A must NOT exist. Circular dependencies are architecture bugs, not features — do not model them even if the code has them.`;
+const FUNCTIONS_GUIDANCE = `tech[] field: list the primary technologies, libraries, and frameworks used by this system.
+  REQUIRED — always fill this. 2-5 items per system.
+  Examples: ["Next.js", "React", "Tailwind"], ["Prisma", "PostgreSQL"], ["Stripe SDK", "Webhooks"], ["tRPC", "Zod"]
+  Look at the system's key_files to determine what packages/frameworks they import.
+  Use short recognizable names: "Next.js" not "nextjs", "PostgreSQL" not "pg".
+
+functions[] field: list the actual exported functions from this system.
+  Format: "functionName(params) → ReturnType"
+  Example: "getAllEvents() → EventWithId[]", "assertAdmin() — throws if not authed"
+  Only include public/exported functions, not internal helpers.
+  Max 6 per system.
+
+observations[] field: 1-3 notable architectural decisions or gotchas.
+  Examples:
+  - "RSC server component calls getAllEvents() directly — no API round-trip"
+  - "No rate limiting on POST — public write endpoint"
+  - "Service role key bypasses RLS — never expose to browser"
+  - "Cookie auth (8h TTL) — no NextAuth, no sessions table"`;
+const DB_TABLES_GUIDANCE = `db_tables[] field: for any system with type "database", list the actual tables and their columns.
+  Read column names and types from the code you were given (look for type definitions, migrations, INSERT statements).
+  Mark pk:true for primary keys, fk:true for foreign keys.
+  Include all tables you can identify — even if you only know the table name without columns.`;
+// ── Main export ───────────────────────────────────────────────────────────────
+function buildAMPrompt(ctx) {
+    const { strategicFiles, enriched, repoName, repoDescription, repoType, fileTree, workspaceManifests } = ctx;
+    const totalFiles = enriched.meta.totalFiles;
+    const strategicPaths = strategicFiles.map((f) => f.relPath);
+    const manifestsBlock = workspaceManifests?.length ? buildWorkspaceManifestsBlock(workspaceManifests) : "";
+    const descriptionLine = repoDescription ? `\nPackage description: ${repoDescription}\n` : "";
+    return `You are analyzing "${repoName}" to produce a Memor Architecture Map.${descriptionLine}
+
+A Memor Architecture Map gives developers a complete spatial mental model of a codebase:
+- WHAT systems exist (named, purposeful — not file paths or folders)
+- WHERE each system sits architecturally (user-facing → api → service → data layer)
+- HOW they connect (specific function calls, not vague "uses")
+- WHAT data flows they implement (end-to-end request journeys)
+
+Your output drives a spatial diagram with 4 horizontal swimlane rows.
+Developers use this to understand a new codebase in minutes.
+
+${manifestsBlock ? `════════════════════════════════════════
+WORKSPACE PACKAGES — complete package inventory
+════════════════════════════════════════
+${manifestsBlock}
+` : ""}════════════════════════════════════════
+FULL FILE TREE (every source file in repo)
+════════════════════════════════════════
+Use this to understand ALL routes, ALL lib functions, ALL API endpoints — even those not in the strategic files below.
+
+\`\`\`
+${fileTree ?? "(file tree not available)"}
+\`\`\`
+
+════════════════════════════════════════
+GRAPH SIGNALS (from static analysis)
+════════════════════════════════════════
+${buildGraphSignals(enriched)}
+
+════════════════════════════════════════
+STRATEGIC FILES — actual code (${strategicFiles.length} of ${totalFiles} total)
+════════════════════════════════════════
+${buildFilesBlock(strategicFiles)}
+
+════════════════════════════════════════
+VALID SECTIONS for repo type "${repoType}"
+════════════════════════════════════════
+${buildSectionReference(repoType)}
+
+════════════════════════════════════════
+LAYER GUIDANCE (mandatory field)
+════════════════════════════════════════
+${LAYER_GUIDANCE}
+
+════════════════════════════════════════
+TIER GUIDANCE
+════════════════════════════════════════
+${TIER_GUIDANCE}
+
+════════════════════════════════════════
+EDGE GUIDANCE
+════════════════════════════════════════
+${EDGE_GUIDANCE}
+
+════════════════════════════════════════
+FUNCTIONS + OBSERVATIONS GUIDANCE
+════════════════════════════════════════
+${FUNCTIONS_GUIDANCE}
+
+════════════════════════════════════════
+DB TABLES GUIDANCE
+════════════════════════════════════════
+${DB_TABLES_GUIDANCE}
+
+════════════════════════════════════════
+FLOW GUIDANCE
+════════════════════════════════════════
+Create 5-7 flows showing end-to-end request journeys.
+Each flow = complete path from browser trigger through all layers to data store.
+Step actions must be specific function names or SQL operations, not generic descriptions.
+system_id must match a system id or external id from your output.
+
+════════════════════════════════════════
+OUTPUT
+════════════════════════════════════════
+Output ONLY valid JSON. No markdown. No explanation. No comments. Just the JSON.
+
+${JSON_SCHEMA}
+
+meta.strategic_files_read = ${JSON.stringify(strategicPaths)}
+meta.total_files = ${totalFiles}
+meta.generated_at = "${new Date().toISOString()}"
+
+Output the JSON now:`;
+}
+//# sourceMappingURL=promptBuilder.js.map

package/dist/amGeneration/promptBuilder.js.map

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

package/dist/amGeneration/selectStrategicFiles.d.ts

@@ -0,0 +1,42 @@
+/**
+ * selectStrategicFiles — picks files the LLM should read + builds a file tree.
+ *
+ * Three-phase selection:
+ *  Phase 0 — Workspace-aware: For monorepos (pnpm/yarn/npm workspaces), pick 1
+ *             representative file per workspace package. Ensures every package is
+ *             represented, not just the first N files found.
+ *  Phase 1 — Targeted reads: API route handlers, lib/service files, schema files,
+ *             external clients. Per-pattern caps prevent any one category from
+ *             consuming all slots.
+ *  Phase 2 — Graph-signal reads: entry points, route owners, high inDegree.
+ *             Fill remaining slots up to MAX_FILES.
+ *
+ * Also exports buildFileTree() — a compact directory listing used in the prompt
+ * so the LLM sees every path even if it can't read every file.
+ */
+import type { EnrichedGraph } from "../SystemSynthesis/types";
+export type StrategicFile = {
+    path: string;
+    relPath: string;
+    reason: string;
+    content: string;
+};
+export declare function buildFileTree(repoRoot: string, workspaceDirs?: Set<string>): Promise<string>;
+export type WorkspaceManifest = {
+    relDir: string;
+    name: string;
+    description?: string;
+    internalDeps: string[];
+    externalDeps: string[];
+    exports: string[];
+    isPrivate: boolean;
+};
+/**
+ * Read package.json manifests for ALL workspace packages.
+ * Returns lightweight summaries used to build the WORKSPACE PACKAGES prompt section.
+ * This is the reliable alternative to heuristic source-file selection — package.json
+ * always exists and contains names, descriptions, and inter-package dependencies.
+ */
+export declare function readWorkspaceManifests(repoRoot: string): Promise<WorkspaceManifest[]>;
+export declare function selectStrategicFiles(enriched: EnrichedGraph, repoRoot: string): Promise<StrategicFile[]>;
+//# sourceMappingURL=selectStrategicFiles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectStrategicFiles.d.ts","sourceRoot":"","sources":["../../src/amGeneration/selectStrategicFiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,0BAA0B,CAAC;AAE5E,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAmDF,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClG;AAMD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAkFF;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA2D3F;AA8QD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,EAAE,CAAC,CAmI1B"}