xtrm-tools 2.2.0 → 2.4.0

package/project-skills/tdd-guard/reporters/jest/src/types.ts

@@ -1,42 +0,0 @@
-import type { Storage } from 'tdd-guard'
-
-export interface TDDGuardReporterOptions {
-  storage?: Storage
-  projectRoot?: string
-}
-
-export interface CapturedError {
-  message: string
-  actual?: string
-  expected?: string
-  showDiff?: boolean
-  operator?: string
-  diff?: string
-  name?: string
-  ok?: boolean
-  stack?: string
-}
-
-export interface CapturedTest {
-  name: string
-  fullName: string
-  state: string
-  errors?: CapturedError[]
-}
-
-export interface CapturedModule {
-  moduleId: string
-  tests: CapturedTest[]
-}
-
-export interface CapturedUnhandledError {
-  message: string
-  name: string
-  stack?: string
-}
-
-export interface CapturedTestRun {
-  testModules: CapturedModule[]
-  unhandledErrors?: CapturedUnhandledError[]
-  reason?: 'passed' | 'failed' | 'interrupted'
-}

package/project-skills/tdd-guard/reporters/jest/tsconfig.json

@@ -1,11 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "composite": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "tsBuildInfoFile": "./dist/tsconfig.tsbuildinfo"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["**/*.test.ts", "**/*.spec.ts"]
-}

package/project-skills/tdd-guard/reporters/phpunit/.php-cs-fixer.php

@@ -1,28 +0,0 @@
-<?php
-
-$finder = PhpCsFixer\Finder::create()
-    ->in(__DIR__ . '/src')
-    ->in(__DIR__ . '/tests')
-    ->exclude('vendor');
-
-$config = new PhpCsFixer\Config();
-return $config->setRules([
-        '@PSR12' => true,
-        'array_syntax' => ['syntax' => 'short'],
-        'ordered_imports' => ['sort_algorithm' => 'alpha'],
-        'no_unused_imports' => true,
-        'single_quote' => true,
-        'trailing_comma_in_multiline' => true,
-        'phpdoc_scalar' => true,
-        'unary_operator_spaces' => true,
-        'binary_operator_spaces' => true,
-        'blank_line_before_statement' => [
-            'statements' => ['break', 'continue', 'declare', 'return', 'throw', 'try'],
-        ],
-        'phpdoc_single_line_var_spacing' => true,
-        'phpdoc_var_without_name' => true,
-        'method_argument_space' => [
-            'on_multiline' => 'ensure_fully_multiline',
-        ],
-    ])
-    ->setFinder($finder);

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

@@ -1,97 +0,0 @@
-# TDD Guard PHPUnit Reporter
-
-PHPUnit reporter that captures test results for TDD Guard validation.
-
-## Requirements
-
-- PHP 8.1+
-- PHPUnit 9.0+ or 10.0+ or 11.0+ or 12.0+
-- [TDD Guard](https://github.com/nizos/tdd-guard) installed globally
-
-## Installation
-
-```bash
-composer require --dev tdd-guard/phpunit
-```
-
-## Configuration
-
-### PHPUnit 10+ Configuration
-
-Add the extension to your `phpunit.xml`:
-
-```xml
-<?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="vendor/autoload.php">
-    <testsuites>
-        <testsuite name="Application Test Suite">
-            <directory>tests</directory>
-        </testsuite>
-    </testsuites>
-    
-    <extensions>
-        <bootstrap class="TddGuard\PHPUnit\TddGuardExtension">
-            <parameter name="projectRoot" value="/absolute/path/to/project/root"/>
-        </bootstrap>
-    </extensions>
-</phpunit>
-```
-
-### PHPUnit 9.x Configuration
-
-Add the listener to your `phpunit.xml`:
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<phpunit bootstrap="vendor/autoload.php">
-    <testsuites>
-        <testsuite name="Application Test Suite">
-            <directory>tests</directory>
-        </testsuite>
-    </testsuites>
-    
-    <listeners>
-        <listener class="TddGuard\PHPUnit\TddGuardListener">
-            <arguments>
-                <string>/absolute/path/to/project/root</string>
-            </arguments>
-        </listener>
-    </listeners>
-</phpunit>
-```
-
-### Project Root Configuration
-
-Set the project root using any ONE of these methods:
-
-**Option 1: PHPUnit Configuration (Recommended)**
-
-Use the `projectRoot` parameter in your `phpunit.xml` (see examples above).
-
-**Option 2: Environment Variable**
-
-```bash
-export TDD_GUARD_PROJECT_ROOT=/absolute/path/to/project/root
-```
-
-**Option 3: Automatic Detection**
-
-If not configured, the reporter will:
-- Use the directory containing `phpunit.xml`
-- Fall back to current working directory
-
-### Configuration Rules
-
-- Path must be absolute
-- Falls back to current directory if configuration is invalid
-
-## 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

package/project-skills/tdd-guard/reporters/phpunit/SYNC_README.md

@@ -1,29 +0,0 @@
-# TDD Guard PHPUnit Reporter
-
-This repository is automatically synchronized from the main [TDD Guard monorepo](https://github.com/nizos/tdd-guard).
-
-## Important Notice
-
-**This is a read-only mirror.** Please do not submit pull requests here.
-
-- **Source code**: https://github.com/nizos/tdd-guard/tree/main/reporters/phpunit
-- **Issues**: https://github.com/nizos/tdd-guard/issues
-- **Pull requests**: https://github.com/nizos/tdd-guard/pulls
-
-## Installation
-
-```bash
-composer require --dev tdd-guard/phpunit
-```
-
-## Why a Separate Repository?
-
-Packagist requires composer.json to be at the root of the repository. Since TDD Guard is a monorepo containing multiple packages (npm, Python, PHP), we maintain this synchronized copy specifically for Packagist distribution.
-
-## Synchronization
-
-This repository is automatically updated whenever changes are pushed to the `reporters/phpunit` directory in the main repository.
-
-## License
-
-MIT - See the main repository for details.

package/project-skills/tdd-guard/reporters/phpunit/composer.json

@@ -1,55 +0,0 @@
-{
-    "name": "tdd-guard/phpunit",
-    "description": "PHPUnit reporter for TDD Guard",
-    "version": "0.1.3",
-    "type": "library",
-    "license": "MIT",
-    "authors": [
-        {
-            "name": "Wolfgang Klinger",
-            "email": "hello@wolfgang-klinger.dev"
-        }
-    ],
-    "keywords": [
-        "tdd",
-        "test-driven-development",
-        "testing",
-        "phpunit",
-        "claude"
-    ],
-    "homepage": "https://github.com/nizos/tdd-guard",
-    "support": {
-        "issues": "https://github.com/nizos/tdd-guard/issues",
-        "source": "https://github.com/nizos/tdd-guard/tree/main/reporters/phpunit"
-    },
-    "require": {
-        "php": ">=8.1",
-        "phpunit/phpunit": "^9.0 || ^10.0 || ^11.0 || ^12.0"
-    },
-    "require-dev": {
-        "symfony/filesystem": "^5.4 || ^6.0 || ^7.0",
-        "friendsofphp/php-cs-fixer": "^3.40",
-        "vimeo/psalm": "^5.0"
-    },
-    "autoload": {
-        "psr-4": {
-            "TddGuard\\PHPUnit\\": "src/"
-        }
-    },
-    "autoload-dev": {
-        "psr-4": {
-            "TddGuard\\PHPUnit\\Tests\\": "tests/"
-        }
-    },
-    "scripts": {
-        "test": "vendor/bin/phpunit",
-        "test:coverage": "vendor/bin/phpunit --coverage-text",
-        "format": "vendor/bin/php-cs-fixer fix",
-        "format:check": "vendor/bin/php-cs-fixer fix --dry-run --diff",
-        "lint": "vendor/bin/psalm",
-        "lint:check": "vendor/bin/psalm --no-progress"
-    },
-    "config": {
-        "sort-packages": true
-    }
-}

package/project-skills/tdd-guard/reporters/phpunit/phpunit.xml.dist

@@ -1,19 +0,0 @@
-<?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="vendor/autoload.php"
-         colors="true"
-         failOnRisky="true"
-         failOnWarning="true">
-    <testsuites>
-        <testsuite name="TDD Guard PHPUnit Reporter">
-            <directory>tests</directory>
-        </testsuite>
-    </testsuites>
-    
-    <source>
-        <include>
-            <directory>src</directory>
-        </include>
-    </source>
-</phpunit>

package/project-skills/tdd-guard/reporters/phpunit/psalm.xml

@@ -1,44 +0,0 @@
-<?xml version="1.0"?>
-<psalm
-    errorLevel="3"
-    resolveFromConfigFile="true"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns="https://getpsalm.org/schema/config"
-    xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
-    findUnusedBaselineEntry="true"
-    findUnusedCode="false"
->
-    <projectFiles>
-        <directory name="src" />
-        <directory name="tests" />
-        <ignoreFiles>
-            <directory name="vendor" />
-        </ignoreFiles>
-    </projectFiles>
-
-    <issueHandlers>
-        <!-- Suppress for test files only -->
-        <PropertyNotSetInConstructor>
-            <errorLevel type="suppress">
-                <directory name="tests" />
-            </errorLevel>
-        </PropertyNotSetInConstructor>
-        <MissingConstructor>
-            <errorLevel type="suppress">
-                <directory name="tests" />
-            </errorLevel>
-        </MissingConstructor>
-        <UnusedClass>
-            <errorLevel type="suppress">
-                <directory name="tests" />
-            </errorLevel>
-        </UnusedClass>
-        
-        <!-- PHPUnit 9.x compatibility - TestListener interface was removed in PHPUnit 10 -->
-        <UndefinedClass>
-            <errorLevel type="suppress">
-                <referencedClass name="PHPUnit\Framework\TestListener" />
-            </errorLevel>
-        </UndefinedClass>
-    </issueHandlers>
-</psalm>

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

@@ -1,28 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit\Event;
-
-use PHPUnit\Event\Test\Errored;
-use PHPUnit\Event\Test\ErroredSubscriber;
-use TddGuard\PHPUnit\TestResultCollector;
-
-final class ErroredTestSubscriber implements ErroredSubscriber
-{
-    private TestResultCollector $collector;
-
-    public function __construct(TestResultCollector $collector)
-    {
-        $this->collector = $collector;
-    }
-
-    public function notify(Errored $event): void
-    {
-        $this->collector->addTestResult(
-            $event->test(),
-            'errored',
-            $event->throwable()->message()
-        );
-    }
-}

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

@@ -1,28 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit\Event;
-
-use PHPUnit\Event\Test\Failed;
-use PHPUnit\Event\Test\FailedSubscriber;
-use TddGuard\PHPUnit\TestResultCollector;
-
-final class FailedTestSubscriber implements FailedSubscriber
-{
-    private TestResultCollector $collector;
-
-    public function __construct(TestResultCollector $collector)
-    {
-        $this->collector = $collector;
-    }
-
-    public function notify(Failed $event): void
-    {
-        $this->collector->addTestResult(
-            $event->test(),
-            'failed',
-            $event->throwable()->message()
-        );
-    }
-}

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

@@ -1,28 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit\Event;
-
-use PHPUnit\Event\Test\MarkedIncomplete;
-use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
-use TddGuard\PHPUnit\TestResultCollector;
-
-final class IncompleteTestSubscriber implements MarkedIncompleteSubscriber
-{
-    private TestResultCollector $collector;
-
-    public function __construct(TestResultCollector $collector)
-    {
-        $this->collector = $collector;
-    }
-
-    public function notify(MarkedIncomplete $event): void
-    {
-        $this->collector->addTestResult(
-            $event->test(),
-            'skipped',
-            'Incomplete: ' . $event->throwable()->message()
-        );
-    }
-}

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

@@ -1,27 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit\Event;
-
-use PHPUnit\Event\Test\Passed;
-use PHPUnit\Event\Test\PassedSubscriber;
-use TddGuard\PHPUnit\TestResultCollector;
-
-final class PassedTestSubscriber implements PassedSubscriber
-{
-    private TestResultCollector $collector;
-
-    public function __construct(TestResultCollector $collector)
-    {
-        $this->collector = $collector;
-    }
-
-    public function notify(Passed $event): void
-    {
-        $this->collector->addTestResult(
-            $event->test(),
-            'passed'
-        );
-    }
-}

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

@@ -1,28 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit\Event;
-
-use PHPUnit\Event\Test\Skipped;
-use PHPUnit\Event\Test\SkippedSubscriber;
-use TddGuard\PHPUnit\TestResultCollector;
-
-final class SkippedTestSubscriber implements SkippedSubscriber
-{
-    private TestResultCollector $collector;
-
-    public function __construct(TestResultCollector $collector)
-    {
-        $this->collector = $collector;
-    }
-
-    public function notify(Skipped $event): void
-    {
-        $this->collector->addTestResult(
-            $event->test(),
-            'skipped',
-            $event->message()
-        );
-    }
-}

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

@@ -1,24 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit\Event;
-
-use PHPUnit\Event\TestRunner\Finished;
-use PHPUnit\Event\TestRunner\FinishedSubscriber;
-use TddGuard\PHPUnit\TestResultCollector;
-
-final class TestRunnerFinishedSubscriber implements FinishedSubscriber
-{
-    private TestResultCollector $collector;
-
-    public function __construct(TestResultCollector $collector)
-    {
-        $this->collector = $collector;
-    }
-
-    public function notify(Finished $event): void
-    {
-        $this->collector->saveResults();
-    }
-}

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

@@ -1,88 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit;
-
-final class PathValidator
-{
-    public static function resolveProjectRoot(string $configuredRoot): string
-    {
-        if ($configuredRoot !== '') {
-            $validated = self::validateProjectRoot($configuredRoot);
-            if ($validated === null) {
-                throw new \InvalidArgumentException('Configured project root is invalid');
-            }
-
-            return $validated;
-        }
-
-        $envRoot = getenv('TDD_GUARD_PROJECT_ROOT');
-        if ($envRoot !== false && $envRoot !== '') {
-            $validated = self::validateProjectRoot($envRoot);
-            if ($validated === null) {
-                throw new \InvalidArgumentException('TDD_GUARD_PROJECT_ROOT is invalid');
-            }
-
-            return $validated;
-        }
-
-        return getcwd();
-    }
-
-    private static function validateProjectRoot(string $path): ?string
-    {
-        if ($path === '') {
-            return null;
-        }
-
-        if (!self::isAbsolutePath($path)) {
-            return null;
-        }
-
-        if (strpos($path, '..') !== false) {
-            return null;
-        }
-
-        if (!is_dir($path)) {
-            return null;
-        }
-
-        $normalizedPath = realpath($path);
-        if ($normalizedPath === false) {
-            return null;
-        }
-
-        $cwd = realpath(getcwd());
-        if ($cwd === false) {
-            return null;
-        }
-
-        if (!self::isAncestorOrSame($normalizedPath, $cwd)) {
-            return null;
-        }
-
-        return $normalizedPath;
-    }
-
-    private static function isAncestorOrSame(string $potentialAncestor, string $path): bool
-    {
-        $potentialAncestor = rtrim($potentialAncestor, DIRECTORY_SEPARATOR);
-        $path = rtrim($path, DIRECTORY_SEPARATOR);
-
-        if ($potentialAncestor === $path) {
-            return true;
-        }
-
-        return strpos($path, $potentialAncestor . DIRECTORY_SEPARATOR) === 0;
-    }
-
-    private static function isAbsolutePath(string $path): bool
-    {
-        if (PHP_OS_FAMILY === 'Windows') {
-            return preg_match('/^[a-zA-Z]:[\\\\\\/]/', $path) === 1;
-        }
-
-        return strpos($path, '/') === 0;
-    }
-}

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

@@ -1,26 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit;
-
-final class Storage
-{
-    private string $projectRoot;
-
-    public function __construct(string $projectRoot = '')
-    {
-        $this->projectRoot = PathValidator::resolveProjectRoot($projectRoot);
-    }
-
-    public function saveTest(string $content): void
-    {
-        $dataDir = $this->projectRoot . '/.claude/tdd-guard/data';
-
-        if (!is_dir($dataDir)) {
-            mkdir($dataDir, 0755, true);
-        }
-
-        file_put_contents($dataDir . '/test.json', $content);
-    }
-}

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

@@ -1,33 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace TddGuard\PHPUnit;
-
-use PHPUnit\Runner\Extension\Extension;
-use PHPUnit\Runner\Extension\Facade;
-use PHPUnit\Runner\Extension\ParameterCollection;
-use PHPUnit\TextUI\Configuration\Configuration;
-
-/**
- * @psalm-api
- */
-final class TddGuardExtension implements Extension
-{
-    public function bootstrap(Configuration $configuration, Facade $facade, ParameterCollection $parameters): void
-    {
-        $projectRoot = $this->getProjectRoot($parameters);
-
-        $subscriber = new TddGuardSubscriber($projectRoot);
-        foreach ($subscriber->getSubscribers() as $eventSubscriber) {
-            $facade->registerSubscriber($eventSubscriber);
-        }
-    }
-
-    private function getProjectRoot(ParameterCollection $parameters): string
-    {
-        $configuredRoot = $parameters->has('projectRoot') ? $parameters->get('projectRoot') : '';
-
-        return PathValidator::resolveProjectRoot($configuredRoot);
-    }
-}