xtrm-tools 2.3.0 → 2.4.0

package/project-skills/tdd-guard/reporters/phpunit/src/TddGuardListener.php

@@ -1,158 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit;
-
-use PHPUnit\Framework\AssertionFailedError;
-use PHPUnit\Framework\Test;
-use PHPUnit\Framework\TestCase;
-use PHPUnit\Framework\TestListener;
-use PHPUnit\Framework\TestListenerDefaultImplementation;
-use PHPUnit\Framework\TestSuite;
-use PHPUnit\Framework\Warning;
-use Throwable;
-
-/**
- * @psalm-api
- */
-final class TddGuardListener implements TestListener
-{
-    use TestListenerDefaultImplementation;
-
-    private array $testResults = [];
-    private string $projectRoot;
-
-    public function __construct(string $projectRoot = '')
-    {
-        $this->projectRoot = PathValidator::resolveProjectRoot($projectRoot);
-    }
-
-    public function startTest(Test $test): void
-    {
-    }
-
-    public function endTest(Test $test, float $time): void
-    {
-        if (!$test instanceof TestCase) {
-            return;
-        }
-
-        $fullName = $test->toString();
-
-        foreach ($this->testResults as $result) {
-            if ($result['test']['fullName'] === $fullName) {
-                return;
-            }
-        }
-
-        $this->addTestResult($test, 'passed');
-    }
-
-    public function addError(Test $test, Throwable $t, float $time): void
-    {
-        $this->addTestResult($test, 'failed', $t->getMessage());
-    }
-
-    public function addFailure(Test $test, AssertionFailedError $e, float $time): void
-    {
-        $this->addTestResult($test, 'failed', $e->getMessage());
-    }
-
-    public function addWarning(Test $test, Warning $e, float $time): void
-    {
-        $this->addTestResult($test, 'failed', 'Warning: ' . $e->getMessage());
-    }
-
-    public function addIncompleteTest(Test $test, Throwable $t, float $time): void
-    {
-        $this->addTestResult($test, 'skipped', 'Incomplete: ' . $t->getMessage());
-    }
-
-    public function addRiskyTest(Test $test, Throwable $t, float $time): void
-    {
-        $this->addTestResult($test, 'failed', 'Risky: ' . $t->getMessage());
-    }
-
-    public function addSkippedTest(Test $test, Throwable $t, float $time): void
-    {
-        $this->addTestResult($test, 'skipped', $t->getMessage());
-    }
-
-    private function addTestResult(Test $test, string $state, ?string $message = null): void
-    {
-        if (!$test instanceof TestCase) {
-            return;
-        }
-
-        $testName = $test->getName();
-        $className = get_class($test);
-        $fullName = $test->toString();
-
-        $result = [
-            'name' => $testName,
-            'fullName' => $fullName,
-            'state' => $state,
-        ];
-
-        if ($message !== null && $state === 'failed') {
-            $result['errors'] = [
-                ['message' => $message],
-            ];
-        }
-
-        try {
-            $reflection = new \ReflectionClass($className);
-            $moduleId = $this->getRelativePath($reflection->getFileName());
-        } catch (\ReflectionException $e) {
-            $moduleId = str_replace('\\', '/', $className) . '.php';
-        }
-
-        $this->testResults[] = [
-            'test' => $result,
-            'module' => $moduleId,
-        ];
-    }
-
-    private function getRelativePath(string $absolutePath): string
-    {
-        if (str_starts_with($absolutePath, $this->projectRoot)) {
-            $relativePath = substr($absolutePath, strlen($this->projectRoot) + 1);
-
-            return str_replace(DIRECTORY_SEPARATOR, '/', $relativePath);
-        }
-
-        return basename($absolutePath);
-    }
-
-    public function endTestSuite(TestSuite $suite): void
-    {
-        if (empty($this->testResults)) {
-            return;
-        }
-
-        $this->saveResults();
-    }
-
-    private function saveResults(): void
-    {
-        $modules = [];
-        foreach ($this->testResults as $item) {
-            $moduleId = $item['module'];
-            if (!isset($modules[$moduleId])) {
-                $modules[$moduleId] = [
-                    'moduleId' => $moduleId,
-                    'tests' => [],
-                ];
-            }
-            $modules[$moduleId]['tests'][] = $item['test'];
-        }
-
-        $output = [
-            'testModules' => array_values($modules),
-        ];
-
-        $reporter = new Storage($this->projectRoot);
-        $reporter->saveTest(json_encode($output, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
-    }
-}

package/project-skills/tdd-guard/reporters/phpunit/src/TddGuardSubscriber.php

@@ -1,35 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit;
-
-use TddGuard\PHPUnit\Event\ErroredTestSubscriber;
-use TddGuard\PHPUnit\Event\FailedTestSubscriber;
-use TddGuard\PHPUnit\Event\IncompleteTestSubscriber;
-use TddGuard\PHPUnit\Event\PassedTestSubscriber;
-use TddGuard\PHPUnit\Event\SkippedTestSubscriber;
-use TddGuard\PHPUnit\Event\TestRunnerFinishedSubscriber;
-
-final class TddGuardSubscriber
-{
-    private TestResultCollector $collector;
-
-    public function __construct(string $projectRoot)
-    {
-        $storage = new Storage($projectRoot);
-        $this->collector = new TestResultCollector($storage, $projectRoot);
-    }
-
-    public function getSubscribers(): array
-    {
-        return [
-            new PassedTestSubscriber($this->collector),
-            new FailedTestSubscriber($this->collector),
-            new ErroredTestSubscriber($this->collector),
-            new SkippedTestSubscriber($this->collector),
-            new IncompleteTestSubscriber($this->collector),
-            new TestRunnerFinishedSubscriber($this->collector),
-        ];
-    }
-}

package/project-skills/tdd-guard/reporters/phpunit/src/TestResultCollector.php

@@ -1,105 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit;
-
-final class TestResultCollector
-{
-    private array $testResults = [];
-    private Storage $storage;
-    private string $projectRoot;
-
-    public function __construct(Storage $storage, string $projectRoot)
-    {
-        $this->storage = $storage;
-        $this->projectRoot = rtrim($projectRoot, DIRECTORY_SEPARATOR);
-    }
-
-    public function addTestResult($test, string $state, ?string $message = null): void
-    {
-        $testName = $test->name();
-        $className = $test->className();
-        $fullName = $className . '::' . $testName;
-
-        $result = [
-            'name' => $testName,
-            'fullName' => $fullName,
-            'state' => $state,
-        ];
-
-        if ($message !== null && ($state === 'failed' || $state === 'errored')) {
-            $result['errors'] = [
-                ['message' => $message],
-            ];
-        }
-
-        try {
-            $reflection = new \ReflectionClass($className);
-            $moduleId = $this->getRelativePath($reflection->getFileName());
-        } catch (\ReflectionException $e) {
-            $moduleId = str_replace('\\', '/', (string) $className) . '.php';
-        }
-
-        $this->testResults[] = [
-            'test' => $result,
-            'module' => $moduleId,
-        ];
-    }
-
-    private function getRelativePath(string $absolutePath): string
-    {
-        if (str_starts_with($absolutePath, $this->projectRoot)) {
-            $relativePath = substr($absolutePath, strlen($this->projectRoot) + 1);
-
-            return str_replace(DIRECTORY_SEPARATOR, '/', $relativePath);
-        }
-
-        $cwd = getcwd();
-        if (str_starts_with($absolutePath, $cwd)) {
-            $relativePath = substr($absolutePath, strlen($cwd) + 1);
-
-            return str_replace(DIRECTORY_SEPARATOR, '/', $relativePath);
-        }
-
-        return basename($absolutePath);
-    }
-
-    public function saveResults(): void
-    {
-        if (empty($this->testResults)) {
-            return;
-        }
-
-        $modules = [];
-        $hasFailures = false;
-
-        foreach ($this->testResults as $item) {
-            $moduleId = $item['module'];
-            if (!isset($modules[$moduleId])) {
-                $modules[$moduleId] = [
-                    'moduleId' => $moduleId,
-                    'tests' => [],
-                ];
-            }
-
-            // Normalize 'errored' to 'failed'
-            $test = $item['test'];
-            if ($test['state'] === 'errored') {
-                $test['state'] = 'failed';
-            }
-            $modules[$moduleId]['tests'][] = $test;
-
-            if ($test['state'] === 'failed') {
-                $hasFailures = true;
-            }
-        }
-
-        $output = [
-            'testModules' => array_values($modules),
-            'reason' => $hasFailures ? 'failed' : 'passed',
-        ];
-
-        $this->storage->saveTest(json_encode($output, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
-    }
-}

package/project-skills/tdd-guard/reporters/phpunit/tests/PathValidatorTest.php

@@ -1,74 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit\Tests;
-
-use PHPUnit\Framework\TestCase;
-use Symfony\Component\Filesystem\Filesystem;
-use TddGuard\PHPUnit\PathValidator;
-
-final class PathValidatorTest extends TestCase
-{
-    private string $tempDir;
-    private Filesystem $filesystem;
-    private string $originalCwd;
-
-    protected function setUp(): void
-    {
-        $this->filesystem = new Filesystem();
-        $this->tempDir = sys_get_temp_dir() . '/tdd-guard-path-test-' . uniqid();
-        $this->filesystem->mkdir($this->tempDir);
-        $this->originalCwd = getcwd();
-    }
-
-    protected function tearDown(): void
-    {
-        chdir($this->originalCwd);
-        $this->filesystem->remove($this->tempDir);
-    }
-
-    public function testRejectsPathTraversal(): void
-    {
-        // Given: A path with directory traversal
-        $pathWithTraversal = $this->tempDir . '/../dangerous';
-
-        // Then: Should throw exception
-        $this->expectException(\InvalidArgumentException::class);
-        $this->expectExceptionMessage('Configured project root is invalid');
-
-        // When: Validating the path
-        PathValidator::resolveProjectRoot($pathWithTraversal);
-    }
-
-    public function testAllowsAncestorOfCurrentDirectory(): void
-    {
-        // Given: Working in a subdirectory
-        $subDir = $this->tempDir . '/subdir';
-        $this->filesystem->mkdir($subDir);
-        chdir($subDir);
-
-        // When: Validating the parent directory
-        $result = PathValidator::resolveProjectRoot($this->tempDir);
-
-        // Then: Should return the validated path
-        $this->assertEquals(realpath($this->tempDir), $result);
-    }
-
-    public function testRejectsNonAncestorDirectory(): void
-    {
-        // Given: Two sibling directories
-        $dir1 = $this->tempDir . '/dir1';
-        $dir2 = $this->tempDir . '/dir2';
-        $this->filesystem->mkdir($dir1);
-        $this->filesystem->mkdir($dir2);
-        chdir($dir1);
-
-        // Then: Should throw exception
-        $this->expectException(\InvalidArgumentException::class);
-        $this->expectExceptionMessage('Configured project root is invalid');
-
-        // When: Trying to use sibling directory as project root
-        PathValidator::resolveProjectRoot($dir2);
-    }
-}

package/project-skills/tdd-guard/reporters/phpunit/tests/TddGuardExtensionFailedTest.php

@@ -1,241 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit\Tests;
-
-use PHPUnit\Framework\TestCase;
-use Symfony\Component\Filesystem\Filesystem;
-
-final class TddGuardExtensionFailedTest extends TestCase
-{
-    private string $tempDir;
-    private Filesystem $filesystem;
-
-    protected function setUp(): void
-    {
-        $this->filesystem = new Filesystem();
-        $this->tempDir = sys_get_temp_dir() . '/tdd-guard-test-' . uniqid();
-        $this->filesystem->mkdir($this->tempDir);
-    }
-
-    protected function tearDown(): void
-    {
-        $this->filesystem->remove($this->tempDir);
-    }
-
-    public function testExtensionCapturesFailedTest(): void
-    {
-        // Given: A test file with a failing test
-        $testFile = $this->tempDir . '/FailingTest.php';
-        file_put_contents($testFile, '<?php
-use PHPUnit\Framework\TestCase;
-class FailingTest extends TestCase {
-    public function testFailing(): void {
-        $this->assertEquals(5, 2 + 2, "Math is broken!");
-    }
-}');
-
-        $phpunitXml = $this->tempDir . '/phpunit.xml';
-        file_put_contents($phpunitXml, '<?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
-         bootstrap="' . dirname(__DIR__) . '/vendor/autoload.php">
-    <testsuites>
-        <testsuite name="Example">
-            <file>' . $testFile . '</file>
-        </testsuite>
-    </testsuites>
-    <extensions>
-        <bootstrap class="TddGuard\PHPUnit\TddGuardExtension">
-            <parameter name="projectRoot" value="' . $this->tempDir . '"/>
-        </bootstrap>
-    </extensions>
-</phpunit>');
-
-        // When: We run PHPUnit with our extension
-        $command = sprintf(
-            'cd %s && php %s/vendor/bin/phpunit -c %s 2>&1',
-            escapeshellarg($this->tempDir),
-            escapeshellarg(dirname(__DIR__)),
-            escapeshellarg($phpunitXml)
-        );
-        exec($command, $output, $returnCode);
-
-        // Then: The test should fail and contain error details
-        $this->assertNotEquals(0, $returnCode, 'PHPUnit should exit with non-zero');
-        $jsonPath = $this->tempDir . '/.claude/tdd-guard/data/test.json';
-        $this->assertFileExists($jsonPath);
-        $data = json_decode(file_get_contents($jsonPath), true);
-        $this->assertArrayHasKey('testModules', $data);
-        $this->assertArrayHasKey('reason', $data);
-        $this->assertEquals('failed', $data['reason']);
-
-        $module = $data['testModules'][0];
-        $test = $module['tests'][0];
-        $this->assertEquals('testFailing', $test['name']);
-        $this->assertEquals('FailingTest::testFailing', $test['fullName']);
-        $this->assertEquals('failed', $test['state']);
-        $this->assertArrayHasKey('errors', $test);
-        $this->assertStringContainsString('Math is broken!', $test['errors'][0]['message']);
-    }
-
-    public function testExtensionCapturesErroredTest(): void
-    {
-        // Given: A test file with a test that errors
-        $testFile = $this->tempDir . '/ErroredTest.php';
-        file_put_contents($testFile, '<?php
-use PHPUnit\Framework\TestCase;
-class ErroredTest extends TestCase {
-    public function testWithError(): void {
-        throw new \RuntimeException("Something went terribly wrong!");
-    }
-}');
-
-        $phpunitXml = $this->tempDir . '/phpunit.xml';
-        file_put_contents($phpunitXml, '<?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
-         bootstrap="' . dirname(__DIR__) . '/vendor/autoload.php">
-    <testsuites>
-        <testsuite name="Example">
-            <file>' . $testFile . '</file>
-        </testsuite>
-    </testsuites>
-    <extensions>
-        <bootstrap class="TddGuard\PHPUnit\TddGuardExtension">
-            <parameter name="projectRoot" value="' . $this->tempDir . '"/>
-        </bootstrap>
-    </extensions>
-</phpunit>');
-
-        // When: We run PHPUnit with our extension
-        $command = sprintf(
-            'cd %s && php %s/vendor/bin/phpunit -c %s 2>&1',
-            escapeshellarg($this->tempDir),
-            escapeshellarg(dirname(__DIR__)),
-            escapeshellarg($phpunitXml)
-        );
-        exec($command, $output, $returnCode);
-
-        // Then: The test should error and reason should be failed
-        $this->assertNotEquals(0, $returnCode, 'PHPUnit should exit with non-zero');
-        $jsonPath = $this->tempDir . '/.claude/tdd-guard/data/test.json';
-        $this->assertFileExists($jsonPath);
-        $data = json_decode(file_get_contents($jsonPath), true);
-        $this->assertArrayHasKey('reason', $data);
-        $this->assertEquals('failed', $data['reason']);
-
-        $module = $data['testModules'][0];
-        $test = $module['tests'][0];
-        $this->assertEquals('testWithError', $test['name']);
-        $this->assertEquals('failed', $test['state']);
-        $this->assertArrayHasKey('errors', $test);
-        $this->assertStringContainsString('Something went terribly wrong!', $test['errors'][0]['message']);
-    }
-
-    public function testErroredStateIsNormalizedToFailed(): void
-    {
-        // This test ensures 'errored' states are normalized to 'failed' for TDD Guard compatibility
-        // Prevents regression where errored states break schema validation
-
-        // Given: A test file that will cause a PHP error
-        $testFile = $this->tempDir . '/ErrorTest.php';
-        file_put_contents($testFile, '<?php
-use PHPUnit\Framework\TestCase;
-
-class ErrorTest extends TestCase
-{
-    public function testUndefinedMethod(): void
-    {
-        $this->nonExistentMethod(); // This will cause a PHP error
-    }
-}
-');
-
-        // When: PHPUnit runs with TDD Guard extension
-        $phpunitXml = $this->tempDir . '/phpunit.xml';
-        file_put_contents($phpunitXml, '<?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.0/phpunit.xsd"
-         bootstrap="' . dirname(__DIR__) . '/vendor/autoload.php"
-         colors="true">
-  <extensions>
-    <bootstrap class="TddGuard\\PHPUnit\\TddGuardExtension"/>
-  </extensions>
-  <testsuites>
-    <testsuite name="test">
-      <file>' . $testFile . '</file>
-    </testsuite>
-  </testsuites>
-</phpunit>');
-
-        $command = sprintf(
-            'cd %s && php %s/vendor/bin/phpunit -c %s 2>&1',
-            escapeshellarg($this->tempDir),
-            escapeshellarg(dirname(__DIR__)),
-            escapeshellarg($phpunitXml)
-        );
-        exec($command, $output, $returnCode);
-
-        // Then: The errored test should be normalized to 'failed' state
-        $this->assertNotEquals(0, $returnCode, 'PHPUnit should exit with non-zero');
-        $jsonPath = $this->tempDir . '/.claude/tdd-guard/data/test.json';
-        $this->assertFileExists($jsonPath);
-        $data = json_decode(file_get_contents($jsonPath), true);
-
-        $test = $data['testModules'][0]['tests'][0];
-        $this->assertEquals('failed', $test['state'], 'Errored test should be normalized to failed state');
-        $this->assertArrayHasKey('errors', $test, 'Failed test should have error details');
-    }
-
-    public function testExtensionCapturesSkippedTest(): void
-    {
-        // Given: A test file with a skipped test
-        $testFile = $this->tempDir . '/SkippedTest.php';
-        file_put_contents($testFile, '<?php
-use PHPUnit\Framework\TestCase;
-class SkippedTest extends TestCase {
-    public function testSkipped(): void {
-        $this->markTestSkipped("Not implemented yet");
-    }
-}');
-
-        $phpunitXml = $this->tempDir . '/phpunit.xml';
-        file_put_contents($phpunitXml, '<?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
-         bootstrap="' . dirname(__DIR__) . '/vendor/autoload.php">
-    <testsuites>
-        <testsuite name="Example">
-            <file>' . $testFile . '</file>
-        </testsuite>
-    </testsuites>
-    <extensions>
-        <bootstrap class="TddGuard\PHPUnit\TddGuardExtension">
-            <parameter name="projectRoot" value="' . $this->tempDir . '"/>
-        </bootstrap>
-    </extensions>
-</phpunit>');
-
-        // When: We run PHPUnit with our extension
-        $command = sprintf(
-            'cd %s && php %s/vendor/bin/phpunit -c %s 2>&1',
-            escapeshellarg($this->tempDir),
-            escapeshellarg(dirname(__DIR__)),
-            escapeshellarg($phpunitXml)
-        );
-        exec($command, $output, $returnCode);
-
-        // Then: The skipped test should be recorded
-        $jsonPath = $this->tempDir . '/.claude/tdd-guard/data/test.json';
-        $this->assertFileExists($jsonPath);
-        $data = json_decode(file_get_contents($jsonPath), true);
-        $this->assertArrayHasKey('reason', $data);
-        $this->assertEquals('passed', $data['reason']);
-        $module = $data['testModules'][0];
-        $test = $module['tests'][0];
-        $this->assertEquals('testSkipped', $test['name']);
-        $this->assertEquals('skipped', $test['state']);
-    }
-}