ci: dev merge後の重複wheel buildを省略

.github/workflows/build-dev.yml

@@ -1,11 +1,9 @@
 name: Build wheels (dev)
 
 on:
-  push:
-    branches: [dev]
-    paths-ignore:
-      - '**.md'
-      - '**.rst'
+  # dev requires a PR; build the full wheel matrix before merging.
+  # Post-merge tests remain in test-dev.yml. For an explicit rebuild use
+  # the existing Build wheels workflow (build.yaml) with ref=dev.
   pull_request:
     branches: [dev]
     paths-ignore:

docs/v3-ci-execution-policy.md

@@ -0,0 +1,50 @@
+<!-- SPDX-License-Identifier: MIT -->
+# devのwheel CI重複実行を避ける方針
+
+## 背景と変更
+
+PRとmerge後のdev pushで、同じ3 OSのwheel matrixを繰り返していた。
+たとえばPR #142のwheel runは35526469811、merge後は35527522837。
+Actionsの実行量を減らし、同じ変更を短い間隔で再buildしないようにする。
+
+変更は`build-dev.yml`のpush triggerだけを削除する。
+PRでは従来どおりLinux/macOS/Windowsの全wheel matrixを実行する。
+Python/ABI/architecture、smoke、共有build actionを縮小しない。
+merge後も`test-dev.yml`のPython matrix、native sanitizer、distribution検証は残す。
+
+| event | wheel | test |
+| --- | --- | --- |
+| dev向けcode PR | 全matrix | 従来どおり |
+| devへのmerge/push | 自動実行しない | 従来どおり |
+| dev向けdocs-only PR/push | 自動実行しない | 自動実行しない |
+| master・release tag | 変更なし | 変更なし |
+
+devはPR必須・削除/force-push禁止のruleset
+`Protect dev integration`（23727562）がactiveであることを確認した。
+必須status check自体はdocs-only省略のため設定せず、統合担当が該当PRのCI成功を確認する。
+rulesetやmasterの必須checkは変更しない。
+
+PR対象headと実際のmerge結果が異なる変更を含む場合や、PRを経ない例外的なpushでは、
+必要に応じてmerge後の明示wheel buildを実行する。PR成功が任意の将来commitの
+wheel互換性を保証するわけではない。
+
+## 明示的なdev再build
+
+既存のdefault branchにもある`build.yaml`のworkflow_dispatchを使う。
+dev専用workflowをdefault branchへ追加する必要はない。
+
+```sh
+gh workflow run build.yaml --ref dev --repo PyYoshi/cChardet
+```
+
+これは利用者が必要と判断して実行するコマンド例であり、
+この変更のために追加の手動buildを起動したわけではない。
+明示dispatchは自動docs-only省略とは別である。
+tag refではなくdevを指定し、release処理は起動しない。
+
+## 検証範囲
+
+構造testで、dev wheelのPR event、docs除外、3 OS matrix、共有action、
+dev pushのtest維持、master/tag/manual eventの維持を確認する。
+workflow構造の検証とGitHub上での実イベントの検証は別であり、
+PR/merge後の実行状況も統合時に確認する。

tests/test_dev_workflow_policy.py

@@ -0,0 +1,61 @@
+# SPDX-License-Identifier: MIT
+"""Structural guards for dev-only wheel deduplication and docs-only skipping."""
+
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def workflow(name):
+    return (ROOT / ".github" / "workflows" / name).read_text(encoding="utf-8")
+
+
+def events(text):
+    block = text.split("\non:\n", 1)[1].split("\npermissions:", 1)[0]
+    return "\n".join(line for line in block.splitlines() if not line.lstrip().startswith("#"))
+
+
+def test_dev_wheels_only_run_automatically_for_pull_requests():
+    assert events(workflow("build-dev.yml")).strip() == """pull_request:
+    branches: [dev]
+    paths-ignore:
+      - '**.md'
+      - '**.rst'"""
+
+
+def test_dev_retains_post_merge_tests_and_docs_only_skips():
+    block = events(workflow("test-dev.yml"))
+    assert block.strip() == """push:
+    branches: [dev]
+    paths-ignore:
+      - '**.md'
+      - '**.rst'
+  pull_request:
+    branches: [dev]
+    paths-ignore:
+      - '**.md'
+      - '**.rst'"""
+    assert "uses: ./.github/workflows/test.yml" in workflow("test-dev.yml")
+
+
+def test_full_wheel_matrix_and_read_only_permissions_remain():
+    text = workflow("build-dev.yml")
+    assert "os: [ubuntu-latest, windows-latest, macos-latest]" in text
+    assert "uses: ./.github/actions/build-wheels" in text
+    assert "submodules: recursive" in text
+    assert "permissions:\n  contents: read" in text
+
+
+def test_master_release_and_explicit_rebuild_events_remain():
+    assert events(workflow("build.yaml")).strip() == """push:
+    branches: [master]
+    tags: ["v*"]
+  pull_request:
+    branches-ignore: [dev]
+  workflow_dispatch:"""
+    assert events(workflow("test.yml")).strip() == """push:
+    branches: [master]
+  pull_request:
+    branches-ignore: [dev]
+  workflow_dispatch:
+  workflow_call:"""