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

bpsai_pair-0.2.2/PKG-INFO

@@ -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.2/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.2}/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-0.2.2/bpsai_pair/data/cookiecutter-paircoder/{{cookiecutter.project_slug}}/.agentpackignore

@@ -0,0 +1,19 @@
+# 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-0.2.2/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.2/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.2/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.2/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.2/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.2}/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