Wrapper installs to shared ~/bin — cross-marketplace same-name binary collision surface (verify follow-up from #112)

[kiki830621]

Problem

三個 MCP wrapper 安裝到共享 ~/bin/<BinaryName> + 全域 sidecar。若使用者同時啟用兩個 marketplace 的同名 plugin（如遷移過渡期的 psychquant 與 macdoc 版 che-word-mcp），兩個 MCP server 會註冊在同一 binary/sidecar 上互相干擾；手動安裝的同名 binary 也會被覆寫。

Expected

Plugin-scoped 安裝目錄（如 ${CLAUDE_PLUGIN_ROOT}/cache/ 或 ~/.cache/<plugin>/bin/），或至少偵測 + 警告碰撞。

---

Source: verify #112 R1(codex)+R2(regression) follow-up finding — report: #115 (comment)

---

Current Status

Phase: closed
Last updated: 2026-07-02 by idd-all batch

PR #122（stacked on #121）。Verify: 6-AI PASS（DA-1 反駁 → plugin-level .bin-cache 修訂 + kill test）。

[kiki830621]

Diagnosis

Type

feature（安裝隔離）

Root Cause / Analysis

三個 wrapper 安裝到共享 ~/bin/<BinaryName> + 全域 sidecar。碰撞情境：(a) 兩個 marketplace 的同名 plugin（遷移過渡期 psychquant vs macdoc 的 che-word-mcp）在同一 binary/sidecar 上互踩版本；(b) 使用者手動安裝的同名 binary 被覆寫。

方案選擇（2+ 有效做法，本 diagnosis 明確 pick）：

1. $PLUGIN_ROOT/.bin-cache/（plugin 自己的 cache 目錄內）— 選這個：collision-free by construction（每 marketplace×plugin×版本自有一份）、零路徑解析、plugin 更新時 cache 汰換 = 乾淨生命週期（重新下載有完整驗證鏈把關，成本數秒）
2. ~/.cache/<derived-marketplace>-<plugin>/bin — 需從 PLUGIN_ROOT 路徑解析 marketplace 名，脆弱於 cache 佈局變更
3. 保留 ~/bin + 碰撞偵測警告 — 治標

Impact

• wrapper ×3（INSTALL_DIR 常數 + 遷移註記）
• shells bump（word 3.20.1→3.20.2、pdf/pptx 0.1.1→0.1.2，Harden che-word-mcp wrapper with sha256 + code-signature verification (security follow-up from #112 push review) #116 解耦後 shell-only bump 自由）+ CHANGELOG + marketplace.json
• 舊 ~/bin/<Binary> 殘留：不主動刪（可能是使用者手動裝的）— README 註記

Strategy

• wrapper ×3：INSTALL_DIR="$PLUGIN_ROOT/.bin-cache"（sidecar 同遷）
• 首次啟動註記舊 ~/bin 副本仍在（stderr 一行，不刪）
• shells bump ×3 + CHANGELOG + marketplace.json 同步
• E2E：fresh install 到 .bin-cache、快路徑、雙 marketplace 模擬（兩個 PLUGIN_ROOT 各自為政）

Conflict Class

C_shared_module_coord — 同 #116 資源（3 wrappers + marketplace.json）；batch 已序列化，本 lane 疊在 #116 branch 上（stacked PR）。

Complexity

Plan — Layer P：decision-heavy（3 方案）+ 安裝路徑為 risk-sensitive 邊界。
[Plan tier deliberation skipped under unattended mode — /idd-all orchestrator]

Risks

• Claude Code plugin cache 更新時清掉 .bin-cache → 重新下載（設計內，驗證鏈把關）
• 既有使用者升級後 binary「搬家」：舊 ~/bin 殘留不影響新路徑運作

Residue

(none)

Vagueness Pre-check

• V1: 2、V4: 2 — issue Expected 已指名 plugin-scoped 方向；驗收可 E2E
• Triggered: no
  [unattended mode — /idd-all orchestrator]

[kiki830621]

Implementation Plan

• wrapper ×3：INSTALL_DIR → $PLUGIN_ROOT/.bin-cache（sidecar 同遷）
• legacy ~/bin 註記（不刪、stderr 一次）
• shells bump（3.20.2 / 0.1.2 ×2）+ CHANGELOG + marketplace.json
• .gitignore：plugins/*/.bin-cache/
• E2E ×4（fresh install、快路徑、雙 marketplace 隔離、ignore 規則）

Implementation Complete

Checklist (synced from TaskList)

• 全部完成 → branch idd/117-plugin-scoped-install（stacked on Harden che-word-mcp wrapper with sha256 + code-signature verification (security follow-up from #112 push review) #116 branch；PR Decouple plugin shell version from binary release tag (binary_version field) #121 merge 後 GitHub 自動 retarget）

Changes

• feat: plugin-scoped binary install dir (.bin-cache) replaces shared ~/bin (#117)

Scope Compliance

11 檔（3 wrappers、3 plugin.json、3 CHANGELOG、marketplace.json、.gitignore）全數可追溯 issue。

Next: verification pending

[unattended mode — /idd-all orchestrator]

[kiki830621]

Verify: #117

Engine

5 general-purpose Agents（Opus 4.8）+ Codex（gpt-5.5 xhigh）

要求覆蓋率

5 / 5 FULLY（requirements 逐項；security 機械證明驗證鏈 byte-identical、攻擊面淨縮小；logic/DA 空格路徑與 mkdir/mktemp 順序實測）

Findings（合併後）

#	Severity	Finding	Source	Action
1	P2（DA 反駁三個 sibling 的核心結論）	version-scoped .bin-cache 使 每次 shell bump 重下載（新版本目錄 = 全新 gitignored cache）→ #116 sidecar 短路效益歸零 + 磁碟隨保留版本目錄倍增（實查 cache：舊版本目錄共存不 GC）	agents:devils-advocate	Fixed（commit 1710c1b）：INSTALL_DIR 上移至 plugin 層級（<marketplace>/<plugin>/.bin-cache）— 隔離性不變（marketplace+plugin 皆在路徑）、跨版本持久。Kill test：兩版本模擬，shell bump 零重下載 ✓
2	LOW	offline-upgrade 收窄：既有 ~/bin 使用者升級後離線 → exit 1（不 fallback 舊副本）	agents:logic	不修 — deliberate trade-off（fallback 會重引碰撞面）；plugin-level 修訂後只發生於首次遷移，非 recurring
3	LOW	wrapper header 註解 sidecar 路徑過時 ×3	agents:logic+requirements	Fixed（同 commit）
4	LOW	pdf/pptx README 仍寫 ~/bin	agents:logic	Fixed；che-word 複製文件的同類漂移 → #118 lane
5	INFO	mkdir(113) < mktemp(128) 順序 — Codex P1 條件式確認 PASS（E2E + 行號機械證明）	codex	已證
6	INFO	PLUGIN_ROOT symlink 不 canonicalize（pre-existing、真實 spawn 不可達）；SIGKILL 殘留 temp（被 ignore + cache 汰換涵蓋）	agents:logic	記錄

對抗性驗證重點

• DA 實測（非模擬）：真下載 fresh install、含空格路徑多段模擬、collision-free 主張以真實 cache + installed_plugins.json 驗證後撤回質疑
• 驗證鏈 Convert macdoc into a Claude Code plugin marketplace (monorepo + marketplace dual identity) #112/Harden che-word-mcp wrapper with sha256 + code-signature verification (security follow-up from #112 push review) #116：security region-diff byte-identical 證明
• 修訂後 E2E：兩版本 kill test、跨 marketplace 並存、dev-checkout + ignore 樹乾淨

透明聲明

Finding 1 的修訂（1710c1b）落在 ensemble 之後，實作為 DA 處方，coordinator 以 DA 設計的 kill test 複驗。

Result: PASS（含 post-ensemble 修訂）
[unattended mode — /idd-all orchestrator]