feat(extension): add default_testsuite_as_full to neutralize partial-run for defaultTestSuite-resolved selection

[wadakatu]

Summary

OpenApiCoverageExtension に opt-in パラメータ default_testsuite_as_full を追加。true かつ Configuration::includeTestSuites() が Configuration::defaultTestSuite() と完全一致するときだけ --testsuite 由来の partial 判定を解除し、strict_required ゲート等が defaultTestSuite ベースの canonical full run でも到達可能になるようにする。

Why

phpunit.xml に defaultTestSuite を宣言しているプロジェクトでは、引数なしの phpunit 実行でも PHPUnit が Configuration::includeTestSuites() にその名前を埋める。結果として #221 の partial 判定が常に立ち、strict_required ゲート (#225) はユーザーの default workflow からは決して評価されない (常に [OpenAPI Strict Required] NOTE: skipped on partial runs ... のみ)。

複数 suite を切っているプロジェクト (make test で Stripe 統合だけ別 job に分離する等) は defaultTestSuite を外せず、phpunit-override 等の二重 config を強いられる状況だった。

#236 で議論した 3 案のうち短期推奨の opt-in パラメータ案 (A) を採用。--testsuite signal のみを打ち消す scoped escape hatch にすることで、--filter / path args 等の他 partial signal は引き続き保護する。

Fixes #236

Verification

• 失敗テストを先に追加 (tests/Unit/Internal/PartialRunDecisionTest.php の新規 5 ケース) し、PartialRunDecision::fromSignals / OpenApiCoverageExtension::detectPartialRun を実装して green に。

• composer ci (PHPUnit 1715 / 4029 assertions + PHPStan level 6 + PHP-CS-Fixer dry) すべて pass。

• 手元の studio-api 構成での再現は本 PR では未実施 (本リポジトリの単体テストに反映済み)。Reviewer 側で必要なら issue feat(extension): treat defaultTestSuite-resolved selection as full run for strict_required / coverage gates #236 の再現プロジェクトで default_testsuite_as_full=true を設定し、[OpenAPI Strict Required] NOTE: skipped on partial runs が出なくなることを確認できます。

• composer test passes

• composer stan passes

• composer cs-check passes

Notes for reviewers

• PartialRunDecision::fromSignals は internal クラスなので、optional 引数 2 つの追加は SemVer 上問題なし (UPGRADING.md の Frozen に該当しない)。既存呼び出しは引数の名前付きで指定されているため、追加位置 (末尾) で破壊しないことを確認済み。
• default_testsuite_as_full=true を立てると output_file 等の persistent 書き込みも実行される。defaultTestSuite に含まれない suite (例: 別 job で動かす Integration suite) が抜けた状態のレポートが書かれる点はユーザー側のトレードオフ。docs/ci.md の新節と docs/strict-required.md の Partial-run skipping 節に明記。
• issue feat(extension): treat defaultTestSuite-resolved selection as full run for strict_required / coverage gates #236 の中期案 (C: PartialRunDecision を output-persistence と gate で 2 系統に分離) は本 PR の範囲外。需要があれば follow-up issue を起票。
• Configuration::hasDefaultTestSuite() / defaultTestSuite() は PHPUnit 11/12/13 すべてに存在するため readTestSuiteList() のような dynamic dispatch は不要。hasDefaultTestSuite() の guard は NoDefaultTestSuiteException の throw を避けるために必須。

[wadakatu]

Follow-up commit (1bff7c0)

Applied review findings (multi-agent review surfaced 1 critical + 5 important + several suggestions; addressed critical & all important):

• Silent failure (IMPORTANT-1/-2): readDefaultTestSuite() now WARNs when default_testsuite_as_full=true but defaultTestSuite is absent or empty. Gated on the opt-in itself — non-opt-in callers stay silent.
• Integration coverage (C1): 4 new cases in OpenApiCoverageExtensionBootstrapTest pin the bootstrap wiring end-to-end (opt-in × {missing / empty / matching default} × {opt-in / no opt-in}). The subscriber's persistent-write WARN remains covered by CoverageReportSubscriberPartialRunTest.
• Doc anchors (comment-analyzer Important 1/2): ASCII-only ci.md heading (default_testsuite_as_full opt-in) so anchors are robust across GitHub renderer versions; setup.md / strict-required.md links re-pointed accordingly.

composer ci passes locally: 1719 tests / 4035 assertions, PHPStan level 6, PHP-CS-Fixer dry.

Suggestions (anchor robustness alternatives, additional --exclude-testsuite matrix expansion, resolveBooleanFlag invalid-value pinning) intentionally deferred to follow-up — they are nice-to-haves on a path that's already covered by the new integration tests + the unit --filter cross-signal test.