uv-suite 0.26.1 → 0.26.3

package/skills/restore/SKILL.md

@@ -1,22 +1,55 @@
 ---
 name: restore
 description: >
-  Restore the latest checkpoint from a previous session. Shows what was done,
-  key decisions, current state, and what's next. Use at the start of a new session.
+  Restore the latest checkpoint for the current session — shows what was done,
+  key decisions, current state, and what's next. With no arguments, picks the
+  current `UVS_SESSION_ID`'s most recent checkpoint. Pass a session id prefix
+  or name to restore from a different session.
+argument-hint: "[<session-id-prefix> | <session-name> | list]"
 user-invocable: true
 allowed-tools:
   - Read(*)
   - Bash(ls *)
+  - Bash(cat *)
+  - Bash(grep *)
+  - Bash(find *)
+  - Bash(git rev-parse *)
+  - Bash("$CLAUDE_PROJECT_DIR"/.claude/hooks/checkpoint-helper.sh *)
 ---
 
-## Latest checkpoint
+## Available sessions with checkpoints
 
-!`cat uv-out/checkpoints/latest.md 2>/dev/null || echo "No checkpoint found. Run /checkpoint to create one."`
+!`"$CLAUDE_PROJECT_DIR"/.claude/hooks/checkpoint-helper.sh list`
 
-## All checkpoints
+(`*` marks the current session.)
 
-!`ls -la uv-out/checkpoints/*.md 2>/dev/null | tail -10 || echo "No checkpoints directory"`
+## Latest checkpoint for the current session
+
+!`"$CLAUDE_PROJECT_DIR"/.claude/hooks/checkpoint-helper.sh latest`
+
+## Argument
+
+$ARGUMENTS
 
 ## Instructions
 
-Read the checkpoint above. Summarize it to the user in 3-4 sentences: what was done, what's the current state, and what's next. Then ask: "Ready to pick up from here, or do you want to take a different direction?"
+1. **If `$ARGUMENTS` is empty or "latest"**: read the checkpoint shown above (the
+   current session's `latest.md`). Summarize it in 3-4 sentences: what was
+   done, current state, what's next. Then ask: "Ready to pick up from here, or
+   do you want to take a different direction?"
+
+2. **If `$ARGUMENTS` is "list"**: just show the user the available-sessions
+   list above and ask which one they want to restore.
+
+3. **If `$ARGUMENTS` looks like a session id prefix** (8-char hex / UUID-ish)
+   **or a session name**: match it against the list above. Read the
+   matching session's `latest.md` from
+   `<project>/uv-out/checkpoints/<full-session-id>/latest.md` using the Read
+   tool, then summarize as in (1).
+
+4. If no match is found, list the available sessions and ask the user to
+   pick one.
+
+When summarizing, include the session's name and purpose from the
+frontmatter at the top of the checkpoint — that's the context the next
+session needs to know what it's picking up.

package/skills/session-init/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: session-init
+description: >
+  Label or relabel the current UV Suite session — sets name, kind (long-running
+  vs outcome), purpose, and priority (low/med/high). Metadata appears in the
+  watchtower dashboard. Use when you skipped the launcher prompt or want to
+  rename a session mid-flight.
+argument-hint: "<name> | --kind long|outcome | --purpose <text> | --priority low|med|high | show | clear"
+user-invocable: true
+allowed-tools:
+  - Bash("$CLAUDE_PROJECT_DIR"/.claude/hooks/session-meta.sh *)
+---
+
+## Apply /session-init $ARGUMENTS
+
+!`HELPER="$CLAUDE_PROJECT_DIR/.claude/hooks/session-meta.sh"; ARGS="$ARGUMENTS"; if [ -z "$ARGS" ] || [ "$ARGS" = "show" ]; then "$HELPER" show; elif [ "$ARGS" = "clear" ]; then "$HELPER" clear; else FIRST=$(printf '%s' "$ARGS" | awk '{print $1}'); REST=$(printf '%s' "$ARGS" | sed 's/^[^ ]* *//'); case "$FIRST" in --kind) "$HELPER" set-kind "$REST" ;; --priority) "$HELPER" set-priority "$REST" ;; --purpose) "$HELPER" set-purpose "$REST" ;; --name) "$HELPER" set-name "$REST" ;; *) "$HELPER" set-name "$ARGS" ;; esac; fi`
+
+## Instructions
+
+Show the user the output of the command above. Do not add commentary — the
+command itself confirms what changed. The dashboard reflects changes within
+a few seconds (next event refreshes session metadata).
+
+## Usage
+
+```
+/session-init                                  show current values
+/session-init show                             show current values
+/session-init <free-text name>                 set the name (default action)
+/session-init --kind long                      set kind: long-running
+/session-init --kind outcome                   set kind: outcome
+/session-init --priority high                  set priority: low | med | high
+/session-init --purpose <free text>            set the purpose
+/session-init clear                            clear name, kind, purpose, priority
+```
+
+## Notes
+
+- The session id is generated by `uv.sh` at launch and exported as
+  `UVS_SESSION_ID`. If you launched `claude` directly, this falls back
+  to an `ad-hoc-<timestamp>` id.
+- Metadata lives at `.uv-suite-state/sessions/<id>.json`.
+- Persona is captured at launch time and is not editable from here —
+  re-launch with a different `uv` persona to change it.
+- Each invocation sets one field at a time. Run multiple times to set more.

package/uv.sh

@@ -41,6 +41,12 @@ case "$1" in
     echo "    pro      Production code (all hooks, all guardrails)"
     echo "    auto     Fully autonomous (max effort, everything approved)"
     echo ""
+    echo "  Session metadata:"
+    echo "    On launch you'll be prompted for name, kind, purpose, and"
+    echo "    priority. Press Enter to skip any field; you'll be reminded"
+    echo "    until the session is named. Use /session-init to relabel."
+    echo "    Set UVS_NO_PROMPT=1 to suppress prompts entirely."
+    echo ""
     exit 0
     ;;
   "")
@@ -73,6 +79,76 @@ case "$PERSONA" in
   auto)         LABEL="Auto — autonomous (max, everything approved)" ;;
 esac
 
+# --- Session metadata: generate id and prompt for label ---
+PROJECT_DIR="$(pwd)"
+STATE_DIR="$PROJECT_DIR/.uv-suite-state"
+SESSIONS_DIR="$STATE_DIR/sessions"
+mkdir -p "$SESSIONS_DIR"
+
+if command -v uuidgen >/dev/null 2>&1; then
+  UVS_SESSION_ID=$(uuidgen | tr '[:upper:]' '[:lower:]')
+else
+  UVS_SESSION_ID="uvs-$(date +%s)-$$"
+fi
+export UVS_SESSION_ID
+
+UVS_NAME=""
+UVS_KIND=""
+UVS_PURPOSE=""
+UVS_PRIORITY=""
+
+# Prompt only if attached to a TTY and not explicitly suppressed
+if [ -t 0 ] && [ -z "$UVS_NO_PROMPT" ]; then
+  echo ""
+  echo "Label this session (Enter to skip — you'll be reminded):"
+  read -r -p "  name:                     " UVS_NAME
+  read -r -p "  kind [long/outcome]:      " UVS_KIND_RAW
+  read -r -p "  purpose:                  " UVS_PURPOSE
+  read -r -p "  priority [low/med/high]:  " UVS_PRIORITY_RAW
+
+  case "$UVS_KIND_RAW" in
+    l|long|long-running) UVS_KIND="long-running" ;;
+    o|outcome)           UVS_KIND="outcome" ;;
+    "")                  UVS_KIND="" ;;
+    *) echo "  (kind '$UVS_KIND_RAW' not recognized — leaving blank)"; UVS_KIND="" ;;
+  esac
+
+  case "$UVS_PRIORITY_RAW" in
+    l|low)        UVS_PRIORITY="low" ;;
+    m|med|medium) UVS_PRIORITY="med" ;;
+    h|high)       UVS_PRIORITY="high" ;;
+    "")           UVS_PRIORITY="" ;;
+    *) echo "  (priority '$UVS_PRIORITY_RAW' not recognized — leaving blank)"; UVS_PRIORITY="" ;;
+  esac
+fi
+
+# Write metadata as JSON. Use python3 for proper escaping of free-text fields.
+META_FILE="$SESSIONS_DIR/$UVS_SESSION_ID.json"
+SID="$UVS_SESSION_ID" \
+NAME="$UVS_NAME" \
+KIND="$UVS_KIND" \
+PURPOSE="$UVS_PURPOSE" \
+PRIORITY="$UVS_PRIORITY" \
+PERSONA_VAL="$PERSONA" \
+CWD_VAL="$PROJECT_DIR" \
+STARTED="$(date +%s)" \
+python3 -c '
+import json, os
+print(json.dumps({
+    "uvs_session_id": os.environ["SID"],
+    "name": os.environ["NAME"],
+    "kind": os.environ["KIND"],
+    "purpose": os.environ["PURPOSE"],
+    "priority": os.environ["PRIORITY"],
+    "persona": os.environ["PERSONA_VAL"],
+    "cwd": os.environ["CWD_VAL"],
+    "started_at": int(os.environ["STARTED"]),
+}, indent=2))
+' > "$META_FILE" 2>/dev/null
+
+# Latest-session pointer (used by hooks that lack UVS_SESSION_ID in their env)
+echo "$UVS_SESSION_ID" > "$STATE_DIR/current-session.txt"
+
 SETTINGS=".claude/personas/$PERSONA.json"
 
 if [ "$TOOL" = "claude" ]; then
@@ -87,7 +163,9 @@ if [ "$TOOL" = "claude" ]; then
     exit 1
   fi
 
+  echo ""
   echo "UV Suite | Claude Code | $LABEL"
+  echo "Session: ${UVS_SESSION_ID:0:8}${UVS_NAME:+ — $UVS_NAME}"
   echo ""
   exec claude --settings "$SETTINGS" "$@"
 
@@ -99,24 +177,16 @@ elif [ "$TOOL" = "codex" ]; then
     exit 1
   fi
 
-  # Codex doesn't have --settings, but reads AGENTS.md and .codex/agents/
-  # We can pass model and approval mode based on persona
   case "$PERSONA" in
-    spike)
-      CODEX_ARGS="--model o3 --approval-mode suggest"
-      ;;
-    sport)
-      CODEX_ARGS="--approval-mode auto-edit"
-      ;;
-    professional)
-      CODEX_ARGS="--approval-mode suggest"
-      ;;
-    auto)
-      CODEX_ARGS="--approval-mode full-auto"
-      ;;
+    spike)        CODEX_ARGS="--model o3 --approval-mode suggest" ;;
+    sport)        CODEX_ARGS="--approval-mode auto-edit" ;;
+    professional) CODEX_ARGS="--approval-mode suggest" ;;
+    auto)         CODEX_ARGS="--approval-mode full-auto" ;;
   esac
 
+  echo ""
   echo "UV Suite | Codex | $LABEL"
+  echo "Session: ${UVS_SESSION_ID:0:8}${UVS_NAME:+ — $UVS_NAME}"
   echo ""
   exec codex $CODEX_ARGS "$@"
 fi

package/watchtower/dashboard.html

@@ -279,6 +279,42 @@
   .event.user-prompt { background: var(--user-prompt-bg); }
   .event.user-prompt .detail { color: var(--user-prompt-text); font-style: italic; }
 
+  /* Session priority: low rows are dimmed, high rows get an accent strip */
+  .event.priority-low { opacity: 0.45; }
+  .event.priority-low:hover { opacity: 0.85; }
+  .event.priority-high { border-left: 3px solid var(--accent); padding-left: 25px; }
+
+  /* Pills shown next to a session label */
+  .pill {
+    display: inline-block;
+    padding: 1px 7px;
+    margin-left: 6px;
+    font-size: 10.5px;
+    font-weight: 600;
+    letter-spacing: 0.04em;
+    text-transform: uppercase;
+    border-radius: 4px;
+    vertical-align: 1px;
+  }
+  .pill.persona-spike        { background: rgba(191, 90, 242, 0.18); color: var(--purple); }
+  .pill.persona-sport        { background: rgba(48, 209, 88, 0.18);  color: var(--success); }
+  .pill.persona-professional { background: rgba(10, 132, 255, 0.18); color: var(--accent); }
+  .pill.persona-auto         { background: rgba(255, 159, 10, 0.18); color: var(--warning); }
+  .pill.priority-low  { background: rgba(154, 154, 163, 0.18); color: var(--text-muted); }
+  .pill.priority-med  { background: rgba(255, 214, 10, 0.18);  color: var(--yellow); }
+  .pill.priority-high { background: rgba(255, 69, 58, 0.18);   color: var(--danger); }
+  .pill.kind-long-running { background: rgba(100, 210, 255, 0.18); color: var(--info); }
+  .pill.kind-outcome      { background: rgba(255, 105, 97, 0.18);  color: var(--peach); }
+
+  .session-tag.priority-low  { opacity: 0.6; }
+  .session-tag .meta-line {
+    display: block;
+    font-size: 11px;
+    font-weight: 400;
+    color: var(--text-muted);
+    margin-top: 2px;
+  }
+
   .timeline-end { padding: 20px 24px; text-align: center; border-bottom: 1px solid var(--border-subtle); }
   .loader { display: inline-block; width: 48px; height: 4px; position: relative; }
   .loader::before {
@@ -393,9 +429,21 @@ let lastEventDiv = null;
 // Session colors and naming
 const palette = ['#0a84ff','#30d158','#ff9f0a','#bf5af2','#ff375f','#64d2ff','#ffd60a','#ac8ee0','#ff6961','#5e5ce6'];
 let colorIdx = 0;
+
+// Resolve the canonical session key for an event: prefer the UV Suite id (one
+// per `uv` launch), fall back to Claude Code's session id, then source_app.
+function eventSid(ev) {
+  return ev.uvs_session_id || ev.session_id || ev.source_app || 'unknown';
+}
+
 function sessionColor(id) {
   if (!sessions[id]) {
-    sessions[id] = { color: palette[colorIdx++ % palette.length], count: 0, lastEvent: null, label: null, app: null };
+    sessions[id] = {
+      color: palette[colorIdx++ % palette.length],
+      count: 0, lastEvent: null,
+      name: '', kind: '', purpose: '', priority: '', persona: '',
+      app: null, label: null,
+    };
     updateSessionBar();
     updateFilterSession();
   }
@@ -406,33 +454,54 @@ function sessionColor(id) {
 
 function updateSessionLabel(sid, ev) {
   if (!sessions[sid]) return;
-  if (!sessions[sid].app && ev.source_app) {
-    sessions[sid].app = ev.source_app;
+  const s = sessions[sid];
+  let changed = false;
+
+  if (!s.app && ev.source_app) { s.app = ev.source_app; changed = true; }
+
+  // Configured metadata wins over heuristics. Update on every event so a
+  // mid-session /session-init relabel is reflected without a refresh.
+  for (const [evKey, sKey] of [
+    ['session_name','name'], ['session_kind','kind'],
+    ['session_purpose','purpose'], ['session_priority','priority'],
+    ['persona','persona'],
+  ]) {
+    if (ev[evKey] !== undefined && ev[evKey] !== null && ev[evKey] !== s[sKey]) {
+      s[sKey] = ev[evKey];
+      changed = true;
+    }
   }
-  // Use first UserPromptSubmit as session label
+
+  // Fall back to first UserPromptSubmit if no configured name yet
   const type = ev.event_type || ev.hook_event_name || '';
-  if (!sessions[sid].label && type === 'UserPromptSubmit') {
+  if (!s.name && !s.label && type === 'UserPromptSubmit') {
     const prompt = ev.tool_input?.prompt || ev.tool_input?.content || ev.message || '';
     if (prompt.length > 0) {
       let label = prompt.slice(0, 45).replace(/\s+\S*$/, '');
       if (prompt.length > label.length) label += '...';
-      sessions[sid].label = label;
-      updateSessionBar();
-      updateFilterSession();
+      s.label = label;
+      changed = true;
     }
   }
+
+  if (changed) {
+    updateSessionBar();
+    updateFilterSession();
+  }
 }
 
 function sessionDisplayName(id) {
   const s = sessions[id];
   if (!s) return shortId(id);
-  if (s.label) {
-    return s.app ? s.app + ': ' + s.label : s.label;
-  }
+  if (s.name) return s.name;
+  if (s.label) return s.app ? s.app + ': ' + s.label : s.label;
   if (s.app) return s.app;
   return shortId(id);
 }
 
+// Sort order: high → med → unset → low (low last so it groups at the bottom)
+const PRIORITY_ORDER = { high: 0, med: 1, '': 2, low: 3 };
+
 function shortId(id) {
   if (!id) return '—';
   return id.length > 10 ? id.slice(0, 8) + '..' : id;
@@ -526,7 +595,7 @@ function eventDetail(ev) {
 }
 
 function renderEvent(ev) {
-  const sid = ev.session_id || ev.source_app || 'unknown';
+  const sid = eventSid(ev);
   const color = sessionColor(sid);
   const type = ev.event_type || ev.hook_event_name || '?';
   const tool = ev.tool_name || '';
@@ -534,6 +603,7 @@ function renderEvent(ev) {
   const fail = isFailure(ev);
   const boundary = isSessionBoundary(ev);
   const prompt = isUserPrompt(ev);
+  const priority = sessions[sid]?.priority || '';
 
   const div = document.createElement('div');
   let cls = 'event';
@@ -541,6 +611,8 @@ function renderEvent(ev) {
   else if (fail) cls += ' failure';
   else if (prompt) cls += ' user-prompt';
   else if (boundary) cls += ' session-boundary';
+  if (priority === 'high') cls += ' priority-high';
+  if (priority === 'low')  cls += ' priority-low';
   div.className = cls;
 
   const humanBadge = human ? '<span class="human-badge">NEEDS HUMAN</span>' : '';
@@ -567,7 +639,9 @@ function renderEvent(ev) {
 function addEvent(ev) {
   events.push(ev);
   if (emptyState.parentNode) emptyState.remove();
-  const sid = ev.session_id || ev.source_app || 'unknown';
+  const sid = eventSid(ev);
+  // Make sure the session is registered before we try to update its metadata
+  sessionColor(sid);
   updateSessionLabel(sid, ev);
 
   // Remove "latest" class from previous latest
@@ -592,7 +666,7 @@ function addEvent(ev) {
 
 function updateWaitingText(ev) {
   if (ev) {
-    const sid = ev.session_id || ev.source_app || 'unknown';
+    const sid = eventSid(ev);
     waitingText.textContent = `Last: ${sessionDisplayName(sid)} — ${timeSince(ev._ts)}`;
   }
 }
@@ -613,7 +687,7 @@ function updateStats() {
   // number drops back down once the session continues past the prompt.
   const latestBySession = {};
   for (const ev of events) {
-    const sid = ev.session_id || ev.source_app || 'unknown';
+    const sid = eventSid(ev);
     latestBySession[sid] = ev;
   }
   const humans = Object.values(latestBySession).filter(needsHuman).length;
@@ -621,15 +695,46 @@ function updateStats() {
   document.getElementById('humanCount').className = 'n' + (humans > 0 ? ' alert' : '');
 }
 
+function escapeHtml(s) {
+  return String(s).replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
+}
+
+function pill(cls, label) {
+  return `<span class="pill ${cls}">${escapeHtml(label)}</span>`;
+}
+
 function updateSessionBar() {
   sessionBar.innerHTML = '';
-  for (const [id, s] of Object.entries(sessions)) {
+  // Sort: high priority first, then med/unset, then low; within a tier, most
+  // recent activity wins so the dashboard surfaces what's happening now.
+  const ids = Object.keys(sessions).sort((a, b) => {
+    const pa = PRIORITY_ORDER[sessions[a].priority] ?? PRIORITY_ORDER[''];
+    const pb = PRIORITY_ORDER[sessions[b].priority] ?? PRIORITY_ORDER[''];
+    if (pa !== pb) return pa - pb;
+    return (sessions[b].lastEvent || 0) - (sessions[a].lastEvent || 0);
+  });
+
+  for (const id of ids) {
+    const s = sessions[id];
     const tag = document.createElement('span');
-    tag.className = 'session-tag' + (selectedSession === id ? ' active' : '');
+    let cls = 'session-tag';
+    if (selectedSession === id) cls += ' active';
+    if (s.priority === 'low')   cls += ' priority-low';
+    tag.className = cls;
     tag.style.background = s.color + '22';
     tag.style.color = s.color;
-    tag.textContent = sessionDisplayName(id) + ' (' + s.count + ')';
-    tag.title = id;
+    tag.title = `${id}${s.purpose ? '\n' + s.purpose : ''}`;
+
+    const pills = [];
+    if (s.persona)  pills.push(pill('persona-' + s.persona, s.persona));
+    if (s.priority) pills.push(pill('priority-' + s.priority, 'P:' + s.priority));
+    if (s.kind)     pills.push(pill('kind-' + s.kind, s.kind));
+
+    const namePart = `<strong>${escapeHtml(sessionDisplayName(id))}</strong>` +
+                     ` <span style="opacity:0.7">(${s.count})</span>`;
+    const meta = pills.length ? `<span class="meta-line">${pills.join('')}</span>` : '';
+    tag.innerHTML = namePart + meta;
+
     tag.onclick = () => { selectedSession = selectedSession === id ? '' : id; refilter(); updateSessionBar(); };
     sessionBar.appendChild(tag);
   }
@@ -662,7 +767,7 @@ function refilter() {
   rows.forEach((row) => {
     const ev = row._ev;
     if (!ev) return;
-    const sid = ev.session_id || ev.source_app || 'unknown';
+    const sid = eventSid(ev);
     const type = ev.event_type || ev.hook_event_name || '';
     const show = (!selectedType || type === selectedType)
               && (!selectedSession || sid === selectedSession)

package/watchtower/events.json

@@ -1,22 +1 @@
-[
-  {
-    "event_type": "PostToolUse",
-    "session_id": "test-123",
-    "source_app": "uv-suite",
-    "tool_name": "Edit",
-    "cwd": "/tmp",
-    "_ts": 1776756371726,
-    "_id": "3f130976-6226-47ea-a477-18a16e194415"
-  },
-  {
-    "event_type": "PostToolUse",
-    "session_id": "test-session",
-    "source_app": "my-project",
-    "tool_name": "Edit",
-    "tool_input": {
-      "file_path": "src/app.ts"
-    },
-    "_ts": 1776757586012,
-    "_id": "efa9ae75-c0e0-48c2-a078-e7075ccef5a7"
-  }
-]
+[]