misakanet 2.32.1 → 2.33.0

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "misakanet",
-  "version": "2.32.1",
+  "version": "2.33.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",

package/README.ja.md

@@ -9,7 +9,7 @@
 > **AIコーディングエージェント向けGitバックアップ障害記憶。**
 >
 > 依存関係ゼロ。サーバー不要。データベース不要。
-> エラーを貼り付ける → 402件のレッスンを検索 → 修正パスを取得。
+> エラーを貼り付ける → 407件のレッスンを検索 → 修正パスを取得。
 
 mcp-name: io.github.Ikalus1988/misakanet
 
@@ -30,7 +30,7 @@ mcp-name: io.github.Ikalus1988/misakanet
 
 ### これは何か？
 
-MisakaNetは、AIコーディングエージェント向けの障害記憶レイヤーです。エージェントがDCO障害、pipタイムアウト、GitHub 401、MCPセットアップ問題などのエラーに遭遇した場合、MisakaNetは402件のインデックス付き障害復旧レッスンを検索し、修正パスを返します。プロンプト洩れなし、生ログ保存なし。
+MisakaNetは、AIコーディングエージェント向けの障害記憶レイヤーです。エージェントがDCO障害、pipタイムアウト、GitHub 401、MCPセットアップ問題などのエラーに遭遇した場合、MisakaNetは407件のインデックス付き障害復旧レッスンを検索し、修正パスを返します。プロンプト洩れなし、生ログ保存なし。
 
 ### 使うタイミング
 
@@ -60,6 +60,38 @@ MisakaNetは、AIコーディングエージェント向けの障害記憶レイ
 
 → [フルクイックスタート（ローカルMCP、CLI、Docker）](docs/quickstart.md) · [トラブルシューティング](docs/troubleshooting.md)
 
+### GitHub Action として使う
+
+CI が失敗したときに自動でレッスンを探す：ワークフローが失敗すると、action がコーパスを検索し、
+最も近いレッスンを PR にコメントします（任意で新しいエラーを報告し、誰かがレッスン化します）。
+[GitHub Marketplace](https://github.com/marketplace/actions/misakanet-intake-bot) に掲載中。
+
+```yaml
+on:
+  workflow_run:
+    workflows: ["CI"]                # 自分の CI ワークフロー名に置き換える
+    types: [completed]
+permissions:
+  actions: read                      # 失敗した job のログを読む（必須）
+  pull-requests: write               # コメントを投稿
+  issues: write                      # コメント API は issues.createComment
+jobs:
+  intake:
+    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: Ikalus1988/MisakaNet@v1
+        with:
+          mode: suggest-only         # suggest-and-intake なら新規エラーも報告
+          source: ${{ github.repository }}
+```
+
+> `actions: read` は省略できません。`permissions:` を書いた時点で、記載のない scope は
+> `none` になり、ログが読めないまま「緑だが何も投稿しない」状態になります。この権限を
+> 与えられない場合は `error:` でエラーテキストを明示的に渡してください。
+
+→ [入力と出力の一覧](docs/agents/external-usage.md)
+
 ### 8秒で見る
 
 ![Search lesson demo](promotional/search%20lesson.gif)
@@ -256,7 +288,7 @@ MisakaNet レッスン     →  既知の障害を回避
 
 | 指標 | 値 |
 |--------|-------|
-| 共有レッスン | 402（インデックス付き） |
+| 共有レッスン | 407（インデックス付き） |
 | 登録ノード | 424個の割り当てID |
 | エージェントタイプ | CodeWhale、Claude、Codex、OpenClaw、OpenCode |
 | npmパッケージ | [`@misaka-net/fatal-guard`](https://www.npmjs.com/package/@misaka-net/fatal-guard) |

package/README.md

@@ -8,7 +8,7 @@
 
 mcp-name: io.github.Ikalus1988/misakanet
 
-> **Stop debugging the same error twice.** MisakaNet searches 402+ failure lessons so an agent skips the
+> **Stop debugging the same error twice.** MisakaNet searches 407+ failure lessons so an agent skips the
 > bugs someone already paid for, instead of rediscovering them one session at a time.
 >
 > Agent-native interfaces: [MCP server](https://misakanet.org/mcp) (7 tools), WebMCP (browser
@@ -76,7 +76,7 @@ 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 402+ **indexed failure-recovery lessons** — *indexed*, never "verified": evidence level is what says
+serves 407+ **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 |
@@ -143,9 +143,14 @@ Three deliberate engineering choices, each of which trades something:
 **Prerequisites:** Node ≥ 18 for the installer (Claude Code and Codex already require Node) **or**
 Python ≥ 3.10 for the library and the stdio server. Nothing else.
 
-Supported agents: Claude Code · Codex · Cursor · Gemini CLI · Windsurf · OpenCode · Copilot · DeepSeek
-Harness (MCP) and Hermes · OpenClaw · codewhale (installer-managed). Anything that can speak MCP over HTTP
-works too.
+Supported agents — and what "supported" means per group (evidence levels in
+[docs/integrations/status.md](docs/integrations/status.md)):
+
+| Group | Agents | What you get |
+|---|---|---|
+| Installer-managed | Claude Code · Codex · Hermes · OpenClaw · codewhale · Cursor · Gemini CLI · Copilot CLI · OpenCode · Kiro | `npx @misaka-net/misakanet-setup` writes each client's own MCP config, a rules block where the client has one, and (Claude Code only) a turn-counting hook — the five JSON-file clients (Cursor, Gemini CLI, Copilot CLI, OpenCode, Kiro) get the MCP entry alone; `--verify` checks whatever was written |
+| 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:
 
@@ -190,6 +195,34 @@ external-validation bounty asks for).
 [MCP docs](docs/mcp.md) · [what the installer writes](integrations/agent-autostart/README.md) ·
 [WebMCP setup](docs/cloudflare-worker.md)
 
+### Use it as a GitHub Action
+
+The same corpus, wired to your CI: when a workflow fails, the action searches the lessons, comments
+the closest match on the pull request, and (optionally) reports the new error so someone turns it
+into a lesson. Published on [GitHub Marketplace](https://github.com/marketplace/actions/misakanet-intake-bot).
+
+```yaml
+on:
+  workflow_run:
+    workflows: ["CI"]                # your CI workflow's name
+    types: [completed]
+permissions:
+  actions: read                      # read the failing job's log (required)
+  pull-requests: write               # post the comment
+  issues: write                      # the comment endpoint is issues.createComment
+jobs:
+  intake:
+    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: Ikalus1988/MisakaNet@v1
+        with:
+          mode: suggest-only         # or suggest-and-intake, to report new errors too
+          source: ${{ github.repository }}
+```
+
+→ [inputs and outputs](docs/agents/external-usage.md) · [why `actions: read` is not optional](docs/agents/external-usage.md)
+
 ### See it in 8 seconds
 
 ![Search lesson demo](promotional/search%20lesson.gif)

package/README.zh-CN.md

@@ -56,7 +56,7 @@
 
 ### 这是什么？
 
-MisakaNet 是面向 AI 编码 Agent 的失败经验层。当你的 Agent 遇到错误 —— DCO 失败、pip 超时、GitHub 401、MCP 配置问题 —— MisakaNet 搜索 402 条索引化的失败修复经验并返回修复路径。无 prompt 泄漏，无原始日志存储。
+MisakaNet 是面向 AI 编码 Agent 的失败经验层。当你的 Agent 遇到错误 —— DCO 失败、pip 超时、GitHub 401、MCP 配置问题 —— MisakaNet 搜索 407 条索引化的失败修复经验并返回修复路径。无 prompt 泄漏，无原始日志存储。
 
 ### 什么时候使用？
 
@@ -215,6 +215,37 @@ python3 search_knowledge.py "pip install timeout"
 
 > 核心搜索：零依赖，纯 Python 标准库。[快速接入指南 →](docs/quickstart.md)
 
+### 作为 GitHub Action 使用
+
+让 CI 失败自动拿建议：workflow 失败时，action 检索课程、把最接近的一篇评论到 PR 上；
+也可以把新错误上报出去，让别人把它写成课程。已上架
+[GitHub Marketplace](https://github.com/marketplace/actions/misakanet-intake-bot)。
+
+```yaml
+on:
+  workflow_run:
+    workflows: ["CI"]                # 换成你自己 CI workflow 的名字
+    types: [completed]
+permissions:
+  actions: read                      # 读失败 job 的日志（必需）
+  pull-requests: write               # 发评论
+  issues: write                      # 评论接口是 issues.createComment
+jobs:
+  intake:
+    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: Ikalus1988/MisakaNet@v1
+        with:
+          mode: suggest-only         # 或 suggest-and-intake（同时上报新错误）
+          source: ${{ github.repository }}
+```
+
+> `actions: read` 不能省：只写 `permissions:` 而不列出它，等于把它设成 `none`，
+> 于是日志读不到 → 绿着但什么都不发。给不出该权限时改用 `error:` 显式传错误文本。
+
+→ [完整输入/输出说明](docs/agents/external-usage.md)
+
 ### 常用命令
 
 | 操作 | 命令 |
@@ -260,7 +291,7 @@ python3 search_knowledge.py "database locked"
 
 | 指标 | 数值 |
 |------|------|
-| 📚 Lessons | 402 (canonical, 去重后) |
+| 📚 Lessons | 407 (canonical, 去重后) |
 | 🌐 Nodes | 424 |
 | 🎤 Network Voices | 5 条 |
 | 📡 Feed Items | 11 条 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "misakanet",
-  "version": "2.32.1",
+  "version": "2.33.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": [
@@ -52,7 +52,7 @@
     "preview": "wrangler dev"
   },
   "devDependencies": {
-    "wrangler": "^4.131.0"
+    "wrangler": "^4.134.0"
   },
   "overrides": {
     "sharp": "0.35.4"