diff --git a/AGENTS.md b/AGENTS.md index 5b6ef22..565d096 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,7 +4,7 @@ Rules for AI coding agents (and humans) working in this repo. `CLAUDE.md` import ## Rule 1: every new or changed provider or source has complete metadata in its registration -**A source exists when its kind's package registers it with `plugin.RegisterProvider`, and its metadata lives only there: the provider's id, name, category and homepage, and each source's id, layer, what it watches, the URLs it reads and its page, `providers/.md`.** Adding, changing or removing a source is a change to that registration (and to its page) in the same PR. There is no list to update: nothing in this repo, the docs site or anywhere else keeps one by hand. +**A source exists when its kind's package registers it with `plugin.RegisterProvider`, and its metadata lives only there: the provider's id, name, category and homepage, and each source's id, layer, what it watches, the URLs it reads, the packages it covers (`pypi:stripe`) and its page, `providers/.md`.** Adding, changing or removing a source is a change to that registration (and to its page) in the same PR. There is no list to update: nothing in this repo, the docs site or anywhere else keeps one by hand. `go run ./cmd/list-plugins` prints the list from the registry (JSON), and the Release workflow attaches it to every release as `plugins.json`; the docs site and patch-it's hosted ingestion service read it from there. `RegisterProvider` refuses incomplete metadata and `go test` fails when a source's page is missing, but no check can tell whether the words are right: you are that check. Say in the PR that you read them. diff --git a/core/plugin/provider.go b/core/plugin/provider.go index 4a02323..9d6cd7d 100644 --- a/core/plugin/provider.go +++ b/core/plugin/provider.go @@ -67,6 +67,11 @@ const ( LayerInfra Layer = "infra" ) +// Ecosystems are the package registries a Source's Packages name. +func Ecosystems() []string { + return []string{"pypi", "npm", "go", "maven", "nuget", "rubygems", "cargo", "packagist"} +} + // Layers are every layer. func Layers() []Layer { return []Layer{LayerAPI, LayerSDK, LayerPackage, LayerRuntime, LayerCI, LayerAIModels, LayerInfra} @@ -103,6 +108,13 @@ type Source struct { // Page is the source's page in this repo: "providers/algolia.md" (why // this source, what it reads and ignores, its known gaps). Page string + // Packages are the published packages whose changes this source + // covers, as ":" ("pypi:stripe", "npm:@vercel/sdk"): + // the package itself for a package or SDK source, the provider's + // official SDKs for an API source. What lets a lockfile entry find its + // sources without a table kept elsewhere. Only names checked by hand; + // none is fine when no package maps to the source. + Packages []string // Plugin runs it. Its Name is the source's old slug ("algolia-search"): // what `--api` selects and every event's `api` carries until patch-it's // change-event contract switches to source ids. @@ -212,6 +224,12 @@ func (p Provider) check() error { return fmt.Errorf("source %q: URL %q isn't absolute", id, u) } } + for _, pkg := range s.Packages { + eco, name, ok := strings.Cut(pkg, ":") + if !ok || !slices.Contains(Ecosystems(), eco) || name == "" || strings.ContainsAny(name, " \t\n") { + return fmt.Errorf("source %q: package %q isn't :, the ecosystem one of plugin.Ecosystems()", id, pkg) + } + } seen[s.ID] = true } return nil @@ -279,6 +297,24 @@ func Sources() []SourceInfo { return out } +// Aliases are the other names a source answers to (Lookup, LookupSource): +// today its first name, the old slug ("algolia-search"), which events carry +// in `api` and fingerprints hash. +func (s SourceInfo) Aliases() []string { return []string{s.Alias()} } + +// ForPackage are the sources that cover a published package +// ("pypi:stripe"), sorted by full id: how a lockfile entry finds what to +// ask the feed for. +func ForPackage(pkg string) []SourceInfo { + var out []SourceInfo + for _, s := range Sources() { + if slices.Contains(s.Source.Packages, pkg) { + out = append(out, s) + } + } + return out +} + // LookupSource finds a source by its full id ("algolia/search-api") or its // old slug ("algolia-search"). func LookupSource(id string) (SourceInfo, bool) { diff --git a/core/plugin/provider_test.go b/core/plugin/provider_test.go index cc2bdf6..6d42186 100644 --- a/core/plugin/provider_test.go +++ b/core/plugin/provider_test.go @@ -59,6 +59,11 @@ func TestRegisterProviderRefusesIncompleteMetadata(t *testing.T) { s.Layer = "API" return s }()}}, + "bad package": {ID: "x7", Name: "X", Category: CategoryAI, Homepage: "https://x.example", Sources: []Source{func() Source { + s := src("api", "x7") + s.Packages = []string{"pip:x"} + return s + }()}}, "wrong kind": {ID: "x6", Name: "X", Category: CategoryAI, Homepage: "https://x.example", Sources: []Source{func() Source { s := src("api", "x6") s.Kind = "openapi" @@ -95,3 +100,17 @@ func TestMergedKindsKeepWorking(t *testing.T) { t.Errorf("CanonicalKind(openapi) = %q", got) } } + +// A package names its sources, and a source answers to its first name. +func TestForPackage(t *testing.T) { + s := src("pkg", "acme-test-pkg") + s.Packages = []string{"pypi:acme-test", "npm:@acme/test"} + RegisterProvider(acme(s)) + got := ForPackage("npm:@acme/test") + if len(got) != 1 || got[0].FullID() != "acme-test/pkg" || strings.Join(got[0].Aliases(), ",") != "acme-test-pkg" { + t.Errorf("ForPackage = %+v", got) + } + if got := ForPackage("pypi:nobody"); len(got) != 0 { + t.Errorf("ForPackage(pypi:nobody) = %+v", got) + } +} diff --git a/docs/plugins.schema.json b/docs/plugins.schema.json index d59ddc8..d935a39 100644 --- a/docs/plugins.schema.json +++ b/docs/plugins.schema.json @@ -32,11 +32,14 @@ "type": "array", "items": { "type": "object", - "required": ["id", "alias", "kind", "layer", "watches", "urls", "page"], + "required": ["id", "alias", "first_name", "aliases", "kind", "layer", "watches", "urls", "packages", "page"], "additionalProperties": false, "properties": { "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*/[a-z0-9][a-z0-9-]*$", "description": "provider/source" }, "alias": { "type": "string", "pattern": "^[a-z0-9][a-z0-9.-]*$", "description": "The old slug: --api and every event's api field until patch-it's change-event contract switches to source ids." }, + "first_name": { "type": "string", "pattern": "^[a-z0-9][a-z0-9.-]*$", "description": "The source's first name, its old slug: what fingerprints keep hashing after the contract switches to source ids." }, + "aliases": { "type": "array", "items": { "type": "string", "pattern": "^[a-z0-9][a-z0-9.-]*$" }, "description": "Every other name the source answers to." }, + "packages": { "type": "array", "items": { "type": "string", "pattern": "^(pypi|npm|go|maven|nuget|rubygems|cargo|packagist):[^\\s]+$" }, "description": "The published packages this source covers, as ecosystem:name, so a lockfile entry finds its sources." }, "kind": { "type": "string", "enum": ["openapi", "changelog", "notices", "migrationguide", "catalog"] }, "layer": { "type": "string", "enum": ["api", "sdk", "package", "runtime", "ci", "ai-models", "infra"] }, "watches": { "type": "string", "minLength": 1 }, diff --git a/docs/writing-a-plugin.md b/docs/writing-a-plugin.md index 6be55f3..ca73552 100644 --- a/docs/writing-a-plugin.md +++ b/docs/writing-a-plugin.md @@ -136,13 +136,16 @@ func init() { ID: "urllib3", Layer: plugin.LayerPackage, Page: "providers/urllib3.md", Watches: "Names removed or deprecated in each release, …", URLs: []string{"https://github.com/urllib3/urllib3/blob/main/CHANGES.rst"}, + Packages: []string{"pypi:urllib3"}, Plugin: Plugin{File: Urllib3}, }}, }) } ``` -`RegisterProvider` panics on missing metadata, a duplicate id, or a provider registered twice with a different name, category or homepage (a provider with sources in two kinds repeats the same ones). `plugin.Lookup` and `plugin.LookupSource` find a source by `provider/source` or by its old slug. +`RegisterProvider` panics on missing metadata, a duplicate id, or a provider registered twice with a different name, category or homepage (a provider with sources in two kinds repeats the same ones). `plugin.Lookup` and `plugin.LookupSource` find a source by `provider/source` or by its old slug (its first name, which events carry in `api` and fingerprints hash). + +`Packages` are the published packages the source covers, `:` (`pypi:stripe`, `npm:@vercel/sdk`): the package itself for a package or SDK source, the provider's official SDKs for an API source. `plugin.ForPackage` finds a package's sources, so a customer's lockfile maps to sources with no table kept anywhere else. List only names you checked; none is fine. ### Fetching: `env.Get` and `core/kit/` diff --git a/internal/pluginlist/pluginlist.go b/internal/pluginlist/pluginlist.go index e9a9aa8..d4bb2e5 100644 --- a/internal/pluginlist/pluginlist.go +++ b/internal/pluginlist/pluginlist.go @@ -38,13 +38,16 @@ type Provider struct { // Source is one source. type Source struct { - ID string `json:"id"` // provider/source - Alias string `json:"alias"` // the old slug: --api and every event's api until the contract switches to source ids - Kind string `json:"kind"` - Layer string `json:"layer"` - Watches string `json:"watches"` - URLs []string `json:"urls"` - Page string `json:"page"` // absolute, at Version + ID string `json:"id"` // provider/source + Alias string `json:"alias"` // the old slug: --api and every event's api until the contract switches to source ids + FirstName string `json:"first_name"` // the same old slug, by the name fingerprints keep hashing after the switch + Aliases []string `json:"aliases"` // every other name the source answers to + Kind string `json:"kind"` + Layer string `json:"layer"` + Watches string `json:"watches"` + URLs []string `json:"urls"` + Packages []string `json:"packages"` // ":"; [] when none + Page string `json:"page"` // absolute, at Version } // Build is the list of everything registered, with pages linked at ref (a @@ -64,9 +67,11 @@ func Build(ref string) File { for _, p := range plugin.Providers() { out := Provider{ID: p.ID, Name: p.Name, Category: string(p.Category), Homepage: p.Homepage} for _, s := range p.Sources { + info := plugin.SourceInfo{Provider: p, Source: s} out.Sources = append(out.Sources, Source{ - ID: p.ID + "/" + s.ID, Alias: s.Plugin.Name(), Kind: s.Kind, Layer: string(s.Layer), - Watches: s.Watches, URLs: s.URLs, Page: Repo + "/blob/" + ref + "/" + s.Page, + ID: info.FullID(), Alias: info.Alias(), FirstName: info.Alias(), Aliases: info.Aliases(), + Kind: s.Kind, Layer: string(s.Layer), Watches: s.Watches, URLs: s.URLs, + Packages: append([]string{}, s.Packages...), Page: Repo + "/blob/" + ref + "/" + s.Page, }) } f.Sources += len(out.Sources) diff --git a/plugins/changelog/changelog.go b/plugins/changelog/changelog.go index ff3f790..bfbc293 100644 --- a/plugins/changelog/changelog.go +++ b/plugins/changelog/changelog.go @@ -34,18 +34,20 @@ func init() { ID: "textual", Name: "Textual", Category: plugin.CategoryPackages, Homepage: "https://textual.textualize.io", Sources: []plugin.Source{{ ID: "textual", Layer: plugin.LayerPackage, Page: "providers/textual.md", - Watches: "Names removed, renamed or deprecated in each release, from the release's section of CHANGELOG.md at its tag", - URLs: []string{"https://github.com/Textualize/textual/blob/main/CHANGELOG.md", "https://pypi.org/project/textual/"}, - Plugin: Plugin{File: Textual}, + Watches: "Names removed, renamed or deprecated in each release, from the release's section of CHANGELOG.md at its tag", + URLs: []string{"https://github.com/Textualize/textual/blob/main/CHANGELOG.md", "https://pypi.org/project/textual/"}, + Packages: []string{"pypi:textual"}, + Plugin: Plugin{File: Textual}, }}, }) plugin.RegisterProvider(plugin.Provider{ ID: "urllib3", Name: "urllib3", Category: plugin.CategoryPackages, Homepage: "https://urllib3.readthedocs.io", Sources: []plugin.Source{{ ID: "urllib3", Layer: plugin.LayerPackage, Page: "providers/urllib3.md", - Watches: "Names removed or deprecated in each release, from the release's section of CHANGES.rst at its tag", - URLs: []string{"https://github.com/urllib3/urllib3/blob/main/CHANGES.rst", "https://pypi.org/project/urllib3/"}, - Plugin: Plugin{File: Urllib3}, + Watches: "Names removed or deprecated in each release, from the release's section of CHANGES.rst at its tag", + URLs: []string{"https://github.com/urllib3/urllib3/blob/main/CHANGES.rst", "https://pypi.org/project/urllib3/"}, + Packages: []string{"pypi:urllib3"}, + Plugin: Plugin{File: Urllib3}, }}, }) plugin.RegisterProvider(plugin.Provider{ diff --git a/plugins/migrationguide/migrationguide.go b/plugins/migrationguide/migrationguide.go index d0ba2fd..15e8fa6 100644 --- a/plugins/migrationguide/migrationguide.go +++ b/plugins/migrationguide/migrationguide.go @@ -28,36 +28,40 @@ func init() { ID: "anthropic", Name: "Anthropic", Category: plugin.CategoryAI, Homepage: "https://www.anthropic.com", Sources: []plugin.Source{{ ID: "python-sdk", Layer: plugin.LayerSDK, Page: "providers/anthropic.md", - Watches: "Request parameters each new major of the Python SDK removes from `messages.create()` and friends, from MIGRATION.md at the major's tag", - URLs: []string{"https://github.com/anthropics/anthropic-sdk-python/blob/main/MIGRATION.md", "https://pypi.org/project/anthropic/"}, - Plugin: Plugin{Guide: sdkguide.Anthropic}, + Watches: "Request parameters each new major of the Python SDK removes from `messages.create()` and friends, from MIGRATION.md at the major's tag", + URLs: []string{"https://github.com/anthropics/anthropic-sdk-python/blob/main/MIGRATION.md", "https://pypi.org/project/anthropic/"}, + Packages: []string{"pypi:anthropic"}, + Plugin: Plugin{Guide: sdkguide.Anthropic}, }}, }) plugin.RegisterProvider(plugin.Provider{ ID: "numpy", Name: "NumPy", Category: plugin.CategoryPackages, Homepage: "https://numpy.org", Sources: []plugin.Source{{ ID: "numpy", Layer: plugin.LayerPackage, Page: "providers/numpy.md", - Watches: "Members removed or renamed in the main namespace in NumPy 2.0", - URLs: []string{"https://github.com/numpy/numpy/blob/v2.0.0/doc/source/numpy_2_0_migration_guide.rst"}, - Plugin: Plugin{Guide: members.NumPy2}, + Watches: "Members removed or renamed in the main namespace in NumPy 2.0", + URLs: []string{"https://github.com/numpy/numpy/blob/v2.0.0/doc/source/numpy_2_0_migration_guide.rst"}, + Packages: []string{"pypi:numpy"}, + Plugin: Plugin{Guide: members.NumPy2}, }}, }) plugin.RegisterProvider(plugin.Provider{ ID: "posthog", Name: "PostHog", Category: plugin.CategoryAnalytics, Homepage: "https://posthog.com", Sources: []plugin.Source{{ ID: "python-sdk", Layer: plugin.LayerSDK, Page: "providers/posthog.md", - Watches: "Members removed in the posthog Python SDK 8.0.0", - URLs: []string{"https://github.com/PostHog/posthog-python/blob/posthog-v8.0.0/docs/migration-7.x-to-8.0.md"}, - Plugin: Plugin{Guide: members.PostHog8}, + Watches: "Members removed in the posthog Python SDK 8.0.0", + URLs: []string{"https://github.com/PostHog/posthog-python/blob/posthog-v8.0.0/docs/migration-7.x-to-8.0.md"}, + Packages: []string{"pypi:posthog"}, + Plugin: Plugin{Guide: members.PostHog8}, }}, }) plugin.RegisterProvider(plugin.Provider{ ID: "newrelic", Name: "New Relic", Category: plugin.CategoryMonitoring, Homepage: "https://newrelic.com", Sources: []plugin.Source{{ ID: "python-agent", Layer: plugin.LayerSDK, Page: "providers/newrelic.md", - Watches: "Members removed in the New Relic Python agent 11.0.0", - URLs: []string{"https://github.com/newrelic/docs-website/blob/f0b4f817bf9a7b76a78e26609369a8a7ce764c8e/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-110000.mdx"}, - Plugin: Plugin{Guide: members.NewRelic11}, + Watches: "Members removed in the New Relic Python agent 11.0.0", + URLs: []string{"https://github.com/newrelic/docs-website/blob/f0b4f817bf9a7b76a78e26609369a8a7ce764c8e/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-110000.mdx"}, + Packages: []string{"pypi:newrelic"}, + Plugin: Plugin{Guide: members.NewRelic11}, }}, }) } diff --git a/plugins/notices/notices.go b/plugins/notices/notices.go index 56c051a..03f160c 100644 --- a/plugins/notices/notices.go +++ b/plugins/notices/notices.go @@ -37,18 +37,20 @@ func init() { ID: "openai", Name: "OpenAI", Category: plugin.CategoryAI, Homepage: "https://openai.com", Sources: []plugin.Source{{ ID: "models", Layer: plugin.LayerAIModels, Page: "providers/openai-models.md", - Watches: "Model deprecations and shutdown dates (Chat Completions and Responses text models)", - URLs: []string{"https://developers.openai.com/api/docs/deprecations"}, - Plugin: Plugin{Page: retire.OpenAI, Archiver: kit.Wayback{}}, + Watches: "Model deprecations and shutdown dates (Chat Completions and Responses text models)", + URLs: []string{"https://developers.openai.com/api/docs/deprecations"}, + Packages: []string{"pypi:openai", "npm:openai"}, + Plugin: Plugin{Page: retire.OpenAI, Archiver: kit.Wayback{}}, }}, }) plugin.RegisterProvider(plugin.Provider{ ID: "anthropic", Name: "Anthropic", Category: plugin.CategoryAI, Homepage: "https://www.anthropic.com", Sources: []plugin.Source{{ ID: "models", Layer: plugin.LayerAIModels, Page: "providers/anthropic-models.md", - Watches: "Model deprecations and retirement dates (Messages API models)", - URLs: []string{"https://platform.claude.com/docs/en/about-claude/model-deprecations"}, - Plugin: Plugin{Page: retire.Anthropic, Archiver: kit.Wayback{}}, + Watches: "Model deprecations and retirement dates (Messages API models)", + URLs: []string{"https://platform.claude.com/docs/en/about-claude/model-deprecations"}, + Packages: []string{"pypi:anthropic", "npm:@anthropic-ai/sdk"}, + Plugin: Plugin{Page: retire.Anthropic, Archiver: kit.Wayback{}}, }}, }) plugin.RegisterProvider(plugin.Provider{ @@ -73,9 +75,10 @@ func init() { ID: "cloudflare", Name: "Cloudflare", Category: plugin.CategoryInfrastructure, Homepage: "https://www.cloudflare.com", Sources: []plugin.Source{{ ID: "api", Layer: plugin.LayerAPI, Page: "providers/cloudflare.md", - Watches: "REST API operations Cloudflare deprecates, breaking on their end-of-life date when it gives one", - URLs: []string{"https://developers.cloudflare.com/fundamentals/api/reference/deprecations/index.xml"}, - Plugin: Plugin{Page: feed.CloudflareAPI, Archiver: kit.Wayback{}}, + Watches: "REST API operations Cloudflare deprecates, breaking on their end-of-life date when it gives one", + URLs: []string{"https://developers.cloudflare.com/fundamentals/api/reference/deprecations/index.xml"}, + Packages: []string{"pypi:cloudflare", "npm:cloudflare"}, + Plugin: Plugin{Page: feed.CloudflareAPI, Archiver: kit.Wayback{}}, }}, }) plugin.RegisterProvider(plugin.Provider{ diff --git a/plugins/openapi/openapi.go b/plugins/openapi/openapi.go index 61eeda4..65d686f 100644 --- a/plugins/openapi/openapi.go +++ b/plugins/openapi/openapi.go @@ -25,9 +25,10 @@ func init() { ID: "stripe", Name: "Stripe", Category: plugin.CategoryPayments, Homepage: "https://stripe.com", Sources: []plugin.Source{{ ID: "api", Layer: plugin.LayerAPI, Page: "providers/stripe.md", - Watches: "REST API changes between OpenAPI spec releases (removed and renamed endpoints, parameters and fields), with migration hints from Stripe's API changelog", - URLs: []string{"https://github.com/stripe/openapi"}, - Plugin: Plugin{Adapter: adapter.Stripe{}, Hints: hint.Stripe{}}, + Watches: "REST API changes between OpenAPI spec releases (removed and renamed endpoints, parameters and fields), with migration hints from Stripe's API changelog", + URLs: []string{"https://github.com/stripe/openapi"}, + Packages: []string{"pypi:stripe", "npm:stripe"}, + Plugin: Plugin{Adapter: adapter.Stripe{}, Hints: hint.Stripe{}}, }}, }) // No Hints yet: Datadog's changelog isn't Stripe's per-parameter table @@ -36,9 +37,10 @@ func init() { ID: "datadog", Name: "Datadog", Category: plugin.CategoryMonitoring, Homepage: "https://www.datadoghq.com", Sources: []plugin.Source{{ ID: "api", Layer: plugin.LayerAPI, Page: "providers/datadog.md", - Watches: "API v2 changes between OpenAPI spec releases", - URLs: []string{"https://github.com/DataDog/datadog-api-client-python"}, - Plugin: Plugin{Adapter: adapter.Datadog{}}, + Watches: "API v2 changes between OpenAPI spec releases", + URLs: []string{"https://github.com/DataDog/datadog-api-client-python"}, + Packages: []string{"pypi:datadog-api-client", "npm:@datadog/datadog-api-client"}, + Plugin: Plugin{Adapter: adapter.Datadog{}}, }}, }) // No Hints: GitLab's deprecations are prose per feature, not a changelog @@ -70,9 +72,10 @@ func init() { ID: "vercel", Name: "Vercel", Category: plugin.CategoryHosting, Homepage: "https://vercel.com", Sources: []plugin.Source{{ ID: "api", Layer: plugin.LayerAPI, Page: "providers/vercel.md", - Watches: "REST API operations deprecated, and deprecated operations removed, between SDK releases of the spec", - URLs: []string{"https://github.com/vercel/sdk"}, - Plugin: Plugin{Adapter: adapter.Vercel{}, Diff: vercelDiff, Keep: vercelKeep}, + Watches: "REST API operations deprecated, and deprecated operations removed, between SDK releases of the spec", + URLs: []string{"https://github.com/vercel/sdk"}, + Packages: []string{"npm:@vercel/sdk"}, + Plugin: Plugin{Adapter: adapter.Vercel{}, Diff: vercelDiff, Keep: vercelKeep}, }}, }) // No Hints: Supabase's changelog is platform news, not keyed by @@ -92,9 +95,10 @@ func init() { for _, spec := range []struct{ name, title string }{{"search", "Search"}, {"ingestion", "Ingestion"}, {"recommend", "Recommend"}} { algolia.Sources = append(algolia.Sources, plugin.Source{ ID: spec.name + "-api", Layer: plugin.LayerAPI, Page: "providers/algolia.md", - Watches: spec.title + " API operations deprecated, and deprecated operations removed, between releases of the spec", - URLs: []string{"https://github.com/algolia/api-clients-automation", "https://github.com/algolia/api-clients-automation/blob/main/specs/bundled/" + spec.name + ".yml"}, - Plugin: Plugin{Adapter: adapter.Algolia{Spec: spec.name}, Diff: algoliaDiff, Keep: algoliaKeep}, + Watches: spec.title + " API operations deprecated, and deprecated operations removed, between releases of the spec", + URLs: []string{"https://github.com/algolia/api-clients-automation", "https://github.com/algolia/api-clients-automation/blob/main/specs/bundled/" + spec.name + ".yml"}, + Packages: []string{"pypi:algoliasearch", "npm:algoliasearch"}, + Plugin: Plugin{Adapter: adapter.Algolia{Spec: spec.name}, Diff: algoliaDiff, Keep: algoliaKeep}, }) } plugin.RegisterProvider(algolia) @@ -104,9 +108,10 @@ func init() { ID: "elastic", Name: "Elastic", Category: plugin.CategorySearch, Homepage: "https://www.elastic.co", Sources: []plugin.Source{{ ID: "elasticsearch-api", Layer: plugin.LayerAPI, Page: "providers/elasticsearch.md", - Watches: "Elasticsearch REST API operations deprecated, and deprecated operations removed, between released minor versions of the spec", - URLs: []string{"https://github.com/elastic/elasticsearch-specification"}, - Plugin: Plugin{Adapter: adapter.Elasticsearch{}, Diff: elasticsearchDiff, Keep: elasticsearchKeep, RemovalsNeedANewVersion: true}, + Watches: "Elasticsearch REST API operations deprecated, and deprecated operations removed, between released minor versions of the spec", + URLs: []string{"https://github.com/elastic/elasticsearch-specification"}, + Packages: []string{"pypi:elasticsearch", "npm:@elastic/elasticsearch"}, + Plugin: Plugin{Adapter: adapter.Elasticsearch{}, Diff: elasticsearchDiff, Keep: elasticsearchKeep, RemovalsNeedANewVersion: true}, }}, }) // No Hints: Sentry's changelog is product news, not keyed by operation. @@ -127,9 +132,10 @@ func init() { ID: "neon", Name: "Neon", Category: plugin.CategoryDatabases, Homepage: "https://neon.com", Sources: []plugin.Source{{ ID: "api", Layer: plugin.LayerAPI, Page: "providers/neon.md", - Watches: "Neon API operations deprecated, and deprecated operations removed, between commits of the spec", - URLs: []string{"https://github.com/neondatabase/neon-pkgs"}, - Plugin: Plugin{Adapter: adapter.Neon{}, Diff: neonDiff, Keep: neonKeep}, + Watches: "Neon API operations deprecated, and deprecated operations removed, between commits of the spec", + URLs: []string{"https://github.com/neondatabase/neon-pkgs"}, + Packages: []string{"npm:@neondatabase/api-client"}, + Plugin: Plugin{Adapter: adapter.Neon{}, Diff: neonDiff, Keep: neonKeep}, }}, }) // No Hints: Convex has no API changelog; its news feed is product news. @@ -162,9 +168,10 @@ func init() { ID: "appwrite", Name: "Appwrite", Category: plugin.CategoryHosting, Homepage: "https://appwrite.io", Sources: []plugin.Source{{ ID: "api", Layer: plugin.LayerAPI, Page: "providers/appwrite.md", - Watches: "REST API operations a server SDK calls that are deprecated between commits of the spec, SDK method renames left out", - URLs: []string{"https://github.com/appwrite/specs"}, - Plugin: Plugin{Adapter: adapter.Appwrite{}, Diff: appwriteDiff, Keep: appwriteKeep}, + Watches: "REST API operations a server SDK calls that are deprecated between commits of the spec, SDK method renames left out", + URLs: []string{"https://github.com/appwrite/specs"}, + Packages: []string{"pypi:appwrite", "npm:node-appwrite"}, + Plugin: Plugin{Adapter: adapter.Appwrite{}, Diff: appwriteDiff, Keep: appwriteKeep}, }}, }) // No Hints: Flagsmith's release notes are product news, not keyed by