stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
main
git.stella-ops.org/docs/features/dropped/mirror-orchestrator-hook-event.md

1.5 KiB
Raw Permalink Blame History

Mirror Orchestrator Hook Event (mirror.ready)

Module

AirGap

Status

PARTIALLY_IMPLEMENTED

Description

Defines the mirror.ready event payload {bundleId, generation, generatedAt, dsseDigest, manifestDigest, location} with optional rekorUUID, enabling CLI and export automation to consume mirror bundle readiness notifications.

What's Implemented

  • AirGap controller with event hooks: src/AirGap/StellaOps.AirGap.Controller/ -- state management and endpoints
  • Time hooks: src/AirGap/StellaOps.AirGap.Time/Hooks/ -- event hooks for time-related operations
  • Bundle catalog model: src/AirGap/StellaOps.AirGap.Importer/Models/BundleCatalogEntry.cs, BundleItem.cs -- bundle metadata with ID, generation, timestamps
  • Sync library: src/AirGap/__Libraries/StellaOps.AirGap.Sync/ -- bundle synchronization infrastructure
  • Source: SPRINT_0150_0001_0003_mirror_orch.md

What's Missing

  • The specific mirror.ready event with payload {bundleId, generation, generatedAt, dsseDigest, manifestDigest, location} may not be formalized as a named event
  • CLI/export automation consumption of mirror readiness notifications needs verification
  • Optional rekorUUID field in event payload needs confirmation

Implementation Plan

  • Define mirror.ready event type in eventing system
  • Implement event publication when mirror bundle is ready
  • Add CLI hook for consuming mirror.ready events
  • Add tests for event payload validation

Related Documentation

  • Source: SPRINT_0150_0001_0003_mirror_orch.md