Aggrega Cache-Slot Metadata schema
Generated reference. Do not edit by hand — regenerate from the published JSON Schema.
Schema id: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json
The metadata.yaml file written into every source-artifact cache slot alongside blob.tgz. Records the {kind, url, version, digest, mediatype, pulled_at} identity tuple so cache inspection and build-time integrity verification have a single canonical record. The wire shape is closed (additionalProperties: false) and all six fields are required. Schema evolution discipline: adding a new optional field is SemVer-MINOR (additive); removing a field or tightening a constraint is SemVer-MAJOR.
Top-level type: object
Properties
| Property | Type | Required | Description |
|---|---|---|---|
kind | enum | yes | The source kind that produced this cache slot. Mirrors the lockfile’s source_artifacts[].kind enum; the matching kind is what every build-time consumer reads to choose the right loader. Allowed values: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci" |
url | string | yes | The authored URL — the identity URL as written in the Recipe’s spec.source.url. For helm-https-chart this is the repo root (repo-root form) or the direct .tgz (direct form) exactly as authored. For git-repository, the cloneable repository URL. For helm-oci-chart, the registry reference. For compose-https-fragment, the fragment’s HTTPS URL. The resolved artifact location for a repo-root helm source is recorded separately under resolved_url: as provenance. |
resolved_url | string | no | Provenance only: the concrete artifact location the authored URL resolved to at pull time. For a repo-root helm source this is the direct .tgz URL the repository index resolved the chart+version to. Recorded for diagnostics; not part of any integrity contract. Absent when the resolved location equals the authored URL. |
version | string | yes | The concrete version the resolver pinned at pull time. For helm-* kinds, the chart version. For git-repository, the commit the authored reference resolved to. Recorded as a single path segment, because it builds the cache slot this metadata sits in, so it carries no /, no \ and no ... Pattern: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | yes | Content digest of the cached .tar.gz archive in sha256:^sha256:[a-f0-9]{64}$. |
mediatype | string | yes | Canonical media type the registry advertised (or the kind’s default for kinds without registry metadata). Recorded for diagnostic provenance. |
pulled_at | string | yes | RFC 3339 timestamp recording the pull-time wall clock. Diagnostic provenance only — not part of any integrity contract. The pattern holds the value to the RFC 3339 shape when the metadata is read. Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
Additional properties are not permitted.