@sparkleideas/agentic-flow 2.0.2-alpha-patch.1

package/agentic-flow/.claude/settings.json

@@ -0,0 +1,238 @@
+{
+  "env": {
+    "CLAUDE_FLOW_AUTO_COMMIT": "false",
+    "CLAUDE_FLOW_AUTO_PUSH": "false",
+    "CLAUDE_FLOW_HOOKS_ENABLED": "true",
+    "CLAUDE_FLOW_TELEMETRY_ENABLED": "true",
+    "CLAUDE_FLOW_REMOTE_EXECUTION": "true",
+    "CLAUDE_FLOW_CHECKPOINTS_ENABLED": "true",
+    "CLAUDE_FLOW_WORKERS_ENABLED": "true",
+    "CLAUDE_FLOW_WORKER_PARALLEL": "true",
+    "CLAUDE_FLOW_MODEL_CACHE_MB": "512",
+    "CLAUDE_FLOW_SUPPRESS_WARNINGS": "true"
+  },
+  "workers": {
+    "enabled": true,
+    "parallel": true,
+    "maxConcurrent": 10,
+    "maxPerTrigger": 3,
+    "defaultTimeout": 300000,
+    "memoryDepositEnabled": true,
+    "progressEventsEnabled": true,
+    "triggers": {
+      "ultralearn": { "priority": "high", "timeout": 300000, "maxAgents": 5 },
+      "optimize": { "priority": "medium", "timeout": 180000, "maxAgents": 2 },
+      "consolidate": { "priority": "low", "timeout": 120000, "maxAgents": 1 },
+      "predict": { "priority": "medium", "timeout": 60000, "maxAgents": 2 },
+      "audit": { "priority": "high", "timeout": 300000, "maxAgents": 3 },
+      "map": { "priority": "medium", "timeout": 240000, "maxAgents": 2 },
+      "preload": { "priority": "low", "timeout": 30000, "maxAgents": 1 },
+      "deepdive": { "priority": "high", "timeout": 600000, "maxAgents": 4 },
+      "document": { "priority": "low", "timeout": 180000, "maxAgents": 2 },
+      "refactor": { "priority": "medium", "timeout": 120000, "maxAgents": 2 },
+      "benchmark": { "priority": "medium", "timeout": 180000, "maxAgents": 2 },
+      "testgaps": { "priority": "medium", "timeout": 120000, "maxAgents": 2 }
+    },
+    "agentMappings": {
+      "ultralearn": ["researcher", "coder"],
+      "optimize": ["performance-analyzer", "coder"],
+      "audit": ["security-analyst", "tester"],
+      "benchmark": ["performance-analyzer"],
+      "testgaps": ["tester"],
+      "document": ["documenter", "researcher"],
+      "deepdive": ["researcher", "security-analyst"],
+      "refactor": ["coder", "reviewer"],
+      "map": ["researcher"],
+      "preload": ["researcher"],
+      "predict": ["performance-analyzer"],
+      "consolidate": ["researcher"]
+    }
+  },
+  "performance": {
+    "modelCache": {
+      "enabled": true,
+      "maxSizeMB": 512,
+      "evictionPolicy": "lru"
+    },
+    "benchmarkThresholds": {
+      "triggerDetection": { "p95Ms": 5 },
+      "workerRegistry": { "p95Ms": 10 },
+      "agentSelection": { "p95Ms": 1 },
+      "memoryKeyGeneration": { "p95Ms": 0.1 },
+      "concurrentWorkers": { "totalMs": 1000 }
+    },
+    "optimizations": {
+      "parallelDispatch": true,
+      "batchMemoryWrites": true,
+      "cacheEmbeddings": true,
+      "suppressWarnings": true
+    }
+  },
+  "agents": {
+    "presets": {
+      "quick-scan": {
+        "phases": ["file-discovery", "pattern-discovery", "summarization"],
+        "timeout": 60000,
+        "priority": "low"
+      },
+      "deep-analysis": {
+        "phases": ["file-discovery", "static-analysis", "complexity-analysis", "pattern-extraction", "summarization"],
+        "timeout": 300000,
+        "priority": "high"
+      },
+      "security-scan": {
+        "phases": ["file-discovery", "security-analysis", "secret-detection", "summarization"],
+        "timeout": 180000,
+        "priority": "critical"
+      },
+      "learning": {
+        "phases": ["file-discovery", "pattern-extraction", "vectorization", "sona-training", "pattern-storage"],
+        "timeout": 300000,
+        "priority": "medium"
+      },
+      "api-docs": {
+        "phases": ["api-discovery", "pattern-extraction", "report-generation", "indexing"],
+        "timeout": 180000,
+        "priority": "low"
+      },
+      "test-analysis": {
+        "phases": ["file-discovery", "pattern-discovery", "coverage-analysis", "summarization"],
+        "timeout": 120000,
+        "priority": "medium"
+      }
+    },
+    "capabilities": {
+      "default": {
+        "onnxEmbeddings": true,
+        "vectorDb": true,
+        "sonaLearning": true,
+        "reasoningBank": true,
+        "intelligenceStore": true,
+        "progressEvents": true,
+        "memoryDeposits": true,
+        "persistResults": true
+      }
+    }
+  },
+  "permissions": {
+    "allow": [
+      "Bash(npx @sparkleideas/claude-flow *)",
+      "Bash(npx @sparkleideas/agentic-flow *)",
+      "Bash(npm run lint)",
+      "Bash(npm run test:*)",
+      "Bash(npm test *)",
+      "Bash(npm run build)",
+      "Bash(npm run benchmark)",
+      "Bash(npm run workers *)",
+      "Bash(git status)",
+      "Bash(git diff *)",
+      "Bash(git log *)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Bash(git push)",
+      "Bash(git config *)",
+      "Bash(git tag *)",
+      "Bash(git branch *)",
+      "Bash(git checkout *)",
+      "Bash(git stash *)",
+      "Bash(jq *)",
+      "Bash(node *)",
+      "Bash(which *)",
+      "Bash(pwd)",
+      "Bash(ls *)",
+      "mcp__ruv-swarm",
+      "mcp__claude-flow@alpha",
+      "mcp__flow-nexus"
+    ],
+    "deny": [
+      "Bash(rm -rf /)",
+      "Bash(curl * | bash)",
+      "Bash(wget * | sh)",
+      "Bash(eval *)"
+    ]
+  },
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.user_prompt // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx @sparkleideas/claude-flow@alpha workers dispatch --prompt '{}' --parallel true 2>/dev/null || true"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx @sparkleideas/claude-flow@alpha hooks pre-command --command '{}' --validate-safety true --prepare-resources true 2>/dev/null || true"
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx @sparkleideas/claude-flow@alpha hooks pre-edit --file '{}' --auto-assign-agents true --load-context true 2>/dev/null || true"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx @sparkleideas/claude-flow@alpha hooks post-command --command '{}' --track-metrics true --store-results true 2>/dev/null || true"
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx @sparkleideas/claude-flow@alpha hooks post-edit --file '{}' --format true --update-memory true 2>/dev/null || true"
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "manual",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/bin/bash -c 'echo \"🔄 PreCompact: Check CLAUDE.md for 54 agents, swarm patterns, SPARC workflows\"; echo \"✅ Ready for compact\"'"
+          }
+        ]
+      },
+      {
+        "matcher": "auto",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/bin/bash -c 'echo \"🔄 Auto-Compact: Preserving agent/worker context\"; echo \"✅ Auto-compact proceeding\"'"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx @sparkleideas/claude-flow@alpha hooks session-end --generate-summary true --persist-state true --export-metrics true 2>/dev/null || true"
+          }
+        ]
+      }
+    ]
+  },
+  "includeCoAuthoredBy": true,
+  "enabledMcpjsonServers": ["@sparkleideas/claude-flow", "@sparkleideas/ruv-swarm"]
+}

package/agentic-flow/.claude/settings.local.json

@@ -0,0 +1,14 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__ruv-swarm",
+      "mcp__claude-flow",
+      "Write",
+      "Edit",
+      "Bash",
+      "Read"
+    ],
+    "deny": [],
+    "defaultMode": "bypassPermissions"
+  }
+}

package/agentic-flow/.claude/skills/agentic-flow-quickstart/skill.md

@@ -0,0 +1,69 @@
+---
+name: agentic-flow-quickstart
+description: Quick start guide for agentic-flow - initialize, configure, and run
+version: 1.0.0
+invocable: true
+author: agentic-flow
+capabilities:
+  - initialization
+  - configuration
+  - mcp_integration
+---
+
+# Agentic Flow Quickstart
+
+Initialize and configure agentic-flow for optimal Claude Code integration.
+
+## Quick Commands
+
+```bash
+# Initialize new project with agentic-flow
+npx agentic-flow@alpha init
+
+# Start MCP server for Claude Code
+npx agentic-flow@alpha mcp start
+
+# List available agents
+npx agentic-flow@alpha --list
+
+# Run a specific agent
+npx agentic-flow@alpha --agent coder --task "implement feature X"
+```
+
+## Features
+
+### 🤖 54+ Specialized Agents
+- Core: `coder`, `reviewer`, `tester`, `planner`, `researcher`
+- Swarm: `hierarchical-coordinator`, `mesh-coordinator`, `adaptive-coordinator`
+- GitHub: `pr-manager`, `code-review-swarm`, `issue-tracker`
+- SPARC: `specification`, `pseudocode`, `architecture`, `refinement`
+
+### 🧠 ReasoningBank Learning Memory
+- Pattern recognition with 84.8% SWE-Bench solve rate
+- 150x faster vector search with HNSW
+- Cross-session memory persistence
+
+### ⚡ SONA Micro-LoRA Optimization
+- 0.05ms inference latency
+- 32.3% token reduction
+- Real-time learning adaptation
+
+### 🔗 MCP Integration
+- 213+ MCP tools available
+- Swarm coordination via claude-flow
+- GitHub integration via ruv-swarm
+
+## Configuration
+
+Settings are stored in `.claude/settings.json`:
+- Hooks for pre/post operations
+- Agent definitions
+- MCP server configuration
+- Statusline customization
+
+## Next Steps
+
+1. Run `npx agentic-flow@alpha init` to set up project
+2. Start MCP server with `npx agentic-flow@alpha mcp start`
+3. Use Claude Code's Task tool to spawn agents
+4. Monitor via statusline and metrics

package/agentic-flow/.claude/skills/hooks-automation/skill.md

@@ -0,0 +1,155 @@
+---
+name: hooks-automation
+description: Configure Claude Code hooks for automated coordination and learning
+version: 1.0.0
+invocable: true
+author: agentic-flow
+capabilities:
+  - pre_edit_hooks
+  - post_edit_hooks
+  - session_management
+  - metrics_tracking
+---
+
+# Hooks Automation Skill
+
+Configure intelligent hooks for automated coordination, formatting, and learning.
+
+## Available Hooks
+
+### PreToolUse Hooks
+Triggered before Claude Code tools execute.
+
+```json
+{
+  "PreToolUse": [
+    {
+      "matcher": "Edit|Write|MultiEdit",
+      "hooks": [{
+        "type": "command",
+        "command": "npx agentic-flow@alpha hooks pre-edit \"$TOOL_INPUT_file_path\""
+      }]
+    },
+    {
+      "matcher": "Bash",
+      "hooks": [{
+        "type": "command",
+        "command": "npx agentic-flow@alpha hooks pre-command \"$TOOL_INPUT_command\""
+      }]
+    }
+  ]
+}
+```
+
+### PostToolUse Hooks
+Triggered after successful tool execution.
+
+```json
+{
+  "PostToolUse": [
+    {
+      "matcher": "Edit|Write|MultiEdit",
+      "hooks": [{
+        "type": "command",
+        "command": "npx agentic-flow@alpha hooks post-edit \"$TOOL_INPUT_file_path\" --success"
+      }]
+    }
+  ]
+}
+```
+
+### Session Hooks
+Triggered at session start/end.
+
+```json
+{
+  "SessionStart": [{
+    "hooks": [{
+      "type": "command",
+      "command": "npx agentic-flow@alpha hooks intelligence stats --json"
+    }]
+  }],
+  "SessionEnd": [{
+    "hooks": [{
+      "type": "command",
+      "command": "npx agentic-flow@alpha hooks metrics --session --json"
+    }]
+  }]
+}
+```
+
+## Hook Commands
+
+```bash
+# Pre-edit: Check for patterns, validate
+npx agentic-flow@alpha hooks pre-edit "src/api.ts"
+
+# Post-edit: Format, learn pattern
+npx agentic-flow@alpha hooks post-edit "src/api.ts" --success
+
+# Pre-command: Validate safety
+npx agentic-flow@alpha hooks pre-command "npm install"
+
+# Post-command: Track result
+npx agentic-flow@alpha hooks post-command "npm install"
+
+# Intelligence routing
+npx agentic-flow@alpha hooks route "implement OAuth"
+
+# Session metrics
+npx agentic-flow@alpha hooks metrics --session
+```
+
+## Automation Features
+
+### Auto-Agent Assignment
+Hooks automatically assign specialized agents based on file type:
+- `.ts`, `.tsx` → TypeScript agent
+- `.py` → Python agent
+- `.md` → Documentation agent
+- `test.*` → Testing agent
+
+### Command Validation
+Pre-command hooks validate for:
+- Dangerous patterns (rm -rf, force push)
+- Permission requirements
+- Resource limits
+
+### Pattern Learning
+Post-edit hooks learn:
+- Code patterns
+- Successful solutions
+- Error recovery strategies
+
+### Metrics Tracking
+Session hooks track:
+- Token usage
+- Tool invocations
+- Success rates
+- Performance metrics
+
+## Configuration
+
+Full hook configuration in `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [...],
+    "PostToolUse": [...],
+    "PostToolUseFailure": [...],
+    "SessionStart": [...],
+    "SessionEnd": [...],
+    "UserPromptSubmit": [...],
+    "Stop": [...]
+  }
+}
+```
+
+## Best Practices
+
+1. **Keep hooks fast**: <100ms for interactive experience
+2. **Use timeout**: Prevent hanging hooks
+3. **Handle failures gracefully**: Use `|| true` for optional hooks
+4. **Log metrics**: Track for optimization
+5. **Test hooks**: Verify before deployment

package/agentic-flow/.claude/skills/memory-patterns/skill.md

@@ -0,0 +1,110 @@
+---
+name: memory-patterns
+description: Persistent memory patterns for cross-session learning and context retention
+version: 1.0.0
+invocable: true
+author: agentic-flow
+capabilities:
+  - memory_store
+  - memory_retrieve
+  - pattern_learning
+  - context_management
+---
+
+# Memory Patterns Skill
+
+Implement persistent memory patterns for AI agents using ReasoningBank.
+
+## Quick Commands
+
+```bash
+# Store a pattern
+npx agentic-flow@alpha memory store "api:auth" "OAuth2 with JWT"
+
+# Retrieve a pattern
+npx agentic-flow@alpha memory get "api:auth"
+
+# Search patterns
+npx agentic-flow@alpha memory search "authentication"
+
+# List all patterns
+npx agentic-flow@alpha memory list --namespace project
+```
+
+## Memory Namespaces
+
+| Namespace | Purpose | TTL |
+|-----------|---------|-----|
+| `session` | Current session context | Until end |
+| `project` | Project-specific learnings | Permanent |
+| `user` | User preferences | Permanent |
+| `swarm` | Swarm coordination state | Swarm lifetime |
+| `cache` | Temporary cached data | 1 hour |
+
+## Pattern Types
+
+### Decision Patterns
+```bash
+# Store decision with context
+npx agentic-flow@alpha memory store \
+  "decisions:auth-method" \
+  '{"choice": "JWT", "reason": "stateless, scalable", "date": "2024-01-01"}'
+```
+
+### Code Patterns
+```bash
+# Store reusable code pattern
+npx agentic-flow@alpha memory store \
+  "patterns:error-handling" \
+  "try-catch with custom error classes and logging"
+```
+
+### Learning Patterns
+```bash
+# Store learning from successful task
+npx agentic-flow@alpha memory store \
+  "learnings:react-hooks" \
+  "useCallback for event handlers, useMemo for expensive computations"
+```
+
+## MCP Tools
+
+```javascript
+// Store memory
+mcp__claude-flow__memory_usage({
+  action: "store",
+  key: "project:architecture",
+  value: "microservices with event-driven communication",
+  namespace: "project"
+})
+
+// Retrieve memory
+mcp__claude-flow__memory_usage({
+  action: "retrieve",
+  key: "project:architecture",
+  namespace: "project"
+})
+
+// Search memories
+mcp__claude-flow__memory_search({
+  pattern: "auth*",
+  namespace: "project",
+  limit: 10
+})
+```
+
+## ReasoningBank Integration
+
+ReasoningBank provides:
+- **150x faster** vector search with HNSW
+- **Reflexion memory** for self-improvement
+- **Skill library** for learned capabilities
+- **Causal graphs** for decision tracking
+
+## Best Practices
+
+1. **Use namespaces**: Organize by scope
+2. **Be specific**: Clear, searchable keys
+3. **Include context**: Store decisions with reasoning
+4. **Clean up**: Delete stale patterns
+5. **Version patterns**: Track changes over time