Enum ContextSourceExclusionV1 

pub enum ContextSourceExclusionV1 {
    LifecycleNotLive {
        lifecycle: HarnessRunLifecycleV1,
    },
    NoBinding,
    NoActiveManagedSession,
    NodeIncarnationUnknown {
        node_id: HarnessSelectorV1,
        node_incarnation: HarnessSelectorV1,
        known_incarnations: Vec<HarnessSelectorV1>,
    },
    ManagedSessionRecordMismatch {
        record_id: HarnessSelectorV1,
        workspace_id: HarnessSelectorV1,
        instance_id: u64,
        generation: u64,
        node_has_records: u32,
    },
    ManagedSessionsPageTruncated {
        record_id: HarnessSelectorV1,
        page_len: u32,
        total: u32,
    },
    MonitorUnavailable,
    ProjectionNotLive {
        availability: ProjectionAvailabilityV1,
        freshness: ProjectionFreshnessV1,
        transport_incomplete: bool,
    },
    DurableNodeUnknown {
        node_id: HarnessSelectorV1,
    },
}

Names, with its compared inputs, the exact reason context_source_option (hatchery-harness-service::runtime) declined to surface a run as a context_sources candidate. Instrumentation only, never a policy decision – the admission logic itself is unchanged by this type’s existence; it only makes an already-silent exclusion observable from launch-options and the harness’s own logs (context source excluded). One variant per early exit in that function, Live and Durable branches alike; a Live-branch-only or Durable-branch-only condition says so in its own doc comment.

Variants

LifecycleNotLive

The run’s lifecycle is neither Running nor Waiting, and it carries no durable context pack (which would have taken the Durable branch instead of this lifecycle gate).

Fields

lifecycle: HarnessRunLifecycleV1

NoBinding

The run carries no binding at all – Live or Durable branch alike.

NoActiveManagedSession

The bound session identity is not Managed at all (Durable branch), or (Live branch) it is Managed with no active_session.

NodeIncarnationUnknown

Live branch only: no entry in the runtime inventory carries this run’s exact node_id + node_incarnation pair (the Durable branch re-resolves the node’s CURRENT incarnation by node_id alone instead; see DurableNodeUnknown). known_incarnations names the incarnation(s) the inventory DOES hold for that node_id, bounded at CONTEXT_SOURCE_EXCLUSION_KNOWN_INCARNATIONS_MAX.

Fields

node_id: HarnessSelectorV1

node_incarnation: HarnessSelectorV1

known_incarnations: Vec<HarnessSelectorV1>

ManagedSessionRecordMismatch

The matched node’s managed_sessions page carries no record whose record_id/workspace_id/active_binding (workspace, instance, generation) match the run’s binding, and that page was NOT cut for size – the record genuinely does not exist on this node right now. node_has_records is the page’s own length, for scale.

Fields

record_id: HarnessSelectorV1

workspace_id: HarnessSelectorV1

instance_id: u64

generation: u64

node_has_records: u32

ManagedSessionsPageTruncated

Same missing-record shape as ManagedSessionRecordMismatch, but the node’s managed_sessions_truncated flag was set: the page the harness received is a PREFIX of the node’s full record set, so the matching record may simply sit past that cut rather than genuinely be absent. page_len is the page’s own length, total the node’s full managed_session_count.

Fields

record_id: HarnessSelectorV1

page_len: u32

total: u32

MonitorUnavailable

Live branch only: execute_operator_monitor returned an error for this run.

ProjectionNotLive

Live branch only: the monitor projection resolved but is not live enough to route an export through right now.

Fields

availability: ProjectionAvailabilityV1

freshness: ProjectionFreshnessV1

transport_incomplete: bool

DurableNodeUnknown

Durable branch only: the pack’s node_id is not currently known by the runtime inventory at all (any incarnation), so there is no route to resolve the pack through right now.

Fields

node_id: HarnessSelectorV1

Implementations

impl ContextSourceExclusionV1

pub fn validate(&self) -> Result<(), HarnessOperatorApiError>

Trait Implementations

impl Clone for ContextSourceExclusionV1

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ContextSourceExclusionV1

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContextSourceExclusionV1

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ContextSourceExclusionV1

impl PartialEq for ContextSourceExclusionV1

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ContextSourceExclusionV1

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ContextSourceExclusionV1