Summary

Introduces a new Mate bridge — symfony/ai-knowledge-mate-extension — that exposes pluggable documentation providers as MCP tools so agents can crawl official docs structurally instead of guessing from training data.

The Symfony bridge ships a built-in SymfonyDocsProvider for symfony/symfony-docs that registers itself when the Knowledge bridge is also installed (interface_exists() guard).

Tools

Behavior

• The first call for a provider clones the source repo (git clone --depth 1) into the local cache.
• Subsequent calls hit the cache.
• The cache auto-refreshes once it's older than ai_mate_knowledge.cache_ttl_seconds (default 24h).
• Section-based chunking reuses Symfony\AI\Store\Document\Loader\RstLoader so chunking semantics stay aligned with the Store component.

Adding a custom provider

use Symfony\AI\Mate\Bridge\Knowledge\Provider\DocsProviderInterface;
use Symfony\AI\Mate\Bridge\Knowledge\Service\GitFetcher;

final class MyDocsProvider implements DocsProviderInterface
{
    public function __construct(private GitFetcher $fetcher) {}

    public function getName(): string { return 'my-docs'; }
    public function getTitle(): string { return 'My Docs'; }
    public function getDescription(): string { return 'My project documentation'; }
    public function getFormat(): string { return 'rst'; }

    public function sync(string \$cacheDir): string
    {
        \$repo = \$cacheDir.'/docs';
        \$this->fetcher->fetch('https://github.com/me/docs.git', 'main', \$repo);

        return \$repo.'/index.rst';
    }
}

Tag the service ai_mate.knowledge_provider.

Future-proofing

The chunk model (PageChunk) already matches what Symfony\AI\Store\Document\Vectorizer consumes, so a future vector-search bridge would only need to extract a small SearcherInterface from KeywordSearcher and an IndexerInterface from the JSON cache step. Not done now to keep the scope focused (YAGNI).

Test plan

• Knowledge bridge: 23/23 PHPUnit tests pass (services, models, registry, tools, TTL behavior)
• Symfony bridge: 114/114 existing tests still pass after my edits
• PHPStan clean on Knowledge bridge
• doctor-rst clean on docs change
• End-to-end: install both bridges in a real project, run bin/mate mcp:tools:call knowledge-toc '{}' then '{"provider":"symfony"}'