claude-flow-novice 2.0.0 → 2.0.1

package/examples/templates/custom-agent/CLAUDE.md

@@ -0,0 +1,299 @@
+# Claude Flow Novice — Custom Agent Template
+
+---
+
+## Custom Agent Development
+
+This template helps you create **custom specialized agents** with unique capabilities.
+
+### Agent Structure
+
+```
+.claude/agents/
+├── my-custom-agent.md        # Agent definition
+├── my-custom-agent-tools.js  # Custom tools
+└── my-custom-agent-config.json  # Configuration
+```
+
+### Creating a Custom Agent
+
+#### 1. Define Agent Behavior
+
+Create `.claude/agents/my-custom-agent.md`:
+
+```markdown
+# Custom Agent Name
+
+## Role
+Specialized agent for [specific purpose]
+
+## Capabilities
+- Capability 1
+- Capability 2
+- Capability 3
+
+## Tools
+- tool1: Description
+- tool2: Description
+
+## Workflow
+1. Step 1
+2. Step 2
+3. Step 3
+
+## Output Format
+Expected output structure
+```
+
+#### 2. Implement Custom Tools
+
+Create `.claude/agents/my-custom-agent-tools.js`:
+
+```javascript
+export async function customTool1(params) {
+  // Implementation
+  return result;
+}
+
+export async function customTool2(params) {
+  // Implementation
+  return result;
+}
+```
+
+#### 3. Configure Agent
+
+Create `.claude/agents/my-custom-agent-config.json`:
+
+```json
+{
+  "name": "my-custom-agent",
+  "role": "specialist",
+  "capabilities": ["cap1", "cap2"],
+  "tools": ["tool1", "tool2"],
+  "priority": 5,
+  "confidence_threshold": 0.75
+}
+```
+
+---
+
+## Using Custom Agents in Swarms
+
+### Spawn Custom Agent
+
+```bash
+# In swarm configuration
+executeSwarm({
+  swarmId: "custom-agent-swarm",
+  objective: "Task requiring custom capabilities",
+  agents: [
+    { role: "my-custom-agent", count: 1 },
+    { role: "coder", count: 2 }
+  ],
+  strategy: "development",
+  mode: "mesh"
+})
+```
+
+### Agent Communication
+
+Custom agents use **Redis pub/sub** for coordination:
+
+```javascript
+// Publish message
+await redis.publish('agent:my-custom-agent:message', JSON.stringify({
+  type: 'task-update',
+  data: { progress: 50 }
+}));
+
+// Subscribe to messages
+await redis.subscribe('agent:my-custom-agent:*', (message) => {
+  handleMessage(JSON.parse(message));
+});
+```
+
+---
+
+## Agent Templates
+
+### Data Processing Agent
+
+```markdown
+# Data Processing Agent
+
+## Role
+Process and transform large datasets
+
+## Capabilities
+- Parse CSV/JSON/XML
+- Transform data structures
+- Validate data quality
+- Generate reports
+
+## Tools
+- parseData(format, data)
+- transformData(rules, data)
+- validateData(schema, data)
+- generateReport(data)
+```
+
+### API Integration Agent
+
+```markdown
+# API Integration Agent
+
+## Role
+Integrate with external APIs
+
+## Capabilities
+- HTTP requests (REST/GraphQL)
+- Authentication handling
+- Rate limiting
+- Error recovery
+
+## Tools
+- makeRequest(endpoint, options)
+- handleAuth(credentials)
+- retryWithBackoff(fn, options)
+```
+
+### Security Audit Agent
+
+```markdown
+# Security Audit Agent
+
+## Role
+Security analysis and vulnerability detection
+
+## Capabilities
+- Code security scanning
+- Dependency auditing
+- Configuration validation
+- Compliance checking
+
+## Tools
+- scanCode(files)
+- auditDependencies(packageJson)
+- validateConfig(config)
+- checkCompliance(standards)
+```
+
+---
+
+## Agent Lifecycle
+
+### 1. Initialization
+
+```javascript
+async function initializeAgent(config) {
+  // Load tools
+  const tools = await loadTools(config.tools);
+
+  // Setup memory
+  await setupMemory(config.name);
+
+  // Register with coordinator
+  await registerAgent(config);
+}
+```
+
+### 2. Task Execution
+
+```javascript
+async function executeTask(task) {
+  // Validate task
+  if (!validateTask(task)) {
+    return { success: false, error: 'Invalid task' };
+  }
+
+  // Execute with tools
+  const result = await runWithTools(task);
+
+  // Report confidence
+  return {
+    success: true,
+    result,
+    confidence: calculateConfidence(result)
+  };
+}
+```
+
+### 3. Cleanup
+
+```javascript
+async function cleanupAgent() {
+  // Save state
+  await saveState();
+
+  // Unregister
+  await unregisterAgent();
+
+  // Clear memory
+  await clearMemory();
+}
+```
+
+---
+
+## Best Practices
+
+1. **Clear Purpose**: Each agent should have one well-defined role
+2. **Self-Contained**: Include all necessary tools and dependencies
+3. **Confidence Reporting**: Always report confidence scores (0.0-1.0)
+4. **Error Handling**: Implement robust error recovery
+5. **Memory Management**: Use SQLite/Redis for persistence
+6. **Communication**: Use Redis pub/sub for coordination
+7. **Testing**: Create unit tests for custom tools
+
+---
+
+## Testing Custom Agents
+
+```bash
+# Test agent in isolation
+node tests/manual/test-custom-agent.js --agent my-custom-agent --task test-task.json
+
+# Test in swarm
+node tests/manual/test-swarm-direct.js "Test custom agent capabilities" --executor --agents my-custom-agent,coder
+```
+
+---
+
+## Example: Machine Learning Agent
+
+```markdown
+# ML Training Agent
+
+## Role
+Train and evaluate machine learning models
+
+## Capabilities
+- Data preprocessing
+- Model training
+- Hyperparameter tuning
+- Evaluation and metrics
+
+## Tools
+- preprocessData(data, config)
+- trainModel(data, params)
+- tuneHyperparameters(model, space)
+- evaluateModel(model, testData)
+
+## Output Format
+{
+  "model_id": "string",
+  "metrics": {
+    "accuracy": 0.95,
+    "f1_score": 0.93
+  },
+  "confidence": 0.88
+}
+```
+
+---
+
+For more information, see:
+- `.claude/agents/` directory for existing agents
+- Main CLAUDE.md in project root
+- `/swarm --help` for swarm orchestration

package/examples/templates/custom-agent/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "my-custom-agent-project",
+  "version": "1.0.0",
+  "description": "Claude Flow Novice custom agent development project",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "npx claude-flow-novice",
+    "create-agent": "node scripts/create-custom-agent.js",
+    "test-agent": "node test-custom-agent.js",
+    "swarm": "node tests/manual/test-swarm-direct.js",
+    "validate": "npx claude-flow-novice validate:agents"
+  },
+  "dependencies": {
+    "claude-flow-novice": "^1.6.6"
+  },
+  "keywords": [
+    "claude",
+    "custom-agents",
+    "ai-agents",
+    "tools",
+    "swarm"
+  ],
+  "author": "",
+  "license": "MIT"
+}

package/examples/templates/event-bus/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "my-event-bus-project",
+  "version": "1.0.0",
+  "description": "Claude Flow Novice event-driven system (10,000+ events/sec)",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "npx claude-flow-novice",
+    "eventbus:init": "npx claude-flow-novice eventbus init --throughput-target 10000",
+    "eventbus:publish": "npx claude-flow-novice eventbus publish",
+    "eventbus:subscribe": "npx claude-flow-novice eventbus subscribe",
+    "eventbus:monitor": "npx claude-flow-novice eventbus monitor",
+    "eventbus:metrics": "npx claude-flow-novice eventbus metrics",
+    "swarm": "node tests/manual/test-swarm-direct.js"
+  },
+  "dependencies": {
+    "claude-flow-novice": "^1.6.6"
+  },
+  "keywords": [
+    "claude",
+    "event-bus",
+    "event-driven",
+    "high-throughput",
+    "ai-agents"
+  ],
+  "author": "",
+  "license": "MIT"
+}

package/examples/templates/fleet-manager/CLAUDE.md

@@ -0,0 +1,134 @@
+# Claude Flow Novice — Fleet Manager Template
+
+---
+
+## Fleet Management Configuration
+
+This template is optimized for **enterprise-scale fleet management** with 1000+ agents.
+
+### Fleet Initialization
+
+```bash
+# Initialize fleet for large-scale operations
+/fleet init --max-agents 1500 --efficiency-target 0.40 --regions us-east-1,eu-west-1
+
+# Auto-scale with efficiency optimization
+/fleet scale --fleet-id fleet-123 --target-size 2000 --strategy predictive
+
+# Resource optimization
+/fleet optimize --fleet-id fleet-123 --efficiency-target 0.45
+```
+
+### Architecture
+
+- **Topology**: Hierarchical (coordinator mesh + worker trees)
+- **Scaling**: Predictive autoscaling with efficiency targets
+- **Regions**: Multi-region deployment with failover
+- **Monitoring**: Real-time dashboard with alerts
+
+### Performance Targets
+
+- Agent efficiency: ≥0.40
+- Response time: <100ms P95
+- Throughput: 10,000+ tasks/hour
+- Availability: 99.9%
+
+### Key Features
+
+1. **Autoscaling**: Automatic agent provisioning based on workload
+2. **Load Balancing**: Intelligent task distribution
+3. **Health Monitoring**: Continuous health checks with auto-recovery
+4. **Cost Optimization**: Resource efficiency tracking
+
+---
+
+## Swarm Configuration
+
+**Fleet-optimized swarm settings:**
+
+```bash
+executeSwarm({
+  swarmId: "fleet-production",
+  objective: "Production workload processing",
+  strategy: "development",
+  mode: "hierarchical",
+  maxAgents: 1500,
+  persistence: true,
+  autoscale: true,
+  efficiencyTarget: 0.40
+})
+```
+
+---
+
+## Usage Patterns
+
+### 1. Initialize Fleet
+
+```bash
+/fleet init --max-agents 1500 --regions us-east-1,eu-west-1
+```
+
+### 2. Deploy Swarm
+
+```bash
+node tests/manual/test-swarm-direct.js "Process customer data pipeline" --executor --max-agents 500
+```
+
+### 3. Monitor Performance
+
+```bash
+/fleet metrics --fleet-id fleet-123 --timeframe 24h --detailed
+/dashboard monitor --fleet-id fleet-123 --alerts
+```
+
+### 4. Optimize Resources
+
+```bash
+/fleet optimize --fleet-id fleet-123 --cost-optimization
+```
+
+---
+
+## Memory & Coordination
+
+Fleet operations use **Redis pub/sub** for coordination and **SQLite with ACL** for memory:
+
+```bash
+# Initialize SQLite memory with ACL
+/sqlite-memory init --database-path ./memory.db --acl-enabled
+
+# Store fleet data with appropriate ACL level
+/sqlite-memory store --key "fleet-metrics" --level system
+```
+
+---
+
+## Monitoring & Alerts
+
+Dashboard provides real-time insights:
+
+```bash
+# Fleet health monitoring
+/dashboard insights --fleet-id fleet-123 --timeframe 24h
+
+# Configure alerts
+/fleet health --fleet-id fleet-123 --deep-check
+```
+
+---
+
+## Best Practices
+
+1. **Start Small**: Begin with 100 agents, scale gradually
+2. **Monitor Efficiency**: Target ≥0.40 efficiency ratio
+3. **Use Regions**: Deploy to multiple regions for resilience
+4. **Enable Autoscaling**: Let system handle capacity automatically
+5. **Review Metrics**: Check dashboard daily for optimization opportunities
+
+---
+
+For more information, see:
+- `/fleet --help`
+- `/dashboard --help`
+- Main CLAUDE.md in project root

package/examples/templates/fleet-manager/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "my-fleet-manager-project",
+  "version": "1.0.0",
+  "description": "Claude Flow Novice fleet management project (1000+ agents)",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "npx claude-flow-novice",
+    "fleet:init": "npx claude-flow-novice fleet init --max-agents 1500",
+    "fleet:scale": "npx claude-flow-novice fleet scale",
+    "fleet:optimize": "npx claude-flow-novice fleet optimize",
+    "fleet:health": "npx claude-flow-novice fleet health",
+    "dashboard": "npx claude-flow-novice dashboard monitor",
+    "swarm": "node tests/manual/test-swarm-direct.js"
+  },
+  "dependencies": {
+    "claude-flow-novice": "^1.6.6"
+  },
+  "keywords": [
+    "claude",
+    "fleet-management",
+    "enterprise",
+    "autoscaling",
+    "ai-agents"
+  ],
+  "author": "",
+  "license": "MIT"
+}

package/package.json

@@ -1,22 +1,38 @@
 {
   "name": "claude-flow-novice",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "AI agent orchestration framework for beginners - coordinate multiple AI agents with swarm intelligence, real-time monitoring, and CFN Loop autonomous development",
   "mcpName": "io.github.ruvnet/claude-flow",
   "main": "./.claude-flow-novice/dist/src/index.js",
   "types": "./.claude-flow-novice/dist/index.d.ts",
+  "workspaces": [
+    "packages/*"
+  ],
+  "packageManager": "npm@10.9.2",
   "bin": {
-    "claude-flow-novice": "./.claude-flow-novice/dist/src/cli/main.js",
-    "claude-soul": "./.claude/commands/claude-soul.js",
-    "swarm": "./.claude/commands/swarm.js",
-    "sparc": "./.claude/commands/sparc.js",
-    "hooks": "./.claude/commands/hooks.js",
-    "memory-safety": "./config/hooks/pre-tool-memory-safety.js"
+    "claude-flow-novice": ".claude-flow-novice/dist/src/cli/main.js",
+    "claude-soul": ".claude/commands/claude-soul.js",
+    "swarm": ".claude/commands/swarm.js",
+    "sparc": ".claude/commands/sparc.js",
+    "hooks": ".claude/commands/hooks.js",
+    "memory-safety": "config/hooks/pre-tool-memory-safety.js"
   },
   "scripts": {
     "start": "node --max-old-space-size=16384 .claude-flow-novice/dist/src/cli/main.js",
     "dev": "tsx --max-old-space-size=16384 src/cli/main.ts",
+    "dev:portal": "npm run dev --workspace=web-portal",
+    "dev:components": "npm run dev --workspace=web-components",
+    "dev:all": "concurrently \"npm run dev:portal\" \"npm run dev:components\"",
     "build": "npm run clean && npm run build:swc && npm run build:fix-imports && npm run build:types:reliable",
+    "build:web": "turbo run build",
+    "build:portal": "npm run build --workspace=web-portal",
+    "build:components": "npm run build --workspace=web-components",
+    "test:web": "turbo run test",
+    "test:watch": "node scripts/test-runner.cjs --watch",
+    "lint:web": "turbo run lint",
+    "lint:fix:web": "turbo run lint:fix",
+    "type-check:web": "turbo run type-check",
+    "clean:web": "turbo run clean && rm -rf node_modules/.cache",
     "quick-install": "node scripts/install/quick-install.js --quick-start",
     "install:benchmark": "node scripts/install/installation-benchmark.js",
     "redis:setup": "node scripts/install/redis-setup.js",
@@ -26,6 +42,9 @@
     "redis:stop": "node scripts/install/redis-cli.js stop",
     "redis:restart": "node scripts/install/redis-cli.js restart",
     "redis:guide": "node scripts/install/redis-cli.js guide",
+    "agents:sync": "node scripts/sync-agents.js",
+    "agents:sync:dry-run": "node scripts/sync-agents.js --dry-run",
+    "agents:sync:verbose": "node scripts/sync-agents.js --verbose",
     "build:swc": "node --max-old-space-size=16384 node_modules/@swc/cli/bin/swc.js src -d .claude-flow-novice/dist --only='**/*.ts' --ignore='**/node_modules/**' --ignore='**/__tests__/**' --ignore='**/*.test.ts' --ignore='**/web/**' --config-file .swcrc && npm run copy:assets",
     "build:fix-imports": "node scripts/fix-js-extensions.js",
     "build:types": "node --max-old-space-size=16384 ./node_modules/.bin/tsc --project config/typescript/tsconfig.json --emitDeclarationOnly --outDir .claude-flow-novice/dist --skipLibCheck --isolatedModules",
@@ -42,20 +61,31 @@
     "ci:validate:quick": "node scripts/ci-validation.js --skip-tests",
     "prepublishOnly": "npm run build && npm run test:ci && npm run lint && npm run security:check && node scripts/pre-publish-validation.js",
     "postpublish": "npm run clean && npm run release:notify",
-    "test": "NODE_OPTIONS='--experimental-vm-modules --max-old-space-size=16384' jest --config=config/jest/jest.config.js --bail --maxWorkers=1 --forceExit",
-    "test:ci": "NODE_OPTIONS='--experimental-vm-modules --max-old-space-size=16384' jest --config=config/jest/jest.config.js --ci --coverage --maxWorkers=2",
-    "test:unit": "NODE_OPTIONS='--experimental-vm-modules --max-old-space-size=16384' jest --config=config/jest/jest.config.js --testPathPatterns=unit --bail",
-    "test:integration": "NODE_OPTIONS='--experimental-vm-modules --max-old-space-size=16384' jest --config=config/jest/jest.config.js --testPathPatterns=integration --bail",
-    "test:e2e": "NODE_OPTIONS='--experimental-vm-modules --max-old-space-size=16384' jest --config=config/jest/jest.config.js --testPathPatterns=e2e --bail",
+    "test": "node scripts/test-runner.cjs",
+    "test:quick": "node scripts/test-runner.cjs --quick",
+    "test:ci": "node scripts/test-runner.cjs --coverage",
+    "test:unit": "node scripts/test-runner.cjs --category=unit",
+    "test:integration": "node scripts/test-runner.cjs --category=integration",
+    "test:e2e": "node scripts/test-runner.cjs --category=e2e",
     "test:performance": "npm run test:performance:basic || echo 'No performance tests configured'",
     "test:coverage": "NODE_OPTIONS='--experimental-vm-modules' jest --config=config/jest/jest.config.js --coverage --coverageReporters=text-lcov | coveralls",
+    "test:cli": "node .claude-flow-novice/dist/src/cli/main.js --version && node .claude-flow-novice/dist/src/cli/main.js --help > /dev/null && echo '✅ CLI smoke test passed'",
+    "test:cli:full": "npm run build && npm run test:cli",
+    "test:chaos": "vitest run tests/chaos --timeout 20m",
+    "test:chaos:local": "vitest run tests/chaos --timeout 20m",
+    "test:chaos:ci": "vitest run tests/chaos --exclude '**/network-partition.test.ts' --timeout 20m",
+    "test:chaos:process-kill": "vitest run tests/chaos/random-process-kill.test.ts --timeout 15m",
+    "test:chaos:redis-restart": "vitest run tests/chaos/redis-restart.test.ts --timeout 15m",
+    "test:chaos:clock-skew": "vitest run tests/chaos/clock-skew.test.ts --timeout 15m",
+    "test:chaos:network": "vitest run tests/chaos/network-partition.test.ts --timeout 15m",
+    "test:chaos:stress": "vitest run tests/chaos/concurrent-stress.test.ts --timeout 25m",
     "lint": "eslint src --ext .ts --max-warnings 0 --config config/linting/.eslintrc.json",
     "format": "prettier --write 'src/**/*.{ts,js,json}' --config config/linting/.prettierrc.json",
     "lint:fix": "eslint src --ext .ts --fix --config config/linting/.eslintrc.json",
     "typecheck": "echo '⚠️ TypeScript checker has internal compiler bug - using SWC for compilation'",
     "mcp:start": "echo '❌ MCP removed in v2.0.0 - Use: claude-flow-novice start' && node .claude-flow-novice/dist/mcp/DEPRECATED.js",
     "mcp:status": "echo '❌ MCP removed in v2.0.0 - See: MCP_DEPRECATION_NOTICE.md'",
-    "postinstall": "node scripts/post-install-claude-md.js && node scripts/verify-installation.js",
+    "postinstall": "node scripts/auto-setup.js && node scripts/post-install-claude-md.js && node scripts/verify-installation.js",
     "version": "npm run build && npm run changelog:generate && git add .",
     "preversion": "npm run test:ci && npm run lint && npm run security:check",
     "postversion": "git push && git push --tags && npm run release:announce",
@@ -76,7 +106,7 @@
     "release:rollback": "node scripts/release-rollback.js",
     "security:check": "npm audit --audit-level moderate && node scripts/security-scan.js",
     "security:fix": "npm audit fix",
-    "security:audit": "npm audit --json > .claude-flow-novice/security-audit.json && cat .claude-flow-novice/security-audit.json",
+    "security:audit": "npm audit --json > reports/security/security-audit.json && cat reports/security/security-audit.json",
     "security:full-audit": "node scripts/security/security-audit.cjs --detailed",
     "security:validate-deployment": "node scripts/security/deployment-validation.cjs",
     "security:setup": "bash scripts/security/install-git-secrets.sh && bash scripts/security/setup-redis-auth.sh",
@@ -86,6 +116,8 @@
     "dependencies:check": "npm outdated || echo 'Dependencies are up to date'",
     "dependencies:update": "npm update && npm audit fix",
     "dependencies:optimize": "npm prune && npm dedupe",
+    "cleanup:blocking": "bash scripts/cleanup-blocking-coordination.sh",
+    "cleanup:blocking:dry-run": "bash scripts/cleanup-blocking-coordination.sh --dry-run",
     "release:validate": "node scripts/release-validation.js",
     "release:notes": "node scripts/generate-release-notes.js",
     "prepack": "npm run build"
@@ -129,7 +161,8 @@
   "files": [
     ".claude-flow-novice/",
     ".claude/",
-    "templates/",
+    ".claude/agents-ignore/",
+    "examples/templates/",
     "config/",
     "scripts/",
     "src/commands/",
@@ -158,7 +191,8 @@
     "V2.0.0_READY_FOR_PUBLICATION.md",
     "NPM_PACKAGE_CONTENTS.md",
     "AGENT_PERFORMANCE_GUIDELINES.md",
-    "MEMORY_LEAK_ROOT_CAUSE.md"
+    "MEMORY_LEAK_ROOT_CAUSE.md",
+    "AUTO_SETUP.md"
   ],
   "exports": {
     ".": "./.claude-flow-novice/dist/src/index.js",
@@ -209,7 +243,9 @@
     "msgpack5": "^6.0.2",
     "ora": "^9.0.0",
     "p-queue": "^7.4.0",
+    "prom-client": "^15.1.3",
     "redis": "^5.8.3",
+    "simple-git": "^3.28.0",
     "socket.io": "^4.8.1",
     "table": "^6.8.0",
     "uuid": "^13.0.0",
@@ -249,21 +285,27 @@
     "@types/ws": "^8.5.10",
     "@typescript-eslint/eslint-plugin": "^8.46.0",
     "@typescript-eslint/parser": "^8.46.0",
+    "@vitest/ui": "^3.2.4",
     "argon2": "^0.31.2",
     "babel-jest": "^30.2.0",
+    "concurrently": "^9.1.0",
     "eslint": "^9.37.0",
     "eslint-plugin-react": "^7.37.5",
-    "express": "^5.1.0",
+    "express": "^4.21.2",
     "jest": "^30.2.0",
+    "js-yaml": "^4.1.0",
     "jsdom": "^27.0.0",
     "node-fetch": "^3.3.2",
+    "npm-run-all2": "^7.0.2",
     "prettier": "^3.1.1",
     "qrcode": "^1.5.4",
     "socket.io-client": "^4.8.1",
     "speakeasy": "^2.0.0",
     "ts-jest": "^29.4.4",
     "tsx": "^4.20.6",
-    "typescript": "^5.9.3"
+    "turbo": "^2.3.3",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
   },
   "pkg": {
     "targets": [