uv-suite 0.10.0 → 0.12.0

package/hooks/doc-slop-grep.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+# UV Suite Hook: Fast deterministic doc-slop check
+# Event: PostToolUse (Write) — Spike persona
+# Greps for vague adjectives and buzzwords in documentation files. No LLM.
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+if [ -z "$FILE_PATH" ] || [ ! -f "$FILE_PATH" ]; then
+  exit 0
+fi
+
+EXT="${FILE_PATH##*.}"
+
+# Only check markdown and text files
+case "$EXT" in
+  md|txt|rst|adoc) ;;
+  *) exit 0 ;;
+esac
+
+FINDINGS=""
+
+# Vague adjectives that say nothing
+MATCH=$(grep -in "robust\|scalable\|comprehensive\|extensible\|maintainable\|enterprise-grade\|battle-tested\|cutting-edge\|state-of-the-art" "$FILE_PATH" 2>/dev/null | head -3)
+if [ -n "$MATCH" ]; then
+  FINDINGS="${FINDINGS}Vague adjectives — replace with specific facts: $(echo "$MATCH" | head -1 | sed 's/"/\\"/g'). "
+fi
+
+# Evasive verbs
+MATCH=$(grep -in "leverages\|utilizes\|facilitates\|empowers\|enables seamless" "$FILE_PATH" 2>/dev/null | head -3)
+if [ -n "$MATCH" ]; then
+  FINDINGS="${FINDINGS}Evasive verbs — say what it actually does: $(echo "$MATCH" | head -1 | sed 's/"/\\"/g'). "
+fi
+
+# Authority appeals without specifics
+MATCH=$(grep -in "best practices\|industry-standard\|widely adopted\|production-ready" "$FILE_PATH" 2>/dev/null | head -3)
+if [ -n "$MATCH" ]; then
+  FINDINGS="${FINDINGS}Name the specific practice instead of citing authority: $(echo "$MATCH" | head -1 | sed 's/"/\\"/g'). "
+fi
+
+if [ -n "$FINDINGS" ]; then
+  cat <<EOF
+{
+  "continue": true,
+  "systemMessage": "Doc slop: ${FINDINGS}"
+}
+EOF
+fi
+
+exit 0

package/hooks/slop-grep.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# UV Suite Hook: Fast deterministic slop check
+# Event: PostToolUse (Edit|Write)
+# Greps for mechanical, unambiguous slop patterns. No LLM, no false positives.
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+if [ -z "$FILE_PATH" ] || [ ! -f "$FILE_PATH" ]; then
+  exit 0
+fi
+
+EXT="${FILE_PATH##*.}"
+FINDINGS=""
+
+case "$EXT" in
+  ts|tsx|js|jsx)
+    # toBeTruthy/toBeDefined in test files
+    if echo "$FILE_PATH" | grep -qE "\.(test|spec)\.(ts|tsx|js|jsx)$"; then
+      MATCH=$(grep -n "\.toBeTruthy()\|\.toBeDefined()" "$FILE_PATH" 2>/dev/null)
+      if [ -n "$MATCH" ]; then
+        FINDINGS="${FINDINGS}Weak assertion in $FILE_PATH: $MATCH. Test specific values instead. "
+      fi
+    fi
+    # catch-and-rethrow (catch { ...throw } with nothing meaningful between)
+    MATCH=$(grep -n "catch.*{" "$FILE_PATH" 2>/dev/null | head -3)
+    ;;
+  py)
+    # bare except: pass
+    MATCH=$(grep -n "except:$\|except Exception:$" "$FILE_PATH" 2>/dev/null)
+    if [ -n "$MATCH" ]; then
+      NEXT=$(grep -A1 "except" "$FILE_PATH" 2>/dev/null | grep -c "pass\|raise")
+      if [ "$NEXT" -gt 0 ]; then
+        FINDINGS="${FINDINGS}Bare except with pass/raise in $FILE_PATH. "
+      fi
+    fi
+    ;;
+esac
+
+if [ -n "$FINDINGS" ]; then
+  cat <<EOF
+{
+  "continue": true,
+  "systemMessage": "Slop detected: ${FINDINGS}"
+}
+EOF
+fi
+
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uv-suite",
-  "version": "0.10.0",
+  "version": "0.12.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/professional.json

@@ -105,11 +105,10 @@
             "statusMessage": "Auto-formatting..."
           },
           {
-            "type": "prompt",
-            "prompt": "Quickly scan the code that was just written or edited for the most obvious AI slop patterns: (1) comments that restate the code like '// Initialize the database' above initDatabase(), (2) try/catch around code that can't throw, (3) single-implementation interfaces or factories, (4) toBeTruthy()/toBeDefined() in tests. If you find any of these specific patterns, respond with {\"ok\": false, \"reason\": \"Slop detected: [specific finding with line reference]. Fix: [specific fix].\"} If the code is clean, respond with {\"ok\": true}. Only flag the most obvious violations — do not be overly strict.",
-            "model": "claude-haiku-4-5",
-            "timeout": 15,
-            "statusMessage": "Checking for AI slop..."
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/slop-grep.sh",
+            "timeout": 3,
+            "statusMessage": "Slop check..."
           }
         ]
       }

package/personas/spike.json

@@ -49,11 +49,10 @@
         "matcher": "Write",
         "hooks": [
           {
-            "type": "prompt",
-            "prompt": "The agent just wrote a documentation or analysis file. Check for documentation slop: (1) vague adjectives like 'robust', 'scalable', 'comprehensive', 'leverages', 'facilitates', (2) feature lists that could describe any system, (3) overview sections that don't say what the system actually does, (4) claims without specifics ('industry-standard best practices'). If you find slop, respond {\"ok\": false, \"reason\": \"Doc slop: [finding]. Fix: replace with specific facts.\"}. If clean, respond {\"ok\": true}.",
-            "model": "claude-haiku-4-5",
-            "timeout": 15,
-            "statusMessage": "Checking documentation quality..."
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/doc-slop-grep.sh",
+            "timeout": 3,
+            "statusMessage": "Doc quality check..."
           }
         ]
       }

package/settings.json

@@ -82,11 +82,10 @@
             "statusMessage": "Auto-formatting..."
           },
           {
-            "type": "prompt",
-            "prompt": "Quickly scan the code that was just written or edited for the most obvious AI slop patterns: (1) comments that restate the code like '// Initialize the database' above initDatabase(), (2) try/catch around code that can't throw, (3) single-implementation interfaces or factories, (4) toBeTruthy()/toBeDefined() in tests. If you find any of these specific patterns, respond with {\"ok\": false, \"reason\": \"Slop detected: [specific finding with line reference]. Fix: [specific fix].\"} If the code is clean, respond with {\"ok\": true}. Only flag the most obvious violations — do not be overly strict.",
-            "model": "claude-haiku-4-5",
-            "timeout": 15,
-            "statusMessage": "Checking for AI slop..."
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/slop-grep.sh",
+            "timeout": 3,
+            "statusMessage": "Slop check..."
           }
         ]
       }