wip

src/Plugins/Tia/ChangedFiles.php

@@ -244,11 +244,7 @@ final readonly class ChangedFiles
     }
 
     /**
-     * Every branch name this checkout knows, local and remote alike. Remotes
-     * count: a branch that only lives on the origin is still a branch someone
-     * will check out, and its baseline must survive.
-     *
-     * @return list<string>|null `null` when git cannot answer.
+     * @return list<string>|null
      */
     public function branchNames(): ?array
     {
@@ -307,13 +303,6 @@ final readonly class ChangedFiles
         return $process->getExitCode() === 0;
     }
 
-    /**
-     * Whether this repository has a revision to anchor a baseline to.
-     *
-     * A freshly initialised repository has none, and every other git call TIA
-     * makes — {@see self::currentBranch()}, {@see self::currentSha()} — fails on
-     * `HEAD` there and reports git as missing, which it is not.
-     */
     public function hasCommits(): bool
     {
         $process = new Process(['git', 'rev-parse', '--verify', '--quiet', 'HEAD'], $this->projectRoot);
@@ -357,10 +346,6 @@ final readonly class ChangedFiles
      */
     private function diffSinceSha(string $sha): array
     {
-        // `--no-renames` matters: with rename detection on, git reports only the
-        // destination of a moved file, so the path the graph has edges for — the
-        // one that is gone — never reaches selection, and every test that
-        // depended on it replays its recorded pass.
         $process = new Process(
             ['git', 'diff', '--name-only', '--no-renames', $sha.'..HEAD'],
             $this->projectRoot,