pullwise 0.3.0__tar.gz → 0.4.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pullwise
-Version: 0.3.0
+Version: 0.4.0
 Summary: AI-powered PR descriptions, labels, and code review using OpenAI
 License: MIT
 Project-URL: Homepage, https://github.com/albertusreza/pr-pilot
@@ -120,6 +120,8 @@ pr-pilot describe --markdown pr_description.md
 | `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 |
+| `pr-pilot commit` | Generate a Conventional Commit message from staged changes |
+| `pr-pilot release` | Full release: changelog + git tag + GitHub release in one command |
 
 ## Usage
 
@@ -140,6 +142,20 @@ pr-pilot changelog
 pr-pilot changelog --output CHANGELOG.md
 ```
 
+```bash
+# Generate a commit message from staged changes
+pr-pilot commit
+
+# Run git commit directly with the generated message
+pr-pilot commit --commit
+
+# Full release: bump version + write changelog + create GitHub release
+pr-pilot release --repo owner/repo
+
+# Preview release without publishing
+pr-pilot release --repo owner/repo --dry-run
+```
+
 ```bash
 # Suggest reviewers for your current branch
 pr-pilot reviewers --base main

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

@@ -100,6 +100,8 @@ pr-pilot describe --markdown pr_description.md
 | `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 |
+| `pr-pilot commit` | Generate a Conventional Commit message from staged changes |
+| `pr-pilot release` | Full release: changelog + git tag + GitHub release in one command |
 
 ## Usage
 
@@ -120,6 +122,20 @@ pr-pilot changelog
 pr-pilot changelog --output CHANGELOG.md
 ```
 
+```bash
+# Generate a commit message from staged changes
+pr-pilot commit
+
+# Run git commit directly with the generated message
+pr-pilot commit --commit
+
+# Full release: bump version + write changelog + create GitHub release
+pr-pilot release --repo owner/repo
+
+# Preview release without publishing
+pr-pilot release --repo owner/repo --dry-run
+```
+
 ```bash
 # Suggest reviewers for your current branch
 pr-pilot reviewers --base main

pullwise-0.4.0/pr_pilot/__init__.py

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

{pullwise-0.3.0 → pullwise-0.4.0}/pr_pilot/analyzer.py

@@ -11,6 +11,8 @@ from .templates import (
     REVIEWER_SYSTEM, REVIEWER_USER, REVIEWER_COMMENT_HEADER, REVIEWER_COMMENT_TEMPLATE,
     STANDUP_SYSTEM, STANDUP_USER,
     ISSUE_SYSTEM, ISSUE_USER,
+    COMMIT_SYSTEM, COMMIT_USER,
+    RELEASE_NOTES_SYSTEM, RELEASE_NOTES_USER,
 )
 
 _MAX_DIFF_CHARS = 24_000   # stay well within context limits
@@ -390,3 +392,159 @@ def create_issues_from_todos(
             labels=data.get("labels", ["technical-debt"]),
         ))
     return issues
+
+
+# ── Commit message generator ──────────────────────────────────────────────────
+
+@dataclass
+class CommitMessage:
+    subject: str
+    body: str | None
+    breaking: bool
+    footer: str | None
+
+    def format(self) -> str:
+        parts = [self.subject]
+        if self.body:
+            parts.append("")
+            parts.append(self.body)
+        if self.footer:
+            parts.append("")
+            parts.append(self.footer)
+        return "\n".join(parts)
+
+
+def _get_staged_diff() -> str:
+    diff = _git("diff", "--cached")
+    if len(diff) > _MAX_DIFF_CHARS:
+        diff = diff[:_MAX_DIFF_CHARS] + "\n\n[diff truncated]"
+    return diff
+
+
+def generate_commit_message(api_key: str, model: str = _MODEL) -> CommitMessage:
+    client = OpenAI(api_key=api_key)
+    diff = _get_staged_diff()
+    if not diff:
+        raise ValueError("No staged changes found. Use 'git add' first.")
+    resp = client.chat.completions.create(
+        model=model,
+        max_tokens=512,
+        messages=[
+            {"role": "system", "content": COMMIT_SYSTEM},
+            {"role": "user", "content": COMMIT_USER.format(diff=diff)},
+        ],
+    )
+    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 CommitMessage(
+        subject=data.get("subject", "chore: update"),
+        body=data.get("body") or None,
+        breaking=data.get("breaking", False),
+        footer=data.get("footer") or None,
+    )
+
+
+# ── Full release workflow ─────────────────────────────────────────────────────
+
+@dataclass
+class ReleaseInfo:
+    version: str
+    tag: str
+    name: str
+    body: str
+    prerelease: bool
+
+
+def _generate_release_notes(
+    api_key: str, version: str, changelog_md: str, model: str = _MODEL
+) -> tuple[str, str]:
+    """Return (release_name, release_body)."""
+    client = OpenAI(api_key=api_key)
+    resp = client.chat.completions.create(
+        model=model,
+        max_tokens=1024,
+        messages=[
+            {"role": "system", "content": RELEASE_NOTES_SYSTEM},
+            {"role": "user", "content": RELEASE_NOTES_USER.format(
+                version=version, changelog_md=changelog_md
+            )},
+        ],
+    )
+    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 data.get("name", f"v{version}"), data.get("body", changelog_md)
+
+
+def run_release(
+    api_key: str,
+    repo: str,
+    changelog_path: str = "CHANGELOG.md",
+    model: str = _MODEL,
+    dry_run: bool = False,
+) -> ReleaseInfo:
+    """Full release: generate changelog → bump version → create GitHub release."""
+    import datetime
+    from .github_client import _api
+
+    # 1. Generate changelog entry
+    entry, new_version = generate_changelog(api_key, model=model)
+    today = datetime.date.today().isoformat()
+    changelog_md = entry.to_markdown(new_version, today)
+
+    # 2. Write CHANGELOG.md
+    import pathlib
+    p = pathlib.Path(changelog_path)
+    if p.exists():
+        existing = p.read_text()
+        if existing.startswith("# "):
+            header, rest = existing.split("\n", 1)
+            new_content = f"{header}\n\n{changelog_md}\n{rest}"
+        else:
+            new_content = f"{changelog_md}\n\n{existing}"
+    else:
+        new_content = f"# Changelog\n\n{changelog_md}\n"
+
+    if not dry_run:
+        p.write_text(new_content)
+
+    # 3. Generate release notes
+    release_name, release_body = _generate_release_notes(
+        api_key, new_version, changelog_md, model=model
+    )
+    tag = f"v{new_version}"
+
+    if not dry_run:
+        # 4. Commit changelog
+        import subprocess
+        subprocess.run(["git", "add", changelog_path], check=True)
+        subprocess.run(
+            ["git", "commit", "-m", f"chore: release {tag}"],
+            check=True
+        )
+        # 5. Create git tag
+        subprocess.run(["git", "tag", tag], check=True)
+        subprocess.run(["git", "push"], check=True)
+        subprocess.run(["git", "push", "--tags"], check=True)
+        # 6. Create GitHub release
+        _api("POST", f"/repos/{repo}/releases", {
+            "tag_name": tag,
+            "name": release_name,
+            "body": release_body,
+            "prerelease": False,
+        })
+
+    return ReleaseInfo(
+        version=new_version,
+        tag=tag,
+        name=release_name,
+        body=release_body,
+        prerelease=False,
+    )

{pullwise-0.3.0 → pullwise-0.4.0}/pr_pilot/cli.py

@@ -6,6 +6,7 @@ import sys
 from .analyzer import (
     describe_pr, suggest_labels, review_pr, review_pr_as_comment,
     generate_changelog, suggest_reviewers, generate_standup, create_issues_from_todos,
+    generate_commit_message, run_release,
 )
 
 _RESET = "\033[0m"
@@ -103,6 +104,71 @@ def cmd_changelog(args: argparse.Namespace) -> None:
     print()
 
 
+def cmd_commit(args: argparse.Namespace) -> None:
+    print(f"\n  {_DIM}Analyzing staged changes...{_RESET}\n")
+    msg = generate_commit_message(_key(), model=args.model)
+
+    print(f"{_BOLD}Commit message:{_RESET}\n")
+    print(f"  {_GREEN}{msg.subject}{_RESET}")
+    if msg.body:
+        print()
+        for line in msg.body.splitlines():
+            print(f"  {line}")
+    if msg.footer:
+        print(f"\n  {_YELLOW}{msg.footer}{_RESET}")
+    if msg.breaking:
+        print(f"\n  {_YELLOW}⚠ Breaking change{_RESET}")
+
+    if args.commit:
+        import subprocess
+        full = msg.format()
+        result = subprocess.run(["git", "commit", "-m", full])
+        if result.returncode == 0:
+            print(f"\n  {_GREEN}✓{_RESET} Committed.")
+        else:
+            print(f"\n  Commit failed — copy the message above and run git commit manually.")
+    elif args.copy:
+        try:
+            import subprocess
+            subprocess.run(["pbcopy"], input=msg.format().encode(), check=True)
+            print(f"\n  {_GREEN}✓{_RESET} Copied to clipboard")
+        except Exception:
+            print(f"\n  {_DIM}(--copy requires macOS pbcopy){_RESET}")
+    print()
+
+
+def cmd_release(args: argparse.Namespace) -> None:
+    repo = args.repo or os.environ.get("GITHUB_REPOSITORY", "")
+    if not repo:
+        print("pr-pilot release: --repo is required (or set GITHUB_REPOSITORY)", file=sys.stderr)
+        sys.exit(1)
+
+    if args.dry_run:
+        print(f"\n  {_DIM}Dry run — nothing will be committed or published{_RESET}\n")
+    else:
+        print(f"\n  {_DIM}Running full release workflow for {repo}...{_RESET}\n")
+
+    release = run_release(
+        _key(),
+        repo=repo,
+        changelog_path=args.changelog,
+        model=args.model,
+        dry_run=args.dry_run,
+    )
+
+    print(f"  {_BOLD}Version:{_RESET}  {_GREEN}{release.tag}{_RESET}")
+    print(f"  {_BOLD}Name:{_RESET}     {release.name}\n")
+    print(release.body)
+
+    if args.dry_run:
+        print(f"\n  {_YELLOW}Dry run complete — no changes made.{_RESET}")
+    else:
+        print(f"\n  {_GREEN}✓{_RESET} CHANGELOG.md updated")
+        print(f"  {_GREEN}✓{_RESET} Committed and tagged {release.tag}")
+        print(f"  {_GREEN}✓{_RESET} GitHub release created")
+    print()
+
+
 def cmd_reviewers(args: argparse.Namespace) -> None:
     from .github_client import upsert_comment
     from .templates import REVIEWER_COMMENT_HEADER
@@ -246,6 +312,23 @@ def main() -> None:
     p_rev.add_argument("--model", default="gpt-4o", help="OpenAI model to use")
     p_rev.set_defaults(func=cmd_review)
 
+    # --- commit ---
+    p_commit = sub.add_parser("commit", help="Generate a conventional commit message from staged changes")
+    p_commit.add_argument("--model", default="gpt-4o")
+    p_commit.add_argument("--commit", action="store_true", help="Run git commit with the generated message")
+    p_commit.add_argument("--copy", action="store_true", help="Copy message to clipboard (macOS)")
+    p_commit.set_defaults(func=cmd_commit)
+
+    # --- release ---
+    p_release = sub.add_parser("release", help="Full release: changelog + git tag + GitHub release")
+    p_release.add_argument("--repo", default=None, help="GitHub repo slug (owner/repo)")
+    p_release.add_argument("--model", default="gpt-4o")
+    p_release.add_argument("--changelog", default="CHANGELOG.md", metavar="FILE",
+                           help="Path to CHANGELOG.md (default: CHANGELOG.md)")
+    p_release.add_argument("--dry-run", action="store_true",
+                           help="Preview release without committing or publishing")
+    p_release.set_defaults(func=cmd_release)
+
     # --- reviewers ---
     p_rev2 = sub.add_parser("reviewers", help="Suggest reviewers based on git blame of changed files")
     p_rev2.add_argument("--base", default="main")

{pullwise-0.3.0 → pullwise-0.4.0}/pr_pilot/templates.py

@@ -175,3 +175,57 @@ Comment: {comment}
 Surrounding code:
 {context}
 """
+
+# ── Commit message generator ──────────────────────────────────────────────────
+
+COMMIT_SYSTEM = """\
+You are an expert at writing git commit messages following the Conventional Commits
+specification (https://www.conventionalcommits.org).
+
+Given a staged diff, write a commit message.
+
+Return a JSON object:
+{
+  "subject": "type(scope): short description, max 72 chars, lowercase after colon",
+  "body": "optional longer explanation (2-4 sentences). null if the subject is self-explanatory.",
+  "breaking": true or false,
+  "footer": "BREAKING CHANGE: description" or null
+}
+
+Types: feat | fix | docs | style | refactor | perf | test | chore | ci | build
+Rules:
+- subject must be lowercase after the colon
+- subject must NOT end with a period
+- body wraps at 72 chars
+- Return ONLY the JSON object, no markdown fences
+"""
+
+COMMIT_USER = """\
+Staged diff:
+{diff}
+"""
+
+# ── Full release workflow ─────────────────────────────────────────────────────
+
+RELEASE_NOTES_SYSTEM = """\
+You are a technical writer creating GitHub release notes for a software project.
+Given a changelog entry and version info, write engaging release notes.
+
+Return a JSON object:
+{
+  "name": "release name (e.g. 'v1.2.0 — Dark Mode & Performance')",
+  "body": "markdown release notes: lead with a 1-2 sentence overview, then bullet sections for Added/Changed/Fixed. Max 400 words.",
+  "prerelease": false
+}
+
+Rules:
+- Be specific about what changed. No filler phrases.
+- Use emoji sparingly: one per section header max.
+- Return ONLY the JSON object, no markdown fences
+"""
+
+RELEASE_NOTES_USER = """\
+Version: {version}
+Changelog entry:
+{changelog_md}
+"""

{pullwise-0.3.0 → pullwise-0.4.0}/pullwise.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pullwise
-Version: 0.3.0
+Version: 0.4.0
 Summary: AI-powered PR descriptions, labels, and code review using OpenAI
 License: MIT
 Project-URL: Homepage, https://github.com/albertusreza/pr-pilot
@@ -120,6 +120,8 @@ pr-pilot describe --markdown pr_description.md
 | `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 |
+| `pr-pilot commit` | Generate a Conventional Commit message from staged changes |
+| `pr-pilot release` | Full release: changelog + git tag + GitHub release in one command |
 
 ## Usage
 
@@ -140,6 +142,20 @@ pr-pilot changelog
 pr-pilot changelog --output CHANGELOG.md
 ```
 
+```bash
+# Generate a commit message from staged changes
+pr-pilot commit
+
+# Run git commit directly with the generated message
+pr-pilot commit --commit
+
+# Full release: bump version + write changelog + create GitHub release
+pr-pilot release --repo owner/repo
+
+# Preview release without publishing
+pr-pilot release --repo owner/repo --dry-run
+```
+
 ```bash
 # Suggest reviewers for your current branch
 pr-pilot reviewers --base main

{pullwise-0.3.0 → pullwise-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pullwise"
-version = "0.3.0"
+version = "0.4.0"
 description = "AI-powered PR descriptions, labels, and code review using OpenAI"
 readme = "README.md"
 license = { text = "MIT" }

{pullwise-0.3.0 → pullwise-0.4.0}/tests/test_analyzer.py

@@ -1,10 +1,12 @@
 from __future__ import annotations
 import json
+import pytest
 from unittest.mock import MagicMock, patch
 from pr_pilot.analyzer import (
     describe_pr, suggest_labels, review_pr, PRDescription,
     review_pr_as_comment, generate_changelog, ChangelogEntry,
     suggest_reviewers, generate_standup, create_issues_from_todos, _bump_version,
+    generate_commit_message, CommitMessage, run_release,
 )
 from pr_pilot.templates import REVIEW_COMMENT_HEADER, REVIEWER_COMMENT_HEADER
 
@@ -238,3 +240,81 @@ def test_create_issues_from_todos(tmp_path):
     assert len(issues) == 1
     assert issues[0].title == "Fix slow foo()"
     assert "technical-debt" in issues[0].labels
+
+
+# ── Commit message generator tests ───────────────────────────────────────────
+
+@patch("pr_pilot.analyzer._get_staged_diff", return_value="+ def login(user, password):\n+     return auth(user)")
+def test_generate_commit_message_basic(mock_diff):
+    payload = {
+        "subject": "feat(auth): add login function",
+        "body": "Implements basic login using the auth helper.",
+        "breaking": False,
+        "footer": None,
+    }
+    with patch("pr_pilot.analyzer.OpenAI") as MockOpenAI:
+        MockOpenAI.return_value.chat.completions.create.return_value = \
+            _mock_openai_response(json.dumps(payload))
+        msg = generate_commit_message("fake-key")
+    assert msg.subject == "feat(auth): add login function"
+    assert msg.breaking is False
+    assert msg.footer is None
+
+
+@patch("pr_pilot.analyzer._get_staged_diff", return_value="")
+def test_generate_commit_message_no_staged(mock_diff):
+    with pytest.raises(ValueError, match="No staged changes"):
+        generate_commit_message("fake-key")
+
+
+def test_commit_message_format_full():
+    msg = CommitMessage(
+        subject="feat(api): add rate limiting",
+        body="Adds sliding window rate limiting to all endpoints.",
+        breaking=True,
+        footer="BREAKING CHANGE: Rate limit headers are now always present.",
+    )
+    formatted = msg.format()
+    assert "feat(api): add rate limiting" in formatted
+    assert "sliding window" in formatted
+    assert "BREAKING CHANGE" in formatted
+
+
+def test_commit_message_format_subject_only():
+    msg = CommitMessage(subject="chore: update deps", body=None, breaking=False, footer=None)
+    assert msg.format() == "chore: update deps"
+
+
+# ── Release workflow tests ────────────────────────────────────────────────────
+
+@patch("pr_pilot.analyzer._get_commits_since_tag", return_value="abc Fix login\ndef Add dark mode")
+@patch("pr_pilot.analyzer._get_current_version", return_value="1.0.0")
+@patch("pr_pilot.analyzer.get_diff", return_value="+ new code")
+@patch("pr_pilot.analyzer.get_commits", return_value="")
+@patch("pr_pilot.analyzer.get_branch", return_value="main")
+def test_run_release_dry_run(mock_branch, mock_commits, mock_diff, mock_ver, mock_ctag, tmp_path):
+    changelog_payload = {
+        "version": "minor", "highlights": "New features.",
+        "added": ["Dark mode"], "changed": [], "fixed": ["Login bug"],
+        "removed": [], "security": [],
+    }
+    release_payload = {
+        "name": "v1.1.0 — Dark Mode",
+        "body": "## What's new\n- Dark mode added\n- Login bug fixed",
+        "prerelease": False,
+    }
+    responses = [
+        _mock_openai_response(json.dumps(changelog_payload)),
+        _mock_openai_response(json.dumps(release_payload)),
+    ]
+    changelog_file = str(tmp_path / "CHANGELOG.md")
+    with patch("pr_pilot.analyzer.OpenAI") as MockOpenAI:
+        MockOpenAI.return_value.chat.completions.create.side_effect = responses
+        release = run_release("fake-key", repo="owner/repo",
+                              changelog_path=changelog_file, dry_run=True)
+    assert release.version == "1.1.0"
+    assert release.tag == "v1.1.0"
+    assert "Dark Mode" in release.name
+    # dry run: changelog file should NOT be written
+    import pathlib
+    assert not pathlib.Path(changelog_file).exists()

pullwise-0.3.0/pr_pilot/__init__.py

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