memor-code-cli 0.2.0

package/dist/graph/walkExports.js

@@ -0,0 +1,172 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.walkExports = walkExports;
+/**
+ * walkExports — parse a single JS/TS source file and return all exported identifiers.
+ * Uses @babel/parser (same as walkImports) for accurate AST parsing.
+ *
+ * Extracts:
+ *   export function foo()         → "foo"
+ *   export const bar = ...        → "bar"
+ *   export class Baz              → "Baz"
+ *   export type X = ...           → "X"
+ *   export interface Y            → "Y"
+ *   export enum Z                 → "Z"
+ *   export { a, b } from './x'   → "a", "b"
+ *   export default class Foo      → "Foo"
+ *   export default function foo   → "foo"
+ */
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const parser_1 = require("@babel/parser");
+const PARSEABLE_EXTS = new Set([".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs"]);
+const MAX_FILE_SIZE = 512_000;
+function extractIdentifier(node) {
+    if (!node || typeof node !== "object")
+        return null;
+    const n = node;
+    if (n["type"] === "Identifier" && typeof n["name"] === "string")
+        return n["name"];
+    return null;
+}
+function collectExportNames(node, result) {
+    if (!node || typeof node !== "object")
+        return;
+    const n = node;
+    const t = n["type"];
+    // export function foo / export class Foo / export const bar
+    if (t === "ExportNamedDeclaration") {
+        const decl = n["declaration"];
+        if (decl) {
+            const dt = decl["type"];
+            // export function foo / export class Foo / export enum Foo
+            if (dt === "FunctionDeclaration" ||
+                dt === "ClassDeclaration" ||
+                dt === "TSEnumDeclaration" ||
+                dt === "TSInterfaceDeclaration") {
+                const id = extractIdentifier(decl["id"]);
+                if (id)
+                    result.add(id);
+            }
+            // export type Foo = ... / export interface Foo
+            if (dt === "TSTypeAliasDeclaration") {
+                const id = extractIdentifier(decl["id"]);
+                if (id)
+                    result.add(id);
+            }
+            // export const foo = ... / export let bar = ...
+            if (dt === "VariableDeclaration") {
+                const declarations = decl["declarations"] ?? [];
+                for (const d of declarations) {
+                    const id = extractIdentifier(d["id"]);
+                    if (id)
+                        result.add(id);
+                }
+            }
+        }
+        // export { a, b } or export { a as b }
+        const specifiers = n["specifiers"] ?? [];
+        for (const spec of specifiers) {
+            // Use exported name (not local name)
+            const exported = extractIdentifier(spec["exported"]);
+            if (exported && exported !== "default")
+                result.add(exported);
+        }
+        return;
+    }
+    // export default class Foo / export default function foo
+    if (t === "ExportDefaultDeclaration") {
+        const decl = n["declaration"];
+        if (decl) {
+            const id = extractIdentifier(decl["id"]);
+            if (id)
+                result.add(id);
+        }
+        return;
+    }
+    // Recurse into children (only top-level program body needed)
+    for (const key of Object.keys(n)) {
+        if (key === "loc" || key === "start" || key === "end" || key === "extra")
+            continue;
+        const child = n[key];
+        if (Array.isArray(child)) {
+            for (const item of child)
+                collectExportNames(item, result);
+        }
+        else if (child && typeof child === "object" && "type" in child) {
+            collectExportNames(child, result);
+        }
+    }
+}
+async function walkExports(absoluteFilePath) {
+    const ext = path.extname(absoluteFilePath).toLowerCase();
+    if (!PARSEABLE_EXTS.has(ext))
+        return [];
+    let source;
+    try {
+        const stat = await fs.stat(absoluteFilePath);
+        if (stat.size > MAX_FILE_SIZE)
+            return [];
+        source = await fs.readFile(absoluteFilePath, "utf8");
+    }
+    catch {
+        return [];
+    }
+    let ast;
+    try {
+        ast = (0, parser_1.parse)(source, {
+            sourceType: "module",
+            plugins: ["typescript", "jsx", "decorators-legacy"],
+            errorRecovery: true,
+        });
+    }
+    catch {
+        try {
+            ast = (0, parser_1.parse)(source, {
+                sourceType: "unambiguous",
+                plugins: ["jsx"],
+                errorRecovery: true,
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    const result = new Set();
+    collectExportNames(ast.program, result);
+    return [...result];
+}
+//# sourceMappingURL=walkExports.js.map

package/dist/graph/walkExports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walkExports.js","sourceRoot":"","sources":["../../src/graph/walkExports.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqGA,kCAmCC;AAxID;;;;;;;;;;;;;;GAcG;AACH,gDAAkC;AAClC,2CAA6B;AAC7B,0CAAsC;AAEtC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC/E,MAAM,aAAa,GAAG,OAAO,CAAC;AAI9B,SAAS,iBAAiB,CAAC,IAAa;IACtC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,CAAC,GAAG,IAAe,CAAC;IAC1B,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,YAAY,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAa,EAAE,MAAmB;IAC5D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO;IAC9C,MAAM,CAAC,GAAG,IAAe,CAAC;IAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAuB,CAAC;IAE1C,4DAA4D;IAC5D,IAAI,CAAC,KAAK,wBAAwB,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,CAAC,aAAa,CAAwB,CAAC;QACrD,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAuB,CAAC;YAE9C,2DAA2D;YAC3D,IACE,EAAE,KAAK,qBAAqB;gBAC5B,EAAE,KAAK,kBAAkB;gBACzB,EAAE,KAAK,mBAAmB;gBAC1B,EAAE,KAAK,wBAAwB,EAC/B,CAAC;gBACD,MAAM,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBACzC,IAAI,EAAE;oBAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC;YAED,+CAA+C;YAC/C,IAAI,EAAE,KAAK,wBAAwB,EAAE,CAAC;gBACpC,MAAM,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBACzC,IAAI,EAAE;oBAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC;YAED,gDAAgD;YAChD,IAAI,EAAE,KAAK,qBAAqB,EAAE,CAAC;gBACjC,MAAM,YAAY,GAAI,IAAI,CAAC,cAAc,CAAe,IAAI,EAAE,CAAC;gBAC/D,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;oBAC7B,MAAM,EAAE,GAAG,iBAAiB,CAAE,CAAa,CAAC,IAAI,CAAC,CAAC,CAAC;oBACnD,IAAI,EAAE;wBAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,MAAM,UAAU,GAAI,CAAC,CAAC,YAAY,CAAe,IAAI,EAAE,CAAC;QACxD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,qCAAqC;YACrC,MAAM,QAAQ,GAAG,iBAAiB,CAAE,IAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;YAClE,IAAI,QAAQ,IAAI,QAAQ,KAAK,SAAS;gBAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO;IACT,CAAC;IAED,yDAAyD;IACzD,IAAI,CAAC,KAAK,0BAA0B,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,CAAC,CAAC,aAAa,CAAwB,CAAC;QACrD,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAY,CAAC,CAAC;YACpD,IAAI,EAAE;gBAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QACD,OAAO;IACT,CAAC;IAED,6DAA6D;IAC7D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO;YAAE,SAAS;QACnF,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC;aAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAK,KAAgB,EAAE,CAAC;YAC7E,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,WAAW,CAAC,gBAAwB;IACxD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC;IACzD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,IAAI,GAAG,aAAa;YAAE,OAAO,EAAE,CAAC;QACzC,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,GAAG,CAAC;IACR,IAAI,CAAC;QACH,GAAG,GAAG,IAAA,cAAK,EAAC,MAAM,EAAE;YAClB,UAAU,EAAE,QAAQ;YACpB,OAAO,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,mBAAmB,CAAC;YACnD,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,GAAG,GAAG,IAAA,cAAK,EAAC,MAAM,EAAE;gBAClB,UAAU,EAAE,aAAa;gBACzB,OAAO,EAAE,CAAC,KAAK,CAAC;gBAChB,aAAa,EAAE,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACrB,CAAC"}

package/dist/heuristics/file-patterns.json

@@ -0,0 +1,325 @@
+{
+    "_meta": {
+        "version": "1.0.0",
+        "scope": "JS/TS ecosystem — file and directory patterns that signal system archetypes",
+        "how": "Each archetype has signals. Each signal has a weight. Signals accumulate. If total >= minScore, archetype is detected.",
+        "signalTypes": {
+            "file-exists": "A specific file exists at this path (relative to system root)",
+            "file-pattern": "Any file matching this glob pattern exists",
+            "dir-exists": "A directory with this name exists anywhere in the system",
+            "dir-at-root": "A directory with this name exists at the system root level",
+            "file-count": "At least N files matching pattern exist",
+            "dep-runtime": "Package is in dependencies{} — use known-packages.json for dep matching",
+            "no-signal": "This signal's ABSENCE increases the score (inverted)"
+        }
+    },
+    "archetypes": {
+        "compiler-framework": {
+            "label": "Compiler / Parser / Transform Framework",
+            "typeHint": "compiler-framework",
+            "minScore": 0.55,
+            "signals": [
+                { "type": "dir-at-root", "name": "compiler", "weight": 0.35, "note": "src/compiler/ or compiler/ at root" },
+                { "type": "dir-at-root", "name": "parse", "weight": 0.30 },
+                { "type": "dir-at-root", "name": "transform", "weight": 0.25 },
+                { "type": "dir-exists", "name": "codegen", "weight": 0.20 },
+                { "type": "dir-exists", "name": "ast", "weight": 0.20 },
+                { "type": "file-pattern", "pattern": "**/compiler.ts", "weight": 0.30 },
+                { "type": "file-pattern", "pattern": "**/parser.ts", "weight": 0.25 },
+                { "type": "file-pattern", "pattern": "**/transform.ts", "weight": 0.20 },
+                { "type": "file-pattern", "pattern": "**/tokenizer.ts", "weight": 0.25 },
+                { "type": "file-pattern", "pattern": "**/lexer.ts", "weight": 0.25 },
+                { "type": "file-pattern", "pattern": "**/codegen.ts", "weight": 0.20 },
+                { "type": "file-count", "pattern": "src/compiler/**/*.ts", "min": 10, "weight": 0.40 },
+                { "type": "file-count", "pattern": "src/**/*.ts", "min": 50, "weight": 0.15, "note": "Large TS surface suggests real framework, not a simple package" }
+            ]
+        },
+        "ui-component-library": {
+            "label": "UI Component Library",
+            "typeHint": "ui-library",
+            "minScore": 0.50,
+            "signals": [
+                { "type": "dir-exists", "name": "components", "weight": 0.20 },
+                { "type": "dir-at-root", "name": "packages", "weight": 0.15 },
+                { "type": "file-count", "pattern": "**/*.stories.tsx", "min": 5, "weight": 0.30 },
+                { "type": "file-count", "pattern": "**/*.stories.jsx", "min": 5, "weight": 0.30 },
+                { "type": "file-count", "pattern": "**/*.stories.ts", "min": 5, "weight": 0.25 },
+                { "type": "file-count", "pattern": "**/index.ts", "min": 10, "weight": 0.15, "note": "Many index.ts = many exported components" },
+                { "type": "dir-exists", "name": "primitives", "weight": 0.20, "note": "Radix-style primitive dir" },
+                { "type": "dir-exists", "name": "tokens", "weight": 0.15 },
+                { "type": "file-exists", "path": ".storybook/main.ts", "weight": 0.25 },
+                { "type": "file-exists", "path": ".storybook/main.js", "weight": 0.25 },
+                { "type": "no-signal", "signal": "has-entry-point-main-tsx", "weight": 0.10, "note": "No src/main.tsx = not a runnable app, more likely a library" }
+            ]
+        },
+        "design-system": {
+            "label": "Design System with Component Library",
+            "typeHint": "design-system",
+            "minScore": 0.60,
+            "signals": [
+                { "type": "dir-exists", "name": "tokens", "weight": 0.30 },
+                { "type": "dir-exists", "name": "foundations", "weight": 0.20 },
+                { "type": "dir-exists", "name": "primitives", "weight": 0.20 },
+                { "type": "file-pattern", "pattern": "**/design-tokens*", "weight": 0.30 },
+                { "type": "file-pattern", "pattern": "**/tokens.json", "weight": 0.25 },
+                { "type": "file-count", "pattern": "**/*.stories.*", "min": 20, "weight": 0.25 },
+                { "type": "file-exists", "path": "style-dictionary.config.js", "weight": 0.35 },
+                { "type": "file-exists", "path": "style-dictionary.config.ts", "weight": 0.35 },
+                { "type": "file-exists", "path": ".storybook/main.ts", "weight": 0.15 }
+            ]
+        },
+        "e2e-test-suite": {
+            "label": "End-to-End Test Suite",
+            "typeHint": "e2e-testing-suite",
+            "minScore": 0.55,
+            "signals": [
+                { "type": "dir-at-root", "name": "cypress", "weight": 0.40 },
+                { "type": "dir-at-root", "name": "e2e", "weight": 0.30 },
+                { "type": "dir-at-root", "name": "playwright", "weight": 0.35 },
+                { "type": "file-exists", "path": "cypress.config.ts", "weight": 0.45 },
+                { "type": "file-exists", "path": "cypress.config.js", "weight": 0.45 },
+                { "type": "file-exists", "path": "playwright.config.ts", "weight": 0.45 },
+                { "type": "file-exists", "path": "playwright.config.js", "weight": 0.45 },
+                { "type": "file-count", "pattern": "**/*.cy.ts", "min": 5, "weight": 0.40, "note": ".cy.* files are unambiguously Cypress — .spec.* are NOT" },
+                { "type": "file-count", "pattern": "**/*.cy.tsx", "min": 5, "weight": 0.40 },
+                { "type": "file-count", "pattern": "**/*.cy.js", "min": 5, "weight": 0.35 },
+                { "type": "file-count", "pattern": "**/*.spec.ts", "min": 50, "weight": 0.10, "note": ".spec.ts is weak — could be Vitest. Only count if very high and combined with other e2e signals" }
+            ]
+        },
+        "storybook-component-library": {
+            "label": "Component Library Powered by Storybook",
+            "typeHint": "storybook-component-library",
+            "minScore": 0.55,
+            "signals": [
+                { "type": "file-exists", "path": ".storybook/main.ts", "weight": 0.40 },
+                { "type": "file-exists", "path": ".storybook/main.js", "weight": 0.40 },
+                { "type": "dir-exists", "name": ".storybook", "weight": 0.30 },
+                { "type": "file-count", "pattern": "**/*.stories.tsx", "min": 3, "weight": 0.35 },
+                { "type": "file-count", "pattern": "**/*.stories.jsx", "min": 3, "weight": 0.35 },
+                { "type": "file-count", "pattern": "**/*.stories.tsx", "min": 20, "weight": 0.20, "note": "Extra weight for high story count" },
+                { "type": "file-count", "pattern": "**/*.stories.mdx", "min": 5, "weight": 0.25 }
+            ]
+        },
+        "next-app": {
+            "label": "Next.js Application",
+            "typeHint": "web-app",
+            "minScore": 0.55,
+            "signals": [
+                { "type": "file-exists", "path": "next.config.js", "weight": 0.55 },
+                { "type": "file-exists", "path": "next.config.ts", "weight": 0.55 },
+                { "type": "file-exists", "path": "next.config.mjs", "weight": 0.55 },
+                { "type": "dir-at-root", "name": "app", "weight": 0.30, "note": "App Router — but 'app/' dir alone is not enough" },
+                { "type": "dir-at-root", "name": "pages", "weight": 0.30, "note": "Pages Router" },
+                { "type": "file-pattern", "pattern": "app/**/page.tsx", "weight": 0.40 },
+                { "type": "file-pattern", "pattern": "app/**/page.jsx", "weight": 0.40 },
+                { "type": "file-pattern", "pattern": "pages/_app.tsx", "weight": 0.45 },
+                { "type": "file-pattern", "pattern": "pages/_app.jsx", "weight": 0.45 },
+                { "type": "file-pattern", "pattern": "pages/index.tsx", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "src/app/**/page.tsx", "weight": 0.40 }
+            ]
+        },
+        "vite-spa": {
+            "label": "Vite SPA / Frontend App",
+            "typeHint": "web-app",
+            "minScore": 0.60,
+            "signals": [
+                { "type": "file-exists", "path": "vite.config.ts", "weight": 0.30 },
+                { "type": "file-exists", "path": "vite.config.js", "weight": 0.30 },
+                { "type": "file-exists", "path": "index.html", "weight": 0.40, "note": "Vite needs an HTML shell" },
+                { "type": "file-exists", "path": "src/index.html", "weight": 0.35 },
+                { "type": "file-exists", "path": "src/main.tsx", "weight": 0.45 },
+                { "type": "file-exists", "path": "src/main.jsx", "weight": 0.45 },
+                { "type": "file-exists", "path": "src/main.ts", "weight": 0.35 },
+                { "type": "file-exists", "path": "src/App.tsx", "weight": 0.30 },
+                { "type": "file-exists", "path": "src/App.jsx", "weight": 0.30 }
+            ]
+        },
+        "nestjs-api": {
+            "label": "NestJS API Service",
+            "typeHint": "api-service",
+            "minScore": 0.55,
+            "signals": [
+                { "type": "file-exists", "path": "nest-cli.json", "weight": 0.60 },
+                { "type": "file-pattern", "pattern": "src/app.module.ts", "weight": 0.50 },
+                { "type": "file-pattern", "pattern": "src/main.ts", "weight": 0.20 },
+                { "type": "dir-exists", "name": "controllers", "weight": 0.25 },
+                { "type": "dir-exists", "name": "modules", "weight": 0.20 },
+                { "type": "file-pattern", "pattern": "**/*.controller.ts", "weight": 0.40 },
+                { "type": "file-pattern", "pattern": "**/*.module.ts", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "**/*.service.ts", "weight": 0.20 },
+                { "type": "file-count", "pattern": "**/*.controller.ts", "min": 3, "weight": 0.20 }
+            ]
+        },
+        "express-api": {
+            "label": "Express API Service",
+            "typeHint": "api-service",
+            "minScore": 0.50,
+            "signals": [
+                { "type": "dir-exists", "name": "routes", "weight": 0.30 },
+                { "type": "dir-exists", "name": "controllers", "weight": 0.25 },
+                { "type": "dir-exists", "name": "middleware", "weight": 0.20 },
+                { "type": "file-pattern", "pattern": "src/app.ts", "weight": 0.20 },
+                { "type": "file-pattern", "pattern": "src/server.ts", "weight": 0.25 },
+                { "type": "file-pattern", "pattern": "src/index.ts", "weight": 0.10 },
+                { "type": "file-pattern", "pattern": "routes/*.ts", "weight": 0.30 },
+                { "type": "file-pattern", "pattern": "routes/*.js", "weight": 0.30 }
+            ]
+        },
+        "electron-app": {
+            "label": "Electron Desktop Application",
+            "typeHint": "desktop-app",
+            "minScore": 0.60,
+            "signals": [
+                { "type": "file-pattern", "pattern": "src/main.ts", "weight": 0.15 },
+                { "type": "file-pattern", "pattern": "electron/main.ts", "weight": 0.45 },
+                { "type": "file-pattern", "pattern": "electron/main.js", "weight": 0.45 },
+                { "type": "dir-exists", "name": "electron", "weight": 0.40 },
+                { "type": "file-exists", "path": "electron-builder.yml", "weight": 0.50 },
+                { "type": "file-exists", "path": "electron-builder.json", "weight": 0.50 }
+            ]
+        },
+        "cli-tool": {
+            "label": "CLI / Developer Tool",
+            "typeHint": "developer-tooling",
+            "minScore": 0.50,
+            "signals": [
+                { "type": "dir-at-root", "name": "bin", "weight": 0.35 },
+                { "type": "dir-exists", "name": "commands", "weight": 0.30 },
+                { "type": "file-pattern", "pattern": "bin/*.ts", "weight": 0.40 },
+                { "type": "file-pattern", "pattern": "bin/*.js", "weight": 0.40 },
+                { "type": "file-pattern", "pattern": "bin/*.mjs", "weight": 0.35 },
+                { "type": "file-exists", "path": "src/cli.ts", "weight": 0.35 },
+                { "type": "file-exists", "path": "src/cli.js", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "src/commands/*.ts", "weight": 0.30 }
+            ]
+        },
+        "shared-package": {
+            "label": "Shared Package / Library",
+            "typeHint": "shared-package",
+            "minScore": 0.55,
+            "signals": [
+                { "type": "file-exists", "path": "src/index.ts", "weight": 0.20 },
+                { "type": "file-exists", "path": "src/index.js", "weight": 0.20 },
+                { "type": "file-exists", "path": "index.ts", "weight": 0.15 },
+                { "type": "file-exists", "path": "index.js", "weight": 0.15 },
+                { "type": "dir-at-root", "name": "src", "weight": 0.10 },
+                { "type": "no-signal", "signal": "has-vite-config", "weight": 0.15, "note": "No vite.config = likely not a runnable app" },
+                { "type": "no-signal", "signal": "has-next-config", "weight": 0.15 },
+                { "type": "no-signal", "signal": "has-index-html", "weight": 0.20 }
+            ]
+        },
+        "docs-site": {
+            "label": "Documentation Site",
+            "typeHint": "docs-site",
+            "minScore": 0.60,
+            "signals": [
+                { "type": "file-count", "pattern": "**/*.md", "min": 20, "weight": 0.20 },
+                { "type": "file-count", "pattern": "**/*.mdx", "min": 10, "weight": 0.30 },
+                { "type": "dir-at-root", "name": "docs", "weight": 0.20 },
+                { "type": "dir-at-root", "name": "content", "weight": 0.15 },
+                { "type": "file-exists", "path": "docusaurus.config.js", "weight": 0.55 },
+                { "type": "file-exists", "path": "docusaurus.config.ts", "weight": 0.55 },
+                { "type": "file-exists", "path": ".vitepress/config.ts", "weight": 0.55 },
+                { "type": "file-exists", "path": ".vitepress/config.js", "weight": 0.55 },
+                { "type": "no-signal", "signal": "has-src-dir", "weight": 0.15, "note": "A docs site alongside a large src/ is just project docs, not a docs product" }
+            ]
+        },
+        "worker-service": {
+            "label": "Background Worker / Queue Consumer",
+            "typeHint": "worker",
+            "minScore": 0.50,
+            "signals": [
+                { "type": "dir-at-root", "name": "workers", "weight": 0.35 },
+                { "type": "dir-at-root", "name": "jobs", "weight": 0.30 },
+                { "type": "dir-at-root", "name": "queues", "weight": 0.30 },
+                { "type": "dir-at-root", "name": "consumers", "weight": 0.30 },
+                { "type": "file-pattern", "pattern": "**/*.worker.ts", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "**/*.worker.js", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "src/workers/*.ts", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "src/jobs/*.ts", "weight": 0.30 }
+            ]
+        },
+        "infra-repo": {
+            "label": "Infrastructure Repository",
+            "typeHint": "infra",
+            "minScore": 0.60,
+            "signals": [
+                { "type": "file-exists", "path": "Dockerfile", "weight": 0.40 },
+                { "type": "file-exists", "path": "docker-compose.yml", "weight": 0.40 },
+                { "type": "file-exists", "path": "docker-compose.yaml", "weight": 0.40 },
+                { "type": "dir-at-root", "name": "terraform", "weight": 0.50 },
+                { "type": "dir-at-root", "name": "k8s", "weight": 0.45 },
+                { "type": "dir-at-root", "name": "kubernetes", "weight": 0.45 },
+                { "type": "dir-at-root", "name": "helm", "weight": 0.45 },
+                { "type": "file-pattern", "pattern": "**/*.tf", "weight": 0.50 },
+                { "type": "file-pattern", "pattern": "**/*.tfvars", "weight": 0.45 }
+            ]
+        }
+    },
+    "subsystem-patterns": {
+        "_note": "These patterns identify subsystems WITHIN a system, not the system itself",
+        "auth-subsystem": {
+            "label": "Authentication & Authorization",
+            "signals": [
+                { "type": "dir-exists", "name": "auth", "weight": 0.50 },
+                { "type": "dir-exists", "name": "authentication", "weight": 0.50 },
+                { "type": "dir-exists", "name": "authorization", "weight": 0.45 },
+                { "type": "file-pattern", "pattern": "**/auth/**/*.ts", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "**/*.guard.ts", "weight": 0.30 },
+                { "type": "file-pattern", "pattern": "**/jwt*.ts", "weight": 0.25 },
+                { "type": "file-pattern", "pattern": "**/passport*.ts", "weight": 0.25 }
+            ]
+        },
+        "database-subsystem": {
+            "label": "Database / Data Access",
+            "signals": [
+                { "type": "dir-exists", "name": "db", "weight": 0.40 },
+                { "type": "dir-exists", "name": "database", "weight": 0.40 },
+                { "type": "dir-exists", "name": "migrations", "weight": 0.35 },
+                { "type": "dir-exists", "name": "repositories", "weight": 0.35 },
+                { "type": "file-exists", "path": "prisma/schema.prisma", "weight": 0.50 },
+                { "type": "file-pattern", "pattern": "**/*.repository.ts", "weight": 0.30 },
+                { "type": "file-pattern", "pattern": "**/migrations/*.ts", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "**/migrations/*.sql", "weight": 0.40 }
+            ]
+        },
+        "api-routes-subsystem": {
+            "label": "API Routes / Controllers",
+            "signals": [
+                { "type": "dir-exists", "name": "routes", "weight": 0.40 },
+                { "type": "dir-exists", "name": "controllers", "weight": 0.40 },
+                { "type": "dir-exists", "name": "handlers", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "**/*.controller.ts", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "**/*.router.ts", "weight": 0.30 },
+                { "type": "file-pattern", "pattern": "routes/**/*.ts", "weight": 0.35 }
+            ]
+        },
+        "config-subsystem": {
+            "label": "Configuration",
+            "signals": [
+                { "type": "dir-exists", "name": "config", "weight": 0.40 },
+                { "type": "dir-exists", "name": "configs", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "**/config/*.ts", "weight": 0.25 },
+                { "type": "file-pattern", "pattern": "**/*.config.ts", "weight": 0.15 }
+            ]
+        },
+        "queue-subsystem": {
+            "label": "Queue / Background Jobs",
+            "signals": [
+                { "type": "dir-exists", "name": "queues", "weight": 0.45 },
+                { "type": "dir-exists", "name": "jobs", "weight": 0.40 },
+                { "type": "dir-exists", "name": "workers", "weight": 0.40 },
+                { "type": "file-pattern", "pattern": "**/*.processor.ts", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "**/*.consumer.ts", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "**/*.job.ts", "weight": 0.30 }
+            ]
+        },
+        "feature-module": {
+            "label": "Feature Module",
+            "signals": [
+                { "type": "file-pattern", "pattern": "**/*.module.ts", "weight": 0.35 },
+                { "type": "file-pattern", "pattern": "**/index.ts", "weight": 0.10 }
+            ]
+        }
+    }
+}