feat: add stub scripts for PHAR-wrapped tools

When php-qa-ci manages tools as PHARs (phpstan, php-cs-fixer, infection,
composer-require-checker), users naturally try vendor/bin/toolname and get
a confusing "Could not open input file" error. These stubs provide clear
instructions on how to run via the QA pipeline or directly via PHAR.

Also removes stale @phpstan-ignore annotations that are no longer needed.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: LTSCommerce

.gitignore

@@ -3,11 +3,15 @@
 **/var/
 /vendor/
 /bin/*
-!/bin/qa
+!/bin/composer-require-checker
+!/bin/infection
 !/bin/mdlinks
-!/bin/psr4-validate
-!/bin/phpunit-runfailed-filter
+!/bin/php-cs-fixer
+!/bin/phpstan
 !/bin/phpunit-check-annotation
+!/bin/phpunit-runfailed-filter
+!/bin/psr4-validate
+!/bin/qa
 /cache/
 /.phive-home/
 /tools/rector/vendor/

bin/composer-require-checker

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+echo "ERROR: composer-require-checker is not installed as a standalone binary."
+echo ""
+echo "php-qa-ci manages Composer Require Checker as a PHAR in vendor-phar/composer-require-checker.phar"
+echo ""
+echo "To run via the QA pipeline (recommended):"
+echo "  vendor/bin/qa -t composerRequireChecker"
+echo ""
+echo "To run directly with custom arguments:"
+echo "  php vendor/lts/php-qa-ci/vendor-phar/composer-require-checker.phar check [args]"
+exit 1

bin/infection

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+echo "ERROR: infection is not installed as a standalone binary."
+echo ""
+echo "php-qa-ci manages Infection as a PHAR in vendor-phar/infection.phar"
+echo ""
+echo "To run via the QA pipeline (recommended):"
+echo "  vendor/bin/qa -t infection"
+echo ""
+echo "To run directly with custom arguments:"
+echo "  php vendor/lts/php-qa-ci/vendor-phar/infection.phar [args]"
+exit 1

bin/php-cs-fixer

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+echo "ERROR: php-cs-fixer is not installed as a standalone binary."
+echo ""
+echo "php-qa-ci manages PHP CS Fixer as a PHAR in vendor-phar/php-cs-fixer.phar"
+echo ""
+echo "To run via the QA pipeline (recommended):"
+echo "  vendor/bin/qa -t phpCsFixer"
+echo ""
+echo "To run directly with custom arguments:"
+echo "  php vendor/lts/php-qa-ci/vendor-phar/php-cs-fixer.phar fix [args]"
+exit 1

bin/phpstan

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+echo "ERROR: phpstan is not installed as a standalone binary."
+echo ""
+echo "php-qa-ci manages PHPStan as a PHAR in vendor-phar/phpstan.phar"
+echo ""
+echo "To run via the QA pipeline (recommended):"
+echo "  vendor/bin/qa -t phpstan"
+echo ""
+echo "To run directly with custom arguments:"
+echo "  php vendor/lts/php-qa-ci/vendor-phar/phpstan.phar analyse [args]"
+exit 1

composer.json

@@ -53,7 +53,11 @@
     }
   },
   "bin": [
+    "bin/composer-require-checker",
+    "bin/infection",
     "bin/mdlinks",
+    "bin/php-cs-fixer",
+    "bin/phpstan",
     "bin/phpunit-check-annotation",
     "bin/psr4-validate",
     "bin/qa"

src/Markdown/LinksChecker.php

@@ -231,7 +231,6 @@ private static function fetchLinkStatus(string $href): ?string
             ]);
             try {
                 $headers = @get_headers($href, false, $context);
-                /** @phpstan-ignore function.alreadyNarrowedType */
                 if (!\is_array($headers)) {
                     continue;
                 }

tests/Large/Markdown/LinksCheckerTest.php

@@ -69,7 +69,6 @@ public function testItHandlesNonFileLinks(): void
     {
         try {
             $result = @\get_headers('https://httpstat.us/200');
-            /** @phpstan-ignore identical.alwaysFalse */
             if (false === $result) {
                 self::markTestSkipped('httpstat.us is not reachable (e.g. CI environment)');
             }