claude-task-master 0.1.1__tar.gz → 0.1.3__tar.gz

{claude_task_master-0.1.1 → claude_task_master-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-task-master
-Version: 0.1.1
+Version: 0.1.3
 Summary: Autonomous task orchestration system that keeps Claude working until a goal is achieved
 Author: Claude Task Master Team
 License-Expression: MIT
@@ -28,7 +28,13 @@ Requires-Dist: rich>=13.0.0
 Requires-Dist: httpx>=0.27.0
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Provides-Extra: api
+Requires-Dist: fastapi>=0.100.0; extra == "api"
+Requires-Dist: uvicorn[standard]>=0.24.0; extra == "api"
+Requires-Dist: passlib[bcrypt]>=1.7.4; extra == "api"
+Requires-Dist: bcrypt<4.1.0,>=4.0.0; extra == "api"
 Provides-Extra: dev
+Requires-Dist: claude-task-master[api]; extra == "dev"
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
@@ -36,7 +42,7 @@ Requires-Dist: pytest-timeout>=2.4.0; extra == "dev"
 Requires-Dist: ruff>=0.3.0; extra == "dev"
 Requires-Dist: mypy>=1.9.0; extra == "dev"
 Provides-Extra: all
-Requires-Dist: claude-task-master[dev,mcp]; extra == "all"
+Requires-Dist: claude-task-master[api,dev,mcp]; extra == "all"
 
 # Claude Task Master
 
@@ -50,21 +56,99 @@ Autonomous task orchestration system that keeps Claude working until a goal is a
 
 ## Quick Start
 
+### Installation
+
+**Option 1: Using uv (recommended)**
+
+```bash
+# Install with uv
+uv tool install claude-task-master
+```
+
+**Option 2: Using pip**
+
 ```bash
 # Install from PyPI
 pip install claude-task-master
+```
 
-# Or with uv (recommended)
-uv tool install claude-task-master
+**Option 3: Using Docker**
+
+```bash
+# Pull the official Docker image from GitHub Container Registry
+docker pull ghcr.io/developerz-ai/claude-task-master:latest
+
+# Run with Docker (requires Claude credentials mounted)
+docker run -d \
+  --name claudetm \
+  -p 8000:8000 \
+  -v ~/.claude:/home/claudetm/.claude:ro \
+  -v $(pwd):/app/project \
+  -v ~/.gitconfig:/home/claudetm/.gitconfig:ro \
+  -v ~/.config/gh:/home/claudetm/.config/gh:ro \
+  ghcr.io/developerz-ai/claude-task-master:latest
+```
+
+See [Docker Deployment Guide](./docs/docker.md) for detailed Docker setup, volume mounts, and configuration options.
+
+### Authentication
+
+Before using claudetm, you need to authenticate with Claude:
+
+```bash
+# Run Claude CLI and login (this saves credentials that claudetm will use)
+claude
+/login
 
-# Verify setup
+# Verify claudetm can access credentials
 claudetm doctor
+```
+
+**For Docker users:** Ensure your `~/.claude/.credentials.json` exists before running the container, as Claude Task Master needs OAuth credentials to function.
+
+### Upgrading
+
+**With uv:**
+```bash
+uv tool install claude-task-master --force --reinstall
+```
 
-# Run a task
+**With pip:**
+```bash
+pip install --upgrade claude-task-master
+```
+
+**With Docker:**
+```bash
+# Pull the latest image
+docker pull ghcr.io/developerz-ai/claude-task-master:latest
+
+# Restart your container with the new image
+docker-compose up -d
+```
+
+**Check version:**
+```bash
+claudetm --version
+```
+
+### Run a Task
+
+**Using the CLI:**
+```bash
 cd your-project
 claudetm start "Add user authentication with tests"
 ```
 
+**Using Docker:**
+```bash
+# Task execution is handled through the unified server
+# Create tasks via the REST API or MCP interface
+curl -H "Authorization: Bearer password" \
+     http://localhost:8000/tasks -X POST \
+     -d '{"goal": "Add user authentication"}'
+```
+
 ## Overview
 
 Claude Task Master uses the Claude Agent SDK to autonomously work on complex tasks. Give it a goal, and it will:
@@ -252,6 +336,17 @@ To use OpenRouter instead of direct Anthropic API:
 CLAUDETM_DEBUG=1 claudetm status
 ```
 
+## Documentation
+
+Complete documentation for all features and deployment options:
+
+| Guide | Description |
+|-------|-------------|
+| **[Docker Deployment](./docs/docker.md)** | Docker installation, configuration, volume mounts, and production deployment |
+| **[Authentication](./docs/authentication.md)** | Password-based authentication for REST API, MCP server, and webhooks |
+| **[REST API Reference](./docs/api-reference.md)** | Complete REST API endpoint documentation with examples |
+| **[Webhooks](./docs/webhooks.md)** | Webhook events, payload formats, HMAC signature verification, and integration examples |
+
 ## Usage
 
 ### CLI Commands
@@ -460,6 +555,49 @@ claudetm context
 
 The system follows SOLID principles with strict Single Responsibility:
 
+### Server Architecture
+
+When running with the unified server (`claudetm-server`), the following components work together:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                      Claude Task Master Server                       │
+│                                                                       │
+│  ┌──────────────┐   ┌──────────────┐   ┌──────────────┐             │
+│  │  REST API    │   │  MCP Server  │   │   Webhooks   │             │
+│  │  (FastAPI)   │   │  (FastMCP)   │   │   (httpx)    │             │
+│  └──────┬───────┘   └──────┬───────┘   └──────┬───────┘             │
+│         │                  │                  │                      │
+│         └──────────────────┼──────────────────┘                      │
+│                            │                                         │
+│                    ┌───────▼───────┐                                 │
+│                    │ Auth Module   │                                 │
+│                    │ (Password)    │                                 │
+│                    └───────────────┘                                 │
+└─────────────────────────────────────────────────────────────────────┘
+
+Docker Container:
+┌─────────────────────────────────────────────────────────────────────┐
+│  claudetm-server                                                     │
+│                                                                       │
+│  Volumes:                                                            │
+│  - /app/project → project directory                                 │
+│  - /root/.claude → Claude credentials (~/.claude)                   │
+│                                                                       │
+│  Env: CLAUDETM_PASSWORD, CLAUDETM_WEBHOOK_URL, ...                   │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**Server Features:**
+- **REST API** - Create and manage tasks, view status, manage webhooks
+- **MCP Server** - Claude editor integration for native IDE support
+- **Webhooks** - Send notifications on task events with HMAC verification
+- **Unified Authentication** - Single password protects all three interfaces
+- **Docker Ready** - Multi-arch image published to GitHub Container Registry
+
+For detailed Docker deployment, see [Docker Deployment Guide](./docs/docker.md).
+For authentication details, see [Authentication Guide](./docs/authentication.md).
+
 ### Core Components
 
 | Component | Responsibility |

{claude_task_master-0.1.1 → claude_task_master-0.1.3}/README.md

@@ -10,21 +10,99 @@ Autonomous task orchestration system that keeps Claude working until a goal is a
 
 ## Quick Start
 
+### Installation
+
+**Option 1: Using uv (recommended)**
+
+```bash
+# Install with uv
+uv tool install claude-task-master
+```
+
+**Option 2: Using pip**
+
 ```bash
 # Install from PyPI
 pip install claude-task-master
+```
 
-# Or with uv (recommended)
-uv tool install claude-task-master
+**Option 3: Using Docker**
+
+```bash
+# Pull the official Docker image from GitHub Container Registry
+docker pull ghcr.io/developerz-ai/claude-task-master:latest
+
+# Run with Docker (requires Claude credentials mounted)
+docker run -d \
+  --name claudetm \
+  -p 8000:8000 \
+  -v ~/.claude:/home/claudetm/.claude:ro \
+  -v $(pwd):/app/project \
+  -v ~/.gitconfig:/home/claudetm/.gitconfig:ro \
+  -v ~/.config/gh:/home/claudetm/.config/gh:ro \
+  ghcr.io/developerz-ai/claude-task-master:latest
+```
+
+See [Docker Deployment Guide](./docs/docker.md) for detailed Docker setup, volume mounts, and configuration options.
+
+### Authentication
+
+Before using claudetm, you need to authenticate with Claude:
+
+```bash
+# Run Claude CLI and login (this saves credentials that claudetm will use)
+claude
+/login
 
-# Verify setup
+# Verify claudetm can access credentials
 claudetm doctor
+```
+
+**For Docker users:** Ensure your `~/.claude/.credentials.json` exists before running the container, as Claude Task Master needs OAuth credentials to function.
+
+### Upgrading
+
+**With uv:**
+```bash
+uv tool install claude-task-master --force --reinstall
+```
 
-# Run a task
+**With pip:**
+```bash
+pip install --upgrade claude-task-master
+```
+
+**With Docker:**
+```bash
+# Pull the latest image
+docker pull ghcr.io/developerz-ai/claude-task-master:latest
+
+# Restart your container with the new image
+docker-compose up -d
+```
+
+**Check version:**
+```bash
+claudetm --version
+```
+
+### Run a Task
+
+**Using the CLI:**
+```bash
 cd your-project
 claudetm start "Add user authentication with tests"
 ```
 
+**Using Docker:**
+```bash
+# Task execution is handled through the unified server
+# Create tasks via the REST API or MCP interface
+curl -H "Authorization: Bearer password" \
+     http://localhost:8000/tasks -X POST \
+     -d '{"goal": "Add user authentication"}'
+```
+
 ## Overview
 
 Claude Task Master uses the Claude Agent SDK to autonomously work on complex tasks. Give it a goal, and it will:
@@ -212,6 +290,17 @@ To use OpenRouter instead of direct Anthropic API:
 CLAUDETM_DEBUG=1 claudetm status
 ```
 
+## Documentation
+
+Complete documentation for all features and deployment options:
+
+| Guide | Description |
+|-------|-------------|
+| **[Docker Deployment](./docs/docker.md)** | Docker installation, configuration, volume mounts, and production deployment |
+| **[Authentication](./docs/authentication.md)** | Password-based authentication for REST API, MCP server, and webhooks |
+| **[REST API Reference](./docs/api-reference.md)** | Complete REST API endpoint documentation with examples |
+| **[Webhooks](./docs/webhooks.md)** | Webhook events, payload formats, HMAC signature verification, and integration examples |
+
 ## Usage
 
 ### CLI Commands
@@ -420,6 +509,49 @@ claudetm context
 
 The system follows SOLID principles with strict Single Responsibility:
 
+### Server Architecture
+
+When running with the unified server (`claudetm-server`), the following components work together:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                      Claude Task Master Server                       │
+│                                                                       │
+│  ┌──────────────┐   ┌──────────────┐   ┌──────────────┐             │
+│  │  REST API    │   │  MCP Server  │   │   Webhooks   │             │
+│  │  (FastAPI)   │   │  (FastMCP)   │   │   (httpx)    │             │
+│  └──────┬───────┘   └──────┬───────┘   └──────┬───────┘             │
+│         │                  │                  │                      │
+│         └──────────────────┼──────────────────┘                      │
+│                            │                                         │
+│                    ┌───────▼───────┐                                 │
+│                    │ Auth Module   │                                 │
+│                    │ (Password)    │                                 │
+│                    └───────────────┘                                 │
+└─────────────────────────────────────────────────────────────────────┘
+
+Docker Container:
+┌─────────────────────────────────────────────────────────────────────┐
+│  claudetm-server                                                     │
+│                                                                       │
+│  Volumes:                                                            │
+│  - /app/project → project directory                                 │
+│  - /root/.claude → Claude credentials (~/.claude)                   │
+│                                                                       │
+│  Env: CLAUDETM_PASSWORD, CLAUDETM_WEBHOOK_URL, ...                   │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**Server Features:**
+- **REST API** - Create and manage tasks, view status, manage webhooks
+- **MCP Server** - Claude editor integration for native IDE support
+- **Webhooks** - Send notifications on task events with HMAC verification
+- **Unified Authentication** - Single password protects all three interfaces
+- **Docker Ready** - Multi-arch image published to GitHub Container Registry
+
+For detailed Docker deployment, see [Docker Deployment Guide](./docs/docker.md).
+For authentication details, see [Authentication Guide](./docs/authentication.md).
+
 ### Core Components
 
 | Component | Responsibility |

{claude_task_master-0.1.1 → claude_task_master-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-task-master"
-version = "0.1.1"
+version = "0.1.3"
 description = "Autonomous task orchestration system that keeps Claude working until a goal is achieved"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -42,7 +42,16 @@ Changelog = "https://github.com/developerz-ai/claude-task-master/blob/main/CHANG
 
 [project.optional-dependencies]
 mcp = ["mcp>=1.0.0"]
+api = [
+    "fastapi>=0.100.0",
+    "uvicorn[standard]>=0.24.0",
+    # Note: passlib (last release: 1.7.4, Oct 2020) is unmaintained but has no known CVEs.
+    # It's widely used and bcrypt is timing-safe. Consider argon2-cffi as future alternative.
+    "passlib[bcrypt]>=1.7.4",
+    "bcrypt>=4.0.0,<4.1.0",  # Pin bcrypt for passlib compatibility
+]
 dev = [
+    "claude-task-master[api]",  # Include API dependencies for testing
     "pytest>=8.0.0",
     "pytest-cov>=4.1.0",
     "pytest-asyncio>=0.23.0",
@@ -51,7 +60,7 @@ dev = [
     "mypy>=1.9.0",
 ]
 all = [
-    "claude-task-master[mcp,dev]",
+    "claude-task-master[mcp,api,dev]",
 ]
 
 [project.scripts]
@@ -61,6 +70,10 @@ claudetm = "claude_task_master.wrapper:main"
 claudetm-py = "claude_task_master.cli:app"
 # MCP server entry point
 claudetm-mcp = "claude_task_master.mcp.server:main"
+# REST API server entry point
+claudetm-api = "claude_task_master.api.server:main"
+# Unified server entry point (REST API + MCP together)
+claudetm-server = "claude_task_master.server:main"
 
 # Setuptools configuration
 [tool.setuptools.packages.find]
@@ -117,6 +130,14 @@ ignore_missing_imports = true
 module = "mcp.*"
 ignore_missing_imports = true
 
+[[tool.mypy.overrides]]
+module = ["fastapi.*", "uvicorn.*"]
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = "passlib.*"
+ignore_missing_imports = true
+
 [[tool.mypy.overrides]]
 module = "tests.*"
 disallow_untyped_defs = false

{claude_task_master-0.1.1 → claude_task_master-0.1.3}/src/claude_task_master/__init__.py

@@ -3,5 +3,5 @@
 Uses Claude Agent SDK to keep Claude working until a goal is achieved.
 """
 
-__version__ = "0.1.1"
+__version__ = "0.1.3"
 __all__ = ["__version__"]

claude_task_master-0.1.3/src/claude_task_master/api/__init__.py

@@ -0,0 +1,98 @@
+"""REST API layer for Claude Task Master.
+
+This module provides a FastAPI-based REST API that exposes claudetm functionality
+as HTTP endpoints for remote task monitoring.
+
+Currently Implemented Endpoints:
+- GET /status: Get current task status
+- GET /plan: Get task plan content
+- GET /logs: Get log content
+- GET /progress: Get progress summary
+- GET /context: Get accumulated context/learnings
+- GET /health: Health check endpoint
+
+Usage:
+    # Import and create the app
+    from claude_task_master.api import create_app
+
+    app = create_app()
+
+    # Or run directly
+    from claude_task_master.api import run_server
+
+    run_server(host="0.0.0.0", port=8000)
+"""
+
+# API components - imported as they are implemented
+from claude_task_master.api.models import (
+    # Response models
+    APIInfo,
+    # Request models
+    ConfigUpdateRequest,
+    ContextResponse,
+    ControlResponse,
+    ErrorResponse,
+    HealthResponse,
+    # Enums
+    LogFormat,
+    LogLevel,
+    LogsResponse,
+    PauseRequest,
+    PlanResponse,
+    ProgressResponse,
+    ResumeRequest,
+    StopRequest,
+    TaskDeleteResponse,
+    TaskInitRequest,
+    TaskInitResponse,
+    TaskListItem,
+    TaskListResponse,
+    TaskOptionsResponse,
+    TaskProgressInfo,
+    TaskStatus,
+    TaskStatusResponse,
+    WorkflowStage,
+)
+
+# Routes
+from claude_task_master.api.routes import create_info_router, register_routes
+
+# Server components
+from claude_task_master.api.server import create_app, get_app, run_server
+
+__all__: list[str] = [
+    # Server
+    "create_app",
+    "run_server",
+    "get_app",
+    # Enums
+    "TaskStatus",
+    "WorkflowStage",
+    "LogLevel",
+    "LogFormat",
+    # Request models
+    "PauseRequest",
+    "StopRequest",
+    "ResumeRequest",
+    "ConfigUpdateRequest",
+    "TaskInitRequest",
+    # Response models
+    "TaskStatusResponse",
+    "TaskOptionsResponse",
+    "TaskProgressInfo",
+    "ControlResponse",
+    "PlanResponse",
+    "LogsResponse",
+    "ProgressResponse",
+    "ContextResponse",
+    "TaskListItem",
+    "TaskListResponse",
+    "HealthResponse",
+    "TaskInitResponse",
+    "TaskDeleteResponse",
+    "ErrorResponse",
+    "APIInfo",
+    # Routes
+    "create_info_router",
+    "register_routes",
+]