@synth-coder/memhub 0.2.4 → 0.2.5

package/dist/src/cli/types.js

@@ -68,17 +68,6 @@ export const AGENTS = [
         globalInstructionsFile: '.gemini/GEMINI.md',
         instructionsFormat: 'markdown',
     },
-    {
-        id: 'codex',
-        name: 'Codex',
-        description: 'OpenAI CLI coding agent',
-        configFile: '.codex/config.toml',
-        globalConfigFile: '.codex/config.toml',
-        configFormat: 'toml',
-        instructionsFile: 'AGENTS.md',
-        globalInstructionsFile: '.codex/AGENTS.md',
-        instructionsFormat: 'markdown',
-    },
 ];
 export function getAgentById(id) {
     return AGENTS.find(agent => agent.id === id);

package/dist/src/cli/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2BH,MAAM,CAAC,MAAM,MAAM,GAA2B;IAC5C;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE,kBAAkB;QAC9B,gBAAgB,EAAE,kBAAkB;QACpC,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,cAAc;QAChC,sBAAsB,EAAE,cAAc;QACtC,kBAAkB,EAAE,OAAO;KAC5B;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,0BAA0B;QACvC,UAAU,EAAE,WAAW;QACvB,gBAAgB,EAAE,uBAAuB;QACzC,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,WAAW;QAC7B,sBAAsB,EAAE,mBAAmB;QAC3C,kBAAkB,EAAE,UAAU;KAC/B;IACD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE,iBAAiB;QAC7B,gBAAgB,EAAE,iBAAiB;QACnC,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,aAAa;QAC/B,sBAAsB,EAAE,aAAa;QACrC,kBAAkB,EAAE,OAAO;KAC5B;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,mBAAmB;QAChC,UAAU,EAAE,mCAAmC;QAC/C,gBAAgB,EAAE,mCAAmC;QACrD,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,gBAAgB;QAClC,sBAAsB,EAAE,gBAAgB;QACxC,kBAAkB,EAAE,OAAO;KAC5B;IACD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,yBAAyB;QACtC,UAAU,EAAE,mBAAmB;QAC/B,gBAAgB,EAAE,mBAAmB;QACrC,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,oBAAoB;QACtC,sBAAsB,EAAE,oBAAoB;QAC5C,kBAAkB,EAAE,UAAU;KAC/B;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE,uBAAuB;QACnC,gBAAgB,EAAE,uBAAuB;QACzC,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,WAAW;QAC7B,sBAAsB,EAAE,mBAAmB;QAC3C,kBAAkB,EAAE,UAAU;KAC/B;IACD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,yBAAyB;QACtC,UAAU,EAAE,oBAAoB;QAChC,gBAAgB,EAAE,oBAAoB;QACtC,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,WAAW;QAC7B,sBAAsB,EAAE,kBAAkB;QAC1C,kBAAkB,EAAE,UAAU;KAC/B;CACO,CAAC;AAEX,MAAM,UAAU,YAAY,CAAC,EAAa;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0BH,MAAM,CAAC,MAAM,MAAM,GAA2B;IAC5C;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE,kBAAkB;QAC9B,gBAAgB,EAAE,kBAAkB;QACpC,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,cAAc;QAChC,sBAAsB,EAAE,cAAc;QACtC,kBAAkB,EAAE,OAAO;KAC5B;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,0BAA0B;QACvC,UAAU,EAAE,WAAW;QACvB,gBAAgB,EAAE,uBAAuB;QACzC,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,WAAW;QAC7B,sBAAsB,EAAE,mBAAmB;QAC3C,kBAAkB,EAAE,UAAU;KAC/B;IACD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE,iBAAiB;QAC7B,gBAAgB,EAAE,iBAAiB;QACnC,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,aAAa;QAC/B,sBAAsB,EAAE,aAAa;QACrC,kBAAkB,EAAE,OAAO;KAC5B;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,mBAAmB;QAChC,UAAU,EAAE,mCAAmC;QAC/C,gBAAgB,EAAE,mCAAmC;QACrD,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,gBAAgB;QAClC,sBAAsB,EAAE,gBAAgB;QACxC,kBAAkB,EAAE,OAAO;KAC5B;IACD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,yBAAyB;QACtC,UAAU,EAAE,mBAAmB;QAC/B,gBAAgB,EAAE,mBAAmB;QACrC,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,oBAAoB;QACtC,sBAAsB,EAAE,oBAAoB;QAC5C,kBAAkB,EAAE,UAAU;KAC/B;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE,uBAAuB;QACnC,gBAAgB,EAAE,uBAAuB;QACzC,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,WAAW;QAC7B,sBAAsB,EAAE,mBAAmB;QAC3C,kBAAkB,EAAE,UAAU;KAC/B;CACO,CAAC;AAEX,MAAM,UAAU,YAAY,CAAC,EAAa;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/docs/user-guide.md

@@ -9,7 +9,7 @@ MemHub is a Git-friendly memory system for AI coding agents. It helps your AI re
 Configure MemHub for your AI agent with one command:
 
 ```bash
-npx -y @synth-coder/memhub init
+npx -y @synth-coder/memhub@latest init
 ```
 
 This will:
@@ -29,20 +29,22 @@ This will:
 | Gemini CLI    | `~/.gemini/settings.json`             | `.gemini/settings.json`             |
 | Codex         | `~/.codex/config.toml`                | `.codex/config.toml`                |
 
+Note: Codex config uses TOML key `mcp_servers` (not `mcpServers`).
+
 ### CLI Options
 
 ```bash
 # Interactive selection (global - default)
-npx -y @synth-coder/memhub init
+npx -y @synth-coder/memhub@latest init
 
 # Specify agent
-npx -y @synth-coder/memhub init -a claude-code
+npx -y @synth-coder/memhub@latest init -a claude-code
 
 # Configure for current project only (local)
-npx -y @synth-coder/memhub init -a cursor -l
+npx -y @synth-coder/memhub@latest init -a cursor -l
 
 # Update existing configuration
-npx -y @synth-coder/memhub init -a claude-code --force
+npx -y @synth-coder/memhub@latest init -a claude-code --force
 ```
 
 | Option               | Description                                     |
@@ -95,7 +97,7 @@ By default, memories are stored in `~/.memhub/` (global) or `./memories/` (local
 
 ```bash
 # Custom storage location
-MEMHUB_STORAGE_PATH=/path/to/memories npx -y @synth-coder/memhub
+MEMHUB_STORAGE_PATH=/path/to/memories npx -y @synth-coder/memhub@latest
 ```
 
 ### File Format

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synth-coder/memhub",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "A Git-friendly memory hub using Markdown-based storage with YAML Front Matter",
   "type": "module",
   "main": "dist/src/index.js",
@@ -8,6 +8,20 @@
   "bin": {
     "memhub": "dist/src/cli/index.js"
   },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src test --ext .ts",
+    "lint:fix": "eslint src test --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\" \"docs/**/*.md\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\" \"docs/**/*.md\"",
+    "typecheck": "tsc --noEmit --project tsconfig.json",
+    "quality": "npm run lint && npm run typecheck && npm run test:coverage",
+    "ci": "npm run quality"
+  },
   "keywords": [
     "mcp",
     "memory",
@@ -43,19 +57,5 @@
   },
   "engines": {
     "node": ">=20.0.0"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint src test --ext .ts",
-    "lint:fix": "eslint src test --ext .ts --fix",
-    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\" \"docs/**/*.md\"",
-    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\" \"docs/**/*.md\"",
-    "typecheck": "tsc --noEmit --project tsconfig.json",
-    "quality": "npm run lint && npm run typecheck && npm run test:coverage",
-    "ci": "npm run quality"
   }
-}
+}

package/src/cli/agents/claude-code.ts

@@ -7,7 +7,7 @@ export function generateClaudeCodeConfig(_memhubPath: string): Record<string, un
     mcpServers: {
       memhub: {
         command: 'npx',
-        args: ['-y', '@synth-coder/memhub'],
+        args: ['-y', '@synth-coder/memhub@latest'],
       },
     },
   };

package/src/cli/agents/cline.ts

@@ -7,7 +7,7 @@ export function generateClineConfig(_memhubPath: string): Record<string, unknown
     mcpServers: {
       memhub: {
         command: 'npx',
-        args: ['-y', '@synth-coder/memhub'],
+        args: ['-y', '@synth-coder/memhub@latest'],
       },
     },
   };

package/src/cli/agents/codex.ts

@@ -4,10 +4,10 @@
 
 export function generateCodexConfig(_memhubPath: string): Record<string, unknown> {
   return {
-    mcpServers: {
+    mcp_servers: {
       memhub: {
         command: 'npx',
-        args: ['-y', '@synth-coder/memhub'],
+        args: ['-y', '@synth-coder/memhub@latest'],
       },
     },
   };

package/src/cli/agents/cursor.ts

@@ -7,7 +7,7 @@ export function generateCursorConfig(_memhubPath: string): Record<string, unknow
     mcpServers: {
       memhub: {
         command: 'npx',
-        args: ['-y', '@synth-coder/memhub'],
+        args: ['-y', '@synth-coder/memhub@latest'],
       },
     },
   };

package/src/cli/agents/factory-droid.ts

@@ -7,7 +7,7 @@ export function generateFactoryDroidConfig(_memhubPath: string): Record<string,
     mcpServers: {
       memhub: {
         command: 'npx',
-        args: ['-y', '@synth-coder/memhub'],
+        args: ['-y', '@synth-coder/memhub@latest'],
       },
     },
   };

package/src/cli/agents/gemini-cli.ts

@@ -7,7 +7,7 @@ export function generateGeminiCliConfig(_memhubPath: string): Record<string, unk
     mcpServers: {
       memhub: {
         command: 'npx',
-        args: ['-y', '@synth-coder/memhub'],
+        args: ['-y', '@synth-coder/memhub@latest'],
       },
     },
   };

package/src/cli/agents/windsurf.ts

@@ -7,7 +7,7 @@ export function generateWindsurfConfig(_memhubPath: string): Record<string, unkn
     mcpServers: {
       memhub: {
         command: 'npx',
-        args: ['-y', '@synth-coder/memhub'],
+        args: ['-y', '@synth-coder/memhub@latest'],
       },
     },
   };

package/src/cli/init.ts

@@ -62,6 +62,14 @@ function stringifyConfig(
   return JSON.stringify(config, null, 2);
 }
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null;
+}
+
+function getTargetMcpKey(config: Record<string, unknown>): 'mcpServers' | 'mcp_servers' {
+  return isRecord(config.mcp_servers) ? 'mcp_servers' : 'mcpServers';
+}
+
 /**
  * Merge memhub config into existing config
  * Preserves all existing servers, adds/updates memhub
@@ -71,19 +79,10 @@ function mergeMcpConfig(
   newConfig: Record<string, unknown>
 ): Record<string, unknown> {
   const result = { ...existing };
-
-  // Ensure mcpServers object exists
-  if (typeof result.mcpServers !== 'object' || result.mcpServers === null) {
-    result.mcpServers = {};
-  }
-
-  // Merge memhub server
-  const existingServers = result.mcpServers as Record<string, unknown>;
-  const newServers = newConfig.mcpServers as Record<string, unknown>;
-
-  for (const [serverName, serverConfig] of Object.entries(newServers)) {
-    existingServers[serverName] = serverConfig;
-  }
+  const targetKey = getTargetMcpKey(newConfig);
+  const existingServers = isRecord(result[targetKey]) ? result[targetKey] : {};
+  const newServers = (newConfig[targetKey] as Record<string, unknown>) ?? {};
+  result[targetKey] = { ...existingServers, ...newServers };
 
   return result;
 }
@@ -158,7 +157,8 @@ export function initAgent(options: InitOptions): InitOutcome {
       try {
         const existingContent = readFileSync(configPath, 'utf-8');
         const existingConfig = parseConfig(existingContent, configFormat);
-        const servers = existingConfig.mcpServers as Record<string, unknown> | undefined;
+        const targetKey = getTargetMcpKey(newConfig);
+        const servers = existingConfig[targetKey] as Record<string, unknown> | undefined;
 
         if (servers && 'memhub' in servers) {
           return {

package/test/cli/init.test.ts

@@ -7,6 +7,7 @@ import { mkdirSync, rmSync, existsSync, readFileSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { initAgent } from '../../src/cli/init.js';
 import { AGENTS, type AgentType } from '../../src/cli/types.js';
+import { parse as parseToml } from 'smol-toml';
 import {
   extractMemHubVersion,
   needsUpdate,
@@ -209,6 +210,26 @@ describe('CLI Init Command', () => {
       expect(config.mcpServers.memhub.command).toBe('npx');
     });
 
+    it('should generate valid TOML config for codex', () => {
+      initAgent({
+        agent: 'codex',
+        local: true,
+        projectPath: TEST_DIR,
+      });
+
+      const configPath = join(TEST_DIR, '.codex/config.toml');
+      const content = readFileSync(configPath, 'utf-8');
+      const config = parseToml(content) as Record<string, unknown>;
+      const servers = config.mcp_servers as Record<string, unknown>;
+      const memhub = servers.memhub as Record<string, unknown>;
+      const args = memhub.args as string[];
+
+      expect(config).toHaveProperty('mcp_servers');
+      expect(servers).toHaveProperty('memhub');
+      expect(memhub.command).toBe('npx');
+      expect(args).toContain('@synth-coder/memhub@latest');
+    });
+
     it('should generate instructions with version tag', () => {
       initAgent({
         agent: 'claude-code',
@@ -260,7 +281,7 @@ describe('CLI Init Command', () => {
         mcpServers: {
           memhub: {
             command: 'npx',
-            args: ['-y', '@synth-coder/memhub'],
+            args: ['-y', '@synth-coder/memhub@latest'],
           },
         },
       };
@@ -315,6 +336,7 @@ describe('CLI Init Command', () => {
       expect(config.mcpServers).toHaveProperty('memhub');
       expect(config.mcpServers.memhub.command).toBe('npx');
     });
+
   });
 
   describe('Instructions Update', () => {

package/tsconfig.json

@@ -1,26 +1,26 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "lib": ["ES2022"],
-    "outDir": "./dist",
-    "rootDir": ".",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "verbatimModuleSyntax": true,
-    "isolatedModules": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
 }

package/tsconfig.test.json

@@ -1,8 +1,8 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "noUnusedLocals": false,
-    "noUnusedParameters": false
-  },
-  "include": ["src/**/*", "test/**/*", "vitest.config.ts"]
-}
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noUnusedLocals": false,
+    "noUnusedParameters": false
+  },
+  "include": ["src/**/*", "test/**/*", "vitest.config.ts"]
+}

package/vitest.config.ts

@@ -1,29 +1,29 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'json', 'html', 'lcov'],
-      thresholds: {
-        lines: 80,
-        functions: 80,
-        branches: 78,
-        statements: 80,
-      },
-      exclude: [
-        'node_modules/',
-        'dist/',
-        'test/',
-        '**/*.d.ts',
-        '**/*.config.*',
-        '**/index.ts',
-        '.eslintrc.cjs',
-        'src/services/embedding-service.ts',
-        'src/server/mcp-server.ts',
-      ],
-    },
-  },
-});
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html', 'lcov'],
+      thresholds: {
+        lines: 80,
+        functions: 80,
+        branches: 78,
+        statements: 80,
+      },
+      exclude: [
+        'node_modules/',
+        'dist/',
+        'test/',
+        '**/*.d.ts',
+        '**/*.config.*',
+        '**/index.ts',
+        '.eslintrc.cjs',
+        'src/services/embedding-service.ts',
+        'src/server/mcp-server.ts',
+      ],
+    },
+  },
+});

package/dist/src/cli/agents/codex.d.ts

@@ -1,5 +0,0 @@
-/**
- * Codex MCP configuration generator
- */
-export declare function generateCodexConfig(_memhubPath: string): Record<string, unknown>;
-//# sourceMappingURL=codex.d.ts.map

package/dist/src/cli/agents/codex.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../../src/cli/agents/codex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAShF"}

package/dist/src/cli/agents/codex.js

@@ -1,14 +0,0 @@
-/**
- * Codex MCP configuration generator
- */
-export function generateCodexConfig(_memhubPath) {
-    return {
-        mcpServers: {
-            memhub: {
-                command: 'npx',
-                args: ['-y', '@synth-coder/memhub'],
-            },
-        },
-    };
-}
-//# sourceMappingURL=codex.js.map

package/dist/src/cli/agents/codex.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../../src/cli/agents/codex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO;QACL,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}