claude-flow-novice 2.18.6 → 2.18.7

package/.claude/hooks/cfn-pre-execution/memory-check.sh

@@ -1,20 +0,0 @@
-#!/bin/bash
-
-# CFN Pre-Execution Memory Check Hook
-# Automatically checks memory availability before CFN operations
-
-set -euo pipefail
-
-# Hook configuration
-HOOK_SCRIPT_PATH="$(dirname "$0")/memory-check.sh"
-MEMORY_MANAGEMENT_SKILL="$(dirname "$0")/../../skills/cfn-memory-management/check-memory.sh"
-
-# Use the memory management skill if available, otherwise use local fallback
-if [[ -f "$MEMORY_MANAGEMENT_SKILL" ]]; then
-    exec "$MEMORY_MANAGEMENT_SKILL" "$@"
-elif [[ -f "$HOOK_SCRIPT_PATH" ]]; then
-    exec "$HOOK_SCRIPT_PATH" "$@"
-else
-    echo "WARNING: Memory check scripts not found, proceeding without memory validation"
-    exit 0
-fi

package/.claude/hooks/cfn-pre-execution/session-start-context.sh

@@ -1,111 +0,0 @@
-#!/bin/bash
-
-# CFN Session Start Context Hook
-# Automatically reads CLAUDE.md at session start to provide project context
-#
-# Purpose: Ensures Main Chat and agents have immediate access to project
-#          guidelines, CFN Loop patterns, and coordination protocols
-#
-# Triggered: Automatically at session initialization
-# Location: .claude/hooks/cfn-pre-execution/session-start-context.sh
-
-set -euo pipefail
-
-# === Configuration ===
-
-PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
-CLAUDE_MD="${PROJECT_ROOT}/CLAUDE.md"
-CFN_EXPERT="${PROJECT_ROOT}/.claude/agents/cfn-dev-team/cfn-system-expert.md"
-
-# === Session Context Output ===
-
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "📋 SESSION START: Loading Project Context"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-# === Read CLAUDE.md ===
-
-if [[ -f "$CLAUDE_MD" ]]; then
-    echo "✅ CLAUDE.md loaded"
-    echo "   Location: $CLAUDE_MD"
-    echo ""
-
-    # Extract key sections for quick reference
-    echo "📌 Quick Reference:"
-    echo ""
-
-    # Extract CFN Loop modes
-    if grep -q "CFN Loop Execution Modes" "$CLAUDE_MD"; then
-        echo "   CFN Loop Modes Available:"
-        echo "   • /cfn-loop-task (Task Mode - Debugging, Full Visibility)"
-        echo "   • /cfn-loop-cli  (CLI Mode - Production, 64% Cost Savings)"
-        echo ""
-    fi
-
-    # Extract delegation pattern
-    if grep -q "CTO Delegation Persona" "$CLAUDE_MD"; then
-        echo "   Active Persona: CTO Delegation"
-        echo "   • Delegate all non-trivial work (>3 steps)"
-        echo "   • Use CFN Loop slash commands for complex tasks"
-        echo "   • Define success criteria, not adoption metrics"
-        echo ""
-    fi
-
-    # Extract test-driven requirements
-    if grep -q "Test-Driven Gates" "$CLAUDE_MD"; then
-        echo "   Test-Driven Gates (v3.0+):"
-        echo "   • Standard Mode: ≥0.95 pass rate (Loop 3), ≥0.90 consensus (Loop 2)"
-        echo "   • MVP Mode: ≥0.70 pass rate, ≥0.80 consensus"
-        echo "   • Enterprise: ≥0.98 pass rate, ≥0.95 consensus"
-        echo ""
-    fi
-
-else
-    echo "⚠️  WARNING: CLAUDE.md not found at $CLAUDE_MD"
-    echo ""
-fi
-
-# === CFN System Expert Reference ===
-
-if [[ -f "$CFN_EXPERT" ]]; then
-    echo "✅ CFN System Expert agent available"
-    echo "   Use for: CFN-specific troubleshooting, methodology questions"
-    echo ""
-else
-    echo "ℹ️  CFN System Expert agent not found (optional)"
-    echo ""
-fi
-
-# === Environment Check ===
-
-echo "🔧 Environment Status:"
-
-# Check for custom routing
-if [[ -f "${PROJECT_ROOT}/.env" ]] && grep -q "CFN_CUSTOM_ROUTING=true" "${PROJECT_ROOT}/.env" 2>/dev/null; then
-    echo "   • Custom Provider Routing: ENABLED"
-else
-    echo "   • Custom Provider Routing: DISABLED (default)"
-fi
-
-# Check for Redis coordination
-if command -v redis-cli &>/dev/null; then
-    echo "   • Redis CLI: Available"
-else
-    echo "   • Redis CLI: Not found (CLI mode may need Docker)"
-fi
-
-# Check for Docker
-if command -v docker &>/dev/null; then
-    echo "   • Docker: Available"
-else
-    echo "   • Docker: Not found"
-fi
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "✨ Ready to delegate. Use /cfn-loop-cli or /cfn-loop-task for complex work."
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-exit 0

package/.claude/hooks/subagent-start.sh

@@ -1,98 +0,0 @@
-#!/bin/bash
-# SubagentStart Hook - Claude Code v2.0.43+
-# Automatically invoked when Main Chat spawns a Task() agent
-#
-# High-value features:
-# 1. Automatic SQLite lifecycle tracking
-# 2. Protocol dependency validation (prevents "consensus on vapor")
-
-set -euo pipefail
-
-# Hook input (provided by Claude Code)
-AGENT_ID="${AGENT_ID:-unknown}"
-AGENT_TYPE="${AGENT_TYPE:-unknown}"
-TASK_ID="${TASK_ID:-unknown}"
-SPAWNED_AT=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-# Project paths
-PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
-DB_PATH="${PROJECT_ROOT}/claude-assets/skills/cfn-redis-coordination/data/cfn-loop.db"
-LOG_PATH="${PROJECT_ROOT}/.artifacts/logs/subagent-lifecycle.log"
-
-# Ensure directories exist
-mkdir -p "$(dirname "$DB_PATH")"
-mkdir -p "$(dirname "$LOG_PATH")"
-
-# ============================================================================
-# Feature 1: Automatic SQLite Lifecycle Tracking
-# ============================================================================
-
-# Initialize database schema if needed
-sqlite3 "$DB_PATH" <<EOF
-CREATE TABLE IF NOT EXISTS agents (
-    id TEXT PRIMARY KEY,
-    type TEXT NOT NULL,
-    status TEXT NOT NULL,
-    confidence REAL,
-    spawned_at TEXT,
-    completed_at TEXT,
-    metadata TEXT
-);
-EOF
-
-# Insert spawn record
-sqlite3 "$DB_PATH" <<EOF
-INSERT OR REPLACE INTO agents (id, type, status, spawned_at, metadata)
-VALUES (
-    '$AGENT_ID',
-    '$AGENT_TYPE',
-    'spawned',
-    '$SPAWNED_AT',
-    '{"source": "subagent_start_hook", "task_id": "$TASK_ID"}'
-);
-EOF
-
-echo "[SubagentStart] Lifecycle tracking: $AGENT_ID ($AGENT_TYPE) spawned at $SPAWNED_AT" | tee -a "$LOG_PATH"
-
-# ============================================================================
-# Feature 2: Protocol Dependency Validation
-# ============================================================================
-
-# Extract phase from agent type (e.g., "loop2-validator" -> "loop2")
-if [[ "$AGENT_TYPE" =~ ^loop([0-9]+)- ]]; then
-    PHASE="${BASH_REMATCH[1]}"
-
-    # Loop 2 validators must wait for Loop 3 completion
-    if [ "$PHASE" = "2" ] && [ "$TASK_ID" != "unknown" ]; then
-        LOOP3_COMPLETED=$(sqlite3 "$DB_PATH" "SELECT COUNT(*) FROM agents WHERE metadata LIKE '%\"task_id\": \"$TASK_ID\"%' AND type LIKE 'loop3-%' AND status='completed';")
-
-        if [ "$LOOP3_COMPLETED" -eq 0 ]; then
-            echo "[SubagentStart] ERROR: Loop 2 agent spawned before Loop 3 completion (task: $TASK_ID)" | tee -a "$LOG_PATH"
-            echo "WARN: Protocol violation detected - Loop 2 validator spawning before Loop 3 implementers complete"
-            echo "This may indicate 'consensus on vapor' anti-pattern"
-            # Don't exit 1 - allow spawn but log warning for debugging
-        else
-            echo "[SubagentStart] Protocol check passed: Loop 3 completed ($LOOP3_COMPLETED agents) before Loop 2 spawn" | tee -a "$LOG_PATH"
-        fi
-    fi
-
-    # Product Owner must wait for Loop 2 completion
-    if [[ "$AGENT_TYPE" =~ product-owner ]] && [ "$TASK_ID" != "unknown" ]; then
-        LOOP2_COMPLETED=$(sqlite3 "$DB_PATH" "SELECT COUNT(*) FROM agents WHERE metadata LIKE '%\"task_id\": \"$TASK_ID\"%' AND type LIKE 'loop2-%' AND status='completed';")
-
-        if [ "$LOOP2_COMPLETED" -eq 0 ]; then
-            echo "[SubagentStart] ERROR: Product Owner spawned before Loop 2 completion (task: $TASK_ID)" | tee -a "$LOG_PATH"
-            echo "WARN: Protocol violation - Product Owner making decisions before validator review"
-            # Don't exit 1 - allow spawn but log warning
-        else
-            echo "[SubagentStart] Protocol check passed: Loop 2 completed ($LOOP2_COMPLETED agents) before Product Owner spawn" | tee -a "$LOG_PATH"
-        fi
-    fi
-fi
-
-# ============================================================================
-# Success Exit
-# ============================================================================
-
-echo "[SubagentStart] Hook completed successfully for $AGENT_ID" | tee -a "$LOG_PATH"
-exit 0

package/.claude/skills/cfn-docker-runtime/lib/coordination/README.md

@@ -1,349 +0,0 @@
-# CFN Docker Coordination
-
-Type-safe Docker orchestration utilities for CFN Loop agent container management.
-
-**Status**: Production Ready
-**Coverage**: 91.8%
-**Tests**: 176 passing
-**TypeScript**: Strict mode enabled
-
-## Installation
-
-```bash
-npm install @cfn/docker-coordination
-```
-
-## Quick Start
-
-```typescript
-import { createDockerManager } from '@cfn/docker-coordination';
-
-// Create manager with all components
-const manager = createDockerManager();
-
-// Verify Docker is accessible
-const accessible = await manager.docker.isAccessible();
-
-// Create and manage agent containers
-const { container, manifest } = await manager.agents.spawnAgent(
-  'backend-dev',
-  'task-123',
-  'agent-456',
-  { memoryLimit: 1024 }
-);
-
-// Monitor container health
-const ready = await manager.health.waitForReady(container, 30000);
-
-// Get container state
-const state = await manager.agents.getAgentStatus(container);
-console.log(`Container status: ${state.status}`);
-
-// Stop and cleanup
-await manager.agents.stopAgent(container);
-await manager.agents.removeAgent(container);
-```
-
-## Core Components
-
-### DockerClient
-Low-level Docker SDK wrapper with proper error handling.
-
-```typescript
-const client = new DockerClient();
-const accessible = await client.isAccessible();
-const container = await client.getContainer('container-id');
-const state = await client.getContainerState(container);
-const logs = await client.getContainerLogs(container);
-```
-
-### AgentContainerManager
-CFN agent-specific container operations.
-
-```typescript
-const manager = new AgentContainerManager(dockerClient);
-const { container, manifest } = await manager.spawnAgent(
-  'backend-dev',
-  'task-id',
-  'agent-id',
-  { memoryLimit: 2048, cpuLimit: 1.0 }
-);
-
-const exitCode = await manager.waitForAgentCompletion(container);
-const logs = await manager.getAgentLogs(container);
-await manager.cleanupStoppedAgents('cfn-wave');
-```
-
-### NetworkManager
-Docker network creation and container connection.
-
-```typescript
-const netManager = new NetworkManager();
-const network = await netManager.createNetworkIfMissing('cfn-network');
-await netManager.connectToNetwork(network, container);
-const info = await netManager.getNetworkInfo(network);
-await netManager.disconnectFromNetwork(network, container);
-```
-
-### VolumeManager
-Docker volume management for persistent storage.
-
-```typescript
-const volManager = new VolumeManager();
-const volume = await volManager.createAgentVolume('agent-id', 'backend');
-const volumes = await volManager.listCfnVolumes();
-await volManager.removeAgentVolume('agent-id');
-const removed = await volManager.removeDanglingVolumes();
-```
-
-### HealthChecker
-Container health monitoring and diagnostics.
-
-```typescript
-const checker = new HealthChecker(dockerClient);
-const healthy = await checker.waitForHealthy(container, 30000);
-const summary = await checker.getHealthSummary(container);
-const state = await checker.monitorUntilCompletion(container, 300000);
-const report = await checker.performDiagnostic(container);
-```
-
-## Type System
-
-Comprehensive TypeScript types for all operations:
-
-```typescript
-// Container options with full type safety
-const options: ContainerOptions = {
-  agentType: 'backend-dev',
-  taskId: 'task-123',
-  agentId: 'agent-456',
-  memoryLimit: 1024,
-  cpuLimit: 0.5,
-  env: {
-    'LOG_LEVEL': 'debug',
-    'REDIS_HOST': 'redis'
-  },
-  volumes: {
-    '/host/data': '/container/data'
-  }
-};
-
-// Container state with discriminated unions
-const state: ContainerState = {
-  id: 'abc123',
-  name: 'cfn-agent-456',
-  status: ContainerStatus.RUNNING,
-  isRunning: true,
-  healthStatus: ContainerHealthStatus.HEALTHY
-};
-
-// Execute summary with metrics
-const summary: ExecutionSummary = {
-  wave_number: 1,
-  summary_time: '2025-11-19T10:30:00Z',
-  metrics: {
-    total: 10,
-    success: 9,
-    failed: 1,
-    timeout: 0
-  }
-};
-```
-
-## Error Handling
-
-Type-safe error classes with context:
-
-```typescript
-import {
-  DockerError,
-  ContainerTimeoutError,
-  ContainerHealthCheckError,
-  NetworkError
-} from '@cfn/docker-coordination';
-
-try {
-  await manager.health.waitForHealthy(container, 5000);
-} catch (error) {
-  if (error instanceof ContainerTimeoutError) {
-    console.error('Container took too long to start');
-  } else if (error instanceof ContainerHealthCheckError) {
-    console.error('Container failed health check');
-  } else if (error instanceof DockerError) {
-    console.error(`Docker error: ${error.code} - ${error.message}`);
-  }
-}
-```
-
-## Configuration
-
-### Memory Tiers
-
-Standard memory configurations:
-
-```typescript
-MemoryTier.SMALL = 512;      // 512 MB
-MemoryTier.MEDIUM = 1024;    // 1 GB
-MemoryTier.LARGE = 2048;     // 2 GB
-MemoryTier.XLARGE = 4096;    // 4 GB
-```
-
-### Container Creation Options
-
-```typescript
-interface ContainerOptions {
-  agentType: string;           // Agent type identifier
-  taskId: string;              // Task ID for coordination
-  agentId: string;             // Unique agent ID
-  memoryLimit: number;         // Memory in MB
-  cpuLimit?: number;           // CPU limit (cores)
-  env?: Record<string, string>;  // Environment variables
-  volumes?: Record<string, string>; // Volume mounts
-  network?: string;            // Network name
-  name?: string;               // Container name override
-  workdir?: string;            // Working directory
-  restartPolicy?: RestartPolicy; // Restart policy
-  healthCheck?: HealthCheckConfig; // Health check
-}
-```
-
-### Health Check Configuration
-
-```typescript
-interface HealthCheckConfig {
-  Test: string[];              // Health check command
-  Interval: number;            // Interval in seconds
-  Timeout: number;             // Timeout in seconds
-  Retries: number;             // Consecutive failures
-  StartPeriod?: number;        // Startup grace period
-}
-```
-
-## Testing
-
-### Run All Tests
-
-```bash
-npm test
-```
-
-### Run Tests in Watch Mode
-
-```bash
-npm run test:watch
-```
-
-### Run Integration Tests Only
-
-```bash
-npm run test:integration
-```
-
-### Check Coverage
-
-```bash
-npm test -- --coverage
-```
-
-Current coverage:
-- Statements: 91.8%
-- Branches: 89.3%
-- Functions: 94.2%
-- Lines: 92.1%
-
-## Building
-
-### Compile TypeScript
-
-```bash
-npm run build
-```
-
-### Type Check Without Emitting
-
-```bash
-npm run type-check
-```
-
-### Lint Code
-
-```bash
-npm run lint
-```
-
-## Backward Compatibility
-
-For existing bash code, a compatibility wrapper is available:
-
-```bash
-source ./docker-helpers.sh
-
-validate_docker_access
-get_container_status "$CONTAINER_ID"
-wait_for_container "$CONTAINER_ID" 300
-get_container_logs "$CONTAINER_ID"
-```
-
-All original bash functions are preserved with identical signatures.
-
-## Security
-
-### Environment Variable Validation
-
-- Blocks dangerous variables: `LD_PRELOAD`, `DOCKER_HOST`, `DOCKER_TLS_VERIFY`
-- Validates variable name format
-- Prevents special character injection
-- Sanitizes values before Docker API calls
-
-### Container Name Sanitization
-
-- Removes invalid characters automatically
-- Enforces Docker naming constraints
-- Maximum length: 63 characters
-- Prepends `cfn-` prefix for identification
-
-### Volume and Network Isolation
-
-- All CFN resources labeled with `cfn-managed=true`
-- Isolated subnets per network: `172.20.0.0/16` default
-- Permission-restricted log files: `0600`
-- Dangling volume cleanup on demand
-
-## Performance
-
-Typical operation latencies:
-- Container creation: ~520ms
-- Container inspection: ~145ms
-- Network creation: ~210ms
-- Volume listing: ~95ms
-- Health check cycle: ~280ms
-
-Performance is within 12-21% of bash implementation due to Node.js overhead.
-
-## Docker Socket Configuration
-
-Default socket path: `/var/run/docker.sock`
-
-### Custom Socket
-
-```typescript
-const manager = createDockerManager('/custom/docker.sock');
-```
-
-### TCP Connection
-
-```typescript
-const client = new DockerClient(undefined, 'localhost', 2375);
-```
-
-## License
-
-MIT
-
-## Contributing
-
-This module is part of the CFN Loop system. For changes, please follow TypeScript strict mode and maintain 80%+ test coverage.
-
-## Support
-
-For issues or questions, refer to the main CFN documentation.