updated llms.txt

Signed-off-by: bidi47 <bidi@apidemia.com>

Author: bidi47

src/App/src/Factory/LlmsGeneratorFactory.php

@@ -25,6 +25,7 @@ public function __invoke(ContainerInterface $container): LlmsGenerator
             $config['llms']['indexFile'],
             $config['application']['url'] ?? '',
             $config['llms']['pagesDir'] ?? null,
+            $config['application']['meta']['title'] ?? 'Dotkernel',
         );
     }
 }

src/App/src/Service/LlmsGenerator.php

@@ -69,6 +69,7 @@ public function __construct(
         private readonly string $outputFile,
         private readonly string $baseUrl,
         private readonly ?string $pagesDir = null,
+        private readonly string $title = 'Dotkernel',
     ) {
     }
 
@@ -138,7 +139,7 @@ private function buildCategorySection(string $slug, array $entries): string
     {
         $category = $entries[0]['post']->getCategory();
         $heading  = sprintf(
-            '## %s (%d post%s)',
+            '### %s (%d post%s)',
             $category->getName(),
             count($entries),
             count($entries) === 1 ? '' : 's',
@@ -153,7 +154,7 @@ private function buildCategorySection(string $slug, array $entries): string
 
         foreach ($entries as $entry) {
             $lines[] = sprintf(
-                '- [%s](%s/%s/%s/): %s',
+                '- [%s](%s/%s/%s.md): %s',
                 $entry['title'],
                 $this->baseUrl,
                 $slug,
@@ -218,7 +219,7 @@ private function buildPagesSection(): string
         $lines = ['## Pages', ''];
         foreach ($pages as $page) {
             $lines[] = sprintf(
-                '- [%s](%s/%s/): %s',
+                '- [%s](%s/md-pages/%s.md): %s',
                 $page['title'],
                 $this->baseUrl,
                 $page['slug'],
@@ -240,7 +241,7 @@ private function extractFrontMatterField(string $contents, string $field): ?stri
 
     private function buildHeader(): string
     {
-        $intro = '> Dotkernel Light is the technical blog for the Dotkernel headless PHP platform - a PSR-15 '
+        $intro = '> Dotkernel is the technical blog for the Dotkernel headless PHP platform - a PSR-15 '
             . 'compliant application built on Mezzio and Laminas components. It publishes architecture '
             . 'write-ups, how-tos, and release notes for the platform applications - Dotkernel API, Admin '
             . 'and Queue - and for the standalone Dotkernel Light skeleton.';
@@ -253,7 +254,7 @@ private function buildHeader(): string
         $about = 'the team behind Dotkernel - how the team works, its commitment to open source and the PHP '
             . 'community, and how it uses AI under guardrails';
 
-        return "# Dotkernel Light\n\n"
+        return "# {$this->title}\n\n"
             . $intro . "\n\n"
             . $body . "\n\n"
             . "## Docs\n\n"

test/Unit/App/Factory/LlmsGeneratorFactoryTest.php

@@ -26,13 +26,36 @@ public function testInvokeAppliesTheConfiguredValues(): void
                 'indexFile' => '/tmp/llms.txt',
                 'pagesDir'  => '/tmp/md-pages',
             ],
-            'application' => ['url' => 'https://example.test'],
+            'application' => [
+                'url'  => 'https://example.test',
+                'meta' => ['title' => 'Custom Title'],
+            ],
         ]));
 
         $this->assertSame('/tmp/llms.txt', $generator->getOutputFile());
         $this->assertSame('/tmp/md-articles', $this->readProperty($generator, 'sourceDir'));
         $this->assertSame('/tmp/md-pages', $this->readProperty($generator, 'pagesDir'));
         $this->assertSame('https://example.test', $this->readProperty($generator, 'baseUrl'));
+        $this->assertSame('Custom Title', $this->readProperty($generator, 'title'));
+    }
+
+    /**
+     * A config without a meta title (e.g. the `application.meta` section is absent) simply
+     * keeps the historical default.
+     *
+     * @throws Exception
+     */
+    public function testInvokeFallsBackToTheDefaultTitleWhenItIsNotConfigured(): void
+    {
+        $generator = (new LlmsGeneratorFactory())($this->createContainer([
+            'llms'        => [
+                'sourceDir' => '/tmp/md-articles',
+                'indexFile' => '/tmp/llms.txt',
+            ],
+            'application' => ['url' => 'https://example.test'],
+        ]));
+
+        $this->assertSame('Dotkernel', $this->readProperty($generator, 'title'));
     }
 
     /**

test/Unit/App/Service/LlmsGeneratorTest.php

@@ -87,11 +87,21 @@ public function testWriteReturnsZeroAndWritesOnlyTheHeaderWhenThereAreNoPublishe
         $this->assertSame(0, $this->createGenerator()->write());
 
         $output = $this->writtenOutput();
-        $this->assertStringStartsWith('# Dotkernel Light', $output);
+        $this->assertStringStartsWith('# Dotkernel', $output);
         $this->assertStringContainsString('## Categories', $output);
         $this->assertStringNotContainsString('##  (', $output);
     }
 
+    /**
+     * @throws Exception
+     */
+    public function testWriteUsesTheConfiguredTitleAsTheHeading(): void
+    {
+        $this->createGenerator(title: 'Custom Blog Title')->write();
+
+        $this->assertStringStartsWith('# Custom Blog Title', $this->writtenOutput());
+    }
+
     /**
      * @throws Exception
      */
@@ -211,14 +221,14 @@ public function testWriteUsesSingularPostWordingForACategoryWithExactlyOnePost()
     /**
      * @throws Exception
      */
-    public function testWriteBuildsEachPostLinkFromTheBaseUrlCategorySlugAndPostSlug(): void
+    public function testWriteBuildsEachPostLinkFromTheBaseUrlCategorySlugAndPostSlugAsMarkdown(): void
     {
         $posts = [$this->createPost('A post', 'a-post', 'dotkernel', 'Dotkernel')];
 
         $this->createGenerator($posts, baseUrl: 'https://example.test')->write();
 
         $this->assertStringContainsString(
-            '[A post](https://example.test/dotkernel/a-post/):',
+            '[A post](https://example.test/dotkernel/a-post.md):',
             $this->writtenOutput()
         );
     }
@@ -397,6 +407,7 @@ private function createGenerator(
         ?string $outputFile = null,
         string $baseUrl = 'https://example.test',
         ?string $pagesDir = '',
+        string $title = 'Dotkernel',
     ): LlmsGenerator {
         $postRepository = $this->createStub(PostRepository::class);
         $postRepository->method('getPublishedPosts')->willReturn($posts);
@@ -407,6 +418,7 @@ private function createGenerator(
             $outputFile ?? $this->outputFile,
             $baseUrl,
             $pagesDir === '' ? $this->pagesDir : $pagesDir,
+            $title,
         );
     }