memor-code-cli 0.2.0

package/dist/heuristics/loader.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Heuristics loader — reads the JSON knowledge files and exposes typed helpers.
+ *
+ * This is the ONLY file that touches the JSON files.
+ * All detectors import from here, never directly from the JSON files.
+ *
+ * Separation of concerns:
+ *   JSON files  = knowledge (what frameworks exist, what patterns mean what)
+ *   TypeScript  = logic (how to score, combine, and decide)
+ */
+export type PackageDepKind = "runtime" | "dev" | "peer" | "any";
+export type KnownPackageEntry = {
+    framework: string | null;
+    category: string;
+    typeHint: string | null;
+    depKind: PackageDepKind;
+    weight: number;
+    repoSignal?: string;
+    note?: string;
+};
+export type ArchetypeSignal = {
+    type: "file-exists" | "file-pattern" | "dir-exists" | "dir-at-root" | "file-count" | "no-signal";
+    name?: string;
+    path?: string;
+    pattern?: string;
+    signal?: string;
+    min?: number;
+    weight: number;
+    note?: string;
+};
+export type ArchetypeDefinition = {
+    label: string;
+    typeHint: string;
+    minScore: number;
+    signals: ArchetypeSignal[];
+};
+export type ImportanceScores = Record<string, number>;
+export type FlowSuppressionRules = Record<string, string[]>;
+/**
+ * Look up a package by exact name.
+ * Returns null if not found or if the entry is a section separator (string).
+ */
+export declare function getPackageInfo(name: string): KnownPackageEntry | null;
+/**
+ * Check if a package name is a known framework dep, filtered by dep kind.
+ *
+ * @param name - exact package name
+ * @param actualDepKind - where it appears in the consuming package.json
+ *   "runtime" = in dependencies{}
+ *   "dev"     = in devDependencies{}
+ *   "peer"    = in peerDependencies{}
+ */
+export declare function isKnownFrameworkDep(name: string, actualDepKind: "runtime" | "dev" | "peer"): boolean;
+/**
+ * Get the typeHint for a package, respecting depKind rules.
+ * Returns null if the package should not produce a typeHint in this context.
+ */
+export declare function getTypeHintForPackage(name: string, actualDepKind: "runtime" | "dev" | "peer"): string | null;
+/**
+ * Get the signal weight for a package, or 0 if not applicable.
+ */
+export declare function getPackageWeight(name: string, actualDepKind: "runtime" | "dev" | "peer"): number;
+/**
+ * Get the framework display name for a package.
+ * Used for tech badge labels on canvas nodes.
+ */
+export declare function getFrameworkLabel(name: string): string | null;
+/**
+ * Check if a package is a monorepo signal (turbo, nx, lerna, etc.)
+ */
+export declare function isMonorepoToolDep(name: string): boolean;
+/**
+ * Resolve all known framework labels from a list of dep names.
+ * Deduplicates by framework name.
+ * Used to build the `detectedTech` array for a system.
+ */
+export declare function resolveFrameworkLabels(runtimeDeps: string[], devDeps: string[], peerDeps: string[]): string[];
+export declare function getArchetypeDefinition(name: string): ArchetypeDefinition | null;
+export declare function getAllArchetypes(): Record<string, ArchetypeDefinition>;
+export declare function getAllSubsystemPatterns(): Record<string, ArchetypeDefinition>;
+/**
+ * Get the base importance score for a system type.
+ * Used by systemRanking.ts to determine canvas node prominence.
+ */
+export declare function getBaseImportanceScore(systemType: string): number;
+/**
+ * Get the bonus added when a system is detected as the repo center.
+ */
+export declare function getRepoCenterBonus(role: "is-repo-center" | "is-most-depended-on" | "is-entry-system"): number;
+/**
+ * Get the flow families that should be suppressed for a given repo mode.
+ * Prevents boilerplate flow templates on framework/library repos.
+ */
+export declare function getSuppressedFlowFamilies(repoMode: string): string[];
+/**
+ * Check if a flow family should be suppressed for the given repo mode.
+ */
+export declare function shouldSuppressFlowFamily(repoMode: string, family: string): boolean;
+/**
+ * Get all repo mode definitions.
+ */
+export declare function getAllRepoModes(): Record<string, {
+    label: string;
+    description: string;
+    minScore: number;
+    signals: Array<{
+        label: string;
+        weight: number;
+    }>;
+    incidental_runnables?: {
+        description: string;
+        rule: string;
+    };
+    importanceNote?: string;
+}>;
+/**
+ * Everything a detector needs to classify a system from its package.json deps.
+ * Returns a map of typeHint → accumulated weight from all matching deps.
+ */
+export declare function scoreTypeHintsFromDeps(runtimeDeps: string[], devDeps: string[], peerDeps: string[]): Map<string, number>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/heuristics/loader.d.ts.map

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

package/dist/heuristics/loader.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * Heuristics loader — reads the JSON knowledge files and exposes typed helpers.
+ *
+ * This is the ONLY file that touches the JSON files.
+ * All detectors import from here, never directly from the JSON files.
+ *
+ * Separation of concerns:
+ *   JSON files  = knowledge (what frameworks exist, what patterns mean what)
+ *   TypeScript  = logic (how to score, combine, and decide)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPackageInfo = getPackageInfo;
+exports.isKnownFrameworkDep = isKnownFrameworkDep;
+exports.getTypeHintForPackage = getTypeHintForPackage;
+exports.getPackageWeight = getPackageWeight;
+exports.getFrameworkLabel = getFrameworkLabel;
+exports.isMonorepoToolDep = isMonorepoToolDep;
+exports.resolveFrameworkLabels = resolveFrameworkLabels;
+exports.getArchetypeDefinition = getArchetypeDefinition;
+exports.getAllArchetypes = getAllArchetypes;
+exports.getAllSubsystemPatterns = getAllSubsystemPatterns;
+exports.getBaseImportanceScore = getBaseImportanceScore;
+exports.getRepoCenterBonus = getRepoCenterBonus;
+exports.getSuppressedFlowFamilies = getSuppressedFlowFamilies;
+exports.shouldSuppressFlowFamily = shouldSuppressFlowFamily;
+exports.getAllRepoModes = getAllRepoModes;
+exports.scoreTypeHintsFromDeps = scoreTypeHintsFromDeps;
+const known_packages_json_1 = __importDefault(require("./known-packages.json"));
+const file_patterns_json_1 = __importDefault(require("./file-patterns.json"));
+const repo_mode_signals_json_1 = __importDefault(require("./repo-mode-signals.json"));
+// ── Package Knowledge ──────────────────────────────────────────────────
+const PACKAGES = known_packages_json_1.default;
+/**
+ * Look up a package by exact name.
+ * Returns null if not found or if the entry is a section separator (string).
+ */
+function getPackageInfo(name) {
+    const entry = PACKAGES[name];
+    if (!entry || typeof entry === "string")
+        return null;
+    return entry;
+}
+/**
+ * Check if a package name is a known framework dep, filtered by dep kind.
+ *
+ * @param name - exact package name
+ * @param actualDepKind - where it appears in the consuming package.json
+ *   "runtime" = in dependencies{}
+ *   "dev"     = in devDependencies{}
+ *   "peer"    = in peerDependencies{}
+ */
+function isKnownFrameworkDep(name, actualDepKind) {
+    const info = getPackageInfo(name);
+    if (!info || info.weight === 0)
+        return false;
+    if (info.depKind === "any")
+        return true;
+    if (info.depKind === "runtime" && actualDepKind !== "runtime")
+        return false;
+    return true;
+}
+/**
+ * Get the typeHint for a package, respecting depKind rules.
+ * Returns null if the package should not produce a typeHint in this context.
+ */
+function getTypeHintForPackage(name, actualDepKind) {
+    const info = getPackageInfo(name);
+    if (!info || info.weight === 0)
+        return null;
+    if (info.depKind === "runtime" && actualDepKind !== "runtime")
+        return null;
+    return info.typeHint;
+}
+/**
+ * Get the signal weight for a package, or 0 if not applicable.
+ */
+function getPackageWeight(name, actualDepKind) {
+    const info = getPackageInfo(name);
+    if (!info)
+        return 0;
+    if (info.depKind === "runtime" && actualDepKind !== "runtime")
+        return 0;
+    if (info.depKind === "dev" && actualDepKind === "runtime")
+        return info.weight * 0.3; // runtime presence of a dev tool is weak
+    return info.weight;
+}
+/**
+ * Get the framework display name for a package.
+ * Used for tech badge labels on canvas nodes.
+ */
+function getFrameworkLabel(name) {
+    const info = getPackageInfo(name);
+    return info?.framework ?? null;
+}
+/**
+ * Check if a package is a monorepo signal (turbo, nx, lerna, etc.)
+ */
+function isMonorepoToolDep(name) {
+    const info = getPackageInfo(name);
+    return info?.repoSignal === "monorepo";
+}
+/**
+ * Resolve all known framework labels from a list of dep names.
+ * Deduplicates by framework name.
+ * Used to build the `detectedTech` array for a system.
+ */
+function resolveFrameworkLabels(runtimeDeps, devDeps, peerDeps) {
+    const seen = new Set();
+    const labels = [];
+    function check(name, kind) {
+        const info = getPackageInfo(name);
+        if (!info?.framework)
+            return;
+        if (info.depKind === "runtime" && kind !== "runtime")
+            return;
+        if (!seen.has(info.framework)) {
+            seen.add(info.framework);
+            labels.push(info.framework);
+        }
+    }
+    runtimeDeps.forEach((d) => check(d, "runtime"));
+    devDeps.forEach((d) => check(d, "dev"));
+    peerDeps.forEach((d) => check(d, "peer"));
+    return labels;
+}
+// ── Archetype Knowledge ────────────────────────────────────────────────
+const FILE_PATTERNS = file_patterns_json_1.default;
+function getArchetypeDefinition(name) {
+    return FILE_PATTERNS.archetypes[name] ?? null;
+}
+function getAllArchetypes() {
+    return FILE_PATTERNS.archetypes;
+}
+function getAllSubsystemPatterns() {
+    return FILE_PATTERNS["subsystem-patterns"];
+}
+// ── Repo Mode Knowledge ────────────────────────────────────────────────
+const REPO_MODE_SIGNALS = repo_mode_signals_json_1.default;
+/**
+ * Get the base importance score for a system type.
+ * Used by systemRanking.ts to determine canvas node prominence.
+ */
+function getBaseImportanceScore(systemType) {
+    return REPO_MODE_SIGNALS["importance-scores"][systemType] ?? 0.30;
+}
+/**
+ * Get the bonus added when a system is detected as the repo center.
+ */
+function getRepoCenterBonus(role) {
+    return REPO_MODE_SIGNALS["repo-center-bonus"][role] ?? 0;
+}
+/**
+ * Get the flow families that should be suppressed for a given repo mode.
+ * Prevents boilerplate flow templates on framework/library repos.
+ */
+function getSuppressedFlowFamilies(repoMode) {
+    return REPO_MODE_SIGNALS["flow-suppression-rules"][repoMode] ?? [];
+}
+/**
+ * Check if a flow family should be suppressed for the given repo mode.
+ */
+function shouldSuppressFlowFamily(repoMode, family) {
+    return getSuppressedFlowFamilies(repoMode).includes(family);
+}
+/**
+ * Get all repo mode definitions.
+ */
+function getAllRepoModes() {
+    return REPO_MODE_SIGNALS.modes;
+}
+// ── Convenience bundles ────────────────────────────────────────────────
+/**
+ * Everything a detector needs to classify a system from its package.json deps.
+ * Returns a map of typeHint → accumulated weight from all matching deps.
+ */
+function scoreTypeHintsFromDeps(runtimeDeps, devDeps, peerDeps) {
+    const scores = new Map();
+    function accumulate(name, kind) {
+        const w = getPackageWeight(name, kind);
+        if (w === 0)
+            return;
+        const hint = getTypeHintForPackage(name, kind);
+        if (!hint)
+            return;
+        scores.set(hint, (scores.get(hint) ?? 0) + w);
+    }
+    runtimeDeps.forEach((d) => accumulate(d, "runtime"));
+    devDeps.forEach((d) => accumulate(d, "dev"));
+    peerDeps.forEach((d) => accumulate(d, "peer"));
+    return scores;
+}
+//# sourceMappingURL=loader.js.map

package/dist/heuristics/loader.js.map

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

package/dist/heuristics/repo-mode-signals.json

@@ -0,0 +1,248 @@
+{
+    "_meta": {
+        "version": "1.0.0",
+        "scope": "JS/TS ecosystem — structural conditions that determine repo-level mode",
+        "how": "repo mode = the overall shape of the repository. Not a system type — the whole repo's identity.",
+        "modes": {
+            "product-web-app": "Single product: one web app, optional API backend",
+            "product-domain-machine": "Monorepo: multiple runnable apps + shared packages",
+            "framework-core": "A framework itself — used by other people's projects",
+            "library-tooling": "A library or developer tool — imported, not deployed",
+            "surface-platform": "Multi-surface platform: web + mobile + desktop surfaces",
+            "ui-component-library": "A UI component library: components published for others to use",
+            "documentation-site": "A docs-first repo: the product IS the documentation",
+            "workflow-platform": "CI/CD, pipeline orchestration, or workflow automation",
+            "developer-tooling": "CLI tools, build tools, linters, code generators",
+            "e2e-testing-suite": "A repo whose primary purpose is E2E testing another product",
+            "unknown": "Cannot determine — show basic info only"
+        }
+    },
+    "modes": {
+        "product-web-app": {
+            "label": "Product Web Application",
+            "description": "A single deployable product with a web frontend and optional backend",
+            "requires": {
+                "any": ["has-web-app-system", "has-next-config", "has-vite-spa"]
+            },
+            "excludes": {
+                "any": ["multiple-runnable-apps", "is-library-repo", "is-framework-repo"]
+            },
+            "signals": [
+                { "label": "Single web app entry point", "weight": 30 },
+                { "label": "next.config.* at root", "weight": 25 },
+                { "label": "src/main.tsx with index.html", "weight": 25 },
+                { "label": "No packages/ directory with >3 packages", "weight": 15 }
+            ],
+            "minScore": 30,
+            "examples": ["cal.com", "linear-app", "notion-clone"]
+        },
+        "product-domain-machine": {
+            "label": "Product Monorepo",
+            "description": "Multiple runnable apps backed by shared packages — one product, many deployables",
+            "requires": {
+                "all": ["has-packages-or-apps-dir"],
+                "any": ["multiple-runnable-apps", "apps-dir-with-2-plus"]
+            },
+            "excludes": {
+                "any": ["is-ui-library-dominant", "is-framework-repo"]
+            },
+            "signals": [
+                { "label": "apps/ directory with 2+ runnable apps", "weight": 40 },
+                { "label": "packages/ with shared utilities + apps/ with apps", "weight": 35 },
+                { "label": "turbo.json or nx.json at root", "weight": 20 },
+                { "label": "Multiple package.json with start scripts", "weight": 25 }
+            ],
+            "minScore": 40,
+            "examples": ["hoppscotch", "twenty", "cal.com monorepo", "supabase"]
+        },
+        "framework-core": {
+            "label": "Framework Core",
+            "description": "A framework, runtime, or platform used by other developers' projects",
+            "requires": {
+                "any": [
+                    "has-compiler-framework-archetype",
+                    "has-platform-adapters",
+                    "has-core-runtime-zone",
+                    "is-published-as-framework"
+                ]
+            },
+            "signals": [
+                { "label": "compiler/ or parse/ directory at root", "weight": 40 },
+                { "label": "Platform adapter packages (express, fastify)", "weight": 35 },
+                { "label": "packages/core + packages/react + packages/vue", "weight": 30 },
+                { "label": "npm package named without app-like suffix", "weight": 15 },
+                { "label": "peerDependencies-heavy package.json", "weight": 20 },
+                { "label": "High incoming deps from other packages", "weight": 25 }
+            ],
+            "minScore": 40,
+            "examples": ["react", "vue", "svelte", "nestjs/nest", "vercel/next.js"],
+            "note": "Framework repos should NOT get flow patterns that assume user-facing behavior (login, payment). They have internal framework flows."
+        },
+        "library-tooling": {
+            "label": "Library / Developer Tooling",
+            "description": "An npm package or tool consumed by developers, not deployed as a product",
+            "requires": {
+                "any": [
+                    "has-cli-archetype",
+                    "single-package-with-src-index",
+                    "is-type-definitions-only"
+                ]
+            },
+            "excludes": {
+                "any": ["has-web-app-entry", "is-framework-repo", "multiple-runnable-apps"]
+            },
+            "signals": [
+                { "label": "bin/ directory with CLI entry", "weight": 35 },
+                { "label": "commander/yargs in runtime deps", "weight": 30 },
+                { "label": "src/index.ts as primary export", "weight": 20 },
+                { "label": "No index.html or web entry point", "weight": 15 },
+                { "label": "package.json main/exports field set", "weight": 20 }
+            ],
+            "minScore": 30,
+            "examples": ["redux-toolkit", "zod", "lodash", "date-fns", "axios"]
+        },
+        "ui-component-library": {
+            "label": "UI Component Library",
+            "description": "A library of UI components published for other developers to use",
+            "requires": {
+                "any": [
+                    "ui-lib-count-5-or-more",
+                    "storybook-with-30-plus-stories",
+                    "packages-all-ui-typed"
+                ]
+            },
+            "excludes": {
+                "any": ["runnable-count-2-or-more", "is-docs-site-dominant"]
+            },
+            "signals": [
+                { "label": "5+ packages all with ui/component names", "weight": 45 },
+                { "label": "30+ .stories.* files", "weight": 35 },
+                { "label": ".storybook/ config at root", "weight": 30 },
+                { "label": "peerDeps include react/vue", "weight": 20 },
+                { "label": "No runnable apps (no src/main.tsx in any pkg)", "weight": 20 }
+            ],
+            "minScore": 45,
+            "examples": ["chakra-ui", "radix-ui", "shadcn/ui", "material-ui"],
+            "incidental-runnables": {
+                "description": "Some UI libs have a docs app or storybook app as runnable. This should NOT trigger product-domain-machine.",
+                "rule": "If runnableCount >= 1 AND uiLibCount >= 4, prefer ui-component-library over product-domain-machine"
+            }
+        },
+        "documentation-site": {
+            "label": "Documentation Site",
+            "description": "The primary product is documentation — MDX content, guides, API references",
+            "requires": {
+                "any": [
+                    "has-docusaurus",
+                    "has-vitepress",
+                    "has-nextra",
+                    "high-mdx-density"
+                ]
+            },
+            "signals": [
+                { "label": "Docusaurus/VitePress/Nextra framework", "weight": 50 },
+                { "label": "20+ MDX files", "weight": 30 },
+                { "label": "docs/ as primary directory", "weight": 20 },
+                { "label": "No significant src/ code tree", "weight": 15 }
+            ],
+            "minScore": 40,
+            "examples": ["docusaurus.io", "vitepress docs", "nextra sites"],
+            "importanceNote": "docs-site importance score = 0.48 (NOT 0.72). A docs site is supplementary in a product repo. Only dominant when it IS the primary system."
+        },
+        "e2e-testing-suite": {
+            "label": "End-to-End Test Suite",
+            "description": "The repo's primary purpose is E2E testing another product",
+            "requires": {
+                "all": ["high-e2e-signal"],
+                "none": ["is-product-with-incidental-e2e"]
+            },
+            "signals": [
+                { "label": "cypress/ or e2e/ as ROOT directory", "weight": 40 },
+                { "label": "cypress.config.* or playwright.config.*", "weight": 45 },
+                { "label": "5+ .cy.* files", "weight": 40 },
+                { "label": "No src/ application code", "weight": 20 }
+            ],
+            "minScore": 55,
+            "antiSignals": [
+                { "label": ".spec.ts files — these are Vitest/Jest, NOT Cypress", "weight": -30, "note": "Never count .spec.ts as e2e evidence" },
+                { "label": "Large src/ application tree alongside tests", "weight": -25, "note": "If a product has e2e tests, it is not an e2e-testing-suite" }
+            ],
+            "examples": ["a dedicated cypress test repo", "playwright test suite repo"]
+        },
+        "developer-tooling": {
+            "label": "Developer Tooling / CLI",
+            "description": "A command-line tool, build tool, linter, or code generator",
+            "requires": {
+                "any": ["has-bin-field", "has-cli-archetype", "has-cli-framework-dep"]
+            },
+            "signals": [
+                { "label": "bin/ with CLI entry points", "weight": 40 },
+                { "label": "commander/yargs in runtime deps", "weight": 35 },
+                { "label": "src/cli.ts or src/commands/", "weight": 30 },
+                { "label": "package.json bin field set", "weight": 35 }
+            ],
+            "minScore": 35,
+            "examples": ["create-react-app", "vite CLI", "eslint", "prettier", "typescript compiler"]
+        },
+        "surface-platform": {
+            "label": "Multi-Surface Platform",
+            "description": "A platform serving multiple surfaces: web, mobile, desktop, API",
+            "requires": {
+                "all": ["multiple-surface-types"]
+            },
+            "signals": [
+                { "label": "web/ + mobile/ + desktop/ directories", "weight": 45 },
+                { "label": "react-native or expo in deps", "weight": 35 },
+                { "label": "electron in deps alongside web app", "weight": 35 },
+                { "label": "3+ distinctly different surface types", "weight": 40 }
+            ],
+            "minScore": 45,
+            "examples": ["hoppscotch (web+desktop+agent)", "an app with web+mobile+desktop"]
+        },
+        "workflow-platform": {
+            "label": "Workflow / Pipeline Platform",
+            "description": "Orchestrates CI/CD pipelines, workflows, or automated tasks",
+            "requires": {
+                "any": ["has-workflow-patterns", "has-pipeline-dirs"]
+            },
+            "signals": [
+                { "label": "pipelines/ or workflows/ directory", "weight": 40 },
+                { "label": "temporal/bull/agenda in runtime deps", "weight": 35 },
+                { "label": "DAG or directed graph patterns", "weight": 30 }
+            ],
+            "minScore": 40,
+            "examples": ["n8n", "temporal.io apps", "GitHub Actions runners"]
+        }
+    },
+    "importance-scores": {
+        "_note": "Base importance scores for system types. These control visual prominence on the canvas.",
+        "api-service": 0.78,
+        "web-app": 0.75,
+        "desktop-app": 0.75,
+        "ui-library": 0.72,
+        "compiler-framework": 0.80,
+        "worker": 0.60,
+        "shared-package": 0.45,
+        "docs-site": 0.48,
+        "infra": 0.50,
+        "developer-tooling": 0.65,
+        "e2e-testing-suite": 0.40,
+        "storybook-component-library": 0.65,
+        "design-system": 0.70,
+        "unknown": 0.30
+    },
+    "repo-center-bonus": {
+        "_note": "Bonus added to importance score when a system is detected as the repo center",
+        "is-repo-center": 0.15,
+        "is-most-depended-on": 0.10,
+        "is-entry-system": 0.08
+    },
+    "flow-suppression-rules": {
+        "_note": "Which FLOW_PATTERN families should be suppressed for which repo modes. Prevents boilerplate flows on repos where they make no sense.",
+        "framework-core": ["web-product", "cli-tool"],
+        "library-tooling": ["web-product", "cli-tool"],
+        "ui-component-library": ["web-product"],
+        "e2e-testing-suite": ["web-product", "backend-framework", "library"],
+        "documentation-site": ["web-product", "backend-framework"]
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}