bug: VersionConsistencyTests 紅燈 — plugin/marketplace 1.14.2 vs AppVersion.current 1.14.1（3b0df30 漏 bump）(sister bug from #169)

[kiki830621]

Problem

VersionConsistencyTests.testAllDistributionArtifactsMatchAppVersion 在 main（與所有分支）紅燈：

• plugin/.claude-plugin/plugin.json version = 1.14.2
• .claude-plugin/marketplace.json che-ical-mcp entry = 1.14.2
• Sources/CheICalMCP/Version.swift AppVersion.current = 1.14.1

commit 3b0df30（chore(release): che-ical-mcp plugin v1.14.2 — #168 two-layer TCC docs）bump 了 plugin 分發層版本，但漏 bump AppVersion.current。此後每次 swift test 都帶 2 個失敗，稀釋測試訊號（真回歸會被「又是那兩個」掩蓋）。

Type

bug（release 流程遺漏 + 測試紅燈）

Expected

擇一（依 release 慣例決定）：

1. 若 1.14.2 是純 plugin-shell 版（binary 無變）→ 釐清 VersionConsistencyTests 的契約：plugin 版本是否允許領先 binary 版本；若允許，測試需改為只驗 binary-related artifacts
2. 若版本應鎖步 → bump AppVersion.current 到 1.14.2（或下一個 binary release 時一併校正）

swift test 回到 0 failures。

---

Source: surfaced during /idd-implement #169 reproduction (Step 5.7)

---

Current Status

Phase: closed
Last updated: 2026-07-10 — PR #177 merged (31418b7)，Closing Summary 已 post

[kiki830621]

Diagnosis

Type

bug（release 流程遺漏 → CI 紅燈）

Root Cause / Analysis

commit 3b0df30（chore(release): plugin v1.14.2）只 bump 了 5 個版本位點中的 2 個（plugin/.claude-plugin/plugin.json、.claude-plugin/marketplace.json → 1.14.2），漏掉 AppVersion.current（Version.swift）、Sources/CheICalMCP/Info.plist CFBundleVersion、mcpb/manifest.json version（皆停在 1.14.1）。VersionConsistencyTests（#163 single-version invariant：AppVersion.current 為 source of truth，四 artifacts 必須相等）自此紅燈，且正阻擋 PR #174 / #176 的 CI。

裁決 issue Expected 的兩選項：採選項 2（版本鎖步）— v1.14.1 先例（metadata-only release 仍全面 bump）+ 測試契約本身就是鎖步 invariant + build-mcpb.sh build-time 同款 fail-fast。選項 1（允許 plugin 領先）需改 invariant 契約，血radius 更大且違 #163 設計。

Impact

• 影響檔案：Sources/CheICalMCP/Version.swift、Sources/CheICalMCP/Info.plist、mcpb/manifest.json（三處 1.14.1 → 1.14.2）
• 每次 swift test 帶 2 個失敗，稀釋回歸訊號；CI 紅燈擋 merge

Strategy

• 三檔版本對齊 1.14.2
• swift test 回 0 failures（VersionConsistencyTests 本身就是 regression guard，無需新測試）

Conflict Class

A_parallel_safe — 三個版本字串位點，無其他 open lane 觸碰。

Complexity

Simple（單一機械修正、驗收由既有 dedicated test 機械判定；Hard-gate: not triggered — 3 檔但同一 trivial 概念且有既有 test 守護）

Risks

• mcpb/manifest.json bump 至 1.14.2 意味下次 .mcpb build 自報 1.14.2 — 與 plugin 分發版本一致，正是 invariant 要的

Residue

• 「為何 3b0df30 會漏」的流程面（release script 未跑 / 手動 bump）不在本 issue — build-mcpb.sh 的 build-time gate 已兜底未來 release path

[kiki830621]

Closing Summary

Root Cause

commit 3b0df30（plugin v1.14.2 release）只 bump 了 5 個版本位點中的 2 個，破壞 #163 single-version invariant → VersionConsistencyTests 紅燈、阻擋後續所有 PR 的 CI。

Solution

AppVersion.current、Info.plist CFBundleVersion、mcpb/manifest.json version 對齊 1.14.2（採版本鎖步 — v1.14.1 metadata-only release 先例 + invariant 契約本意；diagnosis 記錄兩選項裁決）。

Verification

• swift test 454 tests 0 failures（VersionConsistencyTests 即 dedicated regression guard — 機械驗收）
• PR chore: 版本位點對齊 1.14.2 — 修 VersionConsistency 紅燈 (#172) #177 squash-merged（31418b7），CI 綠；下游 PR feat: --print-tcc-path 顯示執行 context（parent chain）與 context-dependence 警告 (#169) #174/docs: README troubleshooting — Claude Code update-rotation TCC breakage (#170) #176 帶入後 CI 同轉綠 — 修復效果實證

Residue

• 「3b0df30 為何漏 bump」的流程面：release script 的 build-time gate（build-mcpb.sh）只護 binary release path，plugin-shell-only release 無 gate — 未另開 issue（低頻、test 已兜底 CI 層）