Files
git.stella-ops.org/src/AirGap/StellaOps.AirGap.Time/AGENTS.md
2026-02-01 21:37:40 +02:00

1.5 KiB

StellaOps AirGap Time Guild Charter

Mission

Manage trusted time anchors and staleness budgets for sealed environments, ensuring deterministic behavior when external time sources are unavailable.

Scope

  • Parse signed time tokens from Mirror Bundles and validate signatures.
  • Persist time_anchor metadata and compute drift/staleness metrics.
  • Provide helpers for UI/API staleness badges and job gating.
  • Integrate with Notifications to alert on approaching drift thresholds.

Definition of Done

  • Test vectors for time tokens committed alongside verification code.
  • Drift calculations deterministic and configurable per tenant.
  • Documentation updates for docs/modules/airgap/guides/staleness-and-time.md with examples.

Required Reading

  • docs/modules/airgap/guides/airgap-mode.md
  • docs/modules/airgap/guides/staleness-and-time.md
  • docs/modules/platform/architecture-overview.md

Working Agreement

    1. Update task status to DOING/DONE in both correspoding sprint file /docs/implplan/SPRINT_*.md and the local TASKS.md when you start or finish work.
    1. Review this charter and the Required Reading documents before coding; confirm prerequisites are met.
    1. Keep changes deterministic (stable ordering, timestamps, hashes) and align with offline/air-gap expectations.
    1. Coordinate doc updates, tests, and cross-guild communication whenever contracts or workflows change.
    1. Revert to TODO if you pause the task without shipping changes; leave notes in commit/PR descriptions for context.