Struct MemCreateParams 

pub struct MemCreateParams {
    pub name: String,
    pub location: PathBuf,
    pub schema_ref: SchemaRef,
    pub vcs: Option<VcsConfig>,
    pub note: Option<String>,
    pub operator_mode: bool,
    pub recovery: Option<RecoveryAction>,
    pub write_guidance: HashMap<String, Value>,
    pub storage: Option<StorageKind>,
    pub actor: Actor,
    pub client: Option<ClientId>,
}

Parameters for create_mem. Mirrors the memstead_mem_create MCP tool’s wire shape 1:1.

Hierarchical paths are first-class mem identifiers — there is no separate path field; name carries the full path (e.g. "team/sub-mem") directly, validated via memstead_base::entity::id::validate_mem_name_grammar. The branch ref composes as refs/heads/<name> and the __MEMSTEAD config blob as __MEMSTEAD:mems/<name>/config.json with no extra composition step.

Fields

name: String

Name of the new mem — the full hierarchical identifier (e.g. "sub-mem" for flat layouts or "team/sub-mem" for hierarchical layouts). Must be unique across every visible mem in the current snapshot, match the basename of location (folder backend identity invariant on the trailing path segment), and satisfy the mem-name grammar ([a-z0-9-]+(/[a-z0-9-]+)*).

location: PathBuf

Target location. Absolute or workspace-relative. Canonicalized inside the orchestrator before the allowlist check.

schema_ref: SchemaRef

Schema pin for the new mem (name@x.y.z).

vcs: Option<VcsConfig>

Optional vcs config override (signing keys, identity hints). Persisted into the per-mem config blob alongside schema and name. Most callers pass None — defaults come from the workspace’s .memstead/workspace.toml. Mirrors full’s memstead_git_branch::MemCreateParams.vcs.

note: Option<String>

Agent-authored provenance note (≤NOTE_MAX_LEN chars).

operator_mode: bool

Process-scoped operator-mode posture. When true, the orchestrator skips the [[mem_management.create]] allowlist gate and the matched-rule schema gate it derives — every other check (input validation, schema canonicalisation, basename invariant, name collision, backend instantiation) runs identically. Set only by transports that established operator intent at boot (memstead-mcp --operator-mode); never accepted as a wire-shape input from agents. Defaults to false — agent-mode.

recovery: Option<RecoveryAction>

Explicit recovery action for the case where the storage already carries residue for the composed branch path. None is the default — the engine then routes by tombstone presence: residue with an unregistered_at tombstone (deliberate operator state from memstead mem unregister) defaults to [RecoveryAction::Reattach], residue without a tombstone refuses with MEM_STORAGE_RESIDUE_DETECTED. Setting an explicit value overrides the tombstone-driven default. A bare mem init against a name with no residue at all ignores this field (the happy path is unchanged).

write_guidance: HashMap<String, Value>

Optional opaque per-instance writing guidance, persisted verbatim into the new mem’s config (writeGuidance) in the seed commit. The engine never inspects the map’s contents (schema-strictness D8 — writeGuidance is client-owned vocabulary); a client that read a schema package’s mem-template.json fills the instance keys and passes them here. Empty map (the default) seeds no guidance, identical to pre-parameter behaviour.

storage: Option<StorageKind>

Explicit storage-backend override. None (default) keeps the workspace-shape heuristic — git-branch when <workspace_root>/mem-repo/.git/ exists, folder otherwise. Some(StorageKind::Folder) forces a folder mount even in a mem-repo workspace: the mem’s markdown files live at location, visible in the outer tree. Some(StorageKind::GitBranch) in a workspace WITHOUT mem-repo/.git/ refuses with EngineError::InvalidInput — there is no gitdir to host the branch.

actor: Actor

Caller category for the seed commit’s provenance trailer. Transports pass their own: MCP Actor::Agent, the CLI Actor::Cli, application embedders (UniFFI, HTTP) Actor::App. Pre-parameter behaviour hardcoded Agent for every transport — the macOS app’s mem creations were misattributed as agent writes.

client: Option<ClientId>

Client identity paired with actor — renders name@version in the seed commit’s Client: trailer and derives its author, exactly as entity mutations do.

Trait Implementations

impl Clone for MemCreateParams

fn clone(&self) -> MemCreateParams

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MemCreateParams

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

Formats the value using the given formatter.