vesper-memory 0.3.0

package/scripts/README.md

@@ -0,0 +1,101 @@
+# Memory System Scripts
+
+This directory contains automation scripts for managing the Memory MCP server infrastructure.
+
+## Scripts
+
+### `ensure-infrastructure.sh`
+**Purpose**: Automatically starts Docker services (Redis, PostgreSQL, Qdrant) if they're not running.
+
+**When it runs**:
+- On every Claude Code session start (via SessionStart hook)
+- Can be run manually anytime
+
+**Usage**:
+```bash
+./scripts/ensure-infrastructure.sh
+```
+
+### `health-check.sh`
+**Purpose**: Comprehensive health check of all Memory system components.
+
+**Usage**:
+```bash
+./scripts/health-check.sh
+```
+
+**Checks**:
+- Docker daemon status
+- Redis connectivity
+- PostgreSQL connectivity
+- Qdrant API responsiveness
+- MCP server build artifacts
+- MCP configuration
+
+## Auto-Start Configuration
+
+The Memory system is configured to start automatically when Claude Code launches:
+
+1. **SessionStart Hook** (`~/.claude/settings.json`):
+   - Runs `ensure-infrastructure.sh` on every Claude Code session
+   - Ensures Docker services are running before MCP server starts
+
+2. **MCP Server** (`~/.claude/mcp_config.json`):
+   - Claude Code automatically launches `dist/server.js` as a subprocess
+   - Server connects to running Docker infrastructure
+
+3. **Optional: Boot-time Auto-Start** (`~/Library/LaunchAgents/com.memory.infrastructure.plist`):
+   - launchd service to start infrastructure on macOS login
+   - Currently created but not loaded (load with `launchctl load`)
+
+## Manual Operations
+
+### Start infrastructure
+```bash
+cd /Users/fitzy/Documents/MemoryProject
+docker-compose up -d
+```
+
+### Stop infrastructure
+```bash
+docker-compose down
+```
+
+### View logs
+```bash
+# All services
+docker-compose logs -f
+
+# Specific service
+docker-compose logs -f redis
+```
+
+### Restart after changes
+```bash
+npm run build                # Rebuild TypeScript
+docker-compose restart       # Restart services
+# Then restart Claude Code to reconnect MCP server
+```
+
+## Troubleshooting
+
+### MCP server not connecting
+1. Run `./scripts/health-check.sh` to diagnose
+2. Check `docker-compose ps` - all services should show "Up"
+3. Verify build: `ls -la dist/server.js`
+4. Check logs: `tail -f logs/infrastructure.log`
+
+### Docker services won't start
+1. Ensure Docker Desktop is running
+2. Check ports 6379, 5432, 6333 are not in use:
+   ```bash
+   lsof -i :6379  # Redis
+   lsof -i :5432  # PostgreSQL
+   lsof -i :6333  # Qdrant
+   ```
+
+### Changes to server.ts not taking effect
+```bash
+npm run build  # Must rebuild TypeScript
+# Restart Claude Code to reload MCP server
+```

package/scripts/ensure-infrastructure.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+# Ensures Docker services are running for Memory MCP server
+
+# Dynamically determine installation directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+cd "$PROJECT_DIR" || exit 1
+
+# Check if Docker is running
+if ! docker info >/dev/null 2>&1; then
+    echo "⚠️  Docker is not running. Please start Docker Desktop."
+    exit 0  # Exit gracefully - don't block Claude startup
+fi
+
+# Check if core services are healthy using docker ps directly
+REDIS_HEALTHY=$(docker ps --filter "name=vesper-redis" --filter "health=healthy" --format "{{.Names}}" | wc -l | tr -d ' ')
+QDRANT_HEALTHY=$(docker ps --filter "name=vesper-qdrant" --filter "health=healthy" --format "{{.Names}}" | wc -l | tr -d ' ')
+EMBEDDING_HEALTHY=$(docker ps --filter "name=vesper-embedding" --filter "health=healthy" --format "{{.Names}}" | wc -l | tr -d ' ')
+
+if [ "$REDIS_HEALTHY" = "0" ] || [ "$QDRANT_HEALTHY" = "0" ] || [ "$EMBEDDING_HEALTHY" = "0" ]; then
+    echo "🚀 Starting Memory infrastructure..."
+    # Use --no-recreate to avoid conflicts with existing containers
+    # Suppress bcrypt hash variable warnings from .env file
+    docker-compose up -d --no-recreate 2>&1 | grep -v "is not set. Defaulting" | grep -v "level=warning" || true
+    sleep 3  # Give services time to initialize
+    echo "✅ Memory infrastructure started"
+else
+    echo "✅ Memory infrastructure already running"
+fi
+
+# Verify build artifacts exist
+if [ ! -f "$PROJECT_DIR/dist/server.js" ]; then
+    echo "🔨 Building MCP server..."
+    npm run build
+fi
+
+echo "✅ Memory system infrastructure ready"
+exit 0

package/scripts/fresh-install-auto.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+
+# Vesper Fresh Installation Script (Automated - No Prompts)
+# For CI/CD or automated deployments
+# WARNING: This will delete all data without confirmation
+
+set -e  # Exit on error
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}╔════════════════════════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║    Vesper Fresh Installation (Automated)                  ║${NC}"
+echo -e "${BLUE}╚════════════════════════════════════════════════════════════╝${NC}"
+echo ""
+
+# Step 1: Stop Docker
+echo -e "${GREEN}[1/10]${NC} Stopping Docker containers..."
+docker-compose down --remove-orphans 2>/dev/null || true
+# Remove any orphaned vesper containers
+docker ps -a | grep vesper | awk '{print $1}' | xargs -r docker rm -f 2>/dev/null || true
+
+# Step 2: Remove volumes
+echo -e "${GREEN}[2/10]${NC} Removing Docker volumes..."
+docker volume ls --filter name=memoryproject 2>/dev/null | awk 'NR>1 {print $2}' | xargs -r docker volume rm 2>/dev/null || true
+
+# Step 3: Remove networks
+echo -e "${GREEN}[3/10]${NC} Removing Docker networks..."
+docker network ls --filter name=memoryproject 2>/dev/null | awk 'NR>1 {print $2}' | xargs -r docker network rm 2>/dev/null || true
+
+# Step 4: Remove Vesper images
+echo -e "${GREEN}[4/10]${NC} Removing Vesper Docker images..."
+docker images --filter reference="*vesper*" --filter reference="*memoryproject*" -q 2>/dev/null | xargs -r docker rmi -f 2>/dev/null || true
+
+# Step 5: Remove node modules
+echo -e "${GREEN}[5/10]${NC} Removing node_modules..."
+rm -rf node_modules package-lock.json
+
+# Step 6: Remove build artifacts
+echo -e "${GREEN}[6/10]${NC} Removing build artifacts..."
+rm -rf dist/ .cache/ .turbo/ coverage/
+
+# Step 7: Clean data
+echo -e "${GREEN}[7/10]${NC} Cleaning data directories..."
+rm -rf data/ logs/ .redis-data/ .postgres-data/ .qdrant-data/
+mkdir -p data logs
+
+# Step 8: Clean certificates
+echo -e "${GREEN}[8/10]${NC} Cleaning certificates..."
+find config/ssl -type f ! -name "*.sh" -delete 2>/dev/null || true
+
+# Step 9: Install
+echo -e "${GREEN}[9/10]${NC} Installing dependencies..."
+npm install
+
+# Step 10: Build
+echo -e "${GREEN}[10/10]${NC} Building project..."
+npm run build
+
+echo ""
+echo -e "${GREEN}✓ Automated fresh installation complete!${NC}"
+echo ""
+
+# Auto-create .env if it doesn't exist
+if [ ! -f .env ] && [ -f .env.example ]; then
+    cp .env.example .env
+    echo -e "${GREEN}✓ Created .env from .env.example${NC}"
+fi
+
+# Auto-generate development certificates if they don't exist
+if [ ! -f config/ssl/server.crt ] && [ -f scripts/generate-dev-certs.sh ]; then
+    echo -e "${BLUE}Generating development certificates...${NC}"
+    ./scripts/generate-dev-certs.sh
+    echo -e "${GREEN}✓ Development certificates generated${NC}"
+fi
+
+# Start services if AUTO_START=true
+if [ "${AUTO_START}" = "true" ]; then
+    echo ""
+    echo -e "${BLUE}Starting Docker services...${NC}"
+    docker-compose up -d
+    echo -e "${GREEN}✓ Services started${NC}"
+    echo ""
+    echo -e "${YELLOW}Check status:${NC} make status"
+else
+    echo ""
+    echo -e "${YELLOW}To start services:${NC} docker-compose up -d"
+    echo -e "${YELLOW}Or run with:${NC} AUTO_START=true npm run fresh-install:auto"
+fi
+
+echo ""
+echo -e "${GREEN}Vesper is ready! 🚀${NC}"

package/scripts/fresh-install.sh

@@ -0,0 +1,167 @@
+#!/bin/bash
+
+# Vesper Fresh Installation Script
+# This script removes all previous installations and starts completely fresh
+# WARNING: This will delete all data, containers, volumes, and build artifacts
+
+set -e  # Exit on error
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Print banner
+echo -e "${BLUE}"
+echo "╔════════════════════════════════════════════════════════════╗"
+echo "║         Vesper Memory System - Fresh Installation         ║"
+echo "║                     Complete Cleanup                       ║"
+echo "╚════════════════════════════════════════════════════════════╝"
+echo -e "${NC}"
+
+# Warning prompt
+echo -e "${YELLOW}⚠️  WARNING: This script will:${NC}"
+echo "   • Stop and remove ALL Docker containers for Vesper"
+echo "   • Delete ALL Docker volumes (all data will be lost)"
+echo "   • Remove Docker networks"
+echo "   • Delete node_modules and package-lock.json"
+echo "   • Delete build artifacts (dist/)"
+echo "   • Delete all database files"
+echo "   • Delete all logs and temporary files"
+echo ""
+echo -e "${RED}   ALL DATA WILL BE PERMANENTLY DELETED!${NC}"
+echo ""
+read -p "Are you sure you want to continue? (yes/no): " -r
+echo
+if [[ ! $REPLY =~ ^[Yy][Ee][Ss]$ ]]
+then
+    echo -e "${YELLOW}Installation cancelled.${NC}"
+    exit 0
+fi
+
+echo ""
+echo -e "${BLUE}Starting fresh installation...${NC}"
+echo ""
+
+# Step 1: Stop and remove Docker containers
+echo -e "${GREEN}[1/10]${NC} Stopping Docker containers..."
+if [ -f docker-compose.yml ]; then
+    docker-compose down --remove-orphans 2>/dev/null || true
+fi
+# Remove any orphaned vesper containers not in docker-compose
+docker ps -a | grep vesper | awk '{print $1}' | xargs -r docker rm -f 2>/dev/null || true
+echo "   ✓ Docker containers stopped"
+
+# Step 2: Remove Docker volumes
+echo -e "${GREEN}[2/10]${NC} Removing Docker volumes..."
+docker volume ls --filter name=memoryproject 2>/dev/null | awk 'NR>1 {print $2}' | xargs -r docker volume rm 2>/dev/null || true
+echo "   ✓ Docker volumes removed"
+
+# Step 3: Remove Docker networks
+echo -e "${GREEN}[3/10]${NC} Removing Docker networks..."
+docker network ls --filter name=memoryproject 2>/dev/null | awk 'NR>1 {print $2}' | xargs -r docker network rm 2>/dev/null || true
+echo "   ✓ Docker networks removed"
+
+# Step 4: Remove Vesper Docker images
+echo -e "${GREEN}[4/10]${NC} Removing Vesper Docker images..."
+docker images --filter reference="*vesper*" --filter reference="*memoryproject*" -q 2>/dev/null | xargs -r docker rmi -f 2>/dev/null || true
+echo "   ✓ Vesper images removed"
+
+# Step 5: Remove node_modules and package-lock.json
+echo -e "${GREEN}[5/10]${NC} Removing node_modules and lock files..."
+rm -rf node_modules
+rm -f package-lock.json
+echo "   ✓ Node dependencies removed"
+
+# Step 6: Remove build artifacts
+echo -e "${GREEN}[6/10]${NC} Removing build artifacts..."
+rm -rf dist/
+rm -rf .cache/
+rm -rf .turbo/
+rm -rf coverage/
+echo "   ✓ Build artifacts removed"
+
+# Step 7: Remove data directories
+echo -e "${GREEN}[7/10]${NC} Removing data directories..."
+rm -rf data/
+mkdir -p data
+rm -rf logs/
+mkdir -p logs
+rm -rf .redis-data/
+rm -rf .postgres-data/
+rm -rf .qdrant-data/
+echo "   ✓ Data directories cleaned"
+
+# Step 8: Remove certificate files (except scripts)
+echo -e "${GREEN}[8/10]${NC} Cleaning certificate directories..."
+find config/ssl -type f ! -name "*.sh" -delete 2>/dev/null || true
+echo "   ✓ Old certificates removed"
+
+# Step 9: Fresh npm install
+echo -e "${GREEN}[9/10]${NC} Installing dependencies (this may take a few minutes)..."
+npm install
+echo "   ✓ Dependencies installed"
+
+# Step 10: Build the project
+echo -e "${GREEN}[10/10]${NC} Building project..."
+npm run build
+echo "   ✓ Project built successfully"
+
+echo ""
+echo -e "${BLUE}════════════════════════════════════════════════════════════${NC}"
+echo -e "${GREEN}✓ Fresh installation complete!${NC}"
+echo -e "${BLUE}════════════════════════════════════════════════════════════${NC}"
+echo ""
+
+# Auto-create .env if it doesn't exist
+if [ ! -f .env ]; then
+    echo -e "${YELLOW}⚠️  No .env file found${NC}"
+    if [ -f .env.example ]; then
+        cp .env.example .env
+        echo -e "${GREEN}✓ Created .env from .env.example${NC}"
+    else
+        echo -e "${RED}✗ .env.example not found${NC}"
+    fi
+fi
+
+# Auto-generate development certificates if they don't exist
+if [ ! -f config/ssl/server.crt ] && [ -f scripts/generate-dev-certs.sh ]; then
+    echo ""
+    echo -e "${BLUE}Generating development certificates...${NC}"
+    ./scripts/generate-dev-certs.sh
+    echo -e "${GREEN}✓ Development certificates generated${NC}"
+fi
+
+echo ""
+echo -e "${BLUE}════════════════════════════════════════════════════════════${NC}"
+echo -e "${GREEN}✓ Installation complete!${NC}"
+echo -e "${BLUE}════════════════════════════════════════════════════════════${NC}"
+echo ""
+
+# Ask if user wants to start services now
+read -p "Would you like to start Docker services now? (yes/no): " -r
+echo
+if [[ $REPLY =~ ^[Yy][Ee][Ss]$ ]]; then
+    echo -e "${BLUE}Starting Docker services...${NC}"
+    docker-compose up -d
+    echo ""
+    echo -e "${GREEN}✓ Services started!${NC}"
+    echo ""
+    echo -e "${YELLOW}Check status with:${NC} ${BLUE}make status${NC}"
+    echo -e "${YELLOW}View logs with:${NC} ${BLUE}docker-compose logs -f${NC}"
+else
+    echo ""
+    echo -e "${YELLOW}To start services later, run:${NC}"
+    echo -e "  ${BLUE}docker-compose up -d${NC}"
+fi
+
+echo ""
+echo -e "${YELLOW}Optional next steps:${NC}"
+echo -e "  • Run tests: ${BLUE}npm test${NC}"
+echo -e "  • Generate API key: ${BLUE}npm run generate-api-key -- --tier unlimited --name 'Development'${NC}"
+echo -e "  • Edit .env: ${BLUE}nano .env${NC}"
+echo ""
+echo -e "${GREEN}Vesper is ready! 🚀${NC}"
+echo ""

package/scripts/health-check.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+# Health check for Memory MCP server and dependencies
+
+set -e
+
+PROJECT_DIR="/Users/fitzy/Documents/MemoryProject"
+
+echo "🔍 Memory System Health Check"
+echo "=============================="
+
+# Check Docker
+if ! docker info >/dev/null 2>&1; then
+    echo "❌ Docker: Not running"
+    exit 1
+else
+    echo "✅ Docker: Running"
+fi
+
+# Check Redis
+if docker-compose -f "$PROJECT_DIR/docker-compose.yml" ps redis | grep -q "Up"; then
+    REDIS_PASSWORD="${REDIS_PASSWORD:-MHot0MIuDfST4QUY6g3WVbLzcDEzJ14B}"
+    if docker exec memory-redis redis-cli -a "$REDIS_PASSWORD" ping 2>/dev/null | grep -q "PONG"; then
+        echo "✅ Redis: Running and responsive"
+    else
+        echo "⚠️  Redis: Running but not responsive"
+    fi
+else
+    echo "❌ Redis: Not running"
+fi
+
+# Check PostgreSQL
+if docker-compose -f "$PROJECT_DIR/docker-compose.yml" ps postgres | grep -q "Up"; then
+    if docker exec memory-postgres pg_isready -U postgres 2>/dev/null | grep -q "accepting connections"; then
+        echo "✅ PostgreSQL: Running and responsive"
+    else
+        echo "⚠️  PostgreSQL: Running but not responsive"
+    fi
+else
+    echo "❌ PostgreSQL: Not running"
+fi
+
+# Check Qdrant
+if docker-compose -f "$PROJECT_DIR/docker-compose.yml" ps qdrant | grep -q "Up"; then
+    if curl -sf http://localhost:6333/healthz >/dev/null 2>&1; then
+        echo "✅ Qdrant: Running and responsive"
+    else
+        echo "⚠️  Qdrant: Running but not responsive"
+    fi
+else
+    echo "❌ Qdrant: Not running"
+fi
+
+# Check build artifacts
+if [ -f "$PROJECT_DIR/dist/server.js" ]; then
+    echo "✅ MCP Server: Build artifacts present"
+else
+    echo "❌ MCP Server: Build artifacts missing (run: npm run build)"
+fi
+
+# Check MCP config
+if [ -f "/Users/fitzy/.claude/mcp_config.json" ]; then
+    if grep -q "memory" "/Users/fitzy/.claude/mcp_config.json"; then
+        echo "✅ MCP Config: Memory server configured"
+    else
+        echo "⚠️  MCP Config: Memory server not configured"
+    fi
+else
+    echo "❌ MCP Config: Not found"
+fi
+
+echo ""
+echo "📊 Memory System Status: Ready"

package/scripts/init-qdrant.ts

@@ -0,0 +1,201 @@
+#!/usr/bin/env npx ts-node --esm
+/**
+ * Qdrant Collection Initialization Script
+ *
+ * Creates the memory-vectors collection with proper configuration:
+ * - 1024-dim dense vectors (BGE-large embedding dimension)
+ * - Cosine similarity distance metric
+ * - Payload indexing for metadata filtering
+ *
+ * Usage:
+ *   npm run init:qdrant
+ *
+ * Environment variables:
+ *   QDRANT_URL - Qdrant server URL (default: http://localhost:6333)
+ *   QDRANT_API_KEY - API key for authentication (required in production)
+ */
+
+import { QdrantClient } from "@qdrant/js-client-rest";
+import { config } from "dotenv";
+
+// Load environment variables
+config();
+
+// Configuration
+const QDRANT_URL = process.env.QDRANT_URL || "http://localhost:6333";
+const QDRANT_API_KEY = process.env.QDRANT_API_KEY;
+const COLLECTION_NAME = "memory-vectors";
+const VECTOR_SIZE = 1024; // BGE-large dimension
+
+interface InitResult {
+  success: boolean;
+  message: string;
+  collectionName: string;
+  vectorSize: number;
+}
+
+/**
+ * Initialize Qdrant collection for memory storage
+ */
+async function initializeQdrant(): Promise<InitResult> {
+  console.log("Initializing Qdrant collection...");
+  console.log(`  URL: ${QDRANT_URL}`);
+  console.log(`  Collection: ${COLLECTION_NAME}`);
+  console.log(`  Vector Size: ${VECTOR_SIZE}`);
+  console.log(`  API Key: ${QDRANT_API_KEY ? "configured" : "not configured"}`);
+
+  // Create client with optional API key
+  const clientConfig: { url: string; apiKey?: string } = {
+    url: QDRANT_URL,
+  };
+
+  if (QDRANT_API_KEY) {
+    clientConfig.apiKey = QDRANT_API_KEY;
+  }
+
+  const client = new QdrantClient(clientConfig);
+
+  try {
+    // Check Qdrant health first
+    console.log("\nChecking Qdrant health...");
+    const response = await fetch(`${QDRANT_URL}/healthz`);
+    if (!response.ok) {
+      throw new Error(`Qdrant health check failed: ${response.status}`);
+    }
+    console.log("  Qdrant is healthy");
+
+    // Check if collection already exists
+    console.log("\nChecking existing collections...");
+    const collections = await client.getCollections();
+    const existingCollection = collections.collections.find(
+      (c) => c.name === COLLECTION_NAME
+    );
+
+    if (existingCollection) {
+      // Verify configuration matches
+      const info = await client.getCollection(COLLECTION_NAME);
+      const vectorConfig = info.config.params.vectors;
+
+      if ("size" in vectorConfig) {
+        if (vectorConfig.size !== VECTOR_SIZE) {
+          console.warn(
+            `  WARNING: Existing collection has different vector size: ${vectorConfig.size}`
+          );
+          console.warn(
+            `  Expected: ${VECTOR_SIZE}. You may need to recreate the collection.`
+          );
+        } else {
+          console.log(
+            `  Collection '${COLLECTION_NAME}' already exists with correct configuration`
+          );
+        }
+      }
+
+      return {
+        success: true,
+        message: `Collection '${COLLECTION_NAME}' already exists`,
+        collectionName: COLLECTION_NAME,
+        vectorSize: VECTOR_SIZE,
+      };
+    }
+
+    // Create new collection
+    console.log(`\nCreating collection '${COLLECTION_NAME}'...`);
+    await client.createCollection(COLLECTION_NAME, {
+      vectors: {
+        size: VECTOR_SIZE,
+        distance: "Cosine",
+      },
+      // Optimize for memory retrieval workload
+      optimizers_config: {
+        default_segment_number: 2,
+        indexing_threshold: 10000,
+      },
+      // Enable write-ahead logging for durability
+      wal_config: {
+        wal_capacity_mb: 32,
+        wal_segments_ahead: 0,
+      },
+    });
+
+    console.log(`  Collection created successfully`);
+
+    // Create payload indexes for common query patterns
+    console.log("\nCreating payload indexes...");
+
+    // Index for filtering by timestamp
+    await client.createPayloadIndex(COLLECTION_NAME, {
+      wait: true, // Wait for index creation to complete
+      field_name: "timestamp",
+      field_schema: "datetime",
+    });
+    console.log("  Created index: timestamp (datetime)");
+
+    // Index for filtering by source
+    await client.createPayloadIndex(COLLECTION_NAME, {
+      wait: true, // Wait for index creation to complete
+      field_name: "source",
+      field_schema: "keyword",
+    });
+    console.log("  Created index: source (keyword)");
+
+    // Index for filtering by type
+    await client.createPayloadIndex(COLLECTION_NAME, {
+      wait: true, // Wait for index creation to complete
+      field_name: "type",
+      field_schema: "keyword",
+    });
+    console.log("  Created index: type (keyword)");
+
+    // Verify collection was created
+    const verifyInfo = await client.getCollection(COLLECTION_NAME);
+    console.log("\nCollection verification:");
+    console.log(`  Status: ${verifyInfo.status}`);
+    console.log(`  Points: ${verifyInfo.points_count}`);
+    console.log(`  Indexed vectors: ${verifyInfo.indexed_vectors_count}`);
+
+    return {
+      success: true,
+      message: `Collection '${COLLECTION_NAME}' created successfully`,
+      collectionName: COLLECTION_NAME,
+      vectorSize: VECTOR_SIZE,
+    };
+  } catch (error) {
+    const errorMessage =
+      error instanceof Error ? error.message : String(error);
+    console.error(`\nError initializing Qdrant: ${errorMessage}`);
+
+    return {
+      success: false,
+      message: `Failed to initialize: ${errorMessage}`,
+      collectionName: COLLECTION_NAME,
+      vectorSize: VECTOR_SIZE,
+    };
+  }
+}
+
+// Run if executed directly
+const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+
+if (isMainModule) {
+  initializeQdrant()
+    .then((result) => {
+      console.log("\n" + "=".repeat(50));
+      if (result.success) {
+        console.log("Qdrant initialization completed successfully");
+        console.log(`  Collection: ${result.collectionName}`);
+        console.log(`  Vector size: ${result.vectorSize}`);
+        process.exit(0);
+      } else {
+        console.error("Qdrant initialization failed");
+        console.error(`  Error: ${result.message}`);
+        process.exit(1);
+      }
+    })
+    .catch((error) => {
+      console.error("Unexpected error:", error);
+      process.exit(1);
+    });
+}
+
+export { initializeQdrant, InitResult };