@jterrats/smart-deployment 1.2.6 → 1.4.0

package/lib/reports/graph-export-service.d.ts

@@ -0,0 +1,85 @@
+import type { DeploymentContext } from '../deployment/deployment-context-service.js';
+import type { CircularDependency, DependencyEdge, NodeId } from '../types/dependency.js';
+export type GraphExportFormat = 'mermaid' | 'dot' | 'json' | 'html';
+export type GraphExportOptions = {
+    format: GraphExportFormat;
+    outputPath?: string;
+    reportDir?: string;
+};
+export type GraphExportResult = {
+    success: boolean;
+    format: GraphExportFormat;
+    path: string;
+    report: GraphExportReport;
+};
+export type GraphExportReport = {
+    generatedAt: string;
+    projectRoot: string;
+    summary: {
+        components: number;
+        dependencyEdges: number;
+        waves: number;
+        cycles: number;
+        isolatedComponents: number;
+    };
+    components: GraphExportComponent[];
+    edges: GraphExportEdge[];
+    waves: GraphExportWave[];
+    cycles: GraphExportCycle[];
+};
+export type GraphExportComponent = {
+    id: NodeId;
+    type: string;
+    name: string;
+    filePath?: string;
+    dependencies: NodeId[];
+    dependents: NodeId[];
+    wave?: number;
+    inCycle: boolean;
+    isolated: boolean;
+};
+export type GraphExportEdge = {
+    from: NodeId;
+    to: NodeId;
+    type: DependencyEdge['type'];
+    source?: DependencyEdge['source'];
+    reason?: string;
+    confidence?: number;
+    fromWave?: number;
+    toWave?: number;
+    crossesWave: boolean;
+    inCycle: boolean;
+};
+export type GraphExportWave = {
+    number: number;
+    componentCount: number;
+    types: string[];
+    maxDepth: number;
+    estimatedTimeSeconds: number;
+    hasCircularDependencies: boolean;
+    components: NodeId[];
+};
+export type GraphExportCycle = {
+    cycle: NodeId[];
+    severity: CircularDependency['severity'];
+    message: string;
+};
+export declare class GraphExportService {
+    generate(context: DeploymentContext, options: GraphExportOptions): Promise<GraphExportResult>;
+    createReport(context: DeploymentContext): GraphExportReport;
+    render(report: GraphExportReport, format: GraphExportFormat): string;
+    toMermaid(report: GraphExportReport): string;
+    toDot(report: GraphExportReport): string;
+    toHtml(report: GraphExportReport): string;
+    private resolveOutputPath;
+    private createComponents;
+    private createEdges;
+    private createWave;
+    private createWaveIndex;
+    private createCycleEdgeSet;
+    private toMermaidNode;
+    private toMermaidId;
+    private componentLabel;
+    private toComponentRow;
+    private toEdgeRow;
+}

package/lib/reports/graph-export-service.js

@@ -0,0 +1,296 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import * as path from 'node:path';
+const DEFAULT_REPORT_DIR = '.smart-deployment/reports/graph-export';
+const FILE_NAMES = {
+    mermaid: 'dependency-graph.mmd',
+    dot: 'dependency-graph.dot',
+    json: 'dependency-graph.json',
+    html: 'dependency-graph.html',
+};
+export class GraphExportService {
+    async generate(context, options) {
+        const report = this.createReport(context);
+        const outputPath = this.resolveOutputPath(context, options);
+        const content = this.render(report, options.format);
+        await mkdir(path.dirname(outputPath), { recursive: true });
+        await writeFile(outputPath, content, 'utf8');
+        return { success: true, format: options.format, path: outputPath, report };
+    }
+    createReport(context) {
+        const waveByComponent = this.createWaveIndex(context.orderedWaves);
+        const cycles = context.scanResult.dependencyResult.circularDependencies.map((cycle) => ({
+            cycle: [...cycle.cycle],
+            severity: cycle.severity,
+            message: cycle.message,
+        }));
+        const cycleEdges = this.createCycleEdgeSet(cycles);
+        const cycleNodes = new Set(cycles.flatMap((cycle) => cycle.cycle));
+        const components = this.createComponents(context, waveByComponent, cycleNodes);
+        const edges = this.createEdges(context.scanResult.dependencyResult.edges, waveByComponent, cycleEdges);
+        return {
+            generatedAt: new Date().toISOString(),
+            projectRoot: context.scanResult.projectRoot,
+            summary: {
+                components: components.length,
+                dependencyEdges: edges.length,
+                waves: context.orderedWaves.length,
+                cycles: cycles.length,
+                isolatedComponents: components.filter((component) => component.isolated).length,
+            },
+            components,
+            edges,
+            waves: context.orderedWaves.map((wave) => this.createWave(wave)),
+            cycles,
+        };
+    }
+    render(report, format) {
+        if (format === 'mermaid')
+            return `${this.toMermaid(report)}\n`;
+        if (format === 'dot')
+            return `${this.toDot(report)}\n`;
+        if (format === 'html')
+            return this.toHtml(report);
+        return `${JSON.stringify(report, null, 2)}\n`;
+    }
+    toMermaid(report) {
+        const lines = ['graph TD'];
+        const nodesByWave = new Map();
+        for (const component of report.components) {
+            const key = component.wave ?? 'unplaced';
+            const group = nodesByWave.get(key) ?? [];
+            group.push(component);
+            nodesByWave.set(key, group);
+        }
+        for (const [waveNumber, components] of nodesByWave.entries()) {
+            const label = waveNumber === 'unplaced' ? 'Unplaced components' : `Wave ${waveNumber}`;
+            lines.push(`  subgraph ${this.toMermaidId(`wave:${waveNumber}`)}["${escapeMermaidText(label)}"]`);
+            for (const component of components) {
+                lines.push(`    ${this.toMermaidNode(component)}`);
+            }
+            lines.push('  end');
+        }
+        for (const edge of report.edges) {
+            const label = edge.inCycle ? 'cycle' : edge.type;
+            lines.push(`  ${this.toMermaidId(edge.from)} -->|"${escapeMermaidText(label)}"| ${this.toMermaidId(edge.to)}`);
+        }
+        if (report.components.length === 0) {
+            lines.push('  empty["No components found"]');
+        }
+        lines.push('  classDef cycle fill:#fee2e2,stroke:#dc2626,stroke-width:2px');
+        lines.push('  classDef normal fill:#eff6ff,stroke:#2563eb,stroke-width:1px');
+        for (const component of report.components) {
+            lines.push(`  class ${this.toMermaidId(component.id)} ${component.inCycle ? 'cycle' : 'normal'}`);
+        }
+        return lines.join('\n');
+    }
+    toDot(report) {
+        const lines = ['digraph Dependencies {', '  rankdir=LR;', '  node [shape=box, style="rounded,filled"];'];
+        const clustered = new Set();
+        for (const wave of report.waves) {
+            lines.push(`  subgraph cluster_wave_${wave.number} {`);
+            lines.push(`    label="${escapeDot(`Wave ${wave.number}`)}";`);
+            for (const componentId of wave.components) {
+                const component = report.components.find((candidate) => candidate.id === componentId);
+                if (component) {
+                    clustered.add(component.id);
+                    lines.push(`    "${escapeDot(component.id)}" [label="${escapeDot(this.componentLabel(component))}"];`);
+                }
+            }
+            lines.push('  }');
+        }
+        for (const component of report.components.filter((candidate) => !clustered.has(candidate.id))) {
+            lines.push(`  "${escapeDot(component.id)}" [label="${escapeDot(this.componentLabel(component))}", fillcolor="${component.inCycle ? '#fee2e2' : '#eff6ff'}"];`);
+        }
+        for (const edge of report.edges) {
+            const attributes = [
+                `label="${escapeDot(edge.inCycle ? 'cycle' : edge.type)}"`,
+                edge.inCycle ? 'color="#dc2626"' : undefined,
+                edge.type === 'soft' ? 'style=dashed' : undefined,
+            ].filter((attribute) => attribute !== undefined);
+            lines.push(`  "${escapeDot(edge.from)}" -> "${escapeDot(edge.to)}" [${attributes.join(', ')}];`);
+        }
+        lines.push('}');
+        return lines.join('\n');
+    }
+    toHtml(report) {
+        const componentRows = report.components.length > 0
+            ? report.components.map((component) => this.toComponentRow(component)).join('')
+            : '<tr><td colspan="6">No components found.</td></tr>';
+        const edgeRows = report.edges.length > 0
+            ? report.edges.map((edge) => this.toEdgeRow(edge)).join('')
+            : '<tr><td colspan="6">No dependency edges found.</td></tr>';
+        const mermaid = this.toMermaid(report);
+        const dot = this.toDot(report);
+        return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <title>Dependency Graph Export</title>
+  <style>
+    body { font-family: Arial, sans-serif; margin: 24px; color: #1f2937; }
+    table { border-collapse: collapse; width: 100%; margin-top: 1rem; }
+    th, td { border: 1px solid #d1d5db; padding: 8px; text-align: left; vertical-align: top; }
+    th { background: #f3f4f6; }
+    pre { background: #f9fafb; border: 1px solid #d1d5db; padding: 12px; overflow: auto; }
+    code { white-space: nowrap; }
+    .summary { display: grid; grid-template-columns: repeat(5, minmax(0, 1fr)); gap: 12px; }
+    .card { border: 1px solid #d1d5db; border-radius: 8px; padding: 12px; background: #fff; }
+  </style>
+</head>
+<body>
+  <h1>Dependency Graph Export</h1>
+  <p>Generated at ${escapeHtml(report.generatedAt)}</p>
+  <p>Project root: <code>${escapeHtml(report.projectRoot)}</code></p>
+  <div class="summary">
+    <div class="card"><strong>Components</strong><br>${report.summary.components}</div>
+    <div class="card"><strong>Edges</strong><br>${report.summary.dependencyEdges}</div>
+    <div class="card"><strong>Waves</strong><br>${report.summary.waves}</div>
+    <div class="card"><strong>Cycles</strong><br>${report.summary.cycles}</div>
+    <div class="card"><strong>Isolated</strong><br>${report.summary.isolatedComponents}</div>
+  </div>
+  <h2>Components</h2>
+  <table><thead><tr><th>ID</th><th>Type</th><th>Name</th><th>Wave</th><th>Cycle</th><th>File</th></tr></thead><tbody>${componentRows}</tbody></table>
+  <h2>Dependency Edges</h2>
+  <table><thead><tr><th>From</th><th>To</th><th>Type</th><th>Source</th><th>Waves</th><th>Cycle</th></tr></thead><tbody>${edgeRows}</tbody></table>
+  <h2>Mermaid</h2><pre>${escapeHtml(mermaid)}</pre>
+  <h2>DOT</h2><pre>${escapeHtml(dot)}</pre>
+  <h2>JSON</h2><pre>${escapeHtml(JSON.stringify(report, null, 2))}</pre>
+</body>
+</html>
+    `.trim();
+    }
+    resolveOutputPath(context, options) {
+        if (options.outputPath)
+            return path.resolve(options.outputPath);
+        const reportDir = options.reportDir ?? path.join(context.scanResult.projectRoot, DEFAULT_REPORT_DIR);
+        return path.join(reportDir, FILE_NAMES[options.format]);
+    }
+    createComponents(context, waveByComponent, cycleNodes) {
+        const graphNodes = new Set(context.scanResult.dependencyResult.graph.keys());
+        for (const dependencies of context.scanResult.dependencyResult.graph.values()) {
+            for (const dependency of dependencies)
+                graphNodes.add(dependency);
+        }
+        for (const nodeId of context.scanResult.dependencyResult.components.keys())
+            graphNodes.add(nodeId);
+        return [...graphNodes]
+            .sort((left, right) => left.localeCompare(right))
+            .map((nodeId) => {
+            const component = context.scanResult.dependencyResult.components.get(nodeId);
+            const dependencies = [...(context.scanResult.dependencyResult.graph.get(nodeId) ?? [])].sort((left, right) => left.localeCompare(right));
+            const dependents = [...(context.scanResult.dependencyResult.reverseGraph.get(nodeId) ?? [])].sort((left, right) => left.localeCompare(right));
+            const parsed = parseNodeId(nodeId, component);
+            return {
+                id: nodeId,
+                type: parsed.type,
+                name: parsed.name,
+                filePath: component?.filePath,
+                dependencies,
+                dependents,
+                wave: waveByComponent.get(nodeId),
+                inCycle: cycleNodes.has(nodeId),
+                isolated: dependencies.length === 0 && dependents.length === 0,
+            };
+        });
+    }
+    createEdges(edges, waveByComponent, cycleEdges) {
+        return [...edges]
+            .sort((left, right) => `${left.from}->${left.to}`.localeCompare(`${right.from}->${right.to}`))
+            .map((edge) => {
+            const fromWave = waveByComponent.get(edge.from);
+            const toWave = waveByComponent.get(edge.to);
+            return {
+                from: edge.from,
+                to: edge.to,
+                type: edge.type,
+                source: edge.source,
+                reason: edge.reason,
+                confidence: edge.confidence,
+                fromWave,
+                toWave,
+                crossesWave: fromWave !== undefined && toWave !== undefined && fromWave !== toWave,
+                inCycle: cycleEdges.has(edgeKey(edge.from, edge.to)),
+            };
+        });
+    }
+    createWave(wave) {
+        return {
+            number: wave.number,
+            componentCount: wave.metadata.componentCount,
+            types: [...wave.metadata.types].sort((left, right) => left.localeCompare(right)),
+            maxDepth: wave.metadata.maxDepth,
+            estimatedTimeSeconds: wave.metadata.estimatedTime,
+            hasCircularDependencies: wave.metadata.hasCircularDeps,
+            components: [...wave.components].sort((left, right) => left.localeCompare(right)),
+        };
+    }
+    createWaveIndex(waves) {
+        const waveByComponent = new Map();
+        for (const wave of waves) {
+            for (const component of wave.components)
+                waveByComponent.set(component, wave.number);
+        }
+        return waveByComponent;
+    }
+    createCycleEdgeSet(cycles) {
+        const cycleEdges = new Set();
+        for (const cycle of cycles) {
+            for (let index = 0; index < cycle.cycle.length; index += 1) {
+                const from = cycle.cycle[index];
+                const to = cycle.cycle[(index + 1) % cycle.cycle.length];
+                if (from && to)
+                    cycleEdges.add(edgeKey(from, to));
+            }
+        }
+        return cycleEdges;
+    }
+    toMermaidNode(component) {
+        return `${this.toMermaidId(component.id)}["${escapeMermaidText(this.componentLabel(component))}"]`;
+    }
+    toMermaidId(value) {
+        return `n_${value.replace(/[^a-zA-Z0-9_]/g, '_')}`;
+    }
+    componentLabel(component) {
+        const markers = [
+            component.wave === undefined ? 'unplaced' : `wave ${component.wave}`,
+            component.inCycle ? 'cycle' : '',
+        ]
+            .filter(Boolean)
+            .join(', ');
+        return markers ? `${component.type}:${component.name} (${markers})` : `${component.type}:${component.name}`;
+    }
+    toComponentRow(component) {
+        return `<tr><td><code>${escapeHtml(component.id)}</code></td><td>${escapeHtml(component.type)}</td><td>${escapeHtml(component.name)}</td><td>${component.wave ?? 'Unplaced'}</td><td>${component.inCycle ? 'Yes' : 'No'}</td><td><code>${escapeHtml(component.filePath ?? '')}</code></td></tr>`;
+    }
+    toEdgeRow(edge) {
+        const waves = edge.fromWave === undefined || edge.toWave === undefined ? 'Unplaced' : `${edge.fromWave} -> ${edge.toWave}`;
+        return `<tr><td><code>${escapeHtml(edge.from)}</code></td><td><code>${escapeHtml(edge.to)}</code></td><td>${escapeHtml(edge.type)}</td><td>${escapeHtml(edge.source ?? '')}</td><td>${escapeHtml(waves)}</td><td>${edge.inCycle ? 'Yes' : 'No'}</td></tr>`;
+    }
+}
+function parseNodeId(nodeId, component) {
+    if (component)
+        return { type: component.type, name: component.name };
+    const separatorIndex = nodeId.indexOf(':');
+    if (separatorIndex === -1)
+        return { type: 'Unknown', name: nodeId };
+    return { type: nodeId.slice(0, separatorIndex), name: nodeId.slice(separatorIndex + 1) };
+}
+function edgeKey(from, to) {
+    return `${from}->${to}`;
+}
+function escapeMermaidText(value) {
+    return value.replaceAll('&', '&amp;').replaceAll('"', '&quot;').replaceAll('[', '(').replaceAll(']', ')');
+}
+function escapeDot(value) {
+    return value.replaceAll('\\', '\\\\').replaceAll('"', '\\"').replaceAll('\n', '\\n');
+}
+function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&amp;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}
+//# sourceMappingURL=graph-export-service.js.map

package/lib/reports/graph-export-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-export-service.js","sourceRoot":"","sources":["../../src/reports/graph-export-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AA8ElC,MAAM,kBAAkB,GAAG,wCAAwC,CAAC;AACpE,MAAM,UAAU,GAAsC;IACpD,OAAO,EAAE,sBAAsB;IAC/B,GAAG,EAAE,sBAAsB;IAC3B,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,uBAAuB;CAC9B,CAAC;AAEF,MAAM,OAAO,kBAAkB;IACtB,KAAK,CAAC,QAAQ,CAAC,OAA0B,EAAE,OAA2B;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAEpD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAC7E,CAAC;IAEM,YAAY,CAAC,OAA0B;QAC5C,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACtF,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;YACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC,CAAC;QACJ,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAEvG,OAAO;YACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,WAAW;YAC3C,OAAO,EAAE;gBACP,UAAU,EAAE,UAAU,CAAC,MAAM;gBAC7B,eAAe,EAAE,KAAK,CAAC,MAAM;gBAC7B,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM;gBAClC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,kBAAkB,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM;aAChF;YACD,UAAU;YACV,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAChE,MAAM;SACP,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,MAAyB,EAAE,MAAyB;QAChE,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/D,IAAI,MAAM,KAAK,KAAK;YAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;QACvD,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;IAEM,SAAS,CAAC,MAAyB;QACxC,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3B,MAAM,WAAW,GAAG,IAAI,GAAG,EAA+C,CAAC;QAE3E,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,IAAI,UAAU,CAAC;YACzC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QAED,KAAK,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAG,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,QAAQ,UAAU,EAAE,CAAC;YACvF,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,WAAW,CAAC,QAAQ,UAAU,EAAE,CAAC,KAAK,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClG,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,iBAAiB,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACjH,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC/C,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;QAC7E,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpG,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,MAAyB;QACpC,MAAM,KAAK,GAAG,CAAC,wBAAwB,EAAE,eAAe,EAAE,6CAA6C,CAAC,CAAC;QACzG,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QAEpC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,2BAA2B,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;YAC/D,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;gBACtF,IAAI,SAAS,EAAE,CAAC;oBACd,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;oBAC5B,KAAK,CAAC,IAAI,CAAC,QAAQ,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,aAAa,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;gBACzG,CAAC;YACH,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC9F,KAAK,CAAC,IAAI,CACR,MAAM,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,aAAa,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,iBACjF,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAClC,KAAK,CACN,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG;gBACjB,UAAU,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAC1D,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;gBAC5C,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;aAClD,CAAC,MAAM,CAAC,CAAC,SAAS,EAAuB,EAAE,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnG,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEM,MAAM,CAAC,MAAyB;QACrC,MAAM,aAAa,GACjB,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YAC1B,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/E,CAAC,CAAC,oDAAoD,CAAC;QAC3D,MAAM,QAAQ,GACZ,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YACrB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,CAAC,CAAC,0DAA0D,CAAC;QACjE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE/B,OAAO;;;;;;;;;;;;;;;;;;;oBAmBS,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC;2BACvB,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC;;uDAEF,MAAM,CAAC,OAAO,CAAC,UAAU;kDAC9B,MAAM,CAAC,OAAO,CAAC,eAAe;kDAC9B,MAAM,CAAC,OAAO,CAAC,KAAK;mDACnB,MAAM,CAAC,OAAO,CAAC,MAAM;qDACnB,MAAM,CAAC,OAAO,CAAC,kBAAkB;;;uHAGiC,aAAa;;0HAEV,QAAQ;yBACzG,UAAU,CAAC,OAAO,CAAC;qBACvB,UAAU,CAAC,GAAG,CAAC;sBACd,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;;;KAG5D,CAAC,IAAI,EAAE,CAAC;IACX,CAAC;IAEO,iBAAiB,CAAC,OAA0B,EAAE,OAA2B;QAC/E,IAAI,OAAO,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;QACrG,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEO,gBAAgB,CACtB,OAA0B,EAC1B,eAA4C,EAC5C,UAA+B;QAE/B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACrF,KAAK,MAAM,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9E,KAAK,MAAM,UAAU,IAAI,YAAY;gBAAE,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACpE,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE;YAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEnG,OAAO,CAAC,GAAG,UAAU,CAAC;aACnB,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;aAChD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACd,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC7E,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC3G,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAC1B,CAAC;YACF,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAC/F,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAC3C,CAAC;YACF,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC9C,OAAO;gBACL,EAAE,EAAE,MAAM;gBACV,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,SAAS,EAAE,QAAQ;gBAC7B,YAAY;gBACZ,UAAU;gBACV,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC;gBACjC,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;gBAC/B,QAAQ,EAAE,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;aAC/D,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,WAAW,CACjB,KAAuB,EACvB,eAA4C,EAC5C,UAA+B;QAE/B,OAAO,CAAC,GAAG,KAAK,CAAC;aACd,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;aAC7F,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5C,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ;gBACR,MAAM;gBACN,WAAW,EAAE,QAAQ,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,QAAQ,KAAK,MAAM;gBAClF,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;aACrD,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,UAAU,CAAC,IAAU;QAC3B,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc;YAC5C,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAChF,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAChC,oBAAoB,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa;YACjD,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe;YACtD,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;SAClF,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,KAAa;QACnC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;QAClD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU;gBAAE,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IAEO,kBAAkB,CAAC,MAA0B;QACnD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAChC,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACzD,IAAI,IAAI,IAAI,EAAE;oBAAE,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,aAAa,CAAC,SAA+B;QACnD,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC;IACrG,CAAC;IAEO,WAAW,CAAC,KAAa;QAC/B,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC;IACrD,CAAC;IAEO,cAAc,CAAC,SAA+B;QACpD,MAAM,OAAO,GAAG;YACd,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,SAAS,CAAC,IAAI,EAAE;YACpE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;SACjC;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;IAC9G,CAAC;IAEO,cAAc,CAAC,SAA+B;QACpD,OAAO,iBAAiB,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,mBAAmB,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,UAAU,CACjH,SAAS,CAAC,IAAI,CACf,YAAY,SAAS,CAAC,IAAI,IAAI,UAAU,YAAY,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,kBAAkB,UAAU,CAC/G,SAAS,CAAC,QAAQ,IAAI,EAAE,CACzB,mBAAmB,CAAC;IACvB,CAAC;IAEO,SAAS,CAAC,IAAqB;QACrC,MAAM,KAAK,GACT,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/G,OAAO,iBAAiB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,UAAU,CAC9E,IAAI,CAAC,EAAE,CACR,mBAAmB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,UAAU,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,YAAY,UAAU,CACtG,KAAK,CACN,YAAY,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC;IACvD,CAAC;CACF;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,SAA6B;IAChE,IAAI,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;IACrE,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,cAAc,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACpE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,EAAU;IACvC,OAAO,GAAG,IAAI,KAAK,EAAE,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC5G,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC"}

package/lib/reports/release-report-builder.d.ts

@@ -0,0 +1,6 @@
+import { type ReleaseReportClock, type ReleaseReportFacts, type ReleaseReportV1 } from '../types/release-report.js';
+export declare class ReleaseReportBuilder {
+    private readonly clock;
+    constructor(clock?: ReleaseReportClock);
+    build(facts: ReleaseReportFacts): ReleaseReportV1;
+}

package/lib/reports/release-report-builder.js

@@ -0,0 +1,115 @@
+import { RELEASE_PHASE_ORDER, RELEASE_REPORT_SCHEMA_VERSION, RELEASE_ROUTE_ORDER, } from '../types/release-report.js';
+const SYSTEM_CLOCK = {
+    now: () => new Date(),
+};
+export class ReleaseReportBuilder {
+    clock;
+    constructor(clock = SYSTEM_CLOCK) {
+        this.clock = clock;
+    }
+    build(facts) {
+        const phases = facts.phases.map(toPhase).sort(comparePhases);
+        const items = facts.items.map(toItem).sort(compareItems);
+        return {
+            schemaVersion: RELEASE_REPORT_SCHEMA_VERSION,
+            generatedAt: this.clock.now().toISOString(),
+            command: facts.command,
+            targetOrg: facts.targetOrg,
+            analysisMode: facts.analysisMode,
+            enrichment: {
+                status: facts.enrichment.status,
+                warnings: sortedUnique(facts.enrichment.warnings),
+            },
+            outcome: facts.outcome,
+            summary: summarize(items),
+            phases,
+            items,
+            reportWarnings: sortedUnique(facts.reportWarnings) ?? [],
+        };
+    }
+}
+function toPhase(phase) {
+    return {
+        ...phase,
+        status: normalizeStatus(phase.status),
+        evidence: sortEvidence(phase.evidence),
+        remediation: sortedUnique(phase.remediation),
+    };
+}
+function toItem(item) {
+    return {
+        ...item,
+        status: normalizeStatus(item.status),
+        evidenceReferences: sortedUnique(item.evidenceReferences),
+        remediation: sortedUnique(item.remediation),
+    };
+}
+function normalizeStatus(status) {
+    if (status === 'unknown')
+        return 'needs_review';
+    if (status === 'inapplicable')
+        return 'skipped';
+    return status;
+}
+function comparePhases(left, right) {
+    return (RELEASE_PHASE_ORDER[left.id] - RELEASE_PHASE_ORDER[right.id] ||
+        RELEASE_ROUTE_ORDER[left.route] - RELEASE_ROUTE_ORDER[right.route] ||
+        lexicalCompare(left.operation, right.operation));
+}
+function compareItems(left, right) {
+    return (RELEASE_PHASE_ORDER[left.phaseId] - RELEASE_PHASE_ORDER[right.phaseId] ||
+        RELEASE_ROUTE_ORDER[left.route] - RELEASE_ROUTE_ORDER[right.route] ||
+        lexicalCompare(left.metadataType, right.metadataType) ||
+        lexicalCompare(left.fullName, right.fullName) ||
+        lexicalCompare(left.targetOrg ?? '', right.targetOrg ?? ''));
+}
+function sortEvidence(evidence) {
+    if (!evidence)
+        return undefined;
+    const byKey = new Map();
+    for (const entry of evidence) {
+        const copy = { ...entry };
+        byKey.set(JSON.stringify(copy), copy);
+    }
+    return [...byKey.values()].sort((left, right) => lexicalCompare(left.tool, right.tool) ||
+        lexicalCompare(left.operationId, right.operationId) ||
+        lexicalCompare(left.deploymentId ?? '', right.deploymentId ?? '') ||
+        lexicalCompare(left.artifact ?? '', right.artifact ?? '') ||
+        (left.exitCode ?? -1) - (right.exitCode ?? -1));
+}
+function summarize(items) {
+    let succeeded = 0;
+    let failed = 0;
+    let skipped = 0;
+    let needsReview = 0;
+    for (const item of items) {
+        if (item.status === 'succeeded')
+            succeeded += 1;
+        else if (item.status === 'failed')
+            failed += 1;
+        else if (item.status === 'skipped')
+            skipped += 1;
+        else
+            needsReview += 1;
+    }
+    return {
+        total: items.length,
+        succeeded,
+        failed,
+        skipped,
+        needsReview,
+    };
+}
+function sortedUnique(values) {
+    if (!values)
+        return undefined;
+    return [...new Set(values)].sort(lexicalCompare);
+}
+function lexicalCompare(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=release-report-builder.js.map

package/lib/reports/release-report-builder.js.map

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

package/lib/reports/release-report-command-adapter.d.ts

@@ -0,0 +1,14 @@
+import { ReleaseReportPresenter, type ReleaseReportPresenterIO } from '../presentation/release-report-presenter.js';
+import type { ReleaseReportFacts, ReleaseReportV1 } from '../types/release-report.js';
+import { ReleaseReportService, type ReleaseReportServiceOptions, type UnderlyingOperationResult } from './release-report-service.js';
+export type ReleaseReportCommandOutput = {
+    releaseReport?: ReleaseReportV1;
+    releaseReportPath?: string;
+    releaseReportWarning?: string;
+};
+export declare class ReleaseReportCommandAdapter {
+    private readonly service;
+    private readonly presenter;
+    constructor(service?: ReleaseReportService, presenter?: ReleaseReportPresenter);
+    finalize<T>(io: ReleaseReportPresenterIO, underlying: UnderlyingOperationResult<T>, facts: ReleaseReportFacts, options: ReleaseReportServiceOptions): Promise<ReleaseReportCommandOutput>;
+}

package/lib/reports/release-report-command-adapter.js

@@ -0,0 +1,28 @@
+import { ReleaseReportPresenter } from '../presentation/release-report-presenter.js';
+import { ReleaseReportService, } from './release-report-service.js';
+export class ReleaseReportCommandAdapter {
+    service;
+    presenter;
+    constructor(service = new ReleaseReportService(), presenter = new ReleaseReportPresenter()) {
+        this.service = service;
+        this.presenter = presenter;
+    }
+    async finalize(io, underlying, facts, options) {
+        const finalized = await this.service.finalize(underlying, facts, options);
+        this.presenter.presentFinalization(io, finalized.report);
+        if (finalized.report.kind === 'unavailable') {
+            if (finalized.report.report)
+                this.presenter.present(io, finalized.report.report);
+            return {
+                releaseReport: finalized.report.report,
+                releaseReportWarning: finalized.report.warning,
+            };
+        }
+        this.presenter.present(io, finalized.report.report);
+        return {
+            releaseReport: finalized.report.report,
+            releaseReportPath: finalized.report.path,
+        };
+    }
+}
+//# sourceMappingURL=release-report-command-adapter.js.map

package/lib/reports/release-report-command-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-report-command-adapter.js","sourceRoot":"","sources":["../../src/reports/release-report-command-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAiC,MAAM,6CAA6C,CAAC;AAEpH,OAAO,EACL,oBAAoB,GAGrB,MAAM,6BAA6B,CAAC;AAQrC,MAAM,OAAO,2BAA2B;IAEnB;IACA;IAFnB,YACmB,UAAU,IAAI,oBAAoB,EAAE,EACpC,YAAY,IAAI,sBAAsB,EAAE;QADxC,YAAO,GAAP,OAAO,CAA6B;QACpC,cAAS,GAAT,SAAS,CAA+B;IACxD,CAAC;IAEG,KAAK,CAAC,QAAQ,CACnB,EAA4B,EAC5B,UAAwC,EACxC,KAAyB,EACzB,OAAoC;QAEpC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1E,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAEzD,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC5C,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM;gBAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACjF,OAAO;gBACL,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM;gBACtC,oBAAoB,EAAE,SAAS,CAAC,MAAM,CAAC,OAAO;aAC/C,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO;YACL,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM;YACtC,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI;SACzC,CAAC;IACJ,CAAC;CACF"}

package/lib/reports/release-report-facts-factory.d.ts

@@ -0,0 +1,14 @@
+import type { DeploymentValidationSummary } from '../deployment/deployment-validation-service.js';
+import type { DeploymentContext } from '../deployment/deployment-context-service.js';
+import type { SpecialDeploymentExecutionResult } from '../deployment/special-deployment-executor.js';
+import type { SpecialDeploymentPlan } from '../deployment/special-deployment-plan.js';
+import type { ReleaseReportFacts } from '../types/release-report.js';
+export declare function buildCiPublishReportFacts(plan: SpecialDeploymentPlan, execution?: SpecialDeploymentExecutionResult): ReleaseReportFacts;
+export declare function buildValidationReportFacts(summary: DeploymentValidationSummary, targetOrg: string | undefined, useAI: boolean): ReleaseReportFacts;
+export declare function buildStartReportFacts(context: DeploymentContext, options: {
+    targetOrg?: string;
+    dryRun: boolean;
+    validateOnly: boolean;
+    failed?: boolean;
+    warning?: string;
+}): ReleaseReportFacts;