i-repo 2.10.0 → 2.10.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i-repo",
-  "version": "2.10.0",
+  "version": "2.10.1",
   "description": "Modern CLI for ConMas i-Reporter - Built for humans and AI",
   "type": "module",
   "bin": {

package/plugins/README.md

@@ -11,6 +11,11 @@ i-Repo GEMBA OS をはじめとする消費者は、これらを npm 依存（`n
 > インストーラが `lib/` ごと配布し、プラグインは `./lib/...` を相対 require する（write 経路は lib 非依存）。
 > **プラグインを更新したら必ずインストーラを再実行すること** — アプリ/CLI が呼ぶのは
 > `~/.i-repo/plugins/` のインストール済み実体であり、リポジトリ正本ではない。
+>
+> **実体を変えたら必ず `--plugin-schema` の `version` を上げること。** 下流の消費者（i-Repo GEMBA OS 等）は
+> この実体を**公開ミラーへ再配布**し、その更新検知を `version` ＋ SHA256 で行う。版番据え置きのまま中身だけ
+> 変えると、消費アプリが「更新あり」を検知できず旧版を配り続ける（過去に mongo で版番据え置きの実体差分、
+> archive で再配布漏れによる版ズレが起きた）。npm 公開後、消費側は依存を上げてミラーを再同期する必要がある。
 
 ## 同梱プラグイン
 

package/scripts/gen-agents-md.mjs

@@ -61,7 +61,9 @@ Codex CLI）は、配信のたびに更新される機械可読カタログを
 3. \`~/.i-repo/catalog/runs/<batchId>.json\` … 実行台帳（\`delivered:true\` が配信成功）
 
 MCP ブリッジ（\`i-repo-gemba-os\`）が使えるなら、同じ情報を \`gemba_catalog\` / \`gemba_describe\` /
-\`gemba_runs\` ツールで取得できます。
+\`gemba_runs\` ツールで、読み返しは \`<plugin>_query\`、配信結果は \`gemba_receipt\` / \`gemba_health\` で取得できます。
+帳票の成果物（PDF/Excel/添付画像）は \`gemba_artifacts\`（一覧）→ \`gemba_read_artifact\`（画像は image、
+その他は resource(blob) で返す。ローカルにある分のみ・上限あり）で扱えます。
 
 ## 2. 着地ストアと読み返し対応
 

package/scripts/irepo-mcp.mjs

@@ -398,7 +398,7 @@ async function runQuery(plugin, args) {
     if (res.status !== 0 && (stderrText.includes("Cannot find module") || stderrText.includes("MODULE_NOT_FOUND")
         || stderrText.includes("no such file"))) {
       const pluginPath = join(PLUGIN_DIR, `i-repo-${plugin}`);
-      return errResult(`プラグインが見つかりません: ${pluginPath} — plugins/install.sh を再実行してください`);
+      return errResult(`プラグインが見つかりません: ${pluginPath} — プラグインインストーラ（install.sh / install.ps1。npm 同梱なら node_modules/i-repo/plugins/）を再実行してください`);
     }
     let stderrObj = null;
     try { stderrObj = JSON.parse(stderrText.split("\n").pop()); } catch {}