uv-suite 0.6.0 → 0.7.0

package/hooks/session-end.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# UV Suite Hook: Session end — reflection and total time
+# Event: Stop (replaces session-review-reminder.sh with richer behavior)
+
+STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
+START_FILE="$STATE_DIR/session-start.txt"
+
+# Compute session duration
+DURATION_MSG=""
+if [ -f "$START_FILE" ]; then
+  START=$(cat "$START_FILE")
+  NOW=$(date +%s)
+  ELAPSED=$((NOW - START))
+  MINUTES=$((ELAPSED / 60))
+
+  # Add to today's total
+  TODAY=$(date +%Y-%m-%d)
+  TODAY_FILE="$STATE_DIR/active-$TODAY.txt"
+  TODAY_TOTAL=$(cat "$TODAY_FILE" 2>/dev/null || echo "0")
+  TODAY_TOTAL=$((TODAY_TOTAL + MINUTES))
+  echo "$TODAY_TOTAL" > "$TODAY_FILE"
+
+  DURATION_MSG="Session: ${MINUTES} min. Today: ${TODAY_TOTAL} min. "
+
+  # Reset session state
+  rm -f "$START_FILE" "$STATE_DIR/tool-count.txt" "$STATE_DIR/last-warning.txt"
+fi
+
+# Check for uncommitted changes
+STAGED=$(git diff --cached --stat 2>/dev/null)
+UNSTAGED=$(git diff --stat 2>/dev/null)
+UNTRACKED=$(git ls-files --others --exclude-standard 2>/dev/null | head -5)
+
+REVIEW_MSG=""
+if [ -n "$STAGED" ] || [ -n "$UNSTAGED" ] || [ -n "$UNTRACKED" ]; then
+  REVIEW_MSG="Uncommitted changes — consider /review and /slop-check before committing. "
+fi
+
+# Reflection prompt
+REFLECTION_MSG="Before closing: What shipped? What did you learn? What would you teach the agent for next time (add to CLAUDE.md or DANGER-ZONES.md)?"
+
+FULL_MSG="${DURATION_MSG}${REVIEW_MSG}${REFLECTION_MSG}"
+
+cat <<EOF
+{
+  "continue": true,
+  "systemMessage": "$FULL_MSG"
+}
+EOF
+
+exit 0

package/hooks/session-start.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# UV Suite Hook: Session start — record start time
+# Event: SessionStart
+
+STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
+mkdir -p "$STATE_DIR"
+
+# Record session start time
+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"
+fi
+
+exit 0

package/hooks/session-timer.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+# UV Suite Hook: Session timer — warn about session duration
+# Event: PostToolUse (runs every Nth tool call)
+# Escalates: 45min → gentle, 90min → firm, 180min → strong
+
+STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
+START_FILE="$STATE_DIR/session-start.txt"
+
+# Only check every 20th tool call to avoid noise
+COUNT_FILE="$STATE_DIR/tool-count.txt"
+COUNT=$(cat "$COUNT_FILE" 2>/dev/null || echo "0")
+COUNT=$((COUNT + 1))
+echo "$COUNT" > "$COUNT_FILE"
+
+if [ $((COUNT % 20)) -ne 0 ]; then
+  exit 0
+fi
+
+if [ ! -f "$START_FILE" ]; then
+  exit 0
+fi
+
+START=$(cat "$START_FILE")
+NOW=$(date +%s)
+ELAPSED=$((NOW - START))
+MINUTES=$((ELAPSED / 60))
+
+# Check if we've already shown a warning for this threshold
+LAST_WARN_FILE="$STATE_DIR/last-warning.txt"
+LAST_WARN=$(cat "$LAST_WARN_FILE" 2>/dev/null || echo "0")
+
+MESSAGE=""
+WARN_LEVEL=0
+
+if [ "$MINUTES" -ge 180 ] && [ "$LAST_WARN" -lt 3 ]; then
+  MESSAGE="SESSION HEALTH (3+ hours): You've been in this session for ${MINUTES} minutes. This is a long stretch. Strongly consider: (1) commit what you have, (2) close this session, (3) take a real break away from the screen. Long uninterrupted agent sessions lead to goal drift, lower judgment quality, and burnout. /compact if you must continue, but a break is better."
+  WARN_LEVEL=3
+elif [ "$MINUTES" -ge 90 ] && [ "$LAST_WARN" -lt 2 ]; then
+  MESSAGE="SESSION HEALTH (90+ min): You've been in this session for ${MINUTES} minutes. Consider taking a 10-minute break — stretch, water, walk. Come back with fresh eyes. Also a good time to commit progress."
+  WARN_LEVEL=2
+elif [ "$MINUTES" -ge 45 ] && [ "$LAST_WARN" -lt 1 ]; then
+  MESSAGE="SESSION HEALTH (45 min): You've been in this session for ${MINUTES} minutes. Good time for a quick break and to commit any progress."
+  WARN_LEVEL=1
+fi
+
+if [ -n "$MESSAGE" ]; then
+  echo "$WARN_LEVEL" > "$LAST_WARN_FILE"
+  cat <<EOF
+{
+  "continue": true,
+  "systemMessage": "$MESSAGE"
+}
+EOF
+fi
+
+exit 0

package/hooks/status-line.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+# UV Suite Hook: Status line — show session duration and persona
+# Event: statusLine (rendered continuously)
+
+STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.uv-suite-state"
+START_FILE="$STATE_DIR/session-start.txt"
+
+# Session duration
+if [ -f "$START_FILE" ]; then
+  START=$(cat "$START_FILE")
+  NOW=$(date +%s)
+  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"
+fi
+
+# Today's total active time
+TODAY=$(date +%Y-%m-%d)
+TODAY_FILE="$STATE_DIR/active-$TODAY.txt"
+if [ -f "$TODAY_FILE" ]; then
+  TODAY_TOTAL=$(cat "$TODAY_FILE")
+  CURRENT_MINS=${MINS:-0}
+  TODAY_NOW=$((TODAY_TOTAL + CURRENT_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)
+fi
+
+echo "UV Suite · $SESSION$TODAY_STR"

package/install.sh

@@ -112,13 +112,16 @@ echo "  ✓ /map-codebase, /spec, /architect, /review, /write-tests"
 echo "  ✓ /write-evals, /slop-check, /prototype, /security-review"
 
 # --- Install hooks ---
-echo "Installing 4 hook scripts..."
+echo "Installing hook scripts..."
 cp "$UV_SUITE_DIR/hooks/"*.sh "$TARGET_DIR/hooks/"
 chmod +x "$TARGET_DIR/hooks/"*.sh
-echo "  ✓ auto-lint.sh (PostToolUse: auto-format on write)"
+echo "  ✓ auto-lint.sh (PostToolUse: auto-format)"
 echo "  ✓ danger-zone-check.sh (PreToolUse: warn on danger zone files)"
 echo "  ✓ block-destructive.sh (PreToolUse: block rm -rf, force push, etc.)"
-echo "  ✓ session-review-reminder.sh (Stop: remind to review uncommitted changes)"
+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 "  + 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.6.0",
+  "version": "0.7.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

@@ -50,6 +50,14 @@
   },
 
   "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start.sh", "timeout": 5 }
+        ]
+      }
+    ],
     "PreToolUse": [
       {
         "matcher": "Bash",
@@ -64,6 +72,12 @@
       }
     ],
     "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-timer.sh", "timeout": 5 }
+        ]
+      },
       {
         "matcher": "Edit|Write",
         "hooks": [
@@ -75,6 +89,19 @@
           }
         ]
       }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-end.sh", "timeout": 10 }
+        ]
+      }
     ]
+  },
+
+  "statusLine": {
+    "type": "command",
+    "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/status-line.sh"
   }
 }

package/personas/professional.json

@@ -48,6 +48,18 @@
   },
 
   "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
     "PreToolUse": [
       {
         "matcher": "Bash",
@@ -73,6 +85,16 @@
       }
     ],
     "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-timer.sh",
+            "timeout": 5
+          }
+        ]
+      },
       {
         "matcher": "Edit|Write",
         "hooks": [
@@ -98,12 +120,17 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-review-reminder.sh",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-end.sh",
             "timeout": 10,
-            "statusMessage": "Checking for uncommitted changes..."
+            "statusMessage": "Wrapping up session..."
           }
         ]
       }
     ]
+  },
+
+  "statusLine": {
+    "type": "command",
+    "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/status-line.sh"
   }
 }

package/personas/spike.json

@@ -36,6 +36,14 @@
   },
 
   "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start.sh", "timeout": 5 }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "Write",
@@ -49,6 +57,19 @@
           }
         ]
       }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-end.sh", "timeout": 10 }
+        ]
+      }
     ]
+  },
+
+  "statusLine": {
+    "type": "command",
+    "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/status-line.sh"
   }
 }

package/personas/sport.json

@@ -22,6 +22,14 @@
   },
 
   "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start.sh", "timeout": 5 }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "Edit|Write",
@@ -34,6 +42,19 @@
           }
         ]
       }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-end.sh", "timeout": 10 }
+        ]
+      }
     ]
+  },
+
+  "statusLine": {
+    "type": "command",
+    "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/status-line.sh"
   }
 }