registry: verify service api_version against entrypoint source #191

Closed
opened 2026-09-08 02:03:11 +00:00 by nsaspy · 0 comments
Owner

Registry P0 compatibility hardening.

validate_service_entrypoint() statically verifies published service name/version agreement but does not verify the registry api_version against literal PluginMetadata(api_version=...) or a canonical module API-version constant. Runtime compatibility catches loaded mismatches later, leaving the fast registry validator with a false-green.

Acceptance:

  • deterministic RED for a service entrypoint whose source declares a different API version than plugins.json;
  • accept literal metadata API versions and canonical API_VERSION / plugin-scoped *_API_VERSION constants;
  • fail closed when source API version cannot be verified;
  • preserve existing name/version checks;
  • focused registry tests, full compatibility/Nix/package gates, exact-head protected merge.
Registry P0 compatibility hardening. `validate_service_entrypoint()` statically verifies published service name/version agreement but does not verify the registry `api_version` against literal `PluginMetadata(api_version=...)` or a canonical module API-version constant. Runtime compatibility catches loaded mismatches later, leaving the fast registry validator with a false-green. Acceptance: - deterministic RED for a service entrypoint whose source declares a different API version than `plugins.json`; - accept literal metadata API versions and canonical `API_VERSION` / plugin-scoped `*_API_VERSION` constants; - fail closed when source API version cannot be verified; - preserve existing name/version checks; - focused registry tests, full compatibility/Nix/package gates, exact-head protected merge.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
nsaspy/zara-plugins#191
No description provided.