[docs] plugin-tools CHANGELOG [1.15.0] entry has placeholder date — backfill (tangential from #60)

[kiki830621]

Problem

Source: surfaced during /idd-plan #60 tangential sweep (Step 2.5)

plugins/plugin-tools/CHANGELOG.md line 14 has the v1.15.0 entry with placeholder date:

## [1.15.0] - (date unknown — please fill in)

This is the standard changelog-tools:changelog-init placeholder — meant to be filled in by maintainer post-init. Never got filled in.

Type

docs

Expected

Replace placeholder with actual release date by checking git log:

git -C ~/Developer/psychquant-claude-plugins log --oneline --grep="plugin-tools.*1.15.0\|plugin-tools v1.15"

Find when v1.15.0 was bumped in marketplace.json / plugin.json (commit hash + date).

Actual

Drift — release went out, CHANGELOG entry exists but with placeholder date that violates KAC ISO-format requirement. changelog-validate plugin-tools may flag this on stricter modes.

Priority

P3 — schedule. Pure docs cleanup, ~2 minutes.

Strategy sketch

cd ~/Developer/psychquant-claude-plugins
git log --oneline plugins/plugin-tools/.claude-plugin/plugin.json | grep 1.15.0
# pick the bump commit hash
git show --pretty="%ad" --date=short -s <hash>
# replace "(date unknown — please fill in)" with that ISO date

Related

• plugin-update: add Step 0 git-state preview + commit/push confirmation dialog before mutating origin #60 (parent — discovered during plan tangential sweep)
• doc-tools:changelog-init placeholder pattern

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: plugin-tools CHANGELOG [1.15.0] date + description backfill.
• Commit: 645d9eb references this issue via Refs PsychQuant/psychquant-claude-plugins#64.
• 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

• 645d9eb: plugin-tools CHANGELOG [1.15.0] date + description backfill (Refs [docs] plugin-tools CHANGELOG [1.15.0] entry has placeholder date — backfill (tangential from #60) #64)
• (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 suppression B description broadened
• 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 都在 #64 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]

Scope expansion (from /idd-verify #60 finding #10)

Verify of #60 (DA + Regression review) confirmed that description history loss is a concurrent drift to the placeholder date issue:

v1.15.0 README Freshness Gate detail dropped from plugin.json + marketplace.json + CHANGELOG [1.15.0] entry. Placeholder-date entry has only the generic tagline, not the v1.15.0-specific feature description (which used to live only in marketplace.json).

When this issue is worked, scope should also include:

• Backfill the [1.15.0] description with the README Freshness Gate detail extracted from git history (search marketplace.json blame to find when the description was authored)

Original scope (placeholder date) + expanded scope (description backfill) form a coherent CHANGELOG [1.15.0] rehab — same file, same entry, single PR.

[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 + scope expansion)

• plugins/plugin-tools/CHANGELOG.md — replace ## [1.15.0] - (date unknown — please fill in) placeholder with ## [1.15.0] - 2026-04-26 + restore description detail (s4/s5/s6 README Freshness Gate v2 signals + 2 suppressions, cross-28-plugin audit) → commit 645d9eb

Cluster context

Part of 4-issue docs cluster sharing PR #71. Cluster branch idd/cluster-docs-followups-49-60.

Changes

• 645d9eb: docs(plugin-tools): backfill CHANGELOG [1.15.0] date + restore description detail (Refs [docs] plugin-tools CHANGELOG [1.15.0] entry has placeholder date — backfill (tangential from #60) #64)

PR

#71

Verification

• ✅ Date verified via git show -s 60f8cab → 2026-04-26
• ✅ Description detail extracted from commit body (s4/s5/s6 detection + 2 suppressions) + original marketplace.json description (cross-28-plugin audit pattern)
• ✅ KAC ISO-format requirement satisfied — no more (date unknown) placeholder
• ✅ changelog-validate plugin-tools strict mode no longer flags this entry

Scope Compliance

Includes both date backfill AND description backfill per scope expansion comment on this issue. Single CHANGELOG edit, no other files touched.

Sister Bugs Filed

none surfaced.

Next: verification pending

/idd-verify --pr 71

[kiki830621]

Verify (via PR #71)

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

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

[kiki830621]

Closing Summary

Problem

plugins/plugin-tools/CHANGELOG.md 的 v1.15.0 entry 用了 changelog-tools:changelog-init placeholder (date unknown — please fill in) 而沒被填入。同時(per scope expansion comment):v1.15.0 description detail 在 plugin.json 跟 marketplace.json 已經被覆蓋成 v1.16.0 description,CHANGELOG 也只有 generic tagline,v1.15.0 README Freshness Gate v2 detail 三處同時遺失。

Surfaced in /idd-plan PsychQuant/psychquant-claude-plugins#60 tangential sweep,scope 在 #64 scope expansion comment 擴大為 date + description 雙重 backfill。

Root Cause

兩處 drift 同時發生:

1. Date drift:changelog-init 用 placeholder 是設計上 deliberate(讓 user 之後填 ISO date),但實際從未填入 — workflow gap
2. Description drift:plugin-update: add Step 0 git-state preview + commit/push confirmation dialog before mutating origin #60 v1.16.0 implementation 把 plugin.json + marketplace.json description 改寫成 v1.16.0 highlight,沒保留 v1.15.0 historical detail;CHANGELOG 也只有 placeholder + 一行 tagline → v1.15.0 完整 description 三處都不在了

Solution

1. Date backfill:Replace (date unknown — please fill in) with 2026-04-26 — verified via git show -s 60f8cab commit AuthorDate
2. Description backfill:從 commit 60f8cab body 抽出原始 detail:
   • README Freshness Gate v2 從 3 信號擴展到 6,新增 3 detection signals + 2 suppressions
   • s4 Component inventory drift: skills/agents/commands 必須在 README 被 reference
   • s5 Tool count drift: parse (N tools) from README,對比 plugin.json description
   • s6 Version history multi-version gap: scan git log,2+ same-major missing 觸發 gate
   • 2 suppressions: no-version-section + wrapper-only/marketplace-sync/version-bump commits
3. Section type: ### Added(KAC canonical for new features)+ ### Notes(repo convention for backfill metadata)

Verification

• 6-AI cluster verify on PR cluster: 4 docs follow-ups from #49 / #60 IDD lifecycles #71 returned PASS after Codex LOW finding upheld and fixed in c04f66d(原本 suppression B description 比 commit body 窄 — 從 bin/*-wrapper.sh only 廣化到 wrapper-only / marketplace-sync / plugin.json version 完整 set,加 1a4c1fe canonical example)
• Date verified empirically: git show -s 60f8cab returns AuthorDate: Sun Apr 26 09:37:56 2026 +0800
• Section types comply with repo convention(### Added + ### Notes,not Codex-rejected ### Changed)
• changelog-validate plugin-tools strict mode no longer flags this entry
• Full verify report: PR PsychQuant/psychquant-claude-plugins#71 issuecomment-4415171847

Changes

• 645d9eb — docs(plugin-tools): backfill CHANGELOG [1.15.0] date + restore description detail (Refs [docs] plugin-tools CHANGELOG [1.15.0] entry has placeholder date — backfill (tangential from #60) #64)
• 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) — broadened suppression B description per commit body
• 1557fbf — cluster squash merge

Cluster context

Part of 4-issue docs cluster (PR #71)。Scope was expanded mid-cycle(#64 plan tangential → verify-stage adjustment)to include description backfill。Sister issues #52 #54 #55 各自獨立 close。

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.