Skip to content

版上げの組み立て: ルートの plugin.json の version も Claude 版にそろえる - #4037

Merged
takemi-ohama merged 3 commits into
mainfrom
fix/release-root-plugin-version
Nov 22, 2026
Merged

takemi-ohama merged 3 commits into
mainfrom
fix/release-root-plugin-version

Conversation

@takemi-ohama

Copy link
Copy Markdown
Contributor

概要

11.0.14 の版上げの組み立て(release-cd.yml の assemble、run https://github.com/devbasex/ai-plugins/actions/runs/44965920730 )が、手順「版数の記載をそろえる」で止まった。

ERROR: plugins/playwright-kit/plugin.json の version が claude 版と食い違う(root: 4.0.4 / claude: 4.0.5)
ERROR: plugins/playwright-kit/plugin.json の description の版数が古い(description: v4.0.4 / Claude 版 plugin.json: v4.0.5)

依存を更新した PR #3961 で playwright-kit が変わったため、assemble は Claude 版の plugin.json を 4.0.5 へ上げた。ところがルートの plugins/playwright-kit/plugin.json(Agent Plugins package)は手順の対象に入っておらず、4.0.4 のまま残っていた。ルートに plugin.json を持つのは playwright-kit だけである。

変えたこと

対象 前 後
scripts/sync-version-mentions.py .claude-plugin・.codex-plugin・marketplace.json の description だけをそろえる ルートの plugin.json の version と description も、Claude 版の version にそろえる
.ndf/release.json の手順の writes ルートの plugin.json を含まない(assemble は申告の外の書き換えで止まる) plugins/playwright-kit/plugin.json を足す
scripts/tests/test_sync_version_mentions.py ndf を上げる形だけ playwright-kit を上げる形のテストを足した(直す前に落ちることを確かめた)

利用者向けの変化

  • 無し(リポジトリのリリースの手順の直し)

テスト計画

  • uv run --frozen --project . --all-extras pytest scripts/tests/test_sync_version_mentions.py -q(7 passed。足したテストは直す前に落ちた)
  • bash scripts/check-lint.sh(違反なし)
  • CI
  • マージの後に assemble を打ち直し、release/v11.0.14 の PR ができる

🤖 Generated with Claude Code

https://claude.ai/code/session_01KYHP7xPKEHnLPsZtLawhvj

takemi-ohama and others added 3 commits November 22, 2026 00:21
11.0.14 の assemble(run 44965920730)が、依存を更新した playwright-kit の Claude 版の
plugin.json だけを 4.0.5 へ上げ、ルートの plugin.json(Agent Plugins package)が 4.0.4 のまま
残って validate_manifests で落ちた。手順「版数の記載をそろえる」がルートの version と description を
Claude 版にそろえ、assemble が書き換えを受け入れるよう writes に足す。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP7xPKEHnLPsZtLawhvj
- 同期するルートの plugin.json を .ndf/release.json のこの手順の writes から読む。
  宣言に無いものがあれば書く前に止める(組み立てが writes の外として止まるのと同じパスを使う)(r1-1)
- マニフェストは 1 回読んで解析し、version と description の更新をまとめて 1 回だけ書く。
  marketplace.json も複数の項目をまとめて 1 回で書く(r1-2)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 書き換え後の本文をすべて作ってから検査し、通ったときだけ書く
- ディレクトリの宣言(plugins/playwright-kit/ など)と ./ 付きの表記を受ける
- 同期済みで書き換わらないルートの plugin.json には宣言を求めない
- 宣言漏れのテストは設定とマニフェストだけの一時ツリーで sync_descriptions を直接呼ぶ(git archive と子プロセスを使わない)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Comment thread scripts/sync-version-mentions.py Resolved
Comment thread scripts/sync-version-mentions.py Resolved
Comment thread scripts/sync-version-mentions.py Resolved
Comment thread scripts/sync-version-mentions.py Resolved
@takemi-ohama

Copy link
Copy Markdown
Contributor Author

cross-review の記録(PR #4037)

終わり方: ラウンドの上限で止まった。ラウンド 3・指摘 5(直した 4・見送った 1・未解決 0)

ラウンドと修正

ラウンド レビューした head 範囲 判定 修正のコミット 送った 直した指摘
1 f084c9957 full changes_required 248541a8e 送った r1-1・r1-2
2 248541a8e since changes_required b479c7bd4 送った r2-1・r2-2
3 b479c7bd4 since changes_required b479c7bd4 送れていない —

指摘

番号 担当 重要度 場所 指摘 終わり方 見送った理由
r1-1 codex major scripts/sync-version-mentions.py:47 組み立てでは、ルートのマニフェストを探す範囲が plugins/** の全体なのに、書き込み先の宣言には playwright-kit のパスしかありません。ルートのマニフェストを持つ対象を追加すると、版上げでファイルを書き換えた後に assemble が writes の対象外として停止します。プロジェクトごとに異なる同期対象を宣言から読み、同期処理と assemble が同じパスを使うようにしてください。 直した —
r1-2 codex major scripts/sync-version-mentions.py:59 ルートのマニフェストは、版がそろっている通常のリリースでも同じファイルを3回読み、JSON を2回解析します。版を上げると読み込みが4回になり、version と description を別々に書き込みます。1回の読み込みと解析で両方の更新を計算し、変更があればまとめて1回だけ書き込んでください。 直した —
r2-1 codex major scripts/sync-version-mentions.py:42 新しい事前検査は writes のファイル名との完全一致を要求するため、assemble が許可する plugins/playwright-kit/ のようなディレクトリ宣言でも正式版の組み立てが止まります。また、版数と description が同期済みで書き込みが発生しないルートマニフェストまで宣言を要求します。実際に更新するパスだけを、書き込み前に assemble と同じパス正規化と配下判定で検査してください。 直した —
r2-2 codex major scripts/tests/test_sync_version_mentions.py:83 宣言漏れのテストは事前検査で停止する分岐だけを確認しますが、CI でリポジトリ全体を git archive と tar で展開し、さらに Python プロセスを起動します。既存の _load() を使い、設定と対象マニフェストだけの一時ツリーに対して sync_descriptions() を直接呼べば、同じ停止条件と書き込み前の状態を追加のプロセス起動なしで検証できます。 直した —
r3-1 codex major scripts/sync-version-mentions.py:68 リリースのたびに plugins/**/.claude-plugin/plugin.json の再帰探索が1回から2回に増えています。44行目の探索でルートの plugin.json を特定しているので、その場で変更予定に入ったルートマニフェストのパスを控え、writes の事前検査に再利用してください。 見送った 基準 3 の「処理の回数」は CLI の起動・API の呼び出し・CI の実行を指す。2 回目の探索はプロセス内のファイル一覧(glob)で、新しい起動も呼び出しも増やさない。対象の plugins/ にはプラグインが 3 つしかなく、所要時間への影響は測れないほど小さい。誤動作(基準 1)・秘密や戻せない操作(基準 2)・設計の文書の食い違い(基準 4)にも当たらない。探索の結果を使い回す形は好みの設計に入るので、ファイルは変えずに見送る。

@takemi-ohama
takemi-ohama merged commit 39d8817 into main Nov 22, 2026
32 checks passed
@takemi-ohama
takemi-ohama deleted the fix/release-root-plugin-version branch November 22, 2026 00:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant