docs(stop): exit 1 also covers a row that could not be read (Issue #71)
Refs #71 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
bd61ef532f
commit
9410913da9
2 files changed
+2
-2
No files matched your search
@@ -58,7 +58,7 @@ bash .agents/skills/multi-agent-mux-stop/scripts/stop_session.sh \
|
|||||||
| Exit | Meaning |
|
| Exit | Meaning |
|
||||||
|---|---|
|
|---|---|
|
||||||
| 0 | Stopped; or already `stopped` (no-op, except with `--purge-conversation`, which still purges) |
|
| 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 |
|
| 2 | Bad arguments (including the retired `--mode` / `--capture-id` / `--graceful`), or `--agent` omitted and not resolvable |
|
||||||
| 3 | `--purge-conversation` without `--yes` |
|
| 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 |
|
| 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 |
|
||||||
|
|||||||
@@ -29,7 +29,7 @@
|
|||||||
#
|
#
|
||||||
# Exit codes:
|
# Exit codes:
|
||||||
# 0 = success (or already-stopped no-op; or a session with no row closed)
|
# 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 누락)
|
# 2 = invalid args | 3 = interactive confirmation required (--yes 누락)
|
||||||
# 4 = purge aborted (herdr session or an agent process holding the conversation survived the kill chain)
|
# 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)
|
# 5 = no row, and herdr runs the session outside this workspace (refused, nothing changed)
|
||||||
|
|||||||
Reference in new issue
Block a user