steerdev 1.1.2__tar.gz → 1.1.5__tar.gz

{steerdev-1.1.2 → steerdev-1.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: steerdev
-Version: 1.1.2
+Version: 1.1.5
 Summary: Backend task runner for steerdev.com - orchestrates CLI coding agents with activity reporting
 Project-URL: Homepage, https://github.com/pentoai/steerdev-agent
 Project-URL: Repository, https://github.com/pentoai/steerdev-agent

{steerdev-1.1.2 → steerdev-1.1.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "steerdev"
-version = "1.1.2"
+version = "1.1.5"
 description = "Backend task runner for steerdev.com - orchestrates CLI coding agents with activity reporting"
 readme = "README.md"
 authors = [

{steerdev-1.1.2 → steerdev-1.1.5}/src/steerdev_agent/cli.py

@@ -1726,6 +1726,14 @@ def run(
             help="Default branch for sync/rebase/PR targets (default: from config or 'main')",
         ),
     ] = None,
+    task_id: Annotated[
+        str | None,
+        typer.Option(
+            "--task-id",
+            "-t",
+            help="Run a specific task by ID (bypasses queue/wave scheduling)",
+        ),
+    ] = None,
 ) -> None:
     """Run the agent for a project!
 
@@ -1851,6 +1859,7 @@ def run(
                 dry_run=dry_run,
                 retry_config=retry_config,
                 branch_config=resolved_branch_config,
+                task_id=task_id,
             )
         )
 
@@ -2341,8 +2350,15 @@ def _display_dependency_check(deps: list) -> None:
 
     for dep in deps:
         if dep.found:
-            status = "[green]Found[/green]"
-            details = dep.version or dep.path or ""
+            if dep.authenticated is False:
+                status = "[red]Not authenticated[/red]"
+                details = dep.auth_hint or "Run the tool's login command"
+            elif dep.authenticated is True:
+                status = "[green]Found & authenticated[/green]"
+                details = dep.auth_details or dep.version or dep.path or ""
+            else:
+                status = "[green]Found[/green]"
+                details = dep.version or dep.path or ""
         elif dep.required:
             status = "[red]Missing (required)[/red]"
             details = f"Install: {dep.install_hint}"
@@ -2488,6 +2504,21 @@ def setup(
         )
         raise typer.Exit(1)
 
+    unauthenticated_required = [
+        d for d in deps if d.required and d.found and d.authenticated is False
+    ]
+    if unauthenticated_required:
+        names = ", ".join(d.name for d in unauthenticated_required)
+        hints = "\n".join(
+            f"  - {d.name}: {d.auth_hint}" for d in unauthenticated_required if d.auth_hint
+        )
+        console.print(
+            f"\n[red]Required tool(s) not authenticated: {names}.[/red]\n"
+            f"Log in before running setup so steerdev can create PRs and "
+            f"manage branches on your behalf.\n{hints}"
+        )
+        raise typer.Exit(1)
+
     # Prompt for install target if not provided
     if install_target is None:
         install_target = _prompt_install_target()

{steerdev-1.1.2 → steerdev-1.1.5}/src/steerdev_agent/prompt/builder.py

@@ -24,6 +24,7 @@ class WaveContext(BaseModel):
 
     wave_number: int = Field(description="Current wave number")
     total_waves: int = Field(description="Total number of waves")
+    wave_name: str = Field(default="", description="Unique wave name (e.g., wave-532d5c)")
     wave_description: str = Field(default="", description="Description of this wave")
     wave_tasks_summary: str = Field(default="", description="Summary of tasks in this wave")
     completed_waves_summary: str = Field(default="", description="Summary of completed waves")

{steerdev-1.1.2 → steerdev-1.1.5}/src/steerdev_agent/runner.py

@@ -111,6 +111,7 @@ def build_wave_context(wave_response: dict[str, Any]) -> WaveContext | None:
     return WaveContext(
         wave_number=wave_info.get("wave_number", 1),
         total_waves=wave_info.get("total_waves", 1),
+        wave_name=wave_info.get("name", ""),
         wave_description=wave_info.get("description", ""),
         wave_tasks_summary=tasks_summary,
         completed_waves_summary=completed_summary,
@@ -187,13 +188,13 @@ def compute_worktree_name(task_id: str, wave_context: WaveContext | None = None)
     """Compute the git worktree name for a task execution.
 
     Naming conventions:
-    - Wave-based: "wave-{wave_number}" (e.g., "wave-3")
+    - Wave-based: "{wave_name}" (e.g., "wave-532d5c")
     - Task-based: "task-{first_8_chars}" (e.g., "task-abc12345")
 
     The worktree lifecycle is managed by Claude CLI via the --worktree flag.
     """
     if wave_context:
-        return f"wave-{wave_context.wave_number}"
+        return wave_context.wave_name or f"wave-{wave_context.wave_number}"
     task_short = task_id[:8] if len(task_id) > 8 else task_id
     return f"task-{task_short}"
 
@@ -286,6 +287,7 @@ class Runner:
         branch_config: BranchConfig | None = None,
         shutdown_event: asyncio.Event | None = None,
         agent_id: str | None = None,
+        task_id: str | None = None,
     ) -> None:
         """Initialize the runner.
 
@@ -333,6 +335,7 @@ class Runner:
         self._enable_waves = enable_waves
         self._enable_canals = enable_canals
         self._agent_id = agent_id
+        self._target_task_id = task_id
 
         # State
         self._state = RunState.STOPPED
@@ -643,7 +646,7 @@ class Runner:
 
         wave_id: str | None = None
         if wave_context:
-            wave_id = f"wave-{wave_context.wave_number}"
+            wave_id = wave_context.wave_name or f"wave-{wave_context.wave_number}"
 
         try:
             with ReportsClient(api_key=self._api_key) as client:
@@ -1123,25 +1126,36 @@ class Runner:
                 suggested_workflow_id: str | None = None
 
                 with TasksClient(api_key=self._api_key) as client:
-                    if self._enable_waves:
-                        try:
-                            task, wave_ctx, suggested_workflow_id = extract_task_and_wave_context(
-                                client.get_next_wave(
-                                    project_id=self.project_id,
-                                    agent_id=self._agent_id,
+                    if self._target_task_id:
+                        if self._tasks_executed > 0:
+                            # Targeted single-task mode: only run the requested task once.
+                            break
+                        task = client.get_task(self._target_task_id)
+                        if not task:
+                            console.print(f"[red]Task {self._target_task_id} not found[/red]")
+                            break
+                    else:
+                        if self._enable_waves:
+                            try:
+                                task, wave_ctx, suggested_workflow_id = (
+                                    extract_task_and_wave_context(
+                                        client.get_next_wave(
+                                            project_id=self.project_id,
+                                            agent_id=self._agent_id,
+                                        )
+                                    )
+                                )
+                            except Exception:
+                                logger.debug(
+                                    "Wave fetch failed, falling back to single-task",
+                                    exc_info=True,
                                 )
-                            )
-                        except Exception:
-                            logger.debug(
-                                "Wave fetch failed, falling back to single-task",
-                                exc_info=True,
-                            )
 
-                    if not task:
-                        task = client.get_next_task(
-                            project_id=self.project_id,
-                            agent_id=self._agent_id,
-                        )
+                        if not task:
+                            task = client.get_next_task(
+                                project_id=self.project_id,
+                                agent_id=self._agent_id,
+                            )
 
                 if not task:
                     if self._tasks_executed == 0:
@@ -1394,6 +1408,7 @@ async def run_agent(
     dry_run: bool = False,
     retry_config: RetryConfig | None = None,
     branch_config: BranchConfig | None = None,
+    task_id: str | None = None,
 ) -> dict[str, Any]:
     """Run the steerdev agent.
 
@@ -1441,6 +1456,7 @@ async def run_agent(
         dry_run=dry_run,
         retry_config=retry_config,
         branch_config=branch_config,
+        task_id=task_id,
     )
 
     # Install signal handler that kills the subprocess immediately on Ctrl+C

{steerdev-1.1.2 → steerdev-1.1.5}/src/steerdev_agent/setup/claude_setup.py

@@ -30,6 +30,11 @@ class DependencyStatus:
     version: str | None = None
     required: bool = True
     install_hint: str = ""
+    # Auth status: True if authenticated, False if not, None if not applicable
+    # (or the binary was not found, or the check could not be performed).
+    authenticated: bool | None = None
+    auth_hint: str = ""
+    auth_details: str | None = None
 
 
 def check_cli_dependencies() -> list[DependencyStatus]:
@@ -75,6 +80,15 @@ def check_cli_dependencies() -> list[DependencyStatus]:
             install_hint="https://nodejs.org/",
         ),
     ]
+
+    for dep in deps:
+        if dep.command == "gh" and dep.found and dep.path is not None:
+            authenticated, details = _check_gh_auth(dep.path)
+            dep.authenticated = authenticated
+            dep.auth_details = details
+            if authenticated is False:
+                dep.auth_hint = "Run: gh auth login"
+
     return deps
 
 
@@ -125,6 +139,37 @@ def _check_dep(
     )
 
 
+def _check_gh_auth(gh_path: str) -> tuple[bool | None, str | None]:
+    """Check whether the GitHub CLI is logged in.
+
+    Returns a tuple of (authenticated, details). `authenticated` is True when
+    `gh auth status` exits 0, False when it exits non-zero (meaning gh is
+    installed but the user isn't logged in), and None when the check could
+    not be executed (timeout / OS error).
+    """
+    try:
+        result = subprocess.run(
+            [gh_path, "auth", "status"],
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+    except (subprocess.TimeoutExpired, OSError):
+        logger.debug("Failed to run `gh auth status`")
+        return None, None
+
+    # `gh auth status` writes its human-readable output to stderr.
+    combined = (result.stderr or "") + (result.stdout or "")
+    details: str | None = None
+    for line in combined.splitlines():
+        stripped = line.strip()
+        if "Logged in to" in stripped or "not logged in" in stripped.lower():
+            details = stripped
+            break
+
+    return result.returncode == 0, details
+
+
 # Word lists for generating agent names
 ADJECTIVES = [
     "bright",

{steerdev-1.1.2 → steerdev-1.1.5}/src/steerdev_agent/worktree.py

@@ -213,7 +213,7 @@ def compute_branch_name(
     """Compute the branch name for a task or wave.
 
     Naming conventions aligned with merge skill branch patterns:
-    - Wave: "wave/{wave_number}" (e.g., "wave/3")
+    - Wave: "{wave_name}" (e.g., "wave-532d5c")
     - Task with external ID: "task/{TICKET-ID}-{slug}" (e.g., "task/PROJ-123-add-auth")
     - Task without external ID: "task/{short-id}-{slug}" (e.g., "task/abc12345-add-auth")
 
@@ -225,7 +225,7 @@ def compute_branch_name(
         Branch name string.
     """
     if wave_context:
-        return f"wave/{wave_context.wave_number}"
+        return wave_context.wave_name or f"wave-{wave_context.wave_number}"
 
     # Try external ticket ID first (e.g., Linear "PROJ-123")
     external_id = task.get("linear_identifier") or task.get("external_id")

{steerdev-1.1.2 → steerdev-1.1.5}/tests/test_claude_setup.py

@@ -1,6 +1,7 @@
 """Tests for Claude setup templates and installed skills."""
 
-from unittest.mock import patch
+import subprocess
+from unittest.mock import MagicMock, patch
 
 from steerdev_agent.setup.claude_setup import ClaudeSetup, check_cli_dependencies
 
@@ -86,3 +87,83 @@ class TestCheckCliDependencies:
         if git_dep.found:
             assert git_dep.path is not None
             assert git_dep.version is not None
+
+
+class TestGhAuthStatus:
+    """Tests for gh auth status checking within check_cli_dependencies()."""
+
+    @staticmethod
+    def _fake_run(*, auth_returncode: int, auth_stderr: str = ""):
+        """Build a fake subprocess.run that returns a version then an auth result."""
+
+        def run(cmd, *args, **kwargs):
+            # First subprocess call is `--version`; second is `auth status`.
+            if "auth" in cmd:
+                return MagicMock(returncode=auth_returncode, stdout="", stderr=auth_stderr)
+            return MagicMock(returncode=0, stdout="gh version 2.0.0\n", stderr="")
+
+        return run
+
+    def test_gh_authenticated_sets_flag_true(self):
+        with (
+            patch("shutil.which", return_value="/usr/bin/gh"),
+            patch(
+                "subprocess.run",
+                side_effect=self._fake_run(
+                    auth_returncode=0,
+                    auth_stderr="✓ Logged in to github.com as octocat",
+                ),
+            ),
+        ):
+            deps = check_cli_dependencies()
+
+        gh_dep = next(d for d in deps if d.command == "gh")
+        assert gh_dep.found is True
+        assert gh_dep.authenticated is True
+        assert gh_dep.auth_hint == ""
+        assert gh_dep.auth_details is not None
+        assert "Logged in" in gh_dep.auth_details
+
+    def test_gh_not_authenticated_sets_flag_false_with_hint(self):
+        with (
+            patch("shutil.which", return_value="/usr/bin/gh"),
+            patch(
+                "subprocess.run",
+                side_effect=self._fake_run(
+                    auth_returncode=1,
+                    auth_stderr="You are not logged into any GitHub hosts.",
+                ),
+            ),
+        ):
+            deps = check_cli_dependencies()
+
+        gh_dep = next(d for d in deps if d.command == "gh")
+        assert gh_dep.found is True
+        assert gh_dep.authenticated is False
+        assert "gh auth login" in gh_dep.auth_hint
+
+    def test_gh_auth_check_timeout_leaves_status_none(self):
+        def run(cmd, *args, **kwargs):
+            if "auth" in cmd:
+                raise subprocess.TimeoutExpired(cmd=cmd, timeout=5)
+            return MagicMock(returncode=0, stdout="gh version 2.0.0\n", stderr="")
+
+        with (
+            patch("shutil.which", return_value="/usr/bin/gh"),
+            patch("subprocess.run", side_effect=run),
+        ):
+            deps = check_cli_dependencies()
+
+        gh_dep = next(d for d in deps if d.command == "gh")
+        assert gh_dep.found is True
+        assert gh_dep.authenticated is None
+        assert gh_dep.auth_hint == ""
+
+    def test_missing_gh_does_not_run_auth_check(self):
+        # When gh isn't installed, authenticated should stay None (not False).
+        with patch("shutil.which", return_value=None):
+            deps = check_cli_dependencies()
+
+        gh_dep = next(d for d in deps if d.command == "gh")
+        assert gh_dep.found is False
+        assert gh_dep.authenticated is None

{steerdev-1.1.2 → steerdev-1.1.5}/tests/test_preparation.py

@@ -211,7 +211,7 @@ class TestWorkspacePreparationInPlace:
         """Continuing a wave stays on the wave branch, only fetches."""
         from steerdev_agent.prompt.builder import WaveContext
 
-        wave_ctx = WaveContext(wave_number=3, total_waves=5)
+        wave_ctx = WaveContext(wave_number=3, total_waves=5, wave_name="wave-a1b2c3")
 
         prep = WorkspacePreparation(
             working_directory=Path("/tmp/repo"),
@@ -227,7 +227,7 @@ class TestWorkspacePreparationInPlace:
             if "rev-parse --is-inside-work-tree" in cmd:
                 return (0, "true", "")
             if "branch --show-current" in cmd:
-                return (0, "wave/3", "")  # Already on wave branch
+                return (0, "wave-a1b2c3", "")  # Already on wave branch
             if "fetch origin" in cmd:
                 return (0, "", "")
             return (0, "", "")
@@ -236,7 +236,7 @@ class TestWorkspacePreparationInPlace:
             result = await prep.prepare(sample_task, wave_ctx)
 
         assert result.success is True
-        assert result.branch_name == "wave/3"
+        assert result.branch_name == "wave-a1b2c3"
         # Should NOT have checkout commands (stayed on branch)
         checkout_cmds = [c for c in calls if c[0] == "checkout"]
         assert len(checkout_cmds) == 0

{steerdev-1.1.2 → steerdev-1.1.5}/tests/test_runner_merge_modes.py

@@ -12,6 +12,7 @@ def _make_wave_context() -> WaveContext:
     return WaveContext(
         wave_number=3,
         total_waves=5,
+        wave_name="wave-a1b2c3",
         wave_description="User management improvements",
         wave_tasks_summary="  [todo] Add user endpoint",
         completed_waves_summary="  - Wave 2: Auth cleanup",
@@ -23,6 +24,7 @@ def _make_wave_response(task_id: str = "task-123") -> dict:
         "wave": {
             "wave_number": 3,
             "total_waves": 5,
+            "name": "wave-a1b2c3",
             "description": "User management improvements",
         },
         "context": {

{steerdev-1.1.2 → steerdev-1.1.5}/tests/test_runner_worktrees.py

@@ -25,13 +25,13 @@ class TestComputeBranchName:
 
     def test_wave_based(self):
         task = {"id": "abc123", "title": "Something"}
-        wave = WaveContext(wave_number=3, total_waves=5)
-        assert compute_branch_name(task, wave) == "wave/3"
+        wave = WaveContext(wave_number=3, total_waves=5, wave_name="wave-a1b2c3")
+        assert compute_branch_name(task, wave) == "wave-a1b2c3"
 
     def test_wave_takes_precedence(self):
         task = {"id": "abc12345xyz", "title": "Add auth", "linear_identifier": "PROJ-123"}
-        wave = WaveContext(wave_number=2, total_waves=4)
-        assert compute_branch_name(task, wave) == "wave/2"
+        wave = WaveContext(wave_number=2, total_waves=4, wave_name="wave-f1e2d3")
+        assert compute_branch_name(task, wave) == "wave-f1e2d3"
 
     def test_title_slugified(self):
         task = {"id": "abc12345xyz", "title": "Add User Authentication & OAuth 2.0"}

{steerdev-1.1.2 → steerdev-1.1.5}/tests/test_worktree.py

@@ -37,8 +37,8 @@ class TestComputeBranchName:
         from steerdev_agent.prompt.builder import WaveContext
 
         task = {"id": "abc", "title": "test"}
-        wave = WaveContext(wave_number=5, total_waves=10)
-        assert compute_branch_name(task, wave) == "wave/5"
+        wave = WaveContext(wave_number=5, total_waves=10, wave_name="wave-d4e5f6")
+        assert compute_branch_name(task, wave) == "wave-d4e5f6"
 
     def test_task_with_linear_id(self):
         task = {"id": "abc12345xyz", "title": "Add auth", "linear_identifier": "PROJ-42"}