Struct Args 

pub struct Args {

    pub id: Option<String>,
    pub expected_hash: Option<String>,
    pub auto_hash: bool,
    pub force: bool,
    pub sections: Vec<String>,
    pub append: Vec<String>,
    pub patch: Vec<String>,
    pub patch_all: Vec<String>,
    pub metadata: Vec<String>,
    pub metadata_unset: Vec<String>,
    pub declare_relations: Vec<String>,
    pub anchors: Vec<String>,
    pub anchors_unset: Vec<String>,
    pub dry_run: bool,
    pub from: Option<PathBuf>,
    pub note: Option<String>,
}

Fields

id: Option<String>

Full entity ID (e.g. specs--my-entity). Required unless --from is given.

expected_hash: Option<String>

Hash from memstead entity <id> (the _hash field). Required unless --auto-hash or --force is given. With --from, this flag overrides the file’s expected_hash field and enforces CAS exactly as on the inline path.

auto_hash: bool

Refetch the current hash immediately before writing. Convenient for interactive use; accepts the race window between the refetch and the write.

force: bool

Skip the hash check entirely (explicit overwrite).

sections: Vec<String>

Replace 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.

append: Vec<String>

Append to section content: repeatable --append key=value.

patch: Vec<String>

Find-and-replace inside a section: repeatable --patch key=OLD=>NEW. Use => (two chars) as the separator between old and new. Exact match of the first occurrence; use --patch-all to replace every occurrence.

patch_all: Vec<String>

Replace every occurrence of OLD in the section — sibling of --patch. Repeatable --patch-all key=OLD=>NEW.

metadata: Vec<String>

Metadata field: repeatable --metadata key=value.

metadata_unset: Vec<String>

Remove a metadata field: repeatable --metadata-unset KEY. Silent no-op if the key is absent; errors on read-only fields (mem/id/type plus the engine-stamped created_date/last_modified) or schema-required fields.

declare_relations: Vec<String>

Atomic batched relation declaration: repeatable --declare-relations REL_TYPE:TARGET_ID. Each entry is validated like an individual memstead relate call (schema-shape, cross-mem policy, target-id grammar) and appended to the entity’s relations BEFORE the strict wiki-link/relation validator runs. Lets the agent add [[target]] body wiki-links AND declare the backing relation in one memstead update call without an interleaved memstead relate. Absent Write-mem targets are auto-stubbed identically to memstead relate’s add path. Each successful declaration is echoed in the response’s relations_declared (with target_was_stubbed flagging the auto-stub case).

anchors: Vec<String>

Provenance anchor: repeatable --anchor '<json>', each a JSON object of the anchor shape. Written into the mem-branch anchors sidecar in the same commit as the update; a malformed anchor refuses INVALID_ANCHOR. An update carrying only --anchor (no section/metadata change) still commits the sidecar. Conflicts with --from (the file’s anchors[] is authoritative there).

anchors_unset: Vec<String>

Explicit anchor removal: repeatable --anchor-unset '<json>', each a JSON object { "artifact": "…" } optionally narrowed by "grain" and/or "class" — a bare artifact removes every anchor on it. Applied BEFORE the --anchor merge in the same commit (anchors merge; writing never removes an anchor not named here). Unsetting a nonexistent target is a no-op. A malformed selector refuses INVALID_ANCHOR. Conflicts with --from (the file’s anchors_unset[] is authoritative there).

dry_run: bool

Preview what would change without writing. Applies on both the inline and --from paths; with --from it forces a dry run even when the file’s dry_run field is absent or false.

from: Option<PathBuf>

JSON file matching MCP memstead_update args shape. The file is the single source of the mutation content — the content flags (--section / --append / --patch / --patch-all / --metadata / --metadata-unset / --declare-relations / --anchor / --anchor-unset) conflict with --from rather than being silently ignored. The flags that DO apply alongside --from: the hash-mode flags (--expected-hash, which overrides the file’s expected_hash field; --auto-hash; --force), --dry-run (forces a dry run even when the file says otherwise), and --note.

note: Option<String>

Agent-authored provenance note (≤280 chars). When [mutations].require_notes = true a missing note adds a NOTE_MISSING warning.

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.