doc2vec 1.1.1 → 1.2.0

package/logger.ts

@@ -1,287 +0,0 @@
-/**
- * Enhanced Logger for structured and consistent logging
- * Compatible with CommonJS and ESM environments
- */
-
-/**
- * Logger levels with their corresponding numeric values
- */
-enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3,
-    NONE = 100
-  }
-  
-  /**
-   * Configuration options for the Logger
-   */
-  interface LoggerConfig {
-    level: LogLevel;
-    useTimestamp: boolean;
-    useColor: boolean;
-    logToFile?: string;
-    prettyPrint?: boolean;
-  }
-  
-  /**
-   * Basic color functions that don't rely on external packages
-   */
-  const colors = {
-    gray: (text: string) => `\x1b[90m${text}\x1b[0m`,
-    blue: (text: string) => `\x1b[34m${text}\x1b[0m`,
-    yellow: (text: string) => `\x1b[33m${text}\x1b[0m`,
-    red: (text: string) => `\x1b[31m${text}\x1b[0m`,
-    green: (text: string) => `\x1b[32m${text}\x1b[0m`,
-    reset: (text: string) => `\x1b[0m${text}\x1b[0m`
-  };
-  
-  /**
-   * Enhanced Logger class with color-coding, timestamp, and formatting
-   */
-  class Logger {
-    private config: LoggerConfig;
-    private moduleName: string;
-  
-    /**
-     * Create a new Logger instance
-     * 
-     * @param moduleName Name of the module using this logger
-     * @param config Logger configuration options
-     */
-    constructor(moduleName: string, config?: Partial<LoggerConfig>) {
-      this.moduleName = moduleName;
-      this.config = {
-        level: LogLevel.INFO,
-        useTimestamp: true,
-        useColor: true,
-        prettyPrint: true,
-        ...config
-      };
-    }
-  
-    /**
-     * Format a log message with timestamp, level, and module information
-     * 
-     * @param level Log level for this message
-     * @param message The message to log
-     * @param args Additional arguments to include
-     * @returns Formatted log message
-     */
-    private formatMessage(level: string, message: string, args: any[] = []): string {
-      const timestamp = this.config.useTimestamp ? 
-        `[${new Date().toISOString()}] ` : '';
-      
-      const modulePrefix = this.moduleName ? 
-        `[${this.moduleName}] ` : '';
-      
-      const levelFormatted = `[${level.padEnd(5)}]`;
-      
-      let formattedMessage = `${timestamp}${levelFormatted} ${modulePrefix}${message}`;
-  
-      if (args.length > 0) {
-        const argsString = args.map(arg => {
-          if (arg instanceof Error) {
-            return `\n--- Error Details ---\nMessage: ${arg.message}\nStack:\n${arg.stack}\n--- End Error ---`;
-          } 
-          else if (this.config.prettyPrint && typeof arg === 'object' && arg !== null) {
-            try {
-              return JSON.stringify(arg, null, 2);
-            } catch (e) {
-              return "[Unserializable Object]"; 
-            }
-          } else {
-            return String(arg); 
-          }
-        }).join('\n');
-  
-        if (this.config.prettyPrint) {
-           formattedMessage += `\n${argsString}`; 
-        } else {
-           formattedMessage += ` ${args.map(String).join(' ')}`;
-        }
-      }
-      
-      return formattedMessage;
-    }
-  
-    /**
-     * Apply color to a message based on log level
-     * 
-     * @param level Log level
-     * @param message Message to color
-     * @returns Colored message
-     */
-    private colorize(level: LogLevel, message: string): string {
-      if (!this.config.useColor) return message;
-      
-      switch (level) {
-        case LogLevel.DEBUG:
-          return colors.gray(message);
-        case LogLevel.INFO:
-          return colors.blue(message);
-        case LogLevel.WARN:
-          return colors.yellow(message);
-        case LogLevel.ERROR:
-          return colors.red(message);
-        default:
-          return message;
-      }
-    }
-  
-    /**
-     * Log a debug message
-     * 
-     * @param message Message to log
-     * @param args Additional arguments
-     */
-    debug(message: string, ...args: any[]): void {
-      if (this.config.level <= LogLevel.DEBUG) {
-        const formattedMessage = this.formatMessage('DEBUG', message, args);
-        console.log(this.colorize(LogLevel.DEBUG, formattedMessage));
-      }
-    }
-  
-    /**
-     * Log an info message
-     * 
-     * @param message Message to log
-     * @param args Additional arguments
-     */
-    info(message: string, ...args: any[]): void {
-      if (this.config.level <= LogLevel.INFO) {
-        const formattedMessage = this.formatMessage('INFO', message, args);
-        console.log(this.colorize(LogLevel.INFO, formattedMessage));
-      }
-    }
-  
-    /**
-     * Log a warning message
-     * 
-     * @param message Message to log
-     * @param args Additional arguments
-     */
-    warn(message: string, ...args: any[]): void {
-      if (this.config.level <= LogLevel.WARN) {
-        const formattedMessage = this.formatMessage('WARN', message, args);
-        console.warn(this.colorize(LogLevel.WARN, formattedMessage));
-      }
-    }
-  
-    /**
-     * Log an error message
-     * 
-     * @param message Message to log
-     * @param args Additional arguments
-     */
-    error(message: string, ...args: any[]): void {
-      if (this.config.level <= LogLevel.ERROR) {
-        const formattedMessage = this.formatMessage('ERROR', message, args);
-        console.error(this.colorize(LogLevel.ERROR, formattedMessage));
-      }
-    }
-  
-    /**
-     * Create a child logger with a more specific module name
-     * 
-     * @param subModule Name of the sub-module
-     * @returns New logger instance
-     */
-    child(subModule: string): Logger {
-      return new Logger(`${this.moduleName}:${subModule}`, this.config);
-    }
-  
-    /**
-     * Format a section header to clearly separate logical parts of execution
-     * 
-     * @param title Section title
-     * @returns Logger instance for chaining
-     */
-    section(title: string): Logger {
-      if (this.config.level <= LogLevel.INFO) {
-        const separator = '='.repeat(Math.max(80 - title.length - 4, 10));
-        const message = `${separator} ${title} ${separator}`;
-        console.log(this.colorize(LogLevel.INFO, message));
-      }
-      return this;
-    }
-  
-    /**
-     * Create a progress indicator
-     * 
-     * @param title Title of the operation
-     * @param total Total number of items to process
-     * @returns Object with update and complete methods
-     */
-    progress(title: string, total: number) {
-      let current = 0;
-      const startTime = Date.now();
-      
-      const update = (increment = 1, message?: string) => {
-        if (this.config.level > LogLevel.INFO) return;
-        
-        current += increment;
-        const percentage = Math.min(Math.floor((current / total) * 100), 100);
-        const elapsed = (Date.now() - startTime) / 1000;
-        let rate = current / elapsed;
-        
-        let timeRemaining = '';
-        if (rate > 0 && current < total) {
-          const remainingSecs = (total - current) / rate;
-          timeRemaining = `, ETA: ${Math.floor(remainingSecs / 60)}m ${Math.floor(remainingSecs % 60)}s`;
-        }
-        
-        const progressBar = this.createProgressBar(percentage);
-        
-        const statusMsg = message ? ` - ${message}` : '';
-        console.log(this.colorize(
-          LogLevel.INFO, 
-          this.formatMessage('INFO', `${title}: ${progressBar} ${percentage}% (${current}/${total}${timeRemaining})${statusMsg}`)
-        ));
-      };
-      
-      const complete = (message = 'Completed') => {
-        if (this.config.level > LogLevel.INFO) return;
-        
-        const elapsed = (Date.now() - startTime) / 1000;
-        const rate = total / elapsed;
-        
-        console.log(this.colorize(
-          LogLevel.INFO,
-          this.formatMessage('INFO', `${title}: ${this.createProgressBar(100)} 100% (${total}/${total}) - ${message} in ${elapsed.toFixed(2)}s (${rate.toFixed(2)} items/sec)`)
-        ));
-      };
-      
-      return { update, complete };
-    }
-  
-    /**
-     * Create a visual progress bar
-     * 
-     * @param percentage Completion percentage
-     * @returns Visual progress bar
-     */
-    private createProgressBar(percentage: number): string {
-      const width = 20;
-      const completeChars = Math.floor((percentage / 100) * width);
-      const incompleteChars = width - completeChars;
-      
-      let bar = '[';
-      if (this.config.useColor) {
-        bar += colors.green('='.repeat(completeChars));
-        bar += ' '.repeat(incompleteChars);
-      } else {
-        bar += '='.repeat(completeChars);
-        bar += ' '.repeat(incompleteChars);
-      }
-      bar += ']';
-      
-      return bar;
-    }
-  }
-  
-  // Create a default logger instance
-  const defaultLogger = new Logger('app');
-  
-  export { Logger, LogLevel, defaultLogger };

package/mcp/Dockerfile

@@ -1,14 +0,0 @@
-FROM node:20-slim AS base
-
-# Copy project files
-COPY package.json /usr/src/app/
-COPY package-lock.json /usr/src/app/
-COPY tsconfig.json /usr/src/app/
-COPY src/index.ts /usr/src/app/src/
-COPY *.db /data/
-WORKDIR /usr/src/app
-
-RUN npm install
-RUN npm run build
-
-ENTRYPOINT ["node", "build/index.js"]

package/mcp/README.md

@@ -1,166 +0,0 @@
-# SQLite Vector Documentation Query MCP Server
-
-This is a Model Context Protocol (MCP) server that enables querying documentation stored in SQLite databases with vector embeddings. The server uses OpenAI's embedding API to convert natural language queries into vector embeddings and performs semantic search against documentation stored in SQLite databases.
-
-## Features
-
-- Vector-based semantic search for documentation
-- Filters by product name and version
-- Uses OpenAI's embedding API for query embedding generation
-- Fully compatible with the Model Context Protocol
-- Simple Express-based API with Server-Sent Events (SSE) for real-time communication
-
-## Prerequisites
-
-- Node.js 20 or higher
-- OpenAI API key
-- Documentation stored in SQLite vector databases (using `sqlite-vec`)
-
-## Environment Variables
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `OPENAI_API_KEY` | Your OpenAI API key (required) | - |
-| `SQLITE_DB_DIR` | Directory containing SQLite databases | Current directory |
-| `PORT` | Port to run the server on | 3001 |
-
-## Local Setup and Running
-
-1. Install dependencies:
-   ```bash
-   npm install
-   ```
-
-2. Create a `.env` file with required environment variables:
-   ```
-   OPENAI_API_KEY=your_openai_api_key
-   SQLITE_DB_DIR=/path/to/databases
-   PORT=3001
-   ```
-
-3. Build the TypeScript code:
-   ```bash
-   npm run build
-   ```
-
-4. Start the server:
-   ```bash
-   npm start
-   ```
-
-## Docker Setup
-
-### Building the Docker Image
-
-```bash
-docker build -t sqlite-vec-mcp-server:latest .
-```
-
-This is going to include any `*.db` files in the `/data` directory of the image.
-
-### Running with Docker
-
-```bash
-docker run -p 3001:3001 \
-  -e OPENAI_API_KEY=your_openai_api_key \
-  sqlite-vec-mcp-server:latest
-```
-
-### Create a Secret for the OpenAI API Key
-
-```bash
-kubectl create secret generic mcp-secrets \
-  --from-literal=OPENAI_API_KEY=your_openai_api_key
-```
-
-### Create a ConfigMap for Database Configuration
-
-```bash
-kubectl create configmap mcp-config \
-  --from-literal=SQLITE_DB_DIR=/data \
-  --from-literal=PORT=3001
-```
-
-### Create a Deployment
-
-Create a file named `deployment.yaml`:
-
-```yaml
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: mcp-sqlite-vec
-  labels:
-    app: mcp-sqlite-vec
-spec:
-  replicas: 1
-  selector:
-    matchLabels:
-      app: mcp-sqlite-vec
-  template:
-    metadata:
-      labels:
-        app: mcp-sqlite-vec
-    spec:
-      containers:
-      - name: mcp-sqlite-vec
-        image: sqlite-vec-mcp-server:latest
-        imagePullPolicy: Always
-        ports:
-        - containerPort: 3001
-        env:
-        - name: OPENAI_API_KEY
-          valueFrom:
-            secretKeyRef:
-              name: mcp-secrets
-              key: OPENAI_API_KEY
-        - name: SQLITE_DB_DIR
-          valueFrom:
-            configMapKeyRef:
-              name: mcp-config
-              key: SQLITE_DB_DIR
-        - name: PORT
-          valueFrom:
-            configMapKeyRef:
-              name: mcp-config
-              key: PORT
-```
-
-Apply it:
-```bash
-kubectl apply -f deployment.yaml
-```
-
-### Create a Service
-
-Create a file named `service.yaml`:
-
-```yaml
-apiVersion: v1
-kind: Service
-metadata:
-  name: mcp-sqlite-vec
-spec:
-  selector:
-    app: mcp-sqlite-vec
-  ports:
-  - port: 3001
-    targetPort: 3001
-  type: ClusterIP
-```
-
-Apply it:
-```bash
-kubectl apply -f service.yaml
-```
-
-## Using the MCP Server
-
-The server implements a tool called `query-documentation` that can be used to query documentation.
-
-### Tool Parameters
-
-- `queryText` (string, required): The natural language query to search for
-- `productName` (string, required): The name of the product documentation database to search within
-- `version` (string, optional): The specific version of the product documentation
-- `limit` (number, optional, default: 4): Maximum number of results to return