uv-suite 0.5.0 → 0.7.0

package/bin/cli.js

@@ -1,49 +1,52 @@
 #!/usr/bin/env node
 
-const { execSync } = require('child_process');
+const { execSync, spawn } = require('child_process');
 const path = require('path');
 const fs = require('fs');
 
 const UV_SUITE_DIR = path.resolve(__dirname, '..');
 const args = process.argv.slice(2);
 const command = args[0];
+const pkg = require(path.join(UV_SUITE_DIR, 'package.json'));
+
+const PERSONAS = ['spike', 'sport', 'pro', 'professional', 'auto'];
+const TOOLS = ['claude', 'codex'];
 
 function usage() {
   console.log(`
-  uv-suite - AI-assisted development framework
+  uv v${pkg.version} — AI-assisted development framework
 
-  Usage:
-    npx uv-suite install [--persona sport|professional|auto|spike] [--global]
-    npx uv-suite info
+  Launch a session:
+    uv claude pro          Claude Code, Professional persona
+    uv claude auto         Claude Code, Auto persona
+    uv codex pro           Codex, Professional persona
+    uv codex sport         Codex, Sport persona
+    uv pro                 Shorthand (defaults to Claude Code)
+    uv                     Claude Code, Professional
 
-  Commands:
-    install   Install agents, skills, hooks, guardrails, and personas
-    info      Show what would be installed
+  Setup:
+    uv install             Install UV Suite into current project
+    uv install --persona sport
+    uv info                Show what's installed
 
   Personas:
-    spike          Research & documentation (Opus, max effort)
-    sport          New projects, prototyping (Sonnet, high effort)
-    professional   Production code (default, all hooks + guardrails)
-    auto           Fully autonomous (max effort, everything approved)
-
-  Examples:
-    npx uv-suite install                        Install with Professional persona
-    npx uv-suite install --persona sport        Install with Sport persona
-    npx uv-suite install --global               Install to ~/.claude/
+    spike        Research & docs (Opus, max effort)
+    sport        New projects (Sonnet, high effort)
+    pro          Production code (all hooks, all guardrails)
+    auto         Fully autonomous (max effort, everything approved)
   `);
 }
 
 function info() {
   console.log(`
-  UV Suite v0.1.0
+  UV Suite v${pkg.version}
 
   Contents:
     10 agents      Claude Code (.md), Cursor (.mdc), Codex (.toml)
     9  skills      Slash commands for Claude Code
-    4  hooks       auto-lint, slop-check, danger-zone, block-destructive
-    6  guardrails  Anti-slop rules (comment, overengineering, error, test, doc, architecture)
+    5  hooks       auto-lint, slop-check, danger-zone, block-destructive, review-reminder
+    6  guardrails  Anti-slop rules
     4  personas    Spike, Sport, Professional, Auto
-    1  launcher    uv.sh (session launcher with persona selection)
 
   Source: ${UV_SUITE_DIR}
   `);
@@ -55,8 +58,6 @@ function install() {
     console.error('Error: install.sh not found at', installScript);
     process.exit(1);
   }
-
-  // Pass through all args after "install"
   const installArgs = args.slice(1).join(' ');
   try {
     execSync(`bash "${installScript}" ${installArgs}`, { stdio: 'inherit' });
@@ -65,20 +66,77 @@ function install() {
   }
 }
 
-switch (command) {
-  case 'install':
-    install();
-    break;
-  case 'info':
-    info();
-    break;
-  case '--help':
-  case '-h':
-  case undefined:
-    usage();
-    break;
-  default:
-    console.error(`Unknown command: ${command}`);
-    usage();
+function normPersona(p) {
+  if (p === 'pro' || p === 'professional') return 'professional';
+  if (PERSONAS.includes(p)) return p;
+  return null;
+}
+
+function personaLabel(p) {
+  const labels = {
+    spike: 'Spike — research & docs (Opus, max)',
+    sport: 'Sport — lightweight (Sonnet, high)',
+    professional: 'Professional — full rigor (all hooks, all guardrails)',
+    auto: 'Auto — autonomous (max, everything approved)',
+  };
+  return labels[p] || p;
+}
+
+function launchClaude(persona, extra) {
+  const settings = path.resolve('.claude/personas', `${persona}.json`);
+  if (!fs.existsSync(settings)) {
+    console.error(`Error: ${settings} not found. Run 'uv install' first.`);
+    process.exit(1);
+  }
+  console.log(`UV Suite | Claude Code | ${personaLabel(persona)}`);
+  console.log('');
+  const child = spawn('claude', ['--settings', settings, ...extra], { stdio: 'inherit' });
+  child.on('exit', (code) => process.exit(code || 0));
+}
+
+function launchCodex(persona, extra) {
+  const approvalMap = {
+    spike: ['--model', 'o3', '--approval-mode', 'suggest'],
+    sport: ['--approval-mode', 'auto-edit'],
+    professional: ['--approval-mode', 'suggest'],
+    auto: ['--approval-mode', 'full-auto'],
+  };
+  const codexArgs = approvalMap[persona] || ['--approval-mode', 'suggest'];
+  console.log(`UV Suite | Codex | ${personaLabel(persona)}`);
+  console.log('');
+  const child = spawn('codex', [...codexArgs, ...extra], { stdio: 'inherit' });
+  child.on('exit', (code) => process.exit(code || 0));
+}
+
+// --- Parse and route ---
+
+if (!command || command === '--help' || command === '-h') {
+  usage();
+  process.exit(0);
+}
+
+if (command === 'install') {
+  install();
+} else if (command === 'info') {
+  info();
+} else if (TOOLS.includes(command)) {
+  // uv claude pro, uv codex auto
+  const persona = normPersona(args[1] || 'pro');
+  if (!persona) {
+    console.error(`Unknown persona: ${args[1]}`);
+    console.error('Available: spike, sport, pro, auto');
     process.exit(1);
+  }
+  const extra = args.slice(2);
+  if (command === 'claude') launchClaude(persona, extra);
+  else launchCodex(persona, extra);
+} else if (normPersona(command)) {
+  // uv pro (shorthand for uv claude pro)
+  const persona = normPersona(command);
+  const extra = args.slice(1);
+  launchClaude(persona, extra);
+} else {
+  console.error(`Unknown command: ${command}`);
+  usage();
+  process.exit(1);
 }

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.5.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",
@@ -24,6 +24,7 @@
     "repomix": "^0.3.0"
   },
   "bin": {
+    "uv": "./bin/cli.js",
     "uv-suite": "./bin/cli.js"
   },
   "files": [

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"
   }
 }