cli-agent-runner 0.1.34__tar.gz → 0.1.35__tar.gz

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.35] - 2026-05-20
+
+### Removed
+- `claude_rate_limit_detector` plugin alias (0.1.20-era back-compat layer after the 0.1.23 rename to `claude_error_detector`). Hard-cut at both entry-point and config-mapping layers. See `docs/migrations/0.1.35.md` for the 1-line TOML migration.
+
 ## [0.1.34] - 2026-05-20
 
 ### Added

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cli-agent-runner
-Version: 0.1.34
+Version: 0.1.35
 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
@@ -80,7 +80,7 @@ agent-runner monitor              # live anomaly detection
 
 Full walkthrough: [`docs/quickstart.md`](docs/quickstart.md).
 
-## 14 verbs
+## 16 verbs
 
 | Lifecycle | Observation |
 |---|---|

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/README.md

@@ -43,7 +43,7 @@ agent-runner monitor              # live anomaly detection
 
 Full walkthrough: [`docs/quickstart.md`](docs/quickstart.md).
 
-## 14 verbs
+## 16 verbs
 
 | Lifecycle | Observation |
 |---|---|

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/README.zh.md

@@ -20,9 +20,9 @@ supervisor 重启 —— 这是核心模式。中间穿插 11 条防御，避开
 
 ```
 ┌──────────────────────────────────────────┐
-│ Layer 3：Witness（monitor）              │  9 个检测器 + 自动停服
+│ Layer 3：Witness（monitor）              │  11 个检测器 + 自动停服
 ├──────────────────────────────────────────┤
-│ Layer 2：Loop（serve，~60 LOC 薄壳）     │  捕获信号，循环拉起 round
+│ Layer 2：Loop（serve，~120 LOC 薄壳）    │  捕获信号，循环拉起 round
 ├──────────────────────────────────────────┤
 │ Layer 1：Round（round）                  │  跑一次 agent，跑完即退
 └──────────────────────────────────────────┘
@@ -57,14 +57,14 @@ agent-runner monitor              # 实时异常检测，OAuth/磁盘 critical
 
 完整上手流程：[`docs/quickstart.md`](docs/quickstart.md)。
 
-## 13 个动词
+## 16 个动词
 
 | 生命周期 | 观察 |
 |---|---|
 | `init` / `install` / `uninstall` | `peek` —— 项目状态快照 |
 | `start` / `stop` / `kill` / `cancel` | `watch` —— peek 在刷新循环里 |
-| `restart` / `status` | `monitor` —— 9 个检测器 + 告警 + 自动停服 |
-| `round` / `serve` | |
+| `restart` / `status` | `monitor` —— 11 个检测器 + 告警 + 自动停服 |
+| `round` / `serve` / `upgrade` | `events` —— 查询 / 流式订阅 events.jsonl |
 
 **停服三动词**有清晰的语义分层：
 - `stop` —— 优雅，等当前 round 跑完再退（最常用）

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/agent_runner/__init__.py

@@ -20,11 +20,6 @@ _HOOK_GROUPS = (
 # Surfaced via peek --json `plugins.disabled` for operator visibility.
 _DISABLED_PLUGIN_NAMES: list[str] = []
 
-# Plugin name aliases for back-compat: old entry-point name -> canonical name.
-_PLUGIN_NAME_ALIASES: dict[str, str] = {
-    "claude_rate_limit_detector": "claude_error_detector",  # 0.1.20 -> 0.1.23 rename
-}
-
 
 def _load_plugins_from_group(group: str) -> None:
     """Discover and load entry_points in ``group``, isolating per-plugin failures.
@@ -98,9 +93,6 @@ def apply_plugin_disable(names: list[str]) -> None:
     if not names:
         return
 
-    # Translate aliases so old config names keep working
-    names = [_PLUGIN_NAME_ALIASES.get(n, n) for n in names]
-
     global _DISABLED_PLUGIN_NAMES
     _DISABLED_PLUGIN_NAMES = list(names)
 

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/agent_runner/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.34'
-__version_tuple__ = version_tuple = (0, 1, 34)
+__version__ = version = '0.1.35'
+__version_tuple__ = version_tuple = (0, 1, 35)
 
 __commit_id__ = commit_id = None

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/agent_runner/builtin_plugins/claude_rate_limit.py

@@ -7,10 +7,9 @@ with computed reset_at_epoch. Supervisor consumes the event.
 Also emits agent_usage_recorded per-round with token/cost data from the
 claude result event (0.1.24+).
 
-Naming history: was `claude_rate_limit_detector` in 0.1.20 (single-purpose
-rate-limit detector). Renamed + generalized to multi-classification in 0.1.23.
-Old plugin name `claude_rate_limit_detector` retained as entry-point alias
-via pyproject.toml.
+Module name is historical: the original 0.1.20 single-purpose
+rate-limit detector was generalized to multi-classification in 0.1.23
+(class + entry-point renamed to `claude_error_detector`; module path kept).
 """
 
 from __future__ import annotations

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/docs/commands.md

@@ -133,7 +133,7 @@ agent-runner monitor --json | jq -c        # pipe alerts to a downstream consume
 
 ## 中文摘要
 
-13 个动词：`init / install / uninstall / start / stop / kill / cancel / restart / status / round / serve / peek / watch / monitor`。
+16 个动词：`init / install / uninstall / start / stop / kill / cancel / restart / status / round / serve / upgrade / peek / watch / events / monitor`。
 
 观察类（peek/watch/monitor）三视角对称，全部共用 `--round / --log / --events / --select / --json` 下钻参数。
 

cli_agent_runner-0.1.35/docs/migrations/0.1.35.md

@@ -0,0 +1,97 @@
+# 0.1.35 — `claude_rate_limit_detector` alias removed
+
+**Date**: 2026-05-20
+
+## What changed
+
+The `claude_rate_limit_detector` alias (introduced 0.1.20, kept as
+back-compat after the 0.1.23 rename to `claude_error_detector`) was
+hard-removed in 0.1.35 at **both** layers:
+
+1. **Entry-point level** (`pyproject.toml`): the old key is no longer
+   declared, so `importlib.metadata.entry_points(group=...)` no longer
+   returns it.
+2. **Config-level alias mapping** (`agent_runner/__init__.py`): the
+   `_PLUGIN_NAME_ALIASES` dict that previously auto-translated the old
+   name in `[plugins] disable/enable` was deleted. Stale TOML entries
+   now trigger the existing typo-catcher UserWarning.
+
+The underlying class (`ClaudeErrorDetector`, module
+`agent_runner.builtin_plugins.claude_rate_limit`) is unchanged; only
+the alias surface was removed.
+
+## Migration (one-line edit, only if you used the old name)
+
+Search your `agent-runner.toml` for `claude_rate_limit_detector`:
+
+```bash
+grep -nE 'claude_rate_limit_detector' agent-runner.toml \
+    && echo "switch to claude_error_detector" \
+    || echo "no migration needed"
+```
+
+If found, switch:
+
+```diff
+ [plugins]
+- disable = ["claude_rate_limit_detector"]
++ disable = ["claude_error_detector"]
+```
+
+Same for `enable = [...]` if you opted-in by name.
+
+The behavior is identical — same class, same hooks, same events emitted.
+
+## Migration (consumers of `importlib.metadata.entry_points`)
+
+If any of your code introspects the entry-point group:
+
+```python
+from importlib.metadata import entry_points
+hooks = entry_points(group="agent_runner.post_round_hooks")
+```
+
+The old key `claude_rate_limit_detector` is no longer in the result.
+Either filter against the canonical name (`claude_error_detector`) or
+iterate by `.value` (module:class target) which has been unchanged
+since 0.1.20.
+
+## Why hard-cut (no deprecation cycle)
+
+The 0.1.23 rename is 12 releases / ~6 days old (as measured by the rapid
+0.1.25-0.1.34 ship cadence). The Argus Gateway team — our only known
+production consumer — explicitly migrated away from the old name during
+their 2026-05-19/20 monitoring overhaul. Carrying an unused back-compat
+entry-point line indefinitely is debt; per project policy
+(`docs/thesis.md` — zero tech debt per release), we hard-cut.
+
+This matches the precedent set in 0.1.29 (legacy `rate_limit_*` event
+aliases removed) and 0.1.34 (`peek --select events.<kind>` selector
+removed): when consumers are migrated, the back-compat layer is debt
+that compounds.
+
+## What did NOT change
+
+- `claude_error_detector` (canonical entry-point key since 0.1.23) — unchanged
+- `gemini_error_detector` — unchanged
+- The plugin's class name (`ClaudeErrorDetector`) — unchanged
+- All events emitted by the plugin (`transient_error_detected` /
+  `agent_usage_recorded` / `anomaly_repetitive_tool`) — unchanged
+- Config schema — no new TOML keys
+- Public Python API — unchanged
+
+## Verification
+
+After upgrade:
+
+```bash
+agent-runner peek --json | jq '.plugins.post_round_hooks'
+```
+
+Expected output:
+
+```json
+["claude_error_detector", "gemini_error_detector"]
+```
+
+(Order may vary; the key thing is `claude_rate_limit_detector` is not present.)

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/docs/plugins.md

@@ -266,13 +266,16 @@ agent-runner ships two built-in `post_round_hooks` plugins registered
 automatically via their own entry-points: `claude_error_detector` (below)
 and `gemini_error_detector` (0.1.24+, parallel for gemini CLI).
 
-### `claude_error_detector` (0.1.23+, formerly `claude_rate_limit_detector`)
+### `claude_error_detector` (0.1.23+)
 
 **Entry-point group:** `agent_runner.post_round_hooks`
 **Module:** `agent_runner.builtin_plugins.claude_rate_limit`
-**Old name:** `claude_rate_limit_detector` retained as an alias in
-`pyproject.toml` so `[plugins] disable = ["claude_rate_limit_detector"]`
-still works for back-compat.
+
+Renamed from `claude_rate_limit_detector` in 0.1.23 when the detector
+was generalized from single-rate-limit to multi-classification. The
+old-name alias was kept as a `pyproject.toml` entry-point through 0.1.34
+and removed in 0.1.35. Operators still using `[plugins] disable =
+["claude_rate_limit_detector"]` must switch to `claude_error_detector`.
 
 After each round, scans the last 50 lines of the round's JSONL log for
 transient errors and usage data:

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/docs/runbook.md

@@ -45,9 +45,10 @@ correctly (process still runs as your user, not root).
 ### Health check
 
 ```bash
-agent-runner status              # service running?
-agent-runner peek                # full state snapshot
-agent-runner peek --json | jq .defenses    # what's defended
+agent-runner status                                       # service running?
+agent-runner peek                                         # full state snapshot
+agent-runner peek --json | jq .defenses                   # what's defended
+agent-runner peek --json | jq .system.agent_process_count # orphan agent count (0.1.34+)
 journalctl --user -u agent-runner@<project> --since "1 hour ago"
 ```
 

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/pyproject.toml

@@ -45,9 +45,8 @@ Changelog = "https://github.com/wan9yu/cli-agent-runner/blob/main/CHANGELOG.md"
 agent-runner = "agent_runner.cli:main"
 
 [project.entry-points."agent_runner.post_round_hooks"]
-claude_rate_limit_detector = "agent_runner.builtin_plugins.claude_rate_limit:ClaudeErrorDetector"  # 0.1.20 alias
-claude_error_detector = "agent_runner.builtin_plugins.claude_rate_limit:ClaudeErrorDetector"      # 0.1.23 canonical
-gemini_error_detector = "agent_runner.builtin_plugins.gemini:GeminiErrorDetector"                 # 0.1.24
+claude_error_detector = "agent_runner.builtin_plugins.claude_rate_limit:ClaudeErrorDetector"
+gemini_error_detector = "agent_runner.builtin_plugins.gemini:GeminiErrorDetector"
 
 [project.optional-dependencies]
 dev = [

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/tests/invariants/test_architecture.py

@@ -3,7 +3,7 @@
 - serve_cmd.py imports from a strict allowlist (no business logic)
 - cli command files call api.X (not direct module imports)
 - All api_types are frozen dataclasses
-- KNOWN_ALERT_KINDS in monitor.py matches the 10 builtin detectors
+- KNOWN_ALERT_KINDS in monitor.py matches the 11 builtin detectors
 """
 
 from __future__ import annotations

{cli_agent_runner-0.1.34 → cli_agent_runner-0.1.35}/tests/invariants/test_entry_points_resolve.py

@@ -41,17 +41,22 @@ def test_each_entry_point_resolves_to_a_live_class():
 
 
 def test_canonical_entry_point_names_match_class_name_attribute():
-    """For non-alias entries, the pyproject key must equal cls.name.
-    `claude_rate_limit_detector` is a known back-compat alias and is skipped.
-    """
+    """Every pyproject entry_point key must equal the bound class's ``name``."""
     entries = _read_post_round_hook_entries()
-    aliases = {"claude_rate_limit_detector"}  # legacy alias retained intentionally
     for name, target in entries.items():
-        if name in aliases:
-            continue
         module_path, _, attr = target.partition(":")
         cls = getattr(importlib.import_module(module_path), attr)
         instance = cls()
         assert instance.name == name, (
             f"entry_point '{name}' bound to class with name '{instance.name}' — mismatch"
         )
+
+
+def test_legacy_claude_rate_limit_detector_alias_removed():
+    """`claude_rate_limit_detector` alias (0.1.20-0.1.34) hard-removed in 0.1.35.
+    Consumers using the old name in `[plugins] disable/enable` must migrate.
+    """
+    entries = _read_post_round_hook_entries()
+    assert "claude_rate_limit_detector" not in entries, (
+        "0.1.20-era alias should be gone; see docs/migrations/0.1.35.md"
+    )