cli-agent-runner 0.2.7__tar.gz → 0.2.8__tar.gz

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/.vulture-whitelist.py

@@ -232,6 +232,16 @@ stash_idempotency_s
 # agent_runner.lifecycle.PIDFile
 path
 
+# agent_runner.migrations.Migration
+detect
+apply
+describe
+
+# agent_runner.migrations.MigrationResult
+new_text
+applied
+manual
+
 # agent_runner.monitor.LocalSource
 log_dir
 

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be 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.2.8] - 2026-08-25
+
+### Added
+- `agent-runner migrate [--dry-run]` rewrites removed/renamed fields in `agent-runner.toml` to their current form, keeping a `.bak`; reports fields needing a manual change.
+- `upgrade` auto-migrates the config before the package/service step and emits a `config_migrated` event; a config needing a manual change aborts the run before it stops the service. `--no-migrate` skips it.
+
+### Changed
+- Removed-field `ConfigError` messages now point to `agent-runner migrate`.
+
+See `docs/migrations/0.2.8.md`.
+
 ## [0.2.7] - 2026-08-25
 
 ### Added

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cli-agent-runner
-Version: 0.2.7
+Version: 0.2.8
 Summary: Restart-on-exit supervisor for autonomous CLI agents
 Project-URL: Homepage, https://github.com/wan9yu/cli-agent-runner
 Project-URL: Documentation, https://github.com/wan9yu/cli-agent-runner#readme
@@ -51,7 +51,7 @@ full disks, runaway memory.
 ┌──────────────────────────────────────────┐
 │ Layer 3: The Witness (monitor)           │  11 detectors + auto-stop
 ├──────────────────────────────────────────┤
-│ Layer 2: The Loop (serve, ~120 LOC)      │  signal-trapping restart loop
+│ Layer 2: The Loop (serve)                │  signal-trapping restart loop
 ├──────────────────────────────────────────┤
 │ Layer 1: The Round (round)               │  one agent invocation
 └──────────────────────────────────────────┘
@@ -80,14 +80,15 @@ agent-runner monitor              # live anomaly detection
 
 Full walkthrough: [`docs/quickstart.md`](docs/quickstart.md).
 
-## 15 verbs
+## 16 verbs
 
 | Lifecycle | Observation |
 |---|---|
 | `init` / `install` / `uninstall` | `peek` — state snapshot |
 | `start` / `stop` / `kill` | `watch` — peek in a refresh loop |
 | `restart` / `status` | `monitor` — 11 detectors, alerts, auto-stop |
-| `round` / `serve` / `upgrade` | `events` — query / stream events.jsonl |
+| `round` / `serve` | `events` — query / stream events.jsonl |
+| `upgrade` / `migrate` | |
 
 Verb reference: [`docs/commands.md`](docs/commands.md).
 
@@ -106,6 +107,10 @@ guards it. Highlights:
 
 Full list and rationale: [`docs/architecture.md`](docs/architecture.md).
 
+Optionally pause the loop during off-hours: `[schedule]` run/pause windows gate
+`serve` (override with `serve --ignore-schedule`) — see the `[schedule]` section
+of [`docs/configuration.md`](docs/configuration.md).
+
 ## Monitor: 11 detectors
 
 Notify only: `timeout_rate`, `hung`, `orphan_chain`, `disk_warning`,

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/README.md

@@ -15,7 +15,7 @@ full disks, runaway memory.
 ┌──────────────────────────────────────────┐
 │ Layer 3: The Witness (monitor)           │  11 detectors + auto-stop
 ├──────────────────────────────────────────┤
-│ Layer 2: The Loop (serve, ~120 LOC)      │  signal-trapping restart loop
+│ Layer 2: The Loop (serve)                │  signal-trapping restart loop
 ├──────────────────────────────────────────┤
 │ Layer 1: The Round (round)               │  one agent invocation
 └──────────────────────────────────────────┘
@@ -44,14 +44,15 @@ agent-runner monitor              # live anomaly detection
 
 Full walkthrough: [`docs/quickstart.md`](docs/quickstart.md).
 
-## 15 verbs
+## 16 verbs
 
 | Lifecycle | Observation |
 |---|---|
 | `init` / `install` / `uninstall` | `peek` — state snapshot |
 | `start` / `stop` / `kill` | `watch` — peek in a refresh loop |
 | `restart` / `status` | `monitor` — 11 detectors, alerts, auto-stop |
-| `round` / `serve` / `upgrade` | `events` — query / stream events.jsonl |
+| `round` / `serve` | `events` — query / stream events.jsonl |
+| `upgrade` / `migrate` | |
 
 Verb reference: [`docs/commands.md`](docs/commands.md).
 
@@ -70,6 +71,10 @@ guards it. Highlights:
 
 Full list and rationale: [`docs/architecture.md`](docs/architecture.md).
 
+Optionally pause the loop during off-hours: `[schedule]` run/pause windows gate
+`serve` (override with `serve --ignore-schedule`) — see the `[schedule]` section
+of [`docs/configuration.md`](docs/configuration.md).
+
 ## Monitor: 11 detectors
 
 Notify only: `timeout_rate`, `hung`, `orphan_chain`, `disk_warning`,

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/agent_runner/_docgen.py

@@ -7,12 +7,16 @@ renderer registry so the substitution rule is testable in isolation.
 
 from __future__ import annotations
 
+import argparse
 import dataclasses
+import functools
+import importlib.resources
 import re
 import typing
 from collections.abc import Callable
 from pathlib import Path
 
+from agent_runner.cli.init_cmd import _preset_names
 from agent_runner.config import (
     AgentConfig,
     Config,
@@ -152,18 +156,53 @@ def render_event_kinds_list() -> str:
     return "\n".join(f"- `{k}`" for k in sorted(KNOWN_EVENT_KINDS))
 
 
-def render_verb_table() -> str:
-    """Walk the argparse subparsers and render a verb table."""
+def _subparser_action() -> argparse.Action:
+    """The single ``_SubParsersAction`` on the top-level parser."""
     from agent_runner.cli import _build_parser
 
     parser = _build_parser()
-    # Find the sub-parsers action — there's exactly one.
-    sub_action = next(a for a in parser._actions if a.__class__.__name__ == "_SubParsersAction")
+    return next(a for a in parser._actions if a.__class__.__name__ == "_SubParsersAction")
+
+
+def _subparser_choices() -> dict[str, argparse.ArgumentParser]:
+    """Map ``verb -> subparser`` for the CLI, the SSOT both verb renderers use."""
+    return _subparser_action().choices
+
+
+def _render_verb_flags(verb: str) -> str:
+    """Bullet list of a verb's own option flags, from its argparse subparser.
+
+    Parent-inherited ``--config`` / ``--json`` carry ``help=SUPPRESS`` on the
+    shared parent and are filtered here, so only verb-specific flags render.
+    """
+    choices = _subparser_choices()
+    lines: list[str] = []
+    for act in choices[verb]._actions:
+        if not act.option_strings:  # positionals
+            continue
+        if isinstance(act, argparse._HelpAction):  # -h/--help
+            continue
+        if act.help is argparse.SUPPRESS:  # parent --config/--json
+            continue
+        name = max(act.option_strings, key=len)
+        if act.choices:
+            val = " {" + ",".join(map(str, act.choices)) + "}"
+        elif act.metavar:
+            val = f" {act.metavar}"
+        else:
+            val = ""
+        lines.append(f"- `{name}{val}` — {act.help}")
+    return "\n".join(lines)
+
+
+def render_verb_table() -> str:
+    """Walk the argparse subparsers and render a verb table."""
+    sub_action = _subparser_action()
     rows = [
         "| Verb | Description |",
         "|---|---|",
     ]
-    for verb, _sp in sub_action.choices.items():
+    for verb in sub_action.choices:
         # Argparse stores help text via `sub_action._choices_actions` indexed by add order.
         help_text = (
             next(
@@ -176,6 +215,18 @@ def render_verb_table() -> str:
     return "\n".join(rows)
 
 
+def _render_preset(name: str) -> str:
+    """Fenced TOML block quoting a shipped ``agent_runner/presets/<name>.toml``.
+
+    The preset file is the SSOT; the recipe doc block is a verbatim mirror so a
+    flag or auth-hint edit in the preset can never drift from its recipe.
+    """
+    body = (importlib.resources.files("agent_runner.presets") / f"{name}.toml").read_text(
+        encoding="utf-8"
+    )
+    return "```toml\n" + body.rstrip() + "\n```"
+
+
 RENDERERS: dict[str, Callable[[], str]] = {
     "defenses-table": render_defenses_table,
     "detector-list": render_detector_list,
@@ -183,6 +234,13 @@ RENDERERS: dict[str, Callable[[], str]] = {
     "config-schema": render_config_schema_table,
     "verb-table": render_verb_table,
 }
+RENDERERS.update(
+    {
+        f"flags-{v}": functools.partial(_render_verb_flags, v)
+        for v in ("init", "monitor", "serve", "migrate")
+    }
+)
+RENDERERS.update({f"preset-{n}": functools.partial(_render_preset, n) for n in _preset_names()})
 
 _GEN_OPEN = re.compile(r"<!-- gen:([a-z0-9-]+) -->")
 
@@ -196,7 +254,9 @@ def render(docs_dir: Path, *, write: bool = True) -> dict[Path, str]:
     Raises ``ValueError`` when a marker references an unknown renderer name.
     """
     out: dict[Path, str] = {}
-    for md in sorted(docs_dir.glob("*.md")):
+    # Top-level docs plus recipes/. NOT rglob: migrations/ is frozen history and
+    # internal/ is gitignored — neither should be regenerated.
+    for md in sorted(docs_dir.glob("*.md")) + sorted((docs_dir / "recipes").glob("*.md")):
         text = md.read_text(encoding="utf-8")
         for match in _GEN_OPEN.finditer(text):
             name = match.group(1)

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/agent_runner/_emit.py

@@ -17,6 +17,7 @@ __all__ = [
     "emit_agent_auth_error_detected",
     "emit_agent_usage_recorded",
     "emit_anomaly_repetitive_tool",
+    "emit_config_migrated",
     "emit_fresh_eyes_round_triggered",
     "emit_max_rounds_reached",
     "emit_rate_limit_stop",
@@ -72,6 +73,15 @@ def emit_crash_loop(log_dir: Path, *, consecutive: int, exit_code: int, log_path
     emit(log_dir, CRASH_LOOP, consecutive=consecutive, exit_code=exit_code, reason=reason)
 
 
+def emit_config_migrated(
+    log_dir: Path, *, applied: list[str], manual: list[str], path: str
+) -> None:
+    """Emit config_migrated when `migrate`/`upgrade` rewrites the config."""
+    from agent_runner.events import CONFIG_MIGRATED, emit
+
+    emit(log_dir, CONFIG_MIGRATED, applied=applied, manual=manual, path=path)
+
+
 def emit_stop_file_detected(
     log_dir: Path, *, stop_file: Path, content: str, rounds_completed: int
 ) -> None:

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/agent_runner/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.7'
-__version_tuple__ = version_tuple = (0, 2, 7)
+__version__ = version = '0.2.8'
+__version_tuple__ = version_tuple = (0, 2, 8)
 
 __commit_id__ = commit_id = None

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/agent_runner/api.py

@@ -737,6 +737,7 @@ from agent_runner._emit import (  # noqa: E402,F401 — intentional bottom re-ex
     emit_agent_usage_recorded,
     emit_anomaly_repetitive_tool,
     emit_config_broken,
+    emit_config_migrated,
     emit_crash_loop,
     emit_fresh_eyes_round_triggered,
     emit_max_rounds_reached,

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/agent_runner/cli/__init__.py

@@ -20,6 +20,7 @@ from agent_runner.cli import (
     events_cmd,
     init_cmd,
     install_cmd,
+    migrate_cmd,
     monitor_cmd,
     peek_cmd,
     round_cmd,
@@ -69,6 +70,7 @@ def _build_parser() -> argparse.ArgumentParser:
     serve_cmd.add_parser(sub, parent)
     round_cmd.add_parser(sub, parent)
     upgrade_cmd.add_parser(sub, parent)
+    migrate_cmd.add_parser(sub, parent)
 
     return parser
 

cli_agent_runner-0.2.8/agent_runner/cli/migrate_cmd.py

@@ -0,0 +1,51 @@
+"""agent-runner migrate — rewrite removed/renamed config fields to current form."""
+
+from __future__ import annotations
+
+import tomllib
+from pathlib import Path
+
+from agent_runner import migrations
+from agent_runner.cli.common import fail  # `fail(msg, *, code=1)` prints to stderr, returns code
+
+
+def add_parser(sub, parent) -> None:
+    p = sub.add_parser(
+        "migrate",
+        parents=[parent],
+        help="Rewrite removed/renamed fields in agent-runner.toml to current form",
+    )
+    p.add_argument("--dry-run", action="store_true", help="Show changes without writing the file")
+    p.set_defaults(func=cmd)
+
+
+def cmd(args) -> int:
+    cfg_path = Path(getattr(args, "config", None) or "agent-runner.toml")
+    try:
+        text = cfg_path.read_text(encoding="utf-8")
+    except OSError as e:
+        return fail(f"cannot read {cfg_path}: {e}", code=2)
+    try:
+        parsed = tomllib.loads(text)
+    except tomllib.TOMLDecodeError as e:
+        return fail(f"{cfg_path} is not valid TOML: {e}", code=2)
+
+    result = migrations.run_migrations(text, parsed)
+    if not result.applied and not result.manual:
+        print(f"{cfg_path}: nothing to migrate")
+        return 0
+
+    for line in result.applied:
+        print(f"  rewrite: {line}")
+    for line in result.manual:
+        print(f"  MANUAL:  {line}")
+
+    if args.dry_run:
+        print("(dry-run — no changes written)")
+        return 1 if result.manual else 0
+
+    if result.applied:
+        cfg_path.with_suffix(cfg_path.suffix + ".bak").write_text(text, encoding="utf-8")
+        cfg_path.write_text(result.new_text, encoding="utf-8")
+        print(f"wrote {cfg_path} (backup: {cfg_path.name}.bak)")
+    return 1 if result.manual else 0

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/agent_runner/cli/upgrade_cmd.py

@@ -16,13 +16,14 @@ import re
 import subprocess
 import sys
 import time
+import tomllib
 from pathlib import Path
 
 import agent_runner
-from agent_runner import __version__, api, events
+from agent_runner import __version__, api, events, migrations
 from agent_runner.api_types import ServiceMode
 from agent_runner.cli.common import cfg_from_args, fail, info
-from agent_runner.config import Config
+from agent_runner.config import Config, ConfigError
 
 
 def add_parser(sub, parent) -> None:
@@ -48,11 +49,28 @@ def add_parser(sub, parent) -> None:
         help="Upgrade the package + smoke only; do not stop/start the service "
         "(you restart it yourself).",
     )
+    p.add_argument(
+        "--no-migrate",
+        action="store_true",
+        help="Skip automatic config migration during upgrade",
+    )
     p.set_defaults(func=cmd)
 
 
 def cmd(args) -> int:
+    cfg_path = Path(args.config)
+    applied, manual = _migrate_config_file(cfg_path, no_migrate=getattr(args, "no_migrate", False))
+    if manual:
+        return fail(
+            "config needs manual migration before upgrade:\n  "
+            + "\n  ".join(manual)
+            + "\nfix it (or run `agent-runner migrate`) then retry"
+        )  # aborts BEFORE any stop/pip — fail fast
     cfg = _try_load_cfg(args)
+    if applied and cfg is not None:
+        api.emit_config_migrated(
+            cfg.runtime.log_dir, applied=applied, manual=[], path=str(cfg_path)
+        )
     return _run_upgrade(
         cfg,
         target=args.target,
@@ -61,12 +79,47 @@ def cmd(args) -> int:
     )
 
 
+def _migrate_config_file(cfg_path: Path, *, no_migrate: bool) -> tuple[list[str], list[str]]:
+    """Auto-migrate the raw config BEFORE load_config (which rejects old keys).
+
+    Only mutates when the migration is COMPLETE. If any transform needs a manual
+    fix, the caller aborts the upgrade — so we write NOTHING (no `.bak`, no
+    rewrite) and return ``([], manual)`` report-only, leaving the file untouched
+    for the user to run `agent-runner migrate` and re-upgrade. Only when there is
+    no manual remainder do we write the `.bak` + rewrite and return the applied
+    changes."""
+    if no_migrate or not cfg_path.exists():
+        return [], []
+    text = cfg_path.read_text(encoding="utf-8")
+    try:
+        parsed = tomllib.loads(text)
+    except tomllib.TOMLDecodeError:
+        return [], []  # broken TOML — let the normal load path report it
+    result = migrations.run_migrations(text, parsed)
+    if result.manual:
+        return [], result.manual  # doomed upgrade → don't mutate the config
+    if result.applied:
+        cfg_path.with_suffix(cfg_path.suffix + ".bak").write_text(text, encoding="utf-8")
+        cfg_path.write_text(result.new_text, encoding="utf-8")
+        return result.applied, []
+    return [], []
+
+
 def _try_load_cfg(args) -> Config | None:
-    """Load the project config if present; None when absent (package-only)."""
+    """Load the project config if present; None when absent (package-only).
+
+    Also degrades to None on a ConfigError (a still-un-migratable legacy config)
+    or a broken-TOML file: the package-only path is a safe fallback, and crashing
+    `upgrade` with a traceback over a removed key or a syntax error would be worse
+    than upgrading without a restart.
+    """
     try:
         return cfg_from_args(args)
     except FileNotFoundError:
         return None
+    except (ConfigError, tomllib.TOMLDecodeError):
+        info("config did not load; proceeding with a package-only upgrade (no restart)")
+        return None
 
 
 def _pip_env_flags() -> list[str]:

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/agent_runner/config.py

@@ -444,14 +444,14 @@ def load_config(toml_path: Path) -> Config:
     if "round_timeout_per_phase" in runtime_d:
         raise ConfigError(
             "runtime.round_timeout_per_phase removed in 0.1.16; "
-            "use [phases.<name>] round_timeout_s = X — see docs/migrations/0.1.16.md"
+            "use [phases.<name>] round_timeout_s = X. Run `agent-runner migrate`."
         )
 
     if runtime_d.get("rate_limit_action") is not None:
         raise ConfigError(
             "runtime.rate_limit_action was removed in 0.1.29; use "
             "runtime.transient_error_action (same allowed values: "
-            "back_off / skip / stop). See docs/migrations/0.1.29.md."
+            "back_off / skip / stop). Run `agent-runner migrate`."
         )
 
     transient_error_action_raw = runtime_d.get("transient_error_action")
@@ -544,8 +544,7 @@ def load_config(toml_path: Path) -> Config:
     vcs_d = raw.get("vcs", {})
     if "orphan_action" in vcs_d:
         raise ConfigError(
-            "vcs.orphan_action removed in 0.1.18; use vcs.dirty_action — "
-            "see docs/migrations/0.1.17.md"
+            "vcs.orphan_action removed in 0.1.18; use vcs.dirty_action. Run `agent-runner migrate`."
         )
     dirty_action = str(vcs_d.get("dirty_action", "stash"))
     if dirty_action not in _VALID_DIRTY_ACTIONS:

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/agent_runner/events.py

@@ -34,6 +34,7 @@ AGENT_NETWORK_BLIP = "agent_network_blip"
 AGENT_SPAWN = "agent_spawn"
 AGENT_USAGE_RECORDED = "agent_usage_recorded"
 CONFIG_BROKEN = "config_broken"
+CONFIG_MIGRATED = "config_migrated"
 CRASH_LOOP = "crash_loop"
 DIRTY_AUTO_COMMITTED = "dirty_auto_committed"
 DIRTY_COMMIT_FAILED = "dirty_commit_failed"

cli_agent_runner-0.2.8/agent_runner/migrations.py

@@ -0,0 +1,89 @@
+"""Executable config migrations. A registry of transforms; each detects a
+removed/renamed key in the parsed TOML and either renames it on the raw file
+text (auto) or reports a manual instruction. Rewriting is targeted regex on the
+raw text so comments and formatting are preserved — no TOML writer dependency."""
+
+from __future__ import annotations
+
+import re
+import tomllib
+from collections.abc import Callable
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class Migration:
+    detect: Callable[[dict], bool]  # old key present in the parsed TOML?
+    apply: Callable[[str], str] | None  # raw-text rewrite; None = manual-only
+    describe: str  # report line (auto) or instruction (manual)
+
+
+@dataclass(frozen=True)
+class MigrationResult:
+    new_text: str
+    applied: list[str]
+    manual: list[str]
+
+
+def _rename_key(old: str, new: str) -> Callable[[str], str]:
+    """Rename a bare TOML assignment `old = ...` to `new = ...`, preserving indent,
+    spacing, value, and inline comment. Anchored to line-start assignments, so a
+    commented-out `# old = ...` or `old` inside a value/string is never matched."""
+    pat = re.compile(rf"(?m)^(?P<indent>[ \t]*){re.escape(old)}(?P<sp>[ \t]*=)")
+    return lambda text: pat.sub(rf"\g<indent>{new}\g<sp>", text)
+
+
+MIGRATIONS: list[Migration] = [
+    Migration(
+        detect=lambda p: "rate_limit_action" in p.get("runtime", {}),
+        apply=_rename_key("rate_limit_action", "transient_error_action"),
+        describe="runtime.rate_limit_action → runtime.transient_error_action",
+    ),
+    Migration(
+        detect=lambda p: "orphan_action" in p.get("vcs", {}),
+        apply=_rename_key("orphan_action", "dirty_action"),
+        describe="vcs.orphan_action → vcs.dirty_action",
+    ),
+    Migration(
+        detect=lambda p: "round_timeout_per_phase" in p.get("runtime", {}),
+        apply=None,
+        describe=(
+            "runtime.round_timeout_per_phase (removed 0.1.16) must be moved "
+            "manually to [phases.<name>] round_timeout_s"
+        ),
+    ),
+]
+
+
+def run_migrations(text: str, parsed: dict) -> MigrationResult:
+    new_text = text
+    applied: list[str] = []
+    manual: list[str] = []
+    for m in MIGRATIONS:
+        if not m.detect(parsed):
+            continue
+        if m.apply is None:
+            manual.append(m.describe)
+            continue
+        rewritten = m.apply(new_text)
+        if rewritten == new_text:
+            # Detected but the line-anchored rename matched nothing (e.g. a
+            # dotted-key `runtime.rate_limit_action = ...` at top level) —
+            # route to manual so we never report "applied" on an unchanged file.
+            manual.append(m.describe)
+            continue
+        try:
+            tomllib.loads(rewritten)
+        except tomllib.TOMLDecodeError:
+            # The rename would collide with a target key that is already present
+            # (e.g. both `orphan_action` and `dirty_action` set), producing a
+            # duplicate assignment — invalid TOML. Never adopt it; hand the user
+            # a manual instruction instead so `migrate`/`upgrade` don't corrupt
+            # the file and then traceback on the next load.
+            manual.append(
+                m.describe + " (target key already present — remove the deprecated key manually)"
+            )
+            continue
+        new_text = rewritten
+        applied.append(m.describe)
+    return MigrationResult(new_text=new_text, applied=applied, manual=manual)

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/agent_runner/presets/codewhale.toml

@@ -11,6 +11,7 @@
 command = ["codewhale", "exec", "--auto", "--output-format", "stream-json"]
 prompt_arg_template = ["{prompt}"]
 name = "codewhale"
+# [agent.env] omitted — DeepSeek key is ambient (env or codewhale keyring).
 
 [runtime]
 work_dir = "."

{cli_agent_runner-0.2.7 → cli_agent_runner-0.2.8}/docs/architecture.md

@@ -199,6 +199,7 @@ See `docs/plugins.md` for the `DirtyHandler` protocol and override recipe.
 - `agent_usage_recorded`
 - `anomaly_repetitive_tool`
 - `config_broken`
+- `config_migrated`
 - `crash_loop`
 - `dirty_auto_committed`
 - `dirty_commit_failed`