bpsai-pair 2.9.3__tar.gz

bpsai_pair-2.9.3/LICENSE

@@ -0,0 +1,8 @@
+Copyright (c) 2025-2026 BPS AI Software. All rights reserved.
+
+This software and associated documentation files (the "Software") are
+proprietary and confidential. Unauthorized copying, modification,
+distribution, or use of this Software, via any medium, is strictly
+prohibited without the express written permission of BPS AI Software.
+
+For licensing inquiries: info@bpsaisoftware.com

bpsai_pair-2.9.3/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include README.md
+recursive-include bpsai_pair/data *

bpsai_pair-2.9.3/PKG-INFO

@@ -0,0 +1,222 @@
+Metadata-Version: 2.4
+Name: bpsai-pair
+Version: 2.9.3
+Summary: AI-augmented pair programming framework with 182+ CLI commands for planning, orchestration, Trello/GitHub integration, and autonomous workflows
+Author-email: BPS AI Software <dev@bpsai.com>
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://github.com/BPSAI/paircoder
+Project-URL: Documentation, https://github.com/BPSAI/paircoder#readme
+Project-URL: Repository, https://github.com/BPSAI/paircoder
+Project-URL: Issues, https://github.com/BPSAI/paircoder/issues
+Project-URL: Changelog, https://github.com/BPSAI/paircoder/blob/main/CHANGELOG.md
+Keywords: ai,pair-programming,cli,claude,gpt,codex,gemini,mcp,trello,github,autonomous,workflow,planning,tasks
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.7
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tiktoken>=0.5.0
+Provides-Extra: trello
+Requires-Dist: py-trello>=0.19.0; extra == "trello"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=2.0; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints>=2.0; extra == "docs"
+Requires-Dist: sphinx-copybutton>=0.5; extra == "docs"
+Requires-Dist: myst-parser>=2.0; extra == "docs"
+Requires-Dist: sphinx-click>=5.0; extra == "docs"
+Provides-Extra: sandbox
+Requires-Dist: docker>=7.0.0; extra == "sandbox"
+Requires-Dist: dockerpty>=0.4.1; extra == "sandbox"
+Dynamic: license-file
+
+# PairCoder — AI-Augmented Pair Programming Framework
+
+[![PyPI version](https://badge.fury.io/py/bpsai-pair.svg)](https://badge.fury.io/py/bpsai-pair)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+PairCoder is a **repo-native toolkit** for pairing with AI coding agents (Claude, GPT, Codex, Gemini). It standardizes project memory in `.paircoder/`, provides structured workflows via skills, and ships a CLI with **182+ commands** to orchestrate the entire development lifecycle.
+
+## Key Features
+
+| Feature | Description |
+|---------|-------------|
+| **Planning System** | Plans, sprints, tasks with YAML+MD format |
+| **Skills** | Claude Code native skills with cross-platform export |
+| **Orchestration** | Multi-agent coordination, model routing by complexity |
+| **Autonomous Workflow** | Auto-session for hands-off task execution |
+| **Contained Autonomy** | Docker-enforced isolation with three-tier access control |
+| **Architecture Enforcement** | File/function size limits with pre-commit/CI gates |
+| **Presets** | 8 built-in presets (python-cli, bps, autonomous, etc.) |
+| **GitHub Integration** | Auto-PR creation, task-linked PRs, archive on merge |
+| **Trello Integration** | Board/card management, progress comments, webhooks |
+| **Standup Generation** | Daily summaries in markdown/slack/trello formats |
+| **Metrics** | Token tracking, cost estimation, budget enforcement |
+| **Time Tracking** | Built-in timer with Toggl integration |
+| **MCP Server** | 15 tools for autonomous agent operation |
+| **Auto-Hooks** | Automatic Trello sync and state updates on task changes |
+
+## Quick Start
+
+### Install
+
+```bash
+pip install bpsai-pair
+bpsai-pair --version
+```
+
+### Initialize a Project
+
+```bash
+# New project with preset
+bpsai-pair init my-project --preset python-cli
+cd my-project
+
+# List available presets
+bpsai-pair preset list
+
+# Initialize with BPS Trello workflow
+bpsai-pair init my-project --preset bps
+
+# Existing project
+cd your-project
+bpsai-pair init .
+```
+
+### Optional Dependencies
+
+```bash
+# For MCP/Claude Desktop integration
+pip install 'bpsai-pair[mcp]'
+
+# For Trello integration
+pip install 'bpsai-pair[trello]'
+
+# For Docker sandbox (contained autonomy)
+pip install 'bpsai-pair[sandbox]'
+
+# All extras
+pip install 'bpsai-pair[mcp,trello,sandbox]'
+```
+
+## Project Structure
+
+After initialization, your project will have:
+
+```
+my-project/
+├── .paircoder/                    # PairCoder data
+│   ├── config.yaml               # Project configuration
+│   ├── capabilities.yaml         # LLM capability manifest
+│   ├── context/                  # Project context files
+│   │   ├── project.md           # Project overview
+│   │   ├── workflow.md          # Workflow guidelines
+│   │   └── state.md             # Current state
+│   ├── plans/                    # Plan files (.plan.yaml)
+│   ├── tasks/                    # Task files (.task.md)
+│   └── history/                  # Archives, metrics
+├── .claude/                       # Claude Code native
+│   ├── skills/                   # Model-invoked skills
+│   ├── agents/                   # Custom subagents
+│   └── commands/                 # Slash commands
+├── AGENTS.md                      # Universal AI entry point
+└── CLAUDE.md                      # Claude Code instructions
+```
+
+## CLI Commands (180+)
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `init [path] [--preset]` | Initialize repo with PairCoder structure |
+| `feature <name>` | Create feature branch with context |
+| `pack [--lite]` | Package context for AI agents |
+| `context-sync` | Update the context loop |
+| `status` | Show current context and recent changes |
+| `validate` | Check repo structure and consistency |
+
+### Planning & Tasks
+
+| Command | Description |
+|---------|-------------|
+| `plan new <slug>` | Create a new plan |
+| `plan list` | List all plans |
+| `plan show <id>` | Show plan details |
+| `plan status [id]` | Show progress with task breakdown |
+| `task list` | List all tasks |
+| `task update <id> --status` | Update task status (fires hooks) |
+
+### Trello Integration
+
+| Command | Description |
+|---------|-------------|
+| `trello connect` | Connect to Trello (store credentials) |
+| `trello boards` | List available boards |
+| `ttask list` | List tasks from board |
+| `ttask start <id>` | Start working on a task |
+| `ttask done <id>` | Complete task with summary |
+
+### MCP Server
+
+| Command | Description |
+|---------|-------------|
+| `mcp serve` | Start MCP server (stdio transport) |
+| `mcp tools` | List available tools |
+| `mcp test <tool>` | Test a tool locally |
+
+### Contained Autonomy
+
+| Command | Description |
+|---------|-------------|
+| `contained-auto [task]` | Start contained autonomous session |
+| `containment status` | Show containment mode and protected paths |
+| `containment rollback` | Rollback to checkpoint |
+
+## Skills System
+
+PairCoder provides Claude Code native skills in `.claude/skills/`:
+
+- **designing-and-implementing** — Feature development workflow
+- **implementing-with-tdd** — Test-driven development
+- **reviewing-code** — Code review workflow
+- **finishing-branches** — Branch completion
+- **managing-task-lifecycle** — Task workflow with Trello
+- **planning-with-trello** — Planning with Trello integration
+- **releasing-versions** — Release preparation workflow
+
+Export skills to other platforms:
+```bash
+bpsai-pair skill export --format cursor    # Export to Cursor
+bpsai-pair skill export --format continue  # Export to Continue.dev
+bpsai-pair skill export --format all       # Export to all platforms
+```
+
+## Documentation
+
+- [Full Documentation](https://github.com/BPSAI/paircoder#readme) — Complete guide with all 180+ commands
+- [User Guide](https://github.com/BPSAI/paircoder/blob/main/.paircoder/docs/USER_GUIDE.md) — Getting started guide
+- [Feature Matrix](https://github.com/BPSAI/paircoder/blob/main/.paircoder/docs/FEATURE_MATRIX.md) — Complete feature inventory
+- [Contained Autonomy](https://github.com/BPSAI/paircoder/blob/main/docs/CONTAINED_AUTONOMY.md) — Docker isolation guide
+
+## License
+
+PairCoder is proprietary software. See [LICENSE](LICENSE) for terms.
+
+For licensing inquiries, contact info@bpsaisoftware.com

bpsai_pair-2.9.3/README.md

@@ -0,0 +1,175 @@
+# PairCoder — AI-Augmented Pair Programming Framework
+
+[![PyPI version](https://badge.fury.io/py/bpsai-pair.svg)](https://badge.fury.io/py/bpsai-pair)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+PairCoder is a **repo-native toolkit** for pairing with AI coding agents (Claude, GPT, Codex, Gemini). It standardizes project memory in `.paircoder/`, provides structured workflows via skills, and ships a CLI with **182+ commands** to orchestrate the entire development lifecycle.
+
+## Key Features
+
+| Feature | Description |
+|---------|-------------|
+| **Planning System** | Plans, sprints, tasks with YAML+MD format |
+| **Skills** | Claude Code native skills with cross-platform export |
+| **Orchestration** | Multi-agent coordination, model routing by complexity |
+| **Autonomous Workflow** | Auto-session for hands-off task execution |
+| **Contained Autonomy** | Docker-enforced isolation with three-tier access control |
+| **Architecture Enforcement** | File/function size limits with pre-commit/CI gates |
+| **Presets** | 8 built-in presets (python-cli, bps, autonomous, etc.) |
+| **GitHub Integration** | Auto-PR creation, task-linked PRs, archive on merge |
+| **Trello Integration** | Board/card management, progress comments, webhooks |
+| **Standup Generation** | Daily summaries in markdown/slack/trello formats |
+| **Metrics** | Token tracking, cost estimation, budget enforcement |
+| **Time Tracking** | Built-in timer with Toggl integration |
+| **MCP Server** | 15 tools for autonomous agent operation |
+| **Auto-Hooks** | Automatic Trello sync and state updates on task changes |
+
+## Quick Start
+
+### Install
+
+```bash
+pip install bpsai-pair
+bpsai-pair --version
+```
+
+### Initialize a Project
+
+```bash
+# New project with preset
+bpsai-pair init my-project --preset python-cli
+cd my-project
+
+# List available presets
+bpsai-pair preset list
+
+# Initialize with BPS Trello workflow
+bpsai-pair init my-project --preset bps
+
+# Existing project
+cd your-project
+bpsai-pair init .
+```
+
+### Optional Dependencies
+
+```bash
+# For MCP/Claude Desktop integration
+pip install 'bpsai-pair[mcp]'
+
+# For Trello integration
+pip install 'bpsai-pair[trello]'
+
+# For Docker sandbox (contained autonomy)
+pip install 'bpsai-pair[sandbox]'
+
+# All extras
+pip install 'bpsai-pair[mcp,trello,sandbox]'
+```
+
+## Project Structure
+
+After initialization, your project will have:
+
+```
+my-project/
+├── .paircoder/                    # PairCoder data
+│   ├── config.yaml               # Project configuration
+│   ├── capabilities.yaml         # LLM capability manifest
+│   ├── context/                  # Project context files
+│   │   ├── project.md           # Project overview
+│   │   ├── workflow.md          # Workflow guidelines
+│   │   └── state.md             # Current state
+│   ├── plans/                    # Plan files (.plan.yaml)
+│   ├── tasks/                    # Task files (.task.md)
+│   └── history/                  # Archives, metrics
+├── .claude/                       # Claude Code native
+│   ├── skills/                   # Model-invoked skills
+│   ├── agents/                   # Custom subagents
+│   └── commands/                 # Slash commands
+├── AGENTS.md                      # Universal AI entry point
+└── CLAUDE.md                      # Claude Code instructions
+```
+
+## CLI Commands (180+)
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `init [path] [--preset]` | Initialize repo with PairCoder structure |
+| `feature <name>` | Create feature branch with context |
+| `pack [--lite]` | Package context for AI agents |
+| `context-sync` | Update the context loop |
+| `status` | Show current context and recent changes |
+| `validate` | Check repo structure and consistency |
+
+### Planning & Tasks
+
+| Command | Description |
+|---------|-------------|
+| `plan new <slug>` | Create a new plan |
+| `plan list` | List all plans |
+| `plan show <id>` | Show plan details |
+| `plan status [id]` | Show progress with task breakdown |
+| `task list` | List all tasks |
+| `task update <id> --status` | Update task status (fires hooks) |
+
+### Trello Integration
+
+| Command | Description |
+|---------|-------------|
+| `trello connect` | Connect to Trello (store credentials) |
+| `trello boards` | List available boards |
+| `ttask list` | List tasks from board |
+| `ttask start <id>` | Start working on a task |
+| `ttask done <id>` | Complete task with summary |
+
+### MCP Server
+
+| Command | Description |
+|---------|-------------|
+| `mcp serve` | Start MCP server (stdio transport) |
+| `mcp tools` | List available tools |
+| `mcp test <tool>` | Test a tool locally |
+
+### Contained Autonomy
+
+| Command | Description |
+|---------|-------------|
+| `contained-auto [task]` | Start contained autonomous session |
+| `containment status` | Show containment mode and protected paths |
+| `containment rollback` | Rollback to checkpoint |
+
+## Skills System
+
+PairCoder provides Claude Code native skills in `.claude/skills/`:
+
+- **designing-and-implementing** — Feature development workflow
+- **implementing-with-tdd** — Test-driven development
+- **reviewing-code** — Code review workflow
+- **finishing-branches** — Branch completion
+- **managing-task-lifecycle** — Task workflow with Trello
+- **planning-with-trello** — Planning with Trello integration
+- **releasing-versions** — Release preparation workflow
+
+Export skills to other platforms:
+```bash
+bpsai-pair skill export --format cursor    # Export to Cursor
+bpsai-pair skill export --format continue  # Export to Continue.dev
+bpsai-pair skill export --format all       # Export to all platforms
+```
+
+## Documentation
+
+- [Full Documentation](https://github.com/BPSAI/paircoder#readme) — Complete guide with all 180+ commands
+- [User Guide](https://github.com/BPSAI/paircoder/blob/main/.paircoder/docs/USER_GUIDE.md) — Getting started guide
+- [Feature Matrix](https://github.com/BPSAI/paircoder/blob/main/.paircoder/docs/FEATURE_MATRIX.md) — Complete feature inventory
+- [Contained Autonomy](https://github.com/BPSAI/paircoder/blob/main/docs/CONTAINED_AUTONOMY.md) — Docker isolation guide
+
+## License
+
+PairCoder is proprietary software. See [LICENSE](LICENSE) for terms.
+
+For licensing inquiries, contact info@bpsaisoftware.com

bpsai_pair-2.9.3/bpsai_pair/__init__.py

@@ -0,0 +1,40 @@
+"""bpsai_pair package"""
+try:
+    from importlib.metadata import version, PackageNotFoundError
+    __version__ = version("bpsai-pair")
+except PackageNotFoundError:
+    __version__ = "dev"
+
+# Core modules
+from . import cli
+from .core import config  # Moved to core/ in T24.2
+from .core import utils  # Merged utils/pyutils/jsonio to core/ in T24.7
+
+# Feature modules (public API)
+from . import planning
+from . import tasks
+from . import trello
+from . import github
+from . import metrics
+from . import orchestration
+from . import mcp
+from . import context
+from .core import presets  # Moved to core/ in T24.6
+
+__all__ = [
+    "__version__",
+    # Core
+    "cli",
+    "config",
+    "utils",
+    # Features
+    "planning",
+    "tasks",
+    "trello",
+    "github",
+    "metrics",
+    "orchestration",
+    "mcp",
+    "context",
+    "presets",
+]

bpsai_pair-2.9.3/bpsai_pair/__main__.py

@@ -0,0 +1,4 @@
+from .cli import app
+
+if __name__ == "__main__":
+    app()

bpsai_pair-2.9.3/bpsai_pair/benchmarks/__init__.py

@@ -0,0 +1,15 @@
+"""Benchmarking framework module."""
+
+from .runner import BenchmarkRunner, BenchmarkResult, BenchmarkConfig
+from .validation import BenchmarkValidator, ValidationResult
+from .reports import BenchmarkReporter, BenchmarkComparison
+
+__all__ = [
+    "BenchmarkRunner",
+    "BenchmarkResult",
+    "BenchmarkConfig",
+    "BenchmarkValidator",
+    "ValidationResult",
+    "BenchmarkReporter",
+    "BenchmarkComparison",
+]