Struct UpdatePlan 

pub struct UpdatePlan { /* private fields */ }

Write plan for an update op (entity or note shape — ADR-099 D3’s update caveat covers both substrates the same way: row/FTS DML in the plan, any reindex deferred to post_commit).

Deferred effects are assigned by this crate’s prepare pass and cannot be supplied by callers constructing a plan directly:

use khive_runtime::{PostCommitEffect, UpdatePlan};
use uuid::Uuid;

let id = Uuid::nil();
let plan = UpdatePlan {
    target_id: id,
    statements: Vec::new(),
    post_commit: PostCommitEffect::ReindexEntity { entity_id: id },
    edge_natural_key: None,
    idempotent_noop: false,
};

A plan returned by a prepare function cannot have its validated statements cleared or replaced before it reaches the runner:

use khive_runtime::UpdatePlan;

fn clear_prepared_statements(mut prepared: UpdatePlan) {
    prepared.statements.clear();
}

Implementations

impl UpdatePlan

pub fn target_id(&self) -> Uuid

The record id supplied to the prepare pass.

pub fn edge_natural_key(&self) -> Option<&EdgeNaturalKey>

The committed lookup key required for a symmetric edge update.

pub fn post_commit(&self) -> &PostCommitEffect

The potential deferred effect. The writer resolves inherited embedding membership before issuing the committed-effects token.

pub fn is_idempotent_noop(&self) -> bool

Whether this plan is a mutation-free note update assertion.

Trait Implementations

impl Clone for UpdatePlan

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UpdatePlan

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

Formats the value using the given formatter.