From 57830cf00aff777981075e675b613e206669d9a5 Mon Sep 17 00:00:00 2001
From: Godopu <godopu16@gmail.com>
Date: Thu, 15 Oct 2026 16:00:40 +0000
Subject: [PATCH] docs(stop): the workflow and the state diagram say a purge
 removes the row (Issue #31)

SKILL.md lines 52 and 83 still said a purge leaves a `terminated` row. The
two blocks' inventory shas move with them (#42), and so does the
passthrough line of stop's heredoc SystemExit(1) (310 -> 327, after the
process gate). Line counts are unchanged, so no other block moves.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .agents/skills/multi-agent-mux-stop/SKILL.md | 4 ++--
 tests/data/skill_code_blocks.json            | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.agents/skills/multi-agent-mux-stop/SKILL.md b/.agents/skills/multi-agent-mux-stop/SKILL.md
index af99b00..0580685 100644
--- a/.agents/skills/multi-agent-mux-stop/SKILL.md
+++ b/.agents/skills/multi-agent-mux-stop/SKILL.md
@@ -49,7 +49,7 @@ bash .agents/skills/multi-agent-mux-stop/scripts/stop_session.sh \
   --session "$SESSION_NAME" --agent "$AGENT" --reason api_error
 
 # 3. Stop gracefully + clean up on-disk conversation (DANGEROUS)
-#    — this prevents any future resume (status=terminated, resumable=false).
+#    — this prevents any future resume and removes the session's registry row (YAML+DB).
 bash .agents/skills/multi-agent-mux-stop/scripts/stop_session.sh \
   --session "$SESSION_NAME" --agent "$AGENT" --purge-conversation --yes
 ```
@@ -80,7 +80,7 @@ while its registry row survives.
 
 ```
 running ──(stop default / --reason)────────► stopped      (resumable:true, conv preserved)
-running ──(stop --purge-conversation --yes)► terminated   (resumable:false, conv deleted)
+running ──(stop --purge-conversation --yes)► row removed  (YAML+DB; conv deleted)
 stopped ──(stop default … again)───────────► stopped      (idempotent no-op)
 ```
 
diff --git a/tests/data/skill_code_blocks.json b/tests/data/skill_code_blocks.json
index c07ca2e..438f418 100644
--- a/tests/data/skill_code_blocks.json
+++ b/tests/data/skill_code_blocks.json
@@ -413,7 +413,7 @@
    "start": 42,
    "end": 55,
    "lang": "bash",
-   "sha": "27ebf150b92a",
+   "sha": "301c347ff881",
    "class": "c",
    "kind": "invocation",
    "evidence": [
@@ -429,7 +429,7 @@
    "start": 81,
    "end": 85,
    "lang": "-",
-   "sha": "a2b56ac238ae",
+   "sha": "a973676cb2d1",
    "class": "c",
    "kind": "diagram",
    "evidence": [
@@ -599,7 +599,7 @@
     "other"
    ],
    "passthrough": {
-    "1": "multi-agent-mux-stop/scripts/stop_session.sh:310"
+    "1": "multi-agent-mux-stop/scripts/stop_session.sh:327"
    }
   },
   "multi-agent-mux-create/scripts/create_session.sh": {