Struct Ctx 

pub struct Ctx {
    pub target: Utf8PathBuf,
    pub repo: String,
    pub forge: Forge,
    pub host: Option<String>,
    pub required_check: Option<String>,
    pub cli: PathBuf,
    pub tech: Option<&'static str>,
    /* private fields */
}

One resolved run context.

Fields

target: Utf8PathBuf

The repository being set up.

repo: String

The project path on the forge.

forge: Forge

The forge the run acts on.

host: Option<String>

The remote host, where one was detected.

required_check: Option<String>

The value of --required-check, where given.

cli: PathBuf

The resolved forge CLI binary.

tech: Option<&'static str>

The detected technology, where the version file names one.

Implementations

impl Ctx

pub fn resolve( target: &Utf8PathBuf, repo_flag: Option<&str>, forge_flag: Option<&str>, required_check: Option<&str>, ) -> Result<Self, RkError>

Resolve detection, overrides, and the forge CLI in one pass, before any step runs.

Errors

Refuses when the target is missing, when no remote resolves and no override covers the gap, when the host is unrecognized, and when the forge CLI is not on PATH.

pub fn trunk(&self) -> &str

The one permanent branch this run asserts.

pub fn line_prefix(&self) -> &str

The release-line prefix this run asserts.

pub fn retired_branches(&self) -> &[String]

The long-lived branches this run’s single-trunk step retires.

pub const fn release_lines(&self) -> bool

Whether a full apply runs the release-line protection.

pub fn bot_app_id(&self) -> Option<&str>

The bot App’s public identifier this target states, where it does.

pub fn trunk_ruleset(&self) -> &str

The ruleset that protects the trunk.

pub fn tag_ruleset(&self) -> &str

The ruleset that makes published tags immutable.

pub fn lines_ruleset(&self) -> &str

The ruleset that protects the release lines.

pub fn title_check(&self) -> &str

The context the landed title job reports under.

pub const fn protection(&self) -> &Protection

The floored policy this target states, already judged at load.

pub fn self_hosted_gitlab(&self) -> bool

Whether this run targets a GitLab instance that is not gitlab.com, where registry trusted publishing cannot reach.

pub fn child_env(&self, step: &str) -> Vec<(OsString, OsString)>

The constructed environment a step receives. Secrets enter only for the step that consumes them; the caller records their handling.

pub fn secret_values() -> Vec<Zeroizing<Vec<u8>>>

The secret bytes a run must keep out of its own output: the values the environment carries. Every buffer is scrubbed on drop; none is ever logged or echoed.

Key material is not read here. The step that transmits a key adds the very bytes it sends, so the needle cannot describe one file while the child receives another.

Trait Implementations

impl Clone for Ctx

fn clone(&self) -> Ctx

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Ctx

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

Formats the value using the given formatter.