uv-suite 0.26.5 → 0.28.0

package/hooks/auto-checkpoint-helper.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+# UV Suite helper: read or change auto-checkpoint settings.
+# Used by the /auto-checkpoint slash command.
+#
+# Usage:
+#   auto-checkpoint-helper.sh status
+#   auto-checkpoint-helper.sh on
+#   auto-checkpoint-helper.sh off
+#   auto-checkpoint-helper.sh <minutes>     # set interval
+
+STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
+mkdir -p "$STATE_DIR"
+STATE_FILE="$STATE_DIR/auto-checkpoint.json"
+
+ensure_state() {
+  [ -f "$STATE_FILE" ] && return
+  cat > "$STATE_FILE" <<'EOF'
+{
+  "mode": "on",
+  "interval_minutes": 10
+}
+EOF
+}
+
+get_field() {
+  ensure_state
+  STATE_PATH="$STATE_FILE" KEY="$1" python3 -c '
+import json, os
+d = json.load(open(os.environ["STATE_PATH"]))
+print(d.get(os.environ["KEY"], ""))
+'
+}
+
+set_field() {
+  ensure_state
+  STATE_PATH="$STATE_FILE" KEY="$1" VAL="$2" python3 -c '
+import json, os
+p = os.environ["STATE_PATH"]
+d = json.load(open(p))
+key = os.environ["KEY"]
+val = os.environ["VAL"]
+if key == "interval_minutes":
+    val = int(val)
+d[key] = val
+json.dump(d, open(p, "w"), indent=2)
+'
+}
+
+ARG=$(printf '%s' "$1" | tr -d '[:space:]')
+
+case "$ARG" in
+  on)
+    set_field mode on
+    echo "Auto-checkpoint: ON (every $(get_field interval_minutes) min, mechanical + semantic)"
+    ;;
+  off)
+    set_field mode off
+    echo "Auto-checkpoint: OFF"
+    ;;
+  ""|status)
+    ensure_state
+    echo "Auto-checkpoint: $(get_field mode) (every $(get_field interval_minutes) min)"
+    ;;
+  *)
+    if printf '%s' "$ARG" | grep -qE '^[0-9]+$' && [ "$ARG" -ge 1 ] && [ "$ARG" -le 1440 ]; then
+      set_field interval_minutes "$ARG"
+      echo "Auto-checkpoint interval: $ARG min (mode: $(get_field mode))"
+    else
+      echo "Usage: /auto-checkpoint [on | off | <minutes 1-1440> | status]"
+      exit 1
+    fi
+    ;;
+esac

package/hooks/auto-checkpoint.sh

@@ -0,0 +1,184 @@
+#!/bin/bash
+# UV Suite Hook: Tier A auto-checkpoint — mechanical state snapshot.
+# Event: PostToolUse
+#
+# Logs every tool call into a per-session activity log. When `interval_minutes`
+# have passed since the last mechanical checkpoint AND there has been activity
+# in the interval, writes a deterministic snapshot to
+# uv-out/checkpoints/<sid>/auto-<ts>-mechanical.md and forwards an
+# AutoCheckpoint event to the watchtower.
+#
+# Tier B (semantic, claude -p) runs separately from the watchtower's timer.
+
+INPUT=$(cat 2>/dev/null || true)
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+STATE_DIR="$PROJECT_DIR/.uv-suite-state"
+SESSIONS_DIR="$STATE_DIR/sessions"
+mkdir -p "$SESSIONS_DIR" 2>/dev/null
+
+STATE_FILE="$STATE_DIR/auto-checkpoint.json"
+
+# Default state if missing
+if [ ! -f "$STATE_FILE" ]; then
+  cat > "$STATE_FILE" <<'EOF'
+{
+  "mode": "on",
+  "interval_minutes": 10
+}
+EOF
+fi
+
+# Read mode + interval (skip if mode != on)
+read_state() {
+  STATE_PATH="$STATE_FILE" python3 -c '
+import json, os, sys
+try:
+    d = json.load(open(os.environ["STATE_PATH"]))
+    print(d.get("mode", "on"))
+    print(d.get("interval_minutes", 10))
+except Exception:
+    print("on"); print("10")
+' 2>/dev/null
+}
+
+STATE_OUT=$(read_state)
+MODE=$(echo "$STATE_OUT" | sed -n 1p)
+INTERVAL_MIN=$(echo "$STATE_OUT" | sed -n 2p)
+[ "$MODE" != "on" ] && exit 0
+[ -z "$INTERVAL_MIN" ] && INTERVAL_MIN=10
+
+# Resolve 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
+[ -z "$SID" ] && exit 0
+
+ACTIVITY_LOG="$SESSIONS_DIR/$SID.activity.log"
+LAST_CP_FILE="$SESSIONS_DIR/$SID.last-mechanical-checkpoint.txt"
+NOW=$(date +%s)
+
+# Append activity entry. Cap log at last 500 lines.
+TOOL=""
+TARGET=""
+if command -v jq >/dev/null 2>&1; then
+  TOOL=$(echo "$INPUT" | jq -r '.tool_name // ""' 2>/dev/null)
+  TARGET=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.command // .tool_input.pattern // .tool_input.url // ""' 2>/dev/null)
+fi
+TARGET=$(printf '%s' "$TARGET" | tr -d '\n' | cut -c1-120)
+[ -n "$TOOL" ] && echo "$NOW $TOOL $TARGET" >> "$ACTIVITY_LOG"
+if [ -f "$ACTIVITY_LOG" ]; then
+  LINES=$(wc -l < "$ACTIVITY_LOG" 2>/dev/null | tr -d ' ')
+  if [ -n "$LINES" ] && [ "$LINES" -gt 500 ]; then
+    tail -n 500 "$ACTIVITY_LOG" > "$ACTIVITY_LOG.tmp" && mv "$ACTIVITY_LOG.tmp" "$ACTIVITY_LOG"
+  fi
+fi
+
+# Has the interval passed since last mechanical checkpoint?
+# On the very first run, seed the timestamp with NOW so we don't fire a
+# checkpoint immediately — the first one fires after the interval has elapsed.
+if [ ! -f "$LAST_CP_FILE" ]; then
+  echo "$NOW" > "$LAST_CP_FILE"
+  exit 0
+fi
+LAST_CP=$(cat "$LAST_CP_FILE" 2>/dev/null)
+LAST_CP=${LAST_CP:-0}
+ELAPSED=$((NOW - LAST_CP))
+INTERVAL_SEC=$((INTERVAL_MIN * 60))
+[ "$ELAPSED" -lt "$INTERVAL_SEC" ] && exit 0
+
+# Activity since last checkpoint? If none, skip.
+SINCE_LINES=0
+if [ -f "$ACTIVITY_LOG" ]; then
+  SINCE_LINES=$(awk -v cutoff="$LAST_CP" '$1 > cutoff' "$ACTIVITY_LOG" 2>/dev/null | wc -l | tr -d ' ')
+fi
+[ "${SINCE_LINES:-0}" -lt 1 ] && exit 0
+
+# Resolve checkpoint dir + metadata via the existing helper
+CP_DIR=$(CLAUDE_PROJECT_DIR="$PROJECT_DIR" "$PROJECT_DIR/.claude/hooks/checkpoint-helper.sh" dir 2>/dev/null)
+[ -z "$CP_DIR" ] && CP_DIR="$PROJECT_DIR/uv-out/checkpoints/$SID" && mkdir -p "$CP_DIR"
+
+# Build the mechanical checkpoint body
+TS_FILE=$(date +%Y-%m-%d-%H%M)
+TS_ISO=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+CP_FILE="$CP_DIR/auto-$TS_FILE-mechanical.md"
+
+# Frontmatter from helper, augmented with checkpoint_kind
+FRONT=$(CLAUDE_PROJECT_DIR="$PROJECT_DIR" "$PROJECT_DIR/.claude/hooks/checkpoint-helper.sh" frontmatter 2>/dev/null)
+# Insert checkpoint_kind: auto-mechanical before closing ---
+FRONT=$(printf '%s' "$FRONT" | awk '
+  /^---$/ { count++ }
+  count == 2 && !done { print "checkpoint_kind: auto-mechanical"; done=1 }
+  { print }
+')
+
+# Activity summary from the log
+ACTIVITY_SUMMARY=$(awk -v cutoff="$LAST_CP" '$1 > cutoff' "$ACTIVITY_LOG" 2>/dev/null | python3 -c '
+import sys, collections, os
+lines = [l.strip() for l in sys.stdin if l.strip()]
+tools = collections.Counter()
+files = collections.Counter()
+for ln in lines:
+    parts = ln.split(" ", 2)
+    if len(parts) < 2: continue
+    tool = parts[1]
+    target = parts[2] if len(parts) > 2 else ""
+    tools[tool] += 1
+    if target and tool in ("Edit", "Write", "Read"):
+        files[target] += 1
+print("### Tool calls")
+for t, n in tools.most_common(8):
+    print(f"- {n}× {t}")
+if files:
+    print("\n### Files touched")
+    for f, n in files.most_common(8):
+        print(f"- {f} ({n})")
+print(f"\n_total tool calls in window: {sum(tools.values())}_")
+' 2>/dev/null)
+
+# Git state (best-effort, may be absent in non-git dirs)
+GIT_BRANCH=$(cd "$PROJECT_DIR" && git branch --show-current 2>/dev/null)
+GIT_STATUS=$(cd "$PROJECT_DIR" && git status --short 2>/dev/null | head -20)
+GIT_LOG=$(cd "$PROJECT_DIR" && git log --oneline -5 2>/dev/null)
+
+{
+  printf '%s\n\n' "$FRONT"
+  printf '# Auto-checkpoint (mechanical): %s\n\n' "$TS_ISO"
+  printf '_window: last %s min, %s tool calls_\n\n' "$INTERVAL_MIN" "$SINCE_LINES"
+  printf '## Activity\n\n%s\n\n' "$ACTIVITY_SUMMARY"
+  if [ -n "$GIT_BRANCH" ]; then
+    printf '## Git\n\n'
+    printf '**Branch:** %s\n\n' "$GIT_BRANCH"
+    if [ -n "$GIT_STATUS" ]; then
+      printf '**Status:**\n```\n%s\n```\n\n' "$GIT_STATUS"
+    else
+      printf '**Status:** clean\n\n'
+    fi
+    if [ -n "$GIT_LOG" ]; then
+      printf '**Recent commits:**\n```\n%s\n```\n' "$GIT_LOG"
+    fi
+  fi
+} > "$CP_FILE"
+
+# Update latest.md so /restore picks it up
+cp "$CP_FILE" "$CP_DIR/latest.md" 2>/dev/null
+echo "$NOW" > "$LAST_CP_FILE"
+
+# Send AutoCheckpoint event to watchtower with inline content
+if [ -x "$PROJECT_DIR/.claude/hooks/watchtower-send.sh" ]; then
+  PREVIEW=$(head -c 2000 "$CP_FILE")
+  PAYLOAD=$(PREVIEW_PATH="$CP_FILE" PREVIEW="$PREVIEW" INTERVAL_MIN="$INTERVAL_MIN" SINCE_LINES="$SINCE_LINES" CWD_VAR="$PROJECT_DIR" python3 -c '
+import json, os
+print(json.dumps({
+    "checkpoint_kind": "auto-mechanical",
+    "checkpoint_path": os.environ["PREVIEW_PATH"],
+    "checkpoint_preview": os.environ["PREVIEW"],
+    "interval_minutes": int(os.environ["INTERVAL_MIN"]),
+    "tool_calls_in_window": int(os.environ["SINCE_LINES"]),
+    "cwd": os.environ["CWD_VAR"],
+}))
+' 2>/dev/null)
+  printf '%s' "$PAYLOAD" | CLAUDE_PROJECT_DIR="$PROJECT_DIR" "$PROJECT_DIR/.claude/hooks/watchtower-send.sh" AutoCheckpoint 2>/dev/null
+fi
+
+exit 0

package/hooks/confirm-helper.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+# UV Suite helper: toggle confirm-mode or change the threshold.
+# Used by the /confirm slash command. Extracted into a script so the
+# slash command can avoid inline ${...} expansions, which Claude Code's
+# permission heuristic flags as obfuscation.
+#
+# Usage:
+#   confirm-helper.sh           # show status
+#   confirm-helper.sh status
+#   confirm-helper.sh on
+#   confirm-helper.sh off
+#   confirm-helper.sh <number>  # set threshold
+
+STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
+mkdir -p "$STATE_DIR"
+MODE_FILE="$STATE_DIR/confirm-mode.txt"
+THRESH_FILE="$STATE_DIR/confirm-threshold.txt"
+
+current_mode() { cat "$MODE_FILE" 2>/dev/null || echo "on"; }
+current_thresh() { cat "$THRESH_FILE" 2>/dev/null || echo "50"; }
+
+ARG=$(printf '%s' "$1" | tr -d '[:space:]')
+
+case "$ARG" in
+  on)
+    echo "on" > "$MODE_FILE"
+    echo "Confirm mode: ON (threshold: $(current_thresh) words)"
+    ;;
+  off)
+    echo "off" > "$MODE_FILE"
+    echo "Confirm mode: OFF"
+    ;;
+  ""|status)
+    echo "Confirm mode: $(current_mode) (threshold: $(current_thresh) words)"
+    ;;
+  *)
+    if printf '%s' "$ARG" | grep -qE '^[0-9]+$'; then
+      echo "$ARG" > "$THRESH_FILE"
+      echo "Threshold set to $ARG words (mode: $(current_mode))"
+    else
+      echo "Usage: /confirm [on | off | <number> | status]"
+      exit 1
+    fi
+    ;;
+esac

package/hooks/session-end-helper.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+# UV Suite helper: explicit session termination.
+# Used by the /session-end slash command.
+#
+# Writes a "terminated_at" timestamp to the session metadata, fires a
+# SessionEnd event to the Watchtower so the dashboard updates the status
+# badge, and prints a one-line confirmation.
+
+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
+  echo "No active UV Suite session to end."
+  exit 1
+fi
+
+META="$SESSIONS_DIR/$SID.json"
+NOW=$(date +%s)
+NOW_ISO=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+if [ -f "$META" ]; then
+  META_PATH="$META" NOW_VAL="$NOW" NOW_ISO_VAL="$NOW_ISO" python3 - <<'PY'
+import json, os
+p = os.environ["META_PATH"]
+d = json.load(open(p))
+d["terminated_at"] = int(os.environ["NOW_VAL"])
+d["terminated_at_iso"] = os.environ["NOW_ISO_VAL"]
+d["lifecycle"] = "terminated"
+json.dump(d, open(p, "w"), indent=2)
+PY
+fi
+
+# Fire SessionEnd event so the dashboard flips the status badge to Terminated.
+if [ -x "$CLAUDE_PROJECT_DIR/.claude/hooks/watchtower-send.sh" ]; then
+  PAYLOAD=$(SID_VAL="$SID" NOW_VAL="$NOW" CWD_VAL="${CLAUDE_PROJECT_DIR:-$(pwd)}" python3 -c '
+import json, os
+print(json.dumps({
+    "uvs_session_id": os.environ["SID_VAL"],
+    "session_id": os.environ["SID_VAL"],
+    "cwd": os.environ["CWD_VAL"],
+    "lifecycle": "terminated",
+    "terminated_at": int(os.environ["NOW_VAL"]),
+    "terminated_by": "user",
+}))
+')
+  printf '%s' "$PAYLOAD" | "$CLAUDE_PROJECT_DIR/.claude/hooks/watchtower-send.sh" SessionEnd 2>/dev/null
+fi
+
+echo "Session ${SID:0:8} marked terminated at $NOW_ISO."
+echo "Run /checkpoint first if you want a final state snapshot, then exit the terminal."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uv-suite",
-  "version": "0.26.5",
+  "version": "0.28.0",
   "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",

package/personas/auto.json

@@ -37,14 +37,22 @@
       "Bash(wc *)",
       "Bash(head *)",
       "Bash(tail *)",
-      "Bash(curl *)"
+      "Bash(curl *)",
+      "Bash(chmod *)",
+      "Bash(rm /tmp/*)",
+      "Bash(echo *)",
+      "Bash(printf *)",
+      "Bash(node --check *)",
+      "Bash(bash -n *)"
     ],
     "deny": [
       "Bash(rm -rf /)",
       "Bash(rm -rf ~)",
       "Bash(sudo rm -rf *)",
       "Bash(git push --force * main)",
-      "Bash(git push --force * master)"
+      "Bash(git push --force * master)",
+      "Bash(rm -rf .)",
+      "Bash(sudo rm *)"
     ]
   },
   "hooks": {
@@ -155,6 +163,12 @@
             "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh PostToolUse",
             "timeout": 2,
             "async": true
+          },
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/auto-checkpoint.sh",
+            "timeout": 5,
+            "async": true
           }
         ]
       },

package/personas/professional.json

@@ -33,7 +33,16 @@
       "Bash(npx prettier *)",
       "Bash(pytest *)",
       "Bash(go test *)",
-      "Bash(cargo test *)"
+      "Bash(cargo test *)",
+      "Bash(chmod *)",
+      "Bash(mkdir *)",
+      "Bash(rm /tmp/*)",
+      "Bash(cat *)",
+      "Bash(ls *)",
+      "Bash(echo *)",
+      "Bash(printf *)",
+      "Bash(node --check *)",
+      "Bash(bash -n *)"
     ],
     "deny": [
       "Bash(rm -rf /)",
@@ -42,7 +51,8 @@
       "Bash(sudo rm *)",
       "Bash(git push --force * main)",
       "Bash(git push --force * master)",
-      "Bash(git reset --hard origin/*)"
+      "Bash(git reset --hard origin/*)",
+      "Bash(sudo rm -rf *)"
     ]
   },
   "hooks": {
@@ -164,6 +174,12 @@
             "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh PostToolUse",
             "timeout": 2,
             "async": true
+          },
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/auto-checkpoint.sh",
+            "timeout": 5,
+            "async": true
           }
         ]
       },

package/personas/spike.json

@@ -22,15 +22,30 @@
       "Bash(find *)",
       "Bash(wc *)",
       "Bash(head *)",
-      "Bash(tail *)"
+      "Bash(tail *)",
+      "Edit(*)",
+      "Bash(git *)",
+      "Bash(npx prettier *)",
+      "Bash(npx markdown-* *)",
+      "Bash(curl *)",
+      "Bash(chmod *)",
+      "Bash(mkdir *)",
+      "Bash(rm /tmp/*)",
+      "Bash(cat *)",
+      "Bash(ls *)",
+      "Bash(echo *)",
+      "Bash(printf *)",
+      "Bash(node --check *)",
+      "Bash(bash -n *)"
     ],
     "deny": [
-      "Edit(*)",
-      "Bash(git commit *)",
-      "Bash(git push *)",
-      "Bash(rm *)",
-      "Bash(npm run *)",
-      "Bash(npx *)"
+      "Bash(rm -rf /)",
+      "Bash(rm -rf ~)",
+      "Bash(rm -rf .)",
+      "Bash(sudo rm *)",
+      "Bash(sudo rm -rf *)",
+      "Bash(git push --force * main)",
+      "Bash(git push --force * master)"
     ]
   },
   "hooks": {
@@ -123,6 +138,12 @@
             "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh PostToolUse",
             "timeout": 2,
             "async": true
+          },
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/auto-checkpoint.sh",
+            "timeout": 5,
+            "async": true
           }
         ]
       },

package/personas/sport.json

@@ -16,7 +16,25 @@
       "Bash(npm *)",
       "Bash(npx *)",
       "Bash(node *)",
-      "Bash(git *)"
+      "Bash(git *)",
+      "Bash(chmod *)",
+      "Bash(mkdir *)",
+      "Bash(rm /tmp/*)",
+      "Bash(cat *)",
+      "Bash(ls *)",
+      "Bash(echo *)",
+      "Bash(printf *)",
+      "Bash(node --check *)",
+      "Bash(bash -n *)"
+    ],
+    "deny": [
+      "Bash(rm -rf /)",
+      "Bash(rm -rf ~)",
+      "Bash(rm -rf .)",
+      "Bash(sudo rm *)",
+      "Bash(sudo rm -rf *)",
+      "Bash(git push --force * main)",
+      "Bash(git push --force * master)"
     ]
   },
   "hooks": {
@@ -109,6 +127,12 @@
             "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh PostToolUse",
             "timeout": 2,
             "async": true
+          },
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/auto-checkpoint.sh",
+            "timeout": 5,
+            "async": true
           }
         ]
       },

package/skills/auto-checkpoint/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: auto-checkpoint
+description: >
+  Toggle automatic checkpoints, or change how often they fire. When on,
+  UV Suite writes a checkpoint every N minutes (default 10): a mechanical
+  state snapshot from the PostToolUse hook, plus a semantic summary written
+  by Claude (via `claude -p --bare --model haiku`) from the Watchtower's
+  timer. Sessions with no activity in the window are skipped.
+argument-hint: "[on|off|<minutes>|status]"
+user-invocable: true
+allowed-tools:
+  - Bash("$CLAUDE_PROJECT_DIR"/.claude/hooks/auto-checkpoint-helper.sh *)
+---
+
+## Apply /auto-checkpoint $ARGUMENTS
+
+!`"$CLAUDE_PROJECT_DIR"/.claude/hooks/auto-checkpoint-helper.sh $ARGUMENTS`
+
+## Instructions
+
+Show the user the line of output above as the response — it confirms what
+changed. Do not add commentary. The change applies to the very next interval;
+no restart needed.
+
+## What this controls
+
+- `on` / `off` — enable or disable both tiers (mechanical + semantic).
+- `<minutes>` — set the checkpoint interval (1-1440). Default 10.
+- `status` (or no argument) — print the current mode and interval.
+
+## How it works
+
+- **Tier A (mechanical):** the `auto-checkpoint.sh` hook runs after each tool
+  call. When the interval has passed and there's been activity since the last
+  checkpoint, it writes a deterministic snapshot — git state, recent tool calls,
+  files touched — to `uv-out/checkpoints/<sid>/auto-<ts>-mechanical.md`.
+- **Tier B (semantic):** the Watchtower process (`uvs watch`) keeps a timer.
+  Every N minutes, for each active session, it shells out to `claude -p --bare
+  --model haiku` with a prompt assembled from the recent dashboard events and
+  git state. Output is saved next to the mechanical checkpoint as
+  `auto-<ts>-semantic.md`. Cap: `--max-budget-usd 0.05` per call.
+- Both tiers fire `AutoCheckpoint` events to the Watchtower so they show up as
+  distinct rows on the dashboard.
+- Sessions with zero activity in the interval are skipped — no empty checkpoints.
+
+State lives in `.uv-suite-state/auto-checkpoint.json` (mode + interval) and
+`.uv-suite-state/sessions/<sid>.last-{mechanical,semantic}-checkpoint.txt`.

package/skills/confirm/SKILL.md

@@ -7,15 +7,12 @@ description: >
 argument-hint: "[on|off|<number>|status]"
 user-invocable: true
 allowed-tools:
-  - Bash(mkdir *)
-  - Bash(echo *)
-  - Bash(cat *)
-  - Bash(printf *)
+  - Bash("$CLAUDE_PROJECT_DIR"/.claude/hooks/confirm-helper.sh *)
 ---
 
 ## Apply /confirm $ARGUMENTS
 
-!`STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"; mkdir -p "$STATE_DIR"; MODE_FILE="$STATE_DIR/confirm-mode.txt"; THRESH_FILE="$STATE_DIR/confirm-threshold.txt"; ARG=$(printf '%s' "$ARGUMENTS" | tr -d '[:space:]'); current_mode() { cat "$MODE_FILE" 2>/dev/null || echo "on"; }; current_thresh() { cat "$THRESH_FILE" 2>/dev/null || echo "50"; }; case "$ARG" in on) echo "on" > "$MODE_FILE"; echo "Confirm mode: ON (threshold: $(current_thresh) words)";; off) echo "off" > "$MODE_FILE"; echo "Confirm mode: OFF";; ''|status) echo "Confirm mode: $(current_mode) (threshold: $(current_thresh) words)";; *) if printf '%s' "$ARG" | grep -qE '^[0-9]+$'; then echo "$ARG" > "$THRESH_FILE"; echo "Threshold set to $ARG words (mode: $(current_mode))"; else echo "Usage: /confirm [on | off | <number> | status]"; fi;; esac`
+!`"$CLAUDE_PROJECT_DIR"/.claude/hooks/confirm-helper.sh $ARGUMENTS`
 
 ## Instructions
 
@@ -31,5 +28,5 @@ next user prompt; no restart needed.
   step. Slash commands (`/foo ...`) are always exempt.
 - `status` (or no argument) — print the current mode and threshold.
 
-State lives in `${CLAUDE_PROJECT_DIR}/.uv-suite-state/confirm-mode.txt` and
-`confirm-threshold.txt`. Defaults if missing: mode `on`, threshold `50`.
+State lives in `.uv-suite-state/confirm-mode.txt` and `.uv-suite-state/confirm-threshold.txt`
+under `$CLAUDE_PROJECT_DIR`. Defaults if missing: mode `on`, threshold `50`.