claude-flow-novice 2.14.30 → 2.14.32

package/dist/cli/index.js

@@ -1,11 +1,28 @@
 #!/usr/bin/env node
 /**
- * CLI Entry Point - v2.0
+ * CLI Entry Point - v2.1
  *
- * Handles agent spawning commands:
+ * Handles agent spawning commands with memory management:
  *   npx claude-flow-novice agent <type> [options]
  */ // Load environment variables from .env file
 import 'dotenv/config';
+// Apply safe memory defaults if not configured
+if (!process.env.NODE_OPTIONS) {
+    // Set conservative 8GB limit (reduced from default 16GB)
+    process.env.NODE_OPTIONS = '--max-old-space-size=8192';
+} else if (!process.env.NODE_OPTIONS.includes('max-old-space-size')) {
+    // Append memory limit to existing NODE_OPTIONS
+    process.env.NODE_OPTIONS += ' --max-old-space-size=8192';
+}
+// Enable memory profiling in development/debug mode
+if (process.env.NODE_ENV === 'development' || process.env.CLAUDE_DEBUG) {
+    if (!process.env.NODE_OPTIONS.includes('inspect')) {
+        process.env.NODE_OPTIONS += ' --inspect=0.0.0.0:9229';
+    }
+    if (!process.env.NODE_OPTIONS.includes('heap-prof')) {
+        process.env.NODE_OPTIONS += ' --heap-prof';
+    }
+}
 import { VERSION } from '../core/index.js';
 import { agentCommand } from './agent-command.js';
 /**
@@ -54,6 +71,16 @@ import { agentCommand } from './agent-command.js';
             case '-h':
                 options.help = true;
                 break;
+            case '--memory-limit':
+                options.memoryLimit = parseInt(value, 10);
+                i++;
+                break;
+            case '--enable-profiling':
+                options.enableProfiling = true;
+                break;
+            case '--debug':
+                options.debug = true;
+                break;
         }
     }
     return {

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\r\n/**\r\n * CLI Entry Point - v2.0\r\n *\r\n * Handles agent spawning commands:\r\n *   npx claude-flow-novice agent <type> [options]\r\n */\r\n\r\n// Load environment variables from .env file\r\nimport 'dotenv/config';\r\n\r\nimport { VERSION } from '../core/index.js';\r\nimport { agentCommand, AgentCommandOptions } from './agent-command.js';\r\n\r\n/**\r\n * Parse command line arguments\r\n */\r\nfunction parseArgs(args: string[]): { command: string; agentType?: string; options: AgentCommandOptions } {\r\n  const command = args[0] || 'help';\r\n  const agentType = args[1] && !args[1].startsWith('--') ? args[1] : undefined;\r\n  const options: AgentCommandOptions = {};\r\n\r\n  // Parse options\r\n  for (let i = agentType ? 2 : 1; i < args.length; i++) {\r\n    const arg = args[i];\r\n    const value = args[i + 1];\r\n\r\n    switch (arg) {\r\n      case '--task-id':\r\n        options.taskId = value;\r\n        i++;\r\n        break;\r\n      case '--iteration':\r\n        options.iteration = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--agent-id':\r\n        options.agentId = value;\r\n        i++;\r\n        break;\r\n      case '--context':\r\n        options.context = value;\r\n        i++;\r\n        break;\r\n      case '--mode':\r\n        options.mode = value;\r\n        i++;\r\n        break;\r\n      case '--priority':\r\n        options.priority = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--parent-task-id':\r\n        options.parentTaskId = value;\r\n        i++;\r\n        break;\r\n      case '--list':\r\n        options.list = true;\r\n        break;\r\n      case '--help':\r\n      case '-h':\r\n        options.help = true;\r\n        break;\r\n    }\r\n  }\r\n\r\n  return { command, agentType, options };\r\n}\r\n\r\n/**\r\n * Display main CLI help\r\n */\r\nfunction displayHelp(): void {\r\n  console.log(`\r\nClaude Flow Novice CLI v${VERSION}\r\n\r\nUsage:\r\n  npx claude-flow-novice <command> [options]\r\n\r\nCommands:\r\n  agent <type> [options]    Spawn an agent for task execution\r\n  --version                 Show version number\r\n  --help                    Show this help message\r\n\r\nExamples:\r\n  # Spawn an agent\r\n  npx claude-flow-novice agent coder --context \"Implement feature\"\r\n\r\n  # List available agents\r\n  npx claude-flow-novice agent --list\r\n\r\n  # Show version\r\n  npx claude-flow-novice --version\r\n\r\nFor more information:\r\n  https://github.com/yourusername/claude-flow-novice\r\n`);\r\n}\r\n\r\n/**\r\n * Main CLI entry point\r\n */\r\nasync function main() {\r\n  const args = process.argv.slice(2);\r\n\r\n  // Handle version flag\r\n  if (args.includes('--version') || args.includes('-v')) {\r\n    console.log(`Claude Flow Novice v${VERSION}`);\r\n    return;\r\n  }\r\n\r\n  // Handle help flag\r\n  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {\r\n    displayHelp();\r\n    return;\r\n  }\r\n\r\n  const { command, agentType, options } = parseArgs(args);\r\n\r\n  switch (command) {\r\n    case 'agent':\r\n      await agentCommand(agentType, options);\r\n      break;\r\n\r\n    default:\r\n      console.error(`Unknown command: ${command}`);\r\n      console.log('Run with --help for usage information');\r\n      process.exit(1);\r\n  }\r\n}\r\n\r\n// Run CLI\r\nmain().catch((error) => {\r\n  console.error('[claude-flow-novice] Fatal error:', error);\r\n  process.exit(1);\r\n});\r\n"],"names":["VERSION","agentCommand","parseArgs","args","command","agentType","startsWith","undefined","options","i","length","arg","value","taskId","iteration","parseInt","agentId","context","mode","priority","parentTaskId","list","help","displayHelp","console","log","main","process","argv","slice","includes","error","exit","catch"],"mappings":";AACA;;;;;CAKC,GAED,4CAA4C;AAC5C,OAAO,gBAAgB;AAEvB,SAASA,OAAO,QAAQ,mBAAmB;AAC3C,SAASC,YAAY,QAA6B,qBAAqB;AAEvE;;CAEC,GACD,SAASC,UAAUC,IAAc;IAC/B,MAAMC,UAAUD,IAAI,CAAC,EAAE,IAAI;IAC3B,MAAME,YAAYF,IAAI,CAAC,EAAE,IAAI,CAACA,IAAI,CAAC,EAAE,CAACG,UAAU,CAAC,QAAQH,IAAI,CAAC,EAAE,GAAGI;IACnE,MAAMC,UAA+B,CAAC;IAEtC,gBAAgB;IAChB,IAAK,IAAIC,IAAIJ,YAAY,IAAI,GAAGI,IAAIN,KAAKO,MAAM,EAAED,IAAK;QACpD,MAAME,MAAMR,IAAI,CAACM,EAAE;QACnB,MAAMG,QAAQT,IAAI,CAACM,IAAI,EAAE;QAEzB,OAAQE;YACN,KAAK;gBACHH,QAAQK,MAAM,GAAGD;gBACjBH;gBACA;YACF,KAAK;gBACHD,QAAQM,SAAS,GAAGC,SAASH,OAAO;gBACpCH;gBACA;YACF,KAAK;gBACHD,QAAQQ,OAAO,GAAGJ;gBAClBH;gBACA;YACF,KAAK;gBACHD,QAAQS,OAAO,GAAGL;gBAClBH;gBACA;YACF,KAAK;gBACHD,QAAQU,IAAI,GAAGN;gBACfH;gBACA;YACF,KAAK;gBACHD,QAAQW,QAAQ,GAAGJ,SAASH,OAAO;gBACnCH;gBACA;YACF,KAAK;gBACHD,QAAQY,YAAY,GAAGR;gBACvBH;gBACA;YACF,KAAK;gBACHD,QAAQa,IAAI,GAAG;gBACf;YACF,KAAK;YACL,KAAK;gBACHb,QAAQc,IAAI,GAAG;gBACf;QACJ;IACF;IAEA,OAAO;QAAElB;QAASC;QAAWG;IAAQ;AACvC;AAEA;;CAEC,GACD,SAASe;IACPC,QAAQC,GAAG,CAAC,CAAC;wBACS,EAAEzB,QAAQ;;;;;;;;;;;;;;;;;;;;;;AAsBlC,CAAC;AACD;AAEA;;CAEC,GACD,eAAe0B;IACb,MAAMvB,OAAOwB,QAAQC,IAAI,CAACC,KAAK,CAAC;IAEhC,sBAAsB;IACtB,IAAI1B,KAAK2B,QAAQ,CAAC,gBAAgB3B,KAAK2B,QAAQ,CAAC,OAAO;QACrDN,QAAQC,GAAG,CAAC,CAAC,oBAAoB,EAAEzB,SAAS;QAC5C;IACF;IAEA,mBAAmB;IACnB,IAAIG,KAAKO,MAAM,KAAK,KAAKP,KAAK2B,QAAQ,CAAC,aAAa3B,KAAK2B,QAAQ,CAAC,OAAO;QACvEP;QACA;IACF;IAEA,MAAM,EAAEnB,OAAO,EAAEC,SAAS,EAAEG,OAAO,EAAE,GAAGN,UAAUC;IAElD,OAAQC;QACN,KAAK;YACH,MAAMH,aAAaI,WAAWG;YAC9B;QAEF;YACEgB,QAAQO,KAAK,CAAC,CAAC,iBAAiB,EAAE3B,SAAS;YAC3CoB,QAAQC,GAAG,CAAC;YACZE,QAAQK,IAAI,CAAC;IACjB;AACF;AAEA,UAAU;AACVN,OAAOO,KAAK,CAAC,CAACF;IACZP,QAAQO,KAAK,CAAC,qCAAqCA;IACnDJ,QAAQK,IAAI,CAAC;AACf"}
+{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\r\n/**\r\n * CLI Entry Point - v2.1\r\n *\r\n * Handles agent spawning commands with memory management:\r\n *   npx claude-flow-novice agent <type> [options]\r\n */\r\n\r\n// Load environment variables from .env file\r\nimport 'dotenv/config';\r\n\r\n// Apply safe memory defaults if not configured\r\nif (!process.env.NODE_OPTIONS) {\r\n  // Set conservative 8GB limit (reduced from default 16GB)\r\n  process.env.NODE_OPTIONS = '--max-old-space-size=8192';\r\n} else if (!process.env.NODE_OPTIONS.includes('max-old-space-size')) {\r\n  // Append memory limit to existing NODE_OPTIONS\r\n  process.env.NODE_OPTIONS += ' --max-old-space-size=8192';\r\n}\r\n\r\n// Enable memory profiling in development/debug mode\r\nif (process.env.NODE_ENV === 'development' || process.env.CLAUDE_DEBUG) {\r\n  if (!process.env.NODE_OPTIONS.includes('inspect')) {\r\n    process.env.NODE_OPTIONS += ' --inspect=0.0.0.0:9229';\r\n  }\r\n  if (!process.env.NODE_OPTIONS.includes('heap-prof')) {\r\n    process.env.NODE_OPTIONS += ' --heap-prof';\r\n  }\r\n}\r\n\r\nimport { VERSION } from '../core/index.js';\r\nimport { agentCommand, AgentCommandOptions } from './agent-command.js';\r\n\r\n/**\r\n * Parse command line arguments\r\n */\r\nfunction parseArgs(args: string[]): { command: string; agentType?: string; options: AgentCommandOptions } {\r\n  const command = args[0] || 'help';\r\n  const agentType = args[1] && !args[1].startsWith('--') ? args[1] : undefined;\r\n  const options: AgentCommandOptions = {};\r\n\r\n  // Parse options\r\n  for (let i = agentType ? 2 : 1; i < args.length; i++) {\r\n    const arg = args[i];\r\n    const value = args[i + 1];\r\n\r\n    switch (arg) {\r\n      case '--task-id':\r\n        options.taskId = value;\r\n        i++;\r\n        break;\r\n      case '--iteration':\r\n        options.iteration = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--agent-id':\r\n        options.agentId = value;\r\n        i++;\r\n        break;\r\n      case '--context':\r\n        options.context = value;\r\n        i++;\r\n        break;\r\n      case '--mode':\r\n        options.mode = value;\r\n        i++;\r\n        break;\r\n      case '--priority':\r\n        options.priority = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--parent-task-id':\r\n        options.parentTaskId = value;\r\n        i++;\r\n        break;\r\n      case '--list':\r\n        options.list = true;\r\n        break;\r\n      case '--help':\r\n      case '-h':\r\n        options.help = true;\r\n        break;\r\n      case '--memory-limit':\r\n        options.memoryLimit = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--enable-profiling':\r\n        options.enableProfiling = true;\r\n        break;\r\n      case '--debug':\r\n        options.debug = true;\r\n        break;\r\n    }\r\n  }\r\n\r\n  return { command, agentType, options };\r\n}\r\n\r\n/**\r\n * Display main CLI help\r\n */\r\nfunction displayHelp(): void {\r\n  console.log(`\r\nClaude Flow Novice CLI v${VERSION}\r\n\r\nUsage:\r\n  npx claude-flow-novice <command> [options]\r\n\r\nCommands:\r\n  agent <type> [options]    Spawn an agent for task execution\r\n  --version                 Show version number\r\n  --help                    Show this help message\r\n\r\nExamples:\r\n  # Spawn an agent\r\n  npx claude-flow-novice agent coder --context \"Implement feature\"\r\n\r\n  # List available agents\r\n  npx claude-flow-novice agent --list\r\n\r\n  # Show version\r\n  npx claude-flow-novice --version\r\n\r\nFor more information:\r\n  https://github.com/yourusername/claude-flow-novice\r\n`);\r\n}\r\n\r\n/**\r\n * Main CLI entry point\r\n */\r\nasync function main() {\r\n  const args = process.argv.slice(2);\r\n\r\n  // Handle version flag\r\n  if (args.includes('--version') || args.includes('-v')) {\r\n    console.log(`Claude Flow Novice v${VERSION}`);\r\n    return;\r\n  }\r\n\r\n  // Handle help flag\r\n  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {\r\n    displayHelp();\r\n    return;\r\n  }\r\n\r\n  const { command, agentType, options } = parseArgs(args);\r\n\r\n  switch (command) {\r\n    case 'agent':\r\n      await agentCommand(agentType, options);\r\n      break;\r\n\r\n    default:\r\n      console.error(`Unknown command: ${command}`);\r\n      console.log('Run with --help for usage information');\r\n      process.exit(1);\r\n  }\r\n}\r\n\r\n// Run CLI\r\nmain().catch((error) => {\r\n  console.error('[claude-flow-novice] Fatal error:', error);\r\n  process.exit(1);\r\n});\r\n"],"names":["process","env","NODE_OPTIONS","includes","NODE_ENV","CLAUDE_DEBUG","VERSION","agentCommand","parseArgs","args","command","agentType","startsWith","undefined","options","i","length","arg","value","taskId","iteration","parseInt","agentId","context","mode","priority","parentTaskId","list","help","memoryLimit","enableProfiling","debug","displayHelp","console","log","main","argv","slice","error","exit","catch"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-novice",
-  "version": "2.14.30",
+  "version": "2.14.32",
   "description": "AI agent orchestration framework with namespace-isolated skills, agents, and CFN Loop validation. Safe installation with ~0.01% collision risk.",
   "main": "dist/index.js",
   "type": "module",
@@ -24,6 +24,10 @@
     ".claude/skills/cfn-agent-output-processing/",
     ".claude/skills/cfn-agent-selector/",
     ".claude/skills/cfn-agent-spawning/",
+    ".claude/skills/cfn-docker-agent-spawning/",
+    ".claude/skills/cfn-docker-loop-orchestration/",
+    ".claude/skills/cfn-docker-redis-coordination/",
+    ".claude/skills/cfn-docker-skill-mcp-selection/",
     ".claude/skills/cfn-analytics/",
     ".claude/skills/cfn-backlog-management/",
     ".claude/skills/cfn-changelog-management/",
@@ -70,7 +74,11 @@
     "automation",
     "cli",
     "consensus",
-    "validation"
+    "validation",
+    "docker",
+    "containers",
+    "memory-leaks",
+    "concurrent-execution"
   ],
   "author": "Claude Flow Novice Team",
   "license": "MIT",

package/readme/README.md

@@ -12,24 +12,67 @@
 
 Claude Flow Novice is a production-ready AI agent orchestration framework built on a skills-first architecture with Redis-based coordination, zero-token waiting mechanisms, and multi-loop consensus validation (CFN Loop).
 
+## CFN Loop Execution Modes
+
+### Task Mode (Debugging - Full Visibility)
+- **Spawn Method**: Main Chat spawns Task() agents directly
+- **Cost**: $0.150/iteration (Anthropic provider)
+- **Visibility**: Complete agent output in Main Chat
+- **Use Case**: Debugging, learning, short tasks (<5 minutes)
+- **Memory**: ANTI-023 protection prevents memory leaks
+- **Audit**: Automatic audit trail storage in SQLite and Redis
+
+### CLI Mode (Production - Cost Optimized)
+- **Spawn Method**: Coordinator spawns CLI agents via `npx claude-flow-novice`
+- **Cost**: $0.054/iteration (64% savings vs Task mode)
+- **Visibility**: Background execution with progress tracking
+- **Use Case**: Production, long tasks, cost-sensitive workflows
+- **Memory**: Redis-based coordination with recovery capabilities
+- **Custom Routing**: Optional 5x cost reduction with Z.ai provider
+
+### Mode Selection Guide
+- **Use Task Mode when**: Debugging issues, learning CFN Loop, short tasks requiring full visibility
+- **Use CLI Mode when**: Production work, cost optimization, long-running tasks, background execution
+- **Custom Routing**: `/custom-routing-activate` for 95-98% total cost savings when using CLI mode
+
+### Slash Commands
+- **`/cfn-loop-task`**: Task mode execution (Main Chat → Task() agents)
+- **`/cfn-loop-cli`**: CLI mode execution (Main Chat → coordinator → CLI agents)
+- **Mode Parameters**: `--mode=mvp|standard|enterprise` with different confidence thresholds
+
+### Cost Comparison
+- **Task Mode**: $0.150/iteration (full visibility, debugging)
+- **CLI Mode**: $0.054/iteration (64% savings, production)
+- **With Custom Routing**: $0.004-0.010/iteration (95-98% total savings)
+
 ## Quick Start
 
+### Task Mode (Debugging - Full Visibility)
 ```bash
 # Install and initialize
 npm install claude-flow-novice
 npx cfn-init
 
-# Initialize a swarm with skills
+# Execute CFN Loop - Main Chat spawns Task() agents directly
+/cfn-loop-task "Implement JWT authentication" --mode=standard
+
+# Custom routing available for 5x cost reduction
+/custom-routing-activate
+```
+
+### CLI Mode (Production - Cost Optimized)
+```bash
+# Install and initialize
+npm install claude-flow-novice
+npx cfn-init
+
+# Execute CFN Loop - Coordinator spawns CLI agents in background
+/cfn-loop-cli "Implement JWT authentication" --mode=standard
+
+# Initialize swarm with skills
 npx claude-flow-novice swarm "Task Description" \
   --skills=redis-coordination,agent-spawning \
   --strategy development
-
-# Execute CFN Loop with orchestration
-./.claude/skills/redis-coordination/orchestrate-cfn-loop.sh \
-  --task-id "unique-task-id" \
-  --mode standard \
-  --loop3-agents "researcher,backend-developer" \
-  --loop2-agents "reviewer,tester"
 ```
 
 ## Documentation Index
@@ -37,6 +80,7 @@ npx claude-flow-novice swarm "Task Description" \
 ### Core Concepts
 - **[Skills System](log-skills.md)** - Modular, reusable agent capabilities
 - **[CFN Loop](cfn-loop-modes.md)** - Three-loop consensus validation framework
+- **[CFN Loop Task Mode](claude-assets/commands/CFN_LOOP_TASK_MODE.md)** - Task execution guide with agent specialization
 - **[Redis Coordination](logs-cli-redis.md)** - Zero-token agent coordination
 
 ### User Guides
@@ -83,17 +127,24 @@ npx claude-flow-novice swarm "Task Description" \
 - **Adaptive Modes**: MVP (fast), Standard (balanced), Enterprise (rigorous)
 
 ### Cost Optimization
-- **CLI Spawning Mode**: 95-98% cost savings vs Task tool
-- **Configurable**: `COST_SAVINGS_MODE=yes` in CLAUDE.md
-- **Safe Default**: Task tool spawning when disabled
+- **CLI Mode**: 64% savings vs Task mode ($0.054 vs $0.150/iteration)
+- **Custom Routing**: Optional 5x reduction with Z.ai provider (95-98% total savings)
+- **Mode-Aware Architecture**: Task Mode agents use clean exit, CLI Mode uses Redis coordination
+- **Memory Safety**: ANTI-023 protection prevents memory leaks in Task Mode
 
 ## Architecture Principles
 
 1. **Skills-Based Coordination**: All agent communication via explicit Redis dependencies
 2. **Multi-Layer Enforcement**: Coordination primitives at technical, skill, agent, and system layers
 3. **Centralized Orchestration**: Keep orchestration in dedicated skills, not distributed across components
-4. **Post-Edit Validation**: All Edit/Write operations trigger validation hooks
-5. **Parallel Agent Spawning**: All Task-based coordinators require parallel spawning (single message, multiple Task calls)
+4. **Mode-Aware Architecture**: Task Mode (direct Task() spawning) vs CLI Mode (coordinator-driven)
+5. **Post-Edit Validation**: All Edit/Write operations trigger validation hooks
+6. **Parallel Agent Spawning**: All Task-based coordinators require parallel spawning (single message, multiple Task calls)
+
+### Mode-Agent Profile Specialization
+- **Task Mode Agents**: Clean exit protocol, direct Main Chat communication, audit trail storage
+- **CLI Mode Agents**: Redis coordination, completion signaling, background execution
+- **Coordinators**: Enhanced monitoring with recovery capabilities, progress tracking
 
 ## Migration Notes
 
@@ -102,7 +153,13 @@ npx claude-flow-novice swarm "Task Description" \
 - Added: Skills system, Redis coordination, zero-token waiting, orchestrate-cfn-loop.sh
 - Breaking: CFN Loop now requires orchestrator (no manual Task spawning)
 
-See [CHANGELOG.md](CHANGELOG.md) for full migration guide.
+**v2.14 Changes:**
+- **Dual-Mode Architecture**: Task Mode (Main Chat Task() spawning) vs CLI Mode (coordinator-driven)
+- **Custom Routing**: Z.ai integration for 5x cost reduction in CLI mode
+- **Memory Safety**: ANTI-023 protection prevents memory leaks in Task Mode
+- **Enhanced Coordinators**: Progress tracking, recovery capabilities, multi-layer enforcement
+
+See [CHANGELOG.md](CHANGELOG.md) and [CFN Loop Task Mode Guide](claude-assets/commands/CFN_LOOP_TASK_MODE.md) for migration details.
 
 ## Support
 

package/scripts/memory-leak-prevention.sh

@@ -0,0 +1,306 @@
+#!/bin/bash
+
+# Memory Leak Detection and Prevention Script
+# Implements recommendations from memory leak analysis
+
+set -euo pipefail
+
+# Configuration
+DEFAULT_MEMORY_LIMIT="8192"  # 8GB limit instead of 16GB
+DEFAULT_NODE_OPTIONS="--max-old-space-size=$DEFAULT_MEMORY_LIMIT"
+PROFILING_DIR="/tmp/claude-memory-profiles"
+LOG_FILE="/tmp/claude-memory-monitor.log"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Create profiling directory
+mkdir -p "$PROFILING_DIR"
+
+log() {
+    echo "$(date '+%Y-%m-%d %H:%M:%S') - $1" | tee -a "$LOG_FILE"
+}
+
+show_help() {
+    cat << EOF
+Memory Leak Detection and Prevention Tool
+
+Usage: $0 [COMMAND] [OPTIONS]
+
+Commands:
+    profile           Start Claude with heap profiling enabled
+    monitor           Monitor existing Claude process memory usage
+    limit             Set memory limits for Claude sessions
+    install-tools     Install strace and perf for WSL
+    analyze           Analyze existing memory profiles
+    config            Show current memory configuration
+
+Options:
+    --limit MB        Set memory limit in MB (default: 8192)
+    --pid PID         Monitor specific process ID
+    --duration SEC    Monitoring duration in seconds (default: 300)
+    --output DIR      Output directory for profiles (default: /tmp/claude-memory-profiles)
+
+Examples:
+    $0 profile --limit 6144                    # Start Claude with 6GB limit and profiling
+    $0 monitor --pid 12345 --duration 600     # Monitor PID 12345 for 10 minutes
+    $0 install-tools                          # Install strace and perf
+    $0 analyze --output ./profiles            # Analyze existing profiles
+EOF
+}
+
+install_debug_tools() {
+    log "${BLUE}Installing strace and perf for debugging...${NC}"
+
+    if command -v apt-get &> /dev/null; then
+        sudo apt-get update
+        sudo apt-get install -y strace linux-tools-generic linux-perf
+    elif command -v yum &> /dev/null; then
+        sudo yum install -y strace perf
+    else
+        log "${RED}Unsupported package manager. Please install strace and perf manually.${NC}"
+        return 1
+    fi
+
+    # Configure perf for non-root users
+    echo -1 | sudo tee /proc/sys/kernel/perf_event_paranoid >/dev/null 2>&1 || true
+    echo 0 | sudo tee /proc/sys/kernel/kptr_restrict >/dev/null 2>&1 || true
+
+    log "${GREEN}Debug tools installed successfully${NC}"
+}
+
+start_with_profiling() {
+    local memory_limit=${1:-$DEFAULT_MEMORY_LIMIT}
+
+    log "${BLUE}Starting Claude with heap profiling and memory limit: ${memory_limit}MB${NC}"
+
+    # Set up environment for profiling
+    export NODE_OPTIONS="--max-old-space-size=$memory_limit --inspect=0.0.0.0:9229 --heap-prof"
+    export CLAUDE_MEMORY_PROFILE_DIR="$PROFILING_DIR"
+
+    # Create profile filename with timestamp
+    local profile_file="${PROFILING_DIR}/claude-profile-$(date +%Y%m%d-%H%M%S)"
+
+    log "${GREEN}Environment variables set:${NC}"
+    log "  NODE_OPTIONS: $NODE_OPTIONS"
+    log "  Profile directory: $PROFILING_DIR"
+    log "${YELLOW}Claude will start with debugging enabled on port 9229${NC}"
+    log "${YELLOW}Use Chrome DevTools or chrome://inspect to connect${NC}"
+
+    # Start Claude CLI with profiling
+    log "${BLUE}Starting Claude CLI...${NC}"
+    npx claude-flow-novice "$@"
+}
+
+monitor_memory() {
+    local target_pid=${1:-}
+    local duration=${2:-300}
+    local output_file="${PROFILING_DIR}/memory-monitor-$(date +%Y%m%d-%H%M%S).csv"
+
+    if [[ -z "$target_pid" ]]; then
+        log "${RED}Error: PID required for monitoring. Use --pid to specify.${NC}"
+        return 1
+    fi
+
+    log "${BLUE}Monitoring PID $target_pid for ${duration} seconds...${NC}"
+    log "Results will be saved to: $output_file"
+
+    # Create CSV header
+    echo "timestamp,pid,rss_mb,vms_mb,cpu_percent,open_files,connections" > "$output_file"
+
+    local start_time=$(date +%s)
+    local end_time=$((start_time + duration))
+
+    while [[ $(date +%s) -lt $end_time ]]; do
+        if ! kill -0 "$target_pid" 2>/dev/null; then
+            log "${RED}Process $target_pid is no longer running${NC}"
+            break
+        fi
+
+        local timestamp=$(date '+%Y-%m-%d %H:%M:%S')
+        local stats=$(ps -p "$target_pid" -o pid,rss,vms,pcpu --no-headers 2>/dev/null || echo "")
+
+        if [[ -n "$stats" ]]; then
+            local rss_mb=$(echo "$stats" | awk '{print int($2/1024)}')
+            local vms_mb=$(echo "$stats" | awk '{print int($3/1024)}')
+            local cpu_percent=$(echo "$stats" | awk '{print $4}')
+
+            # Count open files and network connections
+            local open_files=$(lsof -p "$target_pid" 2>/dev/null | wc -l || echo "0")
+            local connections=$(netstat -p 2>/dev/null | grep "$target_pid/" | wc -l || echo "0")
+
+            echo "$timestamp,$target_pid,$rss_mb,$vms_mb,$cpu_percent,$open_files,$connections" >> "$output_file"
+
+            # Alert if memory exceeds threshold
+            if [[ $rss_mb -gt 8192 ]]; then
+                log "${RED}⚠️  High memory usage detected: ${rss_mb}MB RSS${NC}"
+            fi
+
+            log "Memory: ${rss_mb}MB RSS, ${vms_mb}MB VMS, CPU: ${cpu_percent}%, Files: $open_files, Connections: $connections"
+        fi
+
+        sleep 10
+    done
+
+    log "${GREEN}Monitoring completed. Data saved to: $output_file${NC}"
+}
+
+set_memory_limits() {
+    local limit_mb=${1:-8192}
+
+    log "${BLUE}Setting memory limits to ${limit_mb}MB...${NC}"
+
+    # Update shell configuration
+    local shell_rc="$HOME/.bashrc"
+    if [[ -f "$HOME/.zshrc" ]]; then
+        shell_rc="$HOME/.zshrc"
+    fi
+
+    # Remove existing NODE_OPTIONS lines
+    sed -i '/^export NODE_OPTIONS="--max-old-space-size=/d' "$shell_rc" 2>/dev/null || true
+
+    # Add new limit
+    echo "export NODE_OPTIONS=\"--max-old-space-size=$limit_mb\"" >> "$shell_rc"
+
+    log "${GREEN}Memory limit set to ${limit_mb}MB in $shell_rc${NC}"
+    log "${YELLOW}Restart your shell or run: source $shell_rc${NC}"
+}
+
+analyze_profiles() {
+    local profile_dir=${1:-$PROFILING_DIR}
+
+    log "${BLUE}Analyzing memory profiles in $profile_dir...${NC}"
+
+    if [[ ! -d "$profile_dir" ]]; then
+        log "${RED}Profile directory $profile_dir does not exist${NC}"
+        return 1
+    fi
+
+    # Find heap profile files
+    local heap_profiles=($(find "$profile_dir" -name "*.heapprofile" 2>/dev/null))
+
+    if [[ ${#heap_profiles[@]} -eq 0 ]]; then
+        log "${YELLOW}No heap profiles found in $profile_dir${NC}"
+        return 1
+    fi
+
+    log "${GREEN}Found ${#heap_profiles[@]} heap profile(s)${NC}"
+
+    for profile in "${heap_profiles[@]}"; do
+        log "${BLUE}Analyzing: $(basename "$profile")${NC}"
+
+        # Basic analysis - find top allocations
+        if command -v node &> /dev/null; then
+            echo "Top 10 allocations in $(basename "$profile"):" > "${profile}.analysis"
+            node -e "
+                const fs = require('fs');
+                const data = JSON.parse(fs.readFileSync('$profile', 'utf8'));
+                const allocations = data.heapProfile || data;
+                if (allocations && allocations.samples) {
+                    allocations.samples
+                        .sort((a, b) => b.size - a.size)
+                        .slice(0, 10)
+                        .forEach((sample, i) => {
+                            console.log(\`\${i+1}. \${sample.functionName || 'unknown'}: \${(sample.size/1024/1024).toFixed(2)}MB\`);
+                        });
+                }
+            " >> "${profile}.analysis"
+
+            log "${GREEN}Analysis saved to: ${profile}.analysis${NC}"
+        fi
+    done
+}
+
+show_config() {
+    log "${BLUE}Current Memory Configuration:${NC}"
+
+    # Show current NODE_OPTIONS
+    if [[ -n "${NODE_OPTIONS:-}" ]]; then
+        log "  NODE_OPTIONS: $NODE_OPTIONS"
+    else
+        log "  NODE_OPTIONS: (not set)"
+    fi
+
+    # Show current limits
+    local current_limit=$(echo "$NODE_OPTIONS" | grep -o 'max-old-space-size=[0-9]*' | cut -d'=' -f2 || echo "unlimited")
+    log "  Memory limit: ${current_limit}MB"
+
+    # Show available memory
+    if command -v free &> /dev/null; then
+        local total_mem=$(free -m | awk 'NR==2{print $2}')
+        local available_mem=$(free -m | awk 'NR==2{print $7}')
+        log "  System memory: ${available_mem}MB available / ${total_mem}MB total"
+    fi
+
+    # Show profile directory
+    log "  Profile directory: $PROFILING_DIR"
+    log "  Log file: $LOG_FILE"
+}
+
+# Parse command line arguments
+case "${1:-}" in
+    "profile")
+        shift
+        local limit=$DEFAULT_MEMORY_LIMIT
+        while [[ $# -gt 0 ]]; do
+            case $1 in
+                --limit) limit="$2"; shift 2 ;;
+                *) shift ;;
+            esac
+        done
+        start_with_profiling "$limit"
+        ;;
+    "monitor")
+        shift
+        local pid=""
+        local duration=300
+        while [[ $# -gt 0 ]]; do
+            case $1 in
+                --pid) pid="$2"; shift 2 ;;
+                --duration) duration="$2"; shift 2 ;;
+                *) shift ;;
+            esac
+        done
+        monitor_memory "$pid" "$duration"
+        ;;
+    "limit")
+        shift
+        local limit=$DEFAULT_MEMORY_LIMIT
+        while [[ $# -gt 0 ]]; do
+            case $1 in
+                --limit) limit="$2"; shift 2 ;;
+                *) shift ;;
+            esac
+        done
+        set_memory_limits "$limit"
+        ;;
+    "install-tools")
+        install_debug_tools
+        ;;
+    "analyze")
+        shift
+        local dir=$PROFILING_DIR
+        while [[ $# -gt 0 ]]; do
+            case $1 in
+                --output) dir="$2"; shift 2 ;;
+                *) shift ;;
+            esac
+        done
+        analyze_profiles "$dir"
+        ;;
+    "config")
+        show_config
+        ;;
+    "help"|"-h"|"--help")
+        show_help
+        ;;
+    *)
+        log "${RED}Unknown command: ${1:-}${NC}"
+        show_help
+        exit 1
+        ;;
+esac