stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 3 Releases Wiki Activity
Files
a3b2f30a11672d42fc1f9d45125aa78035055016
git.stella-ops.org/src/Replay/AGENTS.md

1.1 KiB
Raw Blame History

Replay Module Charter

Mission

  • Capture and verify deterministic replay manifests and tokens for audit reproducibility.

Responsibilities

  • Maintain replay manifest schemas, hashing, and validation.
  • Provide WebService APIs for token issuance and verification.
  • Ensure content-addressed references to inputs and outputs.
  • Keep replay logs and storage deterministic and auditable.

Required Reading

  • docs/README.md
  • docs/07_HIGH_LEVEL_ARCHITECTURE.md
  • docs/modules/platform/architecture-overview.md
  • docs/modules/replay/architecture.md
  • docs/modules/replay/replay-proof-schema.md

Working Agreement

  • Use TimeProvider and IGuidGenerator for timestamps and ids.
  • UTC ISO-8601 timestamps with invariant formatting.
  • Hash inputs with canonical JSON and shared hash helpers.
  • No network calls in core logic; all external access via injected clients.
  • Propagate CancellationToken.

Testing Strategy

  • Unit tests for manifest validation and hash determinism.
  • Integration tests for WebService endpoints and token flows.
  • Replay tests verifying identical inputs yield identical outputs.