claude-flow-novice 1.6.2 → 1.6.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-novice",
-  "version": "1.6.2",
+  "version": "1.6.3",
   "description": "Standalone Claude Flow for beginners - AI agent orchestration made easy with enhanced TDD testing pipeline. Enhanced init command creates complete agent system, MCP configuration with 30 essential tools, and automated hooks with single-file testing, real-time coverage analysis, and advanced validation. Fully standalone with zero external dependencies, complete project setup in one command.",
   "mcpName": "io.github.ruvnet/claude-flow",
   "main": ".claude-flow-novice/dist/index.js",
@@ -212,7 +212,9 @@
     "README.md",
     "README-NPM.md",
     "LICENSE",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "AGENT_PERFORMANCE_GUIDELINES.md",
+    "MEMORY_LEAK_ROOT_CAUSE.md"
   ],
   "exports": {
     ".": "./.claude-flow-novice/dist/index.js",

package/scripts/monitor-loop.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# Monitor memory every 30 seconds, 20 iterations
+
+LOG_FILE="memory-monitor-$(date +%Y%m%d-%H%M%S).log"
+ITERATIONS=20
+INTERVAL=30
+
+echo "=== Memory Monitor Started ===" | tee "$LOG_FILE"
+echo "Monitoring for $((ITERATIONS * INTERVAL)) seconds ($ITERATIONS checks)" | tee -a "$LOG_FILE"
+echo "Timestamp: $(date)" | tee -a "$LOG_FILE"
+echo "" | tee -a "$LOG_FILE"
+
+for i in $(seq 1 $ITERATIONS); do
+    TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
+
+    # Total memory usage
+    TOTAL_MEM=$(ps aux | grep -E "(claude|node)" | grep -v grep | awk '{sum+=$6} END {printf "%.1f", sum/1024}')
+
+    # Node process count
+    NODE_COUNT=$(ps aux | grep node | grep -v grep | grep -v snapfuse | wc -l)
+
+    # Claude process count
+    CLAUDE_COUNT=$(ps aux | grep claude | grep -v grep | wc -l)
+
+    # Zombie processes
+    ZOMBIE_COUNT=$(ps aux | grep "<defunct>" | grep -v grep | wc -l)
+
+    # Find processes (memory bombs)
+    FIND_COUNT=$(ps aux | grep "find /mnt/c" | grep -v grep | wc -l)
+
+    # Hook processes
+    HOOK_COUNT=$(ps aux | grep "npx claude-flow-novice hooks" | grep -v grep | wc -l)
+
+    echo "[$i/$ITERATIONS] [$TIMESTAMP] MEM: ${TOTAL_MEM}MB | Node: $NODE_COUNT | Claude: $CLAUDE_COUNT | Zombies: $ZOMBIE_COUNT | Find: $FIND_COUNT | Hooks: $HOOK_COUNT" | tee -a "$LOG_FILE"
+
+    # Alerts
+    if (( $(echo "$TOTAL_MEM > 10000" | bc -l 2>/dev/null || echo 0) )); then
+        echo "  ⚠️  WARNING: Memory usage exceeds 10GB!" | tee -a "$LOG_FILE"
+    fi
+
+    if [ "$NODE_COUNT" -gt 20 ]; then
+        echo "  ⚠️  WARNING: $NODE_COUNT node processes (orphaned agents?)" | tee -a "$LOG_FILE"
+    fi
+
+    if [ "$FIND_COUNT" -gt 0 ]; then
+        echo "  🔴 CRITICAL: $FIND_COUNT find commands on /mnt/c (MEMORY BOMB!)" | tee -a "$LOG_FILE"
+    fi
+
+    if [ "$ZOMBIE_COUNT" -gt 0 ]; then
+        echo "  💀 ZOMBIE: $ZOMBIE_COUNT zombie processes detected" | tee -a "$LOG_FILE"
+    fi
+
+    if [ "$HOOK_COUNT" -gt 5 ]; then
+        echo "  🔁 RECURSION: $HOOK_COUNT hook processes (possible recursion!)" | tee -a "$LOG_FILE"
+    fi
+
+    # Don't sleep on last iteration
+    if [ $i -lt $ITERATIONS ]; then
+        sleep $INTERVAL
+    fi
+done
+
+echo "" | tee -a "$LOG_FILE"
+echo "=== Monitoring Complete ===" | tee -a "$LOG_FILE"
+echo "Log saved to: $LOG_FILE" | tee -a "$LOG_FILE"

package/scripts/monitor-memory.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+# Memory monitoring script for agent swarms
+
+LOG_FILE="memory-monitor.log"
+INTERVAL=5  # seconds
+
+echo "=== Memory Monitor Started ===" | tee -a "$LOG_FILE"
+echo "Timestamp: $(date)" | tee -a "$LOG_FILE"
+echo "" | tee -a "$LOG_FILE"
+
+while true; do
+    TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
+
+    # Total memory usage
+    TOTAL_MEM=$(ps aux | grep -E "(claude|node)" | grep -v grep | awk '{sum+=$6} END {print sum/1024}')
+
+    # Node process count
+    NODE_COUNT=$(ps aux | grep node | grep -v grep | grep -v snapfuse | wc -l)
+
+    # Claude process count
+    CLAUDE_COUNT=$(ps aux | grep claude | grep -v grep | wc -l)
+
+    # Zombie processes
+    ZOMBIE_COUNT=$(ps aux | grep "<defunct>" | grep -v grep | wc -l)
+
+    # Find processes (stuck)
+    FIND_COUNT=$(ps aux | grep "find /mnt/c" | grep -v grep | wc -l)
+
+    echo "[$TIMESTAMP] MEM: ${TOTAL_MEM}MB | Node: $NODE_COUNT | Claude: $CLAUDE_COUNT | Zombies: $ZOMBIE_COUNT | Find: $FIND_COUNT" | tee -a "$LOG_FILE"
+
+    # Alert if memory exceeds 10GB
+    if (( $(echo "$TOTAL_MEM > 10000" | bc -l) )); then
+        echo "⚠️  WARNING: Memory usage exceeds 10GB!" | tee -a "$LOG_FILE"
+    fi
+
+    # Alert if too many node processes
+    if [ "$NODE_COUNT" -gt 20 ]; then
+        echo "⚠️  WARNING: $NODE_COUNT node processes detected (orphaned agents?)" | tee -a "$LOG_FILE"
+    fi
+
+    # Alert if find commands stuck
+    if [ "$FIND_COUNT" -gt 0 ]; then
+        echo "🔴 CRITICAL: $FIND_COUNT find commands running on /mnt/c (memory bomb!)" | tee -a "$LOG_FILE"
+    fi
+
+    sleep $INTERVAL
+done

package/scripts/monitor.py

@@ -0,0 +1,43 @@
+#!/usr/bin/env python3
+import subprocess
+import time
+from datetime import datetime
+
+ITERATIONS = 20
+INTERVAL = 30
+
+print("=== Memory Monitor Started ===")
+print(f"Monitoring for {ITERATIONS * INTERVAL} seconds ({ITERATIONS} checks)")
+print(f"Timestamp: {datetime.now()}")
+print()
+
+for i in range(1, ITERATIONS + 1):
+    timestamp = datetime.now().strftime('%H:%M:%S')
+
+    # Total memory
+    mem_cmd = "ps aux | grep -E '(claude|node)' | grep -v grep | awk '{sum+=$6} END {printf \"%.1f\", sum/1024}'"
+    total_mem = subprocess.getoutput(mem_cmd)
+
+    # Process counts
+    node_count = subprocess.getoutput("ps aux | grep node | grep -v grep | grep -v snapfuse | wc -l").strip()
+    claude_count = subprocess.getoutput("ps aux | grep claude | grep -v grep | wc -l").strip()
+    zombie_count = subprocess.getoutput("ps aux | grep '<defunct>' | grep -v grep | wc -l").strip()
+    find_count = subprocess.getoutput("ps aux | grep 'find /mnt/c' | grep -v grep | wc -l").strip()
+
+    print(f"[{i}/{ITERATIONS}] [{timestamp}] MEM: {total_mem}MB | Node: {node_count} | Claude: {claude_count} | Zombies: {zombie_count} | Find: {find_count}")
+
+    # Alerts
+    if total_mem and float(total_mem) > 10000:
+        print("  ⚠️  WARNING: Memory usage exceeds 10GB!")
+
+    if find_count and int(find_count) > 0:
+        print(f"  🔴 CRITICAL: {find_count} find commands on /mnt/c (MEMORY BOMB!)")
+
+    if zombie_count and int(zombie_count) > 0:
+        print(f"  💀 ZOMBIE: {zombie_count} zombie processes detected")
+
+    if i < ITERATIONS:
+        time.sleep(INTERVAL)
+
+print()
+print("=== Monitoring Complete ===")