apiVersion: naftiko.dev/v1
kind: Capability
metadata:
  name: bazel-central-registry
  title: Bazel Central Registry Lookups
  description: Read-only capability for resolving Bazel modules against the Bazel
    Central Registry (or any BCR-compatible index registry).
  tags:
    - Bzlmod
    - Modules
    - Registry
spec:
  api: bazel-build:bazel-central-registry-api
  operations:
    - id: getRegistryMetadata
      summary: Fetch /bazel_registry.json
      description: Returns mirror list and module_base_path for the registry.
    - id: getModuleMetadata
      summary: List all versions of a module
      description: Read /modules/{module}/metadata.json to discover all published
        versions and any yanked entries.
    - id: getModuleManifest
      summary: Fetch a module's MODULE.bazel for a version
      description: Read /modules/{module}/{version}/MODULE.bazel to inspect that
        version's transitive bazel_dep() declarations.
    - id: getModuleSource
      summary: Fetch a module's source descriptor
      description: Read /modules/{module}/{version}/source.json to learn the source
        archive URL, integrity, and strip_prefix.
  policy:
    rateLimit:
      requestsPerMinute: 120
      notes: Registry hosts are CDN-fronted static JSON; standard polite-client
        limits apply.
    auth: none
  observability:
    metrics:
      - module_lookups_total
      - module_lookup_errors_total
    logs:
      - module_lookup_request