claude-flow 3.7.0-alpha.4 → 3.7.0-alpha.41

package/.claude/worktrees/adr-120-impl/v3/@claude-flow/cli/src/commands/ruvector/setup.ts

@@ -0,0 +1,783 @@
+/**
+ * V3 CLI RuVector Setup Command
+ * Outputs Docker files and SQL for easy RuVector PostgreSQL setup
+ *
+ * Usage:
+ *   npx claude-flow ruvector setup              # Output to ./ruvector-postgres/
+ *   npx claude-flow ruvector setup --output /path/to/dir
+ *   npx claude-flow ruvector setup --print      # Print to stdout only
+ *
+ * Created with care by ruv.io
+ */
+
+import type { Command, CommandContext, CommandResult } from '../../types.js';
+import { output } from '../../output.js';
+import * as fs from 'fs';
+import * as path from 'path';
+
+/**
+ * Docker Compose template for RuVector PostgreSQL
+ */
+const DOCKER_COMPOSE_TEMPLATE = `# RuVector PostgreSQL Testing Environment
+# Official RuVector extension from ruvnet/ruvector-postgres
+#
+# Features:
+# - 77+ SQL functions for vector operations
+# - HNSW/IVFFlat indexing with SIMD acceleration
+# - Hyperbolic embeddings (Poincaré ball)
+# - Graph operations and GNN support
+# - Agent routing and learning
+#
+# Performance: ~61µs latency, 16,400 QPS with HNSW
+
+services:
+  postgres:
+    image: ruvnet/ruvector-postgres:latest
+    container_name: ruvector-postgres
+    environment:
+      POSTGRES_USER: claude
+      POSTGRES_PASSWORD: claude-flow-test
+      POSTGRES_DB: claude_flow
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+      - ./scripts/init-db.sql:/docker-entrypoint-initdb.d/01-init.sql
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U claude -d claude_flow"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+    command: >
+      postgres
+      -c work_mem=256MB
+      -c maintenance_work_mem=512MB
+
+  # Optional: pgAdmin for visual database management
+  pgadmin:
+    image: dpage/pgadmin4:latest
+    container_name: ruvector-pgadmin
+    environment:
+      PGADMIN_DEFAULT_EMAIL: admin@claude-flow.local
+      PGADMIN_DEFAULT_PASSWORD: admin
+      PGADMIN_CONFIG_SERVER_MODE: 'False'
+    ports:
+      - "5050:80"
+    depends_on:
+      postgres:
+        condition: service_healthy
+    profiles:
+      - gui
+
+volumes:
+  postgres_data:
+`;
+
+/**
+ * Init SQL template for RuVector PostgreSQL
+ */
+const INIT_SQL_TEMPLATE = `-- ============================================
+-- RUVECTOR POSTGRESQL INITIALIZATION SCRIPT
+-- ============================================
+--
+-- This script initializes RuVector PostgreSQL extension
+-- from ruvnet/ruvector-postgres with Claude-Flow V3 integration.
+--
+-- RuVector provides 77+ SQL functions including:
+-- - Vector similarity search (HNSW with SIMD)
+-- - Hyperbolic embeddings (Poincaré/Lorentz)
+-- - Graph operations (Cypher queries)
+-- - Agent routing and learning
+--
+-- Performance: ~61µs latency, 16,400 QPS
+
+-- ============================================
+-- PART 1: EXTENSION AND SCHEMA SETUP
+-- ============================================
+
+-- IMPORTANT: RuVector requires explicit VERSION
+-- The control file says 2.0.0 but only 0.1.0 SQL exists
+CREATE EXTENSION IF NOT EXISTS ruvector VERSION '0.1.0';
+
+-- Enable additional required extensions
+CREATE EXTENSION IF NOT EXISTS pgcrypto;
+
+-- Create the claude_flow schema
+CREATE SCHEMA IF NOT EXISTS claude_flow;
+
+-- Grant permissions
+GRANT ALL ON SCHEMA claude_flow TO claude;
+
+-- Set search path
+SET search_path TO claude_flow, public;
+
+-- ============================================
+-- PART 2: CORE TABLES
+-- ============================================
+
+-- Embeddings table with RuVector vector type (384-dim for all-MiniLM-L6-v2)
+CREATE TABLE IF NOT EXISTS claude_flow.embeddings (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    content TEXT NOT NULL,
+    embedding ruvector(384),
+    metadata JSONB DEFAULT '{}',
+    namespace VARCHAR(100) DEFAULT 'default',
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Patterns table for learned patterns (ReasoningBank)
+CREATE TABLE IF NOT EXISTS claude_flow.patterns (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    name VARCHAR(255) NOT NULL,
+    description TEXT,
+    embedding ruvector(384),
+    pattern_type VARCHAR(50),
+    confidence FLOAT DEFAULT 0.5,
+    success_count INT DEFAULT 0,
+    failure_count INT DEFAULT 0,
+    ewc_importance FLOAT DEFAULT 1.0,
+    metadata JSONB DEFAULT '{}',
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Agents table for multi-agent memory coordination
+CREATE TABLE IF NOT EXISTS claude_flow.agents (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    agent_id VARCHAR(255) NOT NULL UNIQUE,
+    agent_type VARCHAR(50),
+    state JSONB DEFAULT '{}',
+    memory_embedding ruvector(384),
+    last_active TIMESTAMPTZ DEFAULT NOW(),
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Trajectories table for SONA reinforcement learning
+CREATE TABLE IF NOT EXISTS claude_flow.trajectories (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    trajectory_id VARCHAR(255) NOT NULL UNIQUE,
+    agent_type VARCHAR(50),
+    task_description TEXT,
+    status VARCHAR(20) DEFAULT 'in_progress',
+    steps JSONB DEFAULT '[]',
+    outcome VARCHAR(20),
+    quality_score FLOAT,
+    started_at TIMESTAMPTZ DEFAULT NOW(),
+    ended_at TIMESTAMPTZ
+);
+
+-- Memory entries table (main storage for Claude-Flow memory)
+CREATE TABLE IF NOT EXISTS claude_flow.memory_entries (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    key VARCHAR(255) NOT NULL,
+    value TEXT NOT NULL,
+    embedding ruvector(384),
+    namespace VARCHAR(100) DEFAULT 'default',
+    metadata JSONB DEFAULT '{}',
+    ttl TIMESTAMPTZ,
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW(),
+    UNIQUE(key, namespace)
+);
+
+-- Hyperbolic embeddings for hierarchical data
+CREATE TABLE IF NOT EXISTS claude_flow.hyperbolic_embeddings (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    content TEXT NOT NULL,
+    euclidean_embedding ruvector(384),
+    poincare_embedding real[],  -- Array for hyperbolic operations
+    curvature FLOAT DEFAULT -1.0,
+    hierarchy_level INT DEFAULT 0,
+    parent_id UUID REFERENCES claude_flow.hyperbolic_embeddings(id),
+    metadata JSONB DEFAULT '{}',
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Graph nodes for GNN operations
+CREATE TABLE IF NOT EXISTS claude_flow.graph_nodes (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    node_id VARCHAR(255) NOT NULL UNIQUE,
+    node_type VARCHAR(50),
+    embedding ruvector(384),
+    features JSONB DEFAULT '{}',
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Graph edges for message passing
+CREATE TABLE IF NOT EXISTS claude_flow.graph_edges (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    source_id UUID REFERENCES claude_flow.graph_nodes(id),
+    target_id UUID REFERENCES claude_flow.graph_nodes(id),
+    edge_type VARCHAR(50),
+    weight FLOAT DEFAULT 1.0,
+    metadata JSONB DEFAULT '{}',
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- ============================================
+-- PART 3: HNSW INDICES (150x-12,500x faster)
+-- ============================================
+
+-- HNSW index for embeddings (cosine distance)
+CREATE INDEX IF NOT EXISTS idx_embeddings_hnsw
+ON claude_flow.embeddings
+USING hnsw (embedding ruvector_cosine_ops)
+WITH (m = 16, ef_construction = 100);
+
+-- HNSW index for patterns
+CREATE INDEX IF NOT EXISTS idx_patterns_hnsw
+ON claude_flow.patterns
+USING hnsw (embedding ruvector_cosine_ops)
+WITH (m = 16, ef_construction = 100);
+
+-- HNSW index for agent memory
+CREATE INDEX IF NOT EXISTS idx_agents_hnsw
+ON claude_flow.agents
+USING hnsw (memory_embedding ruvector_cosine_ops)
+WITH (m = 16, ef_construction = 64);
+
+-- HNSW index for memory entries
+CREATE INDEX IF NOT EXISTS idx_memory_entries_hnsw
+ON claude_flow.memory_entries
+USING hnsw (embedding ruvector_cosine_ops)
+WITH (m = 16, ef_construction = 100);
+
+-- HNSW index for hyperbolic embeddings
+CREATE INDEX IF NOT EXISTS idx_hyperbolic_hnsw
+ON claude_flow.hyperbolic_embeddings
+USING hnsw (euclidean_embedding ruvector_cosine_ops)
+WITH (m = 16, ef_construction = 100);
+
+-- HNSW index for graph nodes
+CREATE INDEX IF NOT EXISTS idx_graph_nodes_hnsw
+ON claude_flow.graph_nodes
+USING hnsw (embedding ruvector_cosine_ops)
+WITH (m = 16, ef_construction = 64);
+
+-- Additional indices for common queries
+CREATE INDEX IF NOT EXISTS idx_embeddings_namespace ON claude_flow.embeddings(namespace);
+CREATE INDEX IF NOT EXISTS idx_memory_entries_namespace ON claude_flow.memory_entries(namespace);
+CREATE INDEX IF NOT EXISTS idx_memory_entries_key ON claude_flow.memory_entries(key);
+
+-- ============================================
+-- PART 4: CORE SEARCH FUNCTIONS
+-- ============================================
+
+-- Semantic similarity search using RuVector HNSW
+CREATE OR REPLACE FUNCTION claude_flow.search_similar(
+    query_embedding ruvector(384),
+    limit_count INT DEFAULT 10,
+    min_similarity FLOAT DEFAULT 0.5
+)
+RETURNS TABLE (
+    id UUID,
+    content TEXT,
+    similarity FLOAT,
+    metadata JSONB
+) AS $$
+BEGIN
+    RETURN QUERY
+    SELECT
+        e.id,
+        e.content,
+        (1 - (e.embedding <=> query_embedding))::FLOAT AS similarity,
+        e.metadata
+    FROM claude_flow.embeddings e
+    WHERE e.embedding IS NOT NULL
+      AND (1 - (e.embedding <=> query_embedding)) >= min_similarity
+    ORDER BY e.embedding <=> query_embedding
+    LIMIT limit_count;
+END;
+$$ LANGUAGE plpgsql STABLE;
+
+-- Memory search with namespace filtering
+CREATE OR REPLACE FUNCTION claude_flow.search_memory(
+    query_embedding ruvector(384),
+    namespace_filter VARCHAR(100) DEFAULT NULL,
+    limit_count INT DEFAULT 10,
+    min_similarity FLOAT DEFAULT 0.5
+)
+RETURNS TABLE (
+    id UUID,
+    key VARCHAR(255),
+    value TEXT,
+    namespace VARCHAR(100),
+    similarity FLOAT,
+    metadata JSONB
+) AS $$
+BEGIN
+    RETURN QUERY
+    SELECT
+        m.id,
+        m.key,
+        m.value,
+        m.namespace,
+        (1 - (m.embedding <=> query_embedding))::FLOAT AS similarity,
+        m.metadata
+    FROM claude_flow.memory_entries m
+    WHERE m.embedding IS NOT NULL
+      AND (1 - (m.embedding <=> query_embedding)) >= min_similarity
+      AND (namespace_filter IS NULL OR m.namespace = namespace_filter)
+      AND (m.ttl IS NULL OR m.ttl > NOW())
+    ORDER BY m.embedding <=> query_embedding
+    LIMIT limit_count;
+END;
+$$ LANGUAGE plpgsql STABLE;
+
+-- Pattern search with type filtering
+CREATE OR REPLACE FUNCTION claude_flow.search_patterns(
+    query_embedding ruvector(384),
+    pattern_type_filter VARCHAR(50) DEFAULT NULL,
+    limit_count INT DEFAULT 10,
+    min_confidence FLOAT DEFAULT 0.5
+)
+RETURNS TABLE (
+    id UUID,
+    name VARCHAR(255),
+    description TEXT,
+    similarity FLOAT,
+    confidence FLOAT,
+    metadata JSONB
+) AS $$
+BEGIN
+    RETURN QUERY
+    SELECT
+        p.id,
+        p.name,
+        p.description,
+        (1 - (p.embedding <=> query_embedding))::FLOAT AS similarity,
+        p.confidence,
+        p.metadata
+    FROM claude_flow.patterns p
+    WHERE p.embedding IS NOT NULL
+      AND p.confidence >= min_confidence
+      AND (pattern_type_filter IS NULL OR p.pattern_type = pattern_type_filter)
+    ORDER BY p.embedding <=> query_embedding
+    LIMIT limit_count;
+END;
+$$ LANGUAGE plpgsql STABLE;
+
+-- Agent routing by expertise similarity
+CREATE OR REPLACE FUNCTION claude_flow.find_agents(
+    query_embedding ruvector(384),
+    agent_type_filter VARCHAR(50) DEFAULT NULL,
+    limit_count INT DEFAULT 5
+)
+RETURNS TABLE (
+    agent_id VARCHAR(255),
+    agent_type VARCHAR(50),
+    similarity FLOAT,
+    state JSONB
+) AS $$
+BEGIN
+    RETURN QUERY
+    SELECT
+        a.agent_id,
+        a.agent_type,
+        (1 - (a.memory_embedding <=> query_embedding))::FLOAT AS similarity,
+        a.state
+    FROM claude_flow.agents a
+    WHERE a.memory_embedding IS NOT NULL
+      AND (agent_type_filter IS NULL OR a.agent_type = agent_type_filter)
+    ORDER BY a.memory_embedding <=> query_embedding
+    LIMIT limit_count;
+END;
+$$ LANGUAGE plpgsql STABLE;
+
+-- ============================================
+-- PART 5: HYPERBOLIC OPERATIONS
+-- ============================================
+
+-- Convert Euclidean to Poincaré embedding
+CREATE OR REPLACE FUNCTION claude_flow.to_poincare(
+    euclidean real[],
+    curvature FLOAT DEFAULT -1.0
+)
+RETURNS real[] AS $$
+BEGIN
+    RETURN ruvector_exp_map(ARRAY_FILL(0.0::real, ARRAY[array_length(euclidean, 1)]), euclidean, curvature);
+END;
+$$ LANGUAGE plpgsql IMMUTABLE;
+
+-- Poincaré distance (geodesic)
+CREATE OR REPLACE FUNCTION claude_flow.poincare_distance(
+    x real[],
+    y real[],
+    curvature FLOAT DEFAULT -1.0
+)
+RETURNS FLOAT AS $$
+BEGIN
+    RETURN ruvector_poincare_distance(x, y, curvature);
+END;
+$$ LANGUAGE plpgsql IMMUTABLE;
+
+-- Hyperbolic search in Poincaré ball
+CREATE OR REPLACE FUNCTION claude_flow.hyperbolic_search(
+    query ruvector(384),
+    limit_count INT DEFAULT 10,
+    curvature FLOAT DEFAULT -1.0
+)
+RETURNS TABLE (
+    id UUID,
+    content TEXT,
+    euclidean_dist FLOAT,
+    hyperbolic_dist FLOAT,
+    hierarchy_level INT,
+    metadata JSONB
+) AS $$
+DECLARE
+    query_arr real[];
+    query_poincare real[];
+BEGIN
+    -- Convert query to array and then to Poincaré
+    SELECT array_agg(x::real ORDER BY ordinality) INTO query_arr
+    FROM unnest(string_to_array(trim(both '[]' from query::text), ',')) WITH ORDINALITY AS t(x, ordinality);
+
+    query_poincare := claude_flow.to_poincare(query_arr, curvature);
+
+    RETURN QUERY
+    SELECT
+        he.id,
+        he.content,
+        (he.euclidean_embedding <-> query)::FLOAT AS euc_dist,
+        COALESCE(ruvector_poincare_distance(he.poincare_embedding, query_poincare, curvature), 999.0)::FLOAT AS hyp_dist,
+        he.hierarchy_level,
+        he.metadata
+    FROM claude_flow.hyperbolic_embeddings he
+    WHERE he.euclidean_embedding IS NOT NULL
+    ORDER BY he.euclidean_embedding <-> query
+    LIMIT limit_count;
+END;
+$$ LANGUAGE plpgsql STABLE;
+
+-- ============================================
+-- PART 6: UTILITY FUNCTIONS
+-- ============================================
+
+-- Get RuVector version info
+CREATE OR REPLACE FUNCTION claude_flow.ruvector_info()
+RETURNS TABLE (
+    version TEXT,
+    simd_info TEXT
+) AS $$
+BEGIN
+    RETURN QUERY
+    SELECT ruvector_version(), ruvector_simd_info();
+END;
+$$ LANGUAGE plpgsql STABLE;
+
+-- Cosine similarity helper (converts cosine distance to similarity)
+CREATE OR REPLACE FUNCTION claude_flow.cosine_similarity(
+    a ruvector,
+    b ruvector
+)
+RETURNS FLOAT AS $$
+BEGIN
+    RETURN (1 - (a <=> b))::FLOAT;
+END;
+$$ LANGUAGE plpgsql IMMUTABLE;
+
+-- L2 distance helper
+CREATE OR REPLACE FUNCTION claude_flow.l2_distance(
+    a ruvector,
+    b ruvector
+)
+RETURNS FLOAT AS $$
+BEGIN
+    RETURN (a <-> b)::FLOAT;
+END;
+$$ LANGUAGE plpgsql IMMUTABLE;
+
+-- Upsert memory entry
+CREATE OR REPLACE FUNCTION claude_flow.upsert_memory(
+    p_key VARCHAR(255),
+    p_value TEXT,
+    p_embedding ruvector(384) DEFAULT NULL,
+    p_namespace VARCHAR(100) DEFAULT 'default',
+    p_metadata JSONB DEFAULT '{}',
+    p_ttl TIMESTAMPTZ DEFAULT NULL
+)
+RETURNS UUID AS $$
+DECLARE
+    v_id UUID;
+BEGIN
+    INSERT INTO claude_flow.memory_entries (key, value, embedding, namespace, metadata, ttl, updated_at)
+    VALUES (p_key, p_value, p_embedding, p_namespace, p_metadata, p_ttl, NOW())
+    ON CONFLICT (key, namespace) DO UPDATE SET
+        value = EXCLUDED.value,
+        embedding = COALESCE(EXCLUDED.embedding, claude_flow.memory_entries.embedding),
+        metadata = EXCLUDED.metadata,
+        ttl = EXCLUDED.ttl,
+        updated_at = NOW()
+    RETURNING id INTO v_id;
+
+    RETURN v_id;
+END;
+$$ LANGUAGE plpgsql;
+
+-- ============================================
+-- COMPLETION
+-- ============================================
+
+DO $$
+DECLARE
+    v_version TEXT;
+    v_simd TEXT;
+BEGIN
+    SELECT ruvector_version() INTO v_version;
+    SELECT ruvector_simd_info() INTO v_simd;
+
+    RAISE NOTICE '';
+    RAISE NOTICE '============================================';
+    RAISE NOTICE 'RuVector PostgreSQL Initialization Complete!';
+    RAISE NOTICE '============================================';
+    RAISE NOTICE '';
+    RAISE NOTICE 'RuVector Version: %', v_version;
+    RAISE NOTICE 'SIMD: %', v_simd;
+    RAISE NOTICE '';
+    RAISE NOTICE 'Schema: claude_flow';
+    RAISE NOTICE 'Tables: embeddings, patterns, agents, trajectories,';
+    RAISE NOTICE '        memory_entries, hyperbolic_embeddings,';
+    RAISE NOTICE '        graph_nodes, graph_edges';
+    RAISE NOTICE 'Indices: 6 HNSW indices + 3 B-tree indices';
+    RAISE NOTICE '';
+    RAISE NOTICE 'Key Functions:';
+    RAISE NOTICE '  - claude_flow.search_similar(embedding, limit, min_sim)';
+    RAISE NOTICE '  - claude_flow.search_memory(embedding, namespace, limit)';
+    RAISE NOTICE '  - claude_flow.search_patterns(embedding, type, limit)';
+    RAISE NOTICE '  - claude_flow.find_agents(embedding, type, limit)';
+    RAISE NOTICE '  - claude_flow.hyperbolic_search(embedding, limit, curvature)';
+    RAISE NOTICE '  - claude_flow.upsert_memory(key, value, embedding, namespace)';
+    RAISE NOTICE '';
+    RAISE NOTICE 'Operators: <=> (cosine), <-> (L2), <#> (neg inner product)';
+    RAISE NOTICE '';
+END $$;
+`;
+
+/**
+ * README template
+ */
+const README_TEMPLATE = `# RuVector PostgreSQL Setup
+
+This directory contains the Docker configuration for RuVector PostgreSQL with Claude-Flow V3.
+
+## Quick Start
+
+\`\`\`bash
+# Start the container
+docker-compose up -d
+
+# Verify it's running
+docker-compose ps
+
+# Check RuVector version
+docker exec ruvector-postgres psql -U claude -d claude_flow -c "SELECT ruvector_version();"
+\`\`\`
+
+## Connection Details
+
+| Setting | Value |
+|---------|-------|
+| Host | localhost |
+| Port | 5432 |
+| Database | claude_flow |
+| Username | claude |
+| Password | claude-flow-test |
+| Schema | claude_flow |
+
+## RuVector Syntax
+
+### Extension Installation
+\`\`\`sql
+-- IMPORTANT: Requires explicit version
+CREATE EXTENSION IF NOT EXISTS ruvector VERSION '0.1.0';
+\`\`\`
+
+### Vector Type
+\`\`\`sql
+-- Use ruvector(384), NOT vector(384)
+CREATE TABLE embeddings (
+    id UUID PRIMARY KEY,
+    embedding ruvector(384)
+);
+\`\`\`
+
+### Distance Operators
+| Operator | Description |
+|----------|-------------|
+| \`<=>\` | Cosine distance |
+| \`<->\` | L2 (Euclidean) distance |
+| \`<#>\` | Negative inner product |
+
+### HNSW Index
+\`\`\`sql
+CREATE INDEX idx_embeddings_hnsw
+ON embeddings
+USING hnsw (embedding ruvector_cosine_ops)
+WITH (m = 16, ef_construction = 100);
+\`\`\`
+
+## Import from sql.js/JSON
+
+\`\`\`bash
+# Export current Claude-Flow memory
+npx claude-flow memory list --format json > memory-export.json
+
+# Import to RuVector PostgreSQL
+npx claude-flow ruvector import --input memory-export.json
+\`\`\`
+
+## pgAdmin (Optional)
+
+\`\`\`bash
+docker-compose --profile gui up -d
+\`\`\`
+
+Access at: http://localhost:5050
+- Email: admin@claude-flow.local
+- Password: admin
+
+## Troubleshooting
+
+### Extension creation fails
+Use explicit version: \`CREATE EXTENSION ruvector VERSION '0.1.0';\`
+
+### Container won't start
+\`\`\`bash
+docker-compose logs postgres
+docker-compose down -v
+docker-compose up -d
+\`\`\`
+
+## Learn More
+- [RuVector Docker Hub](https://hub.docker.com/r/ruvnet/ruvector-postgres)
+- [Claude-Flow Documentation](https://github.com/ruvnet/claude-flow)
+`;
+
+/**
+ * RuVector Setup command - outputs Docker files and SQL
+ */
+export const setupCommand: Command = {
+  name: 'setup',
+  description: 'Output Docker files and SQL for RuVector PostgreSQL setup',
+  aliases: ['scaffold', 'docker'],
+  options: [
+    {
+      name: 'output',
+      short: 'o',
+      description: 'Output directory (default: ./ruvector-postgres)',
+      type: 'string',
+      default: './ruvector-postgres',
+    },
+    {
+      name: 'print',
+      short: 'p',
+      description: 'Print to stdout instead of writing files',
+      type: 'boolean',
+      default: false,
+    },
+    {
+      name: 'force',
+      short: 'f',
+      description: 'Overwrite existing files',
+      type: 'boolean',
+      default: false,
+    },
+  ],
+  examples: [
+    { command: 'claude-flow ruvector setup', description: 'Output files to ./ruvector-postgres/' },
+    { command: 'claude-flow ruvector setup --output /path/to/dir', description: 'Output to custom directory' },
+    { command: 'claude-flow ruvector setup --print', description: 'Print files to stdout' },
+    { command: 'claude-flow ruvector setup --force', description: 'Overwrite existing files' },
+  ],
+  action: async (ctx: CommandContext): Promise<CommandResult> => {
+    const outputDir = (ctx.flags.output as string) || './ruvector-postgres';
+    const printOnly = ctx.flags.print as boolean;
+    const force = ctx.flags.force as boolean;
+
+    output.writeln();
+    output.writeln(output.bold('RuVector PostgreSQL Setup'));
+    output.writeln(output.dim('=' .repeat(50)));
+    output.writeln();
+
+    if (printOnly) {
+      // Print to stdout
+      output.writeln(output.bold('=== docker-compose.yml ==='));
+      output.writeln();
+      output.writeln(DOCKER_COMPOSE_TEMPLATE);
+      output.writeln();
+      output.writeln(output.bold('=== scripts/init-db.sql ==='));
+      output.writeln();
+      output.writeln(INIT_SQL_TEMPLATE);
+      output.writeln();
+      output.writeln(output.bold('=== README.md ==='));
+      output.writeln();
+      output.writeln(README_TEMPLATE);
+      return { success: true };
+    }
+
+    // Create directory structure
+    const scriptsDir = path.join(outputDir, 'scripts');
+
+    try {
+      // Check if directory exists
+      if (fs.existsSync(outputDir) && !force) {
+        const files = fs.readdirSync(outputDir);
+        if (files.length > 0) {
+          output.printWarning(`Directory ${outputDir} already exists and is not empty.`);
+          output.printInfo('Use --force to overwrite existing files.');
+          return { success: false, message: 'Directory not empty' };
+        }
+      }
+
+      // Create directories
+      output.printInfo(`Creating directory: ${outputDir}`);
+      fs.mkdirSync(outputDir, { recursive: true });
+      fs.mkdirSync(scriptsDir, { recursive: true });
+
+      // Write files
+      const dockerComposePath = path.join(outputDir, 'docker-compose.yml');
+      const initSqlPath = path.join(scriptsDir, 'init-db.sql');
+      const readmePath = path.join(outputDir, 'README.md');
+
+      output.printInfo(`Writing: ${dockerComposePath}`);
+      fs.writeFileSync(dockerComposePath, DOCKER_COMPOSE_TEMPLATE);
+
+      output.printInfo(`Writing: ${initSqlPath}`);
+      fs.writeFileSync(initSqlPath, INIT_SQL_TEMPLATE);
+
+      output.printInfo(`Writing: ${readmePath}`);
+      fs.writeFileSync(readmePath, README_TEMPLATE);
+
+      output.writeln();
+      output.printSuccess('RuVector PostgreSQL setup files created!');
+      output.writeln();
+
+      output.printBox([
+        'Files created:',
+        '',
+        `  ${outputDir}/`,
+        '  ├── docker-compose.yml',
+        '  ├── README.md',
+        '  └── scripts/',
+        '      └── init-db.sql',
+        '',
+        'Next steps:',
+        '',
+        `  cd ${outputDir}`,
+        '  docker-compose up -d',
+        '  docker exec ruvector-postgres psql -U claude -d claude_flow -c "SELECT ruvector_version();"',
+      ].join('\n'), 'Setup Complete');
+
+      output.writeln();
+
+      return { success: true };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      output.printError(`Failed to create setup files: ${errorMessage}`);
+      return { success: false, message: errorMessage };
+    }
+  },
+};
+
+export default setupCommand;