OptionalauditOptionalauditRequired when audit is set; contains stable engine/account/session metadata.
OptionalconvergenceThe signed convergence policy governing branch selection and the rollback
horizon (maxRewindCommits). Defaults to DEFAULT_CONVERGENCE_POLICY.
Keep that finite default for production. Infinity is an explicit
debugging/forensics choice that can retain unbounded fork evidence.
The horizon does not guarantee full-history tree pruning. Validated on construction.
OptionalhistoryA pre-populated full-fork history tree, rehydrated from persistence. When omitted the tree is seeded with the current tip as its root and grows as commits arrive.
OptionalingestionTuning for the persistent ingestion pool — undecryptable events held and retried as the history tree grows, instead of being dropped. Defaults to a size- and epoch-age-bounded pool.
OptionallifecycleDurable lifecycle records shared with terminal settlement.
OptionalnowInjectable monotonic clock (ms) for bounded convergence passes. Defaults
to performance.now(); tests pass a fake clock for determinism.
OptionalonLifecycle or derived convergence inputs changed; read current getters.
OptionalonSynchronous terminal fence before exposing the selected state to observers.
OptionalonCalled once the quiescence window elapses after convergence-relevant input, so the owner can re-check MarmotGroupEngine.convergenceStatus and release any queued outbound work (B5). The engine itself holds no outbound queue.
OptionalonOptionalretainedThe bounded convergence window (canonical states + applied commits within the rollback horizon), derived from the history tree on load. When omitted it is seeded with only the current tip (no past-epoch rewind until new commits accrue). Never persisted separately — the tree is the source.
OptionalschedulerInjectable timer for the settle-check; defaults to setTimeout (B5).
OptionalsettlementQuiescence window (ms) before a convergence pass may be treated as settled
(convergence.md settlementQuiescenceMs). Defaults to the profile-1 value.
Optional forensic audit sink. Omitted by default; audit logging is app opt-in.