Struct CreateEntityOutcome 

pub struct CreateEntityOutcome {
    pub id: EntityId,
    pub title: String,
    pub mem: String,
    pub file_path: String,
    pub content_hash: String,
    pub commit_sha: String,
    pub created_date: String,
    pub warnings: Vec<WarningHint>,
    pub type_guidance: BTreeMap<String, Vec<String>>,
    pub incoming_count: Option<usize>,
    pub incoming: Vec<IncomingRef>,
    pub relations_declared: Vec<RelationDeclared>,
}

Successful outcome of [Engine::create_entity].

Fields

id: EntityId

title: String

Echoed from the request — full’s CreateResult.title carries the same value so wire callers don’t need to derive it from the id.

mem: String

Echoed from the request — full’s CreateResult.mem. The EntityId.mem() accessor projects the same value, but surfacing it explicitly mirrors full’s wire shape.

file_path: String

Mem-relative path of the freshly-written .md file.

content_hash: String

SHA-256 of the canonical bytes. Round-trips as expected_hash for the next mutation against this entity. The wire key is _hash to match memstead_entity’s read envelope and the underscore-prefix convention for engine metadata. Pre- fix mutation responses serialised this as content_hash, forcing agents to rename the field when piping the value into a follow-up call.

commit_sha: String

Per-mem commit identifier returned by the backend’s crate::backend::MemBackend::commit. Wire-equivalent to full’s CreateResult.commit_sha.

created_date: String

ISO date string from the parsed entity’s created_date metadata. Today’s date when the schema’s auto-stamp filled it in; the existing value when re-materialising a stub with init_timestamp semantics. Wire-equivalent to full’s CreateResult.created_date.

warnings: Vec<WarningHint>

Typed Tier-2 warnings — today WarningHint::MissingRequiredSection for empty / absent required sections. Populated even when the create succeeded so callers see the same self-correction prompts the existing engines emit. Wire-equivalent to full’s CreateResult.warnings.

type_guidance: BTreeMap<String, Vec<String>>

Type-level write_rules keyed by entity_type — the MISSING_REQUIRED_SECTION / MISSING_REQUIRED_FIELD warnings reference this top-level map via their entity_type field rather than each carrying the (identical, type-axis) array. Empty when no such warnings fire; stable empty shape ships on the wire so consumers don’t branch on field presence (F9). Sorted by key for deterministic output.

incoming_count: Option<usize>

Number of incoming edges adopted from a pre-existing stub at this id. None when no stub adoption happened (no pre-existing entity, or a real entity at the id — but that path errors with AlreadyExists before this field is computed). Wire-equivalent to full’s CreateResult.incoming_count.

incoming: Vec<IncomingRef>

Incoming edges present at this id post-create — populated from store.incoming(id) after the parse + upsert. Empty when no pre-existing stub had referrers. Wire-equivalent to full’s CreateResult.incoming.

relations_declared: Vec<RelationDeclared>

Batched relation declarations from the request’s existing relations[] parameter. Mirrors UpdateEntityOutcome::relations_declared so the agent sees one wire shape across memstead_create and memstead_update. Empty [] when no relations were declared. target_was_stubbed reports the same flag the existing relate auto-stub path emits via WarningHint::InlineWikiLinkAutoStubbed.

Trait Implementations

impl Clone for CreateEntityOutcome

fn clone(&self) -> CreateEntityOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CreateEntityOutcome

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

Formats the value using the given formatter.

impl Serialize for CreateEntityOutcome

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.