gitpadi 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Netwalls
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,266 @@
+<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>
+
+---
+
+## ⚡ Two Ways to Use GitPadi
+
+| 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 |
+
+---
+
+## 🖥️ Use the CLI
+
+**No installation needed.** Run directly with `npx`:
+
+```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
+```
+
+Or use **direct commands**:
+
+```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
+```
+
+### All CLI Commands
+
+<details>
+<summary><b>📋 Issues</b></summary>
+
+```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
+```
+</details>
+
+<details>
+<summary><b>🔀 Pull Requests</b></summary>
+
+```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
+```
+</details>
+
+<details>
+<summary><b>📦 Repositories</b></summary>
+
+```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
+```
+</details>
+
+<details>
+<summary><b>🏆 Contributors</b></summary>
+
+```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>
+
+```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
+```
+</details>
+
+### Or install globally:
+
+```bash
+npm install -g gitpadi
+gitpadi issues list
+```
+
+---
+
+## 🔧 Use as GitHub Action
+
+Just add a workflow file — no setup, no tokens to manage.
+
+### 🏆 Auto-Score Contributors
+
+```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
+```
+
+### 🔍 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
+```
+
+---
+
+## 📄 License
+
+MIT — Built by [Netwalls](https://github.com/Netwalls)

package/action.yml

@@ -0,0 +1,92 @@
+name: 'Contributor Agent'
+description: 'GitHub Action that auto-creates issues from a data file, reviews PRs, and scores applicants with a ranking algorithm'
+author: 'Netwalls'
+branding:
+  icon: 'users'
+  color: 'purple'
+
+inputs:
+  action:
+    description: 'Which action to run: create-issues, review-pr, or score-applicant'
+    required: true
+  github-token:
+    description: 'GitHub token with repo/issues permissions'
+    required: true
+    default: ${{ github.token }}
+  notify-user:
+    description: 'GitHub username to @mention on applicant reviews'
+    required: false
+    default: ''
+  issues-file:
+    description: 'Path to JSON file containing issues to create (for create-issues action)'
+    required: false
+    default: ''
+  dry-run:
+    description: 'Preview without creating (for create-issues action)'
+    required: false
+    default: 'false'
+  start:
+    description: 'Start index for issue creation range'
+    required: false
+    default: '1'
+  end:
+    description: 'End index for issue creation range'
+    required: false
+    default: '999'
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+
+    - name: Install dependencies
+      shell: bash
+      run: |
+        cd ${{ github.action_path }}
+        npm ci --production 2>/dev/null || npm install --production
+
+    - name: Run agent
+      shell: bash
+      env:
+        GITHUB_TOKEN: ${{ inputs.github-token }}
+        GITHUB_OWNER: ${{ github.repository_owner }}
+        GITHUB_REPO: ${{ github.event.repository.name }}
+        INPUT_ACTION: ${{ inputs.action }}
+        NOTIFY_USER: ${{ inputs.notify-user }}
+        ISSUES_FILE: ${{ inputs.issues-file }}
+        DRY_RUN: ${{ inputs.dry-run }}
+        ISSUE_START: ${{ inputs.start }}
+        ISSUE_END: ${{ inputs.end }}
+        PR_NUMBER: ${{ github.event.pull_request.number }}
+        ISSUE_NUMBER: ${{ github.event.issue.number }}
+        COMMENT_ID: ${{ github.event.comment.id }}
+      run: |
+        cd ${{ github.action_path }}
+
+        case "$INPUT_ACTION" in
+          create-issues)
+            ARGS=""
+            if [ "$DRY_RUN" = "true" ]; then ARGS="$ARGS --dry-run"; fi
+            if [ "$ISSUE_START" != "1" ] || [ "$ISSUE_END" != "999" ]; then
+              ARGS="$ARGS --start $ISSUE_START --end $ISSUE_END"
+            fi
+            if [ -n "$ISSUES_FILE" ]; then
+              ARGS="$ARGS --file $ISSUES_FILE"
+            fi
+            npx tsx src/create-issues.ts $ARGS
+            ;;
+          review-pr)
+            npx tsx src/pr-review.ts
+            ;;
+          score-applicant)
+            npx tsx src/applicant-scorer.ts
+            ;;
+          *)
+            echo "❌ Unknown action: $INPUT_ACTION"
+            echo "   Valid actions: create-issues, review-pr, score-applicant"
+            exit 1
+            ;;
+        esac

package/examples/applicant-scorer.yml

@@ -0,0 +1,30 @@
+# Auto-score contributors who apply for issues
+name: Applicant Scorer
+
+on:
+  issue_comment:
+    types: [created]
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: read
+
+jobs:
+  score:
+    # Only run on issue comments (not PR), skip bot comments
+    if: >
+      !github.event.issue.pull_request &&
+      github.event.comment.user.login != 'github-actions[bot]'
+    runs-on: ubuntu-latest
+    name: 🤖 Score Applicant
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Score Applicant
+        uses: Netwalls/contributor-agent@v1
+        with:
+          action: score-applicant
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          notify-user: 'your-github-username'  # change this!

package/examples/create-issues.yml

@@ -0,0 +1,42 @@
+# Batch create GitHub issues from a JSON file
+name: Create Issues
+
+on:
+  workflow_dispatch:
+    inputs:
+      issues-file:
+        description: 'Path to your issues JSON file'
+        required: true
+        default: 'issues.json'
+      dry-run:
+        description: 'Preview without creating (true/false)'
+        required: false
+        default: 'true'
+      start:
+        description: 'Start issue number'
+        required: false
+        default: '1'
+      end:
+        description: 'End issue number'
+        required: false
+        default: '999'
+
+permissions:
+  issues: write
+
+jobs:
+  create-issues:
+    runs-on: ubuntu-latest
+    name: 📋 Create Issues
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Create Issues
+        uses: Netwalls/contributor-agent@v1
+        with:
+          action: create-issues
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          issues-file: ${{ github.event.inputs.issues-file }}
+          dry-run: ${{ github.event.inputs.dry-run }}
+          start: ${{ github.event.inputs.start }}
+          end: ${{ github.event.inputs.end }}

package/examples/issues.json

@@ -0,0 +1,48 @@
+{
+    "labels": {
+        "bug": "d73a49",
+        "feature": "0e8a16",
+        "enhancement": "a2eeef",
+        "documentation": "0075ca",
+        "good first issue": "7057ff",
+        "help wanted": "008672",
+        "priority-high": "e36209",
+        "priority-medium": "fbca04"
+    },
+    "milestones": {
+        "v1.0 - MVP": "Minimum viable product release",
+        "v2.0 - Growth": "Feature expansion and scaling"
+    },
+    "issues": [
+        {
+            "number": 1,
+            "title": "[Feature] Add user authentication",
+            "body": "## Description\nImplement user authentication with OAuth2.\n\n## Acceptance Criteria\n- [ ] Users can sign in with GitHub\n- [ ] JWT tokens are issued on login\n- [ ] Protected routes require valid tokens",
+            "labels": [
+                "feature",
+                "priority-high"
+            ],
+            "milestone": "v1.0 - MVP"
+        },
+        {
+            "number": 2,
+            "title": "[Bug] Fix login redirect loop",
+            "body": "## Description\nUsers are stuck in a redirect loop when attempting to log in.\n\n## Steps to Reproduce\n1. Go to /login\n2. Click 'Sign In'\n3. Page keeps refreshing\n\n## Expected Behavior\nUser should be redirected to dashboard after login.",
+            "labels": [
+                "bug",
+                "priority-high"
+            ],
+            "milestone": "v1.0 - MVP"
+        },
+        {
+            "number": 3,
+            "title": "[Docs] Write API documentation",
+            "body": "## Description\nCreate comprehensive API docs using OpenAPI/Swagger.\n\n## Acceptance Criteria\n- [ ] All endpoints documented\n- [ ] Request/response examples included\n- [ ] Authentication requirements noted",
+            "labels": [
+                "documentation",
+                "good first issue"
+            ],
+            "milestone": "v1.0 - MVP"
+        }
+    ]
+}

package/examples/pr-review.yml

@@ -0,0 +1,23 @@
+# Auto-review every Pull Request
+name: PR Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, edited]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    name: 🤖 Review PR
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Review PR
+        uses: Netwalls/contributor-agent@v1
+        with:
+          action: review-pr
+          github-token: ${{ secrets.GITHUB_TOKEN }}

package/package.json

@@ -0,0 +1,52 @@
+{
+    "name": "gitpadi",
+    "version": "2.0.0",
+    "description": "🤖 GitPadi — Your AI-powered GitHub management CLI. Create repos, manage issues & PRs, score contributors, and automate everything.",
+    "type": "module",
+    "bin": {
+        "gitpadi": "./src/cli.ts"
+    },
+    "files": [
+        "src/",
+        "action.yml",
+        "examples/",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "start": "tsx src/cli.ts",
+        "dev": "tsx watch src/cli.ts",
+        "create-issues": "tsx src/create-issues.ts",
+        "review-pr": "tsx src/pr-review.ts",
+        "score-applicant": "tsx src/applicant-scorer.ts"
+    },
+    "keywords": [
+        "github",
+        "cli",
+        "github-action",
+        "issue-management",
+        "pr-review",
+        "contributor-scoring",
+        "automation",
+        "gitpadi"
+    ],
+    "author": "Netwalls",
+    "license": "MIT",
+    "dependencies": {
+        "@octokit/rest": "^21.1.1",
+        "boxen": "^8.0.1",
+        "chalk": "^5.4.1",
+        "cli-table3": "^0.6.5",
+        "commander": "^13.1.0",
+        "figlet": "^1.10.0",
+        "gradient-string": "^3.0.0",
+        "inquirer": "^12.4.2",
+        "nanospinner": "^1.2.2",
+        "ora": "^8.2.0",
+        "tsx": "^4.19.2"
+    },
+    "devDependencies": {
+        "@types/node": "^22.10.5",
+        "typescript": "^5.9.3"
+    }
+}