memorylink 1.0.0

package/dist/server/mcp-server.js

@@ -0,0 +1,293 @@
+"use strict";
+/**
+ * MemoryLink - MCP Server
+ * Model Context Protocol server for Claude Desktop and Cursor integration
+ *
+ * Enables automatic context injection without manual copy-paste
+ *
+ * v1.1: MCP Server implementation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMCPServer = createMCPServer;
+exports.startMCPServer = startMCPServer;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const utils_js_1 = require("../utils.js");
+const types_js_1 = require("../types.js");
+/**
+ * Get context for AI tools (internal function, returns structured data)
+ */
+async function getContextForMCP(options) {
+    const { tags, since, limit = 50, type } = options;
+    const root = (0, utils_js_1.findRoot)();
+    if (!root || !(0, utils_js_1.isInitialized)(root)) {
+        return '# MemoryLink Context\n\nMemoryLink is not initialized in this directory.\n';
+    }
+    const memoryPath = (0, utils_js_1.getFilePath)('MEMORY', root);
+    const changesPath = (0, utils_js_1.getFilePath)('CHANGES', root);
+    const learningsPath = (0, utils_js_1.getFilePath)('LEARNINGS', root);
+    const protectedPath = (0, utils_js_1.getFilePath)('PROTECTED', root);
+    // Read protected files (plain text)
+    const protectedEntries = [];
+    try {
+        const protectedContent = require('fs').readFileSync(protectedPath, 'utf-8');
+        protectedEntries.push(...protectedContent.split('\n')
+            .filter((l) => l.trim() && !l.startsWith('#')));
+    }
+    catch {
+        // No protected files
+    }
+    // Read JSONL entries
+    let memoryEntries = [];
+    let learningsEntries = [];
+    let changesEntries = [];
+    if ((0, utils_js_1.isJsonlFormat)(memoryPath)) {
+        memoryEntries = (0, utils_js_1.readJsonlEntries)(memoryPath)
+            .filter(e => e.status === 'ACTIVE');
+    }
+    // Extract rules/preferences first (highest priority)
+    const rules = memoryEntries.filter(e => e.type === 'rule' || e.type === 'preference');
+    let nonRuleMemories = memoryEntries.filter(e => e.type !== 'rule' && e.type !== 'preference');
+    if ((0, utils_js_1.isJsonlFormat)(learningsPath)) {
+        learningsEntries = (0, utils_js_1.readJsonlEntries)(learningsPath)
+            .filter(e => e.status === 'ACTIVE');
+    }
+    if ((0, utils_js_1.isJsonlFormat)(changesPath)) {
+        changesEntries = (0, utils_js_1.readJsonlEntries)(changesPath);
+    }
+    // Filter by tag if specified
+    if (tags && tags.length > 0) {
+        nonRuleMemories = tags.reduce((acc, tag) => {
+            return acc.concat((0, utils_js_1.filterByTag)(nonRuleMemories, tag));
+        }, []);
+        // Remove duplicates
+        const seen = new Set();
+        nonRuleMemories = nonRuleMemories.filter(e => {
+            if (seen.has(e.id))
+                return false;
+            seen.add(e.id);
+            return true;
+        });
+        learningsEntries = tags.reduce((acc, tag) => {
+            return acc.concat((0, utils_js_1.filterByTag)(learningsEntries, tag));
+        }, []);
+        const seenLearnings = new Set();
+        learningsEntries = learningsEntries.filter(e => {
+            if (seenLearnings.has(e.id))
+                return false;
+            seenLearnings.add(e.id);
+            return true;
+        });
+    }
+    // Filter by type if specified
+    if (type) {
+        nonRuleMemories = nonRuleMemories.filter(e => e.type === type);
+    }
+    // Filter by date if specified
+    if (since) {
+        nonRuleMemories = (0, utils_js_1.filterBySince)(nonRuleMemories, since);
+        learningsEntries = (0, utils_js_1.filterBySince)(learningsEntries, since);
+        changesEntries = (0, utils_js_1.filterBySince)(changesEntries, since);
+    }
+    // Sort by timestamp (newest last)
+    nonRuleMemories.sort((a, b) => new Date(a.ts).getTime() - new Date(b.ts).getTime());
+    learningsEntries.sort((a, b) => new Date(a.ts).getTime() - new Date(b.ts).getTime());
+    changesEntries.sort((a, b) => new Date(a.ts).getTime() - new Date(b.ts).getTime());
+    // Limit entries
+    const limitedMemories = nonRuleMemories.slice(-limit);
+    const limitedLearnings = learningsEntries.slice(-limit);
+    const limitedChanges = changesEntries.slice(-limit);
+    // Build markdown output
+    const lines = [];
+    lines.push('# MemoryLink Project Context');
+    lines.push('');
+    lines.push('*Auto-injected via MCP Server*');
+    lines.push('');
+    // Protected files section
+    if (protectedEntries.length > 0) {
+        lines.push('## ⛔ Protected Files (DO NOT MODIFY)');
+        protectedEntries.forEach(file => {
+            lines.push(`- \`${file.trim()}\``);
+        });
+        lines.push('');
+    }
+    // Rules section (CRITICAL - must be first)
+    if (rules.length > 0) {
+        lines.push('## 🚨 CRITICAL PROJECT RULES - MUST FOLLOW');
+        lines.push('');
+        const preferences = rules.filter(r => r.type === 'preference');
+        const strictRules = rules.filter(r => r.type === 'rule');
+        if (preferences.length > 0) {
+            lines.push('### User Preferences (HIGHEST PRIORITY)');
+            preferences.forEach(pref => {
+                lines.push(`- **${pref.details}**`);
+                if (pref.tags && pref.tags.length > 0) {
+                    lines.push(`  - Tags: ${pref.tags.join(', ')}`);
+                }
+            });
+            lines.push('');
+        }
+        if (strictRules.length > 0) {
+            lines.push('### Strict Rules');
+            strictRules.forEach(rule => {
+                lines.push(`- **${rule.details}**`);
+                if (rule.tags && rule.tags.length > 0) {
+                    lines.push(`  - Tags: ${rule.tags.join(', ')}`);
+                }
+            });
+            lines.push('');
+        }
+    }
+    // Memory entries
+    if (limitedMemories.length > 0) {
+        lines.push('## 📝 Project Memory');
+        limitedMemories.forEach(entry => {
+            const typeEmoji = entry.type === 'decision' ? '🎯' :
+                entry.type === 'doc_ref' ? '📄' :
+                    entry.type === 'code_snippet' ? '💻' : '📝';
+            lines.push(`- ${typeEmoji} ${entry.details}`);
+            if (entry.tags && entry.tags.length > 0) {
+                lines.push(`  - Tags: ${entry.tags.join(', ')}`);
+            }
+        });
+        lines.push('');
+    }
+    // Learnings
+    if (limitedLearnings.length > 0) {
+        const successLearnings = limitedLearnings.filter(e => e.outcome === 'SUCCESS');
+        const failedLearnings = limitedLearnings.filter(e => e.outcome === 'FAILED');
+        if (successLearnings.length > 0) {
+            lines.push('## ✅ Successful Solutions');
+            successLearnings.forEach(entry => {
+                lines.push(`- **${entry.problem}**: ${entry.solution}`);
+                if (entry.reason) {
+                    lines.push(`  - Reason: ${entry.reason}`);
+                }
+            });
+            lines.push('');
+        }
+        if (failedLearnings.length > 0) {
+            lines.push('## ❌ Failed Solutions (DO NOT REPEAT)');
+            failedLearnings.forEach(entry => {
+                lines.push(`- **${entry.problem}**: ${entry.solution} (FAILED)`);
+                if (entry.reason) {
+                    lines.push(`  - Reason: ${entry.reason}`);
+                }
+            });
+            lines.push('');
+        }
+    }
+    // Recent changes
+    if (limitedChanges.length > 0) {
+        lines.push('## 📋 Recent Changes');
+        limitedChanges.forEach(entry => {
+            const actionEmoji = entry.action === 'created' ? '✨' :
+                entry.action === 'edited' ? '✏️' :
+                    entry.action === 'deleted' ? '🗑️' : '📝';
+            lines.push(`- ${actionEmoji} \`${entry.file}\`: ${entry.reason}`);
+        });
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('*End of MemoryLink context*');
+    return lines.join('\n');
+}
+/**
+ * Create and configure MCP server
+ */
+async function createMCPServer() {
+    const server = new index_js_1.Server({
+        name: 'memorylink',
+        version: types_js_1.MEMORYLINK_VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // List available tools
+    server.setRequestHandler('tools/list', async () => {
+        return {
+            tools: [
+                {
+                    name: 'memorylink_context',
+                    description: 'Get project context from MemoryLink memory system. Returns rules, preferences, memories, learnings, and recent changes.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            tags: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Filter context by tags (e.g., ["api", "auth"])',
+                            },
+                            since: {
+                                type: 'string',
+                                description: 'Filter by date (ISO format or relative: "7d", "2w", "1m")',
+                            },
+                            limit: {
+                                type: 'number',
+                                description: 'Maximum number of entries per section (default: 50)',
+                            },
+                            type: {
+                                type: 'string',
+                                description: 'Filter memory entries by type (note, decision, doc_ref, code_snippet, rule, preference)',
+                            },
+                        },
+                    },
+                },
+            ],
+        };
+    });
+    // Handle tool calls
+    server.setRequestHandler('tools/call', async (request) => {
+        const { name, arguments: args } = request.params;
+        if (name === 'memorylink_context') {
+            try {
+                const context = await getContextForMCP({
+                    tags: args?.tags,
+                    since: args?.since,
+                    limit: args?.limit,
+                    type: args?.type,
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: context,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error getting MemoryLink context: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        throw new Error(`Unknown tool: ${name}`);
+    });
+    return server;
+}
+/**
+ * Start MCP server (stdio transport for Claude Desktop)
+ */
+async function startMCPServer() {
+    try {
+        const server = await createMCPServer();
+        const transport = new stdio_js_1.StdioServerTransport();
+        await server.connect(transport);
+        // Log to stderr (stdio protocol requirement)
+        console.error('MemoryLink MCP Server running on stdio');
+        console.error('Ready to serve context to AI tools');
+    }
+    catch (error) {
+        console.error('Failed to start MCP server:', error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/server/mcp-server.js.map

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

package/dist/telemetry.d.ts

@@ -0,0 +1,92 @@
+/**
+ * MemoryLink - Telemetry & 24×7 Monitoring Module
+ *
+ * v1.6: Opt-in, privacy-first telemetry for self-observation
+ *
+ * DESIGN PRINCIPLES:
+ * - Opt-in only (OFF by default)
+ * - No user content (no code, paths, secrets, PII)
+ * - Non-blocking (never slows down commands)
+ * - Resilient (failures don't affect CLI behavior)
+ */
+/**
+ * Telemetry configuration
+ * Part of MemoryLinkConfig
+ */
+export interface TelemetryConfig {
+    enabled?: boolean;
+    endpoint?: string | null;
+    apiKey?: string | null;
+}
+/**
+ * High-level error categories (safe to send)
+ * No stack traces, no paths, no user content
+ */
+export type ErrorKind = 'NOT_INITIALIZED' | 'NOT_GIT_REPO' | 'CONFIG_MISSING' | 'CONFIG_INVALID' | 'LOCK_ACQUIRE_FAILED' | 'LOCK_TIMEOUT' | 'CHECKPOINT_NOT_FOUND' | 'SCOPE_INVALID' | 'PERMISSION_DENIED' | 'FILE_NOT_FOUND' | 'INVALID_INPUT' | 'UNEXPECTED_ERROR' | 'NETWORK_ERROR' | 'UNKNOWN';
+/**
+ * Telemetry event (privacy-safe)
+ * Contains only safe, high-level information
+ */
+export interface TelemetryEvent {
+    command: string;
+    result: 'success' | 'error';
+    exitCode?: number;
+    errorKind?: ErrorKind;
+    memorylinkVersion: string;
+    nodeVersion: string;
+    os: string;
+    osVersion?: string;
+    isGitRepo?: boolean;
+    hasConfig?: boolean;
+    timestamp: string;
+    flags?: Record<string, boolean | string | number>;
+}
+/**
+ * Get telemetry configuration
+ * Returns null if telemetry is disabled or not configured
+ */
+export declare function getTelemetryConfig(): TelemetryConfig | null;
+/**
+ * Check if telemetry is enabled
+ */
+export declare function isTelemetryEnabled(): boolean;
+/**
+ * Record a telemetry event
+ *
+ * This function:
+ * - Checks if telemetry is enabled
+ * - Creates a safe event (no user content)
+ * - Logs locally (for v1.6 scaffolding)
+ * - TODO v1.6: Sends to remote endpoint if configured
+ *
+ * This function NEVER throws - it silently fails if there's an error
+ */
+export declare function recordEvent(event: Partial<TelemetryEvent>): Promise<void>;
+/**
+ * TODO v1.6+: Event batching
+ * - Collect events in memory buffer
+ * - Send batch every N events (e.g., 10) or every T seconds (e.g., 30s)
+ * - Flush on process exit (graceful shutdown handler)
+ *
+ * TODO v1.6+: Persistent queue
+ * - If endpoint is down, write events to queue file (.memorylink/telemetry-queue.log)
+ * - Retry on next command execution
+ * - Limit queue size to prevent disk bloat (e.g., max 1000 events)
+ * - Clear queue after successful send
+ */
+/**
+ * Determine error kind from error object
+ * Returns high-level category (no user content)
+ */
+export declare function getErrorKind(err: any): ErrorKind;
+/**
+ * Check if current directory is a Git repository
+ * Returns boolean (safe - no paths exposed)
+ */
+export declare function checkIsGitRepo(): boolean;
+/**
+ * Check if config exists
+ * Returns boolean (safe - no paths exposed)
+ */
+export declare function checkHasConfig(): boolean;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GACjB,iBAAiB,GACjB,cAAc,GACd,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,GACrB,cAAc,GACd,sBAAsB,GACtB,eAAe,GACf,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,SAAS,CAAC;AAEd;;;GAGG;AACH,MAAM,WAAW,cAAc;IAE7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;IAGtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAGlB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;CACnD;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAkB3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAG5C;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC/E;AA0HD;;;;;;;;;;;GAWG;AAMH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CA2ChD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAaxC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAYxC"}