uv-suite 0.6.0 → 0.8.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) ---
@@ -218,9 +221,25 @@ Agent output is written to uv-out/. Agents read prior artifacts automatically:
 
 ${HOOKS_TEXT}
 
-### Personas
+### Working practices
 
-Start sessions with: ./uv.sh spike | sport | pro | auto
+**Honesty:** If you can't find a doc, file, or function, say so explicitly. Never fabricate. Say: "I did not find X. What should I do?" Never invent facts to fill gaps. Calibrate confidence — use "I think" when unsure. If 2-3 attempts fail, stop and escalate with what you tried.
+
+**Scope:** Do what was asked. Nothing more. No "while I'm here" fixes. If you notice something worth fixing, mention it at the end, don't silently change it.
+
+**Destructive actions:** Always confirm before rm -rf, force push, dropping tables, modifying CI/CD, pushing to main.
+
+**Completion:** "Done" means verified. Run the tests. Don't say "should work" when you could say "I ran it and it works."
+
+**Failures:** When you fail, say so. Use the escalation format: what you tried, why each failed, your hypothesis, what you need.
+
+**The user knows things you don't:** If something looks wrong, ask why before "fixing" it. Users have context you don't.
+
+**Context:** If the conversation is long, suggest /compact or a new session. Past 90 min, suggest a break.
+
+### Launching sessions
+
+uv claude pro | uv codex pro | uv pro (shorthand)
 EOF
 
   echo "  ✓ UV Suite section added to CLAUDE.md"
@@ -325,102 +344,6 @@ else
   echo "    Register manually after installing Claude Code: claude mcp add playwright -- npx @playwright/mcp@latest"
 fi
 
-# --- Write UV Suite context to CLAUDE.md ---
-if [ "$INSTALL_MODE" = "project" ]; then
-  PROJECT_ROOT="$(dirname "$TARGET_DIR")"
-  CLAUDE_MD="$PROJECT_ROOT/CLAUDE.md"
-
-  # Check if UV Suite section already exists
-  if [ -f "$CLAUDE_MD" ] && grep -q "## UV Suite" "$CLAUDE_MD" 2>/dev/null; then
-    echo "Updating UV Suite section in CLAUDE.md..."
-    # Remove old UV Suite section and rewrite
-    sed -i.bak '/^## UV Suite$/,/^## [^U]/{ /^## [^U]/!d; }' "$CLAUDE_MD" 2>/dev/null || true
-    rm -f "$CLAUDE_MD.bak" 2>/dev/null
-  else
-    echo "Adding UV Suite section to CLAUDE.md..."
-  fi
-
-  cat >> "$CLAUDE_MD" << CLAUDEMD
-
-## UV Suite
-
-This project uses [UV Suite](https://github.com/utsavanand/uv-suite) for AI-assisted development.
-
-**Active persona:** $PERSONA_LABEL
-**Version:** $(cat "$UV_SUITE_DIR/package.json" 2>/dev/null | grep '"version"' | head -1 | sed 's/.*: "//;s/".*//')
-
-### Available skills (slash commands)
-
-| Command | Agent | What it does |
-|---------|-------|-------------|
-| /map-codebase [dir] | Cartographer | Build knowledge graph of codebase |
-| /map-stack [dir] | Cartographer | Map multiple services and their connections |
-| /spec [requirements] | Spec Writer | Write technical specification |
-| /architect [spec] | Architect | Design architecture, decompose into Acts |
-| /review | Reviewer | Code review (correctness, security, perf, slop) |
-| /write-tests [file] | Test Writer | Generate tests matching project conventions |
-| /write-evals [prompt] | Eval Writer | Write AI/LLM evaluation cases |
-| /slop-check | Anti-Slop Guard | Detect 6 categories of AI-generated slop |
-| /prototype [concept] | Prototype Builder | Build static React prototype |
-| /security-review | Security Agent | OWASP audit, dependency scan, secret detection |
-
-### Artifacts
-
-All agent output is written to \`uv-out/\`. Each agent reads relevant prior artifacts from this directory automatically.
-
-| Artifact | Written by | Read by |
-|----------|-----------|---------|
-| uv-out/map-codebase.md | /map-codebase | /architect, /review, /security-review |
-| uv-out/specs/*.md | /spec | /architect, /write-tests, /write-evals |
-| uv-out/architecture/*.md | /architect | /review, /write-tests, /slop-check |
-| uv-out/review-*.md | /review | /slop-check, /security-review |
-| uv-out/security-review-*.md | /security-review | — |
-| uv-out/slop-check-*.md | /slop-check | — |
-
-### Active hooks
-
-Hooks fire automatically on every relevant action. You do not invoke these.
-
-$(if [ "$PERSONA" = "professional" ]; then
-cat << 'HOOKS'
-- **auto-lint** (on file write) — runs prettier/ruff/gofmt
-- **slop check** (on file write) — Haiku scans for obvious slop
-- **danger zone** (on file edit) — warns if file is in DANGER-ZONES.md
-- **destructive block** (on bash) — blocks rm -rf, force push
-- **review reminder** (on session end) — reminds to /review if uncommitted changes
-HOOKS
-elif [ "$PERSONA" = "auto" ]; then
-cat << 'HOOKS'
-- **auto-lint** (on file write) — runs prettier/ruff/gofmt
-- **destructive block** (on bash) — blocks rm -rf, force push
-HOOKS
-elif [ "$PERSONA" = "sport" ]; then
-cat << 'HOOKS'
-- **auto-lint** (on file write) — runs prettier/ruff/gofmt
-HOOKS
-elif [ "$PERSONA" = "spike" ]; then
-cat << 'HOOKS'
-- **doc slop check** (on file write) — Haiku checks documentation quality
-HOOKS
-fi)
-
-### Context management
-
-If the conversation is getting long, proactively suggest running /compact or starting a new session. Use /cost to check token usage. The user's status line shows context window usage.
-
-### Launching sessions
-
-\`\`\`
-uv claude pro     # Claude Code, Professional persona
-uv claude auto    # Claude Code, Auto persona
-uv codex pro      # OpenAI Codex, Professional persona
-uv codex sport    # OpenAI Codex, Sport persona
-\`\`\`
-CLAUDEMD
-
-  echo "  ✓ UV Suite section added to CLAUDE.md"
-fi
-
 # --- Install launcher script ---
 echo "Installing session launcher..."
 cp "$UV_SUITE_DIR/uv.sh" "$TARGET_DIR/../uv.sh" 2>/dev/null || true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uv-suite",
-  "version": "0.6.0",
+  "version": "0.8.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"
   }
 }