@synth-coder/memhub 0.2.2 → 0.2.4

package/README.zh-CN.md

@@ -8,48 +8,99 @@ MemHub 将“用户决策、长期偏好、可复用知识”保存为 **Markdow
 
 ## 为什么用 MemHub
 
-- **Git 原生**：所有记忆都是纯文本文件，天然可 diff / 可回滚
-- **面向 Agent**：通过 MCP（stdio）暴露工具，便于模型调用
-- **人类可读**：元数据在 YAML，正文在 Markdown
-- **质量可控**：内置 lint / typecheck / test / coverage 门禁
+大多数 AI 记忆工具依赖外部 API 或简单的关键词匹配。MemHub 不同：
+
+### 本地 AI 语义搜索
+
+- **向量数据库**：基于 LanceDB 实现快速相似度搜索
+- **本地嵌入模型**：量化版 Transformers.js 模型，完全在本地运行
+- **零 API 成本**：无需外部服务、无需 API 密钥、无速率限制
+- **隐私优先**：你的记忆永远不会离开你的电脑
+
+### Git 原生存储
+
+- **纯文本格式**：所有记忆都是带 YAML front matter 的 Markdown 文件
+- **版本控制**：像代码一样提交、分支、审查、回滚
+- **人类可读**：用任何文本编辑器浏览和编辑记忆
+- **团队友好**：通过 git 仓库共享记忆
+
+### 工作原理
+
+```
+用户查询 → 本地嵌入模型 → 向量搜索 → 排序结果
+              ↑                    ↓
+        运行在 CPU           LanceDB 索引
+       (无需 GPU)           (嵌入式数据库)
+```
+
+当你调用 `memory_load` 时，MemHub：
+1. 使用本地量化模型将查询转换为向量
+2. 在 LanceDB 索引中搜索语义相似的记忆
+3. 返回带有相关性分数的排序结果
+
+这意味着"测试框架偏好"可以找到关于"Vitest vs Jest 决策"的记忆——即使没有精确的关键词匹配。
 
 ---
 
 ## 核心特性
 
-- Markdown 持久化（`.md`）
-- YAML Front Matter 元数据（`id / session_id / entry_type / tags / category / importance / 时间戳`）
-- STM-first 双工具接口：`memory_load` + `memory_update`
-- 并发 CLI 安全目录：`YYYY-MM-DD/session_uuid/...`
-- MCP stdio server，可接入主流 MCP 客户端
+- **语义搜索** — 基于 LanceDB 的向量相似度搜索
+- **本地嵌入** — 量化版 Transformers.js 模型，CPU 运行
+- **Markdown 存储** — 人类可读的 `.md` 文件，带 YAML front matter
+- **Git 友好** — 版本控制、diff、审查你的记忆
+- **MCP 协议** — 支持 Claude Code、Cursor、Cline、Windsurf 等
+- **一键配置** — `npx -y @synth-coder/memhub init`
 
 ---
 
 ## 快速开始
 
-### 1）从 npm 安装
+### 一键配置
+
+使用一条命令为你的 AI 代理配置 MemHub：
 
 ```bash
-npm i @synth-coder/memhub
+npx -y @synth-coder/memhub init
 ```
 
-### 2）本地开发安装依赖
+这将启动交互式提示选择你的代理。MemHub 会：
+1. 将 MCP 服务器配置添加到代理的配置文件
+2. 将 MemHub 使用说明添加到代理的规则文件
 
-```bash
-npm install
-```
+**支持的代理：**
 
-### 3）构建
+| 代理 | 配置文件 | 指令文件 |
+|------|----------|----------|
+| Claude Code | `~/.claude/settings.json` | `~/.claude/CLAUDE.md` |
+| Cursor | `~/.cursor/mcp.json` | `~/.cursorrules` |
+| Cline | `~/.cline/mcp.json` | `~/.clinerules` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` | `~/.windsurfrules` |
+| Factory Droid | `~/.factory/mcp.json` | `~/.factory/AGENTS.md` |
+| Gemini CLI | `~/.gemini/settings.json` | `~/.gemini/GEMINI.md` |
+| Codex | `~/.codex/config.toml` | `~/.codex/AGENTS.md` |
 
-```bash
-npm run build
-```
+### CLI 选项
 
-### 4）执行质量门禁
 ```bash
-npm run quality
+# 交互式选择（全局 - 默认）
+npx -y @synth-coder/memhub init
+
+# 跳过交互式提示
+npx -y @synth-coder/memhub init -a claude-code
+
+# 仅配置当前项目（本地）
+npx -y @synth-coder/memhub init -a cursor -l
+
+# 更新现有配置
+npx -y @synth-coder/memhub init -a claude-code --force
 ```
 
+| 选项 | 说明 |
+|------|------|
+| `-a, --agent <名称>` | 代理类型（跳过交互式选择） |
+| `-l, --local` | 配置当前项目（默认：全局） |
+| `-f, --force` | 更新现有配置 |
+
 ---
 
 ## 作为 MCP Server 使用（stdio）
@@ -131,7 +182,7 @@ YYYY-MM-DD-title-slug.md
 
 ## MCP 工具列表
 
-> 调用策略建议见：`docs/tool-calling-policy.md`（首轮 `memory_load`，末轮 `memory_update`）。
+> 详见 [docs/mcp-tools.md](docs/mcp-tools.md) 获取 API 参考。
 
 - `memory_load`：首轮加载短期记忆（STM）上下文
 - `memory_update`：末轮回写决策/偏好/知识/状态变化
@@ -182,9 +233,10 @@ memhub/
 - [x] 架构与契约设计
 - [x] 核心实现（storage/service/server）
 - [x] 质量门禁（lint/typecheck/test/coverage）
+- [x] CLI init 命令快速配置
 - [ ] 集成测试
 - [ ] 性能优化
-- [x] npm 发布（`@synth-coder/memhub@0.1.3`）
+- [x] npm 发布（`@synth-coder/memhub@0.2.3`）
 
 ---
 

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

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

package/dist/src/cli/agents/claude-code.d.ts.map

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

package/dist/src/cli/agents/claude-code.js

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

package/dist/src/cli/agents/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../../src/cli/agents/claude-code.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cline.d.ts","sourceRoot":"","sources":["../../../../src/cli/agents/cline.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/cline.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cline.js","sourceRoot":"","sources":["../../../../src/cli/agents/cline.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"}

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

@@ -0,0 +1,5 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,14 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../../src/cli/agents/cursor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,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"}

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

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

package/dist/src/cli/agents/factory-droid.d.ts.map

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

package/dist/src/cli/agents/factory-droid.js

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

package/dist/src/cli/agents/factory-droid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-droid.js","sourceRoot":"","sources":["../../../../src/cli/agents/factory-droid.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,0BAA0B,CAAC,WAAmB;IAC5D,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"}

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

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

package/dist/src/cli/agents/gemini-cli.d.ts.map

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

package/dist/src/cli/agents/gemini-cli.js

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

package/dist/src/cli/agents/gemini-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-cli.js","sourceRoot":"","sources":["../../../../src/cli/agents/gemini-cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,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"}

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

@@ -0,0 +1,14 @@
+/**
+ * Agent configuration generators index
+ */
+export { generateCursorConfig } from './cursor.js';
+export { generateClaudeCodeConfig } from './claude-code.js';
+export { generateClineConfig } from './cline.js';
+export { generateWindsurfConfig } from './windsurf.js';
+export { generateFactoryDroidConfig } from './factory-droid.js';
+export { generateGeminiCliConfig } from './gemini-cli.js';
+export { generateCodexConfig } from './codex.js';
+import type { AgentType } from '../types.js';
+export type ConfigGenerator = (memhubPath: string) => Record<string, unknown>;
+export declare function getConfigGenerator(agentId: AgentType): ConfigGenerator;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7C,MAAM,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAY9E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,eAAe,CAEtE"}

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

@@ -0,0 +1,30 @@
+/**
+ * Agent configuration generators index
+ */
+export { generateCursorConfig } from './cursor.js';
+export { generateClaudeCodeConfig } from './claude-code.js';
+export { generateClineConfig } from './cline.js';
+export { generateWindsurfConfig } from './windsurf.js';
+export { generateFactoryDroidConfig } from './factory-droid.js';
+export { generateGeminiCliConfig } from './gemini-cli.js';
+export { generateCodexConfig } from './codex.js';
+import { generateCursorConfig } from './cursor.js';
+import { generateClaudeCodeConfig } from './claude-code.js';
+import { generateClineConfig } from './cline.js';
+import { generateWindsurfConfig } from './windsurf.js';
+import { generateFactoryDroidConfig } from './factory-droid.js';
+import { generateGeminiCliConfig } from './gemini-cli.js';
+import { generateCodexConfig } from './codex.js';
+const generators = {
+    cursor: generateCursorConfig,
+    'claude-code': generateClaudeCodeConfig,
+    cline: generateClineConfig,
+    windsurf: generateWindsurfConfig,
+    'factory-droid': generateFactoryDroidConfig,
+    'gemini-cli': generateGeminiCliConfig,
+    codex: generateCodexConfig,
+};
+export function getConfigGenerator(agentId) {
+    return generators[agentId];
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,UAAU,GAAuC;IACrD,MAAM,EAAE,oBAAoB;IAC5B,aAAa,EAAE,wBAAwB;IACvC,KAAK,EAAE,mBAAmB;IAC1B,QAAQ,EAAE,sBAAsB;IAChC,eAAe,EAAE,0BAA0B;IAC3C,YAAY,EAAE,uBAAuB;IACrC,KAAK,EAAE,mBAAmB;CAC3B,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,OAAkB;IACnD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../../../src/cli/agents/windsurf.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,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"}

package/dist/src/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * MemHub CLI entry point
+ * - No args: start MCP server
+ * - With args: run CLI commands
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/src/cli/index.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+/**
+ * MemHub CLI entry point
+ * - No args: start MCP server
+ * - With args: run CLI commands
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import * as p from '@clack/prompts';
+import { AGENTS } from './types.js';
+import { initAgent, selectAgentInteractive } from './init.js';
+import { createMcpServer } from '../server/mcp-server.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Get package version
+let packageJsonPath = join(__dirname, '../../../package.json');
+if (!existsSync(packageJsonPath)) {
+    packageJsonPath = join(__dirname, '../../package.json');
+}
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+const VERSION = packageJson.version || '0.0.0';
+/**
+ * Start MCP server (no args mode)
+ */
+async function startMcpServer() {
+    const server = createMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('MemHub MCP Server running on stdio');
+}
+function printHelp() {
+    // eslint-disable-next-line no-console
+    console.log(`
+MemHub CLI v${VERSION} - Git-friendly memory for AI agents
+
+Usage:
+  memhub                    Start MCP server (default)
+  memhub init [options]     Configure MemHub for your AI agent
+  memhub --help             Show this help message
+  memhub --version          Show version
+
+Options:
+  -a, --agent <agent>       Agent type (skip interactive selection)
+  -f, --force               Update existing configuration
+  -l, --local               Configure for current project (default: global)
+
+Supported agents:
+${AGENTS.map(a => `  ${a.id.padEnd(15)} ${a.name}`).join('\n')}
+
+Examples:
+  memhub                               # Start MCP server
+  memhub init                          # Interactive selection (global)
+  memhub init --local                  # Interactive selection (project)
+  memhub init --agent cursor           # Configure for Cursor (global)
+  memhub init -a claude-code -l        # Configure for Claude Code (project)
+`);
+}
+function printVersion() {
+    // eslint-disable-next-line no-console
+    console.log(`MemHub CLI v${VERSION}`);
+}
+function parseAgent(value) {
+    const validAgents = AGENTS.map(a => a.id);
+    if (validAgents.includes(value)) {
+        return value;
+    }
+    console.error(`Invalid agent: ${value}`);
+    console.error(`Valid agents: ${validAgents.join(', ')}`);
+    return null;
+}
+async function runCli(args) {
+    // Parse command
+    const command = args[0];
+    if (command === '--help' || command === '-h') {
+        printHelp();
+        process.exit(0);
+    }
+    if (command === '--version' || command === '-v') {
+        printVersion();
+        process.exit(0);
+    }
+    if (command !== 'init') {
+        p.log.error(`Unknown command: ${command}`);
+        p.log.info('Run "memhub --help" for usage information.');
+        process.exit(1);
+    }
+    // Parse init options
+    let agent;
+    let force = false;
+    let local = false;
+    for (let i = 1; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '-a' || arg === '--agent') {
+            const value = args[++i];
+            if (!value) {
+                p.log.error('--agent requires a value');
+                process.exit(1);
+            }
+            const parsed = parseAgent(value);
+            if (!parsed) {
+                process.exit(1);
+            }
+            agent = parsed;
+        }
+        else if (arg === '-f' || arg === '--force') {
+            force = true;
+        }
+        else if (arg === '-l' || arg === '--local') {
+            local = true;
+        }
+        else {
+            p.log.error(`Unknown option: ${arg}`);
+            process.exit(1);
+        }
+    }
+    // Start interactive session
+    p.intro(`MemHub v${VERSION}`);
+    // If no agent specified, run interactive selection
+    if (!agent) {
+        const selectedAgent = await selectAgentInteractive();
+        if (!selectedAgent) {
+            p.cancel('Operation cancelled.');
+            process.exit(0);
+        }
+        agent = selectedAgent;
+    }
+    // Run init with spinner
+    const s = p.spinner();
+    s.start(`Configuring MemHub for ${agent}...`);
+    const result = initAgent({
+        agent,
+        force,
+        local,
+    });
+    if (result.success) {
+        s.stop(`Configured for ${result.agent.name}`);
+        p.log.success(`MCP config: ${result.configPath}`);
+        if (result.instructionsUpdated) {
+            p.log.success(`Instructions: ${result.instructionsPath} (${result.instructionsReason})`);
+        }
+        else {
+            p.log.info(`Instructions: ${result.instructionsPath} (${result.instructionsReason})`);
+        }
+        p.outro(`Restart your agent to start using MemHub.`);
+    }
+    else {
+        s.stop('Configuration failed');
+        p.log.error(result.error);
+        process.exit(1);
+    }
+}
+async function main() {
+    const args = process.argv.slice(2);
+    // No args: start MCP server
+    if (args.length === 0) {
+        await startMcpServer();
+        return;
+    }
+    // With args: run CLI
+    await runCli(args);
+}
+main().catch(error => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

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

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

package/dist/src/cli/init.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Init command implementation
+ * Generates MCP configuration for different AI agents
+ */
+import { type AgentType, type AgentConfig } from './types.js';
+export interface InitOptions {
+    readonly agent: AgentType;
+    /** @deprecated Use local instead */
+    readonly projectPath?: string;
+    readonly force?: boolean;
+    readonly local?: boolean;
+}
+export interface InitResult {
+    readonly success: true;
+    readonly configPath: string;
+    readonly instructionsPath: string;
+    readonly instructionsUpdated: boolean;
+    readonly instructionsReason: string;
+    readonly agent: AgentConfig;
+}
+export interface InitError {
+    readonly success: false;
+    readonly error: string;
+}
+export type InitOutcome = InitResult | InitError;
+/**
+ * Run interactive agent selection using clack
+ */
+export declare function selectAgentInteractive(): Promise<AgentType | null>;
+/**
+ * Generate and write MCP configuration for the specified agent
+ */
+export declare function initAgent(options: InitOptions): InitOutcome;
+//# sourceMappingURL=init.d.ts.map

package/dist/src/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAU,KAAK,SAAS,EAAE,KAAK,WAAW,EAAgB,MAAM,YAAY,CAAC;AAKpF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAsDjD;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAexE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAwG3D"}