claude-flow-novice 2.15.11 → 2.16.0

package/claude-assets/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-assets/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-assets/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-assets/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
 #

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

@@ -0,0 +1,88 @@
+#!/bin/bash
+
+# Pre-Edit Backup Hook Wrapper
+# Creates backup before file modifications in agent workflows
+#
+# Usage: .claude/hooks/cfn-invoke-pre-edit.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
+#
+# Example:
+#   BACKUP_PATH=$(./.claude/hooks/cfn-invoke-pre-edit.sh "/path/to/file.txt" --agent-id "backend-dev-1")
+
+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.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.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.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 ===
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BACKUP_SCRIPT="${SCRIPT_DIR}/../skills/pre-edit-backup/backup.sh"
+
+if [[ ! -f "$BACKUP_SCRIPT" ]]; then
+    echo "Error: Backup script not found: $BACKUP_SCRIPT" >&2
+    exit 1
+fi
+
+# Execute backup and capture output
+if ! BACKUP_DIR=$("$BACKUP_SCRIPT" "$FILE_PATH" "$AGENT_ID" 2>&1); then
+    echo "Error: Backup failed: $BACKUP_DIR" >&2
+    exit 1
+fi
+
+# Return backup directory path
+echo "$BACKUP_DIR"
+exit 0