memory-journal-mcp 3.0.0

package/dist/utils/McpLogger.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Memory Journal MCP Server - MCP Protocol Logger
+ *
+ * Logging that sends structured messages via MCP notifications/message.
+ * Falls back to stderr when MCP server is not connected.
+ * Follows RFC 5424 severity levels as per MCP spec.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * MCP log levels per RFC 5424
+ */
+export type McpLogLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical' | 'alert' | 'emergency';
+interface LogData {
+    message: string;
+    module?: string;
+    operation?: string;
+    [key: string]: unknown;
+}
+/**
+ * MCP Protocol Logger
+ *
+ * Sends structured log messages via MCP notifications/message protocol.
+ * Falls back to stderr when server not connected.
+ */
+export declare class McpLogger {
+    private server;
+    private minLevel;
+    /**
+     * Connect to MCP server for protocol logging
+     */
+    setServer(server: McpServer): void;
+    /**
+     * Set minimum log level (from logging/setLevel request)
+     */
+    setLevel(level: McpLogLevel): void;
+    /**
+     * Get current minimum log level
+     */
+    getLevel(): McpLogLevel;
+    /**
+     * Check if a level should be logged
+     */
+    private shouldLog;
+    /**
+     * Format message for stderr fallback
+     */
+    private formatForStderr;
+    /**
+     * Send log message via MCP protocol or fallback to stderr
+     */
+    log(level: McpLogLevel, loggerName: string, data: LogData): void;
+    debug(loggerName: string, message: string, context?: Record<string, unknown>): void;
+    info(loggerName: string, message: string, context?: Record<string, unknown>): void;
+    notice(loggerName: string, message: string, context?: Record<string, unknown>): void;
+    warning(loggerName: string, message: string, context?: Record<string, unknown>): void;
+    error(loggerName: string, message: string, context?: Record<string, unknown>): void;
+    critical(loggerName: string, message: string, context?: Record<string, unknown>): void;
+}
+export declare const mcpLogger: McpLogger;
+export {};
+//# sourceMappingURL=McpLogger.d.ts.map

package/dist/utils/McpLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpLogger.d.ts","sourceRoot":"","sources":["../../src/utils/McpLogger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,WAAW,GACjB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,OAAO,GACP,WAAW,CAAC;AAalB,UAAU,OAAO;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAuB;IAEvC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAIlC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAMlC;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAsBhE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAInF,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIlF,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIpF,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIrF,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAInF,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGzF;AAGD,eAAO,MAAM,SAAS,WAAkB,CAAC"}

package/dist/utils/McpLogger.js

@@ -0,0 +1,113 @@
+/**
+ * Memory Journal MCP Server - MCP Protocol Logger
+ *
+ * Logging that sends structured messages via MCP notifications/message.
+ * Falls back to stderr when MCP server is not connected.
+ * Follows RFC 5424 severity levels as per MCP spec.
+ */
+const LOG_LEVEL_PRIORITY = {
+    emergency: 0,
+    alert: 1,
+    critical: 2,
+    error: 3,
+    warning: 4,
+    notice: 5,
+    info: 6,
+    debug: 7,
+};
+/**
+ * MCP Protocol Logger
+ *
+ * Sends structured log messages via MCP notifications/message protocol.
+ * Falls back to stderr when server not connected.
+ */
+export class McpLogger {
+    server = null;
+    minLevel = 'info';
+    /**
+     * Connect to MCP server for protocol logging
+     */
+    setServer(server) {
+        this.server = server;
+    }
+    /**
+     * Set minimum log level (from logging/setLevel request)
+     */
+    setLevel(level) {
+        if (level in LOG_LEVEL_PRIORITY) {
+            this.minLevel = level;
+        }
+    }
+    /**
+     * Get current minimum log level
+     */
+    getLevel() {
+        return this.minLevel;
+    }
+    /**
+     * Check if a level should be logged
+     */
+    shouldLog(level) {
+        return LOG_LEVEL_PRIORITY[level] <= LOG_LEVEL_PRIORITY[this.minLevel];
+    }
+    /**
+     * Format message for stderr fallback
+     */
+    formatForStderr(level, loggerName, data) {
+        const timestamp = new Date().toISOString();
+        const levelUpper = level.toUpperCase().padEnd(9);
+        const module = loggerName ? `[${loggerName}]` : '';
+        let formatted = `[${timestamp}] [${levelUpper}] ${module} ${data.message}`;
+        // Add extra context (filter out message and module)
+        const extras = Object.fromEntries(Object.entries(data).filter(([key]) => key !== 'message' && key !== 'module'));
+        if (Object.keys(extras).length > 0) {
+            formatted += ` ${JSON.stringify(extras)}`;
+        }
+        return formatted;
+    }
+    /**
+     * Send log message via MCP protocol or fallback to stderr
+     */
+    log(level, loggerName, data) {
+        if (!this.shouldLog(level))
+            return;
+        // Send via MCP protocol if server connected
+        if (this.server) {
+            try {
+                void this.server.sendLoggingMessage({
+                    level,
+                    logger: loggerName,
+                    data,
+                });
+            }
+            catch {
+                // Fallback to stderr if MCP send fails
+                console.error(this.formatForStderr(level, loggerName, data));
+            }
+        }
+        // Always also log to stderr for local debugging
+        console.error(this.formatForStderr(level, loggerName, data));
+    }
+    // Convenience methods
+    debug(loggerName, message, context) {
+        this.log('debug', loggerName, { message, ...context });
+    }
+    info(loggerName, message, context) {
+        this.log('info', loggerName, { message, ...context });
+    }
+    notice(loggerName, message, context) {
+        this.log('notice', loggerName, { message, ...context });
+    }
+    warning(loggerName, message, context) {
+        this.log('warning', loggerName, { message, ...context });
+    }
+    error(loggerName, message, context) {
+        this.log('error', loggerName, { message, ...context });
+    }
+    critical(loggerName, message, context) {
+        this.log('critical', loggerName, { message, ...context });
+    }
+}
+// Singleton instance
+export const mcpLogger = new McpLogger();
+//# sourceMappingURL=McpLogger.js.map

package/dist/utils/McpLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpLogger.js","sourceRoot":"","sources":["../../src/utils/McpLogger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,MAAM,kBAAkB,GAAgC;IACpD,SAAS,EAAE,CAAC;IACZ,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACX,CAAC;AASF;;;;;GAKG;AACH,MAAM,OAAO,SAAS;IACV,MAAM,GAAqB,IAAI,CAAC;IAChC,QAAQ,GAAgB,MAAM,CAAC;IAEvC;;OAEG;IACH,SAAS,CAAC,MAAiB;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAkB;QACvB,IAAI,KAAK,IAAI,kBAAkB,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QAC1B,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,KAAkB;QAChC,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,KAAkB,EAAE,UAAkB,EAAE,IAAa;QACzE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAEnD,IAAI,SAAS,GAAG,IAAI,SAAS,MAAM,UAAU,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAE3E,oDAAoD;QACpD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC7B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,QAAQ,CAAC,CAChF,CAAC;QAEF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,SAAS,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAkB,EAAE,UAAkB,EAAE,IAAa;QACrD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO;QAEnC,4CAA4C;QAC5C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,IAAI,CAAC;gBACD,KAAK,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;oBAChC,KAAK;oBACL,MAAM,EAAE,UAAU;oBAClB,IAAI;iBACP,CAAC,CAAC;YACP,CAAC;YAAC,MAAM,CAAC;gBACL,uCAAuC;gBACvC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;YACjE,CAAC;QACL,CAAC;QAED,gDAAgD;QAChD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,UAAkB,EAAE,OAAe,EAAE,OAAiC;QACxE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC,UAAkB,EAAE,OAAe,EAAE,OAAiC;QACvE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,UAAkB,EAAE,OAAe,EAAE,OAAiC;QACzE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,CAAC,UAAkB,EAAE,OAAe,EAAE,OAAiC;QAC1E,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,UAAkB,EAAE,OAAe,EAAE,OAAiC;QACxE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,QAAQ,CAAC,UAAkB,EAAE,OAAe,EAAE,OAAiC;QAC3E,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;CACJ;AAED,qBAAqB;AACrB,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Memory Journal MCP Server - Logger
+ *
+ * Centralized logging to stderr only (stdout reserved for MCP protocol).
+ * Follows RFC 5424 severity levels.
+ */
+type LogLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical';
+interface LogContext {
+    module?: string;
+    operation?: string;
+    entityId?: string | number;
+    [key: string]: unknown;
+}
+declare class Logger {
+    private minLevel;
+    constructor(level?: LogLevel);
+    private shouldLog;
+    private formatMessage;
+    private log;
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    notice(message: string, context?: LogContext): void;
+    warning(message: string, context?: LogContext): void;
+    error(message: string, context?: LogContext): void;
+    critical(message: string, context?: LogContext): void;
+    setLevel(level: LogLevel): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE/E,UAAU,UAAU;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAWD,cAAM,MAAM;IACR,OAAO,CAAC,QAAQ,CAAS;gBAEb,KAAK,GAAE,QAAiB;IAIpC,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,GAAG;IASX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAInD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIpD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIrD,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAGlC;AAKD,eAAO,MAAM,MAAM,QAAuB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,70 @@
+/**
+ * Memory Journal MCP Server - Logger
+ *
+ * Centralized logging to stderr only (stdout reserved for MCP protocol).
+ * Follows RFC 5424 severity levels.
+ */
+const LOG_LEVELS = {
+    debug: 7,
+    info: 6,
+    notice: 5,
+    warning: 4,
+    error: 3,
+    critical: 2,
+};
+class Logger {
+    minLevel;
+    constructor(level = 'info') {
+        this.minLevel = LOG_LEVELS[level];
+    }
+    shouldLog(level) {
+        return LOG_LEVELS[level] <= this.minLevel;
+    }
+    formatMessage(level, message, context) {
+        const timestamp = new Date().toISOString();
+        const levelUpper = level.toUpperCase().padEnd(8);
+        const module = context?.module ? `[${context.module}]` : '';
+        const operation = context?.operation ? `[${context.operation}]` : '';
+        let formatted = `[${timestamp}] [${levelUpper}] ${module}${operation} ${message}`;
+        // Add context as JSON if there are additional fields
+        const extras = { ...context };
+        delete extras.module;
+        delete extras.operation;
+        if (Object.keys(extras).length > 0) {
+            formatted += ` ${JSON.stringify(extras)}`;
+        }
+        return formatted;
+    }
+    log(level, message, context) {
+        if (!this.shouldLog(level))
+            return;
+        const formatted = this.formatMessage(level, message, context);
+        // Always write to stderr (stdout is reserved for MCP protocol)
+        console.error(formatted);
+    }
+    debug(message, context) {
+        this.log('debug', message, context);
+    }
+    info(message, context) {
+        this.log('info', message, context);
+    }
+    notice(message, context) {
+        this.log('notice', message, context);
+    }
+    warning(message, context) {
+        this.log('warning', message, context);
+    }
+    error(message, context) {
+        this.log('error', message, context);
+    }
+    critical(message, context) {
+        this.log('critical', message, context);
+    }
+    setLevel(level) {
+        this.minLevel = LOG_LEVELS[level];
+    }
+}
+// Get log level from environment
+const envLevel = (process.env['LOG_LEVEL'] ?? 'info');
+export const logger = new Logger(envLevel);
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/vector/VectorSearchManager.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Memory Journal MCP Server - Vector Search Manager
+ *
+ * Semantic search using @xenova/transformers for embeddings
+ * and vectra for vector indexing.
+ */
+import type { SqliteAdapter } from '../database/SqliteAdapter.js';
+import type { JournalEntry } from '../types/index.js';
+/** Search result with similarity score */
+export interface SemanticSearchResult {
+    entryId: number;
+    score: number;
+    entry?: JournalEntry;
+}
+/**
+ * VectorSearchManager - Handles semantic search with local embeddings
+ */
+export declare class VectorSearchManager {
+    private embedder;
+    private index;
+    private readonly indexPath;
+    private readonly modelName;
+    private initialized;
+    private initializing;
+    constructor(dbPath: string, modelName?: string);
+    /**
+     * Check if vector search is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Initialize the vector search manager (lazy loading)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Generate embedding for text
+     */
+    generateEmbedding(text: string): Promise<number[]>;
+    /**
+     * Add an entry to the vector index (upsert - replaces if exists)
+     */
+    addEntry(entryId: number, content: string): Promise<boolean>;
+    /**
+     * Perform semantic search
+     */
+    search(query: string, limit?: number, similarityThreshold?: number): Promise<SemanticSearchResult[]>;
+    /**
+     * Remove an entry from the vector index
+     */
+    removeEntry(entryId: number): Promise<boolean>;
+    /**
+     * Rebuild index from database entries
+     */
+    rebuildIndex(db: SqliteAdapter): Promise<number>;
+    /**
+     * Get index statistics
+     */
+    getStats(): Promise<{
+        itemCount: number;
+        modelName: string;
+        dimensions: number;
+    }>;
+}
+//# sourceMappingURL=VectorSearchManager.d.ts.map

package/dist/vector/VectorSearchManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorSearchManager.d.ts","sourceRoot":"","sources":["../../src/vector/VectorSearchManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQtD,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAwF;IACxG,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,MAAM,EAAE,SAAS,SAAgB;IAOrD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2CjC;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiBxD;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2ClE;;OAEG;IACG,MAAM,CACR,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,EACV,mBAAmB,SAAM,GAC1B,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAmClC;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYpD;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BtD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAgB1F"}

package/dist/vector/VectorSearchManager.js

@@ -0,0 +1,235 @@
+/**
+ * Memory Journal MCP Server - Vector Search Manager
+ *
+ * Semantic search using @xenova/transformers for embeddings
+ * and vectra for vector indexing.
+ */
+import { pipeline } from '@xenova/transformers';
+import { LocalIndex } from 'vectra';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { logger } from '../utils/logger.js';
+/** Default model for embeddings (same as Python version) */
+const DEFAULT_MODEL = 'Xenova/all-MiniLM-L6-v2';
+/** Embedding dimensions for all-MiniLM-L6-v2 */
+const EMBEDDING_DIMENSIONS = 384;
+/**
+ * VectorSearchManager - Handles semantic search with local embeddings
+ */
+export class VectorSearchManager {
+    // Use a more flexible type since FeatureExtractionPipeline doesn't fully implement Pipeline
+    embedder = null;
+    index = null;
+    indexPath;
+    modelName;
+    initialized = false;
+    initializing = false;
+    constructor(dbPath, modelName = DEFAULT_MODEL) {
+        // Store index in same directory as database
+        const dbDir = path.dirname(dbPath);
+        this.indexPath = path.join(dbDir, '.vectra_index');
+        this.modelName = modelName;
+    }
+    /**
+     * Check if vector search is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Initialize the vector search manager (lazy loading)
+     */
+    async initialize() {
+        if (this.initialized || this.initializing)
+            return;
+        this.initializing = true;
+        try {
+            logger.info('Initializing vector search...', { module: 'VectorSearch' });
+            // Load embedding model (downloads on first use, ~23MB)
+            logger.info(`Loading embedding model: ${this.modelName}`, { module: 'VectorSearch' });
+            this.embedder = await pipeline('feature-extraction', this.modelName, {
+                quantized: true, // Use quantized model for faster inference
+            });
+            logger.info('Embedding model loaded', { module: 'VectorSearch' });
+            // Create or load vectra index
+            if (!fs.existsSync(this.indexPath)) {
+                fs.mkdirSync(this.indexPath, { recursive: true });
+            }
+            this.index = new LocalIndex(this.indexPath);
+            // Check if index exists
+            if (!await this.index.isIndexCreated()) {
+                await this.index.createIndex();
+                logger.info('Created new vector index', { module: 'VectorSearch' });
+            }
+            else {
+                logger.info('Loaded existing vector index', { module: 'VectorSearch' });
+            }
+            this.initialized = true;
+            this.initializing = false;
+            logger.info('Vector search initialized successfully', { module: 'VectorSearch' });
+        }
+        catch (error) {
+            this.initializing = false;
+            logger.error('Failed to initialize vector search', {
+                module: 'VectorSearch',
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+    /**
+     * Generate embedding for text
+     */
+    async generateEmbedding(text) {
+        if (!this.embedder) {
+            throw new Error('Vector search not initialized');
+        }
+        // Generate embedding using feature-extraction pipeline
+        // The pipeline returns a Tensor with a data property containing the embeddings
+        const output = await this.embedder(text, {
+            pooling: 'mean',
+            normalize: true,
+        });
+        // Convert to number array
+        const embedding = Array.from(output.data);
+        return embedding;
+    }
+    /**
+     * Add an entry to the vector index (upsert - replaces if exists)
+     */
+    async addEntry(entryId, content) {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        if (!this.index) {
+            return false;
+        }
+        try {
+            // Delete existing item first to support upsert behavior
+            try {
+                await this.index.deleteItem(String(entryId));
+            }
+            catch {
+                // Item may not exist, ignore
+            }
+            // Generate embedding
+            const embedding = await this.generateEmbedding(content);
+            // Add to vectra index with entry ID as metadata
+            await this.index.insertItem({
+                id: String(entryId),
+                vector: embedding,
+                metadata: { entryId, contentPreview: content.slice(0, 100) }
+            });
+            logger.debug('Added entry to vector index', {
+                module: 'VectorSearch',
+                entityId: entryId
+            });
+            return true;
+        }
+        catch (error) {
+            logger.error('Failed to add entry to vector index', {
+                module: 'VectorSearch',
+                entityId: entryId,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return false;
+        }
+    }
+    /**
+     * Perform semantic search
+     */
+    async search(query, limit = 10, similarityThreshold = 0.3) {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        if (!this.index) {
+            return [];
+        }
+        try {
+            // Generate query embedding
+            const queryEmbedding = await this.generateEmbedding(query);
+            // Search vectra index
+            const results = await this.index.queryItems(queryEmbedding, limit * 2);
+            // Filter by threshold and map to our format
+            const filteredResults = results
+                .filter(r => r.score >= similarityThreshold)
+                .slice(0, limit)
+                .map(r => ({
+                entryId: r.item.metadata.entryId,
+                score: r.score
+            }));
+            return filteredResults;
+        }
+        catch (error) {
+            logger.error('Semantic search failed', {
+                module: 'VectorSearch',
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return [];
+        }
+    }
+    /**
+     * Remove an entry from the vector index
+     */
+    async removeEntry(entryId) {
+        if (!this.index)
+            return false;
+        try {
+            await this.index.deleteItem(String(entryId));
+            return true;
+        }
+        catch {
+            // Item might not exist in index
+            return false;
+        }
+    }
+    /**
+     * Rebuild index from database entries
+     */
+    async rebuildIndex(db) {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        if (!this.index) {
+            return 0;
+        }
+        logger.info('Rebuilding vector index from database...', { module: 'VectorSearch' });
+        // Get all entries
+        const entries = db.getRecentEntries(10000); // Get up to 10k entries
+        let indexed = 0;
+        for (const entry of entries) {
+            // Delete existing item first to avoid "already exists" error
+            try {
+                await this.index.deleteItem(String(entry.id));
+            }
+            catch {
+                // Item may not exist, ignore
+            }
+            const success = await this.addEntry(entry.id, entry.content);
+            if (success)
+                indexed++;
+        }
+        logger.info(`Rebuilt vector index with ${String(indexed)} entries`, { module: 'VectorSearch' });
+        return indexed;
+    }
+    /**
+     * Get index statistics
+     */
+    async getStats() {
+        if (!this.index) {
+            return { itemCount: 0, modelName: this.modelName, dimensions: EMBEDDING_DIMENSIONS };
+        }
+        try {
+            const items = await this.index.listItems();
+            return {
+                itemCount: items.length,
+                modelName: this.modelName,
+                dimensions: EMBEDDING_DIMENSIONS
+            };
+        }
+        catch {
+            return { itemCount: 0, modelName: this.modelName, dimensions: EMBEDDING_DIMENSIONS };
+        }
+    }
+}
+//# sourceMappingURL=VectorSearchManager.js.map

package/dist/vector/VectorSearchManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorSearchManager.js","sourceRoot":"","sources":["../../src/vector/VectorSearchManager.ts"],"names":[],"mappings":"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"}

package/docker-compose.yml

@@ -0,0 +1,37 @@
+version: '3.8'
+
+services:
+  memory-journal-mcp:
+    build: .
+    container_name: memory-journal-mcp
+    volumes:
+      # Mount local data directory for persistent SQLite database
+      - ./data:/app/data
+      # Mount git config for context bundle functionality
+      - ${HOME}/.gitconfig:/root/.gitconfig:ro
+      # Mount SSH keys for GitHub access (optional)
+      - ${HOME}/.ssh:/root/.ssh:ro
+    environment:
+      - DB_PATH=/app/data/memory_journal.db
+      - PYTHONPATH=/app
+    stdin_open: true
+    tty: true
+    # For MCP stdio communication
+    command: python src/server.py
+    restart: unless-stopped
+
+  # Alternative service for testing without git/ssh mounts
+  memory-journal-mcp-basic:
+    build: .
+    container_name: memory-journal-mcp-basic
+    volumes:
+      - ./data:/app/data
+    environment:
+      - DB_PATH=/app/data/memory_journal.db
+      - PYTHONPATH=/app
+    stdin_open: true
+    tty: true
+    command: python src/server.py
+    restart: unless-stopped
+    profiles:
+      - basic