memor-code-cli 0.2.0

package/dist/SystemSynthesis/stampDeterministic.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stampDeterministic = stampDeterministic;
+// ── Edge source classification ────────────────────────────────────────────
+function edgeToSource(e) {
+    if (e.kind === "import")
+        return "import";
+    if (e.kind === "intentional")
+        return "intentional";
+    const t = e.type ?? "";
+    if (t === "ENV_CONSUMES")
+        return "env";
+    if (t === "ORM_CONSUMES")
+        return "orm";
+    if (t === "HTTP_CALL")
+        return "http";
+    if (t === "TRPC_CALL")
+        return "trpc";
+    if (t === "PROXY_ROUTE")
+        return "proxy";
+    return "import";
+}
+// ── Build connection refs to other NAMED systems ──────────────────────────
+function buildConnectionRefs(nodeId, enriched, clusterToSystemName, direction) {
+    const byTarget = new Map();
+    for (const e of enriched.edges) {
+        const isMatch = direction === "outgoing" ? e.from === nodeId : e.to === nodeId;
+        if (!isMatch)
+            continue;
+        const targetId = direction === "outgoing" ? e.to : e.from;
+        const targetName = clusterToSystemName.get(targetId);
+        if (!targetName)
+            continue; // only reference systems the LLM has named
+        const existing = byTarget.get(targetName);
+        if (!existing || e.confidence > existing.confidence) {
+            byTarget.set(targetName, {
+                target: targetName,
+                confidence: Math.round(e.confidence * 100) / 100,
+                source: edgeToSource(e),
+            });
+        }
+    }
+    return [...byTarget.values()].sort((a, b) => b.confidence - a.confidence);
+}
+// ── Build infra refs (DB, cache, queue, external services) ────────────────
+function buildInfraRefs(node, enriched) {
+    const infraIds = new Set(enriched.nodes
+        .filter((n) => n.kind !== "cluster" && n.kind !== "package")
+        .map((n) => n.id));
+    const byTarget = new Map();
+    // Runtime edges from this node to infra nodes
+    for (const e of enriched.edges) {
+        if (e.from !== node.id)
+            continue;
+        if (!infraIds.has(e.to))
+            continue;
+        const infraNode = enriched.nodes.find((n) => n.id === e.to);
+        if (!infraNode)
+            continue;
+        const existing = byTarget.get(infraNode.name);
+        if (!existing || e.confidence > existing.confidence) {
+            byTarget.set(infraNode.name, {
+                target: infraNode.name,
+                confidence: Math.round(e.confidence * 100) / 100,
+                source: edgeToSource(e),
+            });
+        }
+    }
+    // Also capture env_consumes and ormUses that may not have a matching infra node
+    // (e.g. synthetic "database" target when L1 has no matching system declared)
+    for (const target of node.envConsumes) {
+        if (!byTarget.has(target)) {
+            byTarget.set(target, { target, confidence: 0.9, source: "env" });
+        }
+    }
+    for (const evidence of node.ormUses) {
+        // evidence is e.g. "@prisma/client" — use it as the target label
+        const label = evidence.replace("@", "").split("/")[0]; // "@prisma/client" → "prisma"
+        if (!byTarget.has(label)) {
+            byTarget.set(label, { target: label, confidence: 0.95, source: "orm" });
+        }
+    }
+    return [...byTarget.values()].sort((a, b) => b.confidence - a.confidence);
+}
+// ── Graph-driven tier computation ────────────────────────────────────────
+// Tier is a structural property the graph knows with certainty.
+// The LLM's tier guess is always discarded — only this function decides.
+// Archetypes that are always support regardless of how many systems import them.
+// config/type-defs are imported everywhere by design — that's infrastructure, not product core.
+const ALWAYS_SUPPORT_ARCHETYPES = new Set([
+    "type-defs", // pure type declarations — no runtime role
+    "config", // configuration only — imported by everything, still infrastructure
+    "db-migration", // migration scripts — run offline, not imported at runtime
+]);
+function computeGraphTier(calledBy, archetype, maxInDegree, ownsRoutes) {
+    const inDeg = calledBy.length;
+    const arc = archetype ?? "";
+    // Support: config/type-defs/migrations are always support — even when widely imported.
+    // Must run before the primary check or these will be promoted incorrectly.
+    if (ALWAYS_SUPPORT_ARCHETYPES.has(arc))
+        return "support";
+    // Support: web-page — pages users navigate to, nothing should import them.
+    // Keep inDeg guard: a shared layout template legitimately has callers.
+    if (arc === "web-page" && inDeg === 0)
+        return "support";
+    // Primary: at least 2 callers AND at least half the graph's maximum inDegree.
+    if (inDeg >= 2 && inDeg >= Math.ceil(maxInDegree / 2))
+        return "primary";
+    // Support: any cluster with only UI routes (no /api/) and zero callers.
+    // Covers admin pages, marketing pages, etc. — structurally identical to web-page
+    // leaf consumers regardless of whether the archetype was applied to them.
+    if (inDeg === 0 &&
+        ownsRoutes.length > 0 &&
+        ownsRoutes.every((r) => !r.startsWith("/api/")))
+        return "support";
+    // Secondary: everything else.
+    return "secondary";
+}
+// ── Main stamp function ───────────────────────────────────────────────────
+function stampDeterministic(llmSystems, enriched, clusterArchetype) {
+    // Build lookup: cluster id → system name (for connection refs)
+    const clusterToSystemName = new Map();
+    for (const s of llmSystems)
+        clusterToSystemName.set(s.clusterId, s.name);
+    const nodeById = new Map();
+    for (const n of enriched.nodes)
+        nodeById.set(n.id, n);
+    const result = llmSystems.map((llm, i) => {
+        const node = nodeById.get(llm.clusterId);
+        const connects_to = buildConnectionRefs(llm.clusterId, enriched, clusterToSystemName, "outgoing");
+        const called_by = buildConnectionRefs(llm.clusterId, enriched, clusterToSystemName, "incoming");
+        const uses_infra = node ? buildInfraRefs(node, enriched) : [];
+        return {
+            id: `synth-${llm.clusterId.replace(/\//g, "-")}-${i}`,
+            cluster_id: llm.clusterId,
+            file_count: node?.fileCount ?? 0,
+            package_id: node?.packageId,
+            // LLM-filled (name + description); tier is overwritten below by computeGraphTier
+            name: llm.name,
+            type: llm.type,
+            tier: llm.tier,
+            description: llm.description,
+            // Graph-filled — deterministic
+            owns_routes: node?.routes ?? [],
+            owns_models: node?.models ?? [],
+            connects_to,
+            called_by,
+            uses_infra,
+        };
+    });
+    // ── Graph-driven tier assignment ─────────────────────────────────────────
+    // Fully replaces whatever tier the LLM or archetype mapping assigned.
+    // Tier is a structural property — the graph knows it; the LLM guesses it.
+    // Stamp archetypes first so computeGraphTier can use them.
+    if (clusterArchetype) {
+        for (const sys of result) {
+            const a = clusterArchetype.get(sys.cluster_id);
+            if (a)
+                sys.archetype = a;
+        }
+    }
+    const maxInDegree = Math.max(...result.map((s) => s.called_by.length), 0);
+    for (const sys of result) {
+        sys.tier = computeGraphTier(sys.called_by, sys.archetype, maxInDegree, sys.owns_routes);
+    }
+    // Fallback: if the graph has no edges between named systems at all (e.g. a
+    // monorepo with one package), promote the system with the most raw file-level
+    // inDegree from the graph so something is always marked primary.
+    if (!result.some((s) => s.tier === "primary")) {
+        const byFiles = [...result].sort((a, b) => (nodeById.get(b.cluster_id)?.inDegree ?? 0) - (nodeById.get(a.cluster_id)?.inDegree ?? 0));
+        const top = byFiles[0];
+        if (top)
+            top.tier = "primary";
+    }
+    return result;
+}
+//# sourceMappingURL=stampDeterministic.js.map

package/dist/SystemSynthesis/stampDeterministic.js.map

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

package/dist/SystemSynthesis/synthesize.d.ts

@@ -0,0 +1,15 @@
+/**
+ * synthesize — Layer 4 orchestrator.
+ *
+ * 1. LLM names each system (name / type / tier / description only)
+ * 2. stampDeterministic() fills all structural fields from the graph
+ * 3. Returns SynthesisResult — the complete, confidence-scored AM
+ *
+ * The LLM never sees routes/connections in its output schema.
+ * The graph never invents names or descriptions.
+ */
+import type { EnrichedGraph } from "./types";
+import type { SynthesisResult } from "./types";
+import { type CallLLMOptions } from "../graph/callLLM";
+export declare function synthesize(enriched: EnrichedGraph, options?: CallLLMOptions): Promise<SynthesisResult>;
+//# sourceMappingURL=synthesize.d.ts.map

package/dist/SystemSynthesis/synthesize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../src/SystemSynthesis/synthesize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,aAAa,EAA8B,MAAM,SAAS,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,SAAS,CAAC;AAElE,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAsN9E,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAwF1B"}

package/dist/SystemSynthesis/synthesize.js

@@ -0,0 +1,258 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.synthesize = synthesize;
+const callLLM_1 = require("../graph/callLLM");
+const buildLLMPayload_1 = require("../graph/buildLLMPayload");
+const stampDeterministic_1 = require("./stampDeterministic");
+// ── Family graph enrichment ───────────────────────────────────────────────
+// After promoteFamilies() collapses sibling clusters into a parent, we need
+// synthetic EnrichedNodes + remapped edges so stampDeterministic can compute
+// connection refs and tier correctly for the parent cluster.
+function enrichGraphWithFamilies(enriched, parentToChildren) {
+    if (parentToChildren.size === 0)
+        return enriched;
+    const nodeById = new Map(enriched.nodes.map((n) => [n.id, n]));
+    const childToParent = new Map();
+    for (const [parent, children] of parentToChildren) {
+        for (const child of children)
+            childToParent.set(child, parent);
+    }
+    const syntheticNodes = [];
+    for (const [parent, childIds] of parentToChildren) {
+        const children = childIds
+            .map((id) => nodeById.get(id))
+            .filter((n) => n !== undefined);
+        if (children.length === 0)
+            continue;
+        const childSet = new Set(childIds);
+        // External edges: those crossing the family boundary
+        const externalIn = enriched.edges.filter((e) => childSet.has(e.to) && !childSet.has(e.from));
+        const externalOut = enriched.edges.filter((e) => childSet.has(e.from) && !childSet.has(e.to));
+        syntheticNodes.push({
+            id: parent,
+            name: parent.split("/").pop() ?? parent,
+            kind: "cluster",
+            fileCount: children.reduce((s, c) => s + c.fileCount, 0),
+            topExports: [...new Set(children.flatMap((c) => c.topExports))].slice(0, 10),
+            centrality: Math.max(...children.map((c) => c.centrality)),
+            inDegree: new Set(externalIn.map((e) => e.from)).size,
+            outDegree: new Set(externalOut.map((e) => e.to)).size,
+            isEntryPoint: children.some((c) => c.isEntryPoint),
+            isShared: children.some((c) => c.isShared),
+            routes: [...new Set(children.flatMap((c) => c.routes))],
+            models: [...new Set(children.flatMap((c) => c.models))],
+            hasTests: children.some((c) => c.hasTests),
+            hasTypes: children.some((c) => c.hasTypes),
+            hasConfig: children.some((c) => c.hasConfig),
+            envConsumes: [...new Set(children.flatMap((c) => c.envConsumes))],
+            ormUses: [...new Set(children.flatMap((c) => c.ormUses))],
+        });
+    }
+    // Remap all edges: child id → parent id; drop intra-family self-loops
+    const remappedEdges = enriched.edges
+        .map((e) => ({
+        ...e,
+        from: childToParent.get(e.from) ?? e.from,
+        to: childToParent.get(e.to) ?? e.to,
+    }))
+        .filter((e) => e.from !== e.to);
+    return {
+        ...enriched,
+        nodes: [...enriched.nodes, ...syntheticNodes],
+        edges: remappedEdges,
+    };
+}
+// ── Archetype → LLMSystem mapping ────────────────────────────────────────
+// Convert a deterministically-classified cluster into an LLMSystem without
+// any API call. Names are intentionally concise — they orient, not poeticize.
+function archetypeToLLMSystem(c) {
+    const base = c.name.charAt(0).toUpperCase() + c.name.slice(1);
+    // Avoid tautological names like "Config Config" or "Types Types"
+    function withSuffix(suffix) {
+        return base.toLowerCase().endsWith(suffix.toLowerCase()) ? base : `${base} ${suffix}`;
+    }
+    const NAME = {
+        "data-layer": withSuffix("Data Layer"),
+        "db-migration": withSuffix("Migrations"),
+        "cache-client": withSuffix("Cache"),
+        "auth-service": withSuffix("Auth"),
+        "queue-worker": withSuffix("Worker"),
+        "email-service": withSuffix("Mailer"),
+        "middleware": withSuffix("Middleware"),
+        "type-defs": withSuffix("Types"),
+        "config": withSuffix("Config"),
+        "shared-lib": base,
+        "app-entry": withSuffix("Entry"),
+        "web-page": base,
+    };
+    const TYPE = {
+        "data-layer": "data-layer",
+        "db-migration": "data-layer",
+        "cache-client": "infra",
+        "auth-service": "api-service",
+        "queue-worker": "worker",
+        "email-service": "worker",
+        "middleware": "shared-library",
+        "type-defs": "shared-library",
+        "config": "config",
+        "shared-lib": "shared-library",
+        "app-entry": "web-app",
+        "web-page": "web-app",
+    };
+    const TIER = {
+        "data-layer": "primary",
+        "db-migration": "support",
+        "cache-client": "support",
+        "auth-service": "secondary",
+        "queue-worker": "secondary",
+        "email-service": "secondary",
+        "middleware": "support",
+        "type-defs": "support",
+        "config": "support",
+        "shared-lib": "support",
+        "app-entry": "secondary",
+        "web-page": "secondary",
+    };
+    const DESC = {
+        "data-layer": "Manages database schema and persistent data access.",
+        "db-migration": "Contains database migration scripts and schema versioning.",
+        "cache-client": "Provides distributed cache access to reduce latency.",
+        "auth-service": "Handles authentication tokens, sessions, and access control.",
+        "queue-worker": "Processes background jobs and deferred tasks asynchronously.",
+        "email-service": "Sends transactional email and notifications to users.",
+        "middleware": "Cross-cutting concerns: validation, logging, and request transformation.",
+        "type-defs": "Shared TypeScript type definitions and domain interfaces.",
+        "config": "Application configuration and environment settings.",
+        "shared-lib": "Shared utilities used across multiple modules.",
+        "app-entry": "Application entry point that initialises and bootstraps the system.",
+        "web-page": "Public-facing page that users land on directly.",
+    };
+    const a = c.archetype;
+    return {
+        clusterId: c.id,
+        name: NAME[a],
+        type: TYPE[a],
+        tier: TIER[a],
+        description: DESC[a],
+    };
+}
+// ── Deterministic fallback when LLM is unavailable ───────────────────────
+// Produces LLMSystem[] from top clusters by signal quality, no API call needed.
+const SKIP_SEGS = new Set(["src", "lib", "libs", "packages", "apps", "modules", "source"]);
+function fallbackSystemName(id, baseName, nameCounts) {
+    if ((nameCounts.get(baseName) ?? 0) <= 1)
+        return baseName;
+    const parts = id.split("/");
+    for (let i = parts.length - 2; i >= 0; i--) {
+        if (!SKIP_SEGS.has(parts[i]))
+            return `${parts[i]}/${baseName}`;
+    }
+    return baseName;
+}
+function buildFallbackSystems(enriched) {
+    const all = enriched.nodes
+        .filter((n) => (n.kind === "cluster" || n.kind === "package") && !n.hasTests && n.fileCount >= 1);
+    // Always include nodes with infra signals regardless of inDegree
+    const withInfra = all.filter((n) => n.ormUses.length > 0 || n.envConsumes.length > 0 || n.routes.length > 0);
+    const infraIds = new Set(withInfra.map((n) => n.id));
+    // Fill remaining slots with most-imported clusters
+    const rest = all
+        .filter((n) => !infraIds.has(n.id))
+        .sort((a, b) => b.inDegree - a.inDegree);
+    const candidates = [...withInfra, ...rest].slice(0, 25);
+    const nameCounts = new Map();
+    for (const n of candidates)
+        nameCounts.set(n.name, (nameCounts.get(n.name) ?? 0) + 1);
+    const maxIn = Math.max(...candidates.map((n) => n.inDegree), 1);
+    return candidates.map((n, i) => {
+        const relIn = n.inDegree / maxIn;
+        const tier = relIn >= 0.5 ? "primary"
+            : relIn >= 0.15 || n.isEntryPoint ? "secondary"
+                : "support";
+        const displayName = fallbackSystemName(n.id, n.name, nameCounts);
+        const capitalized = displayName.charAt(0).toUpperCase() + displayName.slice(1);
+        return {
+            clusterId: n.id,
+            name: capitalized,
+            type: n.hasTypes ? "shared-library" : n.hasConfig ? "config" : "unknown",
+            tier,
+            description: `${n.fileCount} file${n.fileCount !== 1 ? "s" : ""}${n.routes.length > 0 ? `, ${n.routes.length} routes` : ""}`,
+        };
+    });
+}
+// ── Main synthesize function ──────────────────────────────────────────────
+async function synthesize(enriched, options = {}) {
+    const hasApiKey = !!(process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY);
+    // Phase 3: split payload into deterministic (classified) and ambiguous clusters.
+    // Deterministic clusters are pre-named without any API call.
+    // Only ambiguous clusters are sent to the LLM — smaller payload, fewer tokens.
+    // Family promotion runs inside buildAmbiguousPayload: sibling-heavy directories
+    // are collapsed into their parent before the LLM sees them.
+    const { ambiguousPayloadStr, deterministicClusters, routeFamilies, parentToChildren } = (0, buildLLMPayload_1.buildAmbiguousPayload)(enriched);
+    // Enrich the graph with synthetic parent nodes + remapped edges so stampDeterministic
+    // can compute correct connection refs and tier for promoted family clusters.
+    const enrichedForStamp = enrichGraphWithFamilies(enriched, parentToChildren);
+    // Build archetype map so it can be stamped onto SynthesizedSystem after stampDeterministic
+    const clusterArchetype = new Map(deterministicClusters
+        .filter((c) => c.archetype !== undefined)
+        .map((c) => [c.id, c.archetype]));
+    const deterministicSystems = deterministicClusters.map(archetypeToLLMSystem);
+    let llmSystems = [];
+    let repoSummary = "";
+    // Skip LLM if everything is already classified
+    const needsLLM = ambiguousPayloadStr.length > 0;
+    if (needsLLM) {
+        // Try cache first (keyed by the ambiguous payload hash)
+        try {
+            const cached = await (0, callLLM_1.readLLMCache)(enriched);
+            if (cached && cached.systems.length > 0) {
+                llmSystems = cached.systems;
+                repoSummary = cached.repoSummary;
+            }
+        }
+        catch { /* cache miss is fine */ }
+        // Call LLM with only ambiguous clusters if cache missed and key available
+        if (llmSystems.length === 0 && hasApiKey && !options.noCache) {
+            try {
+                const response = await (0, callLLM_1.callLLM)(enriched, {
+                    ...options,
+                    payloadOverride: ambiguousPayloadStr,
+                });
+                llmSystems = response.systems;
+                repoSummary = response.repoSummary;
+            }
+            catch (err) {
+                console.warn("[memor] LLM call failed, using deterministic fallback:", err.message);
+            }
+        }
+    }
+    // Merge deterministic (pre-named) + LLM-named systems
+    const merged = [...deterministicSystems, ...llmSystems];
+    // If LLM failed and we have ambiguous clusters that got no names,
+    // add fallback-named systems for them (deduplicated against deterministic results).
+    const deterministicIds = new Set(deterministicSystems.map((s) => s.clusterId));
+    const ambiguousFallback = needsLLM && llmSystems.length === 0 && merged.length > 0
+        ? buildFallbackSystems(enriched).filter((s) => !deterministicIds.has(s.clusterId))
+        : [];
+    // Full fallback: if LLM failed and we have no pre-named systems either
+    const allSystems = merged.length > 0
+        ? [...merged, ...ambiguousFallback]
+        : buildFallbackSystems(enriched);
+    // Stamp all structural fields + archetype + tier from the graph — no LLM involved.
+    // Uses enrichedForStamp which includes synthetic parent nodes for promoted families.
+    const systems = (0, stampDeterministic_1.stampDeterministic)(allSystems, enrichedForStamp, clusterArchetype);
+    return {
+        systems,
+        repo_summary: repoSummary,
+        meta: {
+            repo_name: enriched.meta.repoName,
+            repo_type: enriched.meta.repoType,
+            repo_structure: enriched.meta.repoStructure,
+            tech_stack: enriched.meta.techStack,
+            total_files: enriched.meta.totalFiles,
+            data_models: enriched.meta.dataModels,
+            route_families: routeFamilies.length > 0 ? routeFamilies : undefined,
+        },
+    };
+}
+//# sourceMappingURL=synthesize.js.map

package/dist/SystemSynthesis/synthesize.js.map

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

package/dist/SystemSynthesis/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Layer 4 output types — what System Synthesis produces.
+ *
+ * Hard separation:
+ *   LLM fills:   name, type, tier, description, repo_summary
+ *   Graph fills: owns_routes, owns_models, connects_to, called_by, uses_infra
+ *
+ * The LLM never remembers routes. The graph never invents names.
+ */
+export type ConnectionSource = "import" | "intentional" | "env" | "orm" | "http" | "trpc" | "proxy";
+export type ConnectionRef = {
+    target: string;
+    confidence: number;
+    source: ConnectionSource;
+};
+export type SynthesizedSystem = {
+    id: string;
+    cluster_id: string;
+    file_count: number;
+    package_id?: string;
+    name: string;
+    type: string;
+    tier: "primary" | "secondary" | "support";
+    description: string;
+    archetype?: string;
+    owns_routes: string[];
+    owns_models: string[];
+    connects_to: ConnectionRef[];
+    called_by: ConnectionRef[];
+    uses_infra: ConnectionRef[];
+};
+export type SynthesisResult = {
+    systems: SynthesizedSystem[];
+    repo_summary: string;
+    meta: {
+        repo_name: string;
+        repo_type?: string;
+        repo_structure?: string;
+        tech_stack?: string[];
+        total_files: number;
+        data_models: string[];
+        /** Transport-folded route families — orientation anchors for the developer */
+        route_families?: Array<{
+            family: string;
+            count: number;
+        }>;
+    };
+};
+/**
+ * EnrichedGraph — the unified output of Layer 1 + Layer 2 + Layer 3.
+ *
+ * This is the single type that Layer 4 (System Synthesis) consumes.
+ * It merges:
+ *   - L1 declared systems (docker-compose, workspaces, deploy configs)
+ *   - L2 static import graph (clusters, edges, exports, routes, models)
+ *   - L3 runtime edges (HTTP calls, ORM consumers, env wiring, tRPC)
+ *
+ * Every piece of deterministic knowledge about the codebase lives here.
+ * The LLM only names and explains — it never discovers.
+ */
+export type NodeKind = "cluster" | "package" | "app" | "database" | "cache" | "queue" | "proxy" | "infra";
+export type EdgeKind = "import" | "intentional" | "runtime";
+export type EnrichedNode = {
+    id: string;
+    name: string;
+    kind: NodeKind;
+    fileCount: number;
+    topExports: string[];
+    centrality: number;
+    inDegree: number;
+    outDegree: number;
+    isEntryPoint: boolean;
+    isShared: boolean;
+    packageId?: string;
+    routes: string[];
+    models: string[];
+    hasTests: boolean;
+    hasTypes: boolean;
+    hasConfig: boolean;
+    envConsumes: string[];
+    ormUses: string[];
+};
+export type EnrichedEdge = {
+    from: string;
+    to: string;
+    kind: EdgeKind;
+    weight: number;
+    symbols: string[];
+    type?: string;
+    evidence?: string;
+    confidence: number;
+};
+export type EnrichedGraph = {
+    repoRoot: string;
+    nodes: EnrichedNode[];
+    edges: EnrichedEdge[];
+    meta: {
+        repoName: string;
+        repoStructure?: string;
+        repoType?: string;
+        techStack?: string[];
+        readmeSummary?: string;
+        frameworks: string[];
+        totalFiles: number;
+        totalClusters: number;
+        packages: number;
+        dataModels: string[];
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/SystemSynthesis/types.d.ts.map

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

package/dist/SystemSynthesis/types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Layer 4 output types — what System Synthesis produces.
+ *
+ * Hard separation:
+ *   LLM fills:   name, type, tier, description, repo_summary
+ *   Graph fills: owns_routes, owns_models, connects_to, called_by, uses_infra
+ *
+ * The LLM never remembers routes. The graph never invents names.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/SystemSynthesis/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/SystemSynthesis/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}