claude-flow-novice 2.18.22 → 2.18.23

package/.claude/skills/cfn-local-ruvector-accelerator/test_query_api.sh

@@ -1,103 +1,103 @@
-#!/bin/bash
-
-# Test script for Phase 4 Query API
-# This script tests the new query functionality
-
-set -euo pipefail
-
-echo "=== Testing Phase 4 Query API Implementation ==="
-echo
-
-# Check if the binary was built
-BINARY_PATH="./target/debug/local-ruvector"
-if [ ! -f "$BINARY_PATH" ]; then
-    echo "❌ Binary not found at $BINARY_PATH"
-    echo "Please build the project first with: cargo build"
-    exit 1
-fi
-
-echo "✅ Binary found at $BINARY_PATH"
-echo
-
-# Test 1: Check help for new subcommands
-echo "1. Testing help for 'find' subcommand:"
-$BINARY_PATH find --help | head -10
-echo
-
-echo "2. Testing help for 'refs' subcommand:"
-$BINARY_PATH refs --help | head -10
-echo
-
-# Test 2: Create a simple test case
-echo "3. Creating test data..."
-mkdir -p test_code
-cat > test_code/sample.rs << 'EOF'
-use std::collections::HashMap;
-
-pub struct Album {
-    pub id: u32,
-    pub title: String,
-}
-
-pub fn create_album(id: u32, title: &str) -> Album {
-    Album { id, title: title.to_string() }
-}
-
-pub fn print_album(album: &Album) {
-    println!("Album {}: {}", album.id, album.title);
-}
-
-fn main() {
-    let album = create_album(1, "Test Album");
-    print_album(&album);
-}
-EOF
-
-echo "✅ Created test_code/sample.rs"
-echo
-
-# Test 3: Initialize and index
-echo "4. Initializing ruvector..."
-$BINARY_PATH init --force
-echo
-
-echo "5. Indexing test files..."
-$BINARY_PATH index --path test_code --types rs
-echo
-
-# Test 4: Test find commands
-echo "6. Testing find commands..."
-
-echo "6a. Find functions using type 'Album':"
-$BINARY_PATH find --uses-type Album --limit 10
-echo
-
-echo "6b. Find callers of function 'create_album':"
-$BINARY_PATH find --called-by create_album
-echo
-
-echo "6c. Find types from test_code/sample.rs used elsewhere:"
-$BINARY_PATH find --types-from test_code/sample.rs
-echo
-
-echo "6d. Find public API of test_code module:"
-$BINARY_PATH find --public-api test_code --format detailed
-echo
-
-# Test 5: Test refs command
-echo "7. Testing refs command for 'Album':"
-$BINARY_PATH refs Album --format simple
-echo
-
-echo "8. Testing refs command with JSON output:"
-$BINARY_PATH refs create_album --format json | jq . 2>/dev/null || echo "(jq not available for pretty printing)"
-echo
-
-# Cleanup
-echo "9. Cleaning up test data..."
-rm -rf test_code
-$BINARY_PATH reset --confirm 2>/dev/null || true
-echo "✅ Cleanup complete"
-echo
-
+#!/bin/bash
+
+# Test script for Phase 4 Query API
+# This script tests the new query functionality
+
+set -euo pipefail
+
+echo "=== Testing Phase 4 Query API Implementation ==="
+echo
+
+# Check if the binary was built
+BINARY_PATH="./target/debug/local-ruvector"
+if [ ! -f "$BINARY_PATH" ]; then
+    echo "❌ Binary not found at $BINARY_PATH"
+    echo "Please build the project first with: cargo build"
+    exit 1
+fi
+
+echo "✅ Binary found at $BINARY_PATH"
+echo
+
+# Test 1: Check help for new subcommands
+echo "1. Testing help for 'find' subcommand:"
+$BINARY_PATH find --help | head -10
+echo
+
+echo "2. Testing help for 'refs' subcommand:"
+$BINARY_PATH refs --help | head -10
+echo
+
+# Test 2: Create a simple test case
+echo "3. Creating test data..."
+mkdir -p test_code
+cat > test_code/sample.rs << 'EOF'
+use std::collections::HashMap;
+
+pub struct Album {
+    pub id: u32,
+    pub title: String,
+}
+
+pub fn create_album(id: u32, title: &str) -> Album {
+    Album { id, title: title.to_string() }
+}
+
+pub fn print_album(album: &Album) {
+    println!("Album {}: {}", album.id, album.title);
+}
+
+fn main() {
+    let album = create_album(1, "Test Album");
+    print_album(&album);
+}
+EOF
+
+echo "✅ Created test_code/sample.rs"
+echo
+
+# Test 3: Initialize and index
+echo "4. Initializing ruvector..."
+$BINARY_PATH init --force
+echo
+
+echo "5. Indexing test files..."
+$BINARY_PATH index --path test_code --types rs
+echo
+
+# Test 4: Test find commands
+echo "6. Testing find commands..."
+
+echo "6a. Find functions using type 'Album':"
+$BINARY_PATH find --uses-type Album --limit 10
+echo
+
+echo "6b. Find callers of function 'create_album':"
+$BINARY_PATH find --called-by create_album
+echo
+
+echo "6c. Find types from test_code/sample.rs used elsewhere:"
+$BINARY_PATH find --types-from test_code/sample.rs
+echo
+
+echo "6d. Find public API of test_code module:"
+$BINARY_PATH find --public-api test_code --format detailed
+echo
+
+# Test 5: Test refs command
+echo "7. Testing refs command for 'Album':"
+$BINARY_PATH refs Album --format simple
+echo
+
+echo "8. Testing refs command with JSON output:"
+$BINARY_PATH refs create_album --format json | jq . 2>/dev/null || echo "(jq not available for pretty printing)"
+echo
+
+# Cleanup
+echo "9. Cleaning up test data..."
+rm -rf test_code
+$BINARY_PATH reset --confirm 2>/dev/null || true
+echo "✅ Cleanup complete"
+echo
+
 echo "=== Phase 4 Query API Tests Complete ==="

package/CLAUDE.md

@@ -22,11 +22,13 @@ Purpose: concise reference for CFN agents. Focus on persona, mandatory rules, ed
 - Batch operations: one message per batch (spawns, edits, shell, todos, memory).
 - Never mix implementers and validators in one message.
 - Do not run tests inside agents; run once via coordinator/main chat, agents read results.
+- **ANTI-024: Never run test commands with `run_in_background: true`** - orphaned test processes cause memory leaks. Always run tests synchronously. If tests hang, investigate; don't background them.
 - Never save to project root; use appropriate subdirectories.
 - Never hardcode secrets; always redact as `[REDACTED]`.
 - Use RuVector SQL for indexed projects (400x faster than grep); use grep only for non-indexed projects or non-code strings.
 - When monitoring, sleep-check-sleep loops.
 - All agent communication must use coordination protocols; no ad-hoc file coordination.
+- Run `./.claude/cfn-scripts/check-memory.sh` periodically to detect orphaned test processes; use `--kill` to clean them up.
 
 ## 3) Cerebras MCP & Context Discovery Protocols
 
@@ -384,12 +386,38 @@ Anti-patterns: pausing to ask what next, manual Task() for CLI workflows, skippi
 - Record any skipped tests with justification and follow-up owner.
 
 ## 29) Incident Response Notes
-- Capture exact command, commit hash, environment variables, and logs.  
-- Use `[REDACTED]` when logging sensitive fields.  
-- Prefer rollback via backup scripts rather than git reset.  
-- If orchestration deadlocks, restart orchestrator and clear stale Redis keys scoped to the task.  
+- Capture exact command, commit hash, environment variables, and logs.
+- Use `[REDACTED]` when logging sensitive fields.
+- Prefer rollback via backup scripts rather than git reset.
+- If orchestration deadlocks, restart orchestrator and clear stale Redis keys scoped to the task.
 - File incidents or backlog items using `.claude/skills/cfn-backlog-management/add-backlog-item.sh` with cause and remediation.
 
+## 30) Memory Leak Prevention (ANTI-024)
+Background test processes can become orphaned and accumulate memory. Use these tools to prevent and recover:
+
+**CLI Commands (available after npm install):**
+- `npx cfn-check-memory` - Report orphaned test processes
+- `npx cfn-check-memory --kill` - Kill orphaned processes
+- `npx cfn-check-memory --kill 500` - Kill only if total MB > 500
+- `npx cfn-run-limited 6G <command>` - Run command with 6GB memory limit (systemd cgroups)
+
+**NPM Scripts:**
+- `npm run test:safe` - Full test suite with 6GB limit
+- `npm run test:unit:safe` - Unit tests with 2GB limit
+- `npm run check:memory` - Report orphans
+- `npm run check:memory:kill` - Kill orphans
+
+**Prevention Rules:**
+- Never use `run_in_background: true` for test commands
+- Jest config enforces: `maxWorkers: 4`, `forceExit: true`, `workerIdleMemoryLimit: 512MB`
+- If tests hang, investigate root cause; don't background them
+
+**Recovery:**
+```bash
+npx cfn-check-memory --kill    # Kill all orphaned test processes
+ps aux | grep -E "(jest|vitest|node.*test)" | grep -v grep  # Manual check
+```
+
 ---
 
 Use this trimmed guide as the default reference. For CFN-specific deep dives, defer to specialized docs or agents noted above. Keep this file lean; avoid reintroducing duplication.

package/package.json

@@ -1,17 +1,19 @@
 {
   "name": "claude-flow-novice",
-  "version": "2.18.22",
+  "version": "2.18.23",
   "description": "Claude Flow Novice - Advanced orchestration platform for multi-agent AI workflows with CFN Loop architecture\n\nIncludes Local RuVector Accelerator and all CFN skills for complete functionality.",
   "main": "index.js",
   "type": "module",
   "bin": {
-    "cfn-init": "./scripts/cfn-init.js"
+    "cfn-init": "./scripts/cfn-init.js",
+    "cfn-check-memory": "./.claude/cfn-scripts/check-memory.sh",
+    "cfn-run-limited": "./.claude/cfn-scripts/run-with-memory-limit.sh"
   },
   "scripts": {
     "test": "npm run test:unit && npm run test:integration && npm run test:e2e",
-    "test:unit": "jest --testPathPattern=tests/unit --coverage --coverageDirectory=coverage/unit",
-    "test:integration": "jest --testPathPattern=tests/integration --coverage --coverageDirectory=coverage/integration",
-    "test:e2e": "jest --testPathPattern=tests/e2e --coverage --coverageDirectory=coverage/e2e",
+    "test:unit": "./.claude/cfn-scripts/run-with-memory-limit.sh 2G jest --testPathPattern=tests/unit --coverage --coverageDirectory=coverage/unit",
+    "test:integration": "./.claude/cfn-scripts/run-with-memory-limit.sh 4G jest --testPathPattern=tests/integration --coverage --coverageDirectory=coverage/integration",
+    "test:e2e": "./.claude/cfn-scripts/run-with-memory-limit.sh 6G jest --testPathPattern=tests/e2e --coverage --coverageDirectory=coverage/e2e",
     "test:docker": "./tests/docker-mode/run-all-implementations.sh",
     "test:cli": "./tests/cli-mode/run-all-tests.sh",
     "test:cfn-v3": "./tests/cfn-v3/test-e2e-cfn-loop.sh",
@@ -61,6 +63,8 @@
     "ruvector:local:query": "./.claude/skills/cfn-local-ruvector-accelerator/cfn-integration.sh query",
     "ruvector:local:stats": "./.claude/skills/cfn-local-ruvector-accelerator/cfn-integration.sh stats",
     "ruvector:local:build": "cd .claude/skills/cfn-local-ruvector-accelerator && cargo build --release",
+    "check:memory": "./.claude/cfn-scripts/check-memory.sh",
+    "check:memory:kill": "./.claude/cfn-scripts/check-memory.sh --kill",
     "ci:pre-commit": "npm run lint && npm run test:unit && npm run security:audit",
     "ci:full": "npm run test && npm run lint:fix && npm run security:audit && npm run performance:benchmark",
     "dev:watch": "concurrently \"npm run build:watch\" \"nodemon dist/index.js\"",