@nahisaho/musubix-codegraph 2.3.2 → 2.3.3

package/dist/pr/pr-creator.js

@@ -0,0 +1,387 @@
+/**
+ * @nahisaho/musubix-codegraph - PR Creator
+ *
+ * Main orchestrator for creating PRs from refactoring suggestions
+ *
+ * @packageDocumentation
+ * @module @nahisaho/musubix-codegraph/pr
+ *
+ * @see REQ-CG-PR-001 - GitHub Authentication
+ * @see REQ-CG-PR-002 - Auto Apply Refactoring
+ * @see REQ-CG-PR-003 - Git Branch Creation
+ * @see REQ-CG-PR-004 - Auto Commit
+ * @see REQ-CG-PR-005 - GitHub PR Creation
+ * @see DES-CG-PR-001 - Component Design
+ * @see DES-CG-PR-005 - Sequence Diagram
+ */
+import { EventEmitter } from 'node:events';
+import { GitOperations } from './git-operations.js';
+import { GitHubAdapter } from './github-adapter.js';
+import { RefactoringApplier } from './refactoring-applier.js';
+import { PRTemplateGenerator } from './pr-template.js';
+import { generateBranchName, generateCommitMessage, } from './types.js';
+/**
+ * PR Creator
+ *
+ * Orchestrates the entire PR creation workflow:
+ * 1. Authenticate with GitHub
+ * 2. Create a new branch
+ * 3. Apply refactoring changes
+ * 4. Commit changes
+ * 5. Push to remote
+ * 6. Create PR on GitHub
+ *
+ * @see DES-CG-PR-001
+ * @see DES-CG-PR-005
+ * @example
+ * ```typescript
+ * const creator = new PRCreator({ repoPath: '/path/to/repo' });
+ * await creator.initialize();
+ *
+ * const result = await creator.create({
+ *   suggestion: refactoringSuggestion,
+ *   baseBranch: 'main',
+ *   labels: ['refactoring', 'auto-generated'],
+ * });
+ *
+ * console.log(`PR created: ${result.pr?.url}`);
+ * ```
+ */
+export class PRCreator extends EventEmitter {
+    config;
+    git = null;
+    github = null;
+    applier = null;
+    templateGenerator;
+    initialized = false;
+    originalBranch = null;
+    /**
+     * Create a new PRCreator
+     * @param config - Configuration options
+     */
+    constructor(config) {
+        super();
+        this.config = {
+            remote: 'origin',
+            createBackups: true,
+            ...config,
+        };
+        this.templateGenerator = new PRTemplateGenerator();
+    }
+    // ============================================================================
+    // Initialization
+    // ============================================================================
+    /**
+     * Initialize the PR creator
+     * Sets up Git operations and authenticates with GitHub
+     */
+    async initialize() {
+        try {
+            // Initialize Git operations
+            this.git = new GitOperations({
+                repoPath: this.config.repoPath,
+                remote: this.config.remote,
+            });
+            // Parse GitHub owner/repo from remote
+            const remoteInfo = this.git.parseRemoteUrl();
+            if (!remoteInfo) {
+                return {
+                    success: false,
+                    error: 'Could not parse GitHub owner/repo from remote URL',
+                };
+            }
+            // Initialize GitHub adapter
+            this.github = new GitHubAdapter({
+                owner: remoteInfo.owner,
+                repo: remoteInfo.repo,
+                token: this.config.githubToken,
+            });
+            // Authenticate with GitHub
+            const authResult = await this.github.authenticate();
+            if (!authResult.authenticated) {
+                return {
+                    success: false,
+                    error: `GitHub authentication failed: ${authResult.error}`,
+                };
+            }
+            // Initialize refactoring applier
+            this.applier = new RefactoringApplier({
+                repoPath: this.config.repoPath,
+                createBackups: this.config.createBackups,
+            });
+            // Store current branch for potential rollback
+            this.originalBranch = this.git.getCurrentBranch();
+            this.initialized = true;
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Check if initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    // ============================================================================
+    // Main Operations
+    // ============================================================================
+    /**
+     * Create a PR from a refactoring suggestion
+     * @see REQ-CG-PR-002, REQ-CG-PR-003, REQ-CG-PR-004, REQ-CG-PR-005
+     */
+    async create(options) {
+        this.ensureInitialized();
+        const { suggestion, dryRun } = options;
+        const warnings = [];
+        try {
+            this.emit('pr:start', { suggestion });
+            // Generate branch name
+            const branchName = options.branchName ?? generateBranchName(suggestion);
+            // Check for uncommitted changes
+            if (this.git.hasUncommittedChanges()) {
+                warnings.push('Repository has uncommitted changes. They will be stashed.');
+                this.git.stash('musubix-pr-creator-auto-stash');
+            }
+            // Dry run mode - just preview
+            if (dryRun) {
+                return this.dryRun(options, branchName);
+            }
+            // Determine base branch
+            const baseBranch = options.baseBranch ?? this.git.getDefaultBranch();
+            // Create and checkout new branch
+            this.emit('pr:branch', { name: branchName });
+            this.git.createBranch(branchName, baseBranch);
+            // Apply refactoring changes
+            const diffs = this.applier.preview(suggestion);
+            for (const diff of diffs) {
+                this.emit('pr:applying', { file: diff.filePath, changes: 1 });
+            }
+            const applyResult = this.applier.apply(suggestion);
+            if (!applyResult.success) {
+                // Rollback branch
+                this.git.checkout(this.originalBranch);
+                this.git.deleteBranch(branchName, true);
+                return {
+                    success: false,
+                    branchName,
+                    filesChanged: [],
+                    linesAdded: 0,
+                    linesDeleted: 0,
+                    error: `Failed to apply changes: ${applyResult.error}`,
+                    warnings,
+                };
+            }
+            // Stage all changes
+            this.git.stageAll();
+            // Generate commit message
+            const commitMessage = generateCommitMessage(suggestion);
+            // Commit
+            const commitInfo = this.git.commit(commitMessage);
+            this.emit('pr:commit', { hash: commitInfo.hash, message: commitMessage });
+            // Push to remote
+            this.emit('pr:push', { branch: branchName, remote: this.config.remote });
+            this.git.push({ setUpstream: true });
+            // Generate PR body
+            const prTitle = options.title ?? this.templateGenerator.generateTitle(suggestion);
+            const prBody = options.body ?? this.templateGenerator.generate(suggestion, diffs);
+            // Create PR
+            const pr = await this.github.createPullRequest({
+                title: prTitle,
+                body: prBody,
+                head: branchName,
+                base: baseBranch,
+                draft: options.draft,
+            });
+            this.emit('pr:created', { pr });
+            // Add labels, assignees, reviewers
+            if (options.labels && options.labels.length > 0) {
+                await this.github.addLabels(pr.number, options.labels);
+            }
+            if (options.assignees && options.assignees.length > 0) {
+                await this.github.addAssignees(pr.number, options.assignees);
+            }
+            if (options.reviewers && options.reviewers.length > 0) {
+                await this.github.addReviewers(pr.number, options.reviewers);
+            }
+            // Calculate stats
+            const stats = this.git.getDiffStats(baseBranch);
+            const result = {
+                success: true,
+                pr,
+                branchName,
+                commitHash: commitInfo.hash,
+                filesChanged: applyResult.filesModified,
+                linesAdded: stats.additions,
+                linesDeleted: stats.deletions,
+                warnings: warnings.length > 0 ? warnings : undefined,
+            };
+            this.emit('pr:complete', { result });
+            // Switch back to original branch
+            this.git.checkout(this.originalBranch);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.emit('pr:error', { error: error, stage: 'create' });
+            // Attempt cleanup
+            try {
+                if (this.git && this.originalBranch) {
+                    const currentBranch = this.git.getCurrentBranch();
+                    if (currentBranch !== this.originalBranch) {
+                        this.git.checkout(this.originalBranch);
+                    }
+                }
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            return {
+                success: false,
+                branchName: options.branchName ?? generateBranchName(suggestion),
+                filesChanged: [],
+                linesAdded: 0,
+                linesDeleted: 0,
+                error: errorMessage,
+                warnings: warnings.length > 0 ? warnings : undefined,
+            };
+        }
+    }
+    /**
+     * Preview PR creation without actually creating
+     * @see REQ-CG-PR-007
+     */
+    async preview(options) {
+        this.ensureInitialized();
+        const { suggestion } = options;
+        const branchName = options.branchName ?? generateBranchName(suggestion);
+        const baseBranch = options.baseBranch ?? this.git.getDefaultBranch();
+        // Generate preview
+        const diffs = this.applier.preview(suggestion);
+        const title = options.title ?? this.templateGenerator.generateTitle(suggestion);
+        const body = options.body ?? this.templateGenerator.generate(suggestion, diffs);
+        const commitMessage = generateCommitMessage(suggestion);
+        return {
+            branchName,
+            baseBranch,
+            title,
+            body,
+            diffs,
+            commitMessage,
+        };
+    }
+    /**
+     * Validate a suggestion can be applied
+     */
+    validate(suggestion) {
+        this.ensureInitialized();
+        const result = this.applier.canApply(suggestion);
+        return { valid: result.canApply, reason: result.reason };
+    }
+    // ============================================================================
+    // Private Helpers
+    // ============================================================================
+    /**
+     * Dry run implementation
+     */
+    dryRun(options, branchName) {
+        const { suggestion } = options;
+        const baseBranch = options.baseBranch ?? this.git.getDefaultBranch();
+        // Generate preview
+        const diffs = this.applier.preview(suggestion);
+        const title = options.title ?? this.templateGenerator.generateTitle(suggestion);
+        const body = options.body ?? this.templateGenerator.generate(suggestion, diffs);
+        const commitMessage = generateCommitMessage(suggestion);
+        // Calculate stats from diffs
+        let linesAdded = 0;
+        let linesDeleted = 0;
+        for (const diff of diffs) {
+            linesAdded += diff.additions;
+            linesDeleted += diff.deletions;
+        }
+        return {
+            success: true,
+            branchName,
+            filesChanged: diffs.map(d => d.filePath),
+            linesAdded,
+            linesDeleted,
+            preview: {
+                branchName,
+                baseBranch,
+                title,
+                body,
+                diffs,
+                commitMessage,
+            },
+        };
+    }
+    /**
+     * Ensure initialized before operations
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('PRCreator not initialized. Call initialize() first.');
+        }
+    }
+    // ============================================================================
+    // Event Typing
+    // ============================================================================
+    /**
+     * Typed event emitter methods
+     */
+    emit(event, data) {
+        return super.emit(event, data);
+    }
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+}
+/**
+ * Create a PRCreator instance
+ */
+export function createPRCreator(repoPath, options) {
+    return new PRCreator({
+        repoPath,
+        ...options,
+    });
+}
+/**
+ * Quick PR creation helper
+ *
+ * One-shot function to create a PR from a suggestion.
+ *
+ * @example
+ * ```typescript
+ * const result = await createRefactoringPR(
+ *   '/path/to/repo',
+ *   suggestion,
+ *   { labels: ['refactoring'] }
+ * );
+ * ```
+ */
+export async function createRefactoringPR(repoPath, suggestion, options) {
+    const creator = createPRCreator(repoPath);
+    const initResult = await creator.initialize();
+    if (!initResult.success) {
+        return {
+            success: false,
+            branchName: generateBranchName(suggestion),
+            filesChanged: [],
+            linesAdded: 0,
+            linesDeleted: 0,
+            error: initResult.error,
+        };
+    }
+    return creator.create({
+        suggestion,
+        ...options,
+    });
+}
+//# sourceMappingURL=pr-creator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pr-creator.js","sourceRoot":"","sources":["../../src/pr/pr-creator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAQvD,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAgBpB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,SAAU,SAAQ,YAAY;IACxB,MAAM,CAAkB;IACjC,GAAG,GAAyB,IAAI,CAAC;IACjC,MAAM,GAAyB,IAAI,CAAC;IACpC,OAAO,GAA8B,IAAI,CAAC;IAC1C,iBAAiB,CAAsB;IACvC,WAAW,GAAG,KAAK,CAAC;IACpB,cAAc,GAAkB,IAAI,CAAC;IAE7C;;;OAGG;IACH,YAAY,MAAuB;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG;YACZ,MAAM,EAAE,QAAQ;YAChB,aAAa,EAAE,IAAI;YACnB,GAAG,MAAM;SACV,CAAC;QACF,IAAI,CAAC,iBAAiB,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACrD,CAAC;IAED,+EAA+E;IAC/E,iBAAiB;IACjB,+EAA+E;IAE/E;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC;YACH,4BAA4B;YAC5B,IAAI,CAAC,GAAG,GAAG,IAAI,aAAa,CAAC;gBAC3B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;aAC3B,CAAC,CAAC;YAEH,sCAAsC;YACtC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;YAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,mDAAmD;iBAC3D,CAAC;YACJ,CAAC;YAED,4BAA4B;YAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC;gBAC9B,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;aAC/B,CAAC,CAAC;YAEH,2BAA2B;YAC3B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACpD,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,iCAAiC,UAAU,CAAC,KAAK,EAAE;iBAC3D,CAAC;YACJ,CAAC;YAED,iCAAiC;YACjC,IAAI,CAAC,OAAO,GAAG,IAAI,kBAAkB,CAAC;gBACpC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;aACzC,CAAC,CAAC;YAEH,8CAA8C;YAC9C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;YAElD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,+EAA+E;IAC/E,kBAAkB;IAClB,+EAA+E;IAE/E;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,OAAwB;QACnC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QACvC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YAEtC,uBAAuB;YACvB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAAC;YAExE,gCAAgC;YAChC,IAAI,IAAI,CAAC,GAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;gBACtC,QAAQ,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;gBAC3E,IAAI,CAAC,GAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,CAAC;YAED,8BAA8B;YAC9B,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAC1C,CAAC;YAED,wBAAwB;YACxB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,GAAI,CAAC,gBAAgB,EAAE,CAAC;YAEtE,iCAAiC;YACjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YAC7C,IAAI,CAAC,GAAI,CAAC,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAE/C,4BAA4B;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;YAChE,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACpD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,kBAAkB;gBAClB,IAAI,CAAC,GAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAe,CAAC,CAAC;gBACzC,IAAI,CAAC,GAAI,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBACzC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,UAAU;oBACV,YAAY,EAAE,EAAE;oBAChB,UAAU,EAAE,CAAC;oBACb,YAAY,EAAE,CAAC;oBACf,KAAK,EAAE,4BAA4B,WAAW,CAAC,KAAK,EAAE;oBACtD,QAAQ;iBACT,CAAC;YACJ,CAAC;YAED,oBAAoB;YACpB,IAAI,CAAC,GAAI,CAAC,QAAQ,EAAE,CAAC;YAErB,0BAA0B;YAC1B,MAAM,aAAa,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAExD,SAAS;YACT,MAAM,UAAU,GAAG,IAAI,CAAC,GAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACnD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;YAE1E,iBAAiB;YACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAO,EAAE,CAAC,CAAC;YAC1E,IAAI,CAAC,GAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;YAEtC,mBAAmB;YACnB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YAClF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAElF,YAAY;YACZ,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAO,CAAC,iBAAiB,CAAC;gBAC9C,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAC;YAEH,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAEhC,mCAAmC;YACnC,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChD,MAAM,IAAI,CAAC,MAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1D,CAAC;YACD,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,CAAC,MAAO,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAChE,CAAC;YACD,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,CAAC,MAAO,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAChE,CAAC;YAED,kBAAkB;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YAEjD,MAAM,MAAM,GAAmB;gBAC7B,OAAO,EAAE,IAAI;gBACb,EAAE;gBACF,UAAU;gBACV,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,YAAY,EAAE,WAAW,CAAC,aAAa;gBACvC,UAAU,EAAE,KAAK,CAAC,SAAS;gBAC3B,YAAY,EAAE,KAAK,CAAC,SAAS;gBAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;aACrD,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAErC,iCAAiC;YACjC,IAAI,CAAC,GAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAe,CAAC,CAAC;YAEzC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,KAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAElE,kBAAkB;YAClB,IAAI,CAAC;gBACH,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;oBAClD,IAAI,aAAa,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;wBAC1C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;oBACzC,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAC,UAAU,CAAC;gBAChE,YAAY,EAAE,EAAE;gBAChB,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,CAAC;gBACf,KAAK,EAAE,YAAY;gBACnB,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;aACrD,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,OAAwB;QACpC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACxE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,GAAI,CAAC,gBAAgB,EAAE,CAAC;QAEtE,mBAAmB;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAChF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChF,MAAM,aAAa,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAExD,OAAO;YACL,UAAU;YACV,UAAU;YACV,KAAK;YACL,IAAI;YACJ,KAAK;YACL,aAAa;SACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,UAAiC;QACxC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC3D,CAAC;IAED,+EAA+E;IAC/E,kBAAkB;IAClB,+EAA+E;IAE/E;;OAEG;IACK,MAAM,CAAC,OAAwB,EAAE,UAAkB;QACzD,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,GAAI,CAAC,gBAAgB,EAAE,CAAC;QAEtE,mBAAmB;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAChF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChF,MAAM,aAAa,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAExD,6BAA6B;QAC7B,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,UAAU,IAAI,IAAI,CAAC,SAAS,CAAC;YAC7B,YAAY,IAAI,IAAI,CAAC,SAAS,CAAC;QACjC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU;YACV,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YACxC,UAAU;YACV,YAAY;YACZ,OAAO,EAAE;gBACP,UAAU;gBACV,UAAU;gBACV,KAAK;gBACL,IAAI;gBACJ,KAAK;gBACL,aAAa;aACd;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,iBAAiB;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,eAAe;IACf,+EAA+E;IAE/E;;OAEG;IACM,IAAI,CACX,KAAQ,EACR,IAAwB;QAExB,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAEQ,EAAE,CACT,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAEQ,IAAI,CACX,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,OAAkC;IAClF,OAAO,IAAI,SAAS,CAAC;QACnB,QAAQ;QACR,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,UAAiC,EACjC,OAAkC;IAElC,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAE9C,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,kBAAkB,CAAC,UAAU,CAAC;YAC1C,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,CAAC;YACb,YAAY,EAAE,CAAC;YACf,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC;QACpB,UAAU;QACV,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC"}

package/dist/pr/pr-template.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @nahisaho/musubix-codegraph - PR Template Generator
+ *
+ * Generates PR body content from refactoring suggestions
+ *
+ * @packageDocumentation
+ * @module @nahisaho/musubix-codegraph/pr
+ *
+ * @see REQ-CG-PR-006 - PR Body Generation
+ * @see DES-CG-PR-006 - PR Body Template
+ */
+import type { RefactoringSuggestion, FileDiff } from './types.js';
+/**
+ * PR Template options
+ */
+export interface PRTemplateOptions {
+    /** Include file diffs in PR body */
+    includeDiffs?: boolean;
+    /** Maximum diff lines to include (default: 50) */
+    maxDiffLines?: number;
+    /** Include checklist */
+    includeChecklist?: boolean;
+    /** Custom checklist items */
+    checklistItems?: string[];
+    /** Include related issues section */
+    includeRelatedIssues?: boolean;
+    /** Related issue numbers */
+    relatedIssues?: number[];
+    /** Custom footer text */
+    footer?: string;
+}
+/**
+ * PR Template Generator
+ *
+ * Generates well-formatted PR bodies from refactoring suggestions.
+ *
+ * @see DES-CG-PR-006
+ * @example
+ * ```typescript
+ * const generator = new PRTemplateGenerator();
+ * const body = generator.generate(suggestion, diffs);
+ * ```
+ */
+export declare class PRTemplateGenerator {
+    private readonly options;
+    /**
+     * Create a new PRTemplateGenerator
+     * @param options - Template options
+     */
+    constructor(options?: PRTemplateOptions);
+    /**
+     * Generate PR body
+     * @see REQ-CG-PR-006
+     */
+    generate(suggestion: RefactoringSuggestion, diffs?: FileDiff[]): string;
+    /**
+     * Generate PR title
+     */
+    generateTitle(suggestion: RefactoringSuggestion): string;
+    /**
+     * Generate header section
+     */
+    private generateHeader;
+    /**
+     * Generate summary section
+     */
+    private generateSummary;
+    /**
+     * Generate reason section
+     */
+    private generateChangesSection;
+    /**
+     * Generate diffs section
+     */
+    private generateDiffsSection;
+    /**
+     * Generate impact analysis section
+     */
+    private generateImpactSection;
+    /**
+     * Generate checklist section
+     */
+    private generateChecklist;
+    /**
+     * Generate related issues section
+     */
+    private generateRelatedIssues;
+    /**
+     * Generate footer section
+     */
+    private generateFooter;
+}
+/**
+ * Create a PR template generator
+ */
+export declare function createPRTemplateGenerator(options?: PRTemplateOptions): PRTemplateGenerator;
+/**
+ * Generate a simple PR body without advanced options
+ */
+export declare function generateSimplePRBody(suggestion: RefactoringSuggestion): string;
+/**
+ * Generate PR title from suggestion
+ */
+export declare function generatePRTitle(suggestion: RefactoringSuggestion): string;
+//# sourceMappingURL=pr-template.d.ts.map

package/dist/pr/pr-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-template.d.ts","sourceRoot":"","sources":["../../src/pr/pr-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,QAAQ,EAIT,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,qCAAqC;IACrC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4BD;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAE5C;;;OAGG;gBACS,OAAO,GAAE,iBAAsB;IAY3C;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,qBAAqB,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,MAAM;IAoCvE;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM;IASxD;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,cAAc;CAcvB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,CAE1F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,CAG9E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,CAGzE"}