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

misakanet 2.38.0 → 2.39.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 (7) hide show

package/.codex-plugin/plugin.json +33 -1
package/README.ja.md +5 -3
package/README.md +9 -6
package/README.zh-CN.md +14 -9
package/SKILL.md +12 -9
package/package.json +2 -2
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.39.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>
@@ -76,14 +79,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 +141,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.
@@ -172,7 +175,7 @@ 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` |
 | `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`.

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/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "misakanet",
-  "version": "2.38.0",
+  "version": "2.39.0",
   "license": "Apache-2.0",
   "description": "MisakaNet failure-memory skill — evidence-rated failure lessons for AI agents. DSH bundle: registers the MCP tools as mcp__misakanet__* (misakanet_search/get_lesson/…), served by the public Streamable HTTP endpoint https://misakanet.org/mcp — live tools from an npm install, in any profile, with no local python. A profile that prefers the repo's own stdio server can override the bundle row.",
   "files": [
@@ -51,7 +51,7 @@
     "preview": "wrangler dev"
   },
   "devDependencies": {
-    "wrangler": "^4.134.0"
+    "wrangler": "^4.144.0"
   },
   "overrides": {
     "sharp": "0.35.4"

package/skills/misakanet/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