gitpadi 2.0.1 → 2.0.3

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)