claude-task-master 0.1.9__tar.gz → 0.1.10__tar.gz

{claude_task_master-0.1.9 → claude_task_master-0.1.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-task-master
-Version: 0.1.9
+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.27
+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.9 → claude_task_master-0.1.10}/README.md

@@ -345,6 +345,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
@@ -359,6 +360,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'
 
@@ -390,6 +395,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.9 → claude_task_master-0.1.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-task-master"
-version = "0.1.9"
+version = "0.1.10"
 description = "Autonomous task orchestration system that keeps Claude working until a goal is achieved"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -24,10 +24,10 @@ classifiers = [
 ]
 
 dependencies = [
-    "claude-agent-sdk>=0.1.27",
+    "claude-agent-sdk>=0.1.30",
     "typer>=0.12.0",
     "pydantic>=2.0.0",
-    "rich>=13.0.0",
+    "rich>=14.3.2",
     "httpx>=0.27.0",
 ]
 
@@ -39,9 +39,9 @@ Issues = "https://github.com/developerz-ai/claude-task-master/issues"
 Changelog = "https://github.com/developerz-ai/claude-task-master/blob/main/CHANGELOG.md"
 
 [project.optional-dependencies]
-mcp = ["mcp>=1.0.0"]
+mcp = ["mcp>=1.26.0"]
 api = [
-    "fastapi>=0.100.0",
+    "fastapi>=0.128.1",
     "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.
@@ -54,8 +54,8 @@ dev = [
     "pytest-cov>=4.1.0",
     "pytest-asyncio>=0.23.0",
     "pytest-timeout>=2.4.0",
-    "hypothesis>=6.100.0",
-    "ruff>=0.3.0",
+    "hypothesis>=6.151.5",
+    "ruff>=0.15.0",
     "mypy>=1.9.0",
 ]
 all = [

{claude_task_master-0.1.9 → claude_task_master-0.1.10}/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.9"
+__version__ = "0.1.10"
 __all__ = ["__version__"]

{claude_task_master-0.1.9 → claude_task_master-0.1.10}/src/claude_task_master/api/models.py

@@ -48,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
@@ -58,7 +58,7 @@ from pydantic import BaseModel, Field
 # =============================================================================
 
 
-class TaskStatus(str, Enum):
+class TaskStatus(StrEnum):
     """Valid task status values."""
 
     PLANNING = "planning"
@@ -70,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"
@@ -83,7 +83,7 @@ class WorkflowStage(str, Enum):
     MERGED = "merged"
 
 
-class LogLevel(str, Enum):
+class LogLevel(StrEnum):
     """Valid log level values."""
 
     QUIET = "quiet"
@@ -91,7 +91,7 @@ class LogLevel(str, Enum):
     VERBOSE = "verbose"
 
 
-class LogFormat(str, Enum):
+class LogFormat(StrEnum):
     """Valid log format values."""
 
     TEXT = "text"
@@ -159,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).
@@ -176,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",
@@ -228,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.
     """
 
@@ -253,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",
@@ -384,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.
@@ -393,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

{claude_task_master-0.1.9 → claude_task_master-0.1.10}/src/claude_task_master/api/routes.py

@@ -287,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,
@@ -1068,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

{claude_task_master-0.1.9 → claude_task_master-0.1.10}/src/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-0.1.9 → claude_task_master-0.1.10}/src/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-0.1.9 → claude_task_master-0.1.10}/src/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-0.1.9 → claude_task_master-0.1.10}/src/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-0.1.9 → claude_task_master-0.1.10}/src/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-0.1.9 → claude_task_master-0.1.10}/src/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-0.1.9 → claude_task_master-0.1.10}/src/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-0.1.9 → claude_task_master-0.1.10}/src/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-0.1.9 → claude_task_master-0.1.10}/src/claude_task_master/mcp/server.py

@@ -226,6 +226,7 @@ def create_server(
         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]:
@@ -239,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.
 
@@ -246,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()
@@ -336,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,
@@ -351,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).
@@ -365,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-0.1.9 → claude_task_master-0.1.10}/src/claude_task_master/mcp/tools.py

@@ -524,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]:
@@ -535,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.
 
@@ -554,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)
@@ -832,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,
@@ -848,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).
@@ -868,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-0.1.9 → claude_task_master-0.1.10}/src/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.9 → claude_task_master-0.1.10}/src/claude_task_master.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-task-master
-Version: 0.1.9
+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.27
+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.9 → claude_task_master-0.1.10}/src/claude_task_master.egg-info/requires.txt

@@ -1,14 +1,14 @@
-claude-agent-sdk>=0.1.27
+claude-agent-sdk>=0.1.30
 typer>=0.12.0
 pydantic>=2.0.0
-rich>=13.0.0
+rich>=14.3.2
 httpx>=0.27.0
 
 [all]
 claude-task-master[api,dev,mcp]
 
 [api]
-fastapi>=0.100.0
+fastapi>=0.128.1
 uvicorn[standard]>=0.24.0
 passlib[bcrypt]>=1.7.4
 bcrypt<4.1.0,>=4.0.0
@@ -19,9 +19,9 @@ pytest>=8.0.0
 pytest-cov>=4.1.0
 pytest-asyncio>=0.23.0
 pytest-timeout>=2.4.0
-hypothesis>=6.100.0
-ruff>=0.3.0
+hypothesis>=6.151.5
+ruff>=0.15.0
 mypy>=1.9.0
 
 [mcp]
-mcp>=1.0.0
+mcp>=1.26.0