Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

feat(init): #2095 ADR-128 Phase 4 — delete 9 orphan command files (unreachable from COMMANDS_MAP)

ruv0740b2fa1d21
diff --git a/v3/@claude-flow/cli/.claude/commands/flow-nexus/app-store.md b/v3/@claude-flow/cli/.claude/commands/flow-nexus/app-store.md
deleted file mode 100644
index 2f4a4bd266..0000000000
--- a/v3/@claude-flow/cli/.claude/commands/flow-nexus/app-store.md
+++ /dev/null
@@ -1,124 +0,0 @@
----
-name: flow-nexus-app-store
-description: Browse, publish, and deploy applications
----
-
-# Flow Nexus App Store
-
-Browse templates, publish apps, and deploy solutions.
-
-## Browse Apps
-```javascript
-// Search apps
-mcp__flow-nexus__app_search({
- search: "authentication",
- category: "backend",
- featured: true,
- limit: 20
-})
-
-// Get app details
-mcp__flow-nexus__app_get({ app_id: "app_id" })
-
-// List templates
-mcp__flow-nexus__app_store_list_templates({
- category: "web-api",
- tags: ["express", "jwt"],
- limit: 20
-})
-```
-
-## Publish App
-```javascript
-mcp__flow-nexus__app_store_publish_app({
- name: "My Auth Service",
- description: "JWT-based authentication microservice",
- category: "backend",
- version: "1.0.0",
- source_code: sourceCode,
- tags: ["auth", "jwt", "express"],
- metadata: {
- author: "Your Name",
- license: "MIT",
- repository: "github.com/user/repo"
- }
-})
-```
-
-## Deploy Templates
-```javascript
-// Get template details
-mcp__flow-nexus__template_get({
- template_name: "express-api-starter"
-})
-
-// Deploy template
-mcp__flow-nexus__template_deploy({
- template_name: "express-api-starter",
- deployment_name: "my-api",
- variables: {
- api_key: "your_key",
- database_url: "postgres://..."
- },
- env_vars: {
- NODE_ENV: "production"
- }
-})
-```
-
-## Analytics
-```javascript
-// Get app analytics
-mcp__flow-nexus__app_analytics({
- app_id: "your_app_id",
- timeframe: "30d" // 24h, 7d, 30d, 90d
-})
-
-// View installed apps
-mcp__flow-nexus__app_installed({
- user_id: "your_id"
-})
-```
-
-## Update App
-```javascript
-mcp__flow-nexus__app_update({
- app_id: "app_id",
- updates: {
- version: "1.1.0",
- description: "Updated description",
- tags: ["new", "tags"]
- }
-})
-```
-
-## Market Data
-```javascript
-// Get market statistics
-mcp__flow-nexus__market_data()
-```
-
-## Template Categories
-- **web-api**: RESTful APIs and microservices
-- **frontend**: React, Vue, Angular apps
-- **full-stack**: Complete applications
-- **cli-tools**: Command-line utilities
-- **data-processing**: ETL and analytics
-- **ml-models**: Pre-trained models
-- **blockchain**: Web3 applications
-- **mobile**: React Native apps
-
-## Publishing Best Practices
-1. Include comprehensive documentation
-2. Add example usage and configuration
-3. Include tests and CI/CD setup
-4. Use semantic versioning
-5. Add clear license information
-6. Include docker/deployment configs
-7. Provide migration guides for updates
-
-## Revenue Sharing
-- Earn rUv credits when others use your templates
-- Set pricing (0 for free templates)
-- Track usage and earnings in analytics
-- Withdraw credits or use for Flow Nexus services
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/flow-nexus/challenges.md b/v3/@claude-flow/cli/.claude/commands/flow-nexus/challenges.md
deleted file mode 100644
index 91de413e5f..0000000000
--- a/v3/@claude-flow/cli/.claude/commands/flow-nexus/challenges.md
+++ /dev/null
@@ -1,120 +0,0 @@
----
-name: flow-nexus-challenges
-description: Coding challenges, achievements, and leaderboards
----
-
-# Flow Nexus Challenges
-
-Complete coding challenges to earn rUv credits and climb the leaderboard.
-
-## List Challenges
-```javascript
-mcp__flow-nexus__challenges_list({
- difficulty: "intermediate", // beginner, advanced, expert
- category: "algorithms",
- status: "active",
- limit: 20
-})
-```
-
-## Get Challenge Details
-```javascript
-mcp__flow-nexus__challenge_get({
- challenge_id: "two-sum-problem"
-})
-```
-
-## Submit Solution
-```javascript
-mcp__flow-nexus__challenge_submit({
- challenge_id: "challenge_id",
- user_id: "your_id",
- solution_code: `
- function solution(nums, target) {
- const map = new Map();
- for (let i = 0; i < nums.length; i++) {
- const complement = target - nums[i];
- if (map.has(complement)) {
- return [map.get(complement), i];
- }
- map.set(nums[i], i);
- }
- return [];
- }
- `,
- language: "javascript",
- execution_time: 45 // milliseconds
-})
-```
-
-## Complete Challenge
-```javascript
-mcp__flow-nexus__app_store_complete_challenge({
- challenge_id: "challenge_id",
- user_id: "your_id",
- submission_data: {
- passed_tests: 10,
- total_tests: 10,
- execution_time: 45
- }
-})
-```
-
-## Leaderboards
-```javascript
-// Global leaderboard
-mcp__flow-nexus__leaderboard_get({
- type: "global", // weekly, monthly, challenge
- limit: 10
-})
-
-// Challenge-specific leaderboard
-mcp__flow-nexus__leaderboard_get({
- type: "challenge",
- challenge_id: "specific_challenge",
- limit: 25
-})
-```
-
-## Achievements
-```javascript
-mcp__flow-nexus__achievements_list({
- user_id: "your_id",
- category: "speed_demon" // Categories vary
-})
-```
-
-## rUv Credits
-```javascript
-// Check balance
-mcp__flow-nexus__ruv_balance({ user_id: "your_id" })
-
-// View history
-mcp__flow-nexus__ruv_history({
- user_id: "your_id",
- limit: 20
-})
-
-// Earn credits (automatic on completion)
-mcp__flow-nexus__app_store_earn_ruv({
- user_id: "your_id",
- amount: 100,
- reason: "Completed expert challenge",
- source: "challenge"
-})
-```
-
-## Challenge Categories
-- **algorithms**: Classic algorithm problems
-- **data-structures**: DS implementation challenges
-- **system-design**: Architecture challenges
-- **optimization**: Performance challenges
-- **security**: Security-focused problems
-- **ml-basics**: Machine learning fundamentals
-
-## Tips
-1. Start with beginner challenges
-2. Review other solutions after completing
-3. Optimize for both correctness and speed
-4. Complete daily challenges for bonus credits
-5. Unlock achievements for extra rewards
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/flow-nexus/login-registration.md b/v3/@claude-flow/cli/.claude/commands/flow-nexus/login-registration.md
deleted file mode 100644
index 1b7828a821..0000000000
--- a/v3/@claude-flow/cli/.claude/commands/flow-nexus/login-registration.md
+++ /dev/null
@@ -1,65 +0,0 @@
----
-name: flow-nexus-auth
-description: Flow Nexus authentication and user management
----
-
-# Flow Nexus Authentication
-
-Quick commands for Flow Nexus login and registration.
-
-## Register New Account
-```javascript
-mcp__flow-nexus__user_register({
- email: "[email protected]",
- password: "secure_password",
- full_name: "Your Name" // optional
-})
-```
-
-## Login
-```javascript
-mcp__flow-nexus__user_login({
- email: "[email protected]",
- password: "your_password"
-})
-```
-
-## Check Auth Status
-```javascript
-mcp__flow-nexus__auth_status({ detailed: true })
-```
-
-## Logout
-```javascript
-mcp__flow-nexus__user_logout()
-```
-
-## Password Reset
-```javascript
-// Request reset
-mcp__flow-nexus__user_reset_password({ email: "[email protected]" })
-
-// Update with token
-mcp__flow-nexus__user_update_password({
- token: "reset_token",
- new_password: "new_secure_password"
-})
-```
-
-## 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" }
-})
-```
-
-## Quick Start
-1. Register with your email
-2. Check your email for verification
-3. Login to access all features
-4. Configure auto-refill for uninterrupted service
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/flow-nexus/neural-network.md b/v3/@claude-flow/cli/.claude/commands/flow-nexus/neural-network.md
deleted file mode 100644
index a759576c13..0000000000
--- a/v3/@claude-flow/cli/.claude/commands/flow-nexus/neural-network.md
+++ /dev/null
@@ -1,134 +0,0 @@
----
-name: flow-nexus-neural
-description: Train and deploy neural networks in distributed sandboxes
----
-
-# Flow Nexus Neural Networks
-
-Train custom neural networks with distributed computing.
-
-## Train Model
-```javascript
-mcp__flow-nexus__neural_train({
- config: {
- architecture: {
- type: "feedforward", // lstm, gan, autoencoder, transformer
- layers: [
- { type: "dense", units: 128, activation: "relu" },
- { type: "dropout", rate: 0.2 },
- { type: "dense", units: 10, activation: "softmax" }
- ]
- },
- training: {
- epochs: 100,
- batch_size: 32,
- learning_rate: 0.001,
- optimizer: "adam"
- }
- },
- tier: "small" // nano, mini, small, medium, large
-})
-```
-
-## Run Inference
-```javascript
-mcp__flow-nexus__neural_predict({
- model_id: "model_id",
- input: [[0.5, 0.3, 0.2], [0.1, 0.8, 0.1]],
- user_id: "your_id"
-})
-```
-
-## Use Templates
-```javascript
-// List templates
-mcp__flow-nexus__neural_list_templates({
- category: "classification", // regression, nlp, vision, anomaly
- tier: "free",
- limit: 20
-})
-
-// Deploy template
-mcp__flow-nexus__neural_deploy_template({
- template_id: "sentiment-analysis",
- custom_config: {
- training: { epochs: 50 }
- }
-})
-```
-
-## Distributed Training
-```javascript
-// Initialize cluster
-mcp__flow-nexus__neural_cluster_init({
- name: "training-cluster",
- architecture: "transformer",
- topology: "mesh",
- consensus: "proof-of-learning",
- wasmOptimization: true
-})
-
-// Deploy nodes
-mcp__flow-nexus__neural_node_deploy({
- cluster_id: "cluster_id",
- node_type: "worker", // parameter_server, aggregator
- model: "large",
- capabilities: ["training", "inference"]
-})
-
-// Start training
-mcp__flow-nexus__neural_train_distributed({
- cluster_id: "cluster_id",
- dataset: "mnist",
- epochs: 100,
- federated: true // Enable federated learning
-})
-```
-
-## Model Management
-```javascript
-// List your models
-mcp__flow-nexus__neural_list_models({
- user_id: "your_id",
- include_public: true
-})
-
-// Benchmark performance
-mcp__flow-nexus__neural_performance_benchmark({
- model_id: "model_id",
- benchmark_type: "comprehensive"
-})
-
-// Publish as template
-mcp__flow-nexus__neural_publish_template({
- model_id: "model_id",
- name: "My Custom Model",
- description: "Highly accurate classifier",
- category: "classification",
- price: 0 // Free template
-})
-```
-
-## Common Patterns
-
-### Image Classification
-```javascript
-mcp__flow-nexus__neural_train({
- config: {
- architecture: { type: "cnn" },
- training: { epochs: 50, batch_size: 64 }
- },
- tier: "medium"
-})
-```
-
-### Time Series Prediction
-```javascript
-mcp__flow-nexus__neural_train({
- config: {
- architecture: { type: "lstm" },
- training: { epochs: 100, learning_rate: 0.01 }
- },
- tier: "small"
-})
-```
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/flow-nexus/payments.md b/v3/@claude-flow/cli/.claude/commands/flow-nexus/payments.md
deleted file mode 100644
index e9a0a734d3..0000000000
--- a/v3/@claude-flow/cli/.claude/commands/flow-nexus/payments.md
+++ /dev/null
@@ -1,116 +0,0 @@
----
-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
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/flow-nexus/sandbox.md b/v3/@claude-flow/cli/.claude/commands/flow-nexus/sandbox.md
deleted file mode 100644
index 4fe2c8e0ca..0000000000
--- a/v3/@claude-flow/cli/.claude/commands/flow-nexus/sandbox.md
+++ /dev/null
@@ -1,83 +0,0 @@
----
-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"]
-})
-```
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/flow-nexus/swarm.md b/v3/@claude-flow/cli/.claude/commands/flow-nexus/swarm.md
deleted file mode 100644
index 0eb3bf1bce..0000000000
--- a/v3/@claude-flow/cli/.claude/commands/flow-nexus/swarm.md
+++ /dev/null
@@ -1,87 +0,0 @@
----
-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" })
-```
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/flow-nexus/user-tools.md b/v3/@claude-flow/cli/.claude/commands/flow-nexus/user-tools.md
deleted file mode 100644
index f6efe7abea..0000000000
--- a/v3/@claude-flow/cli/.claude/commands/flow-nexus/user-tools.md
+++ /dev/null
@@ -1,152 +0,0 @@
----
-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)
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/flow-nexus/workflow.md b/v3/@claude-flow/cli/.claude/commands/flow-nexus/workflow.md
deleted file mode 100644
index d9869ad46a..0000000000
--- a/v3/@claude-flow/cli/.claude/commands/flow-nexus/workflow.md
+++ /dev/null
@@ -1,115 +0,0 @@
----
-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 }
-})
-```
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/src/init/executor.ts b/v3/@claude-flow/cli/src/init/executor.ts
index 4c187112cb..99638907b2 100644
--- a/v3/@claude-flow/cli/src/init/executor.ts
+++ b/v3/@claude-flow/cli/src/init/executor.ts
@@ -81,6 +81,10 @@ const SKILLS_MAP: Record<string, string[]> = {
/**
* Commands to copy based on configuration
+ * ADR-128 Phase 4: every subdirectory under .claude/commands/ now has a
+ * corresponding key. The flow-nexus/ dir was deleted (belongs to the plugin).
+ * New substrate keys default true; opt-in keys (pair, training, stream-chain,
+ * truth, verify) default false per ADR-128 §Phase 3 opt-in rationale.
*/
const COMMANDS_MAP: Record<string, string[]> = {
core: ['claude-flow-help.md', 'claude-flow-swarm.md', 'claude-flow-memory.md'],
@@ -91,6 +95,19 @@ const COMMANDS_MAP: Record<string, string[]> = {
monitoring: ['monitoring'],
optimization: ['optimization'],
sparc: ['sparc'],
+ // ADR-128 Phase 4 promotions (previously orphaned)
+ agents: ['agents'],
+ coordination: ['coordination'],
+ hiveMind: ['hive-mind'],
+ memory: ['memory'],
+ swarm: ['swarm'],
+ workflows: ['workflows'],
+ // Opt-in categories (non-universal; default false in CommandsConfig)
+ pair: ['pair'],
+ training: ['training'],
+ streamChain: ['stream-chain'],
+ truth: ['truth'],
+ verify: ['verify'],
};
/**
@@ -959,6 +976,19 @@ async function copyCommands(
if (commandsConfig.monitoring) commandsToCopy.push(...COMMANDS_MAP.monitoring);
if (commandsConfig.optimization) commandsToCopy.push(...COMMANDS_MAP.optimization);
if (commandsConfig.sparc) commandsToCopy.push(...COMMANDS_MAP.sparc);
+ // ADR-128 Phase 4 substrate promotions
+ if (commandsConfig.agents) commandsToCopy.push(...(COMMANDS_MAP.agents || []));
+ if (commandsConfig.coordination) commandsToCopy.push(...(COMMANDS_MAP.coordination || []));
+ if (commandsConfig.hiveMind) commandsToCopy.push(...(COMMANDS_MAP.hiveMind || []));
+ if (commandsConfig.memory) commandsToCopy.push(...(COMMANDS_MAP.memory || []));
+ if (commandsConfig.swarm) commandsToCopy.push(...(COMMANDS_MAP.swarm || []));
+ if (commandsConfig.workflows) commandsToCopy.push(...(COMMANDS_MAP.workflows || []));
+ // ADR-128 Phase 4 opt-in categories
+ if (commandsConfig.pair) commandsToCopy.push(...(COMMANDS_MAP.pair || []));
+ if (commandsConfig.training) commandsToCopy.push(...(COMMANDS_MAP.training || []));
+ if (commandsConfig.streamChain) commandsToCopy.push(...(COMMANDS_MAP.streamChain || []));
+ if (commandsConfig.truth) commandsToCopy.push(...(COMMANDS_MAP.truth || []));
+ if (commandsConfig.verify) commandsToCopy.push(...(COMMANDS_MAP.verify || []));
}
// Find source commands directory
diff --git a/v3/@claude-flow/cli/src/init/types.ts b/v3/@claude-flow/cli/src/init/types.ts
index b2a981e734..46f8dbb6d6 100644
--- a/v3/@claude-flow/cli/src/init/types.ts
+++ b/v3/@claude-flow/cli/src/init/types.ts
@@ -88,6 +88,7 @@ export interface SkillsConfig {
/**
* Commands configuration
+ * ADR-128 Phase 4: new keys for promoted substrate dirs and opt-in categories.
*/
export interface CommandsConfig {
/** Include core commands */
@@ -106,6 +107,30 @@ export interface CommandsConfig {
optimization: boolean;
/** Include SPARC commands */
sparc: boolean;
+ // ADR-128 Phase 4 — substrate promotions (default true)
+ /** Include agents commands */
+ agents?: boolean;
+ /** Include coordination commands */
+ coordination?: boolean;
+ /** Include hive-mind commands */
+ hiveMind?: boolean;
+ /** Include memory commands */
+ memory?: boolean;
+ /** Include swarm commands */
+ swarm?: boolean;
+ /** Include workflows commands */
+ workflows?: boolean;
+ // ADR-128 Phase 4 — opt-in categories (default false)
+ /** Include pair programming commands (opt-in) */
+ pair?: boolean;
+ /** Include training commands (opt-in) */
+ training?: boolean;
+ /** Include stream-chain commands (opt-in) */
+ streamChain?: boolean;
+ /** Include truth commands (opt-in) */
+ truth?: boolean;
+ /** Include verify commands (opt-in) */
+ verify?: boolean;
/** Include all commands */
all: boolean;
}
@@ -375,6 +400,19 @@ export const DEFAULT_INIT_OPTIONS: InitOptions = {
monitoring: true,
optimization: true,
sparc: true,
+ // ADR-128 Phase 4 substrate promotions (default true — core swarm substrate)
+ agents: true,
+ coordination: true,
+ hiveMind: true,
+ memory: true,
+ swarm: true,
+ workflows: true,
+ // ADR-128 Phase 4 opt-in (default false — not universal)
+ pair: false,
+ training: false,
+ streamChain: false,
+ truth: false,
+ verify: false,
all: false,
},
agents: {