Files
git.stella-ops.org/docs/updates/2025-11-12-notify-attestation-templates.md
master 61f963fd52
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Implement ledger metrics for observability and add tests for Ruby packages endpoints
- Added `LedgerMetrics` class to record write latency and total events for ledger operations.
- Created comprehensive tests for Ruby packages endpoints, covering scenarios for missing inventory, successful retrieval, and identifier handling.
- Introduced `TestSurfaceSecretsScope` for managing environment variables during tests.
- Developed `ProvenanceMongoExtensions` for attaching DSSE provenance and trust information to event documents.
- Implemented `EventProvenanceWriter` and `EventWriter` classes for managing event provenance in MongoDB.
- Established MongoDB indexes for efficient querying of events based on provenance and trust.
- Added models and JSON parsing logic for DSSE provenance and trust information.
2025-11-13 09:29:09 +02:00

1.9 KiB
Raw Blame History

2025-11-12 Notifications Attestation Template Suite

Summary

  • Introduced the canonical tmpl-attest-* template family covering verification failures, expiring attestations, key rotations, and transparency anomalies.
  • Synchronized overview, rules, and architecture docs so operators, rule authors, and implementers share the same guidance for attestation-triggered notifications.
  • Captured Offline Kit expectations and helper usage so the upcoming NOTIFY-ATTEST-74-002 wiring work has stable artefacts to reference.

Details

  • docs/notifications/templates.md now includes Section7 with required fields, helper references, Slack/Email/Webhook samples, and Offline Kit packaging notes for the attestation lifecycle templates.
  • Baseline exported templates for each required channel now live under offline/notifier/templates/attestation/*.template.json so Offline Kit consumers inherit the canonical payloads immediately.
  • docs/notifications/overview.md highlights that template capabilities include the attestation suite and reiterates determinism requirements around the tmpl-attest-* keys.
  • docs/notifications/rules.md adds Section4.0, mandating the new template keys for attestor.* and authority.keys.* events so rules do not drift.
  • docs/notifications/architecture.md references the template suite inside the rendering pipeline description, reminding service owners to populate attestation context fields.
  • Sprint trackers (SPRINT_170_notifications_telemetry.md, SPRINT_171_notifier_i.md) note the documentation progress for NOTIFY-ATTEST-74-001.

Follow-ups

  • Finalise the attestation event schema on 20251113 so the documented templates can be localised and promoted to Offline Kits.
  • Export the new templates into Offline Kit manifests (offline/notifier/templates/attestation/) once schemas lock.
  • Update rule/controller defaults so attestation-triggered rules reference the documented template keys by default.