/reap-orphans

description: "扫描并清理本地过期的 PUA agent/state。"
allowed-tools: ["Bash(find:*)", "Bash(stat:*)", "Bash(rm:*)", "Bash(ls:*)", "Bash(date:*)", "Bash(mkdir:*)"]

PUA Reap Orphans — 孤儿回收

Keeper Test 的工程版：打完就退场，拖着不走的一律清理。

执行步骤

1. 确保目录存在：

   mkdir -p "$HOME/.claude/pua"

2. 扫描 30 分钟未更新的 loop state（orphan 判定线）：

   find "$HOME/.claude/pua/" -name "loop-*.md" -type f -mmin +30 2>/dev/null

3. 同步扫 legacy 相对路径：

   find .claude/ -maxdepth 1 -name "pua-loop.local.md" -type f -mmin +30 2>/dev/null

4. 对每个匹配文件：

• 读 session_id 和 iteration（若可解析）
• 记录到 `$HOME/.claude/pua/teardown.jsonl`：

     echo "{\"reaped\":\"<file>\",\"age_min\":<N>,\"ts\":\"$(date -u +%FT%TZ)\",\"reason\":\"orphan_reap\"}" \
       >> "$HOME/.claude/pua/teardown.jsonl"

• 删除 state 文件：

     rm -f "<file>"

5. 若存在 `active-agents.json`，清理 spawn_time > 30min 的记录（需 jq）：

   test -f "$HOME/.claude/pua/active-agents.json" && \
     jq '.agents |= map(select(.spawn_time > (now - 1800)))' \
       "$HOME/.claude/pua/active-agents.json" > "$HOME/.claude/pua/active-agents.json.tmp" && \
     mv "$HOME/.claude/pua/active-agents.json.tmp" "$HOME/.claude/pua/active-agents.json"

6. 输出结果：

   > [PUA REAP] 清理了 N 个孤儿状态：
   >   - loop-abc123.md (age 1h42m)
   >   - .claude/pua-loop.local.md (age 3h05m)
   > 全部已落盘到 ~/.claude/pua/teardown.jsonl 备查。

7. 若无孤儿：

> [PUA REAP] 没发现孤儿。球队纪律良好。

幂等性

• 重复执行无害：`rm -f` 对不存在文件不报错
• teardown.jsonl 追加而非覆盖，保留完整历史

安全保护

• 仅清理 `$HOME/.claude/pua/` 和 `.claude/pua-loop.local.md`，不越权
• 年龄阈值硬编码 30min，不接受用户参数（防误杀活跃 loop）