memor-code-cli 0.2.0

package/dist/scanner/detectOutbound.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectOutboundInSource = detectOutboundInSource;
+/**
+ * detectOutbound — find where a file SENDS data: outbound HTTP client calls.
+ *
+ * The mirror of detectRoutes. Where route detection answers "what triggers this code"
+ * (inbound), this answers "where does this code send its output" (outbound) — the fact
+ * a *producer* repo lives on. Recognizes the common clients:
+ *   axios({ url: `${base}/v1/executions/batch`, method: "POST" })
+ *   axios.post(`${base}/v1/tests`, body)
+ *   fetch(`${base}/v1/x`, { method: "PUT" })   ·   got(url, { method })
+ *
+ * URLs are usually template literals (`${baseUrl}/v1/...`); we keep the static path
+ * (drop the interpolated host and any query string) — deterministic, no guessing.
+ */
+const parser_1 = require("@babel/parser");
+const traverse_1 = __importDefault(require("@babel/traverse"));
+const CLIENTS = new Set(["axios", "fetch", "got", "ky", "superagent", "request", "http", "https"]);
+const METHOD_PROPS = new Set(["get", "post", "put", "patch", "delete", "head", "options"]);
+function pathFromUrlNode(node) {
+    if (!node)
+        return undefined;
+    let raw;
+    if (node.type === "StringLiteral")
+        raw = node.value;
+    else if (node.type === "TemplateLiteral")
+        raw = node.quasis.map((q) => q.value?.cooked ?? "").join("");
+    if (raw === undefined)
+        return undefined;
+    let p = raw.split("?")[0].replace(/\/{2,}/g, "/").replace(/\s+/g, "");
+    if (!p.includes("/"))
+        return undefined; // not a URL path
+    if (!/\/[a-zA-Z0-9]/.test(p))
+        return undefined; // empty-ish (e.g. just "${base}")
+    return p;
+}
+function fromObjectConfig(objNode) {
+    const res = {};
+    if (!objNode || objNode.type !== "ObjectExpression")
+        return res;
+    for (const prop of objNode.properties) {
+        if (prop.type !== "ObjectProperty" || !prop.key)
+            continue;
+        const key = prop.key.name ?? prop.key.value;
+        if (key === "url" || key === "uri")
+            res.path = pathFromUrlNode(prop.value);
+        else if (key === "method" && prop.value?.type === "StringLiteral")
+            res.method = prop.value.value.toUpperCase();
+    }
+    return res;
+}
+function detectOutboundInSource(src) {
+    let ast;
+    try {
+        ast = (0, parser_1.parse)(src, { sourceType: "module", plugins: ["typescript", "jsx", "decorators-legacy"] });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    const add = (method, path) => {
+        if (!path)
+            return;
+        if (!out.some(o => o.method === (method ?? "") && o.path === path))
+            out.push({ method: method ?? "", path });
+    };
+    (0, traverse_1.default)(ast, {
+        CallExpression(p) {
+            const callee = p.node.callee;
+            const args = p.node.arguments ?? [];
+            // <client>.<method>(url, ...)  e.g. axios.post(`${b}/v1/tests`, body)
+            if (callee?.type === "MemberExpression" && callee.object?.type === "Identifier" && callee.property?.type === "Identifier") {
+                const obj = callee.object.name, meth = callee.property.name.toLowerCase();
+                if (CLIENTS.has(obj) && METHOD_PROPS.has(meth)) {
+                    add(meth.toUpperCase(), pathFromUrlNode(args[0]));
+                    return;
+                }
+            }
+            // <client>(config)  e.g. axios({ url, method })   OR   <client>(url, opts)  e.g. fetch(url, { method })
+            if (callee?.type === "Identifier" && CLIENTS.has(callee.name)) {
+                const cfg = args.find((a) => a?.type === "ObjectExpression");
+                const fromCfg = fromObjectConfig(cfg);
+                if (fromCfg.path) {
+                    add(fromCfg.method, fromCfg.path);
+                    return;
+                }
+                const url = pathFromUrlNode(args[0]);
+                if (url) {
+                    add(fromObjectConfig(args[1]).method, url);
+                    return;
+                }
+            }
+        },
+    });
+    return out;
+}
+//# sourceMappingURL=detectOutbound.js.map

package/dist/scanner/detectOutbound.js.map

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

package/dist/scanner/detectRepoPurpose.d.ts

@@ -0,0 +1,19 @@
+export type RepoPurposeKind = "storybook-component-library" | "e2e-testing-suite" | "design-system" | "ui-component-library" | "api-backend" | "full-stack-app" | "developer-tooling" | "documentation-site" | "unknown";
+export type RepoPurposeSignal = {
+    /** Short human-readable description of the signal */
+    label: string;
+    /** What was found (file path, dependency name, script name) */
+    evidence: string;
+    /** 0–100, higher = stronger signal */
+    weight: number;
+};
+export type InferredRepoPurpose = {
+    kind: RepoPurposeKind;
+    /** Human-readable label shown in UI */
+    label: string;
+    confidence: "high" | "medium" | "low";
+    /** Every signal that contributed to this conclusion */
+    signals: RepoPurposeSignal[];
+};
+export declare function detectRepoPurpose(rootPath: string): Promise<InferredRepoPurpose>;
+//# sourceMappingURL=detectRepoPurpose.d.ts.map

package/dist/scanner/detectRepoPurpose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectRepoPurpose.d.ts","sourceRoot":"","sources":["../../src/scanner/detectRepoPurpose.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,eAAe,GACvB,6BAA6B,GAC7B,mBAAmB,GACnB,eAAe,GACf,sBAAsB,GACtB,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,oBAAoB,GACpB,SAAS,CAAC;AAEd,MAAM,MAAM,iBAAiB,GAAG;IAC9B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,uDAAuD;IACvD,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B,CAAC;AAsDF,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAyQ9B"}

package/dist/scanner/detectRepoPurpose.js

@@ -0,0 +1,335 @@
+"use strict";
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectRepoPurpose = detectRepoPurpose;
+/**
+ * detectRepoPurpose — deterministic repo purpose detection.
+ *
+ * Uses only structural signals: file type density, config files,
+ * package.json scripts/dependencies, directory names.
+ * Never guesses. Never uses LLM. Every conclusion traces to evidence.
+ */
+const promises_1 = __importDefault(require("fs/promises"));
+const path = __importStar(require("path"));
+// ── Helpers ───────────────────────────────────────────────────────────
+async function fileExists(p) {
+    try {
+        await promises_1.default.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readJsonSafe(p) {
+    try {
+        const raw = await promises_1.default.readFile(p, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Recursively count files matching a predicate, skipping heavy dirs.
+ * Returns early once limit is reached for speed.
+ */
+const SKIP = new Set([
+    "node_modules", ".git", "dist", "build", "out", ".next", ".turbo",
+    "coverage", "__pycache__", ".cache", "storybook-static",
+]);
+async function countFiles(dir, predicate, limit = 2000) {
+    let count = 0;
+    async function walk(current) {
+        if (count >= limit)
+            return;
+        let entries;
+        try {
+            entries = await promises_1.default.readdir(current, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (count >= limit)
+                return;
+            if (e.isDirectory()) {
+                if (!SKIP.has(e.name) && !e.name.startsWith("."))
+                    await walk(path.join(current, e.name));
+            }
+            else if (predicate(e.name)) {
+                count++;
+            }
+        }
+    }
+    await walk(dir);
+    return count;
+}
+async function totalSourceFiles(dir) {
+    return countFiles(dir, (n) => /\.(jsx?|tsx?|mjs|cjs)$/.test(n));
+}
+// ── Main detector ─────────────────────────────────────────────────────
+async function detectRepoPurpose(rootPath) {
+    const signals = [];
+    const scores = {};
+    function add(kind, signal) {
+        signals.push(signal);
+        scores[kind] = (scores[kind] ?? 0) + signal.weight;
+    }
+    // ── 1. package.json scripts and dependencies ──────────────────────
+    const pkgPath = path.join(rootPath, "package.json");
+    const pkg = await readJsonSafe(pkgPath);
+    const scripts = (pkg?.scripts ?? {});
+    const deps = {
+        ...(pkg?.dependencies ?? {}),
+        ...(pkg?.devDependencies ?? {}),
+    };
+    const depNames = Object.keys(deps);
+    const scriptNames = Object.keys(scripts);
+    // Storybook scripts
+    if (scriptNames.some((s) => /storybook/.test(s))) {
+        add("storybook-component-library", {
+            label: "storybook script in package.json",
+            evidence: `scripts.${scriptNames.find((s) => /storybook/.test(s))}`,
+            weight: 30,
+        });
+    }
+    // Storybook devDeps
+    const sbDeps = depNames.filter((d) => d.includes("@storybook/") || d === "storybook");
+    if (sbDeps.length >= 2) {
+        add("storybook-component-library", {
+            label: `${sbDeps.length} Storybook packages in dependencies`,
+            evidence: sbDeps.slice(0, 3).join(", "),
+            weight: 30,
+        });
+    }
+    else if (sbDeps.length === 1) {
+        add("storybook-component-library", {
+            label: "Storybook dependency",
+            evidence: sbDeps[0],
+            weight: 15,
+        });
+    }
+    // Cypress deps/scripts
+    const cyDeps = depNames.filter((d) => /cypress/.test(d));
+    const cyScripts = scriptNames.filter((s) => /cypress|e2e/.test(s));
+    if (cyDeps.length > 0 || cyScripts.length > 0) {
+        const ev = [...cyDeps, ...cyScripts][0];
+        add("e2e-testing-suite", {
+            label: "Cypress in dependencies or scripts",
+            evidence: ev,
+            weight: 40,
+        });
+    }
+    // Playwright
+    const pwDeps = depNames.filter((d) => /playwright/.test(d));
+    if (pwDeps.length > 0) {
+        add("e2e-testing-suite", {
+            label: "Playwright in dependencies",
+            evidence: pwDeps[0],
+            weight: 40,
+        });
+    }
+    // Design token / design-system signals
+    const dsDeps = depNames.filter((d) => /style-dictionary|theo|@tokens-studio|design-tokens|figma-tokens/.test(d));
+    if (dsDeps.length > 0) {
+        add("design-system", {
+            label: "Design token tooling detected",
+            evidence: dsDeps[0],
+            weight: 25,
+        });
+    }
+    // API-backend signals from scripts
+    if (scriptNames.some((s) => /^start(:server)?$/.test(s)) &&
+        depNames.some((d) => /express|fastify|koa|nestjs|hono/.test(d))) {
+        add("api-backend", {
+            label: "Server framework + start script",
+            evidence: depNames.find((d) => /express|fastify|koa|nestjs|hono/.test(d)) ?? "server",
+            weight: 35,
+        });
+    }
+    // Docs signals
+    if (depNames.some((d) => /docusaurus|nextra|vuepress|docus|starlight/.test(d))) {
+        const ev = depNames.find((d) => /docusaurus|nextra|vuepress|docus|starlight/.test(d));
+        add("documentation-site", { label: "Documentation framework", evidence: ev, weight: 45 });
+    }
+    // Tooling signals
+    const isCLI = depNames.some((d) => /commander|yargs|meow|cleye/.test(d)) ||
+        scriptNames.some((s) => /^(bin|cli)$/.test(s));
+    if (isCLI) {
+        const ev = depNames.find((d) => /commander|yargs|meow|cleye/.test(d)) ?? "bin script";
+        add("developer-tooling", { label: "CLI tooling detected", evidence: ev, weight: 30 });
+    }
+    // ── 2. Config file presence ────────────────────────────────────────
+    // Storybook config dir
+    if (await fileExists(path.join(rootPath, ".storybook"))) {
+        add("storybook-component-library", {
+            label: ".storybook/ config directory",
+            evidence: ".storybook/",
+            weight: 35,
+        });
+        // Also consider design-system if storybook exists alongside UI deps
+        if (sbDeps.length > 0) {
+            add("design-system", {
+                label: ".storybook/ with Storybook deps",
+                evidence: ".storybook/",
+                weight: 10,
+            });
+        }
+    }
+    // Cypress config
+    const cyConfigs = ["cypress.config.ts", "cypress.config.js", "cypress.config.mjs", "cypress.json"];
+    for (const cf of cyConfigs) {
+        if (await fileExists(path.join(rootPath, cf))) {
+            add("e2e-testing-suite", {
+                label: "Cypress config file",
+                evidence: cf,
+                weight: 40,
+            });
+            break;
+        }
+    }
+    // Playwright config
+    const pwConfigs = ["playwright.config.ts", "playwright.config.js"];
+    for (const cf of pwConfigs) {
+        if (await fileExists(path.join(rootPath, cf))) {
+            add("e2e-testing-suite", {
+                label: "Playwright config file",
+                evidence: cf,
+                weight: 40,
+            });
+            break;
+        }
+    }
+    // ── 3. File density signals ────────────────────────────────────────
+    const [storyCount, totalCount] = await Promise.all([
+        countFiles(rootPath, (n) => /\.stories\.(jsx?|tsx?|mdx)$/.test(n)),
+        totalSourceFiles(rootPath),
+    ]);
+    if (storyCount > 0 && totalCount > 0) {
+        const storyRatio = storyCount / totalCount;
+        if (storyCount >= 20) {
+            const weight = storyCount >= 100 ? 50 : storyCount >= 20 ? 35 : 20;
+            add("storybook-component-library", {
+                label: `${storyCount} .stories files (${Math.round(storyRatio * 100)}% of source)`,
+                evidence: `${storyCount} .stories.* files`,
+                weight,
+            });
+        }
+        // High story ratio also hints at design-system
+        if (storyRatio > 0.3 && storyCount >= 30) {
+            add("design-system", {
+                label: "High story density suggests design system",
+                evidence: `${storyCount} stories / ${totalCount} source files`,
+                weight: 15,
+            });
+        }
+    }
+    // Cypress spec files — only .cy.* extensions are unambiguously Cypress.
+    // .spec.ts/.spec.js are Vitest/Jest unit tests in most codebases — do NOT count them.
+    const specCount = await countFiles(rootPath, (n) => /\.cy\.(jsx?|tsx?)$/.test(n), 500);
+    if (specCount >= 5) {
+        add("e2e-testing-suite", {
+            label: `${specCount} .cy.* Cypress test files`,
+            evidence: `${specCount} .cy.* files`,
+            weight: specCount >= 30 ? 40 : 25,
+        });
+    }
+    // ── 4. Directory pattern signals ───────────────────────────────────
+    const dirsToCheck = [
+        { dir: "cypress", kind: "e2e-testing-suite", label: "cypress/ directory", weight: 35 },
+        { dir: "e2e", kind: "e2e-testing-suite", label: "e2e/ directory", weight: 25 },
+        { dir: "playwright", kind: "e2e-testing-suite", label: "playwright/ directory", weight: 30 },
+        { dir: "tokens", kind: "design-system", label: "tokens/ design token directory", weight: 20 },
+        { dir: "primitives", kind: "design-system", label: "primitives/ directory (design system pattern)", weight: 15 },
+    ];
+    await Promise.all(dirsToCheck.map(async ({ dir, kind, label, weight }) => {
+        if (await fileExists(path.join(rootPath, dir))) {
+            add(kind, { label, evidence: `${dir}/`, weight });
+        }
+    }));
+    // ── 5. Determine winner ────────────────────────────────────────────
+    const ranked = Object.entries(scores)
+        .sort((a, b) => b[1] - a[1]);
+    const topKind = ranked[0]?.[0] ?? "unknown";
+    const topScore = ranked[0]?.[1] ?? 0;
+    const secondScore = ranked[1]?.[1] ?? 0;
+    // Resolve storybook vs design-system: if both are high, check design-system-specific signals
+    let kind = topKind;
+    if (topKind === "storybook-component-library" || topKind === "design-system") {
+        const dsScore = scores["design-system"] ?? 0;
+        const sbScore = scores["storybook-component-library"] ?? 0;
+        const hasDesignSystemSignals = signals.some((s) => /token|figma|primitives|design system/.test(s.label.toLowerCase()));
+        kind = (dsScore >= 35 && hasDesignSystemSignals) ? "design-system" : "storybook-component-library";
+    }
+    // Confidence
+    const margin = topScore - secondScore;
+    let confidence = topScore >= 70 && margin >= 30 ? "high" :
+        topScore >= 40 ? "medium" :
+            topScore > 0 ? "low" : "low";
+    // Guard: e2e-testing-suite requires a config file to reach medium/high confidence.
+    // A playwright/cypress dep in devDeps alone is not proof the repo IS a test suite —
+    // frameworks and products use these tools for their own tests.
+    // Without playwright.config.* or cypress.config.* at root, cap at low.
+    if (kind === "e2e-testing-suite" && confidence !== "low") {
+        const hasE2eConfig = signals.some((s) => /config file/.test(s.label.toLowerCase()) &&
+            /(playwright|cypress)/.test(s.evidence.toLowerCase()));
+        if (!hasE2eConfig) {
+            confidence = "low";
+        }
+    }
+    // Label
+    const LABELS = {
+        "storybook-component-library": "Component library powered by Storybook",
+        "e2e-testing-suite": "End-to-end test suite",
+        "design-system": "Design system with component library",
+        "ui-component-library": "UI component library",
+        "api-backend": "API backend service",
+        "full-stack-app": "Full-stack application",
+        "developer-tooling": "Developer tooling / CLI",
+        "documentation-site": "Documentation site",
+        "unknown": "General-purpose codebase",
+    };
+    return {
+        kind: topScore === 0 ? "unknown" : kind,
+        label: LABELS[kind],
+        confidence,
+        signals: signals.sort((a, b) => b.weight - a.weight),
+    };
+}
+//# sourceMappingURL=detectRepoPurpose.js.map

package/dist/scanner/detectRepoPurpose.js.map

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

package/dist/scanner/detectRoutes.d.ts

@@ -0,0 +1,22 @@
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | "ALL" | "USE";
+export type DetectedRoute = {
+    method: HttpMethod;
+    /** Route path as written in code, e.g. '/api/users/:id' */
+    path: string;
+    /** Relative path from system root to the file containing this registration */
+    file: string;
+    /** 1-based line number */
+    line: number;
+    /** Named handler function / method if identifiable */
+    handlerName?: string;
+    /** Framework this was detected from */
+    framework: "express" | "fastify" | "nestjs" | "hono" | "koa" | "unknown";
+    /** 0–1 */
+    confidence: number;
+};
+/**
+ * Scan all source files in systemRoot and return every detected HTTP route.
+ * Each result includes file + line so every claim is traceable.
+ */
+export declare function detectRoutes(systemAbsRoot: string): Promise<DetectedRoute[]>;
+//# sourceMappingURL=detectRoutes.d.ts.map

package/dist/scanner/detectRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectRoutes.d.ts","sourceRoot":"","sources":["../../src/scanner/detectRoutes.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,UAAU,GAClB,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAC3C,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvC,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IACzE,UAAU;IACV,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AA4WF;;;GAGG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAoBlF"}