@pcircle/memesh 2.6.5 → 2.6.7

package/README.md

@@ -10,10 +10,12 @@
 
 [![GitHub Stars](https://img.shields.io/github/stars/PCIRCLE-AI/claude-code-buddy?style=social)](https://github.com/PCIRCLE-AI/claude-code-buddy)
 [![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
+[![npm publish](https://github.com/PCIRCLE-AI/claude-code-buddy/actions/workflows/publish-npm.yml/badge.svg)](https://github.com/PCIRCLE-AI/claude-code-buddy/actions/workflows/publish-npm.yml)
+[![Installation Tests](https://github.com/PCIRCLE-AI/claude-code-buddy/actions/workflows/installation-test.yml/badge.svg)](https://github.com/PCIRCLE-AI/claude-code-buddy/actions/workflows/installation-test.yml)
 [![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
 [![MCP](https://img.shields.io/badge/MCP-1.25.3-purple.svg)](https://modelcontextprotocol.io)
 
-[🚀 Quick Start](#-2-minute-quick-start) • [📖 Docs](docs/) • [🌐 Website](https://memesh.pcircle.ai) • [💬 Discussions](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+[🚀 Quick Start](#-2-minute-quick-start) • [📖 Docs](docs/) • [🌐 GitHub](https://github.com/PCIRCLE-AI/claude-code-buddy) • [💬 Discussions](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
 
 ---
 
@@ -171,40 +173,50 @@ buddy-help                          # When stuck
 
 **Three commands. Infinite possibilities.**
 
+### 4. 🔐 **Secure Credential Storage**
+
+```bash
+buddy-secret-store "openai_key" "sk-..." api_key  # Store encrypted
+buddy-secret-get "openai_key"                      # Retrieve for API calls
+buddy-secret-list                                  # See what's stored
+buddy-secret-delete "old_key"                      # Cleanup
+```
+
+**AES-256-GCM encryption. Local only. Never transmitted.**
+
 ---
 
 ## 🚀 Installation Options
 
 Choose your preferred installation method:
 
-### 🏆 Official Marketplace (Coming Soon)
-Once approved by Anthropic, install with one command:
+### ⚡ npm Global Install (Easiest) ⭐ RECOMMENDED
 ```bash
-/plugin install memesh@claude-plugins-official
-```
-
-### ⚡ GitHub Marketplace (Available Now)
-```bash
-# Add marketplace
-/plugin marketplace add PCIRCLE-AI/claude-code-buddy
-
-# Install plugin
-/plugin install memesh@pcircle-ai
+npm install -g @pcircle/memesh
+# Auto-configures everything! Just restart Claude Code.
 ```
 
-### 📦 Quick Install Script (Recommended for Local Dev)
+### 📦 Quick Install Script (For Local Dev)
 ```bash
 git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
 cd claude-code-buddy
 ./scripts/quick-install.sh
-claude --plugin-dir /path/to/claude-code-buddy
 ```
 
 ### 🎯 For Cursor Users
+
+**Quick Start** (basic features):
 ```
 cursor://anysphere.cursor-deeplink/mcp/install?name=@pcircle/memesh&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwY2lyY2xlL21lbWVzaCJdfQ==
 ```
 
+**Full Setup** (with A2A support): See [Cursor Setup Guide](#cursor-full-setup) below.
+
+### 🏆 Claude Code Marketplace (Coming Soon)
+```bash
+/plugin install memesh@claude-plugins-official
+```
+
 ---
 
 ## 🚀 2-Minute Quick Start
@@ -226,15 +238,13 @@ The script will:
 - ✅ Check prerequisites (Node.js 20+)
 - ✅ Install dependencies
 - ✅ Build MeMesh
-- ✅ Show you how to activate the plugin
+- ✅ **Auto-configure** `~/.claude/mcp_settings.json`
 
-**Then start Claude Code with:**
+**Then restart Claude Code completely (quit and reopen).**
 
-```bash
-claude --plugin-dir /path/to/claude-code-buddy
-```
+**Done!** MeMesh is now available and ready to use.
 
-**Done!** MeMesh is now available as a plugin.
+> **Note**: The installer automatically configures your MCP settings. No manual configuration needed!
 
 <Note>
   The `--plugin-dir` flag loads your local plugin. For team distribution, see [Plugin Marketplaces](https://code.claude.com/docs/en/plugin-marketplaces) to create a shared marketplace.
@@ -245,12 +255,33 @@ claude --plugin-dir /path/to/claude-code-buddy
 <details>
 <summary><strong>🎯 Cursor Users</strong> (Click to expand)</summary>
 
-Cursor uses the same MCP protocol. You can use the quick install link:
-```
-cursor://anysphere.cursor-deeplink/mcp/install?name=@pcircle/memesh&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwY2lyY2xlL21lbWVzaCJdfQ==
-```
+<h4 id="cursor-full-setup">Cursor Full Setup (with A2A Support)</h4>
+
+The deep link provides basic features. For **full A2A (Agent-to-Agent) support**, manually configure:
+
+1. **Generate a token**:
+   ```bash
+   openssl rand -hex 32
+   ```
+
+2. **Edit Cursor MCP settings** (`~/.cursor/mcp.json` or via Cursor settings):
+   ```json
+   {
+     "mcpServers": {
+       "memesh": {
+         "command": "npx",
+         "args": ["-y", "@pcircle/memesh"],
+         "env": {
+           "MEMESH_A2A_TOKEN": "<your-64-char-hex-token>"
+         }
+       }
+     }
+   }
+   ```
+
+3. **Restart Cursor** and you're set.
 
-**Restart Cursor** and you're set.
+> **Note**: Use the same token across all sessions for A2A to work.
 
 </details>
 
@@ -382,11 +413,41 @@ buddy-remember "auth"  # Returns project-B's auth decisions
 </details>
 
 <details>
-<summary><strong>17 MCP Standard Tools</strong></summary>
+<summary><strong>Smart Memory Query</strong></summary>
+
+Context-aware memory retrieval with intelligent ranking:
+- 🎯 Semantic search across your knowledge base
+- 🏷️ Auto-tagging for better organization
+- 📊 Relevance scoring based on context
+
+</details>
+
+<details>
+<summary><strong>Multi-Session Support (Daemon Mode)</strong></summary>
+
+Run multiple Claude Code sessions sharing the same memory:
+- 🔄 First instance becomes the daemon
+- 🔗 Subsequent instances connect as proxies
+- 📡 Shared knowledge graph across all sessions
+
+</details>
+
+<details>
+<summary><strong>SecretManager</strong></summary>
+
+Securely store API keys and credentials:
+- 🔐 AES-256-GCM encryption
+- 💾 Local SQLite storage (never transmitted)
+- 🔑 Use `buddy-secret-store` and `buddy-secret-get`
+
+</details>
+
+<details>
+<summary><strong>18+ MCP Standard Tools</strong></summary>
 
-Full integration with Model Context Protocol.
+Full integration with Model Context Protocol for seamless Claude Code experience.
 
-See complete list: [ToolDefinitions.ts](src/mcp/ToolDefinitions.ts)
+Use `buddy-help` to see all available commands.
 
 </details>
 
@@ -476,9 +537,9 @@ Think of it as Claude Code + a really good memory + autopilot mode.
 <details>
 <summary><strong>Q: Can I customize it?</strong></summary>
 
-**A:** Absolutely. Prompt templates in `src/core/PromptEnhancer.ts`.
+**A:** Absolutely! MeMesh plugin is fully open source.
 
-Want deeper customization? Fork it, hack it, make it yours. That's the open source way.
+Want deeper customization? Check our [Contributing Guide](docs/CONTRIBUTING.md) or fork the repo and make it yours.
 
 </details>
 

package/README.zh-TW.md

@@ -13,7 +13,7 @@
 [![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
 [![MCP](https://img.shields.io/badge/MCP-1.25.3-purple.svg)](https://modelcontextprotocol.io)
 
-[🚀 快速開始](#-2-分鐘快速開始) • [📖 文檔](docs/) • [🌐 官網](https://memesh.pcircle.ai) • [💬 討論區](https://github.com/PCIRCLE-AI/memesh/discussions)
+[🚀 快速開始](#-2-分鐘快速開始) • [📖 文檔](docs/) • [🌐 GitHub](https://github.com/PCIRCLE-AI/claude-code-buddy) • [💬 討論區](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
 
 ---
 
@@ -105,40 +105,50 @@ buddy-help                       # 需要幫助時
 
 **三個命令。無限可能。**
 
+### 4. 🔐 **安全憑證儲存**
+
+```bash
+buddy-secret-store "openai_key" "sk-..." api_key  # 加密儲存
+buddy-secret-get "openai_key"                      # 取得憑證
+buddy-secret-list                                  # 查看已儲存
+buddy-secret-delete "old_key"                      # 清理舊金鑰
+```
+
+**AES-256-GCM 加密。僅存本地。永不傳輸。**
+
 ---
 
 ## 🚀 安裝選項
 
 選擇你偏好的安裝方式：
 
-### 🏆 官方 Marketplace（即將推出）
-一旦獲得 Anthropic 批准，一行命令即可安裝：
+### ⚡ npm 全域安裝（最簡單）⭐ 推薦
 ```bash
-/plugin install memesh@claude-plugins-official
-```
-
-### ⚡ GitHub Marketplace（現已可用）
-```bash
-# 添加 marketplace
-/plugin marketplace add PCIRCLE-AI/claude-code-buddy
-
-# 安裝 plugin
-/plugin install memesh@pcircle-ai
+npm install -g @pcircle/memesh
+# 自動設定完成！只需重啟 Claude Code。
 ```
 
-### 📦 快速安裝腳本（本地開發推薦）
+### 📦 快速安裝腳本（本地開發用）
 ```bash
 git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
 cd claude-code-buddy
 ./scripts/quick-install.sh
-claude --plugin-dir /path/to/claude-code-buddy
 ```
 
 ### 🎯 Cursor 使用者
+
+**快速安裝**（基本功能）：
 ```
 cursor://anysphere.cursor-deeplink/mcp/install?name=@pcircle/memesh&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwY2lyY2xlL21lbWVzaCJdfQ==
 ```
 
+**完整設定**（支援 A2A）：請參閱下方 [Cursor 完整設定](#cursor-完整設定)。
+
+### 🏆 Claude Code Marketplace（即將推出）
+```bash
+/plugin install memesh@claude-plugins-official
+```
+
 ---
 
 ## 🚀 2 分鐘快速開始
@@ -168,7 +178,7 @@ cd claude-code-buddy
 claude --plugin-dir /path/to/claude-code-buddy
 ```
 
-**完成！**CCB 現在可以作為 plugin 使用了。
+**完成！**MeMesh 現在可以作為 plugin 使用了。
 
 <Note>
   `--plugin-dir` 標記用於載入本地 plugin。如需團隊分發，請參閱 [Plugin Marketplaces](https://code.claude.com/docs/en/plugin-marketplaces) 建立共享的 marketplace。
@@ -179,12 +189,33 @@ claude --plugin-dir /path/to/claude-code-buddy
 <details>
 <summary><strong>🎯 Cursor 使用者</strong>（點擊展開）</summary>
 
-Cursor 使用相同的 MCP 協議。你可以使用快速安裝連結：
-```
-cursor://anysphere.cursor-deeplink/mcp/install?name=@pcircle/memesh&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwY2lyY2xlL21lbWVzaCJdfQ==
-```
+<h4 id="cursor-完整設定">Cursor 完整設定（支援 A2A）</h4>
 
-**重啟 Cursor** 就完成了。
+Deep link 提供基本功能。如需**完整 A2A（Agent-to-Agent）支援**，請手動設定：
+
+1. **生成 token**：
+   ```bash
+   openssl rand -hex 32
+   ```
+
+2. **編輯 Cursor MCP 設定**（`~/.cursor/mcp.json` 或透過 Cursor 設定）：
+   ```json
+   {
+     "mcpServers": {
+       "memesh": {
+         "command": "npx",
+         "args": ["-y", "@pcircle/memesh"],
+         "env": {
+           "MEMESH_A2A_TOKEN": "<你的-64-字元-hex-token>"
+         }
+       }
+     }
+   }
+   ```
+
+3. **重啟 Cursor** 就完成了。
+
+> **注意**：所有 session 需使用相同的 token 才能讓 A2A 正常運作。
 
 </details>
 
@@ -264,13 +295,13 @@ MeMesh 立即回想：
 <details>
 <summary><strong>自動記憶系統</strong></summary>
 
-當你使用 `buddy-do` 時，CCB 會自動記錄：
+當你使用 `buddy-do` 時，MeMesh 會自動記錄：
 - ✅ 任務目標和結果
 - ✅ 技術決策和理由
 - ✅ 遇到的錯誤和解決方案
 - ✅ 開發里程碑
 
-**你不用想記憶的事。CCB 會處理。**
+**你不用想記憶的事。MeMesh 會處理。**
 
 </details>
 
@@ -292,11 +323,41 @@ buddy-remember "auth"  # 回傳 project-B 的 auth 決策
 </details>
 
 <details>
-<summary><strong>17 個 MCP 標準工具</strong></summary>
+<summary><strong>智能記憶查詢</strong></summary>
+
+具備上下文感知的智能記憶檢索：
+- 🎯 知識庫語意搜尋
+- 🏷️ 自動標籤分類
+- 📊 基於上下文的相關性排序
+
+</details>
+
+<details>
+<summary><strong>多 Session 支援（Daemon 模式）</strong></summary>
+
+多個 Claude Code session 共享同一記憶：
+- 🔄 第一個實例成為 daemon
+- 🔗 後續實例作為 proxy 連接
+- 📡 所有 session 共享知識圖譜
+
+</details>
+
+<details>
+<summary><strong>SecretManager 密鑰管理</strong></summary>
+
+安全存儲 API 金鑰和憑證：
+- 🔐 AES-256-GCM 加密
+- 💾 本地 SQLite 存儲（永不傳輸）
+- 🔑 使用 `buddy-secret-store` 和 `buddy-secret-get`
+
+</details>
+
+<details>
+<summary><strong>18+ 個 MCP 標準工具</strong></summary>
 
-完整整合 Model Context Protocol。
+完整整合 Model Context Protocol，提供無縫的 Claude Code 體驗。
 
-查看完整列表：[ToolDefinitions.ts](src/mcp/ToolDefinitions.ts)
+使用 `buddy-help` 查看所有可用指令。
 
 </details>
 
@@ -386,9 +447,9 @@ buddy-remember "auth"  # 回傳 project-B 的 auth 決策
 <details>
 <summary><strong>Q：可以客製化嗎？</strong></summary>
 
-**A：** 當然。提示詞模板在 `src/core/PromptEnhancer.ts`。
+**A：** 當然！MeMesh 外掛程式完全開源。
 
-想更深度客製化？Fork 它、改它、變成你的。這就是開源精神。
+想更深度客製化？查看我們的[貢獻指南](docs/CONTRIBUTING.md)或 fork 此專案。
 
 </details>
 

package/dist/a2a/client/A2AClient.d.ts

@@ -1,7 +1,11 @@
 import type { SendMessageRequest, SendMessageResponse, Task, TaskStatus, AgentCard } from '../types/index.js';
+import { type RetryOptions } from '../../utils/retry.js';
 export declare class A2AClient {
     private registry;
-    constructor();
+    private retryConfig;
+    constructor(retryConfig?: Partial<RetryOptions>);
+    private getAuthHeaders;
+    private isRetryableHttpError;
     sendMessage(targetAgentId: string, request: SendMessageRequest): Promise<SendMessageResponse>;
     getTask(targetAgentId: string, taskId: string): Promise<Task>;
     listTasks(targetAgentId: string, params?: {

package/dist/a2a/client/A2AClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"A2AClient.d.ts","sourceRoot":"","sources":["../../../src/a2a/client/A2AClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EAEnB,IAAI,EACJ,UAAU,EACV,SAAS,EACV,MAAM,mBAAmB,CAAC;AAG3B,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAgB;;IAM1B,WAAW,CACf,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;IAuBzB,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB7D,SAAS,CACb,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5D,OAAO,CAAC,UAAU,EAAE,CAAC;IA2BlB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAsBvD,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAsBxD,cAAc;IAwB5B,mBAAmB,IAAI,MAAM,EAAE;CAGhC"}
+{"version":3,"file":"A2AClient.d.ts","sourceRoot":"","sources":["../../../src/a2a/client/A2AClient.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EAEnB,IAAI,EACJ,UAAU,EACV,SAAS,EACV,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAoF3E,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,WAAW,CAAe;gBAStB,WAAW,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAqC/C,OAAO,CAAC,cAAc;IA+CtB,OAAO,CAAC,oBAAoB;IAuBtB,WAAW,CACf,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;IA8BzB,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC7D,SAAS,CACb,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5D,OAAO,CAAC,UAAU,EAAE,CAAC;IAmClB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA6BvD,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAmCxD,cAAc;IA6B5B,mBAAmB,IAAI,MAAM,EAAE;CAGhC"}