feat(soar): Add callback parameter to scores, help, and version

- Modify scores method to accept a callable for processing results.
- Update help and version methods to include a callback parameter.
- Enhance pest command to improve test output presentation.
- Ensure backward compatibility by defaulting callback to null.

Author: guanguans

composer.json

@@ -52,7 +52,7 @@
         "ergebnis/license": "^2.6",
         "ergebnis/php-cs-fixer-config": "dev-main",
         "ergebnis/rector-rules": "^1.4",
-        "guanguans/ai-commit": "dev-main",
+        "guanguans/ai-commit": "^1.15",
         "guanguans/monorepo-builder-worker": "^2.0",
         "illuminate/support": "^9.52 || ^10.0 || ^11.0 || ^12.0",
         "mockery/mockery": "^1.6",
@@ -218,7 +218,8 @@
         "normalized-dry-run": "@normalized --dry-run",
         "peck": "/opt/homebrew/opt/php@8.3/bin/php ./vendor/bin/peck check --path=src/ --config=peck.json --ansi -v",
         "peck-init": "@peck --init",
-        "pest": "@php ./vendor/bin/pest --coverage",
+        "pest": "@php ./vendor/bin/pest --colors=always --min=80 --coverage",
+        "pest-bail": "@pest --bail",
         "pest-coverage": "@pest --coverage-html=./.build/phpunit/ --coverage-clover=./.build/phpunit/clover.xml",
         "pest-highest": [
             "@putenvs",

src/Concerns/ConcreteScores.php

@@ -68,12 +68,12 @@ public function markdownScores(array|string $sqls): string
      *
      * @throws \Guanguans\SoarPHP\Exceptions\InvalidOptionException
      */
-    public function scores(array|string $sqls): string
+    public function scores(array|string $sqls, ?callable $callback = null): string
     {
         if (\is_array($sqls)) {
             $sqls = implode($this->getDelimiter(';'), $sqls);
         }
 
-        return $this->clone()->withQuery($sqls)->run();
+        return $this->clone()->withQuery($sqls)->run($callback);
     }
 }

src/Contracts/Soar.php

@@ -22,10 +22,17 @@ public function run(?callable $callback = null): string;
 
     /**
      * @param list<string>|string $sqls
+     * @param null|callable(string, string): void $callback
      */
-    public function scores(array|string $sqls): string;
+    public function scores(array|string $sqls, ?callable $callback = null): string;
 
-    public function help(): string;
+    /**
+     * @param null|callable(string, string): void $callback
+     */
+    public function help(?callable $callback = null): string;
 
-    public function version(): string;
+    /**
+     * @param null|callable(string, string): void $callback
+     */
+    public function version(?callable $callback = null): string;
 }

src/Soar.php

@@ -43,21 +43,22 @@ public function __construct(array $options = [], ?string $soarBinary = null)
     /**
      * @throws \Guanguans\SoarPHP\Exceptions\InvalidOptionException
      */
-    public function help(): string
+    public function help(?callable $callback = null): string
     {
         return $this->clone()->setHelp(true)->run(
-            static function (string $type, string $line) use (&$errorOutput): void {
+            static function (string $type, string $line) use (&$errorOutput, $callback): void {
                 Process::ERR === $type and $errorOutput .= $line;
+                $callback and $callback($type, $line);
             }
         ) ?: $errorOutput;
     }
 
     /**
      * @throws \Guanguans\SoarPHP\Exceptions\InvalidOptionException
      */
-    public function version(): string
+    public function version(?callable $callback = null): string
     {
-        return $this->clone()->setVersion(true)->run();
+        return $this->clone()->setVersion(true)->run($callback);
     }
 
     public function clone(): self