claude-flow-novice 2.9.0 → 2.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-novice",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "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",
@@ -18,7 +18,28 @@
   "files": [
     "dist/",
     ".claude/agents/cfn-dev-team/",
-    ".claude/skills/cfn-*/",
+    ".claude/skills/cfn-ace-system/",
+    ".claude/skills/cfn-agent-discovery/",
+    ".claude/skills/cfn-agent-execution/",
+    ".claude/skills/cfn-agent-output-processing/",
+    ".claude/skills/cfn-agent-selector/",
+    ".claude/skills/cfn-agent-spawning/",
+    ".claude/skills/cfn-analytics/",
+    ".claude/skills/cfn-checkpoint-state/",
+    ".claude/skills/cfn-config-management/",
+    ".claude/skills/cfn-event-bus/",
+    ".claude/skills/cfn-fleet-manager/",
+    ".claude/skills/cfn-hook-pipeline/",
+    ".claude/skills/cfn-hybrid-routing/",
+    ".claude/skills/cfn-loop-orchestration/",
+    ".claude/skills/cfn-loop-validation/",
+    ".claude/skills/cfn-process-lifecycle/",
+    ".claude/skills/cfn-product-owner-decision/",
+    ".claude/skills/cfn-redis-coordination/",
+    ".claude/skills/cfn-sqlite-memory/",
+    ".claude/skills/cfn-test-execution/",
+    ".claude/skills/cfn-transparency-middleware/",
+    ".claude/skills/cfn-webapp-testing/",
     ".claude/hooks/cfn-*",
     ".claude/commands/cfn/",
     ".claude/cfn-data/",
@@ -28,9 +49,11 @@
     "!scripts/test-*.sh",
     "!scripts/*-validation.cjs",
     "!scripts/deployment/",
+    "tools/simple-complexity.sh",
+    "tools/install-lizard.sh",
     "README.md",
     "LICENSE",
-    "CFN-CLAUDE.md"
+    ".claude/root-claude-distribute/CFN-CLAUDE.md"
   ],
   "keywords": [
     "ai",
@@ -50,7 +73,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/yourusername/claude-flow-novice.git"
+    "url": "git+https://github.com/yourusername/claude-flow-novice.git"
   },
   "bugs": {
     "url": "https://github.com/yourusername/claude-flow-novice/issues"
@@ -62,10 +85,16 @@
     "build:swc": "swc src -d dist --config-file .swcrc --ignore '**/*.test.ts' --ignore '**/*.test.tsx' --ignore '**/*.spec.ts'",
     "clean": "rm -rf dist",
     "test": "jest",
+    "test:cfn-v3": "bash tests/cfn-v3-orchestration/run-full-suite.sh",
+    "test:cfn-v3:connections": "node tests/cfn-v3-orchestration/tests/02-worker-connections.test.js",
+    "test:cfn-v3:confidence": "node tests/cfn-v3-orchestration/tests/03-confidence-scores.test.js",
+    "test:cfn-v3:handoffs": "node tests/cfn-v3-orchestration/tests/04-handoff-coordination.test.js",
+    "test:cfn-v3:dataflow": "node tests/cfn-v3-orchestration/tests/05-data-flow.test.js",
+    "test:cfn-v3:shutdown": "node tests/cfn-v3-orchestration/tests/06-graceful-shutdown.test.js",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build && ./scripts/verify-no-secrets.sh",
     "prepack": "npm run build",
-    "postinstall": "node -e \"console.log('\\n✅ claude-flow-novice installed successfully!\\n📚 Get started: npx claude-flow-novice --help\\n🔧 Initialize project: npx cfn-init\\n💡 CFN loops: npx cfn-loop \\\"Task description\\\"\\n')\"",
+    "postinstall": "node scripts/init-project.js",
     "verify-package": "npm pack --dry-run",
     "portal:start": "./scripts/start-portal.sh",
     "portal:stop": "./scripts/stop-portal.sh",
@@ -88,6 +117,11 @@
     "sqlite": "^5.1.1",
     "sqlite3": "^5.1.7"
   },
+  "optionalDependencies": {},
+  "peerDependencies": {},
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "devDependencies": {
     "@swc/cli": "^0.1.62",
     "@swc/core": "^1.3.0",
@@ -111,7 +145,9 @@
     "tsx": "^4.7.0",
     "typescript": "^5.6.3"
   },
-  "engines": {
-    "node": ">=18.0.0"
+  "directories": {
+    "doc": "docs",
+    "example": "examples",
+    "test": "tests"
   }
 }

package/readme/README.md

@@ -1,7 +1,12 @@
-# Claude Flow Novice v2 Documentation
+# Claude Flow Novice v2.9.1 Documentation
 
-**Version:** 2.0 (Skills-First Architecture)
-**Last Updated:** 2025-10-19
+**Version:** 2.9.1 (Skills-First Architecture)
+**Last Updated:** 2025-10-25
+
+**Package Metrics**:
+- 2.4 MB unpacked
+- 303 files
+- Namespace-isolated installation
 
 ## Overview
 
@@ -10,6 +15,10 @@ Claude Flow Novice is a production-ready AI agent orchestration framework built
 ## Quick Start
 
 ```bash
+# Install and initialize
+npm install claude-flow-novice
+npx cfn-init
+
 # Initialize a swarm with skills
 npx claude-flow-novice swarm "Task Description" \
   --skills=redis-coordination,agent-spawning \
@@ -59,11 +68,13 @@ npx claude-flow-novice swarm "Task Description" \
 - **Modular Skills**: Independently maintainable, testable capabilities
 - **Explicit Dependencies**: Redis pub/sub coordination, no implicit coupling
 - **Thin Orchestration**: Main chat delegates to skills, minimal coordination logic
+- **Namespace-Isolated Installation**: ~0.01% collision risk
+- **Preserves User Custom Agents/Skills/Hooks**
 
 ### Zero-Token Coordination
 - **Redis BLPOP**: Agents wait without API calls (0 tokens while idle)
 - **Instant Wake-Up**: <100ms latency for agent activation
-- **Scalable**: 10+ agents, indefinite iteration cycles
+- **Scalable**: 23 agents in cfn-dev-team
 
 ### CFN Loop (Consensus Framework)
 - **Loop 3**: Implementation agents (coders, researchers)

package/scripts/init-project.js

@@ -4,6 +4,7 @@ import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { promisify } from 'util';
+import { spawnSync } from 'child_process';
 import chalk from 'chalk';
 
 const __filename = fileURLToPath(import.meta.url);
@@ -13,30 +14,35 @@ const cpAsync = promisify(fs.cp);
 const mkdirAsync = promisify(fs.mkdir);
 const existsAsync = promisify(fs.exists);
 
+// Find the CFN package root (works both in dev and installed contexts)
+const cfnRoot = path.resolve(process.cwd(), 'node_modules', 'claude-flow-novice');
+
 // Configuration for CFN initialization paths
 const CFN_PATHS = {
   agents: {
-    src: path.resolve(__dirname, '../.claude/agents/cfn-dev-team'),
+    src: path.join(cfnRoot, '.claude/agents/cfn-dev-team'),
     dest: '.claude/agents/cfn-dev-team'
   },
   skills: {
-    src: path.resolve(__dirname, '../.claude/skills/cfn-*'),
-    dest: '.claude/skills/cfn-*'
+    src: path.join(cfnRoot, '.claude/skills'),
+    dest: '.claude/skills',
+    pattern: 'cfn-*'
   },
   hooks: {
-    src: path.resolve(__dirname, '../.claude/hooks/cfn-*'),
-    dest: '.claude/hooks/cfn-*'
+    src: path.join(cfnRoot, '.claude/hooks'),
+    dest: '.claude/hooks',
+    pattern: 'cfn-*'
   },
   commands: {
-    src: path.resolve(__dirname, '../.claude/commands/cfn'),
+    src: path.join(cfnRoot, '.claude/commands/cfn'),
     dest: '.claude/commands/cfn'
   },
   cfnData: {
-    src: path.resolve(__dirname, '../.claude/cfn-data'),
+    src: path.join(cfnRoot, '.claude/cfn-data'),
     dest: '.claude/cfn-data'
   },
   cfnAgentsIgnore: {
-    src: path.resolve(__dirname, '../.claude/cfn-agents-ignore'),
+    src: path.join(cfnRoot, '.claude/cfn-agents-ignore'),
     dest: '.claude/cfn-agents-ignore'
   }
 };
@@ -60,25 +66,38 @@ async function ensureDirectories() {
 }
 
 async function verifyCfnInstallation() {
-  try {
-    await import('claude-flow-novice');
-  } catch (error) {
+  const cfnPath = path.resolve(process.cwd(), 'node_modules', 'claude-flow-novice');
+  if (!fs.existsSync(cfnPath)) {
     console.error(chalk.red('❌ claude-flow-novice not installed. Please run: npm install claude-flow-novice'));
     process.exit(1);
   }
 }
 
-async function copyFiles(src, dest, pattern = '*') {
+async function copyFiles(src, dest, pattern) {
   try {
-    await cpAsync(src, dest, {
-      recursive: true,
-      force: true,
-      filter: (source) => {
-        // Optional: Add filtering logic if needed
-        return true;
+    if (!fs.existsSync(src)) {
+      console.warn(chalk.yellow(`⚠️ Source not found: ${src}`));
+      return false;
+    }
+
+    if (pattern) {
+      // Copy only files/dirs matching pattern (e.g., cfn-*)
+      const items = fs.readdirSync(src);
+      const matched = items.filter(item => item.startsWith(pattern.replace('*', '')));
+
+      for (const item of matched) {
+        const itemSrc = path.join(src, item);
+        const itemDest = path.join(dest, item);
+        await mkdirAsync(path.dirname(itemDest), { recursive: true });
+        await cpAsync(itemSrc, itemDest, { recursive: true, force: true });
       }
-    });
-    console.log(chalk.green(`✅ Copied ${src} → ${dest}`));
+      console.log(chalk.green(`✅ Copied ${matched.length} ${pattern} items from ${src}`));
+    } else {
+      // Copy entire directory
+      await mkdirAsync(path.dirname(dest), { recursive: true });
+      await cpAsync(src, dest, { recursive: true, force: true });
+      console.log(chalk.green(`✅ Copied ${src} → ${dest}`));
+    }
     return true;
   } catch (error) {
     console.error(chalk.red(`❌ Error copying ${src}: ${error.message}`));
@@ -87,14 +106,14 @@ async function copyFiles(src, dest, pattern = '*') {
 }
 
 async function copyCfnClaudeMarkdown() {
-  const cfnClaudeMdPath = path.resolve(__dirname, '../CFN-CLAUDE.md');
+  const cfnClaudeMdPath = path.join(cfnRoot, '.claude/root-claude-distribute/CFN-CLAUDE.md');
   const destPath = path.resolve(process.cwd(), 'CFN-CLAUDE.md');
 
-  if (await existsAsync(cfnClaudeMdPath)) {
+  if (fs.existsSync(cfnClaudeMdPath)) {
     try {
       await cpAsync(cfnClaudeMdPath, destPath);
       console.log(chalk.green('📄 CFN-CLAUDE.md copied to project root'));
-      console.log(chalk.yellow('💡 Use CFN-CLAUDE.md as a reference. Copy to CLAUDE.md if needed.'));
+      console.log(chalk.yellow('💡 Activate CFN workflows: cp CFN-CLAUDE.md CLAUDE.md'));
     } catch (error) {
       console.error(chalk.red(`❌ Failed to copy CFN-CLAUDE.md: ${error.message}`));
     }
@@ -103,8 +122,40 @@ async function copyCfnClaudeMarkdown() {
   }
 }
 
+async function installLizard() {
+  console.log(chalk.blue('\n🔧 Installing lizard (complexity analyzer)...'));
+
+  // Check if lizard is already installed
+  const checkResult = spawnSync('which', ['lizard'], { encoding: 'utf-8' });
+  if (checkResult.status === 0) {
+    console.log(chalk.green('✅ Lizard already installed'));
+    return;
+  }
+
+  // Try to install lizard via pip3
+  const pipCommands = [
+    ['pip3', 'install', '--user', '--break-system-packages', 'lizard'],
+    ['pip3', 'install', '--user', 'lizard'],
+    ['pip', 'install', '--user', 'lizard']
+  ];
+
+  for (const cmd of pipCommands) {
+    const result = spawnSync(cmd[0], cmd.slice(1), { encoding: 'utf-8' });
+    if (result.status === 0) {
+      console.log(chalk.green('✅ Lizard installed successfully'));
+      console.log(chalk.yellow('💡 Add to PATH: export PATH="$HOME/.local/bin:$PATH"'));
+      return;
+    }
+  }
+
+  // If all attempts failed, provide instructions
+  console.log(chalk.yellow('⚠️ Could not auto-install lizard. Manual installation required:'));
+  console.log(chalk.gray('   pip3 install --user lizard'));
+  console.log(chalk.gray('   or run: ./tools/install-lizard.sh'));
+}
+
 async function initializeCfnProject() {
-  console.log(chalk.blue('🚀 Claude Flow Novice CFN Initialization'));
+  console.log(chalk.blue('\n🚀 Claude Flow Novice CFN Initialization\n'));
 
   try {
     // Verify prerequisites
@@ -115,8 +166,8 @@ async function initializeCfnProject() {
     const copyResults = [];
 
     // Copy CFN files
-    for (const [key, { src, dest }] of Object.entries(CFN_PATHS)) {
-      const result = await copyFiles(src, dest);
+    for (const [key, config] of Object.entries(CFN_PATHS)) {
+      const result = await copyFiles(config.src, config.dest, config.pattern);
       copyResults.push(result);
     }
 
@@ -129,10 +180,14 @@ async function initializeCfnProject() {
 
     console.log(chalk.green(`\n✅ CFN Installation Complete`));
     console.log(chalk.blue(`   Copied ${successCount}/${totalPaths} paths successfully`));
+
+    // Install lizard for complexity analysis
+    await installLizard();
+
     console.log(chalk.yellow('\n🔍 Next Steps:'));
-    console.log('   1. Review CFN-CLAUDE.md');
-    console.log('   2. Configure your project');
-    console.log('   3. Run initial CFN setup: npx claude-flow-novice init');
+    console.log('   1. Review CFN-CLAUDE.md in project root');
+    console.log('   2. Run your first CFN Loop: npx cfn-loop "Task description"');
+    console.log('   3. Check available agents: ls .claude/agents/cfn-dev-team/*/\n');
 
   } catch (error) {
     console.error(chalk.red('❌ CFN Initialization Failed'), error);

package/scripts/run-marketing-tests.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+# Run Marketing Infrastructure Integration Tests
+
+set -e
+
+# Ensure the correct working directory
+cd "$(dirname "$0")/.." || exit 1
+
+# Run all marketing test scripts
+echo "🚀 Starting Marketing Infrastructure Integration Tests..."
+
+# Function to run test and capture exit code
+run_test() {
+    local test_script="$1"
+    local start_time=$(date +%s)
+
+    echo "Running $test_script..."
+
+    if bash "$test_script"; then
+        local end_time=$(date +%s)
+        local duration=$((end_time - start_time))
+        echo "✅ $test_script PASSED (${duration}s)"
+    else
+        echo "❌ $test_script FAILED"
+        exit 1
+    fi
+}
+
+# Array of test scripts
+TEST_SCRIPTS=(
+    "tests/marketing-email-campaigns-test.sh"
+    "tests/marketing-social-publishing-test.sh"
+    "tests/marketing-analytics-data-test.sh"
+    "tests/marketing-crm-contacts-test.sh"
+)
+
+# Run each test script
+for test in "${TEST_SCRIPTS[@]}"; do
+    run_test "$test"
+done
+
+echo "🎉 All Marketing Infrastructure Integration Tests PASSED!"
+exit 0

package/scripts/update_paths.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+
+# Path replacements
+SKILL_REPLACEMENTS=(
+    ".claude/skills/redis-coordination/:\.claude/skills/cfn-redis-coordination/"
+    ".claude/skills/agent-spawning/:\.claude/skills/cfn-agent-spawning/"
+    ".claude/skills/playbook/:\.claude/skills/cfn-playbook/"
+    ".claude/skills/:\.claude/skills/cfn-"
+)
+
+HOOK_REPLACEMENTS=(
+    ".claude/hooks/invoke-post-edit.sh:\.claude/hooks/cfn-invoke-post-edit.sh"
+    ".claude/hooks/post-edit.sh:\.claude/hooks/cfn-post-edit.sh"
+    ".claude/hooks/:\.claude/hooks/cfn-"
+)
+
+DATA_REPLACEMENTS=(
+    ".claude/data/:\.claude/cfn-data/"
+)
+
+# Function to perform replacements in a file
+replace_paths() {
+    local file="$1"
+    local replacements=("${@:2}")
+
+    # Perform replacements for each pattern
+    for replacement in "${replacements[@]}"; do
+        IFS=':' read -r old_path new_path <<< "$replacement"
+        sed -i "s|${old_path}|${new_path}|g" "$file"
+    done
+}
+
+# Find and update markdown files
+find .claude/agents/cfn-dev-team -name "*.md" | while read -r file; do
+    echo "Processing $file"
+
+    # Skill path replacements
+    replace_paths "$file" "${SKILL_REPLACEMENTS[@]}"
+
+    # Hook path replacements
+    replace_paths "$file" "${HOOK_REPLACEMENTS[@]}"
+
+    # Data path replacements
+    replace_paths "$file" "${DATA_REPLACEMENTS[@]}"
+done
+
+echo "Path replacements complete!"

package/tools/install-lizard.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# Install lizard complexity analyzer
+
+echo "Installing lizard..."
+
+# Try pipx first (isolated install)
+if command -v pipx >/dev/null 2>&1; then
+    echo "Using pipx..."
+    pipx install lizard
+    exit 0
+fi
+
+# Try pip with user install
+if command -v pip3 >/dev/null 2>&1; then
+    echo "Using pip3 --user..."
+    pip3 install --user lizard
+
+    # Add to PATH if needed
+    PYTHON_USER_BASE=$(python3 -m site --user-base)
+    export PATH="$PYTHON_USER_BASE/bin:$PATH"
+
+    echo ""
+    echo "Add to your ~/.bashrc or ~/.zshrc:"
+    echo "export PATH=\"$PYTHON_USER_BASE/bin:\$PATH\""
+    exit 0
+fi
+
+# Try pip
+if command -v pip >/dev/null 2>&1; then
+    echo "Using pip --user..."
+    pip install --user lizard
+    exit 0
+fi
+
+echo "Error: No Python package manager found"
+echo "Install pipx: sudo apt-get install pipx"
+exit 1

package/tools/simple-complexity.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+# Simple cyclomatic complexity calculator for bash scripts
+
+FILE="$1"
+
+if [ ! -f "$FILE" ]; then
+    echo "Usage: $0 <bash-script>"
+    exit 1
+fi
+
+echo "Cyclomatic Complexity Analysis: $(basename "$FILE")"
+echo "=================================================="
+
+# Count decision points
+IF_COUNT=$(grep -cE '^\s*(if|elif)\s+' "$FILE" 2>/dev/null || echo 0)
+LOOP_COUNT=$(grep -cE '^\s*(for|while|until)\s+' "$FILE" 2>/dev/null || echo 0)
+CASE_COUNT=$(grep -cE '^\s*case\s+' "$FILE" 2>/dev/null || echo 0)
+AND_OR=$(grep -vE '^\s*#' "$FILE" | grep -oE '(\&\&|\|\|)' | wc -l)
+FUNC_COUNT=$(grep -cE 'function\s+[a-zA-Z_]|^[a-zA-Z_][a-zA-Z0-9_]*\s*\(\)' "$FILE" 2>/dev/null || echo 0)
+
+# Calculate total (base 1 + decision points)
+TOTAL=$((1 + IF_COUNT + LOOP_COUNT + CASE_COUNT + AND_OR / 2))
+
+echo "Decision Points:"
+echo "  if/elif:        $IF_COUNT"
+echo "  loops:          $LOOP_COUNT"
+echo "  case:           $CASE_COUNT"
+echo "  &&/||:          $AND_OR"
+echo "  functions:      $FUNC_COUNT"
+echo ""
+echo "Total Complexity: $TOTAL"
+echo ""
+
+if [ $TOTAL -ge 40 ]; then
+    echo "Rating: Very Complex (refactor required)"
+elif [ $TOTAL -ge 20 ]; then
+    echo "Rating: Complex (refactor recommended)"
+elif [ $TOTAL -ge 10 ]; then
+    echo "Rating: Moderate"
+else
+    echo "Rating: Simple"
+fi
+
+echo "=================================================="