uv-suite 0.26.1 → 0.26.3

package/hooks/checkpoint-helper.sh

@@ -0,0 +1,124 @@
+#!/bin/bash
+# UV Suite helper: locate per-session checkpoint paths and print metadata.
+# Used by the /checkpoint and /restore slash commands.
+#
+# Usage:
+#   checkpoint-helper.sh dir       # ensure + print the dir for current session
+#   checkpoint-helper.sh meta      # print session metadata as shell-eval'able lines
+#   checkpoint-helper.sh frontmatter  # YAML frontmatter to embed at the top of a checkpoint
+#   checkpoint-helper.sh latest    # cat the latest checkpoint for current session (with fallback)
+#   checkpoint-helper.sh list      # list all sessions that have checkpoints, newest first
+
+resolve_paths() {
+  PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"
+  STATE_DIR="$PROJECT_DIR/.uv-suite-state"
+  SID="${UVS_SESSION_ID:-}"
+  if [ -z "$SID" ] && [ -f "$STATE_DIR/current-session.txt" ]; then
+    SID=$(cat "$STATE_DIR/current-session.txt" 2>/dev/null)
+  fi
+  CHECKPOINTS_ROOT="$PROJECT_DIR/uv-out/checkpoints"
+  SESSION_CP_DIR=""
+  [ -n "$SID" ] && SESSION_CP_DIR="$CHECKPOINTS_ROOT/$SID"
+  META_FILE=""
+  [ -n "$SID" ] && META_FILE="$STATE_DIR/sessions/$SID.json"
+}
+
+print_meta_field() {
+  # $1 = field name; reads from $META_FILE; empty if missing
+  [ -z "$META_FILE" ] || [ ! -f "$META_FILE" ] && { echo ""; return; }
+  if command -v jq >/dev/null 2>&1; then
+    jq -r --arg k "$1" '.[$k] // ""' "$META_FILE" 2>/dev/null
+  else
+    grep -o "\"$1\"[[:space:]]*:[[:space:]]*\"[^\"]*\"" "$META_FILE" | head -1 | sed "s/.*\"$1\"[[:space:]]*:[[:space:]]*\"\(.*\)\"/\1/"
+  fi
+}
+
+resolve_paths
+
+case "$1" in
+  dir)
+    if [ -n "$SESSION_CP_DIR" ]; then
+      mkdir -p "$SESSION_CP_DIR"
+      echo "$SESSION_CP_DIR"
+    else
+      mkdir -p "$CHECKPOINTS_ROOT"
+      echo "$CHECKPOINTS_ROOT"
+    fi
+    ;;
+  meta)
+    echo "uvs_session_id=${SID:-}"
+    echo "session_name=$(print_meta_field name)"
+    echo "session_kind=$(print_meta_field kind)"
+    echo "session_purpose=$(print_meta_field purpose)"
+    echo "session_priority=$(print_meta_field priority)"
+    echo "persona=$(print_meta_field persona)"
+    ;;
+  frontmatter)
+    NAME=$(print_meta_field name)
+    KIND=$(print_meta_field kind)
+    PURPOSE=$(print_meta_field purpose)
+    PRIORITY=$(print_meta_field priority)
+    PERSONA=$(print_meta_field persona)
+    NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+    cat <<EOF
+---
+uvs_session_id: ${SID:-}
+session_name: ${NAME}
+session_kind: ${KIND}
+session_purpose: ${PURPOSE}
+session_priority: ${PRIORITY}
+persona: ${PERSONA}
+checkpoint_at: ${NOW}
+---
+EOF
+    ;;
+  latest)
+    if [ -n "$SESSION_CP_DIR" ] && [ -f "$SESSION_CP_DIR/latest.md" ]; then
+      cat "$SESSION_CP_DIR/latest.md"
+    elif [ -f "$CHECKPOINTS_ROOT/latest.md" ]; then
+      echo "(no per-session checkpoint for ${SID:-this session}; showing legacy global latest.md)"
+      echo
+      cat "$CHECKPOINTS_ROOT/latest.md"
+    else
+      echo "No checkpoint found at $CHECKPOINTS_ROOT. Run /checkpoint to create one."
+    fi
+    ;;
+  list)
+    [ ! -d "$CHECKPOINTS_ROOT" ] && { echo "No checkpoints directory at $CHECKPOINTS_ROOT"; exit 0; }
+    found=0
+    for d in "$CHECKPOINTS_ROOT"/*/; do
+      [ -d "$d" ] || continue
+      cp_sid=$(basename "$d")
+      cp_meta="$STATE_DIR/sessions/$cp_sid.json"
+      cp_name=""
+      cp_priority=""
+      if [ -f "$cp_meta" ]; then
+        if command -v jq >/dev/null 2>&1; then
+          cp_name=$(jq -r '.name // ""' "$cp_meta" 2>/dev/null)
+          cp_priority=$(jq -r '.priority // ""' "$cp_meta" 2>/dev/null)
+        else
+          cp_name=$(grep -o '"name"[[:space:]]*:[[:space:]]*"[^"]*"' "$cp_meta" | head -1 | sed 's/.*"name"[[:space:]]*:[[:space:]]*"\(.*\)"/\1/')
+        fi
+      fi
+      latest=$(ls -t "$d"*.md 2>/dev/null | head -1)
+      [ -z "$latest" ] && continue
+      ts=$(stat -f '%Sm' -t '%Y-%m-%d %H:%M' "$latest" 2>/dev/null || stat -c '%y' "$latest" 2>/dev/null | cut -c1-16)
+      label="${cp_name:-(unlabeled)}"
+      [ -n "$cp_priority" ] && label="$label [p:$cp_priority]"
+      mark=" "
+      [ "$cp_sid" = "$SID" ] && mark="*"
+      echo "$mark ${cp_sid:0:8}  $ts  $label"
+      found=1
+    done
+    [ "$found" -eq 0 ] && echo "No per-session checkpoints yet (current session: ${SID:-none})"
+    # Note legacy global checkpoint if present
+    if [ -f "$CHECKPOINTS_ROOT/latest.md" ]; then
+      ts=$(stat -f '%Sm' -t '%Y-%m-%d %H:%M' "$CHECKPOINTS_ROOT/latest.md" 2>/dev/null || stat -c '%y' "$CHECKPOINTS_ROOT/latest.md" 2>/dev/null | cut -c1-16)
+      echo "  legacy   $ts  (pre-metadata global latest.md)"
+    fi
+    ;;
+  *)
+    echo "Usage: checkpoint-helper.sh [dir|meta|frontmatter|latest|list]"
+    exit 1
+    ;;
+esac

package/hooks/confirm-prompt.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# UV Suite Hook: Reframe-and-confirm long user prompts before acting.
+#
+# Reads state from $CLAUDE_PROJECT_DIR/.uv-suite-state/. When mode is "on" and
+# the user's prompt exceeds the configured word count, injects a system-context
+# instruction that tells Claude to restate the request and wait for confirmation
+# before doing any work.
+#
+# State files (toggled by the /confirm slash command):
+#   confirm-mode.txt       — "on" or "off"   (default: on)
+#   confirm-threshold.txt  — integer         (default: 50)
+#
+# Slash commands (lines starting with "/") are always skipped so the toggle
+# itself can run without being intercepted.
+
+INPUT=$(cat)
+STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
+
+MODE=$(cat "$STATE_DIR/confirm-mode.txt" 2>/dev/null)
+[ -z "$MODE" ] && MODE="on"
+
+THRESHOLD=$(cat "$STATE_DIR/confirm-threshold.txt" 2>/dev/null)
+[ -z "$THRESHOLD" ] && THRESHOLD=50
+
+[ "$MODE" = "off" ] && exit 0
+
+if command -v jq >/dev/null 2>&1; then
+  PROMPT=$(echo "$INPUT" | jq -r '.prompt // empty' 2>/dev/null)
+else
+  PROMPT=$(echo "$INPUT" | grep -o '"prompt":"[^"]*"' | head -1 | cut -d'"' -f4)
+fi
+
+[ -z "$PROMPT" ] && exit 0
+
+case "$PROMPT" in
+  /*) exit 0 ;;
+esac
+
+WORDS=$(echo "$PROMPT" | wc -w | tr -d ' ')
+[ "$WORDS" -le "$THRESHOLD" ] && exit 0
+
+# Emit Claude Code hook output. additionalContext is appended to the system
+# context for this turn. Keep it terse — long instructions get tuned out.
+ADDITIONAL=$(printf '[uv-suite confirm-mode] The user prompt is %s words (threshold %s). Before doing any work or making tool calls, restate what you understood in 1-2 plain sentences and ask the user to confirm. Only proceed once they confirm. The user can disable this with /confirm off or change the threshold with /confirm <number>.' "$WORDS" "$THRESHOLD")
+
+if command -v jq >/dev/null 2>&1; then
+  jq -nc --arg ctx "$ADDITIONAL" '{hookSpecificOutput:{hookEventName:"UserPromptSubmit",additionalContext:$ctx}}'
+else
+  ESCAPED=$(printf '%s' "$ADDITIONAL" | sed 's/\\/\\\\/g; s/"/\\"/g')
+  printf '{"hookSpecificOutput":{"hookEventName":"UserPromptSubmit","additionalContext":"%s"}}' "$ESCAPED"
+fi

package/hooks/session-label-nag.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+# UV Suite Hook: Nag user to label session if metadata.name is empty.
+# Event: UserPromptSubmit
+#
+# Reads the metadata file at .uv-suite-state/sessions/$UVS_SESSION_ID.json.
+# If the session has no name, injects an additionalContext nudge once every
+# Nth user prompt (default 3) so Claude reminds the user to run /session-init.
+# Skips when the prompt is itself a slash command.
+
+INPUT=$(cat)
+STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
+SESSIONS_DIR="$STATE_DIR/sessions"
+
+# Resolve session id: env first, then current-session pointer
+SID="${UVS_SESSION_ID:-}"
+if [ -z "$SID" ] && [ -f "$STATE_DIR/current-session.txt" ]; then
+  SID=$(cat "$STATE_DIR/current-session.txt" 2>/dev/null)
+fi
+
+[ -z "$SID" ] && exit 0
+META_FILE="$SESSIONS_DIR/$SID.json"
+[ ! -f "$META_FILE" ] && exit 0
+
+# Skip when the session already has a name
+if command -v jq >/dev/null 2>&1; then
+  NAME=$(jq -r '.name // ""' "$META_FILE" 2>/dev/null)
+else
+  NAME=$(grep -o '"name"[[:space:]]*:[[:space:]]*"[^"]*"' "$META_FILE" | head -1 | sed 's/.*"name"[[:space:]]*:[[:space:]]*"\(.*\)"/\1/')
+fi
+[ -n "$NAME" ] && exit 0
+
+# Skip when the user prompt is itself a slash command
+if command -v jq >/dev/null 2>&1; then
+  PROMPT=$(echo "$INPUT" | jq -r '.prompt // empty' 2>/dev/null)
+else
+  PROMPT=$(echo "$INPUT" | grep -o '"prompt":"[^"]*"' | head -1 | cut -d'"' -f4)
+fi
+case "$PROMPT" in
+  /*) exit 0 ;;
+esac
+
+# Rate-limit: nag every Nth prompt (default 3)
+INTERVAL="${UVS_LABEL_NAG_INTERVAL:-3}"
+COUNT_FILE="$SESSIONS_DIR/$SID.prompt-count"
+COUNT=$(cat "$COUNT_FILE" 2>/dev/null)
+[ -z "$COUNT" ] && COUNT=0
+COUNT=$((COUNT + 1))
+echo "$COUNT" > "$COUNT_FILE"
+
+# Nag on the 1st prompt and every Nth after
+REMAINDER=$((COUNT % INTERVAL))
+if [ "$COUNT" -ne 1 ] && [ "$REMAINDER" -ne 1 ]; then
+  exit 0
+fi
+
+MSG="[uv-suite] This session has no name yet. Briefly remind the user to run /session-init to set name, kind (long-running/outcome), purpose, and priority — these label the session in the watchtower dashboard. One sentence is enough; then proceed with the user's request."
+
+if command -v jq >/dev/null 2>&1; then
+  jq -nc --arg ctx "$MSG" '{hookSpecificOutput:{hookEventName:"UserPromptSubmit",additionalContext:$ctx}}'
+else
+  ESCAPED=$(printf '%s' "$MSG" | sed 's/\\/\\\\/g; s/"/\\"/g')
+  printf '{"hookSpecificOutput":{"hookEventName":"UserPromptSubmit","additionalContext":"%s"}}' "$ESCAPED"
+fi

package/hooks/session-meta.sh

@@ -0,0 +1,121 @@
+#!/bin/bash
+# UV Suite helper: read or write session metadata.
+# Used by the /session-init slash command.
+#
+# Usage:
+#   session-meta.sh show
+#   session-meta.sh clear
+#   session-meta.sh set-name     <free text...>
+#   session-meta.sh set-kind     long|outcome
+#   session-meta.sh set-purpose  <free text...>
+#   session-meta.sh set-priority low|med|high
+#
+# Reads/writes .uv-suite-state/sessions/$UVS_SESSION_ID.json under
+# $CLAUDE_PROJECT_DIR (falls back to current-session.txt pointer or a new
+# ad-hoc session if neither is available).
+
+STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
+SESSIONS_DIR="$STATE_DIR/sessions"
+mkdir -p "$SESSIONS_DIR"
+
+SID="${UVS_SESSION_ID:-}"
+if [ -z "$SID" ] && [ -f "$STATE_DIR/current-session.txt" ]; then
+  SID=$(cat "$STATE_DIR/current-session.txt" 2>/dev/null)
+fi
+if [ -z "$SID" ]; then
+  SID="ad-hoc-$(date +%s)"
+  echo "$SID" > "$STATE_DIR/current-session.txt"
+fi
+
+META="$SESSIONS_DIR/$SID.json"
+if [ ! -f "$META" ]; then
+  CWD_VAL="${CLAUDE_PROJECT_DIR:-$(pwd)}" SID_VAL="$SID" STARTED="$(date +%s)" python3 -c '
+import json, os
+print(json.dumps({
+  "uvs_session_id": os.environ["SID_VAL"],
+  "name": "", "kind": "", "purpose": "", "priority": "", "persona": "",
+  "cwd": os.environ["CWD_VAL"],
+  "started_at": int(os.environ["STARTED"]),
+}, indent=2))
+' > "$META"
+fi
+
+ACTION="$1"
+shift || true
+
+print_meta() {
+  META_PATH="$META" python3 - <<'PY'
+import json, os
+d = json.load(open(os.environ["META_PATH"]))
+sid = d.get("uvs_session_id", "")[:8]
+name     = d.get("name", "") or "(unset)"
+kind     = d.get("kind", "") or "(unset)"
+purpose  = d.get("purpose", "") or "(unset)"
+priority = d.get("priority", "") or "(unset)"
+persona  = d.get("persona", "") or "(unset)"
+print(f"session: {sid}")
+print(f"  name:     {name}")
+print(f"  kind:     {kind}")
+print(f"  purpose:  {purpose}")
+print(f"  priority: {priority}")
+print(f"  persona:  {persona}")
+PY
+}
+
+set_field() {
+  FIELD="$1" VAL="$2" META_PATH="$META" python3 - <<'PY'
+import json, os
+p = os.environ["META_PATH"]
+d = json.load(open(p))
+field = os.environ["FIELD"]
+d[field] = os.environ["VAL"]
+json.dump(d, open(p, "w"), indent=2)
+print(f"{field}: {d[field] or '(unset)'}")
+PY
+}
+
+case "$ACTION" in
+  ""|show)
+    print_meta
+    ;;
+  clear)
+    META_PATH="$META" python3 - <<'PY'
+import json, os
+p = os.environ["META_PATH"]
+d = json.load(open(p))
+for k in ("name", "kind", "purpose", "priority"):
+    d[k] = ""
+json.dump(d, open(p, "w"), indent=2)
+print("Cleared name, kind, purpose, priority.")
+PY
+    ;;
+  set-name)
+    set_field "name" "$*"
+    ;;
+  set-kind)
+    case "$1" in
+      l|long|long-running) VAL="long-running" ;;
+      o|outcome)           VAL="outcome" ;;
+      "")                  VAL="" ;;
+      *) echo "kind '$1' not recognized — use long or outcome"; exit 1 ;;
+    esac
+    set_field "kind" "$VAL"
+    ;;
+  set-purpose)
+    set_field "purpose" "$*"
+    ;;
+  set-priority)
+    case "$1" in
+      l|low)        VAL="low" ;;
+      m|med|medium) VAL="med" ;;
+      h|high)       VAL="high" ;;
+      "")           VAL="" ;;
+      *) echo "priority '$1' not recognized — use low, med, or high"; exit 1 ;;
+    esac
+    set_field "priority" "$VAL"
+    ;;
+  *)
+    echo "Usage: session-meta.sh [show|clear|set-name|set-kind|set-purpose|set-priority] [args]"
+    exit 1
+    ;;
+esac

package/hooks/session-start.sh

@@ -1,22 +1,50 @@
 #!/bin/bash
-# UV Suite Hook: Session start — record start time
+# UV Suite Hook: Session start — record start time, fire bootstrap event.
 # Event: SessionStart
 
 STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
-mkdir -p "$STATE_DIR"
+SESSIONS_DIR="$STATE_DIR/sessions"
+mkdir -p "$SESSIONS_DIR"
 
-# Record session start time
+# Per-cwd start timestamp (legacy — used by status-line for "today" totals)
 date +%s > "$STATE_DIR/session-start.txt"
 
-# Track today's total active time
 TODAY=$(date +%Y-%m-%d)
 TODAY_FILE="$STATE_DIR/active-$TODAY.txt"
-if [ ! -f "$TODAY_FILE" ]; then
-  echo "0" > "$TODAY_FILE"
+[ ! -f "$TODAY_FILE" ] && echo "0" > "$TODAY_FILE"
+
+# Resolve UVS session id (set by uv.sh; fall back to current-session pointer)
+SID="${UVS_SESSION_ID:-}"
+if [ -z "$SID" ] && [ -f "$STATE_DIR/current-session.txt" ]; then
+  SID=$(cat "$STATE_DIR/current-session.txt" 2>/dev/null)
+fi
+
+# Build a bootstrap payload that includes session metadata so the dashboard
+# learns about the session before any tool calls happen.
+INPUT=$(cat 2>/dev/null)
+[ -z "$INPUT" ] && INPUT='{}'
+
+PAYLOAD=""
+META_FILE=""
+[ -n "$SID" ] && META_FILE="$SESSIONS_DIR/$SID.json"
+
+if [ -n "$META_FILE" ] && [ -f "$META_FILE" ] && command -v jq >/dev/null 2>&1; then
+  PAYLOAD=$(echo "$INPUT" | jq -c --slurpfile m "$META_FILE" '
+    . + {
+      uvs_session_id: ($m[0].uvs_session_id // ""),
+      session_name:     ($m[0].name // ""),
+      session_kind:     ($m[0].kind // ""),
+      session_purpose:  ($m[0].purpose // ""),
+      session_priority: ($m[0].priority // ""),
+      persona:          ($m[0].persona // ""),
+      cwd:              (.cwd // $m[0].cwd // "")
+    }' 2>/dev/null)
+fi
+
+if [ -z "$PAYLOAD" ]; then
+  PAYLOAD=$(printf '{"uvs_session_id":"%s","cwd":"%s"}' "$SID" "${CLAUDE_PROJECT_DIR:-.}")
 fi
 
-# Send to watchtower
-echo '{"session_id":"'$(cat "$STATE_DIR/session-start.txt")'","cwd":"'${CLAUDE_PROJECT_DIR:-.}'"}' | \
-  "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/watchtower-send.sh" "SessionStart" 2>/dev/null
+echo "$PAYLOAD" | "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/watchtower-send.sh" "SessionStart" 2>/dev/null
 
 exit 0

package/hooks/status-line.sh

@@ -1,46 +1,71 @@
 #!/bin/bash
-# UV Suite Hook: Status line — show session duration and persona
+# UV Suite Hook: Status line — show session label, persona, duration.
 # Event: statusLine (rendered continuously)
 
 STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
+SESSIONS_DIR="$STATE_DIR/sessions"
 START_FILE="$STATE_DIR/session-start.txt"
 
-# Session duration
-if [ -f "$START_FILE" ]; then
+# Resolve UVS session id
+SID="${UVS_SESSION_ID:-}"
+if [ -z "$SID" ] && [ -f "$STATE_DIR/current-session.txt" ]; then
+  SID=$(cat "$STATE_DIR/current-session.txt" 2>/dev/null)
+fi
+META_FILE=""
+[ -n "$SID" ] && META_FILE="$SESSIONS_DIR/$SID.json"
+
+# Pull metadata fields if available
+NAME=""; PERSONA=""; PRIORITY=""; STARTED_AT=""
+if [ -n "$META_FILE" ] && [ -f "$META_FILE" ]; then
+  if command -v jq >/dev/null 2>&1; then
+    NAME=$(jq -r '.name // ""' "$META_FILE" 2>/dev/null)
+    PERSONA=$(jq -r '.persona // ""' "$META_FILE" 2>/dev/null)
+    PRIORITY=$(jq -r '.priority // ""' "$META_FILE" 2>/dev/null)
+    STARTED_AT=$(jq -r '.started_at // ""' "$META_FILE" 2>/dev/null)
+  fi
+fi
+
+# Session duration: prefer per-session started_at, fall back to per-cwd legacy file
+NOW=$(date +%s)
+START=""
+if [ -n "$STARTED_AT" ] && [ "$STARTED_AT" != "null" ]; then
+  START="$STARTED_AT"
+elif [ -f "$START_FILE" ]; then
   START=$(cat "$START_FILE")
-  NOW=$(date +%s)
+fi
+if [ -n "$START" ]; then
   ELAPSED=$((NOW - START))
   MINS=$((ELAPSED / 60))
-
-  if [ "$MINS" -ge 180 ]; then
-    SESSION="session ${MINS}m (!! take a break)"
-  elif [ "$MINS" -ge 90 ]; then
-    SESSION="session ${MINS}m (break soon)"
-  elif [ "$MINS" -ge 45 ]; then
-    SESSION="session ${MINS}m"
-  else
-    SESSION="session ${MINS}m"
-  fi
 else
-  SESSION="session 0m"
+  MINS=0
+fi
+
+if   [ "$MINS" -ge 180 ]; then SESSION="${MINS}m (!! take a break)"
+elif [ "$MINS" -ge 90 ];  then SESSION="${MINS}m (break soon)"
+else                           SESSION="${MINS}m"
 fi
 
-# Today's total active time
+# Today's total active time (per cwd)
 TODAY=$(date +%Y-%m-%d)
 TODAY_FILE="$STATE_DIR/active-$TODAY.txt"
+TODAY_STR=""
 if [ -f "$TODAY_FILE" ]; then
   TODAY_TOTAL=$(cat "$TODAY_FILE")
-  CURRENT_MINS=${MINS:-0}
-  TODAY_NOW=$((TODAY_TOTAL + CURRENT_MINS))
+  TODAY_NOW=$((TODAY_TOTAL + MINS))
   TODAY_STR=" · today ${TODAY_NOW}m"
-else
-  TODAY_STR=""
 fi
 
-# Persona from settings path (best-effort detection)
-PERSONA=""
-if [ -f "$CLAUDE_PROJECT_DIR/.claude/settings.local.json" ]; then
-  PERSONA=$(grep -o '"effort"[^,]*' "$CLAUDE_PROJECT_DIR/.claude/settings.local.json" 2>/dev/null | head -1)
+# Build label
+LABEL_PARTS=()
+if [ -n "$NAME" ] && [ "$NAME" != "null" ]; then
+  LABEL_PARTS+=("$NAME")
+else
+  LABEL_PARTS+=("(unlabeled)")
 fi
+[ -n "$PERSONA" ] && [ "$PERSONA" != "null" ] && LABEL_PARTS+=("[$PERSONA]")
+[ -n "$PRIORITY" ] && [ "$PRIORITY" != "null" ] && LABEL_PARTS+=("p:$PRIORITY")
+
+# Join with spaces
+LABEL_STR="${LABEL_PARTS[*]}"
 
-echo "UV Suite · $SESSION$TODAY_STR"
+echo "UV Suite · $LABEL_STR · ${SESSION}${TODAY_STR}"

package/hooks/watchtower-send.sh

@@ -1,34 +1,66 @@
 #!/bin/bash
-# UV Suite Hook Helper: Send event to Watchtower server
+# UV Suite Hook Helper: Send event to Watchtower server.
 # Called by other hooks or directly from persona hook config.
 # Non-blocking. Fails silently if server not running.
 #
 # Usage from hook config:
 #   "command": ".claude/hooks/watchtower-send.sh PostToolUse"
-# The hook input JSON comes via stdin from Claude Code.
+# Hook input JSON arrives via stdin from Claude Code.
+#
+# Merges UV Suite session metadata (name, kind, purpose, priority, persona)
+# from .uv-suite-state/sessions/$UVS_SESSION_ID.json into every payload so
+# the dashboard can group + label sessions.
 
 EVENT_TYPE="${1:-Unknown}"
 INPUT=$(cat)
 WATCHTOWER_URL="${UVS_WATCHTOWER_URL:-http://localhost:4200}"
 
-# Forward the full hook input to the watchtower, adding event_type and source_app
-# jq merges the original JSON with our extra fields
-PAYLOAD=$(echo "$INPUT" | jq -c ". + {
-  event_type: \"$EVENT_TYPE\",
-  source_app: (.cwd // \"\" | split(\"/\") | last),
-  _hook_ts: now
-}" 2>/dev/null)
+STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
+SESSIONS_DIR="$STATE_DIR/sessions"
+
+# Resolve UVS session id: env first, then current-session pointer
+SID="${UVS_SESSION_ID:-}"
+if [ -z "$SID" ] && [ -f "$STATE_DIR/current-session.txt" ]; then
+  SID=$(cat "$STATE_DIR/current-session.txt" 2>/dev/null)
+fi
+META_FILE=""
+[ -n "$SID" ] && META_FILE="$SESSIONS_DIR/$SID.json"
+
+PAYLOAD=""
+if command -v jq >/dev/null 2>&1; then
+  if [ -n "$META_FILE" ] && [ -f "$META_FILE" ]; then
+    PAYLOAD=$(echo "$INPUT" | jq -c --arg etype "$EVENT_TYPE" --slurpfile m "$META_FILE" '
+      . + {
+        event_type: $etype,
+        source_app: (.cwd // "" | split("/") | last),
+        uvs_session_id:   ($m[0].uvs_session_id // ""),
+        session_name:     ($m[0].name // ""),
+        session_kind:     ($m[0].kind // ""),
+        session_purpose:  ($m[0].purpose // ""),
+        session_priority: ($m[0].priority // ""),
+        persona:          ($m[0].persona // ""),
+        _hook_ts: now
+      }' 2>/dev/null)
+  else
+    PAYLOAD=$(echo "$INPUT" | jq -c --arg etype "$EVENT_TYPE" '
+      . + {
+        event_type: $etype,
+        source_app: (.cwd // "" | split("/") | last),
+        _hook_ts: now
+      }' 2>/dev/null)
+  fi
+fi
 
-# Fallback if jq isn't available or fails
+# Fallback when jq is missing or produced nothing usable
 if [ -z "$PAYLOAD" ] || [ "$PAYLOAD" = "null" ]; then
   SESSION_ID=$(echo "$INPUT" | grep -o '"session_id":"[^"]*"' | head -1 | cut -d'"' -f4)
   TOOL_NAME=$(echo "$INPUT" | grep -o '"tool_name":"[^"]*"' | head -1 | cut -d'"' -f4)
   CWD=$(echo "$INPUT" | grep -o '"cwd":"[^"]*"' | head -1 | cut -d'"' -f4)
   SOURCE_APP=$(basename "$CWD" 2>/dev/null)
-  PAYLOAD="{\"event_type\":\"$EVENT_TYPE\",\"session_id\":\"$SESSION_ID\",\"source_app\":\"$SOURCE_APP\",\"tool_name\":\"$TOOL_NAME\",\"cwd\":\"$CWD\"}"
+  PAYLOAD=$(printf '{"event_type":"%s","session_id":"%s","uvs_session_id":"%s","source_app":"%s","tool_name":"%s","cwd":"%s"}' \
+    "$EVENT_TYPE" "$SESSION_ID" "$SID" "$SOURCE_APP" "$TOOL_NAME" "$CWD")
 fi
 
-# Send to watchtower (non-blocking, fire-and-forget)
 curl -s -X POST "$WATCHTOWER_URL/events" \
   -H "Content-Type: application/json" \
   -d "$PAYLOAD" \

package/install.sh

@@ -102,7 +102,7 @@ cp "$UV_SUITE_DIR/agents/cursor/"*.mdc "$PROJECT_ROOT/.cursor/rules/"
 echo "  ✓ .cursor/rules/*.mdc installed"
 
 # --- Install skills (slash commands) ---
-echo "Installing 10 skills..."
+echo "Installing skills..."
 for skill_dir in "$UV_SUITE_DIR/skills/"*/; do
   skill_name=$(basename "$skill_dir")
   mkdir -p "$TARGET_DIR/skills/$skill_name"
@@ -110,7 +110,7 @@ for skill_dir in "$UV_SUITE_DIR/skills/"*/; do
 done
 echo "  ✓ /map-codebase, /spec, /architect, /review, /write-tests"
 echo "  ✓ /write-evals, /slop-check, /prototype, /security-review"
-echo "  ✓ /map-stack"
+echo "  ✓ /map-stack, /session-init"
 
 # --- Install hooks ---
 echo "Installing hook scripts..."
@@ -122,7 +122,9 @@ echo "  ✓ block-destructive.sh (PreToolUse: block rm -rf, force push, etc.)"
 echo "  ✓ session-start.sh (SessionStart: track session start time)"
 echo "  ✓ session-timer.sh (PostToolUse: warn at 45/90/180 min)"
 echo "  ✓ session-end.sh (Stop: reflection + duration + review reminder)"
-echo "  ✓ status-line.sh (statusLine: show session time continuously)"
+echo "  ✓ session-label-nag.sh (UserPromptSubmit: nudge to /session-init)"
+echo "  ✓ session-meta.sh (helper used by /session-init)"
+echo "  ✓ status-line.sh (statusLine: show session label + time)"
 echo "  + Real-time slop check (Haiku prompt hook, wired in settings.json)"
 
 # --- Install guardrail rules (Sport only) ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uv-suite",
-  "version": "0.26.1",
+  "version": "0.26.3",
   "description": "Portable framework for AI-assisted software development. 10 agents, 9 skills, 5 hooks, 4 personas. Works with Claude Code, Cursor, and Codex.",
   "author": "Utsav Anand",
   "license": "MIT",