claude-flow 3.28.0 → 3.30.0

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

@@ -1,87 +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" })
+---
+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

@@ -1,152 +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
+---
+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)