Struct RelateEntityOutcome 

pub struct RelateEntityOutcome {
    pub from: EntityId,
    pub to: EntityId,
    pub rel_type: String,
    pub action: RelateAction,
    pub content_hash: String,
    pub commit_sha: String,
    pub source: String,
    pub warnings: Vec<WarningHint>,
    pub orphan_stubs_removed: Vec<EntityId>,
}

Successful outcome of [Engine::relate_entity].

Fields

from: EntityId

to: EntityId

rel_type: String

action: RelateAction

content_hash: String

Source entity’s content hash after the call. Unchanged on no-op paths so callers can chain follow-ups without refetching. Wire key _hash.

commit_sha: String

Per-mem commit identifier returned by the backend’s crate::backend::MemBackend::commit. Empty on the no-op paths (RelateAction::NoOpAlreadyPresent, RelateAction::NoOpAbsent) — those branches skip the disk write so no commit happens. Wire-equivalent to the full RelateResult.commit_sha.

source: String

Edge provenance label — always "explicit" for relate-call outcomes. Wire-equivalent to full’s RelateResult.source field; reserved for future inline-link-derived edge surfacing.

warnings: Vec<WarningHint>

Typed non-fatal issues — open-mode schema admissions (WarningHint::UndeclaredRelationshipOpen), duplicate-add no-ops (WarningHint::DuplicateRelationship), remove-nonexistent no-ops (WarningHint::NoSuchRelationship), and auto-stubbed targets (WarningHint::AutoStubCreated). Pre-Item-03 the auto-stub case rode through a deprecated top-level stub_warning: Option<String> field that didn’t follow the warnings[] shape — agents iterating diagnostics silently skipped it; the field has been retired in favour of the uniform warning vocabulary. Empty on the strict-add and strict-remove happy paths.

orphan_stubs_removed: Vec<EntityId>

Stub entities whose last incoming edge was severed by a remove=true call and that were garbage-collected as orphans. Empty on the add path and on remove paths that didn’t strip the last referrer. Wire-equivalent to DeleteEntityOutcome::orphan_stubs_removed; both surfaces share the same field name so MCP / CLI consumers can branch uniformly (F7).

Trait Implementations

impl Clone for RelateEntityOutcome

fn clone(&self) -> RelateEntityOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RelateEntityOutcome

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

Formats the value using the given formatter.

impl Serialize for RelateEntityOutcome

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

where __S: Serializer,

Serialize this value into the given Serde serializer.