chore(static-analysis): type coverage results as CoverageResult for PHPStan 2.2

[wadakatu]

概要

PHPStan 2.2 で sealed array shape のチェックが厳格化され、array<string, mixed> を sealed な CoverageResult / EndpointSummary 期待箇所へ渡すコードが新たにエラー化しました。composer.lock が gitignore されているため CI は毎回 PHPStan を最新解決しており、この厳格版を取り込んで 19 件のエラーで CI（PHPStan ジョブ / PHP 8.3）が落ちています。main でも同一エラーを再現します（既存問題で、特定機能 PR とは無関係）。

変更内容

カバレッジ系の renderer/evaluator 呼び出し箇所の緩い array<string, mixed> 注釈を、OpenApiCoverageTracker で定義済みの CoverageResult / EndpointSummary エイリアスへ置き換え（ヘルパは既に完全な shape を構築済み）。型注釈のみでランタイム挙動の変更なし。

• src/Coverage/CoverageMergeCommand.php: computeResults() の @return を array<string, CoverageResult> に是正（computeCoverageOn() の実戻り値どおり）。evaluateThresholdGate() の @param も同様に是正し、不要なインライン @var を撤去。
• tests/Unit/Coverage/CoverageThresholdEvaluatorTest.php: counts() の @return を CoverageResult に（@phpstan-import-type 追加）。
• tests/Unit/Coverage/{Html,JUnit}CoverageRendererTest.php: renderOne() の $endpoint を EndpointSummary に。
• tests/Unit/Coverage/JsonCoverageRendererTest.php: oneSpecResults() の @return を array<string, CoverageResult> に。
• tests/Unit/Coverage/MarkdownCoverageRendererLintTest.php: endpoint() を EndpointSummary、*Fixture() / lint ヘルパを array<string, CoverageResult> に。

検証

PHP 8.3（CI と同条件、composer install で最新依存を解決 → PHPStan 2.2.1）で:

• vendor/bin/phpstan analyse → No errors（19 → 0）
• vendor/bin/phpunit → 1856 tests グリーン
• php-cs-fixer --dry-run → クリーン

関連情報

• PR feat(schema): enforce discriminator.mapping via if/then lowering #263 の CI も本問題でブロックされていました（feat(schema): enforce discriminator.mapping via if/then lowering #263 は discriminator 機能のみで本問題とは無関係）。本 PR マージ後に feat(schema): enforce discriminator.mapping via if/then lowering #263 を再実行すれば green になります。
• 根本原因: composer.lock の gitignore により CI が PHPStan を最新解決する設計（= 最新ツールでの継続検証）のため、ツール側の厳格化がそのまま顕在化したもの。