paircode 0.7.1__py3-none-any.whl

paircode-0.7.1.dist-info/METADATA

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: paircode
+Version: 0.7.1
+Summary: Adversarial journey framework — orchestrate multiple LLM peers through research, plan, and execute stages with file-trace peer review.
+Project-URL: Homepage, https://github.com/tsomerville2/paircode
+Project-URL: Repository, https://github.com/tsomerville2/paircode
+Project-URL: Issues, https://github.com/tsomerville2/paircode/issues
+Author-email: Travis Somerville <travis.somerville@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: agents,claude,codex,gemini,llm,multi-agent,ollama,orchestration,peer-review
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Description-Content-Type: text/markdown
+
+# paircode
+
+**Multi-LLM peer review for your code, with file-traces on disk.** One primary LLM (alpha) + any number of peer LLMs (Codex, Gemini, Ollama, …) running independent research, plans, and code, with structured cross-review rounds stored entirely as Markdown on disk.
+
+> Born from 31 iterations of dual-LLM silent-agreement hunting on a real ML project. See `diary/001-step-a-architecture.md` for the full design rationale.
+
+## Install
+
+```bash
+pipx install paircode       # or: pip install --user paircode
+paircode install            # registers /paircode in Claude / Codex / Gemini
+```
+
+Then open Claude Code, Codex, or Gemini and you'll see `/paircode` available globally.
+
+## Use it — three entry points
+
+### 1. From Claude Code (or any supported LLM) as a slash command
+
+Inside a Claude Code session:
+
+```
+/paircode drive "build a KISS PHQ-9 depression risk engine"
+```
+
+Claude relays that to the CLI. paircode opens a focus, runs research → plan → execute with peer-reviewed rounds, writes everything to `.paircode/` as Markdown.
+
+### 2. From the shell directly
+
+```bash
+paircode init                                   # bootstrap .paircode/ in cwd
+paircode handshake --write                      # detect CLIs + write peer roster
+paircode drive "refactor the auth middleware"   # full loop
+paircode status                                 # see where you are
+```
+
+### 3. Piece by piece
+
+```bash
+paircode focus "try GitHub Actions migration"
+paircode stage research --rounds 2              # cold v1 + one review/revise round
+paircode seal research                          # mark research FINAL
+paircode stage plan --rounds 3
+paircode seal plan
+paircode stage execute
+paircode seal execute
+```
+
+## What ends up on disk
+
+```
+your-project/
+  .paircode/
+    JOURNEY.md                    # fleet log (auto-updated)
+    peers.yaml                    # who's on the team
+    peers/
+      peer-a-codex/               # peer's profile (and code if full-fork mode)
+    focus-01-<slug>/
+      FOCUS.md                    # this focus's goal, roster override, gate config
+      research/
+        alpha-v1.md ... alpha-vN.md
+        peer-a-codex-v1.md ...
+        reviews/round-01-peer-a-codex-critiques-alpha.md
+        alpha-FINAL.md            # sealed exit artifact
+        peer-a-codex-FINAL.md
+      plan/
+        (same shape)
+      execute/
+        (same shape)
+    focus-02-<slug>/
+      ...
+```
+
+Every LLM's every thought lands as a Markdown file. That's how heterogeneous LLM tools communicate reliably across vendors, sessions, and days.
+
+## Three peer modes
+
+| Mode | What the peer does | When to use |
+|---|---|---|
+| **full-fork** | Writes its own cold codebase + markdown artifacts | Silent-agreement hunting, safety-critical code |
+| **pair-code** | Contributes directly to alpha's codebase via patches + reviews | Feature work, regular dev |
+| **opinion-only** | Reads alpha's work, writes reviews, never touches code | Budget peers, quick sanity checks |
+
+Configured per peer in `.paircode/peers.yaml`.
+
+## Model compatibility
+
+| CLI | Slash command | Subprocess driver | Status |
+|---|---|---|---|
+| Claude Code (`claude`) | ✓ `/paircode` via `~/.claude/commands/paircode.md` | ✓ `claude -p <prompt>` | stable |
+| Codex (`codex`) | ✓ context rule via `~/.codex/rules/paircode.rules` | ✓ `codex exec <prompt>` | stable |
+| Gemini CLI (`gemini`) | ✓ reference file at `~/.gemini/paircode.md` | ✓ `gemini -p <prompt>` | stable |
+| Ollama (`ollama`) | — (local models, no slash-cmd primitive) | ✓ `ollama run <model> <prompt>` | stable |
+| Aider / others | — | best-effort, PRs welcome | planned |
+
+## Commands
+
+```
+paircode --help           full command list
+paircode install          register /paircode in all detected LLM CLIs
+paircode uninstall        remove /paircode from LLM CLIs (idempotent)
+paircode handshake        detect CLIs, propose peer roster
+paircode handshake --write save roster to .paircode/peers.yaml
+paircode init             bootstrap .paircode/ in cwd
+paircode status           summarize current state
+paircode focus <name>     open a new focus
+paircode focus            list existing focuses
+paircode stage <name>     run one stage N rounds on active focus
+paircode seal <stage>     seal stage — copy each peer's latest vN to {peer}-FINAL.md
+paircode drive <topic>    full loop: research → plan → execute
+```
+
+## Why this exists
+
+See [`diary/001-step-a-architecture.md`](diary/001-step-a-architecture.md) for the full backstory. The short version: running two LLMs adversarially surfaces silent-agreement bug classes that neither engine alone can catch, because cross-engine agreement is not the same as correctness when both share the same blind spot.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

paircode-0.7.1.dist-info/RECORD

@@ -0,0 +1,27 @@
+paircode/__init__.py,sha256=YT0HqvBvBPL25b5sHLwWlakhxcvIl5MZlhrFDuHIBkc,166
+paircode/__main__.py,sha256=nj3xFbNqz8UN8UQJSJ1mDyPTD2PZ-7PZ1TF-eTyBbgA,69
+paircode/cli.py,sha256=0FQAq2sEJ_3xY_SvwvYugj_4SSY6_e2ZE0rCyoDOwQE,15858
+paircode/detect.py,sha256=41XxPw7sTRdxieLPc9L2zsxFteIPBr59ObYj13kUVl0,1426
+paircode/drive.py,sha256=Qr7az8L4iXOWRZx6PrRdqX7v-yXVfEFSSczOan35dNM,12405
+paircode/gates.py,sha256=FGKyerAfE5XU0p35kjK030SzEACnSNcfT0lPaYSp-Zw,2301
+paircode/handshake.py,sha256=tgrtqFieH4oqWNjNzJuSBfjQhiP7YaKrxDatou6H_nU,1841
+paircode/installer.py,sha256=xawRpM2Idj2jMVSvc5T6pDVC_SsfujxcHv5m5FDDJRs,5711
+paircode/journey.py,sha256=IXhLzTM_zhNPLpusC7GW4HmEBnRv09Z1doZYYoUwBGA,2146
+paircode/runner.py,sha256=bIcMeUJ6Hjs8CZGNDBXGwqnK934IvsuUQKZButUuIFc,3586
+paircode/seal.py,sha256=HrTnkmA2kgszJLeWG23RklXUy3uCJ2IZR3y33vyRGPY,1742
+paircode/state.py,sha256=5eWw5JSTW_ie1RuSXIFVt0j3mUv3HyKud2yhuy3-tx4,4977
+paircode/templates/FOCUS.md,sha256=BL3I6bjwezqzBSksRb2aYXY_L8Ff4vqZfhvGAPb9r9E,689
+paircode/templates/JOURNEY.md,sha256=GAM2RJ42T5JElFYPiv0nIUCG0vr5q7csXoRsrm4VMwY,464
+paircode/templates/claude_slash_command.md,sha256=jNRqnge_fQ3tK_nLIli_jTZTtyF9MMfAnyajnRnyL_s,1708
+paircode/templates/codex_rules.md,sha256=5LkX4vGbuSwLRyQeTfh_fvnQv8tIk47EDyr1MlHE2zo,858
+paircode/templates/peers.yaml,sha256=wZRxx_ylNtM15HvNNjBMtxqFyW1G7ihLFdteuDtNEYY,898
+paircode-0.7.1.data/data/paircode/templates/FOCUS.md,sha256=BL3I6bjwezqzBSksRb2aYXY_L8Ff4vqZfhvGAPb9r9E,689
+paircode-0.7.1.data/data/paircode/templates/JOURNEY.md,sha256=GAM2RJ42T5JElFYPiv0nIUCG0vr5q7csXoRsrm4VMwY,464
+paircode-0.7.1.data/data/paircode/templates/claude_slash_command.md,sha256=jNRqnge_fQ3tK_nLIli_jTZTtyF9MMfAnyajnRnyL_s,1708
+paircode-0.7.1.data/data/paircode/templates/codex_rules.md,sha256=5LkX4vGbuSwLRyQeTfh_fvnQv8tIk47EDyr1MlHE2zo,858
+paircode-0.7.1.data/data/paircode/templates/peers.yaml,sha256=wZRxx_ylNtM15HvNNjBMtxqFyW1G7ihLFdteuDtNEYY,898
+paircode-0.7.1.dist-info/METADATA,sha256=5EpwCV9J63T-eMM66VXF29LMoiiKN9vlsRcMo_tl_7c,5978
+paircode-0.7.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+paircode-0.7.1.dist-info/entry_points.txt,sha256=Xws2Px0qjasysoJikWE8LokoojG2_7qwOh8vTF-v9K0,47
+paircode-0.7.1.dist-info/licenses/LICENSE,sha256=2z2DTvqat4kmyHNEC8ehgOC5fBtyENHg2-Z0MiY_rxM,1074
+paircode-0.7.1.dist-info/RECORD,,

paircode-0.7.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

paircode-0.7.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+paircode = paircode.cli:main

paircode-0.7.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Travis Somerville
+
+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.