monster-orchestrator 3.2.4 → 3.2.6

package/scripts/monster-stop-hook

@@ -0,0 +1,178 @@
+#!/usr/bin/env bash
+# monster-stop-hook <monster_id> [event]
+#
+# Claude Code の Stop / Notification hook 共通本体。
+# monster のターン終了時（Stop→idle）や承認プロンプト発生時（Notification→awaiting_input）に発火し、
+# ~/.claude/monsters/events.log に NDJSON で 1 行 append する。
+#
+# 契約:
+#   - 第 1 引数: monster_id（省略時は "unknown"）
+#   - 第 2 引数: event 種別（省略時は "idle"。B2 の呼び出しとの後方互換）
+#                 使用値: idle / awaiting_input / spawned / stopped / error
+#                         / user_prompt / session_end / subagent_stop / spawn_timeout
+#   - stdin:    Claude Code 提供の JSON。
+#               awaiting_input では message を、session_end では reason を読む。
+#               それ以外の event では読まない（保存だけして捨てる）。
+#   - exit:     常に 0（失敗でも monster を止めない）
+#
+# 注: user_prompt / session_end / subagent_stop は awaiting_input 以外なので
+#     subtype 分類は行わず、event 名のみを events.log に記録する。
+
+set +e
+
+ID="${1:-unknown}"
+EVENT="${2:-idle}"
+# 板 #442 ③: monsters ルートの解決は **全経路で同一の式**にする。
+#   server 側（src/paths.ts）は MONSTER_MCP_ROOT を honour しており、hook だけ $HOME 直書きだと
+#   非既定 root で動かしたときに **server と hook が別の台帳を見る**（=イベントが迷子になる）。
+#   ⚠️ 共有ファイルを source する形は採らない——この種のスクリプトは ~/.claude/hooks/ 等へ
+#      **単体でコピーして使う**運用があり、兄弟ファイルへの依存はコピー時に壊れる。
+#      代わりに式を 1 行に畳み、tests が全経路の同一性を強制する。
+#   MONSTER_ROOT は後方互換の別名（monster-deathcheck が従来これを見ていた）。
+ROOT="${MONSTER_MCP_ROOT:-${MONSTER_ROOT:-$HOME/.claude/monsters}}"
+EVENTS="$ROOT/events.log"
+STATE="$ROOT/state.json"
+TS="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+
+# stdin を一旦 tmpfile に保存（後で JSON パースに使用、空でも問題なし）
+STDIN_TMP="$(mktemp -t monster-hook.XXXXXX)"
+cat > "$STDIN_TMP" 2>/dev/null
+trap 'rm -f "$STDIN_TMP"' EXIT
+
+# events.log ディレクトリを保証
+mkdir -p "$ROOT" 2>/dev/null
+
+# state.json から tmux session 名を取得（無ければ空）
+SESSION=""
+if [ -f "$STATE" ]; then
+  SESSION=$(python3 - "$STATE" "$ID" <<'PY' 2>/dev/null
+import json, sys
+try:
+    s = json.load(open(sys.argv[1]))
+    m = s.get('monsters', {}).get(sys.argv[2], {})
+    print(m.get('tmux_session', ''))
+except Exception:
+    print('')
+PY
+)
+fi
+
+# tmux 最新 tail を meta.tail に（最大 200 文字、JSON-safe）
+TAIL=""
+if [ -n "$SESSION" ]; then
+  TAIL=$(tmux capture-pane -t "$SESSION" -p -S -10 2>/dev/null \
+    | tail -3 \
+    | tr '\n' ' ' \
+    | tr -d '\r' \
+    | python3 -c 'import sys,json; s=sys.stdin.read()[:200]; sys.stdout.write(json.dumps(s)[1:-1])' 2>/dev/null)
+fi
+
+# Notification hook の場合、stdin JSON から message を抽出して subtype 分類。
+# Stop hook 等の場合は subtype="" のまま。
+# subtype enum:
+#   approval       - 承認プロンプト（"permission" を含む）
+#   waiting        - ユーザ入力待ち（"waiting"/"input" を含む）
+#   tool_error     - ツールエラー（"error"/"failed" を含む）
+#   idle_warning   - アイドル警告（"idle" を含む）
+#   other          - 上記以外（message はあるが分類外）
+SUBTYPE=""
+MESSAGE_JSON='""'
+if [ "$EVENT" = "awaiting_input" ] && [ -s "$STDIN_TMP" ]; then
+  PARSED=$(python3 - "$STDIN_TMP" <<'PY' 2>/dev/null
+import json, sys
+try:
+    raw = open(sys.argv[1]).read()
+    d = json.loads(raw) if raw.strip() else {}
+except Exception:
+    d = {}
+msg = (d.get('message') or '').strip()
+low = msg.lower()
+if not msg:
+    sub = ''
+elif 'permission' in low or 'approve' in low or 'allow' in low:
+    sub = 'approval'
+elif 'waiting' in low or 'input' in low:
+    sub = 'waiting'
+elif 'error' in low or 'failed' in low:
+    sub = 'tool_error'
+elif 'idle' in low:
+    sub = 'idle_warning'
+else:
+    sub = 'other'
+# 200 文字キャップ
+msg = msg[:200]
+print(sub)
+print(json.dumps(msg))
+PY
+)
+  SUBTYPE=$(printf '%s' "$PARSED" | sed -n '1p')
+  MSG_LINE=$(printf '%s' "$PARSED" | sed -n '2p')
+  if [ -n "$MSG_LINE" ]; then
+    MESSAGE_JSON="$MSG_LINE"
+  fi
+fi
+
+# SessionEnd hook は stdin の JSON に reason を載せてくる
+# （clear / logout / prompt_input_exit / other 等）。
+# これが「正常に終わったのか、途中で落ちたのか」の唯一の一次情報だが、従来は読み捨てていた。
+# ⇒ 検出機構を新設する必要はない。既に配達されている信号を読むだけでよい。
+#    stopped の latest_event が正常完了も異常死も一律 session_end になっていた原因がこれ。
+REASON=""
+if [ "$EVENT" = "session_end" ] && [ -s "$STDIN_TMP" ]; then
+  REASON=$(python3 - "$STDIN_TMP" <<'REASONPY' 2>/dev/null
+import json, sys
+try:
+    raw = open(sys.argv[1]).read()
+    d = json.loads(raw) if raw.strip() else {}
+except Exception:
+    d = {}
+r = d.get('reason')
+# 想定外の型・長大な値を events.log に流し込まない
+print(r[:64] if isinstance(r, str) else '')
+REASONPY
+)
+fi
+
+# UserPromptSubmit hook は stdin の JSON に prompt（submit された本文そのもの）を載せてくる。
+# その指紋（sha256 の先頭 16 桁）を meta に置くと、送り手が「自分が送った本文が着弾したか」を
+# **送信単位で**照合できる（BACKLOG #175）。件数の増加だけでは、同じ席へ同時に来た
+# 別の送信と取り違えうるため。
+#
+# 🔑 本文そのものは載せない。指紋だけで照合は足りるうえ、events.log は全レーンが読む共有ログで、
+#    指示本文を撒くと機密がそこへ流れる。
+# 🔑 指紋の対象は **Claude が受け取った本文そのもの**。送り手側は同じ正規化
+#    （tmux.ts の sanitizeSendText）を通した文字列を対象にすること（二重情報源を作らない）。
+# ⚠️ python3 が無い / prompt が無い環境では空になり、meta にキーが増えないだけ。
+#    送り手側は従来どおり件数差へ安全に縮退する（fail-safe）。
+PROMPT_SHA=""
+if [ "$EVENT" = "user_prompt" ] && [ -s "$STDIN_TMP" ]; then
+  PROMPT_SHA=$(python3 - "$STDIN_TMP" <<'SHAPY' 2>/dev/null
+import json, sys, hashlib
+try:
+    raw = open(sys.argv[1]).read()
+    d = json.loads(raw) if raw.strip() else {}
+except Exception:
+    d = {}
+p = d.get('prompt')
+print(hashlib.sha256(p.encode('utf-8')).hexdigest()[:16] if isinstance(p, str) else '')
+SHAPY
+)
+fi
+
+# NDJSON 行構築して append（O_APPEND で atomic）
+# meta に subtype / message を含める（Notification 時のみ意味を持つ）
+if [ -n "$REASON" ]; then
+  printf '{"ts":"%s","monster_id":"%s","event":"%s","session":"%s","meta":{"tail":"%s","reason":"%s"}}\n' \
+    "$TS" "$ID" "$EVENT" "$SESSION" "$TAIL" "$REASON" >> "$EVENTS" 2>/dev/null
+elif [ -n "$SUBTYPE" ]; then
+  printf '{"ts":"%s","monster_id":"%s","event":"%s","session":"%s","meta":{"tail":"%s","subtype":"%s","message":%s}}\n' \
+    "$TS" "$ID" "$EVENT" "$SESSION" "$TAIL" "$SUBTYPE" "$MESSAGE_JSON" >> "$EVENTS" 2>/dev/null
+elif [ -n "$PROMPT_SHA" ]; then
+  printf '{"ts":"%s","monster_id":"%s","event":"%s","session":"%s","meta":{"tail":"%s","prompt_sha256":"%s"}}\n' \
+    "$TS" "$ID" "$EVENT" "$SESSION" "$TAIL" "$PROMPT_SHA" >> "$EVENTS" 2>/dev/null
+else
+  printf '{"ts":"%s","monster_id":"%s","event":"%s","session":"%s","meta":{"tail":"%s"}}\n' \
+    "$TS" "$ID" "$EVENT" "$SESSION" "$TAIL" >> "$EVENTS" 2>/dev/null
+fi
+
+exit 0

package/scripts/supervisor-notify-tick.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# supervisor-notify の 1 tick を回す薄いラッパ（launchd の ProgramArguments から呼ばれる）。
+#
+# 出典: docs/requirements-supervisor-notify.md §3.6（watcher は本パッケージの scripts/ に同梱）
+# 設置手順: docs/supervisor-notify-launchd.md
+#
+# launchd は PATH を /usr/bin:/bin:/usr/sbin:/sbin しか持たないので node を自力で探す。
+# Homebrew の node（/opt/homebrew/bin/node）が本機の実体。MONSTER_NODE_BIN で上書き可。
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+resolve_node() {
+  if [ -n "${MONSTER_NODE_BIN:-}" ]; then
+    printf '%s\n' "$MONSTER_NODE_BIN"
+    return
+  fi
+  for candidate in /opt/homebrew/bin/node /usr/local/bin/node; do
+    [ -x "$candidate" ] && printf '%s\n' "$candidate" && return
+  done
+  command -v node
+}
+
+NODE_BIN="$(resolve_node)"
+if [ ! -x "$NODE_BIN" ]; then
+  echo "supervisor-notify: node が見つかりません（MONSTER_NODE_BIN で指定してください）" >&2
+  exit 1
+fi
+
+# 配布物（dist-obf）を優先し、開発中の tsc 出力（dist）にフォールバックする
+for entry in "$ROOT/dist-obf/supervisor-notify-tick.js" "$ROOT/dist/supervisor-notify-tick.js"; do
+  if [ -f "$entry" ]; then
+    exec "$NODE_BIN" "$entry"
+  fi
+done
+
+echo "supervisor-notify: tick 本体が見つかりません（npm run build または npm run build:obfuscated を実行してください）" >&2
+exit 1