Harden che-word-mcp wrapper with sha256 + code-signature verification (security follow-up from #112 push review)

[kiki830621]

Problem

Push security review（#112 / PR #115）指出 plugins/che-word-mcp/bin/che-word-mcp-wrapper.sh 下載 binary 後直接 exec，無 sha256 / code-signature 驗證（supply-chain / unverified remote code execution class）。同 review 中兩個新 wrapper（che-pdf-mcp、che-pptx-mcp）已在 PR #115 內修復；che-word-mcp 的 wrapper 是自 psychquant-claude-plugins 逐字複製的既有生產 pattern，未在該 PR 內動的原因：

1. 修改會破壞「複製 = byte-identical」的遷移驗證契約（audit trail 已記錄）
2. shell plugin.json version 綁 binary 下載契約（wrapper 以 plugin.json version 挑 release tag）— bump shell 版本會讓 wrapper 去抓不存在的 v3.20.1 binary tag 再 fallback latest，sidecar 記錄錯亂。乾淨修法需要 shell/binary 版本解耦（如 binary_version 欄位）

Expected

che-word-mcp wrapper 具備與 PR #115 兩個新 wrapper 相同的雙重驗證（sha256 asset 比對 fail-closed + codesign TeamIdentifier=6W377FS7BS 硬閘），且版本語意正確（binary 下載仍鎖 v3.20.0）。

Actual

Wrapper 下載後直接 exec（HTTPS 為唯一防線）。

Impact

中高 — release asset 遭掉包（GitHub 帳號被入侵情境）時使用者端無第二道防線。che-word-mcp 是 4 個 plugins 中安裝基數最大者。

---

Source: surfaced during #112 push security review disposition

---

Current Status

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

PR #121（off main，stacked train 基底）。Verify: 6-AI PASS（Codex P2 fail-closed 修）。

[kiki830621]

Scope 更新（#112 verify R1 之後）：

• wrapper 加固已在 PR Convert macdoc into a Claude Code plugin marketplace (monorepo + marketplace dual identity) #115 內完成（commit 813bae4）— che-word-mcp wrapper 改用與 pdf/pptx 相同的硬化模板（強制 sha256 + requirement-based codesign + pinned no-fallback）。原「版本耦合需先解耦」的延後理由被 verify R1 推翻：macdoc marketplace 尚未首發，複製 shell 可先修（版本刻意不 bump，見 shell CHANGELOG Unreleased 段說明）。
• 本 issue 剩餘 scope 縮小為：shell/binary 版本解耦（如 binary_version 欄位），讓未來 shell 變更可正常 bump 版本而不破壞 binary 下載契約。

[kiki830621]

Diagnosis

Type

refactor（版本契約解耦）

Root Cause / Analysis

Wrapper 以 plugin.json 的 version 欄位挑 binary release tag（v$version）。這把「shell 版本」與「binary 版本」焊死：shell-only 變更（如 #112 的 wrapper 硬化）bump 版本會使下載指向不存在的 tag → 新安裝 fail-closed 直接失敗。現況 che-word-mcp shell 已累積硬化變更但版本停在 3.20.0（CHANGELOG 以 Unreleased 段記錄），違反 bump-on-change 慣例。

Impact

• plugins/{che-word-mcp,che-pdf-mcp,che-pptx-mcp}/.claude-plugin/plugin.json（+binary_version 欄位）
• 同三個 wrapper（DESIRED_VERSION 解析順序）
• .claude-plugin/marketplace.json（版本同步）
• plugins/che-word-mcp/CHANGELOG.md（Unreleased → 版次化）

Strategy

• plugin.json ×3 加 binary_version 欄位（word: 3.20.0、pdf: 0.1.0、pptx: 0.1.0）
• wrapper ×3：DESIRED_VERSION 改讀 binary_version，缺欄位時 fallback version（backward compat — 舊 shell 不破）
• che-word-mcp shell version 3.20.0 → 3.20.1（吸收 Convert macdoc into a Claude Code plugin marketplace (monorepo + marketplace dual identity) #112 硬化變更）；CHANGELOG [Unreleased — macdoc marketplace shell] → [3.20.1] - 2026-07-02
• marketplace.json 同步（word 3.20.1 + binary_version 3.20.0）
• E2E：word wrapper（shell 3.20.1）仍正確下載 binary v3.20.0 + 快路徑 exec-time 驗證通過；fresh-install 模擬

Conflict Class

C_shared_module_coord — 共享資源：3 個 wrapper 檔 + marketplace.json（與 #117/#118 同資源，batch 已序列化緊鄰）。

Complexity

Plan — Layer P：跨檔順序依賴（plugin.json 欄位 ↔ wrapper 解析）、版本契約邊界（risk-sensitive：搞錯 fallback 順序會 brick 新安裝）。
[Plan tier deliberation skipped under unattended mode — /idd-all orchestrator]

Risks

• fallback 順序錯誤 → 無 binary_version 的舊 shell 破壞（mitigation：binary_version 優先、缺欄位 fallback version，E2E 雙情境測）
• marketplace.json 與 plugin.json 版本漂移（mitigation：一次 commit 同步兩處 + jq 驗證）

Residue

(none)

Vagueness Pre-check

• V1: 2 — issue scope 明確（binary_version 欄位方案已在 issue 內指名）
• V4: 2 — 驗收 = shell bump 不再破壞下載契約（可 E2E 驗）
• Triggered: no
  [unattended mode — /idd-all orchestrator]

[kiki830621]

Implementation Plan

• plugin.json ×3 加 binary_version
• wrapper ×3 binary_version-first 解析 + version fallback
• che-word-mcp shell 3.20.0 → 3.20.1 + CHANGELOG 版次化
• marketplace.json 同步
• E2E ×3 情境

Implementation Complete

Checklist (synced from TaskList)

• binary_version 欄位 ×3 → branch idd/116-version-decoupling
• wrapper 解析順序（binary_version → version fallback）×3
• shell 3.20.1 bump + CHANGELOG [3.20.1] - 2026-07-02（含 Changed 段記錄解耦契約）
• marketplace.json（word: version 3.20.1 / binary_version 3.20.0）
• E2E：fresh install（shell 3.20.1 → 下載 v3.20.0 ✓）、快路徑（無重下載 ✓）、無欄位 fallback（✓）

Changes

• refactor: decouple shell version from binary release tag via binary_version (#116)

Scope Compliance

8 檔全數可追溯至 issue scope；無其他改動。

Next: verification pending

[unattended mode — /idd-all orchestrator]

[kiki830621]

Verify: #116

Engine

5 general-purpose Agents（Opus 4.8, file-based output）+ Codex（gpt-5.5 xhigh, codex-call）

要求覆蓋率

5 / 5 requirements FULLY（binary_version↔release tags 實測、解析順序、3.20.1 版次化、marketplace 同步、下載路徑不含 shell version）

Findings（合併後）

#	Severity	Finding	Source	Action
1	P2	binary_version 存在但空值 → fallback 到 shell version 而非 fail-closed（語意偏差）	codex	Fixed（key-presence-aware：缺席才 fallback、存在但空值拒絕；E2E 驗證保留已驗 binary）
2	LOW	pdf/pptx wrapper 已變但版本未 bump（0.1.0 已隨 PR #115 live）— logic 與 DA 對「是否已發布」判定分歧，防禦性處理	agents:logic+devils-advocate	Fixed（0.1.1 bump + CHANGELOG + marketplace 同步 — 正是本 issue 解耦的用途）
3	LOW	description 欄位仍以 v3.20.0 開頭（cosmetic；#118 doc-drift lane 將整理）	agents:regression+codex	轉 #118
4	INFO	binary_version 雙 source-of-truth 手動同步負擔 + 作者忘記欄位的 hazard	agents:devils-advocate	CLAUDE.md 加發布紀律行（Fixed）；工具化留 future
5	INFO	grep pattern anchor 可再硬化（實測無誤配，防禦性建議）	codex	不處理（三方實測互斥成立）

對抗性驗證重點

• grep version/binary_version 誤配：三方獨立實測（logic、DA 六組 edge inputs、codex）互斥成立
• Convert macdoc into a Claude Code plugin marketplace (monorepo + marketplace dual identity) #112 驗證鏈（sha256/codesign/exec-time）：機械證明未觸碰（security）
• 舊 wrapper × 新 plugin.json 遷移路徑：DA 從 main 提取舊解析器實測 fail-to-good
• v3.20.1 tag 不存在（前提確認）、v3.20.0 assets 完整（HTTP 實測）

Result: PASS（in-scope fixes 已隨 commit 落地）
[unattended mode — /idd-all orchestrator]