memor-code-cli 0.2.0

package/dist/analysis/extractRouteMap.js

@@ -0,0 +1,354 @@
+"use strict";
+/**
+ * extractRouteMap — deterministic Next.js route scanner.
+ *
+ * Finds all route.ts (API routes) and page.tsx (page components),
+ * runs buildDetailedFileXRay on each to get handler signatures + call chains,
+ * and returns a compact RouteMap for use in flow generation.
+ *
+ * Zero LLM calls. Runs in ~100ms on a typical Next.js app.
+ */
+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.extractRouteMap = extractRouteMap;
+exports.serializeRouteMap = serializeRouteMap;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const buildDetailedFileXRay_1 = require("./buildDetailedFileXRay");
+const buildFlowGraph_1 = require("../amGeneration/buildFlowGraph");
+// ── File path → route path ────────────────────────────────────────────────────
+const HTTP_METHODS = new Set(["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]);
+function filePathToRoutePath(relPath) {
+    // Remove file extension and trailing /route or /page
+    let p = relPath
+        .replace(/\\/g, "/")
+        .replace(/\.(ts|tsx|js|jsx)$/, "")
+        .replace(/\/route$/, "")
+        .replace(/\/page$/, "");
+    // Strip leading app/ or pages/
+    p = p.replace(/^app\//, "/").replace(/^pages\//, "/");
+    if (!p.startsWith("/"))
+        p = "/" + p;
+    // Next.js: remove (group) segments like (marketing)
+    p = p.replace(/\/\([^)]+\)/g, "");
+    // Clean up double slashes
+    p = p.replace(/\/+/g, "/");
+    return p || "/";
+}
+// ── Scan helpers ──────────────────────────────────────────────────────────────
+function findFiles(dir, pattern) {
+    const results = [];
+    if (!fs.existsSync(dir))
+        return results;
+    function walk(current) {
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.name.startsWith(".") || e.name === "node_modules")
+                continue;
+            const full = path.join(current, e.name);
+            if (e.isDirectory()) {
+                walk(full);
+            }
+            else if (pattern.test(e.name)) {
+                results.push(full);
+            }
+        }
+    }
+    walk(dir);
+    return results;
+}
+function buildCallChains(fns) {
+    const byName = new Map(fns.map(f => [f.name, f]));
+    const chains = [];
+    for (const fn of fns) {
+        for (const callee of fn.calls) {
+            chains.push({ from: fn.name, to: callee, external: false });
+        }
+        for (const ext of fn.externalCalls ?? []) {
+            chains.push({ from: fn.name, to: ext, external: true });
+        }
+        // One level deeper: resolve what fn.calls themselves call
+        for (const callee of fn.calls) {
+            const calleeFn = byName.get(callee);
+            if (!calleeFn)
+                continue;
+            for (const ext of calleeFn.externalCalls ?? []) {
+                chains.push({ from: callee, to: ext, external: true });
+            }
+        }
+    }
+    return chains;
+}
+// ── Main extractor ────────────────────────────────────────────────────────────
+// ── Monorepo-aware Next.js root discovery ─────────────────────────────────────
+function isNextJsRoot(dir) {
+    return (fs.existsSync(path.join(dir, "next.config.ts")) ||
+        fs.existsSync(path.join(dir, "next.config.js")) ||
+        fs.existsSync(path.join(dir, "next.config.mjs")) ||
+        fs.existsSync(path.join(dir, "next.config.cjs")));
+}
+function findNextJsRoots(repoRoot) {
+    const roots = [];
+    if (isNextJsRoot(repoRoot))
+        roots.push(repoRoot);
+    // Scan common monorepo parent dirs (apps/*, packages/*)
+    for (const parentName of ["apps", "packages"]) {
+        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 subDir = path.join(parentDir, e.name);
+            if (isNextJsRoot(subDir))
+                roots.push(subDir);
+        }
+    }
+    // Fallback: always include root even if no next.config found
+    if (roots.length === 0)
+        roots.push(repoRoot);
+    return roots;
+}
+// ── Background job scanner ────────────────────────────────────────────────────
+function scanBackgroundJobs(repoRoot) {
+    const jobs = [];
+    const CODE_RE = /\.(ts|tsx|js|jsx|mjs)$/;
+    // Patterns to detect
+    const CRON_RE = /(?:cron\.schedule|schedule\(|@Cron\()\s*['"`]([^'"`]+)['"`]/g;
+    const QUEUE_RE = /\.(?:process|add|subscribe|consume|on)\s*\(\s*['"`]([^'"`]+)['"`]/g;
+    const INTERVAL_RE = /setInterval\s*\([^,]+,\s*(\d+)/g;
+    const LISTENER_RE = /(?:emitter|bus|eventBus|rabbit|nats)\.on\s*\(\s*['"`]([^'"`]+)['"`]/g;
+    const WORKER_RE = /new\s+(?:Worker|BullWorker|Queue)\s*\(\s*['"`]([^'"`]+)['"`]/g;
+    function walk(dir) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.name.startsWith(".") || e.name === "node_modules" || e.name === "dist")
+                continue;
+            const full = path.join(dir, e.name);
+            if (e.isDirectory()) {
+                walk(full);
+                continue;
+            }
+            if (!CODE_RE.test(e.name))
+                continue;
+            let src;
+            try {
+                src = fs.readFileSync(full, "utf8");
+            }
+            catch {
+                continue;
+            }
+            const relPath = path.relative(repoRoot, full).replace(/\\/g, "/");
+            const check = (re, kind, labelFn) => {
+                re.lastIndex = 0;
+                let m;
+                while ((m = re.exec(src)) !== null) {
+                    const fnMatch = src.slice(0, m.index).match(/(?:function|async function|const|let)\s+([\w$]+)\s*(?:=|{)/g);
+                    const handler = fnMatch ? fnMatch[fnMatch.length - 1].replace(/^.*?(?:function|const|let)\s+([\w$]+).*$/, "$1") : "handler";
+                    jobs.push({ kind, filePath: relPath, trigger: labelFn(m), handlerName: handler });
+                }
+            };
+            check(CRON_RE, "cron", m => m[1]);
+            check(QUEUE_RE, "queue", m => m[1]);
+            check(LISTENER_RE, "event-listener", m => m[1]);
+            check(WORKER_RE, "worker", m => m[1]);
+            // setInterval: convert ms to human label
+            INTERVAL_RE.lastIndex = 0;
+            let im;
+            while ((im = INTERVAL_RE.exec(src)) !== null) {
+                const ms = parseInt(im[1]);
+                const label = ms >= 3_600_000 ? `every ${Math.round(ms / 3_600_000)}h`
+                    : ms >= 60_000 ? `every ${Math.round(ms / 60_000)}min`
+                        : `every ${ms}ms`;
+                jobs.push({ kind: "interval", filePath: relPath, trigger: label, handlerName: "setInterval" });
+            }
+        }
+    }
+    walk(repoRoot);
+    return jobs;
+}
+function extractRouteMap(repoRoot) {
+    const nextRoots = findNextJsRoots(repoRoot);
+    const routeFiles = [];
+    const pageFiles = [];
+    for (const nextRoot of nextRoots) {
+        const appDir = path.join(nextRoot, "app");
+        const pagesDir = path.join(nextRoot, "pages");
+        routeFiles.push(...findFiles(appDir, /^route\.(ts|tsx|js|jsx)$/), ...findFiles(pagesDir, /^.*\.(ts|tsx|js|jsx)$/));
+        pageFiles.push(...findFiles(appDir, /^page\.(ts|tsx|js|jsx)$/), ...findFiles(pagesDir, /^(?!_app|_document|api\/).*\.(tsx|jsx)$/));
+    }
+    const filteredRouteFiles = routeFiles.filter(f => !f.includes("/node_modules/"));
+    const filteredPageFiles = pageFiles.filter(f => !f.includes("/node_modules/"));
+    const apiRoutes = [];
+    const pages = [];
+    // Process API routes
+    for (const absPath of filteredRouteFiles) {
+        // Skip pages/api/** that are in old router (treat as API routes)
+        const relPath = path.relative(repoRoot, absPath).replace(/\\/g, "/");
+        const routePath = filePathToRoutePath(relPath);
+        let xray;
+        try {
+            xray = (0, buildDetailedFileXRay_1.buildDetailedFileXRay)(absPath, repoRoot);
+        }
+        catch {
+            continue;
+        }
+        const httpHandlers = xray.functions.filter(f => HTTP_METHODS.has(f.name));
+        if (httpHandlers.length === 0)
+            continue; // not a route handler file
+        const handlers = httpHandlers.map(h => ({
+            method: h.name,
+            calls: h.calls,
+            externalCalls: h.externalCalls ?? [],
+            isAsync: h.isAsync,
+        }));
+        apiRoutes.push({
+            routePath,
+            filePath: relPath,
+            handlers,
+            callChains: buildCallChains(xray.functions),
+        });
+    }
+    // Process page routes
+    for (const absPath of filteredPageFiles) {
+        const relPath = path.relative(repoRoot, absPath).replace(/\\/g, "/");
+        const routePath = filePathToRoutePath(relPath);
+        let xray;
+        try {
+            xray = (0, buildDetailedFileXRay_1.buildDetailedFileXRay)(absPath, repoRoot);
+        }
+        catch {
+            continue;
+        }
+        const comp = xray.functions.find(f => f.kind === "component");
+        if (!comp)
+            continue;
+        pages.push({
+            routePath,
+            filePath: relPath,
+            componentName: comp.name,
+            calls: comp.calls,
+            externalCalls: comp.externalCalls ?? [],
+            stateVars: comp.renderAnalysis?.stateVars ?? [],
+            events: (comp.renderAnalysis?.eventsWired ?? []).map(e => e.event),
+            renders: comp.renderAnalysis?.renderedElements ?? [],
+        });
+    }
+    // If no Next.js API routes found, fall back to Express/NestJS entry point discovery
+    if (apiRoutes.length === 0) {
+        try {
+            const entryPoints = (0, buildFlowGraph_1.discoverEntryPoints)(repoRoot);
+            for (const ep of entryPoints) {
+                // Only include write paths and any route not already captured
+                apiRoutes.push({
+                    routePath: ep.routePath,
+                    filePath: path.relative(repoRoot, ep.absFile).replace(/\\/g, "/"),
+                    handlers: [{ method: ep.method, calls: ep.handlerFn ? [ep.handlerFn] : [], externalCalls: [], isAsync: true }],
+                    callChains: [],
+                });
+            }
+        }
+        catch { /* best-effort */ }
+    }
+    // Sort by route path for deterministic output
+    apiRoutes.sort((a, b) => a.routePath.localeCompare(b.routePath));
+    pages.sort((a, b) => a.routePath.localeCompare(b.routePath));
+    const backgroundJobs = scanBackgroundJobs(repoRoot);
+    return { apiRoutes, pages, backgroundJobs };
+}
+// ── Compact text serialization (for LLM prompt) ───────────────────────────────
+function serializeRouteMap(rm) {
+    const lines = [];
+    lines.push(`API ROUTES (${rm.apiRoutes.length}):`);
+    for (const r of rm.apiRoutes) {
+        const methods = r.handlers.map(h => h.method).join(", ");
+        lines.push(`  ${methods} ${r.routePath}  [${r.filePath}]`);
+        for (const h of r.handlers) {
+            if (h.calls.length > 0) {
+                lines.push(`    ${h.method}() → calls: ${h.calls.join(", ")}`);
+            }
+            if (h.externalCalls.length > 0) {
+                lines.push(`    ${h.method}() → external: ${h.externalCalls.join(", ")}`);
+            }
+        }
+        // Show resolved call chains (handler → callee → external)
+        const deepExt = r.callChains.filter(c => c.external && !r.handlers.some(h => h.method === c.from));
+        if (deepExt.length > 0) {
+            const unique = [...new Set(deepExt.map(c => `${c.from} → ${c.to}`))];
+            lines.push(`    chains: ${unique.slice(0, 4).join("; ")}`);
+        }
+    }
+    lines.push("");
+    lines.push(`PAGE ROUTES (${rm.pages.length}):`);
+    for (const p of rm.pages) {
+        lines.push(`  ${p.routePath}  [${p.filePath}]  component: ${p.componentName}`);
+        if (p.calls.length > 0)
+            lines.push(`    calls: ${p.calls.join(", ")}`);
+        if (p.externalCalls.length > 0)
+            lines.push(`    external: ${p.externalCalls.join(", ")}`);
+        if (p.stateVars.length > 0)
+            lines.push(`    state: [${p.stateVars.join(", ")}]`);
+        if (p.renders.length > 0)
+            lines.push(`    renders: ${p.renders.join(", ")}`);
+    }
+    if (rm.backgroundJobs.length > 0) {
+        lines.push("");
+        lines.push(`BACKGROUND JOBS (${rm.backgroundJobs.length}):`);
+        for (const j of rm.backgroundJobs) {
+            lines.push(`  [${j.kind.toUpperCase()}] ${j.trigger}  handler: ${j.handlerName}  [${j.filePath}]`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=extractRouteMap.js.map

package/dist/analysis/extractRouteMap.js.map

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

package/dist/analysis/generateFileInsight.d.ts

@@ -0,0 +1,19 @@
+/**
+ * generateFileInsight — fast Claude Haiku call for a file's AI description + suggestions.
+ *
+ * Sends a compact STRUCTURED summary (function signatures, call graph, render analysis)
+ * instead of raw source lines. This covers the whole file regardless of size and uses
+ * far fewer tokens than pasting code.
+ *
+ * Results are cached in memory for the lifetime of the server process.
+ */
+import type { DetailedFileXRay } from "./buildDetailedFileXRay";
+export type FileInsight = {
+    description: string;
+    suggestions: {
+        title: string;
+        detail: string;
+    }[];
+};
+export declare function generateFileInsight(absPath: string, repoRoot: string, apiKey: string, xray: DetailedFileXRay): Promise<FileInsight>;
+//# sourceMappingURL=generateFileInsight.d.ts.map

package/dist/analysis/generateFileInsight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateFileInsight.d.ts","sourceRoot":"","sources":["../../src/analysis/generateFileInsight.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClD,CAAC;AA4DF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,WAAW,CAAC,CAmCtB"}

package/dist/analysis/generateFileInsight.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * generateFileInsight — fast Claude Haiku call for a file's AI description + suggestions.
+ *
+ * Sends a compact STRUCTURED summary (function signatures, call graph, render analysis)
+ * instead of raw source lines. This covers the whole file regardless of size and uses
+ * far fewer tokens than pasting code.
+ *
+ * Results are cached in memory for the lifetime of the server process.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFileInsight = generateFileInsight;
+const anthropic_1 = require("../anthropic");
+// In-memory cache: absolute path → insight
+const cache = new Map();
+function buildStructuredSummary(xray) {
+    const lines = [];
+    lines.push(`File: ${xray.relPath} (${xray.lineCount} lines)`);
+    lines.push(`Type: ${xray.ext}`);
+    lines.push("");
+    // Imports — just the sources, names are noise
+    if (xray.imports.length > 0) {
+        const sources = xray.imports.map(i => i.source).join(", ");
+        lines.push(`Imports: ${sources}`);
+        lines.push("");
+    }
+    lines.push(`Functions (${xray.functions.length}):`);
+    for (const fn of xray.functions) {
+        const loc = fn.lineEnd - fn.lineStart;
+        const tags = [fn.kind];
+        if (fn.isAsync)
+            tags.push("async");
+        if (fn.isExported)
+            tags.push("exported");
+        const calledByCount = fn.calledBy.length;
+        lines.push(`  ${fn.name} [${tags.join(", ")}] L${fn.lineStart}-${fn.lineEnd} (${loc} loc)`);
+        if (fn.params.length > 0) {
+            const p = fn.params.map(p => `${p.name}${p.optional ? "?" : ""}: ${p.type}`).join(", ");
+            lines.push(`    params: ${p}`);
+        }
+        if (fn.returnType && fn.returnType !== "void") {
+            lines.push(`    returns: ${fn.returnType}`);
+        }
+        if (fn.calls.length > 0) {
+            lines.push(`    calls: ${fn.calls.join(", ")}`);
+        }
+        if (calledByCount > 0) {
+            lines.push(`    calledBy: ${fn.calledBy.join(", ")}`);
+        }
+        else if (!fn.isExported && fn.kind === "function") {
+            lines.push(`    calledBy: none (potential dead code)`);
+        }
+        if (fn.externalCalls && fn.externalCalls.length > 0) {
+            lines.push(`    external: ${fn.externalCalls.join(", ")}`);
+        }
+        if (fn.renderAnalysis) {
+            const ra = fn.renderAnalysis;
+            if (ra.stateVars.length > 0)
+                lines.push(`    state: [${ra.stateVars.join(", ")}]`);
+            if (ra.eventsWired.length > 0)
+                lines.push(`    events: ${ra.eventsWired.map(e => `${e.event}(${e.handler})`).join(", ")}`);
+            if (ra.conditionCount > 0)
+                lines.push(`    conditions: ${ra.conditionCount}`);
+            if (ra.renderedElements.length > 0)
+                lines.push(`    renders: ${ra.renderedElements.join(", ")}`);
+        }
+    }
+    return lines.join("\n");
+}
+async function generateFileInsight(absPath, repoRoot, apiKey, xray) {
+    if (cache.has(absPath))
+        return cache.get(absPath);
+    const summary = buildStructuredSummary(xray);
+    const client = (0, anthropic_1.createAnthropicClient)(apiKey);
+    const msg = await client.messages.create({
+        model: "claude-haiku-4-5-20251001",
+        max_tokens: 512,
+        messages: [
+            {
+                role: "user",
+                content: `You are a senior engineer reviewing a codebase. Below is a structured analysis of one file — function signatures, call graph, state, events, external API calls. Use this to give a precise description and actionable suggestions. Respond with JSON only, no markdown.
+
+${summary}
+
+JSON format:
+{
+  "description": "• <what this file does — 1 line>\n• <its architectural role — 1 line>\n• <key dependency or pattern worth knowing — 1 line>",
+  "suggestions": [
+    { "title": "<4-5 words>", "detail": "<specific actionable improvement grounded in the data above, ≤90 chars>" },
+    { "title": "<4-5 words>", "detail": "<specific actionable improvement grounded in the data above, ≤90 chars>" },
+    { "title": "<4-5 words>", "detail": "<specific actionable improvement grounded in the data above, ≤90 chars>" }
+  ]
+}`,
+            },
+        ],
+    });
+    const raw = msg.content[0].type === "text" ? msg.content[0].text.trim() : "{}";
+    const clean = raw.replace(/^```json?\s*/i, "").replace(/```\s*$/, "").trim();
+    const insight = JSON.parse(clean);
+    cache.set(absPath, insight);
+    return insight;
+}
+//# sourceMappingURL=generateFileInsight.js.map

package/dist/analysis/generateFileInsight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateFileInsight.js","sourceRoot":"","sources":["../../src/analysis/generateFileInsight.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAqEH,kDAwCC;AA3GD,4CAAqD;AASrD,2CAA2C;AAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;AAE7C,SAAS,sBAAsB,CAAC,IAAsB;IACpD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,SAAS,SAAS,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,8CAA8C;IAC9C,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC;IAEpD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;QACtC,MAAM,IAAI,GAAa,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,EAAE,CAAC,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,EAAE,CAAC,UAAU;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,aAAa,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QAEzC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,OAAO,KAAK,GAAG,OAAO,CAAC,CAAC;QAE5F,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxF,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;aAAM,IAAI,CAAC,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,EAAE,CAAC,aAAa,IAAI,EAAE,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC;YAC7B,IAAI,EAAE,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;gBAAQ,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzF,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;gBAAM,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/H,IAAI,EAAE,CAAC,cAAc,GAAG,CAAC;gBAAU,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC;YACtF,IAAI,EAAE,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnG,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACvC,OAAe,EACf,QAAgB,EAChB,MAAc,EACd,IAAsB;IAEtB,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;IAEnD,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAA,iCAAqB,EAAC,MAAM,CAAC,CAAC;IAE7C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QACvC,KAAK,EAAE,2BAA2B;QAClC,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;;EAEf,OAAO;;;;;;;;;;EAUP;aACK;SACF;KACF,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAgB,CAAC;IAEjD,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/analysis/llmXRay.d.ts

@@ -0,0 +1,39 @@
+/**
+ * llmXRay — LLM-powered deep analysis of a single source file.
+ *
+ * Produces a structured breakdown:
+ *   - headline: what this file REALLY is (not what the name says)
+ *   - responsibilities: each distinct job the file does, with line ranges + snippets
+ *   - dependencyMap: what each import actually contributes
+ *   - blastRadius: what breaks if this file has a bug
+ *
+ * Results are cached at {repoRoot}/.memor/xray/{hash}.json, invalidated by file mtime.
+ */
+export type LLMXRayResponsibility = {
+    name: string;
+    lineRange: string;
+    snippet: string;
+    what: string;
+    why: string;
+    gotcha?: string;
+};
+export type LLMXRayDep = {
+    source: string;
+    role: string;
+};
+export type LLMXRayBlastItem = {
+    severity: "critical" | "warning" | "info";
+    bug: string;
+    effect: string;
+};
+export type LLMXRay = {
+    headline: string;
+    realRole: string;
+    responsibilities: LLMXRayResponsibility[];
+    dependencyMap: LLMXRayDep[];
+    blastRadius: LLMXRayBlastItem[];
+    generatedAt: string;
+    fileMtime: number;
+};
+export declare function generateLLMXRay(absPath: string, repoRoot: string, apiKey?: string): Promise<LLMXRay>;
+//# sourceMappingURL=llmXRay.d.ts.map

package/dist/analysis/llmXRay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmXRay.d.ts","sourceRoot":"","sources":["../../src/analysis/llmXRay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;IAC1C,aAAa,EAAE,UAAU,EAAE,CAAC;IAC5B,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAmGF,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAyElB"}