chore: style

src/Plugins/Tia/ChangedFiles.php

@@ -219,16 +219,6 @@ final readonly class ChangedFiles
         return $branch === '' || $branch === 'HEAD' ? null : $branch;
     }
 
-    /**
-     * The repository's default branch — the one every other branch's baseline
-     * falls back to reading.
-     *
-     * Advisory, unlike {@see self::currentBranch()}: a repository that cannot
-     * answer the question is not a broken repository. A remote-less checkout
-     * has no `origin/HEAD`, and plenty of CI checkouts never run
-     * `git remote set-head`, so every step here fails soft and the caller is
-     * left to pick its own default.
-     */
     public function defaultBranch(): ?string
     {
         $head = $this->gitOutput(['git', 'symbolic-ref', '--short', 'refs/remotes/origin/HEAD']);
@@ -241,10 +231,6 @@ final readonly class ChangedFiles
             }
         }
 
-        // `init.defaultBranch` is a setting of the machine, not of the
-        // repository — it names what `git init` would have called the first
-        // branch here, which is worth nothing once the repository disagrees.
-        // Taken only when a branch by that name actually exists.
         $configured = $this->gitOutput(['git', 'config', '--get', 'init.defaultBranch']);
 
         if ($configured === null) {
@@ -257,12 +243,6 @@ final readonly class ChangedFiles
         return $exists ? $configured : null;
     }
 
-    /**
-     * Whether the repository has any remote configured.
-     *
-     * Advisory like {@see self::defaultBranch()} — a `git` that cannot answer
-     * is reported as "no remote", and the caller decides what that means.
-     */
     public function hasRemote(): bool
     {
         return $this->gitOutput(['git', 'remote']) !== null;

src/Plugins/Tia/CiDefaultBranch.php

@@ -5,23 +5,10 @@ declare(strict_types=1);
 namespace Pest\Plugins\Tia;
 
 /**
- * The default branch as the CI provider itself reports it.
- *
- * Worth asking before git: a CI checkout is the one place where git knows the
- * least. `actions/checkout` builds the working copy with `git init` plus a
- * single-ref `fetch` rather than a `clone`, so `origin/HEAD` is never set and
- * `init.defaultBranch` — a setting of the runner image, not of the repository —
- * is all git has left to offer. The provider, meanwhile, states the answer
- * outright in the environment it handed us.
- *
  * @internal
  */
 final class CiDefaultBranch
 {
-    /**
-     * Advisory, like every other source in the chain: anything unreadable,
-     * unparsable, or simply absent means "no answer", never a failure.
-     */
     public static function detect(): ?string
     {
         return self::fromGitLab() ?? self::fromGitHubEvent();
@@ -32,11 +19,6 @@ final class CiDefaultBranch
         return self::environment('CI_DEFAULT_BRANCH');
     }
 
-    /**
-     * GitHub publishes no default-branch variable, but every repository-scoped
-     * event payload carries `repository.default_branch`, and the path to that
-     * payload is in the environment.
-     */
     private static function fromGitHubEvent(): ?string
     {
         $path = self::environment('GITHUB_EVENT_PATH');

src/Plugins/Tia/Configuration.php

@@ -61,12 +61,6 @@ final class Configuration
     }
 
     /**
-     * The branch whose baseline every other branch falls back to reading.
-     *
-     * Autodetected from the repository when left unset; declare it here when
-     * the repository cannot answer for itself — no `origin/HEAD`, or an
-     * `init.defaultBranch` that disagrees with reality.
-     *
      * @return $this
      */
     public function defaultBranch(string $branch): self

src/Plugins/Tia/Graph.php

@@ -48,15 +48,6 @@ final class Graph
      */
     private array $baselines = [];
 
-    /**
-     * The baseline a branch with none of its own reads from.
-     *
-     * Only ever read from: a branch writes to its own key, so a fallback that
-     * leaked into the write path would corrupt the baseline every other branch
-     * depends on. Resolved once per run by the plugin — see
-     * {@see self::setFallbackBranch()} — because the git calls it takes are not
-     * free and the read path runs per test.
-     */
     private string $fallbackBranch = 'main';
 
     private readonly string $projectRoot;
@@ -704,15 +695,6 @@ final class Graph
         return array_keys($files);
     }
 
-    /**
-     * Whether any cached result due a re-run points at a test file that is not
-     * on disk — deleted, or never locatable in the first place (`eval()`'d code,
-     * a path outside the project).
-     *
-     * A filtered run cannot honour such an entry: it would select a file that
-     * collects no tests, so the run reports green without ever re-running the
-     * failure — and does so again on every subsequent invocation.
-     */
     public function hasUnlocatedTestsToRerun(string $branch, ?string $fallbackBranch = null): bool
     {
         $baseline = $this->baselineFor($branch, $fallbackBranch);
@@ -730,9 +712,6 @@ final class Graph
 
             $rel = $this->relative($file);
 
-            // Results are stored relative, so `relative()` answers "is this
-            // inside the project" without ever touching the filesystem. The
-            // stat is what tells a deleted test file apart from a live one.
             if ($rel === null || ! is_file($this->projectRoot.'/'.$rel)) {
                 return true;
             }
@@ -856,13 +835,7 @@ final class Graph
 
     /**
      * @param  array<string, array<int, string>>  $testToFiles
-     * @param  bool  $keepExisting  Leave already-recorded edge sets alone. For runs
-     *                              whose edges are piggybacked off a PHPUnit coverage
-     *                              session: that data is scoped by `<source>`, so it
-     *                              can only ever be narrower than what the TIA
-     *                              recorder sees — it never contains the test's own
-     *                              file, for one — and a narrower edge set silently
-     *                              stops selecting the tests it used to select.
+     * @param  bool  $keepExisting  Leave already-recorded edge sets alone.
      */
     public function replaceEdges(array $testToFiles, bool $keepExisting = false): void
     {
@@ -873,8 +846,6 @@ final class Graph
                 continue;
             }
 
-            // An empty set means "known, covers nothing", so piggyback data is
-            // still an improvement there — only a populated set is protected.
             if ($keepExisting && ($this->edges[$testRel] ?? []) !== []) {
                 continue;
             }
@@ -1483,13 +1454,6 @@ final class Graph
     }
 
     /**
-     * The branches a recorded graph holds baselines for, read straight from the
-     * encoded form.
-     *
-     * Answerable before the graph is hydrated because the default branch has to
-     * be resolved first: the fallback is what every hydrated graph reads its
-     * baselines through.
-     *
      * @return list<string>
      */
     public static function branchesIn(string $json): array