@nebutra/next-unicorn-skill 1.0.0

package/dist/planner/migration-planner.js

@@ -0,0 +1,144 @@
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const RISK_PHASE_MAP = {
+    low: { order: 1, name: 'Low-Risk Quick Wins' },
+    medium: { order: 2, name: 'Medium-Risk Improvements' },
+    high: { order: 3, name: 'High-Risk Transformations' },
+};
+// ---------------------------------------------------------------------------
+// buildMigrationPlan — main entry point
+// ---------------------------------------------------------------------------
+/**
+ * Build a phased migration plan from a list of recommendations.
+ *
+ * Phasing logic:
+ * - Phase 1: low-risk items
+ * - Phase 2: medium-risk items
+ * - Phase 3: high-risk items (with adapter strategies)
+ *
+ * Within each phase, items are ordered by composite score descending
+ * (highest impact first).
+ *
+ * Only phases that have items are included (empty phases are skipped).
+ *
+ * High-risk items MUST have an AdapterStrategy generated — if the input
+ * recommendation doesn't already have one, a default is generated.
+ *
+ * The deletion checklist includes EVERY filePath from recommendations.
+ *
+ * Empty recommendations → empty plan with zero phases.
+ *
+ * Requirements: 4.1, 4.2, 4.3, 4.4, 9.4
+ */
+export function buildMigrationPlan(recommendations) {
+    if (recommendations.length === 0) {
+        return { phases: [], deletionChecklist: [] };
+    }
+    // --- Step 1: Group recommendations by risk level ---
+    const groups = {
+        low: [],
+        medium: [],
+        high: [],
+    };
+    for (let i = 0; i < recommendations.length; i++) {
+        const rec = recommendations[i];
+        const risk = rec.migrationRisk;
+        groups[risk].push({ index: i, rec });
+    }
+    // --- Step 2: Sort each group by composite score descending ---
+    for (const risk of ['low', 'medium', 'high']) {
+        groups[risk].sort((a, b) => b.rec.impactScores.composite - a.rec.impactScores.composite);
+    }
+    // --- Step 3: Build phases (only non-empty groups) ---
+    const phases = [];
+    let phaseNumber = 1;
+    for (const risk of ['low', 'medium', 'high']) {
+        const items = groups[risk];
+        if (items.length === 0)
+            continue;
+        const phaseMeta = RISK_PHASE_MAP[risk];
+        const steps = items.map((item) => {
+            const step = buildMigrationStep(item.index, item.rec, risk);
+            return step;
+        });
+        phases.push({
+            phase: phaseNumber,
+            name: phaseMeta.name,
+            steps,
+        });
+        phaseNumber++;
+    }
+    // --- Step 4: Build deletion checklist ---
+    const deletionChecklist = buildDeletionChecklist(recommendations);
+    return { phases, deletionChecklist };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Build a single migration step from a recommendation.
+ *
+ * For high-risk items, ensures an AdapterStrategy is present.
+ * If the recommendation already has one, it is used; otherwise a default
+ * is generated from the recommendation's metadata.
+ */
+function buildMigrationStep(index, rec, risk) {
+    const description = buildStepDescription(rec, risk);
+    const step = {
+        recommendationIndex: index,
+        description,
+    };
+    if (risk === 'high') {
+        step.adapterStrategy = rec.adapterStrategy ?? generateDefaultAdapterStrategy(rec);
+    }
+    return step;
+}
+/**
+ * Build a human-readable description for a migration step.
+ */
+function buildStepDescription(rec, risk) {
+    const pattern = rec.currentImplementation.patternCategory;
+    const library = rec.recommendedLibrary.name;
+    const filePath = rec.currentImplementation.filePath;
+    if (risk === 'high') {
+        return `Replace ${pattern} in ${filePath} with ${library} using adapter strategy`;
+    }
+    if (risk === 'medium') {
+        return `Replace ${pattern} in ${filePath} with ${library}`;
+    }
+    return `Replace ${pattern} in ${filePath} with ${library} (quick win)`;
+}
+/**
+ * Generate a default AdapterStrategy for a high-risk recommendation
+ * that doesn't already have one.
+ *
+ * Requirements: 4.2, 9.4
+ */
+function generateDefaultAdapterStrategy(rec) {
+    const pattern = rec.currentImplementation.patternCategory;
+    const library = rec.recommendedLibrary.name;
+    const filePath = rec.currentImplementation.filePath;
+    return {
+        wrapperInterface: `I${pattern}Adapter`,
+        legacyCode: filePath,
+        targetLibrary: library,
+        description: `Adapter wrapping legacy ${pattern} implementation to transition to ${library}`,
+    };
+}
+/**
+ * Build the deletion checklist from all recommendations.
+ *
+ * Every filePath from a recommendation's currentImplementation appears
+ * in the checklist.
+ *
+ * Requirements: 4.3
+ */
+function buildDeletionChecklist(recommendations) {
+    return recommendations.map((rec) => ({
+        filePath: rec.currentImplementation.filePath,
+        lineRange: rec.currentImplementation.lineRange,
+        reason: `Replaced ${rec.currentImplementation.patternCategory} with ${rec.recommendedLibrary.name}`,
+    }));
+}
+//# sourceMappingURL=migration-planner.js.map

package/dist/planner/migration-planner.js.map

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

package/dist/pr-creator/git-operations.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Git Operations — injectable interface for git CLI operations.
+ *
+ * Real implementation shells out to git CLI.
+ * Designed for testability via interface injection.
+ *
+ * Requirements: 12.2
+ */
+import type { FileChange } from './platform-client.js';
+/**
+ * Interface for git operations.
+ */
+export interface GitOperations {
+    /** Create a new branch from the current HEAD */
+    createBranch(branchName: string): Promise<void>;
+    /** Checkout an existing branch */
+    checkout(branchName: string): Promise<void>;
+    /** Stage and commit file changes */
+    commitChanges(changes: FileChange[], message: string): Promise<{
+        sha: string;
+    }>;
+    /** Push a branch to the remote */
+    push(branchName: string): Promise<void>;
+    /** Check if a branch exists locally or remotely */
+    branchExists(branchName: string): Promise<boolean>;
+    /** Get the current branch name */
+    getCurrentBranch(): Promise<string>;
+}
+//# sourceMappingURL=git-operations.d.ts.map

package/dist/pr-creator/git-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-operations.d.ts","sourceRoot":"","sources":["../../src/pr-creator/git-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMvD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,oCAAoC;IACpC,aAAa,CACX,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE5B,kCAAkC;IAClC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC,mDAAmD;IACnD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnD,kCAAkC;IAClC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACrC"}

package/dist/pr-creator/git-operations.js

@@ -0,0 +1,10 @@
+/**
+ * Git Operations — injectable interface for git CLI operations.
+ *
+ * Real implementation shells out to git CLI.
+ * Designed for testability via interface injection.
+ *
+ * Requirements: 12.2
+ */
+export {};
+//# sourceMappingURL=git-operations.js.map

package/dist/pr-creator/git-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-operations.js","sourceRoot":"","sources":["../../src/pr-creator/git-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/pr-creator/platform-client.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Platform Client — injectable interface for git hosting platform APIs.
+ *
+ * Supports GitHub, GitLab, and Bitbucket.
+ *
+ * Requirements: 12.1, 12.5
+ */
+export type PlatformType = 'github' | 'gitlab' | 'bitbucket';
+export interface PullRequestInput {
+    title: string;
+    body: string;
+    baseBranch: string;
+    headBranch: string;
+    labels: string[];
+    reviewers: string[];
+    draft: boolean;
+}
+export interface PullRequestResult {
+    id: number;
+    url: string;
+    number: number;
+    status: 'created' | 'updated' | 'failed';
+    errorMessage?: string;
+}
+export interface FileChange {
+    path: string;
+    content: string;
+    /** Operation type */
+    operation: 'create' | 'update' | 'delete';
+}
+/**
+ * Client interface for git hosting platform APIs.
+ * Injectable for testability.
+ */
+export interface PlatformClient {
+    /** Which platform this client connects to */
+    platform: PlatformType;
+    /** Create a new pull request */
+    createPullRequest(input: PullRequestInput): Promise<PullRequestResult>;
+    /** Update an existing pull request */
+    updatePullRequest(prNumber: number, input: Partial<PullRequestInput>): Promise<PullRequestResult>;
+    /** Check if a PR already exists for the given branch */
+    findExistingPR(headBranch: string): Promise<PullRequestResult | null>;
+    /** Get the default branch name */
+    getDefaultBranch(): Promise<string>;
+}
+//# sourceMappingURL=platform-client.d.ts.map

package/dist/pr-creator/platform-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-client.d.ts","sourceRoot":"","sources":["../../src/pr-creator/platform-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC3C;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,QAAQ,EAAE,YAAY,CAAC;IAEvB,gCAAgC;IAChC,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEvE,sCAAsC;IACtC,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B,wDAAwD;IACxD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAEtE,kCAAkC;IAClC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACrC"}

package/dist/pr-creator/platform-client.js

@@ -0,0 +1,9 @@
+/**
+ * Platform Client — injectable interface for git hosting platform APIs.
+ *
+ * Supports GitHub, GitLab, and Bitbucket.
+ *
+ * Requirements: 12.1, 12.5
+ */
+export {};
+//# sourceMappingURL=platform-client.js.map

package/dist/pr-creator/platform-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-client.js","sourceRoot":"","sources":["../../src/pr-creator/platform-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/pr-creator/pr-description-builder.d.ts

@@ -0,0 +1,23 @@
+/**
+ * PR Description Builder — generates rich markdown PR descriptions
+ * and titles following conventional commit format.
+ *
+ * Requirements: 12.4, 12.6
+ */
+import type { PRPlan } from './pr-strategy.js';
+/**
+ * Build a PR title following conventional commit format.
+ * Property 28: PR title follows conventional commit format.
+ *
+ * Examples:
+ * - "fix(deps): upgrade lodash 4.17.20 -> 4.17.21 (CVE-2026-12345)"
+ * - "chore(deps): update @types/react 18.2.0 -> 18.3.1"
+ * - "refactor(i18n): replace hand-rolled i18n with next-intl"
+ * - "fix(security): patch 3 critical vulnerabilities"
+ */
+export declare function buildPRTitle(plan: PRPlan): string;
+/**
+ * Build a rich markdown PR description with embedded analysis.
+ */
+export declare function buildPRDescription(plan: PRPlan): string;
+//# sourceMappingURL=pr-description-builder.d.ts.map

package/dist/pr-creator/pr-description-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-description-builder.d.ts","sourceRoot":"","sources":["../../src/pr-creator/pr-description-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,kBAAkB,CAAC;AAM3D;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkDjD;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmDvD"}

package/dist/pr-creator/pr-description-builder.js

@@ -0,0 +1,187 @@
+/**
+ * PR Description Builder — generates rich markdown PR descriptions
+ * and titles following conventional commit format.
+ *
+ * Requirements: 12.4, 12.6
+ */
+// ---------------------------------------------------------------------------
+// buildPRTitle
+// ---------------------------------------------------------------------------
+/**
+ * Build a PR title following conventional commit format.
+ * Property 28: PR title follows conventional commit format.
+ *
+ * Examples:
+ * - "fix(deps): upgrade lodash 4.17.20 -> 4.17.21 (CVE-2026-12345)"
+ * - "chore(deps): update @types/react 18.2.0 -> 18.3.1"
+ * - "refactor(i18n): replace hand-rolled i18n with next-intl"
+ * - "fix(security): patch 3 critical vulnerabilities"
+ */
+export function buildPRTitle(plan) {
+    switch (plan.type) {
+        case 'security-update': {
+            const items = plan.items.filter((i) => i.kind === 'security');
+            if (items.length === 1) {
+                const u = items[0].update;
+                return `fix(deps): upgrade ${u.packageName} ${u.currentVersion} -> ${u.targetVersion}`;
+            }
+            return `fix(security): patch ${items.length} vulnerabilities`;
+        }
+        case 'dependency-update': {
+            const items = plan.items.filter((i) => i.kind === 'update');
+            if (items.length === 1) {
+                const u = items[0].update;
+                return `chore(deps): update ${u.packageName} ${u.currentVersion} -> ${u.targetVersion}`;
+            }
+            return `chore(deps): update ${items.length} dependencies`;
+        }
+        case 'grouped-update': {
+            const items = plan.items.filter((i) => i.kind === 'update');
+            if (items.length > 0) {
+                const groupKey = items[0].update.groupKey ?? 'deps';
+                return `chore(deps): update ${groupKey} packages (${items.length} updates)`;
+            }
+            return `chore(deps): update dependency group`;
+        }
+        case 'migration': {
+            const items = plan.items.filter((i) => i.kind === 'migration');
+            if (items.length === 1) {
+                const rec = items[0].recommendation;
+                return `refactor(${rec.domain}): replace ${rec.currentImplementation.patternCategory} with ${rec.recommendedLibrary.name}`;
+            }
+            const phase = items[0]?.phaseNumber ?? 1;
+            return `refactor: migration phase ${phase} (${items.length} changes)`;
+        }
+        default:
+            return `chore: next-unicorn update`;
+    }
+}
+// ---------------------------------------------------------------------------
+// buildPRDescription
+// ---------------------------------------------------------------------------
+/**
+ * Build a rich markdown PR description with embedded analysis.
+ */
+export function buildPRDescription(plan) {
+    const sections = [];
+    // Header
+    sections.push(`## ${getPRTypeEmoji(plan.type)} ${getPRTypeLabel(plan.type)}`);
+    sections.push('');
+    // Summary
+    sections.push(buildSummarySection(plan));
+    sections.push('');
+    // Details per item type
+    for (const item of plan.items) {
+        switch (item.kind) {
+            case 'security':
+                sections.push(buildSecurityItemSection(item));
+                break;
+            case 'update':
+                sections.push(buildUpdateItemSection(item));
+                break;
+            case 'migration':
+                sections.push(buildMigrationItemSection(item));
+                break;
+        }
+        sections.push('');
+    }
+    // Reviewer checklist
+    sections.push('## Checklist');
+    sections.push('');
+    sections.push('- [ ] Review changes and verify correctness');
+    sections.push('- [ ] Run test suite');
+    if (plan.type === 'migration') {
+        sections.push('- [ ] Verify adapter strategy works correctly');
+        sections.push('- [ ] Check for regressions in affected areas');
+    }
+    if (plan.type === 'security-update') {
+        sections.push('- [ ] Verify vulnerability is patched');
+        sections.push('- [ ] Check for breaking changes from the upgrade');
+    }
+    sections.push('- [ ] Run `pnpm install` to regenerate lockfile');
+    sections.push('');
+    // Footer
+    sections.push('---');
+    sections.push('*Auto-generated by [Next-Unicorn](https://github.com/TsekaLuk/Next-Unicorn-Skill) SKILL*');
+    return sections.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function getPRTypeEmoji(type) {
+    const map = {
+        'security-update': 'Security',
+        'dependency-update': 'Dependency Update',
+        'grouped-update': 'Grouped Update',
+        'migration': 'Migration',
+    };
+    return map[type] ?? 'Update';
+}
+function getPRTypeLabel(type) {
+    return getPRTypeEmoji(type);
+}
+function buildSummarySection(plan) {
+    const lines = [];
+    lines.push('### Summary');
+    lines.push('');
+    lines.push(`This PR contains **${plan.items.length}** change(s).`);
+    return lines.join('\n');
+}
+function buildSecurityItemSection(item) {
+    const u = item.update;
+    const lines = [];
+    lines.push(`### ${u.packageName}: ${u.currentVersion} -> ${u.targetVersion}`);
+    lines.push('');
+    lines.push(`| Dimension | Score |`);
+    lines.push(`|-----------|-------|`);
+    lines.push(`| Security | ${u.impactScores.security}/10 |`);
+    lines.push(`| Urgency | **${u.urgency}** |`);
+    lines.push(`| Breaking Risk | ${u.breakingRisk} |`);
+    lines.push(`| Estimated Effort | ${u.estimatedEffort}h |`);
+    if (u.vulnFixCount > 0) {
+        lines.push(`| Vulnerabilities Fixed | ${u.vulnFixCount} |`);
+    }
+    return lines.join('\n');
+}
+function buildUpdateItemSection(item) {
+    const u = item.update;
+    const lines = [];
+    lines.push(`### ${u.packageName}: ${u.currentVersion} -> ${u.targetVersion}`);
+    lines.push('');
+    lines.push(`- **Update type:** ${u.updateType}`);
+    lines.push(`- **Breaking risk:** ${u.breakingRisk}`);
+    lines.push(`- **Estimated effort:** ${u.estimatedEffort}h`);
+    if (u.hasBreakingChanges && u.breakingChangeSummary) {
+        lines.push('');
+        lines.push(`> **Breaking Changes:** ${u.breakingChangeSummary}`);
+    }
+    return lines.join('\n');
+}
+function buildMigrationItemSection(item) {
+    const rec = item.recommendation;
+    const lines = [];
+    lines.push(`### Replace ${rec.currentImplementation.patternCategory} with ${rec.recommendedLibrary.name}`);
+    lines.push('');
+    lines.push(`- **File:** ${rec.currentImplementation.filePath}`);
+    lines.push(`- **Lines:** ${rec.currentImplementation.lineRange.start}-${rec.currentImplementation.lineRange.end}`);
+    lines.push(`- **Domain:** ${rec.domain}`);
+    lines.push(`- **Migration risk:** ${rec.migrationRisk}`);
+    lines.push(`- **Estimated effort:** ${rec.estimatedEffort}h`);
+    lines.push(`- **Verification:** ${rec.verificationStatus}`);
+    lines.push('');
+    lines.push(`| Dimension | Score |`);
+    lines.push(`|-----------|-------|`);
+    lines.push(`| Composite | ${rec.impactScores.composite}/10 |`);
+    lines.push(`| Security | ${rec.impactScores.security}/10 |`);
+    lines.push(`| Maintainability | ${rec.impactScores.maintainability}/10 |`);
+    lines.push(`| Performance | ${rec.impactScores.performance}/10 |`);
+    if (rec.adapterStrategy) {
+        lines.push('');
+        lines.push(`#### Adapter Strategy`);
+        lines.push(`- **Wrapper:** \`${rec.adapterStrategy.wrapperInterface}\``);
+        lines.push(`- **Legacy code:** \`${rec.adapterStrategy.legacyCode}\``);
+        lines.push(`- **Target library:** \`${rec.adapterStrategy.targetLibrary}\``);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=pr-description-builder.js.map

package/dist/pr-creator/pr-description-builder.js.map

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

package/dist/pr-creator/pr-executor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * PR Executor — executes PR plans by creating branches, committing changes,
+ * and creating/updating pull requests via the platform client.
+ *
+ * Requirements: 12.5, 12.9
+ */
+import type { PRResult, PRSummary } from '../schemas/output.schema.js';
+import type { PRPlan } from './pr-strategy.js';
+import type { PlatformClient } from './platform-client.js';
+import type { GitOperations } from './git-operations.js';
+export interface PRExecutionResult {
+    created: PRResult[];
+    summary: PRSummary;
+}
+export interface PRExecutionOptions {
+    plans: PRPlan[];
+    platformClient: PlatformClient;
+    gitOps: GitOperations;
+    labels: string[];
+    reviewers: string[];
+    draft: boolean;
+}
+/**
+ * Execute all PR plans — create branches, commits, and pull requests.
+ *
+ * Each plan is processed independently — a failure for one PR does not
+ * affect others (Requirement 12.9).
+ */
+export declare function executePRPlans(options: PRExecutionOptions): Promise<PRExecutionResult>;
+//# sourceMappingURL=pr-executor.d.ts.map

package/dist/pr-creator/pr-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-executor.d.ts","sourceRoot":"","sources":["../../src/pr-creator/pr-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAChB;AAMD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAuG5B"}

package/dist/pr-creator/pr-executor.js

@@ -0,0 +1,109 @@
+/**
+ * PR Executor — executes PR plans by creating branches, committing changes,
+ * and creating/updating pull requests via the platform client.
+ *
+ * Requirements: 12.5, 12.9
+ */
+import { buildPRTitle, buildPRDescription } from './pr-description-builder.js';
+// ---------------------------------------------------------------------------
+// executePRPlans
+// ---------------------------------------------------------------------------
+/**
+ * Execute all PR plans — create branches, commits, and pull requests.
+ *
+ * Each plan is processed independently — a failure for one PR does not
+ * affect others (Requirement 12.9).
+ */
+export async function executePRPlans(options) {
+    const { plans, platformClient, gitOps, labels, reviewers, draft } = options;
+    const results = [];
+    let created = 0;
+    let updated = 0;
+    let skipped = 0;
+    let failed = 0;
+    // Get default branch for PR base
+    let baseBranch;
+    try {
+        baseBranch = await platformClient.getDefaultBranch();
+    }
+    catch {
+        baseBranch = 'main';
+    }
+    for (const plan of plans) {
+        try {
+            // Check for existing PR (Property 29: deduplication)
+            const existingPR = await platformClient.findExistingPR(plan.branchName);
+            if (existingPR) {
+                // Update existing PR
+                const title = buildPRTitle(plan);
+                const body = buildPRDescription(plan);
+                const updateResult = await platformClient.updatePullRequest(existingPR.number, { title, body });
+                results.push({
+                    branchName: plan.branchName,
+                    title,
+                    type: plan.type,
+                    status: 'updated',
+                    url: updateResult.url,
+                    prNumber: updateResult.number,
+                    itemCount: plan.items.length,
+                });
+                updated++;
+                continue;
+            }
+            // Create new branch and PR
+            const branchExists = await gitOps.branchExists(plan.branchName);
+            if (!branchExists) {
+                await gitOps.createBranch(plan.branchName);
+            }
+            await gitOps.checkout(plan.branchName);
+            // Commit a placeholder change (actual code transforms are done separately)
+            const title = buildPRTitle(plan);
+            await gitOps.commitChanges([], title);
+            await gitOps.push(plan.branchName);
+            // Create PR
+            const body = buildPRDescription(plan);
+            const prResult = await platformClient.createPullRequest({
+                title,
+                body,
+                baseBranch,
+                headBranch: plan.branchName,
+                labels,
+                reviewers,
+                draft,
+            });
+            results.push({
+                branchName: plan.branchName,
+                title,
+                type: plan.type,
+                status: 'created',
+                url: prResult.url,
+                prNumber: prResult.number,
+                itemCount: plan.items.length,
+            });
+            created++;
+        }
+        catch (err) {
+            const title = buildPRTitle(plan);
+            results.push({
+                branchName: plan.branchName,
+                title,
+                type: plan.type,
+                status: 'failed',
+                errorMessage: err instanceof Error ? err.message : String(err),
+                itemCount: plan.items.length,
+            });
+            failed++;
+        }
+    }
+    return {
+        created: results,
+        summary: {
+            totalPlanned: plans.length,
+            created,
+            updated,
+            skipped,
+            failed,
+        },
+    };
+}
+//# sourceMappingURL=pr-executor.js.map

package/dist/pr-creator/pr-executor.js.map

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