stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

prep docs and service updates
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details

Browse Source
This commit is contained in:
master
2025-11-21 06:56:36 +00:00
parent ca35db9ef4
commit d519782a8f
242 changed files with 17293 additions and 13367 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/modules/policy/prep/2025-11-20-ledger-export-prep.md Normal file
View File

@@ -0,0 +1,21 @@
# 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.