CAS Promotion Checklist (SIGNALS-24-002)
Audience: Signals Guild, Platform Storage Guild.
Purpose: Promote call graphs into content-addressable storage (CAS) with signed manifests, so the Signals module can serve immutable, verifiable callgraph artifacts. This checklist is the gate that moves SIGNALS-24-002 from
BLOCKEDto implementation.
Stella Ops stores call graphs as immutable, content-addressed blobs. Each blob is paired with a signed manifest so downstream consumers (Policy Engine, Reachability scoring, Console) can verify provenance before trusting the graph. The steps below stand up that storage tier and its signing/retention policy.
Preconditions
- CAS bucket created for
signals-callgraphswith write limited to Signals service principals. - Surface bundle mock hash recorded; real scanner cache ETA published.
- Signed manifest tooling available (sigstore or in-house signer) with add-only policy.
Steps
- Freeze manifest schema (fields:
graph_id,digest,language,source,created,signer,signature). - Generate manifests for existing callgraphs; store under
cas://signals/manifests/{graph_id}.json. - Sign each manifest; attach DSSE envelope; store under
cas://signals/manifests/{graph_id}.json.dsse. - Apply bucket policy: read-only for downstream, write for Signals service; deny deletes.
- Configure GC policy: retain manifests indefinitely; callgraph blobs keep 30d rolling unless referenced.
- Enable alerts for failed retrievals and missing manifest/DSSE pairs.
- Record hash list and signer key IDs in release notes.
Deliverables
- Policy document + proof of applied IAM
- Manifest schema JSON
- Signed manifest samples (see tests)
- Hash list of all published callgraphs (sha256)
Evidence locations (repo paths)
- Policy & schema: this file (
docs/modules/signals/guides/cas-promotion-24-002.md). - Sample manifest + DSSE:
tests/reachability/corpus/manifest.json(already present) maps to the expected structure.
Owners
| Guild | Responsibility |
|---|---|
| Signals Guild | Implementation |
| Platform Storage Guild | Policy and approvals |
Status
- Checklist published 2025-11-19; awaiting Platform Storage approval to proceed.
Related
- Provenance Appendix Checklist (SIGNALS-24-003) — provenance fields layered onto CAS-stored facts; depends on this promotion landing.
- Callgraph Schema Reference — structure of the
stella.callgraph.v1documents promoted into CAS.
