Enum Command 

pub enum Command {
    Init {
        force: bool,
    },
    Import {
        mode: ImportModeArg,
        source: Option<String>,
        force: bool,
    },
    AdoptOverlay {
        overlay_record: PathBuf,
        force: bool,
    },
    Validate,
    ValidateIndex {
        index_root: PathBuf,
    },
    PromotionReport {
        index_root: PathBuf,
        apply: bool,
        limit: Option<usize>,
        json: bool,
        verbose: bool,
    },
    Query {
        path: String,
        json: bool,
        raw: bool,
    },
    Generate {
        check: bool,
    },
    Doctor {
        json: bool,
    },
    Manage {
        surface: PreviewSurfaceArg,
        adopt: bool,
    },
    Preview {
        surface: Option<PreviewSurfaceArg>,
        all: bool,
        json: bool,
    },
    Trust {
        json: bool,
    },
    AdoptionStatus {
        json: bool,
    },
    Ci {
        command: CiCommand,
    },
    Claim {
        path: PathBuf,
        json: bool,
    },
    ClaimInit {
        host: String,
        owner: String,
        repo: String,
        claim_id: String,
        claimant_name: String,
        asserted_role: String,
        contact: Option<String>,
        record_sources: Vec<String>,
        canonical_repo_url: Option<String>,
        review_md: bool,
        force: bool,
    },
    ClaimFromNative {
        index_root: PathBuf,
        claim_id: String,
        claimant_name: String,
        asserted_role: String,
        contact: Option<String>,
        review_md: bool,
        force: bool,
    },
    ClaimEvent {
        path: PathBuf,
        kind: ClaimEventKindArg,
        actor: String,
        summary: String,
        corrected_state: Option<CorrectedClaimStateArg>,
        canonical_record_path: Option<String>,
        canonical_mirror_path: Option<String>,
    },
    ClaimSubmitNative {
        index_root: PathBuf,
        claim_id: String,
        actor: String,
        summary: String,
    },
    ClaimAcceptNative {
        index_root: PathBuf,
        path: Option<PathBuf>,
        claim_id: Option<String>,
        actor: String,
        summary: String,
    },
    Public {
        command: PublicCommand,
    },
}

Variants

Init

Initialize a canonical root .repo scaffold.

Fields

force: bool

Overwrite an existing root .repo.

Import

Import conventional repository surfaces into a dotrepo record.

Fields

mode: ImportModeArg

Record mode for the imported manifest.

source: Option<String>

Explicit repository source URL for overlays.

force: bool

Overwrite previously imported artifacts.

AdoptOverlay

Bootstrap a native .repo from an existing public overlay record.

Fields

overlay_record: PathBuf

Path to an overlay record.toml from the public index.

force: bool

Overwrite an existing root .repo.

Validate

Validate only the root .repo or root record.toml.

ValidateIndex

Validate a public index tree rooted at index/.

Fields

index_root: PathBuf

Index root to validate.

PromotionReport

Analyze index records for promotion eligibility to verified status.

Fields

index_root: PathBuf

Index root to analyze.

apply: bool

Apply eligible draft/imported/inferred promotions after reporting.

limit: Option<usize>

Maximum number of promotions to apply.

json: bool

Emit the full report as JSON.

verbose: bool

Show per-record details including blockers.

Query

Query one field from the selected record, preserving trust-aware selection in --json.

Fields

path: String

Dot-path such as repo.name or record.trust.provenance.

json: bool

Emit the full conflict-aware query report as JSON.

raw: bool

Emit only the selected scalar value. Refuses when competing records exist.

Generate

Render generated compatibility surfaces or fail when they drift.

Fields

check: bool

Check generated surfaces for drift without writing files.

Doctor

Inspect unmanaged conventional files at the repository root.

Fields

json: bool

Emit the full doctor report as JSON.

Manage

Adopt one supported Markdown surface into managed-region sync.

Fields

surface: PreviewSurfaceArg

Conventional surface to manage.

adopt: bool

Convert the existing file into a managed-region file.

Preview

Preview how dotrepo would render or replace one managed surface.

Fields

surface: Option<PreviewSurfaceArg>

Conventional surface to preview.

all: bool

Preview every supported surface.

json: bool

Emit the full preview report as JSON.

Trust

Inspect trust, authority handoff, and competing records for one repository identity.

Fields

json: bool

Emit the full conflict-aware trust report as JSON.

AdoptionStatus

Summarize native adoption readiness for the current repository.

Fields

json: bool

Emit the full adoption readiness report as JSON.

Ci

Scaffold CI for the canonical native-repo maintainer loop.

Fields

command: CiCommand

Claim

Inspect one maintainer-claim directory from the index.

Fields

path: PathBuf

Claim directory relative to –root.

json: bool

Emit the full claim inspection report as JSON.

ClaimInit

Scaffold a draft maintainer-claim directory for one index repository.

Fields

host: String

Repository host under index_root/repos////.

owner: String

Repository owner under index_root/repos////.

repo: String

Repository name under index_root/repos////.

claim_id: String

Claim directory name under claims//.

claimant_name: String

Claimant display name recorded in claim.toml.

asserted_role: String

Claimed repository role, such as maintainer.

contact: Option<String>

Optional claimant contact detail.

record_sources: Vec<String>

Additional record source URLs tied to this claim.

canonical_repo_url: Option<String>

Optional canonical repository URL for the claim target.

review_md: bool

Create a placeholder review.md next to claim.toml.

force: bool

Replace an existing empty scaffold, but never overwrite event history.

ClaimFromNative

Scaffold a maintainer claim from the current native .repo.

Fields

index_root: PathBuf

Index root where the overlay claim directory should be created.

claim_id: String

Claim directory name under claims//.

claimant_name: String

Claimant display name recorded in claim.toml.

asserted_role: String

Claimed repository role, such as maintainer.

contact: Option<String>

Optional claimant contact detail.

review_md: bool

Create a placeholder review.md next to claim.toml.

force: bool

Replace an existing empty scaffold, but never overwrite event history.

ClaimEvent

Append a new claim event and update the current claim state.

Fields

path: PathBuf

Claim directory relative to –root.

kind: ClaimEventKindArg

Event kind to append.

actor: String

Actor label recorded in the event.

summary: String

Short event summary recorded in the audit trail.

corrected_state: Option<CorrectedClaimStateArg>

Optional corrected current state when kind=corrected.

canonical_record_path: Option<String>

Optional canonical .repo path recorded for accepted handoff.

canonical_mirror_path: Option<String>

Optional canonical mirror record path recorded for accepted handoff.

ClaimSubmitNative

Append a submitted claim event with the claim path derived from the current native .repo.

Fields

index_root: PathBuf

Index root containing the claim directory.

claim_id: String

Claim directory name under claims//.

actor: String

Actor label recorded in the event.

summary: String

Short event summary recorded in the audit trail.

ClaimAcceptNative

Append an accepted claim event with canonical links from the current native .repo.

Fields

index_root: PathBuf

Index root containing the claim directory.

path: Option<PathBuf>

Claim directory relative to –index-root.

claim_id: Option<String>

Claim directory name under claims/; derives path from repo.homepage.

actor: String

Actor label recorded in the event.

summary: String

Short event summary recorded in the audit trail.

Public

Inspect or export public read-only index responses.

Fields

command: PublicCommand

Trait Implementations

impl FromArgMatches for Command

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<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Command

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

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

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

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

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand