Skip to content

Replay and Audit Model

Replay is not a debugging feature.

In Forge Pool, replay is part of execution truth.

It exists so workloads can be:

  • reproduced
  • audited
  • defended
  • inspected over time

A distributed result without replay is operationally weaker, legally weaker, and technically weaker than a replayable one.


Replay as a First-Class Property

Every successful Kernel execution must produce replay-grade truth surfaces.

That does not always mean one identical public token format in every deployment.

It does mean the system must preserve enough execution identity to support deterministic reproduction and audit.

Replay is therefore a first-class execution concern, not a convenience layer after the fact.


What Replay Requires

Replay requires preservation of the following categories of truth:

  • original execution contract
  • workload identity
  • seed behavior
  • shard planning truth
  • reduction truth
  • artifact references where needed
  • sufficient execution metadata for rerun and audit

At minimum, replay depends on:

  • op.name
  • op.version
  • op.profile
  • canonical args
  • seed mode and root seed behavior
  • relevant policy semantics
  • reducer semantics
  • shard metadata sufficient for reconstruction

Replay Goals

A valid replay model must support:

  • deterministic rerun
  • post-hoc audit
  • incident review
  • compliance-grade traceability
  • long-term inspection of how a result was produced

Replay is therefore both an engineering capability and a governance capability.


Replay Artifacts

Typical replay-grade surfaces may include:

  • root seed
  • canonical args hash
  • workload identity
  • shard execution manifest
  • per-shard seed references
  • result hashes
  • verification metadata
  • artifact references and hashes
  • execution metrics snapshots

The exact representation may vary.

The replay truth requirement does not.


Replay and Seeds

Replay is impossible without stable seed semantics.

If the original request used:

Explicit seed mode

The same explicit root seed must be preserved.

Derived seed mode

The same derivation logic and canonical request identity must be preserved so the same root seed can be reconstructed.

In both cases, shard seed derivation must remain reproducible.


Replay and Artifacts

Some workloads require artifacts for complete replay or audit.

Examples may include:

  • result JSON
  • execution manifests
  • verification reports
  • intermediate references
  • workload-specific artifacts tied to reduction truth

Artifacts used for replay should be:

  • immutable
  • hash-addressed where applicable
  • version-aware
  • sufficient for later inspection

Replay must survive time, not just immediate retry windows.


Replay vs Retry

Replay is not the same as retry.

  • Retry attempts execution again after operational failure
  • Replay reproduces a previously defined execution truth for verification or audit

Retry is operational.

Replay is doctrinal.


Replay vs Logging

Replay is not equivalent to “we logged some metadata.”

Logs may help investigation.

Replay requires preserved execution truth.

If the system can describe what happened but cannot reproduce or validate it, replay is incomplete.


Long-Term Integrity

Replay data should preserve long-term trust characteristics.

That means replay surfaces should be:

  • versioned
  • hashed
  • durable enough for audit needs
  • resistant to silent mutation

A replay system that only works immediately after execution is not sufficient for high-trust workloads.


Why Replay Matters

Forge Pool is built for domains where execution must be more than fast.

It must be explainable later.

Replay is what makes that possible.

Without replay:

  • audit becomes narrative instead of proof
  • distributed trust weakens
  • verification loses long-term value
  • execution history becomes harder to defend

With replay:

  • results remain inspectable
  • disputes can be resolved
  • correctness can be revisited
  • the system remains accountable over time

Final Note

Replay is part of the Planetary Kernel promise.

It is how Forge turns distributed execution from an event into a durable truth surface.