gitpadi 2.0.2 → 2.0.4

package/README.md

@@ -1,270 +1,102 @@
-<p align="center">
-  <h1 align="center">🤖 GitPadi</h1>
-  <p align="center"><strong>Your AI-powered GitHub management agent.</strong></p>
-  <p align="center">
-    Auto-score contributors, review PRs, manage issues & repos — from your terminal or as a GitHub Action.
-  </p>
-  <p align="center">
-    <a href="#-use-the-cli">CLI</a> •
-    <a href="#-use-as-github-action">GitHub Action</a> •
-    <a href="#-scoring-algorithm">Scoring Algorithm</a>
-  </p>
-</p>
+# 🤖 GitPadi
 
----
-
-## ⚡ Two Ways to Use GitPadi
+GitPadi is a GitHub management CLI and Action built to automate the repetitive parts of maintaining open-source projects. 
 
-| Method | Best For | Setup |
-|--------|----------|-------|
-| **CLI** (`npx gitpadi`) | Hands-on management from your terminal | One command |
-| **GitHub Action** | Automated scoring & reviews on every event | Copy one workflow file |
+Whether you're a maintainer managing hundreds of issues or a contributor making your first PR, GitPadi turns multi-step GitHub workflows into single commands.
 
 ---
 
-## 🖥️ Use the CLI
+## 🚀 For Contributors
 
-**No installation needed.** Run directly with `npx`:
+Stop worrying about forking, upstream remotes, and branch naming. GitPadi handles the plumbing so you can focus on the code.
 
+### Start a new contribution
 ```bash
-export GITHUB_TOKEN=ghp_your_token
-export GITHUB_OWNER=your-org
-export GITHUB_REPO=your-repo
-
-npx gitpadi
-```
-
-That launches the **interactive terminal**:
-
-```
-┌─────────────────────────────────────┐
-│  🤖 GitPadi v2.0                    │
-│  Your GitHub Management Companion   │
-└─────────────────────────────────────┘
-
-? What would you like to do?
-  📋  Manage Issues
-  🔀  Manage Pull Requests
-  📦  Manage Repositories
-  🏆  Score Contributors
-  🚀  Create Release
-  ⚙️   Switch Repo
-  👋  Exit
+npx gitpadi start <issue-url>
 ```
+This single command:
+1. **Forks** the repository to your account.
+2. **Clones** it to your machine.
+3. Sets up the **upstream remote**.
+4. Creates a **fresh feature branch** linked to the issue.
 
-Or use **direct commands**:
-
+### Submit your work
 ```bash
-npx gitpadi issues list
-npx gitpadi prs merge 5 --method squash
-npx gitpadi contributors score octocat
-npx gitpadi repo create my-app --org MyOrg
+npx gitpadi submit
 ```
+When you're done, this command:
+1. **Stages** all your changes.
+2. Creates a **commit** with a clean message.
+3. **Pushes** to your fork.
+4. Opens a **Pull Request** on the original repo, auto-linked to the issue.
+
+---
 
-### All CLI Commands
+## 🛠️ For Maintainers
 
-<details>
-<summary><b>📋 Issues</b></summary>
+Manage your community and project health directly from your terminal.
 
+### 📋 Bulk Issue Creation
+Create dozens of issues in seconds from a simple Markdown or JSON file.
 ```bash
-npx gitpadi issues list                        # List open issues
-npx gitpadi issues create -t "Bug fix" -l bug  # Create issue
-npx gitpadi issues bulk -f issues.json         # Bulk create from JSON
-npx gitpadi issues close 42                    # Close issue
-npx gitpadi issues reopen 42                   # Reopen issue
-npx gitpadi issues delete 42                   # Close & lock
-npx gitpadi issues assign 42 alice bob         # Assign users
-npx gitpadi issues assign-best 42             # 🏆 Auto-assign top scorer
-npx gitpadi issues search "login bug"          # Search issues
-npx gitpadi issues label 42 bug priority-high  # Add labels
+npx gitpadi issues bulk -f roadmap.md
 ```
-</details>
-
-<details>
-<summary><b>🔀 Pull Requests</b></summary>
+*(Supports `## Heading` titles and `**Labels:**` tags).*
 
+### 🏆 Smart Contributor Scoring
+Auto-score applicants based on their GitHub history, account age, and relevance to the issue.
 ```bash
-npx gitpadi prs list                     # List open PRs
-npx gitpadi prs merge 5 --method squash  # Merge PR (squash/merge/rebase)
-npx gitpadi prs close 5                  # Close PR
-npx gitpadi prs review 5                 # Auto-review (size, tests, security)
-npx gitpadi prs approve 5                # Approve PR
-npx gitpadi prs diff 5                   # Show changed files
+npx gitpadi contributors score octocat
 ```
-</details>
-
-<details>
-<summary><b>📦 Repositories</b></summary>
-
+Or let GitPadi find the best applicant for an issue:
 ```bash
-npx gitpadi repo list --org MyOrg              # List repos
-npx gitpadi repo create my-app --org MyOrg     # Create repo
-npx gitpadi repo delete my-app --org MyOrg     # Delete repo
-npx gitpadi repo clone my-app                  # Clone repo
-npx gitpadi repo info my-app                   # Show repo details
-npx gitpadi repo topics my-app rust blockchain # Set topics
+npx gitpadi issues assign-best 42
 ```
-</details>
 
-<details>
-<summary><b>🏆 Contributors</b></summary>
+### 🔀 Advanced PR Management
+- **Review PRs**: Get an automated review (size analysis, security checks, test coverage).
+- **Fast Merge**: Squash and merge PRs directly from the CLI.
+- **CI Status**: View GitHub Action logs for a PR without opening a browser.
 
-```bash
-npx gitpadi contributors score octocat    # Score a user (0-100)
-npx gitpadi contributors rank 42          # Rank all applicants for issue #42
-npx gitpadi contributors list             # List repo contributors
-```
-</details>
+---
 
-<details>
-<summary><b>🚀 Releases</b></summary>
+## ⚡ Quick Start
+
+No installation required. Just set your token and go:
 
 ```bash
-npx gitpadi release create v1.0.0          # Create release (auto-notes)
-npx gitpadi release create v1.0.0 --draft  # Create as draft
-npx gitpadi release list                   # List releases
+export GITHUB_TOKEN=ghp_your_token
+npx gitpadi
 ```
-</details>
-
-### Or install globally:
 
+### Direct Commands
 ```bash
-npm install -g gitpadi
-gitpadi issues list
+npx gitpadi issues list --limit 100
+npx gitpadi prs review 5
+npx gitpadi release create v1.0.0
 ```
 
 ---
 
-## 🔧 Use as GitHub Action
-
-Just add a workflow file — no setup, no tokens to manage.
+## 🔧 Use as a GitHub Action
 
-### 🏆 Auto-Score Contributors
+GitPadi can run on every event in your repo. Just add a workflow file.
 
+**Auto-Score Applicants:**
 ```yaml
-# .github/workflows/applicant-scorer.yml
-name: Score Applicants
-on:
-  issue_comment:
-    types: [created]
-permissions:
-  contents: read
-  issues: write
-  pull-requests: read
-jobs:
-  score:
-    if: "!github.event.issue.pull_request"
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: Netwalls/contributor-agent@v2
-        with:
-          action: score-applicant
-          notify-user: 'your-username'  # ← you get @mentioned
+- uses: Netwalls/contributor-agent@v2
+  with:
+    action: score-applicant
 ```
 
-### 🔍 Auto-Review PRs
-
+**Auto-Review PRs:**
 ```yaml
-# .github/workflows/pr-review.yml
-name: PR Review
-on:
-  pull_request:
-    types: [opened, synchronize, reopened]
-permissions:
-  contents: read
-  pull-requests: write
-jobs:
-  review:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: Netwalls/contributor-agent@v2
-        with:
-          action: review-pr
-```
-
-### 📋 Bulk Create Issues
-
-```yaml
-# .github/workflows/create-issues.yml
-name: Create Issues
-on:
-  workflow_dispatch:
-    inputs:
-      issues-file:
-        description: 'Path to issues JSON'
-        default: 'issues.json'
-      dry-run:
-        description: 'Preview only'
-        default: 'true'
-permissions:
-  issues: write
-jobs:
-  create:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: Netwalls/contributor-agent@v2
-        with:
-          action: create-issues
-          issues-file: ${{ github.event.inputs.issues-file }}
-          dry-run: ${{ github.event.inputs.dry-run }}
-```
-
----
-
-## 🏆 Scoring Algorithm
-
-GitPadi scores contributors on **6 dimensions** (100 points total):
-
-| Category | Max | What It Measures |
-|----------|-----|-----------------|
-| 🔧 **Repo Experience** | **30** | Merged PRs, open PRs, issues in YOUR specific repo |
-| 🏛️ Account Maturity | 15 | Account age |
-| 🌐 GitHub Presence | 15 | Public repos, followers, profile README |
-| ⚡ Activity Level | 15 | Recent public GitHub activity |
-| 📝 Application Quality | 15 | Comment depth — mentions approach, experience, timeline |
-| 💻 Language Relevance | 10 | User's languages match issue label languages |
-
-### Tiers
-
-| Tier | Score | Recommendation |
-|------|-------|---------------|
-| 🏆 **S** | 75+ | Strong — assign immediately |
-| 🟢 **A** | 55-74 | Good — assign with confidence |
-| 🟡 **B** | 40-54 | Decent — review profile first |
-| 🟠 **C** | 25-39 | Below average — wait for better |
-| 🔴 **D** | 0-24 | Low — manual review needed |
-
-### Detected Application Phrases
-
-> *"I'd like to work on this"* · *"Can I take this?"* · *"Assign me"* · *"I'm interested"* · *"I want to contribute"* · *"Let me handle this"* · *"Picking this up"* · *"Claiming this"*
-
----
-
-## ⚙️ Configuration
-
-### Environment Variables
-
-| Variable | Required | Description |
-|----------|----------|-------------|
-| `GITHUB_TOKEN` | ✅ | GitHub PAT with `repo` scope |
-| `GITHUB_OWNER` | For CLI | Org or username |
-| `GITHUB_REPO` | For CLI | Repository name |
-
-### CLI Flags
-
-```bash
-npx gitpadi --owner MyOrg --repo my-project --token ghp_xxx issues list
+- uses: Netwalls/contributor-agent@v2
+  with:
+    action: review-pr
 ```
 
 ---
 
 ## 📄 License
-
-MIT — Built by [Netwalls](https://github.com/Netwalls)
-
-
-
-i noticed that a users have more issues but it is just bring out the top 10 issues that are open how do we bring out more issues
+MIT — Built by [Netwalls](https://github.com/Netwalls)

package/dist/cli.js

@@ -8,6 +8,7 @@ import chalk from 'chalk';
 import inquirer from 'inquirer';
 import gradient from 'gradient-string';
 import figlet from 'figlet';
+import { execSync } from 'child_process';
 import boxen from 'boxen';
 import { createSpinner } from 'nanospinner';
 import { Octokit } from '@octokit/rest';
@@ -257,16 +258,50 @@ async function contributorMenu() {
                 await contribute.viewLogs();
             }
             else if (action === 'submit') {
-                const { title, message, issue } = await ask([
-                    { type: 'input', name: 'title', message: 'PR Title:' },
-                    { type: 'input', name: 'message', message: 'Commit message (optional):' },
-                    { type: 'input', name: 'issue', message: 'Related Issue # (optional):' }
+                const branch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
+                const match = branch.match(/issue-(\d+)/);
+                const detectedIssue = match ? parseInt(match[1]) : undefined;
+                let detectedTitle = '';
+                if (detectedIssue) {
+                    process.stdout.write(dim(`  🔍 Detected Issue #${detectedIssue} from branch... `));
+                    try {
+                        const { data: issueData } = await getOctokit().issues.get({
+                            owner: getOwner(),
+                            repo: getRepo(),
+                            issue_number: detectedIssue,
+                        });
+                        detectedTitle = issueData.title;
+                        console.log(cyan(`${detectedTitle}`));
+                    }
+                    catch {
+                        console.log(dim(' (could not fetch title)'));
+                    }
+                }
+                const { confirm } = await ask([
+                    {
+                        type: 'list',
+                        name: 'confirm',
+                        message: yellow('🚀 Ready to submit?'),
+                        choices: [
+                            { name: `✅ Yes, use automated metadata`, value: 'yes' },
+                            { name: `✍️  Edit title/message manually`, value: 'edit' },
+                            { name: `⬅  Back`, value: 'back' }
+                        ]
+                    }
                 ]);
-                await contribute.submitPR({
-                    title,
-                    message: message || title,
-                    issue: issue ? parseInt(issue) : undefined
-                });
+                if (confirm === 'back')
+                    return;
+                let submissionOpts = {};
+                if (confirm === 'edit') {
+                    submissionOpts = await ask([
+                        { type: 'input', name: 'title', message: 'PR Title:', default: detectedTitle ? `fix: ${detectedTitle}` : '' },
+                        { type: 'input', name: 'message', message: 'Commit Message:', default: detectedTitle ? `fix: ${detectedTitle} (#${detectedIssue})` : '' },
+                        { type: 'input', name: 'issue', message: 'Issue #:', default: detectedIssue ? detectedIssue.toString() : '' }
+                    ]);
+                    if (submissionOpts.issue)
+                        submissionOpts.issue = parseInt(submissionOpts.issue);
+                }
+                await contribute.submitPR(submissionOpts);
             }
         }
     }
@@ -363,11 +398,10 @@ async function issueMenu() {
     else if (action === 'bulk') {
         const a = await ask([
             { type: 'input', name: 'file', message: yellow('📁 Path to issues file (JSON or MD)') + dim(' (q=back):') },
-            { type: 'confirm', name: 'dryRun', message: 'Dry run first?', default: true },
             { type: 'number', name: 'start', message: dim('Start index:'), default: 1 },
             { type: 'number', name: 'end', message: dim('End index:'), default: 999 },
         ]);
-        await issues.createIssuesFromFile(a.file, { dryRun: a.dryRun, start: a.start, end: a.end });
+        await issues.createIssuesFromFile(a.file, { start: a.start, end: a.end });
     }
     else if (action === 'assign-best') {
         const spinner = createSpinner(dim('Finding issues with applicants...')).start();
@@ -753,8 +787,8 @@ function setupCommander() {
         .option('-i, --issue <n>', 'Issue number')
         .action(async (o) => {
         await contribute.submitPR({
-            title: o.title || 'Automated PR',
-            message: o.message || o.title,
+            title: o.title,
+            message: o.message,
             issue: o.issue ? parseInt(o.issue) : undefined
         });
     });

package/dist/commands/contribute.js

@@ -81,8 +81,23 @@ export async function forkAndClone(target) {
                 execSync(`git remote add upstream https://github.com/${owner}/${repo}.git`, { stdio: 'pipe' });
             }
             catch { /* exists */ }
+            // 1. Detect default branch
+            let defaultBranch = 'main';
+            try {
+                execSync('git rev-parse upstream/main', { stdio: 'pipe' });
+            }
+            catch {
+                defaultBranch = 'master';
+            }
+            // 2. Checkout default branch before syncing
+            try {
+                execSync(`git checkout ${defaultBranch}`, { stdio: 'pipe' });
+            }
+            catch {
+                // If it fails, maybe it's not even a valid default branch locally, but we'll try to sync anyway
+            }
             await syncBranch();
-            // Create or switch to issue branch
+            // 3. Create or switch to issue branch
             const branchName = issue ? `fix/issue-${issue}` : null;
             if (branchName) {
                 try {
@@ -220,9 +235,34 @@ export async function submitPR(opts) {
         const owner = getOwner();
         const repo = getRepo();
         const branch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
+        // Auto-infer issue from branch name (e.g. fix/issue-303)
+        let linkedIssue = opts.issue;
+        if (!linkedIssue) {
+            const match = branch.match(/issue-(\d+)/);
+            if (match)
+                linkedIssue = parseInt(match[1]);
+        }
+        const octokit = getOctokit();
+        // 2. Fetch Issue Details for better PR Metadata
+        let issueTitle = '';
+        if (linkedIssue) {
+            spinner.text = `Fetching details for issue #${linkedIssue}...`;
+            try {
+                const { data: issueData } = await octokit.issues.get({
+                    owner,
+                    repo,
+                    issue_number: linkedIssue,
+                });
+                issueTitle = issueData.title;
+            }
+            catch (e) {
+                // Silently fallback if issue doesn't exist or no access
+            }
+        }
+        const prTitle = opts.title || (issueTitle ? `fix: ${issueTitle} (#${linkedIssue})` : 'Automated contribution via GitPadi');
+        const commitMsg = opts.message || prTitle;
         // 1. Stage and Commit
         spinner.text = 'Staging and committing changes...';
-        const commitMsg = opts.message || opts.title || 'Automated contribution via GitPadi';
         try {
             execSync('git add .', { stdio: 'pipe' });
             // Check if there are changes to commit
@@ -235,24 +275,25 @@ export async function submitPR(opts) {
             // If commit fails (e.g. no changes), we might still want to push if there are unpushed commits
             dim('  (Note: No new changes to commit or commit failed)');
         }
-        // Auto-infer issue from branch name (e.g. fix/issue-303)
-        let linkedIssue = opts.issue;
-        if (!linkedIssue) {
-            const match = branch.match(/issue-(\d+)/);
-            if (match)
-                linkedIssue = parseInt(match[1]);
-        }
         spinner.text = 'Pushing to your fork...';
         execSync(`git push origin ${branch}`, { stdio: 'pipe' });
         spinner.text = 'Creating Pull Request...';
         const body = opts.body || (linkedIssue ? `Fixes #${linkedIssue}` : 'Automated PR via GitPadi');
-        const { data: pr } = await getOctokit().pulls.create({
+        // Detect base branch
+        let baseBranch = 'main';
+        try {
+            execSync('git rev-parse origin/main', { stdio: 'pipe' });
+        }
+        catch {
+            baseBranch = 'master';
+        }
+        const { data: pr } = await octokit.pulls.create({
             owner,
             repo,
-            title: opts.title,
+            title: prTitle,
             body,
             head: `${await getAuthenticatedUser()}:${branch}`,
-            base: 'main',
+            base: baseBranch,
         });
         spinner.succeed(`PR Created: ${green(pr.html_url)}`);
     }

package/dist/commands/issues.js

@@ -11,16 +11,29 @@ export async function listIssues(opts) {
     const octokit = getOctokit();
     const spinner = ora(`Fetching issues from ${chalk.cyan(getFullRepo())}...`).start();
     try {
-        const { data: issues } = await octokit.issues.listForRepo({
-            owner: getOwner(), repo: getRepo(),
-            state: opts.state || 'open',
-            labels: opts.labels || undefined,
-            per_page: opts.limit || 50,
-        });
-        // Filter out PRs (GitHub API returns PRs in issues endpoint)
-        const realIssues = issues.filter((i) => !i.pull_request);
+        const requestedLimit = opts.limit || 50;
+        const realIssues = [];
+        let page = 1;
+        // Fetch until we have enough real issues or run out of pages
+        while (realIssues.length < requestedLimit) {
+            const { data: issues } = await octokit.issues.listForRepo({
+                owner: getOwner(), repo: getRepo(),
+                state: opts.state || 'open',
+                labels: opts.labels || undefined,
+                per_page: 100, // Fetch max per page to be efficient
+                page: page++,
+            });
+            if (issues.length === 0)
+                break;
+            const batch = issues.filter((i) => !i.pull_request);
+            realIssues.push(...batch);
+            if (issues.length < 100)
+                break; // Last page
+        }
+        // Clip to requested limit
+        const finalIssues = realIssues.slice(0, requestedLimit);
         spinner.stop();
-        if (realIssues.length === 0) {
+        if (finalIssues.length === 0) {
             console.log(chalk.yellow('\n  No issues found.\n'));
             return;
         }
@@ -28,13 +41,13 @@ export async function listIssues(opts) {
             head: ['#', 'Title', 'Labels', 'Assignee', 'State'].map((h) => chalk.cyan(h)),
             style: { head: [], border: [] },
         });
-        realIssues.forEach((i) => {
+        finalIssues.forEach((i) => {
             const labels = i.labels.map((l) => typeof l === 'string' ? l : l.name || '').join(', ');
             const assignee = i.assignee?.login || chalk.dim('unassigned');
             const state = i.state === 'open' ? chalk.green('open') : chalk.red('closed');
             table.push([`#${i.number}`, i.title.substring(0, 60), labels.substring(0, 30), assignee, state]);
         });
-        console.log(`\n${chalk.bold(`📋 Issues — ${getFullRepo()}`)} (${realIssues.length})\n`);
+        console.log(`\n${chalk.bold(`📋 Issues — ${getFullRepo()}`)} (${finalIssues.length})\n`);
         console.log(table.toString());
         console.log('');
     }
@@ -137,16 +150,22 @@ export async function createIssuesFromFile(filePath, opts) {
     console.log(`\n${chalk.bold('📋 GitPadi Issue Creator')}`);
     console.log(chalk.dim(`  Repo:   ${getFullRepo()}`));
     console.log(chalk.dim(`  File:   ${filePath} (${detectedFormat})`));
-    console.log(chalk.dim(`  Range:  #${start}-#${end} (${filtered.length} issues)`));
-    console.log(chalk.dim(`  Mode:   ${opts.dryRun ? 'DRY RUN' : 'LIVE'}\n`));
-    if (opts.dryRun) {
-        filtered.forEach((i) => {
-            console.log(`  ${chalk.dim(`#${String(i.number).padStart(2, '0')}`)}  ${i.title}`);
-            console.log(chalk.dim(`       [${(i.labels || []).join(', ')}]`));
-            if (i.body)
-                console.log(chalk.dim(`       ${i.body.substring(0, 80)}...`));
-        });
-        console.log(chalk.green(`\n✅ Dry run: ${filtered.length} issues would be created.\n`));
+    console.log(chalk.dim(`  Found:  ${filtered.length} issues\n`));
+    // Always preview first
+    filtered.forEach((i) => {
+        console.log(`  ${chalk.dim(`#${String(i.number).padStart(2, '0')}`)}  ${i.title}`);
+        console.log(chalk.dim(`       [${(i.labels || []).join(', ')}]`));
+    });
+    // Ask for confirmation
+    const inquirer = (await import('inquirer')).default;
+    const { proceed } = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'proceed',
+            message: chalk.yellow(`Create these ${filtered.length} issues on GitHub?`),
+            default: true,
+        }]);
+    if (!proceed) {
+        console.log(chalk.dim('\n  Cancelled.\n'));
         return;
     }
     const octokit = getOctokit();

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "gitpadi",
-    "version": "2.0.2",
-    "description": "🤖 GitPadi — Your AI-powered GitHub management CLI. Create repos, manage issues & PRs, score contributors, and automate everything.",
+    "version": "2.0.4",
+    "description": "GitPadi — Your AI-powered GitHub management CLI. Create repos, manage issues & PRs, score contributors, and automate everything.",
     "type": "module",
     "bin": {
         "gitpadi": "./dist/cli.js"

package/src/cli.ts

@@ -287,16 +287,50 @@ async function contributorMenu() {
             } else if (action === 'logs') {
                 await contribute.viewLogs();
             } else if (action === 'submit') {
-                const { title, message, issue } = await ask([
-                    { type: 'input', name: 'title', message: 'PR Title:' },
-                    { type: 'input', name: 'message', message: 'Commit message (optional):' },
-                    { type: 'input', name: 'issue', message: 'Related Issue # (optional):' }
+                const branch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
+                const match = branch.match(/issue-(\d+)/);
+                const detectedIssue = match ? parseInt(match[1]) : undefined;
+
+                let detectedTitle = '';
+                if (detectedIssue) {
+                    process.stdout.write(dim(`  🔍 Detected Issue #${detectedIssue} from branch... `));
+                    try {
+                        const { data: issueData } = await getOctokit().issues.get({
+                            owner: getOwner(),
+                            repo: getRepo(),
+                            issue_number: detectedIssue,
+                        });
+                        detectedTitle = issueData.title;
+                        console.log(cyan(`${detectedTitle}`));
+                    } catch { console.log(dim(' (could not fetch title)')); }
+                }
+
+                const { confirm } = await ask([
+                    {
+                        type: 'list',
+                        name: 'confirm',
+                        message: yellow('🚀 Ready to submit?'),
+                        choices: [
+                            { name: `✅ Yes, use automated metadata`, value: 'yes' },
+                            { name: `✍️  Edit title/message manually`, value: 'edit' },
+                            { name: `⬅  Back`, value: 'back' }
+                        ]
+                    }
                 ]);
-                await contribute.submitPR({
-                    title,
-                    message: message || title,
-                    issue: issue ? parseInt(issue) : undefined
-                });
+
+                if (confirm === 'back') return;
+
+                let submissionOpts: any = {};
+                if (confirm === 'edit') {
+                    submissionOpts = await ask([
+                        { type: 'input', name: 'title', message: 'PR Title:', default: detectedTitle ? `fix: ${detectedTitle}` : '' },
+                        { type: 'input', name: 'message', message: 'Commit Message:', default: detectedTitle ? `fix: ${detectedTitle} (#${detectedIssue})` : '' },
+                        { type: 'input', name: 'issue', message: 'Issue #:', default: detectedIssue ? detectedIssue.toString() : '' }
+                    ]);
+                    if (submissionOpts.issue) submissionOpts.issue = parseInt(submissionOpts.issue);
+                }
+
+                await contribute.submitPR(submissionOpts);
             }
         }
     }
@@ -393,11 +427,10 @@ async function issueMenu() {
     } else if (action === 'bulk') {
         const a = await ask([
             { type: 'input', name: 'file', message: yellow('📁 Path to issues file (JSON or MD)') + dim(' (q=back):') },
-            { type: 'confirm', name: 'dryRun', message: 'Dry run first?', default: true },
             { type: 'number', name: 'start', message: dim('Start index:'), default: 1 },
             { type: 'number', name: 'end', message: dim('End index:'), default: 999 },
         ]);
-        await issues.createIssuesFromFile(a.file, { dryRun: a.dryRun, start: a.start, end: a.end });
+        await issues.createIssuesFromFile(a.file, { start: a.start, end: a.end });
     } else if (action === 'assign-best') {
         const spinner = createSpinner(dim('Finding issues with applicants...')).start();
         const octokit = getOctokit();
@@ -785,8 +818,8 @@ function setupCommander(): Command {
         .option('-i, --issue <n>', 'Issue number')
         .action(async (o) => {
             await contribute.submitPR({
-                title: o.title || 'Automated PR',
-                message: o.message || o.title,
+                title: o.title,
+                message: o.message,
                 issue: o.issue ? parseInt(o.issue) : undefined
             });
         });

package/src/commands/contribute.ts

@@ -100,9 +100,24 @@ export async function forkAndClone(target: string) {
             // Ensure upstream remote exists
             try { execSync(`git remote add upstream https://github.com/${owner}/${repo}.git`, { stdio: 'pipe' }); } catch { /* exists */ }
 
+            // 1. Detect default branch
+            let defaultBranch = 'main';
+            try {
+                execSync('git rev-parse upstream/main', { stdio: 'pipe' });
+            } catch {
+                defaultBranch = 'master';
+            }
+
+            // 2. Checkout default branch before syncing
+            try {
+                execSync(`git checkout ${defaultBranch}`, { stdio: 'pipe' });
+            } catch {
+                // If it fails, maybe it's not even a valid default branch locally, but we'll try to sync anyway
+            }
+
             await syncBranch();
 
-            // Create or switch to issue branch
+            // 3. Create or switch to issue branch
             const branchName = issue ? `fix/issue-${issue}` : null;
             if (branchName) {
                 try {
@@ -253,9 +268,36 @@ export async function submitPR(opts: { title: string, body?: string, issue?: num
         const repo = getRepo();
         const branch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
 
+        // Auto-infer issue from branch name (e.g. fix/issue-303)
+        let linkedIssue = opts.issue;
+        if (!linkedIssue) {
+            const match = branch.match(/issue-(\d+)/);
+            if (match) linkedIssue = parseInt(match[1]);
+        }
+
+        const octokit = getOctokit();
+
+        // 2. Fetch Issue Details for better PR Metadata
+        let issueTitle = '';
+        if (linkedIssue) {
+            spinner.text = `Fetching details for issue #${linkedIssue}...`;
+            try {
+                const { data: issueData } = await octokit.issues.get({
+                    owner,
+                    repo,
+                    issue_number: linkedIssue,
+                });
+                issueTitle = issueData.title;
+            } catch (e) {
+                // Silently fallback if issue doesn't exist or no access
+            }
+        }
+
+        const prTitle = opts.title || (issueTitle ? `fix: ${issueTitle} (#${linkedIssue})` : 'Automated contribution via GitPadi');
+        const commitMsg = opts.message || prTitle;
+
         // 1. Stage and Commit
         spinner.text = 'Staging and committing changes...';
-        const commitMsg = opts.message || opts.title || 'Automated contribution via GitPadi';
 
         try {
             execSync('git add .', { stdio: 'pipe' });
@@ -269,26 +311,27 @@ export async function submitPR(opts: { title: string, body?: string, issue?: num
             dim('  (Note: No new changes to commit or commit failed)');
         }
 
-        // Auto-infer issue from branch name (e.g. fix/issue-303)
-        let linkedIssue = opts.issue;
-        if (!linkedIssue) {
-            const match = branch.match(/issue-(\d+)/);
-            if (match) linkedIssue = parseInt(match[1]);
-        }
-
         spinner.text = 'Pushing to your fork...';
         execSync(`git push origin ${branch}`, { stdio: 'pipe' });
 
         spinner.text = 'Creating Pull Request...';
         const body = opts.body || (linkedIssue ? `Fixes #${linkedIssue}` : 'Automated PR via GitPadi');
 
-        const { data: pr } = await getOctokit().pulls.create({
+        // Detect base branch
+        let baseBranch = 'main';
+        try {
+            execSync('git rev-parse origin/main', { stdio: 'pipe' });
+        } catch {
+            baseBranch = 'master';
+        }
+
+        const { data: pr } = await octokit.pulls.create({
             owner,
             repo,
-            title: opts.title,
+            title: prTitle,
             body,
             head: `${await getAuthenticatedUser()}:${branch}`,
-            base: 'main',
+            base: baseBranch,
         });
 
         spinner.succeed(`PR Created: ${green(pr.html_url)}`);

package/src/commands/issues.ts

@@ -14,18 +14,34 @@ export async function listIssues(opts: { state?: string; labels?: string; limit?
     const spinner = ora(`Fetching issues from ${chalk.cyan(getFullRepo())}...`).start();
 
     try {
-        const { data: issues } = await octokit.issues.listForRepo({
-            owner: getOwner(), repo: getRepo(),
-            state: (opts.state as 'open' | 'closed' | 'all') || 'open',
-            labels: opts.labels || undefined,
-            per_page: opts.limit || 50,
-        });
+        const requestedLimit = opts.limit || 50;
+        const realIssues: any[] = [];
+        let page = 1;
+
+        // Fetch until we have enough real issues or run out of pages
+        while (realIssues.length < requestedLimit) {
+            const { data: issues } = await octokit.issues.listForRepo({
+                owner: getOwner(), repo: getRepo(),
+                state: (opts.state as 'open' | 'closed' | 'all') || 'open',
+                labels: opts.labels || undefined,
+                per_page: 100, // Fetch max per page to be efficient
+                page: page++,
+            });
+
+            if (issues.length === 0) break;
+
+            const batch = issues.filter((i) => !i.pull_request);
+            realIssues.push(...batch);
+
+            if (issues.length < 100) break; // Last page
+        }
+
+        // Clip to requested limit
+        const finalIssues = realIssues.slice(0, requestedLimit);
 
-        // Filter out PRs (GitHub API returns PRs in issues endpoint)
-        const realIssues = issues.filter((i) => !i.pull_request);
         spinner.stop();
 
-        if (realIssues.length === 0) {
+        if (finalIssues.length === 0) {
             console.log(chalk.yellow('\n  No issues found.\n'));
             return;
         }
@@ -35,14 +51,14 @@ export async function listIssues(opts: { state?: string; labels?: string; limit?
             style: { head: [], border: [] },
         });
 
-        realIssues.forEach((i) => {
-            const labels = i.labels.map((l) => typeof l === 'string' ? l : l.name || '').join(', ');
+        finalIssues.forEach((i) => {
+            const labels = i.labels.map((l: any) => typeof l === 'string' ? l : l.name || '').join(', ');
             const assignee = i.assignee?.login || chalk.dim('unassigned');
             const state = i.state === 'open' ? chalk.green('open') : chalk.red('closed');
             table.push([`#${i.number}`, i.title.substring(0, 60), labels.substring(0, 30), assignee, state]);
         });
 
-        console.log(`\n${chalk.bold(`📋 Issues — ${getFullRepo()}`)} (${realIssues.length})\n`);
+        console.log(`\n${chalk.bold(`📋 Issues — ${getFullRepo()}`)} (${finalIssues.length})\n`);
         console.log(table.toString());
         console.log('');
     } catch (e: any) {
@@ -153,16 +169,25 @@ export async function createIssuesFromFile(filePath: string, opts: { dryRun?: bo
     console.log(`\n${chalk.bold('📋 GitPadi Issue Creator')}`);
     console.log(chalk.dim(`  Repo:   ${getFullRepo()}`));
     console.log(chalk.dim(`  File:   ${filePath} (${detectedFormat})`));
-    console.log(chalk.dim(`  Range:  #${start}-#${end} (${filtered.length} issues)`));
-    console.log(chalk.dim(`  Mode:   ${opts.dryRun ? 'DRY RUN' : 'LIVE'}\n`));
-
-    if (opts.dryRun) {
-        filtered.forEach((i: any) => {
-            console.log(`  ${chalk.dim(`#${String(i.number).padStart(2, '0')}`)}  ${i.title}`);
-            console.log(chalk.dim(`       [${(i.labels || []).join(', ')}]`));
-            if (i.body) console.log(chalk.dim(`       ${i.body.substring(0, 80)}...`));
-        });
-        console.log(chalk.green(`\n✅ Dry run: ${filtered.length} issues would be created.\n`));
+    console.log(chalk.dim(`  Found:  ${filtered.length} issues\n`));
+
+    // Always preview first
+    filtered.forEach((i: any) => {
+        console.log(`  ${chalk.dim(`#${String(i.number).padStart(2, '0')}`)}  ${i.title}`);
+        console.log(chalk.dim(`       [${(i.labels || []).join(', ')}]`));
+    });
+
+    // Ask for confirmation
+    const inquirer = (await import('inquirer')).default;
+    const { proceed } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'proceed',
+        message: chalk.yellow(`Create these ${filtered.length} issues on GitHub?`),
+        default: true,
+    }]);
+
+    if (!proceed) {
+        console.log(chalk.dim('\n  Cancelled.\n'));
         return;
     }