@prodara/compiler 0.1.0

package/dist/doc-gen/doc-renderer.js

@@ -0,0 +1,65 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Doc-Gen Main Renderer
+// ---------------------------------------------------------------------------
+// Top-level entry point: generates DocFile[] from a ProductGraph.
+// Also handles writing files with atomic writes and stale cleanup.
+import { writeFileSync, mkdirSync, readdirSync, unlinkSync, renameSync } from 'node:fs';
+import { basename, join, resolve } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { createStringResolver } from './string-resolver.js';
+import { createLinkResolver } from './link-resolver.js';
+import { renderModuleDoc } from './module-renderer.js';
+import { renderProductOverview } from './product-renderer.js';
+// ---------------------------------------------------------------------------
+// Generation
+// ---------------------------------------------------------------------------
+/**
+ * Generate human-readable markdown docs from a product graph.
+ * Returns the files to write — caller can use `writeDocs()` for I/O.
+ */
+export function generateDocs(graph, config, root) {
+    const outputDir = resolve(root, config.outputDir);
+    const resolveString = createStringResolver(graph);
+    const resolveLink = createLinkResolver(graph);
+    const files = [];
+    // Product overview
+    files.push({
+        path: join(outputDir, 'README.md'),
+        content: renderProductOverview(graph, resolveString),
+    });
+    // Per-module docs
+    for (const mod of graph.modules) {
+        files.push({
+            path: join(outputDir, `${mod.name}.md`),
+            content: renderModuleDoc(mod, graph, resolveString, resolveLink),
+        });
+    }
+    return files;
+}
+// ---------------------------------------------------------------------------
+// File writing
+// ---------------------------------------------------------------------------
+/**
+ * Write generated doc files to disk with atomic writes.
+ * Cleans up stale .md files that no longer correspond to modules.
+ */
+export function writeDocs(files, outputDir, root) {
+    const absOutputDir = resolve(root, outputDir);
+    mkdirSync(absOutputDir, { recursive: true });
+    // Write files atomically (temp + rename)
+    const writtenNames = new Set();
+    for (const file of files) {
+        const tmpPath = file.path + `.tmp_${randomBytes(4).toString('hex')}`;
+        writeFileSync(tmpPath, file.content, 'utf-8');
+        renameSync(tmpPath, file.path);
+        writtenNames.add(basename(file.path));
+    }
+    // Clean stale .md files that no longer correspond to modules
+    const existing = readdirSync(absOutputDir);
+    for (const name of existing) {
+        if (name.endsWith('.md') && !writtenNames.has(name)) {
+            unlinkSync(join(absOutputDir, name));
+        }
+    }
+}
+//# sourceMappingURL=doc-renderer.js.map

package/dist/doc-gen/doc-renderer.js.map

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

package/dist/doc-gen/format-helpers.d.ts

@@ -0,0 +1,18 @@
+import type { GraphTypeRef, ModuleNode } from '../graph/graph-types.js';
+export declare function renderBanner(sourceFile: string): string[];
+export declare function formatTypeRef(ref: GraphTypeRef): string;
+export declare function renderTable(headers: string[], rows: string[][]): string[];
+export declare function humanize(snakeName: string): string;
+export declare function toAnchor(heading: string): string;
+export declare function section(title: string, level?: number): string[];
+/**
+ * Safely extract a typed array property from a module node.
+ * Returns empty array if the property is missing or not an array.
+ */
+export declare function getArrayProp<T>(mod: ModuleNode, key: string): T[];
+/**
+ * Extract the last segment of a dot-separated identifier.
+ * e.g. `"board.board_strings.title"` → `"title"`
+ */
+export declare function shortName(id: string): string;
+//# sourceMappingURL=format-helpers.d.ts.map

package/dist/doc-gen/format-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-helpers.d.ts","sourceRoot":"","sources":["../../src/doc-gen/format-helpers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAMxE,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAQzD;AAMD,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAcvD;AAMD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAQzE;AAMD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOhD;AAMD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE,CAGlE;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,CAGjE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAI5C"}

package/dist/doc-gen/format-helpers.js

@@ -0,0 +1,92 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Doc-Gen Format Helpers
+// ---------------------------------------------------------------------------
+// Shared formatting utilities for human-readable doc generation.
+// ---------------------------------------------------------------------------
+// Auto-generated file banner
+// ---------------------------------------------------------------------------
+export function renderBanner(sourceFile) {
+    const now = new Date().toISOString();
+    return [
+        `<!-- ⚠️ AUTO-GENERATED FROM .prd FILES — DO NOT EDIT -->`,
+        `<!-- Source: ${sourceFile} | Compiled: ${now} -->`,
+        `<!-- Edit the .prd source files and recompile to update. -->`,
+        '',
+    ];
+}
+// ---------------------------------------------------------------------------
+// Type display
+// ---------------------------------------------------------------------------
+export function formatTypeRef(ref) {
+    if (typeof ref === 'string')
+        return ref;
+    if ('ref' in ref) {
+        const parts = ref.ref.split('.');
+        /* v8 ignore next -- split always returns ≥1 element */
+        return parts[parts.length - 1] ?? ref.ref;
+    }
+    /* v8 ignore next 3 -- exhaustive: false branch of this if is unreachable */
+    if ('generic' in ref) {
+        return `${ref.generic}<${formatTypeRef(ref.arg)}>`;
+    }
+    /* v8 ignore next 3 -- exhaustive check */
+    const _exhaustive = ref;
+    return String(_exhaustive);
+}
+// ---------------------------------------------------------------------------
+// Markdown table helpers
+// ---------------------------------------------------------------------------
+export function renderTable(headers, rows) {
+    const lines = [];
+    lines.push(`| ${headers.join(' | ')} |`);
+    lines.push(`| ${headers.map(() => '---').join(' | ')} |`);
+    for (const row of rows) {
+        lines.push(`| ${row.join(' | ')} |`);
+    }
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// Name formatting
+// ---------------------------------------------------------------------------
+export function humanize(snakeName) {
+    return snakeName
+        .replace(/_/g, ' ')
+        .trim()
+        .replace(/\b\w/g, c => c.toUpperCase());
+}
+export function toAnchor(heading) {
+    return heading
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9 -]/g, '')
+        .replace(/\s+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+// ---------------------------------------------------------------------------
+// Section helpers
+// ---------------------------------------------------------------------------
+export function section(title, level = 2) {
+    const prefix = '#'.repeat(level);
+    return ['', `${prefix} ${title}`, ''];
+}
+// ---------------------------------------------------------------------------
+// Graph node helpers — shared across all doc-gen renderers
+// ---------------------------------------------------------------------------
+/**
+ * Safely extract a typed array property from a module node.
+ * Returns empty array if the property is missing or not an array.
+ */
+export function getArrayProp(mod, key) {
+    const val = mod[key];
+    return Array.isArray(val) ? val : [];
+}
+/**
+ * Extract the last segment of a dot-separated identifier.
+ * e.g. `"board.board_strings.title"` → `"title"`
+ */
+export function shortName(id) {
+    const parts = id.split('.');
+    /* v8 ignore next -- split always returns ≥1 element */
+    return parts[parts.length - 1] ?? id;
+}
+//# sourceMappingURL=format-helpers.js.map

package/dist/doc-gen/format-helpers.js.map

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

package/dist/doc-gen/index.d.ts

@@ -0,0 +1,5 @@
+export { generateDocs, writeDocs } from './doc-renderer.js';
+export type { DocFile } from './doc-renderer.js';
+export type { SectionContext } from './section-renderers.js';
+export type { ActorNode, CapabilityNode, EntityNode, ValueNode, EnumNode, RuleNode, WorkflowNode, ActionNode, EventNode, ScheduleNode, SurfaceNode, RenderingNode, TokensNode, StorageNode, SecurityNode, PrivacyNode, TestNode, StringsNode, FieldRef, StepNode, } from './doc-gen-types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/doc-gen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/doc-gen/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EACV,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAC1D,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAC3D,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EACnD,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GACrE,MAAM,oBAAoB,CAAC"}

package/dist/doc-gen/index.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Doc-Gen Barrel Exports
+// ---------------------------------------------------------------------------
+export { generateDocs, writeDocs } from './doc-renderer.js';
+//# sourceMappingURL=index.js.map

package/dist/doc-gen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/doc-gen/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4CAA4C;AAC5C,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/doc-gen/link-resolver.d.ts

@@ -0,0 +1,10 @@
+import type { ProductGraph } from '../graph/graph-types.js';
+/**
+ * Create a link resolver for cross-module and same-module references.
+ *
+ * @param graph The product graph (used to look up which module a node belongs to)
+ * @returns A function that given a node id and the current module name,
+ *          returns a markdown link string
+ */
+export declare function createLinkResolver(graph: ProductGraph): (nodeId: string, fromModule: string) => string;
+//# sourceMappingURL=link-resolver.d.ts.map

package/dist/doc-gen/link-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-resolver.d.ts","sourceRoot":"","sources":["../../src/doc-gen/link-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAsC5D;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,GAClB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,CA0ChD"}

package/dist/doc-gen/link-resolver.js

@@ -0,0 +1,87 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Doc-Gen Link Resolver
+// ---------------------------------------------------------------------------
+// Generates cross-module markdown links and same-module anchor links.
+import { toAnchor, humanize } from './format-helpers.js';
+/**
+ * Section heading anchors keyed by node kind.
+ * Used to link to the correct section within a module doc.
+ */
+const KIND_TO_SECTION = {
+    entity: 'Domain Model',
+    value: 'Domain Model',
+    enum: 'Domain Model',
+    rule: 'Business Rules',
+    actor: 'Actors & Capabilities',
+    capability: 'Actors & Capabilities',
+    workflow: 'Workflows',
+    action: 'Actions',
+    event: 'Events',
+    schedule: 'Schedules',
+    surface: 'Surfaces',
+    rendering: 'Surfaces',
+    tokens: 'Design System',
+    theme: 'Design System',
+    strings: 'Design System',
+    storage: 'Storage',
+    integration: 'Platform',
+    transport: 'Platform',
+    execution: 'Platform',
+    extension: 'Platform',
+    security: 'Governance',
+    privacy: 'Governance',
+    validation: 'Governance',
+    constitution: 'Governance',
+    secret: 'Runtime',
+    environment: 'Runtime',
+    deployment: 'Runtime',
+    test: 'Tests',
+};
+/**
+ * Create a link resolver for cross-module and same-module references.
+ *
+ * @param graph The product graph (used to look up which module a node belongs to)
+ * @returns A function that given a node id and the current module name,
+ *          returns a markdown link string
+ */
+export function createLinkResolver(graph) {
+    // Build a map from node id → { moduleName, kind, name }
+    const nodeIndex = new Map();
+    for (const mod of graph.modules) {
+        for (const [key, value] of Object.entries(mod)) {
+            if (key === 'id' || key === 'kind' || key === 'name' || key === 'imports')
+                continue;
+            /* v8 ignore next -- all graph module properties past id/kind/name/imports are arrays */
+            if (!Array.isArray(value))
+                continue;
+            for (const item of value) {
+                if (item && typeof item === 'object' && 'id' in item && 'kind' in item && 'name' in item) {
+                    nodeIndex.set(item.id, {
+                        moduleName: mod.name,
+                        kind: item.kind,
+                        name: item.name,
+                    });
+                }
+            }
+        }
+    }
+    return (nodeId, fromModule) => {
+        const node = nodeIndex.get(nodeId);
+        if (!node) {
+            // Can't resolve — just return the last segment as plain text
+            const parts = nodeId.split('.');
+            /* v8 ignore next -- split always returns ≥1 element */
+            return parts[parts.length - 1] ?? nodeId;
+        }
+        /* v8 ignore next -- all known kinds are in KIND_TO_SECTION */
+        const sectionTitle = KIND_TO_SECTION[node.kind] ?? humanize(node.kind);
+        const anchor = `#${toAnchor(sectionTitle)}`;
+        if (node.moduleName === fromModule) {
+            // Same-module anchor link
+            return `[${node.name}](${anchor})`;
+        }
+        // Cross-module link
+        return `[${node.name}](${node.moduleName}.md${anchor})`;
+    };
+}
+//# sourceMappingURL=link-resolver.js.map

package/dist/doc-gen/link-resolver.js.map

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

package/dist/doc-gen/mermaid-renderers.d.ts

@@ -0,0 +1,12 @@
+import type { ModuleNode, GraphEdge } from '../graph/graph-types.js';
+import type { WorkflowNode } from './doc-gen-types.js';
+/**
+ * Render a Mermaid erDiagram block for all entities/enums/values in a module.
+ * Returns empty array if the module has no domain objects.
+ */
+export declare function renderEntityErDiagram(mod: ModuleNode, edges: readonly GraphEdge[]): string[];
+/**
+ * Render a Mermaid flowchart for a single workflow.
+ */
+export declare function renderWorkflowFlowchart(workflow: WorkflowNode): string[];
+//# sourceMappingURL=mermaid-renderers.d.ts.map

package/dist/doc-gen/mermaid-renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-renderers.d.ts","sourceRoot":"","sources":["../../src/doc-gen/mermaid-renderers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAgB,MAAM,yBAAyB,CAAC;AAEnF,OAAO,KAAK,EAAmC,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAcxF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,SAAS,SAAS,EAAE,GAC1B,MAAM,EAAE,CA2EV;AAqDD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CA0DxE"}

package/dist/doc-gen/mermaid-renderers.js

@@ -0,0 +1,197 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Doc-Gen Mermaid Renderers
+// ---------------------------------------------------------------------------
+// Generates Mermaid ER diagrams for entities and flowcharts for workflows.
+import { formatTypeRef, getArrayProp } from './format-helpers.js';
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+function mermaidId(name) {
+    return name.replace(/[^a-zA-Z0-9_]/g, '_');
+}
+// ---------------------------------------------------------------------------
+// Entity-Relationship Diagram
+// ---------------------------------------------------------------------------
+/**
+ * Render a Mermaid erDiagram block for all entities/enums/values in a module.
+ * Returns empty array if the module has no domain objects.
+ */
+export function renderEntityErDiagram(mod, edges) {
+    const entities = getArrayProp(mod, 'entities');
+    const enums = getArrayProp(mod, 'enums');
+    const values = getArrayProp(mod, 'values');
+    if (entities.length === 0 && enums.length === 0 && values.length === 0)
+        return [];
+    const lines = [];
+    lines.push('```mermaid');
+    lines.push('erDiagram');
+    // Render entities
+    for (const entity of entities) {
+        const eid = mermaidId(entity.name).toUpperCase();
+        lines.push(`    ${eid} {`);
+        for (const field of entity.fields) {
+            const typeName = formatTypeRef(field.type);
+            const pk = field.name.endsWith('_id') || field.name === 'id' ? ' PK' : '';
+            lines.push(`        ${typeName} ${field.name}${pk}`);
+        }
+        lines.push('    }');
+    }
+    // Render value objects
+    for (const value of values) {
+        const vid = mermaidId(value.name).toUpperCase();
+        lines.push(`    ${vid} {`);
+        for (const field of value.fields) {
+            const typeName = formatTypeRef(field.type);
+            lines.push(`        ${typeName} ${field.name}`);
+        }
+        lines.push('    }');
+    }
+    // Render enums as entities with members
+    for (const en of enums) {
+        const eid = mermaidId(en.name).toUpperCase();
+        lines.push(`    ${eid} {`);
+        for (const member of en.members) {
+            lines.push(`        enum ${member.name}`);
+        }
+        lines.push('    }');
+    }
+    // Render relationships from field_type edges within this module
+    const modulePrefix = mod.id + '.';
+    const fieldTypeEdges = edges.filter(e => e.kind === 'field_type' && e.from.startsWith(modulePrefix));
+    // Build name lookup once to avoid O(n²) scanning
+    const nameById = new Map();
+    for (const e of entities)
+        nameById.set(e.id, e.name);
+    for (const v of values)
+        nameById.set(v.id, v.name);
+    for (const en of enums)
+        nameById.set(en.id, en.name);
+    const rendered = new Set();
+    for (const edge of fieldTypeEdges) {
+        /* v8 ignore next -- field_type edges always reference known entities */
+        const fromNode = nameById.get(edge.from) ?? null;
+        const toNode = nameById.get(edge.to) ?? null;
+        if (!fromNode || !toNode)
+            continue;
+        const fromId = mermaidId(fromNode).toUpperCase();
+        const toId = mermaidId(toNode).toUpperCase();
+        const key = `${fromId}-${toId}`;
+        if (rendered.has(key))
+            continue;
+        rendered.add(key);
+        const cardinality = inferCardinality(entities, values, edge.from, edge.to);
+        lines.push(`    ${fromId} ${cardinality} ${toId} : "references"`);
+    }
+    lines.push('```');
+    return lines;
+}
+function inferCardinality(entities, values, fromId, toId) {
+    // Look at the from entity's fields to find the field referencing toId
+    const allFieldContainers = [...entities, ...values];
+    for (const container of allFieldContainers) {
+        if (!fromId.startsWith(container.id))
+            continue;
+        for (const field of container.fields) {
+            if (refPointsTo(field.type, toId)) {
+                return getCardinalitySymbol(field.type);
+            }
+        }
+    }
+    return '||--||';
+}
+function refPointsTo(type, targetId) {
+    if (typeof type === 'string')
+        return false;
+    if ('ref' in type)
+        return type.ref === targetId || targetId.endsWith(`.${extractName(type.ref)}`);
+    /* v8 ignore next 2 -- exhaustive: type is always string | ref | generic */
+    if ('generic' in type)
+        return refPointsTo(type.arg, targetId);
+    /* v8 ignore next 2 -- exhaustive: type is always string | ref | generic */
+    return false;
+}
+function extractName(ref) {
+    const parts = ref.split('.');
+    /* v8 ignore next -- split always returns ≥1 element */
+    return parts[parts.length - 1] ?? ref;
+}
+function getCardinalitySymbol(type) {
+    /* v8 ignore next -- only called with ref or generic types */
+    if (typeof type === 'string')
+        return '||--||';
+    if ('ref' in type)
+        return '||--||';
+    /* v8 ignore next 4 -- all known generics handled above */
+    if ('generic' in type) {
+        if (type.generic === 'optional')
+            return '||--o|';
+        if (type.generic === 'list')
+            return '||--o{';
+    }
+    /* v8 ignore next 2 -- only optional and list generics are used */
+    return '||--||';
+}
+// ---------------------------------------------------------------------------
+// Workflow Flowchart
+// ---------------------------------------------------------------------------
+/**
+ * Render a Mermaid flowchart for a single workflow.
+ */
+export function renderWorkflowFlowchart(workflow) {
+    if (!workflow.steps || workflow.steps.length === 0)
+        return [];
+    const lines = [];
+    lines.push('```mermaid');
+    lines.push('flowchart TD');
+    const wfId = mermaidId(workflow.name);
+    lines.push(`    START([${workflow.name}]) --> S0`);
+    let idx = 0;
+    for (const step of workflow.steps) {
+        const nodeId = `S${idx}`;
+        const nextId = idx + 1 < workflow.steps.length ? `S${idx + 1}` : null;
+        if ('call' in step) {
+            lines.push(`    ${nodeId}[${step.call}]`);
+            if (nextId) {
+                lines.push(`    ${nodeId} --> ${nextId}`);
+            }
+        }
+        else if ('fail' in step) {
+            lines.push(`    ${nodeId}{{${step.fail}}}`);
+        }
+        else if ('decide' in step) {
+            lines.push(`    ${nodeId}{${step.decide}?}`);
+            for (const branch of step.branches) {
+                const branchId = `${nodeId}_${mermaidId(branch.when)}`;
+                if (branch.action.call) {
+                    lines.push(`    ${nodeId} -->|${branch.when}| ${branchId}[${branch.action.call}]`);
+                    if (nextId) {
+                        lines.push(`    ${branchId} --> ${nextId}`);
+                    }
+                }
+                else if (branch.action.fail) {
+                    lines.push(`    ${nodeId} -->|${branch.when}| ${branchId}{{${branch.action.fail}}}`);
+                }
+            }
+            // Default branch to next step
+            if (nextId) {
+                lines.push(`    ${nodeId} -->|other| ${nextId}`);
+            }
+        }
+        idx++;
+    }
+    // Effects
+    const lastStepId = `S${workflow.steps.length - 1}`;
+    if (workflow.effects) {
+        let effIdx = 0;
+        for (const effect of workflow.effects) {
+            const effId = `EFF${effIdx}`;
+            /* v8 ignore next -- effect always has entries */
+            const [kind, value] = Object.entries(effect)[0] ?? ['effect', 'unknown'];
+            lines.push(`    ${lastStepId} --> ${effId}>${kind}: ${value}]`);
+            effIdx++;
+        }
+    }
+    lines.push('```');
+    return lines;
+}
+//# sourceMappingURL=mermaid-renderers.js.map

package/dist/doc-gen/mermaid-renderers.js.map

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

package/dist/doc-gen/module-renderer.d.ts

@@ -0,0 +1,6 @@
+import type { ModuleNode, ProductGraph } from '../graph/graph-types.js';
+/**
+ * Render a complete human-readable markdown document for one module.
+ */
+export declare function renderModuleDoc(mod: ModuleNode, graph: ProductGraph, resolveString: (ref: string | null) => string | null, resolveLink: (nodeId: string, fromModule: string) => string): string;
+//# sourceMappingURL=module-renderer.d.ts.map

package/dist/doc-gen/module-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-renderer.d.ts","sourceRoot":"","sources":["../../src/doc-gen/module-renderer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAkBxE;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,EACpD,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,GAC1D,MAAM,CAiDR"}

package/dist/doc-gen/module-renderer.js

@@ -0,0 +1,54 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Doc-Gen Module Renderer
+// ---------------------------------------------------------------------------
+// Orchestrates all section renderers to produce a complete module doc.
+import { renderBanner, humanize } from './format-helpers.js';
+import { renderActorsSection, renderDomainSection, renderRulesSection, renderWorkflowsSection, renderActionsSection, renderEventsSection, renderSchedulesSection, renderSurfacesSection, renderDesignSection, renderStorageSection, renderGovernanceSection, renderTestsSection, } from './section-renderers.js';
+/**
+ * Render a complete human-readable markdown document for one module.
+ */
+export function renderModuleDoc(mod, graph, resolveString, resolveLink) {
+    const lines = [];
+    // Source file hint — use the module name as the source reference
+    lines.push(...renderBanner(`${mod.name}.prd`));
+    lines.push(`# ${humanize(mod.name)}`);
+    lines.push('');
+    // Imports
+    if (mod.imports.length > 0) {
+        lines.push('**Imports:**');
+        for (const imp of mod.imports) {
+            lines.push(`- \`${imp.symbol}\` from \`${imp.from}\`${imp.alias ? ` (as \`${imp.alias}\`)` : ''}`);
+        }
+        lines.push('');
+    }
+    // Build section context
+    const ctx = {
+        mod,
+        edges: graph.edges,
+        resolveString,
+        resolveLink,
+    };
+    // Render all sections in order
+    const sectionRenderers = [
+        renderActorsSection,
+        renderDomainSection,
+        renderRulesSection,
+        renderWorkflowsSection,
+        renderActionsSection,
+        renderEventsSection,
+        renderSchedulesSection,
+        renderSurfacesSection,
+        renderDesignSection,
+        renderStorageSection,
+        renderGovernanceSection,
+        renderTestsSection,
+    ];
+    for (const renderer of sectionRenderers) {
+        const sectionLines = renderer(ctx);
+        if (sectionLines.length > 0) {
+            lines.push(...sectionLines);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=module-renderer.js.map

package/dist/doc-gen/module-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-renderer.js","sourceRoot":"","sources":["../../src/doc-gen/module-renderer.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAC9E,uEAAuE;AAGvE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAe,EACf,KAAmB,EACnB,aAAoD,EACpD,WAA2D;IAE3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,iEAAiE;IACjE,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,UAAU;IACV,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,MAAM,aAAa,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,wBAAwB;IACxB,MAAM,GAAG,GAAmB;QAC1B,GAAG;QACH,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,aAAa;QACb,WAAW;KACZ,CAAC;IAEF,+BAA+B;IAC/B,MAAM,gBAAgB,GAAG;QACvB,mBAAmB;QACnB,mBAAmB;QACnB,kBAAkB;QAClB,sBAAsB;QACtB,oBAAoB;QACpB,mBAAmB;QACnB,sBAAsB;QACtB,qBAAqB;QACrB,mBAAmB;QACnB,oBAAoB;QACpB,uBAAuB;QACvB,kBAAkB;KACnB,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/doc-gen/product-renderer.d.ts

@@ -0,0 +1,6 @@
+import type { ProductGraph } from '../graph/graph-types.js';
+/**
+ * Render the product-level README.md overview document.
+ */
+export declare function renderProductOverview(graph: ProductGraph, resolveString: (ref: string | null) => string | null): string;
+//# sourceMappingURL=product-renderer.d.ts.map

package/dist/doc-gen/product-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-renderer.d.ts","sourceRoot":"","sources":["../../src/doc-gen/product-renderer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,yBAAyB,CAAC;AAQxE;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,GACnD,MAAM,CAqFR"}