Struct UpgradeArgs 

pub struct UpgradeArgs {
    pub target: Utf8PathBuf,
    pub profile: ProfileFlags,
    pub nix_packaging: Option<String>,
    pub reporting_policy: Option<String>,
    pub scorecard: Option<String>,
    pub code_scanning: Option<String>,
    pub stage: Option<Utf8PathBuf>,
    pub replace: Vec<String>,
    pub workflow_guards: Option<String>,
    pub workflow_only: bool,
    pub apply: bool,
    pub json: bool,
}

Take a landed target to this binary’s projection.

Flags resolve over configuration, and recorded answers stand where both are silent. Preview by default; --apply replaces every recorded generated file, preserves every seeded and state file, and rewrites the receipt last.

Fields

target: Utf8PathBuf

The landed repository to upgrade.

profile: ProfileFlags

The project profile and the Git workflow, each flag overriding the configured answer; the apply writes the answer back into the config. Omitted, the config answers first and the record is the fallback.

nix_packaging: Option<String>

Change the recorded Nix request: on adds the capability’s files and records it; off drops them from the record while the files stay on disk as the target’s own, like any file this binary stops shipping. Omitted, configuration precedes the recorded choice.

reporting_policy: Option<String>

Change the recorded reporting policy request: on lands SECURITY.md and records it; off drops it from the record while the file stays on disk as the target’s own.

scorecard: Option<String>

Change the recorded Scorecard request: on adds the workflow and records it; off drops it from the record while the file stays on disk as the target’s own, like any file this binary stops shipping. Omitted, configuration precedes the recorded choice.

code_scanning: Option<String>

Change the recorded code scanning provider: codeql or semgrep lands that provider’s workflow and records it; off drops it from the record while the file stays on disk as the target’s own. Omitted, configuration precedes the recorded choice.

stage: Option<Utf8PathBuf>

Land the answers a stage resolved, read from its receipt and never its bytes; refuses a stage another binary wrote or one taken for another target.

replace: Vec<String>

Save a copy of this conflict, then replace it: an unattributed file, or a recorded rendered file someone edited. Repeatable; every conflict not named still refuses.

workflow_guards: Option<String>

Change the recorded workflow guards: on keeps or adds their lines, glossary, and hooks, and off drops them. A record that predates the capability carries a pending answer, which this upgrade reports and answers on unless this flag says otherwise. Omitted, configuration precedes the recorded choice.

workflow_only: bool

Land the Git workflow and nothing of a release: a preset that sets profile.release.mode = "none", git.integration = "local", git.checkout_mode = "linked-worktree", and capabilities.workflow_guards = true, and records those four answers alone. A flag that contradicts one of them refuses before any write; a flag the preset does not set, such as --merge-form, combines with it.

apply: bool

Write the upgrade; without it every file’s action is listed and nothing is touched. rk stage is the full-byte comparison surface.

json: bool

Emit one JSON object on stdout instead of the human report.

Trait Implementations

impl Args for UpgradeArgs

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Debug for UpgradeArgs

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

Formats the value using the given formatter.

impl FromArgMatches for UpgradeArgs

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.