specweave 1.0.550 → 1.0.552

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

@@ -1,270 +0,0 @@
-#!/bin/bash
-# session-start.sh - Session initialization dispatcher (ACTIVE HOOK)
-#
-# ✅ This is the ACTIVE session-start hook (configured in hooks.json)
-# Ultra-fast, non-blocking startup for every Claude Code session
-#
-# v1.0.127: AUTO-LOAD PLUGINS based on project type (React, Express, K8s, etc.)
-# v1.0.180: LSP language server check (detects missing binaries)
-#
-# Claude Code 2.1.2+ Enhancement:
-# - Reads agent_type from SessionStart input for agent-specific initialization
-# - Enables customized startup behavior based on which agent is running
-set +e
-
-[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
-
-# Find project root
-PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
-  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
-done
-[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
-
-# ============================================================================
-# SESSION CLEANUP: ALWAYS clear auto-mode.json (CRITICAL for session-scoped auto)
-# Auto mode MUST be session-scoped - each new Claude Code session starts FRESH.
-# This ensures: Session A runs /sw:auto → closes → Session B starts CLEAN
-# ============================================================================
-STATE_DIR="$PROJECT_ROOT/.specweave/state"
-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-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
-  echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] SessionStart: Cleared auto-mode session files (session-scoped)" >> "$PROJECT_ROOT/.specweave/logs/session.log" 2>/dev/null
-fi
-
-# ============================================================================
-# CONTEXT PRESSURE RESET: Clear pressure state for fresh session budget (v1.0.262)
-# Ensures new sessions start at user's configured base budget level
-# ============================================================================
-rm -f "$STATE_DIR/context-pressure.json" 2>/dev/null
-rm -f "$STATE_DIR/.context-hash" 2>/dev/null
-rm -f "$STATE_DIR/prompt-health-alert.json" 2>/dev/null
-
-# ============================================================================
-# PROMPT BASELINE HEALTH CHECK (v1.0.268)
-# Calculates approximate baseline prompt size from controllable factors.
-# Warns user if baseline is dangerously high (>80K warning, >120K critical).
-# Writes prompt-health.json for dashboard consumption.
-# ============================================================================
-CLAUDE_MD_SIZE=0
-MEMORY_MD_SIZE=0
-SKILL_BUDGET="${SLASH_COMMAND_TOOL_CHAR_BUDGET:-15000}"
-[[ ! "$SKILL_BUDGET" =~ ^[0-9]+$ ]] && SKILL_BUDGET=15000
-SYSTEM_ESTIMATE=12000
-HOOK_PER_TURN=3000
-
-# Measure CLAUDE.md
-if [[ -f "$PROJECT_ROOT/CLAUDE.md" ]]; then
-  CLAUDE_MD_SIZE=$(wc -c < "$PROJECT_ROOT/CLAUDE.md" 2>/dev/null | tr -d ' ')
-  [[ ! "$CLAUDE_MD_SIZE" =~ ^[0-9]+$ ]] && CLAUDE_MD_SIZE=0
-fi
-
-# Measure global CLAUDE.md (user's global instructions)
-GLOBAL_CLAUDE="$HOME/.claude/CLAUDE.md"
-if [[ -f "$GLOBAL_CLAUDE" ]]; then
-  _GC_SIZE=$(wc -c < "$GLOBAL_CLAUDE" 2>/dev/null | tr -d ' ')
-  [[ "$_GC_SIZE" =~ ^[0-9]+$ ]] && MEMORY_MD_SIZE=$((_GC_SIZE))
-fi
-
-# Measure project-specific MEMORY.md
-_PROJECT_SLUG=$(echo "$PROJECT_ROOT" | sed 's|^/||;s|/|-|g')
-_PROJECT_MEMORY="$HOME/.claude/projects/-${_PROJECT_SLUG}/memory/MEMORY.md"
-if [[ -f "$_PROJECT_MEMORY" ]]; then
-  _PM_SIZE=$(wc -c < "$_PROJECT_MEMORY" 2>/dev/null | tr -d ' ')
-  [[ "$_PM_SIZE" =~ ^[0-9]+$ ]] && MEMORY_MD_SIZE=$((MEMORY_MD_SIZE + _PM_SIZE))
-fi
-
-BASELINE=$((CLAUDE_MD_SIZE + MEMORY_MD_SIZE + SKILL_BUDGET + SYSTEM_ESTIMATE + HOOK_PER_TURN))
-
-# Determine warning level
-WARNING_THRESHOLD=80000
-CRITICAL_THRESHOLD=120000
-WARNING_LEVEL="normal"
-if [[ $BASELINE -gt $CRITICAL_THRESHOLD ]]; then
-  WARNING_LEVEL="critical"
-elif [[ $BASELINE -gt $WARNING_THRESHOLD ]]; then
-  WARNING_LEVEL="warning"
-fi
-
-# Write health check to state for dashboard
-cat > "$STATE_DIR/prompt-health.json" <<EOF
-{"baseline":$BASELINE,"claudeMdSize":$CLAUDE_MD_SIZE,"memoryMdSize":$MEMORY_MD_SIZE,"skillBudget":$SKILL_BUDGET,"systemEstimate":$SYSTEM_ESTIMATE,"hookPerTurn":$HOOK_PER_TURN,"warningLevel":"$WARNING_LEVEL","checkedAt":"$(date -Iseconds)"}
-EOF
-
-# Emit warnings
-if [[ "$WARNING_LEVEL" == "critical" ]]; then
-  echo "{\"continue\":true,\"systemMessage\":\"PROMPT HEALTH: CRITICAL - Baseline prompt size is ${BASELINE} chars ($((BASELINE / 1000))KB). CLAUDE.md=${CLAUDE_MD_SIZE}, MEMORY.md=${MEMORY_MD_SIZE}, Skills=${SKILL_BUDGET}. Risk of 'Prompt is too long' errors. Reduce MEMORY.md (<5KB), lower contextBudget.level, or reduce SLASH_COMMAND_TOOL_CHAR_BUDGET.\"}"
-elif [[ "$WARNING_LEVEL" == "warning" ]]; then
-  echo "{\"continue\":true,\"systemMessage\":\"PROMPT HEALTH: Elevated baseline prompt size (${BASELINE} chars / $((BASELINE / 1000))KB). CLAUDE.md=${CLAUDE_MD_SIZE}, MEMORY.md=${MEMORY_MD_SIZE}. Consider reducing MEMORY.md or lowering contextBudget level if you see compaction warnings.\"}"
-fi
-
-# Log health check
-mkdir -p "$PROJECT_ROOT/.specweave/logs" 2>/dev/null
-echo "[$(date -Iseconds)] HEALTH_CHECK | baseline=$BASELINE | level=$WARNING_LEVEL | claude_md=$CLAUDE_MD_SIZE | memory_md=$MEMORY_MD_SIZE | skills=$SKILL_BUDGET" >> "$PROJECT_ROOT/.specweave/logs/prompt-health.log" 2>/dev/null
-
-# ============================================================================
-# PLUGIN CACHE: Do NOT delete - Claude Code manages its own plugin cache
-# v1.0.206: (REVERTED) Cache deletion broke plugin loading - installed_plugins.json
-#           still referenced deleted paths, causing all commands/skills to fail
-# ============================================================================
-
-# ============================================================================
-# PLUGIN HEALTH: Ensure sw@specweave is enabled (guards against corruption)
-# v1.0.513: Claude Code's plugin CLI can corrupt enabledPlugins as a side
-# effect of install/uninstall operations (read-modify-write race, settings
-# sync after installed_plugins.json wipe). This fast check repairs it.
-# ============================================================================
-CLAUDE_SETTINGS="$HOME/.claude/settings.json"
-if command -v jq >/dev/null 2>&1 && [[ -f "$CLAUDE_SETTINGS" ]]; then
-  SW_STATE=$(jq -r '.enabledPlugins["sw@specweave"]' "$CLAUDE_SETTINGS" 2>/dev/null)
-  if [[ "$SW_STATE" != "true" ]]; then
-    jq '.enabledPlugins["sw@specweave"] = true' "$CLAUDE_SETTINGS" > "${CLAUDE_SETTINGS}.tmp" && \
-      mv "${CLAUDE_SETTINGS}.tmp" "$CLAUDE_SETTINGS" 2>/dev/null
-    echo '{"continue":true,"systemMessage":"sw@specweave was disabled (corruption detected) — auto-repaired. Skills are now active."}'
-    mkdir -p "$PROJECT_ROOT/.specweave/logs" 2>/dev/null
-    echo "[$(date -Iseconds)] PLUGIN_HEALTH: Repaired sw@specweave (was: $SW_STATE)" >> "$PROJECT_ROOT/.specweave/logs/session.log" 2>/dev/null
-  fi
-fi
-
-# Read stdin to extract agent_type (Claude Code 2.1.2+)
-INPUT=$(cat 2>/dev/null || echo '{}')
-AGENT_TYPE=""
-if command -v jq >/dev/null 2>&1; then
-  AGENT_TYPE=$(echo "$INPUT" | jq -r '.agent_type // ""' 2>/dev/null || echo "")
-fi
-
-# Agent-specific initialization (Claude Code 2.1.2+)
-if [[ -n "$AGENT_TYPE" ]]; then
-  STATE_DIR="$PROJECT_ROOT/.specweave/state"
-  mkdir -p "$STATE_DIR" 2>/dev/null
-
-  # Store agent type for other hooks to use
-  echo "$AGENT_TYPE" > "$STATE_DIR/.current-agent-type" 2>/dev/null
-
-  # Agent-specific startup messages
-  case "$AGENT_TYPE" in
-    sw:pm|sw-pm)
-      echo '{"continue":true,"systemMessage":"🎯 PM Agent: Product Management context loaded. Focus on user stories, acceptance criteria, and business value."}'
-      ;;
-    sw:architect|sw-architect)
-      echo '{"continue":true,"systemMessage":"🏗️ Architect Agent: Technical design context loaded. Focus on ADRs, system design, and architecture patterns."}'
-      ;;
-  esac
-fi
-
-# Hook directory for finding other scripts
-HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# === MCP Connection Health Check ===
-# Check for recent MCP drops that could cause session hangs
-CLAUDE_DEBUG="$HOME/.claude/debug/latest"
-if [[ -f "$CLAUDE_DEBUG" ]]; then
-  # Count MCP drops in last debug log (only check last 500 lines for speed)
-  MCP_DROPS=$(tail -500 "$CLAUDE_DEBUG" 2>/dev/null | grep -c "WS-IDE connection dropped" 2>/dev/null | head -1 || echo "0")
-  MCP_DROPS="${MCP_DROPS//[^0-9]/}"  # Strip non-numeric characters
-  [[ -z "$MCP_DROPS" ]] && MCP_DROPS=0
-  if [[ "$MCP_DROPS" -gt 2 ]]; then
-    echo "{\"continue\":true,\"systemMessage\":\"⚠️ MCP Connection Issues Detected: $MCP_DROPS drops in last session. Consider: (1) Restart VS Code Extension Host (Cmd+Shift+P), (2) Close extra files, (3) Use terminal mode if issues persist.\"}"
-  fi
-fi
-
-# Script paths (HOOK_DIR already defined above)
-# HOOK_DIR is hooks/v2/dispatchers (where this script is)
-# Need to go up THREE levels to reach plugin root: dispatchers -> v2 -> hooks -> plugin
-PLUGIN_ROOT="$(cd "$HOOK_DIR/../../.." && pwd)"
-SCRIPTS_DIR="$PLUGIN_ROOT/scripts"
-SCHEDULER_STARTUP="$PLUGIN_ROOT/lib/scheduler-startup.sh"
-CLEANUP_SCRIPT="$SCRIPTS_DIR/cleanup-legacy-state.sh"
-
-# === Dashboard Cache Validation (v0.34.0 - Instant Status Commands) ===
-# Rebuild cache if missing or schema version mismatch
-CACHE_FILE="$PROJECT_ROOT/.specweave/state/dashboard.json"
-REBUILD_SCRIPT="$SCRIPTS_DIR/rebuild-dashboard-cache.sh"
-CACHE_VERSION_EXPECTED=1
-
-if [[ -f "$REBUILD_SCRIPT" ]]; then
-  SHOULD_REBUILD=false
-
-  if [[ ! -f "$CACHE_FILE" ]]; then
-    # Cache missing - rebuild
-    SHOULD_REBUILD=true
-  elif command -v jq >/dev/null 2>&1; then
-    # Check version (only if jq available)
-    CACHE_VERSION=$(jq -r '.version // 0' "$CACHE_FILE" 2>/dev/null)
-    if [[ "$CACHE_VERSION" != "$CACHE_VERSION_EXPECTED" ]]; then
-      SHOULD_REBUILD=true
-    fi
-  fi
-
-  if [[ "$SHOULD_REBUILD" == "true" ]]; then
-    # Rebuild in background to not block session start
-    nohup bash "$REBUILD_SCRIPT" --quiet > /dev/null 2>&1 &
-    disown 2>/dev/null
-  fi
-fi
-
-# === AUTO-LOAD PLUGINS REMOVED (v1.0.159) ===
-# Project-file-based detection (specweave detect-project) was removed.
-#
-# REASON: Users want plugins installed ONLY when LLM determines they need them
-# for a specific BUILD task, not based on project file scanning.
-#
-# Plugin auto-loading now happens ONLY in user-prompt-submit.sh via LLM detection.
-# When user submits a prompt like "Build React dashboard", the LLM analyzes
-# the request and installs relevant plugins (backend, testing, etc.)
-#
-# To install plugins manually: vskill install --repo anton-abyzov/vskill --plugin backend
-
-# === LEGACY STATE CLEANUP (v1.0.148) ===
-# Clean up old processor state files on session start
-# This is a one-time migration - old files are removed automatically
-if [[ -f "$CLEANUP_SCRIPT" ]]; then
-  bash "$CLEANUP_SCRIPT" 2>/dev/null || true
-fi
-
-# Check for due scheduled jobs (non-blocking)
-if [[ -f "$SCHEDULER_STARTUP" ]]; then
-  bash "$SCHEDULER_STARTUP" 2>/dev/null || true
-fi
-
-# === LSP OPERATIONS (v1.0.197) ===
-# LSP check and warm-up ONLY run if user has explicitly enabled LSP via ENABLE_LSP_TOOL=1
-# This avoids wasted background work for users who don't use LSP features
-#
-# Why gate on ENABLE_LSP_TOOL:
-# 1. LSP requires explicit setup (language server binaries, Claude plugins)
-# 2. Not all users need semantic code intelligence
-# 3. Background processes consume resources
-# 4. LSP warm-up is triggered on-demand when user prompt contains LSP keywords
-#
-# To enable: Add "export ENABLE_LSP_TOOL=1" to ~/.zshrc or ~/.bashrc
-if [[ -n "${ENABLE_LSP_TOOL:-}" ]]; then
-  # === LSP LANGUAGE SERVER CHECK ===
-  # Verify language server binaries are installed for dominant project languages
-  LSP_CHECK_SCRIPT="$SCRIPTS_DIR/lsp-check.sh"
-  if [[ -x "$LSP_CHECK_SCRIPT" ]] || [[ -f "$LSP_CHECK_SCRIPT" ]]; then
-    mkdir -p "$PROJECT_ROOT/.specweave/logs" 2>/dev/null
-    nohup bash "$LSP_CHECK_SCRIPT" "$PROJECT_ROOT" \
-      >> "$PROJECT_ROOT/.specweave/logs/lsp-check.log" 2>&1 &
-    disown 2>/dev/null
-  fi
-
-  # NOTE: LSP warm-up is NOT done here on session start
-  # Instead, it's triggered lazily by user-prompt-submit.sh when:
-  # 1. User prompt contains LSP keywords ("find references", "go to definition", etc.)
-  # 2. AND warm-up hasn't been done yet this session
-  # This avoids warming up LSP for sessions that never use it
-fi
-
-# Session watchdog REMOVED (ADR-0224)
-# VSCode extension manages session lifecycle - no daemon needed
-# For stuck sessions: Close Claude Code or restart Extension Host
-
-exit 0

package/plugins/specweave/hooks/v2/guards/completion-guard.sh

@@ -1,14 +0,0 @@
-#!/bin/bash
-# completion-guard.sh - DISABLED (v1.0.38)
-#
-# This guard was converted to WARNING-only in v1.0.37, and now completely
-# disabled in v1.0.38 per user feedback: "you MUST NEVER block such operations"
-#
-# Completion workflow should be handled by agents/scripts with proper business logic,
-# not by hooks that can interfere with file operations.
-#
-# This guard now does NOTHING - just allows all operations.
-
-set +e
-echo '{"decision":"allow"}'
-exit 0

package/plugins/specweave/hooks/v2/guards/increment-duplicate-guard.sh

@@ -1,14 +0,0 @@
-#!/bin/bash
-# increment-duplicate-guard.sh - DISABLED (v1.0.38)
-#
-# This guard was converted to WARNING-only in v1.0.37, and now completely
-# disabled in v1.0.38 per user feedback: "you MUST NEVER block such operations"
-#
-# Duplicate detection should be handled by agents/scripts with proper business logic,
-# not by hooks that can interfere with file operations.
-#
-# This guard now does NOTHING - just allows all operations.
-
-set +e
-echo '{"decision":"allow"}'
-exit 0

package/plugins/specweave/hooks/v2/guards/increment-existence-guard.sh

@@ -1,240 +0,0 @@
-#!/bin/bash
-# increment-existence-guard.sh - Mode-aware guard for team creation
-#
-# PURPOSE:
-# Enforces spec-first principle for IMPLEMENTATION teams while allowing
-# non-implementation teams (review, brainstorm, analysis) to proceed freely.
-#
-# MODES:
-# - implementation (default): Requires increment with substantive spec.md
-# - review: PR reviews, code audits, architecture reviews — no increment needed
-# - brainstorm: Multi-perspective ideation sessions — no increment needed
-# - analysis: Codebase research, exploration, audits — no increment needed
-# - research: Codebase investigation and web research — no increment needed
-# - plan: Parallel planning with PM + Architect — creates its own increment
-#
-# MODE DETECTION (in priority order):
-# 1. team_name prefix: review-*, brainstorm-*, analysis-*, audit-*, research-*, plan-*
-# 2. description keywords: "review", "brainstorm", "analyze", "audit", "explore",
-#    "ideate", "research", "planning", "pr #", "pull request", "code review",
-#    "architecture review"
-# 3. Default: implementation mode (requires increment)
-#
-# DETECTION (implementation mode only):
-# - Fires on TeamCreate tool calls (global via hooks.json + skill-scoped via frontmatter)
-# - Scans .specweave/increments/ and repositories/*/*/.specweave/increments/
-# - Requires spec.md to pass ALL checks:
-#   1. File exists and has >500 bytes of content
-#   2. No template markers (exact strings or {{VAR}} patterns)
-#   3. At least one acceptance criterion (AC- pattern)
-# - BLOCKS if no qualifying increment found
-# - ALLOWS if at least one passes all checks
-#
-# @since 1.0.342
-# @updated 1.0.417 — multi-mode support
-
-set -e
-
-INPUT=$(cat)
-TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // .toolName // ""')
-
-# Only check TeamCreate
-if [[ "$TOOL_NAME" != "TeamCreate" ]]; then
-  echo '{"decision":"allow"}'
-  exit 0
-fi
-
-# Env var bypass — allows team creation without increment (e.g. specweave team --no-increment)
-if [[ "${SPECWEAVE_NO_INCREMENT:-}" == "1" ]]; then
-  echo '{"decision":"allow"}'
-  exit 0
-fi
-
-# --- MODE DETECTION ---
-# Extract team_name and description from the tool input
-TEAM_NAME=$(echo "$INPUT" | jq -r '.tool_input.team_name // .input.team_name // ""' 2>/dev/null)
-DESCRIPTION=$(echo "$INPUT" | jq -r '.tool_input.description // .input.description // ""' 2>/dev/null)
-
-# Lowercase for matching
-TEAM_NAME_LC=$(echo "$TEAM_NAME" | tr '[:upper:]' '[:lower:]')
-DESCRIPTION_LC=$(echo "$DESCRIPTION" | tr '[:upper:]' '[:lower:]')
-
-# Check 1: team_name prefix
-NON_IMPL_MODE=false
-case "$TEAM_NAME_LC" in
-  review-*|brainstorm-*|analysis-*|audit-*|explore-*|ideate-*|research-*|plan-*)
-    NON_IMPL_MODE=true
-    ;;
-esac
-
-# Check 2: description keywords (only if prefix didn't match)
-if [[ "$NON_IMPL_MODE" == "false" ]]; then
-  NON_IMPL_KEYWORDS=(
-    "review"
-    "brainstorm"
-    "analyze"
-    "audit"
-    "explore"
-    "ideate"
-    "pull request"
-    "pr #"
-    "pr review"
-    "code review"
-    "architecture review"
-    "security audit"
-    "performance audit"
-    "code audit"
-    "ideation"
-    "exploration"
-    "research"
-    "planning"
-    "perspectives"
-    "devil's advocate"
-    "pros and cons"
-  )
-
-  for keyword in "${NON_IMPL_KEYWORDS[@]}"; do
-    if [[ "$DESCRIPTION_LC" == *"$keyword"* ]]; then
-      NON_IMPL_MODE=true
-      break
-    fi
-  done
-fi
-
-# Non-implementation modes bypass the spec check entirely
-if [[ "$NON_IMPL_MODE" == "true" ]]; then
-  echo '{"decision":"allow"}'
-  exit 0
-fi
-
-# --- IMPLEMENTATION MODE: Require increment with spec ---
-
-# Template markers — spec.md with these is a template, not a real spec
-TEMPLATE_MARKERS=(
-  "[Story Title]"
-  "[user type]"
-  "[goal]"
-  "[benefit]"
-  "[Specific, testable criterion]"
-  "[Component 1]"
-  "[High-level description"
-  "{{RESOLVED_PROJECT}}"
-  "TEMPLATE FILE"
-)
-
-check_spec() {
-  local spec_path="$1"
-  if [[ ! -f "$spec_path" ]]; then
-    return 1
-  fi
-
-  # Check 1: Minimum size (500 bytes — a real spec with user stories and ACs)
-  local size
-  size=$(wc -c < "$spec_path" 2>/dev/null || echo "0")
-  size=$(echo "$size" | tr -d '[:space:]')
-  if [[ "$size" -le 500 ]]; then
-    return 1
-  fi
-
-  # Check 2: Scan FULL file for template markers (not just first 10 lines)
-  local content
-  content=$(cat "$spec_path" 2>/dev/null || echo "")
-
-  # Exact template marker strings
-  for marker in "${TEMPLATE_MARKERS[@]}"; do
-    if [[ "$content" == *"$marker"* ]]; then
-      return 1
-    fi
-  done
-
-  # Regex: {{UPPERCASE_VAR}} mustache placeholders (e.g., {{FEATURE_NAME}})
-  if echo "$content" | grep -qE '\{\{[A-Z_]+\}\}' 2>/dev/null; then
-    return 1
-  fi
-
-  # Regex: High count of [Bracket Placeholders] suggests unfilled template
-  # (threshold: 4+ to avoid false positives from markdown links [text](url))
-  local bracket_count
-  bracket_count=$(echo "$content" | grep -cE '\[[A-Z][^]]{2,}\]' 2>/dev/null || true)
-  bracket_count=$(echo "$bracket_count" | tail -1 | tr -d '[:space:]')
-  if [[ -n "$bracket_count" ]] && [[ "$bracket_count" -ge 4 ]]; then
-    return 1
-  fi
-
-  # Check 3: Structural completeness — at least one acceptance criterion
-  if ! grep -qE 'AC-US[0-9]+-[0-9]+|AC-[0-9]+' "$spec_path" 2>/dev/null; then
-    return 1
-  fi
-
-  return 0
-}
-
-# Search for qualifying increments
-FOUND=false
-
-# Detect project root via walk-up
-_DIR="$PWD"
-_LIMIT=0
-while [[ "$_DIR" != "/" ]] && [[ ! -f "$_DIR/.specweave/config.json" ]] && [[ $_LIMIT -lt 50 ]]; do
-  _DIR=$(dirname "$_DIR")
-  _LIMIT=$((_LIMIT + 1))
-done
-_ROOT="$_DIR"
-
-# Single-repo increments
-if [[ -d "$_ROOT/.specweave/increments" ]]; then
-  while IFS= read -r spec; do
-    if check_spec "$spec"; then
-      FOUND=true
-      break
-    fi
-  done < <(find "$_ROOT/.specweave/increments" -maxdepth 2 -name "spec.md" 2>/dev/null)
-fi
-
-# Multi-repo increments
-if [[ "$FOUND" == "false" ]] && [[ -d "$_ROOT/repositories" ]]; then
-  while IFS= read -r spec; do
-    if check_spec "$spec"; then
-      FOUND=true
-      break
-    fi
-  done < <(find "$_ROOT/repositories" -path "*/.specweave/increments/*/spec.md" -maxdepth 6 2>/dev/null)
-fi
-
-if [[ "$FOUND" == "true" ]]; then
-  echo '{"decision":"allow"}'
-  exit 0
-fi
-
-# BLOCK — no qualifying increment found (implementation mode only)
-REASON="SPEC-FIRST ENFORCEMENT: Increment Required Before Team Creation
-
-TeamCreate CANNOT proceed without an existing increment with a substantive spec.md.
-This requirement applies to IMPLEMENTATION teams only.
-
-No qualifying increment found. A valid spec.md must have:
-  - At least 500 bytes of real content (not templates)
-  - No unfilled template markers or {{PLACEHOLDER}} patterns
-  - At least one acceptance criterion (AC-USx-xx pattern)
-
-Searched:
-  - .specweave/increments/*/spec.md
-  - repositories/*/*/.specweave/increments/*/spec.md
-
-REQUIRED ACTION:
-  1. Run: /sw:increment \"your feature description\"
-  2. Review and approve the spec, plan, and tasks
-  3. THEN run: /sw:team-lead to parallelize execution
-
-ALTERNATIVE: For non-implementation work, use a mode-prefixed team name:
-  - review-*     → PR reviews, code audits (no increment needed)
-  - brainstorm-* → Ideation sessions (no increment needed)
-  - analysis-*   → Research and exploration (no increment needed)
-  - research-*   → Codebase research and investigation (no increment needed)
-  - plan-*       → Parallel planning with PM + Architect (creates increment)
-
-Workflow: /sw:increment → /sw:team-lead → /sw:done"
-
-REASON_ESCAPED=$(echo "$REASON" | jq -Rs .)
-echo "{\"decision\":\"block\",\"reason\":${REASON_ESCAPED}}"
-exit 0