claude-flow-novice 2.18.12 → 2.18.14

package/.claude/settings.json

@@ -54,7 +54,38 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash -c 'FILE=$(cat | jq -r \".tool_input.file_path // .tool_input.path // empty\"); if echo \"$FILE\" | grep -qE \"package\\.json$|package-lock\\.json$|yarn\\.lock$|node_modules/|\\.git/|\\.log$|dist/|build/|\\.db$\"; then echo \"[Hook] Skipping protected file: $FILE\" >&2; exit 0; fi; echo \"[Hook] File edit validated\" >&2; exit 0'"
+            "command": "bash -c 'FILE=$(cat | jq -r \".tool_input.file_path // .tool_input.path // empty\"); [ -z \"$FILE\" ] && exit 0; if echo \"$FILE\" | grep -qE \"^\\.env$|\\.env\\.|^credentials\\.json$|^secrets\\.(json|yaml|yml)$|\\.pem$|\\.key$|/\\.aws/|id_rsa\"; then echo \"BLOCKED: Cannot edit sensitive file: $FILE. Use environment variables or secrets manager.\" >&2; exit 2; fi; exit 0'",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash -c 'INPUT=$(cat); FILE=$(echo \"$INPUT\" | jq -r \".tool_input.file_path // .tool_input.path // empty\"); CONTENT=$(echo \"$INPUT\" | jq -r \".tool_input.content // empty\"); [ -z \"$FILE\" ] && exit 0; if echo \"$FILE\" | grep -qE \"\\.json$\"; then if ! echo \"$CONTENT\" | jq . >/dev/null 2>&1; then echo \"BLOCKED: Invalid JSON syntax in $FILE. Please fix JSON before writing.\" >&2; exit 2; fi; fi; exit 0'",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash -c 'INPUT=$(cat); FILE=$(echo \"$INPUT\" | jq -r \".tool_input.file_path // .tool_input.path // empty\"); [ -z \"$FILE\" ] && exit 0; if echo \"$FILE\" | grep -qE \"package\\.json$|package-lock\\.json$|node_modules/|\\.git/|dist/|build/|\\.db$\"; then exit 0; fi; if [ -f \"$FILE\" ]; then \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/cfn-invoke-pre-edit.sh\" \"$FILE\" --agent-id \"${AGENT_ID:-hook}\" >/dev/null 2>&1 || true; fi; exit 0'",
+            "timeout": 30
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__cerebras-mcp__write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash -c 'INPUT=$(cat); FILE_PATH=$(echo \"$INPUT\" | jq -r \".tool_input.file_path // empty\"); PROMPT=$(echo \"$INPUT\" | jq -r \".tool_input.prompt // empty\" | head -c 300); [ -z \"$FILE_PATH\" ] || [ -z \"$PROMPT\" ] && exit 0; FILE_EXT=\"${FILE_PATH##*.}\"; PATTERNS=\"\"; if [ -f \"./.claude/skills/cfn-local-ruvector-accelerator/query-local.sh\" ]; then PATTERNS=$(./.claude/skills/cfn-local-ruvector-accelerator/query-local.sh --pattern \"$FILE_EXT ${PROMPT:0:100}\" --limit 2 2>/dev/null || echo \"\"); fi; if [ -n \"$PATTERNS\" ]; then echo \"{\\\"additionalContext\\\":\\\"RuVector found similar successful patterns: $PATTERNS\\\"}\"; fi; exit 0'",
+            "timeout": 8
           }
         ]
       }
@@ -65,7 +96,17 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash -c 'echo \"[Hook] Command completed\" >&2; exit 0'"
+            "command": "bash -c 'INPUT=$(cat); EXIT_CODE=$(echo \"$INPUT\" | jq -r \".tool_result.exit_code // 0\"); STDERR=$(echo \"$INPUT\" | jq -r \".tool_result.stderr // empty\"); if [ \"$EXIT_CODE\" != \"0\" ] && [ -n \"$STDERR\" ]; then if [ -f \"./.claude/skills/cfn-error-management/cli/capture-error.sh\" ]; then ./.claude/skills/cfn-error-management/cli/capture-error.sh --error-type BASH_EXECUTION --message \"${STDERR:0:500}\" --context \"bash-tool\" --agent-id \"${AGENT_ID:-hook}\" 2>&1 || true; fi; fi; echo \"[Hook] Command completed (exit: $EXIT_CODE)\" >&2; exit 0'"
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__cerebras-mcp__write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash -c 'INPUT=$(cat); FILE_PATH=$(echo \"$INPUT\" | jq -r \".tool_input.file_path // empty\"); PROMPT=$(echo \"$INPUT\" | jq -r \".tool_input.prompt // empty\" | head -c 500); RESULT=$(echo \"$INPUT\" | jq -r \".tool_result // empty\" | head -c 200); [ -z \"$FILE_PATH\" ] && exit 0; if echo \"$RESULT\" | grep -qiE \"success|written|created|generated\"; then if [ -f \"./.claude/skills/cfn-local-ruvector-accelerator/index-code.sh\" ]; then echo \"[Cerebras-Hook] Indexing successful generation: $FILE_PATH\" >&2; ./.claude/skills/cfn-local-ruvector-accelerator/index-code.sh --path \"$FILE_PATH\" --source cerebras --metadata \"{\\\"prompt\\\":\\\"${PROMPT:0:200}\\\",\\\"success\\\":true}\" 2>&1 || true; fi; fi; exit 0'",
+            "timeout": 10
           }
         ]
       },
@@ -74,7 +115,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash -c 'FILE=$(cat | jq -r \".tool_input.file_path // .tool_input.path // empty\"); if echo \"$FILE\" | grep -qE \"package\\.json$|package-lock\\.json$|yarn\\.lock$|node_modules/|\\.git/|\\.log$|dist/|build/|\\.db$\"; then echo \"[Hook] Skipping protected file: $FILE\" >&2; exit 0; fi; echo \"[Hook] File edit completed\" >&2; exit 0'"
+            "command": "bash -c 'INPUT=$(cat); FILE=$(echo \"$INPUT\" | jq -r \".tool_input.file_path // .tool_input.path // empty\"); [ -z \"$FILE\" ] || [ ! -f \"$FILE\" ] && exit 0; if echo \"$FILE\" | grep -qE \"package\\.json$|package-lock\\.json$|node_modules/|\\.git/|dist/|build/\"; then exit 0; fi; cd \"${CLAUDE_PROJECT_DIR:-.}\"; node config/hooks/post-edit-pipeline.js \"$FILE\" --agent-id \"${AGENT_ID:-hook}\" 2>&1 | tail -20 || true; exit 0'",
+            "timeout": 45
           }
         ]
       }
@@ -85,7 +127,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "/bin/bash -c 'export PATH=\"$HOME/bin:$PATH\"; INPUT=$(cat); CUSTOM=$(echo \"$INPUT\" | jq -r \".custom_instructions // \\\"\\\"\"); echo \"🔄 PreCompact Guidance:\"; echo \"📋 IMPORTANT: Review CLAUDE.md in project root for:\"; echo \"   • 54 available agents and concurrent usage patterns\"; echo \"   • Swarm coordination strategies (hierarchical, mesh, adaptive)\"; echo \"   • SPARC methodology workflows with batchtools optimization\"; echo \"   • Critical concurrent execution rules (GOLDEN RULE: 1 MESSAGE = ALL OPERATIONS)\"; if [ -n \"$CUSTOM\" ]; then echo \"🎯 Custom compact instructions: $CUSTOM\"; fi; echo \"\"; echo \"✅ Ready for compact operation\"'"
+            "command": "/bin/bash .claude/hooks/cfn-precompact-enhanced.sh"
           }
         ]
       },
@@ -94,7 +136,18 @@
         "hooks": [
           {
             "type": "command",
-            "command": "/bin/bash -c 'echo \"🔄 Auto-Compact Guidance (Context Window Full):\"; echo \"📋 CRITICAL: Before compacting, ensure you understand:\"; echo \"   The claude.md file of the directory you are working in\"; echo \"   • Concurrent execution patterns from CLAUDE.md\"; echo \"   • the CFN loop \"; echo \"   • Swarm coordination strategies for complex tasks\"; echo \"⚡ Apply GOLDEN RULE: Always batch operations in single messages\"; echo \"\"; echo \"📊 Recent Metrics Summary (Last 60 min):\"; timeout 30s node src/slash-commands/metrics-summary.js --minutes=60 2>/dev/null || echo \"   Metrics unavailable\"; echo \"✅ Auto-compact proceeding with full agent context\"'"
+            "command": "/bin/bash .claude/hooks/cfn-precompact-enhanced.sh"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash -c 'echo \"[SessionStart] Initializing session context...\" >&2; if [ -f \"./.claude/hooks/cfn-load-cerebras-env.sh\" ]; then RESULT=$(./.claude/hooks/cfn-load-cerebras-env.sh 2>&1); if echo \"$RESULT\" | jq . >/dev/null 2>&1; then echo \"$RESULT\"; else echo \"$RESULT\" >&2; fi; fi; if [ -f \"./.claude/skills/cfn-memory-persistence/lib/auto/auto-load-session-context.sh\" ]; then ./.claude/skills/cfn-memory-persistence/lib/auto/auto-load-session-context.sh --session-id \"${SESSION_ID:-$(date +%s)}\" 2>&1 || true; fi; if [ -f \"./.claude/skills/cfn-transparency-middleware/invoke-transparency-init.sh\" ]; then ./.claude/skills/cfn-transparency-middleware/invoke-transparency-init.sh --task-id \"${SESSION_ID:-session}\" --level standard 2>&1 || true; fi; echo \"[SessionStart] Context loaded\" >&2; exit 0'",
+            "timeout": 15
           }
         ]
       }
@@ -104,7 +157,19 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash -c 'echo \"[Hook] Session ending\" >&2; exit 0'"
+            "command": "bash -c 'echo \"[SessionEnd] Persisting session state...\" >&2; if [ -f \"./.claude/skills/cfn-memory-persistence/lib/auto/save-session-context.sh\" ]; then ./.claude/skills/cfn-memory-persistence/lib/auto/save-session-context.sh --session-id \"${SESSION_ID:-$(date +%s)}\" 2>&1 || true; fi; if [ -f \"./.claude/skills/cfn-knowledge-base/cli/knowledge-base.sh\" ]; then ./.claude/skills/cfn-knowledge-base/cli/knowledge-base.sh store-learning --type session-end --category completed --confidence 0.85 2>&1 || true; fi; echo \"[SessionEnd] Session ended\" >&2; exit 0'",
+            "timeout": 15
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash -c 'INPUT=$(cat); TRANSCRIPT=$(echo \"$INPUT\" | jq -r \".transcript_path // empty\"); AGENT_ID=$(echo \"$INPUT\" | jq -r \".agent_id // empty\"); if [ -f \"./.claude/skills/cfn-agent-lifecycle/cli/lifecycle-hook.sh\" ] && [ -n \"$AGENT_ID\" ]; then ./.claude/skills/cfn-agent-lifecycle/cli/lifecycle-hook.sh complete --agent-id \"$AGENT_ID\" --status completed --confidence 0.92 2>&1 || true; fi; [ -z \"$TRANSCRIPT\" ] || [ ! -f \"$TRANSCRIPT\" ] && exit 0; LINES=$(wc -l < \"$TRANSCRIPT\" 2>/dev/null || echo 0); if [ \"$LINES\" -lt 5 ]; then if ! grep -qiE \"complete|finished|done|summary|deliverable|implemented|created|fixed\" \"$TRANSCRIPT\" 2>/dev/null; then echo \"{\\\"decision\\\":\\\"block\\\",\\\"reason\\\":\\\"Output appears incomplete ($LINES lines, no completion signals). Please provide a summary of work done and deliverables.\\\"}\"; fi; fi; exit 0'",
+            "timeout": 15
           }
         ]
       }

package/.claude/skills/cfn-agent-lifecycle/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-agent-lifecycle
-description: Unified agent management from selection through completion - spawning, execution, output processing
+description: "Unified agent management from selection through completion - spawning, execution, output processing. Use when selecting agents for tasks, spawning agents with dependency validation, processing agent outputs, or tracking agent lifecycle events with audit trails."
 version: 2.0.0
 tags: [mega-skill, agent-management, lifecycle, spawning]
 status: production

package/.claude/skills/cfn-agent-tooling/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-agent-tooling
-description: Agent development tools - generation and validation
+description: "Agent development tools - generation and validation. Use when creating new agent templates from scaffolding, or validating and linting existing agent profiles for correctness and completeness."
 version: 1.0.0
 tags: [mega-skill, agents, templates, validation, development]
 status: production

package/.claude/skills/cfn-cerebras-coordinator/QUICKSTART.md

@@ -0,0 +1,348 @@
+# TDD Conversation Coordinator - Quick Start
+
+Get started with iterative TDD in under 5 minutes.
+
+## Prerequisites
+
+```bash
+# 1. Check dependencies
+which curl jq || sudo apt install curl jq
+
+# 2. Set API key
+export ZAI_API_KEY="your-cerebras-api-key"
+
+# 3. Verify coordinator exists
+ls -lh ./.claude/skills/cfn-cerebras-coordinator/tdd-conversation-coordinator.sh
+```
+
+## Your First TDD Cycle (2 minutes)
+
+### Example 1: Simple Validator
+
+```bash
+# Navigate to project root
+cd /path/to/project
+
+# Run TDD coordinator
+./.claude/skills/cfn-cerebras-coordinator/tdd-conversation-coordinator.sh \
+  --agent-id my-first-tdd \
+  --feature "Email validator that accepts RFC-compliant addresses" \
+  --file ./src/validators/email-validator.ts \
+  --test-command "npm test email-validator.test.ts" \
+  --max-iterations 3 \
+  --verbose
+```
+
+**What happens**:
+1. Generates comprehensive tests (RED phase)
+2. Verifies tests fail (no implementation yet)
+3. Generates implementation (GREEN phase)
+4. Runs tests - if fail, enters fix loop
+5. Saves conversation to `conversations/` directory
+6. Indexes pattern to RuVector
+
+**Expected output**:
+```
+================================================
+   TDD Conversation Coordinator
+================================================
+Feature:        Email validator that accepts RFC-compliant addresses
+Target File:    ./src/validators/email-validator.ts
+Agent ID:       my-first-tdd
+Max Iterations: 3
+================================================
+
+[2025-12-10 10:30:05] Phase 1: Gathering context
+[2025-12-10 10:30:07] Phase 2 (RED): Generating failing tests
+[2025-12-10 10:30:15] Tests written to: ./src/validators/email-validator.test.ts
+[2025-12-10 10:30:16] Phase 3 (RED): Verifying tests fail as expected
+[2025-12-10 10:30:17] Tests failed as expected - Red Phase validated
+[2025-12-10 10:30:18] Phase 4 (GREEN): Generating implementation
+[2025-12-10 10:30:28] Implementation written to: ./src/validators/email-validator.ts
+
+--- Iteration 1/3 ---
+[2025-12-10 10:30:30] Phase 5 (GREEN): Running tests to verify implementation
+[2025-12-10 10:30:32] All tests pass - Green Phase complete
+
+================================================
+   SUCCESS! All tests pass.
+================================================
+
+Summary:
+  Feature:        Email validator that accepts RFC-compliant addresses
+  Implementation: ./src/validators/email-validator.ts
+  Tests:          ./src/validators/email-validator.test.ts
+  Iterations:     1
+  Conversation:   Saved for learning
+```
+
+## Check Your Results
+
+```bash
+# View generated test file
+cat ./src/validators/email-validator.test.ts
+
+# View generated implementation
+cat ./src/validators/email-validator.ts
+
+# Run tests manually
+npm test email-validator.test.ts
+
+# Review conversation history
+cat ./.claude/skills/cfn-cerebras-coordinator/conversations/*.json | jq .
+```
+
+## Common Use Cases
+
+### Use Case 1: Validator Function
+```bash
+./.claude/skills/cfn-cerebras-coordinator/tdd-conversation-coordinator.sh \
+  --agent-id validator-001 \
+  --feature "URL validator with protocol, domain, and path checking" \
+  --file ./src/validators/url.ts \
+  --test-command "npm test url.test.ts" \
+  --max-iterations 3
+```
+
+### Use Case 2: Data Transformer
+```bash
+./.claude/skills/cfn-cerebras-coordinator/tdd-conversation-coordinator.sh \
+  --agent-id transformer-001 \
+  --feature "JSON to CSV transformer with nested object flattening" \
+  --file ./src/transformers/json-to-csv.ts \
+  --test-command "npm test json-to-csv.test.ts" \
+  --context "./src/types.ts" \
+  --max-iterations 5
+```
+
+### Use Case 3: API Handler
+```bash
+./.claude/skills/cfn-cerebras-coordinator/tdd-conversation-coordinator.sh \
+  --agent-id api-001 \
+  --feature "REST API handler for user registration with validation" \
+  --file ./src/handlers/register.ts \
+  --test-command "npm test register.test.ts" \
+  --context "./src/types.ts,./src/middleware/validation.ts" \
+  --max-iterations 5 \
+  --verbose
+```
+
+## Interactive Mode
+
+Run example wizard for guided setup:
+
+```bash
+./.claude/skills/cfn-cerebras-coordinator/example-usage.sh
+```
+
+**Menu options**:
+1. Simple TypeScript function
+2. Python data validator
+3. Go HTTP middleware
+4. Complex authentication flow
+5. Custom example (interactive prompts)
+
+## Understanding Iterations
+
+### Iteration 1: Initial Implementation
+- Cerebras generates code from feature description
+- Usually handles happy path
+- May miss edge cases
+
+### Iteration 2: Error Recovery
+- Tests fail with specific error
+- Cerebras reviews full conversation history
+- Analyzes what went wrong
+- Generates fix addressing specific failure
+
+### Iteration 3+: Refinement
+- Handles remaining edge cases
+- Fixes subtle bugs
+- Improves error handling
+- Each iteration has full context of previous attempts
+
+## Troubleshooting
+
+### Problem: Tests don't fail in Red phase
+**Solution**: Remove existing implementation file first
+```bash
+rm ./src/validators/email-validator.ts
+# Then run coordinator
+```
+
+### Problem: API error (HTTP 401)
+**Solution**: Check API key
+```bash
+echo $ZAI_API_KEY  # Should show your key
+export ZAI_API_KEY="your-key-here"
+```
+
+### Problem: Tests still failing after max iterations
+**Solution 1**: Increase iterations
+```bash
+--max-iterations 7
+```
+
+**Solution 2**: Add more context
+```bash
+--context "./src/types.ts,./src/utils/*.ts"
+```
+
+**Solution 3**: Simplify feature scope
+```bash
+# Instead of: "Complete authentication system"
+# Try: "Password hash comparison function"
+```
+
+### Problem: Test command not found
+**Solution**: Install test framework
+```bash
+# For npm/jest
+npm install --save-dev jest @types/jest
+
+# For Python/pytest
+pip install pytest
+
+# For Go
+# Built-in, no install needed
+```
+
+## Next Steps
+
+### 1. Review Documentation
+```bash
+# Complete usage guide
+cat ./.claude/skills/cfn-cerebras-coordinator/README.md
+
+# Coordinator comparison
+cat ./.claude/skills/cfn-cerebras-coordinator/TDD_COORDINATOR_OVERVIEW.md
+```
+
+### 2. Run Test Suite
+```bash
+./.claude/skills/cfn-cerebras-coordinator/test-tdd-coordinator.sh
+```
+
+### 3. Learn from Conversations
+```bash
+# Find successful patterns
+find ./.claude/skills/cfn-cerebras-coordinator/conversations/ \
+  -name "*.json" \
+  -exec jq '.metadata | {feature, iterations}' {} \;
+
+# Review a specific conversation
+jq . conversations/20251210-*.json
+```
+
+### 4. Integrate with CFN Agents
+```javascript
+// From an agent
+Task("backend-dev", `
+  Implement feature using TDD coordinator:
+
+  ./.claude/skills/cfn-cerebras-coordinator/tdd-conversation-coordinator.sh \\
+    --agent-id backend-tdd-001 \\
+    --feature "Rate limiter with token bucket algorithm" \\
+    --file ./src/middleware/rate-limiter.ts \\
+    --test-command "npm test rate-limiter.test.ts" \\
+    --context "./src/types.ts" \\
+    --max-iterations 5
+
+  Report results and confidence.
+`)
+```
+
+## Cost Estimation
+
+| Complexity | Iterations | Duration | Cost |
+|------------|-----------|----------|------|
+| Simple validator | 1-2 | 30-60s | $0.02-0.05 |
+| Medium algorithm | 2-3 | 60-120s | $0.05-0.10 |
+| Complex feature | 3-5 | 120-300s | $0.10-0.25 |
+
+**Cost factors**:
+- Context file size
+- Feature complexity
+- Number of iterations
+- Test suite size
+
+## Best Practices
+
+### 1. Write Clear Feature Descriptions
+```bash
+# Good - specific and testable
+--feature "JWT validator that verifies signature, checks expiration, validates issuer"
+
+# Less helpful - too vague
+--feature "JWT stuff"
+```
+
+### 2. Provide Relevant Context
+```bash
+# Good - includes types and related utilities
+--context "./src/types.ts,./src/utils/crypto.ts"
+
+# Less helpful - too much unrelated code
+--context "./src/**/*.ts"
+```
+
+### 3. Start with Lower Iterations
+```bash
+# Try 3 iterations first
+--max-iterations 3
+
+# Increase only if needed
+--max-iterations 5
+```
+
+### 4. Use Verbose Mode for Learning
+```bash
+# See detailed logs
+--verbose
+
+# Understand what's happening at each phase
+```
+
+### 5. Save Successful Patterns
+```bash
+# Conversations automatically saved to:
+./.claude/skills/cfn-cerebras-coordinator/conversations/
+
+# Review and learn from them
+```
+
+## Getting Help
+
+1. **Check README**: `cat README.md`
+2. **Run tests**: `./test-tdd-coordinator.sh`
+3. **Enable verbose**: `--verbose` flag
+4. **Review conversations**: `cat conversations/*.json | jq .`
+5. **Simplify feature**: Break into smaller pieces
+
+## Summary
+
+**You've learned**:
+- How to run a TDD cycle with conversation memory
+- How iterations and error recovery work
+- Common use cases and examples
+- Troubleshooting techniques
+- Cost estimation
+
+**Next actions**:
+1. Try a simple feature first
+2. Review generated code and tests
+3. Experiment with context files
+4. Monitor conversation logs
+5. Integrate into your workflow
+
+**Key command**:
+```bash
+./.claude/skills/cfn-cerebras-coordinator/tdd-conversation-coordinator.sh \
+  --agent-id YOUR_ID \
+  --feature "YOUR_FEATURE" \
+  --file YOUR_FILE \
+  --test-command "YOUR_TEST_CMD" \
+  --max-iterations 3
+```
+
+Happy TDD! 🧪