Struct Requestor 

pub struct Requestor {
    pub kind: String,
    pub repo: Option<String>,
    pub branch: Option<String>,
    pub pr_number: Option<u64>,
    pub sha: Option<String>,
    pub pr_labels: Vec<String>,
    pub actor: Option<String>,
}

Identity + routing context for a request.

Fields

kind: String

Discriminator: "github-pr", "manual", "ci-run", "scheduled", … The wire shape is open by design — operators may register their own kinds and the crate::pool::PoolSelector matches on raw string equality. The substrate’s own emitters stamp one of the four canonical kebab-case kinds enumerated by RequestorKind::ALL; Requestor::known_kind projects the open wire field through that closed-set view at ONE site so future kind-keyed consumers (pool dashboards, completion lists, audit-trail classifiers) sweep the typed variants without re-implementing match self.kind.as_str() arm-by-arm. Sibling shape to crate::receipt::ReceiptEnvelope::known_kind.

repo: Option<String>

Optional repo identifier (e.g., "pleme-io/demo-app"). Matched against PoolSelector.repos.

branch: Option<String>

Optional branch name. Matched against PoolSelector.branches.

pr_number: Option<u64>

Optional PR number (for kind: github-pr). Surfaces in printcolumns + audit.

sha: Option<String>

Optional commit SHA (for kind: github-pr or ci-run). Stamped onto the allocated Process for traceability.

pr_labels: Vec<String>

PR / commit labels — matched as a subset against PoolSelector.prLabels.

actor: Option<String>

Free-form actor — username, CI runner ID, etc.

Implementations

impl Requestor

pub fn known_kind(&self) -> Option<RequestorKind>

Decode Self::kind into the typed RequestorKind variant when the wire string matches one of the four substrate-emitted canonical kebab-case kinds; None when the kind is an operator-registered open string (the schema is open by design — every allocation remains a valid allocation, but only typed kinds participate in closed-set dispatch). The (open String, closed-typed view) split lets future kind-keyed consumers (pool-selector classifiers, dashboard completion, audit-trail classifiers) sweep the typed variants without touching the open-by-design wire shape. Lifted as the canonical decode site so no consumer re-implements the match self.kind.as_str() arm- by-arm — the closed-set sweep happens through [RequestorKind::from_str] at ONE site. Sibling shape to crate::receipt::ReceiptEnvelope::known_kind.

pub fn kind_only(kind: impl Into<String>) -> Self

The canonical minimal Requestor composer — binds only the single caller-varying Self::kind slot and leaves the six-slot default tail (repo = None, branch = None, pr_number = None, sha = None, pr_labels = vec![], actor = None) at ONE substrate owner. The lift of the 9-line Requestor { kind: <lit>.into(), repo: None, branch: None, pr_number: None, sha: None, pr_labels: vec![], actor: None } incantation past the ★★ PRIME-DIRECTIVE ≥ 2 duplication threshold — pre-lift the SAME kind-only fixture shape recurred at TEN workspace-wide fixture sites (six inside crate::allocation’s own test module — the known_kind_decodes_built_requestors sweep, the known_kind_returns_none_for_open_kinds open-kind pin, the alloc_with_phase / alloc_without_status observers on the phase axis, the bound_pool observer on the routing axis, the expires_at observer on the TTL axis, and the allocation_spec_omits_optional_fields wire-shape pin; three inside [crate::lib]’s pin fixtures (the alloc_fixture + two empty_alloc_spec helpers on the coordinate / annotation axes)).

impl Into<String> on the argument accepts every pre-lift caller shape verbatim without an argument recast:

• Requestor::kind_only("manual") — the operator-authored default fixture, matching the pre-lift kind: "manual".into().
• Requestor::kind_only("github-pr") — the GitHub-webhook fixture, matching the pre-lift kind: "github-pr".into().
• Requestor::kind_only(RequestorKind::GithubPr) — the typed-round-trip callsite, matching the pre-lift kind: k .into() where k: RequestorKind composes through the From<RequestorKind> for String bridge.
• Requestor::kind_only("operator-custom-kind") — the open-kind pin, matching the pre-lift kind: "operator-custom-kind".into().

The six-slot default tail is the SAFE minimal shape: every crate::pool::PoolSelector filter sees “no repo constraint, no branch constraint, no PR labels” and matches every pool (post-lift a callsite that legitimately overrides a slot lands the override at its own site via struct-update on top of kind_only). A future addition to Requestor — a new optional slot (e.g. a run_id for CI kinds, an email for scheduled kinds, a cluster scoping override) — lands at ONE primitive body and every fixture / default-shape callsite inherits the upgrade mechanically. Pre-lift a new field would have broken all TEN callsites (each holds an exhaustive struct literal); post-lift only sites that legitimately override the new slot need to name it.

Sibling substrate primitives on the same “bind-the-required- slots-only” axis: crate::intent::AplicacaoIntent::chart_only (Aplicacao chart-pointer-only composer; the 7-slot Aplicacao counterpart), crate::pool::PoolSpec::with_template (Pool template-only composer; the 11-slot Pool counterpart), and [crate::spec::ProcessSpec::gate_compute_defaults] (Process zero-arg-fixture composer; the 12-slot Process counterpart).

Trait Implementations

impl Clone for Requestor

fn clone(&self) -> Requestor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Requestor

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Requestor

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Requestor

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 Requestor

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

where __S: Serializer,

Serialize this value into the given Serde serializer.