specweave 1.0.235 → 1.0.239

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

@@ -0,0 +1,166 @@
+#!/bin/bash
+# stop-auto-v5.sh - Auto Mode Stop Hook (v5.0 - Gate Only)
+# ADR-0225: "Increments ARE the state. Hooks ARE the sync."
+# Hook = simple gate. Quality gates (tests, build, coverage) belong in /sw:done.
+# Sourceable: set __STOP_AUTO_V5_SOURCED=1 to load functions only.
+set +e
+
+# ── Timing ───────────────────────────────────────────────────────────────
+if [[ "$OSTYPE" == "darwin"* ]]; then _START_MS=$(($(date +%s) * 1000))
+else _START_MS=$(($(date +%s) * 1000 + $(date +%N 2>/dev/null | cut -c1-3 || echo "0"))); fi
+_get_duration_ms() {
+    local n; if [[ "$OSTYPE" == "darwin"* ]]; then n=$(($(date +%s) * 1000))
+    else n=$(($(date +%s) * 1000 + $(date +%N 2>/dev/null | cut -c1-3 || echo "0"))); fi
+    echo $((n - _START_MS))
+}
+
+# ── Stdin & paths ────────────────────────────────────────────────────────
+[ -z "${__STOP_AUTO_V5_SOURCED:-}" ] && cat > /dev/null
+PROJECT_ROOT="${PROJECT_ROOT:-$(pwd)}"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+[ -f "$SCRIPT_DIR/log-decision.sh" ] && source "$SCRIPT_DIR/log-decision.sh"
+
+SW="$PROJECT_ROOT/.specweave"
+STATE_DIR="$SW/state"
+LOGS_DIR="$SW/logs"
+LOG_FILE="$LOGS_DIR/stop-auto.log"
+
+log() {
+    mkdir -p "$LOGS_DIR" 2>/dev/null
+    echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] $1" >> "$LOG_FILE" 2>/dev/null
+    [ "${SPECWEAVE_DEBUG_HOOKS:-0}" = "1" ] && echo -e "\033[36m[stop-auto-v5]\033[0m $1" >&2
+}
+
+# ── Helpers ──────────────────────────────────────────────────────────────
+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_open_acs() {
+    local f="$1"; [ ! -f "$f" ] && echo "0" && return
+    local c; c=$(grep -c '\[ \]' "$f" 2>/dev/null) || true; echo "${c:-0}"
+}
+silent_approve() {
+    local reason="$1" rc="${2:-session_inactive}" ctx="${3:-"{}"}"
+    log "APPROVE: $reason"
+    type log_decision &>/dev/null && log_decision "stop-auto" "approve" "$rc" "$reason" "$ctx" "$(_get_duration_ms)"
+    echo '{"decision":"approve"}'; exit 0
+}
+loud_approve() {
+    local reason="$1" rc="${2:-session_complete}" ctx="${3:-"{}"}" msg="$4"
+    log "APPROVE (loud): $reason"
+    type log_decision &>/dev/null && log_decision "stop-auto" "approve" "$rc" "$reason" "$ctx" "$(_get_duration_ms)"
+    jq -n --arg d "approve" --arg r "$reason" --arg m "$msg" '{decision:$d,reason:$r,systemMessage:$m}'; exit 0
+}
+block() {
+    local reason="$1" rc="${2:-work_remaining}" ctx="${3:-"{}"}" msg="$4"
+    log "BLOCK: $reason"
+    type log_decision &>/dev/null && log_decision "stop-auto" "block" "$rc" "$reason" "$ctx" "$(_get_duration_ms)"
+    jq -n --arg d "block" --arg r "$reason" --arg m "$msg" '{decision:$d,reason:$r,systemMessage:$m}'; exit 0
+}
+
+# ── Source-only guard ────────────────────────────────────────────────────
+[ "${__STOP_AUTO_V5_SOURCED:-}" = "1" ] && return 0 2>/dev/null || true
+[ "${__STOP_AUTO_V5_SOURCED:-}" = "1" ] && exit 0
+
+# ═════════════════════════════════════════════════════════════════════════
+# MAIN
+# ═════════════════════════════════════════════════════════════════════════
+INC_DIR="$SW/increments"
+CFG="$SW/config.json"
+SESSION="$STATE_DIR/auto-mode.json"
+TURN_FILE="$STATE_DIR/.stop-auto-turns"
+DEDUP_PREV="$STATE_DIR/.stop-auto-dedup-prev"
+
+# 1. Quick exits
+[ ! -d "$SW" ] && silent_approve "Not a SpecWeave project" "not_specweave_project"
+[ ! -d "$INC_DIR" ] && silent_approve "No increments directory" "no_increments_dir"
+
+# 2. Config
+MAX_TURNS=20; MAX_AGE=7200; AUTO_ON="true"; DEDUP_WIN="${SPECWEAVE_STOP_HOOK_DEDUP:-30}"
+if [ -f "$CFG" ]; then
+    AUTO_ON=$(jq -r '.auto.enabled // true' "$CFG" 2>/dev/null || echo "true")
+    MAX_TURNS=$(jq -r '.auto.maxTurns // 20' "$CFG" 2>/dev/null || echo "20")
+    MAX_AGE=$(jq -r '.auto.maxSessionAge // 7200' "$CFG" 2>/dev/null || echo "7200")
+fi
+[ "$AUTO_ON" != "true" ] && silent_approve "Auto mode disabled" "auto_disabled"
+
+# 3. Session marker
+[ ! -f "$SESSION" ] && silent_approve "No auto session" "session_inactive" '{"sessionActive":false}'
+ACTIVE=$(jq -r '.active // false' "$SESSION" 2>/dev/null || echo "false")
+[ "$ACTIVE" != "true" ] && silent_approve "Session not active" "session_inactive" '{"sessionActive":false}'
+
+# 4. Staleness
+MTIME=$(stat -f%m "$SESSION" 2>/dev/null || stat -c%Y "$SESSION" 2>/dev/null || echo "0")
+NOW=$(date +%s); AGE=$((NOW - MTIME))
+if [ "$AGE" -gt "$MAX_AGE" ]; then
+    rm -f "$SESSION" "$DEDUP_PREV" "$TURN_FILE" 2>/dev/null
+    silent_approve "Stale session (${AGE}s)" "session_stale" \
+        "$(jq -n --argjson a "$AGE" --argjson m "$MAX_AGE" '{sessionAge:$a,maxSessionAge:$m}')"
+fi
+touch "$SESSION" 2>/dev/null
+
+# 5. Turn counter (never resets during session)
+TURN=1
+if [ -f "$TURN_FILE" ]; then
+    S=$(cat "$TURN_FILE" 2>/dev/null || echo "0")
+    [[ "$S" =~ ^[0-9]+$ ]] && TURN=$((S + 1))
+fi
+mkdir -p "$STATE_DIR" 2>/dev/null
+echo "$TURN" > "$TURN_FILE.tmp" && mv "$TURN_FILE.tmp" "$TURN_FILE" 2>/dev/null
+
+if [ "$TURN" -ge "$MAX_TURNS" ]; then
+    rm -f "$SESSION" "$DEDUP_PREV" "$TURN_FILE" 2>/dev/null
+    loud_approve "Turn limit ($TURN/$MAX_TURNS)" "turn_limit" \
+        "$(jq -n --argjson c "$TURN" --argjson m "$MAX_TURNS" '{turn:{current:$c,max:$m}}')" \
+        "Turn limit reached ($TURN/$MAX_TURNS). Run /sw:auto to start a new session."
+fi
+
+# 6. Dedup (write-first prevents race)
+if [ -f "$DEDUP_PREV" ]; then
+    LAST=$(cat "$DEDUP_PREV" 2>/dev/null || echo "0")
+    EL=$((NOW - LAST))
+    if [ "$EL" -lt "$DEDUP_WIN" ]; then
+        silent_approve "Deduplicated (${EL}s)" "deduplicated" \
+            "$(jq -n --argjson e "$EL" --argjson w "$DEDUP_WIN" '{elapsed:$e,dedupWindow:$w}')"
+    fi
+fi
+echo "$NOW" > "$DEDUP_PREV" 2>/dev/null
+
+# 7. Scan active increments
+TP=0; TAC=0; IC=0; ILIST=""
+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
+    d=$(dirname "$meta"); id=$(basename "$d")
+    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"
+    fi
+done
+
+# 8. 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" \
+        "$(jq -n --argjson t "$TURN" '{turn:$t}')" \
+        "All tasks and ACs complete. Run /sw:done to close the increment."
+fi
+
+# 9. Work remains → block with concise message
+DETAILS=""
+IFS=',' read -ra ENTRIES <<< "$ILIST"
+for entry in "${ENTRIES[@]}"; do
+    IFS='|' read -r eid ep ea <<< "$entry"
+    DETAILS="${DETAILS}\n  - ${eid}: ${ep} tasks pending, ${ea} ACs open"
+done
+
+BMSG="Auto Mode: ${IC} increment(s) need work${DETAILS}\nTurn $TURN/$MAX_TURNS | Continue: /sw:do | Complete: /sw:done"
+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}}')" \
+    "$BMSG"

package/plugins/specweave/hooks/user-prompt-submit.sh

@@ -1119,6 +1119,16 @@ if [[ "${SPECWEAVE_DISABLE_AUTO_LOAD:-0}" != "1" ]] && [[ "${SPECWEAVE_DISABLE_H
                   fi
 
                   echo "[$(date -Iseconds)] plugins | installed=${PLUGINS_INSTALLED:-none} | already=${PLUGINS_ALREADY:-none}" >> "$LAZY_LOAD_LOG"
+
+                  # v0195: Suggest @playwright/cli alongside MCP plugin for token efficiency
+                  if echo " $DETECTED_PLUGINS " | grep -q " playwright "; then
+                    if ! command -v playwright-cli >/dev/null 2>&1; then
+                      CLI_SUGGEST_MSG="\\n💡 **Tip**: Install \`@playwright/cli\` for token-efficient browser automation (~98% savings vs MCP):\\n"
+                      CLI_SUGGEST_MSG="${CLI_SUGGEST_MSG}  \`npm install -g @playwright/cli@latest\`\\n"
+                      AUTOLOAD_PLUGINS_MSG="${AUTOLOAD_PLUGINS_MSG:-}${CLI_SUGGEST_MSG}"
+                      echo "[$(date -Iseconds)] playwright-cli | suggested=true | reason=not-installed" >> "$LAZY_LOAD_LOG"
+                    fi
+                  fi
                 fi
               fi
             fi

package/plugins/specweave/hooks/v2/dispatchers/post-tool-use.sh

@@ -165,7 +165,7 @@ safe_run_sync() {
 play_task_completion_sound() {
   local tasks_file="$1"
   local state_file="$STATE_DIR/.last-task-completion"
-  local session_file="$STATE_DIR/auto-session.json"
+  local session_file="$STATE_DIR/auto-mode.json"
 
   # DISABLED: Sound notifications are disabled by default
   # To re-enable, set SPECWEAVE_SOUND_ENABLED=1 in environment
@@ -311,6 +311,14 @@ case "$FILE_PATH" in
         safe_run_sync "$SYNC_SCRIPT" "task-ac-sync" "$INPUT"
       fi
 
+      # ========================================================================
+      # GITHUB AC SYNC (v1.0.236+): Post progress to GitHub after AC sync
+      # ========================================================================
+      GITHUB_AC_HANDLER="${HOOK_DIR}/../../../specweave-github/hooks/github-ac-sync-handler.sh"
+      if [[ -f "$GITHUB_AC_HANDLER" ]]; then
+        safe_run_background "$GITHUB_AC_HANDLER" "github-ac-sync" "$INC_ID"
+      fi
+
       # ========================================================================
       # TDD ENFORCEMENT (v1.0.160+): Enforce TDD discipline
       # ========================================================================
@@ -349,6 +357,18 @@ case "$FILE_PATH" in
       play_task_completion_sound "$FILE_PATH"
     fi
 
+    # ========================================================================
+    # GITHUB AUTO-CREATE (v1.0.237+): Create issues when spec.md is written
+    # ========================================================================
+    # When spec.md is created/updated AND has user stories, auto-create
+    # GitHub issues if autoSync or auto_create_github_issue is enabled.
+    if [[ "$FILE_PATH" == *spec.md ]]; then
+      GITHUB_AUTO_CREATE="${HOOK_DIR}/../../../specweave-github/hooks/github-auto-create-handler.sh"
+      if [[ -f "$GITHUB_AUTO_CREATE" ]]; then
+        safe_run_background "$GITHUB_AUTO_CREATE" "github-auto-create" "$INC_ID"
+      fi
+    fi
+
     # Tasks or spec changed -> check for US completion (background)
     safe_run_background "$DETECTOR_DIR/us-completion-detector.sh" "us-completion-detector" "$INC_ID"
 

package/plugins/specweave/hooks/v2/dispatchers/session-start.sh

@@ -32,7 +32,7 @@ AUTO_MODE_FILE="$STATE_DIR/auto-mode.json"
 if [[ -f "$AUTO_MODE_FILE" ]]; then
   rm -f "$AUTO_MODE_FILE" 2>/dev/null
   rm -f "$STATE_DIR/.stop-auto-dedup" 2>/dev/null
-  rm -f "$STATE_DIR/.stop-auto-retry" 2>/dev/null
+  rm -f "$STATE_DIR/.stop-auto-dedup-prev" 2>/dev/null
   rm -f "$STATE_DIR/.stop-auto-turns" 2>/dev/null
   # Log cleanup (non-blocking, fire-and-forget)
   mkdir -p "$PROJECT_ROOT/.specweave/logs" 2>/dev/null