Struct FluxResourceRef 

pub struct FluxResourceRef {
    pub api_version: String,
    pub kind: String,
    pub name: String,
    pub namespace: String,
    pub ready: bool,
    pub message: Option<String>,
    pub last_check: Option<DateTime<Utc>>,
}

Reference to a FluxCD resource emitted as part of this Process.

Fields

api_version: String

kind: String

name: String

namespace: String

ready: bool

message: Option<String>

last_check: Option<DateTime<Utc>>

Implementations

impl FluxResourceRef

pub fn fetch_coords(&self) -> (&str, &str, &str, &str)

Pure typed projection of the four fetch coordinates (namespace, api_version, kind, name) every consumer that dispatches this persisted reference through kube-rs’s dynamic- object surface splats by hand pre-lift. The 4-tuple binds the slot order at ONE typed accessor so a copy-paste at any downstream consumer cannot swap two adjacent &str slots in the fetch call.

Peer projection to crate::k8s_wire_identity::K8sWireIdentity on the static- identity axis: [K8sWireIdentity] carries a (&'static str, &'static str) closed-set variant’s pair for emit-time (RENDER phase) composition; this method carries the full (ns, apiVersion, kind, name) 4-slot borrow for fetch-time (VERIFY / ATTEST-heartbeat) composition where the ref’s payload comes back off the persisted ProcessStatus.flux_resources slice with owned Strings rather than static literals. The two primitives partition the fetch axis by whether the caller starts from a closed-set variant (emit-time) or a persisted status slice (fetch-time).

Pre-lift the 5-slot ssapply::fetch(client, &r.namespace, &r.api_version, &r.kind, &r.name) splat was hand-authored at TWO sites past the ★★ PRIME-DIRECTIVE ≥ 2 duplication threshold in tatara-reconciler::phase_machine:

• handle_running — the VERIFY-phase per-ref readiness probe that populates the updated FluxResourceRef slice with ready + message + last_check.
• handle_attested — the ATTEST-heartbeat drift detector that short-circuits on the first non-Ready ref.

Both sites splatted the SAME four &r.X field borrows in the SAME order into raw ssapply::fetch. A copy-paste that swapped two adjacent &str slots (&r.api_version and &r.kind are both strings that look interchangeable to a mechanical substitution) would silently 404 at wire time and diagnose as a broken CRD rather than as slot skew at the callsite. Post-lift each site names the ref ONCE and unpacks it through this ONE projection; the slot order binds structurally at the tuple return so a caller cannot desync one axis.

A future addition (a case-fold normalization on the group, a virtual-cluster prefix rewrite for multi-tenancy, a generateName fallback on the name slot, a cluster-cache short-circuit inserted between the projection and the fetch call) lands at this ONE method and every downstream fetch consumer inherits the upgrade mechanically — no per-site edit at handle_running / handle_attested / any future kenshi- runner / mirror-audit / drift-probe consumer that grows a third consumer.

Return-order pin lives at [tests::flux_resource_ref_fetch_coords_binds_slots_by_position] so a regression that swapped namespace and api_version (both String, same type) inside the tuple constructor fails- loudly here rather than as a silent wire-time 404 at every downstream fetch consumer.

Theory grounding: THEORY.md §II.1 invariant 5 (composition preserves proofs — the 4-tuple slot order binds at ONE typed projection so a regression across the two fields of the same String type fails at the projection’s positional pin rather than at every downstream fetch consumer). THEORY.md §VI.1 (generation over composition — the 5-slot splat recurred at two hand-authored sites past the ≥ 2 duplication trigger, and is lifted to ONE typed borrow-projection here).

Trait Implementations

impl Clone for FluxResourceRef

fn clone(&self) -> FluxResourceRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FluxResourceRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FluxResourceRef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for FluxResourceRef

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl Serialize for FluxResourceRef

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

where __S: Serializer,

Serialize this value into the given Serde serializer.