@angriff36/manifest 2.18.0

package/packages/cli/dist/commands/breaking-change.js

@@ -0,0 +1,150 @@
+/**
+ * CLI command: manifest diff breaking <oldIR> <newIR>
+ *
+ * Classifies IR diffs as compatible/deprecated/breaking with consumer impact
+ * analysis. Supports acknowledgments file for CI integration.
+ */
+import fs from 'node:fs/promises';
+import chalk from 'chalk';
+import ora from 'ora';
+import { diffIR } from '@angriff36/manifest/ir-diff';
+import { classifyBreakingChanges } from '@angriff36/manifest/breaking-change';
+function createSpinner(message, enabled) {
+    if (!enabled) {
+        return {
+            text: message,
+            stop() { },
+            fail(_msg) { },
+        };
+    }
+    return ora(message).start();
+}
+function tableLine(label, value) {
+    return label.padEnd(26) + ' ' + value;
+}
+async function loadIRFile(path) {
+    const content = await fs.readFile(path, 'utf-8');
+    return JSON.parse(content);
+}
+async function loadAcknowledgments(path) {
+    try {
+        const content = await fs.readFile(path, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (parsed.version !== 1) {
+            throw new Error('Unsupported acknowledgments file version: ' + String(parsed.version));
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return undefined;
+        }
+        throw error;
+    }
+}
+function printHumanReadableReport(report, oldPath, newPath, ackPath) {
+    console.log(chalk.bold('\nBreaking Change Analysis'));
+    console.log('');
+    console.log(chalk.cyan('Files'));
+    console.log(tableLine('Old IR', oldPath));
+    console.log(tableLine('New IR', newPath));
+    if (ackPath)
+        console.log(tableLine('Acknowledgments', ackPath));
+    console.log('');
+    console.log(chalk.bold('Summary'));
+    console.log(tableLine('Compatible changes', chalk.green(String(report.summary.compatible))));
+    console.log(tableLine('Deprecated changes', chalk.yellow(String(report.summary.deprecated))));
+    console.log(tableLine('Breaking changes', chalk.red(String(report.summary.breaking))));
+    console.log(tableLine('Total', String(report.summary.total)));
+    if (report.summary.breaking > 0) {
+        console.log('');
+        console.log(chalk.bold(chalk.red('Breaking Changes')));
+        for (const change of report.classified.filter(c => c.severity === 'breaking')) {
+            const acked = report.acknowledged.includes(change);
+            const marker = acked ? chalk.gray('[ACK]') : chalk.red('[NEW]');
+            console.log('  ' + marker + ' ' + change.path);
+            console.log('         ' + change.description);
+            if (change.consumerImpact.length > 0) {
+                console.log('         Impact: ' + change.consumerImpact.join(', '));
+            }
+        }
+    }
+    if (report.summary.deprecated > 0) {
+        console.log('');
+        console.log(chalk.bold(chalk.yellow('Deprecated Changes')));
+        for (const change of report.classified.filter(c => c.severity === 'deprecated')) {
+            console.log('  ' + chalk.yellow('[DEP]') + ' ' + change.path);
+            console.log('         ' + change.description);
+        }
+    }
+    if (report.consumerImpact.commands.length > 0) {
+        console.log('');
+        console.log(chalk.bold('Affected Commands'));
+        for (const cmd of report.consumerImpact.commands) {
+            console.log('  - ' + cmd);
+        }
+    }
+    if (report.consumerImpact.routes.length > 0) {
+        console.log('');
+        console.log(chalk.bold('Affected Routes'));
+        for (const route of report.consumerImpact.routes) {
+            console.log('  - ' + route);
+        }
+    }
+    if (report.consumerImpact.projections.length > 0) {
+        console.log('');
+        console.log(chalk.bold('Affected Projections'));
+        for (const proj of report.consumerImpact.projections) {
+            console.log('  - ' + proj);
+        }
+    }
+    if (report.unacknowledged.length > 0) {
+        console.log('');
+        console.log(chalk.yellow('\n' + report.unacknowledged.length + ' unacknowledged breaking change(s) found.'));
+        console.log(chalk.gray('Add entries to the acknowledgments file to suppress CI failures.'));
+    }
+    else if (report.summary.breaking > 0 && report.unacknowledged.length === 0) {
+        console.log('');
+        console.log(chalk.green('All breaking changes have been acknowledged.'));
+    }
+}
+export async function breakingChangeCommand(oldIRPath, newIRPath, options = {}) {
+    const spinner = createSpinner('Analyzing breaking changes', !options.json);
+    try {
+        const [oldIR, newIR] = await Promise.all([
+            loadIRFile(oldIRPath),
+            loadIRFile(newIRPath),
+        ]);
+        spinner.stop();
+        const diffReport = diffIR(oldIR, newIR);
+        const acks = options.ack ? await loadAcknowledgments(options.ack) : undefined;
+        const report = classifyBreakingChanges(diffReport, acks);
+        if (options.json) {
+            const output = JSON.stringify(report, null, 2);
+            if (options.output) {
+                await fs.writeFile(options.output, output, 'utf-8');
+                console.log(chalk.green('Report written to ' + options.output));
+            }
+            else {
+                console.log(output);
+            }
+        }
+        else {
+            if (options.output) {
+                await fs.writeFile(options.output, JSON.stringify(report, null, 2), 'utf-8');
+                console.log(chalk.green('Report written to ' + options.output));
+            }
+            printHumanReadableReport(report, oldIRPath, newIRPath, options.ack);
+        }
+        // CI mode: exit non-zero on unacknowledged breaking changes
+        if (options.ci && report.unacknowledged.length > 0) {
+            process.exit(1);
+        }
+        return report;
+    }
+    catch (error) {
+        spinner.fail('diff breaking failed: ' + (error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=breaking-change.js.map

package/packages/cli/dist/commands/breaking-change.js.map

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

package/packages/cli/dist/commands/build.d.ts

@@ -0,0 +1,26 @@
+/**
+ * manifest build command
+ *
+ * Compiles .manifest to IR and generates code in one step.
+ */
+interface BuildOptions {
+    projection: string;
+    surface: string;
+    irOutput: string;
+    codeOutput: string;
+    glob?: string;
+    auth: string;
+    database: string;
+    runtime: string;
+    response: string;
+    /** Forwarded to generate.ts so dispatcher/concreteCommandRoutes config flows through. */
+    projectionOptionsFromConfig?: Record<string, unknown>;
+}
+/**
+ * Build command handler
+ *
+ * Combines compile + generate in a single workflow.
+ */
+export declare function buildCommand(source: string | undefined, options: BuildOptions): Promise<void>;
+export {};
+//# sourceMappingURL=build.d.ts.map

package/packages/cli/dist/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,2BAA2B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvD;AAGD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/packages/cli/dist/commands/build.js

@@ -0,0 +1,58 @@
+/**
+ * manifest build command
+ *
+ * Compiles .manifest to IR and generates code in one step.
+ */
+import path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import { compileCommand } from './compile.js';
+import { generateCommand } from './generate.js';
+/**
+ * Build command handler
+ *
+ * Combines compile + generate in a single workflow.
+ */
+export async function buildCommand(source, options) {
+    const spinner = ora('Manifest build workflow').start();
+    try {
+        // Step 1: Compile to IR
+        spinner.text = 'Step 1/2: Compiling .manifest to IR...';
+        // Run compile (silent mode, we handle output)
+        const compileSpinner = ora('Compiling').start();
+        await compileCommand(source, {
+            output: options.irOutput,
+            glob: options.glob,
+            diagnostics: false,
+            pretty: true,
+        });
+        compileSpinner.succeed('Compiled to IR');
+        // Step 2: Generate code from IR
+        spinner.text = 'Step 2/2: Generating code from IR...';
+        await generateCommand(options.irOutput, {
+            projection: options.projection,
+            surface: options.surface,
+            output: options.codeOutput,
+            auth: options.auth,
+            database: options.database,
+            runtime: options.runtime,
+            response: options.response,
+            projectionOptionsFromConfig: options.projectionOptionsFromConfig,
+        });
+        spinner.succeed(`Build complete: IR → ${options.irOutput}, Code → ${options.codeOutput}`);
+        // Show summary
+        console.log('');
+        console.log(chalk.bold('Build Summary:'));
+        console.log(`  IR output:  ${path.relative(process.cwd(), options.irOutput)}`);
+        console.log(`  Code output: ${path.relative(process.cwd(), options.codeOutput)}`);
+        console.log(`  Projection: ${options.projection}`);
+        console.log(`  Surface:    ${options.surface}`);
+        console.log('');
+    }
+    catch (error) {
+        spinner.fail(`Build failed: ${error instanceof Error ? error.message : String(error)}`);
+        console.error(error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=build.js.map

package/packages/cli/dist/commands/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAiBhD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA0B,EAC1B,OAAqB;IAErB,MAAM,OAAO,GAAG,GAAG,CAAC,yBAAyB,CAAC,CAAC,KAAK,EAAE,CAAC;IAEvD,IAAI,CAAC;QACH,wBAAwB;QACxB,OAAO,CAAC,IAAI,GAAG,wCAAwC,CAAC;QAExD,8CAA8C;QAC9C,MAAM,cAAc,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC;QAEhD,MAAM,cAAc,CAAC,MAAM,EAAE;YAC3B,MAAM,EAAE,OAAO,CAAC,QAAQ;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QAEH,cAAc,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAEzC,gCAAgC;QAChC,OAAO,CAAC,IAAI,GAAG,sCAAsC,CAAC;QAEtD,MAAM,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE;YACtC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,UAAU;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,2BAA2B,EAAE,OAAO,CAAC,2BAA2B;SACjE,CAAC,CAAC;QAEH,OAAO,CAAC,OAAO,CAAC,wBAAwB,OAAO,CAAC,QAAQ,YAAY,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAE1F,eAAe;QACf,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClF,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAElB,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,iBAAiB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxF,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/packages/cli/dist/commands/changelog.d.ts

@@ -0,0 +1,26 @@
+/**
+ * manifest changelog <from-ref> [to-ref]
+ *
+ * Generates a human-readable Markdown changelog from IR diffs between two
+ * Git refs (tags, branches, SHAs). Compiles .manifest sources at each ref,
+ * diffs the resulting IR, classifies changes, and emits Markdown formatted
+ * for GitHub Releases and Keep a Changelog conventions.
+ *
+ * Usage:
+ *   manifest changelog v1.0.0 v1.1.0
+ *   manifest changelog v1.0.0              # compares to HEAD
+ *   manifest changelog v1.0.0 --json       # structured JSON output
+ *   manifest changelog v1.0.0 -o CHANGELOG.md
+ */
+export interface ChangelogOptions {
+    /** Glob pattern for .manifest sources (default: **\/*.manifest) */
+    source?: string;
+    /** Output file path (writes Markdown or JSON depending on --json) */
+    output?: string;
+    /** Emit structured JSON instead of Markdown */
+    json?: boolean;
+    /** Custom title for the changelog heading */
+    title?: string;
+}
+export declare function changelogCommand(fromRef: string, toRef: string, options?: ChangelogOptions): Promise<void>;
+//# sourceMappingURL=changelog.d.ts.map

package/packages/cli/dist/commands/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/commands/changelog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA2BH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgUD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAkFf"}

package/packages/cli/dist/commands/changelog.js

@@ -0,0 +1,365 @@
+/**
+ * manifest changelog <from-ref> [to-ref]
+ *
+ * Generates a human-readable Markdown changelog from IR diffs between two
+ * Git refs (tags, branches, SHAs). Compiles .manifest sources at each ref,
+ * diffs the resulting IR, classifies changes, and emits Markdown formatted
+ * for GitHub Releases and Keep a Changelog conventions.
+ *
+ * Usage:
+ *   manifest changelog v1.0.0 v1.1.0
+ *   manifest changelog v1.0.0              # compares to HEAD
+ *   manifest changelog v1.0.0 --json       # structured JSON output
+ *   manifest changelog v1.0.0 -o CHANGELOG.md
+ */
+import fs from 'node:fs/promises';
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+import ora from 'ora';
+// ============================================================================
+// Lazy loaders (match vitest alias resolution pattern used by other commands)
+// ============================================================================
+async function loadCompiler() {
+    return await import('@angriff36/manifest/ir-compiler');
+}
+async function loadDiff() {
+    return await import('@angriff36/manifest/ir-diff');
+}
+async function loadBreaking() {
+    return await import('@angriff36/manifest/breaking-change');
+}
+// ============================================================================
+// Git helpers
+// ============================================================================
+function gitShowFile(ref, filePath) {
+    try {
+        return execSync(`git show ${ref}:${filePath}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            maxBuffer: 10 * 1024 * 1024,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+function gitListFiles(ref, pattern) {
+    try {
+        const output = execSync(`git ls-tree -r --name-only ${ref}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        const allFiles = output.trim().split('\n').filter(Boolean);
+        // Match against the glob pattern (simple: ends with .manifest)
+        const suffix = '.manifest';
+        if (pattern === '**/*.manifest' || pattern === '*.manifest') {
+            return allFiles.filter(f => f.endsWith(suffix));
+        }
+        // For custom patterns, do a basic directory prefix match
+        const prefix = pattern.replace(/\*\*\/\*\.manifest$/, '').replace(/\*\.manifest$/, '');
+        return allFiles.filter(f => f.endsWith(suffix) && f.startsWith(prefix));
+    }
+    catch {
+        return [];
+    }
+}
+function gitRefExists(ref) {
+    try {
+        execSync(`git rev-parse --verify ${ref}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function gitRefLabel(ref) {
+    try {
+        // Try to get tag name or branch name
+        const tag = execSync(`git describe --tags --exact-match ${ref}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (tag)
+            return tag;
+    }
+    catch {
+        // Not an exact tag — fall through
+    }
+    return ref;
+}
+// ============================================================================
+// Compile manifest sources at a given Git ref
+// ============================================================================
+async function compileAtRef(ref, sourcePattern) {
+    const compiler = await loadCompiler();
+    const files = gitListFiles(ref, sourcePattern);
+    if (files.length === 0) {
+        return { ir: null, error: `No .manifest files found at ref '${ref}'` };
+    }
+    // Compile each file and merge — for single-file projects this is straightforward.
+    // For multi-file projects, compile each and take the last valid IR
+    // (real multi-file merge would require the full compiler pipeline, but
+    // the IR compiler handles each file independently).
+    let lastIR = null;
+    const allDiagnostics = [];
+    for (const file of files) {
+        const source = gitShowFile(ref, file);
+        if (!source)
+            continue;
+        const result = await compiler.compileToIR(source, { sourcePath: file });
+        if (result.ir) {
+            lastIR = result.ir;
+        }
+        if (result.diagnostics) {
+            allDiagnostics.push(...result.diagnostics);
+        }
+    }
+    const errors = allDiagnostics.filter(d => d.severity === 'error');
+    if (!lastIR) {
+        return {
+            ir: null,
+            error: errors.length > 0
+                ? `Compilation failed at ref '${ref}': ${errors[0].message}`
+                : `No valid IR produced at ref '${ref}'`,
+        };
+    }
+    return { ir: lastIR };
+}
+// ============================================================================
+// Markdown generation (Keep a Changelog + GitHub Releases format)
+// ============================================================================
+function generateMarkdown(fromRef, toRef, diffReport, breakingReport, title) {
+    const date = new Date().toISOString().slice(0, 10);
+    const fromLabel = gitRefLabel(fromRef);
+    const toLabel = gitRefLabel(toRef);
+    const heading = title ?? `${toLabel}`;
+    const lines = [];
+    lines.push(`## ${heading} — ${date}`);
+    lines.push('');
+    lines.push(`Comparing \`${fromLabel}\` → \`${toLabel}\``);
+    lines.push('');
+    if (!diffReport.summary.hasChanges) {
+        lines.push('No changes detected.');
+        return lines.join('\n');
+    }
+    const sections = [];
+    // --- Breaking Changes ---
+    if (breakingReport.summary.breaking > 0) {
+        const items = [];
+        for (const change of breakingReport.classified.filter(c => c.severity === 'breaking')) {
+            const impact = change.consumerImpact.length > 0
+                ? ` (impacts: ${change.consumerImpact.join(', ')})`
+                : '';
+            items.push(`**BREAKING**: ${change.description} — \`${change.path}\`${impact}`);
+        }
+        sections.push({ heading: 'Breaking Changes', items });
+    }
+    // --- Added ---
+    const added = [];
+    // New entities
+    for (const entity of diffReport.entities.filter(e => e.change === 'added')) {
+        added.push(`New entity \`${entity.name}\``);
+    }
+    // New commands
+    for (const cmd of diffReport.commands.filter(c => c.change === 'added')) {
+        const entityNote = cmd.details?.entity?.to ? ` on \`${cmd.details.entity.to}\`` : '';
+        added.push(`New command \`${cmd.name}\`${entityNote}`);
+    }
+    // New policies
+    for (const pol of diffReport.policies.filter(p => p.change === 'added')) {
+        added.push(`New policy \`${pol.name}\``);
+    }
+    // New events
+    for (const evt of diffReport.events.filter(e => e.change === 'added')) {
+        added.push(`New event \`${evt.name}\``);
+    }
+    // New stores
+    for (const store of diffReport.stores.filter(s => s.change === 'added')) {
+        added.push(`New store for \`${store.entity}\``);
+    }
+    // New properties on existing entities
+    for (const entity of diffReport.entities.filter(e => e.change === 'changed')) {
+        for (const prop of entity.properties.filter(p => p.change === 'added')) {
+            added.push(`New property \`${entity.name}.${prop.name}\``);
+        }
+        for (const cp of entity.computedProperties.filter(c => c.change === 'added')) {
+            added.push(`New computed property \`${entity.name}.${cp.name}\``);
+        }
+        for (const rel of entity.relationships.filter(r => r.change === 'added')) {
+            added.push(`New relationship \`${entity.name}.${rel.name}\``);
+        }
+        for (const con of entity.constraints.filter(c => c.change === 'added')) {
+            added.push(`New constraint \`${entity.name}.${con.name}\``);
+        }
+    }
+    if (added.length > 0) {
+        sections.push({ heading: 'Added', items: added });
+    }
+    // --- Changed ---
+    const changed = [];
+    for (const entity of diffReport.entities.filter(e => e.change === 'changed')) {
+        for (const prop of entity.properties.filter(p => p.change === 'changed')) {
+            const details = [];
+            if (prop.details?.type) {
+                details.push(`type: \`${prop.details.type.from}\` → \`${prop.details.type.to}\``);
+            }
+            if (prop.details?.modifiers) {
+                details.push(`modifiers: [${prop.details.modifiers.from.join(', ')}] → [${prop.details.modifiers.to.join(', ')}]`);
+            }
+            const detailStr = details.length > 0 ? ` (${details.join('; ')})` : '';
+            changed.push(`Modified property \`${entity.name}.${prop.name}\`${detailStr}`);
+        }
+        for (const cp of entity.computedProperties.filter(c => c.change === 'changed')) {
+            changed.push(`Modified computed property \`${entity.name}.${cp.name}\``);
+        }
+        for (const rel of entity.relationships.filter(r => r.change === 'changed')) {
+            const kindDetail = rel.details?.kind
+                ? ` (kind: \`${rel.details.kind.from}\` → \`${rel.details.kind.to}\`)`
+                : '';
+            changed.push(`Modified relationship \`${entity.name}.${rel.name}\`${kindDetail}`);
+        }
+        for (const con of entity.constraints.filter(c => c.change === 'changed')) {
+            changed.push(`Modified constraint \`${entity.name}.${con.name}\``);
+        }
+    }
+    for (const cmd of diffReport.commands.filter(c => c.change === 'changed')) {
+        changed.push(`Modified command \`${cmd.name}\``);
+    }
+    for (const pol of diffReport.policies.filter(p => p.change === 'changed')) {
+        changed.push(`Modified policy \`${pol.name}\``);
+    }
+    for (const evt of diffReport.events.filter(e => e.change === 'changed')) {
+        changed.push(`Modified event \`${evt.name}\``);
+    }
+    if (changed.length > 0) {
+        sections.push({ heading: 'Changed', items: changed });
+    }
+    // --- Deprecated ---
+    if (breakingReport.summary.deprecated > 0) {
+        const items = [];
+        for (const change of breakingReport.classified.filter(c => c.severity === 'deprecated')) {
+            items.push(`${change.description} — \`${change.path}\``);
+        }
+        sections.push({ heading: 'Deprecated', items });
+    }
+    // --- Removed ---
+    const removed = [];
+    for (const entity of diffReport.entities.filter(e => e.change === 'removed')) {
+        removed.push(`Removed entity \`${entity.name}\``);
+    }
+    for (const cmd of diffReport.commands.filter(c => c.change === 'removed')) {
+        removed.push(`Removed command \`${cmd.name}\``);
+    }
+    for (const pol of diffReport.policies.filter(p => p.change === 'removed')) {
+        removed.push(`Removed policy \`${pol.name}\``);
+    }
+    for (const evt of diffReport.events.filter(e => e.change === 'removed')) {
+        removed.push(`Removed event \`${evt.name}\``);
+    }
+    for (const store of diffReport.stores.filter(s => s.change === 'removed')) {
+        removed.push(`Removed store for \`${store.entity}\``);
+    }
+    // Removed properties on existing entities
+    for (const entity of diffReport.entities.filter(e => e.change === 'changed')) {
+        for (const prop of entity.properties.filter(p => p.change === 'removed')) {
+            removed.push(`Removed property \`${entity.name}.${prop.name}\``);
+        }
+        for (const cp of entity.computedProperties.filter(c => c.change === 'removed')) {
+            removed.push(`Removed computed property \`${entity.name}.${cp.name}\``);
+        }
+        for (const rel of entity.relationships.filter(r => r.change === 'removed')) {
+            removed.push(`Removed relationship \`${entity.name}.${rel.name}\``);
+        }
+    }
+    if (removed.length > 0) {
+        sections.push({ heading: 'Removed', items: removed });
+    }
+    // --- Render sections ---
+    for (const section of sections) {
+        lines.push(`### ${section.heading}`);
+        lines.push('');
+        for (const item of section.items) {
+            lines.push(`- ${item}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+// ============================================================================
+// Command handler
+// ============================================================================
+export async function changelogCommand(fromRef, toRef, options = {}) {
+    const sourcePattern = options.source ?? '**/*.manifest';
+    const spinner = ora(`Generating changelog ${fromRef} → ${toRef}`).start();
+    try {
+        // Validate refs
+        if (!gitRefExists(fromRef)) {
+            spinner.fail(`Git ref not found: ${fromRef}`);
+            process.exit(1);
+            return;
+        }
+        if (!gitRefExists(toRef)) {
+            spinner.fail(`Git ref not found: ${toRef}`);
+            process.exit(1);
+            return;
+        }
+        // Compile at each ref
+        spinner.text = `Compiling .manifest files at ${fromRef}`;
+        const oldResult = await compileAtRef(fromRef, sourcePattern);
+        if (!oldResult.ir) {
+            spinner.fail(oldResult.error ?? `Failed to compile at ${fromRef}`);
+            process.exit(1);
+            return;
+        }
+        spinner.text = `Compiling .manifest files at ${toRef}`;
+        const newResult = await compileAtRef(toRef, sourcePattern);
+        if (!newResult.ir) {
+            spinner.fail(newResult.error ?? `Failed to compile at ${toRef}`);
+            process.exit(1);
+            return;
+        }
+        // Diff
+        spinner.text = 'Analyzing IR differences';
+        const diffMod = await loadDiff();
+        const breakingMod = await loadBreaking();
+        const diffReport = diffMod.diffIR(oldResult.ir, newResult.ir);
+        const breakingReport = breakingMod.classifyBreakingChanges(diffReport);
+        spinner.stop();
+        // JSON output
+        if (options.json) {
+            const jsonOutput = JSON.stringify({
+                fromRef,
+                toRef,
+                date: new Date().toISOString().slice(0, 10),
+                diff: diffReport,
+                breaking: breakingReport,
+            }, null, 2);
+            if (options.output) {
+                await fs.writeFile(options.output, jsonOutput, 'utf-8');
+                console.log(chalk.green(`Changelog JSON written to ${options.output}`));
+            }
+            else {
+                console.log(jsonOutput);
+            }
+            return;
+        }
+        // Markdown output
+        const markdown = generateMarkdown(fromRef, toRef, diffReport, breakingReport, options.title);
+        if (options.output) {
+            await fs.writeFile(options.output, markdown, 'utf-8');
+            console.log(chalk.green(`Changelog written to ${options.output}`));
+        }
+        else {
+            console.log(markdown);
+        }
+    }
+    catch (error) {
+        spinner.fail(`Changelog generation failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=changelog.js.map