Repository navigation
Conversation
A plugin is now registered as a source of its provider:
plugin.RegisterProvider(Provider{ID, Name, Category, Homepage, Sources:
[]Source{ID, Kind, Layer, Watches, URLs, Page, Plugin}}). Source ids are
provider/source (stripe/api, algolia/search-api, openai/models); the old
slugs stay as aliases, so Lookup and LookupSource resolve both, Names() still
lists the old slugs, and events keep the old api value until patch-it's
change-event contract switches to source ids.
The three Algolia plugins are one provider with three sources. Every provider
has a category. RegisterProvider refuses incomplete metadata; a test checks
every registered plugin is a source whose page exists, and the docs table
must match the registrations word for word until it goes.
new-plugin writes a RegisterProvider block, reusing an existing provider's
metadata.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Signed-off-by: adssib <[email protected]>
This was referenced Nov 20, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Stacked on #183. Refs #173 (I19.2), part of #171.
What this changes
Every plugin is now registered as a source of a provider, with its metadata, in code:
provider/source; the old slug is the source'sPlugin.Name()and stays an alias.plugin.Lookupand the newplugin.LookupSourceresolve both (algolia/search-apiandalgolia-search).plugin.Names()still lists the old slugs (what--api allruns), so patch-it's hosted ingestion service behaves exactly as before.apivalue (algolia-search,openai-models…) until patch-it's change-event contract switches to source ids; that switch is a contract PR in patch-it first.plugins/openapi→openapi), so it can't drift.algolia/search-api,algolia/ingestion-api,algolia/recommend-api).plugin.Categories(): ai, payments, infrastructure, databases, monitoring, analytics, auth, messaging, hosting, search, devtools, crm, packages) and every source a layer (plugin.Layers(): api, sdk, package, runtime, ci, ai-models, infra).RegisterProviderrefuses incomplete metadata (no category, name, homepage, watches, URLs, page, a wrong layer or kind). A provider registered from two kinds (Anthropic, GitHub) must say the same name, category and homepage.plugins/all's test fails if a registered plugin isn't a source or its page is missing.docs/plugins.md,internal/pluginlistchecks every row says what its registration says (provider, layer, what it watches, page): the move is word for word, anddocs/plugins.jsonis unchanged.cmd/new-pluginwrites aRegisterProviderblock (placeholders markedTODO(new-plugin)for a new provider's category and homepage; an existing provider's metadata reused).apion events)(This table is for review only; it isn't committed anywhere.)
Checklist
docs/plugins.md: unchanged; a test now checks each row against its registration (removed in the next PR)main)testdata/README.md: not applicable, no new sourceproviders/<api>.md: unchanged; each source'sPagepoints at its existing pageenv.Get/core/kit/make checkpasses locallyNotes for the reviewer
go build ./... && go vet ./...pass (it usesRegister/Lookup/Names, all unchanged in behavior).Watches, provider name, layer and page with itsdocs/plugins.mdrow: the new pluginlist check enforces it.Calls I made (please check)
search(Algolia, Elastic),analytics(PostHog),crm(Salesforce). Choices to check: Google →ai(only Vertex AI models today), Appwrite →hosting, Supabase/Neon/Convex/PlanetScale/MongoDB/Redis →databases, Cloudflare →infrastructure, GitHub/GitLab/Flagsmith →devtools.apifor a provider's single REST API,rest-apiwhere the provider has other sources or several APIs (GitHub, GitLab, Salesforce), the package name for packages (numpy/numpy),python-sdk/python-agentfor SDKs. Elasticsearch's provider iselastic.Statusfield: a registered source is live by definition; a pause belongs in the hosted service's settings, not in code.Related PRs
plugins.jsonrelease asset)apps/plugins-repo.md)🤖 Generated with Claude Code