claude-flow 3.0.0-alpha.3 → 3.0.0-alpha.39

package/.claude/commands/flow-nexus/swarm.md

@@ -0,0 +1,87 @@
+---
+name: flow-nexus-swarm
+description: AI swarm deployment and coordination in cloud
+---
+
+# Flow Nexus Swarms
+
+Deploy and manage AI agent swarms in the cloud.
+
+## Initialize Swarm
+```javascript
+mcp__flow-nexus__swarm_init({
+  topology: "hierarchical", // mesh, ring, star, hierarchical
+  maxAgents: 8,
+  strategy: "balanced" // balanced, specialized, adaptive
+})
+```
+
+## Spawn Agents
+```javascript
+mcp__flow-nexus__agent_spawn({
+  type: "researcher", // coder, analyst, optimizer, coordinator
+  name: "Lead Researcher",
+  capabilities: ["web_search", "analysis", "summarization"]
+})
+```
+
+## Orchestrate Tasks
+```javascript
+mcp__flow-nexus__task_orchestrate({
+  task: "Build a REST API with authentication",
+  strategy: "parallel", // parallel, sequential, adaptive
+  maxAgents: 5,
+  priority: "high"
+})
+```
+
+## Monitor Swarm
+```javascript
+// Get swarm status
+mcp__flow-nexus__swarm_status()
+
+// List active swarms
+mcp__flow-nexus__swarm_list({ status: "active" })
+
+// Scale swarm
+mcp__flow-nexus__swarm_scale({ target_agents: 10 })
+
+// Destroy swarm
+mcp__flow-nexus__swarm_destroy({ swarm_id: "id" })
+```
+
+## Templates
+```javascript
+// Use pre-built swarm template
+mcp__flow-nexus__swarm_create_from_template({
+  template_name: "full-stack-dev",
+  overrides: {
+    maxAgents: 6,
+    strategy: "specialized"
+  }
+})
+
+// List available templates
+mcp__flow-nexus__swarm_templates_list({
+  category: "quickstart" // specialized, enterprise, custom
+})
+```
+
+## Common Swarm Patterns
+
+### Research Swarm
+```javascript
+mcp__flow-nexus__swarm_init({ topology: "mesh", maxAgents: 5 })
+mcp__flow-nexus__agent_spawn({ type: "researcher", name: "Lead" })
+mcp__flow-nexus__agent_spawn({ type: "analyst", name: "Data Analyst" })
+mcp__flow-nexus__task_orchestrate({ task: "Research ML trends" })
+```
+
+### Development Swarm
+```javascript
+mcp__flow-nexus__swarm_init({ topology: "hierarchical", maxAgents: 8 })
+mcp__flow-nexus__agent_spawn({ type: "coordinator", name: "PM" })
+mcp__flow-nexus__agent_spawn({ type: "coder", name: "Backend Dev" })
+mcp__flow-nexus__agent_spawn({ type: "coder", name: "Frontend Dev" })
+mcp__flow-nexus__task_orchestrate({ task: "Build e-commerce platform" })
+```

package/.claude/commands/flow-nexus/user-tools.md

@@ -0,0 +1,152 @@
+---
+name: flow-nexus-user-tools
+description: User management, storage, and system utilities
+---
+
+# Flow Nexus User Tools
+
+Utilities for user management, storage, and system operations.
+
+## Profile Management
+```javascript
+// Get profile
+mcp__flow-nexus__user_profile({
+  user_id: "your_id"
+})
+
+// Update profile
+mcp__flow-nexus__user_update_profile({
+  user_id: "your_id",
+  updates: {
+    full_name: "New Name",
+    bio: "Developer interested in AI",
+    github_username: "username"
+  }
+})
+
+// Get statistics
+mcp__flow-nexus__user_stats({
+  user_id: "your_id"
+})
+```
+
+## Storage Management
+```javascript
+// Upload file
+mcp__flow-nexus__storage_upload({
+  bucket: "my-bucket",
+  path: "data/file.json",
+  content: JSON.stringify(data),
+  content_type: "application/json"
+})
+
+// List files
+mcp__flow-nexus__storage_list({
+  bucket: "my-bucket",
+  path: "data/",
+  limit: 100
+})
+
+// Get public URL
+mcp__flow-nexus__storage_get_url({
+  bucket: "my-bucket",
+  path: "data/file.json",
+  expires_in: 3600 // seconds
+})
+
+// Delete file
+mcp__flow-nexus__storage_delete({
+  bucket: "my-bucket",
+  path: "data/file.json"
+})
+```
+
+## Real-time Subscriptions
+```javascript
+// Subscribe to database changes
+mcp__flow-nexus__realtime_subscribe({
+  table: "tasks",
+  event: "INSERT", // UPDATE, DELETE, *
+  filter: "status=eq.pending"
+})
+
+// List subscriptions
+mcp__flow-nexus__realtime_list()
+
+// Unsubscribe
+mcp__flow-nexus__realtime_unsubscribe({
+  subscription_id: "sub_id"
+})
+```
+
+## Execution Monitoring
+```javascript
+// Monitor execution stream
+mcp__flow-nexus__execution_stream_subscribe({
+  stream_type: "claude-flow-swarm",
+  deployment_id: "deployment_id"
+})
+
+// Get stream status
+mcp__flow-nexus__execution_stream_status({
+  stream_id: "stream_id"
+})
+
+// List generated files
+mcp__flow-nexus__execution_files_list({
+  stream_id: "stream_id",
+  created_by: "claude-flow",
+  file_type: "javascript"
+})
+
+// Get file content
+mcp__flow-nexus__execution_file_get({
+  file_id: "file_id"
+})
+```
+
+## System Health
+```javascript
+// Check system health
+mcp__flow-nexus__system_health()
+
+// View audit logs
+mcp__flow-nexus__audit_log({
+  user_id: "your_id",
+  limit: 100
+})
+```
+
+## Queen Seraphina Chat
+```javascript
+// Seek guidance from Queen Seraphina
+mcp__flow-nexus__seraphina_chat({
+  message: "How should I architect my distributed system?",
+  enable_tools: true, // Allow her to create swarms/deploy code
+  conversation_history: [
+    { role: "user", content: "Previous message" },
+    { role: "assistant", content: "Previous response" }
+  ]
+})
+```
+
+## Email Verification
+```javascript
+mcp__flow-nexus__user_verify_email({
+  token: "verification_token_from_email"
+})
+```
+
+## Storage Buckets
+- **public**: Publicly accessible files
+- **private**: User-only access
+- **shared**: Team collaboration
+- **temp**: Auto-deleted after 24h
+
+## Best Practices
+1. Use appropriate storage buckets
+2. Set expiration on temporary URLs
+3. Monitor real-time subscriptions
+4. Clean up unused subscriptions
+5. Regular audit log reviews
+6. Enable 2FA for security (coming soon)

package/.claude/commands/flow-nexus/workflow.md

@@ -0,0 +1,115 @@
+---
+name: flow-nexus-workflow
+description: Event-driven workflow automation with message queues
+---
+
+# Flow Nexus Workflows
+
+Create and manage automated workflows with event-driven processing.
+
+## Create Workflow
+```javascript
+mcp__flow-nexus__workflow_create({
+  name: "CI/CD Pipeline",
+  description: "Automated testing and deployment",
+  steps: [
+    { id: "test", action: "run_tests", agent: "tester" },
+    { id: "build", action: "build_app", agent: "builder" },
+    { id: "deploy", action: "deploy_prod", agent: "deployer" }
+  ],
+  triggers: ["push_to_main", "manual_trigger"]
+})
+```
+
+## Execute Workflow
+```javascript
+mcp__flow-nexus__workflow_execute({
+  workflow_id: "workflow_id",
+  input_data: {
+    branch: "main",
+    commit: "abc123"
+  },
+  async: true // Execute via message queue
+})
+```
+
+## Monitor Workflows
+```javascript
+// Get workflow status
+mcp__flow-nexus__workflow_status({
+  workflow_id: "id",
+  include_metrics: true
+})
+
+// List workflows
+mcp__flow-nexus__workflow_list({
+  status: "running",
+  limit: 10
+})
+
+// Get audit trail
+mcp__flow-nexus__workflow_audit_trail({
+  workflow_id: "id",
+  limit: 50
+})
+```
+
+## Agent Assignment
+```javascript
+mcp__flow-nexus__workflow_agent_assign({
+  task_id: "task_id",
+  agent_type: "coder",
+  use_vector_similarity: true // AI-powered matching
+})
+```
+
+## Queue Management
+```javascript
+mcp__flow-nexus__workflow_queue_status({
+  include_messages: true
+})
+```
+
+## Common Workflow Patterns
+
+### CI/CD Pipeline
+```javascript
+mcp__flow-nexus__workflow_create({
+  name: "Deploy Pipeline",
+  steps: [
+    { action: "lint", parallel: true },
+    { action: "test", parallel: true },
+    { action: "build", depends_on: ["lint", "test"] },
+    { action: "deploy", depends_on: ["build"] }
+  ],
+  triggers: ["github_push"]
+})
+```
+
+### Data Processing
+```javascript
+mcp__flow-nexus__workflow_create({
+  name: "ETL Pipeline",
+  steps: [
+    { action: "extract_data", agent: "data_extractor" },
+    { action: "transform_data", agent: "transformer" },
+    { action: "load_data", agent: "loader" },
+    { action: "validate", agent: "validator" }
+  ],
+  triggers: ["schedule:0 2 * * *"] // Daily at 2 AM
+})
+```
+
+### Multi-Stage Review
+```javascript
+mcp__flow-nexus__workflow_create({
+  name: "PR Review",
+  steps: [
+    { action: "code_analysis", agent: "analyzer" },
+    { action: "security_scan", agent: "security" },
+    { action: "performance_test", agent: "perf_tester" },
+    { action: "approve_merge", agent: "reviewer" }
+  ],
+  metadata: { priority: 10 }
+})
+```

package/.claude/commands/github/README.md

@@ -0,0 +1,11 @@
+# Github Commands
+
+Commands for github operations in Claude Flow.
+
+## Available Commands
+
+- [github-swarm](./github-swarm.md)
+- [repo-analyze](./repo-analyze.md)
+- [pr-enhance](./pr-enhance.md)
+- [issue-triage](./issue-triage.md)
+- [code-review](./code-review.md)