mcp-memory-keeper 0.10.2 → 0.12.0

package/dist/utils/tool-profiles.js

@@ -0,0 +1,242 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PROFILES = exports.ALL_TOOL_NAMES_SET = exports.ALL_TOOL_NAMES = void 0;
+exports.loadConfigFile = loadConfigFile;
+exports.validateToolNames = validateToolNames;
+exports.resolveActiveProfile = resolveActiveProfile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/**
+ * All known tool names - source of truth for validation.
+ * Update this list whenever a tool is added or removed from the
+ * ListToolsRequestSchema handler in src/index.ts.
+ */
+exports.ALL_TOOL_NAMES = [
+    // Session Management
+    'context_session_start',
+    'context_session_list',
+    'context_set_project_dir',
+    // Core Context
+    'context_save',
+    'context_get',
+    'context_status',
+    // File Caching
+    'context_cache_file',
+    'context_file_changed',
+    // Checkpoints
+    'context_checkpoint',
+    'context_restore_checkpoint',
+    // Summarization & Compaction
+    'context_summarize',
+    'context_prepare_compaction',
+    // Git Integration
+    'context_git_commit',
+    // Search
+    'context_search',
+    'context_search_all',
+    'context_semantic_search',
+    // Export/Import
+    'context_export',
+    'context_import',
+    // Knowledge Graph
+    'context_analyze',
+    'context_find_related',
+    'context_visualize',
+    // Multi-Agent
+    'context_delegate',
+    // Session Branching/Merging
+    'context_branch_session',
+    'context_merge_sessions',
+    // Journal & Timeline
+    'context_journal_entry',
+    'context_timeline',
+    // Advanced Features
+    'context_compress',
+    'context_integrate_tool',
+    'context_diff',
+    // Channel Management
+    'context_list_channels',
+    'context_channel_stats',
+    'context_reassign_channel',
+    // Watch
+    'context_watch',
+    // Batch Operations
+    'context_batch_save',
+    'context_batch_delete',
+    'context_batch_update',
+    // Relationships
+    'context_link',
+    'context_get_related',
+];
+/** Pre-computed Set for O(1) lookups — used internally and exported for index.ts */
+exports.ALL_TOOL_NAMES_SET = new Set(exports.ALL_TOOL_NAMES);
+/** Built-in default profiles */
+exports.DEFAULT_PROFILES = {
+    minimal: [
+        'context_session_start',
+        'context_session_list',
+        'context_save',
+        'context_get',
+        'context_search',
+        'context_status',
+        'context_checkpoint',
+        'context_restore_checkpoint',
+    ],
+    standard: [
+        'context_session_start',
+        'context_session_list',
+        'context_set_project_dir',
+        'context_save',
+        'context_get',
+        'context_status',
+        'context_checkpoint',
+        'context_restore_checkpoint',
+        'context_search',
+        'context_search_all',
+        'context_summarize',
+        'context_prepare_compaction',
+        'context_git_commit',
+        'context_export',
+        'context_import',
+        'context_journal_entry',
+        'context_timeline',
+        'context_list_channels',
+        'context_channel_stats',
+        'context_batch_save',
+        'context_batch_delete',
+        'context_batch_update',
+    ],
+    full: [...exports.ALL_TOOL_NAMES],
+};
+const CONFIG_DIR = path.join(os.homedir(), '.mcp-memory-keeper');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+/** Load config file, returning null if absent or invalid */
+function loadConfigFile(configPath = CONFIG_FILE) {
+    try {
+        if (!fs.existsSync(configPath)) {
+            return null;
+        }
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed ||
+            typeof parsed !== 'object' ||
+            Array.isArray(parsed) ||
+            !parsed.profiles ||
+            typeof parsed.profiles !== 'object' ||
+            Array.isArray(parsed.profiles)) {
+            console.warn(`[MCP-Memory-Keeper] Config file at ${configPath} is missing a valid "profiles" key. Ignoring file.`);
+            return null;
+        }
+        // Validated: parsed.profiles is a non-null, non-array object
+        return { profiles: parsed.profiles };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`[MCP-Memory-Keeper] Failed to load config file at ${configPath}: ${message}. Ignoring file.`);
+        return null;
+    }
+}
+/** Validate tool names against ALL_TOOL_NAMES, returning unknown names */
+function validateToolNames(tools) {
+    return tools.filter(name => !exports.ALL_TOOL_NAMES_SET.has(name));
+}
+/** Resolve the active profile based on env var and config file */
+function resolveActiveProfile(configPath) {
+    const warnings = [];
+    let profileName = (process.env.TOOL_PROFILE || '').trim();
+    const hasEnvVar = profileName.length > 0;
+    if (!hasEnvVar) {
+        profileName = 'full';
+    }
+    const config = loadConfigFile(configPath);
+    let toolList;
+    let source = 'default';
+    // Resolution precedence: config file > built-in defaults
+    if (config && config.profiles[profileName] !== undefined) {
+        const candidate = config.profiles[profileName];
+        // Validate that the profile value is actually an array of strings
+        if (!Array.isArray(candidate) || !candidate.every(item => typeof item === 'string')) {
+            warnings.push(`Profile "${profileName}" in config file is not a valid array of strings. Falling back to built-in default.`);
+        }
+        else {
+            toolList = candidate;
+            source = hasEnvVar ? 'env+config' : 'config';
+        }
+    }
+    if (toolList === undefined && exports.DEFAULT_PROFILES[profileName] !== undefined) {
+        toolList = [...exports.DEFAULT_PROFILES[profileName]];
+        source = hasEnvVar ? 'env+builtin' : 'default';
+    }
+    if (toolList === undefined) {
+        // Profile not found anywhere
+        const allProfiles = {
+            ...exports.DEFAULT_PROFILES,
+            ...(config ? config.profiles : {}),
+        };
+        const profileList = Object.entries(allProfiles)
+            .map(([name, tools]) => `${name}(${Array.isArray(tools) ? tools.length : '?'})`)
+            .join(', ');
+        warnings.push(`Unknown TOOL_PROFILE "${profileName}". Available profiles: ${profileList}. Using "full".`);
+        profileName = 'full';
+        toolList = [...exports.DEFAULT_PROFILES.full];
+        source = 'default';
+    }
+    // Validate tool names
+    const unknownNames = validateToolNames(toolList);
+    if (unknownNames.length > 0) {
+        warnings.push(`Unknown tool names in profile "${profileName}": ${unknownNames.join(', ')}. These will be ignored.`);
+    }
+    // Filter to only valid tools
+    const validTools = toolList.filter(name => exports.ALL_TOOL_NAMES_SET.has(name));
+    // Guard against empty profile
+    if (validTools.length === 0) {
+        warnings.push(`Profile "${profileName}" has no valid tools after filtering. Using "full".`);
+        profileName = 'full';
+        return {
+            profileName,
+            tools: new Set(exports.ALL_TOOL_NAMES),
+            source: 'default',
+            warnings,
+        };
+    }
+    return {
+        profileName,
+        tools: new Set(validTools),
+        source,
+        warnings,
+    };
+}

package/examples/config.json

@@ -0,0 +1,31 @@
+{
+  "_comment": "Place this file at ~/.mcp-memory-keeper/config.json. Built-in profiles (minimal, standard, full) are available without configuration. Define custom profiles or override built-ins here.",
+  "profiles": {
+    "my_custom_workflow": [
+      "context_session_start",
+      "context_save",
+      "context_get",
+      "context_search",
+      "context_status",
+      "context_checkpoint",
+      "context_restore_checkpoint",
+      "context_diff",
+      "context_timeline",
+      "context_batch_save"
+    ],
+    "git_focused": [
+      "context_session_start",
+      "context_session_list",
+      "context_set_project_dir",
+      "context_save",
+      "context_get",
+      "context_search",
+      "context_status",
+      "context_checkpoint",
+      "context_restore_checkpoint",
+      "context_git_commit",
+      "context_diff",
+      "context_export"
+    ]
+  }
+}

package/examples/project-directory-setup.md

@@ -0,0 +1,114 @@
+# Smart Project Directory Management
+
+As of version 0.8.3, MCP Memory Keeper provides intelligent assistance for setting up project directories to enable git tracking. This enhancement helps users configure their project directory correctly, especially when starting Claude Code from parent directories.
+
+## How it Works
+
+When you start a new session without providing a `projectDir`, the server will:
+
+1. Check if the current directory has a git repository
+2. Scan subdirectories for git repositories
+3. Provide smart suggestions for setting up the project directory
+4. Prompt for project directory when git operations are attempted
+
+## Examples
+
+### Starting from Parent Directory
+
+```typescript
+// If you're in ~/workspace and your project is in ~/workspace/my-project
+await mcp.call('context_session_start', {
+  name: 'My Feature Work',
+  description: 'Working on the new feature',
+});
+
+// Response will show:
+// Started new session: <session-id>
+// Name: My Feature Work
+// Git branch: unknown
+//
+// 💡 Found git repositories in: my-project, another-project
+// To enable git tracking, start a session with your project directory:
+// context_session_start({ name: "My Feature Work", projectDir: "/Users/you/workspace/my-project" })
+```
+
+### Explicit Directory (Override)
+
+```typescript
+// You can still explicitly set a different directory if needed
+await mcp.call('context_session_start', {
+  name: 'Another Project',
+  projectDir: '/path/to/different/project',
+});
+
+// Response will show:
+// Started new session: <session-id>
+// Name: Another Project
+// Working directory: /path/to/different/project (explicitly set)
+// Git branch: develop
+```
+
+### Non-Git Directory
+
+```typescript
+// If the directory is not a git repository
+await mcp.call('context_session_start', {
+  name: 'Non-Git Project',
+});
+
+// Response will show:
+// Started new session: <session-id>
+// Name: Non-Git Project
+// Working directory: /path/to/current/directory (auto-detected)
+// Git: No repository found in working directory
+```
+
+### Git Operations Without Project Directory
+
+```typescript
+// If you try to commit without setting project directory
+await mcp.call('context_git_commit', {
+  message: 'feat: Add new feature',
+});
+
+// Response will show:
+// ⚠️ No project directory set for git tracking!
+//
+// To enable git tracking for your project, use one of these methods:
+//
+// 1. For the current session:
+//    context_set_project_dir({ projectDir: "/path/to/your/project" })
+//
+// 2. When starting a new session:
+//    context_session_start({ name: "My Session", projectDir: "/path/to/your/project" })
+```
+
+## Benefits
+
+1. **Smart Suggestions**: Automatically detects git repositories and suggests the right paths
+2. **Clear Guidance**: Provides helpful messages when project directory is needed
+3. **Prevents Mistakes**: Avoids using wrong directories when started from parent folders
+4. **Context Preservation**: The working directory is saved with the session for future reference
+5. **Backward Compatible**: Existing code that provides `projectDir` continues to work as before
+
+## Database Schema
+
+The sessions table now includes a `working_directory` column to persist this information:
+
+```sql
+CREATE TABLE sessions (
+  id TEXT PRIMARY KEY,
+  name TEXT,
+  description TEXT,
+  branch TEXT,
+  working_directory TEXT,  -- New column
+  parent_id TEXT,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (parent_id) REFERENCES sessions(id)
+);
+```
+
+## Migration Support
+
+For existing databases, the schema is automatically updated when the server starts. The migration checks if the `working_directory` column exists and adds it if missing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-memory-keeper",
-  "version": "0.10.2",
+  "version": "0.12.0",
   "description": "MCP server for persistent context management in AI coding assistants",
   "main": "dist/index.js",
   "bin": {
@@ -45,19 +45,20 @@
   "files": [
     "dist/**/*",
     "bin/**/*",
+    "examples/**/*",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.3",
-    "better-sqlite3": "^11.10.0",
+    "better-sqlite3": "^12.1.0",
     "simple-git": "^3.28.0",
     "uuid": "^11.1.0"
   },