feat(health): add getChecks() and afterAll() lifecycle hook

- getChecks() returns registered checks for introspection
- afterAll() registers callbacks invoked after runAll() with aggregate results
- reset() now also clears afterAll callbacks

Closes #392
Closes #391

Author: Ibrahim BinAlshikh

WebFiori/Framework/Health/HealthCheck.php

@@ -21,6 +21,10 @@ class HealthCheck {
      * @var array Registered checks indexed by name.
      */
     private static array $checks = [];
+    /**
+     * @var array Callbacks to execute after runAll() completes.
+     */
+    private static array $afterAllCallbacks = [];
     /**
      * Register a health check.
      *
@@ -68,17 +72,24 @@ public static function runAll(): array {
             }
         }
 
-        return [
+        $aggregate = [
             'status' => $allOk ? 'ok' : 'fail',
             'timestamp' => date('c'),
             'checks' => $results,
         ];
+
+        foreach (self::$afterAllCallbacks as $cb) {
+            $cb($aggregate);
+        }
+
+        return $aggregate;
     }
     /**
      * Remove all registered checks.
      */
     public static function reset(): void {
         self::$checks = [];
+        self::$afterAllCallbacks = [];
     }
     /**
      * Returns the number of registered checks.
@@ -88,4 +99,24 @@ public static function reset(): void {
     public static function getCheckCount(): int {
         return count(self::$checks);
     }
+    /**
+     * Returns all registered checks.
+     *
+     * @return array Associative array keyed by check name. Values are
+     * HealthCheckInterface instances or callables.
+     */
+    public static function getChecks(): array {
+        return self::$checks;
+    }
+    /**
+     * Register a callback to execute after all checks complete.
+     *
+     * The callback receives the aggregate result array with 'status',
+     * 'timestamp', and 'checks' keys.
+     *
+     * @param callable $callback A function that accepts the aggregate results array.
+     */
+    public static function afterAll(callable $callback): void {
+        self::$afterAllCallbacks[] = $callback;
+    }
 }

tests/WebFiori/Framework/Tests/Health/HealthCheckTest.php

@@ -130,4 +130,62 @@ public function testResultToArray() {
         $this->assertEquals('fail', $arr['status']);
         $this->assertEquals('down', $arr['reason']);
     }
+
+    /** @test */
+    public function testGetChecksReturnsRegisteredChecks() {
+        HealthCheck::reset();
+        HealthCheck::register(new PassingCheck());
+        HealthCheck::register('custom', fn() => HealthCheckResult::ok());
+
+        $checks = HealthCheck::getChecks();
+        $this->assertCount(2, $checks);
+        $this->assertArrayHasKey('passing', $checks);
+        $this->assertArrayHasKey('custom', $checks);
+        $this->assertInstanceOf(HealthCheckInterface::class, $checks['passing']);
+        $this->assertIsCallable($checks['custom']);
+    }
+
+    /** @test */
+    public function testAfterAllCallbackReceivesAggregateResults() {
+        HealthCheck::reset();
+        HealthCheck::register(new PassingCheck());
+        HealthCheck::register(new FailingCheck());
+
+        $received = null;
+        HealthCheck::afterAll(function (array $results) use (&$received) {
+            $received = $results;
+        });
+
+        $result = HealthCheck::runAll();
+
+        $this->assertNotNull($received);
+        $this->assertEquals($result, $received);
+        $this->assertEquals('fail', $received['status']);
+        $this->assertArrayHasKey('passing', $received['checks']);
+        $this->assertArrayHasKey('failing', $received['checks']);
+    }
+
+    /** @test */
+    public function testAfterAllMultipleCallbacks() {
+        HealthCheck::reset();
+        HealthCheck::register(new PassingCheck());
+
+        $count = 0;
+        HealthCheck::afterAll(function () use (&$count) { $count++; });
+        HealthCheck::afterAll(function () use (&$count) { $count++; });
+
+        HealthCheck::runAll();
+        $this->assertEquals(2, $count);
+    }
+
+    /** @test */
+    public function testResetClearsAfterAllCallbacks() {
+        HealthCheck::reset();
+        $called = false;
+        HealthCheck::afterAll(function () use (&$called) { $called = true; });
+        HealthCheck::reset();
+        HealthCheck::register(new PassingCheck());
+        HealthCheck::runAll();
+        $this->assertFalse($called);
+    }
 }