claude-flow-novice 2.18.5 → 2.18.6

package/.claude/skills/cfn-agent-lifecycle/lib/selection/src/cli.ts

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+import { AgentSelector, AgentSelection } from './agent-selector';
+import * as path from 'path';
+
+/**
+ * CLI entry point for agent selection
+ * Usage: npx ts-node src/cli.ts "task description" [--min-validators N]
+ */
+async function main(): Promise<void> {
+  try {
+    // Parse command line arguments
+    const args = process.argv.slice(2);
+
+    if (args.length === 0) {
+      // No task description provided, return default
+      const defaultResult: AgentSelection = {
+        loop3: ['backend-developer', 'devops-engineer'],
+        loop2: ['code-reviewer', 'tester', 'code-quality-validator'],
+        product_owner: 'product-owner',
+        category: 'default',
+        confidence: 0.70
+      };
+      console.log(JSON.stringify(defaultResult));
+      return;
+    }
+
+    const taskDescription = args[0];
+    let minValidators = 3;
+
+    // Parse optional parameters
+    for (let i = 1; i < args.length; i++) {
+      if (args[i] === '--min-validators' && i + 1 < args.length) {
+        const parsed = parseInt(args[i + 1], 10);
+        if (!isNaN(parsed) && parsed > 0) {
+          minValidators = parsed;
+        }
+        i++;
+      }
+    }
+
+    // Create selector with proper paths
+    const projectRoot = process.env.PROJECT_ROOT || process.cwd();
+    const mappingsPath = path.join(
+      projectRoot,
+      '.claude/skills/cfn-agent-selection-with-fallback/agent-mappings.json'
+    );
+    const agentsDir = path.join(projectRoot, '.claude/agents/cfn-dev-team');
+
+    const selector = new AgentSelector(mappingsPath, agentsDir);
+
+    // Select agents
+    const result = await selector.selectAgents(taskDescription, minValidators);
+
+    // Output JSON
+    console.log(JSON.stringify(result));
+  } catch (error) {
+    // Return error response with fallback agents
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    const errorResult: AgentSelection = {
+      loop3: ['backend-developer', 'devops-engineer'],
+      loop2: ['code-reviewer', 'tester', 'code-quality-validator'],
+      product_owner: 'product-owner',
+      category: 'default',
+      confidence: 0.70
+    };
+
+    console.error(`[ERROR] ${errorMessage}`, );
+    console.log(JSON.stringify(errorResult));
+    process.exit(1);
+  }
+}
+
+main();

package/.claude/skills/cfn-agent-lifecycle/lib/selection/task-classifier.sh

@@ -0,0 +1,93 @@
+#!/usr/bin/env bash
+
+##############################################################################
+# ⚠️  DEPRECATED - This bash script is deprecated
+#
+# Deprecation Date: 2025-11-20
+# Removal Date: 2026-02-20 (90 days)
+# Replacement: dist/cli.cjs
+#
+# 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
+#
+##############################################################################
+
+set -eu
+
+# Task Classifier - Categorize tasks into predefined types
+# Usage: ./task-classifier.sh "task description"
+
+TASK_DESCRIPTION="${1:-}"
+
+if [ -z "$TASK_DESCRIPTION" ]; then
+  echo "default"
+  exit 0
+fi
+
+# Convert to lowercase for matching
+TASK_LOWER=$(echo "$TASK_DESCRIPTION" | tr '[:upper:]' '[:lower:]')
+
+# Classification logic (priority order matters)
+
+# Security (highest priority - security-critical)
+if echo "$TASK_LOWER" | grep -qE "(security|vulnerability|exploit|encryption|ssl|tls|certificate|oauth|saml|rbac|permission|auth|jwt|authentication|authorization)"; then
+  echo "security"
+  exit 0
+fi
+
+# Infrastructure (DevOps, Docker, K8s)
+if echo "$TASK_LOWER" | grep -qE "(docker|kubernetes|k8s|helm|deployment|ci/cd|pipeline|aws|gcp|azure|cloud|terraform|ansible|infrastructure)"; then
+  echo "infrastructure"
+  exit 0
+fi
+
+# Mobile (iOS, Android, React Native)
+if echo "$TASK_LOWER" | grep -qE "(mobile|ios|android|react-native|react native|swift|kotlin|flutter|app store|play store)"; then
+  echo "mobile"
+  exit 0
+fi
+
+# Fullstack (Frontend + Backend keywords)
+if echo "$TASK_LOWER" | grep -qE "(fullstack|full-stack|full stack)" || \
+   (echo "$TASK_LOWER" | grep -qE "(react|vue|angular|svelte|frontend|ui)" && \
+    echo "$TASK_LOWER" | grep -qE "(api|backend|server|database|endpoint)"); then
+  echo "fullstack"
+  exit 0
+fi
+
+# Performance (Optimization, benchmarking) - Check early due to broad keywords
+if echo "$TASK_LOWER" | grep -qE "(performance|benchmark|latency|throughput|profiling|memory leak|cpu usage|slow|optimize|optimiz)"; then
+  echo "performance"
+  exit 0
+fi
+
+# Database (Schema, migrations, design)
+if echo "$TASK_LOWER" | grep -qE "(schema|migration|index|database.*query|sql|nosql|postgres|mongodb|redis|mysql|database design|table design|user.*table|create.*table)"; then
+  echo "database"
+  exit 0
+fi
+
+# Frontend (React, TypeScript, UI/UX)
+if echo "$TASK_LOWER" | grep -qE "(react|vue|angular|svelte|typescript|javascript|css|scss|tailwind|ui|ux|design|component|frontend|next\.js|remix)"; then
+  echo "frontend"
+  exit 0
+fi
+
+# Backend API (REST, GraphQL, endpoints)
+if echo "$TASK_LOWER" | grep -qE "(api|rest|graphql|endpoint|middleware|express|fastify|nest\.js|backend|server|microservice)"; then
+  echo "backend-api"
+  exit 0
+fi
+
+# Default fallback
+echo "default"
+exit 0

package/.claude/skills/cfn-agent-lifecycle/lib/spawning/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: cfn-agent-spawning
+description: Agent process spawning with provider configuration and execution
+version: 1.0.0
+tags: [agent-spawning, process-management, execution]
+status: production
+---
+
+# Agent Spawning Submodule
+
+**Parent Skill:** cfn-agent-lifecycle
+**Purpose:** Spawn agent processes with proper environment and provider configuration
+
+## Components
+
+- `spawn-agent.sh` - Primary agent spawning script
+- `spawn-worker.sh` - Worker process spawning
+- `spawn-agent-wrapper.sh` - Wrapper for standardized spawning
+- `spawn-templates.sh` - Template-based spawning
+- `execute-agent.sh` - Agent execution handler
+- `get-agent-provider-env.sh` - Provider environment configuration
+- `parse-agent-provider.sh` - Provider parsing utilities
+- `check-dependencies.sh` - Dependency validation
+
+## Usage
+
+```bash
+# Spawn an agent
+./.claude/skills/cfn-agent-lifecycle/lib/spawning/spawn-agent.sh \
+  --agent-type backend-dev \
+  --task-id "task-123" \
+  --provider kimi
+
+# Execute agent directly
+./.claude/skills/cfn-agent-lifecycle/lib/spawning/execute-agent.sh \
+  --agent-id "agent-123" \
+  --task "implement feature"
+```

package/.claude/skills/cfn-agent-lifecycle/lib/spawning/check-dependencies.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+
+##############################################################################
+# ⚠️  DEPRECATED - This bash script is deprecated
+#
+# Deprecation Date: 2025-11-20
+# Removal Date: 2026-02-20 (90 days)
+# Replacement: dist/cli/spawn-agent-cli.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
+#
+##############################################################################
+
+# Dependency checker for Agent Spawning
+
+check_command() {
+  if command -v "$1" &> /dev/null; then
+    VERSION=$($1 --version 2>&1 | head -n1)
+    echo "✅ $1: $VERSION"
+    return 0
+  else
+    echo "❌ $1: NOT FOUND"
+    return 1
+  fi
+}
+
+echo "Checking dependencies for Agent Spawning..."
+MISSING=0
+
+# Required dependencies
+check_command "bash" || MISSING=$((MISSING+1))
+check_command "jq" || MISSING=$((MISSING+1))
+
+if [ $MISSING -eq 0 ]; then
+  echo ""
+  echo "✅ All required dependencies installed"
+  exit 0
+else
+  echo ""
+  echo "❌ Missing $MISSING required dependencies"
+  exit 1
+fi

package/.claude/skills/cfn-agent-lifecycle/lib/spawning/execute-agent.sh

@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+##############################################################################
+# Agent Execution Script
+#
+# Executes CLI-spawned agents by invoking Claude API with agent prompt.
+# Supports both Anthropic and z.ai provider routing.
+#
+# Environment Variables:
+#   AGENT_TYPE      - Agent type/name (e.g., "rust-enterprise-developer")
+#   AGENT_ID        - Unique agent identifier (e.g., "rust-enterprise-1")
+#   AGENT_MODEL     - Model to use (haiku, sonnet, opus)
+#   AGENT_TOOLS     - Comma-separated list of tools
+#   TASK_ID         - Task identifier for CFN Loop coordination
+#   ITERATION       - Current iteration number
+#   MODE            - Execution mode (cli, api, hybrid)
+#   PROMPT_FILE     - Path to file containing agent prompt
+#
+# Usage:
+#   ./execute-agent.sh
+##############################################################################
+
+set -euo pipefail
+
+# Validate required environment variables
+if [ -z "${AGENT_TYPE:-}" ]; then
+  echo "Error: AGENT_TYPE environment variable required" >&2
+  exit 1
+fi
+
+if [ -z "${PROMPT_FILE:-}" ] || [ ! -f "${PROMPT_FILE:-}" ]; then
+  echo "Error: PROMPT_FILE must be set and file must exist" >&2
+  exit 1
+fi
+
+# Default values
+AGENT_ID="${AGENT_ID:-${AGENT_TYPE}-1}"
+AGENT_MODEL="${AGENT_MODEL:-haiku}"
+TASK_ID="${TASK_ID:-}"
+ITERATION="${ITERATION:-1}"
+MODE="${MODE:-cli}"
+
+echo "=== Agent Execution ==="
+echo "Agent Type: $AGENT_TYPE"
+echo "Agent ID: $AGENT_ID"
+echo "Model: $AGENT_MODEL"
+echo "Task ID: ${TASK_ID:-N/A}"
+echo "Iteration: $ITERATION"
+echo "Mode: $MODE"
+echo ""
+
+# Read prompt from file
+PROMPT=$(cat "$PROMPT_FILE")
+
+# Determine API provider
+API_PROVIDER="anthropic"
+if [ -f ".claude/cfn-config/api-provider.json" ]; then
+  PROVIDER_CONFIG=$(cat .claude/cfn-config/api-provider.json)
+  if echo "$PROVIDER_CONFIG" | grep -q '"provider".*"zai"'; then
+    API_PROVIDER="zai"
+  fi
+fi
+
+if [ "${CLAUDE_API_PROVIDER:-}" = "zai" ]; then
+  API_PROVIDER="zai"
+fi
+
+echo "API Provider: $API_PROVIDER"
+echo ""
+
+# Map agent model to API model name
+case "$AGENT_MODEL" in
+  haiku)
+    API_MODEL="claude-3-5-haiku-20241022"
+    ;;
+  sonnet)
+    API_MODEL="claude-3-5-sonnet-20241022"
+    ;;
+  opus)
+    API_MODEL="claude-3-opus-20240229"
+    ;;
+  *)
+    echo "Warning: Unknown model '$AGENT_MODEL', defaulting to haiku" >&2
+    API_MODEL="claude-3-5-haiku-20241022"
+    ;;
+esac
+
+# For now, we'll simulate agent execution by echoing the prompt
+# TODO: Implement actual API calls when API client is ready
+echo "=== Agent Prompt (First 500 chars) ==="
+echo "$PROMPT" | head -c 500
+echo "..."
+echo ""
+echo "=== Agent Execution Status ==="
+echo "✅ Agent prompt prepared successfully"
+echo "⚠️  Note: Direct API execution not yet implemented"
+echo ""
+echo "Next Steps:"
+echo "1. Integrate with Claude API SDK"
+echo "2. Implement streaming response handling"
+echo "3. Add tool execution support"
+echo ""
+
+# For CFN Loop agents, simulate completion protocol
+if [ -n "$TASK_ID" ]; then
+  echo "=== CFN Loop Simulation ==="
+  echo "This agent would execute the following protocol:"
+  echo ""
+  echo "1. Execute task work"
+  echo "2. redis-cli lpush \"swarm:${TASK_ID}:${AGENT_ID}:done\" \"complete\""
+  echo "3. ./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh report \\"
+  echo "     --task-id \"$TASK_ID\" \\"
+  echo "     --agent-id \"$AGENT_ID\" \\"
+  echo "     --confidence 0.85 \\"
+  echo "     --iteration $ITERATION"
+  echo "4. ./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh enter \\"
+  echo "     --task-id \"$TASK_ID\" \\"
+  echo "     --agent-id \"$AGENT_ID\" \\"
+  echo "     --context \"iteration-complete\""
+  echo ""
+fi
+
+# Clean up prompt file
+rm -f "$PROMPT_FILE"
+
+# Exit with success (temporary until real execution implemented)
+exit 0

package/.claude/skills/cfn-agent-lifecycle/lib/spawning/get-agent-provider-env.sh

@@ -0,0 +1,149 @@
+#!/bin/bash
+
+##############################################################################
+# ⚠️  DEPRECATED - This bash script is deprecated
+#
+# Deprecation Date: 2025-11-20
+# Removal Date: 2026-02-20 (90 days)
+# Replacement: agent-definition-parser.ts
+#
+# 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
+#
+##############################################################################
+
+
+# Get Agent Provider Environment Variables
+# Determines which provider environment variables to use for CLI/Docker agent spawning
+#
+# Logic:
+# 1. If custom routing is disabled, use Main Chat settings (from .claude/settings.json)
+# 2. If custom routing is enabled:
+#    a. Check agent profile for PROVIDER_PARAMETERS
+#    b. If found, use agent-specific provider/model
+#    c. If not found, use Main Chat settings
+#
+# Usage: source get-agent-provider-env.sh AGENT_TYPE
+# Exports: ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL, ANTHROPIC_SMALL_FAST_MODEL
+
+set -euo pipefail
+
+AGENT_TYPE="${1:-}"
+CUSTOM_ROUTING_ENABLED="${CFN_CUSTOM_ROUTING:-false}"
+SETTINGS_FILE=".claude/settings.json"
+
+if [[ -z "$AGENT_TYPE" ]]; then
+    echo "Usage: source $0 AGENT_TYPE" >&2
+    return 1 2>/dev/null || exit 1
+fi
+
+# Function to get provider config (zai, kimi, openrouter, gemini, xai, anthropic)
+get_provider_config() {
+    local provider="$1"
+    local model="${2:-}"
+
+    case "$provider" in
+        zai)
+            export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
+            export ANTHROPIC_AUTH_TOKEN="${ZAI_API_KEY:-}"
+            export ANTHROPIC_MODEL="${model:-glm-4.6}"
+            export ANTHROPIC_SMALL_FAST_MODEL="${model:-glm-4.6}"
+            ;;
+        kimi)
+            export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
+            export ANTHROPIC_AUTH_TOKEN="${KIMI_API_KEY:-}"
+            export ANTHROPIC_MODEL="${model:-kimi-k2-turbo-preview}"
+            export ANTHROPIC_SMALL_FAST_MODEL="${model:-kimi-k2-turbo-preview}"
+            ;;
+        openrouter)
+            export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
+            export ANTHROPIC_AUTH_TOKEN="${OPENROUTER_API_KEY:-}"
+            export ANTHROPIC_MODEL="${model:-anthropic/claude-sonnet-4.5}"
+            export ANTHROPIC_SMALL_FAST_MODEL="${model:-anthropic/claude-sonnet-4.5}"
+            ;;
+        gemini)
+            export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
+            export ANTHROPIC_AUTH_TOKEN="${OPENROUTER_API_KEY:-}"
+            export ANTHROPIC_MODEL="${model:-google/gemini-2.0-flash-001}"
+            export ANTHROPIC_SMALL_FAST_MODEL="${model:-google/gemini-2.0-flash-001}"
+            ;;
+        xai)
+            export ANTHROPIC_BASE_URL="https://api.x.ai/v1"
+            export ANTHROPIC_AUTH_TOKEN="${XAI_API_KEY:-}"
+            export ANTHROPIC_MODEL="${model:-grok-beta}"
+            export ANTHROPIC_SMALL_FAST_MODEL="${model:-grok-beta}"
+            ;;
+        anthropic|*)
+            # Use default Anthropic settings (remove custom env vars)
+            unset ANTHROPIC_BASE_URL
+            unset ANTHROPIC_AUTH_TOKEN
+            unset ANTHROPIC_MODEL
+            unset ANTHROPIC_SMALL_FAST_MODEL
+            ;;
+    esac
+}
+
+# Function to detect provider from base URL
+detect_provider_from_url() {
+    local base_url="$1"
+    local model="${2:-}"
+
+    if [[ "$base_url" == *"z.ai"* ]]; then
+        echo "zai"
+    elif [[ "$base_url" == *"moonshot.ai"* ]]; then
+        echo "kimi"
+    elif [[ "$base_url" == *"x.ai"* ]]; then
+        echo "xai"
+    elif [[ "$base_url" == *"openrouter.ai"* ]]; then
+        # Check if model is Gemini
+        if [[ "$model" == google/gemini* ]]; then
+            echo "gemini"
+        else
+            echo "openrouter"
+        fi
+    else
+        echo "anthropic"
+    fi
+}
+
+# Step 1: Check if custom routing is enabled
+if [[ "$CUSTOM_ROUTING_ENABLED" != "true" ]]; then
+    # Custom routing disabled - use Main Chat settings from .claude/settings.json
+    if [[ -f "$SETTINGS_FILE" ]]; then
+        BASE_URL=$(jq -r '.env.ANTHROPIC_BASE_URL // empty' "$SETTINGS_FILE" 2>/dev/null || echo "")
+
+        if [[ -n "$BASE_URL" ]]; then
+            # Main Chat has custom provider configured
+            export ANTHROPIC_BASE_URL="$BASE_URL"
+            export ANTHROPIC_AUTH_TOKEN=$(jq -r '.env.ANTHROPIC_AUTH_TOKEN // empty' "$SETTINGS_FILE" 2>/dev/null || echo "")
+            export ANTHROPIC_MODEL=$(jq -r '.env.ANTHROPIC_MODEL // empty' "$SETTINGS_FILE" 2>/dev/null || echo "")
+            export ANTHROPIC_SMALL_FAST_MODEL=$(jq -r '.env.ANTHROPIC_SMALL_FAST_MODEL // empty' "$SETTINGS_FILE" 2>/dev/null || echo "")
+        fi
+        # else: No custom provider, use default Anthropic
+    fi
+    return 0 2>/dev/null || exit 0
+fi
+
+# Step 2: Custom routing enabled - check agent profile for PROVIDER_PARAMETERS
+AGENT_PROVIDER=$(bash .claude/skills/cfn-agent-spawning/parse-agent-provider.sh "$AGENT_TYPE" --field provider)
+AGENT_MODEL=$(bash .claude/skills/cfn-agent-spawning/parse-agent-provider.sh "$AGENT_TYPE" --field model)
+
+if [[ -n "$AGENT_PROVIDER" ]]; then
+    # Agent has provider parameters - use them
+    get_provider_config "$AGENT_PROVIDER" "$AGENT_MODEL"
+else
+    # No agent-specific provider - default to Z.ai with glm-4.6
+    export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
+    export ANTHROPIC_AUTH_TOKEN="${ZAI_API_KEY:-}"
+    export ANTHROPIC_MODEL="glm-4.6"
+    export ANTHROPIC_SMALL_FAST_MODEL="glm-4.6"
+fi

package/.claude/skills/cfn-agent-lifecycle/lib/spawning/parse-agent-provider.sh

@@ -0,0 +1,81 @@
+#!/bin/bash
+
+##############################################################################
+# ⚠️  DEPRECATED - This bash script is deprecated
+#
+# Deprecation Date: 2025-11-20
+# Removal Date: 2026-02-20 (90 days)
+# Replacement: agent-definition-parser.ts
+#
+# 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
+#
+##############################################################################
+
+
+# Parse Agent Provider Parameters
+# Extracts provider and model from agent profile's PROVIDER_PARAMETERS section
+# Usage: parse-agent-provider.sh AGENT_TYPE [--field provider|model]
+
+set -euo pipefail
+
+AGENT_TYPE="${1:-}"
+FIELD="${2:---field}"
+FIELD_VALUE="${3:-provider}"
+
+if [[ -z "$AGENT_TYPE" ]]; then
+    echo "Usage: $0 AGENT_TYPE [--field provider|model]" >&2
+    exit 1
+fi
+
+# Find agent file in multiple locations
+AGENT_FILE=""
+SEARCH_PATHS=(
+    ".claude/agents/cfn-dev-team/**/${AGENT_TYPE}.md"
+    ".claude/agents/custom/${AGENT_TYPE}.md"
+    ".claude/agents/${AGENT_TYPE}.md"
+)
+
+for pattern in "${SEARCH_PATHS[@]}"; do
+    # Use find with glob pattern
+    while IFS= read -r -d '' file; do
+        if [[ -f "$file" ]]; then
+            AGENT_FILE="$file"
+            break 2
+        fi
+    done < <(find .claude/agents -type f -name "${AGENT_TYPE}.md" -print0 2>/dev/null)
+done
+
+if [[ -z "$AGENT_FILE" ]]; then
+    # Agent file not found, return empty (will fallback to main chat settings)
+    echo ""
+    exit 0
+fi
+
+# Extract PROVIDER_PARAMETERS section
+# Format:
+# <!-- PROVIDER_PARAMETERS
+# provider: kimi
+# model: kimi-k2-turbo-preview
+# -->
+
+PARAM_VALUE=$(awk '
+    /<!-- PROVIDER_PARAMETERS/,/-->/ {
+        if ($0 ~ /^'"${FIELD_VALUE}"':/) {
+            sub(/^'"${FIELD_VALUE}"':[ \t]*/, "")
+            print $0
+            exit
+        }
+    }
+' "$AGENT_FILE" | tr -d '\r' | xargs)
+
+echo "$PARAM_VALUE"

package/.claude/skills/cfn-agent-lifecycle/lib/spawning/spawn-agent-wrapper.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+
+##############################################################################
+# ⚠️  DEPRECATED - This bash script is deprecated
+#
+# Deprecation Date: 2025-11-20
+# Removal Date: 2026-02-20 (90 days)
+# Replacement: dist/cli/spawn-agent-cli.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
+#
+##############################################################################
+
+# Backward Compatibility Wrapper for Agent Spawner
+#
+# Provides backward compatibility with bash version by delegating
+# to TypeScript implementation. Maintains 100% CLI interface compatibility.
+#
+# Usage: Same as original spawn-agent.sh
+#   spawn-agent-wrapper.sh <agent-type> --task-id <id> [options]
+
+set -euo pipefail
+
+# ⚠️ ANTI-023 MEMORY LEAK PROTECTION: Block Task Mode agents
+# Task Mode agents spawn via Task() tool and should NOT use agent spawning CLI
+# CLI mode requires TASK_ID environment variable (validates existence, not pattern)
+if [[ -z "${TASK_ID:-}" ]]; then
+    echo "❌ ERROR: TASK_ID environment variable required for CLI mode" >&2
+    echo "🚨 ANTI-023: This script is for CLI-spawned coordinators only" >&2
+    echo "💡 Task Mode agents should use Task() tool, not CLI spawning" >&2
+    exit 1
+fi
+
+# Sanitize TASK_ID to prevent command injection
+if [[ "${TASK_ID}" =~ [^a-zA-Z0-9._-] ]]; then
+    echo "❌ ERROR: TASK_ID contains invalid characters: ${TASK_ID}" >&2
+    echo "Allowed: alphanumeric, dot, underscore, hyphen" >&2
+    exit 1
+fi
+
+# Validate required parameters for CLI mode
+if [[ -z "${1:-}" ]]; then
+    echo "❌ ERROR: Agent type required" >&2
+    exit 1
+fi
+
+# Get the project root
+PROJECT_ROOT="${PROJECT_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)}"
+
+# Delegate to TypeScript implementation
+# The CLI expects agent type as first argument, followed by options
+node "${PROJECT_ROOT}/dist/cli/spawn-agent-cli.js" "$@"
+exit $?