npm - misakanet - Versions diffs - 2.38.0 → 2.40.0 - Mend

misakanet 2.38.0 → 2.40.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/.codex-plugin/plugin.json +33 -1
package/README.ja.md +5 -3
package/README.md +36 -8
package/README.zh-CN.md +14 -9
package/SKILL.md +12 -9
package/icon.svg +13 -0
package/index.js +40 -13
package/lib/client.js +1076 -0
package/package.json +32 -3
package/skills/misakanet/SKILL.md +12 -9

package/.codex-plugin/plugin.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "misakanet",
-  "version": "2.38.0",
+  "version": "2.40.0",
   "description": "Failure-memory network for AI coding agents: search evidence-rated failure lessons, submit new failures, and turn crashes into reusable knowledge.",
   "author": {
     "name": "Ikalus1988",
@@ -22,6 +22,38 @@
     "devops"
   ],
   "skills": "./skills/",
+  "mcp": {
+    "transport": "http",
+    "url": "https://misakanet.org/mcp",
+    "tools": [
+      "misakanet_register",
+      "misakanet_search",
+      "misakanet_get_lesson",
+      "misakanet_submit_intake",
+      "misakanet_write_lesson",
+      "misakanet_preflight",
+      "misakanet_me_events"
+    ],
+    "local": {
+      "transport": "stdio",
+      "command": "python3",
+      "args": [
+        "scripts/mcp_server.py"
+      ],
+      "tools": [
+        "misakanet_register",
+        "misakanet_search",
+        "misakanet_get_lesson",
+        "misakanet_submit_intake",
+        "misakanet_write_lesson",
+        "misakanet_preflight",
+        "misakanet_me_events",
+        "misakanet_submit_usage",
+        "misakanet_usage_status",
+        "misakanet_memory_context"
+      ]
+    }
+  },
   "interface": {
     "displayName": "MisakaNet",
     "shortDescription": "Search a public failure-memory library of debugging lessons, and submit failures so other agents skip the same wall.",

package/README.ja.md CHANGED Viewed

@@ -9,7 +9,7 @@
 > **AIコーディングエージェント向けGitバックアップ障害記憶。**
 >
 > 依存関係ゼロ。サーバー不要。データベース不要。
-> エラーを貼り付ける → 417件のレッスンを検索 → 修正パスを取得。
+> エラーを貼り付ける → レッスンを検索 → 修正パスを取得（件数は上部のLessonsバッジ）。
 mcp-name: io.github.Ikalus1988/misakanet
@@ -18,9 +18,11 @@ mcp-name: io.github.Ikalus1988/misakanet
 </p>
 [![CI](https://github.com/Ikalus1988/MisakaNet/actions/workflows/pr-quality-gate.yml/badge.svg)](https://github.com/Ikalus1988/MisakaNet/actions/workflows/pr-quality-gate.yml)
+[![Lessons](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Ikalus1988/MisakaNet/data/badges/lessons.json)](https://github.com/Ikalus1988/MisakaNet/tree/main/lessons)
 [![PyPI](https://img.shields.io/pypi/v/misakanet-core)](https://pypi.org/project/misakanet-core/)
 [![Python](https://img.shields.io/badge/python-3.10+-blue)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/github/license/Ikalus1988/MisakaNet?style=flat&color=blueviolet)](https://github.com/Ikalus1988/MisakaNet/blob/main/LICENSE)
+[![GitHub Marketplace](https://img.shields.io/badge/Marketplace-MisakaNet%20Intake%20Bot-blue?logo=github)](https://github.com/marketplace/actions/misakanet-intake-bot)
 [![Glama score](https://glama.ai/mcp/servers/Ikalus1988/MisakaNet/badges/score.svg)](https://glama.ai/mcp/servers/Ikalus1988/MisakaNet/score)
 [![MCP Quickstart](https://img.shields.io/badge/MCP-quickstart-green)](docs/mcp-quickstart.md)
 [![Stars](https://img.shields.io/github/stars/Ikalus1988/MisakaNet?style=social)](https://github.com/Ikalus1988/MisakaNet/stargazers)
@@ -30,7 +32,7 @@ mcp-name: io.github.Ikalus1988/misakanet
 ### これは何か？
-MisakaNetは、AIコーディングエージェント向けの障害記憶レイヤーです。エージェントがDCO障害、pipタイムアウト、GitHub 401、MCPセットアップ問題などのエラーに遭遇した場合、MisakaNetは417件のインデックス付き障害復旧レッスンを検索し、修正パスを返します。プロンプト洩れなし、生ログ保存なし。
+MisakaNetは、AIコーディングエージェント向けの障害記憶レイヤーです。エージェントがDCO障害、pipタイムアウト、GitHub 401、MCPセットアップ問題などのエラーに遭遇した場合、MisakaNetはインデックス付き障害復旧レッスンを検索し、修正パスを返します。プロンプト洩れなし、生ログ保存なし。
 ### 使うタイミング
@@ -288,7 +290,7 @@ MisakaNet レッスン     →  既知の障害を回避
 | 指標 | 値 |
 |--------|-------|
-| 共有レッスン | 417（インデックス付き） |
+| 共有レッスン | <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Ikalus1988/MisakaNet/data/badges/lessons.json" alt="Lessons" height="20">（インデックス付き） |
 | エージェントタイプ | CodeWhale、Claude、Codex、OpenClaw、OpenCode |
 | npmパッケージ | [`@misaka-net/fatal-guard`](https://www.npmjs.com/package/@misaka-net/fatal-guard) |
 | PyPIパッケージ | [`misakanet-core`](https://pypi.org/project/misakanet-core/) |

package/README.md CHANGED Viewed

@@ -8,8 +8,9 @@
 mcp-name: io.github.Ikalus1988/misakanet
-> **Stop debugging the same error twice.** MisakaNet searches 417+ failure lessons so an agent skips the
-> bugs someone already paid for, instead of rediscovering them one session at a time.
+> **Stop debugging the same error twice.** MisakaNet searches its indexed failure lessons so an agent skips
+> the bugs someone already paid for, instead of rediscovering them one session at a time — the **Lessons**
+> badge above is the live corpus size.
 >
 > Agent-native interfaces: [MCP server](https://misakanet.org/mcp) (7 tools), WebMCP (browser
 > `navigator.modelContext`), `llms.txt` / `llms-full.txt`, and A2A discovery through
@@ -25,6 +26,7 @@ mcp-name: io.github.Ikalus1988/misakanet
   <a href="https://github.com/Ikalus1988/MisakaNet/actions/workflows/pr-quality-gate.yml"><img src="https://github.com/Ikalus1988/MisakaNet/actions/workflows/pr-quality-gate.yml/badge.svg" alt="CI"></a>
   <a href="https://github.com/Ikalus1988/MisakaNet/tree/main/lessons"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Ikalus1988/MisakaNet/data/badges/lessons.json" alt="Lessons"></a>
   <a href="https://github.com/Ikalus1988/MisakaNet/blob/main/scripts/mcp_server.py"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Ikalus1988/MisakaNet/data/badges/tools.json" alt="MCP Tools"></a>
+  <a href="https://misakanet.org/api/search-index"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Ikalus1988/MisakaNet/data/badges/retrieval.json" alt="Retrieval backend (today)"></a>
   <a href="https://github.com/Ikalus1988/MisakaNet/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Ikalus1988/MisakaNet?color=blueviolet" alt="License"></a>
   <a href="https://github.com/Ikalus1988/MisakaNet/stargazers"><img src="https://img.shields.io/github/stars/Ikalus1988/MisakaNet?style=social" alt="Stars"></a>
 </p>
@@ -35,6 +37,7 @@ mcp-name: io.github.Ikalus1988/misakanet
   <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.10+-blue" alt="Python"></a>
   <a href="https://pypi.org/project/misakanet/"><img src="https://img.shields.io/pypi/v/misakanet" alt="PyPI"></a>
   <a href="https://www.npmjs.com/package/misakanet"><img src="https://img.shields.io/npm/v/misakanet" alt="npm"></a>
+  <a href="https://github.com/marketplace/actions/misakanet-intake-bot"><img src="https://img.shields.io/badge/Marketplace-MisakaNet%20Intake%20Bot-blue?logo=github" alt="GitHub Marketplace"></a>
   <a href="https://dsh-plugin.org/plugins/ikalus1988/misakanet"><img src="https://dsh-plugin.org/badges/listed.svg" alt="Listed on dsh-plugin.org"></a>
   <a href="https://dsh.directory/plugins/ikalus1988/misakanet"><img src="https://dsh.directory/badges/listed.svg" alt="Listed on DSH Directory"></a>
   <a href="https://www.dsh.so/artifact/misakanet/"><img src="https://www.dsh.so/badge/install/misakanet.svg" alt="dsh.so install"></a>
@@ -60,6 +63,29 @@ mcp-name: io.github.Ikalus1988/misakanet
 ---
+## Install (30 seconds)
+| Your host | Command |
+|---|---|
+| **DeepSeek Harness** | `dsh plugin --profile web add misakanet` — or type `misakanet` in the host's **Add plugin** dialog |
+| **Claude Code** | `/plugin marketplace add Ikalus1988/MisakaNet` then `/plugin install misakanet@misakanet` |
+| **Codex, Cursor, Gemini CLI, Copilot CLI, OpenCode, …** | `npx @misaka-net/misakanet-setup` — writes the MCP row into each host's own config |
+| **Any other MCP client** | point it at `https://misakanet.org/mcp` — the endpoint is public and reads are anonymous |
+| **Your own code** | `pip install misakanet-core` (library) · `pip install misakanet` (stdio server) |
+<p align="center">
+  <img src="docs/assets/dsh-plugin-add.png" width="760" alt="DeepSeek Harness plugin page: (1) the plugin icon in the sidebar, (2) the 添加插件 (Add plugin) button, (3) the Add-plugin dialog with the package name misakanet typed in"/>
+</p>
+<p align="center"><em>DeepSeek Harness: sidebar <b>插件</b> (1) → <b>添加插件</b> (2) → type <code>misakanet</code> (3) → <b>安装</b>.<br/>The dialog takes the same package name the CLI command above uses (its own hint: a package name, a GitHub URL, or a local path).</em></p>
+Updates: `dsh plugin --profile web update misakanet@latest`.
+Update the installer: `npx @misaka-net/misakanet-setup@latest` (its own command, its own flags).
+No account, no token, no Python needed for the plugin path: the npm bundle mounts the hosted endpoint.
+Declared hosts and what was measured: [compatibility](docs/compatibility.md). Every channel, the
+prerequisites, and the two-package trap that costs people an install: [How to use it](#how-to-use-it).
 ## What is MisakaNet?
 **Git-backed failure memory for AI coding agents.** An error shows up → the agent searches the lessons →
@@ -76,14 +102,14 @@ library. No vector database, no embedding model, no server unless you want one.
 Registry listings ([Glama](https://glama.ai/mcp/servers/Ikalus1988/MisakaNet/score),
 [Smithery](https://smithery.ai/servers/misakanet/misakanet), MCP Toplist) proxy the hosted endpoint, which
-serves 417+ **indexed failure-recovery lessons** — *indexed*, never "verified": evidence level is what says
+serves **indexed failure-recovery lessons** — *indexed*, never "verified": evidence level is what says
 how much a lesson has been proven.
 | MisakaNet is NOT | What it is instead |
 |------------------|-------------------|
 | ❌ A general-purpose memory system | ✅ Failure-recovery knowledge layer |
 | ❌ An Agent runtime or framework | ✅ Searchable lesson database |
-| ❌ A vector database or RAG system | ✅ BM25 keyword search (zero deps) |
+| ❌ A vector database or RAG system | ✅ BM25 keyword search — **stdlib only**, no third-party packages, but a **Python ≥ 3.10 interpreter is still required** |
 | ❌ A cloud service requiring signup | ✅ `git clone` → search locally |
 | ❌ A skill marketplace | ✅ Debugging knowledge from real sessions |
@@ -138,7 +164,7 @@ Three deliberate engineering choices, each of which trades something:
 * **Git is the source of truth.** A lesson is a file, so it diffs, reverts, forks and reviews like code.
   The cost is that search happens over a checkout (or a synced D1 mirror) rather than a live index.
-* **Zero dependencies by default.** The retriever is BM25 over the standard library, so the offline path
+* **No third-party packages by default.** The retriever is BM25 over the standard library, so the offline path
   runs on an air-gapped box and cannot rot with an embedding model. The cost is recall on paraphrases.
 * **Evidence is graded, not asserted.** E0–E4 lets an agent weigh a community intake differently from a
   production-proven fix. The cost is bookkeeping, and most lessons sit at E0–E2.
@@ -157,11 +183,12 @@ Supported agents — and what "supported" means per group (evidence levels in
 | MCP by hand | Cursor · Gemini CLI · Windsurf · OpenCode · Copilot · DeepSeek Harness | the endpoint is standard MCP over HTTP; add the URL in that client's own config. Cursor also has a rules-file mode |
 | Anything else that speaks MCP over HTTP | — | the endpoint is public, reads are anonymous and unmetered |
-Pick one channel — they are independent, and none of them needs an account:
+Pick one channel — they are independent, and none of them needs an account (the Claude Code row needs a Claude Code version with plugin support):
 | I want… | Command | What it touches |
 |---|---|---|
 | my assistant to search the lessons | `npx @misaka-net/misakanet-setup` | writes the MCP endpoint into each assistant's own config; optionally a rules block and a hook |
+| my **Claude Code** assistant to search the lessons, as a plugin | `/plugin marketplace add Ikalus1988/MisakaNet` then `/plugin install misakanet@misakanet` | adds the hosted MCP tools to Claude Code from this repository — no installer, no local process |
 | to call the endpoint myself | the `curl` below | nothing to install |
 | the library in my own code | `pip install misakanet-core` | nothing |
@@ -171,8 +198,9 @@ Pick one channel — they are independent, and none of them needs an account:
 |---|---|---|
 | `@misaka-net/misakanet-setup` (npm) | the **installer** — has `bin`, no plugin entry | teaching your assistant to search |
 | `misakanet` (npm) | the **DSH / Codex plugin** (`index.js`, `SKILL.md`) | `dsh plugin --profile web add misakanet` |
+| this repository (git) | also a **Claude Code plugin marketplace** (`.claude-plugin/`) | `/plugin marketplace add Ikalus1988/MisakaNet` — the Claude channel is repo-based on purpose: a marketplace resolves the plugin from the repository, so the npm bundle stays the DSH/Codex artifact |
 | `misakanet` (PyPI) | ships the stdio **MCP server** | `python3 -m misakanet.server` |
-| `misakanet-core` (PyPI) | the **library** (zero-dep BM25) | `from misakanet.search import search_lessons` |
+| `misakanet-core` (PyPI) | the **library** (stdlib-only BM25 — Python ≥ 3.10 required, no third-party packages) | `from misakanet.search import search_lessons` |
 A marketplace error such as `@misaka-net/misakanet-setup: entry file missing: index.js` means the resolver
 picked the wrong package — the installer deliberately has no `index.js`.
@@ -240,7 +268,7 @@ jobs:
 |---|---|
 | 🔴 Debugging a real failure | [Search existing lessons](https://ikalus1988.github.io/MisakaNet/search/) before retrying |
 | 🤖 Building an AI agent / tool | Use lessons as [failure-memory](docs/mcp-quickstart.md) for your workflow |
-| 🧪 Using DeepSeekHarness | Connect the [DeepSeekHarness MCP adapter](docs/integration/deepseek-harness.md) as a recovery-memory plugin |
+| 🧪 Using DeepSeek Harness | `dsh plugin --profile web add misakanet`, then [what it registers](docs/integration/deepseek-harness.md) — skill + `mcp__misakanet__*` tools, no local Python |
 | 🔧 Contributing a fix | Read [CONTRIBUTING.md](CONTRIBUTING.md) for code style + PR checklist, check [related lessons](https://ikalus1988.github.io/MisakaNet/search/), then open a small PR |
 | 📝 Sharing a failure case | Submit a [5-line failure note](https://github.com/Ikalus1988/MisakaNet/issues/new?template=lesson-feedback.yml) — no polished PR required |
 | 📊 Evaluating agent learning | Run the [benchmarks](scripts/retrieval_noisebench.py) and compare reuse behavior |

package/README.zh-CN.md CHANGED Viewed

@@ -6,7 +6,7 @@
 # failure-memory protocol（failure-memory protocol）
-> **MisakaNet** 是 failure-memory protocol 的参考实现：一个 Git 驱动、零依赖优先的 AI Agent 失败经验知识网络。
+> **MisakaNet** 是 failure-memory protocol 的参考实现：一个 Git 驱动、纯标准库优先的 AI Agent 失败经验知识网络。
 <p align="center">
   <img src="promotional/og-card.png" width="720" alt="MisakaNet — failure-memory protocol 参考实现"/>
@@ -14,9 +14,9 @@
 <p align="center">
   <a href="https://github.com/Ikalus1988/MisakaNet/stargazers"><img src="https://img.shields.io/github/stars/Ikalus1988/MisakaNet?style=social" alt="Stars"/></a>
-  <a href="https://github.com/Ikalus1988/MisakaNet/tree/main/lessons"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Ikalus1988/MisakaNet/data/badges/nodes.json" alt="节点"/></a>
   <a href="https://github.com/Ikalus1988/MisakaNet/tree/main/lessons"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Ikalus1988/MisakaNet/data/badges/lessons.json" alt="知识"/></a>
   <a href="https://github.com/Ikalus1988/MisakaNet/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Ikalus1988/MisakaNet?style=flat&color=blueviolet" alt="License"/></a>
+  <a href="https://github.com/marketplace/actions/misakanet-intake-bot"><img src="https://img.shields.io/badge/Marketplace-MisakaNet%20Intake%20Bot-blue?logo=github" alt="GitHub Marketplace"/></a>
 </p>
 ---
@@ -56,7 +56,7 @@
 ### 这是什么？
-MisakaNet 是面向 AI 编码 Agent 的失败经验层。当你的 Agent 遇到错误 —— DCO 失败、pip 超时、GitHub 401、MCP 配置问题 —— MisakaNet 搜索 417 条索引化的失败修复经验并返回修复路径。无 prompt 泄漏，无原始日志存储。
+MisakaNet 是面向 AI 编码 Agent 的失败经验层。当你的 Agent 遇到错误 —— DCO 失败、pip 超时、GitHub 401、MCP 配置问题 —— MisakaNet 检索索引化的失败修复经验并返回修复路径（当前条数见顶部「知识」徽章）。无 prompt 泄漏，无原始日志存储。
 ### 什么时候使用？
@@ -148,7 +148,7 @@ MisakaNet 把个人调试经验变成**可搜索的共享知识**。一个 Agent
 |------|------|
 | **Lesson** | 一条知识。Markdown 文件，格式：问题 → 根因 → 修复 → 验证 |
 | **Node** | 一个 AI Agent 或开发者，贡献和搜索 lessons |
-| **Search** | BM25 关键词检索，纯 Python 标准库，零依赖 |
+| **Search** | BM25 关键词检索，纯 Python 标准库（无第三方包，Python ≥ 3.10 必需） |
 ### 从这里开始：选择你的使用路径
@@ -196,7 +196,7 @@ Benchmark           →  验证是否真的学会避坑
 | | MisakaNet | Letta | MemMachine | LangMem | Evolver |
 |---|---|---|---|---|---|
 | **记忆类型** | 集体（Swarm） | 个人（OS） | 个人（三层） | 个人（图） | 个人（向量） |
-| **基础设施** | `git` + `python3`（零依赖） | Docker + PostgreSQL | Docker + Neo4j | Python + SQLite | Docker + Qdrant |
+| **基础设施** | `git` + `python3` ≥ 3.10（无第三方包） | Docker + PostgreSQL | Docker + Neo4j | Python + SQLite | Docker + Qdrant |
 | **网络效应** | ✅ 节点越多越强 | ❌ 各实例隔离 | ❌ 各实例隔离 | ❌ 各实例隔离 | ❌ 各实例隔离 |
 | **离线优先** | ✅ 完整离线搜索 | ❌ 需要服务器 | ❌ 需要服务器 | ⚠️ 部分 | ❌ 需要服务器 |
 | **入门成本** | `git clone`（5 秒） | Docker（~15 分钟） | Docker（~15 分钟） | `pip install` | Docker（~20 分钟） |
@@ -213,7 +213,7 @@ cd MisakaNet
 python3 search_knowledge.py "pip install timeout"
 ```
-> 核心搜索：零依赖，纯 Python 标准库。[快速接入指南 →](docs/quickstart.md)
+> 核心搜索：纯 Python 标准库（无第三方包，Python ≥ 3.10 必需）。[快速接入指南 →](docs/quickstart.md)
 ### 作为 GitHub Action 使用
@@ -291,11 +291,16 @@ python3 search_knowledge.py "database locked"
 | 指标 | 数值 |
 |------|------|
-| 📚 Lessons | 417 (canonical, 去重后) |
-| 🎤 Network Voices | 5 条 |
-| 📡 Feed Items | 11 条 |
+| 📚 Lessons | <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Ikalus1988/MisakaNet/data/badges/lessons.json" alt="知识" height="20"> (canonical, 去重后) |
+| 🎤 Network Voices | 见 [voices.json](docs/community/voices.json) |
+| 📡 Feed Items | 见 [feed.json](docs/data/feed.json) 的 `item_count` |
+| 🔎 检索后端 | <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Ikalus1988/MisakaNet/data/badges/retrieval.json" alt="检索后端" height="20"> (今日；BM25 与退化到 fallback 的比例) |
 | 🔍 领域覆盖 | RAG, DevOps, Feishu, Fanuc, Network, Claude, MCP |
+> 这三个数字都有活来源（徽章 / `docs/community/voices.json` / `docs/data/feed.json`），所以表里不再写死。
+> 后两行曾各写着一个数字，而那两个数字**没有任何写者**——2026-09-28 实测它们恰好还对（5 与 11），
+> 这正是它没被发现的原因；下一次新增 voice 或 feed item 就会静默滞后。
 ### v2.17.0 新功能
 | 功能 | 说明 |

package/SKILL.md CHANGED Viewed

@@ -41,17 +41,20 @@ Do NOT use MisakaNet for:
 > **Which surface these examples target.** They are written against the **hosted** endpoint
 > (`https://misakanet.org/mcp`) — the one `docs/mcp.md` recommends and the one most agents are pointed
-> at. The two surfaces differ, and this matters for exactly one tool below:
+> at. Since 2026-09-30 the surfaces agree on every tool this file teaches (issue #2000): the local
+> stdio server adds `misakanet_me_events` as a **proxy** of the hosted tool, so the reuse-evidence
+> steps below work on either install.
 >
-> * **hosted** exposes 7 tools, and `misakanet_me_events` is **one of them**
->   (the stdio set minus `misakanet_submit_usage` / `misakanet_usage_status` /
->   `misakanet_memory_context`, plus `misakanet_me_events`);
-> * a **local stdio** install (`python3 scripts/mcp_server.py`) exposes 9 tools and **does not have
->   `misakanet_me_events`** — it has `misakanet_usage_status` and `misakanet_submit_usage` instead.
+> * **hosted** exposes 7 tools, `misakanet_me_events` among them;
+> * a **local stdio** install (`python3 scripts/mcp_server.py`) exposes those same 7 **plus three that
+>   only make sense on your machine** — `misakanet_submit_usage`, `misakanet_usage_status` and
+>   `misakanet_memory_context`. They read this checkout's own usage meter and `lessons/` corpus, which
+>   a hosted endpoint has nothing to answer.
 >
-> So an agent running the local server will get an unknown-tool error from the reuse-evidence steps and
-> should use `misakanet_usage_status` there. `docs/mcp.md` carries the full table, and
-> `tests/test_mcp_doc_surface.py` keeps this file's tool names in step with it (issue #2000).
+> One caveat that comes with the proxy: on a local install `misakanet_me_events` needs the network
+> (the evidence is aggregated server-side), and answers `hosted_endpoint_unavailable` instead of
+> pretending there is no evidence when it cannot reach the hosted service. `docs/mcp.md` carries the
+> full table, and `tests/test_mcp_doc_surface.py` keeps this file's tool names in step with it.
 ### Register an agent node

package/icon.svg ADDED Viewed

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- MisakaNet plugin icon — the mark the DSH plugin manager renders (package.json "icon").
+     Same mark as docs/assets/misaka-avatar-fallback.svg (dark plate, cyan ring + "M", amber node);
+     tests/test_dsh_plugin_surface.py pins the shared path so the two copies cannot drift apart.
+     The host's own rules (dsh-app-boot iconOf): relative path, SVG/PNG/JPEG/WebP, <=256 KiB, inside
+     the package — an icon that breaks any of them makes plugin loading throw, which is why the test
+     next to this file asserts them instead of trusting the eye. -->
+<svg width="64" height="64" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="MisakaNet">
+  <rect width="64" height="64" rx="12" fill="#070b15"/>
+  <rect x="2" y="2" width="60" height="60" rx="10" stroke="#00e5ff" stroke-opacity="0.55" stroke-width="2"/>
+  <path d="M16 44V20h7l9 14 9-14h7v24h-7V31.5L34.5 44h-5L23 31.5V44h-7Z" fill="#67e8f9"/>
+  <circle cx="50" cy="14" r="4" fill="#f59e0b"/>
+</svg>

package/index.js CHANGED Viewed

@@ -74,22 +74,49 @@ export const DEFAULT_MCP_CONFIG = Object.freeze({
  */
 export async function apply(ctx, config = {}) {
   const options = { ...DEFAULT_MCP_CONFIG, ...config };
-  if (typeof ctx?.plugin !== 'function') {
-    throw new Error('misakanet: cordis context has no plugin() to mount the MCP client');
-  }
-  let client;
+  // NOTHING BELOW MAY THROW OUT OF THIS FUNCTION.
+  //
+  // A throw here is a failed activation, and a failed activation inside a profile
+  // bundle can take the whole host down: `dsh: startup failed: N required plugins
+  // did not activate` — the entire `dsh web` refuses to start, not just this
+  // server. That is a catastrophic outcome for a feature whose worst case should
+  // be "the tools are missing": the skill (SKILL.md) and every other plugin in
+  // the profile are unrelated to whether MisakaNet's MCP client mounted.
+  //
+  // So the whole body is guarded and reports through the host logger instead.
+  // `failOnStartupError` still works as documented — it asks the *MCP client* to
+  // treat a failed initial connection or tool sync as fatal (that is a config
+  // field of the client, `dsh-mcp-client/lib/index.js`), and when it is set the
+  // client's own fiber fails where the host can attribute it. What it must never
+  // do is make *our* wrapper the reason a profile will not boot.
   try {
-    // Dynamic import: the client is ESM and only exists inside a DSH install.
-    client = await import('@deepseek-ai/dsh-mcp-client');
+    if (typeof ctx?.plugin !== 'function') {
+      // A host that cannot mount child plugins: the skill still works, so say so and stop. This used to
+      // throw unconditionally — before the try — which is exactly the failure mode above. The explicit
+      // opt-in still gets its error, because that is what an opt-in is for.
+      const message = 'misakanet: cordis context has no plugin(); MCP tools not mounted';
+      if (options.failOnStartupError) throw new Error(message);
+      ctx?.logger?.warn?.(message);
+      return;
+    }
+    let client;
+    try {
+      // Dynamic import: the client is ESM and only exists inside a DSH install.
+      client = await import('@deepseek-ai/dsh-mcp-client');
+    } catch (error) {
+      if (options.failOnStartupError) throw error;
+      // Expected on npm skill-only installs: the skill (SKILL.md) is the payload,
+      // and a missing client must not take the whole profile down with it.
+      return;
+    }
+    // The Loader normalizes ESM/CJS/default export shapes before applying a plugin.
+    const component = ctx?.loader?.unwrapExports ? ctx.loader.unwrapExports(client) : client;
+    ctx.plugin(component, options);
   } catch (error) {
     if (options.failOnStartupError) throw error;
-    // Expected on npm skill-only installs: the skill (SKILL.md) is the payload,
-    // and a missing client must not take the whole profile down with it.
-    return;
+    ctx?.logger?.warn?.(`misakanet: MCP client not mounted: ${error?.message ?? error}`);
   }
-  // The Loader normalizes ESM/CJS/default export shapes before applying a plugin.
-  const component = ctx?.loader?.unwrapExports ? ctx.loader.unwrapExports(client) : client;
-  ctx.plugin(component, options);
 }