Struct Args 

pub struct Args {
    pub title: Option<String>,
    pub entity_type: Option<String>,
    pub mem: Option<String>,
    pub sections: Vec<String>,
    pub metadata: Vec<String>,
    pub relations: Vec<String>,
    pub anchors: Vec<String>,
    pub from: Option<PathBuf>,
    pub dry_run: bool,
    pub note: Option<String>,
}

Fields

title: Option<String>

Entity title. Required unless --from is given.

entity_type: Option<String>

Entity type (e.g. spec, memo, concept). Required unless --from is given.

mem: Option<String>

Mem name. Defaults to the first writable mem.

sections: Vec<String>

Section content: repeatable --section key=value. Body wiki-links must take slug-form ([[idempotency]], not the title-case [[Idempotency]]) — a non-slug target refuses with INVALID_WIKI_LINK_TARGET carrying a proposed_slug to retry with.

metadata: Vec<String>

Metadata override: repeatable --metadata key=value.

relations: Vec<String>

Initial relationship: repeatable --relation TYPE:target-id. Works on both workspace shapes. A target that does not exist yet is materialised as a forward-reference stub, same as on the MCP surface.

anchors: Vec<String>

Provenance anchor: repeatable --anchor '<json>', each a JSON object of the anchor shape ({ "artifact": "...", "grain": "file", "class": "anchored", "hash": "...", "hash_stability": "stable" }). Written into the mem-branch anchors sidecar in the same commit as the entity. A malformed anchor refuses INVALID_ANCHOR. Ignored when --from is given (the file’s anchors[] is authoritative).

from: Option<PathBuf>

JSON file matching the MCP memstead_create args shape. If set, all --title / --type / --section / --metadata / --relation / --anchor flags are ignored (the file is the single source of truth). --note still applies (winning over the file’s note), and --dry-run ORs with the file’s dry_run — same semantics as update --from, so one template feeds both commands. The JSON type field is entity_type (not type), matching the response envelopes — a previous --json response pipes back in unchanged.

dry_run: bool

Preview only — validate and compute the result without writing to disk, mutating the store, or producing a commit. Response carries the prospective id / file_path / content_hash plus any warnings. MEM-REPO WORKSPACES ONLY — refused with INVALID_INPUT on the filesystem-mem workspace memstead quickstart produces.

note: Option<String>

Agent-authored provenance note (≤280 chars, one sentence describing why this mutation happened). Lands in the per-mem commit body between the mechanical subject line and the provenance trailers. When [mutations].require_notes = true in workspace config a missing note adds a NOTE_MISSING warning to the response (the mutation still commits). When --from also carries a note, this flag takes precedence.

Trait Implementations

impl Args for Args

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 CommandFactory for Args

fn command<'b>() -> Command

Build a Command that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a Command that can update self.

impl Debug for Args

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

Formats the value using the given formatter.

impl FromArgMatches for Args

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.

impl Parser for Args

fn parse() -> Self

Parse from std::env::args_os(), exit on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.