@smartergpt/lex-mcp 2.5.2 → 2.8.0

package/README.md

@@ -1,6 +1,8 @@
 # @smartergpt/lex-mcp
 
-MCP server wrapper for [Lex](https://github.com/Guffawaffle/lex) episodic memory.
+Thin MCP stdio wrapper for [@smartergpt/lex](https://github.com/Guffawaffle/lex) episodic memory.
+
+Lex owns all capabilities. This package owns delivery over [Model Context Protocol](https://modelcontextprotocol.io/).
 
 ## Quick Start
 
@@ -43,13 +45,24 @@ Add to `claude_desktop_config.json`:
 }
 ```
 
+### Quick Smoke Test
+
+```bash
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx @smartergpt/lex-mcp
+```
+
 ## Environment Variables
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `LEX_WORKSPACE_ROOT` | Workspace root directory | Current directory |
-| `LEX_MEMORY_DB` | SQLite database path | `.smartergpt/lex/lex.db` |
-| `LEX_DEBUG` | Enable debug logging | Off |
+| `LEX_WORKSPACE_ROOT` | Project root directory (compat env var name) | Current directory |
+| `LEX_DB_PATH` | SQLite database path (canonical) | `.smartergpt/lex/memory.db` |
+| `LEX_MEMORY_DB` | Alias for `LEX_DB_PATH` (compat only) | — |
+| `LEX_DEBUG` | Enable debug logging to stderr | Off |
+
+When both `LEX_DB_PATH` and `LEX_MEMORY_DB` are set, `LEX_DB_PATH` wins.
+
+For multi-root workspaces, set the same absolute `LEX_DB_PATH` for direct Lex, this MCP wrapper, and AXF-routed Lex. The wrapper delegates `.lex.config.json`, environment, and default-store resolution to Lex core, so installed launches now honor caller-project config files. Use `system_introspect` to compare canonical store paths and `path-v1` identities across launch paths.
 
 ## Tools
 

package/index.mjs

@@ -9,41 +9,30 @@
  *   npx @smartergpt/lex-mcp
  *
  * Environment Variables:
- *   LEX_WORKSPACE_ROOT - Workspace root directory (default: cwd)
- *   LEX_MEMORY_DB      - SQLite database path (default: .smartergpt/lex/lex.db)
+ *   LEX_WORKSPACE_ROOT - Project root directory (compat env var name, default: cwd)
+ *   LEX_DB_PATH        - SQLite database path (default: .smartergpt/lex/memory.db)
+ *   LEX_MEMORY_DB      - Alias for LEX_DB_PATH (for backwards compatibility)
  *   LEX_DEBUG          - Enable debug logging to stderr
  */
 
 import { MCPServer } from "@smartergpt/lex/mcp-server";
-import { join, dirname } from "path";
-import { mkdirSync } from "fs";
 
-// Workspace root defaults to current working directory
-const repoRoot = process.env.LEX_WORKSPACE_ROOT || process.cwd();
+// Project root defaults to current working directory.
+const projectRoot = process.env.LEX_WORKSPACE_ROOT || process.cwd();
 
 // Set LEX_WORKSPACE_ROOT for modules that need it
 if (!process.env.LEX_WORKSPACE_ROOT) {
-  process.env.LEX_WORKSPACE_ROOT = repoRoot;
-}
-
-// Database path defaults to .smartergpt/lex/lex.db in workspace root
-const dbPath =
-  process.env.LEX_MEMORY_DB || join(repoRoot, ".smartergpt", "lex", "lex.db");
-
-// Ensure the database directory exists (first-time setup)
-try {
-  mkdirSync(dirname(dbPath), { recursive: true });
-} catch {
-  // Ignore — directory may already exist or be read-only
+  process.env.LEX_WORKSPACE_ROOT = projectRoot;
 }
 
 // Initialize MCP server
 let mcpServer;
 try {
-  mcpServer = new MCPServer(dbPath, repoRoot);
+  // Lex core owns env, .lex.config.json, and default-path precedence. Passing
+  // only the caller root prevents the delivery wrapper from masking config.
+  mcpServer = new MCPServer({ repoRoot: projectRoot });
   if (process.env.LEX_DEBUG) {
-    console.error(`[LEX-MCP] Server initialized: ${dbPath}`);
-    console.error(`[LEX-MCP] Workspace root: ${repoRoot}`);
+    console.error(`[LEX-MCP] Project root: ${projectRoot}`);
   }
 } catch (error) {
   console.error(`[LEX-MCP] Failed to initialize: ${error.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartergpt/lex-mcp",
-  "version": "2.5.2",
+  "version": "2.8.0",
   "description": "MCP server for Lex episodic memory - stdio transport wrapper",
   "mcpName": "dev.smartergpt/lex",
   "type": "module",
@@ -10,13 +10,19 @@
     "README.md"
   ],
   "scripts": {
+    "test": "node test-contract.mjs && node test-mcp-server.mjs --local --clean",
+    "test:contract": "node test-contract.mjs",
+    "test:contract:verbose": "node test-contract.mjs --verbose",
     "test:mcp": "node test-mcp-server.mjs --local --clean",
     "test:mcp:verbose": "node test-mcp-server.mjs --local --clean --verbose",
+    "test:pack": "node test-pack-smoke.mjs",
+    "test:pack:verbose": "node test-pack-smoke.mjs --verbose",
+    "test:pack:keep": "node test-pack-smoke.mjs --keep",
     "test:published": "node test-mcp-server.mjs --clean",
     "link:local": "rm -rf node_modules/@smartergpt/lex && mkdir -p node_modules/@smartergpt && ln -s /srv/lex-mcp/lex node_modules/@smartergpt/lex"
   },
   "dependencies": {
-    "@smartergpt/lex": "^2.5.1"
+    "@smartergpt/lex": "^2.8.0"
   },
   "publishConfig": {
     "access": "public",