@bloomreach/brxm-upgrade 0.1.1

package/dist/capture/quality-report.js

@@ -0,0 +1,161 @@
+/**
+ * Generates a markdown quality report for the QA pipeline run against a single
+ * manifest version.
+ *
+ * Sections produced (conditional sections are omitted when empty):
+ * 1. Header with version and date
+ * 2. Summary table with key metrics
+ * 3. Informational Reclassifications (if any)
+ * 4. Entries Regenerated (if any), with full critique issue details
+ * 5. Warnings (needs_improvement entries not regenerated, if any)
+ * 6. Heuristic Fixes (if any)
+ *
+ * @param version - The manifest version string (e.g. "16.7.0")
+ * @param records - All QARecord objects produced by the pipeline
+ * @returns A markdown-formatted quality report string
+ */
+export function generateQualityReport(version, records) {
+    const summary = computeSummary(records);
+    const sections = [];
+    sections.push(renderHeader(version));
+    sections.push(renderSummary(summary));
+    const informational = records.filter(r => r.critique.shouldBeInformational);
+    if (informational.length > 0) {
+        sections.push(renderInformationalSection(informational));
+    }
+    const regenerated = records.filter(r => r.regenerated);
+    if (regenerated.length > 0) {
+        sections.push(renderRegeneratedSection(regenerated));
+    }
+    const warnings = records.filter(r => r.finalQuality === 'needs_improvement' && !r.regenerated);
+    if (warnings.length > 0) {
+        sections.push(renderWarningsSection(warnings));
+    }
+    const withFixes = records.filter(r => r.heuristicFixes.length > 0);
+    if (withFixes.length > 0) {
+        sections.push(renderHeuristicFixesSection(withFixes));
+    }
+    return sections.join('\n\n') + '\n';
+}
+// ---------------------------------------------------------------------------
+// Summary computation
+// ---------------------------------------------------------------------------
+function computeSummary(records) {
+    const entriesProcessed = records.length;
+    const passed = records.filter(r => r.finalQuality === 'good' && !r.regenerated).length;
+    const improved = records.filter(r => r.finalQuality === 'needs_improvement' && !r.regenerated).length;
+    const regenerated = records.filter(r => r.regenerated).length;
+    const splitCount = records.filter(r => r.split).length;
+    // Final entry count: non-split entries count as 1 each; split entries count
+    // as their splitCount (falling back to 1 if not set).
+    const finalEntryCount = records.reduce((total, r) => {
+        if (r.split && r.splitCount !== undefined) {
+            return total + r.splitCount;
+        }
+        return total + 1;
+    }, 0);
+    const informationalReclassifications = records.filter(r => r.critique.shouldBeInformational).length;
+    return {
+        entriesProcessed,
+        passed,
+        improved,
+        regenerated,
+        splitCount,
+        finalEntryCount,
+        informationalReclassifications,
+    };
+}
+// ---------------------------------------------------------------------------
+// Section renderers
+// ---------------------------------------------------------------------------
+function renderHeader(version) {
+    const date = new Date().toISOString().split('T')[0]; // YYYY-MM-DD
+    return `# Manifest Quality Report: ${version}\n\n_Generated on ${date}_`;
+}
+function renderSummary(summary) {
+    const rows = [
+        `| Entries processed | ${summary.entriesProcessed} |`,
+        `| Passed (good, no regeneration) | ${summary.passed} |`,
+        `| Warnings (needs improvement) | ${summary.improved} |`,
+        `| Regenerated | ${summary.regenerated} |`,
+        `| Split entries | ${summary.splitCount} |`,
+        `| Final entry count | ${summary.finalEntryCount} |`,
+    ];
+    if (summary.informationalReclassifications > 0) {
+        rows.push(`| Informational reclassifications | ${summary.informationalReclassifications} |`);
+    }
+    const lines = [
+        '## Summary',
+        '',
+        '| Metric | Count |',
+        '|--------|-------|',
+        ...rows,
+    ];
+    return lines.join('\n');
+}
+function renderInformationalSection(records) {
+    const lines = ['## Informational Reclassifications', ''];
+    lines.push('The following entries were flagged as candidates for reclassification to the ' +
+        '`informational` type:');
+    lines.push('');
+    for (const r of records) {
+        lines.push(`- \`${r.entryId}\``);
+    }
+    return lines.join('\n');
+}
+function renderRegeneratedSection(records) {
+    const lines = ['## Entries Regenerated', ''];
+    for (const r of records) {
+        lines.push(`### \`${r.entryId}\``);
+        lines.push('');
+        if (r.critique.issues.length === 0) {
+            lines.push('_No issues recorded (critique data unavailable)._');
+        }
+        else {
+            for (const issue of r.critique.issues) {
+                lines.push(`- **[${issue.severity}] ${issue.category}**: ${issue.description}`);
+                lines.push(`  - _Suggestion_: ${issue.suggestion}`);
+            }
+        }
+        lines.push('');
+    }
+    // Remove trailing blank line from last entry
+    if (lines[lines.length - 1] === '') {
+        lines.pop();
+    }
+    return lines.join('\n');
+}
+function renderWarningsSection(records) {
+    const lines = ['## Warnings', ''];
+    lines.push('These entries have quality issues but were kept without regeneration:');
+    lines.push('');
+    for (const r of records) {
+        lines.push(`### \`${r.entryId}\``);
+        lines.push('');
+        for (const issue of r.critique.issues) {
+            lines.push(`- **[${issue.severity}] ${issue.category}**: ${issue.description}`);
+            lines.push(`  - _Suggestion_: ${issue.suggestion}`);
+        }
+        lines.push('');
+    }
+    if (lines[lines.length - 1] === '') {
+        lines.pop();
+    }
+    return lines.join('\n');
+}
+function renderHeuristicFixesSection(records) {
+    const lines = ['## Heuristic Fixes Applied', ''];
+    for (const r of records) {
+        lines.push(`### \`${r.entryId}\``);
+        lines.push('');
+        for (const fix of r.heuristicFixes) {
+            lines.push(`- ${fix}`);
+        }
+        lines.push('');
+    }
+    if (lines[lines.length - 1] === '') {
+        lines.pop();
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=quality-report.js.map

package/dist/capture/quality-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-report.js","sourceRoot":"","sources":["../../src/capture/quality-report.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,OAAmB;IACxE,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IAEtC,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAC5E,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,aAAa,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACvD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,mBAAmB,IAAI,CAAC,CAAC,CAAC,WAAW,CAC9D,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,SAAS,cAAc,CAAC,OAAmB;IACzC,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;IACvF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,mBAAmB,IAAI,CAAC,CAAC,CAAC,WAAW,CAC9D,CAAC,MAAM,CAAC;IACT,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;IAC9D,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAEvD,4EAA4E;IAC5E,sDAAsD;IACtD,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAClD,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC;QAC9B,CAAC;QACD,OAAO,KAAK,GAAG,CAAC,CAAC;IACnB,CAAC,EAAE,CAAC,CAAC,CAAC;IAEN,MAAM,8BAA8B,GAAG,OAAO,CAAC,MAAM,CACnD,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CACtC,CAAC,MAAM,CAAC;IAET,OAAO;QACL,gBAAgB;QAChB,MAAM;QACN,QAAQ;QACR,WAAW;QACX,UAAU;QACV,eAAe;QACf,8BAA8B;KAC/B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa;IAClE,OAAO,8BAA8B,OAAO,qBAAqB,IAAI,GAAG,CAAC;AAC3E,CAAC;AAED,SAAS,aAAa,CAAC,OAA6B;IAClD,MAAM,IAAI,GAAa;QACrB,yBAAyB,OAAO,CAAC,gBAAgB,IAAI;QACrD,sCAAsC,OAAO,CAAC,MAAM,IAAI;QACxD,oCAAoC,OAAO,CAAC,QAAQ,IAAI;QACxD,mBAAmB,OAAO,CAAC,WAAW,IAAI;QAC1C,qBAAqB,OAAO,CAAC,UAAU,IAAI;QAC3C,yBAAyB,OAAO,CAAC,eAAe,IAAI;KACrD,CAAC;IAEF,IAAI,OAAO,CAAC,8BAA8B,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,uCAAuC,OAAO,CAAC,8BAA8B,IAAI,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,YAAY;QACZ,EAAE;QACF,oBAAoB;QACpB,oBAAoB;QACpB,GAAG,IAAI;KACR,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,0BAA0B,CAAC,OAAmB;IACrD,MAAM,KAAK,GAAa,CAAC,oCAAoC,EAAE,EAAE,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CACR,+EAA+E;QAC7E,uBAAuB,CAC1B,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAmB;IACnD,MAAM,KAAK,GAAa,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAEvD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACtC,KAAK,CAAC,IAAI,CACR,QAAQ,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,OAAO,KAAK,CAAC,WAAW,EAAE,CACpE,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,6CAA6C;IAC7C,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QACnC,KAAK,CAAC,GAAG,EAAE,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAmB;IAChD,MAAM,KAAK,GAAa,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CACR,uEAAuE,CACxE,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CACR,QAAQ,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,OAAO,KAAK,CAAC,WAAW,EAAE,CACpE,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QACnC,KAAK,CAAC,GAAG,EAAE,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,2BAA2B,CAAC,OAAmB;IACtD,MAAM,KAAK,GAAa,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;IAE3D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QACnC,KAAK,CAAC,GAAG,EAAE,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/capture/review-flow.d.ts

@@ -0,0 +1,37 @@
+import type { ManifestEntry } from '../planning/types.js';
+import type { ChangeDocument, ConflictCheckResult, ReviewResult } from './types.js';
+/**
+ * Interactive review flow for manifest entries during change capture.
+ * Presents each generated entry to the user and collects their decision.
+ */
+export declare class ReviewFlow {
+    /**
+     * Formats a ManifestEntry as a human-readable summary for terminal display.
+     *
+     * @param entry - The manifest entry to format
+     * @returns A multi-line string with color-coded field names
+     */
+    formatEntrySummary(entry: ManifestEntry): string;
+    /**
+     * Presents a manifest entry for interactive review and collects the user's decision.
+     * Displays the entry summary, conflict information (if any), and prompts the user
+     * to accept, skip, edit, replace, or add as a separate entry.
+     *
+     * @param entry - The generated manifest entry to review
+     * @param doc - The source change document
+     * @param conflict - Result of conflict checking against existing entries
+     * @returns The user's review result including decision and (possibly edited) entry
+     */
+    reviewEntry(entry: ManifestEntry, doc: ChangeDocument, conflict: ConflictCheckResult): Promise<ReviewResult>;
+    /**
+     * Opens the entry in the user's $EDITOR for manual editing, validates the
+     * result against the ManifestEntry schema, and re-prompts on validation errors.
+     *
+     * @param entry - The original manifest entry to edit
+     * @param doc - The source change document
+     * @param conflict - Conflict check result for post-edit decision
+     * @returns The review result with the edited entry
+     */
+    private handleEdit;
+}
+//# sourceMappingURL=review-flow.d.ts.map

package/dist/capture/review-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-flow.d.ts","sourceRoot":"","sources":["../../src/capture/review-flow.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAkB,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpG;;;GAGG;AACH,qBAAa,UAAU;IACrB;;;;;OAKG;IACH,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;IA0ChD;;;;;;;;;OASG;IACG,WAAW,CACf,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,mBAAmB,GAC5B,OAAO,CAAC,YAAY,CAAC;IAmExB;;;;;;;;OAQG;YACW,UAAU;CA0FzB"}

package/dist/capture/review-flow.js

@@ -0,0 +1,212 @@
+import { randomUUID } from 'node:crypto';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import yaml from 'js-yaml';
+/**
+ * Interactive review flow for manifest entries during change capture.
+ * Presents each generated entry to the user and collects their decision.
+ */
+export class ReviewFlow {
+    /**
+     * Formats a ManifestEntry as a human-readable summary for terminal display.
+     *
+     * @param entry - The manifest entry to format
+     * @returns A multi-line string with color-coded field names
+     */
+    formatEntrySummary(entry) {
+        const lines = [];
+        lines.push(`  ${chalk.cyan('id')}: ${entry.id}`);
+        lines.push(`  ${chalk.cyan('type')}: ${entry.type}`);
+        lines.push(`  ${chalk.cyan('automatable')}: ${entry.automatable}`);
+        lines.push(`  ${chalk.cyan('description')}: ${entry.description}`);
+        if (entry.jira_ticket) {
+            lines.push(`  ${chalk.cyan('jira_ticket')}: ${entry.jira_ticket}`);
+        }
+        if (entry.patterns && entry.patterns.length > 0) {
+            lines.push(`  ${chalk.cyan('patterns')}:`);
+            for (const p of entry.patterns) {
+                lines.push(`    - match: "${p.match}"`);
+                lines.push(`      replace: "${p.replace}"`);
+            }
+        }
+        if (entry.file_globs) {
+            lines.push(`  ${chalk.cyan('file_globs')}: ${JSON.stringify(entry.file_globs)}`);
+        }
+        if (entry.detection_patterns) {
+            lines.push(`  ${chalk.cyan('detection_patterns')}: ${JSON.stringify(entry.detection_patterns)}`);
+        }
+        if (entry.ai_guidance) {
+            lines.push(`  ${chalk.cyan('ai_guidance')}: ${entry.ai_guidance}`);
+        }
+        if (entry.manual_steps) {
+            lines.push(`  ${chalk.cyan('manual_steps')}:`);
+            for (const s of entry.manual_steps) {
+                lines.push(`    - "${s}"`);
+            }
+        }
+        if (entry.changelog_entry) {
+            lines.push(`  ${chalk.cyan('changelog_entry')}: ${entry.changelog_entry}`);
+        }
+        if (entry.risk_level !== undefined) {
+            lines.push(`  ${chalk.cyan('risk_level')}: ${entry.risk_level}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Presents a manifest entry for interactive review and collects the user's decision.
+     * Displays the entry summary, conflict information (if any), and prompts the user
+     * to accept, skip, edit, replace, or add as a separate entry.
+     *
+     * @param entry - The generated manifest entry to review
+     * @param doc - The source change document
+     * @param conflict - Result of conflict checking against existing entries
+     * @returns The user's review result including decision and (possibly edited) entry
+     */
+    async reviewEntry(entry, doc, conflict) {
+        // eslint-disable-next-line no-console
+        console.log('');
+        // eslint-disable-next-line no-console
+        console.log(chalk.bold('\u2501'.repeat(60)));
+        // eslint-disable-next-line no-console
+        console.log(chalk.bold(`Change doc: ${doc.filename}`));
+        if (doc.metadata.jiraTicket) {
+            // eslint-disable-next-line no-console
+            console.log(chalk.bold(`JIRA: ${doc.metadata.jiraTicket}`));
+        }
+        // eslint-disable-next-line no-console
+        console.log(chalk.bold('\u2501'.repeat(60)));
+        if (conflict.hasConflict) {
+            // eslint-disable-next-line no-console
+            console.log('');
+            // eslint-disable-next-line no-console
+            console.log(chalk.yellow(`\u26A0 JIRA ${doc.metadata.jiraTicket} already has ${conflict.existingEntries.length} entry(ies) in unreleased.yaml:`));
+            for (const existing of conflict.existingEntries) {
+                // eslint-disable-next-line no-console
+                console.log(chalk.dim(this.formatEntrySummary(existing)));
+            }
+            // eslint-disable-next-line no-console
+            console.log('');
+        }
+        // eslint-disable-next-line no-console
+        console.log(chalk.green('Suggested manifest entry:'));
+        // eslint-disable-next-line no-console
+        console.log('');
+        // eslint-disable-next-line no-console
+        console.log(this.formatEntrySummary(entry));
+        // eslint-disable-next-line no-console
+        console.log('');
+        const choices = [];
+        if (conflict.hasConflict) {
+            choices.push({ name: 'Replace existing entry(ies)', value: 'replace' });
+            choices.push({ name: 'Add as separate entry', value: 'add_separate' });
+        }
+        else {
+            choices.push({ name: 'Accept', value: 'accept' });
+        }
+        choices.push({ name: 'Edit in $EDITOR', value: 'edit' });
+        choices.push({ name: 'Skip', value: 'skip' });
+        const { decision } = await inquirer.prompt([
+            {
+                type: 'select',
+                name: 'decision',
+                message: 'What would you like to do?',
+                choices,
+            },
+        ]);
+        if (decision === 'edit') {
+            return this.handleEdit(entry, doc, conflict);
+        }
+        return {
+            entry,
+            decision,
+            sourceFile: doc.filename,
+        };
+    }
+    /**
+     * Opens the entry in the user's $EDITOR for manual editing, validates the
+     * result against the ManifestEntry schema, and re-prompts on validation errors.
+     *
+     * @param entry - The original manifest entry to edit
+     * @param doc - The source change document
+     * @param conflict - Conflict check result for post-edit decision
+     * @returns The review result with the edited entry
+     */
+    async handleEdit(entry, doc, conflict) {
+        const { writeFile, readFile, unlink } = await import('node:fs/promises');
+        const { tmpdir } = await import('node:os');
+        const pathModule = await import('node:path');
+        const { spawnSync } = await import('node:child_process');
+        const { getEntryValidationErrors } = await import('./entry-validator.js');
+        const tmpPath = pathModule.join(tmpdir(), `brxm-entry-${randomUUID()}.yaml`);
+        const entryYaml = yaml.dump(entry, { lineWidth: 120, noRefs: true });
+        await writeFile(tmpPath, entryYaml, 'utf-8');
+        const editor = process.env['EDITOR'] ?? process.env['VISUAL'] ?? 'vi';
+        let editedEntry;
+        try {
+            while (!editedEntry) {
+                const editorResult = spawnSync(editor, [tmpPath], { stdio: 'inherit' });
+                if (editorResult.error || editorResult.status !== 0) {
+                    // eslint-disable-next-line no-console
+                    console.log(chalk.red(`\nFailed to launch editor (${editor}).`));
+                    const { retry } = await inquirer.prompt([
+                        {
+                            type: 'confirm',
+                            name: 'retry',
+                            message: 'Try again?',
+                            default: false,
+                        },
+                    ]);
+                    if (!retry) {
+                        return { entry, decision: 'skip', sourceFile: doc.filename };
+                    }
+                    continue;
+                }
+                const editedContent = await readFile(tmpPath, 'utf-8');
+                const parsed = yaml.load(editedContent);
+                const errors = getEntryValidationErrors(parsed);
+                if (errors.length > 0) {
+                    // eslint-disable-next-line no-console
+                    console.log(chalk.red('\nValidation errors:'));
+                    for (const err of errors) {
+                        // eslint-disable-next-line no-console
+                        console.log(chalk.red(`  - ${err}`));
+                    }
+                    const { retry } = await inquirer.prompt([
+                        {
+                            type: 'confirm',
+                            name: 'retry',
+                            message: 'Re-open editor to fix?',
+                            default: true,
+                        },
+                    ]);
+                    if (!retry) {
+                        return { entry, decision: 'skip', sourceFile: doc.filename };
+                    }
+                }
+                else {
+                    editedEntry = parsed;
+                }
+            }
+        }
+        finally {
+            await unlink(tmpPath).catch(() => { });
+        }
+        if (conflict.hasConflict) {
+            const { decision } = await inquirer.prompt([
+                {
+                    type: 'select',
+                    name: 'decision',
+                    message: 'Edited entry ready. What would you like to do?',
+                    choices: [
+                        { name: 'Replace existing entry(ies)', value: 'replace' },
+                        { name: 'Add as separate entry', value: 'add_separate' },
+                        { name: 'Skip', value: 'skip' },
+                    ],
+                },
+            ]);
+            return { entry: editedEntry, decision, sourceFile: doc.filename };
+        }
+        return { entry: editedEntry, decision: 'accept', sourceFile: doc.filename };
+    }
+}
+//# sourceMappingURL=review-flow.js.map

package/dist/capture/review-flow.js.map

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

package/dist/capture/types.d.ts

@@ -0,0 +1,114 @@
+import type { ManifestEntry } from '../planning/types.js';
+/**
+ * Metadata extracted from a change document's front-matter.
+ */
+export interface ChangeDocMetadata {
+    /** JIRA ticket (e.g., "CMS-18384") */
+    jiraTicket: string | undefined;
+    /** Branch name */
+    branch: string | undefined;
+    /** Document date (YYYY-MM-DD) */
+    date: string | undefined;
+    /** Author name */
+    author: string | undefined;
+}
+/**
+ * AI Context Tags parsed from the YAML block at the end of a change document.
+ */
+export interface AIContextTags {
+    change_type?: string;
+    modules_affected?: string[];
+    api_changes?: string;
+    breaking_changes?: boolean;
+    database_changes?: boolean;
+    test_coverage?: string;
+    risk_level?: string;
+}
+/**
+ * A parsed change document ready for AI analysis.
+ */
+export interface ChangeDocument {
+    /** Filename (e.g., "2026-01-15-CMS-18384-jakarta.md") */
+    filename: string;
+    /** Absolute file path */
+    filePath: string;
+    /** Extracted metadata from front-matter */
+    metadata: ChangeDocMetadata;
+    /** AI Context Tags from the YAML block */
+    contextTags: AIContextTags;
+    /** Full Markdown content */
+    content: string;
+}
+/**
+ * Result of conflict checking a change document against unreleased.yaml.
+ */
+export interface ConflictCheckResult {
+    /** Whether a conflict exists */
+    hasConflict: boolean;
+    /** Existing entries with the same JIRA ticket */
+    existingEntries: ManifestEntry[];
+}
+/**
+ * User decision for a manifest entry during interactive review.
+ */
+export type ReviewDecision = 'accept' | 'edit' | 'skip' | 'replace' | 'add_separate';
+/**
+ * Result of reviewing a single entry.
+ */
+export interface ReviewResult {
+    /** The candidate manifest entry (after possible edits). Always present, but unused when decision is 'skip'. */
+    entry: ManifestEntry;
+    /** User's decision */
+    decision: ReviewDecision;
+    /** The source change document filename */
+    sourceFile: string;
+}
+/**
+ * Summary of the log-change processing run.
+ */
+export interface LogChangeSummary {
+    /** Total change documents scanned */
+    totalScanned: number;
+    /** Entries accepted (new or edited) */
+    accepted: number;
+    /** Entries intentionally skipped (user choice in interactive review,
+     *  or conflict resolution blocked by missing metadata) */
+    skipped: number;
+    /** Documents that failed to produce a manifest entry (validation error,
+     *  AI returned malformed data, etc.) — separate from `skipped` so the
+     *  CI wrapper can hard-fail when these are non-zero */
+    failed: number;
+    /** Entries that replaced existing ones */
+    replaced: number;
+    /** Entries added alongside existing (same JIRA) */
+    addedSeparate: number;
+}
+/**
+ * Options for the log-change command.
+ */
+export interface LogChangeOptions {
+    /** Path to change documents directory (default: docs/changes) */
+    changesDir?: string;
+    /** Path to unreleased.yaml */
+    unreleasedPath?: string;
+    /** Skip interactive review (auto-accept all) */
+    autoAccept?: boolean;
+    /** Enable verbose output */
+    verbose?: boolean;
+}
+/**
+ * Options for the finalize command.
+ */
+export interface FinalizeOptions {
+    /** Version string to finalize as (e.g., "16.3.0") */
+    version: string;
+    /** Path to unreleased.yaml */
+    unreleasedPath?: string;
+    /** Path to released manifests directory */
+    releasedDir?: string;
+    /** Skip confirmation prompt */
+    force?: boolean;
+    /** Enable verbose output */
+    verbose?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/capture/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kBAAkB;IAClB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,iCAAiC;IACjC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,kBAAkB;IAClB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,0CAA0C;IAC1C,WAAW,EAAE,aAAa,CAAC;IAC3B,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,eAAe,EAAE,aAAa,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,MAAM,GACN,MAAM,GACN,SAAS,GACT,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+GAA+G;IAC/G,KAAK,EAAE,aAAa,CAAC;IACrB,sBAAsB;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB;8DAC0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB;;2DAEuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/capture/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/capture/types.js.map

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

package/dist/commands/discover.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+/**
+ * Create the discover command.
+ */
+export declare function createDiscoverCommand(): Command;
+//# sourceMappingURL=discover.d.ts.map

package/dist/commands/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/commands/discover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwGpC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CA+D/C"}