claude-task-master 0.1.8__py3-none-any.whl → 0.1.10__py3-none-any.whl

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.8"
+__version__ = "0.1.10"
 __all__ = ["__version__"]

claude_task_master/api/models.py

@@ -25,6 +25,7 @@ Response Models:
 - CloneRepoResponse: Result of cloning a repository
 - SetupRepoResponse: Result of setting up a repository
 - PlanRepoResponse: Result of planning for a repository
+- DeleteCodingStyleResponse: Result of deleting coding-style.md
 
 Usage:
     from claude_task_master.api.models import (
@@ -47,7 +48,7 @@ Usage:
 from __future__ import annotations
 
 from datetime import datetime
-from enum import Enum
+from enum import Enum, StrEnum
 from typing import Any
 
 from pydantic import BaseModel, Field
@@ -57,7 +58,7 @@ from pydantic import BaseModel, Field
 # =============================================================================
 
 
-class TaskStatus(str, Enum):
+class TaskStatus(StrEnum):
     """Valid task status values."""
 
     PLANNING = "planning"
@@ -69,7 +70,7 @@ class TaskStatus(str, Enum):
     FAILED = "failed"
 
 
-class WorkflowStage(str, Enum):
+class WorkflowStage(StrEnum):
     """Valid workflow stage values for PR lifecycle."""
 
     WORKING = "working"
@@ -82,7 +83,7 @@ class WorkflowStage(str, Enum):
     MERGED = "merged"
 
 
-class LogLevel(str, Enum):
+class LogLevel(StrEnum):
     """Valid log level values."""
 
     QUIET = "quiet"
@@ -90,7 +91,7 @@ class LogLevel(str, Enum):
     VERBOSE = "verbose"
 
 
-class LogFormat(str, Enum):
+class LogFormat(StrEnum):
     """Valid log format values."""
 
     TEXT = "text"
@@ -158,6 +159,7 @@ class ConfigUpdateRequest(BaseModel):
     Attributes:
         auto_merge: Whether to auto-merge PRs when approved.
         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.
         log_level: Log level (quiet, normal, verbose).
@@ -175,6 +177,12 @@ class ConfigUpdateRequest(BaseModel):
         le=1000,
         description="Maximum number of work sessions before pausing",
     )
+    max_prs: int | None = Field(
+        default=None,
+        ge=1,
+        le=100,
+        description="Maximum number of pull requests to create",
+    )
     pause_on_pr: bool | None = Field(
         default=None,
         description="Whether to pause after creating PR for manual review",
@@ -227,6 +235,7 @@ class TaskInitRequest(BaseModel):
         model: Model to use (opus, sonnet, haiku).
         auto_merge: Whether to auto-merge PRs when approved.
         max_sessions: Max work sessions before pausing.
+        max_prs: Max pull requests to create.
         pause_on_pr: Pause after creating PR for manual review.
     """
 
@@ -252,6 +261,12 @@ class TaskInitRequest(BaseModel):
         le=1000,
         description="Maximum number of work sessions before pausing",
     )
+    max_prs: int | None = Field(
+        default=None,
+        ge=1,
+        le=100,
+        description="Maximum number of pull requests to create",
+    )
     pause_on_pr: bool = Field(
         default=False,
         description="Pause after creating PR for manual review",
@@ -383,6 +398,7 @@ class TaskOptionsResponse(BaseModel):
     Attributes:
         auto_merge: Whether to auto-merge PRs when approved.
         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.
         log_level: Current log level.
@@ -392,6 +408,7 @@ class TaskOptionsResponse(BaseModel):
 
     auto_merge: bool
     max_sessions: int | None
+    max_prs: int | None
     pause_on_pr: bool
     enable_checkpointing: bool
     log_level: str
@@ -860,3 +877,24 @@ class PlanRepoResponse(BaseModel):
     criteria: str | None = None
     run_id: str | None = None
     error: str | None = None
+
+
+# =============================================================================
+# Coding Style Response Models
+# =============================================================================
+
+
+class DeleteCodingStyleResponse(BaseModel):
+    """Response model for deleting the coding-style.md file.
+
+    Attributes:
+        success: Whether the deletion operation succeeded.
+        message: Human-readable result message.
+        file_existed: Whether the file existed before deletion.
+        error: Error message if deletion failed.
+    """
+
+    success: bool
+    message: str
+    file_existed: bool = False
+    error: str | None = None

claude_task_master/api/routes.py

@@ -10,6 +10,7 @@ Endpoints:
 - GET /progress: Get progress summary
 - GET /context: Get accumulated context/learnings
 - GET /health: Health check endpoint
+- DELETE /coding-style: Delete the coding-style.md file
 - POST /task/init: Initialize a new task
 - DELETE /task: Delete/cleanup current task
 - POST /control/stop: Stop a running task with optional cleanup
@@ -51,6 +52,7 @@ from claude_task_master.api.models import (
     ConfigUpdateRequest,
     ContextResponse,
     ControlResponse,
+    DeleteCodingStyleResponse,
     ErrorResponse,
     HealthResponse,
     LogsResponse,
@@ -285,6 +287,7 @@ def create_info_router() -> APIRouter:
                 options=TaskOptionsResponse(
                     auto_merge=state.options.auto_merge,
                     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,
@@ -613,6 +616,68 @@ def create_info_router() -> APIRouter:
             active_tasks=active_tasks,
         )
 
+    @router.delete(
+        "/coding-style",
+        response_model=DeleteCodingStyleResponse,
+        responses={
+            404: {"model": ErrorResponse, "description": "No active task found"},
+            500: {"model": ErrorResponse, "description": "Internal server error"},
+        },
+        summary="Delete Coding Style",
+        description="Delete the coding-style.md file from the state directory.",
+    )
+    async def delete_coding_style(request: Request) -> DeleteCodingStyleResponse | JSONResponse:
+        """Delete the coding-style.md file.
+
+        Removes the coding-style.md file from the state directory. This file
+        contains extracted coding conventions and is regenerated on the next run.
+
+        Returns:
+            DeleteCodingStyleResponse indicating whether the file was deleted.
+
+        Raises:
+            404: If no active task exists.
+            500: If an error occurs during deletion.
+        """
+        state_manager = _get_state_manager(request)
+
+        if not state_manager.exists():
+            return JSONResponse(
+                status_code=404,
+                content=ErrorResponse(
+                    error="not_found",
+                    message="No active task found",
+                    suggestion="Start a new task with 'claudetm start <goal>'",
+                ).model_dump(),
+            )
+
+        try:
+            file_existed = state_manager.delete_coding_style()
+
+            if file_existed:
+                return DeleteCodingStyleResponse(
+                    success=True,
+                    message="Coding style file deleted successfully",
+                    file_existed=True,
+                )
+            else:
+                return DeleteCodingStyleResponse(
+                    success=True,
+                    message="Coding style file did not exist",
+                    file_existed=False,
+                )
+
+        except Exception as e:
+            logger.exception("Error deleting coding style file")
+            return JSONResponse(
+                status_code=500,
+                content=ErrorResponse(
+                    error="internal_error",
+                    message="Failed to delete coding style file",
+                    detail=str(e),
+                ).model_dump(),
+            )
+
     return router
 
 
@@ -1004,6 +1069,7 @@ def create_task_router() -> APIRouter:
             options = TaskOptions(
                 auto_merge=task_init.auto_merge,
                 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
@@ -1356,7 +1422,9 @@ def register_routes(app: FastAPI) -> None:
     repo_router = create_repo_router()
     app.include_router(repo_router, prefix="/repo")
 
-    logger.debug("Registered info routes: /status, /plan, /logs, /progress, /context, /health")
+    logger.debug(
+        "Registered info routes: /status, /plan, /logs, /progress, /context, /health, /coding-style"
+    )
     logger.debug("Registered control routes: /control/stop, /control/resume, /config")
     logger.debug("Registered task routes: /task/init, /task")
     logger.debug("Registered webhook routes: /webhooks, /webhooks/{id}, /webhooks/test")

claude_task_master/cli_commands/workflow.py

@@ -113,6 +113,11 @@ def start(
         "-n",
         help="Max work sessions before pausing (default: unlimited)",
     ),
+    max_prs: int | None = typer.Option(
+        None,
+        "--prs",
+        help="Max pull requests to create (default: unlimited)",
+    ),
     pause_on_pr: bool = typer.Option(
         False,
         "--pause-on-pr",
@@ -158,6 +163,8 @@ def start(
         claudetm start "Add dark mode toggle"
         claudetm start "Fix bug #123" -m opus --no-auto-merge
         claudetm start "Refactor auth" -n 5 --pause-on-pr
+        claudetm start "Add user auth" --prs 1
+        claudetm start "Implement dashboard" --prs 3 --max-sessions 10
         claudetm start "Debug issue" -l verbose --log-format json
         claudetm start "Deploy feature" --webhook-url https://example.com/hooks
 
@@ -212,6 +219,7 @@ def start(
         options = TaskOptions(
             auto_merge=auto_merge,
             max_sessions=max_sessions,
+            max_prs=max_prs,
             pause_on_pr=pause_on_pr,
             enable_checkpointing=enable_checkpointing,
             log_level=log_level.lower(),

claude_task_master/core/agent.py

@@ -171,7 +171,11 @@ class AgentWrapper:
             )
 
     def run_planning_phase(
-        self, goal: str, context: str = "", coding_style: str | None = None
+        self,
+        goal: str,
+        context: str = "",
+        coding_style: str | None = None,
+        max_prs: int | None = None,
     ) -> dict[str, Any]:
         """Run planning phase with read-only tools.
 
@@ -182,10 +186,11 @@ class AgentWrapper:
             goal: The goal to plan for.
             context: Additional context for planning.
             coding_style: Optional coding style guide to inject into prompt.
+            max_prs: Optional maximum number of PRs to create.
 
         Delegates to AgentPhaseExecutor for implementation.
         """
-        return self._phase_executor.run_planning_phase(goal, context, coding_style)
+        return self._phase_executor.run_planning_phase(goal, context, coding_style, max_prs)
 
     def generate_coding_style(self) -> dict[str, Any]:
         """Generate a coding style guide by analyzing the codebase.

claude_task_master/core/agent_message.py

@@ -79,10 +79,25 @@ class MessageProcessor:
                             self.logger.log_tool_result(block.tool_use_id, "completed")
 
         # Collect final result from ResultMessage
+        # Important: Only use message.result if we have no accumulated text,
+        # or if message.result contains content not in our accumulated text.
+        # This preserves verification markers (VERIFICATION_RESULT: PASS/FAIL)
+        # that may be output in earlier TextBlocks.
         if message_type == "ResultMessage":
-            if hasattr(message, "result"):
-                result_text = message.result
-                console.newline()  # Add newline after completion
+            if hasattr(message, "result") and message.result:
+                # If we have no accumulated text, use the result
+                if not result_text.strip():
+                    result_text = message.result
+                    console.newline()  # Add newline after completion
+                # If message.result contains verification markers we're missing,
+                # prefer message.result (it might be more complete)
+                elif (
+                    "verification_result:" in message.result.lower()
+                    and "verification_result:" not in result_text.lower()
+                ):
+                    result_text = message.result
+                    console.newline()  # Add newline after completion
+                # Otherwise keep our accumulated text (it has the markers)
 
         return result_text
 

claude_task_master/core/agent_phases.py

@@ -111,7 +111,11 @@ class AgentPhaseExecutor:
         self.process_message_func = process_message_func
 
     def run_planning_phase(
-        self, goal: str, context: str = "", coding_style: str | None = None
+        self,
+        goal: str,
+        context: str = "",
+        coding_style: str | None = None,
+        max_prs: int | None = None,
     ) -> dict[str, Any]:
         """Run planning phase with read-only tools.
 
@@ -122,6 +126,7 @@ class AgentPhaseExecutor:
             goal: The goal to plan for.
             context: Additional context for planning.
             coding_style: Optional coding style guide to inject into prompt.
+            max_prs: Optional maximum number of PRs to create.
 
         Returns:
             Dict with 'plan', 'criteria', and 'raw_output' keys.
@@ -131,6 +136,7 @@ class AgentPhaseExecutor:
             goal=goal,
             context=context if context else None,
             coding_style=coding_style,
+            max_prs=max_prs,
         )
 
         # Always use Opus for planning (smartest model)

claude_task_master/core/orchestrator.py

@@ -1357,6 +1357,9 @@ After completing your fixes, end with: TASK COMPLETE"""
     def _wait_for_fix_pr_merge(self, state: TaskState) -> bool:
         """Wait for fix PR to pass CI and merge it.
 
+        If CI fails, attempts to fix the issues (up to 2 retries) before giving up.
+        This mirrors the regular PR workflow where CI failures trigger fix sessions.
+
         Args:
             state: Current task state.
 
@@ -1377,7 +1380,68 @@ After completing your fixes, end with: TASK COMPLETE"""
             console.warning(f"Could not detect fix PR: {e}")
             return False
 
-        # Poll CI until success or failure
+        # Allow up to 2 CI fix attempts before giving up
+        max_ci_fix_attempts = 1  # 0 and 1 = 2 attempts
+        ci_fix_attempt = 0
+
+        while ci_fix_attempt <= max_ci_fix_attempts:
+            # Poll CI until success or failure
+            ci_result = self._poll_fix_pr_ci(pr_number, state)
+
+            if ci_result == "success":
+                # CI passed, proceed to merge
+                break
+            elif ci_result == "failure":
+                ci_fix_attempt += 1
+                if ci_fix_attempt > max_ci_fix_attempts:
+                    console.error(f"Fix PR CI failed after {max_ci_fix_attempts} fix attempts")
+                    return False
+
+                # Attempt to fix the CI failure
+                console.info(
+                    f"Attempting to fix CI failure ({ci_fix_attempt}/{max_ci_fix_attempts})..."
+                )
+                if not self._fix_pr_ci_failure(pr_number, state):
+                    console.error("Failed to fix CI issues")
+                    return False
+
+                # Wait for CI to restart after push
+                console.info("Waiting 30s for CI to restart...")
+                if not interruptible_sleep(30):
+                    return False
+            else:
+                # Interrupted or timed out
+                return False
+
+        # Merge the PR
+        if state.options.auto_merge:
+            try:
+                console.info(f"Merging fix PR #{pr_number}...")
+                self.github_client.merge_pr(pr_number)
+                console.success(f"Fix PR #{pr_number} merged!")
+
+                # Checkout back to target branch
+                self._checkout_to_main()
+
+                return True
+            except Exception as e:
+                console.error(f"Failed to merge fix PR: {e}")
+                return False
+        else:
+            console.info(f"Fix PR #{pr_number} ready to merge (auto_merge disabled)")
+            console.detail("Merge manually then run 'claudetm resume'")
+            return False
+
+    def _poll_fix_pr_ci(self, pr_number: int, state: TaskState) -> str:
+        """Poll CI status for a fix PR.
+
+        Args:
+            pr_number: The PR number to check.
+            state: Current task state.
+
+        Returns:
+            "success" if CI passed, "failure" if CI failed, "interrupted" if cancelled.
+        """
         max_wait = 600  # 10 minutes max
         poll_interval = 10
         waited = 0
@@ -1388,40 +1452,84 @@ After completing your fixes, end with: TASK COMPLETE"""
 
                 if pr_status.ci_state == "SUCCESS":
                     console.success("Fix PR CI passed!")
-                    break
+                    return "success"
                 elif pr_status.ci_state in ("FAILURE", "ERROR"):
-                    console.error("Fix PR CI failed - cannot auto-merge")
-                    return False
+                    console.warning("Fix PR CI failed")
+                    return "failure"
                 else:
                     console.info(f"Waiting for fix PR CI... ({pr_status.checks_pending} pending)")
                     if not interruptible_sleep(poll_interval):
-                        return False
+                        return "interrupted"
                     waited += poll_interval
             except Exception as e:
                 console.warning(f"Error checking CI: {e}")
                 if not interruptible_sleep(poll_interval):
-                    return False
+                    return "interrupted"
                 waited += poll_interval
 
-        if waited >= max_wait:
-            console.warning("Timed out waiting for fix PR CI")
-            return False
+        console.warning("Timed out waiting for fix PR CI")
+        return "interrupted"
 
-        # Merge the PR
-        if state.options.auto_merge:
-            try:
-                console.info(f"Merging fix PR #{pr_number}...")
-                self.github_client.merge_pr(pr_number)
-                console.success(f"Fix PR #{pr_number} merged!")
+    def _fix_pr_ci_failure(self, pr_number: int, state: TaskState) -> bool:
+        """Fix CI failures on a fix PR.
 
-                # Checkout back to target branch
-                self._checkout_to_main()
+        Saves CI failure logs and runs an agent to fix the issues.
 
-                return True
-            except Exception as e:
-                console.error(f"Failed to merge fix PR: {e}")
+        Args:
+            pr_number: The PR number with failing CI.
+            state: Current task state.
+
+        Returns:
+            True if fix session completed successfully.
+        """
+        try:
+            # Save CI failure logs
+            self.pr_context.save_ci_failures(pr_number)
+
+            # Get feedback (CI failures)
+            has_ci, has_comments, pr_dir_path = self.pr_context.get_combined_feedback(pr_number)
+
+            if not has_ci and not has_comments:
+                console.warning("No CI failures or comments found to fix")
                 return False
-        else:
-            console.info(f"Fix PR #{pr_number} ready to merge (auto_merge disabled)")
-            console.detail("Merge manually then run 'claudetm resume'")
+
+            # Build task description
+            ci_path = f"{pr_dir_path}/ci/" if pr_dir_path else ".claude-task-master/debugging/"
+
+            task_description = f"""
+Fix PR CI Failure
+
+The CI checks have failed for this fix PR. Your task is to:
+
+1. Read the CI failure logs in `{ci_path}`
+2. Understand what tests/lints are failing
+3. Fix the issues in the codebase
+4. Run tests locally to verify fixes (check package.json, Makefile, or pyproject.toml for test commands)
+5. Commit and push the fixes
+
+Important:
+- Only fix issues identified in the CI logs
+- Run tests locally before committing
+- Push changes to trigger a new CI run
+"""
+
+            # Run agent to fix issues
+            context = self.state_manager.load_context()
+            coding_style = self.state_manager.load_coding_style()
+
+            current_branch = self._get_current_branch()
+            self.agent.run_work_session(
+                task_description=task_description,
+                context=context,
+                model_override=ModelType.OPUS,
+                required_branch=current_branch,
+                coding_style=coding_style,
+            )
+
+            state.session_count += 1
+            self.state_manager.save_state(state)
+            return True
+
+        except Exception as e:
+            console.error(f"Failed to fix CI issues: {e}")
             return False

claude_task_master/core/planner.py

@@ -55,9 +55,15 @@ class Planner:
         # Load any existing context
         context = self.state_manager.load_context()
 
-        # Run planning phase with Claude (with coding style)
+        # Get max_prs from state options (if state exists)
+        max_prs = None
+        if self.state_manager.state_file.exists():
+            state = self.state_manager.load_state()
+            max_prs = state.options.max_prs
+
+        # Run planning phase with Claude (with coding style and max_prs)
         result = self.agent.run_planning_phase(
-            goal=goal, context=context, coding_style=coding_style
+            goal=goal, context=context, coding_style=coding_style, max_prs=max_prs
         )
 
         # Extract plan and criteria from result

claude_task_master/core/prompts_planning.py

@@ -10,7 +10,10 @@ from .prompts_base import PromptBuilder
 
 
 def build_planning_prompt(
-    goal: str, context: str | None = None, coding_style: str | None = None
+    goal: str,
+    context: str | None = None,
+    coding_style: str | None = None,
+    max_prs: int | None = None,
 ) -> str:
     """Build the planning phase prompt.
 
@@ -18,6 +21,7 @@ def build_planning_prompt(
         goal: The user's goal to achieve.
         context: Optional accumulated context from previous sessions.
         coding_style: Optional coding style guide to inject.
+        max_prs: Optional maximum number of PRs to create.
 
     Returns:
         Complete planning prompt.
@@ -175,6 +179,28 @@ executed in a continuous conversation, so Claude remembers previous work.
 **Each PR should be mergeable independently when possible.**""",
     )
 
+    # PR limit constraint (if specified)
+    if max_prs:
+        builder.add_section(
+            "⚠️ PR LIMIT CONSTRAINT (MANDATORY)",
+            f"""**CRITICAL: You MUST create EXACTLY {max_prs} pull request(s) or fewer. This is MANDATORY.**
+
+🚫 **YOU ARE NOT ALLOWED TO EXCEED {max_prs} PR(s). NO EXCEPTIONS.**
+
+Everything MUST fit within {max_prs} PR(s). Plan accordingly:
+
+{"**For 1 PR: Put EVERYTHING in a single pull request.**" if max_prs == 1 else f"**For {max_prs} PRs: Intelligently group all work into {max_prs} or fewer pull requests.**"}
+
+- Combine ALL related changes together
+- Group tests, docs, and code in the same PR
+- Keep dependencies together (schema + model + service in one PR)
+- Prioritize essential work if needed
+
+**DO NOT CREATE MORE THAN {max_prs} PR(s) under any circumstances.**
+
+Any plan that exceeds {max_prs} PR(s) is INVALID and will be REJECTED.""",
+        )
+
     # Success criteria
     builder.add_section(
         "Step 3: Define Success Criteria",

claude_task_master/core/state.py

@@ -78,6 +78,7 @@ class TaskOptions(BaseModel):
 
     auto_merge: bool = True
     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

claude_task_master/core/state_file_ops.py

@@ -146,6 +146,18 @@ class FileOperationsMixin:
             return coding_style_file.read_text()
         return None
 
+    def delete_coding_style(self) -> bool:
+        """Delete coding style guide file (coding-style.md).
+
+        Returns:
+            True if file was deleted, False if file did not exist.
+        """
+        coding_style_file = self.state_dir / "coding-style.md"
+        if coding_style_file.exists():
+            coding_style_file.unlink()
+            return True
+        return False
+
     def _parse_plan_tasks(self, plan: str) -> list[str]:
         """Parse tasks from plan markdown.
 

claude_task_master/mcp/server.py

@@ -69,6 +69,7 @@ ClearMailboxResult = tools.ClearMailboxResult
 CloneRepoResult = tools.CloneRepoResult
 SetupRepoResult = tools.SetupRepoResult
 PlanRepoResult = tools.PlanRepoResult
+DeleteCodingStyleResult = tools.DeleteCodingStyleResult
 
 
 # =============================================================================
@@ -201,12 +202,31 @@ def create_server(
         """
         return tools.clean_task(work_dir, force, state_dir)
 
+    @mcp.tool()
+    def delete_coding_style(
+        state_dir: str | None = None,
+    ) -> dict[str, Any]:
+        """Delete the coding style guide file (coding-style.md).
+
+        The coding style file is a cached guide that's preserved across runs to save
+        tokens. Call this to force regeneration on the next planning phase when
+        project conventions have changed.
+
+        Args:
+            state_dir: Optional custom state directory path.
+
+        Returns:
+            Dictionary indicating success or failure with deletion status.
+        """
+        return tools.delete_coding_style(work_dir, state_dir)
+
     @mcp.tool()
     def initialize_task(
         goal: str,
         model: str = "opus",
         auto_merge: bool = True,
         max_sessions: int | None = None,
+        max_prs: int | None = None,
         pause_on_pr: bool = False,
         state_dir: str | None = None,
     ) -> dict[str, Any]:
@@ -220,6 +240,7 @@ def create_server(
             model: Model to use (opus, sonnet, haiku).
             auto_merge: Whether to auto-merge PRs when approved.
             max_sessions: Max work sessions before pausing.
+            max_prs: Max pull requests to create.
             pause_on_pr: Pause after creating PR for manual review.
             state_dir: Optional custom state directory path.
 
@@ -227,7 +248,7 @@ def create_server(
             Dictionary indicating success with run_id or failure.
         """
         return tools.initialize_task(
-            work_dir, goal, model, auto_merge, max_sessions, pause_on_pr, state_dir
+            work_dir, goal, model, auto_merge, max_sessions, max_prs, pause_on_pr, state_dir
         )
 
     @mcp.tool()
@@ -317,6 +338,7 @@ def create_server(
     def update_config(
         auto_merge: bool | None = None,
         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,
@@ -332,6 +354,7 @@ def create_server(
         Args:
             auto_merge: Whether to auto-merge PRs when approved.
             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.
             log_level: Log level (quiet, normal, verbose).
@@ -346,6 +369,7 @@ def create_server(
             work_dir,
             auto_merge=auto_merge,
             max_sessions=max_sessions,
+            max_prs=max_prs,
             pause_on_pr=pause_on_pr,
             enable_checkpointing=enable_checkpointing,
             log_level=log_level,

claude_task_master/mcp/tools.py

@@ -183,6 +183,15 @@ class PlanRepoResult(BaseModel):
     error: str | None = None
 
 
+class DeleteCodingStyleResult(BaseModel):
+    """Result from delete_coding_style tool."""
+
+    success: bool
+    message: str
+    deleted: bool = False
+    error: str | None = None
+
+
 # =============================================================================
 # Tool Implementations
 # =============================================================================
@@ -402,6 +411,57 @@ def get_context(
         }
 
 
+def delete_coding_style(
+    work_dir: Path,
+    state_dir: str | None = None,
+) -> dict[str, Any]:
+    """Delete the coding style guide file (coding-style.md).
+
+    The coding style file is a cached guide that's preserved across runs to save
+    tokens. Call this to force regeneration on the next planning phase when
+    project conventions have changed.
+
+    Args:
+        work_dir: Working directory for the server.
+        state_dir: Optional custom state directory path.
+
+    Returns:
+        Dictionary indicating success or failure with deletion status.
+    """
+    state_path = Path(state_dir) if state_dir else work_dir / ".claude-task-master"
+    state_manager = StateManager(state_dir=state_path)
+
+    if not state_manager.exists():
+        return DeleteCodingStyleResult(
+            success=False,
+            message="No task state found",
+            deleted=False,
+            error="No active task found. Initialize a task first.",
+        ).model_dump()
+
+    try:
+        deleted = state_manager.delete_coding_style()
+        if deleted:
+            return DeleteCodingStyleResult(
+                success=True,
+                message="Coding style guide deleted successfully",
+                deleted=True,
+            ).model_dump()
+        else:
+            return DeleteCodingStyleResult(
+                success=True,
+                message="Coding style guide did not exist",
+                deleted=False,
+            ).model_dump()
+    except Exception as e:
+        return DeleteCodingStyleResult(
+            success=False,
+            message=f"Failed to delete coding style guide: {e}",
+            deleted=False,
+            error=str(e),
+        ).model_dump()
+
+
 def clean_task(
     work_dir: Path,
     force: bool = False,
@@ -464,6 +524,7 @@ def initialize_task(
     model: str = "opus",
     auto_merge: bool = True,
     max_sessions: int | None = None,
+    max_prs: int | None = None,
     pause_on_pr: bool = False,
     state_dir: str | None = None,
 ) -> dict[str, Any]:
@@ -475,6 +536,7 @@ def initialize_task(
         model: Model to use (opus, sonnet, haiku).
         auto_merge: Whether to auto-merge PRs when approved.
         max_sessions: Max work sessions before pausing.
+        max_prs: Max pull requests to create.
         pause_on_pr: Pause after creating PR for manual review.
         state_dir: Optional custom state directory path.
 
@@ -494,6 +556,7 @@ def initialize_task(
         options = TaskOptions(
             auto_merge=auto_merge,
             max_sessions=max_sessions,
+            max_prs=max_prs,
             pause_on_pr=pause_on_pr,
         )
         state = state_manager.initialize(goal=goal, model=model, options=options)
@@ -772,6 +835,7 @@ def update_config(
     work_dir: Path,
     auto_merge: bool | None = None,
     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,
@@ -788,6 +852,7 @@ def update_config(
         work_dir: Working directory for the server.
         auto_merge: Whether to auto-merge PRs when approved.
         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.
         log_level: Log level (quiet, normal, verbose).
@@ -808,6 +873,8 @@ def update_config(
         kwargs["auto_merge"] = auto_merge
     if max_sessions is not None:
         kwargs["max_sessions"] = max_sessions
+    if max_prs is not None:
+        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:

claude_task_master/webhooks/events.py

@@ -44,7 +44,7 @@ from __future__ import annotations
 import uuid
 from dataclasses import dataclass, field
 from datetime import UTC, datetime
-from enum import Enum
+from enum import StrEnum
 from typing import Any
 
 # =============================================================================
@@ -52,7 +52,7 @@ from typing import Any
 # =============================================================================
 
 
-class EventType(str, Enum):
+class EventType(StrEnum):
     """Webhook event types.
 
     Each event type corresponds to a specific lifecycle event in the

{claude_task_master-0.1.8.dist-info → claude_task_master-0.1.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-task-master
-Version: 0.1.8
+Version: 0.1.10
 Summary: Autonomous task orchestration system that keeps Claude working until a goal is achieved
 Author: Claude Task Master Team
 License-Expression: MIT
@@ -19,15 +19,15 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
-Requires-Dist: claude-agent-sdk>=0.1.0
+Requires-Dist: claude-agent-sdk>=0.1.30
 Requires-Dist: typer>=0.12.0
 Requires-Dist: pydantic>=2.0.0
-Requires-Dist: rich>=13.0.0
+Requires-Dist: rich>=14.3.2
 Requires-Dist: httpx>=0.27.0
 Provides-Extra: mcp
-Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Requires-Dist: mcp>=1.26.0; extra == "mcp"
 Provides-Extra: api
-Requires-Dist: fastapi>=0.100.0; extra == "api"
+Requires-Dist: fastapi>=0.128.1; 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"
@@ -37,8 +37,8 @@ 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"
 Requires-Dist: pytest-timeout>=2.4.0; extra == "dev"
-Requires-Dist: hypothesis>=6.100.0; extra == "dev"
-Requires-Dist: ruff>=0.3.0; extra == "dev"
+Requires-Dist: hypothesis>=6.151.5; extra == "dev"
+Requires-Dist: ruff>=0.15.0; extra == "dev"
 Requires-Dist: mypy>=1.9.0; extra == "dev"
 Provides-Extra: all
 Requires-Dist: claude-task-master[api,dev,mcp]; extra == "all"
@@ -390,6 +390,7 @@ claudetm start "Your goal here" [OPTIONS]
 | `--model` | Model to use (sonnet, opus, haiku) | sonnet |
 | `--auto-merge/--no-auto-merge` | Auto-merge PRs when ready | True |
 | `--max-sessions` | Limit number of sessions | unlimited |
+| `--prs` | Limit number of PRs to create | unlimited |
 | `--pause-on-pr` | Pause after creating PR | False |
 
 ### Common Workflows
@@ -404,6 +405,10 @@ claudetm start "Refactor auth system" --model opus --no-auto-merge
 # Limited sessions to prevent runaway
 claudetm start "Fix bug in parser" --max-sessions 5
 
+# Limit number of PRs (forces everything into fewer PRs)
+claudetm start "Add user dashboard" --prs 1
+claudetm start "Implement notifications" --prs 3 --max-sessions 10
+
 # Monitor progress
 watch -n 5 'claudetm status'
 
@@ -435,6 +440,10 @@ claudetm start "Add dark mode toggle to settings" --model opus
 # Refactoring
 claudetm start "Refactor API client to use async/await" --max-sessions 5
 
+# Limit PRs for focused changes
+claudetm start "Add user authentication" --prs 1
+claudetm start "Build admin dashboard" --prs 2 --max-sessions 8
+
 # Documentation
 claudetm start "Add API documentation and examples"
 ```

{claude_task_master-0.1.8.dist-info → claude_task_master-0.1.10.dist-info}/RECORD

@@ -1,10 +1,10 @@
-claude_task_master/__init__.py,sha256=JAKhI_GFk5m5HASlCbJF5c_zSYuMV_GZYjOLrzWU-Lo,187
+claude_task_master/__init__.py,sha256=FM8X1pOP-O8f-7DZXsRpUbBJ3ztwsqBsi9AEGfwlLSI,188
 claude_task_master/cli.py,sha256=b2nowi18sFSX8pLZiFKjQqDp7cvRWRnNayN96n-d770,6238
 claude_task_master/server.py,sha256=a39yqwj2gZWpAPOzU9E3yj8ds7wmSqevOyiI7QHu_EQ,15791
 claude_task_master/wrapper.py,sha256=NQywkv06-4jkBz4lFPkQvDrr8TEMgyAqYWEnQI2fgck,6001
 claude_task_master/api/__init__.py,sha256=PLYnsz8ce5JbMhkE3s268l898QZjR-hCiaqb97o0W0Y,2205
-claude_task_master/api/models.py,sha256=w5UirlQXirF94a3HCfCic2pz223PYaw2-KTVBG8cFC4,25922
-claude_task_master/api/routes.py,sha256=iwMREBGW37hxlmABsdzzjc8kWtSPyHA0N5Y66GrAIKk,47780
+claude_task_master/api/models.py,sha256=T8C1C2zJyxFp1y2wsG3KBrpOb6e5UrbkaV7Qgg-BHxY,27130
+claude_task_master/api/routes.py,sha256=aC-tjlTa_4TesRcRimnKLy0u2COVk-h9fVgHh3Mfmbo,50279
 claude_task_master/api/routes_config.py,sha256=gmLb40bxiNwF4N8U7_MarXRFnzzJWGjqQGDF4wOMjiI,5125
 claude_task_master/api/routes_control.py,sha256=HaM6JfTTlwnfaHADXlk-Pc3FpdBWp6yzG3NBXqdfFTU,9814
 claude_task_master/api/routes_repo.py,sha256=Lh9c1JqyBTUiuq_8Nlyig-wtVyl6Ha9rVk_20MOxCqg,11649
@@ -23,13 +23,13 @@ claude_task_master/cli_commands/fix_session.py,sha256=yXijoqCKZ9kE2_TPIwSTScTeAo
 claude_task_master/cli_commands/github.py,sha256=x8UcAqBRdGUau0frkzkoeOmZ5xaN4AFUDWybFHVDXa0,5142
 claude_task_master/cli_commands/info.py,sha256=jmzslLMiVk3ZyGBsVxNSfoe1qLJsuCG9Zqz57zYauRE,6084
 claude_task_master/cli_commands/mailbox.py,sha256=SJzZxzxpkIv4cwXA-8gaVzqTJuqh1rwxQ4TeL-VmDE4,9291
-claude_task_master/cli_commands/workflow.py,sha256=_ITtxFoH6JWd8vPPjdKXjmRj3RiOay3kUEwSZl7rJhA,16980
+claude_task_master/cli_commands/workflow.py,sha256=mcFOG2_4r-o0GMvhIO9GQC7_z8RPCxytd8C0jTiYMr8,17270
 claude_task_master/core/__init__.py,sha256=nmwC07VqpbuogTYbXTYhb0KJifwsrF922FepWEHnpyc,8945
-claude_task_master/core/agent.py,sha256=fRx7NzOZMsqfRFcue5Tvlq8nvkyiv5i_vP06J_awC2I,11931
+claude_task_master/core/agent.py,sha256=snQmeZx4xvREuuIv-L3IlN6V7kZC0FH1BSqH41ckXVs,12064
 claude_task_master/core/agent_exceptions.py,sha256=TjPlGXQhGjWof1kENyRmBowRNRay4SXL0YCH_VYsq4g,6354
-claude_task_master/core/agent_message.py,sha256=-GYlZe0A8WCoEtuM4LHtymA4DEJLaHgpbQghpMl4i6g,6860
+claude_task_master/core/agent_message.py,sha256=gelItCmxluOHwiNzBQhJ-skNzFVxCVDe_qBmr6MnYao,7809
 claude_task_master/core/agent_models.py,sha256=06kTenpOHKDFt8tOqa9h5-4fvjkwNxm2MDC3FzbbmoQ,6551
-claude_task_master/core/agent_phases.py,sha256=QVhPu9RJGYceoOb1yJyXsUJSNBYjLdFkJAaRHgZ6-ZM,13227
+claude_task_master/core/agent_phases.py,sha256=XfXPLDcOeSthIm-v0uZNmgW-7gfueNnIGqqh_7-aMzA,13380
 claude_task_master/core/agent_query.py,sha256=lu6-X3AdNC4t-THZf6Qc2lBIpwhmm7bhgWqezSbOOGY,17269
 claude_task_master/core/checkpoint.py,sha256=qwW_Qj1yjNNuyBZEAj91bOGhn1yCsjqOccGn3XFIPRg,7142
 claude_task_master/core/circuit_breaker.py,sha256=kXVgLDVy5_kie65frVPkrcPMmm6FWSHOqwfTe7Isebk,13545
@@ -43,25 +43,25 @@ claude_task_master/core/credentials.py,sha256=khav4RO-N5R7lG7E1VGdDztEgB1yOzYBJL
 claude_task_master/core/hooks.py,sha256=ZQLsELwrCDgxmjRQfsNO8e3Tswpig-8yWZjEAjbpT98,14304
 claude_task_master/core/key_listener.py,sha256=d-TZvEkmhYudzLkJx6SWYFBMyJMYcscZ9k9vrAXMBU0,5434
 claude_task_master/core/logger.py,sha256=87m45KxDH3UO8JG9TFZVsstd5bpFspNVG6L5gg8fgLc,8061
-claude_task_master/core/orchestrator.py,sha256=pSL-Uw7klHxHgHMmpG1eTRPOeZLtvJoxxYtHHXwOibE,54313
+claude_task_master/core/orchestrator.py,sha256=tNq2vJoItYiV0VmUy3Jl-wqVNdL8wAGv4205Z_OJ4FI,58210
 claude_task_master/core/parallel.py,sha256=1eQWU4yVJCQktsK1sC98eMk42Y8OOneQXSeZ-G4psO8,14838
 claude_task_master/core/plan_updater.py,sha256=hhLR3L9cPqDUAjxaVMPWDDwm6GFHe3xrDbAXFSFeRxA,6843
-claude_task_master/core/planner.py,sha256=wYHTO6oOBE9JMFumyciw0qqbc6nTutpEt5SVqQ3_SRU,2917
+claude_task_master/core/planner.py,sha256=fIEwBrKEU_uXmuJOqL6_NLj1V786oa4nb_5B9pDgveM,3176
 claude_task_master/core/pr_context.py,sha256=C1kxyona1LUTFcag-CHp86T-YJYTunPlJEAGllqBUTE,19534
 claude_task_master/core/progress_tracker.py,sha256=nQS4LKjQcy0ptNJFH80nBAz_ygbVbgn73ItdBbe6tzk,12068
 claude_task_master/core/prompts.py,sha256=WPPQQGYvUq_vF4muKuBuYoB8fq3hU1E6lZhDSB34-V8,2212
 claude_task_master/core/prompts_base.py,sha256=pCJsHWq1hxoLC_f5c_GwaaXFdwIkyIseU9qmtZwVt3c,1981
 claude_task_master/core/prompts_coding_style.py,sha256=kGmd8Sq0-nTnNLS8qrqSwxv3Adk6bRNZ0C1Uq1jGzpA,4756
 claude_task_master/core/prompts_plan_update.py,sha256=Gvq1urZ3Cn6IMGDN6XQosKb0GjbLxKYeCVBbP-SREpY,4314
-claude_task_master/core/prompts_planning.py,sha256=BoA-ix8ZpXTjDFaSdxK3Nmjqq6SxPrdsN7oNuErQmJo,7275
+claude_task_master/core/prompts_planning.py,sha256=kAjh5LVYH5Ee-YOkKUEP0D7itmJ_nFLl5nf6RsUp1Ts,8280
 claude_task_master/core/prompts_verification.py,sha256=h4fW8hF479BA0I43BWNLzDGHcGqn86Dh_xfXpSvmeEE,4624
 claude_task_master/core/prompts_working.py,sha256=HsCmVJFnn71HAcbkSR4J8A5UOsMfL4jUB-SqCEPRma4,11449
 claude_task_master/core/rate_limit.py,sha256=r_ztFybFHTP1UWJIW66OTqAUNJLffyCo7uPwrpFUO1c,4439
 claude_task_master/core/shutdown.py,sha256=-WaP6FoAgvdBGOmu6AtEu9YWA4n0v8AP9Cm_39g_BW8,10194
-claude_task_master/core/state.py,sha256=wCoFubgFyW5Lj1gqum7Kz_2_khynWv7lTxtw92NxCSk,24811
+claude_task_master/core/state.py,sha256=LzXGGBZhOBBiJ8GhUdBg04z39KLE__busBVuY0W2d1A,24842
 claude_task_master/core/state_backup.py,sha256=OJnFotGNyCxzDBbfmtd8zo8VyEHVvsxGH_NRBNL0Ma8,5780
 claude_task_master/core/state_exceptions.py,sha256=7nJ5-tBf-owTU68a07pkdUq-DnUV_D7DbNMuNSzsVLc,6691
-claude_task_master/core/state_file_ops.py,sha256=uQ4lRPzVWWD5VhXnZhDQacJyqefK0V_38uBpQiV7zaI,5035
+claude_task_master/core/state_file_ops.py,sha256=91nRGA1vf-vHNHDJdvypH2uCXdhngHP45Yv5clbp-PQ,5423
 claude_task_master/core/state_pr.py,sha256=R8pwmzP15yStFji_Epq1p8VcWdLN96aG8mAcndi5p1U,7926
 claude_task_master/core/state_recovery.py,sha256=1kIOd_dnRF3ZbjNohTXDzanBsfAhrWcQUNzGdg3rN9o,3812
 claude_task_master/core/subagents.py,sha256=-O4dsywG2-FWwB6kg20GwaVIuQ2DAWcrkJYIBvmVM1Q,6759
@@ -80,17 +80,17 @@ claude_task_master/mailbox/models.py,sha256=CTLqm3M2Mvw_cZQSaphGE1x05fFFTQMOHzh1
 claude_task_master/mailbox/storage.py,sha256=n0gzVp64R12pMtX1TQbJuraQfzASCsD53xgeyfdVWo4,6372
 claude_task_master/mcp/__init__.py,sha256=uLd6VkJlzO3qKaYRLTVEM5OJrGi5wlSIzNLre_tPhgw,1018
 claude_task_master/mcp/auth.py,sha256=K1FHszG7Klnn0j1k9n0krueSmZ4Q8_gKw8NDRp0OFU4,5459
-claude_task_master/mcp/server.py,sha256=zxiaEDqijo-k2O-QuRgEkjb-hoX8Xvd1NyWku5wQS5Y,27318
-claude_task_master/mcp/tools.py,sha256=74f6Z7JHyqgVLlb-AkNS4b5jIaU4JhvIXmSDO14NYBo,57158
+claude_task_master/mcp/server.py,sha256=XE1tjmk37P2arp6QnYpo8ZT-AJW-Hr2uQwega5XJ3mY,28223
+claude_task_master/mcp/tools.py,sha256=2QJS1FaDPeQr9WsU9q7YgViwFwEsqir94lvlMWiB7Ak,59302
 claude_task_master/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 claude_task_master/utils/debug_claude_md.py,sha256=88opwpoh9ApR3ZyRVFro3e6jpngR3_kGoB5abdLA1As,6620
 claude_task_master/utils/doctor.py,sha256=z9mm9RUVVAYuFzCWd03kjUXMvKFxXVDyeiuqS5-RXYA,2796
 claude_task_master/webhooks/__init__.py,sha256=bJfQBkSRZCOaVNnOg7PlG-FbwJV4YsySD2st0Z4uGFk,1981
 claude_task_master/webhooks/client.py,sha256=DEz3vrNmuTBPp2t_rK515zRRKJAzFxxL8B9iCbXRuEU,24589
 claude_task_master/webhooks/config.py,sha256=cufVrl94zSSubpoNFWVYp5ht2Okf_K_8UAQfFsaaOIE,19230
-claude_task_master/webhooks/events.py,sha256=dbzOEdrum_joa4AUizVKxyPQW6q3TVAXDft5kxlr8O8,32140
-claude_task_master-0.1.8.dist-info/METADATA,sha256=w6ZU44zJZ6uVA5ZNYeOT2rXbLd3PSj9wWhZkGQ9_MBI,29580
-claude_task_master-0.1.8.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-claude_task_master-0.1.8.dist-info/entry_points.txt,sha256=vpjSBkvZSSZ1WmmNSbiszyiiy-fAvtmmaOTOyLnufqM,251
-claude_task_master-0.1.8.dist-info/top_level.txt,sha256=Axj8q87a_7qo5JyjdIFe9ebs4BFOnuDt_gdxHqSDwqc,19
-claude_task_master-0.1.8.dist-info/RECORD,,
+claude_task_master/webhooks/events.py,sha256=V-kWjb6QF2PpFJ3FtSP6hGP-Ivhdt2Tg71g6NXi1iwY,32141
+claude_task_master-0.1.10.dist-info/METADATA,sha256=vjkSZyIy0Zg_nLXZXbD6CudonMWn-qjUvtHnLYQoZm0,29955
+claude_task_master-0.1.10.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+claude_task_master-0.1.10.dist-info/entry_points.txt,sha256=vpjSBkvZSSZ1WmmNSbiszyiiy-fAvtmmaOTOyLnufqM,251
+claude_task_master-0.1.10.dist-info/top_level.txt,sha256=Axj8q87a_7qo5JyjdIFe9ebs4BFOnuDt_gdxHqSDwqc,19
+claude_task_master-0.1.10.dist-info/RECORD,,

{claude_task_master-0.1.8.dist-info → claude_task_master-0.1.10.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.1)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any