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

Checkpoint: File edits

rUv2857e63eda1c
diff --git a/agents/architect.yaml b/agents/architect.yaml
index 8c718c189d..346dce3655 100644
--- a/agents/architect.yaml
+++ b/agents/architect.yaml
@@ -8,4 +8,4 @@ capabilities:
optimizations:
- context-caching
- memory-persistence
-createdAt: "2026-01-17T20:38:42.618Z"
+createdAt: "2026-01-17T20:58:10.119Z"
diff --git a/agents/coder.yaml b/agents/coder.yaml
index 42496a700c..48fb0e731b 100644
--- a/agents/coder.yaml
+++ b/agents/coder.yaml
@@ -8,4 +8,4 @@ capabilities:
optimizations:
- flash-attention
- token-reduction
-createdAt: "2026-01-17T20:38:42.618Z"
+createdAt: "2026-01-17T20:58:10.119Z"
diff --git a/agents/reviewer.yaml b/agents/reviewer.yaml
index 64b2291969..136e6906a4 100644
--- a/agents/reviewer.yaml
+++ b/agents/reviewer.yaml
@@ -7,4 +7,4 @@ capabilities:
- best-practices
optimizations:
- incremental-analysis
-createdAt: "2026-01-17T20:38:42.619Z"
+createdAt: "2026-01-17T20:58:10.120Z"
diff --git a/agents/security-architect.yaml b/agents/security-architect.yaml
index 620d91cb37..92d78e7854 100644
--- a/agents/security-architect.yaml
+++ b/agents/security-architect.yaml
@@ -7,4 +7,4 @@ capabilities:
- security-review
optimizations:
- pattern-matching
-createdAt: "2026-01-17T20:38:42.619Z"
+createdAt: "2026-01-17T20:58:10.120Z"
diff --git a/agents/tester.yaml b/agents/tester.yaml
index ba4c15a8f8..f1747b568f 100644
--- a/agents/tester.yaml
+++ b/agents/tester.yaml
@@ -7,4 +7,4 @@ capabilities:
- coverage
optimizations:
- parallel-execution
-createdAt: "2026-01-17T20:38:42.619Z"
+createdAt: "2026-01-17T20:58:10.119Z"
diff --git a/v3/@claude-flow/cli/src/commands/ruvector/setup.ts b/v3/@claude-flow/cli/src/commands/ruvector/setup.ts
new file mode 100644
index 0000000000..3d243911ba
--- /dev/null
+++ b/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: [email protected]
+ 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
+- 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.options.output as string;
+ const printOnly = ctx.options.print as boolean;
+ const force = ctx.options.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, error: '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, error: errorMessage };
+ }
+ },
+};
+
+export default setupCommand;