From 9410913da924c877e644461359e22df93a22c143 Mon Sep 17 00:00:00 2001 From: Godopu Date: Sun, 25 Oct 2026 17:35:58 +0000 Subject: [PATCH] docs(stop): exit 1 also covers a row that could not be read (Issue #71) Refs #71 Co-Authored-By: Claude Opus 5.5 --- .agents/skills/multi-agent-mux-stop/SKILL.md | 2 +- .agents/skills/multi-agent-mux-stop/scripts/stop_session.sh | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.agents/skills/multi-agent-mux-stop/SKILL.md b/.agents/skills/multi-agent-mux-stop/SKILL.md index fb383e6..2d0c1a3 100644 --- a/.agents/skills/multi-agent-mux-stop/SKILL.md +++ b/.agents/skills/multi-agent-mux-stop/SKILL.md @@ -58,7 +58,7 @@ bash .agents/skills/multi-agent-mux-stop/scripts/stop_session.sh \ | Exit | Meaning | |---|---| | 0 | Stopped; or already `stopped` (no-op, except with `--purge-conversation`, which still purges) | -| 1 | From the checks before the stop, nothing was changed: YAML not found, or the session is neither registered nor on the herdr server. **The registry update after the stop also exits 1** (the row disappeared from the YAML during the run) | +| 1 | From the checks before the stop, nothing was changed: YAML not found, its row could not be read, or the session is neither registered nor on the herdr server. **The registry update after the stop also exits 1** (the row disappeared from the YAML during the run) | | 2 | Bad arguments (including the retired `--mode` / `--capture-id` / `--graceful`), or `--agent` omitted and not resolvable | | 3 | `--purge-conversation` without `--yes` | | 4 | Purge aborted: the herdr session, or an agent process still holding the conversation, survived the kill chain. Records preserved: the registry row and the conversation files are untouched, though the session itself may already be down | diff --git a/.agents/skills/multi-agent-mux-stop/scripts/stop_session.sh b/.agents/skills/multi-agent-mux-stop/scripts/stop_session.sh index 0bff957..c5ac9bd 100755 --- a/.agents/skills/multi-agent-mux-stop/scripts/stop_session.sh +++ b/.agents/skills/multi-agent-mux-stop/scripts/stop_session.sh @@ -29,7 +29,7 @@ # # Exit codes: # 0 = success (or already-stopped no-op; or a session with no row closed) -# 1 = YAML not found / not registered and not on the herdr server +# 1 = YAML not found / its row unreadable / not registered and not on the herdr server # 2 = invalid args | 3 = interactive confirmation required (--yes 누락) # 4 = purge aborted (herdr session or an agent process holding the conversation survived the kill chain) # 5 = no row, and herdr runs the session outside this workspace (refused, nothing changed)