#!/usr/bin/env bash
# ==============================================================================
# 用途：SessionEnd hook 主程式。工作階段結束時**盡力**釋放角色單一載入鎖，讓使用者
#       關掉 CLI 後可以立刻在新階段叫回同一個角色，不必等閒置逾時自然過期。
# 更新時間：2026/07/29 12:55:00
# 相依：bash、node（解析 hook 輸入）、同目錄的 role_lib.sh。
# 退出碼：一律 0 —— hook 絕不可阻斷 CLI 結束。
#
# 為什麼這只是「快速路徑」而非唯一解法：SessionEnd 不保證觸發（kill -9、直接關掉終端機
# 視窗、WSL 關機、當機都不會跑），因此 role_instance_acquire 的 mtime 閒置逾時接手仍是
# 最終保障，兩者缺一不可 —— 只留 SessionEnd 會在異常結束時把角色鎖死到下次手動解鎖。
#
# 為什麼一定要比對 transcript 才釋放：被鎖擋下的第二個工作階段也會觸發 SessionEnd，
# 若無條件刪鎖，它關閉時就會把「仍在使用中」的第一個階段的鎖一起刪掉，等於讓整個
# 單一實例限制形同虛設。只有鎖確實登記在自己名下時才釋放。
# ==============================================================================

ROLE_STAGE="role-unload"
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# shellcheck source=./role_lib.sh
. "${SCRIPT_DIR}/role_lib.sh"

role_is_child && exit 0
role_enabled || exit 0
role_single_instance_enabled || exit 0
# sub agent 等非對話情境本來就不寫鎖，也就沒有鎖要釋放
role_skip_instance_lock && exit 0
command -v node >/dev/null 2>&1 || role_quit "找不到 node，略過角色鎖釋放" "WRN"

ROLE="$(role_resolve_name)"
[ -n "$ROLE" ] || role_quit "未指定角色，略過角色鎖釋放"

# ------------------------------------------------------------------------------
# 讀取 hook 輸入（transcript_path／reason）
# ------------------------------------------------------------------------------
HOOK_INPUT="$(cat 2>/dev/null)"
[ -n "$HOOK_INPUT" ] || role_quit "hook 輸入為空，略過角色鎖釋放"

HOOK_FIELDS="$(printf '%s' "$HOOK_INPUT" | node -e '
let raw = "";
process.stdin.setEncoding("utf8");
process.stdin.on("data", (chunk) => { raw += chunk; });
process.stdin.on("end", () => {
  let data = {};
  try { data = JSON.parse(raw); } catch {}
  process.stdout.write([
    data.transcript_path || data.session_path || data.conversation_path || data.path || "",
    data.reason || "",
  ].join("\n"));
});
' 2>/dev/null)"
HOOK_TRANSCRIPT="$(printf '%s' "$HOOK_FIELDS" | sed -n '1p')"
HOOK_REASON="$(printf '%s' "$HOOK_FIELDS" | sed -n '2p')"

# 無法識別工作階段就不動鎖：寧可讓它照原本的閒置逾時過期，也不要誤刪別人的鎖
[ -n "$HOOK_TRANSCRIPT" ] || role_quit "hook 未提供 transcript 路徑，略過角色鎖釋放"

LOCK_FILE="$(role_instance_lock_path "$ROLE")"
[ -f "$LOCK_FILE" ] || role_quit "角色 ${ROLE} 目前無鎖，無須釋放"

HOLDER="$(role_instance_lock_field "$LOCK_FILE" transcript)"
if [ "$HOLDER" != "$HOOK_TRANSCRIPT" ]; then
  role_quit "角色鎖屬於其他工作階段，不釋放（持有者 ${HOLDER:-未知}）"
fi

role_instance_release "$ROLE"
role_log "INF" "工作階段結束（原因 ${HOOK_REASON:-未提供}），已釋放角色鎖：${ROLE}"
exit 0