causantic 0.2.0

package/dist/maintenance/tasks/vacuum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vacuum.js","sourceRoot":"","sources":["../../../src/maintenance/tasks/vacuum.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAgB;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACxB,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAElB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAChC,OAAO,EAAE,gCAAgC;SAC1C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAChC,OAAO,EAAE,kBAAmB,KAAe,CAAC,OAAO,EAAE;SACtD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP server exports.
+ */
+export { McpServer, startMcpServer } from './server.js';
+export { tools, getTool, recallTool, explainTool, predictTool } from './tools.js';
+export type { ToolDefinition } from './tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,8 @@
+/**
+ * MCP server exports.
+ */
+// Server
+export { McpServer, startMcpServer } from './server.js';
+// Tools
+export { tools, getTool, recallTool, explainTool, predictTool } from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExD,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,90 @@
+/**
+ * MCP (Model Context Protocol) server for memory tools.
+ * Provides recall, explain, and predict tools for Claude Code integration.
+ *
+ * Features:
+ * - Health check endpoint (ping)
+ * - Structured JSON logging
+ * - Graceful shutdown handling
+ * - Standardized error responses
+ * - Optional token-based authentication
+ */
+/** MCP Server configuration */
+export interface McpServerConfig {
+    /** Enable structured JSON logging */
+    enableLogging?: boolean;
+    /** Log level: 'debug' | 'info' | 'warn' | 'error' */
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    /** Authentication token (if set, requires Authorization header) */
+    authToken?: string;
+    /** Enable health check endpoint */
+    enableHealthCheck?: boolean;
+}
+/**
+ * Handle MCP requests via JSON-RPC over stdio.
+ */
+export declare class McpServer {
+    private running;
+    private startTime;
+    private config;
+    private requestCount;
+    private errorCount;
+    constructor(config?: McpServerConfig);
+    /**
+     * Log a structured message.
+     */
+    private log;
+    /**
+     * Start the MCP server.
+     */
+    start(): Promise<void>;
+    /**
+     * Set up graceful shutdown signal handlers.
+     */
+    private setupShutdownHandlers;
+    /**
+     * Stop the MCP server gracefully.
+     */
+    stop(): Promise<void>;
+    /**
+     * Check authentication if configured.
+     */
+    private checkAuth;
+    /**
+     * Handle a single MCP request.
+     */
+    private handleRequest;
+    /**
+     * Handle ping request (simple health check).
+     */
+    private handlePing;
+    /**
+     * Handle detailed health check request.
+     */
+    private handleHealth;
+    /**
+     * Handle initialize request.
+     */
+    private handleInitialize;
+    /**
+     * Handle tools/list request.
+     */
+    private handleToolsList;
+    /**
+     * Handle tools/call request.
+     */
+    private handleToolsCall;
+    /**
+     * Get server statistics.
+     */
+    getStats(): {
+        requestCount: number;
+        errorCount: number;
+        uptime: number;
+    };
+}
+/**
+ * Create and start the MCP server.
+ */
+export declare function startMcpServer(config?: McpServerConfig): Promise<McpServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAmFD;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAK;gBAEX,MAAM,GAAE,eAAoB;IASxC;;OAEG;IACH,OAAO,CAAC,GAAG;IAkBX;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuE5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3B;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;YACW,aAAa;IAoD3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;YACW,YAAY;IAsD1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;YACW,eAAe;IAwD7B;;OAEG;IACH,QAAQ,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAOzE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAIjF"}

package/dist/mcp/server.js

@@ -0,0 +1,395 @@
+/**
+ * MCP (Model Context Protocol) server for memory tools.
+ * Provides recall, explain, and predict tools for Claude Code integration.
+ *
+ * Features:
+ * - Health check endpoint (ping)
+ * - Structured JSON logging
+ * - Graceful shutdown handling
+ * - Standardized error responses
+ * - Optional token-based authentication
+ */
+import { createInterface } from 'readline';
+import { tools, getTool } from './tools.js';
+import { getDb, closeDb } from '../storage/db.js';
+import { disposeRetrieval } from '../retrieval/context-assembler.js';
+import { initStartupPrune } from '../storage/pruner.js';
+import { getChunkCount } from '../storage/chunk-store.js';
+import { getEdgeCount } from '../storage/edge-store.js';
+import { getClusterCount } from '../storage/cluster-store.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('mcp-server');
+/** Standard error codes */
+const ErrorCodes = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    UNAUTHORIZED: -32001,
+    TOOL_ERROR: -32002,
+};
+/**
+ * Create a standardized error response.
+ */
+function createErrorResponse(id, code, message, data) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        error: { code, message, data },
+    };
+}
+/**
+ * Handle MCP requests via JSON-RPC over stdio.
+ */
+export class McpServer {
+    running = false;
+    startTime = 0;
+    config;
+    requestCount = 0;
+    errorCount = 0;
+    constructor(config = {}) {
+        this.config = {
+            enableLogging: config.enableLogging ?? (process.env.CAUSANTIC_MCP_LOGGING === 'true'),
+            logLevel: config.logLevel ?? process.env.CAUSANTIC_MCP_LOG_LEVEL ?? 'info',
+            authToken: config.authToken ?? process.env.CAUSANTIC_MCP_AUTH_TOKEN ?? '',
+            enableHealthCheck: config.enableHealthCheck ?? true,
+        };
+    }
+    /**
+     * Log a structured message.
+     */
+    log(entry) {
+        if (!this.config.enableLogging)
+            return;
+        const levels = ['debug', 'info', 'warn', 'error'];
+        const configLevel = levels.indexOf(this.config.logLevel);
+        const entryLevel = levels.indexOf(entry.level);
+        if (entryLevel < configLevel)
+            return;
+        const logEntry = {
+            timestamp: new Date().toISOString(),
+            ...entry,
+        };
+        // Write to stderr to avoid interfering with stdio protocol
+        process.stderr.write(JSON.stringify(logEntry) + '\n');
+    }
+    /**
+     * Start the MCP server.
+     */
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.startTime = Date.now();
+        // Initialize database
+        getDb();
+        // Start background pruning (non-blocking)
+        initStartupPrune();
+        this.log({ level: 'info', event: 'server_started' });
+        // Set up graceful shutdown handlers
+        this.setupShutdownHandlers();
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: false,
+        });
+        rl.on('line', async (line) => {
+            const startTime = Date.now();
+            this.requestCount++;
+            try {
+                const request = JSON.parse(line);
+                this.log({
+                    level: 'debug',
+                    event: 'request_received',
+                    requestId: request.id,
+                    method: request.method,
+                });
+                const response = await this.handleRequest(request);
+                console.log(JSON.stringify(response));
+                this.log({
+                    level: 'debug',
+                    event: 'request_completed',
+                    requestId: request.id,
+                    method: request.method,
+                    durationMs: Date.now() - startTime,
+                });
+            }
+            catch (error) {
+                this.errorCount++;
+                const errorResponse = createErrorResponse(0, ErrorCodes.PARSE_ERROR, 'Parse error', error instanceof Error ? error.message : String(error));
+                console.log(JSON.stringify(errorResponse));
+                this.log({
+                    level: 'error',
+                    event: 'parse_error',
+                    error: error instanceof Error ? error.message : String(error),
+                    durationMs: Date.now() - startTime,
+                });
+            }
+        });
+        rl.on('close', () => {
+            this.log({ level: 'info', event: 'stdin_closed' });
+            this.stop();
+        });
+    }
+    /**
+     * Set up graceful shutdown signal handlers.
+     */
+    setupShutdownHandlers() {
+        const shutdown = async (signal) => {
+            this.log({ level: 'info', event: 'shutdown_signal', details: { signal } });
+            await this.stop();
+            process.exit(0);
+        };
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        process.on('SIGHUP', () => shutdown('SIGHUP'));
+    }
+    /**
+     * Stop the MCP server gracefully.
+     */
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        this.log({
+            level: 'info',
+            event: 'server_stopping',
+            details: {
+                uptime: Date.now() - this.startTime,
+                requestCount: this.requestCount,
+                errorCount: this.errorCount,
+            },
+        });
+        try {
+            await disposeRetrieval();
+            closeDb();
+            this.log({ level: 'info', event: 'server_stopped' });
+        }
+        catch (error) {
+            this.log({
+                level: 'error',
+                event: 'shutdown_error',
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Check authentication if configured.
+     */
+    checkAuth(params) {
+        if (!this.config.authToken)
+            return true;
+        const token = params?._auth;
+        return token === this.config.authToken;
+    }
+    /**
+     * Handle a single MCP request.
+     */
+    async handleRequest(request) {
+        const { id, method, params } = request;
+        // Check authentication for non-system methods
+        if (method !== 'initialize' && !this.checkAuth(params)) {
+            this.log({ level: 'warn', event: 'auth_failed', requestId: id, method });
+            return createErrorResponse(id, ErrorCodes.UNAUTHORIZED, 'Unauthorized');
+        }
+        try {
+            switch (method) {
+                case 'initialize':
+                    return this.handleInitialize(id);
+                case 'tools/list':
+                    return this.handleToolsList(id);
+                case 'tools/call':
+                    return await this.handleToolsCall(id, params);
+                case 'ping':
+                    return this.handlePing(id);
+                case 'health':
+                    return await this.handleHealth(id);
+                case 'shutdown':
+                    await this.stop();
+                    return { jsonrpc: '2.0', id, result: null };
+                default:
+                    return createErrorResponse(id, ErrorCodes.METHOD_NOT_FOUND, `Method not found: ${method}`);
+            }
+        }
+        catch (error) {
+            this.errorCount++;
+            this.log({
+                level: 'error',
+                event: 'request_error',
+                requestId: id,
+                method,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return createErrorResponse(id, ErrorCodes.INTERNAL_ERROR, 'Internal error', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Handle ping request (simple health check).
+     */
+    handlePing(id) {
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: { pong: true, timestamp: Date.now() },
+        };
+    }
+    /**
+     * Handle detailed health check request.
+     */
+    async handleHealth(id) {
+        if (!this.config.enableHealthCheck) {
+            return createErrorResponse(id, ErrorCodes.METHOD_NOT_FOUND, 'Health check disabled');
+        }
+        let dbOk = false;
+        let vectorOk = false;
+        let chunks = 0;
+        let edges = 0;
+        let clusters = 0;
+        try {
+            const db = getDb();
+            db.prepare('SELECT 1').get();
+            dbOk = true;
+            chunks = getChunkCount();
+            edges = getEdgeCount();
+            clusters = getClusterCount();
+        }
+        catch {
+            dbOk = false;
+        }
+        try {
+            // Vector store health check
+            const { vectorStore } = await import('../storage/vector-store.js');
+            if (vectorStore) {
+                vectorOk = true;
+            }
+        }
+        catch {
+            vectorOk = false;
+        }
+        const status = {
+            status: dbOk && vectorOk ? 'healthy' : dbOk ? 'degraded' : 'unhealthy',
+            version: '0.2.0',
+            uptime: Date.now() - this.startTime,
+            checks: {
+                database: dbOk,
+                vectorStore: vectorOk,
+            },
+            stats: {
+                chunks,
+                edges,
+                clusters,
+            },
+        };
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: status,
+        };
+    }
+    /**
+     * Handle initialize request.
+     */
+    handleInitialize(id) {
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: {
+                protocolVersion: '2024-11-05',
+                capabilities: {
+                    tools: {},
+                },
+                serverInfo: {
+                    name: 'causantic',
+                    version: '0.2.0',
+                },
+            },
+        };
+    }
+    /**
+     * Handle tools/list request.
+     */
+    handleToolsList(id) {
+        const toolList = tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        }));
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: { tools: toolList },
+        };
+    }
+    /**
+     * Handle tools/call request.
+     */
+    async handleToolsCall(id, params) {
+        const { name, arguments: args } = params;
+        const tool = getTool(name);
+        if (!tool) {
+            return createErrorResponse(id, ErrorCodes.INVALID_PARAMS, `Unknown tool: ${name}`);
+        }
+        const startTime = Date.now();
+        try {
+            const result = await tool.handler(args);
+            this.log({
+                level: 'info',
+                event: 'tool_executed',
+                requestId: id,
+                details: { tool: name, durationMs: Date.now() - startTime },
+            });
+            return {
+                jsonrpc: '2.0',
+                id,
+                result: {
+                    content: [
+                        {
+                            type: 'text',
+                            text: result,
+                        },
+                    ],
+                },
+            };
+        }
+        catch (error) {
+            this.log({
+                level: 'error',
+                event: 'tool_error',
+                requestId: id,
+                details: { tool: name },
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return createErrorResponse(id, ErrorCodes.TOOL_ERROR, 'Tool execution failed', {
+                tool: name,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Get server statistics.
+     */
+    getStats() {
+        return {
+            requestCount: this.requestCount,
+            errorCount: this.errorCount,
+            uptime: Date.now() - this.startTime,
+        };
+    }
+}
+/**
+ * Create and start the MCP server.
+ */
+export async function startMcpServer(config) {
+    const server = new McpServer(config);
+    await server.start();
+    return server;
+}
+// CLI entry point
+if (import.meta.url === `file://${process.argv[1]}`) {
+    startMcpServer().catch((error) => {
+        log.error('Failed to start MCP server:', { error: error instanceof Error ? error.message : String(error) });
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,52 @@
+/**
+ * MCP tool definitions for memory operations.
+ */
+/**
+ * Tool definition for MCP.
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description: string;
+        }>;
+        required: string[];
+    };
+    handler: (args: Record<string, unknown>) => Promise<string>;
+}
+/**
+ * Recall tool: retrieve relevant context from memory.
+ */
+export declare const recallTool: ToolDefinition;
+/**
+ * Explain tool: get explanation of what led to current state.
+ */
+export declare const explainTool: ToolDefinition;
+/**
+ * Predict tool: predict what might be relevant next.
+ */
+export declare const predictTool: ToolDefinition;
+/**
+ * List projects tool: discover available projects for filtering.
+ */
+export declare const listProjectsTool: ToolDefinition;
+/**
+ * List sessions tool: browse available sessions for a project.
+ */
+export declare const listSessionsTool: ToolDefinition;
+/**
+ * Reconstruct tool: rebuild session context by time range.
+ */
+export declare const reconstructTool: ToolDefinition;
+/**
+ * All available tools.
+ */
+export declare const tools: ToolDefinition[];
+/**
+ * Get tool by name.
+ */
+export declare function getTool(name: string): ToolDefinition | undefined;
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAClE,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7D;AAcD;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,cAoCxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,cAoCzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,cAmCzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAyB9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cA2D9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAgE7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,cAAc,EAOjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhE"}