Skip to content

fix: 大量のファイルを触ったコミットを履歴から外す - #27

Merged
valbeat merged 3 commits into
mainfrom
feat/skip-bulk-commits
Sep 20, 2026
Merged

valbeat merged 3 commits into
mainfrom
feat/skip-bulk-commits

Conversation

@valbeat

@valbeat valbeat commented Sep 20, 2026 •

Copy link
Copy Markdown
Member

何を

全体の一括整形やライセンスヘッダの更新は、1 コミットで全モジュールの組に共起を作るが、知識は何も共有していない。原著の結合は「変更が伝播する関係」なので、伝播していない変更は数えるべきではない。

--max-commit-files(既定 50)を超える解析対象ファイルを触ったコミットを、履歴ごと外すようにした。同時変更だけでなく、変動性と所有者の重なりからも同時に消える。--max-commit-files=0 で従来どおり。

どうやって見つけたか

jev-coupling(coupling-meter の出力に Jev の判定を重ねる実験)で「この同時変更は設計上の必然か」を聞くとき、両モジュールを変えたコミットの subject を渡すようにした(#26)。すると 117 組中 116 組が「偶発」 と答えた。subject を見ると理由は明らかだった。

A -> B
  ["未使用の private プロパティやメソッドを削除",
   "Apply php-cs-fixer fix src",
   "Apply php-cs-fixer fix"]

git を直接叩いて裏を取ったところ、10 年分の履歴がある公開 OSS の PHP プロジェクトには PHP を 50 ファイル以上触ったコミットが 36 件あり、最大の一括整形コミットは 800 ファイル以上を触っており、上位 3 件はいずれもライセンス表記の更新と一括整形だった。

共起イベント 合計 9,651
うち 50 ファイル以上のコミット由来 5,560(57.6%)
組の数 1,467
共起が大量コミットだけで成り立っている組 840(57%)

効果(10 年分の履歴がある公開 OSS の PHP プロジェクト)

before(--max-commit-files=0) after(既定 50)
解析コミット 3,358 3,332(35 件を除外)
同時変更率の平均 0.048 0.023
共起が 0 件の組 2 / 182 35 / 182
バランスが崩れている組 37 34
指摘「型に出ない結合」 2 0(どちらも一括整形由来だった)
指摘「触っている人が分かれている」 0 3(一括コミットが著者の重なりを水増ししていた)
直す順の上位 15 の入れ替わり — 2 組

33 組が「一緒に変わっているように見えていたが、共有するコミットが 1 件もない」状態だった。

既定値について

既定を 50 にした。0(無効)を既定にすると、履歴の長い OSS ではほぼ確実に汚染される。上限を上げたい場合は --max-commit-files=200 のように指定する。上で測ったプロジェクトでは 200 に上げても 6 件が外れる。

確認

  • composer test 197 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 を再生成した
  • README と --format 系のドキュメントに「この値を変えたら基準を作り直す」を追記し、ワークフローにも注記した
  • README と fixture から特定のプロジェクト名とテーブル名を外した

残る運用上の注意

均衡度は変動性を含み、変動性は git 履歴の分位なので、コミットが増えると全モジュールの順位が動く。このリポジトリは解析対象のコミットが 6 件しかないため、基準が揺れやすい。安定させるなら coupling-meter.yaml の volatility: でドメイン判断として宣言するのが筋だが、それは別の判断なのでこの PR には入れていない。

一括整形やライセンスヘッダの更新は、1 コミットで全モジュールの組に共起を作る
が、知識は何も共有していない。原著の結合は「変更が伝播する関係」なので、
伝播していない変更は数えない。

--max-commit-files(既定 50)を超える解析対象ファイルを触ったコミットを履歴
ごと外す。同時変更だけでなく変動性と所有者の重なりからも消える。0 で無効。

EC-CUBE 4 では 3,358 件中 35 件が外れ(最大は「コピーライト更新」で PHP 833
ファイル)、同時変更率の平均が 0.048 から 0.023 に半減する。共起 0 の組は 2 から
35 に増え、「型に出ない結合」2 件は両方とも一括整形由来だったので消える。
逆に「触っている人が分かれている」が 0 から 3 件出る(一括コミットが著者の
重なりを水増ししていた)。
@valbeat valbeat self-assigned this Sep 20, 2026
--max-commit-files で一括整形のコミットを履歴から外したことで、変動性の分位が
変わり、均衡度がほぼ全組で動いた(多くは 2 から 10 へ改善し、Balance -> Config
だけ 8 から 5 へ悪化)。基準は測り方ごとに作り直す必要がある。

ワークフローにその旨を注記し、README にも「この値を変えたら基準を作り直す」と書いた。
@valbeat
valbeat marked this pull request as ready for review September 20, 2026 07:08
@valbeat
valbeat merged commit 301ea09 into main Sep 20, 2026
10 checks passed
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