stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
f6ef1ef33762710a15cda339adc816ba114ea080
git.stella-ops.org/docs-archived/implplan/2025-11-24-export-mirror-orch-1501.md
master d0a7b88398 move docs/**/archived/* to docs-archived/**/*
2026-01-05 16:02:11 +02:00

1.3 KiB
Raw Blame History

Export / Orchestrator Mirror Hook — EXPORT-MIRROR-ORCH-1501

Date: 2025-11-24 Owners: Exporter Guild · CLI Guild Scope: Define orchestration/export hook payload when mirror bundles become ready so CLI/automation can consume without Ops backlog leakage.

Hook payload

Event: mirror.ready Fields (deterministic, lower-case keys):

  • bundleId (string)
  • generation (string/number-as-string, matches mirrorGeneration)
  • generatedAt (ISO-8601 UTC)
  • manifestDigest (sha256:… of mirror.json)
  • dsseDigest (sha256:… of mirror.dsse payload)
  • location (URI or offline path where bundle is staged)
  • rekorUUID (optional; present when transparency entry exists)

Behavior

  • Emitted by ExportCenter/Orchestrator when mirror bundle artifacts land in staging.
  • At-least-once; consumers must de-dup by (bundleId,generation).
  • No external fetches; payload entirely local/offline friendly.

Actions

  • Exporter Guild: add hook emission to bundle pipeline; include mirror.dsse.json header path in payload for CLI verification.
  • CLI Guild: subscribe to mirror.ready; surface manifest/dsse digests and location in stella mirror status.

Risks

  • Field names may shift with ExportCenter manifest v1.1; keep aliasing if needed.
  • Rekor optional; CLI should warn when absent but proceed with local verification.