Removes the --agentic-run option

raphaelstolt · raphaelstolt · commit c8dc39b364ac · 2026-05-30T11:23:25.000+02:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 
 ## [Unreleased]
 
+### Removed
+- Removed the explicit `--agtentic-run` option as agent detection is now done automatically per default.
+
 ## [v5.10.0] - 2026-05-18
 
 ### Added
diff --git a/README.md b/README.md
@@ -349,14 +349,12 @@ This project [includes](./resources/boost/skills) three AI skills focused on man
 
 ### Agentic-friendly output
 
-All commands support the `--agentic-run` option, which switches the output from human-readable text to a structured JSON object.
+All commands auto-detect agentic runs, which switches the output from human-readable text to a structured JSON object.
 This is useful when integrating the tool into AI workflows or automation pipelines where machine-readable output is preferred.
 
-> [!NOTE]
-> As of release `v5.6.1` agentic runs are auto-detected and enabled by default.
-
 ``` bash
-lean-package-validator validate --agentic-run [<directory>]
+export COPILOT_MODEL=1
+lean-package-validator validate [<directory>]
 ```
 
 ``` json
diff --git a/src/Commands/Concerns/OutputOptions.php b/src/Commands/Concerns/OutputOptions.php
@@ -11,11 +11,6 @@
 
 trait OutputOptions
 {
-    protected function addAgenticOutputOption(callable $addOption): void
-    {
-        $addOption('agentic-run', null, InputOption::VALUE_NONE, 'Enable agentic-friendly output formatting');
-    }
-
     protected function addDryRunOutputOption(callable $addOption, string $message): void
     {
         $addOption('dry-run', null, InputOption::VALUE_NONE, $message);
@@ -26,9 +21,9 @@ protected function isDryRun(InputInterface $input): bool
         return (bool) $input->getOption('dry-run');
     }
 
-    protected function isAgenticRun(InputInterface $input): bool
+    protected function isAgenticRun(): bool
     {
-        return AgentDetector::detect()->isAgent || $input->getOption('agentic-run') === true;
+        return AgentDetector::detect()->isAgent === true;
     }
 
     /**
diff --git a/src/Commands/CreateCommand.php b/src/Commands/CreateCommand.php
@@ -49,9 +49,6 @@ protected function configure(): void
         $this->addDryRunOutputOption(function (...$args) {
             $this->getDefinition()->addOption(new InputOption(...$args));
         }, 'Do not write any files. Output the expected .gitattributes content');
-        $this->addAgenticOutputOption(function (...$args) {
-            $this->getDefinition()->addOption(new InputOption(...$args));
-        });
 
         $flavourDescription = 'Generate the .gitattributes file with the given flavour';
 
@@ -70,7 +67,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         $this->analyser->getActualExportIgnoreAnalyser()->setDirectory($directory);
 
-        $isAgenticRun = $this->isAgenticRun($input);
+        $isAgenticRun = $this->isAgenticRun();
 
         $generationFlavour = $input->getOption('flavour') ?: ClassicExportIgnoreAnalyser::EXPORT_IGNORE_CLASSIC;
 
diff --git a/src/Commands/InitCommand.php b/src/Commands/InitCommand.php
@@ -83,9 +83,6 @@ protected function configure(): void
         $this->addDryRunOutputOption(function (...$args) {
             $this->getDefinition()->addOption(new InputOption(...$args));
         }, 'Do not write any files. Output the content that would be written');
-        $this->addAgenticOutputOption(function (...$args) {
-            $this->getDefinition()->addOption(new InputOption(...$args));
-        });
     }
 
     /**
@@ -103,7 +100,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         $overwriteDefaultLpvFile = $input->getOption('overwrite');
         $chosenPreset = (string) $input->getOption('preset');
         $globPatternFromPreset = false;
-        $isAgenticRun = $this->isAgenticRun($input);
+        $isAgenticRun = $this->isAgenticRun();
 
         if ($directory !== WORKING_DIRECTORY) {
             try {
diff --git a/src/Commands/ReformatCommand.php b/src/Commands/ReformatCommand.php
@@ -83,9 +83,6 @@ protected function configure(): void
         $this->addDryRunOutputOption(function (...$args) {
             $this->getDefinition()->addOption(new InputOption(...$args));
         }, 'Do not write any files. Output the content that would be written');
-        $this->addAgenticOutputOption(function (...$args) {
-            $this->getDefinition()->addOption(new InputOption(...$args));
-        });
     }
 
     /**
@@ -112,7 +109,7 @@ private function reformatPresentExportIgnores(
     ): int {
         $gitattributesPath = $this->exportIgnoreAnalyser->getGitattributesFilePath();
 
-        $isAgenticRun = $this->isAgenticRun($input);
+        $isAgenticRun = $this->isAgenticRun();
 
         if (!\file_exists($gitattributesPath) && $this->isDryRun($input) !== true) {
             if ($isAgenticRun) {
diff --git a/src/Commands/RefreshCommand.php b/src/Commands/RefreshCommand.php
@@ -85,9 +85,6 @@ protected function configure(): void
         $this->addDryRunOutputOption(function (...$args) {
             $this->getDefinition()->addOption(new InputOption(...$args));
         }, 'Do not write any files. Output the content that would be written');
-        $this->addAgenticOutputOption(function (...$args) {
-            $this->getDefinition()->addOption(new InputOption(...$args));
-        });
     }
 
     /**
@@ -103,7 +100,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
     {
         $directory = (string) $input->getArgument('directory');
         $chosenPreset = (string) $input->getOption('preset');
-        $isAgenticRun = $this->isAgenticRun($input);
+        $isAgenticRun = $this->isAgenticRun();
 
         if ($directory !== '' && $directory !== WORKING_DIRECTORY) {
             try {
diff --git a/src/Commands/TreeCommand.php b/src/Commands/TreeCommand.php
@@ -57,15 +57,12 @@ protected function configure(): void
 
         $this->addOption('src', null, InputOption::VALUE_NONE, $srcDescription);
         $this->addOption('dist-package', null, InputOption::VALUE_NONE, $distPackageDescription);
-        $this->addAgenticOutputOption(function (...$args) {
-            $this->getDefinition()->addOption(new InputOption(...$args));
-        });
     }
 
     protected function execute(InputInterface $input, OutputInterface $output): int
     {
         $this->directoryToOperateOn = (string) $input->getArgument('directory');
-        $isAgenticRun = $this->isAgenticRun($input);
+        $isAgenticRun = $this->isAgenticRun();
 
         if (!\is_dir($this->directoryToOperateOn)) {
             $warning = "Warning: The provided directory "
diff --git a/src/Commands/UpdateCommand.php b/src/Commands/UpdateCommand.php
@@ -69,16 +69,13 @@ protected function configure(): void
         $this->addDryRunOutputOption(function (...$args) {
             $this->getDefinition()->addOption(new InputOption(...$args));
         }, 'Do not write any files. Output the expected .gitattributes content');
-        $this->addAgenticOutputOption(function (...$args) {
-            $this->getDefinition()->addOption(new InputOption(...$args));
-        });
     }
 
     protected function execute(InputInterface $input, OutputInterface $output): int
     {
         $directory = (string) $input->getArgument('directory') ?: \getcwd();
         $this->exportIgnoreAnalyser->setDirectory($directory);
-        $isAgenticRun = $this->isAgenticRun($input);
+        $isAgenticRun = $this->isAgenticRun();
 
         if ((bool) $input->getOption('group')) {
             $this->exportIgnoreAnalyser->setGroupNonExportIgnores(true);
diff --git a/src/Commands/ValidateCommand.php b/src/Commands/ValidateCommand.php
@@ -202,9 +202,6 @@ protected function configure(): void
             InputOption::VALUE_NONE,
             $reportStaleExportIgnoresDescription
         );
-        $this->addAgenticOutputOption(function (...$args) {
-            $this->getDefinition()->addOption(new InputOption(...$args));
-        });
     }
 
     /**
@@ -222,7 +219,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
     {
         $directory = (string) $input->getArgument('directory');
         $chosenPreset = (string) $input->getOption('preset');
-        $isAgenticRun = $this->isAgenticRun($input);
+        $isAgenticRun = $this->isAgenticRun();
 
         if ($directory !== \getcwd()) {
             try {
diff --git a/tests/Commands/Concerns/OutputOptionsTest.php b/tests/Commands/Concerns/OutputOptionsTest.php
@@ -8,26 +8,23 @@
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\TestCase;
 use Stolt\LeanPackage\Commands\Concerns\OutputOptions;
-use Symfony\Component\Console\Input\InputInterface;
 
 class OutputOptionsTest extends TestCase
 {
     use OutputOptions;
 
     protected function tearDown(): void
     {
+        \putenv('COPILOT_MODEL');
         unset($_ENV['COPILOT_MODEL']);
     }
 
     #[Test]
     #[RunInSeparateProcess]
     public function itAutoDetectsAnAiAgent(): void
     {
-        $mockedInput = $this->createMock(InputInterface::class);
-        $mockedInput->method('getOption')->with('agentic-run')->willReturn(false);
-
         \putenv('COPILOT_MODEL=1');
 
-        $this->assertTrue($this->isAgenticRun($mockedInput));
+        $this->assertTrue($this->isAgenticRun());
     }
 }
diff --git a/tests/Commands/CreateCommandTest.php b/tests/Commands/CreateCommandTest.php
@@ -43,6 +43,7 @@ private function getCommandInstance(): CreateCommand
     protected function tearDown(): void
     {
         $this->removeDirectory($this->temporaryDirectory);
+        $this->clearAgenticEnvironment();
     }
 
     #[Test]
@@ -270,17 +271,18 @@ public function failsIfGitattributesAlreadyExists(): void
     }
 
     #[Test]
-    public function outputsJsonOnSuccessWhenAgenticRunOptionIsSet(): void
+    public function outputsJsonOnSuccessInAnAgenticRun(): void
     {
         if ((new OsHelper())->isWindows()) {
             $this->markTestSkipped('Skipping test on Windows systems');
         }
 
         $this->createTemporaryFiles(['README.md', '.gitignore'], ['tests']);
 
+        \putenv('COPILOT_MODEL=1');
+
         $result = TestCommand::for($this->getCommandInstance())
             ->addArgument($this->temporaryDirectory)
-            ->addOption('agentic-run')
             ->execute()
             ->assertSuccessful();
 
@@ -294,7 +296,7 @@ public function outputsJsonOnSuccessWhenAgenticRunOptionIsSet(): void
     }
 
     #[Test]
-    public function outputsJsonOnFailureWhenAgenticRunOptionIsSet(): void
+    public function outputsJsonOnFailureInAnAgenticRun(): void
     {
         $gitattributesContent = <<<CONTENT
 
@@ -303,9 +305,10 @@ public function outputsJsonOnFailureWhenAgenticRunOptionIsSet(): void
 CONTENT;
         $this->createTemporaryGitattributesFile($gitattributesContent);
 
+        \putenv('COPILOT_MODEL=1');
+
         $result = TestCommand::for($this->getCommandInstance())
             ->addArgument($this->temporaryDirectory)
-            ->addOption('agentic-run')
             ->execute()
             ->assertFaulty();
 
diff --git a/tests/Commands/InitCommandTest.php b/tests/Commands/InitCommandTest.php
@@ -51,6 +51,7 @@ protected function tearDown(): void
         if (\is_dir($this->temporaryDirectory)) {
             $this->removeDirectory($this->temporaryDirectory);
         }
+        $this->clearAgenticEnvironment();
     }
 
     #[Test]
@@ -228,15 +229,16 @@ public function existingDefaultLpvFileIsOverwrittenWhenDesired(): void
     }
 
     #[Test]
-    public function outputsJsonOnSuccessWhenAgenticRunOptionIsSet(): void
+    public function outputsJsonOnSuccessInAnAgenticRun(): void
     {
         $command = $this->application->find('init');
         $tester = new CommandTester($command);
 
+        \putenv('COPILOT_MODEL=1');
+
         $exitCode = $tester->execute([
             'command' => $command->getName(),
             'directory' => WORKING_DIRECTORY,
-            '--agentic-run' => true,
         ]);
 
         $this->assertSame(Command::SUCCESS, $exitCode);
@@ -251,17 +253,18 @@ public function outputsJsonOnSuccessWhenAgenticRunOptionIsSet(): void
     }
 
     #[Test]
-    public function outputsJsonOnFailureWhenAgenticRunOptionIsSet(): void
+    public function outputsJsonOnFailureInAnAgenticRun(): void
     {
         $this->createTemporaryFilesInDirectory($this->temporaryDirectory, ['.lpv']);
 
         $command = $this->application->find('init');
         $tester = new CommandTester($command);
 
+        \putenv('COPILOT_MODEL=1');
+
         $exitCode = $tester->execute([
             'command' => $command->getName(),
             'directory' => WORKING_DIRECTORY,
-            '--agentic-run' => true,
         ]);
 
         $this->assertTrue($exitCode !== Command::SUCCESS);
diff --git a/tests/Commands/RefreshCommandTest.php b/tests/Commands/RefreshCommandTest.php
@@ -38,6 +38,7 @@ protected function tearDown(): void
         if (\is_dir($this->temporaryDirectory)) {
             $this->removeDirectory($this->temporaryDirectory);
         }
+        $this->clearAgenticEnvironment();
     }
 
     /**
@@ -160,18 +161,19 @@ public function usingANonAvailablePresetShowsWarning(): void
     }
 
     #[Test]
-    public function outputsJsonOnSuccessWhenAgenticRunOptionIsSet(): void
+    public function outputsJsonOnSuccessInAnAgenticRun(): void
     {
         $this->createTemporaryGlobPatternFile("*.txt\n*.lock\n");
 
         $command = $this->application->find('refresh');
         $tester = new CommandTester($command);
 
+        \putenv('COPILOT_MODEL=1');
+
         $exitCode = $tester->execute([
             'command' => $command->getName(),
             'directory' => WORKING_DIRECTORY,
             '--preset' => 'PHP',
-            '--agentic-run' => true,
         ]);
 
         $this->assertSame(Command::SUCCESS, $exitCode);
@@ -191,11 +193,12 @@ public function outputsJsonOnFailureWhenAgenticRunOptionIsSet(): void
         $command = $this->application->find('refresh');
         $tester = new CommandTester($command);
 
+        \putenv('COPILOT_MODEL=1');
+
         $exitCode = $tester->execute([
             'command' => $command->getName(),
             'directory' => WORKING_DIRECTORY,
             '--preset' => 'PHP',
-            '--agentic-run' => true,
         ]);
 
         $this->assertTrue($exitCode !== Command::SUCCESS);
diff --git a/tests/Commands/TreeCommandTest.php b/tests/Commands/TreeCommandTest.php
@@ -37,6 +37,7 @@ protected function tearDown(): void
         if (\is_dir($this->temporaryDirectory)) {
             $this->removeDirectory($this->temporaryDirectory);
         }
+        $this->clearAgenticEnvironment();
     }
     #[Test]
     public function displaysExpectedSrcTree(): void
@@ -110,7 +111,7 @@ public function displaysExpectedDistPackageTree(): void
     }
 
     #[Test]
-    public function outputsJsonWhenAgenticRunOptionIsSet(): void
+    public function outputsJsonInAnAgenticRun(): void
     {
         $command = $this->application->find('tree');
         $commandTester = new CommandTester($command);
@@ -121,11 +122,12 @@ public function outputsJsonWhenAgenticRunOptionIsSet(): void
             \json_encode(['name' => 'test/agentic-package'])
         );
 
+        \putenv('COPILOT_MODEL=1');
+
         $commandTester->execute([
             'command' => $command->getName(),
             'directory' => $this->temporaryDirectory,
             '--src' => true,
-            '--agentic-run' => true,
         ]);
 
         $commandTester->assertCommandIsSuccessful();
diff --git a/tests/Commands/UpdateCommandTest.php b/tests/Commands/UpdateCommandTest.php
diff --git a/tests/Commands/ValidateCommandTest.php b/tests/Commands/ValidateCommandTest.php
diff --git a/tests/TestCase.php b/tests/TestCase.php

Original file line number	Diff line number	Diff line change
`@@ -11,11 +11,6 @@`
`11`	`11`
`12`	`12`	`trait OutputOptions`
`13`	`13`	`{`
`14`		`- protected function addAgenticOutputOption(callable $addOption): void`
`15`		`- {`
`16`		`- $addOption('agentic-run', null, InputOption::VALUE_NONE, 'Enable agentic-friendly output formatting');`
`17`		`- }`
`18`		`-`
`19`	`14`	`protected function addDryRunOutputOption(callable $addOption, string $message): void`
`20`	`15`	`{`
`21`	`16`	`$addOption('dry-run', null, InputOption::VALUE_NONE, $message);`
`@@ -26,9 +21,9 @@ protected function isDryRun(InputInterface $input): bool`
`26`	`21`	`return (bool) $input->getOption('dry-run');`
`27`	`22`	`}`
`28`	`23`
`29`		`- protected function isAgenticRun(InputInterface $input): bool`
	`24`	`+ protected function isAgenticRun(): bool`
`30`	`25`	`{`
`31`		`- return AgentDetector::detect()->isAgent \|\| $input->getOption('agentic-run') === true;`
	`26`	`+ return AgentDetector::detect()->isAgent === true;`
`32`	`27`	`}`
`33`	`28`
`34`	`29`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -57,15 +57,12 @@ protected function configure(): void`
`57`	`57`
`58`	`58`	`$this->addOption('src', null, InputOption::VALUE_NONE, $srcDescription);`
`59`	`59`	`$this->addOption('dist-package', null, InputOption::VALUE_NONE, $distPackageDescription);`
`60`		`- $this->addAgenticOutputOption(function (...$args) {`
`61`		`- $this->getDefinition()->addOption(new InputOption(...$args));`
`62`		`- });`
`63`	`60`	`}`
`64`	`61`
`65`	`62`	`protected function execute(InputInterface $input, OutputInterface $output): int`
`66`	`63`	`{`
`67`	`64`	`$this->directoryToOperateOn = (string) $input->getArgument('directory');`
`68`		`- $isAgenticRun = $this->isAgenticRun($input);`
	`65`	`+ $isAgenticRun = $this->isAgenticRun();`
`69`	`66`
`70`	`67`	`if (!\is_dir($this->directoryToOperateOn)) {`
`71`	`68`	`$warning = "Warning: The provided directory "`