test(config): add KcodeComposerGeneratorTest + lean build-phar.php

KcodeComposerGeneratorTest (5 cases): toolName, outputPath, default versions,
user version overrides, config section, output newline.

bin/build-phar.php: restored to lean build strategy — bundles only src/
and an inline PSR-4 autoloader. Tools install dynamically via kcode init,
avoiding prohibitively slow Phar::compressFiles(GZ) on large vendor trees
(documented pitfall #12 in devkit KI).

Author: walmir-silva

bin/build-phar.php

@@ -1,12 +1,18 @@
 <?php
+
 declare(strict_types=1);
 
 /**
- * Manual PHAR builder for kcode — bypasses Box chdir() bug on PHP 8.4
+ * Manual PHAR builder for kcode — bypasses Box chdir() bug on PHP 8.4.
+ *
+ * The PHAR is intentionally lean: it bundles only the KaririCode\Devkit
+ * source classes and a minimal PSR-4 autoloader. Dev tools (phpunit,
+ * phpstan, etc.) are NOT bundled — `kcode init` installs them dynamically
+ * into .kcode/vendor/ of the target project via composer.
  */
 
-$root    = dirname(__DIR__);
-$output  = $root . '/build/kcode.phar';
+$root   = dirname(__DIR__);
+$output = $root . '/build/kcode.phar';
 
 if (file_exists($output)) {
     unlink($output);

tests/Unit/Configuration/KcodeComposerGeneratorTest.php

@@ -0,0 +1,130 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Devkit\Tests\Unit\Configuration;
+
+use KaririCode\Devkit\Configuration\KcodeComposerGenerator;
+use KaririCode\Devkit\Core\ProjectContext;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\Attributes\UsesClass;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(KcodeComposerGenerator::class)]
+#[UsesClass(ProjectContext::class)]
+final class KcodeComposerGeneratorTest extends TestCase
+{
+    private ProjectContext $context;
+
+    protected function setUp(): void
+    {
+        $this->context = new ProjectContext(
+            projectRoot: '/tmp/test-project',
+            projectName: 'test/project',
+            namespace: 'Test\\Project',
+            phpVersion: '8.4',
+            phpstanLevel: 9,
+            psalmLevel: 3,
+            sourceDirs: ['/tmp/test-project/src'],
+            testDirs: ['/tmp/test-project/tests'],
+            excludeDirs: ['src/Contract'],
+            testSuites: ['Unit' => 'tests/Unit'],
+            coverageExclude: ['src/Exception'],
+            csFixerRules: [],
+            rectorSets: [],
+            toolVersions: [],
+        );
+    }
+
+    #[Test]
+    public function toolNameIsKcodeComposer(): void
+    {
+        $generator = new KcodeComposerGenerator();
+        $this->assertSame('kcode-composer', $generator->toolName());
+    }
+
+    #[Test]
+    public function outputPathIsComposerJson(): void
+    {
+        $generator = new KcodeComposerGenerator();
+        $this->assertSame('composer.json', $generator->outputPath());
+    }
+
+    #[Test]
+    public function generateProducesValidJsonWithDefaultVersions(): void
+    {
+        $generator = new KcodeComposerGenerator();
+        $output    = $generator->generate($this->context);
+
+        /** @var array<string, mixed> $manifest */
+        $manifest = json_decode($output, true, 512, \JSON_THROW_ON_ERROR);
+
+        $this->assertSame('kariricode/devkit-tools', $manifest['name']);
+        $this->assertIsArray($manifest['require']);
+
+        // All 5 default tools must be present
+        $require = $manifest['require'];
+        $this->assertArrayHasKey('phpunit/phpunit', $require);
+        $this->assertArrayHasKey('phpstan/phpstan', $require);
+        $this->assertArrayHasKey('friendsofphp/php-cs-fixer', $require);
+        $this->assertArrayHasKey('rector/rector', $require);
+        $this->assertArrayHasKey('vimeo/psalm', $require);
+    }
+
+    #[Test]
+    public function generateRespectsUserToolVersionOverrides(): void
+    {
+        $contextWithVersions = new ProjectContext(
+            projectRoot: '/tmp/test-project',
+            projectName: 'test/project',
+            namespace: 'Test\\Project',
+            phpVersion: '8.4',
+            phpstanLevel: 9,
+            psalmLevel: 3,
+            sourceDirs: ['/tmp/test-project/src'],
+            testDirs: ['/tmp/test-project/tests'],
+            excludeDirs: [],
+            testSuites: [],
+            coverageExclude: [],
+            csFixerRules: [],
+            rectorSets: [],
+            toolVersions: ['phpunit' => '^11.0', 'phpstan' => '^1.12'],
+        );
+
+        $generator = new KcodeComposerGenerator();
+        $output    = $generator->generate($contextWithVersions);
+
+        /** @var array<string, mixed> $manifest */
+        $manifest = json_decode($output, true, 512, \JSON_THROW_ON_ERROR);
+
+        $require = $manifest['require'];
+        $this->assertSame('^11.0', $require['phpunit/phpunit']);
+        $this->assertSame('^1.12', $require['phpstan/phpstan']);
+        // Unoverridden tool still uses default
+        $this->assertStringStartsWith('^', $require['rector/rector']);
+    }
+
+    #[Test]
+    public function generateIncludesComposerConfigSection(): void
+    {
+        $generator = new KcodeComposerGenerator();
+        $output    = $generator->generate($this->context);
+
+        /** @var array<string, mixed> $manifest */
+        $manifest = json_decode($output, true, 512, \JSON_THROW_ON_ERROR);
+
+        $this->assertIsArray($manifest['config']);
+        $this->assertSame('full', $manifest['config']['bin-compat']);
+        $this->assertTrue($manifest['config']['optimize-autoloader']);
+    }
+
+    #[Test]
+    public function generateOutputEndsWithNewline(): void
+    {
+        $generator = new KcodeComposerGenerator();
+        $output    = $generator->generate($this->context);
+
+        $this->assertStringEndsWith(\PHP_EOL, $output);
+    }
+}