@bloomreach/brxm-upgrade 0.1.1

package/dist/guide/rendering/formatters.js

@@ -0,0 +1,340 @@
+import chalk from 'chalk';
+/**
+ * Format a phase progress header.
+ *
+ * @param phaseNumber - Current phase number (1-indexed)
+ * @param totalPhases - Total number of phases
+ * @param name - Display name for the phase
+ * @returns Formatted header string with separator line
+ */
+export function formatPhaseHeader(phaseNumber, totalPhases, name) {
+    const lines = [
+        '',
+        chalk.bold(`● Phase ${phaseNumber} of ${totalPhases} — ${name}`),
+        chalk.dim('━'.repeat(40)),
+        '',
+    ];
+    return lines.join('\n');
+}
+/**
+ * Format a version card with AI-generated summary.
+ *
+ * @param summary - Version summary containing headline and bullet points
+ * @returns Formatted card string showing version details
+ */
+export function formatVersionCard(summary) {
+    const lines = [
+        `  ${chalk.bold(summary.version)} — ${summary.headline}`,
+        ...summary.bullets.map((b) => `    ${chalk.dim('•')} ${b}`),
+        chalk.dim(`    ${summary.automatedCount} automated, ${summary.reviewCount} need review`),
+    ];
+    return lines.join('\n');
+}
+/**
+ * Format a step briefing header for the execution phase.
+ *
+ * Displays step number, description, risk level indicator, type, automation
+ * status, and count of affected files.
+ *
+ * @param input - Step briefing data
+ * @returns Formatted briefing string
+ */
+export function formatStepBriefing(input) {
+    const riskBlocks = '■'.repeat(Math.min(input.riskLevel, 5)) +
+        '□'.repeat(Math.max(5 - input.riskLevel, 0));
+    const riskLabels = ['Very Low', 'Low', 'Medium', 'High', 'Critical'];
+    const riskLabel = riskLabels[Math.min(Math.max(input.riskLevel - 1, 0), 4)];
+    const automationLabel = input.automatable === 'true'
+        ? chalk.green('Automated')
+        : input.automatable === 'partial'
+            ? chalk.yellow('AI-Assisted')
+            : chalk.red('Manual');
+    const lines = [
+        '',
+        chalk.bold(`Step ${input.stepNumber}/${input.totalSteps}: ${input.description}`),
+        `Risk: ${riskBlocks} (${riskLabel})  |  Type: ${input.type}  |  ${automationLabel}`,
+    ];
+    if (input.affectedFileCount > 0) {
+        lines.push(chalk.dim(`Files affected: ${input.affectedFileCount}`));
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a progress bar for execution phase.
+ *
+ * @param current - Number of completed steps
+ * @param total - Total number of steps
+ * @returns Formatted progress bar string with fraction
+ */
+export function formatProgressBar(current, total) {
+    const width = 20;
+    const filled = Math.round((current / total) * width);
+    const bar = '█'.repeat(filled) + '░'.repeat(width - filled);
+    return `Progress: [${bar}] ${current}/${total}`;
+}
+// ── Banner layout constants (shared by welcome & resume banners) ──────────
+/** Total inner width of the banner box (between │ borders). */
+const BANNER_BOX_WIDTH = 56;
+/** Visible character width of each logo line (excluding ANSI codes). */
+const LOGO_VISIBLE_WIDTH = 9;
+/** Left padding before the logo inside the box. */
+const LOGO_LEFT_PAD = 2;
+/** Gap between logo and text columns. */
+const LOGO_TEXT_GAP = 3;
+/** Column where text starts (left pad + logo width + gap). */
+const BANNER_TEXT_START_COL = LOGO_LEFT_PAD + LOGO_VISIBLE_WIDTH + LOGO_TEXT_GAP;
+/**
+ * Render the Bloomreach logo as three colored lines.
+ *
+ * Uses chalk RGB for Bloomreach brand colors:
+ * - Yellow (244, 208, 0) for the diamond shape
+ * - Blue (0, 47, 108) for the center "b" on yellow background
+ *
+ * @returns Array of 3 logo lines (each 9 visible chars wide)
+ */
+function bloomreachLogo() {
+    const y = chalk.rgb(244, 208, 0);
+    const yd = chalk.dim.rgb(244, 208, 0);
+    const b = chalk.bgRgb(244, 208, 0).rgb(0, 47, 108);
+    return [
+        ` ${yd('░')}${y('▓███▓')}${yd('░')} `,
+        `${y('▓███')}${b('b')}${y('███▓')}`,
+        ` ${yd('░')}${y('▓███▓')}${yd('░')} `,
+    ];
+}
+/**
+ * Format the welcome banner shown at guide start.
+ *
+ * @param currentVersion - Currently detected brXM version, if already known
+ * @returns Formatted welcome banner string
+ */
+export function formatWelcomeBanner(currentVersion) {
+    const logo = bloomreachLogo();
+    const title = 'brXM Upgrade Guide';
+    const versionText = currentVersion
+        ? `Current version: ${currentVersion}`
+        : 'Discover, plan, and execute your upgrade';
+    const emptyLinePad = ' '.repeat(BANNER_BOX_WIDTH - BANNER_TEXT_START_COL);
+    const titlePad = ' '.repeat(Math.max(0, BANNER_BOX_WIDTH - BANNER_TEXT_START_COL - title.length));
+    const versionPad = ' '.repeat(Math.max(0, BANNER_BOX_WIDTH - BANNER_TEXT_START_COL - versionText.length));
+    const lines = [
+        '',
+        chalk.bold('╭' + '─'.repeat(BANNER_BOX_WIDTH) + '╮'),
+        chalk.bold('│') + ' '.repeat(LOGO_LEFT_PAD) + logo[0] + ' '.repeat(LOGO_TEXT_GAP) + emptyLinePad + chalk.bold('│'),
+        chalk.bold('│') + ' '.repeat(LOGO_LEFT_PAD) + logo[1] + ' '.repeat(LOGO_TEXT_GAP) + title + titlePad + chalk.bold('│'),
+        chalk.bold('│') + ' '.repeat(LOGO_LEFT_PAD) + logo[2] + ' '.repeat(LOGO_TEXT_GAP) + versionText + versionPad + chalk.bold('│'),
+        chalk.bold('╰' + '─'.repeat(BANNER_BOX_WIDTH) + '╯'),
+        '',
+    ];
+    return lines.join('\n');
+}
+/**
+ * Format the resume detection banner shown when prior state exists.
+ *
+ * @param state - Resume state containing discovery, plan, and execution info
+ * @returns Formatted resume banner string
+ */
+export function formatResumeBanner(state) {
+    const logo = bloomreachLogo();
+    const title = 'brXM Upgrade Guide';
+    const subtitle = 'Previous session detected';
+    const emptyLinePad = ' '.repeat(BANNER_BOX_WIDTH - BANNER_TEXT_START_COL);
+    const titlePad = ' '.repeat(Math.max(0, BANNER_BOX_WIDTH - BANNER_TEXT_START_COL - title.length));
+    const subtitlePad = ' '.repeat(Math.max(0, BANNER_BOX_WIDTH - BANNER_TEXT_START_COL - subtitle.length));
+    const lines = [
+        '',
+        chalk.bold('╭' + '─'.repeat(BANNER_BOX_WIDTH) + '╮'),
+        chalk.bold('│') + ' '.repeat(LOGO_LEFT_PAD) + logo[0] + ' '.repeat(LOGO_TEXT_GAP) + emptyLinePad + chalk.bold('│'),
+        chalk.bold('│') + ' '.repeat(LOGO_LEFT_PAD) + logo[1] + ' '.repeat(LOGO_TEXT_GAP) + title + titlePad + chalk.bold('│'),
+        chalk.bold('│') + ' '.repeat(LOGO_LEFT_PAD) + logo[2] + ' '.repeat(LOGO_TEXT_GAP) + subtitle + subtitlePad + chalk.bold('│'),
+        chalk.bold('╰' + '─'.repeat(BANNER_BOX_WIDTH) + '╯'),
+        '',
+        'Found existing upgrade state:',
+    ];
+    if (state.hasDiscovery) {
+        lines.push(`  ${chalk.green('•')} Discovery: ${chalk.green('✓')} completed`);
+    }
+    if (state.hasPlan) {
+        lines.push(`  ${chalk.green('•')} Plan: ${chalk.green('✓')} generated`);
+    }
+    if (state.hasExecution && state.executionState) {
+        const completed = state.executionState.completedSteps.length;
+        lines.push(`  ${chalk.green('•')} Execution: ${completed} steps completed`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Format the 3-step explanation shown after the welcome banner.
+ *
+ * @returns Formatted intro text describing the three upgrade phases
+ */
+export function formatIntroExplanation() {
+    return [
+        '',
+        chalk.dim('This tool will guide you through upgrading your brXM'),
+        chalk.dim('project in three steps:'),
+        '',
+        '  1. ' + chalk.bold('Discover') + ' \u2014 scan your project and check readiness',
+        '  2. ' + chalk.bold('Plan') + '     \u2014 create a step-by-step upgrade plan',
+        '  3. ' + chalk.bold('Execute') + '  \u2014 apply changes with guidance',
+        '',
+        chalk.dim('We will detect your current version during discovery and let you'),
+        chalk.dim('choose a target version before planning the upgrade.'),
+        '',
+    ].join('\n');
+}
+/**
+ * Format a brief phase intro description.
+ *
+ * @param phaseName - Name of the phase ('Discover', 'Plan', or 'Execute')
+ * @param context - Optional dynamic values for the phase intro
+ * @returns Formatted phase intro text
+ */
+export function formatPhaseIntro(phaseName, context) {
+    switch (phaseName) {
+        case 'Discover':
+            return [
+                chalk.dim('We\'ll detect your current version, let you pick a target,'),
+                chalk.dim('then scan your project to check upgrade readiness.'),
+                '',
+            ].join('\n');
+        case 'Plan':
+            if (context?.totalChanges && context.fromVersion && context.toVersion) {
+                return [
+                    chalk.dim(`We'll analyze all ${context.totalChanges} changes in the ${context.fromVersion} → ${context.toVersion}`),
+                    chalk.dim('upgrade and organize them into a step-by-step plan.'),
+                    '',
+                ].join('\n');
+            }
+            return [
+                chalk.dim('We\'ll analyze all changes and organize them into a step-by-step plan.'),
+                '',
+            ].join('\n');
+        case 'Execute':
+            return [
+                chalk.dim('We\'ll walk through each step of the plan. For each change'),
+                chalk.dim('you can apply it, preview the diff, ask questions, or skip.'),
+                '',
+            ].join('\n');
+        default:
+            return '';
+    }
+}
+/**
+ * Format a transition block between phases.
+ *
+ * Returns the display text (without the continue prompt — that's for inquirer).
+ *
+ * @param message - Transition message with whatHappened and whatIsNext
+ * @returns Formatted transition text
+ */
+export function formatTransition(message) {
+    const lines = [
+        '',
+        chalk.green('✓ ') + chalk.bold(message.whatHappened.split('\n')[0]),
+        '',
+        ...message.whatHappened.split('\n').slice(1).map((l) => '  ' + l),
+        '',
+        ...message.whatIsNext.split('\n').map((l) => '  ' + l),
+        '',
+    ];
+    return lines.join('\n');
+}
+/**
+ * Format the final outro after execution completes.
+ *
+ * Includes summary statistics, manual steps remaining, and next-step guidance.
+ *
+ * @param data - Outro data including versions, counts, duration, and manual steps
+ * @returns Formatted outro text
+ */
+export function formatOutro(data) {
+    const lines = [
+        '',
+        chalk.green('✓ ') + chalk.bold(`Upgrade complete — ${data.fromVersion} → ${data.toVersion}`),
+        '',
+        `  Applied: ${data.applied}`,
+        `  Skipped: ${data.skipped}${data.skipped > 0 ? ' (manual review needed)' : ''}`,
+    ];
+    if (data.failed > 0) {
+        lines.push(`  Failed:  ${data.failed}`);
+    }
+    lines.push(`  Duration: ${Math.round(data.duration / 1000)}s`);
+    if (data.manualStepsRemaining.length > 0) {
+        lines.push('');
+        lines.push(chalk.bold('  Manual Steps Remaining:'));
+        for (const step of data.manualStepsRemaining) {
+            lines.push(`  ${chalk.yellow('□')} Step ${step.stepNumber}: ${step.description}`);
+            if (step.manualSteps) {
+                for (const ms of step.manualSteps) {
+                    lines.push(`    ${chalk.dim('•')} ${ms}`);
+                }
+            }
+        }
+    }
+    lines.push('');
+    lines.push(chalk.bold('  What\'s next:'));
+    lines.push(`    • Review applied changes:    ${chalk.dim('git diff')}`);
+    lines.push(`    • Build and test:            ${chalk.dim('mvn clean install')}`);
+    if (data.failed > 0) {
+        lines.push(`    • Re-run failed steps:       ${chalk.dim('brxm-upgrade execute --resume')}`);
+    }
+    lines.push(`    • View your upgrade plan:    ${chalk.dim('.brxm-upgrade/plan.json')}`);
+    if (data.manualStepsRemaining.length > 0) {
+        lines.push(`    • Complete ${data.manualStepsRemaining.length} manual step(s) listed above`);
+    }
+    lines.push('');
+    lines.push(chalk.dim('  For additional guidance, consult the upgrade documentation'));
+    lines.push(chalk.dim('  at https://xmdocumentation.bloomreach.com'));
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Word-wrap and indent text for clean terminal display.
+ *
+ * Long paragraphs are wrapped so that every visual line starts with the
+ * indent — no ragged left edge from terminal line-wrapping. Blank lines
+ * between paragraphs are preserved.
+ *
+ * @param text - Raw text to indent and wrap
+ * @param indent - Number of spaces to indent (default 2)
+ * @param maxWidth - Target line width including indent (default 80)
+ */
+export function wrapIndentedText(text, indent = 2, maxWidth = 80) {
+    const pad = ' '.repeat(indent);
+    const contentWidth = maxWidth - indent;
+    return text
+        .split('\n')
+        .flatMap((line) => {
+        if (line.trim() === '')
+            return [''];
+        return wordWrap(line.trim(), contentWidth).map((wrapped) => pad + wrapped);
+    })
+        .join('\n');
+}
+/**
+ * Break a single line into multiple lines at word boundaries,
+ * each no longer than maxWidth characters.
+ */
+function wordWrap(line, maxWidth) {
+    if (line.length <= maxWidth)
+        return [line];
+    const result = [];
+    let remaining = line;
+    while (remaining.length > maxWidth) {
+        // Find the last space within maxWidth
+        let breakAt = remaining.lastIndexOf(' ', maxWidth);
+        if (breakAt <= 0) {
+            // No space found — force break at maxWidth
+            breakAt = maxWidth;
+        }
+        result.push(remaining.slice(0, breakAt));
+        remaining = remaining.slice(breakAt).trimStart();
+    }
+    if (remaining.length > 0) {
+        result.push(remaining);
+    }
+    return result;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/guide/rendering/formatters.js.map

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

package/dist/guide/rendering/index.d.ts

@@ -0,0 +1,2 @@
+export { formatPhaseHeader, formatVersionCard, formatStepBriefing, formatProgressBar, formatWelcomeBanner, formatResumeBanner, } from './formatters.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/guide/rendering/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/guide/rendering/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/guide/rendering/index.js

@@ -0,0 +1,2 @@
+export { formatPhaseHeader, formatVersionCard, formatStepBriefing, formatProgressBar, formatWelcomeBanner, formatResumeBanner, } from './formatters.js';
+//# sourceMappingURL=index.js.map

package/dist/guide/rendering/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/guide/rendering/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/guide/rendering/platform-changes.d.ts

@@ -0,0 +1,18 @@
+import type { ManifestEntry, ManifestEntryType } from '../../planning/types.js';
+type InformationalCategory = 'security' | 'performance' | 'ui_ux' | 'internal_cleanup' | 'configuration';
+/** Map an entry type to an informational category. */
+export declare function categoryFromType(type: ManifestEntryType): InformationalCategory;
+/** Group informational entries by category. */
+export declare function groupByCategory(entries: ManifestEntry[]): Map<InformationalCategory, ManifestEntry[]>;
+/** Format the Platform Changes Summary for CLI output. */
+export declare function formatPlatformChangesSummary(entries: ManifestEntry[], fromVersion: string, toVersion: string): string;
+/** Build structured payload for MCP responses, grouping entries by category. */
+export declare function buildPlatformChangesPayload(entries: ManifestEntry[]): Array<{
+    category: string;
+    entries: Array<{
+        id: string;
+        summary: string;
+    }>;
+}>;
+export {};
+//# sourceMappingURL=platform-changes.d.ts.map

package/dist/guide/rendering/platform-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-changes.d.ts","sourceRoot":"","sources":["../../../src/guide/rendering/platform-changes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEhF,KAAK,qBAAqB,GAAG,UAAU,GAAG,aAAa,GAAG,OAAO,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAqBzG,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,qBAAqB,CAE/E;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,qBAAqB,EAAE,aAAa,EAAE,CAAC,CAWrG;AAED,0DAA0D;AAC1D,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,aAAa,EAAE,EACxB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAoCR;AAED,gFAAgF;AAChF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,aAAa,EAAE,GACvB,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAsB9E"}

package/dist/guide/rendering/platform-changes.js

@@ -0,0 +1,86 @@
+import chalk from 'chalk';
+const CATEGORY_LABELS = {
+    security: 'Security',
+    performance: 'Performance',
+    ui_ux: 'UI/UX',
+    internal_cleanup: 'Internal Cleanup',
+    configuration: 'Configuration',
+};
+const TYPE_TO_CATEGORY = {
+    security_configuration: 'security',
+    repository_migration: 'internal_cleanup',
+    configuration_migration: 'configuration',
+    frontend_migration: 'ui_ux',
+    maven_update: 'configuration',
+    dependency_migration: 'configuration',
+    namespace_migration: 'configuration',
+    api_migration: 'configuration',
+};
+/** Map an entry type to an informational category. */
+export function categoryFromType(type) {
+    return TYPE_TO_CATEGORY[type] ?? 'configuration';
+}
+/** Group informational entries by category. */
+export function groupByCategory(entries) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const category = entry.informational_category ?? categoryFromType(entry.type);
+        const list = groups.get(category) ?? [];
+        list.push(entry);
+        groups.set(category, list);
+    }
+    return groups;
+}
+/** Format the Platform Changes Summary for CLI output. */
+export function formatPlatformChangesSummary(entries, fromVersion, toVersion) {
+    if (entries.length === 0)
+        return '';
+    const lines = [];
+    const title = `Platform Changes Summary (${fromVersion} → ${toVersion})`;
+    lines.push('');
+    lines.push(chalk.cyan('╭' + '─'.repeat(title.length + 4) + '╮'));
+    lines.push(chalk.cyan('│  ') + chalk.bold.white(title) + chalk.cyan('  │'));
+    lines.push(chalk.cyan('╰' + '─'.repeat(title.length + 4) + '╯'));
+    lines.push('');
+    const grouped = groupByCategory(entries);
+    const categoryOrder = [
+        'security', 'performance', 'ui_ux', 'internal_cleanup', 'configuration',
+    ];
+    for (const category of categoryOrder) {
+        const group = grouped.get(category);
+        if (!group || group.length === 0)
+            continue;
+        const label = CATEGORY_LABELS[category];
+        const count = group.length;
+        lines.push(chalk.bold(`${label} (${count} change${count === 1 ? '' : 's'})`));
+        for (const entry of group) {
+            const summary = entry.changelog_summary ?? entry.description;
+            const ticket = entry.jira_ticket ? ` (${entry.jira_ticket})` : '';
+            lines.push(`  - ${summary}${ticket}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/** Build structured payload for MCP responses, grouping entries by category. */
+export function buildPlatformChangesPayload(entries) {
+    const grouped = groupByCategory(entries);
+    const result = [];
+    const categoryOrder = [
+        'security', 'performance', 'ui_ux', 'internal_cleanup', 'configuration',
+    ];
+    for (const category of categoryOrder) {
+        const group = grouped.get(category);
+        if (!group || group.length === 0)
+            continue;
+        result.push({
+            category: CATEGORY_LABELS[category],
+            entries: group.map((e) => ({
+                id: e.id,
+                summary: e.changelog_summary ?? e.description,
+            })),
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=platform-changes.js.map

package/dist/guide/rendering/platform-changes.js.map

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

package/dist/guide/types.d.ts

@@ -0,0 +1,100 @@
+import type { AIClient } from '../ai/types.js';
+import type { BrxmUpgradeConfig } from '../config/index.js';
+import type { ProjectContext } from '../discovery/types.js';
+import type { UpgradePlan, PlanStep, ManifestLoadOptions } from '../planning/types.js';
+import type { ExecutionState, StepExecutionResult } from '../execution/types.js';
+import type { DocsClient } from '../docs/docs-client.js';
+import type { UpgradeState } from '../core/upgrade-state.js';
+/**
+ * Structured transition message shown between phases.
+ * Explains what happened and what's coming next.
+ */
+export interface TransitionMessage {
+    /** What this phase accomplished (e.g., "We scanned your project and found 5 modules...") */
+    whatHappened: string;
+    /** What the next phase will do (e.g., "We'll analyze all 27 changes...") */
+    whatIsNext: string;
+    /** The continue prompt (e.g., "Continue to planning?") */
+    continuePrompt: string;
+}
+/**
+ * Result of a single guide phase.
+ */
+export interface PhaseResult {
+    success: boolean;
+    summary: string;
+    data?: unknown;
+    error?: string;
+    transitionMessage?: TransitionMessage;
+}
+/**
+ * Shared context passed between guide phases.
+ * Accumulates state as each phase completes.
+ */
+export interface GuideContext {
+    projectRoot: string;
+    config: BrxmUpgradeConfig;
+    manifestOptions: ManifestLoadOptions;
+    ai?: AIClient;
+    docsClient?: DocsClient;
+    currentVersion?: string;
+    targetVersion?: string;
+    discovery?: ProjectContext;
+    plan?: UpgradePlan;
+    executionState?: ExecutionState;
+    executionResults?: StepExecutionResult[];
+}
+/**
+ * Interface for a single guide phase.
+ */
+export interface GuidePhase {
+    readonly name: string;
+    readonly phaseNumber: number;
+    readonly totalPhases: number;
+    readonly canChat: boolean;
+    run(context: GuideContext): Promise<PhaseResult>;
+}
+/**
+ * AI-generated summary for a single version.
+ */
+export interface VersionSummary {
+    version: string;
+    headline: string;
+    bullets: string[];
+    automatedCount: number;
+    reviewCount: number;
+}
+/**
+ * Cache structure for version summaries.
+ */
+export interface VersionSummaryCache {
+    /** ISO-8601 timestamp string (e.g. `"2023-01-01T12:00:00.000Z"`) */
+    generatedAt: string;
+    fromVersion: string;
+    summaries: VersionSummary[];
+}
+/**
+ * Final summary of the guided upgrade run.
+ */
+export interface GuideSummary {
+    fromVersion: string;
+    toVersion: string;
+    completedSteps: number;
+    skippedSteps: number;
+    manualStepsRemaining: PlanStep[];
+    /** Total elapsed time in milliseconds */
+    duration: number;
+}
+/**
+ * Resume state detected on startup.
+ */
+export interface ResumeState {
+    hasDiscovery: boolean;
+    hasPlan: boolean;
+    hasExecution: boolean;
+    discovery?: ProjectContext;
+    plan?: UpgradePlan;
+    executionState?: ExecutionState;
+    upgradeState?: UpgradeState;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/guide/types.js

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

package/dist/guide/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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