@bloomreach/brxm-upgrade 0.1.1

package/dist/docs/docs-client.d.ts

@@ -0,0 +1,44 @@
+import type { DocsServerConfig } from '../types/index.js';
+import type { DocSearchResult } from './types.js';
+/**
+ * Thin MCP client for the brxm-docs documentation server.
+ * Provides semantic search and page retrieval with graceful degradation.
+ * When the server is unreachable, operations return empty results instead of throwing.
+ */
+export declare class DocsClient {
+    private client;
+    private connected;
+    private unavailable;
+    private readonly config;
+    private readonly searchCache;
+    private readonly logger;
+    constructor(config?: Partial<DocsServerConfig>, verbose?: boolean);
+    /**
+     * Search documentation for pages relevant to the given query.
+     *
+     * @param query - Natural language search query
+     * @param limit - Maximum number of results to return (default: 3)
+     * @returns Array of search results, or empty array on failure
+     */
+    search(query: string, limit?: number): Promise<DocSearchResult[]>;
+    /**
+     * Get a summary for a specific documentation page.
+     *
+     * @param url - The documentation page URL
+     * @returns Summary text, or null on failure
+     */
+    getPageSummary(url: string): Promise<string | null>;
+    /**
+     * Whether dynamic (AI-initiated) searches are enabled and the server is reachable.
+     */
+    get isDynamicSearchEnabled(): boolean;
+    /**
+     * Gracefully close the MCP connection.
+     */
+    disconnect(): Promise<void>;
+    private ensureConnected;
+    private callWithTimeout;
+    private parseSearchResults;
+    private markUnavailable;
+}
+//# sourceMappingURL=docs-client.d.ts.map

package/dist/docs/docs-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-client.d.ts","sourceRoot":"","sources":["../../src/docs/docs-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IACpE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM,EAAE,OAAO,UAAQ;IASnE;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA+BlE;;;;;OAKG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBzD;;OAEG;IACH,IAAI,sBAAsB,IAAI,OAAO,CAEpC;IAED;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAYnB,eAAe;YAqBf,eAAe;IAY7B,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,eAAe;CAMxB"}

package/dist/docs/docs-client.js

@@ -0,0 +1,161 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { createLogger } from '../utils/logger.js';
+const CONNECTION_TIMEOUT_MS = 5_000;
+const REQUEST_TIMEOUT_MS = 10_000;
+/**
+ * Thin MCP client for the brxm-docs documentation server.
+ * Provides semantic search and page retrieval with graceful degradation.
+ * When the server is unreachable, operations return empty results instead of throwing.
+ */
+export class DocsClient {
+    client = null;
+    connected = false;
+    unavailable = false;
+    config;
+    searchCache = new Map();
+    logger;
+    constructor(config = {}, verbose = false) {
+        this.config = {
+            url: config.url ?? 'https://brxm-docs.bloomreach.works/mcp',
+            enabled: config.enabled ?? true,
+            dynamicSearch: config.dynamicSearch ?? true,
+        };
+        this.logger = createLogger({ prefix: 'docs', verbose });
+    }
+    /**
+     * Search documentation for pages relevant to the given query.
+     *
+     * @param query - Natural language search query
+     * @param limit - Maximum number of results to return (default: 3)
+     * @returns Array of search results, or empty array on failure
+     */
+    async search(query, limit = 3) {
+        if (!this.config.enabled || this.unavailable)
+            return [];
+        const cacheKey = `${query}:${limit}`;
+        const cached = this.searchCache.get(cacheKey);
+        if (cached) {
+            this.logger.debug(`Cache hit for "${query}" (${cached.length} results)`);
+            return cached;
+        }
+        try {
+            await this.ensureConnected();
+            this.logger.debug(`Searching: "${query}"`);
+            const result = await this.callWithTimeout('semantic_search', { query, limit });
+            const results = this.parseSearchResults(result);
+            this.searchCache.set(cacheKey, results);
+            if (results.length > 0) {
+                this.logger.debug(`Found ${results.length} result(s):`);
+                for (const r of results) {
+                    this.logger.debug(`  - ${r.title} (${r.url})`);
+                }
+            }
+            else {
+                this.logger.debug(`No results for "${query}"`);
+            }
+            return results;
+        }
+        catch {
+            this.markUnavailable();
+            return [];
+        }
+    }
+    /**
+     * Get a summary for a specific documentation page.
+     *
+     * @param url - The documentation page URL
+     * @returns Summary text, or null on failure
+     */
+    async getPageSummary(url) {
+        if (!this.config.enabled || this.unavailable)
+            return null;
+        try {
+            await this.ensureConnected();
+            this.logger.debug(`Fetching summary for ${url}`);
+            const result = await this.callWithTimeout('get_summary', { url });
+            if (result && typeof result === 'object' && 'text' in result) {
+                return String(result.text);
+            }
+            return typeof result === 'string' ? result : null;
+        }
+        catch {
+            this.markUnavailable();
+            return null;
+        }
+    }
+    /**
+     * Whether dynamic (AI-initiated) searches are enabled and the server is reachable.
+     */
+    get isDynamicSearchEnabled() {
+        return this.config.enabled && this.config.dynamicSearch && !this.unavailable;
+    }
+    /**
+     * Gracefully close the MCP connection.
+     */
+    async disconnect() {
+        if (this.client) {
+            try {
+                await this.client.close();
+            }
+            catch {
+                /* ignore close errors */
+            }
+            this.client = null;
+            this.connected = false;
+        }
+    }
+    async ensureConnected() {
+        if (this.connected)
+            return;
+        if (this.unavailable)
+            throw new Error('Docs server unavailable');
+        const transport = new StreamableHTTPClientTransport(new URL(this.config.url));
+        this.client = new Client({ name: 'brxm-upgrade', version: '0.1.0' }, { capabilities: {} });
+        const connectPromise = this.client.connect(transport);
+        const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('Connection timeout')), CONNECTION_TIMEOUT_MS));
+        await Promise.race([connectPromise, timeoutPromise]);
+        this.connected = true;
+        this.logger.debug(`Connected to documentation server at ${new URL(this.config.url).host}`);
+    }
+    async callWithTimeout(tool, args) {
+        if (!this.client)
+            throw new Error('Not connected');
+        const callPromise = this.client.callTool({ name: tool, arguments: args });
+        const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('Request timeout')), REQUEST_TIMEOUT_MS));
+        const result = await Promise.race([callPromise, timeoutPromise]);
+        return result?.content?.[0] ?? null;
+    }
+    parseSearchResults(raw) {
+        if (!raw || typeof raw !== 'object')
+            return [];
+        const text = raw.text;
+        if (!text)
+            return [];
+        try {
+            const parsed = JSON.parse(text);
+            if (Array.isArray(parsed)) {
+                return parsed.map((item) => {
+                    const r = item;
+                    return {
+                        title: typeof r.title === 'string' ? r.title : '',
+                        url: typeof r.url === 'string' ? r.url : '',
+                        snippet: typeof r.snippet === 'string' ? r.snippet : (typeof r.summary === 'string' ? r.summary : ''),
+                        score: typeof r.score === 'number' ? r.score : undefined,
+                    };
+                });
+            }
+        }
+        catch {
+            /* not JSON, treat as plain text — return empty */
+        }
+        return [];
+    }
+    markUnavailable() {
+        if (!this.unavailable) {
+            this.unavailable = true;
+            this.logger.info('Documentation server unavailable, continuing without doc context.');
+        }
+    }
+}
+//# sourceMappingURL=docs-client.js.map

package/dist/docs/docs-client.js.map

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

package/dist/docs/docs-context.d.ts

@@ -0,0 +1,23 @@
+import type { DocSearchResult } from './types.js';
+/**
+ * Builds documentation context strings for injection into AI prompts.
+ */
+export declare class DocsContext {
+    /**
+     * Format search results into a context block for AI prompts.
+     * Returns empty string if no results.
+     */
+    static buildDocContext(results: DocSearchResult[]): string;
+    /**
+     * Build a concise search query from manifest entry metadata.
+     * Prefers doc_search_keywords when available (generated during manifest creation).
+     * Falls back to deriving keywords from the entry id slug.
+     * Uses only generic brXM terms — never customer-specific data.
+     */
+    static buildSearchQuery(entry: {
+        id: string;
+        type: string;
+        doc_search_keywords?: string[];
+    }): string;
+}
+//# sourceMappingURL=docs-context.d.ts.map

package/dist/docs/docs-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-context.d.ts","sourceRoot":"","sources":["../../src/docs/docs-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD;;GAEG;AACH,qBAAa,WAAW;IACtB;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM;IAc1D;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,MAAM;CAYrG"}

package/dist/docs/docs-context.js

@@ -0,0 +1,41 @@
+const MAX_RESULTS_IN_CONTEXT = 3;
+const MAX_SNIPPET_LENGTH = 500;
+/**
+ * Builds documentation context strings for injection into AI prompts.
+ */
+export class DocsContext {
+    /**
+     * Format search results into a context block for AI prompts.
+     * Returns empty string if no results.
+     */
+    static buildDocContext(results) {
+        if (results.length === 0)
+            return '';
+        const limited = results.slice(0, MAX_RESULTS_IN_CONTEXT);
+        const sections = limited.map((r) => {
+            const snippet = r.snippet.length > MAX_SNIPPET_LENGTH
+                ? r.snippet.substring(0, MAX_SNIPPET_LENGTH) + '...'
+                : r.snippet;
+            return `**${r.title}** (${r.url})\n${snippet}`;
+        });
+        return `Relevant brXM documentation:\n\n${sections.join('\n\n---\n\n')}`;
+    }
+    /**
+     * Build a concise search query from manifest entry metadata.
+     * Prefers doc_search_keywords when available (generated during manifest creation).
+     * Falls back to deriving keywords from the entry id slug.
+     * Uses only generic brXM terms — never customer-specific data.
+     */
+    static buildSearchQuery(entry) {
+        if (entry.doc_search_keywords && entry.doc_search_keywords.length > 0) {
+            return `brXM ${entry.doc_search_keywords.join(' ')}`;
+        }
+        // Fallback: derive from id slug like "cms-18005-cmyk-rgb-conversion-fix" → "cmyk rgb conversion fix"
+        const idWords = entry.id
+            .replace(/^[a-z]+-\d+-/, '') // strip ticket prefix (e.g. "cms-18005-")
+            .replace(/-/g, ' ');
+        const type = entry.type.replace(/_/g, ' ');
+        return `brXM ${idWords} ${type}`;
+    }
+}
+//# sourceMappingURL=docs-context.js.map

package/dist/docs/docs-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-context.js","sourceRoot":"","sources":["../../src/docs/docs-context.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACjC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B;;GAEG;AACH,MAAM,OAAO,WAAW;IACtB;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,OAA0B;QAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACjC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,kBAAkB;gBACnD,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,kBAAkB,CAAC,GAAG,KAAK;gBACpD,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACd,OAAO,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,MAAM,OAAO,EAAE,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,OAAO,mCAAmC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;IAC3E,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAmE;QACzF,IAAI,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtE,OAAO,QAAQ,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,CAAC;QAED,qGAAqG;QACrG,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE;aACrB,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,0CAA0C;aACtE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACtB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3C,OAAO,QAAQ,OAAO,IAAI,IAAI,EAAE,CAAC;IACnC,CAAC;CACF"}

package/dist/docs/index.d.ts

@@ -0,0 +1,4 @@
+export { DocsClient } from './docs-client.js';
+export { DocsContext } from './docs-context.js';
+export type { DocSearchResult, DocPage } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/docs/index.js

@@ -0,0 +1,3 @@
+export { DocsClient } from './docs-client.js';
+export { DocsContext } from './docs-context.js';
+//# sourceMappingURL=index.js.map

package/dist/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/docs/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A single search result from the docs MCP server.
+ */
+export interface DocSearchResult {
+    /** Page title */
+    title: string;
+    /** Page URL on the documentation site */
+    url: string;
+    /** Relevant snippet or summary */
+    snippet: string;
+    /** Relevance score (0-1) */
+    score?: number;
+}
+/**
+ * Full page content from the docs MCP server.
+ */
+export interface DocPage {
+    /** Page title */
+    title: string;
+    /** Page URL */
+    url: string;
+    /** Full page content (markdown) */
+    content: string;
+    /** AI-generated summary */
+    summary?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/docs/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/docs/types.js

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

package/dist/docs/types.js.map

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

package/dist/execution/diff-presenter.d.ts

@@ -0,0 +1,52 @@
+import type { PlanStep } from '../planning/types.js';
+import type { PreparedChanges, StepDecision } from './types.js';
+/**
+ * Presents diffs and step details to the user and collects their decisions
+ * via interactive inquirer prompts.
+ */
+export declare class DiffPresenter {
+    /**
+     * Formats a step header with metadata badges for terminal display.
+     *
+     * @param step - The plan step to format
+     * @param totalSteps - Total number of steps in the plan
+     * @returns Formatted header string with ANSI color codes
+     */
+    formatStepHeader(step: PlanStep, totalSteps: number): string;
+    /**
+     * Presents prepared changes to the user with a diff summary and optional
+     * AI analysis, then prompts for a decision.
+     *
+     * @param prepared - The prepared changes to present
+     * @returns The user's decision for this step
+     */
+    presentChanges(prepared: PreparedChanges): Promise<StepDecision>;
+    /**
+     * Displays the full colorized diff for all changes in a prepared set.
+     *
+     * @param prepared - The prepared changes to display diffs for
+     */
+    showFullDiff(prepared: PreparedChanges): void;
+    /**
+     * Presents a manual step with instructions and prompts the user to confirm
+     * whether they have completed the steps.
+     *
+     * @param step - The manual plan step to present
+     * @returns 'accept' if the user confirms completion, 'skip' otherwise
+     */
+    presentManualStep(step: PlanStep): Promise<StepDecision>;
+    /**
+     * Prompts the user for a decision on prepared changes. If the user chooses
+     * to view the full diff, shows it and re-prompts.
+     */
+    private promptForDecision;
+    /**
+     * Returns a colorized badge string for the automation level.
+     */
+    private getAutomationBadge;
+    /**
+     * Returns a human-readable label for a numeric risk level (1-5).
+     */
+    private getRiskBadge;
+}
+//# sourceMappingURL=diff-presenter.d.ts.map

package/dist/execution/diff-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-presenter.d.ts","sourceRoot":"","sources":["../../src/execution/diff-presenter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGhE;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAwB5D;;;;;;OAMG;IACG,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBtE;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAO7C;;;;;;OAMG;IACG,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;IA8B9D;;;OAGG;YACW,iBAAiB;IA2B/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,YAAY;CAKrB"}

package/dist/execution/diff-presenter.js

@@ -0,0 +1,148 @@
+/* eslint-disable no-console */
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { generateDiff, formatDiffForTerminal, summarizeDiffs } from '../utils/diff.js';
+/**
+ * Presents diffs and step details to the user and collects their decisions
+ * via interactive inquirer prompts.
+ */
+export class DiffPresenter {
+    /**
+     * Formats a step header with metadata badges for terminal display.
+     *
+     * @param step - The plan step to format
+     * @param totalSteps - Total number of steps in the plan
+     * @returns Formatted header string with ANSI color codes
+     */
+    formatStepHeader(step, totalSteps) {
+        const automationBadge = this.getAutomationBadge(step.automatable);
+        const riskBadge = this.getRiskBadge(step.riskLevel);
+        const lines = [
+            '',
+            chalk.bold('\u2501'.repeat(70)),
+            chalk.bold(`Step ${step.stepNumber}/${totalSteps}: ${step.entryId}`),
+            chalk.bold('\u2501'.repeat(70)),
+            '',
+            `${chalk.cyan('Description:')} ${step.description}`,
+            `${chalk.cyan('Type:')} ${step.type}`,
+            `${chalk.cyan('Automation:')} ${automationBadge}`,
+            `${chalk.cyan('Risk Level:')} ${riskBadge}`,
+            `${chalk.cyan('Files Affected:')} ${step.affectedFileCount}`,
+        ];
+        if (step.documentationUrl) {
+            lines.push(`${chalk.cyan('Documentation:')} ${step.documentationUrl}`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Presents prepared changes to the user with a diff summary and optional
+     * AI analysis, then prompts for a decision.
+     *
+     * @param prepared - The prepared changes to present
+     * @returns The user's decision for this step
+     */
+    async presentChanges(prepared) {
+        const diffs = prepared.changes.map((change) => generateDiff(change.originalContent, change.modifiedContent, change.filePath));
+        console.log(summarizeDiffs(diffs));
+        if (prepared.aiAnalysis) {
+            console.log('');
+            console.log(chalk.yellow('AI Analysis:'));
+            console.log(prepared.aiAnalysis);
+        }
+        return this.promptForDecision(prepared);
+    }
+    /**
+     * Displays the full colorized diff for all changes in a prepared set.
+     *
+     * @param prepared - The prepared changes to display diffs for
+     */
+    showFullDiff(prepared) {
+        for (const change of prepared.changes) {
+            const diff = generateDiff(change.originalContent, change.modifiedContent, change.filePath);
+            console.log(formatDiffForTerminal(diff));
+        }
+    }
+    /**
+     * Presents a manual step with instructions and prompts the user to confirm
+     * whether they have completed the steps.
+     *
+     * @param step - The manual plan step to present
+     * @returns 'accept' if the user confirms completion, 'skip' otherwise
+     */
+    async presentManualStep(step) {
+        console.log('');
+        console.log(chalk.yellow('Manual Steps Required:'));
+        console.log('');
+        if (step.manualSteps) {
+            step.manualSteps.forEach((s, i) => {
+                console.log(`  ${chalk.cyan(`${i + 1}.`)} ${s}`);
+            });
+        }
+        if (step.documentationUrl) {
+            console.log('');
+            console.log(`${chalk.cyan('Documentation:')} ${step.documentationUrl}`);
+        }
+        console.log('');
+        const { completed } = (await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'completed',
+                message: 'Have you completed these manual steps?',
+                default: false,
+            },
+        ]));
+        return completed ? 'accept' : 'skip';
+    }
+    /**
+     * Prompts the user for a decision on prepared changes. If the user chooses
+     * to view the full diff, shows it and re-prompts.
+     */
+    async promptForDecision(prepared) {
+        const choices = [
+            { name: 'Accept changes', value: 'accept' },
+            ...(prepared.changes.length > 0
+                ? [{ name: 'View full diff', value: 'view_diff' }]
+                : []),
+            { name: 'Skip this step', value: 'skip' },
+            { name: 'Reject and rollback', value: 'reject' },
+        ];
+        const { action } = (await inquirer.prompt([
+            {
+                type: 'select',
+                name: 'action',
+                message: 'What would you like to do?',
+                choices,
+            },
+        ]));
+        if (action === 'view_diff') {
+            this.showFullDiff(prepared);
+            return this.promptForDecision(prepared);
+        }
+        return action;
+    }
+    /**
+     * Returns a colorized badge string for the automation level.
+     */
+    getAutomationBadge(level) {
+        switch (level) {
+            case 'true':
+                return chalk.green('Automated');
+            case 'partial':
+                return chalk.yellow('AI-Assisted');
+            case 'false':
+                return chalk.red('Manual');
+            default:
+                return level;
+        }
+    }
+    /**
+     * Returns a human-readable label for a numeric risk level (1-5).
+     */
+    getRiskBadge(level) {
+        const labels = ['Very Low', 'Low', 'Medium', 'High', 'Critical'];
+        const idx = Math.min(Math.max(level - 1, 0), labels.length - 1);
+        return labels[idx];
+    }
+}
+//# sourceMappingURL=diff-presenter.js.map

package/dist/execution/diff-presenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-presenter.js","sourceRoot":"","sources":["../../src/execution/diff-presenter.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvF;;;GAGG;AACH,MAAM,OAAO,aAAa;IACxB;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAc,EAAE,UAAkB;QACjD,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEpD,MAAM,KAAK,GAAG;YACZ,EAAE;YACF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YACpE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC/B,EAAE;YACF,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE;YACnD,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE;YACrC,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,eAAe,EAAE;YACjD,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,SAAS,EAAE;YAC3C,GAAG,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,iBAAiB,EAAE;SAC7D,CAAC;QAEF,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAAC,QAAyB;QAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC5C,YAAY,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,QAAQ,CAAC,CAC9E,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QAEnC,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,QAAyB;QACpC,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3F,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,iBAAiB,CAAC,IAAc;QACpC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAChC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC;YAC3C;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,wCAAwC;gBACjD,OAAO,EAAE,KAAK;aACf;SACF,CAAC,CAA2B,CAAC;QAE9B,OAAO,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IACvC,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,iBAAiB,CAAC,QAAyB;QACvD,MAAM,OAAO,GAAG;YACd,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE;YAC3C,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAC7B,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;gBAClD,CAAC,CAAC,EAAE,CAAC;YACP,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE;YACzC,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE;SACjD,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC;YACxC;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,4BAA4B;gBACrC,OAAO;aACR;SACF,CAAC,CAAuB,CAAC;QAE1B,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,MAAsB,CAAC;IAChC,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,KAAa;QACtC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAClC,KAAK,SAAS;gBACZ,OAAO,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACrC,KAAK,OAAO;gBACV,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC7B;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,KAAa;QAChC,MAAM,MAAM,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAChE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;CACF"}

package/dist/execution/executors/ai-assisted.d.ts

@@ -0,0 +1,28 @@
+import type { PlanStep, AutomationLevel } from '../../planning/types.js';
+import type { AIClient } from '../../ai/types.js';
+import type { IStepExecutor, PreparedChanges, FileChange } from '../types.js';
+/**
+ * Executor for AI-assisted steps (automatable === 'partial').
+ *
+ * Uses the AI client to propose concrete file edits against a bounded set of
+ * candidate files. The user can review the diff, ask the AI to revise the
+ * proposal, and then decide whether to apply it.
+ */
+export declare class AIAssistedExecutor implements IStepExecutor {
+    readonly automationLevel: AutomationLevel;
+    private readonly aiClient;
+    constructor(aiClient: AIClient);
+    prepare(step: PlanStep, projectRoot: string): Promise<PreparedChanges>;
+    revise(step: PlanStep, projectRoot: string, previousProposal: PreparedChanges, revisionRequest: string): Promise<PreparedChanges>;
+    apply(prepared: PreparedChanges, _projectRoot: string): Promise<FileChange[]>;
+    private proposeChanges;
+    private resolveCandidateFiles;
+    private resolveDirectFiles;
+    private readCandidateFiles;
+    private truncateContent;
+    private matchesPattern;
+    private buildProposalPrompt;
+    private parseProposalResponse;
+    private extractJsonObject;
+}
+//# sourceMappingURL=ai-assisted.d.ts.map

package/dist/execution/executors/ai-assisted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-assisted.d.ts","sourceRoot":"","sources":["../../../src/execution/executors/ai-assisted.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAwB9E;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACtD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAa;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAExB,QAAQ,EAAE,QAAQ;IAIxB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAItE,MAAM,CACV,IAAI,EAAE,QAAQ,EACd,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,eAAe,EACjC,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,CAAC;IAOrB,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YAYrE,cAAc;YAgEd,qBAAqB;IA2BnC,OAAO,CAAC,kBAAkB;YAWZ,kBAAkB;IAgBhC,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,mBAAmB;IA2D3B,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,iBAAiB;CAQ1B"}