specweave 1.0.299 → 1.0.301

package/dist/src/core/skill-security/scanner.js

@@ -0,0 +1,78 @@
+/**
+ * SKILL.md self-scan scanner.
+ * Applies detection rules against SKILL.md content and bash code blocks.
+ */
+import { SKILL_SECURITY_RULES } from './rules.js';
+import { extractBashBlocks } from './parser.js';
+/**
+ * Scan SKILL.md content using structured detection rules.
+ * Rules marked `codeBlockOnly: true` only apply inside bash code blocks.
+ * Other rules apply to the full markdown content.
+ */
+export function scanSkillMd(content, rules = SKILL_SECURITY_RULES) {
+    const findings = [];
+    const allLines = content.split('\n');
+    // Build a set of line ranges for bash code blocks (1-based)
+    const bashBlocks = extractBashBlocks(content);
+    const bashBlockLines = new Set();
+    for (const block of bashBlocks) {
+        const blockLineCount = block.content.split('\n').length;
+        for (let offset = 0; offset < blockLineCount; offset++) {
+            bashBlockLines.add(block.startLine + 1 + offset); // +1 because startLine is the fence
+        }
+    }
+    // Separate rules by scope
+    const codeOnlyRules = rules.filter(r => r.codeBlockOnly);
+    const fullContentRules = rules.filter(r => !r.codeBlockOnly);
+    // Apply full-content rules to every line
+    for (let i = 0; i < allLines.length; i++) {
+        const line = allLines[i];
+        const lineNum = i + 1;
+        for (const rule of fullContentRules) {
+            if (rule.pattern.test(line)) {
+                const match = line.match(rule.pattern);
+                findings.push({
+                    ruleId: rule.id,
+                    category: rule.category,
+                    severity: rule.severity,
+                    message: rule.message,
+                    suggestedFix: rule.suggestedFix,
+                    line: lineNum,
+                    matchedText: match?.[0] ?? line.trim().slice(0, 60),
+                });
+            }
+        }
+    }
+    // Apply code-block-only rules to lines inside bash blocks
+    for (let i = 0; i < allLines.length; i++) {
+        const lineNum = i + 1;
+        if (!bashBlockLines.has(lineNum))
+            continue;
+        const line = allLines[i];
+        for (const rule of codeOnlyRules) {
+            if (rule.pattern.test(line)) {
+                const match = line.match(rule.pattern);
+                findings.push({
+                    ruleId: rule.id,
+                    category: rule.category,
+                    severity: rule.severity,
+                    message: rule.message,
+                    suggestedFix: rule.suggestedFix,
+                    line: lineNum,
+                    matchedText: match?.[0] ?? line.trim().slice(0, 60),
+                });
+            }
+        }
+    }
+    // Sort findings by line number
+    findings.sort((a, b) => a.line - b.line);
+    const hasCriticalOrHigh = findings.some(f => f.severity === 'critical' || f.severity === 'high');
+    const hasAny = findings.length > 0;
+    const exitCode = hasCriticalOrHigh ? 2 : hasAny ? 1 : 0;
+    return {
+        exitCode,
+        passed: !hasCriticalOrHigh,
+        findings,
+    };
+}
+//# sourceMappingURL=scanner.js.map

package/dist/src/core/skill-security/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../../../src/core/skill-security/scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAqB,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAiChD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,QAA6B,oBAAoB;IAC5F,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAErC,4DAA4D;IAC5D,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACxD,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,MAAM,EAAE,EAAE,CAAC;YACvD,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,oCAAoC;QACxF,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAE7D,yCAAyC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvC,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;iBACpD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvC,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;iBACpD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAEzC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IACjG,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAEnC,MAAM,QAAQ,GAAc,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnE,OAAO;QACL,QAAQ;QACR,MAAM,EAAE,CAAC,iBAAiB;QAC1B,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.299",
+  "version": "1.0.301",
   "description": "Spec-driven development framework for AI coding agents. Works with Claude Code, Codex, Antigravity, Cursor, Copilot & more. 100+ skills, 49 CLI commands, verified skill certification, autonomous execution, and living documentation.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/hooks/lib/score-increment.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+# score-increment.sh — Score an increment against a text query using keyword overlap.
+#
+# Usage: score-increment.sh <increment_dir> <query>
+# Output: integer 0-100 (higher = better match)
+#
+# Corpus: increment directory name + metadata title + spec.md overview + task titles
+
+set -e
+
+INCREMENT_DIR="$1"
+QUERY="$2"
+
+if [ -z "$INCREMENT_DIR" ] || [ -z "$QUERY" ]; then
+    echo "0"
+    exit 0
+fi
+
+if [ ! -d "$INCREMENT_DIR" ]; then
+    echo "0"
+    exit 0
+fi
+
+# Build corpus from multiple sources
+CORPUS=""
+
+# 1. Directory name (e.g. "0257-auto-context-aware-selection" → words)
+DIR_NAME=$(basename "$INCREMENT_DIR")
+CORPUS="$CORPUS ${DIR_NAME//-/ }"
+
+# 2. Title from metadata.json
+META_FILE="$INCREMENT_DIR/metadata.json"
+if [ -f "$META_FILE" ]; then
+    TITLE=$(jq -r '.title // .name // ""' "$META_FILE" 2>/dev/null || echo "")
+    CORPUS="$CORPUS $TITLE"
+fi
+
+# 3. First 500 chars of spec.md (overview/problem statement)
+SPEC_FILE="$INCREMENT_DIR/spec.md"
+if [ -f "$SPEC_FILE" ]; then
+    OVERVIEW=$(head -c 500 "$SPEC_FILE" 2>/dev/null || echo "")
+    CORPUS="$CORPUS $OVERVIEW"
+fi
+
+# 4. Task titles from tasks.md (lines starting with ### T-)
+TASKS_FILE="$INCREMENT_DIR/tasks.md"
+if [ -f "$TASKS_FILE" ]; then
+    TASK_TITLES=$(grep '^### T-' "$TASKS_FILE" 2>/dev/null | sed 's/^### T-[0-9]*: //' || echo "")
+    CORPUS="$CORPUS $TASK_TITLES"
+fi
+
+# Normalize corpus: lowercase, non-alphanumeric → space
+CORPUS_LC=$(echo "$CORPUS" | tr '[:upper:]' '[:lower:]' | tr -cs 'a-z0-9' ' ')
+
+# Extract unique query keywords: lowercase, length > 2, skip common stopwords
+STOPWORDS="the and for with from that this are was were has have been will not"
+KEYWORDS=$(echo "$QUERY" | tr '[:upper:]' '[:lower:]' | tr -cs 'a-z0-9' '\n' | \
+    awk 'length > 2' | \
+    grep -vxF -e "the" -e "and" -e "for" -e "with" -e "from" -e "that" -e "this" \
+              -e "are" -e "was" -e "were" -e "has" -e "have" -e "been" -e "will" \
+              -e "not" -e "into" -e "use" -e "its" | \
+    sort -u)
+
+if [ -z "$KEYWORDS" ]; then
+    echo "0"
+    exit 0
+fi
+
+# Count matches
+TOTAL=0
+MATCHED=0
+while IFS= read -r keyword; do
+    [ -z "$keyword" ] && continue
+    TOTAL=$((TOTAL + 1))
+    if echo "$CORPUS_LC" | grep -qw "$keyword" 2>/dev/null; then
+        MATCHED=$((MATCHED + 1))
+    fi
+done <<< "$KEYWORDS"
+
+if [ "$TOTAL" -eq 0 ]; then
+    echo "0"
+    exit 0
+fi
+
+# Score = matched_keywords / total_keywords * 100
+SCORE=$(( MATCHED * 100 / TOTAL ))
+echo "$SCORE"

package/plugins/specweave/hooks/stop-auto-v5.sh

@@ -52,10 +52,22 @@ count_pending_tasks() {
     local f="$1"; [ ! -f "$f" ] && echo "0" && return
     local c; c=$(grep -c '\[ \]' "$f" 2>/dev/null) || true; echo "${c:-0}"
 }
+count_completed_tasks() {
+    local f="$1"; [ ! -f "$f" ] && echo "0" && return
+    local c; c=$(grep -c '\[x\]' "$f" 2>/dev/null) || true; echo "${c:-0}"
+}
 count_open_acs() {
     local f="$1"; [ ! -f "$f" ] && echo "0" && return
     local c; c=$(grep -c '\[ \]' "$f" 2>/dev/null) || true; echo "${c:-0}"
 }
+get_next_task_title() {
+    local f="$1"; [ ! -f "$f" ] && echo "" && return
+    local lnum; lnum=$(grep -n '\[ \]' "$f" 2>/dev/null | head -1 | cut -d: -f1)
+    [ -z "$lnum" ] && echo "" && return
+    # Search backwards from [ ] line to find ### T-NNN: Title heading
+    local title; title=$(head -n "$lnum" "$f" | grep '### T-' | tail -1 | sed 's/^### T-[0-9]*: //')
+    echo "${title}" | head -c 80
+}
 silent_approve() {
     local reason="$1" rc="${2:-session_inactive}" ctx="${3:-"{}"}"
     log "APPROVE: $reason"
@@ -143,8 +155,12 @@ if [ -f "$DEDUP_PREV" ]; then
 fi
 echo "$NOW" > "$DEDUP_PREV" 2>/dev/null
 
-# 7. Scan active increments
+# 7. Read userGoal from session marker
+USER_GOAL=$(jq -r '.userGoal // ""' "$SESSION" 2>/dev/null || echo "")
+
+# 8. Scan active increments (enriched: next task, progress fraction)
 TP=0; TAC=0; IC=0; ILIST=""
+_SCORE_SCRIPT="$SCRIPT_DIR/lib/score-increment.sh"
 for meta in $(find "$INC_DIR" -maxdepth 2 -name "metadata.json" 2>/dev/null); do
     st=$(jq -r '.status // "unknown"' "$meta" 2>/dev/null || echo "unknown")
     [ "$st" != "active" ] && [ "$st" != "in-progress" ] && continue
@@ -152,11 +168,23 @@ for meta in $(find "$INC_DIR" -maxdepth 2 -name "metadata.json" 2>/dev/null); do
     p=$(count_pending_tasks "$d/tasks.md"); a=$(count_open_acs "$d/spec.md")
     if [ "$p" -gt 0 ] || [ "$a" -gt 0 ]; then
         TP=$((TP + p)); TAC=$((TAC + a)); IC=$((IC + 1))
-        [ -z "$ILIST" ] && ILIST="$id|$p|$a" || ILIST="$ILIST,$id|$p|$a"
+        # Extract next pending task title (first [ ] line, strip markdown)
+        _next_task=$(grep -m1 '\[ \]' "$d/tasks.md" 2>/dev/null | sed 's/.*\] //' | head -c 80 || echo "")
+        # Count completed tasks for progress fraction
+        _done=$(grep -c '\[x\]' "$d/tasks.md" 2>/dev/null) || _done=0
+        _total=$((_done + p))
+        # Score against userGoal if set and scoring script available
+        _score=""
+        if [ -n "$USER_GOAL" ] && [ -f "$_SCORE_SCRIPT" ]; then
+            _score=$(bash "$_SCORE_SCRIPT" "$d" "$USER_GOAL" 2>/dev/null || echo "0")
+        fi
+        # Extended ILIST format: id|pending|acs|next_task|done|total|score
+        _entry="$id|$p|$a|$_next_task|$_done|$_total|${_score:-0}"
+        [ -z "$ILIST" ] && ILIST="$_entry" || ILIST="$ILIST,$_entry"
     fi
 done
 
-# 8. All complete → approve
+# 9. All complete → approve
 if [ "$IC" -eq 0 ]; then
     rm -f "$SESSION" "$DEDUP_PREV" "$TURN_FILE" 2>/dev/null
     loud_approve "All work complete" "all_complete" \
@@ -164,19 +192,37 @@ if [ "$IC" -eq 0 ]; then
         "All tasks and ACs complete. Run /sw:done to close the increment."
 fi
 
-# 9. Work remains → block with concise message
+# 10. Work remains → block with enriched context message
+# Sort entries by score descending (highest-relevance first) when userGoal is set
+SORTED_ILIST="$ILIST"
+if [ -n "$USER_GOAL" ] && [ "$IC" -gt 1 ]; then
+    # Sort by score field (7th field) descending
+    SORTED_ILIST=$(echo "$ILIST" | tr ',' '\n' | sort -t'|' -k7 -nr | tr '\n' ',')
+    SORTED_ILIST="${SORTED_ILIST%,}"  # trim trailing comma
+fi
+
 DETAILS=""
-IFS=',' read -ra ENTRIES <<< "$ILIST"
+_BEST_ID=""
+IFS=',' read -ra ENTRIES <<< "$SORTED_ILIST"
 for entry in "${ENTRIES[@]}"; do
-    IFS='|' read -r eid ep ea <<< "$entry"
-    DETAILS="${DETAILS}\n  - ${eid}: ${ep} tasks pending, ${ea} ACs open"
+    IFS='|' read -r eid ep ea enext edone etotal escore <<< "$entry"
+    [ -z "$_BEST_ID" ] && _BEST_ID="$eid"
+    _progress="${edone:-0}/${etotal:-0} tasks"
+    _next_info=""
+    [ -n "$enext" ] && _next_info=" | Next: $enext"
+    DETAILS="${DETAILS}\n  ▸ ${eid}: ${_progress}${_next_info}"
 done
 
-BMSG="Auto Mode: ${IC} increment(s) need work${DETAILS}\nTurn $TURN/$MAX_TURNS | Continue: /sw:do | Complete: /sw:done"
+# Build enriched block message
+BMSG=""
+[ -n "$USER_GOAL" ] && BMSG="Goal: ${USER_GOAL}\n"
+BMSG="${BMSG}Auto Mode: ${IC} increment(s) need work${DETAILS}"
+BMSG="${BMSG}\nTurn $TURN/$MAX_TURNS | Continue: /sw:do ${_BEST_ID}"
 BMSG=$(echo -e "$BMSG")
 
 block "Work remaining: $TP tasks, $TAC ACs" "work_remaining" \
     "$(jq -n --argjson p "$TP" --argjson a "$TAC" --argjson i "$IC" \
         --argjson t "$TURN" --argjson mt "$MAX_TURNS" --arg il "$ILIST" \
-        '{pendingTasks:$p,openAcs:$a,incompleteIncrements:$i,increments:$il,turn:{current:$t,max:$mt}}')" \
+        --arg goal "$USER_GOAL" --arg best "$_BEST_ID" \
+        '{pendingTasks:$p,openAcs:$a,incompleteIncrements:$i,increments:$il,turn:{current:$t,max:$mt},userGoal:$goal,recommended:$best}')" \
     "$BMSG"

package/plugins/specweave/hooks/tests/test-auto-context-integration.sh

@@ -0,0 +1,126 @@
+#!/bin/bash
+# Integration test: scored selection + enriched feedback (T-012, AC-US1-01, AC-US2-01, AC-US3-01)
+# Creates a mock .specweave/ project, scores increments, and verifies enrichment helpers.
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SCORE_SCRIPT="$SCRIPT_DIR/../lib/score-increment.sh"
+STOP_HOOK="$SCRIPT_DIR/../stop-auto-v5.sh"
+TMPDIR_ROOT=$(mktemp -d)
+trap 'rm -rf "$TMPDIR_ROOT"' EXIT
+
+PASS=0; FAIL=0
+
+assert_eq() {
+    if [ "$1" = "$2" ]; then
+        echo "  ✓ $3"; PASS=$((PASS+1))
+    else
+        echo "  ✗ $3 (expected '$2', got '$1')"; FAIL=$((FAIL+1))
+    fi
+}
+
+assert_gt() {
+    if [ "$1" -gt "$2" ]; then
+        echo "  ✓ $3 ($1 > $2)"; PASS=$((PASS+1))
+    else
+        echo "  ✗ $3 (expected $1 > $2)"; FAIL=$((FAIL+1))
+    fi
+}
+
+assert_contains() {
+    if echo "$1" | grep -q "$2"; then
+        echo "  ✓ $3"; PASS=$((PASS+1))
+    else
+        echo "  ✗ $3 (expected '$1' to contain '$2')"; FAIL=$((FAIL+1))
+    fi
+}
+
+echo "Integration: scored selection + enriched feedback"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Setup mock .specweave/ structure
+SW="$TMPDIR_ROOT/.specweave"
+INC_DIR="$SW/increments"
+STATE_DIR="$SW/state"
+LOGS_DIR="$SW/logs"
+mkdir -p "$INC_DIR/0100-user-auth" "$INC_DIR/0101-deploy-pipeline" "$STATE_DIR" "$LOGS_DIR"
+
+# Create increment 0100: auth
+echo '{"title":"User Authentication Feature","status":"active","lastActivity":"2026-02-18T10:00:00Z"}' \
+    > "$INC_DIR/0100-user-auth/metadata.json"
+cat > "$INC_DIR/0100-user-auth/spec.md" << 'EOF'
+# User Authentication Feature
+
+Implement login, signup, and OAuth for user authentication.
+EOF
+cat > "$INC_DIR/0100-user-auth/tasks.md" << 'EOF'
+### T-001: Add login endpoint
+**Status**: [x] completed
+### T-002: Add signup endpoint
+**Status**: [x] completed
+### T-003: OAuth integration
+**Status**: [ ] pending
+### T-004: Session management
+**Status**: [ ] pending
+EOF
+
+# Create increment 0101: deploy
+echo '{"title":"CI/CD Deploy Pipeline","status":"active","lastActivity":"2026-02-17T10:00:00Z"}' \
+    > "$INC_DIR/0101-deploy-pipeline/metadata.json"
+cat > "$INC_DIR/0101-deploy-pipeline/spec.md" << 'EOF'
+# CI/CD Deploy Pipeline
+
+Setup continuous integration and deployment pipeline with Docker and GitHub Actions.
+EOF
+cat > "$INC_DIR/0101-deploy-pipeline/tasks.md" << 'EOF'
+### T-001: Create Dockerfile
+**Status**: [x] completed
+### T-002: Configure GitHub Actions
+**Status**: [ ] pending
+### T-003: Set up staging environment
+**Status**: [ ] pending
+EOF
+
+# TC-015: Scored selection — auth scores higher for "fix authentication"
+s_auth=$(bash "$SCORE_SCRIPT" "$INC_DIR/0100-user-auth" "fix authentication" 2>/dev/null)
+s_deploy=$(bash "$SCORE_SCRIPT" "$INC_DIR/0101-deploy-pipeline" "fix authentication" 2>/dev/null)
+assert_gt "$s_auth" "$s_deploy" "TC-015a: auth scores higher than deploy for auth prompt"
+
+# TC-015b: Deploy scores higher for "deploy pipeline docker"
+s_auth2=$(bash "$SCORE_SCRIPT" "$INC_DIR/0100-user-auth" "deploy pipeline docker" 2>/dev/null)
+s_deploy2=$(bash "$SCORE_SCRIPT" "$INC_DIR/0101-deploy-pipeline" "deploy pipeline docker" 2>/dev/null)
+assert_gt "$s_deploy2" "$s_auth2" "TC-015b: deploy scores higher for deploy prompt"
+
+# TC-015c: userGoal wiring — verify logic matches setup-auto.sh
+AUTO_MODE_FILE="$STATE_DIR/auto-mode.json"
+PROMPT="fix authentication"
+if [ -f "$AUTO_MODE_FILE" ]; then
+    if [ -n "$PROMPT" ]; then
+        _UPDATED=$(jq --arg g "$PROMPT" '.userGoal = $g' "$AUTO_MODE_FILE" 2>/dev/null)
+    else
+        _UPDATED=$(jq '.userGoal = null' "$AUTO_MODE_FILE" 2>/dev/null)
+    fi
+    [ -n "$_UPDATED" ] && echo "$_UPDATED" > "$AUTO_MODE_FILE"
+elif [ -n "$PROMPT" ]; then
+    jq -n --arg g "$PROMPT" '{"active":false,"userGoal":$g}' > "$AUTO_MODE_FILE"
+fi
+goal=$(jq -r '.userGoal' "$AUTO_MODE_FILE")
+assert_eq "$goal" "fix authentication" "TC-015c: userGoal written to auto-mode.json"
+
+# TC-015d: Stop hook enrichment — source hook, test helpers
+export PROJECT_ROOT="$TMPDIR_ROOT"
+export __STOP_AUTO_V5_SOURCED=1
+source "$STOP_HOOK" 2>/dev/null
+
+next_auth=$(get_next_task_title "$INC_DIR/0100-user-auth/tasks.md")
+assert_eq "$next_auth" "OAuth integration" "TC-015d: enriched next task from auth increment"
+
+done_auth=$(count_completed_tasks "$INC_DIR/0100-user-auth/tasks.md")
+pending_auth=$(count_pending_tasks "$INC_DIR/0100-user-auth/tasks.md")
+assert_eq "$done_auth" "2" "TC-015e: auth increment done count = 2"
+assert_eq "$pending_auth" "2" "TC-015f: auth increment pending count = 2"
+
+echo ""
+echo "Results: $PASS passed, $FAIL failed"
+[ "$FAIL" -eq 0 ] || exit 1

package/plugins/specweave/hooks/tests/test-stop-auto-enriched.sh

@@ -0,0 +1,128 @@
+#!/bin/bash
+# Tests for enriched stop hook feedback (AC-US3-01, AC-US3-02, AC-US3-03, AC-US4-01, AC-US4-03)
+# Sources stop-auto-v5.sh to load helper functions only.
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+STOP_HOOK="$SCRIPT_DIR/../stop-auto-v5.sh"
+TMPDIR_ROOT=$(mktemp -d)
+trap 'rm -rf "$TMPDIR_ROOT"' EXIT
+
+PASS=0; FAIL=0
+
+assert_eq() {
+    if [ "$1" = "$2" ]; then
+        echo "  ✓ $3"; PASS=$((PASS+1))
+    else
+        echo "  ✗ $3 (expected '$2', got '$1')"; FAIL=$((FAIL+1))
+    fi
+}
+
+assert_ge() {
+    if [ "$1" -ge "$2" ]; then
+        echo "  ✓ $3 ($1 >= $2)"; PASS=$((PASS+1))
+    else
+        echo "  ✗ $3 (expected >= $2, got $1)"; FAIL=$((FAIL+1))
+    fi
+}
+
+# Set up minimal .specweave structure so sourcing succeeds
+export PROJECT_ROOT="$TMPDIR_ROOT"
+mkdir -p "$TMPDIR_ROOT/.specweave/logs" "$TMPDIR_ROOT/.specweave/state" "$TMPDIR_ROOT/.specweave/increments"
+
+# Source only (loads helper functions, skips main execution)
+export __STOP_AUTO_V5_SOURCED=1
+source "$STOP_HOOK" 2>/dev/null
+
+echo "stop-auto-v5.sh enrichment function tests"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Create a tasks.md with known counts
+TASKS_FILE="$TMPDIR_ROOT/tasks.md"
+cat > "$TASKS_FILE" << 'EOF'
+### T-001: Setup database
+**User Story**: US-001 | **Status**: [x] completed
+
+### T-002: Implement login
+**User Story**: US-001 | **Status**: [x] completed
+
+### T-003: Add unit tests
+**User Story**: US-001 | **Status**: [x] completed
+
+### T-004: Write integration tests
+**User Story**: US-001 | **Status**: [x] completed
+
+### T-005: Deploy to staging
+**User Story**: US-001 | **Status**: [x] completed
+
+### T-006: Configure auth middleware
+**User Story**: US-001 | **Status**: [ ] pending
+
+### T-007: Add error handling
+**User Story**: US-001 | **Status**: [ ] pending
+
+### T-008: Final review and cleanup
+**User Story**: US-001 | **Status**: [ ] pending
+EOF
+
+# TC-010: Block message includes next task title (AC-US3-01)
+result=$(get_next_task_title "$TASKS_FILE")
+assert_eq "$result" "Configure auth middleware" "TC-010: get_next_task_title returns first pending task"
+
+# TC-011: count_completed_tasks counts [x] entries
+done_count=$(count_completed_tasks "$TASKS_FILE")
+assert_eq "$done_count" "5" "TC-011: count_completed_tasks = 5"
+
+# TC-012: count_pending_tasks counts [ ] entries (AC-US3-03)
+pending_count=$(count_pending_tasks "$TASKS_FILE")
+assert_eq "$pending_count" "3" "TC-012: count_pending_tasks = 3"
+
+# TC-012b: Progress fraction calculation
+total=$((done_count + pending_count))
+assert_eq "$total" "8" "TC-012b: total = done + pending = 8"
+
+# TC-013: Empty tasks file → zeros
+EMPTY_FILE="$TMPDIR_ROOT/empty.md"
+touch "$EMPTY_FILE"
+done_empty=$(count_completed_tasks "$EMPTY_FILE")
+pending_empty=$(count_pending_tasks "$EMPTY_FILE")
+assert_eq "$done_empty" "0" "TC-013: empty file → 0 completed"
+assert_eq "$pending_empty" "0" "TC-013b: empty file → 0 pending"
+
+# TC-013c: get_next_task_title on empty file → empty string
+next_empty=$(get_next_task_title "$EMPTY_FILE")
+assert_eq "$next_empty" "" "TC-013c: empty file → no next title"
+
+# TC-014: Missing file → zeros
+done_missing=$(count_completed_tasks "/nonexistent/tasks.md")
+assert_eq "$done_missing" "0" "TC-014: missing file → 0 completed"
+
+# TC-015: get_next_task_title with all completed → empty
+ALL_DONE_FILE="$TMPDIR_ROOT/all-done.md"
+cat > "$ALL_DONE_FILE" << 'EOF'
+### T-001: Done task one
+**Status**: [x] completed
+
+### T-002: Done task two
+**Status**: [x] completed
+EOF
+next_done=$(get_next_task_title "$ALL_DONE_FILE")
+assert_eq "$next_done" "" "TC-015: all done → no next title"
+
+# TC-016: get_next_task_title with task without title pattern
+MIXED_FILE="$TMPDIR_ROOT/mixed.md"
+cat > "$MIXED_FILE" << 'EOF'
+### T-001: First Task Title
+**Status**: [x] completed
+### T-002: Second Task Title
+**Status**: [ ] pending
+### T-003: Third Task Title
+**Status**: [ ] pending
+EOF
+next_mixed=$(get_next_task_title "$MIXED_FILE")
+assert_eq "$next_mixed" "Second Task Title" "TC-016: returns first pending task title"
+
+echo ""
+echo "Results: $PASS passed, $FAIL failed"
+[ "$FAIL" -eq 0 ] || exit 1