pi-pair-programmer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthieu Pernelle
+
+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,65 @@
+# Pi Pair Programmer
+
+Background code review for [Pi](https://pi.dev/docs/extensions) and [OMP](https://omp.sh/docs/extension-authoring).
+
+![Pi Pair Programmer workflow: coding agent writes code, focused reviewers filter findings, then the agent accepts or rejects feedback before continuing](assets/pair-programmer-overview.png)
+
+## Why
+
+Coding with AI adds entropy to a codebase.
+Agents optimize for local correctness instead of thinking about the global system. They repeat code and reinvent the wheel.
+
+Turn-by-turn static analysis is necessary but not sufficient.
+Code review happens too late in the code production pipeline.
+
+This extension lets you run multiple highly specialized reviewers, each focused on a specific concern, to catch issues static analysis cannot detect as soon as code is generated. Without bloating the context window, thanks to a Jev-based filter that removes inherited and duplicate findings.
+
+## Install
+
+With Pi:
+
+```sh
+pi install git:github.com/T-moz/pi-pair-programmer
+```
+
+With OMP:
+
+```sh
+omp plugin install github:T-moz/pi-pair-programmer
+```
+
+For the Jev filter, set your TypeSafe API key before starting Pi or OMP:
+
+```sh
+export TYPESAFE_API_KEY="your-api-key"
+```
+
+Without it, reviews still run, but only exact duplicate findings are filtered.
+
+## Use
+
+Reviews are on by default. After each successful `write` or `edit`, reviewers run in the background. The coding agent must accept or reject each finding with a reason before continuing with other tools. Only accepted findings appear in your transcript.
+
+Run `/pair-programmer` to toggle reviews.
+
+Run `/pair-clear` to cancel reviews and clear all findings.
+
+The default reviewer uses your current model and asks: “Does it add entropy?” To change the prompt, model, or files reviewed, create `pair-programmer.reviewers.json` in your working directory:
+
+```json
+{
+  "reviewers": [
+    {
+      "model": "current",
+      "prompt": "Does it add entropy?",
+      "include": ["src/**/*.ts"],
+      "exclude": ["**/*.test.ts"]
+    }
+  ]
+}
+```
+
+Use `current` or a `provider/model` identifier. File patterns are relative to your working directory; exclusions take precedence. Add entries for more reviewers.
+
+- `/pair-stats`: view review activity, findings, tokens, and estimated costs on demand; missing usage stays unknown.
+- Diagnostics stay in files, never the terminal: OMP uses its native logs; Pi uses `~/.pi/agent/logs/pair-programmer/` (or `$PI_CODING_AGENT_DIR/logs/pair-programmer/`).

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "pi-pair-programmer",
+  "version": "0.1.0",
+  "description": "A TypeScript extension for Pi and OMP",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/T-moz/pi-pair-programmer.git"
+  },
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "pi-package"
+  ],
+  "files": [
+    "src"
+  ],
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "omp": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "scripts": {
+    "check": "tsc --noEmit && eslint . --max-warnings 0 && prettier --check . && npm test",
+    "test": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --max-warnings 0",
+    "format:check": "prettier --check .",
+    "format": "prettier --write ."
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.87.1",
+    "@eslint/js": "^10.0.1",
+    "@vitest/coverage-v8": "^5.0.1",
+    "eslint": "^10.11.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-import-x": "^4.17.1",
+    "eslint-plugin-promise": "^7.3.0",
+    "eslint-plugin-regexp": "^3.3.1",
+    "eslint-plugin-security": "^4.0.1",
+    "eslint-plugin-sonarjs": "^4.2.1",
+    "eslint-plugin-unicorn": "^76.0.0",
+    "globals": "^17.12.0",
+    "prettier": "^3.9.9",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.70.1",
+    "vitest": "^5.0.1"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "dependencies": {
+    "@typesafe-ai/sdk": "^0.6.0",
+    "minimatch": "^10.2.6",
+    "pino": "^10.3.1",
+    "typebox": "^1.3.34",
+    "zod": "^4.6.5"
+  }
+}