Struct SyncArgs 

pub struct SyncArgs {
    pub recursive: bool,
    pub pack_root: Option<PathBuf>,
    pub workspace: Option<PathBuf>,
    pub dry_run: bool,
    pub quiet: bool,
    pub no_validate: bool,
    pub ref_override: Option<String>,
    pub only: Vec<String>,
    pub force: bool,
    pub parallel: Option<u32>,
}

Fields

recursive: bool

Recurse into child packs.

pack_root: Option<PathBuf>

Pack root. Directory holding .grex/pack.yaml, or the YAML file itself. When omitted, sync prints the legacy M1 stub and exits 0.

workspace: Option<PathBuf>

Override the workspace root. Defaults to the parent pack’s root directory; children resolve as flat siblings.

dry_run: bool

Plan actions without touching the filesystem.

quiet: bool

Suppress per-action log lines.

no_validate: bool

Skip plan-phase validators. Debug-only escape hatch.

ref_override: Option<String>

Override the default ref for every pack in this sync invocation. Accepts a branch, tag, or commit SHA. Empty strings are rejected.

only: Vec<String>

Restrict sync to packs whose workspace-relative path (or name) matches the glob. Repeat the flag to OR-combine multiple patterns (standard */**/? semantics). Non-matching packs are skipped entirely — no action execution, no lockfile write.

force: bool

Re-execute every pack even when its actions_hash is unchanged from the prior lockfile. Overrides the M4-B skip-on-hash short-circuit; dry-run semantics are unchanged.

parallel: Option<u32>

Max parallel pack ops during this sync run (feat-m6-1).

Semantics:

• Absent → default num_cpus::get() resolved in verbs::sync.
• 0 → unbounded (Semaphore::MAX_PERMITS).
• 1 → serial fast-path (preserves pre-M6 wall-order).
• 2..=1024 → bounded parallel.

Env fallback: GREX_PARALLEL is honoured only when the flag is absent. Clap reads the env var automatically via env.

Distinct from the global --parallel on GlobalFlags; that knob is documented as the harness-level worker cap and rejects 0. Sync parallelism uses 0 as the “unbounded” sentinel per .omne/cfg/concurrency.md.

Trait Implementations

impl Args for SyncArgs

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 SyncArgs

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

Formats the value using the given formatter.

impl FromArgMatches for SyncArgs

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.