xtrm-tools 2.0.0

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

@@ -0,0 +1,105 @@
+<?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

@@ -0,0 +1,74 @@
+<?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

@@ -0,0 +1,241 @@
+<?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']);
+    }
+}

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

@@ -0,0 +1,84 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TddGuard\PHPUnit\Tests;
+
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\Filesystem\Filesystem;
+
+final class TddGuardExtensionTest 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 testExtensionCapturesPassingTest(): void
+    {
+        // Given: A test file that will pass
+        $testFile = $this->tempDir . '/ExampleTest.php';
+        file_put_contents($testFile, '<?php
+use PHPUnit\Framework\TestCase;
+class ExampleTest extends TestCase {
+    public function testPassing(): void {
+        $this->assertTrue(true);
+    }
+}');
+
+        $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 pass and results should be saved
+        $this->assertEquals(0, $returnCode, 'PHPUnit should exit with 0. Output: ' . implode("\n", $output));
+        $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->assertCount(1, $data['testModules']);
+        $this->assertArrayHasKey('reason', $data);
+        $this->assertEquals('passed', $data['reason']);
+
+        $module = $data['testModules'][0];
+        $this->assertStringContainsString('ExampleTest.php', $module['moduleId']);
+        $this->assertCount(1, $module['tests']);
+
+        $test = $module['tests'][0];
+        $this->assertEquals('testPassing', $test['name']);
+        $this->assertEquals('ExampleTest::testPassing', $test['fullName']);
+        $this->assertEquals('passed', $test['state']);
+    }
+}

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

@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TddGuard\PHPUnit\Tests;
+
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\Filesystem\Filesystem;
+use TddGuard\PHPUnit\Storage;
+
+final class TddGuardStorageLocationTest 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-test-' . uniqid();
+        $this->filesystem->mkdir($this->tempDir);
+        $this->originalCwd = getcwd();
+        chdir($this->tempDir);
+    }
+
+    protected function tearDown(): void
+    {
+        chdir($this->originalCwd);
+        $this->filesystem->remove($this->tempDir);
+    }
+
+    public function testStorageSavesToCorrectLocation(): void
+    {
+        // Given: A storage configured with a specific project root
+        $storage = new Storage($this->tempDir);
+
+        // When: We save test results
+        $testData = '{"testModules": []}';
+        $storage->saveTest($testData);
+
+        // Then: The file should be saved in the correct TDD Guard location
+        $expectedPath = $this->tempDir . '/.claude/tdd-guard/data/test.json';
+        $this->assertFileExists($expectedPath);
+        $this->assertEquals($testData, file_get_contents($expectedPath));
+    }
+
+    public function testStorageRespectsEnvironmentVariable(): void
+    {
+        // Given: Environment variable is set
+        $originalEnv = getenv('TDD_GUARD_PROJECT_ROOT');
+        putenv('TDD_GUARD_PROJECT_ROOT=' . $this->tempDir);
+
+        try {
+            // When: Storage is created without explicit project root
+            $storage = new Storage('');
+            $testData = '{"testModules": []}';
+            $storage->saveTest($testData);
+
+            // Then: It should use the environment variable location
+            $expectedPath = $this->tempDir . '/.claude/tdd-guard/data/test.json';
+            $this->assertFileExists($expectedPath);
+
+        } finally {
+            if ($originalEnv !== false) {
+                putenv('TDD_GUARD_PROJECT_ROOT=' . $originalEnv);
+            } else {
+                putenv('TDD_GUARD_PROJECT_ROOT');
+            }
+        }
+    }
+}

package/project-skills/tdd-guard/reporters/pytest/README.md

@@ -0,0 +1,77 @@
+# TDD Guard Pytest Reporter
+
+Pytest plugin that captures test results for TDD Guard validation.
+
+## Requirements
+
+- Python 3.8+
+- pytest 6.0+
+- [TDD Guard](https://github.com/nizos/tdd-guard) installed globally
+
+## Installation
+
+```bash
+pip install tdd-guard-pytest
+```
+
+The plugin activates automatically when installed.
+
+## Configuration
+
+### Project Root Configuration
+
+Set `tdd_guard_project_root` to your project root using any ONE of these methods:
+
+**Option 1: pyproject.toml**
+
+```toml
+[tool.pytest.ini_options]
+tdd_guard_project_root = "/absolute/path/to/project/root"
+```
+
+**Option 2: pytest.ini**
+
+```ini
+[pytest]
+tdd_guard_project_root = /absolute/path/to/project/root
+```
+
+**Option 3: setup.cfg**
+
+```ini
+[tool:pytest]
+tdd_guard_project_root = /absolute/path/to/project/root
+```
+
+### Configuration Rules
+
+- Path must be absolute
+- Current directory must be within the configured project root
+- Falls back to current directory if configuration is invalid
+
+## Development
+
+When developing the pytest reporter, you need to configure the project root to ensure test results are saved to the correct location:
+
+1. Copy the example configuration:
+
+   ```bash
+   cp pytest.ini.example pytest.ini
+   ```
+
+2. Edit `pytest.ini` and set the absolute path to your TDD Guard project root:
+   ```ini
+   [pytest]
+   tdd_guard_project_root = /absolute/path/to/tdd-guard
+   ```
+
+**Note:** `pytest.ini` is gitignored to avoid committing machine-specific paths.
+
+## More Information
+
+- Test results are saved to `.claude/tdd-guard/data/test.json`
+- See [TDD Guard documentation](https://github.com/nizos/tdd-guard) for complete setup
+
+## License
+
+MIT