claude-flow-novice 2.15.11 → 2.16.1

package/.claude/commands/cfn-loop-frontend.md

@@ -561,7 +561,7 @@ Before running frontend CFN Loop:
 
 - Guide: `.claude/commands/cfn/CFN_LOOP_FRONTEND.md` (742 lines, complete workflow)
 - Coordinator: `.claude/agents/cfn-dev-team/coordinators/cfn-frontend-coordinator.md`
-- Task Mode: `.claude/commands/cfn/CFN_LOOP_TASK_MODE.md`
+- Task Mode: `.claude/commands/CFN_LOOP_TASK_MODE.md`
 - Standard CFN Loop: `.claude/commands/cfn/cfn-loop.md`
 
 ---

package/.claude/commands/cfn-loop-task.md

@@ -106,7 +106,7 @@ You must execute this CFN Loop directly using the Task() tool to spawn agents.
 Read the complete Task Mode guide for detailed workflow:
 
 ```
-Read('.claude/commands/cfn/CFN_LOOP_TASK_MODE.md')
+Read('.claude/commands/CFN_LOOP_TASK_MODE.md')
 ```
 
 **Expected output:** Complete guide with agent selection, workflow steps, helper scripts
@@ -450,7 +450,7 @@ parse-decision.sh --output "$PO_OUTPUT"
 
 ## Related Documentation
 
-- **Task Mode Guide**: `.claude/commands/cfn/CFN_LOOP_TASK_MODE.md` (complete reference)
+- **Task Mode Guide**: `.claude/commands/CFN_LOOP_TASK_MODE.md` (complete reference)
 - Coordinator Parameters: `.claude/commands/cfn/CFN_COORDINATOR_PARAMETERS.md`
 - Agent Output Standards: `docs/AGENT_OUTPUT_STANDARDS.md`
 - ACE System: `.claude/skills/cfn-ace-system/SKILL.md`

package/.claude/commands/cfn-loop-trigger.md

@@ -0,0 +1,114 @@
+---
+description: "Execute CFN Loop via trigger.dev (replaces Redis coordination)"
+argument-hint: "<task description> [--mode=mvp|standard|enterprise] [--test-command=<cmd>] [--pass-rate=<0.0-1.0>]"
+allowed-tools: ["Bash", "TodoWrite", "Read"]
+---
+
+# CFN Loop trigger.dev Mode - Production Execution
+
+**IMPORTANT: This slash command MUST auto-execute the trigger.dev workflow via Bash tool.**
+
+**DO NOT just show instructions. EXECUTE the bash command immediately after reading this.**
+
+---
+
+## Execution Instructions (AUTO-EXECUTE)
+
+**Step 1: Parse Arguments**
+```
+TASK_DESCRIPTION: $ARGUMENTS (extract task, remove flags)
+MODE: Parse from --mode flag or default to "standard"
+TEST_COMMAND: Parse from --test-command flag or default to "npm test"
+PASS_RATE: Parse from --pass-rate flag or default based on mode (mvp=0.70, standard=0.95, enterprise=0.98)
+```
+
+**Step 2: Verify trigger.dev Environment**
+```bash
+# Check TRIGGER_API_KEY is set
+if [ -z "$TRIGGER_API_KEY" ]; then
+  # Try loading from trigger-test-app
+  if [ -f "/mnt/c/Users/masha/Documents/trigger-test-app/.env.local" ]; then
+    export $(grep -E '^TRIGGER_' /mnt/c/Users/masha/Documents/trigger-test-app/.env.local | xargs)
+    echo "✅ Loaded trigger.dev credentials from trigger-test-app"
+  else
+    echo "❌ ERROR: TRIGGER_API_KEY not set"
+    echo "   Set TRIGGER_API_KEY environment variable or create .env.local"
+    exit 1
+  fi
+fi
+
+export TRIGGER_API_URL="${TRIGGER_API_URL:-http://localhost:3040}"
+echo "✅ trigger.dev API: $TRIGGER_API_URL"
+```
+
+**Step 3: Generate Task ID**
+```bash
+TASK_ID="cfn-trigger-$(date +%s%N | tail -c 7)-${RANDOM}"
+echo "📋 Task ID: $TASK_ID"
+```
+
+**Step 4: Trigger CFN Loop Workflow (REQUIRED - Execute via Bash)**
+```bash
+cd /mnt/c/Users/masha/Documents/claude-flow-novice/trigger-dev && \
+TRIGGER_API_KEY="$TRIGGER_API_KEY" \
+TRIGGER_API_URL="$TRIGGER_API_URL" \
+npx tsx src/cli/trigger-cfn-loop.ts \
+  --task-id "$TASK_ID" \
+  --description "$TASK_DESCRIPTION" \
+  --mode "$MODE" \
+  --test-command "$TEST_COMMAND" \
+  --pass-rate "$PASS_RATE"
+```
+
+**Step 5: Inform User**
+After triggering workflow, tell user:
+- ✅ CFN Loop triggered via trigger.dev with task ID: $TASK_ID
+- 📊 Monitor in dashboard: http://localhost:3040
+- 🔍 Check status: `npx tsx trigger-dev/src/cli/index.ts cfn-loop status <event-id>`
+
+---
+
+## Background Information (DO NOT show unless asked)
+
+**Task**: $ARGUMENTS
+
+## What is trigger.dev Mode?
+
+**trigger.dev Mode Architecture:**
+- Main Chat triggers workflow via trigger.dev SDK event
+- trigger.dev orchestrates Loop 3 agents, gate checks, Loop 2 validators
+- No Redis required - uses trigger.dev's built-in job coordination
+- Dashboard visibility at http://localhost:3040
+- Automatic retries and error handling built-in
+
+**Advantages over CLI/Redis mode:**
+- ✅ No Redis dependency or BLPOP coordination issues
+- ✅ Visual dashboard for job monitoring
+- ✅ Built-in retry logic and error handling
+- ✅ Event-driven architecture (no polling)
+- ✅ Persistent job history and logs
+
+**Mode Thresholds:**
+| Mode | Pass Rate | Consensus | Max Iterations |
+|------|-----------|-----------|----------------|
+| MVP | 0.70 | 0.80 | 5 |
+| Standard | 0.95 | 0.90 | 10 |
+| Enterprise | 0.98 | 0.95 | 15 |
+
+---
+
+## Troubleshooting
+
+**trigger.dev not running:**
+```bash
+cd /mnt/c/Users/masha/Documents/docker/trigger.dev && docker-compose up -d
+```
+
+**Check service health:**
+```bash
+curl http://localhost:3040/api/v1/health
+```
+
+**View job logs:**
+- Dashboard: http://localhost:3040
+- Or: `npx tsx trigger-dev/src/cli/index.ts cfn-loop status <event-id> --poll`

package/.claude/commands/deprecated/cfn-loop.md

@@ -95,7 +95,7 @@ Extract parameters from command:
 
 ```javascript
 // Read Task Mode guide for agent specialization and workflow
-const taskModeGuide = await Read('.claude/commands/cfn/CFN_LOOP_TASK_MODE.md');
+const taskModeGuide = await Read('.claude/commands/CFN_LOOP_TASK_MODE.md');
 
 // Guide provides:
 // - Agent specialization (Loop 3: implementers, Loop 2: validators, Loop 4: PO)
@@ -274,7 +274,7 @@ Main Chat does NOT spawn a coordinator. Instead, it coordinates directly followi
 
 ```javascript
 // Step 1: Read Task Mode Guide
-const guide = await Read('.claude/commands/cfn/CFN_LOOP_TASK_MODE.md');
+const guide = await Read('.claude/commands/CFN_LOOP_TASK_MODE.md');
 
 // Step 2: Analyze Task Complexity (from guide)
 const complexity = analyzeComplexity({

package/.claude/hooks/cfn-invoke-post-edit-ts.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+
+##############################################################################
+# ⚠️  DEPRECATED - This bash script is deprecated
+#
+# Deprecation Date: 2025-11-20
+# Removal Date: 2026-02-20 (90 days)
+# Replacement: dist/cli/post-edit-hook.js
+#
+# This script will be removed in 90 days. Please migrate to TypeScript.
+#
+# Migration Guide: See docs/BASH_DEPRECATION_NOTICE.md
+# TypeScript Benefits:
+#   - Type safety (zero runtime type errors)
+#   - 90%+ test coverage
+#   - Better performance
+#   - Comprehensive documentation
+#
+# Automatic Migration:
+#   Set USE_TYPESCRIPT=true to use TypeScript implementation automatically
+#
+##############################################################################
+
+
+# Post-Edit Hook Invocation Script (TypeScript Implementation)
+# Validates files after modifications
+#
+# Usage:
+#   ./.claude/hooks/cfn-invoke-post-edit-ts.sh <file_path> [--agent-id <id>] [--blocking]
+#
+# Examples:
+#   ./.claude/hooks/cfn-invoke-post-edit-ts.sh src/file.ts
+#   ./.claude/hooks/cfn-invoke-post-edit-ts.sh src/file.ts --agent-id "coder-1"
+#   ./.claude/hooks/cfn-invoke-post-edit-ts.sh src/file.ts --blocking
+
+set -euo pipefail
+
+# Parse arguments
+FILE_PATH=""
+AGENT_ID="${AGENT_ID:-unknown}"
+BLOCKING=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --agent-id)
+            AGENT_ID="$2"
+            shift 2
+            ;;
+        --blocking)
+            BLOCKING=true
+            shift
+            ;;
+        *)
+            FILE_PATH="$1"
+            shift
+            ;;
+    esac
+done
+
+# Validate file path
+if [[ -z "$FILE_PATH" ]]; then
+    echo "Error: File path required"
+    echo "Usage: $0 <file_path> [--agent-id <id>] [--blocking]"
+    exit 1
+fi
+
+PROJECT_ROOT="$(git rev-parse --show-toplevel)" || exit 1
+
+# Try TypeScript implementation first
+if command -v node >/dev/null 2>&1 && [[ -f "$PROJECT_ROOT/dist/cli/post-edit-hook.js" ]]; then
+    echo "Running post-edit validation: $FILE_PATH"
+
+    # Run TypeScript implementation
+    VALIDATION_RESULT=$(node "$PROJECT_ROOT/dist/cli/post-edit-hook.js" "$FILE_PATH" --agent-id "$AGENT_ID" 2>&1 || true)
+    VALIDATION_EXIT=$?
+
+    # Check if validation failed and blocking is enabled
+    if [[ "$BLOCKING" == "true" ]] && [[ $VALIDATION_EXIT -ne 0 ]]; then
+        echo "❌ Post-edit validation failed (blocking mode)"
+        exit 1
+    fi
+
+    echo "✅ Post-edit validation complete"
+    exit 0
+else
+    # Fall back to bash implementation
+    PIPELINE="${PROJECT_ROOT}/.claude/hooks/cfn-invoke-post-edit.sh"
+
+    if [[ ! -f "$PIPELINE" ]]; then
+        echo "Error: Post-edit handler not found"
+        exit 1
+    fi
+
+    # Call bash implementation
+    if "$PIPELINE" "$FILE_PATH" --agent-id "$AGENT_ID" $([ "$BLOCKING" = "true" ] && echo "--blocking" || true); then
+        exit 0
+    else
+        exit 1
+    fi
+fi

package/.claude/hooks/cfn-invoke-post-edit-ts.sh.backup

@@ -0,0 +1,78 @@
+#!/bin/bash
+
+# Post-Edit Hook Invocation Script (TypeScript Implementation)
+# Validates files after modifications
+#
+# Usage:
+#   ./.claude/hooks/cfn-invoke-post-edit-ts.sh <file_path> [--agent-id <id>] [--blocking]
+#
+# Examples:
+#   ./.claude/hooks/cfn-invoke-post-edit-ts.sh src/file.ts
+#   ./.claude/hooks/cfn-invoke-post-edit-ts.sh src/file.ts --agent-id "coder-1"
+#   ./.claude/hooks/cfn-invoke-post-edit-ts.sh src/file.ts --blocking
+
+set -euo pipefail
+
+# Parse arguments
+FILE_PATH=""
+AGENT_ID="${AGENT_ID:-unknown}"
+BLOCKING=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --agent-id)
+            AGENT_ID="$2"
+            shift 2
+            ;;
+        --blocking)
+            BLOCKING=true
+            shift
+            ;;
+        *)
+            FILE_PATH="$1"
+            shift
+            ;;
+    esac
+done
+
+# Validate file path
+if [[ -z "$FILE_PATH" ]]; then
+    echo "Error: File path required"
+    echo "Usage: $0 <file_path> [--agent-id <id>] [--blocking]"
+    exit 1
+fi
+
+PROJECT_ROOT="$(git rev-parse --show-toplevel)" || exit 1
+
+# Try TypeScript implementation first
+if command -v node >/dev/null 2>&1 && [[ -f "$PROJECT_ROOT/dist/cli/post-edit-hook.js" ]]; then
+    echo "Running post-edit validation: $FILE_PATH"
+
+    # Run TypeScript implementation
+    VALIDATION_RESULT=$(node "$PROJECT_ROOT/dist/cli/post-edit-hook.js" "$FILE_PATH" --agent-id "$AGENT_ID" 2>&1 || true)
+    VALIDATION_EXIT=$?
+
+    # Check if validation failed and blocking is enabled
+    if [[ "$BLOCKING" == "true" ]] && [[ $VALIDATION_EXIT -ne 0 ]]; then
+        echo "❌ Post-edit validation failed (blocking mode)"
+        exit 1
+    fi
+
+    echo "✅ Post-edit validation complete"
+    exit 0
+else
+    # Fall back to bash implementation
+    PIPELINE="${PROJECT_ROOT}/.claude/hooks/cfn-invoke-post-edit.sh"
+
+    if [[ ! -f "$PIPELINE" ]]; then
+        echo "Error: Post-edit handler not found"
+        exit 1
+    fi
+
+    # Call bash implementation
+    if "$PIPELINE" "$FILE_PATH" --agent-id "$AGENT_ID" $([ "$BLOCKING" = "true" ] && echo "--blocking" || true); then
+        exit 0
+    else
+        exit 1
+    fi
+fi

package/.claude/hooks/cfn-invoke-post-edit.sh

@@ -1,4 +1,26 @@
 #!/bin/bash
+
+##############################################################################
+# ⚠️  DEPRECATED - This bash script is deprecated
+#
+# Deprecation Date: 2025-11-20
+# Removal Date: 2026-02-20 (90 days)
+# Replacement: dist/cli/post-edit-hook.js
+#
+# This script will be removed in 90 days. Please migrate to TypeScript.
+#
+# Migration Guide: See docs/BASH_DEPRECATION_NOTICE.md
+# TypeScript Benefits:
+#   - Type safety (zero runtime type errors)
+#   - 90%+ test coverage
+#   - Better performance
+#   - Comprehensive documentation
+#
+# Automatic Migration:
+#   Set USE_TYPESCRIPT=true to use TypeScript implementation automatically
+#
+##############################################################################
+
 #
 # Post-Edit Hook Invocation Script
 # Simplifies calling the post-edit pipeline from any agent
@@ -16,6 +38,28 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 CONFIG_FILE="$SCRIPT_DIR/cfn-post-edit.config.json"
 
+# Ensure jq is available (fallback to local download if sudo unavailable)
+JQ_CMD="jq"
+if ! command -v jq >/dev/null 2>&1; then
+    JQ_FALLBACK="$SCRIPT_DIR/../tools/jq"
+    if [ ! -x "$JQ_FALLBACK" ]; then
+        mkdir -p "$SCRIPT_DIR/../tools"
+        if command -v curl >/dev/null 2>&1; then
+            curl -fsSL -o "$JQ_FALLBACK" https://github.com/stedolan/jq/releases/download/jq-1.6/jq-linux64 && chmod +x "$JQ_FALLBACK" || true
+        elif command -v wget >/dev/null 2>&1; then
+            wget -q -O "$JQ_FALLBACK" https://github.com/stedolan/jq/releases/download/jq-1.6/jq-linux64 && chmod +x "$JQ_FALLBACK" || true
+        fi
+    fi
+    if [ -x "$JQ_FALLBACK" ]; then
+        JQ_CMD="$JQ_FALLBACK"
+    else
+        echo "Error: jq not found and download failed. Install jq or ensure curl/wget access." >&2
+        exit 1
+    fi
+else
+    JQ_CMD="$(command -v jq)"
+fi
+
 # Parse arguments
 FILE_PATH=""
 AGENT_ID="${AGENT_ID:-unknown}"
@@ -24,6 +68,10 @@ BLOCKING=false
 while [[ $# -gt 0 ]]; do
     case $1 in
         --agent-id)
+            if [[ -z "${2:-}" ]]; then
+                echo "Error: --agent-id requires a value" >&2
+                exit 1
+            fi
             AGENT_ID="$2"
             shift 2
             ;;
@@ -46,14 +94,14 @@ if [ -z "$FILE_PATH" ]; then
 fi
 
 # Check if hooks are enabled
-ENABLED=$(jq -r '.enabled // true' "$CONFIG_FILE" 2>/dev/null || echo "true")
+ENABLED=$("$JQ_CMD" -r '.enabled // true' "$CONFIG_FILE" 2>/dev/null || echo "true")
 if [ "$ENABLED" != "true" ]; then
     echo "Post-edit hooks disabled in config"
     exit 0
 fi
 
 # Get pipeline path from config
-PIPELINE=$(jq -r '.pipeline // "config/hooks/post-edit-pipeline.js"' "$CONFIG_FILE")
+PIPELINE=$("$JQ_CMD" -r '.pipeline // "config/hooks/post-edit-pipeline.js"' "$CONFIG_FILE")
 
 # Build memory key
 MEMORY_KEY="swarm/${AGENT_ID}/hook-results"
@@ -70,10 +118,10 @@ if [ "$BLOCKING" = true ] && [ $EXIT_CODE -ne 0 ]; then
 fi
 
 # Publish to Redis if enabled
-REDIS_ENABLED=$(jq -r '.redis.enabled // false' "$CONFIG_FILE")
+REDIS_ENABLED=$("$JQ_CMD" -r '.redis.enabled // false' "$CONFIG_FILE")
 if [ "$REDIS_ENABLED" = "true" ] && command -v redis-cli >/dev/null 2>&1; then
-    CHANNEL=$(jq -r '.redis.publishChannel // "swarm:hooks:post-edit"' "$CONFIG_FILE")
-    MESSAGE=$(jq -n \
+    CHANNEL=$("$JQ_CMD" -r '.redis.publishChannel // "swarm:hooks:post-edit"' "$CONFIG_FILE")
+    MESSAGE=$("$JQ_CMD" -n \
         --arg file "$FILE_PATH" \
         --arg agent "$AGENT_ID" \
         --arg exit "$EXIT_CODE" \

package/.claude/hooks/cfn-invoke-post-edit.sh.backup

@@ -0,0 +1,87 @@
+#!/bin/bash
+#
+# Post-Edit Hook Invocation Script
+# Simplifies calling the post-edit pipeline from any agent
+#
+# Usage:
+#   ./.claude/hooks/invoke-post-edit.sh <file_path> [--agent-id <id>] [--blocking]
+#
+# Examples:
+#   ./.claude/hooks/invoke-post-edit.sh src/file.ts
+#   ./.claude/hooks/invoke-post-edit.sh src/file.ts --agent-id "coder-1"
+#   ./.claude/hooks/invoke-post-edit.sh src/file.ts --blocking
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CONFIG_FILE="$SCRIPT_DIR/cfn-post-edit.config.json"
+
+# Parse arguments
+FILE_PATH=""
+AGENT_ID="${AGENT_ID:-unknown}"
+BLOCKING=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --agent-id)
+            AGENT_ID="$2"
+            shift 2
+            ;;
+        --blocking)
+            BLOCKING=true
+            shift
+            ;;
+        *)
+            FILE_PATH="$1"
+            shift
+            ;;
+    esac
+done
+
+# Validate file path
+if [ -z "$FILE_PATH" ]; then
+    echo "Error: File path required"
+    echo "Usage: $0 <file_path> [--agent-id <id>] [--blocking]"
+    exit 1
+fi
+
+# Check if hooks are enabled
+ENABLED=$(jq -r '.enabled // true' "$CONFIG_FILE" 2>/dev/null || echo "true")
+if [ "$ENABLED" != "true" ]; then
+    echo "Post-edit hooks disabled in config"
+    exit 0
+fi
+
+# Get pipeline path from config
+PIPELINE=$(jq -r '.pipeline // "config/hooks/post-edit-pipeline.js"' "$CONFIG_FILE")
+
+# Build memory key
+MEMORY_KEY="swarm/${AGENT_ID}/hook-results"
+
+# Execute pipeline
+echo "Running post-edit validation: $FILE_PATH"
+EXIT_CODE=0
+node "$PIPELINE" "$FILE_PATH" --memory-key "$MEMORY_KEY" || EXIT_CODE=$?
+
+# Handle exit codes based on blocking mode
+if [ "$BLOCKING" = true ] && [ $EXIT_CODE -ne 0 ]; then
+    echo "❌ Post-edit validation failed (blocking mode)"
+    exit $EXIT_CODE
+fi
+
+# Publish to Redis if enabled
+REDIS_ENABLED=$(jq -r '.redis.enabled // false' "$CONFIG_FILE")
+if [ "$REDIS_ENABLED" = "true" ] && command -v redis-cli >/dev/null 2>&1; then
+    CHANNEL=$(jq -r '.redis.publishChannel // "swarm:hooks:post-edit"' "$CONFIG_FILE")
+    MESSAGE=$(jq -n \
+        --arg file "$FILE_PATH" \
+        --arg agent "$AGENT_ID" \
+        --arg exit "$EXIT_CODE" \
+        --arg ts "$(date +%s)" \
+        '{file: $file, agentId: $agent, exitCode: $exit, timestamp: $ts}')
+
+    echo "$MESSAGE" | redis-cli -x PUBLISH "$CHANNEL" >/dev/null 2>&1 || true
+fi
+
+echo "✅ Post-edit validation complete (exit code: $EXIT_CODE)"
+exit 0  # Always exit 0 unless blocking mode

package/.claude/hooks/cfn-invoke-pre-edit-ts.sh

@@ -0,0 +1,116 @@
+#!/bin/bash
+
+##############################################################################
+# ⚠️  DEPRECATED - This bash script is deprecated
+#
+# Deprecation Date: 2025-11-20
+# Removal Date: 2026-02-20 (90 days)
+# Replacement: dist/cli/pre-edit-hook.js
+#
+# This script will be removed in 90 days. Please migrate to TypeScript.
+#
+# Migration Guide: See docs/BASH_DEPRECATION_NOTICE.md
+# TypeScript Benefits:
+#   - Type safety (zero runtime type errors)
+#   - 90%+ test coverage
+#   - Better performance
+#   - Comprehensive documentation
+#
+# Automatic Migration:
+#   Set USE_TYPESCRIPT=true to use TypeScript implementation automatically
+#
+##############################################################################
+
+
+# Pre-Edit Backup Hook Wrapper (TypeScript Implementation)
+# Creates backup before file modifications in agent workflows
+#
+# Usage: .claude/hooks/cfn-invoke-pre-edit-ts.sh FILE_PATH --agent-id AGENT_ID
+#
+# Arguments:
+#   FILE_PATH   - Absolute path to file about to be edited
+#   --agent-id  - Unique identifier for the agent performing the edit
+#
+# Returns:
+#   Backup directory path on success
+#   Exit code 1 on failure
+
+set -euo pipefail
+
+# === Parse Arguments ===
+
+FILE_PATH=""
+AGENT_ID=""
+
+# First positional argument is file path
+if [[ -n "${1:-}" ]] && [[ "$1" != --* ]]; then
+    FILE_PATH="$1"
+    shift
+fi
+
+# Parse remaining named arguments
+while [[ "$#" -gt 0 ]]; do
+    case $1 in
+        --agent-id)
+            if [[ -z "${2:-}" ]]; then
+                echo "Error: --agent-id requires a value" >&2
+                exit 1
+            fi
+            AGENT_ID="$2"
+            shift 2
+            ;;
+        *)
+            echo "Error: Unknown argument: $1" >&2
+            echo "Usage: cfn-invoke-pre-edit-ts.sh FILE_PATH --agent-id AGENT_ID" >&2
+            exit 1
+            ;;
+    esac
+done
+
+# === Validate Inputs ===
+
+if [[ -z "$FILE_PATH" ]]; then
+    echo "Error: No file path provided" >&2
+    echo "Usage: cfn-invoke-pre-edit-ts.sh FILE_PATH --agent-id AGENT_ID" >&2
+    exit 1
+fi
+
+if [[ -z "$AGENT_ID" ]]; then
+    echo "Error: No agent ID provided" >&2
+    echo "Usage: cfn-invoke-pre-edit-ts.sh FILE_PATH --agent-id AGENT_ID" >&2
+    exit 1
+fi
+
+if [[ ! -f "$FILE_PATH" ]]; then
+    echo "Error: File does not exist: $FILE_PATH" >&2
+    exit 1
+fi
+
+# === Execute Pre-Edit Backup ===
+
+PROJECT_ROOT="$(git rev-parse --show-toplevel)" || exit 1
+
+# Try to use compiled TypeScript version, fall back to bash
+if command -v node >/dev/null 2>&1 && [[ -f "$PROJECT_ROOT/dist/cli/pre-edit-hook.js" ]]; then
+    # Use TypeScript implementation
+    if ! BACKUP_DIR=$(node "$PROJECT_ROOT/dist/cli/pre-edit-hook.js" "$FILE_PATH" --agent-id "$AGENT_ID" 2>&1); then
+        echo "Error: Backup failed: $BACKUP_DIR" >&2
+        exit 1
+    fi
+else
+    # Fall back to bash implementation
+    BACKUP_SCRIPT="${PROJECT_ROOT}/.claude/hooks/cfn-invoke-pre-edit.sh"
+    if [[ ! -f "$BACKUP_SCRIPT" ]]; then
+        echo "Error: Backup script not found and TypeScript not available: $BACKUP_SCRIPT" >&2
+        exit 1
+    fi
+
+    if ! BACKUP_DIR=$("$BACKUP_SCRIPT" "$FILE_PATH" --agent-id "$AGENT_ID" 2>&1); then
+        echo "Error: Backup failed: $BACKUP_DIR" >&2
+        exit 1
+    fi
+fi
+
+# Return backup directory path
+echo "$BACKUP_DIR"
+exit 0