bpsai-pair 0.2.0__tar.gz → 0.2.1__tar.gz

bpsai_pair-0.2.1/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: bpsai-pair
+Version: 0.2.1
+Summary: CLI for AI pair-coding workflow
+Author: BPS AI Software
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.7
+Requires-Dist: pyyaml>=6.0
+
+# bpsai-pair CLI
+
+The PairCoder CLI tool for AI pair programming workflows.
+
+## Quick Start
+
+### Install from PyPI
+```bash
+pip install bpsai-pair
+bpsai-pair --help
+```
+
+### Development Install
+```bash
+cd tools/cli
+pip install -e .
+bpsai-pair --help
+```
+
+## Usage
+
+### Initialize scaffolding (uses bundled template)
+```bash
+bpsai-pair-init
+# or with main CLI:
+bpsai-pair init
+```
+
+### Create feature branch
+```bash
+bpsai-pair feature auth-refactor \
+  --type refactor \
+  --primary "Decouple auth via DI" \
+  --phase "Refactor auth module + tests"
+```
+
+### Pack context for AI
+```bash
+bpsai-pair pack --out agent_pack.tgz
+bpsai-pair pack --list  # Preview files
+bpsai-pair pack --json  # JSON output
+```
+
+### Update context loop
+```bash
+bpsai-pair context-sync \
+  --last "Initialized scaffolding" \
+  --next "Set up CI secrets" \
+  --blockers "None"
+```
+
+## Commands
+
+- `bpsai-pair init` - Initialize repo with PairCoder structure
+- `bpsai-pair-init` - Quick init with bundled template (no args)
+- `bpsai-pair feature` - Create feature/fix/refactor branch
+- `bpsai-pair pack` - Package context for AI agents
+- `bpsai-pair context-sync` - Update the Context Loop
+- `bpsai-pair status` - Show current state
+- `bpsai-pair validate` - Check repo structure
+- `bpsai-pair ci` - Run local CI checks
+
+## Development
+
+Run tests:
+```bash
+pytest
+```
+
+Build wheel:
+```bash
+python -m build
+```
+
+## Template
+
+The CLI bundles a cookiecutter template in `bpsai_pair/data/cookiecutter-paircoder/` 
+that gets installed with the package and used by `bpsai-pair-init`.

bpsai_pair-0.2.1/README.md

@@ -0,0 +1,78 @@
+# bpsai-pair CLI
+
+The PairCoder CLI tool for AI pair programming workflows.
+
+## Quick Start
+
+### Install from PyPI
+```bash
+pip install bpsai-pair
+bpsai-pair --help
+```
+
+### Development Install
+```bash
+cd tools/cli
+pip install -e .
+bpsai-pair --help
+```
+
+## Usage
+
+### Initialize scaffolding (uses bundled template)
+```bash
+bpsai-pair-init
+# or with main CLI:
+bpsai-pair init
+```
+
+### Create feature branch
+```bash
+bpsai-pair feature auth-refactor \
+  --type refactor \
+  --primary "Decouple auth via DI" \
+  --phase "Refactor auth module + tests"
+```
+
+### Pack context for AI
+```bash
+bpsai-pair pack --out agent_pack.tgz
+bpsai-pair pack --list  # Preview files
+bpsai-pair pack --json  # JSON output
+```
+
+### Update context loop
+```bash
+bpsai-pair context-sync \
+  --last "Initialized scaffolding" \
+  --next "Set up CI secrets" \
+  --blockers "None"
+```
+
+## Commands
+
+- `bpsai-pair init` - Initialize repo with PairCoder structure
+- `bpsai-pair-init` - Quick init with bundled template (no args)
+- `bpsai-pair feature` - Create feature/fix/refactor branch
+- `bpsai-pair pack` - Package context for AI agents
+- `bpsai-pair context-sync` - Update the Context Loop
+- `bpsai-pair status` - Show current state
+- `bpsai-pair validate` - Check repo structure
+- `bpsai-pair ci` - Run local CI checks
+
+## Development
+
+Run tests:
+```bash
+pytest
+```
+
+Build wheel:
+```bash
+python -m build
+```
+
+## Template
+
+The CLI bundles a cookiecutter template in `bpsai_pair/data/cookiecutter-paircoder/` 
+that gets installed with the package and used by `bpsai-pair-init`.

{bpsai_pair-0.2.0 → bpsai_pair-0.2.1}/bpsai_pair/__init__.py

@@ -2,7 +2,7 @@
 bpsai_pair package
 """
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 
 # Make modules available at package level
 from . import cli

bpsai_pair-0.2.1/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.agentpackignore

@@ -0,0 +1,12 @@
+# Default agent pack exclusions
+.git/
+.venv/
+__pycache__/
+node_modules/
+dist/
+build/
+*.log
+*.bak
+*.tgz
+*.tar.gz
+*.zip

bpsai_pair-0.2.1/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.github/workflows/project_tree.yml

@@ -0,0 +1,54 @@
+name: Refresh Project Tree
+
+on:
+  schedule:
+    - cron: '17 3 * * *'  # Daily at 03:17 UTC
+  workflow_dispatch: {}
+
+permissions:
+  contents: write
+
+jobs:
+  refresh:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Generate project tree
+        run: |
+          TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+          echo "# Project Tree (snapshot)" > context/project_tree.md
+          echo "_Generated: ${TS}_" >> context/project_tree.md
+          echo "" >> context/project_tree.md
+          echo '```' >> context/project_tree.md
+
+          # Use find to create tree (cross-platform)
+          find . \
+            -path './.git' -prune -o \
+            -path './node_modules' -prune -o \
+            -path './dist' -prune -o \
+            -path './build' -prune -o \
+            -path './.venv' -prune -o \
+            -path './__pycache__' -prune -o \
+            -path './tools/cli/dist' -prune -o \
+            -path './tools/cli/build' -prune -o \
+            -path './**/*.egg-info' -prune -o \
+            -type f -print -o \
+            -type d -print | \
+            sed 's|^\./||' | \
+            grep -v '^\.$' | \
+            sort >> context/project_tree.md
+
+          echo '```' >> context/project_tree.md
+
+      - name: Commit changes if any
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add context/project_tree.md || true
+          if ! git diff --cached --quiet; then
+            git commit -m "chore(context): refresh project_tree snapshot [skip ci]"
+            git push
+          else
+            echo "No changes to commit."
+          fi

bpsai_pair-0.2.1/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/AGENTS.md

@@ -0,0 +1,29 @@
+# Agents Guide (Root Pointer)
+
+Welcome, AI agent! This project uses PairCoder for AI pair programming.
+
+## Where to Start
+
+All instructions, context, and project information are maintained in the `/context` directory:
+
+1. **Read first:** `/context/agents.md` - Complete playbook and guidelines
+2. **Current state:** `/context/development.md` - Roadmap and Context Loop
+3. **File structure:** `/context/project_tree.md` - Repository layout
+4. **Component docs:** `/context/directory_notes/` - Directory-specific guidance
+
+## Critical Reminder
+
+Always check the Context Loop at the end of `/context/development.md` for:
+- **Overall goal is:** The project's primary objective
+- **Last action was:** What was just completed
+- **Next action will be:** The immediate next step
+- **Blockers/Risks:** Any issues needing attention
+
+## After Making Changes
+
+Update the Context Loop using:
+```bash
+bpsai-pair context-sync --last "What you did" --next "Next step" --blockers "Any issues"
+```
+
+Begin by reading `/context/agents.md` for complete instructions.

bpsai_pair-0.2.1/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/CLAUDE.md

@@ -0,0 +1,32 @@
+# Claude Guide (Root Pointer)
+
+Hello Claude! This project follows PairCoder conventions for AI pair programming.
+
+## Getting Started
+
+Your instructions are organized in the `/context` directory:
+
+1. **Start here:** `/context/agents.md` - Full AI pairing playbook
+2. **Project state:** `/context/development.md` - Current goals and progress
+3. **Repository map:** `/context/project_tree.md` - File structure reference
+
+## Working in This Repository
+
+Before making any changes:
+- Review the Context Loop in `/context/development.md`
+- Understand the current phase and next actions
+- Check for any blockers or risks
+
+After making changes:
+- Update the Context Loop to maintain continuity
+- Use the provided CLI command or edit directly
+- Keep changes focused and well-documented
+
+## PairCoder Principles
+
+- Maintain the Context Loop discipline
+- Make small, reversible changes
+- Add tests before implementing features
+- Follow the project's established patterns
+
+See `/context/agents.md` for detailed instructions.

bpsai_pair-0.2.1/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/agents.md

@@ -0,0 +1,15 @@
+# Agents Guide
+
+This project uses a **Context Loop**. Always keep these fields current:
+
+- **Overall goal is:** Single-sentence mission
+- **Last action was:** What just completed
+- **Next action will be:** The very next step
+- **Blockers:** Known issues or decisions needed
+
+### Working Rules for Agents\n- Do not modify or examine ignored directories (see `.agentpackignore`). Assume large assets exist even if excluded.\n- Prefer minimal, reversible changes.\n- After committing code, run `bpsai-pair context-sync` to update the loop.\n- Request a new context pack when the tree or docs change significantly.\n\n### Context Pack\nRun `bpsai-pair pack --out agent_pack.tgz` and upload to your session.\n
+---
+
+## Branch Discipline
+- Use `--type feature|fix|refactor` when creating features.
+- Conventional Commits recommended.

bpsai_pair-0.2.0/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/development.md.bak → bpsai_pair-0.2.1/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/development.md

@@ -8,3 +8,4 @@
 - **Overall goal is:** (set by feature)
 - **Last action was:** (set by feature)
 - **Next action will be:** (set by feature)
+- **Blockers:** (set by feature)

{bpsai_pair-0.2.0 → bpsai_pair-0.2.1}/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/scripts/README.md

@@ -1,6 +1,6 @@
 # Scripts directory (intentionally minimal)
 
-This project uses the **PairCoder CLI** (Python) — no Bash scripts required.
+This project uses the **PairCoder CLI** (Python) — Bash scripts have been deprecated.
 Common commands:
 
 ```bash

bpsai_pair-0.2.1/bpsai_pair.egg-info/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: bpsai-pair
+Version: 0.2.1
+Summary: CLI for AI pair-coding workflow
+Author: BPS AI Software
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.7
+Requires-Dist: pyyaml>=6.0
+
+# bpsai-pair CLI
+
+The PairCoder CLI tool for AI pair programming workflows.
+
+## Quick Start
+
+### Install from PyPI
+```bash
+pip install bpsai-pair
+bpsai-pair --help
+```
+
+### Development Install
+```bash
+cd tools/cli
+pip install -e .
+bpsai-pair --help
+```
+
+## Usage
+
+### Initialize scaffolding (uses bundled template)
+```bash
+bpsai-pair-init
+# or with main CLI:
+bpsai-pair init
+```
+
+### Create feature branch
+```bash
+bpsai-pair feature auth-refactor \
+  --type refactor \
+  --primary "Decouple auth via DI" \
+  --phase "Refactor auth module + tests"
+```
+
+### Pack context for AI
+```bash
+bpsai-pair pack --out agent_pack.tgz
+bpsai-pair pack --list  # Preview files
+bpsai-pair pack --json  # JSON output
+```
+
+### Update context loop
+```bash
+bpsai-pair context-sync \
+  --last "Initialized scaffolding" \
+  --next "Set up CI secrets" \
+  --blockers "None"
+```
+
+## Commands
+
+- `bpsai-pair init` - Initialize repo with PairCoder structure
+- `bpsai-pair-init` - Quick init with bundled template (no args)
+- `bpsai-pair feature` - Create feature/fix/refactor branch
+- `bpsai-pair pack` - Package context for AI agents
+- `bpsai-pair context-sync` - Update the Context Loop
+- `bpsai-pair status` - Show current state
+- `bpsai-pair validate` - Check repo structure
+- `bpsai-pair ci` - Run local CI checks
+
+## Development
+
+Run tests:
+```bash
+pytest
+```
+
+Build wheel:
+```bash
+python -m build
+```
+
+## Template
+
+The CLI bundles a cookiecutter template in `bpsai_pair/data/cookiecutter-paircoder/` 
+that gets installed with the package and used by `bpsai-pair-init`.

{bpsai_pair-0.2.0 → bpsai_pair-0.2.1}/bpsai_pair.egg-info/SOURCES.txt

@@ -23,6 +23,8 @@ bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.editorconf
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.gitignore
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.gitleaks.toml
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.pre-commit-config.yaml
+bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/AGENTS.md
+bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/CLAUDE.md
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/CODEOWNERS
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/CONTRIBUTING.md
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/SECURITY.md
@@ -30,9 +32,7 @@ bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.github/PUL
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.github/workflows/ci.yml
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.github/workflows/project_tree.yml
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/agents.md
-bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/agents.md.bak
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/development.md
-bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/development.md.bak
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/project_tree.md
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/directory_notes/.gitkeep
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/prompts/deep_research.yml

{bpsai_pair-0.2.0 → bpsai_pair-0.2.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 readme = "README.md"
 name = "bpsai-pair"
-version = "0.2.0"
+version = "0.2.1"
 description = "CLI for AI pair-coding workflow"
 requires-python = ">=3.9"
 dependencies = [ "typer>=0.12", "rich>=13.7", "pyyaml>=6.0",]
@@ -22,4 +22,4 @@ bpsai-pair-init = "bpsai_pair.init_bundled_cli:main"
 include-package-data = true
 
 [tool.setuptools.package-data]
-bpsai_pair = ["data/**"]
+bpsai_pair = ["data/**/*"]

bpsai_pair-0.2.0/PKG-INFO

@@ -1,29 +0,0 @@
-Metadata-Version: 2.4
-Name: bpsai-pair
-Version: 0.2.0
-Summary: CLI for AI pair-coding workflow
-Author: BPS AI Software
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: typer>=0.12
-Requires-Dist: rich>=13.7
-Requires-Dist: pyyaml>=6.0
-
-
-# bpsai-pair CLI
-
-## Quick start (local, un-packaged)
-```
-python -m tools.cli.bpsai_pair --help
-python -m tools.cli.bpsai_pair init tools/cookiecutter-paircoder
-python -m tools.cli.bpsai_pair feature auth-di --primary "Decouple auth via DI" --phase "Refactor auth + tests"
-python -m tools.cli.bpsai_pair pack --extra README.md
-python -m tools.cli.bpsai_pair context-sync --last "initialized scaffolding" --nxt "set up CI secrets" --blockers "none"
-```
-
-## Install as a CLI
-```
-cd tools/cli
-pip install -e .
-# now available as: bpsai-pair --help
-```

bpsai_pair-0.2.0/README.md

@@ -1,18 +0,0 @@
-
-# bpsai-pair CLI
-
-## Quick start (local, un-packaged)
-```
-python -m tools.cli.bpsai_pair --help
-python -m tools.cli.bpsai_pair init tools/cookiecutter-paircoder
-python -m tools.cli.bpsai_pair feature auth-di --primary "Decouple auth via DI" --phase "Refactor auth + tests"
-python -m tools.cli.bpsai_pair pack --extra README.md
-python -m tools.cli.bpsai_pair context-sync --last "initialized scaffolding" --nxt "set up CI secrets" --blockers "none"
-```
-
-## Install as a CLI
-```
-cd tools/cli
-pip install -e .
-# now available as: bpsai-pair --help
-```

bpsai_pair-0.2.0/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.agentpackignore

@@ -1 +0,0 @@
-# Default agent pack exclusions\n.git/\n.venv/\n__pycache__/\nnode_modules/\ndist/\nbuild/\n*.log\n*.bak\n*.tgz\n*.tar.gz\n*.zip\n

bpsai_pair-0.2.0/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.github/workflows/project_tree.yml

@@ -1,33 +0,0 @@
-
-name: Refresh Project Tree
-
-on:
-  schedule:
-    - cron: 17 3 CODEOWNERS context CONTRIBUTING.md docs infra prompts scripts SECURITY.md services src templates tests tools CODEOWNERS context CONTRIBUTING.md docs infra prompts scripts SECURITY.md services src templates tests tools *
-  workflow_dispatch: {}
-
-permissions:
-  contents: write
-
-jobs:
-  refresh:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Generate project tree
-        run: |
-          TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-          echo "# Project Tree (snapshot)" > context/project_tree.md
-          echo "_Generated: ${TS}_" >> context/project_tree.md
-          echo >> context/project_tree.md
-          echo  >> context/project_tree.md
-      - name: Commit changes if any
-        run: |
-          git config user.name "github-actions"
-          git config user.email "actions@github.com"
-          git add context/project_tree.md || true
-          if ! git diff --cached --quiet; then
-            git commit -m "chore(context): refresh project_tree snapshot" && git push;
-          else
-            echo "No changes to commit.";
-          fi

bpsai_pair-0.2.0/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/agents.md

@@ -1,6 +0,0 @@
-# Agents Guide\n\nThis project uses a **Context Loop**. Always keep these fields current:\n\n- **Overall goal is:** Single-sentence mission\n- **Last action was:** What just completed\n- **Next action will be:** The very next step\n- **Blockers:** Known issues or decisions needed\n\n### Working Rules for Agents\n- Do not modify or examine ignored directories (see `.agentpackignore`). Assume large assets exist even if excluded.\n- Prefer minimal, reversible changes.\n- After committing code, run `bpsai-pair context-sync` to update the loop.\n- Request a new context pack when the tree or docs change significantly.\n\n### Context Pack\nRun `bpsai-pair pack --out agent_pack.tgz` and upload to your session.\n
----
-
-## Branch Discipline
-- Use `--type feature|fix|refactor` when creating features.
-- Conventional Commits recommended.

bpsai_pair-0.2.0/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/agents.md.bak

@@ -1,196 +0,0 @@
-# Agents Guide — AI Pair Coding Playbook
-
-**Purpose:** Make GPT-5 / Claude / CodeX effective partners for {{ cookiecutter.primary_goal }} while improving modularity, maintainability, and testability.
-
-**Audience:** Engineers, Tech Leads, and AI Agents connected to this repo.
-
----
-
-## 0) Ground Rules (READ FIRST)
-
-* **Single Source of Truth:** This repository and the files in `/context` are canonical for all agent runs.
-* **Safety First:** No destructive ops without backups and a PR. Agents must create `*.bak` or use Git branches.
-* **Tests Before Changes:** Add/extend tests that fail *before* implementing a fix/refactor.
-* **Small, Reviewable Diffs:** Keep changes scoped; open PRs early; link to the relevant roadmap task.
-* **Update Context Every Run:** Always persist “Overall/Last/Next” (see §6) after actions.
-
----
-
-## 1) Repo Layout & Context Discipline
-
-> Keep the agent’s attention on code that matters. Avoid token waste and blind spots.
-
-* **Project Tree (authoritative sketch):**
-
-  ```
-  .
-  ├─ /src                # Application code
-  ├─ /tests              # Unit/integration tests
-  ├─ /services           # External adapters, API clients
-  ├─ /infra              # IaC / deployment (optional)
-  ├─ /docs               # Human-readable docs
-  ├─ /context            # Agent context files (canonical)
-  │   ├─ development.md
-  │   ├─ agents.md
-  │   ├─ project_tree.md
-  │   └─ directory_notes/
-  ├─ /assets/images      # Large/media (EXCLUDED from agent context)
-  └─ ...
-  ```
-
-* **Explicit Exclusions:** `/assets/images`, `/dist`, `/build`, `/node_modules`, binaries, large JSON/CSV.
-  Agents must **assume these exist** and avoid recommending moves/rewrites.
-
-* **Directory Notes (optional but powerful):**
-  Add `/context/directory_notes/<dir>.md` with:
-
-  * Purpose, entry points, invariants, dependency direction.
-  * “Do/Don’t” for this directory.
-  * Local glossary (domain terms, DTOs).
-  * Known pitfalls.
-
----
-
-## 2) Branching & PR Conventions
-
-* **Branch names:** `feature/<short-goal>` or `refactor/<module>` or `fix/<ticket-id>`
-* **Create branch from:** `main`
-* **PR template must include:**
-
-  * Goal link to `<PHASE N TASK>`
-  * Risk level (Low/Med/High)
-  * Test plan (automated + manual)
-  * Rollback plan
-  * Context update diff (what changed in `/context` files)
-
----
-
-## 3) Operating Modes
-
-### A) Non-Scripted (Live Collaboration)
-
-1. Create branch: `git checkout -b feature/<FEATURE>`
-2. Connect agent (Claude or GPT-5) to repo URL.
-3. Attach context: `/context/development.md`, `/context/agents.md`, relevant `/context/directory_notes/*`.
-4. **Prompt:**
-
-   ```
-   PHASE 1 GOAL: <PHASE 1 GOAL>
-   Constraints: preserve public APIs, add tests first, no destructive ops.
-   Output: stepwise plan + minimal diffs per step.
-   ```
-
-### B) Scripted (One-Pass Implementation)
-
-1. Create branch: `git checkout -b feature/<FEATURE>`
-2. Attach **only** relevant context files.
-3. **Prompt:**
-
-   ```
-   Create a comprehensive script/commit plan to accomplish <PHASE 1 GOAL> in one pass.
-   Requirements:
-   - Zero breakage; create backups where needed.
-   - Generate/modify tests first to capture intended behavior.
-   - Respect repo conventions, linting, and formatting.
-   - Produce: (a) ordered commit plan, (b) code patches, (c) updated docs, (d) updated context (see §6).
-   ```
-
----
-
-## 4) Canonical Prompts
-
-### 4.1 Deep Research (Kickoff)
-
-```
-You are a staff-level engineer embedded in this codebase.
-Objective: Produce a comprehensive plan to improve modularity, maintainability, and achieve {{ cookiecutter.primary_goal }}.
-Deliverables:
-- Architecture review (current vs. target), explicit trade-offs.
-- Refactoring map (by module), dependency inversion opportunities, interface boundaries.
-- Test posture upgrade plan (unit/integration/contract), coverage deltas.
-- Risks, complexity hotspots, and rollback strategies.
-- 3-phase roadmap with measurable outcomes.
-Constraints:
-- Respect exclusions listed in agents.md.
-- Assume assets exist where excluded.
-- Prefer small, reversible changes; maximize seam creation for safe refactors.
-```
-
-### 4.2 Roadmap → Files
-
-```
-Convert the roadmap into:
-- /context/development.md   (engineering tasks, test plans, risks)
-- /context/agents.md        (this file; update Operating Modes, Prompts if needed)
-Ensure clear Phase 1/2/3 breakdown with milestone checklists and acceptance criteria.
-```
-
-### 4.3 Implementation Guardrails (per task)
-
-```
-For TASK: <task-name>
-- Propose minimal diff solution.
-- Add/adjust tests first to lock behavior.
-- Provide code patches and commands to run tests/lints.
-- Call out risks + rollback.
-- Update context loop (Overall/Last/Next).
-```
-
----
-
-## 5) Testing & Quality Gates
-
-* **Unit tests:** focus on pure logic and interfaces.
-* **Integration tests:** external boundaries (DB, queues, HTTP) via testcontainers/mocks.
-* **Contract tests:** for service clients with provider/consumer pacts if applicable.
-* **Coverage targets:** raise or maintain ≥ <TARGET>% lines/branches where practical.
-* **CI gates:** lint, type-check, build, test, basic security scan (SAST/dep audit).
-
----
-
-## 6) Context Loop (Mandatory)
-
-Agents **must** persist this block at the end of every session in `/context/development.md` (and in any relevant directory note):
-
-```
-## Context Sync (AUTO-UPDATED)
-Overall goal is: {{ cookiecutter.primary_goal }}
-Last action was: <what changed and why> (commit SHA if available)
-Next action will be: <smallest valuable step with owner>
-Blockers/Risks: <if any>
-```
-
----
-
-## 7) Failure Modes & Rollback
-
-* **If tests fail:** revert last commit or apply backup. Fix tests first, then code.
-* **If unintended API change:** restore interface, add regression test.
-* **If scope creep:** park in `Phase N Backlog` with rationale.
-
----
-
-## 8) Example Exclusion Prompt
-
-> *Drop into your agent prompt when large dirs are omitted.*
-
-“Relevant image/media assets exist under `/assets/images` but are intentionally excluded from your context to conserve tokens. **Do not** propose changes that relocate, inline, or re-encode assets. Assume paths referenced in code are valid. Focus your analysis on `/src`, `/services`, and `/tests`. If a change seems to require asset inspection, propose an interface-level abstraction instead.”
-
----
-
-## 9) Definitions
-
-* **Seam:** a point in code where behavior can be changed without editing the code (e.g., via interface, DI, adapter).
-* **Backwards compatibility window:** period where both old and new APIs coexist with deprecation notices.
-
----
-
-## 10) Tools & Commands (fill per repo)
-
-* **Install:** `<cmd>`
-* **Format/Lint:** `<cmd>`
-* **Test (unit):** `<cmd>`
-* **Test (integration):** `<cmd>`
-* **Type check:** `<cmd>`
-* **Local CI bundle:** `<cmd>`
-

bpsai_pair-0.2.0/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/development.md

@@ -1 +0,0 @@
-# Development Log\n\n**Phase:** (set by first feature)\n**Primary Goal:** (set by first feature)\n\n## Context Sync (AUTO-UPDATED)\n\n- **Overall goal is:** (set by feature)\n- **Last action was:** (set by feature)\n- **Next action will be:** (set by feature)\n- **Blockers:** (set by feature)\n

bpsai_pair-0.2.0/bpsai_pair.egg-info/PKG-INFO

@@ -1,29 +0,0 @@
-Metadata-Version: 2.4
-Name: bpsai-pair
-Version: 0.2.0
-Summary: CLI for AI pair-coding workflow
-Author: BPS AI Software
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: typer>=0.12
-Requires-Dist: rich>=13.7
-Requires-Dist: pyyaml>=6.0
-
-
-# bpsai-pair CLI
-
-## Quick start (local, un-packaged)
-```
-python -m tools.cli.bpsai_pair --help
-python -m tools.cli.bpsai_pair init tools/cookiecutter-paircoder
-python -m tools.cli.bpsai_pair feature auth-di --primary "Decouple auth via DI" --phase "Refactor auth + tests"
-python -m tools.cli.bpsai_pair pack --extra README.md
-python -m tools.cli.bpsai_pair context-sync --last "initialized scaffolding" --nxt "set up CI secrets" --blockers "none"
-```
-
-## Install as a CLI
-```
-cd tools/cli
-pip install -e .
-# now available as: bpsai-pair --help
-```