Files
claude/hooks/session-start.sh
T

443 lines
17 KiB
Bash

#!/usr/bin/env bash
# ============================================================
# Claude Code — Session start plugin status
# Runs once per session. Filesystem only, except one quiet
# git fetch for the version/update check near the end.
# ============================================================
# ── Session source (memory digest gate) ──
# stdin carries the hook JSON. Read it first, before any child can eat it.
# Digest on startup | clear | compact, and on an empty source from a manual
# terminal run; never on resume. Without timeout or jq the source is
# unknowable: digest only when stdin is a terminal, never from a hook.
# A non-JSON stdin makes jq print nothing: it reads as an empty source and
# the digest prints.
_ss_digest=0
if command -v timeout >/dev/null 2>&1 && command -v jq >/dev/null 2>&1; then
_ss_source=""
if [ ! -t 0 ]; then
_ss_in=$(timeout 1 cat 2>/dev/null)
_ss_source=$(printf '%s' "$_ss_in" | jq -r '.source // empty' 2>/dev/null)
fi
case "$_ss_source" in ""|startup|clear|compact) _ss_digest=1 ;; esac
unset _ss_in _ss_source
elif [ -t 0 ]; then
_ss_digest=1
fi
# ── Quick health check (filesystem only, no subprocesses) ──
BROKEN=()
for f in CLAUDE.md settings.json agents skills rules; do
[ ! -e "$HOME/.claude/$f" ] && BROKEN+=("$f")
done
if [ ${#BROKEN[@]} -gt 0 ]; then
# Try to find the repo path from an existing symlink
_repo_hint=""
for _probe in CLAUDE.md settings.json; do
if [ -L "$HOME/.claude/$_probe" ]; then
_repo_hint="$(cd "$(dirname "$(readlink "$HOME/.claude/$_probe")")" 2>/dev/null && pwd)"
break
fi
done
_fix_cmd="${_repo_hint:+cd $_repo_hint && }bash link.sh"
echo ""
echo "┌─ ⚠️ CONFIG ISSUES ────────────────────────────────┐"
for b in "${BROKEN[@]}"; do
printf "│ MISSING: ~/.claude/%-30s│\n" "$b"
done
printf "│ → %-47s│\n" "$_fix_cmd"
echo "│ → make doctor for full diagnostic │"
echo "└───────────────────────────────────────────────────┘"
unset _repo_hint _fix_cmd
fi
# ── Load shared detection library ──
_lib="$(dirname "${BASH_SOURCE[0]}")/../lib/detect-plugins.sh"
if [ -f "$_lib" ]; then
# shellcheck source=../lib/detect-plugins.sh disable=SC1091
source "$_lib"
else
echo "⚠️ lib/detect-plugins.sh not found — config broken, run: bash link.sh"
exit 0
fi
unset _lib
# ── gitflow hooks reconcile (BDR-095) ──
# A repo's .githooks/ lags lib/gitflow.sh until someone re-runs install-hook
# (LRN-114). Do it here, once per session, silently when current; the lib
# prints the refreshed names, shown in the banner with a commit reminder.
GF_REFRESHED=""
_gf_lib="$(dirname "${BASH_SOURCE[0]}")/../lib/gitflow.sh"
if [ -f "$_gf_lib" ] && git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
GF_REFRESHED=$(bash "$_gf_lib" reconcile-hooks 2>/dev/null | sed -n 's/^gitflow hooks refreshed: *//p')
fi
# ── graphify threshold signal (BDR-097) ──
# Informs, never acts: one banner line when the repo holds ≥ 200 tracked code
# files and no graph. The user decides whether to build one.
GRAPHIFY_HINT=""
_gg_lib="$(dirname "${BASH_SOURCE[0]}")/../lib/graphify-gate.sh"
if [ -f "$_gg_lib" ]; then GRAPHIFY_HINT=$(bash "$_gg_lib" "$PWD" 2>/dev/null); fi
unset _gg_lib
# ── Toggle plugin detection ──
# One profile.sh run, shared with detect_gstack through PROFILE_PLAIN.
PROFILE_PLAIN="$(bash "$HOME/.claude/lib/profile.sh" -C "$PWD" current \
--plain 2>/dev/null)" || PROFILE_PLAIN=""
export PROFILE_PLAIN
TOGGLE_ACTIVE=()
TOGGLE_INACTIVE=()
for plugin in gstack uiux_pro_max plugin_dev context7 graphifyy; do
# Map function name to display name. graphifyy = the pipx PACKAGE name
# (pypi:graphifyy); the CLI and skill are 'graphify' — display that.
case "$plugin" in
uiux_pro_max) display="ui-ux-pro-max" ;;
plugin_dev) display="plugin-dev" ;;
graphifyy) display="graphify" ;;
*) display="$plugin" ;;
esac
if "detect_$plugin" 2>/dev/null; then
TOGGLE_ACTIVE+=("$display")
else
TOGGLE_INACTIVE+=("$display")
fi
done
# --- Format output ---
ACTIVE_STR="${TOGGLE_ACTIVE[*]:-none}"
INACTIVE_STR="${TOGGLE_INACTIVE[*]:-none}"
# Profile row: the project's local profile, the conversation's --settings
# one, or none (manifest defaults = full) with the /plugin-check pointer.
_pname="$(sed -n 's/^profile=//p' <<<"$PROFILE_PLAIN" | head -1)"
case "$(sed -n 's/^source=//p' <<<"$PROFILE_PLAIN" | head -1)" in
flag) PROFILE_ROW="profile: ${_pname} (conv)" ;;
local) PROFILE_ROW="profile: ${_pname} (local)" ;;
default) PROFILE_ROW="profile: none (full), try /plugin-check" ;;
*) PROFILE_ROW="profile: ? (profile.sh failed)" ;;
esac
unset _pname
# GSD v2 — standalone CLI (not a Claude Code plugin — shown separately)
if detect_gsd 2>/dev/null; then
GSD_STATUS="gsd v2 ✓"
else
GSD_STATUS="gsd v2 ✗ (npm install -g gsd-pi)"
fi
# Version detection: follow CLAUDE.md symlink back to repo, then read version.txt
_claude_real="$(readlink "$HOME/.claude/CLAUDE.md" 2>/dev/null || true)"
if [ -n "$_claude_real" ]; then
_repo_dir="$(cd "$(dirname "$_claude_real")" 2>/dev/null && pwd)"
CONFIG_VERSION=$(cat "$_repo_dir/version.txt" 2>/dev/null || echo "?")
else
CONFIG_VERSION="?"
fi
REPO_DIR="${_repo_dir:-}"
unset _claude_real _repo_dir
# Effort tiering (BDR-107): this env var beats every skill/agent `effort:` pin.
EFFORT_WARN=""
if [ -n "${CLAUDE_CODE_EFFORT_LEVEL:-}" ]; then
EFFORT_WARN="⚠️ CLAUDE_CODE_EFFORT_LEVEL=${CLAUDE_CODE_EFFORT_LEVEL} set: skill/agent effort pins ignored"
fi
# Detect plan and set passive token budget
PLAN=$(detect_plan 2>/dev/null || echo "pro")
case "$PLAN" in
max) _budget=20000; PLAN_LABEL="Max" ;;
pro) _budget=11000; PLAN_LABEL="Pro" ;;
free) _budget=5000; PLAN_LABEL="Free" ;;
*) _budget=11000; PLAN_LABEL="Pro" ;;
esac
# Quick passive token cost estimate
# Only count plugins that are ACTIVE (detected as ON), not just installed
# superpowers dropped 2026-09-28 (tier 2 of the skill-catalog prune): its
# 7 vendored skills are counted by the skill catalog, not a plugin cost.
_passive_t=0
# Token costs for toggle plugins — map display name to cost
declare -A _plugin_costs=(
[gstack]=2750
[ui-ux-pro-max]=400
[plugin-dev]=100
[context7]=200
[graphify]=300
)
for _p in "${TOGGLE_ACTIVE[@]}"; do
_cost="${_plugin_costs[$_p]:-0}"
_passive_t=$((_passive_t + _cost))
done
_budget_pct=$((_passive_t * 100 / _budget))
if [ "$_budget_pct" -gt 50 ]; then
TOKEN_WARN="⚠️ ~${_passive_t}t passif (${_budget_pct}% budget $PLAN_LABEL)"
elif [ "$_budget_pct" -gt 25 ]; then
TOKEN_WARN="~${_passive_t}t passif (${_budget_pct}% budget $PLAN_LABEL)"
else
TOKEN_WARN=""
fi
unset _passive_t _budget_pct _budget
echo ""
echo "┌─ Claude Code config ──────────────────────────────────┐"
# "ALWAYS ON" row — actual state, not hardcoded. RTK is a binary on PATH;
# the others are marketplace plugins whose state lives in
# settings.json:enabledPlugins. Anything missing/disabled is omitted so
# the user sees the real picture instead of a misleading literal.
ALWAYS_ON=()
detect_rtk &>/dev/null && ALWAYS_ON+=("rtk")
# Derive the plugin list from settings.json:enabledPlugins (true entries)
# instead of a hardcoded name pair — a hardcoded SET under-reports newly
# enabled plugins (pr-review-toolkit was enabled yet invisible). LRN-005
# class. Plugins owned by the toggle row below are excluded (dual display).
_toggle_owned=" gstack ui-ux-pro-max plugin-dev context7 graphify "
while IFS= read -r _pl; do
case "$_toggle_owned" in
*" $_pl "*) : ;;
*) ALWAYS_ON+=("$_pl") ;;
esac
done < <(grep -oE '"[A-Za-z0-9_-]+@[A-Za-z0-9_-]+"[[:space:]]*:[[:space:]]*true' "$HOME/.claude/settings.json" 2>/dev/null \
| sed -E 's/^"([^@]+)@.*$/\1/')
unset _toggle_owned _pl
ALWAYS_ON_STR="${ALWAYS_ON[*]:-none}"
# Same 40-char-width split policy as the toggle row below — keeps the
# right border aligned on overflow. Greedy width-fill (not a fixed 3-name
# cut: 3 long names overflowed line 1 and left line 2 empty).
if [ "${#ALWAYS_ON_STR}" -le 40 ]; then
printf "│ ✅ ON : %-40s│\n" "$ALWAYS_ON_STR"
else
_ao_l1=""; _ao_l2=""
for _ao_e in "${ALWAYS_ON[@]}"; do
if [ -z "$_ao_l2" ] && [ $(( ${#_ao_l1} + ${#_ao_e} + 1 )) -le 40 ]; then
_ao_l1="${_ao_l1:+$_ao_l1 }$_ao_e"
else
_ao_l2="${_ao_l2:+$_ao_l2 }$_ao_e"
fi
done
printf "│ ✅ ON : %-40s│\n" "$_ao_l1"
printf "│ %-40s│\n" "$_ao_l2"
unset _ao_l1 _ao_l2 _ao_e
fi
unset ALWAYS_ON ALWAYS_ON_STR
# Plugin display — all plugins shown, split across 2 lines if >4
_active_count=${#TOGGLE_ACTIVE[@]}
_inactive_count=${#TOGGLE_INACTIVE[@]}
if [ "$_active_count" -eq 0 ]; then
printf "│ 🟢 ON : %-40s│\n" "none"
elif [ "$_active_count" -le 4 ]; then
printf "│ 🟢 ON : %-40s│\n" "$ACTIVE_STR"
else
# Split: first 4 on line 1, rest on continuation line
_line1="${TOGGLE_ACTIVE[0]} ${TOGGLE_ACTIVE[1]} ${TOGGLE_ACTIVE[2]} ${TOGGLE_ACTIVE[3]}"
_rest=("${TOGGLE_ACTIVE[@]:4}")
_line2="${_rest[*]}"
printf "│ 🟢 ON : %-40s│\n" "$_line1"
printf "│ %-40s│\n" "$_line2"
unset _line1 _line2 _rest
fi
if [ "$_inactive_count" -eq 0 ]; then
printf "│ ⚫ OFF : %-40s│\n" "none"
elif [ "$_inactive_count" -le 4 ]; then
printf "│ ⚫ OFF : %-40s│\n" "$INACTIVE_STR"
else
_line1="${TOGGLE_INACTIVE[0]} ${TOGGLE_INACTIVE[1]} ${TOGGLE_INACTIVE[2]} ${TOGGLE_INACTIVE[3]}"
_rest=("${TOGGLE_INACTIVE[@]:4}")
_line2="${_rest[*]}"
printf "│ ⚫ OFF : %-40s│\n" "$_line1"
printf "│ %-40s│\n" "$_line2"
unset _line1 _line2 _rest
fi
unset _active_count _inactive_count
printf "│ 🖥️ CLI : %-40s│\n" "$GSD_STATUS"
[ -n "$TOKEN_WARN" ] && printf "│ 💰 %-44s│\n" "${TOKEN_WARN:0:44}"
printf "│ 📦 v%-45s│\n" "$CONFIG_VERSION"
if [ -n "$GF_REFRESHED" ]; then
_gf_line="hooks refreshed: $GF_REFRESHED → commit .githooks/"
printf "│ 🪝 %-44s│\n" "${_gf_line:0:44}"
unset _gf_line
fi
# ── manual-push mode (BDR-111): one lock line when this repo never auto-pushes ──
# %-46s, not 44: bash printf pads by BYTES and "—" is 3 bytes (2 extra).
_pm=$( [ -r "$_gf_lib" ] && bash "$_gf_lib" push-mode 2>/dev/null )
case "$_pm" in
manual) printf "│ 🔒 %-46s│\n" "push : manual (autopush=false) — ! git push" ;;
invalid) printf "│ 🔒 %-46s│\n" "push : manual (autopush bad) — ! git push" ;;
esac
unset _pm _gf_lib
# ── code origin: one line inside a git repo, none outside ──
_co_lib="$(dirname "${BASH_SOURCE[0]}")/../lib/code-origin.sh"
if [ -r "$_co_lib" ] && git rev-parse --git-dir >/dev/null 2>&1; then
_co=$(bash "$_co_lib" 2>/dev/null)
case "$_co" in
ours*) _co_line="code : ours (limites strictes)" ;;
foreign*) _co_line="code : foreign (${_co#foreign })" ;;
*) _co_line="" ;;
esac
[ -n "$_co_line" ] && printf "│ 📐 %-44s│\n" "${_co_line:0:44}"
unset _co _co_line
fi
unset _co_lib
if [ -n "$GRAPHIFY_HINT" ]; then
printf "│ 🕸️ %-44s│\n" "${GRAPHIFY_HINT:0:44}"
printf "│ %-40s│\n" "→ /graphify (AST, seconds) — you decide"
fi
# CLAUDE.global.md line-count guard (anti-regression, BDR-062): warn past
# 320. BDR-125 phase 1 moved Design work, the graphify usage and the
# architecture defaults to their carriers.
if [ -n "$REPO_DIR" ] && [ -f "$REPO_DIR/CLAUDE.global.md" ]; then
_claude_lines=$(wc -l < "$REPO_DIR/CLAUDE.global.md")
if [ "$_claude_lines" -gt 320 ]; then
_cmd_warn="CLAUDE.global.md ${_claude_lines}L (>320) — density pass"
printf "│ ⚠️ %-44s│\n" "${_cmd_warn:0:44}"
unset _cmd_warn
fi
unset _claude_lines
fi
# Registry v1 (BDR-125 phase 4a): a project registry without `format: 2`.
# The lib names each v1 registry on stderr (`memory: v1: <file>`).
_mem_lib="$(dirname "${BASH_SOURCE[0]}")/../lib/memory.sh"
if [ -f "$_mem_lib" ] && [ -d .claude/memory ]; then
_v1=$(bash "$_mem_lib" check .claude/memory 2>&1 >/dev/null \
| grep -c '^memory: v1:' || true)
if [ "${_v1:-0}" -gt 0 ]; then
printf "│ ⚠️ %-44s│\n" "registry v1: ${_v1} file(s) (memory.sh check)"
fi
unset _v1
fi
unset _mem_lib
# Version check: compare local vs remote (non-blocking)
_remote_ver=""
if [ -n "$REPO_DIR" ] && [ -d "$REPO_DIR/.git" ] && [ -z "${SESSION_START_OFFLINE:-}" ]; then
_remote_ver=$(cd "$REPO_DIR" 2>/dev/null && git fetch origin --quiet 2>/dev/null && git show origin/main:version.txt 2>/dev/null) || _remote_ver=""
fi
if [ -n "$_remote_ver" ] && [ "$_remote_ver" != "$CONFIG_VERSION" ]; then
printf "│ 🔄 update available: v%-27s│\n" "$_remote_ver"
fi
unset _remote_ver REPO_DIR
printf "│ 🎛 %-46s│\n" "$PROFILE_ROW"
echo "│ 🩺 make doctor full diagnostic │"
echo "└───────────────────────────────────────────────────┘"
[ -n "$EFFORT_WARN" ] && printf '%s\n' "$EFFORT_WARN"
# graphify usage (BDR-125 phase 1): the rules left CLAUDE.global.md, which
# keeps the 200-file threshold and a one-line reminder; they print where a
# graph exists.
_gx_root=$(git rev-parse --show-toplevel 2>/dev/null)
if [ -n "$_gx_root" ] && [ -f "$_gx_root/graphify-out/graph.json" ]; then
cat <<'EOF'
graphify (graphify-out/graph.json present):
- Codebase-wide question → `graphify query`; relationships → `path A B`;
concept → `explain`. Scoped subgraph beats raw grep.
- Known file / small task → read directly, no graphify.
- `wiki/index.md` → broad-nav entry; `GRAPH_REPORT.md` → whole-architecture.
- After editing code → `graphify update .` (AST-only, free).
EOF
fi
unset _gx_root
# ── memory digest ──
# Cut a line at 160 chars with an ellipsis; a cut that split a multibyte
# char (non-UTF-8 locale) loses trailing chars until iconv accepts it.
_digest_cut() {
local v=$1
[ "${#v}" -le 160 ] && { printf '%s' "$v"; return; }
v="${v:0:159}"
if command -v iconv >/dev/null 2>&1; then
while [ -n "$v" ] \
&& ! printf '%s' "$v" | iconv -f UTF-8 -t UTF-8 >/dev/null 2>&1; do
v="${v%?}"
done
fi
printf '%s…' "$v"
}
# Open BLK (≤ 3 listed, the rest counted) and upstream count, as digest lines.
_digest_blockers() { # <root> <memory.sh>
local row line rest status title open=0 upstream=0 more="" tmo=()
# a hung memory.sh must not stall every session start
command -v timeout >/dev/null 2>&1 && tmo=(timeout 2)
while IFS= read -r row; do
[[ "$row" == "| BLK-"* ]] || continue
line="${row#| }"; line="${line% |}"
rest="${line#* | }"; rest="${rest#* | }"
[[ "$rest" == *" | "* ]] || continue
status="${rest##* | }"; title="${rest% | *}"
case "$status" in
open) open=$((open + 1))
[ "$open" -le 3 ] && echo "- open: ${line%% | *} $title" ;;
upstream) upstream=$((upstream + 1)) ;;
esac
done < <("${tmo[@]}" bash "$2" -C "$1" index blocker 2>/dev/null)
[ "$open" -gt 3 ] && more="+$((open - 3)) more"
[ "$upstream" -gt 0 ] && more="${more:+$more, }+${upstream} upstream"
[ -n "$more" ] && echo "- open: $more"
}
_digest_todo() { # <root> → first 3 unchecked Actionable items
awk '/^### Actionable/ { on = 1; next } /^#/ { on = 0 }
on && sub(/^- \[ \] /, "") && n++ < 3 { print "- todo: " $0 }' \
"$1/.claude/tasks/TODO.md"
}
_digest_journal() { # <root> → last journal bullet
local last
last=$(grep '^- ' "$1/.claude/memory/journal.md" | tail -1)
[ -n "$last" ] && echo "- journal: ${last#- }"
}
# The block: header + open BLK lines + count line + todo lines + journal.
# Todo lines are added in order while the block stays <= 800 chars, so the
# last ones drop first; header, open BLK lines (3 x 160 max), count line and
# journal always stay and always fit. The only loop is bounded by the todo
# count (3). Stays bash 3.2 safe (checked by SD11).
# Built in a variable and printed once, so a failure mid-way prints nothing.
_digest_assemble() { # reads the arrays blk, cnt, todo, jr of the caller
local head="memory digest:" tail="" body="" line size
for line in "${blk[@]}" "${cnt[@]}"; do head+=$'\n'"$line"; done
for line in "${jr[@]}"; do tail=$'\n'"$line"; done
size=$((${#head} + ${#tail}))
for line in "${todo[@]}"; do
[ $((size + ${#line} + 1)) -le 800 ] || break
body+=$'\n'"$line"; size=$((size + ${#line} + 1))
done
printf '%s%s%s\n' "$head" "$body" "$tail"
}
_memory_digest() { # <project-root>
local root=$1 lib line blk=() cnt=() todo=() jr=()
lib="$(dirname "${BASH_SOURCE[0]}")/../lib/memory.sh"
[ -d "$root/.claude/memory" ] || return 0
if [ -f "$lib" ]; then
while IFS= read -r line; do
case "$line" in
"- open: +"*) cnt+=("$line") ;;
*) blk+=("$(_digest_cut "$line")") ;;
esac
done < <(_digest_blockers "$root" "$lib")
fi
while IFS= read -r line; do todo+=("$(_digest_cut "$line")"); done \
< <(_digest_todo "$root")
while IFS= read -r line; do jr+=("$(_digest_cut "$line")"); done \
< <(_digest_journal "$root")
[ $((${#blk[@]} + ${#cnt[@]} + ${#todo[@]} + ${#jr[@]})) -gt 0 ] || return 0
_digest_assemble
}
if [ "$_ss_digest" = 1 ]; then
_ss_root=$(git rev-parse --show-toplevel 2>/dev/null) || _ss_root=$PWD
( _memory_digest "$_ss_root" ) 2>/dev/null || true
unset _ss_root
fi
unset _ss_digest
echo ""
unset TOKEN_WARN PROFILE_PLAIN