[docs] Backfill CHANGELOG [2.16.1] entry (sister concern from #49)

[kiki830621]

Problem

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

plugins/che-apple-mail-mcp/CHANGELOG.md is missing a ## [2.16.1] - 2026-05-09 entry. Commit 8089765 bumped the plugin to v2.16.1 (from v2.16.0) but skipped the CHANGELOG, breaking the KAC 1.1.0 invariant that every release version gets a documented entry.

Type

docs

Expected

CHANGELOG.md has an entry for every released version, including bump-only releases. The 2.16.1 entry should document:

• Bump-only purpose (ship binary v2.7.1)
• cluster: 4 refactor/docs follow-ups from #49 / #60 IDD lifecycles #72 base64 fix
• [refactor] Define IDD_ALL_UNATTENDED env var contract across idd-all + plugin-tools (sibling concern from #60) issue-driven-development#123 SQLite fast-path stderr logging
• [enhancement] che-apple-mail-mcp session-start hook: PID validation + started_at comparison hardening (follow-up from #76) #66 .partial.emlx attachment fix
• Tool count drift catch-up 44→47 in user-facing surfaces

Section: probably ### Notes (since it's bump-only ship-binary, no shell-side Added / Changed / Fixed).

Actual

## [Unreleased]

## [2.17.0] - 2026-05-09     ← just-added by PsychQuant/psychquant-claude-plugins#49
  ...

## [2.16.0] - 2026-05-07     ← jumps from 2.17 → 2.16, no 2.16.1 entry

Verification: git log --oneline | grep 2.16.1 shows commit 8089765 chore: bump che-apple-mail-mcp v2.16.1 (ship binary v2.7.1: PsychQuant/psychquant-claude-plugins#72 PsychQuant/issue-driven-development#123 PsychQuant/psychquant-claude-plugins#66) — the version was clearly released, just not documented.

Impact

• KAC convention violated; CHANGELOG users (e.g. plugin discovery, marketplace listing readers) miss context for 2.16.1
• changelog-validate skill might flag this if run with strict mode
• Future me / future maintainers reading CHANGELOG will see the gap and have to dig commit history to reconstruct what 2.16.1 shipped

Priority

P3 — schedule. Not blocking; pure documentation backfill. ~5 min fix once user picks up.

Strategy sketch

1. Open plugins/che-apple-mail-mcp/CHANGELOG.md
2. Insert ## [2.16.1] - 2026-05-09 block between [Unreleased]/[2.17.0] and [2.16.0] (in chronological release order; v2.16.1 sits between 2.16.0 and 2.17.0)
3. Section content: ### Notes block summarizing cluster: 4 refactor/docs follow-ups from #49 / #60 IDD lifecycles #72 / [refactor] Define IDD_ALL_UNATTENDED env var contract across idd-all + plugin-tools (sibling concern from #60) issue-driven-development#123 / [enhancement] che-apple-mail-mcp session-start hook: PID validation + started_at comparison hardening (follow-up from #76) #66 + tool count update
4. Verify three-way sync still holds (descriptions in plugin.json / marketplace.json already include 2.16.1 history; CHANGELOG just catches up)

Related

• kiki830621/chchen-lab workspace surfaced this during /idd-implement of archive-mail: support workspaces with nested communications layout and symlinked historical archives #49 — see Implementation Complete comment "Plan-correction during implement" section.
• Filed per IDD idd-implement Step 5.7 sister bug sweep (IC_R011 commercial low-bar filing).

Current Status

Phase: implemented (cluster-PR mode)
Last updated: 2026-05-10 by /idd-implement cluster

Key Decisions

• Part of 4-issue docs cluster ([docs] Backfill CHANGELOG [2.16.1] entry (sister concern from #49) #52 + [docs] archive-mail YAML message_id parser brittle — reduce 'schema diversity' claim or strengthen (sister concern from #49) #54 + [docs] README workspace pattern '100% backward compat' wording too strong (sister concern from #49) #55 + [docs] plugin-tools CHANGELOG [1.15.0] entry has placeholder date — backfill (tangential from #60) #64) sharing PR cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71 + cluster branch idd/cluster-docs-followups-49-60.
• Implementation: che-apple-mail-mcp CHANGELOG [2.16.1] backfill.
• Commit: 6602456 references this issue via Refs PsychQuant/psychquant-claude-plugins#52.
• Pure docs change — no code logic, no test impact, no version bump.

Scope Changes

• Single file change per issue, all 4 issues touch different files (no inter-issue scope overlap).
• No sister bugs surfaced (Step 5.7 sweep returned empty).

Blocking

• (none) Awaiting /idd-verify --pr 71 cluster verify + per-issue /idd-close after merge.

Commits

• 6602456: che-apple-mail-mcp CHANGELOG [2.16.1] backfill (Refs [docs] Backfill CHANGELOG [2.16.1] entry (sister concern from #49) #52)
• (cluster total: 4 commits — see PR cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71 for full diff)

Current Status

Phase: verified
Last updated: 2026-05-10 by /idd-verify cluster

Key Decisions

• Cluster verify (PR cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71) returned PASS after empirical adjudication of Codex GPT-5.5 cross-model dissent. Full report: cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71 (comment)
• This issue's verify-stage fix(es): LOW user-facing-surfaces overclaim
• Codex caught parser-behavior accuracy issue Claude reviewer flat-passed — cross-model verify did its job.
• 2 Codex HIGH findings on ### Notes non-KAC section names rejected as false positives — empirical evidence shows ### Notes is established repo convention (6× usage in che-apple-mail-mcp CHANGELOG, also batch-ocr/plugin-tools/parallel-ai-agents).
• DA skipped — disagreements were empirically resolvable via repo grep + bash awk test, no need for separate DA agent.

Scope Changes

• (none from this issue's perspective; cluster-level only)
• Cross-issue observation filed inline in master report: plugin currently v2.18.1 but CHANGELOG missing [2.18.1] entry (same KAC drift class as [docs] Backfill CHANGELOG [2.16.1] entry (sister concern from #49) #52) — suggested follow-up for next cluster.

Blocking

• (none) Awaiting PR cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71 merge + per-issue /idd-close closing summary.

Commits

• c04f66d: fix(docs-cluster): apply /idd-verify PR cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71 codex findings (Refs [docs] Backfill CHANGELOG [2.16.1] entry (sister concern from #49) #52 [docs] archive-mail YAML message_id parser brittle — reduce 'schema diversity' claim or strengthen (sister concern from #49) #54 [docs] plugin-tools CHANGELOG [1.15.0] entry has placeholder date — backfill (tangential from #60) #64)
• (this-issue commit on cluster branch): see PR cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71 for full diff

Current Status

Phase: closed
Last updated: 2026-05-10 by /idd-close cluster

Key Decisions

• Closed via cluster /idd-close PsychQuant/psychquant-claude-plugins#52 PsychQuant/psychquant-claude-plugins#54 PsychQuant/psychquant-claude-plugins#55 PsychQuant/psychquant-claude-plugins#64 after PR cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71 merged.
• Per-issue closing summary written independently (NOT batched — IDD discipline).
• Step 0 supersession active(Implementation Complete > Checklist all - [x])→ Strategy/Plan unchecked items 視為 superseded per #515 fix。
• Step 1.5 PR Gate PASS(PR cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71 MERGED at 2026-05-10T12:02:27Z as 1557fbf)。
• Step 1.6 semantic gate PASS(每個 issue 的 backtick file path 都在 #52 commit 的 changed-files 列表)。

Scope Changes

• Cluster of 4 issues sharing 1 PR + 1 squash-merge commit 1557fbf(原 5 commits squashed: 4 implementation + 1 verify-fix)。
• Verify-stage findings:cross-model dissent caught accuracy issues Claude flat-passed(parser-behavior wording, scope claim narrowing, suppression description completeness)。
• 2 Codex HIGH on ### Notes non-KAC rejected as repo-convention false positives。

Blocking

• (none — issue CLOSED)

Commits

• 1557fbf: cluster: 4 docs follow-ups from archive-mail: support workspaces with nested communications layout and symlinked historical archives #49 / plugin-update: add Step 0 git-state preview + commit/push confirmation dialog before mutating origin #60 IDD lifecycles (cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71) — squash merge
• (Pre-squash on cluster branch idd/cluster-docs-followups-49-60,already deleted post-merge)

[kiki830621]

Implementation Plan (cluster-PR mode)

This issue is part of a 4-issue docs cluster sharing 1 feature branch + 1 PR. Plan covers all 4 issues for transparency; commits use Refs #N to match each item to its source issue.

Cluster scope:

• [docs] Backfill CHANGELOG [2.16.1] entry (sister concern from #49) #52 — Backfill CHANGELOG [2.16.1] entry in che-apple-mail-mcp
• [docs] archive-mail YAML message_id parser brittle — reduce 'schema diversity' claim or strengthen (sister concern from #49) #54 — Reduce "Resilient to schema diversity" claim in archive-mail.md Step 2.1
• [docs] README workspace pattern '100% backward compat' wording too strong (sister concern from #49) #55 — Soften "100% backward compat" wording in che-apple-mail-mcp/README.md
• [docs] plugin-tools CHANGELOG [1.15.0] entry has placeholder date — backfill (tangential from #60) #64 — Backfill [1.15.0] placeholder date in plugin-tools/CHANGELOG.md + restore description detail

Branch: idd/cluster-docs-followups-49-60

Files & Changes (per-issue)

#52 (commit 1)

• plugins/che-apple-mail-mcp/CHANGELOG.md — insert ## [2.16.1] - 2026-05-09 block between current [2.17.0] and [2.16.0]. Section: ### Notes (bump-only). Content: ship binary v2.7.1 (cluster: 4 refactor/docs follow-ups from #49 / #60 IDD lifecycles #72 base64 fix + [refactor] Define IDD_ALL_UNATTENDED env var contract across idd-all + plugin-tools (sibling concern from #60) issue-driven-development#123 SQLite fast-path stderr logging + [enhancement] che-apple-mail-mcp session-start hook: PID validation + started_at comparison hardening (follow-up from #76) #66 .partial.emlx attachment fix) + tool count drift catch-up 44→47.

#54 (commit 2)

• plugins/che-apple-mail-mcp/commands/archive-mail.md — Step 2.1 properties block, replace "Resilient to schema diversity" claim with v2.6+ format-compatibility wording matching issue body's diff sketch. Pure docs (option A.1 per issue), no parser hardening (deferred).

#55 (commit 3)

• plugins/che-apple-mail-mcp/README.md — Workspace Patterns section, replace "100% backward compat" wording with explicit-pin / mid-migration distinction per issue body's diff sketch.

#64 (commit 4)

• plugins/plugin-tools/CHANGELOG.md — replace ## [1.15.0] - (date unknown — please fill in) placeholder with ## [1.15.0] - 2026-04-26. Backfill description per scope expansion: README Freshness Gate v2 (6 signals + 2 suppressions), component inventory drift / tool count drift / version history multi-version gap, cross-28-plugin audit.

Sequencing

4 disjoint files → 4 independent commits, any order. Choose simplest visual order: #52 → #54 → #55 → #64.

Decision Points (locked in)

• D1 — Cluster vs separate PRs: chose cluster because all 4 are pure docs, low review surface, batch-friendly. Separate PRs would create review fragmentation for marginal benefit.
• D2 — [docs] archive-mail YAML message_id parser brittle — reduce 'schema diversity' claim or strengthen (sister concern from #49) #54 scope: claim reduction only (Option A.1 per issue body); no parser hardening this PR. Defer until N≥3 user reports of manual-archive missed dedup.
• D3 — [docs] plugin-tools CHANGELOG [1.15.0] entry has placeholder date — backfill (tangential from #60) #64 scope: include description backfill (per scope expansion comment), not just date — same file, single edit.

Risks & Mitigations

• Trailing whitespace risk (per plugin-update: add Step 0 git-state preview + commit/push confirmation dialog before mutating origin #60 verify finding) — keep edits surgical; manual review of diff before commit.
• CHANGELOG cross-version ordering ([docs] Backfill CHANGELOG [2.16.1] entry (sister concern from #49) #52) — verify [2.18.1] [2.18.0] [2.17.0] [2.16.1] [2.16.0] ordering after insert.
• changelog-validate 3-way sync — descriptions byte-equality check still applies; [docs] plugin-tools CHANGELOG [1.15.0] entry has placeholder date — backfill (tangential from #60) #64 only changes CHANGELOG, not plugin.json/marketplace.json (those still have v1.16.0 description, which is different from v1.15.0). 3-way sync is on latest entry, not historical entries — this PR doesn't change latest, no sync issue.

Out-of-scope

• Parser hardening for [docs] archive-mail YAML message_id parser brittle — reduce 'schema diversity' claim or strengthen (sister concern from #49) #54 (Option B in issue) — defer
• Other CHANGELOG drift across marketplace plugins — defer to plugin-deploy audit pass
• README Workspace Patterns rewrite beyond [docs] README workspace pattern '100% backward compat' wording too strong (sister concern from #49) #55 — defer

[kiki830621]

Implementation Complete

Checklist (synced from cluster Implementation Plan)

• plugins/che-apple-mail-mcp/CHANGELOG.md — insert ## [2.16.1] - 2026-05-09 block between [2.17.0] and [2.16.0], ### Notes section, content per issue body strategy → commit 6602456

Cluster context

This issue is part of a 4-issue docs cluster sharing PR #71. See Implementation Plan above for full cluster scope. Each commit on cluster branch idd/cluster-docs-followups-49-60 uses Refs #N to match source issue.

Changes

• 6602456: docs(che-apple-mail-mcp): backfill CHANGELOG [2.16.1] entry (Refs [docs] Backfill CHANGELOG [2.16.1] entry (sister concern from #49) #52)

PR

#71

Verification

• ✅ Manual review of CHANGELOG ordering: [Unreleased] → [2.18.1] → [2.18.0] → [2.17.0] → [2.16.1] (NEW) → [2.16.0] — chronological correct
• ✅ Section type ### Notes (bump-only release, no shell-side Added/Changed/Fixed)
• ✅ Backfilled content matches binary v2.7.1 ship history (cluster: 4 refactor/docs follow-ups from #49 / #60 IDD lifecycles #72 + [refactor] Define IDD_ALL_UNATTENDED env var contract across idd-all + plugin-tools (sibling concern from #60) issue-driven-development#123 + [enhancement] che-apple-mail-mcp session-start hook: PID validation + started_at comparison hardening (follow-up from #76) #66 + tool count 44→47)
• T5 3-way sync invariant unaffected — this PR only changes historical CHANGELOG entry, not latest [2.18.1] which still syncs with plugin.json + marketplace.json descriptions

Scope Compliance

Single file change (CHANGELOG.md only). No code logic change. Pure docs backfill.

Sister Bugs Filed (mid-impl, v2.44.0+ #526)

none surfaced — pure docs backfill, no reproduction trace.

Next: verification pending

/idd-verify --pr 71 will run 6-AI ensemble against the cluster PR diff covering all 4 issues.

[kiki830621]

Verify (via PR #71)

Result: PASS — all blocking findings resolved in fix commit c04f66d
Full report: #71 (comment)

This issue's findings: see "#52" section in the linked report.

[kiki830621]

Closing Summary

Problem

plugins/che-apple-mail-mcp/CHANGELOG.md 缺少 ## [2.16.1] - 2026-05-09 entry。Commit 8089765(2026-05-09)bump 了 plugin 從 v2.16.0 → v2.16.1 但 skip 了 CHANGELOG entry,違反 KAC 1.1.0 invariant — every released version 必須有 documented entry。

Root Cause

v2.16.1 是 bump-only release to ship binary v2.7.1。當時的 release flow 沒做 CHANGELOG sync(只改 plugin.json + marketplace.json description),結果 CHANGELOG 跳過 v2.16.1 從 v2.17.0 直接到 v2.16.0,留下 audit gap。

Surfaced in /idd-implement PsychQuant/psychquant-claude-plugins#49 reproduction (Step 5.7) — 我在 v2.17.0 implement 過程中讀 CHANGELOG 撞到這個 gap。

Solution

Insert ## [2.16.1] - 2026-05-09 block between [2.17.0] and [2.16.0](chronological release order)。Section type: ### Notes(repo convention for bump-only releases — established 用法,6× existing usage in this CHANGELOG)。

Content:

• Bump-only purpose: ship binary v2.7.1
• Binary v2.7.1 ships: cluster: 4 refactor/docs follow-ups from #49 / #60 IDD lifecycles #72 base64 decoding fix, [refactor] Define IDD_ALL_UNATTENDED env var contract across idd-all + plugin-tools (sibling concern from #60) issue-driven-development#123 SQLite fast-path stderr logging, [enhancement] che-apple-mail-mcp session-start hook: PID validation + started_at comparison hardening (follow-up from #76) #66 .partial.emlx attachment fix
• Tool count drift catch-up (44 → 47): 限定為 plugin.json + marketplace.json description fields(commit 8089765 只 touched 這 2 個,不含 README — verify finding 修正)

Verification

• 6-AI cluster verify(combined Claude reviewer + Codex GPT-5.5 xhigh)on PR cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71 returned PASS after empirical adjudication of 1 LOW finding(原 wording "user-facing surfaces" overclaim → narrowed to "plugin.json + marketplace.json descriptions" in fix commit c04f66d)。
• KAC ordering verified:[Unreleased] → [2.18.1] → [2.18.0] → [2.17.0] → [2.16.1](NEW)→ [2.16.0] chronological correct
• ### Notes section name 是 repo convention(empirical:6× existing usage),Codex 對此判定 non-KAC 為 false positive(REJECTED with empirical evidence)
• Full verify report: PR PsychQuant/psychquant-claude-plugins#71 issuecomment-4415171847

Changes

• 6602456 — docs(che-apple-mail-mcp): backfill CHANGELOG [2.16.1] entry (Refs [docs] Backfill CHANGELOG [2.16.1] entry (sister concern from #49) #52)
• c04f66d — fix(docs-cluster): apply /idd-verify PR cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71 codex findings (Refs [docs] Backfill CHANGELOG [2.16.1] entry (sister concern from #49) #52 [docs] archive-mail YAML message_id parser brittle — reduce 'schema diversity' claim or strengthen (sister concern from #49) #54 [docs] plugin-tools CHANGELOG [1.15.0] entry has placeholder date — backfill (tangential from #60) #64) — narrowed "user-facing surfaces" overclaim
• 1557fbf — cluster: 4 docs follow-ups from archive-mail: support workspaces with nested communications layout and symlinked historical archives #49 / plugin-update: add Step 0 git-state preview + commit/push confirmation dialog before mutating origin #60 IDD lifecycles (cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71) — squash merge to main

Cluster context

Part of 4-issue docs cluster solved as PR #71(cluster-PR mode)。Sister issues #54 #55 #64 各自獨立 closing summary。

Closing Follow-ups Filed (v2.45.0+ #527)

(none — no orphan mentions in closing summary)

Trigger-phrase scan hits: all classified as cross-linked context or CONSTRAINT-with-trigger-condition (IC_R011 §3 exempt) — no separate filings warranted.