Skip to content

bucket-mode 名を progresskpabs に改名 (旧名は非推奨 alias) - #407

Merged
SH11235 merged 2 commits into
mainfrom
refactor/bucket-mode-rename-progresskpabs
Sep 5, 2026
Merged

SH11235 merged 2 commits into
mainfrom
refactor/bucket-mode-rename-progresskpabs

Conversation

@SH11235

@SH11235 SH11235 commented Sep 5, 2026

Copy link
Copy Markdown
Owner

概要

LayerStack の bucket-mode canonical 名を progress8kpabs から progresskpabs に改名する。

綴りに含まれる「8」は bucket 数を意味しない (bucket 数は --num-buckets、既定 9) レガシー名で、実態と乖離していた。また推論エンジン rshogi 側の canonical 名は既に progresskpabs であり、クロスリポで綴りが割れていたのを揃える。

変更内容

  • BucketMode::ProgressKpAbs へ variant rename、canonical_name() = "progresskpabs"
  • BucketMode::parse / parse_cli を単一パース点として追加。CLI (trainer / eval_sfen) のエラー文・非推奨警告文を共通化
  • experiment.json の params.bucket_mode は CLI 生文字列ではなくパース済み mode の canonical 名を記録
  • raw checkpoint reader は格納 bucket_mode を正規化して照合。writer は canonical 名のみ書く。header layout 不変・version bump なし
  • docs / bench-pos.toml / コメント類の表記更新

alias ポリシー

層 方針
checkpoint read 旧綴り progress8kpabs を恒久 alias として受理 (既存 ckpt の --resume / --eval-only を維持)。v7 以前の暗黙値も progresskpabs として解釈
CLI --bucket-mode 旧綴りを非推奨 alias として受理し [deprecated] 警告を表示。削除期限 = 次の大規模学習 campaign 完了後
checkpoint / experiment.json write canonical 名のみ

forward 互換の注意

本改名後に書かれた checkpoint (新名格納) は、改名前の binary では resume できない (bucket mode 文字列の不一致エラー)。

検証

  • sh11235 (ubuntu-3080ti) で bash scripts/local-ci.sh フル PASS ×2 回 (d5d826e 時点 / 480e9b2 時点、全 step・GPU テスト含む)
  • Windows 側: cargo fmt --check / cargo clippy --workspace --all-targets -- -D warnings / CPU テスト (nnue-train 141 / eval-sfen 2 / cli_tests 65 / raw_ckpt 30) green
  • テスト追加: 旧綴り格納 v8 ckpt の受理 + cross-mode 拒否、CLI alias 受理と警告文内容、alias 入力時の experiment.json canonical 固定、eval_sfen の引数整合検証
  • 独立レビュー (Codex): REQUEST_CHANGES 4 件 → 対応 → APPROVE

設計ノートは別途管理。

🤖 Generated with Claude Code

SH11235 and others added 2 commits September 6, 2026 02:50
…lias)

綴りに含まれる 8 は bucket 数ではなく (bucket 数は --num-buckets、既定 9)、
推論エンジン rshogi の canonical 名 progresskpabs とも綴りが割れていたため
名前を実態に揃える。

- BucketMode::parse を単一パース点として追加し、canonical 名 2 種 +
  非推奨 alias progress8kpabs を受理 (CLI は alias 使用時に警告を表示)
- raw checkpoint reader は格納 bucket_mode を正規化して照合する
  (旧名で書かれた既存 ckpt の --resume / --eval-only を維持、恒久 alias)。
  writer は canonical 名のみ書く。header layout は不変で version bump なし
- eval_sfen も同じ alias を受理
- 旧名格納 v8 ckpt の受理 / cross-mode 拒否 / CLI alias 受理のテストを追加

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…nonical 名に固定

- experiment.json の params.bucket_mode に CLI 生文字列を保存していたため、
  非推奨 alias で起動した run に旧綴りが記録されていた。パース済み mode の
  canonical_name() を保存する
- BucketMode::parse_cli を追加し、trainer / eval_sfen の --bucket-mode の
  エラー文と非推奨警告文を単一パース点に集約 (eval_sfen の独自 match を排除)
- eval_sfen の引数整合検証を validate_mode_args として分離しテストを追加、
  parse_cli の警告文内容 (alias のみ [deprecated]、canonical は警告なし) を
  テストで固定
- BucketMode の alias コメントから経緯記述を除き入力互換規則のみ残す

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 5, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-05T18:24:14.667324Z 480e9b2 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@SH11235
SH11235 merged commit 7c33786 into main Sep 5, 2026
1 check passed
@SH11235
SH11235 deleted the refactor/bucket-mode-rename-progresskpabs branch September 5, 2026 18:27
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