Files
git.stella-ops.org/docs/updates/2025-10-19-docs-guild.md

869 B

Docs Guild Update — 2025-10-19

Subject: Event envelope reference & canonical samples Audience: Docs Guild, Platform Events, Runtime Guild

  • Extended docs/events/README.md with envelope field tables, offline validation commands, and guidance for optional payload fields.
  • Added canonical sample payloads under docs/events/samples/ for scanner.report.ready@1, scheduler.rescan.delta@1, and attestor.logged@1; validated them with ajv-cli to match the published schemas.
  • Documented the validation loop so air-gapped operators can mirror the CI checks before rolling new event versions.

Next steps:

  • Platform Events to embed the canonical samples into their contract tests.
  • Runtime Guild checklist for quieted finding counts & progress hints published in docs/runtime/SCANNER_RUNTIME_READINESS.md; gather stakeholder sign-off.