Repository navigation
fix: 大量のファイルを触ったコミットを履歴から外す - #27
Merged
Merged
Conversation
一括整形やライセンスヘッダの更新は、1 コミットで全モジュールの組に共起を作る が、知識は何も共有していない。原著の結合は「変更が伝播する関係」なので、 伝播していない変更は数えない。 --max-commit-files(既定 50)を超える解析対象ファイルを触ったコミットを履歴 ごと外す。同時変更だけでなく変動性と所有者の重なりからも消える。0 で無効。 EC-CUBE 4 では 3,358 件中 35 件が外れ(最大は「コピーライト更新」で PHP 833 ファイル)、同時変更率の平均が 0.048 から 0.023 に半減する。共起 0 の組は 2 から 35 に増え、「型に出ない結合」2 件は両方とも一括整形由来だったので消える。 逆に「触っている人が分かれている」が 0 から 3 件出る(一括コミットが著者の 重なりを水増ししていた)。
--max-commit-files で一括整形のコミットを履歴から外したことで、変動性の分位が 変わり、均衡度がほぼ全組で動いた(多くは 2 から 10 へ改善し、Balance -> Config だけ 8 から 5 へ悪化)。基準は測り方ごとに作り直す必要がある。 ワークフローにその旨を注記し、README にも「この値を変えたら基準を作り直す」と書いた。
valbeat
marked this pull request as ready for review
September 20, 2026 07:08
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
何を
全体の一括整形やライセンスヘッダの更新は、1 コミットで全モジュールの組に共起を作るが、知識は何も共有していない。原著の結合は「変更が伝播する関係」なので、伝播していない変更は数えるべきではない。
--max-commit-files(既定 50)を超える解析対象ファイルを触ったコミットを、履歴ごと外すようにした。同時変更だけでなく、変動性と所有者の重なりからも同時に消える。--max-commit-files=0で従来どおり。どうやって見つけたか
jev-coupling(coupling-meter の出力に Jev の判定を重ねる実験)で「この同時変更は設計上の必然か」を聞くとき、両モジュールを変えたコミットの subject を渡すようにした(#26)。すると 117 組中 116 組が「偶発」 と答えた。subject を見ると理由は明らかだった。git を直接叩いて裏を取ったところ、10 年分の履歴がある公開 OSS の PHP プロジェクトには PHP を 50 ファイル以上触ったコミットが 36 件あり、最大の一括整形コミットは 800 ファイル以上を触っており、上位 3 件はいずれもライセンス表記の更新と一括整形だった。
効果(10 年分の履歴がある公開 OSS の PHP プロジェクト)
--max-commit-files=0)33 組が「一緒に変わっているように見えていたが、共有するコミットが 1 件もない」状態だった。
既定値について
既定を 50 にした。0(無効)を既定にすると、履歴の長い OSS ではほぼ確実に汚染される。上限を上げたい場合は
--max-commit-files=200のように指定する。上で測ったプロジェクトでは 200 に上げても 6 件が外れる。確認
composer test197 tests / 663 assertions(新規 4 件)composer phpstanエラーなしcomposer cs-check差分なし依存
#26(
co_change_subjects)とは独立。どちらを先にマージしても構わない(触っている箇所が違う)。追記(レビュー対応)
main(feat: 共起したコミットの subject を --json に載せる #26 マージ後)とのコンフリクトを解消Coupling Balanceの CI 失敗を修正。--max-commit-filesで履歴から外したコミットのぶん変動性の分位が動き、均衡度がほぼ全組で変わった(多くは 2 から 10 へ改善、Balance -> Configだけ 8 から 5 へ悪化)。測り方が変わった以上、基準は作り直す必要があるため.coupling-baseline.jsonを再生成した--format系のドキュメントに「この値を変えたら基準を作り直す」を追記し、ワークフローにも注記した残る運用上の注意
均衡度は変動性を含み、変動性は git 履歴の分位なので、コミットが増えると全モジュールの順位が動く。このリポジトリは解析対象のコミットが 6 件しかないため、基準が揺れやすい。安定させるなら
coupling-meter.yamlのvolatility:でドメイン判断として宣言するのが筋だが、それは別の判断なのでこの PR には入れていない。