@grunnverk/github-tools 1.0.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 Tim O'Brien
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,314 @@
+# @grunnverk/github-tools
+
+GitHub API utilities for automation - PR management, issue tracking, workflow monitoring.
+
+## Features
+
+- **Pull Request Management** - Create, update, merge, and find PRs
+- **Issue Operations** - Create issues, list open issues, search recent closures
+- **Milestone Management** - Create, close, and find milestones
+- **Release Operations** - Create releases, get releases by tag
+- **Workflow Monitoring** - Wait for workflow completion, get workflow runs
+- **Branch Operations** - Delete branches programmatically
+- **Flexible Logging** - Bring your own logger or use the built-in console logger
+- **Injectable Prompt** - Provide custom prompt functions for interactive operations
+
+## Installation
+
+```bash
+npm install @grunnverk/github-tools
+```
+
+## Quick Start
+
+```typescript
+import { createPullRequest, mergePullRequest, getRepoDetails } from '@grunnverk/github-tools';
+
+// Get repository details
+const { owner, repo } = await getRepoDetails();
+console.log(`Repository: ${owner}/${repo}`);
+
+// Create a pull request
+const pr = await createPullRequest(
+    'feat: Add new feature',
+    'Detailed description of the changes',
+    'feature-branch',
+    'main'
+);
+console.log(`Created PR #${pr.number}: ${pr.html_url}`);
+
+// Merge the pull request
+await mergePullRequest(pr.number, 'squash', 'feat: Add new feature (#123)');
+console.log('PR merged successfully!');
+```
+
+## Environment Variables
+
+**Required**:
+- `GITHUB_TOKEN`: GitHub personal access token with appropriate permissions
+
+```bash
+export GITHUB_TOKEN="ghp_your_token_here"
+```
+
+## Custom Logger
+
+By default, github-tools uses a console-based logger. You can provide your own logger implementation (e.g., Winston):
+
+```typescript
+import { setLogger } from '@grunnverk/github-tools';
+import winston from 'winston';
+
+// Create Winston logger
+const logger = winston.createLogger({
+    level: 'info',
+    format: winston.format.json(),
+    transports: [new winston.transports.Console()]
+});
+
+// Use Winston with github-tools
+setLogger(logger);
+```
+
+## Custom Prompt Function
+
+For interactive operations (like merge confirmations), you can provide a custom prompt function:
+
+```typescript
+import { setPromptFunction } from '@grunnverk/github-tools';
+
+// Custom prompt implementation
+const myPrompt = async (message: string): Promise<boolean> => {
+    // Your custom prompt logic (e.g., CLI prompts, UI dialogs, etc.)
+    const answer = await askUser(message);
+    return answer === 'yes';
+};
+
+// Use custom prompt with github-tools
+setPromptFunction(myPrompt);
+```
+
+## Core Modules
+
+### Pull Request Operations
+
+```typescript
+import {
+    createPullRequest,
+    findOpenPullRequestByHeadRef,
+    updatePullRequest,
+    mergePullRequest
+} from '@grunnverk/github-tools';
+
+// Create PR
+const pr = await createPullRequest('title', 'body', 'head', 'base');
+
+// Find existing PR
+const existingPr = await findOpenPullRequestByHeadRef('feature-branch');
+
+// Update PR
+await updatePullRequest(pr.number, {
+    title: 'Updated title',
+    body: 'Updated description'
+});
+
+// Merge PR
+await mergePullRequest(pr.number, 'squash', 'Commit title');
+```
+
+### Issue Operations
+
+```typescript
+import {
+    createIssue,
+    getOpenIssues,
+    getRecentClosedIssuesForCommit
+} from '@grunnverk/github-tools';
+
+// Create issue
+const issue = await createIssue(
+    'Bug: Something is broken',
+    'Detailed description',
+    ['bug', 'priority-high']
+);
+
+// Get all open issues
+const openIssues = await getOpenIssues();
+
+// Get issues closed in recent commits
+const closedIssues = await getRecentClosedIssuesForCommit('v1.0.0', 'v1.1.0', 50);
+```
+
+### Milestone Operations
+
+```typescript
+import {
+    findMilestoneByTitle,
+    createMilestone,
+    closeMilestone
+} from '@grunnverk/github-tools';
+
+// Find existing milestone
+const milestone = await findMilestoneByTitle('v1.0.0');
+
+// Create new milestone
+const newMilestone = await createMilestone(
+    'v1.1.0',
+    'Release 1.1.0 milestone'
+);
+
+// Close milestone
+await closeMilestone(milestone.number);
+```
+
+### Release Operations
+
+```typescript
+import {
+    createGitHubRelease,
+    getReleaseByTag,
+    getAllReleases
+} from '@grunnverk/github-tools';
+
+// Create release
+await createGitHubRelease(
+    'v1.0.0',
+    'Release 1.0.0',
+    '## Changes\n- Feature 1\n- Feature 2',
+    false,  // not a draft
+    false   // not a prerelease
+);
+
+// Get specific release
+const release = await getReleaseByTag('v1.0.0');
+
+// Get all releases
+const allReleases = await getAllReleases();
+```
+
+### Workflow Operations
+
+```typescript
+import {
+    waitForWorkflowsToComplete,
+    getWorkflowRunsForCommit
+} from '@grunnverk/github-tools';
+
+// Wait for workflows to complete (with timeout)
+await waitForWorkflowsToComplete('abc123', 300); // 5 minutes
+
+// Get workflow runs for a commit
+const runs = await getWorkflowRunsForCommit('abc123');
+```
+
+## API Documentation
+
+### Pull Request Functions
+
+| Function | Description |
+|----------|-------------|
+| `createPullRequest(title, body, head, base?)` | Creates a new pull request |
+| `findOpenPullRequestByHeadRef(headRef)` | Finds open PR by head branch |
+| `updatePullRequest(number, updates)` | Updates PR title/body |
+| `mergePullRequest(number, method, title?)` | Merges a pull request |
+| `deleteBranch(branchName)` | Deletes a branch |
+
+### Issue Functions
+
+| Function | Description |
+|----------|-------------|
+| `createIssue(title, body, labels?)` | Creates a new issue |
+| `getOpenIssues()` | Gets all open issues |
+| `getRecentClosedIssuesForCommit(from, to, limit)` | Gets recently closed issues |
+
+### Milestone Functions
+
+| Function | Description |
+|----------|-------------|
+| `findMilestoneByTitle(title)` | Finds milestone by title |
+| `createMilestone(title, description?)` | Creates a new milestone |
+| `closeMilestone(number)` | Closes a milestone |
+
+### Release Functions
+
+| Function | Description |
+|----------|-------------|
+| `createGitHubRelease(tag, name, body, draft, prerelease)` | Creates a GitHub release |
+| `getReleaseByTag(tag)` | Gets release by tag name |
+| `getAllReleases()` | Gets all releases |
+
+### Workflow Functions
+
+| Function | Description |
+|----------|-------------|
+| `waitForWorkflowsToComplete(sha, timeout?)` | Waits for workflows to complete |
+| `getWorkflowRunsForCommit(sha)` | Gets workflow runs for commit |
+| `getAllWorkflowRuns()` | Gets all workflow runs |
+| `getCheckRunsForRef(ref)` | Gets check runs for a ref |
+
+### Utility Functions
+
+| Function | Description |
+|----------|-------------|
+| `getOctokit()` | Gets configured Octokit instance |
+| `getCurrentBranchName()` | Gets current branch name |
+| `getRepoDetails()` | Gets owner and repo name |
+| `setLogger(logger)` | Sets custom logger |
+| `setPromptFunction(fn)` | Sets custom prompt function |
+
+## Security
+
+This library requires a GitHub personal access token with appropriate permissions:
+
+- **`repo`** scope for private repositories
+- **`public_repo`** scope for public repositories
+- **`workflow`** scope if you need to interact with GitHub Actions
+
+Store your token securely:
+```bash
+# Never commit tokens to version control
+export GITHUB_TOKEN="ghp_your_token_here"
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm run test
+
+# Lint
+npm run lint
+
+# Watch mode
+npm run watch
+```
+
+## Dependencies
+
+- **@grunnverk/git-tools**: Git operations and utilities
+- **@octokit/rest**: GitHub API client
+- **winston** (peer, optional): Logging framework
+
+## License
+
+Apache-2.0 - see [LICENSE](LICENSE) file for details.
+
+## Author
+
+Tim O'Brien <tobrien@discursive.com>
+
+## Related Projects
+
+- [kodrdriv](https://github.com/grunnverk/kodrdriv) - AI-powered Git workflow automation tool
+- [@grunnverk/git-tools](https://github.com/grunnverk/git-tools) - Git utilities for automation
+
+
+TEST
+
+<!-- Build: 2026-01-15 15:59:12 UTC -->

package/dist/errors.js

@@ -0,0 +1,124 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * Error types for github-tools
+ */ class CommandError extends Error {
+    constructor(message){
+        super(message);
+        this.name = 'CommandError';
+    }
+}
+class ArgumentError extends Error {
+    constructor(message){
+        super(message);
+        this.name = 'ArgumentError';
+    }
+}
+class PullRequestCheckError extends Error {
+    getRecoveryInstructions() {
+        return `To resolve failed PR checks:
+1. Review the failed checks at: ${this.prUrl}
+2. Fix the issues identified
+3. Push the fixes
+4. Re-run this command`;
+    }
+    constructor(message, prNumber, failedChecks, prUrl){
+        super(message), _define_property(this, "prNumber", void 0), _define_property(this, "failedChecks", void 0), _define_property(this, "prUrl", void 0);
+        this.name = 'PullRequestCheckError';
+        this.prNumber = prNumber || 0;
+        this.failedChecks = failedChecks || [];
+        this.prUrl = prUrl || '';
+    }
+}
+class PullRequestCreationError extends Error {
+    getRecoveryInstructions() {
+        var _this_details;
+        if (this.statusCode === 422) {
+            var _this_details1;
+            const errorMessage = ((_this_details1 = this.details) === null || _this_details1 === void 0 ? void 0 : _this_details1.message) || '';
+            // Check for specific 422 error patterns
+            if (errorMessage.includes('pull request already exists') || errorMessage.includes('A pull request already exists')) {
+                const instructions = [
+                    `❌ Failed to create PR: A pull request already exists for ${this.head} → ${this.base}`
+                ];
+                if (this.existingPRUrl) {
+                    instructions.push('');
+                    instructions.push(`📋 Existing PR: ${this.existingPRUrl}`);
+                }
+                instructions.push('');
+                instructions.push('Options:');
+                if (this.existingPRNumber) {
+                    instructions.push(`  1. Reuse existing PR #${this.existingPRNumber} (command will detect and continue automatically)`);
+                    instructions.push(`  2. Close existing PR: gh pr close ${this.existingPRNumber}`);
+                } else {
+                    instructions.push('  1. Check for existing PRs: gh pr list');
+                    instructions.push('  2. Close existing PR if needed: gh pr close <number>');
+                }
+                instructions.push(`  3. Use different branch name`);
+                return instructions.join('\n');
+            }
+            if (errorMessage.includes('No commits between') || errorMessage.includes('head and base')) {
+                return `❌ Failed to create PR: No commits between ${this.head} and ${this.base}
+
+This usually means:
+  • The branches are already in sync
+  • No changes have been pushed to ${this.head}
+
+What to do:
+  1. Verify you're on the correct branch: git branch
+  2. Check if there are unpushed commits: git log ${this.base}..${this.head}
+  3. If no changes exist, there's nothing to publish`;
+            }
+            if (errorMessage.includes('Validation Failed') || errorMessage.includes('field')) {
+                return `❌ Failed to create PR: Validation error
+
+Error details: ${errorMessage}
+
+Common causes:
+  • PR title too long (max 256 characters)
+  • Invalid characters in title or body
+  • Branch protection rules preventing PR creation
+
+What to do:
+  1. Check your commit message is valid: git log -1
+  2. Verify branch protection settings in GitHub
+  3. Try creating the PR manually to see detailed error`;
+            }
+        }
+        // Generic recovery instructions
+        return `❌ Failed to create pull request (HTTP ${this.statusCode})
+
+Error: ${((_this_details = this.details) === null || _this_details === void 0 ? void 0 : _this_details.message) || 'Unknown error'}
+
+What to do:
+  1. Check GitHub API status: https://www.githubstatus.com/
+  2. Verify GITHUB_TOKEN permissions (needs 'repo' scope)
+  3. Check if base branch (${this.base}) exists
+  4. Verify working directory is clean: git status
+  5. Try viewing existing PRs: gh pr list --head ${this.head}`;
+    }
+    constructor(message, statusCode, head, base, details, existingPRNumber, existingPRUrl){
+        super(message), _define_property(this, "statusCode", void 0), _define_property(this, "existingPRNumber", void 0), _define_property(this, "existingPRUrl", void 0), _define_property(this, "head", void 0), _define_property(this, "base", void 0), _define_property(this, "details", void 0);
+        this.name = 'PullRequestCreationError';
+        this.statusCode = statusCode;
+        this.head = head;
+        this.base = base;
+        this.details = details;
+        this.existingPRNumber = existingPRNumber;
+        this.existingPRUrl = existingPRUrl;
+    }
+}
+
+export { ArgumentError, CommandError, PullRequestCheckError, PullRequestCreationError };
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sources":["../src/errors.ts"],"sourcesContent":["/**\n * Error types for github-tools\n */\n\nexport class CommandError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = 'CommandError';\n    }\n}\n\nexport class ArgumentError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = 'ArgumentError';\n    }\n}\n\nexport class PullRequestCheckError extends Error {\n    public readonly prNumber: number;\n    public readonly failedChecks: any[];\n    public readonly prUrl: string;\n\n    constructor(message: string, prNumber?: number, failedChecks?: any[], prUrl?: string) {\n        super(message);\n        this.name = 'PullRequestCheckError';\n        this.prNumber = prNumber || 0;\n        this.failedChecks = failedChecks || [];\n        this.prUrl = prUrl || '';\n    }\n\n    getRecoveryInstructions(): string {\n        return `To resolve failed PR checks:\n1. Review the failed checks at: ${this.prUrl}\n2. Fix the issues identified\n3. Push the fixes\n4. Re-run this command`;\n    }\n}\n\nexport class PullRequestCreationError extends Error {\n    public readonly statusCode: number;\n    public readonly existingPRNumber?: number;\n    public readonly existingPRUrl?: string;\n    public readonly head: string;\n    public readonly base: string;\n    public readonly details?: any;\n\n    constructor(\n        message: string,\n        statusCode: number,\n        head: string,\n        base: string,\n        details?: any,\n        existingPRNumber?: number,\n        existingPRUrl?: string\n    ) {\n        super(message);\n        this.name = 'PullRequestCreationError';\n        this.statusCode = statusCode;\n        this.head = head;\n        this.base = base;\n        this.details = details;\n        this.existingPRNumber = existingPRNumber;\n        this.existingPRUrl = existingPRUrl;\n    }\n\n    getRecoveryInstructions(): string {\n        if (this.statusCode === 422) {\n            const errorMessage = this.details?.message || '';\n\n            // Check for specific 422 error patterns\n            if (errorMessage.includes('pull request already exists') ||\n                errorMessage.includes('A pull request already exists')) {\n                const instructions = [`❌ Failed to create PR: A pull request already exists for ${this.head} → ${this.base}`];\n\n                if (this.existingPRUrl) {\n                    instructions.push('');\n                    instructions.push(`📋 Existing PR: ${this.existingPRUrl}`);\n                }\n\n                instructions.push('');\n                instructions.push('Options:');\n                if (this.existingPRNumber) {\n                    instructions.push(`  1. Reuse existing PR #${this.existingPRNumber} (command will detect and continue automatically)`);\n                    instructions.push(`  2. Close existing PR: gh pr close ${this.existingPRNumber}`);\n                } else {\n                    instructions.push('  1. Check for existing PRs: gh pr list');\n                    instructions.push('  2. Close existing PR if needed: gh pr close <number>');\n                }\n                instructions.push(`  3. Use different branch name`);\n\n                return instructions.join('\\n');\n            }\n\n            if (errorMessage.includes('No commits between') ||\n                errorMessage.includes('head and base')) {\n                return `❌ Failed to create PR: No commits between ${this.head} and ${this.base}\n\nThis usually means:\n  • The branches are already in sync\n  • No changes have been pushed to ${this.head}\n\nWhat to do:\n  1. Verify you're on the correct branch: git branch\n  2. Check if there are unpushed commits: git log ${this.base}..${this.head}\n  3. If no changes exist, there's nothing to publish`;\n            }\n\n            if (errorMessage.includes('Validation Failed') ||\n                errorMessage.includes('field')) {\n                return `❌ Failed to create PR: Validation error\n\nError details: ${errorMessage}\n\nCommon causes:\n  • PR title too long (max 256 characters)\n  • Invalid characters in title or body\n  • Branch protection rules preventing PR creation\n\nWhat to do:\n  1. Check your commit message is valid: git log -1\n  2. Verify branch protection settings in GitHub\n  3. Try creating the PR manually to see detailed error`;\n            }\n        }\n\n        // Generic recovery instructions\n        return `❌ Failed to create pull request (HTTP ${this.statusCode})\n\nError: ${this.details?.message || 'Unknown error'}\n\nWhat to do:\n  1. Check GitHub API status: https://www.githubstatus.com/\n  2. Verify GITHUB_TOKEN permissions (needs 'repo' scope)\n  3. Check if base branch (${this.base}) exists\n  4. Verify working directory is clean: git status\n  5. Try viewing existing PRs: gh pr list --head ${this.head}`;\n    }\n}\n\n"],"names":["CommandError","Error","message","name","ArgumentError","PullRequestCheckError","getRecoveryInstructions","prUrl","prNumber","failedChecks","PullRequestCreationError","statusCode","errorMessage","details","includes","instructions","head","base","existingPRUrl","push","existingPRNumber","join"],"mappings":";;;;;;;;;;;;;AAAA;;IAIO,MAAMA,YAAAA,SAAqBC,KAAAA,CAAAA;AAC9B,IAAA,WAAA,CAAYC,OAAe,CAAE;AACzB,QAAA,KAAK,CAACA,OAAAA,CAAAA;QACN,IAAI,CAACC,IAAI,GAAG,cAAA;AAChB,IAAA;AACJ;AAEO,MAAMC,aAAAA,SAAsBH,KAAAA,CAAAA;AAC/B,IAAA,WAAA,CAAYC,OAAe,CAAE;AACzB,QAAA,KAAK,CAACA,OAAAA,CAAAA;QACN,IAAI,CAACC,IAAI,GAAG,eAAA;AAChB,IAAA;AACJ;AAEO,MAAME,qBAAAA,SAA8BJ,KAAAA,CAAAA;IAavCK,uBAAAA,GAAkC;AAC9B,QAAA,OAAO,CAAC;gCACgB,EAAE,IAAI,CAACC,KAAK;;;sBAGtB,CAAC;AACnB,IAAA;AAdA,IAAA,WAAA,CAAYL,OAAe,EAAEM,QAAiB,EAAEC,YAAoB,EAAEF,KAAc,CAAE;AAClF,QAAA,KAAK,CAACL,OAAAA,CAAAA,EALV,gBAAA,CAAA,IAAA,EAAgBM,UAAAA,EAAhB,MAAA,CAAA,EACA,gBAAA,CAAA,IAAA,EAAgBC,cAAAA,EAAhB,MAAA,CAAA,EACA,gBAAA,CAAA,IAAA,EAAgBF,OAAAA,EAAhB,MAAA,CAAA;QAII,IAAI,CAACJ,IAAI,GAAG,uBAAA;QACZ,IAAI,CAACK,QAAQ,GAAGA,QAAAA,IAAY,CAAA;AAC5B,QAAA,IAAI,CAACC,YAAY,GAAGA,YAAAA,IAAgB,EAAE;QACtC,IAAI,CAACF,KAAK,GAAGA,KAAAA,IAAS,EAAA;AAC1B,IAAA;AASJ;AAEO,MAAMG,wBAAAA,SAAiCT,KAAAA,CAAAA;IA2B1CK,uBAAAA,GAAkC;AA+D7B,QAAA,IAAA,aAAA;AA9DD,QAAA,IAAI,IAAI,CAACK,UAAU,KAAK,GAAA,EAAK;AACJ,YAAA,IAAA,cAAA;YAArB,MAAMC,YAAAA,GAAe,CAAA,CAAA,cAAA,GAAA,IAAI,CAACC,OAAO,MAAA,IAAA,IAAZ,cAAA,KAAA,MAAA,GAAA,MAAA,GAAA,cAAA,CAAcX,OAAO,KAAI,EAAA;;AAG9C,YAAA,IAAIU,aAAaE,QAAQ,CAAC,kCACtBF,YAAAA,CAAaE,QAAQ,CAAC,+BAAA,CAAA,EAAkC;AACxD,gBAAA,MAAMC,YAAAA,GAAe;oBAAC,CAAC,yDAAyD,EAAE,IAAI,CAACC,IAAI,CAAC,GAAG,EAAE,IAAI,CAACC,IAAI,CAAA;AAAG,iBAAA;gBAE7G,IAAI,IAAI,CAACC,aAAa,EAAE;AACpBH,oBAAAA,YAAAA,CAAaI,IAAI,CAAC,EAAA,CAAA;oBAClBJ,YAAAA,CAAaI,IAAI,CAAC,CAAC,gBAAgB,EAAE,IAAI,CAACD,aAAa,CAAA,CAAE,CAAA;AAC7D,gBAAA;AAEAH,gBAAAA,YAAAA,CAAaI,IAAI,CAAC,EAAA,CAAA;AAClBJ,gBAAAA,YAAAA,CAAaI,IAAI,CAAC,UAAA,CAAA;gBAClB,IAAI,IAAI,CAACC,gBAAgB,EAAE;oBACvBL,YAAAA,CAAaI,IAAI,CAAC,CAAC,wBAAwB,EAAE,IAAI,CAACC,gBAAgB,CAAC,iDAAiD,CAAC,CAAA;oBACrHL,YAAAA,CAAaI,IAAI,CAAC,CAAC,oCAAoC,EAAE,IAAI,CAACC,gBAAgB,CAAA,CAAE,CAAA;gBACpF,CAAA,MAAO;AACHL,oBAAAA,YAAAA,CAAaI,IAAI,CAAC,yCAAA,CAAA;AAClBJ,oBAAAA,YAAAA,CAAaI,IAAI,CAAC,wDAAA,CAAA;AACtB,gBAAA;AACAJ,gBAAAA,YAAAA,CAAaI,IAAI,CAAC,CAAC,8BAA8B,CAAC,CAAA;gBAElD,OAAOJ,YAAAA,CAAaM,IAAI,CAAC,IAAA,CAAA;AAC7B,YAAA;AAEA,YAAA,IAAIT,aAAaE,QAAQ,CAAC,yBACtBF,YAAAA,CAAaE,QAAQ,CAAC,eAAA,CAAA,EAAkB;AACxC,gBAAA,OAAO,CAAC,0CAA0C,EAAE,IAAI,CAACE,IAAI,CAAC,KAAK,EAAE,IAAI,CAACC,IAAI;;;;mCAI3D,EAAE,IAAI,CAACD,IAAI;;;;kDAII,EAAE,IAAI,CAACC,IAAI,CAAC,EAAE,EAAE,IAAI,CAACD,IAAI;oDACvB,CAAC;AACzC,YAAA;AAEA,YAAA,IAAIJ,aAAaE,QAAQ,CAAC,wBACtBF,YAAAA,CAAaE,QAAQ,CAAC,OAAA,CAAA,EAAU;AAChC,gBAAA,OAAO,CAAC;;AAET,eAAA,EAAEF,YAAAA;;;;;;;;;;uDAUsC,CAAC;AAC5C,YAAA;AACJ,QAAA;;AAGA,QAAA,OAAO,CAAC,sCAAsC,EAAE,IAAI,CAACD,UAAU,CAAC;;OAEjE,EAAE,CAAA,CAAA,aAAA,GAAA,IAAI,CAACE,OAAO,cAAZ,aAAA,KAAA,MAAA,GAAA,MAAA,GAAA,aAAA,CAAcX,OAAO,KAAI,eAAA;;;;;2BAKP,EAAE,IAAI,CAACe,IAAI,CAAC;;iDAEU,EAAE,IAAI,CAACD,IAAI,CAAA,CAAE;AAC1D,IAAA;AA1FA,IAAA,WAAA,CACId,OAAe,EACfS,UAAkB,EAClBK,IAAY,EACZC,IAAY,EACZJ,OAAa,EACbO,gBAAyB,EACzBF,aAAsB,CACxB;QACE,KAAK,CAAChB,OAAAA,CAAAA,EAhBV,gBAAA,CAAA,IAAA,EAAgBS,YAAAA,EAAhB,SACA,gBAAA,CAAA,IAAA,EAAgBS,kBAAAA,EAAhB,MAAA,CAAA,EACA,gBAAA,CAAA,IAAA,EAAgBF,eAAAA,EAAhB,MAAA,CAAA,EACA,gBAAA,CAAA,IAAA,EAAgBF,MAAAA,EAAhB,MAAA,CAAA,EACA,gBAAA,CAAA,IAAA,EAAgBC,QAAhB,MAAA,CAAA,EACA,gBAAA,CAAA,IAAA,EAAgBJ,SAAAA,EAAhB,MAAA,CAAA;QAYI,IAAI,CAACV,IAAI,GAAG,0BAAA;QACZ,IAAI,CAACQ,UAAU,GAAGA,UAAAA;QAClB,IAAI,CAACK,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACJ,OAAO,GAAGA,OAAAA;QACf,IAAI,CAACO,gBAAgB,GAAGA,gBAAAA;QACxB,IAAI,CAACF,aAAa,GAAGA,aAAAA;AACzB,IAAA;AA0EJ;;;;"}