kynjal-cli 4.0.0 → 4.0.2

package/dist/src/commands/ruvector/setup.js

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