bpsai-pair 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

bpsai_pair/__init__.py

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

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

@@ -1 +1,19 @@
-# 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
+# Default agent pack exclusions
+.git/
+.venv/
+venv/
+env/
+__pycache__/
+node_modules/
+dist/
+build/
+*.log
+*.bak
+*.tgz
+*.tar.gz
+*.zip
+.env
+.env.*
+*.pyc
+.DS_Store
+Thumbs.db

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

@@ -1,9 +1,8 @@
-
 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 *
+    - cron: '17 3 * * *'  # Daily at 03:17 UTC
   workflow_dispatch: {}
 
 permissions:
@@ -14,20 +13,42 @@ jobs:
     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
+          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"
-          git config user.email "actions@github.com"
+          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" && git push;
+            git commit -m "chore(context): refresh project_tree snapshot [skip ci]"
+            git push
           else
-            echo "No changes to commit.";
+            echo "No changes to commit."
           fi

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/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/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/agents.md

@@ -1,4 +1,13 @@
-# 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
+# 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

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

@@ -1 +1,11 @@
-# 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
+# Development Log
+
+**Phase:** (set by first feature)
+**Primary Goal:** (set by first feature)
+
+## Context Sync (AUTO-UPDATED)
+
+- **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/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/ops.py

@@ -17,12 +17,12 @@ import json
 
 class GitOps:
     """Git operations helper."""
-    
+
     @staticmethod
     def is_repo(path: Path) -> bool:
         """Check if path is a git repo."""
         return (path / ".git").exists()
-    
+
     @staticmethod
     def is_clean(path: Path) -> bool:
         """Check if working tree is clean."""
@@ -58,7 +58,7 @@ class GitOps:
             return True
         except:
             return False
-    
+
     @staticmethod
     def current_branch(path: Path) -> str:
         """Get current branch name."""
@@ -69,7 +69,7 @@ class GitOps:
             text=True
         )
         return result.stdout.strip() if result.returncode == 0 else ""
-    
+
     @staticmethod
     def create_branch(path: Path, branch: str, from_branch: str = "main") -> bool:
         """Create and checkout a new branch."""
@@ -81,10 +81,10 @@ class GitOps:
         )
         if check.returncode != 0:
             return False
-        
+
         # Checkout source branch
         subprocess.run(["git", "checkout", from_branch], cwd=path, capture_output=True)
-        
+
         # Pull if upstream exists
         upstream = subprocess.run(
             ["git", "rev-parse", "--abbrev-ref", "--symbolic-full-name", "@{u}"],
@@ -93,7 +93,7 @@ class GitOps:
         )
         if upstream.returncode == 0:
             subprocess.run(["git", "pull", "--ff-only"], cwd=path, capture_output=True)
-        
+
         # Create new branch
         result = subprocess.run(
             ["git", "checkout", "-b", branch],
@@ -101,13 +101,13 @@ class GitOps:
             capture_output=True
         )
         return result.returncode == 0
-    
+
     @staticmethod
     def add_commit(path: Path, files: List[Path], message: str) -> bool:
         """Add files and commit."""
         for f in files:
             subprocess.run(["git", "add", str(f)], cwd=path, capture_output=True)
-        
+
         result = subprocess.run(
             ["git", "commit", "-m", message],
             cwd=path,
@@ -118,19 +118,19 @@ class GitOps:
 
 class ProjectTree:
     """Generate project tree snapshots."""
-    
+
     @staticmethod
     def generate(root: Path, excludes: Optional[Set[str]] = None) -> str:
         """Generate a tree structure of the project."""
         if excludes is None:
             excludes = {
-                '.git', '.venv', 'venv', '__pycache__', 
+                '.git', '.venv', 'venv', '__pycache__',
                 'node_modules', 'dist', 'build', '.mypy_cache',
                 '.pytest_cache', '.tox', '*.egg-info', '.DS_Store'
             }
-        
+
         tree_lines = []
-        
+
         def should_skip(path: Path) -> bool:
             name = path.name
             for pattern in excludes:
@@ -139,20 +139,20 @@ class ProjectTree:
                 if name == pattern:
                     return True
             return False
-        
+
         def walk_dir(dir_path: Path, prefix: str = ""):
             items = sorted(dir_path.iterdir(), key=lambda x: (x.is_file(), x.name))
             items = [i for i in items if not should_skip(i)]
-            
+
             for i, item in enumerate(items):
                 is_last = i == len(items) - 1
                 current = "└── " if is_last else "├── "
                 tree_lines.append(f"{prefix}{current}{item.name}")
-                
+
                 if item.is_dir():
                     extension = "    " if is_last else "│   "
                     walk_dir(item, prefix + extension)
-        
+
         tree_lines.append(".")
         walk_dir(root)
         return "\n".join(tree_lines)
@@ -160,7 +160,7 @@ class ProjectTree:
 
 class ContextPacker:
     """Package context files for AI agents."""
-    
+
     @staticmethod
     def read_ignore_patterns(ignore_file: Path) -> Set[str]:
         """Read patterns from .agentpackignore file."""
@@ -170,42 +170,41 @@ class ContextPacker:
                 for line in f:
                     line = line.strip()
                     if line and not line.startswith('#'):
-                        patterns.add(line.rstrip('/'))
+                        patterns.add(line)
         else:
             # Default patterns
             patterns = {
                 '.git', '.venv', '__pycache__', 'node_modules',
-                'dist', 'build', '*.log', '*.bak', '*.tgz', 
+                'dist', 'build', '*.log', '*.bak', '*.tgz',
                 '*.tar.gz', '*.zip', '.env*'
             }
         return patterns
-    
+
     @staticmethod
     def should_exclude(path: Path, patterns: Set[str]) -> bool:
         """Check if path should be excluded based on patterns."""
-        path_str = str(path).replace('\\', '/')
-        
+        from pathlib import PurePath
+
+        p = PurePath(path.as_posix())
+
         for pattern in patterns:
-            # Handle wildcards
-            if '*' in pattern:
-                import fnmatch
-                if fnmatch.fnmatch(path.name, pattern):
+            # Handle directory patterns (ending with /)
+            if pattern.endswith('/'):
+                dir_pattern = pattern.rstrip('/')
+                # Check if this is the directory itself or if it's inside the directory
+                if path.is_dir() and p.match(dir_pattern):
+                    return True
+                if any(parent.match(dir_pattern) for parent in p.parents):
                     return True
-                if fnmatch.fnmatch(path_str, pattern):
+            # Handle file/general patterns
+            else:
+                if p.match(pattern):
                     return True
-            # Handle directory patterns
-            elif pattern.endswith('/'):
-                if path.is_dir() and path.name == pattern[:-1]:
+                if any(parent.match(pattern) for parent in p.parents):
                     return True
-            # Exact match
-            elif path.name == pattern:
-                return True
-            # Path contains pattern
-            elif pattern in path_str.split('/'):
-                return True
-        
+
         return False
-    
+
     @staticmethod
     def pack(
         root: Path,
@@ -217,33 +216,33 @@ class ContextPacker:
         # Default files to include
         context_files = [
             root / "context" / "development.md",
-            root / "context" / "agents.md", 
+            root / "context" / "agents.md",
             root / "context" / "project_tree.md",
         ]
-        
+
         # Add directory_notes if it exists
         dir_notes = root / "context" / "directory_notes"
         if dir_notes.exists():
             for note in dir_notes.rglob("*.md"):
                 context_files.append(note)
-        
+
         # Add extra files
         if extra_files:
             for extra in extra_files:
                 extra_path = root / extra
                 if extra_path.exists():
                     context_files.append(extra_path)
-        
+
         # Filter out non-existent files
         context_files = [f for f in context_files if f.exists()]
-        
+
         if dry_run:
             return context_files
-        
+
         # Read ignore patterns
         ignore_file = root / ".agentpackignore"
         patterns = ContextPacker.read_ignore_patterns(ignore_file)
-        
+
         # Create tarball
         with tarfile.open(output, "w:gz") as tar:
             for file_path in context_files:
@@ -251,13 +250,13 @@ class ContextPacker:
                 if not ContextPacker.should_exclude(file_path, patterns):
                     arcname = file_path.relative_to(root)
                     tar.add(file_path, arcname=str(arcname))
-        
+
         return context_files
 
 
 class FeatureOps:
     """Operations for feature branch management."""
-    
+
     @staticmethod
     def create_feature(
         root: Path,
@@ -271,17 +270,17 @@ class FeatureOps:
         # Check if working tree is clean
         if not force and not GitOps.is_clean(root):
             raise ValueError("Working tree not clean. Commit or stash changes, or use --force")
-        
+
         # Create branch
         branch_name = f"{branch_type}/{name}"
         if not GitOps.create_branch(root, branch_name):
             raise ValueError(f"Failed to create branch {branch_name}")
-        
+
         # Ensure context directory structure
         context_dir = root / "context"
         context_dir.mkdir(exist_ok=True)
         (context_dir / "directory_notes").mkdir(exist_ok=True)
-        
+
         # Update or create development.md
         dev_file = context_dir / "development.md"
         if not dev_file.exists():
@@ -301,7 +300,7 @@ class FeatureOps:
         else:
             # Update existing file
             content = dev_file.read_text()
-            
+
             # Update Primary Goal
             if primary_goal:
                 import re
@@ -315,7 +314,7 @@ class FeatureOps:
                     f'Overall goal is: {primary_goal}',
                     content
                 )
-            
+
             # Update Phase
             if phase:
                 content = re.sub(
@@ -328,16 +327,16 @@ class FeatureOps:
                     f'Next action will be: {phase}',
                     content
                 )
-            
+
             # Update Last action
             content = re.sub(
                 r'Last action was:.*',
                 f'Last action was: Created feature branch {branch_name}',
                 content
             )
-            
+
             dev_file.write_text(content)
-        
+
         # Create agents.md if missing
         agents_file = context_dir / "agents.md"
         if not agents_file.exists():
@@ -360,7 +359,7 @@ This project uses a **Context Loop**. Always keep these fields current:
 Run `bpsai-pair pack --out agent_pack.tgz` and upload to your session.
 """
             agents_file.write_text(agents_content)
-        
+
         # Generate project tree
         tree_file = context_dir / "project_tree.md"
         tree_content = f"""# Project Tree (snapshot)
@@ -371,29 +370,29 @@ _Generated: {datetime.now(timezone.utc).isoformat()}Z_
 ```
 """
         tree_file.write_text(tree_content)
-        
+
         # Commit changes
         GitOps.add_commit(
             root,
             [dev_file, agents_file, tree_file],
             f"feat(context): start {branch_name} — Primary Goal: {primary_goal or 'TBD'}"
         )
-        
+
         return True
 
 
 class LocalCI:
     """Cross-platform local CI runner."""
-    
+
     @staticmethod
     def run_python_checks(root: Path) -> dict:
         """Run Python linting, formatting, and tests."""
         results = {}
-        
+
         # Check if Python project
         if not ((root / "pyproject.toml").exists() or (root / "requirements.txt").exists()):
             return results
-        
+
         # Try to run ruff
         try:
             subprocess.run(["ruff", "format", "--check", "."], cwd=root, check=True)
@@ -401,46 +400,46 @@ class LocalCI:
             results["ruff"] = "passed"
         except:
             results["ruff"] = "failed or not installed"
-        
+
         # Try to run mypy
         try:
             subprocess.run(["mypy", "."], cwd=root, check=True)
             results["mypy"] = "passed"
         except:
             results["mypy"] = "failed or not installed"
-        
+
         # Try to run pytest
         try:
             subprocess.run(["pytest", "-q"], cwd=root, check=True)
             results["pytest"] = "passed"
         except:
             results["pytest"] = "failed or not installed"
-        
+
         return results
-    
+
     @staticmethod
     def run_node_checks(root: Path) -> dict:
         """Run Node.js linting, formatting, and tests."""
         results = {}
-        
+
         if not (root / "package.json").exists():
             return results
-        
+
         # Try npm commands
         try:
             subprocess.run(["npm", "run", "lint"], cwd=root, check=True)
             results["eslint"] = "passed"
         except:
             results["eslint"] = "failed or not configured"
-        
+
         try:
             subprocess.run(["npm", "test"], cwd=root, check=True)
             results["npm test"] = "passed"
         except:
             results["npm test"] = "failed or not configured"
-        
+
         return results
-    
+
     @staticmethod
     def run_all(root: Path) -> dict:
         """Run all applicable CI checks."""

bpsai_pair-0.2.2.dist-info/METADATA

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: bpsai-pair
+Version: 0.2.2
+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.dist-info → bpsai_pair-0.2.2.dist-info}/RECORD

@@ -1,42 +1,42 @@
-bpsai_pair/__init__.py,sha256=LpEf96Jx3tRBAzZZ8ZkPU7yWnTduFq_vZYru2jLa1Rs,379
+bpsai_pair/__init__.py,sha256=j8lrbjl_BGMHWus8G47VvaIP9w7kM_aQ7_kdGVY1hzM,379
 bpsai_pair/__main__.py,sha256=Qd-f8z2Q2vpiEP2x6PBFsJrpACWDVxFKQk820MhFmHo,59
 bpsai_pair/adapters.py,sha256=oowin5juQ9dTRwpHD8eJGBCahI2BoQZVEAhueDD821Y,323
 bpsai_pair/cli.py,sha256=qc5Pcr8gUG-xuJtrqqMT-kxlHi6zUyPDIUrOIuE_110,18422
 bpsai_pair/config.py,sha256=OIBaBkjz_jNsms4zjFxnmEN9gpqRLk1FTPq4ZBNkAUM,8750
 bpsai_pair/init_bundled_cli.py,sha256=AjtdC7yt4p-FatYt5y65XEwH9CtSFKnRc09cgb0di3I,1906
 bpsai_pair/jsonio.py,sha256=C_n42gPLRqjpif-AO0vjE3G1ae_v_PT3cywu7J4Xx-M,189
-bpsai_pair/ops.py,sha256=wYVhZ5XNfRjBkr3Ztvp6j1bBW-0bOggyAQOCVHmjPuA,14706
+bpsai_pair/ops.py,sha256=BbGEefND2xLCpxtZvKJtyDVd_yWW61g-LtPWXsVTEys,14340
 bpsai_pair/pyutils.py,sha256=5ub27mF4OIaGDm7CDacXsU_9FUZVaPOnYp2NyavFydo,998
 bpsai_pair/utils.py,sha256=TzaN27qKsBlRQCYHBcA06ufQERcc1fcyyOY7QlJQv8M,289
 bpsai_pair/data/cookiecutter-paircoder/cookiecutter.json,sha256=FoaPEPabd5AneVMamzBSw6QNsLZ3DhJRkNtmPOVtSIY,346
-bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.agentpackignore,sha256=4NkboG3S3zI736evJVm4RTjmzFxx_hvMi6KTBaGnLxU,130
+bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.agentpackignore,sha256=CIhaDHCwLQMwHBtVEL5VVgM9c_OQ6jKvRU7H8kvSNEI,167
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.editorconfig,sha256=Qpd1apKmHcq5gVWI8jpoxAbY_LF_04tkclK06aE2lB0,235
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.gitignore,sha256=ylldDXITCRrj038OGp1pBwihuM4SA6vDvThOvilZV0Q,47
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.gitleaks.toml,sha256=STXJmj13hqxp9ejb2hImc1h72BPB_1qsgT_b86o0HYA,373
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.pre-commit-config.yaml,sha256=o9AmanEQcUJCYOlnKg4SNcA_rviJKbczGiijyp9oSdY,1021
+bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/AGENTS.md,sha256=sChAlA26eE_I57Sfv3d6gAbMsu0UQyYxUUtctIbx3RA,1046
+bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/CLAUDE.md,sha256=5u5fq0HQaRsOwfI_h6GmR7lI7mMt91Bfk4aYOLuIzwU,1012
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/CODEOWNERS,sha256=vWB4d6NzBm1qlhLs_4uFQFz6UDICn5Ehn0NUqvXlMYo,715
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/CONTRIBUTING.md,sha256=KdZ4GjoyWMSS_kSb4zI0riALXkGuXmsiT09yH5X3Ac4,1191
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/SECURITY.md,sha256=L6teX1-0xxToQek2m5lR8iEZlJdzg2TYwpSIIKZDTzE,495
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.github/PULL_REQUEST_TEMPLATE.md,sha256=VbjBqMsIcryg3YY8TL8NsGnnzE1Thz43MrBaI3-m5mU,1146
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.github/workflows/ci.yml,sha256=VisTKdEHgnL6902gqKczr5FXFZgJlmA0zw2FJBMjb2Q,2766
-bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.github/workflows/project_tree.yml,sha256=QXS7BCkua_digYmhhSJtWhVcPrEhVJWbRTqIstdK1nw,1146
-bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/agents.md,sha256=yUgVqo5BuU5l3oX1hrRCzjLtvItvfArknxQ7ElrEzo4,836
-bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/agents.md.bak,sha256=jO9h6OnstcQmcejpO4BBnjX4USZUuSBDZ0U4GJf0tv0,6813
-bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/development.md,sha256=wQIGHsI6YDQ_hv1Ps-xYXf9vLmGi73rWbwTGOzt2S60,295
-bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/development.md.bak,sha256=Nm0e5ZNsTWawkcwU61m-6MFwseWouakPMWCwxCNElUY,251
+bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.github/workflows/project_tree.yml,sha256=jCdBPZSVnoMlrZGZRPrfNI_omy2bBneP501iW0yQ4Nc,1702
+bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/agents.md,sha256=3sxgyfzfBY7tjJuGh5t1e9f4qFS8Z5iaT70OEKzB2Ig,827
+bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/development.md,sha256=-1Woc7zLMw-YYkkE8_E0indISEiS0wv00qkpCEpyQm8,284
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/project_tree.md,sha256=ppNgU2afWoJOnSJbOl9GoJ8EuNT85N005_8LjilEN4w,89
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/directory_notes/.gitkeep,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/prompts/deep_research.yml,sha256=lhHG4JRi9Zdsq5J8TNaw2HeupD5oD7mm5J0XPNg1H9A,958
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/prompts/implementation.yml,sha256=co2EmK7ojw3lqeNXf99rlU3wxn6mrSuVAZGMlOEZHt4,639
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/prompts/roadmap.yml,sha256=EIdCo_EZpPZ9GXXg71IDgMooychyarWPpulojrcGIg8,498
-bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/scripts/README.md,sha256=gnZc_VUQPU81z7SIh3VqTqh0JPJJecKWmqWh-eBgJpU,358
+bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/scripts/README.md,sha256=2eHMbeH479EQwq5QFz83Mw-cb_x2SeYlKolk5hfELIw,367
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/src/.gitkeep,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/templates/adr.md,sha256=y_9hvwCgzukpV2pYOjYGk4kD-a6YZZZJqflMjnHvbLE,460
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/templates/directory_note.md,sha256=FnNMtnD_CpvVzpp5VzQzS4qddFQ6jfyS8q36ff10DrA,346
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/tests/example_contract/README.md,sha256=x5ZpsFnN9QiMWtXJsYw9n27ik5Yf425N5tbzMKOpVQQ,109
 bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/tests/example_integration/README.md,sha256=_G9MzJQq1GR4fVSgGeUFVo2eyzDXJVQn6mqJ5He1Euk,150
-bpsai_pair-0.2.0.dist-info/METADATA,sha256=jBUABNC5sNe8WFZ4oR_SPNAOBfsi8ITw3ufXBielzPk,813
-bpsai_pair-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-bpsai_pair-0.2.0.dist-info/entry_points.txt,sha256=tK6yOUS1oseLus0bPQYd2cuLJgL1Zr3AGb_YPHVCtCI,101
-bpsai_pair-0.2.0.dist-info/top_level.txt,sha256=kwTlUncK6pxJyQpZQdspexSc-kWtPvZkLUy4ji1P6LU,11
-bpsai_pair-0.2.0.dist-info/RECORD,,
+bpsai_pair-0.2.2.dist-info/METADATA,sha256=rz1nAlU4uxedrEUfYzndhr_A838a0UCHujUkBysVC_A,1812
+bpsai_pair-0.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+bpsai_pair-0.2.2.dist-info/entry_points.txt,sha256=tK6yOUS1oseLus0bPQYd2cuLJgL1Zr3AGb_YPHVCtCI,101
+bpsai_pair-0.2.2.dist-info/top_level.txt,sha256=kwTlUncK6pxJyQpZQdspexSc-kWtPvZkLUy4ji1P6LU,11
+bpsai_pair-0.2.2.dist-info/RECORD,,

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/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/context/development.md.bak

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

bpsai_pair-0.2.0.dist-info/METADATA

@@ -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
-```