Struct StoreArgs 

pub struct StoreArgs {

    pub tier: String,
    pub namespace: Option<String>,
    pub title: String,
    pub content: String,
    pub tags: String,
    pub priority: i32,
    pub confidence: Option<f64>,
    pub source: String,
    pub expires_at: Option<String>,
    pub ttl_secs: Option<i64>,
    pub scope: Option<String>,
    pub kind: Option<String>,
    pub citations: Option<String>,
    pub source_uri: Option<String>,
    pub source_span: Option<String>,
    pub entity_id: Option<String>,
    pub sign: bool,
}

Clap-derived arg shape for the store subcommand. Definition moved from main.rs verbatim in W5a — fields and attrs unchanged.

Fields

tier: String

Memory tier. default_value must be a literal at attribute-parse time, so the wire string is kept here verbatim; it is byte-equal to crate::models::Tier::Mid.as_str() (pm-v3.1 PR6 #1174 sweep — raw tier literals are confined to the deserializer + clap default_value attrs that cannot accept const expressions).

namespace: Option<String>

title: String

content: String

Content (use - to read from stdin)

tags: String

priority: i32

confidence: Option<f64>

Confidence 0.0-1.0. When omitted (#1591) the compiled default is stamped with truthful confidence_source = "default" provenance instead of falsely claiming caller_provided.

source: String

Source: user, claude, hook, api

expires_at: Option<String>

Explicit expiry timestamp (RFC3339). Overrides tier default.

ttl_secs: Option<i64>

TTL in seconds. Overrides tier default.

scope: Option<String>

Task 1.5 visibility scope: private (default) / team / unit / org / collective. Stored as metadata.scope; affects which agents can recall this memory when queries use --as-agent.

kind: Option<String>

v0.7.0 F2.3 (#1427) — Form-6 typed memory kind. One of: observation (default), reflection, persona, concept, entity, claim, relation, event, conversation, decision. Maps to Memory::memory_kind (canonical: crate::models::MemoryKind).

citations: Option<String>

v0.7.0 F2.3 (#1427) — Form-4 fact-provenance citations array. JSON array of {uri, accessed_at, hash?, span?} entries. Maps to Memory::citations (validated via validate::validate_citation). Pass --citations '[{"uri":"https://example.com","accessed_at":"2026-05-31T00:00:00Z"}]'.

source_uri: Option<String>

v0.7.0 F2.3 (#1427) — Form-4 first-class source URI pointer. Accepted schemes: uri: / doc: / file:. Maps to Memory::source_uri (validated via validate::validate_source_uri).

source_span: Option<String>

v0.7.0 F2.3 (#1427) — Form-4 byte-range pin into the source body. JSON {start: <usize>, end: <usize>}. Maps to Memory::source_span (validated via validate::validate_source_span).

entity_id: Option<String>

v0.7.0 F2.3 (#1427) — QW-2 persona artefact entity binding. Required when --kind persona. Maps to Memory::entity_id.

sign: bool

#626 Layer-3 (Task 1.3 / C5) — sign this write with the resolved agent’s local Ed25519 keypair so the stored row is attested rather than merely claimed. Requires a <agent_id>.priv under the key directory (AI_MEMORY_KEY_DIR or the platform default); the bound public key must match (see ai-memory agents bind-key). When unset, the write is claimed unless AI_MEMORY_REQUIRE_AGENT_ATTESTATION is on, which rejects it.

Trait Implementations

impl Args for StoreArgs

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 FromArgMatches for StoreArgs

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.