feat(Framework): Add Session and Worker events

refactor(Teamcity): Render environment info
refactor(CLI): Print environment info

Author: roxblnfk

docs/spec/events-naming.md

@@ -42,23 +42,35 @@ TestRetrying  // Event fired when a test is about to be retried
 When events form a hierarchy, the entity name should reflect the nesting level:
 
 ```
-TestPipeline    → Top level (run interceptors pipeline)
-  TestBatch     → Mid level (multiple runs of same test)
-    Test        → Individual test execution
+Session         → Outermost level (entire test run lifecycle)
+  Worker        → Subprocess level (parallel/isolated execution)
+    TestSuite   → Suite level (collection of test cases)
+      TestCase  → Class level (single test class)
+        TestPipeline  → Pipeline level (run interceptors)
+          TestBatch   → Batch level (DataProvider/Retry)
+            Test      → Individual test execution
 ```
 
 ### Complete Event Hierarchy Example
 
 ```php
-TestPipelineStarting   // Before run interceptors start
-  TestBatchStarting    // Before batch of test runs (DataProvider/Retry)
-    TestStarting       // Before individual test execution
-    TestFinished       // After individual test execution
-    TestRetrying       // Before retry attempt (if applicable)
-    TestStarting       // Next attempt
-    TestFinished
-  TestBatchFinished    // After all test runs in batch
-TestPipelineFinished   // After run interceptors finish
+SessionStarting        // Before any tests are discovered or executed
+  WorkerStarting       // Before a subprocess starts (parallel/isolated mode)
+    TestSuiteStarting  // Before a test suite (collection of cases) starts
+      TestCaseStarting // Before a test class starts
+        TestPipelineStarting   // Before run interceptors start
+          TestBatchStarting    // Before batch of test runs (DataProvider/Retry)
+            TestStarting       // Before individual test execution
+            TestFinished       // After individual test execution
+            TestRetrying       // Before retry attempt (if applicable)
+            TestStarting       // Next attempt
+            TestFinished
+          TestBatchFinished    // After all test runs in batch
+        TestPipelineFinished   // After run interceptors finish
+      TestCaseFinished // After a test class finishes
+    TestSuiteFinished  // After a test suite finishes
+  WorkerFinished       // After a subprocess finishes
+SessionFinished        // After all tests complete, carries RunResult
 ```
 
 ## Event Class Structure
@@ -159,8 +171,42 @@ Each event class must have a PHPDoc comment that includes:
 4. **Hierarchy clarity**: Entity names reflect nesting levels
 5. **Ecosystem alignment**: Consistent with Laravel, Symfony event naming patterns
 
+## Namespace Organization
+
+Events are grouped into namespaces by entity layer. The namespace name matches the entity
+prefix for test-domain events. Framework-level events are the exception — `Session` and
+`Worker` share a single `Framework` namespace since they belong to the same infrastructure
+layer and are not test-domain entities.
+
+```
+Event\Framework\     → Session*, Worker*  (infrastructure lifecycle)
+Event\TestSuite\     → TestSuite*
+Event\TestCase\      → TestCase*
+Event\Test\          → TestPipeline*, TestBatch*, TestDataSet*, Test*
+```
+
 ## Examples from Testo
 
+### Framework Events (`Event\Framework`)
+
+Top-level lifecycle events not tied to any specific test entity. Grouped in their own
+namespace since `Session` and `Worker` belong to the same infrastructure layer.
+
+```php
+SessionStarting        // Before the entire test run begins (fired once)
+SessionFinished        // After all tests complete, carries RunResult with duration
+WorkerStarting         // Before a subprocess starts (parallel/isolated mode)
+WorkerFinished         // After a subprocess finishes
+```
+
+### Suite and Case Events
+```php
+TestSuiteStarting      // Before a suite (collection of test cases) starts
+TestSuiteFinished      // After a suite finishes
+TestCaseStarting       // Before a test class starts
+TestCaseFinished       // After a test class finishes
+```
+
 ### Pipeline Events
 ```php
 TestPipelineStarting   // Before run interceptors

src/Application/Application.php

@@ -5,6 +5,7 @@
 namespace Testo\Application;
 
 use Internal\Path;
+use Psr\EventDispatcher\EventDispatcherInterface;
 use Testo\Application\Config\ApplicationConfig;
 use Testo\Application\Config\Internal\ConfigInflector;
 use Testo\Application\Config\PluginConfigurator;
@@ -15,6 +16,11 @@
 use Testo\Application\Value\RunResult;
 use Testo\Common\Container;
 use Testo\Core\Value\Status;
+use Testo\Event\Framework\FrameworkStarting;
+use Testo\Event\Framework\SessionFinished;
+use Testo\Event\Framework\SessionStarting;
+use Testo\Event\Framework\WorkerFinished;
+use Testo\Event\Framework\WorkerStarting;
 
 final class Application
 {
@@ -85,19 +91,29 @@ public function run(?Filter $filter = null): RunResult
         $filter === null or $this->container->set($filter);
         $filter ??= $this->container->get(Filter::class);
 
+        $dispatcher = $this->container->get(EventDispatcherInterface::class);
+        $dispatcher->dispatch(new SessionStarting());
+        $dispatcher->dispatch(new WorkerStarting());
+
+
         $suiteProvider = $this->container->get(SuiteProvider::class);
         $suiteRunner = $this->container->get(SuiteRunner::class);
         $status = Status::Passed;
+        $duration = microtime(true);
 
-        # Iterate Test Suites
+        # Iterate and run Test Suites
         $suiteResults = [];
         foreach ($suiteProvider->withFilter($filter)->getSuites() as $suite) {
             $suiteResults[] = $suiteResult = $suiteRunner->runSuite($suite, $filter);
             $suiteResult->status->isFailure() and $status = Status::Failed;
         }
 
-        # Run suites
-        return new RunResult($suiteResults, status: $status);
+        $duration = microtime(true) - $duration;
+        $result = new RunResult($suiteResults, status: $status, duration: $duration);
+
+        $dispatcher->dispatch(new WorkerFinished());
+        $dispatcher->dispatch(new SessionFinished($result));
+        return $result;
     }
 
     public function getContainer(): Container

src/Application/Value/RunResult.php

@@ -22,6 +22,8 @@ public function __construct(
          */
         public readonly iterable $results,
         public readonly Status $status,
+        /** Duration of the session in seconds. */
+        public readonly float $duration,
     ) {}
 
     /**

src/Bridge/Symfony/Command/Base.php

@@ -110,4 +110,5 @@ protected function getConfigFile(InputInterface $input): ?Path
 
         return null;
     }
+
 }

src/Bridge/Symfony/Renderer/Formatter.php

@@ -57,7 +57,7 @@ public static function runHeader(): string
     {
         $name = Info::NAME;
         $version = Info::version();
-        return Style::bold('# Running Tests') . Style::dim(" ({$name} v{$version})") . "\n\n";
+        return Style::bold("{$name}") . Style::dim(" v{$version}") . "\n\n";
     }
 
     /**

src/Bridge/Symfony/Renderer/TerminalLogger.php

@@ -5,6 +5,7 @@
 namespace Testo\Bridge\Symfony\Renderer;
 
 use Testo\Assert\TestState;
+use Testo\Common\Environment;
 use Testo\Core\Context\CaseInfo;
 use Testo\Core\Context\CaseResult;
 use Testo\Core\Context\SuiteInfo;
@@ -39,9 +40,6 @@ final class TerminalLogger
     /** @var list<array{result: TestResult, duration: int<0, max>|null}> */
     private array $failures = [];
 
-    private float $startTime;
-    private bool $headerPrinted = false;
-
     /**
      * Current indentation level for nested tests (e.g., DataProvider datasets).
      *
@@ -56,16 +54,13 @@ final class TerminalLogger
 
     public function __construct(
         private readonly OutputFormat $format = OutputFormat::Compact,
-    ) {
-        $this->startTime = \microtime(true);
-    }
+    ) {}
 
     /**
      * Publishes test suite started message.
      */
     public function suiteStartedFromInfo(SuiteInfo $info): void
     {
-        $this->ensureHeader();
         echo Formatter::suiteHeader($info->name, $this->format);
     }
 
@@ -82,7 +77,6 @@ public function handleSuiteResult(SuiteInfo $info, SuiteResult $result): void
      */
     public function caseStartedFromInfo(CaseInfo $info): void
     {
-        $this->ensureHeader();
         echo Formatter::caseHeader($info->name, $this->format);
     }
 
@@ -100,7 +94,6 @@ public function handleCaseResult(CaseInfo $info, CaseResult $result): void
      */
     public function batchStartedFromInfo(TestInfo $info): void
     {
-        $this->ensureHeader();
         $this->currentIndentLevel = 1;
 
         if ($this->format === OutputFormat::Dots) {
@@ -129,7 +122,6 @@ public function batchFinishedFromInfo(TestInfo $info): void
      */
     public function testStartedFromInfo(TestInfo $info, ?string $overrideName = null): void
     {
-        $this->ensureHeader();
         $this->currentTestName = $overrideName;
         // No output on test start for compact/dots mode
     }
@@ -154,23 +146,39 @@ public function handleTestResult(TestResult $result, ?int $duration): void
     /**
      * Prints final summary with all failures and statistics.
      */
-    public function printSummary(): void
+    public function printSummary(float $duration): void
     {
         $this->printFailures();
-        $this->printStatistics();
+        $this->printStatistics($duration);
     }
 
     /**
      * Ensures run header is printed once.
      */
-    private function ensureHeader(): void
+    public function ensureHeader(): void
     {
-        if ($this->headerPrinted) {
-            return;
-        }
-
         echo Formatter::runHeader();
-        $this->headerPrinted = true;
+    }
+
+    public function printEnvironment(): void
+    {
+        echo \sprintf(' %s %s (%s)', Style::info('OS:'), Environment::getOs(), Environment::getCpu()) . "\n";
+        echo \sprintf(' %s %s (%s, memory: %s)', Style::info('PHP:'), Environment::getPhpVersion(), \PHP_SAPI, \ini_get('memory_limit') ?: 'unlimited') . "\n";
+
+        $modes = Environment::getXDebugMode();
+        $xdebug = match (true) {
+            !Environment::hasXDebug() => 'off',
+            $modes !== [] => Environment::getXDebugVersion() . Style::dim(' (' . \implode(', ', $modes) . ')'),
+            default => Environment::getXDebugVersion() . Style::dim(' (off)'),
+        };
+        echo \sprintf('   %s %s', Style::info('XDebug:'), $xdebug) . "\n";
+
+        $opcache = match (true) {
+            !Environment::isOpCacheEnabled() => 'off',
+            Environment::isJitEnabled() => 'enabled with JIT',
+            default => 'enabled',
+        };
+        echo \sprintf('   %s %s', Style::info('OPcache:'), $opcache) . "\n\n";
     }
 
     /**
@@ -348,9 +356,8 @@ function: $result->info->testDefinition->reflection,
     /**
      * Prints final statistics.
      */
-    private function printStatistics(): void
+    private function printStatistics(float $duration): void
     {
-        $duration = \microtime(true) - $this->startTime;
         $success = $this->failedTests === 0;
 
         echo Formatter::summary(

src/Bridge/Symfony/TerminalRenderer.php

@@ -11,6 +11,8 @@
 use Testo\Bridge\Symfony\Renderer\TerminalLogger;
 use Testo\Common\Container;
 use Testo\Core\Context\TestInfo;
+use Testo\Event\Framework\SessionFinished;
+use Testo\Event\Framework\SessionStarting;
 use Testo\Event\Test\TestBatchFinished;
 use Testo\Event\Test\TestBatchStarting;
 use Testo\Event\Test\TestDataSetFinished;
@@ -48,6 +50,10 @@ public function configure(Container $container): void
     {
         $listeners = $container->get(EventListenerCollector::class);
 
+        // Framework events
+        $listeners->addListener(SessionStarting::class, $this->onSessionStarting(...));
+        $listeners->addListener(SessionFinished::class, $this->onSessionFinished(...));
+
         // Test Pipeline events (lifecycle of entire test through all interceptors)
         $listeners->addListener(TestPipelineFinished::class, $this->onTestPipelineFinished(...));
 
@@ -68,6 +74,17 @@ public function configure(Container $container): void
         $listeners->addListener(TestSuiteFinished::class, $this->onTestSuiteFinished(...));
     }
 
+    private function onSessionStarting(SessionStarting $event): void
+    {
+        $this->logger->ensureHeader();
+        $this->logger->printEnvironment();
+    }
+
+    private function onSessionFinished(SessionFinished $event): void
+    {
+        $this->logger->printSummary($event->result->duration);
+    }
+
     private static function getId(TestInfo $testInfo): string
     {
         return \spl_object_hash($testInfo->testDefinition);
@@ -138,8 +155,5 @@ private function onTestSuiteStarting(TestSuiteStarting $event): void
     private function onTestSuiteFinished(TestSuiteFinished $event): void
     {
         $this->logger->handleSuiteResult($event->suiteInfo, $event->suiteResult);
-
-        // Print final summary after all tests in suite complete
-        $this->logger->printSummary();
     }
 }