lemming-cli 0.2.1__tar.gz → 0.3.0__tar.gz

{lemming_cli-0.2.1 → lemming_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lemming-cli
-Version: 0.2.1
+Version: 0.3.0
 Summary: An autonomous, iterative task runner for AI coding agents.
 Project-URL: Homepage, https://github.com/owahltinez/lemming
 Project-URL: Repository, https://github.com/owahltinez/lemming
@@ -246,13 +246,20 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
 
 ### Roadmap Management
 
-- **`status [<id>]`**: Roadmap overview or deep-dive into a specific task.
+- **`status [<id>]`**: Queue/history overview or deep-dive into a specific
+  task, including supersession lineage and runner/orchestrator-hook execution
+  times. Superseded and failed history stays visible in the default overview;
+  `--verbose` also shows routine completed/cancelled history.
 - **`goal [<text>]`**: Set or view the long-term goal shared by all tasks.
   Supports `-f/--file`.
 - **`add <desc>`**: Append a new task. Supports `--index` and `--runner`.
 - **`edit <id>`**: Modify a task's description, runner, or position.
-- **`delete <id>`**: Remove a task. Supports `--all` and `--completed` for bulk
-  operations.
+- **`delete <id>`**: Remove an unstarted task while retaining its runner log.
+  Tasks with execution history require `--force`; autonomous restructuring
+  should use `supersede`. Supports `--all` and `--completed` for bulk cleanup,
+  including logs.
+- **`supersede <id> --reason <text>`**: Retire a replaced or split task without
+  losing its progress, timings, log, or links to replacement tasks.
 - **`progress`**: Manage progress entries and findings for specific tasks.
   - `list <id>`: List all progress for a task.
   - `add <id> <finding>`: Record a new technical detail.
@@ -283,9 +290,11 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
 - **`fail <id>`**: Mark a task as a terminal failure (will not be retried).
 - **`cancel <id>`**: Stop an in-progress task (kills the runner process).
 - **`reset <id>`**: Clear attempts and progress to start a task fresh.
-- **`logs [<id>]`**: Print a task's execution log to stdout. If no ID is
-  provided, it defaults to the active or most recent task. Orchestrator hook
-  output is automatically appended.
+- Superseded tasks remain visible as non-failing history; replacement tasks
+  link back through their parent task ID.
+- **`logs [<id>]`**: Print a task's execution log to stdout, including retained
+  logs for removed tasks. If no ID is provided, it defaults to the active or
+  most recent task. Orchestrator hook output is automatically appended.
 
 ### Execution
 

{lemming_cli-0.2.1 → lemming_cli-0.3.0}/README.md

@@ -224,13 +224,20 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
 
 ### Roadmap Management
 
-- **`status [<id>]`**: Roadmap overview or deep-dive into a specific task.
+- **`status [<id>]`**: Queue/history overview or deep-dive into a specific
+  task, including supersession lineage and runner/orchestrator-hook execution
+  times. Superseded and failed history stays visible in the default overview;
+  `--verbose` also shows routine completed/cancelled history.
 - **`goal [<text>]`**: Set or view the long-term goal shared by all tasks.
   Supports `-f/--file`.
 - **`add <desc>`**: Append a new task. Supports `--index` and `--runner`.
 - **`edit <id>`**: Modify a task's description, runner, or position.
-- **`delete <id>`**: Remove a task. Supports `--all` and `--completed` for bulk
-  operations.
+- **`delete <id>`**: Remove an unstarted task while retaining its runner log.
+  Tasks with execution history require `--force`; autonomous restructuring
+  should use `supersede`. Supports `--all` and `--completed` for bulk cleanup,
+  including logs.
+- **`supersede <id> --reason <text>`**: Retire a replaced or split task without
+  losing its progress, timings, log, or links to replacement tasks.
 - **`progress`**: Manage progress entries and findings for specific tasks.
   - `list <id>`: List all progress for a task.
   - `add <id> <finding>`: Record a new technical detail.
@@ -261,9 +268,11 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
 - **`fail <id>`**: Mark a task as a terminal failure (will not be retried).
 - **`cancel <id>`**: Stop an in-progress task (kills the runner process).
 - **`reset <id>`**: Clear attempts and progress to start a task fresh.
-- **`logs [<id>]`**: Print a task's execution log to stdout. If no ID is
-  provided, it defaults to the active or most recent task. Orchestrator hook
-  output is automatically appended.
+- Superseded tasks remain visible as non-failing history; replacement tasks
+  link back through their parent task ID.
+- **`logs [<id>]`**: Print a task's execution log to stdout, including retained
+  logs for removed tasks. If no ID is provided, it defaults to the active or
+  most recent task. Orchestrator hook output is automatically appended.
 
 ### Execution
 

{lemming_cli-0.2.1 → lemming_cli-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "lemming-cli"
-version = "0.2.1"
+version = "0.3.0"
 description = "An autonomous, iterative task runner for AI coding agents."
 readme = "README.md"
 authors = [

{lemming_cli-0.2.1 → lemming_cli-0.3.0}/src/lemming/api/tasks.py

@@ -76,6 +76,11 @@ def update_task(
     """Update a task's description, runner, position, status, or parent."""
     tasks_file = context.resolve_tasks_file(request.app.state, project)
     status = update.get("status")
+    if status == tasks.TaskStatus.SUPERSEDED:
+        raise fastapi.HTTPException(
+            400,
+            "Use the supersede endpoint so a reason is recorded.",
+        )
 
     # Validation: require progress if completing or failing from the UI,
     # but not if we are just marking a finished task as pending (uncomplete).
@@ -91,6 +96,7 @@ def update_task(
             tasks.TaskStatus.COMPLETED,
             tasks.TaskStatus.FAILED,
             tasks.TaskStatus.CANCELLED,
+            tasks.TaskStatus.SUPERSEDED,
         ):
             require_progress = True
 
@@ -130,11 +136,39 @@ def delete_task(
 ):
     """Delete a single task by ID."""
     tasks.delete_tasks(
-        context.resolve_tasks_file(request.app.state, project), task_id=task_id
+        context.resolve_tasks_file(request.app.state, project),
+        task_id=task_id,
+        force=True,
     )
     return {"status": "ok"}
 
 
+class SupersedeTaskRequest(pydantic.BaseModel):
+    """Request body for superseding a task."""
+
+    reason: str
+
+
+@router.post("/api/tasks/{task_id}/supersede")
+def supersede_task(
+    request: fastapi.Request,
+    task_id: str,
+    body: SupersedeTaskRequest,
+    project: str | None = None,
+):
+    """Supersede a task while retaining its history."""
+    try:
+        return tasks.supersede_task(
+            context.resolve_tasks_file(request.app.state, project),
+            task_id,
+            body.reason,
+        )
+    except ValueError as e:
+        if "not found" in str(e):
+            raise fastapi.HTTPException(404, str(e))
+        raise fastapi.HTTPException(400, str(e))
+
+
 @router.post("/api/tasks/{task_id}/cancel")
 def cancel_task_endpoint(
     request: fastapi.Request, task_id: str, project: str | None = None

{lemming_cli-0.2.1 → lemming_cli-0.3.0}/src/lemming/api/tasks_test.py

@@ -174,6 +174,25 @@ def test_reopen_cancelled_task_via_api(client, test_tasks):
     assert response.json()["attempts"] == 0
 
 
+def test_supersede_and_reopen_task_via_api(client, test_tasks):
+    response = client.post(
+        "/api/tasks/task2/supersede",
+        json={"reason": "split after timeout"},
+    )
+    assert response.status_code == 200
+    assert response.json()["status"] == tasks.TaskStatus.SUPERSEDED
+    assert response.json()["superseded_reason"] == "split after timeout"
+
+    response = client.post(
+        "/api/tasks/task2/update",
+        json={"status": tasks.TaskStatus.PENDING},
+    )
+    assert response.status_code == 200
+    assert response.json()["status"] == tasks.TaskStatus.PENDING
+    assert response.json()["superseded_reason"] is None
+    assert response.json()["superseded_at"] is None
+
+
 def test_has_log_population(client, test_tasks):
     # Initially no logs
     response = client.get("/api/data")
@@ -225,7 +244,7 @@ def test_api_log(client, test_tasks):
     assert response.json() == {"log": ""}
 
 
-def test_api_delete_log_cleanup(client, test_tasks):
+def test_api_delete_retains_log(client, test_tasks):
     test_tasks_file = test_tasks
     # 1. Add a task
     data = tasks.load_tasks(test_tasks_file)
@@ -248,6 +267,20 @@ def test_api_delete_log_cleanup(client, test_tasks):
 
     # 3. Delete via API
     response = client.post(f"/api/tasks/{task_id}/delete")
+    assert response.status_code == 200
+    assert log_file.read_text() == "API delete log"
+
+    response = client.get(f"/api/tasks/{task_id}/log")
+    assert response.status_code == 200
+    assert response.json() == {"log": "API delete log"}
+
+
+def test_api_delete_completed_cleans_up_log(client, test_tasks):
+    log_file = paths.get_log_file(test_tasks, "task1")
+    log_file.write_text("completed task log")
+
+    response = client.post("/api/tasks/delete-completed")
+
     assert response.status_code == 200
     assert not log_file.exists()
 

{lemming_cli-0.2.1 → lemming_cli-0.3.0}/src/lemming/cli/tasks.py

@@ -1,5 +1,6 @@
 """CLI commands for managing tasks in the roadmap queue."""
 
+import math
 import time
 import typing
 
@@ -9,6 +10,58 @@ from .. import paths, tasks
 from .main import cli
 
 
+def _format_elapsed_time(seconds: float) -> str:
+    """Format elapsed seconds for CLI status output."""
+    if seconds < 60:
+        return f"{seconds:.1f}s"
+    return f"{int(seconds // 60)}m {int(seconds % 60)}s"
+
+
+def _execution_time_rows(
+    execution_times: dict[str, float] | None,
+) -> list[tuple[str, str]]:
+    """Return display labels and durations with the runner first."""
+    if not execution_times:
+        return []
+
+    components = [
+        (component, duration)
+        for component, duration in execution_times.items()
+        if math.isfinite(duration) and duration > 0
+    ]
+    components.sort(key=lambda item: item[0] != "runner")
+    return [
+        (
+            component.removeprefix("hook:"),
+            _format_elapsed_time(duration),
+        )
+        for component, duration in components
+    ]
+
+
+def _echo_task_summary(task: tasks.Task, all_tasks: list[tasks.Task]) -> None:
+    """Print one task row plus compact supersession lineage."""
+    marker_by_status = {
+        tasks.TaskStatus.COMPLETED: ("[x]", "green"),
+        tasks.TaskStatus.IN_PROGRESS: ("[*]", "cyan"),
+        tasks.TaskStatus.CANCELLED: ("[-]", "red"),
+        tasks.TaskStatus.SUPERSEDED: ("[~]", "magenta"),
+        tasks.TaskStatus.FAILED: ("[!]", "red"),
+        tasks.TaskStatus.PENDING: ("[ ]", "yellow"),
+    }
+    marker, status_color = marker_by_status[task.status]
+    click.secho(f"{marker} ", fg=status_color, nl=False)
+    parent_str = f" [parent:{task.parent}]" if task.parent else ""
+    click.echo(f"({task.id}){parent_str} {task.description}")
+
+    if task.status == tasks.TaskStatus.SUPERSEDED:
+        if task.superseded_reason:
+            click.echo(f"    Reason: {task.superseded_reason}")
+        replacements = [item.id for item in all_tasks if item.parent == task.id]
+        if replacements:
+            click.echo(f"    Replaced by: {', '.join(replacements)}")
+
+
 @cli.command(short_help="[description] Add a new task to the queue")
 @click.argument("description", required=False)
 @click.option(
@@ -165,10 +218,23 @@ def edit(
     is_flag=True,
     help="Delete all tasks and clear the goal.",
 )
-@click.option("--completed", is_flag=True, help="Delete completed tasks only.")
+@click.option(
+    "--completed",
+    is_flag=True,
+    help="Delete terminal task history and its logs.",
+)
+@click.option(
+    "--force",
+    is_flag=True,
+    help="Explicitly remove a task that has execution history.",
+)
 @click.pass_context
 def delete_task(
-    ctx: click.Context, task_id: str | None, delete_all: bool, completed: bool
+    ctx: click.Context,
+    task_id: str | None,
+    delete_all: bool,
+    completed: bool,
+    force: bool,
 ):
     """Deletes one or more tasks from the roadmap."""
     tasks_file = ctx.obj["TASKS_FILE"]
@@ -180,6 +246,9 @@ def delete_task(
     if task_id and (delete_all or completed):
         click.echo("Error: Cannot specify a task ID with --all or --completed.")
         ctx.exit(1)
+    if force and not task_id:
+        click.echo("Error: --force requires a task ID.")
+        ctx.exit(1)
     if not task_id and not delete_all and not completed:
         click.echo("Error: Provide a task ID, or use --all or --completed.")
         ctx.exit(1)
@@ -190,6 +259,7 @@ def delete_task(
             task_id=task_id,
             all_tasks=delete_all,
             completed_only=completed,
+            force=force,
         )
     except ValueError as e:
         click.echo(f"Error: {e}")
@@ -200,14 +270,35 @@ def delete_task(
             "Deleted all tasks, progress, and logs, and cleared the goal."
         )
     elif completed:
-        click.echo(f"Deleted {removed} completed task(s) and their logs.")
+        click.echo(f"Deleted {removed} history task(s) and their logs.")
     elif task_id:
         if removed > 0:
-            click.echo(f"Removed task(s) matching {task_id} and their logs")
+            click.echo(
+                f"Removed task matching {task_id}; runner log retained "
+                "if present."
+            )
         else:
             click.echo(f"Error: Task {task_id} not found.")
 
 
+@cli.command(short_help="<taskid> Replace a task while keeping its history")
+@click.argument("task_id")
+@click.option(
+    "--reason",
+    required=True,
+    help="Why the task was replaced (for example, split after timeout).",
+)
+@click.pass_context
+def supersede(ctx: click.Context, task_id: str, reason: str):
+    """Marks a task as superseded without deleting its execution record."""
+    try:
+        target = tasks.supersede_task(ctx.obj["TASKS_FILE"], task_id, reason)
+        click.echo(f"Task {target.id} marked as superseded: {reason.strip()}")
+    except ValueError as e:
+        click.echo(f"Error: {e}")
+        ctx.exit(1)
+
+
 @cli.command(short_help="<taskid> Show the goal and task details")
 @click.argument("task_id", required=False)
 @click.pass_context
@@ -231,59 +322,81 @@ def status(ctx: click.Context, task_id: str | None):
         if verbose:
             click.secho("=== Long-Term Goal ===", fg="cyan", bold=True)
             click.echo(project_data.goal or "No goal set.")
-            click.secho("\n=== Tasks ===", fg="cyan", bold=True)
 
         if not project_data.tasks:
             if verbose:
                 click.echo("No tasks found.")
             return
 
-        for t in project_data.tasks:
-            if not verbose and t.status in (
-                tasks.TaskStatus.COMPLETED,
-                tasks.TaskStatus.CANCELLED,
-            ):
-                continue
-
-            if t.status == tasks.TaskStatus.COMPLETED:
-                marker = "[x]"
-                status_color = "green"
-            elif t.status == tasks.TaskStatus.IN_PROGRESS:
-                marker = "[*]"
-                status_color = "cyan"
-            elif t.status == tasks.TaskStatus.CANCELLED:
-                marker = "[-]"
-                status_color = "red"
-            else:
-                marker = "[ ]"
-                status_color = "yellow"
-
-            click.secho(f"{marker} ", fg=status_color, nl=False)
-            parent_str = ""
-            if t.parent:
-                parent_str = f" [parent:{t.parent}]"
-
-            click.echo(f"({t.id}){parent_str} {t.description}")
-
-        if not verbose:
-            completed_count = sum(
-                1
-                for t in project_data.tasks
-                if t.status
-                in (tasks.TaskStatus.COMPLETED, tasks.TaskStatus.CANCELLED)
+        terminal_statuses = {
+            tasks.TaskStatus.COMPLETED,
+            tasks.TaskStatus.FAILED,
+            tasks.TaskStatus.CANCELLED,
+            tasks.TaskStatus.SUPERSEDED,
+        }
+        queue = [
+            task
+            for task in project_data.tasks
+            if task.status not in terminal_statuses
+        ]
+        history = [
+            task
+            for task in project_data.tasks
+            if task.status in terminal_statuses
+        ]
+        visible_history = (
+            history
+            if verbose
+            else [
+                task
+                for task in history
+                if task.status
+                in (tasks.TaskStatus.FAILED, tasks.TaskStatus.SUPERSEDED)
+            ]
+        )
+
+        queue_heading = "\n=== Queue ===" if verbose else "Queue:"
+        click.secho(queue_heading, fg="cyan", bold=True)
+        if queue:
+            for task in queue:
+                _echo_task_summary(task, project_data.tasks)
+        else:
+            click.echo("No active tasks.")
+
+        if visible_history:
+            history_heading = "\n=== History ===" if verbose else "\nHistory:"
+            click.secho(history_heading, fg="magenta", bold=True)
+            for task in visible_history:
+                _echo_task_summary(task, project_data.tasks)
+
+        hidden_count = len(history) - len(visible_history)
+        if hidden_count:
+            click.echo(
+                f"({hidden_count} completed/cancelled history task(s) hidden; "
+                "use --verbose to show)"
             )
-            if completed_count > 0:
-                click.echo(
-                    f"({completed_count} completed/cancelled tasks hidden)"
-                )
         return
 
-    target = next(
-        (t for t in project_data.tasks if t.id.startswith(task_id)), None
-    )
+    try:
+        target = tasks.resolve_task(project_data.tasks, task_id)
+    except tasks.TaskNotFoundError:
+        try:
+            retained_log = tasks.resolve_log_file(tasks_file, task_id)
+        except tasks.TaskNotFoundError:
+            click.echo(f"Error: Task {task_id} not found.")
+            return
+        except tasks.AmbiguousTaskIdError as e:
+            click.echo(f"Error: {e}")
+            return
 
-    if not target:
-        click.echo(f"Error: Task {task_id} not found.")
+        retained_id = retained_log.name.removesuffix("-runner.log")
+        click.echo(
+            f"Task {retained_id} was removed; runner log retained at "
+            f"{retained_log}"
+        )
+        return
+    except tasks.AmbiguousTaskIdError as e:
+        click.echo(f"Error: {e}")
         return
 
     if project_data.loop_running:
@@ -304,7 +417,14 @@ def status(ctx: click.Context, task_id: str | None):
     click.echo(f"Status:        {status_str}")
     click.echo(f"Description:   {target.description}")
     if target.parent:
-        click.echo(f"Parent:        {target.parent}")
+        parent = next(
+            (task for task in project_data.tasks if task.id == target.parent),
+            None,
+        )
+        parent_context = (
+            f" [{parent.status}] {parent.description}" if parent else ""
+        )
+        click.echo(f"Parent:        {target.parent}{parent_context}")
     if target.runner:
         click.echo(f"Custom Runner: {target.runner}")
     click.echo(f"Attempts:      {target.attempts}")
@@ -326,16 +446,37 @@ def status(ctx: click.Context, task_id: str | None):
             "%Y-%m-%d %H:%M:%S %Z", time.localtime(target.completed_at)
         )
         click.echo(f"Completed At:  {comp_time}")
+    if target.superseded_at:
+        superseded_time = time.strftime(
+            "%Y-%m-%d %H:%M:%S %Z",
+            time.localtime(target.superseded_at),
+        )
+        click.echo(f"Superseded At: {superseded_time}")
+    if target.superseded_reason:
+        click.echo(f"Reason:         {target.superseded_reason}")
+
+    replacements = [
+        task for task in project_data.tasks if task.parent == target.id
+    ]
+    if replacements:
+        click.echo("Replaced By:")
+        for replacement in replacements:
+            click.echo(
+                f"  {replacement.id} [{replacement.status}] "
+                f"{replacement.description}"
+            )
     run_time = target.run_time
     if target.status == tasks.TaskStatus.IN_PROGRESS and target.last_started_at:
         run_time += time.time() - target.last_started_at
 
     if run_time > 0:
-        if run_time < 60:
-            rt_str = f"{run_time:.1f}s"
-        else:
-            rt_str = f"{int(run_time // 60)}m {int(run_time % 60)}s"
-        click.echo(f"Run Time:      {rt_str}")
+        click.echo(f"Run Time:      {_format_elapsed_time(run_time)}")
+
+    execution_rows = _execution_time_rows(target.execution_times)
+    if execution_rows:
+        label_width = max(len(label) for label, _ in execution_rows)
+        for label, duration in execution_rows:
+            click.echo(f"  {label:<{label_width}}  {duration}")
 
     if target.progress:
         click.secho("\n--- Progress ---", fg="magenta", bold=True)
@@ -350,7 +491,7 @@ def logs(ctx: click.Context, task_id: str | None):
     """Prints the execution log for a task to stdout.
 
     If no task_id is provided, it defaults to the currently running task or
-    the most recently completed one.
+    the most recently finished one.
 
     Note: Orchestrator hooks are appended to the main 'runner' log.
     """
@@ -359,10 +500,18 @@ def logs(ctx: click.Context, task_id: str | None):
     data = tasks.load_tasks(tasks_file)
 
     target = None
+    log_file = None
     if task_id:
-        target = next((t for t in data.tasks if t.id.startswith(task_id)), None)
-        if not target:
-            click.echo(f"Error: Task {task_id} not found.")
+        try:
+            target = tasks.resolve_task(data.tasks, task_id)
+        except tasks.TaskNotFoundError:
+            try:
+                log_file = tasks.resolve_log_file(tasks_file, task_id)
+            except (tasks.TaskNotFoundError, tasks.AmbiguousTaskIdError) as e:
+                click.echo(f"Error: {e}")
+                ctx.exit(1)
+        except tasks.AmbiguousTaskIdError as e:
+            click.echo(f"Error: {e}")
             ctx.exit(1)
     else:
         # Try to find an active task
@@ -371,20 +520,35 @@ def logs(ctx: click.Context, task_id: str | None):
             None,
         )
         if not target:
-            # Fall back to the most recently completed task
-            completed = [
-                t for t in data.tasks if t.status == tasks.TaskStatus.COMPLETED
+            # Fall back to the most recently finished task.
+            finished = [
+                task
+                for task in data.tasks
+                if task.status
+                in (
+                    tasks.TaskStatus.COMPLETED,
+                    tasks.TaskStatus.FAILED,
+                    tasks.TaskStatus.CANCELLED,
+                    tasks.TaskStatus.SUPERSEDED,
+                )
             ]
-            if completed:
-                target = sorted(completed, key=lambda x: x.completed_at or 0)[
-                    -1
-                ]
+            if finished:
+                target = max(
+                    finished,
+                    key=lambda task: (
+                        task.completed_at
+                        or task.superseded_at
+                        or task.created_at
+                        or 0
+                    ),
+                )
 
-    if not target:
-        click.echo("Error: No active or recently completed task found.")
+    if not target and log_file is None:
+        click.echo("Error: No active or recently finished task found.")
         ctx.exit(1)
 
-    log_file = paths.get_log_file(tasks_file, target.id)
+    if log_file is None:
+        log_file = paths.get_log_file(tasks_file, target.id)
     if not log_file.exists():
         click.echo(f"No log for task {target.id}.")
         ctx.exit(1)