PyTaskAI v0.3.0
Minimal AI-powered task management with MCP integration and hexagonal architecture
🎯 Project Status: ✅ COMPLETE - PRODUCTION READY
🚀 Hexagonal architecture implementation completed successfully!
- Achievement: Clean 2900-line codebase with 6 essential MCP tools
- Quality: 168 tests passing, 80% coverage, SOLID principles
- Architecture: Complete hexagonal (ports & adapters) implementation
🏗️ New Architecture: Hexagonal (Ports & Adapters)
pytaskai/
├── domain/ # 🔵 CORE - Pure business logic
│ ├── entities/ # Task, SubTask business entities
│ ├── repositories/ # Abstract interfaces (ports)
│ └── services/ # Domain services
├── application/ # 🟡 USE CASES - Orchestration
│ ├── use_cases/ # Application use cases
│ ├── dto/ # Data Transfer Objects
│ └── interfaces/ # Ports for external services
├── infrastructure/ # 🟢 IMPLEMENTATION - Details
│ ├── persistence/ # SQLite implementation
│ └── external/ # OpenAI service
└── adapters/ # 🟠 EXTERNAL - User interfaces
├── mcp/ # MCP server adapter
└── cli/ # CLI adapter
📊 Achievement Metrics (vs Previous)
| Aspect | Previous | ✅ Achieved |
|---|---|---|
| Total Lines | 5000+ | 2900 lines |
| Dependencies | 26+ | 6 core |
| MCP Tools | 27 | 6 essential |
| AI Providers | 9 | 1 (OpenAI) |
| Test Coverage | None | 80% (168 tests) |
| Architecture | Monolithic | Hexagonal |
🚀 Quick Start
# Install
pip install -e .
# Setup environment
export OPENAI_API_KEY="your-key-here"
# CLI usage
pytaskai init # Initialize database
pytaskai task add "My new task" # Add task
pytaskai task list # List tasks
pytaskai task generate 1 # AI subtask generation
# Run tests
python -m pytest pytaskai/tests/ # All 168 tests
# MCP integration (Claude Code)
# Configure in ~/.claude.json or MCP client
🔧 Essential Features (6 MCP Tools)
- list_tasks - List tasks with filters
- get_task - Get task details
- add_task - Create new task
- update_task - Modify task
- delete_task - Remove task
- generate_subtasks - AI-powered task breakdown
📊 Dependencies (Minimal)
dependencies = [
"fastmcp>=0.3.0", # MCP server
"pydantic>=2.0.0", # Data models
"sqlalchemy>=2.0.0", # Database
"openai>=1.0.0", # AI (OpenAI only)
"click>=8.0.0", # CLI
"python-dotenv>=1.0.0" # Config
]
🏁 Implementation Status
✅ All Milestones Completed:
- MILESTONE 1: Domain Layer - Entities, value objects, repository interfaces
- MILESTONE 2: Application Layer - Use cases, DTOs, dependency injection
- MILESTONE 3: Infrastructure Persistence - SQLite repository implementation
- MILESTONE 4: MCP Adapter - FastMCP server with 6 essential tools
- MILESTONE 5: Infrastructure AI - OpenAI service integration
- MILESTONE 6: CLI Adapter - Click-based command line interface
- MILESTONE 7: Integration & Testing - E2E tests, architecture validation
🎯 Quality Metrics Achieved:
- 168 tests passing with 80% code coverage
- Zero business logic duplication between CLI and MCP adapters
- Complete hexagonal architecture with proper dependency inversion
- SOLID principles compliance validated through architecture tests
🎯 Design Principles
- SOLID Principles: Rigorously applied
- DRY Implementation: Zero code duplication
- Hexagonal Architecture: Clean separation of concerns
- Domain-Driven Design: Business logic in domain layer
- Test-Driven: Every layer fully testable
- Incremental: Each milestone is complete and functional
🤝 Contributing
This project now has a stable hexagonal architecture foundation! Contributions are welcome:
- Fork and clone the repository
- Install development dependencies:
pip install -e ".[dev]" - Run tests:
python -m pytest pytaskai/tests/ - Follow architecture: Maintain hexagonal architecture principles
- Submit PR with tests and documentation
See CLAUDE.md for detailed development guidelines.
📄 License
MIT License - see LICENSE.md for details.
PyTaskAI v0.3.0 - Production-ready hexagonal architecture implementation complete! 🎉
Metadata
Release files for pytaskai 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pytaskai-0.3.0.tar.gz | 99.9 kB | Without provenance | Details for pytaskai-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pytaskai-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for pytaskai-0.3.0-py3-none-any.whl |
Total release size: 223.6 kB
Release files / pytaskai-0.3.0.tar.gz
| Download URL | pytaskai-0.3.0.tar.gz |
|---|---|
| Size | 99.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
054544d66aed2f6a4876cc875ab0a8818667dbd1faf0ce3bde9ca5528b6d20b4
|
|
BLAKE2b-256 checksum How to use checksums |
6f636a71c92615a10c61a305a719ebf677aab1e1e78b79428578f7ca468e2bc3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Release files / pytaskai-0.3.0-py3-none-any.whl
| Download URL | pytaskai-0.3.0-py3-none-any.whl |
|---|---|
| Size | 123.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4f43c22004ce473986aee07bbd3782cb8c78ddb1439bd11ffd036185a4757e14
|
|
BLAKE2b-256 checksum How to use checksums |
78d92bf7aa833e693200c2c078c90dc55a018a2e50581ca11652554bc3f156b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Security for pytaskai 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.