agentic-flow 1.0.0

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

@@ -0,0 +1,116 @@
+---
+name: flow-nexus-payments
+description: Credit management, billing, and payment configuration
+---
+
+# Flow Nexus Payments
+
+Manage credits, configure billing, and track usage.
+
+## Check Balance
+```javascript
+mcp__flow-nexus__check_balance()
+```
+
+## Purchase Credits
+```javascript
+// Create payment link
+mcp__flow-nexus__create_payment_link({
+  amount: 50 // USD, minimum $10
+})
+// Returns secure payment URL to complete purchase
+```
+
+## Auto-Refill Configuration
+```javascript
+// Enable auto-refill
+mcp__flow-nexus__configure_auto_refill({
+  enabled: true,
+  threshold: 100,  // Refill when credits drop below 100
+  amount: 50       // Refill with $50 worth of credits
+})
+
+// Disable auto-refill
+mcp__flow-nexus__configure_auto_refill({
+  enabled: false
+})
+```
+
+## Payment History
+```javascript
+mcp__flow-nexus__get_payment_history({
+  limit: 50
+})
+```
+
+## rUv Credits Management
+```javascript
+// Check balance
+mcp__flow-nexus__ruv_balance({
+  user_id: "your_id"
+})
+
+// Transaction history
+mcp__flow-nexus__ruv_history({
+  user_id: "your_id",
+  limit: 100
+})
+```
+
+## Upgrade Tier
+```javascript
+mcp__flow-nexus__user_upgrade({
+  user_id: "your_id",
+  tier: "pro" // pro, enterprise
+})
+```
+
+## Usage Statistics
+```javascript
+mcp__flow-nexus__user_stats({
+  user_id: "your_id"
+})
+```
+
+## Credit Pricing
+- **Swarm Operations**: 1-10 credits/hour
+- **Sandbox Execution**: 0.5-5 credits/hour
+- **Neural Training**: 5-50 credits/job
+- **Workflow Runs**: 0.1-1 credit/execution
+- **Storage**: 0.01 credits/GB/day
+
+## Earning Credits
+1. **Complete Challenges**: 10-500 credits per challenge
+2. **Publish Templates**: Earn when others use
+3. **Referrals**: Bonus credits for invites
+4. **Daily Login**: Small daily bonus
+5. **Achievements**: Unlock milestone rewards
+
+## Tiers
+### Free Tier
+- 100 free credits monthly
+- Basic sandbox access
+- Limited swarm agents (3 max)
+- Community support
+
+### Pro Tier ($29/month)
+- 1000 credits monthly
+- Priority sandbox access
+- Unlimited agents
+- Advanced workflows
+- Email support
+
+### Enterprise Tier (Custom)
+- Unlimited credits
+- Dedicated resources
+- Custom models
+- SLA guarantee
+- Priority support
+
+## Cost Optimization Tips
+1. Use smaller sandboxes when possible
+2. Optimize neural network training parameters
+3. Batch workflow executions
+4. Clean up unused resources
+5. Monitor usage regularly
+6. Use templates to avoid redundant work

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

@@ -0,0 +1,83 @@
+---
+name: flow-nexus-sandbox
+description: E2B sandbox management for isolated code execution
+---
+
+# Flow Nexus Sandboxes
+
+Deploy and manage isolated execution environments.
+
+## Create Sandbox
+```javascript
+mcp__flow-nexus__sandbox_create({
+  template: "node", // node, python, react, nextjs, vanilla, base
+  name: "my-sandbox",
+  env_vars: {
+    API_KEY: "your_api_key",
+    NODE_ENV: "development"
+  },
+  timeout: 3600 // seconds
+})
+```
+
+## Execute Code
+```javascript
+mcp__flow-nexus__sandbox_execute({
+  sandbox_id: "sandbox_id",
+  code: `
+    console.log('Hello from sandbox!');
+    const result = await fetch('https://api.example.com');
+    return result.json();
+  `,
+  language: "javascript",
+  capture_output: true
+})
+```
+
+## Manage Sandboxes
+```javascript
+// List all sandboxes
+mcp__flow-nexus__sandbox_list({ status: "running" })
+
+// Get status
+mcp__flow-nexus__sandbox_status({ sandbox_id: "id" })
+
+// Upload file
+mcp__flow-nexus__sandbox_upload({
+  sandbox_id: "id",
+  file_path: "/app/data.json",
+  content: JSON.stringify(data)
+})
+
+// Stop sandbox
+mcp__flow-nexus__sandbox_stop({ sandbox_id: "id" })
+
+// Delete sandbox
+mcp__flow-nexus__sandbox_delete({ sandbox_id: "id" })
+```
+
+## Templates
+- **node**: Node.js environment
+- **python**: Python 3.x environment  
+- **react**: React development setup
+- **nextjs**: Next.js full-stack
+- **vanilla**: Basic HTML/CSS/JS
+- **base**: Minimal Linux environment
+
+## Common Patterns
+```javascript
+// API development sandbox
+mcp__flow-nexus__sandbox_create({
+  template: "node",
+  name: "api-dev",
+  install_packages: ["express", "cors", "dotenv"],
+  startup_script: "npm run dev"
+})
+
+// ML sandbox
+mcp__flow-nexus__sandbox_create({
+  template: "python",
+  name: "ml-training",
+  install_packages: ["numpy", "pandas", "scikit-learn"]
+})
+```

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)