claude-flow-novice 2.15.4 → 2.15.6

package/.claude/skills/cfn-docker-redis-coordination/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "target": "es2020",
+    "module": "commonjs",
+    "lib": ["es2020"],
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true,
+    "moduleResolution": "node",
+    "isolatedModules": true,
+    "noImplicitAny": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}

package/.claude/skills/cfn-loop-orchestration/.eslintrc.js

@@ -0,0 +1,56 @@
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+  },
+  env: {
+    node: true,
+    es2022: true,
+    jest: true,
+  },
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+  ],
+  plugins: ['@typescript-eslint'],
+  rules: {
+    // TypeScript specific rules
+    '@typescript-eslint/no-explicit-any': 'error',
+    '@typescript-eslint/no-non-null-assertion': 'warn',
+    '@typescript-eslint/no-unused-vars': [
+      'error',
+      {
+        argsIgnorePattern: '^_',
+        varsIgnorePattern: '^_',
+      },
+    ],
+    '@typescript-eslint/require-await': 'off',
+
+    // General ESLint rules
+    'no-console': [
+      'warn',
+      {
+        allow: ['warn', 'error'],
+      },
+    ],
+    'no-debugger': 'error',
+    'prefer-const': 'warn',
+    'no-var': 'error',
+    'eqeqeq': ['error', 'always'],
+    'no-eval': 'error',
+    'no-implied-eval': 'error',
+    'object-shorthand': 'warn',
+    'prefer-arrow-callback': 'warn',
+    'prefer-template': 'warn',
+  },
+  overrides: [
+    {
+      files: ['**/*.test.ts', '**/*.spec.ts', 'tests/**/*'],
+      rules: {
+        '@typescript-eslint/no-explicit-any': 'off',
+      },
+    },
+  ],
+};

package/.claude/skills/cfn-loop-orchestration/.prettierrc.json

@@ -0,0 +1,18 @@
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": true,
+  "quoteProps": "as-needed",
+  "jsxSingleQuote": false,
+  "trailingComma": "es5",
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "arrowParens": "always",
+  "requirePragma": false,
+  "insertPragma": false,
+  "proseWrap": "preserve",
+  "htmlWhitespaceSensitivity": "css",
+  "embeddedLanguageFormatting": "auto"
+}

package/.claude/skills/cfn-loop-orchestration/README.md

@@ -1,41 +1,149 @@
-# CFN Loop Orchestration Skill
-
-Modular skill for orchestrating Complete Fail Never (CFN) Loop workflows with clean separation from Redis coordination primitives.
-
-## Quick Start
-
-```bash
-# Execute a CFN Loop
-./.claude/skills/cfn-loop-orchestration/orchestrate.sh \
-  --task-id "my-task-001" \
-  --mode standard \
-  --loop3-agents "backend-dev,researcher,architect" \
-  --loop2-agents "reviewer,tester,security" \
-  --product-owner "product-owner" \
-  --epic-context '{"epicGoal":"Build auth system","deliverables":["auth.js","tests.js"]}' \
-  --max-iterations 10
-```
-
-## Monitoring Capabilities
-
-### Monitoring Script: `monitor-execution.sh`
-
-#### Key Features
-- Real-time Progress Tracking
-- Performance Metrics Collection
-- Error Detection
-- Flexible Monitoring Configuration
-
-#### Basic Usage
-```bash
-./monitor-execution.sh --task-id <unique_task_id>
-```
-
-#### Metrics Tracked
-- Iteration Progression
-- Agent Completion Signals
-- Gate Check Results
-- Consensus Validation
-- Execution Performance
-
-[Rest of the previous README content remains the same]
+# CFN Loop Orchestration Engine - TypeScript v3.0
+
+Type-safe implementation of the CFN Loop orchestration system with test-driven validation.
+
+## Overview
+
+This is the TypeScript migration of the CFN Loop orchestration system, replacing the bash-based implementation with a fully type-safe, well-tested TypeScript codebase.
+
+**Key Features:**
+- Full type safety with TypeScript strict mode
+- Test-driven validation (≥95% pass rate gates)
+- Mode-specific execution (MVP, Standard, Enterprise)
+- Redis-based agent coordination
+- Comprehensive test coverage (80-100% per module)
+
+## Project Structure
+
+```
+src/
+├── orchestrator/       # Main orchestration engine
+├── gate-checker/       # Test result validation
+├── agent-spawner/      # Agent spawning and coordination
+├── redis/             # Redis coordination layer
+├── utils/             # Utilities and helpers
+└── types.ts           # Core type definitions
+
+tests/
+├── orchestrator/       # Orchestrator tests
+├── gate-checker/       # Gate checker tests
+└── agent-spawner/      # Agent spawner tests
+
+bash-wrappers/         # Shell wrappers for CLI compatibility
+```
+
+## Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Type check
+npm run type-check
+
+# Lint
+npm run lint
+```
+
+## Development
+
+```bash
+# Watch mode for development
+npm run build:watch
+
+# Watch mode for tests
+npm run test:watch
+
+# Format code
+npm run format
+
+# Fix linting issues
+npm run lint:fix
+```
+
+## Configuration
+
+### tsconfig.json
+Strict TypeScript configuration with:
+- ES2022 target
+- CommonJS module format
+- Path mapping for clean imports
+- All strict compiler options enabled
+
+### jest.config.js
+Test configuration with:
+- ts-jest preset for TypeScript support
+- Coverage thresholds (80-100% per module)
+- Path mapping for imports
+- 30-second test timeout
+
+### .eslintrc.js
+Linting configuration with:
+- TypeScript-specific rules
+- Strict null checking
+- No implicit any
+- Prefer const and proper variable declarations
+
+## Test Coverage
+
+Target coverage per module:
+- `src/orchestrator/`: 100%
+- `src/gate-checker/`: 100%
+- `src/agent-spawner/`: 90%
+- `src/utils/`: 80%
+- Global minimum: 80%
+
+## Type Definitions
+
+Core types are defined in `src/types.ts`:
+
+- `ExecutionMode` - 'mvp' | 'standard' | 'enterprise'
+- `OrchestrationConfig` - Task configuration
+- `AgentSpec` - Agent specification with resources
+- `TestResult` - Test execution results
+- `GateResult` - Gate check results
+- `ProductOwnerDecision` - 'PROCEED' | 'ITERATE' | 'ABORT'
+- `OrchestrationResult` - Final result
+
+## Mode Configuration
+
+| Mode | Test Gate | Consensus | Max Iterations | Validators |
+|------|-----------|-----------|----------------|------------|
+| mvp | 70% | 80% | 5 | 2 |
+| standard | 95% | 90% | 10 | 3 |
+| enterprise | 98% | 95% | 15 | 5 |
+
+## Migration Plan
+
+See `docs/migration/BASH_TO_TYPESCRIPT_MIGRATION_PLAN.md` for the complete migration strategy from bash to TypeScript.
+
+## Building and Deployment
+
+```bash
+# Production build
+npm run build
+
+# Distribution files are in dist/
+# Include in packages: dist/, package.json, README.md
+```
+
+## Environment Variables
+
+```
+CFN_REDIS_HOST=localhost (default)
+CFN_REDIS_PORT=6379 (default)
+NODE_ENV=test|development|production
+```
+
+## License
+
+MIT

package/.claude/skills/cfn-loop-orchestration/jest.config.js

@@ -0,0 +1,67 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src', '<rootDir>/tests'],
+  testMatch: ['**/__tests__/**/*.ts', '**/?(*.)+(spec|test).ts'],
+  moduleFileExtensions: ['ts', 'js', 'json'],
+  transform: {
+    '^.+\\.ts$': [
+      'ts-jest',
+      {
+        tsconfig: {
+          esModuleInterop: true,
+          allowSyntheticDefaultImports: true,
+        },
+      },
+    ],
+  },
+  moduleNameMapper: {
+    '^@orchestrator/(.*)$': '<rootDir>/src/orchestrator/$1',
+    '^@gate-checker/(.*)$': '<rootDir>/src/gate-checker/$1',
+    '^@agent-spawner/(.*)$': '<rootDir>/src/agent-spawner/$1',
+    '^@redis/(.*)$': '<rootDir>/src/redis/$1',
+    '^@utils/(.*)$': '<rootDir>/src/utils/$1',
+    '^@types/(.*)$': '<rootDir>/src/types/$1',
+  },
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/index.ts',
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 80,
+      functions: 80,
+      lines: 80,
+      statements: 80,
+    },
+    './src/orchestrator/': {
+      branches: 100,
+      functions: 100,
+      lines: 100,
+      statements: 100,
+    },
+    './src/gate-checker/': {
+      branches: 100,
+      functions: 100,
+      lines: 100,
+      statements: 100,
+    },
+    './src/agent-spawner/': {
+      branches: 90,
+      functions: 90,
+      lines: 90,
+      statements: 90,
+    },
+    './src/utils/': {
+      branches: 80,
+      functions: 80,
+      lines: 80,
+      statements: 80,
+    },
+  },
+  setupFilesAfterEnv: ['<rootDir>/tests/setup.ts'],
+  testTimeout: 30000,
+  verbose: true,
+  collectCoverage: false,
+};

package/.claude/skills/cfn-loop-orchestration/orchestrate-wrapper.sh

@@ -0,0 +1,268 @@
+#!/bin/bash
+
+##############################################################################
+# CFN Loop Orchestration Wrapper - Parameter Validation & Fallback Enforcement
+# Version: 1.0.0 (BUG #22 Phase 2 - Parameter Fallback)
+#
+# Purpose:
+# Validates and enforces non-empty parameters for orchestrate.sh invocation.
+# Applies task-appropriate hardcoded fallbacks when parameters are empty or unset.
+# Guarantees that orchestrator is always called with valid, non-empty agent lists.
+#
+# Usage:
+#   ./orchestrate-wrapper.sh --task-id <id> \
+#                           --mode <mvp|standard|enterprise> \
+#                           [--loop3-agents <agents>] \
+#                           [--loop2-agents <agents>] \
+#                           [--product-owner <agent>] \
+#                           [--task-type <backend|full-stack|default>] \
+#                           [--max-iterations <n>] \
+#                           [other orchestrate.sh args...]
+#
+# Exit Codes:
+#   0 = Success (orchestrator invoked)
+#   1 = Invalid orchestrator path or orchestrator execution failed
+#   2 = Missing required parameters (task-id, mode)
+##############################################################################
+
+set -euo pipefail
+
+# Determine script location and project root
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+ORCHESTRATOR_PATH="$SCRIPT_DIR/orchestrate.sh"
+
+# Parameter storage
+TASK_ID=""
+MODE=""
+LOOP3_AGENTS=""
+LOOP2_AGENTS=""
+PRODUCT_OWNER=""
+TASK_TYPE="default"  # backend, full-stack, or default
+REMAINING_ARGS=()
+
+##############################################################################
+# Fallback Agent Configuration by Task Type
+##############################################################################
+
+# Default fallbacks (for generic tasks with no specific type)
+DEFAULT_LOOP3_AGENTS="backend-developer,coder"
+DEFAULT_LOOP2_AGENTS="code-reviewer,tester"
+DEFAULT_PRODUCT_OWNER="product-owner"
+
+# Backend-specific fallbacks (for API, database, infrastructure tasks)
+BACKEND_LOOP3_AGENTS="backend-developer,backend-dev"
+BACKEND_LOOP2_AGENTS="code-reviewer,security-specialist,tester"
+BACKEND_PRODUCT_OWNER="product-owner"
+
+# Full-stack fallbacks (for tasks requiring both backend and frontend)
+FULLSTACK_LOOP3_AGENTS="backend-developer,react-frontend-engineer"
+FULLSTACK_LOOP2_AGENTS="code-reviewer,security-specialist,tester,qa-engineer"
+FULLSTACK_PRODUCT_OWNER="product-owner"
+
+##############################################################################
+# Argument Parsing
+##############################################################################
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --task-id)
+      if [[ $# -lt 2 ]]; then
+        echo "Error: --task-id requires a value" >&2
+        exit 2
+      fi
+      TASK_ID="$2"
+      shift 2
+      ;;
+    --mode)
+      if [[ $# -lt 2 ]]; then
+        echo "Error: --mode requires a value" >&2
+        exit 2
+      fi
+      # Validate mode is one of: mvp, standard, enterprise
+      if [[ ! "$2" =~ ^(mvp|standard|enterprise)$ ]]; then
+        echo "Error: --mode must be one of: mvp, standard, enterprise (got: '$2')" >&2
+        exit 2
+      fi
+      MODE="$2"
+      shift 2
+      ;;
+    --loop3-agents)
+      if [[ $# -lt 2 ]]; then
+        echo "Error: --loop3-agents requires a value" >&2
+        exit 2
+      fi
+      LOOP3_AGENTS="$2"
+      shift 2
+      ;;
+    --loop2-agents)
+      if [[ $# -lt 2 ]]; then
+        echo "Error: --loop2-agents requires a value" >&2
+        exit 2
+      fi
+      LOOP2_AGENTS="$2"
+      shift 2
+      ;;
+    --product-owner)
+      if [[ $# -lt 2 ]]; then
+        echo "Error: --product-owner requires a value" >&2
+        exit 2
+      fi
+      PRODUCT_OWNER="$2"
+      shift 2
+      ;;
+    --task-type)
+      if [[ $# -lt 2 ]]; then
+        echo "Error: --task-type requires a value" >&2
+        exit 2
+      fi
+      TASK_TYPE="$2"
+      shift 2
+      ;;
+    *)
+      # Collect remaining arguments for orchestrator
+      REMAINING_ARGS+=("$1")
+      shift
+      ;;
+  esac
+done
+
+##############################################################################
+# Required Parameter Validation
+##############################################################################
+
+if [[ -z "$TASK_ID" ]]; then
+  echo "❌ Error: --task-id is required" >&2
+  exit 2
+fi
+
+if [[ -z "$MODE" ]]; then
+  echo "❌ Error: --mode is required" >&2
+  exit 2
+fi
+
+##############################################################################
+# Parameter Normalization & Fallback Enforcement
+##############################################################################
+
+# Helper function to check if a value is effectively empty
+# (handles empty strings, unset variables, and whitespace-only strings)
+is_empty() {
+  local value="${1:-}"
+  # Remove leading/trailing whitespace
+  value=$(echo "$value" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+  [[ -z "$value" ]]
+}
+
+# Apply task-type-specific fallbacks to empty parameters
+case "$TASK_TYPE" in
+  backend)
+    # Backend-specific task defaults
+    if is_empty "$LOOP3_AGENTS"; then
+      LOOP3_AGENTS="$BACKEND_LOOP3_AGENTS"
+    fi
+    if is_empty "$LOOP2_AGENTS"; then
+      LOOP2_AGENTS="$BACKEND_LOOP2_AGENTS"
+    fi
+    if is_empty "$PRODUCT_OWNER"; then
+      PRODUCT_OWNER="$BACKEND_PRODUCT_OWNER"
+    fi
+    ;;
+  full-stack)
+    # Full-stack task defaults
+    if is_empty "$LOOP3_AGENTS"; then
+      LOOP3_AGENTS="$FULLSTACK_LOOP3_AGENTS"
+    fi
+    if is_empty "$LOOP2_AGENTS"; then
+      LOOP2_AGENTS="$FULLSTACK_LOOP2_AGENTS"
+    fi
+    if is_empty "$PRODUCT_OWNER"; then
+      PRODUCT_OWNER="$FULLSTACK_PRODUCT_OWNER"
+    fi
+    ;;
+  *)
+    # Default/generic task fallbacks
+    if is_empty "$LOOP3_AGENTS"; then
+      LOOP3_AGENTS="$DEFAULT_LOOP3_AGENTS"
+    fi
+    if is_empty "$LOOP2_AGENTS"; then
+      LOOP2_AGENTS="$DEFAULT_LOOP2_AGENTS"
+    fi
+    if is_empty "$PRODUCT_OWNER"; then
+      PRODUCT_OWNER="$DEFAULT_PRODUCT_OWNER"
+    fi
+    ;;
+esac
+
+##############################################################################
+# Post-Fallback Parameter Validation
+##############################################################################
+
+# Verify all parameters are now non-empty (guaranteed by fallbacks)
+if is_empty "$LOOP3_AGENTS"; then
+  echo "❌ Fatal: LOOP3_AGENTS is empty (fallback failed)" >&2
+  echo "   Task Type: $TASK_TYPE" >&2
+  echo "   Value: '$LOOP3_AGENTS'" >&2
+  exit 1
+fi
+
+if is_empty "$LOOP2_AGENTS"; then
+  echo "❌ Fatal: LOOP2_AGENTS is empty (fallback failed)" >&2
+  echo "   Task Type: $TASK_TYPE" >&2
+  echo "   Value: '$LOOP2_AGENTS'" >&2
+  exit 1
+fi
+
+if is_empty "$PRODUCT_OWNER"; then
+  echo "❌ Fatal: PRODUCT_OWNER is empty (fallback failed)" >&2
+  echo "   Task Type: $TASK_TYPE" >&2
+  echo "   Value: '$PRODUCT_OWNER'" >&2
+  exit 1
+fi
+
+##############################################################################
+# Orchestrator Path Validation
+##############################################################################
+
+if [[ ! -f "$ORCHESTRATOR_PATH" ]]; then
+  echo "❌ Error: Orchestrator not found at $ORCHESTRATOR_PATH" >&2
+  exit 1
+fi
+
+if [[ ! -x "$ORCHESTRATOR_PATH" ]]; then
+  echo "⚠️  Warning: Orchestrator is not executable. Attempting to fix..." >&2
+  chmod +x "$ORCHESTRATOR_PATH" || {
+    echo "❌ Error: Cannot make orchestrator executable at $ORCHESTRATOR_PATH" >&2
+    exit 1
+  }
+fi
+
+##############################################################################
+# Agent Configuration Logging
+##############################################################################
+
+echo "📋 Agent Configuration ($(date +%Y-%m-%d' '%H:%M:%S)):" >&2
+echo "   Task ID: $TASK_ID" >&2
+echo "   Mode: $MODE" >&2
+echo "   Task Type: $TASK_TYPE" >&2
+echo "   Loop 3 Agents: $LOOP3_AGENTS" >&2
+echo "   Loop 2 Agents: $LOOP2_AGENTS" >&2
+echo "   Product Owner: $PRODUCT_OWNER" >&2
+echo "" >&2
+
+##############################################################################
+# Orchestrator Invocation with Validated Parameters
+##############################################################################
+
+# Use exec to replace this process with orchestrator
+# This ensures clean exit and proper signal handling
+exec "$ORCHESTRATOR_PATH" \
+  --task-id "$TASK_ID" \
+  --mode "$MODE" \
+  --loop3-agents "$LOOP3_AGENTS" \
+  --loop2-agents "$LOOP2_AGENTS" \
+  --product-owner "$PRODUCT_OWNER" \
+  "${REMAINING_ARGS[@]}"
+
+# Note: exec replaces the shell process, so code below never executes
+# Exit code comes directly from orchestrator execution