The release event¶
The event is the product. Every consumer, whatever its sink, receives the same CloudEvents 1.0 object, described by a JSON Schema in angelia-dev/spec.
{
"specversion": "1.0",
"id": "01JBX2A7C8D9E0F1G2H3J4K5M6",
"source": "angelia://homelab/watches/01JBX1Z3M4N5P6Q7R8S9T0V1W2",
"type": "dev.angelia.release.published.v1",
"subject": "pypi:requests@2.33.0",
"time": "2026-10-30T17:00:02.512Z",
"datacontenttype": "application/json",
"dataschema": "https://github.com/angelia-dev/spec/schemas/release/v1.json",
"data": {
"source": "pypi",
"package": "requests",
"version": "2.33.0",
"normalized_version": "2.33.0",
"previous_version": "2.32.5",
"scheme": "pep440",
"bump": "minor",
"backport": false,
"prerelease": false,
"yanked": false,
"published_at": "2026-10-27T14:02:11Z",
"detected_at": "2026-10-30T17:00:00Z",
"cooldown_satisfied_at": "2026-10-30T14:02:11Z",
"urls": {
"release": "https://pypi.org/project/requests/2.33.0/",
"changelog": "https://github.com/psf/requests/blob/main/HISTORY.md",
"artifact": null
},
"notes": null,
"watch": {
"id": "01JBX1Z3M4N5P6Q7R8S9T0V1W2",
"name": "requests",
"labels": { "team": "platform" }
},
"purl": "pkg:pypi/requests@2.33.0"
}
}
What to rely on¶
idis stable. It is generated once; every retry and replay carries the same id. Delivery is at-least-once, so deduplicate on it.- Every documented field is present. A field without a value is
null, never missing. versionis the raw upstream string,normalized_versionthe scheme's form.previous_versionis the greatest earlier version, andbump(major,minor,patch) is the change from it.backportistruewhen a greater version was already known:1.9.4after2.0.0.purlidentifies the package, so you can join with SBOMs, OSV and Renovate.- Ignore what you do not know. New optional fields are a minor change.
Types¶
type |
When |
|---|---|
dev.angelia.release.published.v1 |
a new final version passed the policy |
dev.angelia.release.prerelease.v1 |
a new pre-release passed the policy |
dev.angelia.release.yanked.v1 |
a known version was yanked upstream; refers to the original event |
The data is untrusted
Package names, versions and URLs come from public registries that anyone can publish to. Treat every field as data: quote it in shell scripts, never paste it into a prompt as an instruction. See Security model.