@nahisaho/musubix-codegraph 2.3.2 → 2.3.4

package/dist/pr/index.js

@@ -0,0 +1,26 @@
+/**
+ * @nahisaho/musubix-codegraph/pr - PR Creation Module
+ *
+ * Automatic PR generation from refactoring suggestions
+ *
+ * @packageDocumentation
+ * @module @nahisaho/musubix-codegraph/pr
+ *
+ * @see REQ-CG-PR-001 - REQ-CG-PR-009
+ * @see DES-CG-PR-001 - DES-CG-PR-006
+ */
+// Main PR Creator
+export { PRCreator, createPRCreator, createRefactoringPR, } from './pr-creator.js';
+// Error Handling (v2.3.4 NEW)
+export { PRCreatorError, PRErrorMessages, } from './errors.js';
+// Git Operations
+export { GitOperations, createGitOperations, } from './git-operations.js';
+// GitHub Adapter
+export { GitHubAdapter, createGitHubAdapter, } from './github-adapter.js';
+// Refactoring Applier
+export { RefactoringApplier, createRefactoringApplier, } from './refactoring-applier.js';
+// PR Template Generator
+export { PRTemplateGenerator, createPRTemplateGenerator, generateSimplePRBody, generatePRTitle, } from './pr-template.js';
+// Utility Functions
+export { REFACTORING_TO_COMMIT_TYPE, generateBranchName, generateCommitMessage, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/pr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kBAAkB;AAClB,OAAO,EACL,SAAS,EACT,eAAe,EACf,mBAAmB,GAGpB,MAAM,iBAAiB,CAAC;AAEzB,8BAA8B;AAC9B,OAAO,EACL,cAAc,EACd,eAAe,GAEhB,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,mBAAmB,GAIpB,MAAM,qBAAqB,CAAC;AAE7B,sBAAsB;AACtB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAIzB,MAAM,0BAA0B,CAAC;AAElC,wBAAwB;AACxB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,eAAe,GAEhB,MAAM,kBAAkB,CAAC;AAsC1B,oBAAoB;AACpB,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,173 @@
+/**
+ * @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 type { RefactoringSuggestion, PRCreateOptions, PRCreateResult, PRPreview, PRCreatorEvents } from './types.js';
+/**
+ * PRCreator state
+ * @see DES-CG-v234-003
+ */
+export type PRCreatorState = 'uninitialized' | 'offline' | 'full';
+/**
+ * PR Creator configuration
+ */
+export interface PRCreatorConfig {
+    /** Repository root path */
+    repoPath: string;
+    /** GitHub token (optional, will try env or gh CLI) */
+    githubToken?: string;
+    /** Remote name (default: origin) */
+    remote?: string;
+    /** Create backups before modifications */
+    createBackups?: boolean;
+}
+/**
+ * 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 declare class PRCreator extends EventEmitter {
+    private readonly config;
+    private git;
+    private github;
+    private applier;
+    private templateGenerator;
+    private initialized;
+    private originalBranch;
+    private state;
+    /**
+     * Create a new PRCreator
+     * @param config - Configuration options
+     */
+    constructor(config: PRCreatorConfig);
+    /**
+     * Initialize for offline operations (preview only)
+     * Does not require GitHub authentication
+     *
+     * @see REQ-CG-v234-001
+     * @see DES-CG-v234-001
+     */
+    initializeOffline(): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Initialize the PR creator with full GitHub authentication
+     * Sets up Git operations and authenticates with GitHub
+     */
+    initialize(): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Check if initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get current state
+     * @see DES-CG-v234-003
+     */
+    getState(): PRCreatorState;
+    /**
+     * Generate PR preview without creating
+     * Works in both offline and full modes
+     *
+     * @see REQ-CG-v234-001
+     * @see DES-CG-v234-001
+     */
+    previewSuggestion(suggestion: RefactoringSuggestion): PRPreview;
+    /**
+     * Create a PR from a refactoring suggestion
+     * Requires full initialization (GitHub authentication)
+     *
+     * @see REQ-CG-PR-002, REQ-CG-PR-003, REQ-CG-PR-004, REQ-CG-PR-005
+     */
+    create(options: PRCreateOptions): Promise<PRCreateResult>;
+    /**
+     * Preview PR creation without actually creating
+     * @see REQ-CG-PR-007
+     */
+    preview(options: PRCreateOptions): Promise<PRPreview>;
+    /**
+     * Validate a suggestion can be applied
+     */
+    validate(suggestion: RefactoringSuggestion): {
+        valid: boolean;
+        reason?: string;
+    };
+    /**
+     * Dry run implementation
+     */
+    private dryRun;
+    /**
+     * Ensure initialized before operations (legacy)
+     * @deprecated Use ensureState() instead
+     */
+    private ensureInitialized;
+    /**
+     * Ensure PRCreator is in one of the allowed states
+     * @see DES-CG-v234-003
+     */
+    private ensureState;
+    /**
+     * Typed event emitter methods
+     */
+    emit<K extends keyof PRCreatorEvents>(event: K, data: PRCreatorEvents[K]): boolean;
+    on<K extends keyof PRCreatorEvents>(event: K, listener: (data: PRCreatorEvents[K]) => void): this;
+    once<K extends keyof PRCreatorEvents>(event: K, listener: (data: PRCreatorEvents[K]) => void): this;
+}
+/**
+ * Create a PRCreator instance
+ */
+export declare function createPRCreator(repoPath: string, options?: Partial<PRCreatorConfig>): PRCreator;
+/**
+ * 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 declare function createRefactoringPR(repoPath: string, suggestion: RefactoringSuggestion, options?: Partial<PRCreateOptions>): Promise<PRCreateResult>;
+//# sourceMappingURL=pr-creator.d.ts.map

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

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

package/dist/pr/pr-creator.js

@@ -0,0 +1,468 @@
+/**
+ * @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 { PRCreatorError, PRErrorMessages } from './errors.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;
+    state = 'uninitialized';
+    /**
+     * Create a new PRCreator
+     * @param config - Configuration options
+     */
+    constructor(config) {
+        super();
+        this.config = {
+            remote: 'origin',
+            createBackups: true,
+            ...config,
+        };
+        this.templateGenerator = new PRTemplateGenerator();
+    }
+    // ============================================================================
+    // Initialization
+    // ============================================================================
+    /**
+     * Initialize for offline operations (preview only)
+     * Does not require GitHub authentication
+     *
+     * @see REQ-CG-v234-001
+     * @see DES-CG-v234-001
+     */
+    async initializeOffline() {
+        try {
+            // Initialize Git operations (local only)
+            this.git = new GitOperations({
+                repoPath: this.config.repoPath,
+                remote: this.config.remote,
+            });
+            // 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.state = 'offline';
+            this.initialized = true;
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Initialize the PR creator with full GitHub authentication
+     * Sets up Git operations and authenticates with GitHub
+     */
+    async initialize() {
+        try {
+            // First do offline initialization if not already done
+            if (this.state === 'uninitialized') {
+                const offlineResult = await this.initializeOffline();
+                if (!offlineResult.success) {
+                    return offlineResult;
+                }
+            }
+            // Parse GitHub owner/repo from remote
+            const remoteInfo = this.git.parseRemoteUrl();
+            if (!remoteInfo) {
+                const err = PRErrorMessages.REMOTE_PARSE_FAILED;
+                return {
+                    success: false,
+                    error: `${err.message}. ${err.suggestion}`,
+                };
+            }
+            // 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) {
+                const err = PRErrorMessages.AUTH_FAILED;
+                return {
+                    success: false,
+                    error: `${err.message}: ${authResult.error}. ${err.suggestion}`,
+                };
+            }
+            this.state = 'full';
+            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;
+    }
+    /**
+     * Get current state
+     * @see DES-CG-v234-003
+     */
+    getState() {
+        return this.state;
+    }
+    // ============================================================================
+    // Main Operations
+    // ============================================================================
+    /**
+     * Generate PR preview without creating
+     * Works in both offline and full modes
+     *
+     * @see REQ-CG-v234-001
+     * @see DES-CG-v234-001
+     */
+    previewSuggestion(suggestion) {
+        this.ensureState('offline', 'full');
+        const branchName = generateBranchName(suggestion);
+        const commitMessage = generateCommitMessage(suggestion);
+        const title = this.templateGenerator.generateTitle(suggestion);
+        const diffs = this.applier.preview(suggestion);
+        const body = this.templateGenerator.generate(suggestion, diffs);
+        const baseBranch = this.git.getDefaultBranch();
+        return {
+            branchName,
+            baseBranch,
+            title,
+            body,
+            diffs,
+            commitMessage,
+        };
+    }
+    /**
+     * Create a PR from a refactoring suggestion
+     * Requires full initialization (GitHub authentication)
+     *
+     * @see REQ-CG-PR-002, REQ-CG-PR-003, REQ-CG-PR-004, REQ-CG-PR-005
+     */
+    async create(options) {
+        this.ensureState('full');
+        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 (legacy)
+     * @deprecated Use ensureState() instead
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw PRCreatorError.fromCode('NOT_INITIALIZED');
+        }
+    }
+    /**
+     * Ensure PRCreator is in one of the allowed states
+     * @see DES-CG-v234-003
+     */
+    ensureState(...allowed) {
+        if (!allowed.includes(this.state)) {
+            if (this.state === 'uninitialized') {
+                throw PRCreatorError.fromCode('NOT_INITIALIZED');
+            }
+            else if (this.state === 'offline' && allowed.includes('full')) {
+                throw PRCreatorError.fromCode('OFFLINE_MODE');
+            }
+            throw PRCreatorError.fromCode('NOT_INITIALIZED');
+        }
+    }
+    // ============================================================================
+    // 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