delegate-agent-cli 0.22.0__tar.gz → 0.23.0__tar.gz

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.23.0] - 2026-07-30
+
+### Added
+
+- Added `delegate runs prune` with a 30-day default age threshold, an explicit `--older-than` override, and `--dry-run` preview output. It prunes terminal Run records and their associated Registry artifacts (per-Run directory, logs, Completion Report, retained raw-log archive) without touching genuinely running Runs. Persistent-worktree Runs are skipped unless their worktree is recorded as removed or missing — unknown or unrecorded worktree status is treated as possibly present, mirroring `worktree gc` — so live worktrees never lose their Registry records. The ambient retention pass is bypassed on the prune command path so a dry run never mutates state.
+
+### Fixed
+
+- Focused unittest invocations (`python3 -m unittest tests.<module>`) no longer fail on the src layout import: `tests/__init__.py` now puts `src` on `sys.path` before any test module import runs.
+
 ## [0.22.0] - 2026-07-26
 
 ### Changed
@@ -759,6 +769,7 @@ Usage-audit fix wave: 82 sessions and 1,241 delegate invocations from one week o
 
 - Releases before 0.1.3 predate this changelog.
 
+[0.23.0]: https://github.com/treygoff24/delegate-agent/compare/v0.22.0...v0.23.0
 [0.22.0]: https://github.com/treygoff24/delegate-agent/compare/v0.21.0...v0.22.0
 [0.21.0]: https://github.com/treygoff24/delegate-agent/compare/v0.20.0...v0.21.0
 [0.20.0]: https://github.com/treygoff24/delegate-agent/compare/v0.19.0...v0.20.0

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: delegate-agent-cli
-Version: 0.22.0
+Version: 0.23.0
 Summary: A tiny CLI for delegating bounded agent tasks across coding-agent runtimes.
 Author: Trey Goff
 License-Expression: MIT
@@ -332,6 +332,7 @@ delegate runs --recent
 delegate ps                   # active and stale tracked runs
 delegate snapshot <alias-or-runId>
 delegate run-output <alias-or-runId>
+delegate runs prune --dry-run # preview GC of terminal run records older than 30 days
 ```
 
 Aliases are always numbered (`codex-1`, `cursor-2`); a **bare harness name

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/README.md

@@ -299,6 +299,7 @@ delegate runs --recent
 delegate ps                   # active and stale tracked runs
 delegate snapshot <alias-or-runId>
 delegate run-output <alias-or-runId>
+delegate runs prune --dry-run # preview GC of terminal run records older than 30 days
 ```
 
 Aliases are always numbered (`codex-1`, `cursor-2`); a **bare harness name

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/docs/cli-reference.md

@@ -931,6 +931,7 @@ Tracked runs return bounded parent-facing output and store local metadata under
 
 ```bash
 delegate runs [--active|--running|--stale|--recent] [--harness HARNESS] [--group NAME] [--limit N]
+delegate runs prune [--older-than DAYS] [--dry-run]
 delegate ps [--harness HARNESS] [--group NAME] [--limit N]
 delegate snapshot [--latest HARNESS] [--no-redact] <handle>
 delegate run-output [--latest HARNESS] <handle> [--completion-report] [--stdout] [--stderr] [--tail N] [--max-chars N] [--raw] [--no-redact]
@@ -942,6 +943,8 @@ delegate cancel <handle>...
 `delegate ps` is the shorter first-class form of `delegate runs --active` and
 accepts the same harness, group, and limit selectors.
 
+`delegate runs prune` removes old terminal Run records from the workspace Registry so they stop accumulating forever. Only runs whose effective status is terminal (`succeeded`, `failed`, `cancelled`, or `stale` from a dead child) and whose last Registry activity is older than the threshold (default 30 days; override with `--older-than DAYS`) are eligible. Effectively running runs are always skipped, and persistent-worktree runs are skipped unless their worktree is recorded as removed or missing — pruning the record of a live worktree would orphan it from `worktree list`/`show`/`remove`. Pruning deletes the per-Run directory (Snapshot, Manifest, logs, events, Completion Report) and the retained raw-log archive; worktree paths on disk are never touched. `--dry-run` reports what would be removed without changing anything. JSON output uses schema `delegate.runs-prune.v1` with `planned`, `removed`, `skipped` (each entry carries a `reason`), and `errors` sections.
+
 Run-scoped handles (`snapshot`, `run-output`, `wait`, and `cancel`)
 resolve exact run IDs and numbered aliases first. A bare harness name such as
 `codex` resolves to that harness's latest run, and `harness:modelAlias` (for

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/docs/delegate-workflows.md

@@ -175,6 +175,7 @@ engines = args.get("engines", ["codex", "claude", "cursor"])
 models = args.get("models", {})
 prompt = args["prompt"]
 
+
 def reviewer(engine):
     return lambda: agent(
         prompt,
@@ -184,6 +185,7 @@ def reviewer(engine):
         phase=f"Review ({engine})",
     )
 
+
 reviews = parallel([reviewer(engine) for engine in engines])
 return {"reviews": dict(zip(engines, reviews))}
 ```

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "delegate-agent-cli"
-version = "0.22.0"
+version = "0.23.0"
 description = "A tiny CLI for delegating bounded agent tasks across coding-agent runtimes."
 readme = "README.md"
 requires-python = ">=3.11"

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/__init__.py

@@ -1,5 +1,5 @@
 """Delegate Agent CLI package."""
 
-VERSION = "0.22.0"
+VERSION = "0.23.0"
 
 __all__ = ["VERSION"]

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/cli.py

@@ -1180,7 +1180,12 @@ def main(
             "workflow",
         }:
             existing_registry = run_registry.registry_root_if_exists(Path(workspace.path))
-            if existing_registry is not None:
+            pruning_runs = (
+                parsed.subcommand == "runs"
+                and parsed.runs is not None
+                and parsed.runs.action == "prune"
+            )
+            if existing_registry is not None and not pruning_runs:
                 maybe_run_retention_pass(existing_registry, config)
         if parsed.subcommand == "snapshot":
             return emit_snapshot(parsed, workspace, stdout)

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/cli_parser.py

@@ -1380,7 +1380,10 @@ def parse_runs(
     # front-ends (ps) do not report errors against flags nobody entered.
     rest, json_mode = consume_json_option(rest, json_mode)
     if any(command_help.is_help_token(token) for token in rest):
-        return help_command(json_mode, "runs")
+        topic = "runs prune" if rest and rest[0] == "prune" else "runs"
+        return help_command(json_mode, topic)
+    if rest and rest[0] == "prune":
+        return parse_runs_prune(rest[1:], json_mode, cwd)
     active = False
     recent = False
     running = False
@@ -1468,6 +1471,37 @@ def parse_runs(
     )
 
 
+def parse_runs_prune(rest: list[str], json_mode: bool, cwd: str | None) -> ParsedCommand:
+    rest, json_mode = consume_json_option(rest, json_mode)
+    if any(command_help.is_help_token(token) for token in rest):
+        return help_command(json_mode, "runs prune")
+    older_than_days = None
+    dry_run = False
+    i = 0
+    while i < len(rest):
+        token = rest[i]
+        if token == "--older-than":
+            value = _require_option_value(rest, i, token)
+            older_than_days = parse_non_negative_int(value, option="runs prune --older-than")
+            i += 2
+            continue
+        if token == "--dry-run":
+            dry_run = True
+            i += 1
+            continue
+        raise DelegateError("unknown_option", f"runs prune does not support option: {token}")
+    return ParsedCommand(
+        "runs",
+        global_options=GlobalOptions(json_mode=json_mode, cwd=cwd),
+        runs=inspection_commands.RunsCommand(
+            action="prune",
+            older_than_days=older_than_days,
+            dry_run=dry_run,
+            json_mode=json_mode,
+        ),
+    )
+
+
 def parse_ps(rest: list[str], json_mode: bool, cwd: str | None) -> ParsedCommand:
     rest, json_mode = consume_json_option(rest, json_mode)
     if any(command_help.is_help_token(token) for token in rest):

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/command_help.py

@@ -16,6 +16,7 @@ from dataclasses import dataclass, field
 from delegate_agent import VERSION
 from delegate_agent.constants import ENGINES_PROSE
 from delegate_agent.json_types import JsonObject
+from delegate_agent.run_registry import DEFAULT_RUN_PRUNE_DAYS
 
 
 @dataclass(frozen=True)
@@ -818,7 +819,34 @@ COMMAND_SPECS: dict[str, CommandSpec] = {
             "delegate runs --group wave4",
         ),
         notes=("--active, --running, --stale, and --recent are mutually exclusive.",),
-        see_also=("ps", "snapshot", "run-output"),
+        see_also=("ps", "runs prune", "snapshot", "run-output"),
+        unsupported_global_options=("--auth-profile",),
+    ),
+    "runs prune": CommandSpec(
+        name="runs prune",
+        summary="Prune old terminal Run records from the workspace Registry.",
+        usage=("delegate [--cwd PATH] [--json] runs prune [--older-than DAYS] [--dry-run]",),
+        options=(
+            OptionSpec(
+                "--older-than",
+                "DAYS",
+                f"Prune Runs older than DAYS by Registry activity time (defaults to {DEFAULT_RUN_PRUNE_DAYS}; non-negative integer).",
+            ),
+            OptionSpec(
+                "--dry-run",
+                None,
+                "Report planned removals without changing the Registry, logs, or artifacts.",
+            ),
+        ),
+        examples=(
+            "delegate runs prune --dry-run",
+            "delegate runs prune --older-than 14",
+        ),
+        notes=(
+            "Only terminal effective statuses are eligible: succeeded, failed, cancelled, and stale from a dead child; effective running Runs are always skipped.",
+            "Runs with a registered present persistent worktree are skipped, so their worktree remains manageable. Pruning removes the per-Run directory, including its Snapshot, Manifest, logs, events, and Completion Report, plus the retained raw-log archive.",
+        ),
+        see_also=("runs", "snapshot", "run-output"),
         unsupported_global_options=("--auth-profile",),
     ),
     "ps": CommandSpec(
@@ -1745,6 +1773,7 @@ def render_overview_text() -> str:
         "delegate [--cwd PATH] [--json] snapshot [--latest HARNESS] [--no-redact] <handle>",
         "delegate [--cwd PATH] [--json] runs "
         "[--active|--running|--stale|--recent] [--harness HARNESS] [--limit N]",
+        "delegate [--cwd PATH] [--json] runs prune [--older-than DAYS] [--dry-run]",
         "delegate [--cwd PATH] [--json] ps [--harness HARNESS] [--group NAME] [--limit N]",
         "delegate [--cwd PATH] [--json] run-output <handle> "
         "[--completion-report] [--stdout] [--stderr] [--tail N] [--max-chars N] "

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/inspection_commands.py

@@ -19,12 +19,15 @@ class SnapshotCommand:
 
 @dataclass(frozen=True)
 class RunsCommand:
+    action: str | None = None
     active: bool = False
     running: bool = False
     stale: bool = False
     harness: str | None = None
     group: str | None = None
     limit: int | None = None
+    older_than_days: int | None = None
+    dry_run: bool = False
     json_mode: bool = False
 
 
@@ -64,6 +67,34 @@ def emit_snapshot(command: SnapshotCommand, *, workspace_path: str, stdout: Text
 
 def emit_runs(command: RunsCommand, *, workspace_path: str, stdout: TextIO) -> int:
     registry_root = run_registry.registry_root_if_exists(Path(workspace_path))
+    if command.action == "prune":
+        older_than_days = (
+            command.older_than_days
+            if command.older_than_days is not None
+            else run_registry.DEFAULT_RUN_PRUNE_DAYS
+        )
+        payload = (
+            run_registry.prune_runs(
+                registry_root,
+                older_than_days=older_than_days,
+                dry_run=command.dry_run,
+            )
+            if registry_root is not None
+            else run_registry.empty_run_prune_payload(
+                older_than_days=older_than_days,
+                dry_run=command.dry_run,
+            )
+        )
+        if command.json_mode:
+            delegate_rendering.print_json(payload, stdout)
+        else:
+            delegate_rendering.render_runs_prune_text(payload, stdout)
+        if payload.get("ok") is False:
+            exit_code = payload.get("exitCode")
+            return exit_code if isinstance(exit_code, int) else 1
+        return 0
+    if command.action is not None:
+        raise InspectionError("unknown_runs_action", f"Unknown runs action: {command.action}")
     limit = command.limit or run_registry.DEFAULT_RUNS_LIMIT
     if command.running:
         mode = "running"

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/rendering.py

@@ -554,6 +554,24 @@ def render_worktree_prune_text(payload: JsonObject, stdout: TextIO) -> None:
                     print(f"  - {label} {detail}", file=stdout)
 
 
+def render_runs_prune_text(payload: JsonObject, stdout: TextIO) -> None:
+    print(f"older than: {payload.get('olderThanDays', '?')} days", file=stdout)
+    if payload.get("dryRun") is True:
+        print("dry run: Registry, logs, and artifacts unchanged", file=stdout)
+    for section in ("planned", "removed", "skipped", "errors"):
+        items = payload.get(section)
+        count = len(items) if isinstance(items, list) else 0
+        print(f"{section}: {count}", file=stdout)
+        if isinstance(items, list):
+            for item in items[:20]:
+                if isinstance(item, dict):
+                    label = item.get("alias") or item.get("runId") or "?"
+                    detail = (
+                        item.get("reason") or item.get("code") or item.get("effectiveStatus") or ""
+                    )
+                    print(f"  - {label} {detail}", file=stdout)
+
+
 def render_worktree_gc_text(payload: JsonObject, stdout: TextIO) -> None:
     print(f"reconciled: {payload.get('reconciled', 0)}", file=stdout)
     if payload.get("dryRun") is True:

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/run_registry.py

@@ -6,16 +6,17 @@ import os
 import re
 import secrets
 import shlex
+import shutil
 import subprocess
 import time
 from collections.abc import Iterator
 from contextlib import contextmanager
 from dataclasses import dataclass
-from datetime import UTC, datetime
+from datetime import UTC, datetime, timedelta
 from pathlib import Path
 
-from delegate_agent import private_io
-from delegate_agent.json_types import JsonObject
+from delegate_agent import archived_logs, private_io
+from delegate_agent.json_types import JsonObject, is_non_negative_int
 from delegate_agent.private_io import (  # noqa: F401  # re-exported
     RegistryJsonError,
     ensure_private_dir,
@@ -47,6 +48,9 @@ STATE_SCHEMA = "delegate.state.v1"
 SNAPSHOT_SCHEMA = "delegate.snapshot.v1"
 RUNS_SCHEMA = "delegate.runs.v1"
 RUN_OUTPUT_SCHEMA = "delegate.run-output.v1"
+RUNS_PRUNE_SCHEMA = "delegate.runs-prune.v1"
+DEFAULT_RUN_PRUNE_DAYS = 30
+RUN_PRUNE_ERROR_EXIT_CODE = 1
 REGISTRY_LOCK_NAME = ".registry.lock"
 REGISTRY_LOCK_TIMEOUT_SECONDS = 30.0
 REGISTRY_LOCK_POLL_SECONDS = 0.05
@@ -832,3 +836,151 @@ from delegate_agent.run_status import (  # noqa: E402, F401  # re-exported
     stale_next_actions,
     status_fields,
 )
+
+
+def _run_prune_ref(
+    index: JsonObject,
+    run_id: str,
+    status: str,
+    *,
+    reason: str | None = None,
+) -> JsonObject:
+    entry: JsonObject = {
+        "alias": alias_for_run(index, run_id),
+        "runId": run_id,
+        "effectiveStatus": status,
+    }
+    if reason is not None:
+        entry["reason"] = reason
+    return entry
+
+
+def _remove_run_record_artifacts(registry_root: Path, run_id: str) -> None:
+    run_path = run_directory(registry_root, run_id)
+    if run_path.is_symlink():
+        raise OSError(f"refusing to prune symlinked run directory: {run_path}")
+    if run_path.exists():
+        shutil.rmtree(run_path)
+    archived_logs.archive_path(registry_root, run_id).unlink(missing_ok=True)
+
+
+def empty_run_prune_payload(*, older_than_days: int, dry_run: bool) -> JsonObject:
+    return {
+        "schema": RUNS_PRUNE_SCHEMA,
+        "ok": True,
+        "olderThanDays": older_than_days,
+        "dryRun": dry_run,
+        "planned": [],
+        "removed": [],
+        "skipped": [],
+        "errors": [],
+    }
+
+
+def prune_runs(
+    registry_root: Path,
+    *,
+    older_than_days: int = DEFAULT_RUN_PRUNE_DAYS,
+    dry_run: bool = False,
+    now: datetime | None = None,
+) -> JsonObject:
+    """Prune old terminal Run records and their per-Run artifacts."""
+    if not is_non_negative_int(older_than_days):
+        raise ValueError("older_than_days must be a non-negative integer")
+    # worktree_records imports this module, so keep this dependency local.
+    from delegate_agent import worktree_records
+
+    cutoff = (now or datetime.now(UTC)) - timedelta(days=older_than_days)
+    planned: list[JsonObject] = []
+    removed: list[JsonObject] = []
+    skipped: list[JsonObject] = []
+    errors: list[JsonObject] = []
+    index_changed = False
+
+    with registry_lock(registry_root):
+        index = load_index(registry_root)
+        # Like worktree gc, treat unknown/unrecorded status as possibly present:
+        # only records whose worktree is affirmatively gone are prunable.
+        present_persistent_worktree_run_ids = {
+            record["runId"]
+            for record in worktree_records.load_persistent_records(registry_root)
+            if record.get("registryWorktreeStatus")
+            not in (worktree_records.STATUS_REMOVED, worktree_records.STATUS_MISSING)
+        }
+        for run_id, index_entry in list(index.get("runs", {}).items()):
+            if not isinstance(run_id, str) or not isinstance(index_entry, dict):
+                continue
+            if not RUN_ID_RE.fullmatch(run_id):
+                skipped.append(
+                    _run_prune_ref(
+                        index, run_id, run_status.STATUS_UNKNOWN, reason="invalid_run_id"
+                    )
+                )
+                continue
+            state = load_run_state_or_none(registry_root, run_id)
+            effective_status = run_status.effective_status(state)
+            if run_id in present_persistent_worktree_run_ids:
+                skipped.append(
+                    _run_prune_ref(
+                        index,
+                        run_id,
+                        effective_status,
+                        reason="persistent_worktree",
+                    )
+                )
+                continue
+            if effective_status == run_status.STATUS_RUNNING:
+                skipped.append(_run_prune_ref(index, run_id, effective_status, reason="running"))
+                continue
+            if effective_status not in run_status.TERMINAL_STATUSES | {run_status.STATUS_STALE}:
+                skipped.append(
+                    _run_prune_ref(index, run_id, effective_status, reason="non_terminal")
+                )
+                continue
+            manifest = load_run_manifest_or_none(registry_root, run_id)
+            activity = run_status.activity_datetime(state, manifest, run_id)
+            if activity is None:
+                skipped.append(
+                    _run_prune_ref(index, run_id, effective_status, reason="invalid_activity")
+                )
+                continue
+            if activity >= cutoff:
+                skipped.append(
+                    _run_prune_ref(index, run_id, effective_status, reason="not_yet_old_enough")
+                )
+                continue
+            candidate = _run_prune_ref(index, run_id, effective_status)
+            candidate["activityAt"] = run_status.activity_timestamp(state, manifest, run_id)
+            planned.append(candidate)
+            if dry_run:
+                continue
+            try:
+                _remove_run_record_artifacts(registry_root, run_id)
+            except OSError as exc:
+                errors.append({**candidate, "code": "record_remove_failed", "message": str(exc)})
+                continue
+            for alias, target_run_id in list(index.get("aliases", {}).items()):
+                if target_run_id != run_id:
+                    continue
+                index["aliases"].pop(alias, None)
+                if isinstance(alias, str) and alias and alias not in {".", ".."}:
+                    claim_path = aliases_dir(registry_root) / alias
+                    if Path(alias).name == alias and (
+                        claim_path.is_file() or claim_path.is_symlink()
+                    ):
+                        claim_path.unlink(missing_ok=True)
+            index["runs"].pop(run_id, None)
+            removed.append(candidate)
+            index_changed = True
+        if index_changed:
+            save_index(registry_root, index)
+
+    payload = empty_run_prune_payload(older_than_days=older_than_days, dry_run=dry_run)
+    payload["planned"] = planned
+    payload["removed"] = removed
+    payload["skipped"] = skipped
+    payload["errors"] = errors
+    if errors:
+        payload["ok"] = False
+        payload["exitCode"] = RUN_PRUNE_ERROR_EXIT_CODE
+    return payload

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/src/delegate_agent_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: delegate-agent-cli
-Version: 0.22.0
+Version: 0.23.0
 Summary: A tiny CLI for delegating bounded agent tasks across coding-agent runtimes.
 Author: Trey Goff
 License-Expression: MIT
@@ -332,6 +332,7 @@ delegate runs --recent
 delegate ps                   # active and stale tracked runs
 delegate snapshot <alias-or-runId>
 delegate run-output <alias-or-runId>
+delegate runs prune --dry-run # preview GC of terminal run records older than 30 days
 ```
 
 Aliases are always numbered (`codex-1`, `cursor-2`); a **bare harness name

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/tests/test_delegate_help_cli.py

@@ -101,6 +101,7 @@ class MultiLevelHelpTests(HelpCliTestBase):
         (["dry-run", "droid", "--help"], "dry-run"),
         (["worktree", "remove", "--help"], "worktree remove"),
         (["worktree", "prune", "--help"], "worktree prune"),
+        (["runs", "prune", "--help"], "runs prune"),
         (["worktree", "list", "--help"], "worktree list"),
         (["worktree", "show", "--help"], "worktree show"),
         (["worktree", "gc", "--help"], "worktree gc"),

{delegate_agent_cli-0.22.0 → delegate_agent_cli-0.23.0}/tests/test_delegate_parser.py

@@ -1100,6 +1100,30 @@ class ParserTests(unittest.TestCase):
             self.delegate.parse_cli(["runs", "--limit", "0"])
         self.assertEqual(ctx.exception.error, "invalid_limit")
 
+    def test_runs_prune_parses_age_override_and_dry_run(self):
+        parsed = self.delegate.parse_cli(
+            [
+                "--json",
+                "--cwd",
+                "/tmp/repo",
+                "runs",
+                "prune",
+                "--older-than",
+                "14",
+                "--dry-run",
+            ]
+        )
+        self.assertEqual(parsed.subcommand, "runs")
+        self.assertEqual(parsed.runs.action, "prune")
+        self.assertEqual(parsed.runs.older_than_days, 14)
+        self.assertTrue(parsed.runs.dry_run)
+        self.assertTrue(parsed.runs.json_mode)
+
+    def test_runs_prune_rejects_negative_age(self):
+        with self.assertRaises(self.delegate.DelegateError) as ctx:
+            self.delegate.parse_cli(["runs", "prune", "--older-than", "-1"])
+        self.assertEqual(ctx.exception.error, "missing_option_value")
+
     def test_has_misplaced_global_option_detects_exact_tokens(self):
         self.assertFalse(self.delegate.has_misplaced_global_option([]))
         self.assertFalse(self.delegate.has_misplaced_global_option(["--jsonish"]))