bpsai-pair 2.9.2__tar.gz

bpsai_pair-2.9.2/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 BPS AI Software
+
+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.

bpsai_pair-2.9.2/MANIFEST.in

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

bpsai_pair-2.9.2/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: bpsai-pair
+Version: 2.9.2
+Summary: AI-augmented pair programming framework with 127+ CLI commands for planning, orchestration, Trello/GitHub integration, and autonomous workflows
+Author-email: BPS AI Software <dev@bpsai.com>
+License-Expression: MIT
+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 **127+ 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 |
+| **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** | 13 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 (127+)
+
+### 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 127+ 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
+
+MIT License — see [LICENSE](https://github.com/BPSAI/paircoder/blob/main/LICENSE) for details.
+
+## Contributing
+
+Contributions welcome! See our [Contributing Guide](https://github.com/BPSAI/paircoder/blob/main/CONTRIBUTING.md).

bpsai_pair-2.9.2/README.md

@@ -0,0 +1,176 @@
+# 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 **127+ 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 |
+| **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** | 13 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 (127+)
+
+### 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 127+ 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
+
+MIT License — see [LICENSE](https://github.com/BPSAI/paircoder/blob/main/LICENSE) for details.
+
+## Contributing
+
+Contributions welcome! See our [Contributing Guide](https://github.com/BPSAI/paircoder/blob/main/CONTRIBUTING.md).

bpsai_pair-2.9.2/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.2/bpsai_pair/__main__.py

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

bpsai_pair-2.9.2/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",
+]