Apple Docs Bridge
Relier les agents à la documentation Apple en conservant la source, la fraîcheur et les inconnues de chaque réponse.
Schéma du service · illustration originale, sans contenu documentaire tiers
Problème et contexte
Un agent qui consulte une documentation doit savoir d’où elle vient, quand elle a été vérifiée et si elle reste utilisable après une panne. La disponibilité d’une API ne suffit pas non plus à établir l’éligibilité d’une fonctionnalité dans un contexte donné.
Ma contribution
Développé un service MCP local de recherche et de restitution des références API, HIG et pages Support, avec sources Markdown et repli DocC JSON. Ajouté un cache SQLite partagé entre processus, des réponses paginées avec provenance et fraîcheur, et une vérification régionale limitée aux règles explicitement examinées. Préparé les transports stdio et HTTP loopback ainsi qu’un paquet de plugin portable.
Choix et compromis
Partager le cache et réguler la revalidation entre processus.
Utiliser des baux, des requêtes conditionnelles et un délai partagé après une limitation du serveur. Conserver une source périmée explicitement signalée, ou répondre indisponible, plutôt que masquer l’échec d’une actualisation.
Faire des inconnues une partie du résultat.
Distinguer date de publication, dernière vérification, disponibilité OS/API et éligibilité régionale. Une règle non couverte reste inconnue ; le cache ne constitue pas une archive historique des SDK.
Résultat
Un service documentaire local qui restitue contenu et provenance avec un état de fraîcheur explicite. Le paquet et les transports sont distincts d’une installation validée dans un client donné ou d’un service distant de production.