thomasdavis / thomasdavis/sshfighter.com

Question: authoritative runtime deployment attestation for replay provenance

Open
#30 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
26
Forks
3
Avg merge
15h 42m
Merged PRs (30d)
11

Description

Context

Issue #26 fixed the concrete sf-5/sf-6 mismatch: simulator exports now use the canonical runtime engine version, and the source documents that the version is a compatibility family rather than a unique build identifier.

For replay-backed experiments, one question remains: a public match records engine_version, and /api/health reports the same family, but materially different source/deployment profiles can share that value. From the public record alone, a consumer cannot always map a match or deployment epoch to an immutable source/build snapshot.

There may already be an authoritative deployment audit trail or an established pattern from the infrastructure used for this project or Donto. This issue is intended to discover and document that source of truth, not to assume a new implementation.

Maintainer questions

  1. Is an immutable deploy identifier already recorded today—for example a source commit, build/release ID, image digest, or deployment event log?
  2. Can that record reliably map a match timestamp or deployment epoch to the code that was running, including rollbacks or multiple workers?
  3. Should replay/training consumers use that existing audit trail, or would a stable, non-sensitive identifier be appropriate in /api/health, match metadata, or exports?
  4. If a public identifier is desirable, which deployment-provided value is authoritative? We should not guess an environment variable or synthesize an identifier in application code.

Desired outcome

  • Document the existing runtime/deployment source of truth, if one exists.
  • Clarify whether exact live-deploy attestation is intentionally internal or should be exposed to replay/training consumers.
  • If a code change is wanted, identify the authoritative input and expected semantics before implementation.

No combat, balance, or replay-format change is proposed here.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Begin with the public /api/health response, match records, and exports, then inspect the project's deployment and infrastructure records for immutable commit, build, image, or deployment identifiers. Document the authoritative source, its timestamp, rollback, and multi-worker mapping, and whether it should remain internal or be exposed to replay and training consumers.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
api, documentation, infrastructure
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.