claude-flow-novice 2.15.11 → 2.16.0

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/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

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

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

@@ -0,0 +1,94 @@
+#!/bin/bash
+
+# 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

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

@@ -1,5 +1,27 @@
 #!/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
 # Creates backup before file modifications in agent workflows
 #