feat: Add Context7 docs source integration

- Add DocsSource class for retrieving content from Context7
- Implement DocsSourceFetcher for API communication
- Update JSON schema for validation

Author: butschster

json-schema.json

@@ -685,7 +685,8 @@
             "git_diff",
             "tree",
             "mcp",
-            "composer"
+            "composer",
+            "docs"
           ],
           "description": "Type of content source"
         },
@@ -812,6 +813,18 @@
           "then": {
             "$ref": "#/definitions/treeSource"
           }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "docs"
+              }
+            }
+          },
+          "then": {
+            "$ref": "#/definitions/docsSource"
+          }
         }
       ]
     },
@@ -1345,6 +1358,49 @@
       ],
       "description": "Configuration for rendering diffs"
     },
+    "docsSource": {
+      "type": "object",
+      "description": "Source for documentation content",
+      "required": [
+        "type",
+        "library",
+        "topic"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "docs"
+          ],
+          "description": "Source type - docs"
+        },
+        "library": {
+          "type": "string",
+          "description": "Library identifier (e.g., \"laravel/docs\")"
+        },
+        "topic": {
+          "type": "string",
+          "description": "Topic to search for within the library"
+        },
+        "tokens": {
+          "type": "integer",
+          "default": 500,
+          "description": "Maximum token count to retrieve"
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable description of the source"
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of tags for this source"
+        }
+      },
+      "additionalProperties": false
+    },
     "treeSource": {
       "description": "Generates a hierarchical visualization of directory structures",
       "properties": {

src/Application/Kernel.php

@@ -23,6 +23,7 @@
 use Butschster\ContextGenerator\Modifier\PhpSignature\PhpSignatureModifierBootloader;
 use Butschster\ContextGenerator\Modifier\Sanitizer\SanitizerModifierBootloader;
 use Butschster\ContextGenerator\Source\Composer\ComposerSourceBootloader;
+use Butschster\ContextGenerator\Source\Docs\DocsSourceBootloader;
 use Butschster\ContextGenerator\Source\File\FileSourceBootloader;
 use Butschster\ContextGenerator\Source\GitDiff\GitDiffSourceBootloader;
 use Butschster\ContextGenerator\Source\Github\GithubSourceBootloader;
@@ -73,6 +74,7 @@ protected function defineBootloaders(): array
             GitDiffSourceBootloader::class,
             TreeSourceBootloader::class,
             McpSourceBootloader::class,
+            DocsSourceBootloader::class,
 
             // Modifiers
             PhpContentFilterBootloader::class,

src/Source/Docs/DocsSource.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Butschster\ContextGenerator\Source\Docs;
+
+use Butschster\ContextGenerator\Source\BaseSource;
+
+/**
+ * Source for retrieving documentation from Context7 service
+ */
+final class DocsSource extends BaseSource
+{
+    /**
+     * @param string $library Library identifier (e.g., "laravel/docs")
+     * @param string $topic Topic to search for within the library
+     * @param string $description Human-readable description
+     * @param int $tokens Maximum token count to retrieve
+     * @param array<non-empty-string> $tags
+     */
+    public function __construct(
+        public readonly string $library,
+        public readonly string $topic,
+        string $description = '',
+        public readonly int $tokens = 2000,
+        array $tags = [],
+    ) {
+        parent::__construct(description: $description, tags: $tags);
+    }
+
+    #[\Override]
+    public function jsonSerialize(): array
+    {
+        return \array_filter([
+            'type' => 'docs',
+            ...parent::jsonSerialize(),
+            'library' => $this->library,
+            'topic' => $this->topic,
+            'tokens' => $this->tokens,
+        ], static fn($value) => $value !== null && $value !== '' && $value !== []);
+    }
+}

src/Source/Docs/DocsSourceBootloader.php

@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Butschster\ContextGenerator\Source\Docs;
+
+use Butschster\ContextGenerator\Application\Bootloader\HttpClientBootloader;
+use Butschster\ContextGenerator\Application\Bootloader\SourceFetcherBootloader;
+use Butschster\ContextGenerator\Application\Logger\HasPrefixLoggerInterface;
+use Butschster\ContextGenerator\Lib\Content\ContentBuilderFactory;
+use Butschster\ContextGenerator\Lib\HttpClient\HttpClientInterface;
+use Butschster\ContextGenerator\Lib\Variable\VariableResolver;
+use Butschster\ContextGenerator\Source\Registry\SourceRegistryInterface;
+use Spiral\Boot\Bootloader\Bootloader;
+use Spiral\Core\FactoryInterface;
+
+final class DocsSourceBootloader extends Bootloader
+{
+    #[\Override]
+    public function defineDependencies(): array
+    {
+        return [HttpClientBootloader::class];
+    }
+
+    #[\Override]
+    public function defineSingletons(): array
+    {
+        return [
+            DocsSourceFetcher::class => static fn(
+                FactoryInterface $factory,
+                ContentBuilderFactory $builderFactory,
+                HttpClientInterface $httpClient,
+                VariableResolver $variables,
+                HasPrefixLoggerInterface $logger,
+            ): DocsSourceFetcher => $factory->make(DocsSourceFetcher::class, [
+                'defaultHeaders' => [
+                    'User-Agent' => 'CTX Bot',
+                    'Accept' => 'text/plain',
+                    'Accept-Language' => 'en-US,en;q=0.9',
+                ],
+            ]),
+        ];
+    }
+
+    public function init(
+        SourceFetcherBootloader $registry,
+        SourceRegistryInterface $sourceRegistry,
+        DocsSourceFactory $factory,
+    ): void {
+        $registry->register(DocsSourceFetcher::class);
+        $sourceRegistry->register($factory);
+    }
+}

src/Source/Docs/DocsSourceFactory.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Butschster\ContextGenerator\Source\Docs;
+
+use Butschster\ContextGenerator\Source\Registry\AbstractSourceFactory;
+
+/**
+ * Factory for creating DocsSource instances
+ */
+final readonly class DocsSourceFactory extends AbstractSourceFactory
+{
+    #[\Override]
+    public function getType(): string
+    {
+        return 'docs';
+    }
+
+    #[\Override]
+    public function create(array $config): DocsSource
+    {
+        $this->logger?->debug('Creating Docs source', [
+            'path' => $this->dirs->getRootPath(),
+            'config' => $config,
+        ]);
+
+        if (!isset($config['library']) || !\is_string($config['library'])) {
+            throw new \RuntimeException('Docs source must have a "library" string property');
+        }
+
+        if (!isset($config['topic']) || !\is_string($config['topic'])) {
+            throw new \RuntimeException('Docs source must have a "topic" string property');
+        }
+
+        $tokens = 2000;
+        if (isset($config['tokens']) && (\is_int($config['tokens']) || \is_string($config['tokens']))) {
+            $tokens = (int) $config['tokens'];
+        }
+
+        return new DocsSource(
+            library: $config['library'],
+            topic: $config['topic'],
+            description: $config['description'] ?? '',
+            tokens: $tokens,
+            tags: $config['tags'] ?? [],
+        );
+    }
+}