pullwise 0.1.0__tar.gz → 0.3.0__tar.gz

{pullwise-0.1.0 → pullwise-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pullwise
-Version: 0.1.0
+Version: 0.3.0
 Summary: AI-powered PR descriptions, labels, and code review using OpenAI
 License: MIT
 Project-URL: Homepage, https://github.com/albertusreza/pr-pilot
@@ -10,7 +10,6 @@ Keywords: github,pull-request,openai,ai,automation,devtools,cli,github-actions
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Software Development :: Version Control :: Git
 Requires-Python: >=3.9
@@ -19,10 +18,17 @@ Requires-Dist: openai>=1.0.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 
-# pr-pilot ✈️
+# PullWise ✈️
+
+[![PyPI](https://img.shields.io/pypi/v/pullwise)](https://pypi.org/project/pullwise/)
+[![Downloads](https://img.shields.io/pypi/dm/pullwise)](https://pypi.org/project/pullwise/)
+[![CI](https://github.com/albertusreza/pr-pilot/actions/workflows/ci.yml/badge.svg)](https://github.com/albertusreza/pr-pilot/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 **Stop writing PR descriptions.** Let AI do it.
 
+> 📦 GitHub Action: [`albertusreza/pr-pilot`](https://github.com/marketplace/actions/pullwise) · PyPI: [`pullwise`](https://pypi.org/project/pullwise/)
+
 `pr-pilot` is a GitHub Action + CLI that analyzes your diff and commit history, then automatically writes a clear, structured PR description — with a summary, change list, test plan, and labels.
 
 ```yaml
@@ -87,7 +93,7 @@ Add `OPENAI_API_KEY` to your repo secrets and you're done. Works with any langua
 ### As a CLI
 
 ```bash
-pip install pr-pilot
+pip install pullwise
 export OPENAI_API_KEY=sk-...
 
 # Generate a description for your current branch
@@ -103,6 +109,73 @@ pr-pilot review
 pr-pilot describe --markdown pr_description.md
 ```
 
+## Features
+
+| Command | What it does |
+|---|---|
+| `pr-pilot describe` | Generate a structured PR description from your diff |
+| `pr-pilot review` | Get a senior-engineer-style code review in the terminal |
+| `pr-pilot comment` | Post an AI review as a GitHub PR comment (updates on re-run, no spam) |
+| `pr-pilot changelog` | Generate a `CHANGELOG.md` entry from commits since last tag |
+| `pr-pilot reviewers` | Suggest reviewers based on git blame of changed files |
+| `pr-pilot standup` | Generate a daily standup update from your recent commits |
+| `pr-pilot todos` | Scan for TODO/FIXME comments and create GitHub issues from them |
+
+## Usage
+
+```bash
+# Generate PR description (terminal)
+pr-pilot describe --base main
+
+# Get a quick code review in the terminal
+pr-pilot review --base main
+
+# Post review as a GitHub PR comment
+pr-pilot comment --repo owner/repo --pr 42
+
+# Generate CHANGELOG entry (print to stdout)
+pr-pilot changelog
+
+# Write directly into CHANGELOG.md
+pr-pilot changelog --output CHANGELOG.md
+```
+
+```bash
+# Suggest reviewers for your current branch
+pr-pilot reviewers --base main
+
+# Post suggestion as a comment + assign on GitHub
+pr-pilot reviewers --post --assign --repo owner/repo --pr 42
+
+# Generate a standup from yesterday's commits
+pr-pilot standup
+
+# Generate from the last 3 days and copy to clipboard
+pr-pilot standup --days 3 --copy
+
+# Scan for TODO/FIXME and preview issues
+pr-pilot todos
+
+# Actually create GitHub issues from them
+pr-pilot todos --create --repo owner/repo
+```
+
+### Auto-comment on every PR (GitHub Action)
+
+```yaml
+# .github/workflows/pr-review.yml
+- uses: actions/checkout@v4
+  with:
+    fetch-depth: 0
+- run: pip install pullwise
+- run: pr-pilot comment --repo ${{ github.repository }} --pr ${{ github.event.pull_request.number }}
+  env:
+    OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+    GITHUB_TOKEN: ${{ github.token }}
+```
+
+The comment updates itself on every new push — no duplicate comments.
+
 ## Options
 
 | Input | Default | Description |

{pullwise-0.1.0 → pullwise-0.3.0}/README.md

@@ -1,7 +1,14 @@
-# pr-pilot ✈️
+# PullWise ✈️
+
+[![PyPI](https://img.shields.io/pypi/v/pullwise)](https://pypi.org/project/pullwise/)
+[![Downloads](https://img.shields.io/pypi/dm/pullwise)](https://pypi.org/project/pullwise/)
+[![CI](https://github.com/albertusreza/pr-pilot/actions/workflows/ci.yml/badge.svg)](https://github.com/albertusreza/pr-pilot/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 **Stop writing PR descriptions.** Let AI do it.
 
+> 📦 GitHub Action: [`albertusreza/pr-pilot`](https://github.com/marketplace/actions/pullwise) · PyPI: [`pullwise`](https://pypi.org/project/pullwise/)
+
 `pr-pilot` is a GitHub Action + CLI that analyzes your diff and commit history, then automatically writes a clear, structured PR description — with a summary, change list, test plan, and labels.
 
 ```yaml
@@ -66,7 +73,7 @@ Add `OPENAI_API_KEY` to your repo secrets and you're done. Works with any langua
 ### As a CLI
 
 ```bash
-pip install pr-pilot
+pip install pullwise
 export OPENAI_API_KEY=sk-...
 
 # Generate a description for your current branch
@@ -82,6 +89,73 @@ pr-pilot review
 pr-pilot describe --markdown pr_description.md
 ```
 
+## Features
+
+| Command | What it does |
+|---|---|
+| `pr-pilot describe` | Generate a structured PR description from your diff |
+| `pr-pilot review` | Get a senior-engineer-style code review in the terminal |
+| `pr-pilot comment` | Post an AI review as a GitHub PR comment (updates on re-run, no spam) |
+| `pr-pilot changelog` | Generate a `CHANGELOG.md` entry from commits since last tag |
+| `pr-pilot reviewers` | Suggest reviewers based on git blame of changed files |
+| `pr-pilot standup` | Generate a daily standup update from your recent commits |
+| `pr-pilot todos` | Scan for TODO/FIXME comments and create GitHub issues from them |
+
+## Usage
+
+```bash
+# Generate PR description (terminal)
+pr-pilot describe --base main
+
+# Get a quick code review in the terminal
+pr-pilot review --base main
+
+# Post review as a GitHub PR comment
+pr-pilot comment --repo owner/repo --pr 42
+
+# Generate CHANGELOG entry (print to stdout)
+pr-pilot changelog
+
+# Write directly into CHANGELOG.md
+pr-pilot changelog --output CHANGELOG.md
+```
+
+```bash
+# Suggest reviewers for your current branch
+pr-pilot reviewers --base main
+
+# Post suggestion as a comment + assign on GitHub
+pr-pilot reviewers --post --assign --repo owner/repo --pr 42
+
+# Generate a standup from yesterday's commits
+pr-pilot standup
+
+# Generate from the last 3 days and copy to clipboard
+pr-pilot standup --days 3 --copy
+
+# Scan for TODO/FIXME and preview issues
+pr-pilot todos
+
+# Actually create GitHub issues from them
+pr-pilot todos --create --repo owner/repo
+```
+
+### Auto-comment on every PR (GitHub Action)
+
+```yaml
+# .github/workflows/pr-review.yml
+- uses: actions/checkout@v4
+  with:
+    fetch-depth: 0
+- run: pip install pullwise
+- run: pr-pilot comment --repo ${{ github.repository }} --pr ${{ github.event.pull_request.number }}
+  env:
+    OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+    GITHUB_TOKEN: ${{ github.token }}
+```
+
+The comment updates itself on every new push — no duplicate comments.
+
 ## Options
 
 | Input | Default | Description |

pullwise-0.3.0/pr_pilot/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.3.0"

pullwise-0.3.0/pr_pilot/analyzer.py

@@ -0,0 +1,392 @@
+from __future__ import annotations
+import json
+import subprocess
+from dataclasses import dataclass, field
+
+from openai import OpenAI
+
+from .templates import (
+    DESCRIBE_SYSTEM, DESCRIBE_USER, LABEL_SYSTEM, REVIEW_SYSTEM,
+    CHANGELOG_SYSTEM, CHANGELOG_USER, REVIEW_COMMENT_HEADER, REVIEW_COMMENT_TEMPLATE,
+    REVIEWER_SYSTEM, REVIEWER_USER, REVIEWER_COMMENT_HEADER, REVIEWER_COMMENT_TEMPLATE,
+    STANDUP_SYSTEM, STANDUP_USER,
+    ISSUE_SYSTEM, ISSUE_USER,
+)
+
+_MAX_DIFF_CHARS = 24_000   # stay well within context limits
+_MODEL = "gpt-4o"
+
+
+@dataclass
+class PRDescription:
+    title: str
+    summary: str
+    changes: list[str]
+    breaking: bool
+    breaking_notes: str | None
+    test_plan: str
+    labels: list[str]
+
+    def to_markdown(self) -> str:
+        lines = [
+            f"## Summary\n{self.summary}\n",
+            "## Changes",
+        ]
+        for c in self.changes:
+            lines.append(f"- {c}")
+        if self.breaking:
+            lines.append(f"\n## ⚠️ Breaking Changes\n{self.breaking_notes}")
+        lines.append(f"\n## Test Plan\n{self.test_plan}")
+        return "\n".join(lines)
+
+
+def _git(*args: str) -> str:
+    result = subprocess.run(["git"] + list(args), capture_output=True, text=True)
+    return result.stdout.strip()
+
+
+def get_diff(base: str = "main") -> str:
+    diff = _git("diff", f"{base}...HEAD")
+    if len(diff) > _MAX_DIFF_CHARS:
+        diff = diff[:_MAX_DIFF_CHARS] + "\n\n[diff truncated — showing first 24k chars]"
+    return diff
+
+
+def get_commits(base: str = "main") -> str:
+    return _git("log", f"{base}...HEAD", "--oneline", "--no-merges")
+
+
+def get_branch() -> str:
+    return _git("rev-parse", "--abbrev-ref", "HEAD")
+
+
+def describe_pr(api_key: str, base: str = "main", model: str = _MODEL) -> PRDescription:
+    client = OpenAI(api_key=api_key)
+    diff = get_diff(base)
+    commits = get_commits(base)
+    branch = get_branch()
+
+    if not diff and not commits:
+        raise ValueError(f"No changes found between '{branch}' and '{base}'")
+
+    user_msg = DESCRIBE_USER.format(
+        branch=branch, base=base, commits=commits or "(none)", diff=diff or "(empty)"
+    )
+    resp = client.chat.completions.create(
+        model=model,
+        max_tokens=1024,
+        messages=[
+            {"role": "system", "content": DESCRIBE_SYSTEM},
+            {"role": "user", "content": user_msg},
+        ],
+    )
+    raw = resp.choices[0].message.content or "{}"
+    raw = raw.strip()
+    if raw.startswith("```"):
+        raw = "\n".join(raw.splitlines()[1:])
+    if raw.endswith("```"):
+        raw = "\n".join(raw.splitlines()[:-1])
+
+    data = json.loads(raw.strip())
+    return PRDescription(
+        title=data.get("title", branch),
+        summary=data.get("summary", ""),
+        changes=data.get("changes", []),
+        breaking=data.get("breaking", False),
+        breaking_notes=data.get("breaking_notes"),
+        test_plan=data.get("test_plan", ""),
+        labels=data.get("labels", ["feature"]),
+    )
+
+
+def suggest_labels(api_key: str, title: str, body: str, model: str = _MODEL) -> list[str]:
+    client = OpenAI(api_key=api_key)
+    resp = client.chat.completions.create(
+        model=model,
+        max_tokens=64,
+        messages=[
+            {"role": "system", "content": LABEL_SYSTEM},
+            {"role": "user", "content": f"Title: {title}\n\nBody: {body[:2000]}"},
+        ],
+    )
+    raw = resp.choices[0].message.content or "[]"
+    return json.loads(raw.strip())
+
+
+def review_pr(api_key: str, base: str = "main", model: str = _MODEL) -> str:
+    client = OpenAI(api_key=api_key)
+    diff = get_diff(base)
+    if not diff:
+        return "No changes to review."
+    resp = client.chat.completions.create(
+        model=model,
+        max_tokens=1024,
+        messages=[
+            {"role": "system", "content": REVIEW_SYSTEM},
+            {"role": "user", "content": f"Diff:\n\n{diff}"},
+        ],
+    )
+    return (resp.choices[0].message.content or "").strip()
+
+
+def review_pr_as_comment(api_key: str, base: str = "main", model: str = _MODEL) -> str:
+    """Return a GitHub-flavoured markdown comment with the AI review."""
+    body = review_pr(api_key, base=base, model=model)
+    return REVIEW_COMMENT_TEMPLATE.format(header=REVIEW_COMMENT_HEADER, body=body)
+
+
+# ── Changelog ────────────────────────────────────────────────────────────────
+
+@dataclass
+class ChangelogEntry:
+    version_bump: str        # "patch" | "minor" | "major"
+    highlights: str
+    added: list[str]
+    changed: list[str]
+    fixed: list[str]
+    removed: list[str]
+    security: list[str]
+
+    def to_markdown(self, new_version: str, date: str) -> str:
+        lines = [f"## [{new_version}] - {date}", f"\n_{self.highlights}_\n"]
+        sections = [
+            ("Added", self.added),
+            ("Changed", self.changed),
+            ("Fixed", self.fixed),
+            ("Removed", self.removed),
+            ("Security", self.security),
+        ]
+        for title, items in sections:
+            if items:
+                lines.append(f"\n### {title}")
+                for item in items:
+                    lines.append(f"- {item}")
+        return "\n".join(lines)
+
+
+def _get_current_version() -> str:
+    """Read version from pyproject.toml, setup.cfg, or package __init__."""
+    try:
+        tag = _git("describe", "--tags", "--abbrev=0")
+        return tag.lstrip("v") if tag else "0.0.0"
+    except Exception:
+        return "0.0.0"
+
+
+def _get_commits_since_tag() -> str:
+    tag = _git("describe", "--tags", "--abbrev=0")
+    if tag:
+        return _git("log", f"{tag}...HEAD", "--oneline", "--no-merges")
+    return _git("log", "--oneline", "--no-merges", "-30")
+
+
+def _bump_version(current: str, bump: str) -> str:
+    parts = current.split(".")
+    try:
+        major, minor, patch = int(parts[0]), int(parts[1]), int(parts[2].split("-")[0])
+    except (IndexError, ValueError):
+        return "0.1.0"
+    if bump == "major":
+        return f"{major + 1}.0.0"
+    if bump == "minor":
+        return f"{major}.{minor + 1}.0"
+    return f"{major}.{minor}.{patch + 1}"
+
+
+def generate_changelog(api_key: str, model: str = _MODEL) -> tuple[ChangelogEntry, str]:
+    """Return (ChangelogEntry, new_version_string)."""
+    import datetime
+    client = OpenAI(api_key=api_key)
+    current = _get_current_version()
+    commits = _get_commits_since_tag()
+    diff = get_diff(base="HEAD~10") if not commits else get_diff(base=f"v{current}" if current != "0.0.0" else "HEAD~10")
+
+    if not commits:
+        raise ValueError("No commits found since last tag. Nothing to changelog.")
+
+    user_msg = CHANGELOG_USER.format(
+        current_version=current, commits=commits, diff=diff[:12_000] or "(empty)"
+    )
+    resp = client.chat.completions.create(
+        model=model,
+        max_tokens=1024,
+        messages=[
+            {"role": "system", "content": CHANGELOG_SYSTEM},
+            {"role": "user", "content": user_msg},
+        ],
+    )
+    raw = (resp.choices[0].message.content or "{}").strip()
+    if raw.startswith("```"):
+        raw = "\n".join(raw.splitlines()[1:])
+    if raw.endswith("```"):
+        raw = "\n".join(raw.splitlines()[:-1])
+
+    data = json.loads(raw.strip())
+    entry = ChangelogEntry(
+        version_bump=data.get("version", "patch"),
+        highlights=data.get("highlights", ""),
+        added=data.get("added", []),
+        changed=data.get("changed", []),
+        fixed=data.get("fixed", []),
+        removed=data.get("removed", []),
+        security=data.get("security", []),
+    )
+    new_version = _bump_version(current, entry.version_bump)
+    return entry, new_version
+
+
+# ── Reviewer suggester ────────────────────────────────────────────────────────
+
+@dataclass
+class ReviewerSuggestion:
+    reviewers: list[str]
+    reasoning: str
+
+    def to_comment(self) -> str:
+        rows = "\n".join(f"| @{r} | {self.reasoning} |" for r in self.reviewers)
+        return REVIEWER_COMMENT_TEMPLATE.format(
+            header=REVIEWER_COMMENT_HEADER,
+            reasoning=self.reasoning,
+            rows=rows,
+        )
+
+
+def _get_blame_summary(base: str = "main") -> tuple[str, str]:
+    """Return (author, blame_summary) for files changed vs base."""
+    author = _git("config", "user.name") or "unknown"
+    changed_files = _git("diff", f"{base}...HEAD", "--name-only").splitlines()
+    lines = []
+    for f in changed_files[:15]:  # cap at 15 files
+        blame = _git("log", "--follow", "--format=%an", "-5", "--", f)
+        authors = ", ".join(dict.fromkeys(blame.splitlines()))  # unique, ordered
+        lines.append(f"  {f}: {authors or 'no history'}")
+    return author, "\n".join(lines)
+
+
+def suggest_reviewers(api_key: str, base: str = "main", model: str = _MODEL) -> ReviewerSuggestion:
+    client = OpenAI(api_key=api_key)
+    author, blame_summary = _get_blame_summary(base)
+    if not blame_summary:
+        raise ValueError("No changed files found — nothing to base reviewer suggestion on.")
+    resp = client.chat.completions.create(
+        model=model,
+        max_tokens=256,
+        messages=[
+            {"role": "system", "content": REVIEWER_SYSTEM},
+            {"role": "user", "content": REVIEWER_USER.format(author=author, blame_summary=blame_summary)},
+        ],
+    )
+    raw = (resp.choices[0].message.content or "{}").strip()
+    if raw.startswith("```"):
+        raw = "\n".join(raw.splitlines()[1:])
+    if raw.endswith("```"):
+        raw = "\n".join(raw.splitlines()[:-1])
+    data = json.loads(raw.strip())
+    return ReviewerSuggestion(
+        reviewers=data.get("reviewers", []),
+        reasoning=data.get("reasoning", ""),
+    )
+
+
+# ── Standup generator ─────────────────────────────────────────────────────────
+
+def generate_standup(api_key: str, days: int = 1, model: str = _MODEL) -> str:
+    client = OpenAI(api_key=api_key)
+    author = _git("config", "user.name") or "developer"
+    since = f"{days} day ago" if days == 1 else f"{days} days ago"
+    commits = _git("log", f"--since={since}", "--oneline", "--no-merges",
+                   f"--author={author}")
+    if not commits:
+        commits = _git("log", "--oneline", "--no-merges", "-10")
+    if not commits:
+        return "No recent commits found."
+    resp = client.chat.completions.create(
+        model=model,
+        max_tokens=256,
+        messages=[
+            {"role": "system", "content": STANDUP_SYSTEM},
+            {"role": "user", "content": STANDUP_USER.format(
+                author=author, days=days, commits=commits
+            )},
+        ],
+    )
+    return (resp.choices[0].message.content or "").strip()
+
+
+# ── Issue creator (TODO/FIXME scanner) ───────────────────────────────────────
+
+@dataclass
+class TodoIssue:
+    file_path: str
+    line_number: int
+    comment: str
+    title: str
+    body: str
+    labels: list[str]
+
+
+def _scan_todos(root: str = ".") -> list[tuple[str, int, str, str]]:
+    """Return list of (file, lineno, comment_text, context) for TODO/FIXME."""
+    import re
+    from pathlib import Path
+    pattern = re.compile(r'(TODO|FIXME|HACK|XXX)\s*:?\s*(.+)', re.IGNORECASE)
+    skip = {'.git', 'node_modules', '__pycache__', '.venv', 'venv', 'dist', 'build'}
+    results = []
+    for path in Path(root).rglob('*'):
+        if any(p in skip for p in path.parts):
+            continue
+        if not path.is_file():
+            continue
+        suffix = path.suffix.lower()
+        if suffix not in {'.py', '.js', '.ts', '.tsx', '.jsx', '.go', '.rb', '.java', '.md'}:
+            continue
+        try:
+            lines = path.read_text(errors='replace').splitlines()
+        except Exception:
+            continue
+        for i, line in enumerate(lines, 1):
+            m = pattern.search(line)
+            if m:
+                start = max(0, i - 3)
+                end = min(len(lines), i + 3)
+                context = '\n'.join(lines[start:end])
+                results.append((str(path), i, m.group(0).strip(), context))
+    return results
+
+
+def create_issues_from_todos(
+    api_key: str, root: str = ".", model: str = _MODEL
+) -> list[TodoIssue]:
+    client = OpenAI(api_key=api_key)
+    todos = _scan_todos(root)
+    issues = []
+    for file_path, line_number, comment, context in todos:
+        resp = client.chat.completions.create(
+            model=model,
+            max_tokens=512,
+            messages=[
+                {"role": "system", "content": ISSUE_SYSTEM},
+                {"role": "user", "content": ISSUE_USER.format(
+                    file_path=file_path, line_number=line_number,
+                    comment=comment, context=context,
+                )},
+            ],
+        )
+        raw = (resp.choices[0].message.content or "{}").strip()
+        if raw.startswith("```"):
+            raw = "\n".join(raw.splitlines()[1:])
+        if raw.endswith("```"):
+            raw = "\n".join(raw.splitlines()[:-1])
+        try:
+            data = json.loads(raw.strip())
+        except json.JSONDecodeError:
+            continue
+        issues.append(TodoIssue(
+            file_path=file_path,
+            line_number=line_number,
+            comment=comment,
+            title=data.get("title", comment[:72]),
+            body=data.get("body", ""),
+            labels=data.get("labels", ["technical-debt"]),
+        ))
+    return issues