Struct MergeSession 

pub struct MergeSession {
    pub merge_id: MergeSessionId,
    pub src_head: Option<OpId>,
    pub dst_head: Option<OpId>,
    pub lca: Option<OpId>,
    pub auto_resolved: Vec<MergeOutcome>,
    /* private fields */
}

Stateful merge in flight. Hold one per active merge between start and commit. Sessions are not thread-safe; the HTTP wrapper is expected to wrap them in a Mutex keyed by MergeSessionId.

Fields

merge_id: MergeSessionId

src_head: Option<OpId>

dst_head: Option<OpId>

lca: Option<OpId>

auto_resolved: Vec<MergeOutcome>

Outcomes the engine resolved unilaterally — Both (both sides agreed) and one-sided (Src / Dst). The agent sees these for audit but doesn’t need to act on them.

Implementations

impl MergeSession

pub fn start( merge_id: impl Into<MergeSessionId>, op_log: &OpLog, src_head: Option<&OpId>, dst_head: Option<&OpId>, ) -> Result<Self>

Start a merge session. Runs the engine in crate::merge and partitions the outcomes into auto-resolved and conflicts-needing-attention.

pub fn remaining_conflicts(&self) -> Vec<&ConflictRecord>

Pending conflicts (those without a non-defer resolution).

pub fn resolve( &mut self, resolutions: Vec<(ConflictId, Resolution)>, ) -> Vec<ResolveVerdict>

Submit resolutions in batch. Returns one verdict per input. Accepted resolutions are recorded; rejected ones leave the previous resolution (if any) in place so partial submissions don’t clobber earlier good work.

pub fn resolve_checked( &mut self, resolutions: Vec<(ConflictId, Resolution)>, checker: &dyn ResolutionChecker, ) -> Vec<ResolveVerdict>

Submit resolutions in batch, type-checking each against the composed program before accepting it (#834).

This is the loop the session was built for — “submit N resolutions, see which broke type-checking, fix them, retry” — made real. Structural validation (Self::validate_resolution) runs first; a structurally-valid resolution is then overlaid on dst’s head together with every resolution accepted so far, and the injected ResolutionChecker type-checks the result. A resolution whose composed program doesn’t type-check is rejected with ResolutionRejection::TypeError and not recorded, so the session’s accepted set stays type-correct at every step.

Resolutions are processed in order and accumulate: a later resolution is checked against the program the earlier accepted ones already produced. Interdependent picks (two conflicts that only compose together) should therefore be submitted in dependency order, or a rejected one resubmitted after its partner lands — the same way git needs both halves of an intertwined conflict resolved before the tree builds. Unresolved conflicts contribute nothing to the projection: they leave dst’s (always-valid) side standing, so a partial batch still composes.

pub fn validate_resolution( &self, conflict_id: &ConflictId, resolution: &Resolution, ) -> Result<(), ResolutionRejection>

Validate a single resolution against the session’s pending conflicts. Pure (no side effects); the caller decides whether to accept.

pub fn commit(self) -> Result<Vec<(ConflictId, Resolution)>, CommitError>

Finalize the merge. On success returns the resolved resolutions in conflict_id order. The caller is responsible for synthesizing the final Operation::Merge op against the store and persisting it; this function returns the engine’s view of “what to land,” not the persisted op id.

Trait Implementations

impl Debug for MergeSession

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MergeSession

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MergeSession

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

where __S: Serializer,

Serialize this value into the given Serde serializer.