Skip to content
This repository was archived by the owner on Nov 10, 2026. It is now read-only.
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

### Removed

- **The inert `claudetm start --checkpointing` flag, `TaskOptions.enable_checkpointing`, and the `enable_checkpointing` REST/MCP config field.** Nothing read the option and no checkpoint manager was wired into a run, so the flag advertised rollbacks that never existed. The REST `POST /config` request and `/status` options response and the MCP `update_config` tool no longer carry the field, and the docs and examples that presented checkpointing as a feature are gone. A `state.json` that still contains `enable_checkpointing` under `options` loads normally (the key is ignored) and is dropped on the next save.
- **Removed the dead public helper `get_context_window` from `claude_task_master.core`.** Defined in `core/agent_models.py`, re-exported through the `core` package facade and referenced by a docstring clause in `core/config.py`, it had no caller anywhere in the codebase, and its return value set no compaction threshold and no SDK context window — a model-to-window mapping nothing consumed. The data behind it is retained: `MODEL_CONTEXT_WINDOWS`, `MODEL_CONTEXT_WINDOWS_STANDARD`, `DEFAULT_COMPACT_THRESHOLD_PERCENT` and `ContextWindowsConfig` are unchanged; only the unreachable accessor and the text naming it are deleted.
- **Removed the dead `_format_pr_comments` GraphQL formatter (`github/client_pr_helpers.py`).** The REST path `_format_pr_comments_from_rest` is the only PR-comment formatter with a caller; the GraphQL variant had no call site anywhere in the codebase and no test references it. Removed together with its entry in both `__all__` lists (`client_pr_helpers.py` and `client_pr.py`) and the corresponding `client_pr` backward-compat re-export; the five live sibling helpers are unchanged.

Expand Down
4 changes: 0 additions & 4 deletions docs/api-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,6 @@ Get comprehensive status information about the current task.
"max_sessions": 10,
"max_prs": null,
"pause_on_pr": false,
"enable_checkpointing": false,
"log_level": "normal",
"log_format": "text",
"pr_per_task": false,
Expand All @@ -175,8 +174,6 @@ 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 @@ -422,7 +419,6 @@ Update runtime task configuration options.
- `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) - 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
Expand Down
1 change: 0 additions & 1 deletion docs/mcp-tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -444,7 +444,6 @@ Update task configuration options at runtime.
| `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 | 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
9 changes: 0 additions & 9 deletions examples/08-advanced-workflows.md
Original file line number Diff line number Diff line change
Expand Up @@ -334,15 +334,6 @@ claudetm start "Add pagination to API" --model sonnet
claudetm start "Design and implement microservice architecture" --model opus
```

### 5. Checkpointing for Safety

```bash
# Enable checkpointing for risky changes
claudetm start "Major database schema refactor" --checkpointing

# If something goes wrong, checkpoint allows rollback
```

## Handling Edge Cases

### CI Failures During Multi-Step Process
Expand Down
9 changes: 0 additions & 9 deletions examples/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,15 +102,6 @@ claudetm start "Complex task" --max-sessions 10
# Stops after 10 work sessions
```

## Checkpointing (Experimental)

Enable file checkpointing for safe rollbacks:

```bash
claudetm start "Risky refactor" --checkpointing
# Can rollback changes if things go wrong
```

## Troubleshooting

### Check System Setup
Expand Down
11 changes: 0 additions & 11 deletions src/claude_task_master/api/models_task.py
Original file line number Diff line number Diff line change
Expand Up @@ -114,8 +114,6 @@ 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: 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 @@ -154,12 +152,6 @@ class ConfigUpdateRequest(_RemovedFieldGuard):
default=None,
description="Whether to pause after creating PR for manual review",
)
enable_checkpointing: bool | None = Field(
default=None,
description=(
"Accepted and stored, but has no effect because no checkpointing is implemented"
),
)
log_level: LogLevel | None = Field(
default=None,
description="Log level (quiet, normal, verbose)",
Expand Down Expand Up @@ -291,8 +283,6 @@ 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: 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 All @@ -305,7 +295,6 @@ class TaskOptionsResponse(BaseModel):
max_sessions: int | None
max_prs: int | None
pause_on_pr: bool
enable_checkpointing: bool
log_level: str
log_format: str
pr_per_task: bool
Expand Down
1 change: 0 additions & 1 deletion src/claude_task_master/api/routes_info.py
Original file line number Diff line number Diff line change
Expand Up @@ -161,7 +161,6 @@ async def get_status(request: Request) -> TaskStatusResponse | JSONResponse:
max_sessions=state.options.max_sessions,
max_prs=state.options.max_prs,
pause_on_pr=state.options.pause_on_pr,
enable_checkpointing=state.options.enable_checkpointing,
log_level=state.options.log_level,
log_format=state.options.log_format,
pr_per_task=state.options.pr_per_task,
Expand Down
1 change: 0 additions & 1 deletion src/claude_task_master/api/routes_task.py
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,6 @@ async def init_task(
max_sessions=task_init.max_sessions,
max_prs=task_init.max_prs,
pause_on_pr=task_init.pause_on_pr,
enable_checkpointing=False, # Default to False
log_level="normal", # Default to normal
log_format="text", # Default to text
pr_per_task=False, # Default to False
Expand Down
6 changes: 0 additions & 6 deletions src/claude_task_master/cli_commands/workflow_start.py
Original file line number Diff line number Diff line change
Expand Up @@ -96,11 +96,6 @@ def start(
"--pause-on-pr",
help="Pause after creating PR for manual review",
),
enable_checkpointing: bool = typer.Option(
False,
"--checkpointing",
help="Accepted and stored, but has no effect because no checkpointing is implemented",
),
log_level: str = typer.Option(
"normal",
"--log-level",
Expand Down Expand Up @@ -253,7 +248,6 @@ def start(
max_sessions=max_sessions,
max_prs=max_prs,
pause_on_pr=pause_on_pr,
enable_checkpointing=enable_checkpointing,
log_level=log_level.lower(),
log_format=log_format.lower(),
pr_per_task=pr_per_task,
Expand Down
2 changes: 0 additions & 2 deletions src/claude_task_master/core/control_ops.py
Original file line number Diff line number Diff line change
Expand Up @@ -245,8 +245,6 @@ 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 - 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
2 changes: 0 additions & 2 deletions src/claude_task_master/core/state.py
Original file line number Diff line number Diff line change
Expand Up @@ -413,8 +413,6 @@ 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 - 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
1 change: 0 additions & 1 deletion src/claude_task_master/core/state_models.py
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,6 @@ class TaskOptions(BaseModel):
max_sessions: int | None = None
max_prs: int | None = None
pause_on_pr: bool = False
enable_checkpointing: bool = False
log_level: str = "normal" # quiet, normal, verbose
log_format: str = "text" # text, json
pr_per_task: bool = False # If True, create PR per task; if False, PR per group
Expand Down
2 changes: 0 additions & 2 deletions src/claude_task_master/mcp/server_specs.py
Original file line number Diff line number Diff line change
Expand Up @@ -192,8 +192,6 @@
" 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: 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
5 changes: 0 additions & 5 deletions src/claude_task_master/mcp/tool_handlers_control.py
Original file line number Diff line number Diff line change
Expand Up @@ -185,7 +185,6 @@ def update_config(
max_sessions: int | None = None,
max_prs: int | None = None,
pause_on_pr: bool | None = None,
enable_checkpointing: bool | None = None,
log_level: str | None = None,
log_format: str | None = None,
pr_per_task: bool | None = None,
Expand All @@ -207,8 +206,6 @@ 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: 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 All @@ -235,8 +232,6 @@ def update_config(
kwargs["max_prs"] = max_prs
if pause_on_pr is not None:
kwargs["pause_on_pr"] = pause_on_pr
if enable_checkpointing is not None:
kwargs["enable_checkpointing"] = enable_checkpointing
if log_level is not None:
kwargs["log_level"] = log_level
if log_format is not None:
Expand Down
2 changes: 0 additions & 2 deletions tests/api/test_auth.py
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,6 @@ def state_file(state_dir: Path) -> Path:
"auto_merge": True,
"max_sessions": 10,
"pause_on_pr": False,
"enable_checkpointing": False,
"log_level": "normal",
"log_format": "text",
"pr_per_task": False,
Expand Down Expand Up @@ -170,7 +169,6 @@ def test_health_returns_degraded_for_blocked_task(
"auto_merge": True,
"max_sessions": 10,
"pause_on_pr": False,
"enable_checkpointing": False,
"log_level": "normal",
"log_format": "text",
"pr_per_task": False,
Expand Down
103 changes: 0 additions & 103 deletions tests/api/test_doc_field_lists.py
Original file line number Diff line number Diff line change
Expand Up @@ -69,25 +69,6 @@
# uses for its parameter tables.
_ROW_RE = re.compile(r"^\|\s*`(?P<name>[A-Za-z_][A-Za-z0-9_]*)`(?P<rest>.*)$")

# Phrases that tell the reader the option is accepted and stored but does
# nothing - nothing in the tree implements checkpointing.
_INERT_PHRASES = (
"no effect",
"no checkpointing",
"not implemented",
"unimplemented",
"not supported",
"unsupported",
"inert",
"no-op",
"does nothing",
"ignored",
)

# Phrases that tell the reader the option is still accepted and stored.
_ACCEPTED_PHRASES = ("accepted", "stored")


# =============================================================================
# Markdown parsing
# =============================================================================
Expand Down Expand Up @@ -197,26 +178,6 @@ def _table_fields(block: list[str]) -> list[tuple[str, str]]:
return fields


def _prose(section: list[str]) -> list[str]:
"""The lines of a section that are not inside a fenced code block.

Args:
section: The lines of a section.

Returns:
The prose lines only.
"""
prose: list[str] = []
in_fence = False
for line in section:
if line.strip().startswith("```"):
in_fence = not in_fence
continue
if not in_fence:
prose.append(line)
return prose


def _json_blocks(section: list[str]) -> list[str]:
"""The bodies of the fenced code blocks of a section.

Expand Down Expand Up @@ -274,41 +235,6 @@ def _assert_same_fields(
)


def _assert_inert(text: str, label: str) -> None:
"""Assert that an option is documented as accepted but without effect.

Args:
text: The documented text of the option.
label: How the option is named in the failure message.

Raises:
AssertionError: If the text does not say the option is inert.
"""
lowered = text.lower()
assert any(phrase in lowered for phrase in _ACCEPTED_PHRASES), (
f"{label}: the option must be documented as accepted and stored, got: {text.strip()!r}"
)
assert any(phrase in lowered for phrase in _INERT_PHRASES), (
f"{label}: the option must be documented as having no effect, got: {text.strip()!r}"
)


def _field_text(fields: list[tuple[str, str]], name: str) -> str:
"""The documented text of one field.

Args:
fields: The parsed ``(name, text)`` pairs of a documented list.
name: The field to look up.

Returns:
The text that follows the field name, or an empty string.
"""
for field_name, rest in fields:
if field_name == name:
return rest
return ""


def _tool_parameters(fn: Callable[..., Any]) -> set[str]:
"""The parameters an MCP tool exposes to clients.

Expand Down Expand Up @@ -417,35 +343,6 @@ def test_mcp_tools_expose_no_parameters_beyond_the_model_fields_plus_state_dir()
)


# =============================================================================
# Checkpointing
# =============================================================================


def test_checkpointing_is_documented_as_accepted_but_inert() -> None:
"""Both config surfaces document `enable_checkpointing` as inert: nothing implements it."""
surfaces = {
"docs/api-reference.md PATCH /config": _bullet_fields(
_block_after_label(_API_REFERENCE, "#### `PATCH /config`", "**Supported Options:**")
),
"docs/mcp-tools.md update_config": _table_fields(
_block_after_label(_MCP_TOOLS, "#### `update_config`", "**Parameters:**")
),
}
for label, fields in surfaces.items():
text = _field_text(fields, "enable_checkpointing")
assert text, f"{label}: enable_checkpointing is not documented"
_assert_inert(text, f"{label} enable_checkpointing")


def test_status_sample_reports_checkpointing_as_inert() -> None:
"""The `GET /status` note says the reported checkpointing flag does nothing."""
prose = _prose(_section(_API_REFERENCE, "#### `GET /status`"))
mentions = " ".join(line for line in prose if "enable_checkpointing" in line)
assert mentions, "docs/api-reference.md GET /status does not mention enable_checkpointing"
_assert_inert(mentions, "docs/api-reference.md GET /status enable_checkpointing")


# =============================================================================
# Server behaviour
# =============================================================================
Expand Down
Loading
Loading