tess::diagnostics::FlowCounters Struct Reference

#include <tess/diagnostics/diagnostics.h>

Public Member Functions
constexpr auto	terminal () const noexcept -> std::uint64_t
	Sum of every terminal outcome bucket.
constexpr auto	admission_identity_holds () const noexcept -> bool
	Every offer was admitted, rejected, or coalesced — never lost.
constexpr auto	retention_identity_holds () const noexcept -> bool
	Every admitted item is terminal or still outstanding — never both.
void	reset () noexcept
	Returns the counters to their zero-initialized state.

Public Attributes
std::uint64_t	offered = 0
	Admission offers, including rejected and coalesced ones.
std::uint64_t	admitted = 0
	Offers accepted as new flow items.
std::uint64_t	rejected = 0
	Offers refused at the admission boundary.
std::uint64_t	coalesced_into_pending = 0
	Offers absorbed by an item that was already pending.
std::uint64_t	completed = 0
	Items that reached their intended result.
std::uint64_t	cancelled = 0
	Items explicitly cancelled by the caller.
std::uint64_t	superseded = 0
	Items replaced by a newer admission of the same slot or goal.
std::uint64_t	stale = 0
	Items whose result no longer satisfies its version requirement.
std::uint64_t	failed = 0
	Items that terminated in an error state.
std::uint64_t	dropped_after_admission = 0
	Admitted items discarded before reaching any other terminal state.
std::uint64_t	offered_work_units = 0
	Work units offered through explicitly bounded budgets.
std::uint64_t	consumed_work_units = 0
	Work units actually consumed by flow items.
std::uint64_t	outstanding_current = 0
	Admitted, non-terminal items right now.
std::uint64_t	outstanding_high_water = 0
	Highest simultaneous outstanding count observed.
std::uint64_t	inventory_tick_weighted = 0
	Sum over observed ticks of outstanding items times elapsed ticks.
std::uint64_t	residence_ticks_accumulated = 0
	Total admission-to-terminal ticks over terminalized items.
std::uint64_t	oldest_outstanding_age_ticks = 0
	Age in ticks of the oldest still-outstanding item, as last observed.

Detailed Description

Deterministic admission and terminal accounting for one bounded flow.

Plain ungated data, like EventStream rejection counts: flows update an attached accountant at the transition where each fact is known, so histories are never reconstructed from current state. Two conservation identities hold at every quiescent point; they are invariants, not tunable goldens. completed is non-monotonic in exactly one documented case: a produced result that later goes stale before retirement is reclassified from completed to stale so one admission lands in exactly one terminal bucket.

---

The documentation for this struct was generated from the following file:

• include/tess/diagnostics/diagnostics.h