qrtt1 · April 10, 2026 08:31
diff --git a/README.md b/README.md
diff --git a/human-being-hooks.sh b/human-being-hooks.sh
 #!/usr/bin/env bash
 # human-being-hooks.sh — manage hooks for tl-dx-human-being skill
 #
 # Usage:
 #   human-being-hooks.sh log <event-type>         # called by hook, appends event
 #   human-being-hooks.sh install [settings.json]  # add hooks to settings file
 #   human-being-hooks.sh cleanup [session] [settings.json]  # remove hooks + event file
 #   human-being-hooks.sh list [session]           # show recent events
 #   human-being-hooks.sh status [session]         # last event timestamp
 #   human-being-hooks.sh send <pane> <text>       # send text to pane, auto-handle Pasted text
 #   human-being-hooks.sh send-file <pane> <file>  # send file contents to pane
 #   human-being-hooks.sh role-status [session]    # last event per role
 #   human-being-hooks.sh stale [session] [minutes]  # find roles stuck busy too long
 #   human-being-hooks.sh codex-status <pane>     # check Codex Driver state via capture-pane

 set -euo pipefail

 SCRIPT_PATH="$(cd "$(dirname "$0")" && pwd)/$(basename "$0")"
 HOOK_TAG="tl-dx-human-being"
 EVENT_DIR="/tmp"

 get_session() {
  tmux display-message -p '#S' 2>/dev/null || echo "default"
 }

 event_file() {
  local session="${1:-$(get_session)}"
  echo "${EVENT_DIR}/claude-events-${session}.jsonl"
 }

 # --- Subcommands ---

 HOOK_EVENTS=("SessionStart" "UserPromptSubmit" "Stop" "PermissionRequest" "Notification")

 cmd_log() {
  local event_type="${1:-unknown}"
  local session
  session="$(get_session)"
  local role="${ROLE:-unknown}"
  local ts
  ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
  echo "{\"event\":\"${event_type}\",\"ts\":\"${ts}\",\"session\":\"${session}\",\"role\":\"${role}\",\"skill\":\"${HOOK_TAG}\"}" \
    >> "$(event_file "$session")"
 }

 cmd_install() {
  local settings="${1:-.claude/settings.json}"

  # If already installed, remove old hooks first (plugin version may have changed)
  # Pass "skip-events" as session to avoid deleting event files during reinstall
  if [ -f "$settings" ] && grep -q "${HOOK_TAG}" "$settings" 2>/dev/null; then
    echo "Removing old hooks from ${settings} before reinstalling..."
    cmd_remove_hooks "$settings"
  fi

  if ! command -v jq &>/dev/null; then
    echo "Error: jq is required to install hooks." >&2
    exit 1
  fi

  # Start from existing settings or empty object
  local base="{}"
  if [ -f "$settings" ]; then
    base="$(cat "$settings")"
  fi

  local tmp="${settings}.tmp.$$"
  local jq_expr="."
  for evt in "${HOOK_EVENTS[@]}"; do
    local entry
    entry=$(jq -n --arg cmd "${SCRIPT_PATH} log ${evt}" '{
      "matcher": "",
      "hooks": [{"type": "command", "command": $cmd, "timeout": 5}]
    }')
    jq_expr="${jq_expr} | .hooks.${evt} = (.hooks.${evt} // []) + [\$entry_${evt}]"
  done

  # Build jq args dynamically
  local jq_args=()
  for evt in "${HOOK_EVENTS[@]}"; do
    local entry
    entry=$(jq -n --arg cmd "${SCRIPT_PATH} log ${evt}" '{
      "matcher": "",
      "hooks": [{"type": "command", "command": $cmd, "timeout": 5}]
    }')
    jq_args+=(--argjson "entry_${evt}" "$entry")
  done

  if echo "$base" | jq "${jq_args[@]}" '
    .hooks.SessionStart = (.hooks.SessionStart // []) + [$entry_SessionStart]
    | .hooks.UserPromptSubmit = (.hooks.UserPromptSubmit // []) + [$entry_UserPromptSubmit]
    | .hooks.Stop = (.hooks.Stop // []) + [$entry_Stop]
    | .hooks.PermissionRequest = (.hooks.PermissionRequest // []) + [$entry_PermissionRequest]
    | .hooks.Notification = (.hooks.Notification // []) + [$entry_Notification]
  ' > "$tmp"; then
    mv "$tmp" "$settings"
    echo "Hooks added to ${settings}: ${HOOK_EVENTS[*]}"
  else
    rm -f "$tmp"
    echo "Error: failed to install hooks into ${settings}." >&2
    exit 1
  fi
 }

 cmd_remove_hooks() {
  local settings="${1:-.claude/settings.json}"
  if [ -f "$settings" ] && grep -q "${HOOK_TAG}" "$settings" 2>/dev/null; then
    if command -v jq &>/dev/null; then
      local tmp="${settings}.tmp.$$"
      local jq_expr="."
      for evt in "${HOOK_EVENTS[@]}"; do
        jq_expr="${jq_expr} | .hooks.${evt} = [.hooks.${evt}[]? | select(.hooks[]?.command | contains(\$tag) | not)] | if .hooks.${evt} == [] then del(.hooks.${evt}) else . end"
      done
      if jq --arg tag "${HOOK_TAG}" "${jq_expr}" "$settings" > "$tmp"; then
        mv "$tmp" "$settings"
        echo "Hooks removed from ${settings}."
      else
        rm -f "$tmp"
        echo "Warning: failed to remove hooks from ${settings}." >&2
      fi
    fi
  fi
 }

 cmd_cleanup() {
  local session="${1:-}"
  local settings="${2:-.claude/settings.json}"

  # Remove event file(s)
  if [ -n "$session" ]; then
    local ef
    ef="$(event_file "$session")"
    if [ -f "$ef" ]; then
      rm -f "$ef"
      echo "Removed ${ef}"
    fi
  else
    # Clean all event files
    local count=0
    for f in "${EVENT_DIR}"/claude-events-*.jsonl; do
      [ -f "$f" ] || continue
      rm -f "$f"
      count=$((count + 1))
    done
    if [ "$count" -gt 0 ]; then
      echo "Removed ${count} event file(s)."
    fi
  fi

  # Remove hooks from settings.json
  cmd_remove_hooks "$settings"
 }

 cmd_list() {
  local session="${1:-$(get_session)}"
  local ef
  ef="$(event_file "$session")"
  if [ -f "$ef" ]; then
    cat "$ef"
  else
    echo "No events for session '${session}'."
  fi
 }

 cmd_status() {
  local session="${1:-$(get_session)}"
  local ef
  ef="$(event_file "$session")"
  if [ -f "$ef" ]; then
    tail -1 "$ef"
  else
    echo "No events for session '${session}'."
  fi
 }

 cmd_send() {
  local pane="${1:?Usage: send <pane> <text>}"
  shift
  local text="$*"
  if [ -z "$text" ]; then
    # Read from stdin if no text argument (supports piping / here-doc)
    text="$(cat)"
  fi
  if [ -z "$text" ]; then
    echo "Error: no text provided." >&2
    exit 1
  fi
  tmux send-keys -t "$pane" "$text" Enter
  sleep 1
  # Check for Pasted text indicator and send extra Enter if needed
  if tmux capture-pane -t "$pane" -p | tail -5 | grep -q 'Pasted text'; then
    tmux send-keys -t "$pane" Enter
    sleep 0.5
    if tmux capture-pane -t "$pane" -p | tail -5 | grep -q 'Pasted text'; then
      echo "Warning: 'Pasted text' still visible after retry." >&2
    fi
  fi
 }

 cmd_codex_status() {
  local pane="${1:?Usage: codex-status <pane>}"
  # Codex has no hook events. Infer state from screen content.
  # Codex idle prompt shows: › Implement {feature}
  # When processing, the › line shows the actual input text instead.
  local content
  content="$(tmux capture-pane -t "$pane" -p | tail -10)"
  if echo "$content" | grep -qE "Implement \{feature\}"; then
    echo "IDLE"
  else
    echo "BUSY (or unknown — use capture-pane to verify)"
  fi
 }

 cmd_send_file() {
  local pane="${1:?Usage: send-file <pane> <file>}"
  local file="${2:?Usage: send-file <pane> <file>}"
  if [ ! -f "$file" ]; then
    echo "Error: file not found: ${file}" >&2
    exit 1
  fi
  local text
  text="$(cat "$file")"
  cmd_send "$pane" "$text"
 }

 cmd_role_status() {
  local session="${1:-$(get_session)}"
  local ef
  ef="$(event_file "$session")"
  if [ ! -f "$ef" ]; then
    echo "No events for session '${session}'."
    return
  fi
  # For each unique role, print the last event
  awk -F'"' '{
    for (i=1; i<=NF; i++) {
      if ($i == "role") role=$(i+2)
      if ($i == "event") event=$(i+2)
      if ($i == "ts") ts=$(i+2)
    }
    if (role != "") last[role] = event " (" ts ")"
  }
  END {
    for (r in last) print r ": " last[r]
  }' "$ef" | sort
 }

 cmd_stale() {
  local session="${1:-$(get_session)}"
  local threshold_min="${2:-5}"
  local ef
  ef="$(event_file "$session")"
  if [ ! -f "$ef" ]; then
    echo "No events for session '${session}'."
    return
  fi
  local now_epoch
  now_epoch="$(date +%s)"
  local found=0

  local role event ts event_epoch diff_sec diff_min

  # For each role, get last event; if it's UserPromptSubmit and older than threshold, report
  while IFS= read -r line; do
    role="$(echo "$line" | awk -F'"' '{ for(i=1;i<=NF;i++) if($i=="role") print $(i+2) }')"
    event="$(echo "$line" | awk -F'"' '{ for(i=1;i<=NF;i++) if($i=="event") print $(i+2) }')"
    ts="$(echo "$line" | awk -F'"' '{ for(i=1;i<=NF;i++) if($i=="ts") print $(i+2) }')"

    if [ "$event" = "UserPromptSubmit" ] && [ -n "$ts" ]; then
      # Parse ISO timestamp to epoch (works on macOS and GNU date)
      if date -j -f "%Y-%m-%dT%H:%M:%SZ" "$ts" +%s &>/dev/null; then
        event_epoch="$(date -j -f "%Y-%m-%dT%H:%M:%SZ" "$ts" +%s)"
      else
        event_epoch="$(date -d "$ts" +%s 2>/dev/null || echo 0)"
      fi
      diff_sec=$(( now_epoch - event_epoch ))
      diff_min=$(( diff_sec / 60 ))
      if [ "$diff_min" -ge "$threshold_min" ]; then
        echo "STALE: ${role} — UserPromptSubmit ${diff_min} minutes ago (${ts})"
        found=1
      fi
    fi
  done < <(
    # Get last event per role
    awk -F'"' '{
      for (i=1; i<=NF; i++) {
        if ($i == "role") role=$(i+2)
      }
      if (role != "") lines[role] = $0
    }
    END {
      for (r in lines) print lines[r]
    }' "$ef"
  )

  if [ "$found" -eq 0 ]; then
    echo "No stale roles."
  fi
 }

 # --- Main ---

 cmd="${1:-}"
 shift || true

 case "$cmd" in
  log)       cmd_log "$@" ;;
  install)   cmd_install "$@" ;;
  cleanup)   cmd_cleanup "$@" ;;
  list)      cmd_list "$@" ;;
  status)    cmd_status "$@" ;;
  send)         cmd_send "$@" ;;
  send-file)    cmd_send_file "$@" ;;
  role-status)  cmd_role_status "$@" ;;
  stale)        cmd_stale "$@" ;;
  codex-status) cmd_codex_status "$@" ;;
  *)
    echo "Usage: $(basename "$0") {log|install|cleanup|list|status|send|send-file|role-status|stale|codex-status} [args...]" >&2
    exit 1
    ;;
 esac
diff --git a/navigator-driver-briefing.md b/navigator-driver-briefing.md
diff --git a/SKILL.md b/SKILL.md
File	Goes to
`SKILL.md`	`<claude-code-plugin>/skills/tl-dx-human-being/SKILL.md`
`human-being-hooks.sh`	`<claude-code-plugin>/skills/tl-dx-human-being/scripts/human-being-hooks.sh`
`navigator-driver-briefing.md`	`<claude-code-plugin>/skills/tl-dx-human-being/references/navigator-driver-briefing.md`
	#!/usr/bin/env bash
	# human-being-hooks.sh — manage hooks for tl-dx-human-being skill
	#
	# Usage:
	# human-being-hooks.sh log <event-type> # called by hook, appends event
	# human-being-hooks.sh install [settings.json] # add hooks to settings file
	# human-being-hooks.sh cleanup [session] [settings.json] # remove hooks + event file
	# human-being-hooks.sh list [session] # show recent events
	# human-being-hooks.sh status [session] # last event timestamp
	# human-being-hooks.sh send <pane> <text> # send text to pane, auto-handle Pasted text
	# human-being-hooks.sh send-file <pane> <file> # send file contents to pane
	# human-being-hooks.sh role-status [session] # last event per role
	# human-being-hooks.sh stale [session] [minutes] # find roles stuck busy too long
	# human-being-hooks.sh codex-status <pane> # check Codex Driver state via capture-pane

	set -euo pipefail

	SCRIPT_PATH="$(cd "$(dirname "$0")" && pwd)/$(basename "$0")"
	HOOK_TAG="tl-dx-human-being"
	EVENT_DIR="/tmp"

	get_session() {
	tmux display-message -p '#S' 2>/dev/null \|\| echo "default"
	}

	event_file() {
	local session="${1:-$(get_session)}"
	echo "${EVENT_DIR}/claude-events-${session}.jsonl"
	}

	# --- Subcommands ---

	HOOK_EVENTS=("SessionStart" "UserPromptSubmit" "Stop" "PermissionRequest" "Notification")

	cmd_log() {
	local event_type="${1:-unknown}"
	local session
	session="$(get_session)"
	local role="${ROLE:-unknown}"
	local ts
	ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
	echo "{\"event\":\"${event_type}\",\"ts\":\"${ts}\",\"session\":\"${session}\",\"role\":\"${role}\",\"skill\":\"${HOOK_TAG}\"}" \
	>> "$(event_file "$session")"
	}

	cmd_install() {
	local settings="${1:-.claude/settings.json}"

	# If already installed, remove old hooks first (plugin version may have changed)
	# Pass "skip-events" as session to avoid deleting event files during reinstall
	if [ -f "$settings" ] && grep -q "${HOOK_TAG}" "$settings" 2>/dev/null; then
	echo "Removing old hooks from ${settings} before reinstalling..."
	cmd_remove_hooks "$settings"
	fi

	if ! command -v jq &>/dev/null; then
	echo "Error: jq is required to install hooks." >&2
	exit 1
	fi

	# Start from existing settings or empty object
	local base="{}"
	if [ -f "$settings" ]; then
	base="$(cat "$settings")"
	fi

	local tmp="${settings}.tmp.$$"
	local jq_expr="."
	for evt in "${HOOK_EVENTS[@]}"; do
	local entry
	entry=$(jq -n --arg cmd "${SCRIPT_PATH} log ${evt}" '{
	"matcher": "",
	"hooks": [{"type": "command", "command": $cmd, "timeout": 5}]
	}')
	jq_expr="${jq_expr} \| .hooks.${evt} = (.hooks.${evt} // []) + [\$entry_${evt}]"
	done

	# Build jq args dynamically
	local jq_args=()
	for evt in "${HOOK_EVENTS[@]}"; do
	local entry
	entry=$(jq -n --arg cmd "${SCRIPT_PATH} log ${evt}" '{
	"matcher": "",
	"hooks": [{"type": "command", "command": $cmd, "timeout": 5}]
	}')
	jq_args+=(--argjson "entry_${evt}" "$entry")
	done

	if echo "$base" \| jq "${jq_args[@]}" '
	.hooks.SessionStart = (.hooks.SessionStart // []) + [$entry_SessionStart]
	\| .hooks.UserPromptSubmit = (.hooks.UserPromptSubmit // []) + [$entry_UserPromptSubmit]
	\| .hooks.Stop = (.hooks.Stop // []) + [$entry_Stop]
	\| .hooks.PermissionRequest = (.hooks.PermissionRequest // []) + [$entry_PermissionRequest]
	\| .hooks.Notification = (.hooks.Notification // []) + [$entry_Notification]
	' > "$tmp"; then
	mv "$tmp" "$settings"
	echo "Hooks added to ${settings}: ${HOOK_EVENTS[*]}"
	else
	rm -f "$tmp"
	echo "Error: failed to install hooks into ${settings}." >&2
	exit 1
	fi
	}

	cmd_remove_hooks() {
	local settings="${1:-.claude/settings.json}"
	if [ -f "$settings" ] && grep -q "${HOOK_TAG}" "$settings" 2>/dev/null; then
	if command -v jq &>/dev/null; then
	local tmp="${settings}.tmp.$$"
	local jq_expr="."
	for evt in "${HOOK_EVENTS[@]}"; do
	jq_expr="${jq_expr} \| .hooks.${evt} = [.hooks.${evt}[]? \| select(.hooks[]?.command \| contains(\$tag) \| not)] \| if .hooks.${evt} == [] then del(.hooks.${evt}) else . end"
	done
	if jq --arg tag "${HOOK_TAG}" "${jq_expr}" "$settings" > "$tmp"; then
	mv "$tmp" "$settings"
	echo "Hooks removed from ${settings}."
	else
	rm -f "$tmp"
	echo "Warning: failed to remove hooks from ${settings}." >&2
	fi
	fi
	fi
	}

	cmd_cleanup() {
	local session="${1:-}"
	local settings="${2:-.claude/settings.json}"

	# Remove event file(s)
	if [ -n "$session" ]; then
	local ef
	ef="$(event_file "$session")"
	if [ -f "$ef" ]; then
	rm -f "$ef"
	echo "Removed ${ef}"
	fi
	else
	# Clean all event files
	local count=0
	for f in "${EVENT_DIR}"/claude-events-*.jsonl; do
	[ -f "$f" ] \|\| continue
	rm -f "$f"
	count=$((count + 1))
	done
	if [ "$count" -gt 0 ]; then
	echo "Removed ${count} event file(s)."
	fi
	fi

	# Remove hooks from settings.json
	cmd_remove_hooks "$settings"
	}

	cmd_list() {
	local session="${1:-$(get_session)}"
	local ef
	ef="$(event_file "$session")"
	if [ -f "$ef" ]; then
	cat "$ef"
	else
	echo "No events for session '${session}'."
	fi
	}

	cmd_status() {
	local session="${1:-$(get_session)}"
	local ef
	ef="$(event_file "$session")"
	if [ -f "$ef" ]; then
	tail -1 "$ef"
	else
	echo "No events for session '${session}'."
	fi
	}

	cmd_send() {
	local pane="${1:?Usage: send <pane> <text>}"
	shift
	local text="$*"
	if [ -z "$text" ]; then
	# Read from stdin if no text argument (supports piping / here-doc)
	text="$(cat)"
	fi
	if [ -z "$text" ]; then
	echo "Error: no text provided." >&2
	exit 1
	fi
	tmux send-keys -t "$pane" "$text" Enter
	sleep 1
	# Check for Pasted text indicator and send extra Enter if needed
	if tmux capture-pane -t "$pane" -p \| tail -5 \| grep -q 'Pasted text'; then
	tmux send-keys -t "$pane" Enter
	sleep 0.5
	if tmux capture-pane -t "$pane" -p \| tail -5 \| grep -q 'Pasted text'; then
	echo "Warning: 'Pasted text' still visible after retry." >&2
	fi
	fi
	}

	cmd_codex_status() {
	local pane="${1:?Usage: codex-status <pane>}"
	# Codex has no hook events. Infer state from screen content.
	# Codex idle prompt shows: › Implement {feature}
	# When processing, the › line shows the actual input text instead.
	local content
	content="$(tmux capture-pane -t "$pane" -p \| tail -10)"
	if echo "$content" \| grep -qE "Implement \{feature\}"; then
	echo "IDLE"
	else
	echo "BUSY (or unknown — use capture-pane to verify)"
	fi
	}

	cmd_send_file() {
	local pane="${1:?Usage: send-file <pane> <file>}"
	local file="${2:?Usage: send-file <pane> <file>}"
	if [ ! -f "$file" ]; then
	echo "Error: file not found: ${file}" >&2
	exit 1
	fi
	local text
	text="$(cat "$file")"
	cmd_send "$pane" "$text"
	}

	cmd_role_status() {
	local session="${1:-$(get_session)}"
	local ef
	ef="$(event_file "$session")"
	if [ ! -f "$ef" ]; then
	echo "No events for session '${session}'."
	return
	fi
	# For each unique role, print the last event
	awk -F'"' '{
	for (i=1; i<=NF; i++) {
	if ($i == "role") role=$(i+2)
	if ($i == "event") event=$(i+2)
	if ($i == "ts") ts=$(i+2)
	}
	if (role != "") last[role] = event " (" ts ")"
	}
	END {
	for (r in last) print r ": " last[r]
	}' "$ef" \| sort
	}

	cmd_stale() {
	local session="${1:-$(get_session)}"
	local threshold_min="${2:-5}"
	local ef
	ef="$(event_file "$session")"
	if [ ! -f "$ef" ]; then
	echo "No events for session '${session}'."
	return
	fi
	local now_epoch
	now_epoch="$(date +%s)"
	local found=0

	local role event ts event_epoch diff_sec diff_min

	# For each role, get last event; if it's UserPromptSubmit and older than threshold, report
	while IFS= read -r line; do
	role="$(echo "$line" \| awk -F'"' '{ for(i=1;i<=NF;i++) if($i=="role") print $(i+2) }')"
	event="$(echo "$line" \| awk -F'"' '{ for(i=1;i<=NF;i++) if($i=="event") print $(i+2) }')"
	ts="$(echo "$line" \| awk -F'"' '{ for(i=1;i<=NF;i++) if($i=="ts") print $(i+2) }')"

	if [ "$event" = "UserPromptSubmit" ] && [ -n "$ts" ]; then
	# Parse ISO timestamp to epoch (works on macOS and GNU date)
	if date -j -f "%Y-%m-%dT%H:%M:%SZ" "$ts" +%s &>/dev/null; then
	event_epoch="$(date -j -f "%Y-%m-%dT%H:%M:%SZ" "$ts" +%s)"
	else
	event_epoch="$(date -d "$ts" +%s 2>/dev/null \|\| echo 0)"
	fi
	diff_sec=$(( now_epoch - event_epoch ))
	diff_min=$(( diff_sec / 60 ))
	if [ "$diff_min" -ge "$threshold_min" ]; then
	echo "STALE: ${role} — UserPromptSubmit ${diff_min} minutes ago (${ts})"
	found=1
	fi
	fi
	done < <(
	# Get last event per role
	awk -F'"' '{
	for (i=1; i<=NF; i++) {
	if ($i == "role") role=$(i+2)
	}
	if (role != "") lines[role] = $0
	}
	END {
	for (r in lines) print lines[r]
	}' "$ef"
	)

	if [ "$found" -eq 0 ]; then
	echo "No stale roles."
	fi
	}

	# --- Main ---

	cmd="${1:-}"
	shift \|\| true

	case "$cmd" in
	log) cmd_log "$@" ;;
	install) cmd_install "$@" ;;
	cleanup) cmd_cleanup "$@" ;;
	list) cmd_list "$@" ;;
	status) cmd_status "$@" ;;
	send) cmd_send "$@" ;;
	send-file) cmd_send_file "$@" ;;
	role-status) cmd_role_status "$@" ;;
	stale) cmd_stale "$@" ;;
	codex-status) cmd_codex_status "$@" ;;
	*)
	echo "Usage: $(basename "$0") {log\|install\|cleanup\|list\|status\|send\|send-file\|role-status\|stale\|codex-status} [args...]" >&2
	exit 1
	;;
	esac
name	tl-dx-human-being
disable-model-invocation	true
description	Simulate a human operator coordinating AI agents via tmux. Three-layer hierarchy: PO (user) talks only to PO proxy (this session), PO proxy directs Navigator and Driver in tmux panes. Pairs with i-am-lazy or other delegation skills as the hands-on executor.
Mode	When to use	Panes
Simple	Single-file edit, formatting, simple bug fix	1 Worker
Standard	Multi-step development, tasks needing planning	Navigator + Driver
Multi-driver	Cross-file refactor, parallel independent subtasks	Navigator + multiple Drivers