pi-pr-review 1.6.0 → 1.6.2

package/.github/workflows/pull-request.yml

@@ -0,0 +1,52 @@
+name: Pull Request
+
+on:
+  pull_request:
+    types:
+      - opened
+      - edited
+      - synchronize
+      - reopened
+      - ready_for_review
+
+permissions:
+  contents: read
+
+jobs:
+  title:
+    name: Validate PR title
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Check Conventional Commit format
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
+        run: |
+          node <<'NODE'
+          const title = process.env.PR_TITLE ?? "";
+          const conventionalTitle = /^(feat|fix|perf|revert|docs|style|refactor|test|chore)(\([a-z0-9][a-z0-9._/-]*\))?!?: \S.*$/;
+
+          if (!conventionalTitle.test(title)) {
+            console.error(`Invalid PR title: ${title}`);
+            console.error("Use: <type>(optional-scope): description");
+            console.error("Allowed types: feat, fix, perf, revert, docs, style, refactor, test, chore");
+            console.error("Add ! before : for a breaking change, for example feat!: description");
+            process.exit(1);
+          }
+          NODE
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.2.15
+
+      - name: Run tests
+        run: bun test

package/.github/workflows/release-please.yml

@@ -0,0 +1,69 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: release-please-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: Create release PR or GitHub release
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+    steps:
+      - name: Create nerv-ops installation token
+        id: app-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ vars.NERV_OPS_APP_ID }}
+          private-key: ${{ secrets.NERV_OPS_PRIVATE_KEY }}
+
+      - name: Run Release Please
+        id: release
+        uses: googleapis/release-please-action@v4
+        with:
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+          token: ${{ steps.app-token.outputs.token }}
+
+  publish:
+    name: Test and publish to npm
+    needs: release
+    if: ${{ needs.release.outputs.release_created == 'true' }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Check out release commit
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org
+
+      - name: Set up Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.2.15
+
+      - name: Install npm with trusted publishing support
+        run: npm install --global npm@11.5.1
+
+      - name: Test
+        run: bun test
+
+      - name: Publish to npm
+        run: npm publish --access public --provenance

package/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.6.2"
+}

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## [1.6.2](https://github.com/10ego/pi-pr-review/compare/v1.6.1...v1.6.2) (2026-07-11)
+
+
+### Miscellaneous Chores
+
+* **release:** automate versioning and npm publishing ([585e961](https://github.com/10ego/pi-pr-review/commit/585e9616a85153a8edb03ec66acb7b75739706b0))
+* **release:** version every conventional PR ([be175e8](https://github.com/10ego/pi-pr-review/commit/be175e811bca1a0e74bb8e56d5148da80d2207b0))

package/README.md

@@ -1,6 +1,6 @@
 # pi-pr-review
 
-A model-agnostic GitHub pull-request review prompt for [pi](https://pi.dev).
+A parallel, model-agnostic AI code reviewer for GitHub pull requests in the [Pi coding agent](https://pi.dev).
 
 Pass a PR number and pi will:
 
@@ -21,19 +21,21 @@ No model name is hardcoded anywhere. The package ships an extension that adds **
 
 ## Install
 
-Install straight from the public repo (user scope):
+Install the published npm package in user scope:
 
 ```bash
-pi install git:github.com/10ego/pi-pr-review
+pi install npm:pi-pr-review
 ```
 
-Or project scope (shareable with your team, auto-installed on trust):
+Or install it in project scope so the dependency is shareable with your team and automatically installed when the project is trusted:
 
 ```bash
-pi install -l git:github.com/10ego/pi-pr-review
+pi install -l npm:pi-pr-review
 ```
 
-You can also install from a local checkout by pointing at the package directory, e.g. `pi install ./pi-pr-review` (add `-l` for project scope).
+For local development only, you can point pi at a checkout with `pi install ./pi-pr-review` (add `-l` for project scope).
+
+Releases are versioned from conventional squash-merged PR titles and published automatically through npm trusted publishing. See [RELEASING.md](RELEASING.md) for the release and merge policy.
 
 ### Alternative: use the template without packaging
 

package/RELEASING.md

@@ -0,0 +1,26 @@
+# Releasing
+
+[Release Please](https://github.com/googleapis/release-please) watches conventional commits merged into `main`. It opens or updates a release PR containing the calculated version change, `CHANGELOG.md`, and release manifest. Merging that release PR creates a GitHub release and, after the test suite passes, publishes `pi-pr-review` to npm with signed provenance.
+
+## Semver
+
+The squash-merged PR title becomes the commit Release Please evaluates:
+
+- `feat: ...` creates a minor release.
+- `feat!: ...`, `fix!: ...`, or a `BREAKING CHANGE:` footer creates a major release.
+- Every other allowed type—`fix:`, `perf:`, `revert:`, `chore:`, `docs:`, `refactor:`, `style:`, and `test:`—creates a patch release.
+
+All changes to `main` must go through a pull request and use squash merging. The required `Validate PR title` check enforces the conventional title, and the required `Test` check runs the Bun test suite. Direct pushes, force pushes, branch deletion, and administrator bypass are disabled.
+
+## One-time setup
+
+1. Install the private [`nerv-ops`](https://github.com/settings/apps/nerv-ops) GitHub App on this repository with **Contents: read and write** and **Pull requests: read and write** permissions.
+2. Add the App ID as the repository Actions variable `NERV_OPS_APP_ID`, and add a generated PEM private key as the repository Actions secret `NERV_OPS_PRIVATE_KEY`.
+3. In the npm settings for [`pi-pr-review`](https://www.npmjs.com/package/pi-pr-review), add a GitHub Actions trusted publisher with:
+   - organization/user: `10ego`
+   - repository: `pi-pr-review`
+   - workflow filename: `release-please.yml`
+   - environment: leave blank
+4. Use conventional titles for squash-merged PRs.
+
+No npm token is stored in GitHub. The workflow exchanges the App credentials for a short-lived repository installation token and uses npm trusted publishing through GitHub OIDC.

package/package.json

@@ -1,13 +1,29 @@
 {
   "name": "pi-pr-review",
-  "version": "1.6.0",
-  "description": "Model-agnostic GitHub PR code review prompt for pi. Pass a PR number; it derives the base and head branches from the PR in the current repo, reviews the diff, and returns structured JSON findings.",
+  "version": "1.6.2",
+  "description": "Parallel AI code review for GitHub pull requests in the Pi coding agent, with model-agnostic tiered subagents, structured findings, optional verification, and safe COMMENT-only publishing.",
   "keywords": [
     "pi-package",
+    "pi-extension",
+    "pi",
+    "pi-coding-agent",
+    "pr-review",
     "code-review",
+    "ai-code-review",
+    "ai-review",
     "github",
+    "github-pr",
     "pull-request",
-    "prompt-template"
+    "pull-request-review",
+    "code-reviewer",
+    "code-quality",
+    "review",
+    "automation",
+    "llm",
+    "subagents",
+    "parallel",
+    "multi-agent",
+    "developer-tools"
   ],
   "license": "MIT",
   "repository": {

package/release-please-config.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "bootstrap-sha": "b9b62811aab72269b5f2bbb58d08d37b3c20ecff",
+  "packages": {
+    ".": {
+      "release-type": "node",
+      "package-name": "pi-pr-review",
+      "changelog-path": "CHANGELOG.md",
+      "include-component-in-tag": false,
+      "changelog-sections": [
+        { "type": "feat", "section": "Features", "hidden": false },
+        { "type": "fix", "section": "Bug Fixes", "hidden": false },
+        { "type": "perf", "section": "Performance Improvements", "hidden": false },
+        { "type": "revert", "section": "Reverts", "hidden": false },
+        { "type": "docs", "section": "Documentation", "hidden": false },
+        { "type": "style", "section": "Styles", "hidden": false },
+        { "type": "refactor", "section": "Code Refactoring", "hidden": false },
+        { "type": "test", "section": "Tests", "hidden": false },
+        { "type": "chore", "section": "Miscellaneous Chores", "hidden": false }
+      ]
+    }
+  }
+}