specweave 0.26.11 → 0.26.13

package/plugins/specweave/hooks/post-increment-status-change.sh.backup

@@ -0,0 +1,147 @@
+#!/bin/bash
+
+# SpecWeave Post-Increment-Status-Change Hook
+# Runs automatically after increment status changes (pause/resume/abandon)
+#
+# Trigger: /specweave:pause, /specweave:resume, /specweave:abandon commands
+# Purpose: Notify GitHub when increment status changes
+#
+# What it does:
+# 1. Detects status change (paused, resumed, abandoned)
+# 2. Posts comment to GitHub issue
+# 3. Updates metadata
+#
+# Usage:
+#   ./post-increment-status-change.sh <incrementId> <newStatus> <reason>
+#
+# Example:
+#   ./post-increment-status-change.sh 0015-hierarchical-sync paused "Waiting for API keys"
+
+set -e
+
+# Find project root
+find_project_root() {
+  local dir="$1"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.specweave" ]; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+  pwd
+}
+
+PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
+cd "$PROJECT_ROOT" 2>/dev/null || true
+
+# Configuration
+LOGS_DIR=".specweave/logs"
+DEBUG_LOG="$LOGS_DIR/hooks-debug.log"
+
+mkdir -p "$LOGS_DIR" 2>/dev/null || true
+
+# Arguments
+INCREMENT_ID="$1"
+NEW_STATUS="$2"
+REASON="$3"
+
+if [ -z "$INCREMENT_ID" ] || [ -z "$NEW_STATUS" ]; then
+  echo "Usage: $0 <incrementId> <newStatus> [reason]" >&2
+  echo "Example: $0 0015-hierarchical-sync paused 'Waiting for API'" >&2
+  exit 1
+fi
+
+echo "[$(date)] 📊 Status changed: $NEW_STATUS" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Validate status
+case "$NEW_STATUS" in
+  paused|resumed|abandoned)
+    ;;
+  *)
+    echo "[$(date)] ⚠️  Unknown status: $NEW_STATUS (skipping sync)" >> "$DEBUG_LOG" 2>/dev/null || true
+    exit 0
+    ;;
+esac
+
+# Check if GitHub CLI available
+if ! command -v gh &> /dev/null; then
+  echo "[$(date)] ℹ️  GitHub CLI not found, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  exit 0
+fi
+
+# Check if authenticated
+if ! gh auth status &> /dev/null; then
+  echo "[$(date)] ℹ️  GitHub CLI not authenticated, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  exit 0
+fi
+
+# Load metadata
+METADATA_FILE=".specweave/increments/$INCREMENT_ID/metadata.json"
+
+if [ ! -f "$METADATA_FILE" ]; then
+  echo "[$(date)] ℹ️  No metadata.json found, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  exit 0
+fi
+
+# Extract GitHub issue number
+GITHUB_ISSUE=$(jq -r '.github.issue // empty' "$METADATA_FILE" 2>/dev/null)
+
+if [ -z "$GITHUB_ISSUE" ]; then
+  echo "[$(date)] ℹ️  No GitHub issue linked, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  exit 0
+fi
+
+# Detect repository
+GITHUB_REMOTE=$(git remote get-url origin 2>/dev/null || echo "")
+REPO_MATCH=$(echo "$GITHUB_REMOTE" | grep -o 'github\.com[:/][^/]*/[^/]*' | sed 's/github\.com[:/]//')
+
+if [ -z "$REPO_MATCH" ]; then
+  echo "[$(date)] ⚠️  Could not detect GitHub repository" >> "$DEBUG_LOG" 2>/dev/null || true
+  exit 0
+fi
+
+echo "[$(date)] 🔄 Posting status change to GitHub issue #$GITHUB_ISSUE" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Build comment based on status
+EMOJI=""
+TITLE=""
+case "$NEW_STATUS" in
+  paused)
+    EMOJI="⏸️"
+    TITLE="Increment Paused"
+    ;;
+  resumed)
+    EMOJI="▶️"
+    TITLE="Increment Resumed"
+    ;;
+  abandoned)
+    EMOJI="🗑️"
+    TITLE="Increment Abandoned"
+    ;;
+esac
+
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+COMMENT="$EMOJI **$TITLE**
+
+**Reason**: ${REASON:-Not specified}
+
+**Timestamp**: $TIMESTAMP
+
+---
+🤖 Auto-updated by SpecWeave"
+
+# Post comment
+echo "$COMMENT" | gh issue comment "$GITHUB_ISSUE" --body-file - 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+  echo "[$(date)] ⚠️  Failed to post comment (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+}
+
+echo "[$(date)] ✅ Status change synced to GitHub" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Update status line cache (status changed - may affect which increment is "current")
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+bash "$HOOK_DIR/lib/update-status-line.sh" 2>/dev/null || true
+
+# Return success (non-blocking)
+exit 0

package/plugins/specweave/hooks/post-metadata-change.sh

@@ -192,6 +192,15 @@ case "$CURRENT_STATUS" in
     fi
     ;;
 
+  active|planning|in-progress)
+    # Increment became active - MUST register in active-increment.json!
+    # CRITICAL FIX (v0.26.15): post-task-completion.sh depends on this file
+    # Without registration, ALL sync operations are skipped!
+    echo "[$(date)] post-metadata-change: Status is $CURRENT_STATUS - registering as active + updating status line" >> "$DEBUG_LOG" 2>/dev/null || true
+    bash "$HOOK_DIR/lib/update-active-increment.sh" 2>/dev/null || true
+    bash "$HOOK_DIR/lib/update-status-line.sh" 2>/dev/null || true
+    ;;
+
   *)
     # Other metadata changes (e.g., task completion count, AC count)
     # Just update status line to reflect new progress

package/plugins/specweave/hooks/post-spec-update.sh.backup

@@ -0,0 +1,158 @@
+#!/bin/bash
+
+###############################################################################
+# SpecWeave Post-Spec-Update Hook
+#
+# CRITICAL ARCHITECTURE:
+# - Fires when .specweave/docs/internal/specs/spec-*.md is updated
+# - Auto-syncs to linked external tool (GitHub Project/Jira Epic/ADO Feature)
+# - Replaces increment-based sync (which was wrong!)
+#
+# Trigger Points:
+# 1. After /specweave:sync-docs update (spec updated from increment)
+# 2. After manual spec.md edits (user updates living docs directly)
+# 3. After bidirectional sync from external tool
+#
+# What It Does:
+# - Detects which spec was updated
+# - Checks if spec is linked to external tool (frontmatter: externalLinks)
+# - Syncs changes to GitHub Project / Jira Epic / ADO Feature
+# - Updates user stories, acceptance criteria, progress
+#
+# Usage:
+#   post-spec-update.sh <spec-file-path>
+#
+# Example:
+#   post-spec-update.sh .specweave/docs/internal/specs/spec-001-core-framework.md
+#
+###############################################################################
+
+set -euo pipefail
+
+# Arguments
+SPEC_FILE_PATH="${1:-}"
+
+# Validate arguments
+if [[ -z "$SPEC_FILE_PATH" ]]; then
+  echo "❌ Error: Spec file path required"
+  echo "Usage: post-spec-update.sh <spec-file-path>"
+  exit 1
+fi
+
+# Check if spec file exists
+if [[ ! -f "$SPEC_FILE_PATH" ]]; then
+  echo "❌ Error: Spec file not found: $SPEC_FILE_PATH"
+  exit 1
+fi
+
+# Extract spec ID from file path
+# Example: .specweave/docs/internal/specs/spec-001-core-framework.md → spec-001
+SPEC_ID=$(basename "$SPEC_FILE_PATH" .md)
+
+echo ""
+echo "🔗 Post-Spec-Update Hook"
+echo "   Spec: $SPEC_ID"
+echo "   File: $SPEC_FILE_PATH"
+
+# Load config to check if auto-sync is enabled
+CONFIG_FILE=".specweave/config.json"
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  echo "   ℹ️  No config file found, skipping auto-sync"
+  exit 0
+fi
+
+# Check if auto-sync is enabled
+AUTO_SYNC=$(jq -r '.hooks.post_spec_update.auto_sync // true' "$CONFIG_FILE")
+
+if [[ "$AUTO_SYNC" != "true" ]]; then
+  echo "   ℹ️  Auto-sync disabled in config, skipping"
+  exit 0
+fi
+
+# Parse spec frontmatter to detect external links
+# Use gray-matter or similar to extract YAML frontmatter
+# For now, use simple grep/sed approach
+
+# Check if GitHub link exists
+GITHUB_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE_PATH" | grep -A 5 "github:" | grep "projectId:" | sed 's/.*projectId: *//; s/ *$//' || echo "")
+
+# Check if Jira link exists
+JIRA_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE_PATH" | grep -A 5 "jira:" | grep "epicKey:" | sed 's/.*epicKey: *//; s/ *$//' || echo "")
+
+# Check if ADO link exists
+ADO_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE_PATH" | grep -A 5 "ado:" | grep "featureId:" | sed 's/.*featureId: *//; s/ *$//' || echo "")
+
+# Determine which provider to sync
+PROVIDER=""
+if [[ -n "$GITHUB_LINK" ]]; then
+  PROVIDER="github"
+  EXTERNAL_ID="$GITHUB_LINK"
+elif [[ -n "$JIRA_LINK" ]]; then
+  PROVIDER="jira"
+  EXTERNAL_ID="$JIRA_LINK"
+elif [[ -n "$ADO_LINK" ]]; then
+  PROVIDER="ado"
+  EXTERNAL_ID="$ADO_LINK"
+fi
+
+# No external link found - skip sync
+if [[ -z "$PROVIDER" ]]; then
+  echo "   ℹ️  Spec not linked to external tool, skipping sync"
+  echo "   Hint: Use /specweave-github:sync-spec or /specweave-jira:sync-spec to link"
+  exit 0
+fi
+
+echo "   🔗 Detected external link: $PROVIDER (ID: $EXTERNAL_ID)"
+
+# Sync to external tool based on provider
+case "$PROVIDER" in
+  github)
+    echo "   🔄 Syncing to GitHub Project..."
+
+    # Check if GitHub CLI is available
+    if ! command -v gh &> /dev/null; then
+      echo "   ⚠️  GitHub CLI (gh) not found, skipping sync"
+      exit 0
+    fi
+
+    # TODO: Call GitHub spec sync
+    # For now, just log the action
+    echo "   ✅ GitHub sync queued (implementation pending)"
+    ;;
+
+  jira)
+    echo "   🔄 Syncing to Jira Epic..."
+
+    # Check if Jira config exists
+    if [[ -z "${JIRA_DOMAIN:-}" ]]; then
+      echo "   ⚠️  Jira not configured (.env), skipping sync"
+      exit 0
+    fi
+
+    # TODO: Call Jira spec sync
+    echo "   ✅ Jira sync queued (implementation pending)"
+    ;;
+
+  ado)
+    echo "   🔄 Syncing to Azure DevOps Feature..."
+
+    # Check if ADO config exists
+    if [[ -z "${ADO_ORGANIZATION:-}" ]]; then
+      echo "   ⚠️  ADO not configured (.env), skipping sync"
+      exit 0
+    fi
+
+    # TODO: Call ADO spec sync
+    echo "   ✅ ADO sync queued (implementation pending)"
+    ;;
+
+  *)
+    echo "   ⚠️  Unknown provider: $PROVIDER"
+    exit 0
+    ;;
+esac
+
+echo "   ✅ Post-spec-update hook complete"
+echo ""
+
+exit 0

package/plugins/specweave/hooks/post-task-completion.sh

@@ -66,6 +66,14 @@ find_project_root() {
 PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
 cd "$PROJECT_ROOT" 2>/dev/null || true
 
+# ============================================================================
+# ULTRA-FAST EARLY EXIT FOR NON-SPECWEAVE PROJECTS (T-006 - v0.26.15)
+# ============================================================================
+# Skip ALL processing if not a SpecWeave project - saves ~50-100ms
+if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+  exit 0
+fi
+
 # ============================================================================
 # RECURSION PREVENTION (CRITICAL - v0.26.0 - FILE-BASED GUARD)
 # ============================================================================

package/plugins/specweave/hooks/post-task-edit.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+#
+# post-task-edit.sh (v0.26.16)
+#
+# Lightweight hook triggered after Edit on tasks.md
+# ONLY updates status line cache - no heavy processing!
+#
+# Purpose: Keep status line in sync when tasks are marked complete via Edit
+#
+# Performance target: <20ms (just calls update-status-line.sh)
+#
+set +e
+
+# EMERGENCY KILL SWITCH
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
+# Find hook directory
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Consume stdin (required for PostToolUse hooks)
+cat > /dev/null
+
+# Update status line cache (force refresh by removing mtime marker)
+PROJECT_ROOT="$PWD"
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
+done
+
+if [[ -d "$PROJECT_ROOT/.specweave" ]]; then
+  # Remove mtime markers to force full refresh
+  rm -f "$PROJECT_ROOT/.specweave/state/.status-mtime-"* 2>/dev/null || true
+
+  # Update status line
+  bash "$HOOK_DIR/lib/update-status-line.sh" 2>/dev/null || true
+fi
+
+exit 0

package/plugins/specweave/hooks/post-user-story-complete.sh.backup

@@ -0,0 +1,179 @@
+#!/bin/bash
+
+###############################################################################
+# SpecWeave Post-User-Story-Complete Hook
+#
+# CRITICAL ARCHITECTURE:
+# - Fires when user story marked complete in spec.md (AC checkbox checked)
+# - Updates external PM tool (GitHub Issue/Jira Story/ADO User Story)
+# - Moves GitHub card to "Done" / Closes Jira story / Completes ADO story
+#
+# Trigger Points:
+# 1. After user manually checks AC checkbox in spec.md
+# 2. After bidirectional sync updates AC status
+# 3. After increment completion syncs to spec
+#
+# What It Does:
+# - Detects which user story was completed (all AC checkboxes checked)
+# - Finds corresponding external item (GitHub Issue/Jira Story/ADO User Story)
+# - Updates item status to "Done" / "Closed"
+# - Adds completion comment with timestamp
+#
+# Usage:
+#   post-user-story-complete.sh <spec-id> <user-story-id>
+#
+# Example:
+#   post-user-story-complete.sh spec-001 US-001
+#
+###############################################################################
+
+set -euo pipefail
+
+# Arguments
+SPEC_ID="${1:-}"
+USER_STORY_ID="${2:-}"
+
+# Validate arguments
+if [[ -z "$SPEC_ID" || -z "$USER_STORY_ID" ]]; then
+  echo "❌ Error: Spec ID and User Story ID required"
+  echo "Usage: post-user-story-complete.sh <spec-id> <user-story-id>"
+  exit 1
+fi
+
+echo ""
+echo "🎉 Post-User-Story-Complete Hook"
+echo "   Spec: $SPEC_ID"
+echo "   User Story: $USER_STORY_ID"
+
+# Find spec file
+SPEC_FILE=""
+if [[ -f ".specweave/docs/internal/specs/$SPEC_ID.md" ]]; then
+  SPEC_FILE=".specweave/docs/internal/specs/$SPEC_ID.md"
+elif [[ -f ".specweave/docs/internal/projects/default/specs/$SPEC_ID.md" ]]; then
+  SPEC_FILE=".specweave/docs/internal/projects/default/specs/$SPEC_ID.md"
+else
+  echo "❌ Error: Spec file not found for $SPEC_ID"
+  exit 1
+fi
+
+# Load config to check if auto-sync is enabled
+CONFIG_FILE=".specweave/config.json"
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  echo "   ℹ️  No config file found, skipping auto-sync"
+  exit 0
+fi
+
+# Check if auto-sync is enabled
+AUTO_SYNC=$(jq -r '.hooks.post_user_story_complete.auto_sync // true' "$CONFIG_FILE")
+
+if [[ "$AUTO_SYNC" != "true" ]]; then
+  echo "   ℹ️  Auto-sync disabled in config, skipping"
+  exit 0
+fi
+
+# Parse spec frontmatter to detect external links
+# Check if GitHub link exists
+GITHUB_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE" | grep -A 5 "github:" | grep "projectId:" | sed 's/.*projectId: *//; s/ *$//' || echo "")
+
+# Check if Jira link exists
+JIRA_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE" | grep -A 5 "jira:" | grep "epicKey:" | sed 's/.*epicKey: *//; s/ *$//' || echo "")
+
+# Check if ADO link exists
+ADO_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE" | grep -A 5 "ado:" | grep "featureId:" | sed 's/.*featureId: *//; s/ *$//' || echo "")
+
+# Determine which provider to sync
+PROVIDER=""
+if [[ -n "$GITHUB_LINK" ]]; then
+  PROVIDER="github"
+  EXTERNAL_ID="$GITHUB_LINK"
+elif [[ -n "$JIRA_LINK" ]]; then
+  PROVIDER="jira"
+  EXTERNAL_ID="$JIRA_LINK"
+elif [[ -n "$ADO_LINK" ]]; then
+  PROVIDER="ado"
+  EXTERNAL_ID="$ADO_LINK"
+fi
+
+# No external link found - skip sync
+if [[ -z "$PROVIDER" ]]; then
+  echo "   ℹ️  Spec not linked to external tool, skipping sync"
+  exit 0
+fi
+
+echo "   🔗 Detected external link: $PROVIDER"
+
+# Update external tool based on provider
+case "$PROVIDER" in
+  github)
+    echo "   🔄 Updating GitHub Issue for $USER_STORY_ID..."
+
+    # Check if GitHub CLI is available
+    if ! command -v gh &> /dev/null; then
+      echo "   ⚠️  GitHub CLI (gh) not found, skipping sync"
+      exit 0
+    fi
+
+    # Find GitHub Issue for this user story
+    # Search for issue with title pattern "[USER_STORY_ID]"
+    REPO=$(git remote get-url origin | sed -E 's/.*github\.com[:/]([^/]+\/[^/]+)(\.git)?$/\1/')
+
+    # Search for issue
+    ISSUE_NUMBER=$(gh issue list --repo "$REPO" --search "\"[$USER_STORY_ID]\" in:title" --json number --jq '.[0].number' 2>/dev/null || echo "")
+
+    if [[ -z "$ISSUE_NUMBER" ]]; then
+      echo "   ⚠️  GitHub Issue not found for $USER_STORY_ID"
+      exit 0
+    fi
+
+    echo "   📝 Found GitHub Issue #$ISSUE_NUMBER"
+
+    # Close issue
+    gh issue close "$ISSUE_NUMBER" --repo "$REPO" --comment "✅ User story completed
+
+🤖 Auto-closed by SpecWeave hook
+Completed at: $(date -u +%Y-%m-%dT%H:%M:%SZ)" 2>/dev/null || {
+      echo "   ⚠️  Failed to close issue"
+      exit 0
+    }
+
+    echo "   ✅ GitHub Issue #$ISSUE_NUMBER closed"
+    ;;
+
+  jira)
+    echo "   🔄 Updating Jira Story for $USER_STORY_ID..."
+
+    # Check if Jira config exists
+    if [[ -z "${JIRA_DOMAIN:-}" ]]; then
+      echo "   ⚠️  Jira not configured (.env), skipping sync"
+      exit 0
+    fi
+
+    # TODO: Find Jira Story by title pattern
+    # TODO: Transition story to "Done" status
+    echo "   ✅ Jira story transition queued (implementation pending)"
+    ;;
+
+  ado)
+    echo "   🔄 Updating ADO User Story for $USER_STORY_ID..."
+
+    # Check if ADO config exists
+    if [[ -z "${ADO_ORGANIZATION:-}" ]]; then
+      echo "   ⚠️  ADO not configured (.env), skipping sync"
+      exit 0
+    fi
+
+    # TODO: Find ADO User Story by title pattern
+    # TODO: Update state to "Closed"
+    echo "   ✅ ADO user story update queued (implementation pending)"
+    ;;
+
+  *)
+    echo "   ⚠️  Unknown provider: $PROVIDER"
+    exit 0
+    ;;
+esac
+
+echo "   ✅ Post-user-story-complete hook complete"
+echo ""
+
+exit 0

package/plugins/specweave/hooks/pre-command-deduplication.sh

@@ -1,83 +1,73 @@
 #!/bin/bash
 
-# SpecWeave Pre-Command Deduplication Hook
+# SpecWeave Pre-Command Deduplication Hook (v0.26.14 - OPTIMIZED)
 # Fires BEFORE any command executes (UserPromptSubmit hook)
 # Purpose: Prevent duplicate command invocations within configurable time window
+#
+# OPTIMIZATIONS (v0.26.14):
+# 1. Early exit for non-SpecWeave projects (<1ms)
+# 2. Skip node spawn if deduplicator not available
+# 3. Pure bash stdin reading
 
-set +e  # EMERGENCY FIX: Changed from set -euo pipefail to prevent Claude Code crashes
+set +e
 
 # ==============================================================================
-# PROJECT ROOT DETECTION
+# ULTRA-FAST EARLY EXIT
 # ==============================================================================
 
-# Find project root by searching upward for .specweave/ directory
-find_project_root() {
-  local dir="$1"
-  while [ "$dir" != "/" ]; do
-    if [ -d "$dir/.specweave" ]; then
-      echo "$dir"
-      return 0
-    fi
-    dir="$(dirname "$dir")"
-  done
-  # Fallback: try current directory
-  if [ -d "$(pwd)/.specweave" ]; then
-    pwd
-  else
-    echo "$(pwd)"
-  fi
-}
-
-PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
-cd "$PROJECT_ROOT" 2>/dev/null || true
+# Quick check: If no .specweave in cwd or nearby, just approve
+if [[ ! -d ".specweave" ]] && [[ ! -d "../.specweave" ]] && [[ ! -d "../../.specweave" ]]; then
+  cat /dev/stdin > /dev/null  # Drain stdin
+  echo '{"decision":"approve"}'
+  exit 0
+fi
 
 # Read input JSON from stdin
 INPUT=$(cat)
 
 # ==============================================================================
-# DEDUPLICATION CHECK: Block duplicate commands within 1 second
+# DEDUPLICATION CHECK: Pure bash with file-based cache
 # ==============================================================================
 
-# Check if deduplication module is available
-if command -v node >/dev/null 2>&1 && [[ -f "dist/src/core/deduplication/command-deduplicator.js" ]]; then
-  # Use dedicated wrapper script for ES module compatibility
-  DEDUP_RESULT=$(echo "$INPUT" | node scripts/check-deduplication.js 2>/dev/null || echo "OK")
-
-  # Parse result
-  STATUS=$(echo "$DEDUP_RESULT" | head -1)
+# Use file-based deduplication (no node!) with 1-second TTL
+CACHE_DIR=".specweave/state/.dedup-cache"
+mkdir -p "$CACHE_DIR" 2>/dev/null || true
 
-  if [[ "$STATUS" == "DUPLICATE" ]]; then
-    # Get stats
-    STATS=$(echo "$DEDUP_RESULT" | tail -1)
+# Extract command from input (use jq if available, fallback to grep)
+if command -v jq >/dev/null 2>&1; then
+  COMMAND=$(echo "$INPUT" | jq -r '.prompt // ""' 2>/dev/null | head -c 100 | tr -d '\n' | tr '/' '_' | tr ' ' '_')
+else
+  COMMAND=$(echo "$INPUT" | grep -oP '"prompt"\s*:\s*"\K[^"]{0,100}' 2>/dev/null | tr '/' '_' | tr ' ' '_')
+fi
 
-    # Extract command and stats for readable message
-    COMMAND=$(echo "$STATS" | grep -o '"lastCommand":"[^"]*"' | cut -d'"' -f4 || echo "unknown")
-    TOTAL_BLOCKED=$(echo "$STATS" | grep -o '"totalDuplicatesBlocked":[0-9]*' | cut -d':' -f2 || echo "1")
-    CACHE_SIZE=$(echo "$STATS" | grep -o '"currentCacheSize":[0-9]*' | cut -d':' -f2 || echo "1")
+# Only check for SpecWeave commands
+if [[ "$COMMAND" == *specweave* ]]; then
+  CACHE_FILE="$CACHE_DIR/${COMMAND:0:50}.lock"
 
-    # Build error message WITHOUT embedding JSON (avoid escaping issues)
-    MESSAGE=$(cat <<'EOF'
+  # Check if cached and recent (within 1 second)
+  if [[ -f "$CACHE_FILE" ]]; then
+    CACHE_AGE=$(($(date +%s) - $(stat -f %m "$CACHE_FILE" 2>/dev/null || stat -c %Y "$CACHE_FILE" 2>/dev/null || echo 0)))
+    if [[ "$CACHE_AGE" -lt 1 ]]; then
+      cat <<EOF
 {
   "decision": "block",
-  "reason": "🚫 DUPLICATE COMMAND DETECTED\n\nCommand: `COMMAND_PLACEHOLDER`\nTime window: 1 second\n\nThis command was just executed! To prevent unintended duplicates, this invocation has been blocked.\n\n💡 If you meant to run this command again:\n  1. Wait 1 second\n  2. Run the command again\n\nDeduplication Stats:\n- Total duplicates blocked: BLOCKED_PLACEHOLDER\n- Commands in cache: CACHE_PLACEHOLDER"
+  "reason": "Duplicate command detected (within 1 second). Wait a moment and try again."
 }
 EOF
-)
-    # Replace placeholders (avoids JSON escaping issues)
-    # Use | as sed delimiter to avoid conflicts with / in command names
-    echo "$MESSAGE" | sed "s|COMMAND_PLACEHOLDER|$COMMAND|g" | sed "s|BLOCKED_PLACEHOLDER|$TOTAL_BLOCKED|g" | sed "s|CACHE_PLACEHOLDER|$CACHE_SIZE|g"
-    exit 0
+      exit 0
+    fi
   fi
+
+  # Update cache timestamp
+  touch "$CACHE_FILE" 2>/dev/null || true
+
+  # Cleanup old cache files (>10 seconds old)
+  find "$CACHE_DIR" -type f -mmin +1 -delete 2>/dev/null &
 fi
 
 # ==============================================================================
-# PASS THROUGH: No duplicate detected, proceed with command
+# PASS THROUGH: No duplicate detected
 # ==============================================================================
 
-cat <<EOF
-{
-  "decision": "approve"
-}
-EOF
-
+echo '{"decision":"approve"}'
 exit 0