[license] Preserve literal author emails (#179)

Author: coisa

CHANGELOG.md

@@ -17,6 +17,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+- Preserve literal angle brackets around maintainer emails when generating LICENSE files from composer metadata (#179)
 - Keep packaged `.agents` payloads exportable and synchronize packaged skills and agents with repository-relative symlink targets so consumer repositories no longer receive broken absolute machine paths (#188)
 - Rewrite drifted Git hooks by removing the previous target first, restore the intended `0o755` executable mode, and report unwritable hook replacements cleanly when `.git/hooks` stays locked (#190)
 - Keep Composer plugin command discovery compatible with consumer environments by moving unsupported Symfony Console named parameters out of command metadata/configuration and by decoupling the custom filesystem wrapper from Composer's bundled Symfony Filesystem signatures (#185)

src/License/Generator.php

@@ -24,6 +24,7 @@
 use FastForward\DevTools\Filesystem\FilesystemInterface;
 use Psr\Clock\ClockInterface;
 use Twig\Environment;
+use Twig\Markup;
 
 /**
  * Generates LICENSE files from composer.json metadata.
@@ -91,7 +92,7 @@ public function generateContent(): ?string
 
         try {
             $content = $this->renderer->render('licenses/' . $templateFilename, [
-                'copyright_holder' => (string) $this->composer->getAuthors(true),
+                'copyright_holder' => new Markup((string) $this->composer->getAuthors(true), 'UTF-8'),
                 'year' => $this->clock->now()
                     ->format('Y'),
             ]);

tests/License/GeneratorTest.php

@@ -22,20 +22,24 @@
 use Exception;
 use DateTimeImmutable;
 use FastForward\DevTools\Composer\Json\ComposerJsonInterface;
+use FastForward\DevTools\Composer\Json\Schema\Author;
 use FastForward\DevTools\Composer\Json\Schema\AuthorInterface;
 use FastForward\DevTools\Filesystem\FilesystemInterface;
 use FastForward\DevTools\License\Generator;
 use FastForward\DevTools\License\ResolverInterface;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\Attributes\UsesClass;
 use PHPUnit\Framework\TestCase;
 use Prophecy\Argument;
 use Prophecy\Prophecy\ObjectProphecy;
 use Prophecy\PhpUnit\ProphecyTrait;
 use Psr\Clock\ClockInterface;
 use Twig\Environment;
+use Twig\Loader\ArrayLoader;
 
 #[CoversClass(Generator::class)]
+#[UsesClass(Author::class)]
 final class GeneratorTest extends TestCase
 {
     use ProphecyTrait;
@@ -144,6 +148,43 @@ public function generateWithValidLicenseWillCreateFile(): void
         self::assertSame($renderedContent, $result);
     }
 
+    /**
+     * @return void
+     */
+    #[Test]
+    public function generateContentWillPreserveLiteralAuthorEmailAngleBrackets(): void
+    {
+        $generator = new Generator(
+            $this->resolver->reveal(),
+            $this->composer->reveal(),
+            $this->clock->reveal(),
+            new Environment(new ArrayLoader([
+                'licenses/mit.txt' => 'Copyright (c) {{ year }} {{ copyright_holder }}',
+            ]), [
+                'autoescape' => 'html',
+            ]),
+            $this->filesystem->reveal(),
+        );
+
+        $this->composer->getLicense()
+            ->willReturn('MIT');
+        $this->resolver->resolve('MIT')
+            ->willReturn('mit.txt');
+        $this->composer->getAuthors(true)
+            ->willReturn(new Author('Felipe Sayão Lobato Abreu', 'github@mentordosnerds.com'));
+        $this->clock->now()
+            ->willReturn(new DateTimeImmutable('2026-04-23'));
+
+        $content = $generator->generateContent();
+
+        self::assertSame(
+            'Copyright (c) 2026 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>',
+            $content,
+        );
+        self::assertStringNotContainsString('&lt;', (string) $content);
+        self::assertStringNotContainsString('&gt;', (string) $content);
+    }
+
     /**
      * @return void
      */