Skip to content
This repository was archived by the owner on Nov 10, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions docs/api-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,6 +148,8 @@ Get comprehensive status information about the current task.
"workflow_stage": "pr_created",
"options": {
"auto_merge": true,
"enable_release": false,
"enable_verification": false,
"max_sessions": 10,
"max_prs": null,
"pause_on_pr": false,
Expand All @@ -173,6 +175,8 @@ Get comprehensive status information about the current task.
}
```

**Note:** `enable_checkpointing` is reported for compatibility only: it is accepted and stored, but has no effect because no checkpointing is implemented.

**Status Values:**

- `planning` - Task is in planning phase
Expand Down Expand Up @@ -413,15 +417,16 @@ Update runtime task configuration options.
**Supported Options:**

- `auto_merge` (boolean) - Whether to auto-merge PRs once CI is green and review feedback is resolved (no approving review is required)
- `enable_release` (boolean) - Whether to run post-merge release verification
- `enable_verification` (boolean) - Whether to run final success-criteria verification + fix loop after all tasks complete
- `max_sessions` (integer, 1-1000) - Maximum work sessions before pausing
- `max_prs` (integer, 1-100) - Maximum number of pull requests to create
- `pause_on_pr` (boolean) - Whether to pause after creating PR
- `enable_checkpointing` (boolean) - Enable state checkpointing
- `enable_checkpointing` (boolean) - Accepted and stored, but has no effect because no checkpointing is implemented
- `log_level` (string) - Log level: `quiet`, `normal`, `verbose`
- `log_format` (string) - Log format: `text`, `json`
- `pr_per_task` (boolean) - Create PR per task vs per group
- `parallel` (boolean) - Whether a work session may split its one task across `hive-worker` subagents with disjoint write sets
- `max_budget_usd` (float) - Max spending per session in USD (null for unlimited)

**Note:** Only provide the fields you want to update. At least one field is required.

Expand Down Expand Up @@ -477,11 +482,12 @@ Initialize a new task with the given goal and options.
- `goal` (required, string, 1-10000 chars) - The goal to achieve
- `model` (optional, string) - Model to use: `opus`, `sonnet`, `haiku` (default: `opus`)
- `auto_merge` (optional, boolean) - Auto-merge PRs once CI is green and review feedback is resolved; no approving review is required (default: `true`)
- `enable_release` (optional, boolean) - Whether to run post-merge release verification (default: `false`)
- `enable_verification` (optional, boolean) - Whether to run final success-criteria verification + fix loop after all tasks complete (default: `false`)
- `max_sessions` (optional, integer, 1-1000) - Max sessions before pausing
- `max_prs` (optional, integer, 1-100) - Max pull requests to create
- `pause_on_pr` (optional, boolean) - Pause after creating PR (default: `false`)
- `parallel` (optional, boolean) - Let each work session split its ONE task across `hive-worker` subagents when the pieces have disjoint write sets (default: `true`). The lead sizes its own team; zero workers is a valid answer
- `budget` (optional, float) - Max spending per session in USD (default: unlimited)

**Response:** `TaskInitResponse` (201 Created)

Expand Down
6 changes: 5 additions & 1 deletion docs/mcp-tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -290,6 +290,8 @@ Initialize a new task with the given goal.
| `goal` | string | Yes | - | The goal to achieve |
| `model` | string | No | `opus` | Model to use (opus, sonnet, haiku) |
| `auto_merge` | boolean | No | `true` | Auto-merge PRs once CI is green and review feedback is resolved (no approving review required) |
| `enable_release` | boolean | No | `false` | Whether to run post-merge release verification |
| `enable_verification` | boolean | No | `false` | Whether to run final success-criteria verification + fix loop after all tasks complete |
| `max_sessions` | integer | No | - | Max work sessions before pausing |
| `max_prs` | integer | No | - | Max pull requests to create |
| `pause_on_pr` | boolean | No | `false` | Pause after creating PR |
Expand Down Expand Up @@ -437,10 +439,12 @@ Update task configuration options at runtime.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `auto_merge` | boolean | No | Auto-merge PRs once CI is green and review feedback is resolved (no approving review required) |
| `enable_release` | boolean | No | Whether to run post-merge release verification |
| `enable_verification` | boolean | No | Whether to run final success-criteria verification + fix loop after all tasks complete |
| `max_sessions` | integer | No | Max work sessions before pausing |
| `max_prs` | integer | No | Max pull requests to create |
| `pause_on_pr` | boolean | No | Pause after creating PR |
| `enable_checkpointing` | boolean | No | Enable state checkpointing |
| `enable_checkpointing` | boolean | No | Accepted and stored, but has no effect because no checkpointing is implemented |
| `log_level` | string | No | Log level: quiet, normal, verbose |
| `log_format` | string | No | Log format: text, json |
| `pr_per_task` | boolean | No | Create PR per task vs per group |
Expand Down
10 changes: 7 additions & 3 deletions src/claude_task_master/api/models_task.py
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,8 @@ class ConfigUpdateRequest(_RemovedFieldGuard):
max_sessions: Maximum number of work sessions before pausing.
max_prs: Maximum number of pull requests to create.
pause_on_pr: Whether to pause after creating PR for manual review.
enable_checkpointing: Whether to enable state checkpointing.
enable_checkpointing: Accepted and stored, but has no effect because no
checkpointing is implemented.
log_level: Log level (quiet, normal, verbose).
log_format: Log format (text, json).
pr_per_task: Whether to create PR per task vs per group.
Expand Down Expand Up @@ -155,7 +156,9 @@ class ConfigUpdateRequest(_RemovedFieldGuard):
)
enable_checkpointing: bool | None = Field(
default=None,
description="Whether to enable state checkpointing",
description=(
"Accepted and stored, but has no effect because no checkpointing is implemented"
),
)
log_level: LogLevel | None = Field(
default=None,
Expand Down Expand Up @@ -288,7 +291,8 @@ class TaskOptionsResponse(BaseModel):
max_sessions: Maximum number of work sessions before pausing.
max_prs: Maximum number of pull requests to create.
pause_on_pr: Whether to pause after creating PR for manual review.
enable_checkpointing: Whether state checkpointing is enabled.
enable_checkpointing: Accepted and stored, but has no effect because no
checkpointing is implemented.
log_level: Current log level.
log_format: Current log format.
pr_per_task: Whether to create PR per task vs per group.
Expand Down
2 changes: 1 addition & 1 deletion src/claude_task_master/cli_commands/workflow_start.py
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ def start(
enable_checkpointing: bool = typer.Option(
False,
"--checkpointing",
help="Enable file checkpointing for safe rollbacks",
help="Accepted and stored, but has no effect because no checkpointing is implemented",
),
log_level: str = typer.Option(
"normal",
Expand Down
3 changes: 2 additions & 1 deletion src/claude_task_master/core/control_ops.py
Original file line number Diff line number Diff line change
Expand Up @@ -245,7 +245,8 @@ def update_config(self, **kwargs: Any) -> ControlResult:
- auto_merge: bool - Whether to auto-merge PRs
- max_sessions: int | None - Maximum number of sessions
- pause_on_pr: bool - Whether to pause on PR creation
- enable_checkpointing: bool - Whether to enable checkpointing
- enable_checkpointing: bool - Accepted and stored, but has no effect
(no checkpointing is implemented)
- log_level: str - Log level (quiet, normal, verbose)
- log_format: str - Log format (text, json)
- pr_per_task: bool - Whether to create PR per task
Expand Down
3 changes: 2 additions & 1 deletion src/claude_task_master/core/state.py
Original file line number Diff line number Diff line change
Expand Up @@ -413,7 +413,8 @@ def update_options(
- auto_merge: bool - Whether to auto-merge PRs
- max_sessions: int | None - Maximum number of sessions
- pause_on_pr: bool - Whether to pause on PR creation
- enable_checkpointing: bool - Whether to enable checkpointing
- enable_checkpointing: bool - Accepted and stored, but has no effect
(no checkpointing is implemented)
- log_level: str - Log level (quiet, normal, verbose)
- log_format: str - Log format (text, json)
- pr_per_task: bool - Whether to create PR per task
Expand Down
3 changes: 2 additions & 1 deletion src/claude_task_master/mcp/server_specs.py
Original file line number Diff line number Diff line change
Expand Up @@ -192,7 +192,8 @@
" max_sessions: Maximum number of work sessions before pausing.\n"
" max_prs: Maximum number of pull requests to create.\n"
" pause_on_pr: Whether to pause after creating PR for manual review.\n"
" enable_checkpointing: Whether to enable state checkpointing.\n"
" enable_checkpointing: Accepted and stored, but has no effect because\n"
" no checkpointing is implemented.\n"
" log_level: Log level (quiet, normal, verbose).\n"
" log_format: Log format (text, json).\n"
" pr_per_task: Whether to create PR per task vs per group.\n"
Expand Down
3 changes: 2 additions & 1 deletion src/claude_task_master/mcp/tool_handlers_control.py
Original file line number Diff line number Diff line change
Expand Up @@ -207,7 +207,8 @@ def update_config(
max_sessions: Maximum number of work sessions before pausing.
max_prs: Maximum number of pull requests to create.
pause_on_pr: Whether to pause after creating PR for manual review.
enable_checkpointing: Whether to enable state checkpointing.
enable_checkpointing: Accepted and stored, but has no effect because no
checkpointing is implemented.
log_level: Log level (quiet, normal, verbose).
log_format: Log format (text, json).
pr_per_task: Whether to create PR per task vs per group.
Expand Down
Loading
Loading