stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 16 Releases Wiki Activity
Files
efaf3cb7899907a8d18840fa6af146795f3c3bf9
git.stella-ops.org/docs/modules/policy/prep/2025-11-20-ledger-export-prep.md
master d519782a8f
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details
prep docs and service updates
2025-11-21 06:56:36 +00:00

1.0 KiB
Raw Blame History

Ledger Export Prep — PREP-POLICY-ENGINE-34-101-LEDGER-EXPORT-REQUI

Status: Draft (2025-11-20) Owners: Policy Guild Scope: Define ledger export requirements once worker results (33-101) exist.

Dependencies

  • Worker result schema (33-101).
  • Storage/ledger format choice (Mongo vs Postgres) and retention policy.

Draft export shape

  • Export file: NDJSON with entries {tenant_id, job_id, context_id, component_purl, advisory_id, status, trace_ref, occurred_at}.
  • Manifest: {export_id, schema_version, generated_at, record_count, sha256} with DSSE envelope optional.
  • Ordering: stable by (tenant_id, job_id, component_purl, advisory_id).

Acceptance

  • Draft schema at docs/modules/policy/schemas/policy-ledger-export@draft.json and sample at docs/modules/policy/samples/policy-ledger-export@draft.json.
  • Retention knobs documented (TTL/size caps) once storage decision is made.

Handoff

Use this as the prep artefact for PREP-POLICY-ENGINE-34-101-LEDGER-EXPORT-REQUI. Update with storage/retention decisions, then unblock implementation.