memstead-base 0.1.0

Engine internals for Memstead — store, parser, validators, filesystem-mem engine.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

//! Wire types for `Engine::branch_reset`.
//!
//! fetch / pull / push / branch_reset form one transport surface; this op is the lone history-rewrite
//! primitive the others compose against.

use serde::{Deserialize, Serialize};

/// Successful outcome of `Engine::branch_reset`. Carries enough
/// context for callers (CLI, replay skills, audit UIs) to surface
/// what happened without a follow-up `memstead_changes_since` poll.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct BranchResetOutcome {
    /// Mem name whose branch pointer moved.
    pub mem: String,
    /// Full ref name of the moved branch (`refs/heads/<mem>` for
    /// flat layouts, `refs/heads/<path>/<mem>` for hierarchical
    /// ones).
    pub branch_ref: String,
    /// SHA the branch pointed at before the reset.
    pub previous_sha: String,
    /// SHA the branch points at after the reset.
    pub new_sha: String,
    /// SHAs of the commits that the reset moved away from — every
    /// commit reachable from `previous_sha` but not from `new_sha`.
    /// Empty when the reset was a no-op (target == current head).
    /// Implementer guarantees: every entry was unpushed at the
    /// instant of the safety probe; nothing in the list was reachable
    /// from any `refs/remotes/*` ref.
    pub discarded_commits: Vec<String>,
}