OXYGENHUB

Coverage / crates/oxy-core/src/tree.rs 93.7%

1154 of 1231 lines run, 163 of 183 functions · run #300 on main · run missed

1
//! The tree graph: nodes, placements, and modes as atoms (spec §7.1, §7.2),
2
//! with tree conflict detection and path assignment (spec §9.2).
3
4
use crate::hash::ChangeHash;
5
use crate::ids::NodeId;
6
use crate::objects::{Mode, NodeKind, OpRef, TreeOp};
7
use std::collections::{BTreeMap, BTreeSet, HashMap, HashSet};
8
9
/// `(change, index into that change's tree_ops)`.
10
pub type OpKey = (ChangeHash, u32);
11
12
/// The graph's own maps: keyed by hashes and random ids, which need no
13
/// SipHash (see [`crate::fasthash`]).
14
type Map<K, V> = crate::fasthash::FastMap<K, V>;
15
16
/// A node's placement or mode atoms, sorted: nearly always one, held
17
/// without an allocation.
18
#[derive(Clone, Debug, Default, PartialEq, Eq)]
19
enum KeySet {
20
    #[default]
21
    Empty,
22
    One(OpKey),
23
    Many(Vec<OpKey>),
24
}
25
26
impl KeySet {
27279099×
    fn insert(&mut self, k: OpKey) {
28161×
        match self {
29278892×
            KeySet::Empty => *self = KeySet::One(k),
30161×
            KeySet::One(a) if *a == k => {}
31161×
            KeySet::One(a) => {
32161×
                let a = *a;
33161×
                *self = KeySet::Many(if a < k { vec![a, k] } else { vec![k, a] });
34
            }
3546×
            KeySet::Many(v) => {
3646×
                if let Err(i) = v.binary_search(&k) {
3746×
                    v.insert(i, k);
3846×
                }
39
            }
40
        }
41279099×
    }
42648×
    fn remove(&mut self, k: &OpKey) {
43642×
        match self {
44642×
            KeySet::One(a) if a == k => *self = KeySet::Empty,
456×
            KeySet::Many(v) => {
466×
                if let Ok(i) = v.binary_search(k) {
476×
                    v.remove(i);
486×
                }
496×
                if v.len() == 1 {
506×
                    *self = KeySet::One(v[0]);
516×
                } else if v.is_empty() {
520×
                    *self = KeySet::Empty;
530×
                }
54
            }
5584×
            _ => {}
56
        }
57648×
    }
5820306242×
    fn as_slice(&self) -> &[OpKey] {
5920306242×
        match self {
600×
            KeySet::Empty => &[],
6120306200×
            KeySet::One(a) => std::slice::from_ref(a),
6242×
            KeySet::Many(v) => v,
63
        }
6420306242×
    }
6520294298×
    fn iter(&self) -> std::slice::Iter<'_, OpKey> {
6620294298×
        self.as_slice().iter()
6720294298×
    }
6811944×
    fn len(&self) -> usize {
6911944×
        self.as_slice().len()
7011944×
    }
71648×
    fn is_empty(&self) -> bool {
72648×
        matches!(self, KeySet::Empty)
73648×
    }
74
}
75
76
impl<'a> IntoIterator for &'a KeySet {
77
    type Item = &'a OpKey;
78
    type IntoIter = std::slice::Iter<'a, OpKey>;
796763998×
    fn into_iter(self) -> Self::IntoIter {
806763998×
        self.iter()
816763998×
    }
82
}
83
84
#[derive(Clone, Debug, PartialEq, Eq)]
85
pub struct Placement {
86
    pub node: NodeId,
87
    pub parent: NodeId,
88
    pub name: String,
89
}
90
91
#[derive(Clone, Debug, Default)]
92
struct TreeMaps {
93
    kinds: Map<NodeId, NodeKind>,
94
    introduced: Map<NodeId, ChangeHash>,
95
    placements: Map<OpKey, Placement>,
96
    modes: Map<OpKey, (NodeId, Mode)>,
97
    /// Placement atoms retired by `RemoveNode`/`Move`, and mode atoms retired
98
    /// by `SetMode`. Kept apart because `AddNode` introduces one of each
99
    /// under the same key.
100
    deleted_placements: Map<OpKey, BTreeSet<ChangeHash>>,
101
    deleted_modes: Map<OpKey, BTreeSet<ChangeHash>>,
102
    placements_of: Map<NodeId, KeySet>,
103
    modes_of: Map<NodeId, KeySet>,
104
    /// The live subsets of `placements_of` and `modes_of`, kept as changes
105
    /// apply, so the view walks what is live rather than all history.
106
    live_placements_of: Map<NodeId, KeySet>,
107
    live_modes_of: Map<NodeId, KeySet>,
108
}
109
110
#[derive(Clone, Debug, Default)]
111
pub struct TreeGraph {
112
    /// The graph itself; see [`TreeGraph::m`].
113
    maps: std::sync::OnceLock<TreeMaps>,
114
    /// A state index's encoding of `maps`, decoded when first needed: a
115
    /// command that only reads the view (a status) never needs them.
116
    raw: Option<std::sync::Arc<Vec<u8>>>,
117
    /// The introducers block of the same index, read alone while `maps`
118
    /// is not decoded: a snapshot asks for introducers but no more.
119
    raw_introduced: Option<std::sync::Arc<Vec<u8>>>,
120
    introduced_only: std::sync::OnceLock<Map<NodeId, ChangeHash>>,
121
    /// The view, once computed, with the path of each directory in it;
122
    /// kept up to date as ops apply when that is simple (see
123
    /// `update_view`), cleared otherwise.
124
    view_cache: std::sync::OnceLock<CachedView>,
125
}
126
127
#[derive(Clone, Debug, PartialEq, Eq)]
128
pub enum TreeConflict {
129
    /// Two live nodes share `(parent, name)`.
130
    Name {
131
        parent: NodeId,
132
        name: String,
133
        nodes: Vec<NodeId>,
134
    },
135
    /// One node has several live placements.
136
    MultiPlacement {
137
        node: NodeId,
138
        placements: Vec<OpKey>,
139
    },
140
    /// A live node's parent is not live.
141
    Orphan { node: NodeId, parent: NodeId },
142
    /// A directory is placed inside its own descendant.
143
    Cycle { node: NodeId },
144
    /// Several live mode atoms.
145
    Mode { node: NodeId, modes: Vec<Mode> },
146
}
147
148
/// A node as it appears in the working copy.
149
#[derive(Clone, Debug, PartialEq, Eq)]
150
pub struct TreeEntry {
151
    pub path: String,
152
    pub node: NodeId,
153
    pub kind: NodeKind,
154
    pub mode: Mode,
155
    /// The placement this entry materializes (for building `RemoveNode`/`Move`).
156
    pub placement: OpKey,
157
    /// The live mode atom (for building `SetMode`).
158
    pub mode_atom: Option<OpKey>,
159
}
160
161
#[derive(Clone, Debug, Default)]
162
struct CachedView {
163
    view: TreeView,
164
    dirs: HashMap<NodeId, String>,
165
}
166
167
impl CachedView {
1683885×
    fn new(view: TreeView) -> CachedView {
1693885×
        let mut dirs: HashMap<NodeId, String> = view
1703885×
            .entries
1713885×
            .values()
17238743×
            .filter(|e| e.kind == NodeKind::Dir)
1733885×
            .map(|e| (e.node, e.path.clone()))
1743885×
            .collect();
1753885×
        dirs.insert(NodeId::ROOT, String::new());
1763885×
        CachedView { view, dirs }
1773885×
    }
178
}
179
180
#[derive(Clone, Debug, Default, PartialEq, Eq)]
181
pub struct TreeView {
182
    /// Path → entry, paths use `/` and have no leading slash; conflicted
183
    /// entries carry a `.oxy-conflict-<n>` suffix. Shared, so a view is
184
    /// cheap to clone.
185
    pub entries: std::sync::Arc<BTreeMap<String, TreeEntry>>,
186
    pub conflicts: Vec<TreeConflict>,
187
}
188
189
impl TreeView {
1902419×
    pub fn is_conflicted(&self) -> bool {
1912419×
        !self.conflicts.is_empty()
1922419×
    }
1931321×
    pub fn by_node(&self) -> HashMap<NodeId, &TreeEntry> {
1949546×
        self.entries.values().map(|e| (e.node, e)).collect()
1951321×
    }
196
}
197
198
impl TreeGraph {
1992803×
    pub fn new() -> Self {
2002803×
        Self::default()
2012803×
    }
202
203
    /// The graph's maps, decoded from a state index on first use.
20448324713×
    fn m(&self) -> &TreeMaps {
20548324713×
        self.maps.get_or_init(|| match &self.raw {
2062795×
            Some(raw) => {
2072795×
                TreeMaps::decode(raw).expect("a state index is checked against its hash when read")
208
            }
2095140×
            None => TreeMaps::default(),
2107935×
        })
21148324713×
    }
212
213709283×
    fn m_mut(&mut self) -> &mut TreeMaps {
214709283×
        self.m();
215709283×
        self.maps.get_mut().expect("decoded just now")
216709283×
    }
217
218
    /// Apply tree op `index` of `change`; `OpRef` self references must already be resolved.
21938065×
    pub fn apply(&mut self, change: ChangeHash, index: u32, op: &TreeOp) {
22038065×
        let cached = self.view_cache.take();
221
        // Whether the placement or mode atom this op retires was live.
22238065×
        let was_live = match op {
223733×
            TreeOp::RemoveNode { placement, .. } => self.placement_live(&op_key(*placement)),
224160×
            TreeOp::Move { old, .. } => self.placement_live(&op_key(*old)),
22528×
            TreeOp::SetMode { old, .. } => self.mode_live(&op_key(*old)),
22637144×
            TreeOp::AddNode { .. } => false,
227
        };
22838065×
        self.apply_to_graph(change, index, op);
22938065×
        if let Some(mut c) = cached {
23012128×
            if self.update_view(&mut c, (change, index), op, was_live) {
2312603×
                #[cfg(test)]
2329328×
                assert_eq!(
2332603×
                    c.view,
2349328×
                    self.compute_view(),
2352603×
                    "view kept up to date by {op:?}"
2362603×
                );
23711931×
                self.view_cache = std::sync::OnceLock::from(c);
2382603×
            }
23925937×
        }
24038065×
    }
241
24238065×
    fn apply_to_graph(&mut self, change: ChangeHash, index: u32, op: &TreeOp) {
24338065×
        let key = (change, index);
24438065×
        match op {
245
            TreeOp::AddNode {
24637144×
                node,
24737144×
                kind,
24837144×
                mode,
24937144×
                parent,
25037144×
                name,
251
            } => {
25237144×
                self.m_mut().kinds.insert(*node, *kind);
25337144×
                self.m_mut().introduced.insert(*node, change);
25437144×
                self.m_mut().placements.insert(
25537144×
                    key,
25637144×
                    Placement {
25737144×
                        node: *node,
25837144×
                        parent: *parent,
25937144×
                        name: name.clone(),
26037144×
                    },
261
                );
26237144×
                self.m_mut()
26337144×
                    .placements_of
26437144×
                    .entry(*node)
26537144×
                    .or_default()
26637144×
                    .insert(key);
26737144×
                self.index_placement(key);
26837144×
                if *kind != NodeKind::Dir {
26935315×
                    self.m_mut().modes.insert(key, (*node, *mode));
27035315×
                    self.m_mut().modes_of.entry(*node).or_default().insert(key);
27135315×
                    self.index_mode(key);
27235315×
                }
273
            }
274733×
            TreeOp::RemoveNode { placement, .. } => {
275733×
                self.m_mut()
276733×
                    .deleted_placements
277733×
                    .entry(op_key(*placement))
278733×
                    .or_default()
279733×
                    .insert(change);
280733×
                self.index_placement(op_key(*placement));
281733×
            }
282
            TreeOp::Move {
283160×
                node,
284160×
                old,
285160×
                parent,
286160×
                name,
287160×
            } => {
288160×
                self.m_mut()
289160×
                    .deleted_placements
290160×
                    .entry(op_key(*old))
291160×
                    .or_default()
292160×
                    .insert(change);
293160×
                self.index_placement(op_key(*old));
294160×
                self.m_mut().placements.insert(
295160×
                    key,
296160×
                    Placement {
297160×
                        node: *node,
298160×
                        parent: *parent,
299160×
                        name: name.clone(),
300160×
                    },
301160×
                );
302160×
                self.m_mut()
303160×
                    .placements_of
304160×
                    .entry(*node)
305160×
                    .or_default()
306160×
                    .insert(key);
307160×
                self.index_placement(key);
308160×
            }
30928×
            TreeOp::SetMode { node, old, mode } => {
31028×
                self.m_mut()
31128×
                    .deleted_modes
31228×
                    .entry(op_key(*old))
31328×
                    .or_default()
31428×
                    .insert(change);
31528×
                self.index_mode(op_key(*old));
31628×
                self.m_mut().modes.insert(key, (*node, *mode));
31728×
                self.m_mut().modes_of.entry(*node).or_default().insert(key);
31828×
                self.index_mode(key);
31928×
            }
320
        }
32138065×
    }
322
323
    /// Bring the cached view `c` up to date with `op` (already applied as
324
    /// `key`) where that is simple and the view has no conflicts; false
325
    /// when it must be computed again. `was_live`: whether the placement or
326
    /// mode atom `op` retires was live before it.
32712128×
    fn update_view(&self, c: &mut CachedView, key: OpKey, op: &TreeOp, was_live: bool) -> bool {
32812128×
        if !c.view.conflicts.is_empty() {
3299×
            return false;
33012119×
        }
33112119×
        match op {
33211934×
            TreeOp::AddNode { node, .. } => self.view_add(c, *node, key),
333110×
            TreeOp::RemoveNode { node, placement } => {
334110×
                !was_live || self.view_remove(c, *node, op_key(*placement))
335
            }
33666×
            TreeOp::Move { node, old, .. } => {
33766×
                (!was_live || self.view_remove(c, *node, op_key(*old)))
33810×
                    && self.view_add(c, *node, key)
339
            }
3409×
            TreeOp::SetMode { node, .. } => {
3419×
                let live = self.live_placements(node);
3429×
                match live.as_slice() {
3439×
                    [] => true,
3445×
                    [(k, p)] => {
3455×
                        let Some(path) = c.dirs.get(&p.parent).map(|d| join(d, &p.name)) else {
3460×
                            return false;
347
                        };
3485×
                        let Some(mode) = self.entry_mode(node) else {
3490×
                            return false;
350
                        };
3515×
                        let entries = std::sync::Arc::make_mut(&mut c.view.entries);
3525×
                        match entries.get_mut(&path) {
3535×
                            Some(e) if e.node == *node && e.placement == *k => {
3545×
                                (e.mode_atom, e.mode) = mode;
3555×
                                true
356
                            }
3570×
                            _ => false,
358
                        }
359
                    }
3600×
                    _ => false,
361
                }
362
            }
363
        }
36412128×
    }
365
366
    /// The view entry for `node`'s placement `key`, just made live.
36711944×
    fn view_add(&self, c: &mut CachedView, node: NodeId, key: OpKey) -> bool {
36811944×
        if !self.placement_live(&key) {
3690×
            return true;
37011944×
        }
37111944×
        if self
37211944×
            .m()
37311944×
            .live_placements_of
37411944×
            .get(&node)
37511944×
            .is_none_or(|s| s.len() != 1)
376
        {
3777×
            return false;
37811937×
        }
37911937×
        let Some(p) = self.m().placements.get(&key) else {
3800×
            return false;
381
        };
38211937×
        let Some(path) = c.dirs.get(&p.parent).map(|d| join(d, &p.name)) else {
3832×
            return false;
384
        };
38511935×
        let Some((mode_atom, mode)) = self.entry_mode(&node) else {
3860×
            return false;
387
        };
38811935×
        let kind = self.kind(&node).unwrap_or(NodeKind::File);
38911935×
        let entries = std::sync::Arc::make_mut(&mut c.view.entries);
39011935×
        if entries.contains_key(&path) || node == NodeId::ROOT {
39146×
            return false;
39211889×
        }
393
        // Nothing can be placed under a directory that was not in the view
394
        // yet: it would have been an orphan, and the view had no conflicts.
39511889×
        if kind == NodeKind::Dir {
396818×
            c.dirs.insert(node, path.clone());
39711071×
        }
39811889×
        entries.insert(
39911889×
            path.clone(),
40011889×
            TreeEntry {
40111889×
                path,
40211889×
                node,
40311889×
                kind,
40411889×
                mode,
40511889×
                placement: key,
40611889×
                mode_atom,
40711889×
            },
408
        );
40911889×
        true
41011944×
    }
411
412
    /// Drop the view entry of `node`'s placement `key`, just retired.
413163×
    fn view_remove(&self, c: &mut CachedView, node: NodeId, key: OpKey) -> bool {
414163×
        if self.m().live_placements_of.contains_key(&node) {
41556×
            return false;
416107×
        }
417107×
        let Some(p) = self.m().placements.get(&key) else {
41842×
            return false;
419
        };
42065×
        let Some(path) = c.dirs.get(&p.parent).map(|d| join(d, &p.name)) else {
4210×
            return false;
422
        };
42365×
        let entries = std::sync::Arc::make_mut(&mut c.view.entries);
42465×
        match entries.get(&path) {
42565×
            Some(e) if e.node == node && e.placement == key => {}
4260×
            _ => return false,
427
        }
42865×
        if entries.get(&path).is_some_and(|e| e.kind == NodeKind::Dir) {
42936×
            let prefix = format!("{path}/");
43036×
            if entries
43136×
                .range(prefix.clone()..)
43236×
                .next()
43336×
                .is_some_and(|(k, _)| k.starts_with(&prefix))
434
            {
43535×
                return false;
4361×
            }
4371×
            c.dirs.remove(&node);
43829×
        }
43930×
        entries.remove(&path);
44030×
        true
441163×
    }
442
443
    /// The mode atom and mode of `node`'s entry, as `compute_view` finds
444
    /// them; `None` when its live modes conflict.
44511940×
    fn entry_mode(&self, node: &NodeId) -> Option<(Option<OpKey>, Mode)> {
44611940×
        let lm = self.live_modes(node);
44711940×
        let distinct: BTreeSet<Mode> = lm.iter().map(|(_, m)| *m).collect();
44811940×
        if distinct.len() > 1 {
4490×
            return None;
45011940×
        }
45111940×
        let mode_atom = lm.iter().map(|(k, _)| *k).max();
45211940×
        let mode = mode_atom
45311940×
            .and_then(|k| self.m().modes.get(&k).map(|(_, m)| *m))
45411940×
            .unwrap_or_default();
45511940×
        Some((mode_atom, mode))
45611940×
    }
457
458
    /// Bring placement `k` in the live index up to date.
45971767×
    fn index_placement(&mut self, k: OpKey) {
46071767×
        let Some(node) = self.m_mut().placements.get(&k).map(|p| p.node) else {
461275×
            return;
462
        };
46371492×
        if self.placement_live(&k) {
46470571×
            self.m_mut()
46570571×
                .live_placements_of
46670571×
                .entry(node)
46770571×
                .or_default()
46870571×
                .insert(k);
46970571×
        } else if let Some(set) = self.m_mut().live_placements_of.get_mut(&node) {
470619×
            set.remove(&k);
471619×
            if set.is_empty() {
472548×
                self.m_mut().live_placements_of.remove(&node);
473548×
            }
474302×
        }
47571767×
    }
476
477
    /// Bring mode atom `k` in the live index up to date.
47868863×
    fn index_mode(&mut self, k: OpKey) {
47968863×
        let Some(node) = self.m_mut().modes.get(&k).map(|(n, _)| *n) else {
48015×
            return;
481
        };
48268848×
        if self.mode_live(&k) {
48368819×
            self.m_mut()
48468819×
                .live_modes_of
48568819×
                .entry(node)
48668819×
                .or_default()
48768819×
                .insert(k);
48868819×
        } else if let Some(set) = self.m_mut().live_modes_of.get_mut(&node) {
48929×
            set.remove(&k);
49029×
            if set.is_empty() {
49110×
                self.m_mut().live_modes_of.remove(&node);
49219×
            }
4930×
        }
49468863×
    }
495
496
    /// Directories no longer placed anywhere, by the (parent, name) they
497
    /// were last placed at, with that placement: what an import can bring
498
    /// back rather than make a second node for one Git path.
49914×
    pub fn dead_dirs(&self) -> HashMap<(NodeId, String), (NodeId, OpKey)> {
50014×
        let mut out: HashMap<(NodeId, String), (NodeId, OpKey)> = HashMap::new();
50115×
        for (k, p) in &self.m().placements {
50215×
            if self.kind(&p.node) != Some(NodeKind::Dir)
5035×
                || self.placement_live(k)
5042×
                || !self.live_placements(&p.node).is_empty()
505
            {
50613×
                continue;
5072×
            }
5082×
            let slot = out
5092×
                .entry((p.parent, p.name.clone()))
5102×
                .or_insert((p.node, *k));
511
            // The newest placement, by key: the same answer in any order.
5122×
            if *k > slot.1 {
5130×
                *slot = (p.node, *k);
5142×
            }
515
        }
51614×
        out
51714×
    }
518
519
    /// Every placement `node` ever had, live or not, with the changes that
520
    /// retired it (none while live).
5210×
    pub fn placement_history(&self, node: &NodeId) -> Vec<(OpKey, &Placement, Vec<ChangeHash>)> {
5220×
        self.m()
5230×
            .placements_of
5240×
            .get(node)
5250×
            .into_iter()
5260×
            .flatten()
5270×
            .filter_map(|k| {
5280×
                let p = self.m().placements.get(k)?;
5290×
                let by = self
5300×
                    .m()
5310×
                    .deleted_placements
5320×
                    .get(k)
5330×
                    .map(|d| d.iter().copied().collect())
5340×
                    .unwrap_or_default();
5350×
                Some((*k, p, by))
5360×
            })
5370×
            .collect()
5380×
    }
539
54084334×
    fn placement_live(&self, k: &OpKey) -> bool {
54184334×
        self.m()
54284334×
            .deleted_placements
54384334×
            .get(k)
54484334×
            .is_none_or(|d| d.is_empty())
54584334×
    }
54668876×
    fn mode_live(&self, k: &OpKey) -> bool {
54768876×
        self.m().deleted_modes.get(k).is_none_or(|d| d.is_empty())
54868876×
    }
549
5506775957×
    pub fn kind(&self, node: &NodeId) -> Option<NodeKind> {
5516775957×
        if node.is_root() {
5520×
            Some(NodeKind::Dir)
553
        } else {
5546775957×
            self.m().kinds.get(node).copied()
555
        }
5566775957×
    }
557
558
    /// The change whose `AddNode` introduced `node`.
55914636×
    pub fn introducer(&self, node: &NodeId) -> Option<ChangeHash> {
56014636×
        if let (None, Some(raw)) = (self.maps.get(), &self.raw_introduced) {
561550×
            let only = self.introduced_only.get_or_init(|| {
56259×
                read_introduced(raw).expect("a state index is checked against its hash when read")
56359×
            });
564
            #[cfg(test)]
5650×
            assert_eq!(
5660×
                only.get(node),
5670×
                TreeMaps::decode(self.raw.as_ref().unwrap())
5680×
                    .unwrap()
5690×
                    .introduced
5700×
                    .get(node),
571
                "the introducers block is the maps'"
572
            );
573550×
            return only.get(node).copied();
57414086×
        }
57514086×
        self.m().introduced.get(node).copied()
57614636×
    }
577
578163×
    pub fn placement(&self, k: &OpKey) -> Option<&Placement> {
579163×
        self.m().placements.get(k)
580163×
    }
581
5826764207×
    pub fn live_placements(&self, node: &NodeId) -> Vec<(OpKey, &Placement)> {
5836764207×
        self.m()
5846764207×
            .live_placements_of
5856764207×
            .get(node)
5866764207×
            .into_iter()
5876764207×
            .flat_map(|ks| ks.iter())
5886764214×
            .filter_map(|k| self.m().placements.get(k).map(|p| (*k, p)))
5896764207×
            .collect()
5906764207×
    }
591
5926775938×
    pub fn live_modes(&self, node: &NodeId) -> Vec<(OpKey, Mode)> {
5936775938×
        self.m()
5946775938×
            .live_modes_of
5956775938×
            .get(node)
5966775938×
            .into_iter()
5976775938×
            .flat_map(|ks| ks.iter())
5986775938×
            .filter_map(|k| self.m().modes.get(k).map(|(_, m)| (*k, *m)))
5996775938×
            .collect()
6006775938×
    }
601
602
    /// Every node that has at least one live placement.
6030×
    pub fn placed_nodes(&self) -> impl Iterator<Item = NodeId> + '_ {
6040×
        self.m().live_placements_of.keys().copied()
6050×
    }
606
607
    /// Resolve the tree: assign paths, find conflicts.
608
    /// The materialized tree (spec §7.1): computed once per graph and
609
    /// cloned for each caller.
6106991×
    pub fn view(&self) -> TreeView {
6116991×
        self.view_cache
6126991×
            .get_or_init(|| CachedView::new(self.compute_view()))
613
            .view
6146991×
            .clone()
6156991×
    }
616
61712473×
    fn compute_view(&self) -> TreeView {
61812473×
        let mut view = TreeView::default();
61912473×
        let mut entries: BTreeMap<String, TreeEntry> = BTreeMap::new();
620
621
        // Live placements grouped by parent.
62212473×
        let mut children: HashMap<NodeId, Vec<(OpKey, &Placement)>> = HashMap::new();
6236763998×
        for ks in self.m().live_placements_of.values() {
6246764013×
            for k in ks {
6256764013×
                if let Some(p) = self.m().placements.get(k) {
6266764013×
                    children.entry(p.parent).or_default().push((*k, p));
6276764013×
                }
628
            }
629
        }
63019693×
        for c in children.values_mut() {
63174865122×
            c.sort_by(|a, b| a.1.name.cmp(&b.1.name).then(a.0.cmp(&b.0)));
632
        }
633
634
        // Multi-placement and mode conflicts.
635
        // Only placed nodes: one with no live placement is not in the tree.
63612473×
        let mut nodes: Vec<NodeId> = self.m().live_placements_of.keys().copied().collect();
63712473×
        nodes.sort();
63812473×
        let mut multi: HashSet<NodeId> = HashSet::new();
639
        // Each node's mode and the atom it comes from, for the entries.
64012473×
        let mut modes: HashMap<NodeId, (Option<OpKey>, Mode)> = HashMap::new();
6416763998×
        for n in &nodes {
6426763998×
            let lp = self.live_placements(n);
643
            // One placement (nearly every node) cannot be in two places.
6446763998×
            if lp.len() > 1 {
64515×
                let distinct_places: BTreeSet<(&NodeId, &str)> = lp
64615×
                    .iter()
64730×
                    .map(|(_, p)| (&p.parent, p.name.as_str()))
64815×
                    .collect();
64915×
                if distinct_places.len() > 1 {
6502×
                    multi.insert(*n);
6512×
                    view.conflicts.push(TreeConflict::MultiPlacement {
6522×
                        node: *n,
6532×
                        placements: lp.iter().map(|(k, _)| *k).collect(),
654
                    });
65513×
                }
6566763983×
            }
6576763998×
            let lm = self.live_modes(n);
6586763998×
            if lm.len() > 1 {
6592×
                let distinct_modes: BTreeSet<Mode> = lm.iter().map(|(_, m)| *m).collect();
6602×
                if distinct_modes.len() > 1 {
6611×
                    view.conflicts.push(TreeConflict::Mode {
6621×
                        node: *n,
6631×
                        modes: distinct_modes.into_iter().collect(),
6641×
                    });
6651×
                }
6666763996×
            }
6676763998×
            let mode_atom = lm.iter().map(|(k, _)| *k).max();
6686763998×
            let mode = mode_atom
6696763998×
                .and_then(|k| self.m().modes.get(&k).map(|(_, m)| *m))
6706763998×
                .unwrap_or_default();
6716763998×
            modes.insert(*n, (mode_atom, mode));
672
        }
673
674
        // BFS from the root, assigning paths.
67512473×
        let mut reached: HashSet<NodeId> = HashSet::new();
67612473×
        reached.insert(NodeId::ROOT);
67712473×
        let mut queue: Vec<(NodeId, String)> = vec![(NodeId::ROOT, String::new())];
67812473×
        let mut on_path: HashSet<NodeId> = HashSet::new();
67933956×
        while let Some((dir, dir_path)) = queue.pop() {
68021483×
            let Some(kids) = children.get(&dir) else {
6811795×
                continue;
682
            };
683
            // Name conflicts within this directory: the children are sorted
684
            // by name, so each name's group is a run of them.
68519688×
            let mut groups: Vec<(&str, &[(OpKey, &Placement)])> = Vec::new();
68619688×
            let mut start = 0;
6876764007×
            for i in 1..=kids.len() {
6886764007×
                if i == kids.len() || kids[i].1.name != kids[start].1.name {
6896763729×
                    groups.push((kids[start].1.name.as_str(), &kids[start..i]));
6906763729×
                    start = i;
6916763729×
                }
692
            }
6936763729×
            for (name, group) in groups {
6946763729×
                let distinct: BTreeSet<NodeId> = group.iter().map(|(_, p)| p.node).collect();
6956763729×
                if distinct.len() > 1 {
696226×
                    view.conflicts.push(TreeConflict::Name {
697226×
                        parent: dir,
698226×
                        name: name.to_string(),
699226×
                        nodes: distinct.iter().copied().collect(),
700226×
                    });
7016763503×
                }
7026763729×
                let suffixed = distinct.len() > 1;
7036764007×
                for (i, (k, p)) in group.iter().enumerate() {
7046764007×
                    let node = p.node;
7056764007×
                    if node == dir || on_path.contains(&node) {
7060×
                        view.conflicts.push(TreeConflict::Cycle { node });
7070×
                        continue;
7086764007×
                    }
7096764007×
                    let needs_suffix = suffixed || multi.contains(&node);
7106764007×
                    let leaf = if needs_suffix {
711494×
                        format!("{name}.oxy-conflict-{}", i + 1)
712
                    } else {
7136763513×
                        name.to_string()
714
                    };
7156764007×
                    let path = if dir_path.is_empty() {
71617761×
                        leaf
717
                    } else {
7186746246×
                        format!("{dir_path}/{leaf}")
719
                    };
7206764007×
                    let kind = self.kind(&node).unwrap_or(NodeKind::File);
7216764007×
                    let (mode_atom, mode) = modes.get(&node).copied().unwrap_or_default();
7226764007×
                    entries.insert(
7236764007×
                        path.clone(),
7246764007×
                        TreeEntry {
7256764007×
                            path: path.clone(),
7266764007×
                            node,
7276764007×
                            kind,
7286764007×
                            mode,
7296764007×
                            placement: *k,
7306764007×
                            mode_atom,
7316764007×
                        },
732
                    );
7336764007×
                    if kind == NodeKind::Dir && reached.insert(node) {
7349010×
                        on_path.insert(dir);
7359010×
                        queue.push((node, path));
7366754997×
                    } else {
7376754997×
                        reached.insert(node);
7386754997×
                    }
739
                }
740
            }
741
        }
742
743
        // Nodes with live placements that were never reached: orphans or cycles.
7446763998×
        for n in &nodes {
7456763998×
            if reached.contains(n) {
7466763993×
                continue;
7475×
            }
7485×
            let lp = self.live_placements(n);
7495×
            if lp.is_empty() {
7500×
                continue;
7515×
            }
7525×
            let mut seen = HashSet::new();
7535×
            let mut cur = *n;
7545×
            let conflict = loop {
75512×
                if !seen.insert(cur) {
7562×
                    break TreeConflict::Cycle { node: *n };
75710×
                }
75810×
                let lp = self.live_placements(&cur);
75910×
                let Some((_, p)) = lp.first() else {
7603×
                    break TreeConflict::Orphan {
7613×
                        node: *n,
7623×
                        parent: cur,
7633×
                    };
764
                };
7657×
                if reached.contains(&p.parent) {
766
                    // Parent reached but this node was not: the parent is not a
767
                    // directory, so this is a name/kind problem surfaced as orphan.
7680×
                    break TreeConflict::Orphan {
7690×
                        node: *n,
7700×
                        parent: p.parent,
7710×
                    };
7727×
                }
7737×
                cur = p.parent;
774
            };
7755×
            if !view.conflicts.contains(&conflict) {
7765×
                view.conflicts.push(conflict);
7775×
            }
778
        }
77912473×
        view.entries = std::sync::Arc::new(entries);
78012473×
        view
78112473×
    }
782
}
783
784
impl TreeGraph {
785
    /// Serialize for a checkpoint.
786400×
    pub fn to_value(&self) -> crate::cbor::Value {
787
        use crate::cbor::Value;
7884286×
        let opkey = |k: &OpKey| vec![Value::Bytes(k.0 .0.to_vec()), Value::Uint(k.1 as u64)];
789800×
        let deleters = |m: &Map<OpKey, BTreeSet<ChangeHash>>| {
790800×
            let mut ks: Vec<&OpKey> = m.keys().collect();
791800×
            ks.sort();
792
            Value::Array(
793800×
                ks.into_iter()
794800×
                    .map(|k| {
795334×
                        let mut v = opkey(k);
796334×
                        v.push(Value::Array(
797345×
                            m[k].iter().map(|d| Value::Bytes(d.0.to_vec())).collect(),
798
                        ));
799334×
                        Value::Array(v)
800334×
                    })
801800×
                    .collect(),
802
            )
803800×
        };
804400×
        let mut nodes: Vec<&NodeId> = self.m().kinds.keys().collect();
805400×
        nodes.sort();
806400×
        let mut pks: Vec<&OpKey> = self.m().placements.keys().collect();
807400×
        pks.sort();
808400×
        let mut mks: Vec<&OpKey> = self.m().modes.keys().collect();
809400×
        mks.sort();
810400×
        Value::map([
811
            (
812
                0,
813
                Value::Array(
814400×
                    nodes
815400×
                        .into_iter()
8162173×
                        .map(|n| {
8172173×
                            Value::Array(vec![
8182173×
                                Value::Bytes(n.0.to_vec()),
8192173×
                                Value::Uint(self.m().kinds[n].tag()),
8202173×
                                self.m()
8212173×
                                    .introduced
8222173×
                                    .get(n)
8232173×
                                    .map(|h| Value::Bytes(h.0.to_vec()))
8242173×
                                    .unwrap_or(Value::Null),
825
                            ])
8262173×
                        })
827400×
                        .collect(),
828
                ),
829
            ),
830
            (
831
                1,
832
                Value::Array(
833400×
                    pks.into_iter()
8342175×
                        .map(|k| {
8352175×
                            let p = &self.m().placements[k];
8362175×
                            let mut v = opkey(k);
8372175×
                            v.extend([
8382175×
                                Value::Bytes(p.node.0.to_vec()),
8392175×
                                Value::Bytes(p.parent.0.to_vec()),
8402175×
                                Value::Text(p.name.clone()),
8412175×
                            ]);
8422175×
                            Value::Array(v)
8432175×
                        })
844400×
                        .collect(),
845
                ),
846
            ),
847400×
            (2, deleters(&self.m().deleted_placements)),
848
            (
849
                3,
850
                Value::Array(
851400×
                    mks.into_iter()
8521777×
                        .map(|k| {
8531777×
                            let (n, m) = &self.m().modes[k];
8541777×
                            let mut v = opkey(k);
8551777×
                            v.extend([Value::Bytes(n.0.to_vec()), Value::Uint(m.bits())]);
8561777×
                            Value::Array(v)
8571777×
                        })
858400×
                        .collect(),
859
                ),
860
            ),
861400×
            (4, deleters(&self.m().deleted_modes)),
862
        ])
863400×
    }
864
865100×
    pub fn from_value(v: &crate::cbor::Value) -> Result<TreeGraph, crate::objects::ObjectError> {
866
        use crate::objects::{array, bytes, field, map, oref, text, u32_, uint, ObjectError};
867100×
        let m = map(v, "tree graph")?;
8681730×
        let node = |v: &crate::cbor::Value| {
8691730×
            NodeId::from_slice(bytes(v, "node")?)
8701730×
                .ok_or_else(|| ObjectError::Schema("node: expected 16 bytes".into()))
8711730×
        };
872879×
        let opkey = |e: &[crate::cbor::Value]| -> Result<OpKey, ObjectError> {
873879×
            Ok((oref(&e[0], "op change")?, u32_(&e[1], "op index")?))
874879×
        };
875100×
        let mut g = TreeGraph::default();
876441×
        for n in array(field(m, 0, "nodes")?, "nodes")? {
877441×
            let e = array(n, "node entry")?;
878441×
            if e.len() != 3 {
8790×
                return Err(ObjectError::Schema("node entry: expected 3 fields".into()));
880441×
            }
881441×
            let id = node(&e[0])?;
882441×
            g.m_mut()
883441×
                .kinds
884441×
                .insert(id, NodeKind::from_tag(uint(&e[1], "kind")?)?);
885441×
            if !e[2].is_null() {
886441×
                g.m_mut().introduced.insert(id, oref(&e[2], "introducer")?);
8870×
            }
888
        }
889442×
        for p in array(field(m, 1, "placements")?, "placements")? {
890442×
            let e = array(p, "placement")?;
891442×
            if e.len() != 5 {
8920×
                return Err(ObjectError::Schema("placement: expected 5 fields".into()));
893442×
            }
894442×
            let k = opkey(e)?;
895442×
            let pl = Placement {
896442×
                node: node(&e[2])?,
897442×
                parent: node(&e[3])?,
898442×
                name: text(&e[4], "name")?.to_owned(),
899
            };
900442×
            g.m_mut()
901442×
                .placements_of
902442×
                .entry(pl.node)
903442×
                .or_default()
904442×
                .insert(k);
905442×
            g.m_mut().placements.insert(k, pl);
906
        }
907100×
        let deleters = |v: &crate::cbor::Value,
908
                        what: &str|
909200×
         -> Result<Map<OpKey, BTreeSet<ChangeHash>>, ObjectError> {
910200×
            let mut out = Map::default();
911200×
            for d in array(v, what)? {
91232×
                let e = array(d, what)?;
91332×
                if e.len() != 3 {
9140×
                    return Err(ObjectError::Schema(format!("{what}: expected 3 fields")));
91532×
                }
91632×
                out.insert(
91732×
                    opkey(e)?,
91832×
                    array(&e[2], "deleters")?
91932×
                        .iter()
92033×
                        .map(|x| oref(x, "deleter"))
92132×
                        .collect::<Result<BTreeSet<_>, _>>()?,
922
                );
923
            }
924200×
            Ok(out)
925200×
        };
926100×
        g.m_mut().deleted_placements =
927100×
            deleters(field(m, 2, "deleted placements")?, "deleted placement")?;
928405×
        for md in array(field(m, 3, "modes")?, "modes")? {
929405×
            let e = array(md, "mode")?;
930405×
            if e.len() != 4 {
9310×
                return Err(ObjectError::Schema("mode: expected 4 fields".into()));
932405×
            }
933405×
            let k = opkey(e)?;
934405×
            let n = node(&e[2])?;
935405×
            g.m_mut()
936405×
                .modes
937405×
                .insert(k, (n, Mode::from_bits(uint(&e[3], "mode bits")?)?));
938405×
            g.m_mut().modes_of.entry(n).or_default().insert(k);
939
        }
940100×
        g.m_mut().deleted_modes = deleters(field(m, 4, "deleted modes")?, "deleted mode")?;
941100×
        let keys: Vec<OpKey> = g.m_mut().placements.keys().copied().collect();
942442×
        for k in keys {
943442×
            g.index_placement(k);
944442×
        }
945100×
        let keys: Vec<OpKey> = g.m_mut().modes.keys().copied().collect();
946405×
        for k in keys {
947405×
            g.index_mode(k);
948405×
        }
949100×
        Ok(g)
950100×
    }
951
}
952
953
/// The tree in the flat layout of a local index (oxygen#41), with its view
954
/// when that has no conflicts, so a loaded tree need not work it out again.
955
impl TreeGraph {
956919×
    pub(crate) fn write_flat(&self, w: &mut crate::flat::Writer) {
957130952×
        let key = |w: &mut crate::flat::Writer, k: &OpKey| {
958130952×
            w.object(&k.0);
959130952×
            w.u32(k.1);
960130952×
        };
961
        // The maps as a block of their own: a reader keeps it undecoded
962
        // until something needs them.
963919×
        let outer = std::mem::take(w);
964919×
        let mut kinds: Vec<(&NodeId, &NodeKind)> = self.m().kinds.iter().collect();
965919×
        kinds.sort_by_key(|(n, _)| **n);
966919×
        w.count(kinds.len());
96732758×
        for (n, k) in kinds {
96832758×
            w.fixed(&n.0);
96932758×
            w.u8(k.tag() as u8);
97032758×
        }
971919×
        let mut intro: Vec<(&NodeId, &ChangeHash)> = self.m().introduced.iter().collect();
972919×
        intro.sort();
973919×
        w.count(intro.len());
97432758×
        for (n, c) in intro {
97532758×
            w.fixed(&n.0);
97632758×
            w.object(c);
97732758×
        }
978919×
        let mut pl: Vec<(&OpKey, &Placement)> = self.m().placements.iter().collect();
979919×
        pl.sort_by_key(|(k, _)| **k);
980919×
        w.count(pl.len());
98132758×
        for (k, p) in pl {
98232758×
            key(w, k);
98332758×
            w.fixed(&p.node.0);
98432758×
            w.fixed(&p.parent.0);
98532758×
            w.bytes(p.name.as_bytes());
98632758×
        }
987919×
        let mut modes: Vec<(&OpKey, &(NodeId, Mode))> = self.m().modes.iter().collect();
988919×
        modes.sort_by_key(|(k, _)| **k);
989919×
        w.count(modes.len());
99032718×
        for (k, (n, m)) in modes {
99132718×
            key(w, k);
99232718×
            w.fixed(&n.0);
99332718×
            w.u8(m.bits() as u8);
99432718×
        }
9951838×
        for m in [&self.m().deleted_placements, &self.m().deleted_modes] {
9961838×
            let mut ks: Vec<(&OpKey, &BTreeSet<ChangeHash>)> = m.iter().collect();
9971838×
            ks.sort_by_key(|(k, _)| **k);
9981838×
            w.count(ks.len());
9991838×
            for (k, by) in ks {
10000×
                key(w, k);
10010×
                w.count(by.len());
10020×
                for c in by {
10030×
                    w.object(c);
10040×
                }
1005
            }
1006
        }
1007919×
        let maps = std::mem::replace(w, outer);
1008919×
        w.bytes(&maps.0);
1009
        // The introducers again, alone, for a reader that needs no more.
1010919×
        let mut iw = crate::flat::Writer::default();
1011919×
        let mut intro: Vec<(&NodeId, &ChangeHash)> = self.m().introduced.iter().collect();
1012919×
        intro.sort();
1013919×
        iw.count(intro.len());
101432758×
        for (n, c) in intro {
101532758×
            iw.fixed(&n.0);
101632758×
            iw.object(c);
101732758×
        }
1018919×
        w.bytes(&iw.0);
1019
        // The view as a block of its own.
1020919×
        let outer = std::mem::take(w);
1021919×
        let view = self.view();
1022919×
        if view.conflicts.is_empty() {
1023919×
            w.u8(1);
1024919×
            w.count(view.entries.len());
102532758×
            for (path, e) in view.entries.iter() {
102632758×
                w.bytes(path.as_bytes());
102732758×
                w.fixed(&e.node.0);
102832758×
                w.u8(e.kind.tag() as u8);
102932758×
                w.u8(e.mode.bits() as u8);
103032758×
                key(w, &e.placement);
103132758×
                match &e.mode_atom {
103240×
                    None => w.u8(0),
103332718×
                    Some(k) => {
103432718×
                        w.u8(1);
103532718×
                        key(w, k);
103632718×
                    }
1037
                }
1038
            }
10390×
        } else {
10400×
            w.u8(0);
10410×
        }
1042919×
        let view_bytes = std::mem::replace(w, outer);
1043919×
        w.bytes(&view_bytes.0);
1044919×
    }
1045
10461801×
    pub(crate) fn read_flat(
10471801×
        r: &mut crate::flat::Reader,
10481801×
    ) -> Result<TreeGraph, crate::objects::ObjectError> {
10491801×
        let maps = r.bytes()?;
10501801×
        let introduced = r.bytes()?;
10511801×
        let view = Self::read_view(r.bytes()?)?;
10521801×
        let mut g = TreeGraph {
10531801×
            raw: Some(std::sync::Arc::new(maps.to_vec())),
10541801×
            raw_introduced: Some(std::sync::Arc::new(introduced.to_vec())),
10551801×
            ..TreeGraph::default()
10561801×
        };
10571801×
        if let Some(view) = view {
1058747×
            // Checked on a copy, so the graph itself stays undecoded.
1059747×
            #[cfg(test)]
10601054×
            assert_eq!(
1061747×
                view,
10621054×
                TreeGraph {
10631054×
                    raw: g.raw.clone(),
10641054×
                    ..TreeGraph::default()
10651054×
                }
10661054×
                .compute_view(),
1067747×
                "an index's view is the tree's"
1068747×
            );
10691801×
            g.view_cache = std::sync::OnceLock::from(CachedView::new(view));
1070747×
        }
10711801×
        Ok(g)
10721801×
    }
1073
}
1074
1075
impl TreeMaps {
1076
    /// The maps block of a tree's flat form.
10772795×
    fn decode(bytes: &[u8]) -> Result<TreeMaps, crate::objects::ObjectError> {
1078
        use crate::objects::ObjectError;
10792795×
        let _t = crate::timing::phase("index: tree maps");
1080165599×
        let node = |r: &mut crate::flat::Reader| -> Result<NodeId, ObjectError> {
1081165599×
            Ok(NodeId(r.fixed::<16>()?))
1082165599×
        };
108366215×
        let key = |r: &mut crate::flat::Reader| -> Result<OpKey, ObjectError> {
108466215×
            Ok((r.object()?, r.u32()?))
108566215×
        };
10862795×
        let r = &mut crate::flat::Reader::new(bytes);
10872795×
        let mut g = TreeGraph::new();
10882795×
        for _ in 0..r.count()? {
108933128×
            let n = node(r)?;
109033128×
            g.m_mut()
109133128×
                .kinds
109233128×
                .insert(n, NodeKind::from_tag(r.u8()? as u64)?);
1093
        }
10942795×
        for _ in 0..r.count()? {
109533128×
            let n = node(r)?;
109633128×
            g.m_mut().introduced.insert(n, r.object()?);
1097
        }
10982795×
        for _ in 0..r.count()? {
109933128×
            let k = key(r)?;
110033128×
            let p = Placement {
110133128×
                node: node(r)?,
110233128×
                parent: node(r)?,
110333128×
                name: r.text()?,
1104
            };
110533128×
            g.m_mut().placements_of.entry(p.node).or_default().insert(k);
110633128×
            g.m_mut().placements.insert(k, p);
1107
        }
11082795×
        for _ in 0..r.count()? {
110933087×
            let k = key(r)?;
111033087×
            let n = node(r)?;
111133087×
            g.m_mut()
111233087×
                .modes
111333087×
                .insert(k, (n, Mode::from_bits(r.u8()? as u64)?));
111433087×
            g.m_mut().modes_of.entry(n).or_default().insert(k);
1115
        }
11165590×
        for i in 0..2 {
11175590×
            let mut m: Map<OpKey, BTreeSet<ChangeHash>> = Map::default();
11185590×
            for _ in 0..r.count()? {
11190×
                let k = key(r)?;
11200×
                let mut by = BTreeSet::new();
11210×
                for _ in 0..r.count()? {
11220×
                    by.insert(r.object()?);
1123
                }
11240×
                m.insert(k, by);
1125
            }
11265590×
            if i == 0 {
11272795×
                g.m_mut().deleted_placements = m;
11282795×
            } else {
11292795×
                g.m_mut().deleted_modes = m;
11302795×
            }
1131
        }
11322795×
        if !r.at_end() {
11330×
            return Err(ObjectError::Schema("state index: tree maps".into()));
11342795×
        }
11352795×
        let keys: Vec<OpKey> = g.m().placements.keys().copied().collect();
113633128×
        for k in keys {
113733128×
            g.index_placement(k);
113833128×
        }
11392795×
        let keys: Vec<OpKey> = g.m().modes.keys().copied().collect();
114033087×
        for k in keys {
114133087×
            g.index_mode(k);
114233087×
        }
11432795×
        Ok(g.maps.into_inner().unwrap_or_default())
11442795×
    }
1145
}
1146
1147
impl TreeGraph {
1148
    /// The view block of a tree's flat form, when it holds one.
11491801×
    fn read_view(bytes: &[u8]) -> Result<Option<TreeView>, crate::objects::ObjectError> {
11501801×
        let _t = crate::timing::phase("index: view");
11511801×
        let mut r = crate::flat::Reader::new(bytes);
11521801×
        if r.u8()? != 1 {
11530×
            return Ok(None);
11541801×
        }
115533413×
        let key = |r: &mut crate::flat::Reader| -> Result<OpKey, crate::objects::ObjectError> {
115633413×
            Ok((r.object()?, r.u32()?))
115733413×
        };
11581801×
        let n = r.count()?;
1159
        // Collected, then built in one step: the map is made from sorted
1160
        // input in a single pass rather than by searching for each insert.
11611801×
        let mut entries = Vec::with_capacity(n);
11621801×
        for _ in 0..n {
116316717×
            let path = r.text()?;
116416717×
            let e = TreeEntry {
116516717×
                path: path.clone(),
116616717×
                node: NodeId(r.fixed::<16>()?),
116716717×
                kind: NodeKind::from_tag(r.u8()? as u64)?,
116816717×
                mode: Mode::from_bits(r.u8()? as u64)?,
116916717×
                placement: key(&mut r)?,
117016717×
                mode_atom: match r.u8()? {
117121×
                    0 => None,
117216696×
                    _ => Some(key(&mut r)?),
1173
                },
1174
            };
117516717×
            entries.push((path, e));
1176
        }
11771801×
        Ok(Some(TreeView {
11781801×
            entries: std::sync::Arc::new(entries.into_iter().collect()),
11791801×
            conflicts: Vec::new(),
11801801×
        }))
11811801×
    }
1182
}
1183
1184
/// The introducers block of a tree's flat form.
118559×
fn read_introduced(bytes: &[u8]) -> Result<Map<NodeId, ChangeHash>, crate::objects::ObjectError> {
118659×
    let r = &mut crate::flat::Reader::new(bytes);
118759×
    let n = r.count()?;
118859×
    let mut m = Map::default();
118959×
    m.reserve(n);
119059×
    for _ in 0..n {
11910×
        let node = NodeId(r.fixed::<16>()?);
11920×
        m.insert(node, r.object()?);
1193
    }
119459×
    Ok(m)
119559×
}
1196
119712005×
fn join(dir: &str, name: &str) -> String {
119812005×
    if dir.is_empty() {
11994049×
        name.to_string()
1200
    } else {
12017956×
        format!("{dir}/{name}")
1202
    }
120312005×
}
1204
12052926×
pub fn op_key(r: OpRef) -> OpKey {
12062926×
    (r.change, r.index)
12072926×
}
1208
1209
#[cfg(test)]
1210
mod tests {
1211
    use super::*;
1212
    use crate::hash::ObjectRef;
1213
121454×
    fn h(n: u8) -> ChangeHash {
121554×
        ObjectRef([n; 32])
121654×
    }
121751×
    fn nid(n: u8) -> NodeId {
121851×
        NodeId([n; 16])
121951×
    }
122014×
    fn add(g: &mut TreeGraph, c: u8, i: u32, node: u8, kind: NodeKind, parent: NodeId, name: &str) {
122114×
        g.apply(
122214×
            h(c),
122314×
            i,
122414×
            &TreeOp::AddNode {
122514×
                node: nid(node),
122614×
                kind,
122714×
                mode: Mode::TEXT,
122814×
                parent,
122914×
                name: name.into(),
123014×
            },
1231
        );
123214×
    }
12337×
    fn paths(v: &TreeView) -> Vec<String> {
12347×
        v.entries.keys().cloned().collect()
12357×
    }
1236
1237
    /// Each op applied to a graph whose view is cached keeps it up to date
1238
    /// or drops it: `apply` checks every kept view against a full one.
1239
    #[test]
12401×
    fn cached_view_follows_ops() {
12411×
        let at = |c: u8, i: u32| OpRef {
12424×
            change: h(c),
12434×
            index: i,
12444×
        };
12451×
        let mut g = TreeGraph::new();
12461×
        let ops = [
12471×
            TreeOp::AddNode {
12481×
                node: nid(1),
12491×
                kind: NodeKind::Dir,
12501×
                mode: Mode::TEXT,
12511×
                parent: NodeId::ROOT,
12521×
                name: "src".into(),
12531×
            },
12541×
            TreeOp::AddNode {
12551×
                node: nid(2),
12561×
                kind: NodeKind::File,
12571×
                mode: Mode::TEXT,
12581×
                parent: nid(1),
12591×
                name: "a.rs".into(),
12601×
            },
12611×
            TreeOp::SetMode {
12621×
                node: nid(2),
12631×
                old: at(1, 1),
12641×
                mode: Mode {
12651×
                    exec: true,
12661×
                    opaque: false,
12671×
                },
12681×
            },
12691×
            TreeOp::Move {
12701×
                node: nid(2),
12711×
                old: at(1, 1),
12721×
                parent: NodeId::ROOT,
12731×
                name: "b.rs".into(),
12741×
            },
12751×
            // Moving an empty directory, then removing it.
12761×
            TreeOp::Move {
12771×
                node: nid(1),
12781×
                old: at(1, 0),
12791×
                parent: NodeId::ROOT,
12801×
                name: "lib".into(),
12811×
            },
12821×
            TreeOp::RemoveNode {
12831×
                node: nid(1),
12841×
                placement: at(1, 4),
12851×
            },
12861×
            // A name taken twice: a conflict, so the view is computed again.
12871×
            TreeOp::AddNode {
12881×
                node: nid(3),
12891×
                kind: NodeKind::File,
12901×
                mode: Mode::TEXT,
12911×
                parent: NodeId::ROOT,
12921×
                name: "b.rs".into(),
12931×
            },
12941×
        ];
12957×
        for (i, op) in ops.iter().enumerate() {
12967×
            let _ = g.view();
12977×
            g.apply(h(1), i as u32, op);
12987×
            assert_eq!(g.view(), g.compute_view());
1299
        }
13001×
        let v = g.view();
13011×
        assert_eq!(paths(&v), ["b.rs.oxy-conflict-1", "b.rs.oxy-conflict-2"]);
13021×
        assert!(v.entries.values().any(|e| e.mode.exec));
13031×
    }
1304
1305
    #[test]
13061×
    fn nested_paths_and_rename() {
13071×
        let mut g = TreeGraph::new();
13081×
        add(&mut g, 1, 0, 1, NodeKind::Dir, NodeId::ROOT, "src");
13091×
        add(&mut g, 1, 1, 2, NodeKind::File, nid(1), "main.rs");
13101×
        add(&mut g, 1, 2, 3, NodeKind::File, NodeId::ROOT, "README");
13111×
        let v = g.view();
13121×
        assert_eq!(paths(&v), ["README", "src", "src/main.rs"]);
13131×
        assert!(!v.is_conflicted());
1314
1315
        // Rename src/main.rs → src/lib.rs, move src → lib (subtree follows).
13161×
        g.apply(
13171×
            h(2),
1318
            0,
13191×
            &TreeOp::Move {
13201×
                node: nid(2),
13211×
                old: OpRef {
13221×
                    change: h(1),
13231×
                    index: 1,
13241×
                },
13251×
                parent: nid(1),
13261×
                name: "lib.rs".into(),
13271×
            },
1328
        );
13291×
        g.apply(
13301×
            h(2),
1331
            1,
13321×
            &TreeOp::Move {
13331×
                node: nid(1),
13341×
                old: OpRef {
13351×
                    change: h(1),
13361×
                    index: 0,
13371×
                },
13381×
                parent: NodeId::ROOT,
13391×
                name: "lib".into(),
13401×
            },
1341
        );
13421×
        let v = g.view();
13431×
        assert_eq!(paths(&v), ["README", "lib", "lib/lib.rs"]);
13441×
        assert_eq!(v.entries["lib/lib.rs"].placement, (h(2), 0));
1345
13461×
        g.apply(
13471×
            h(3),
1348
            0,
13491×
            &TreeOp::RemoveNode {
13501×
                node: nid(3),
13511×
                placement: OpRef {
13521×
                    change: h(1),
13531×
                    index: 2,
13541×
                },
13551×
            },
1356
        );
13571×
        assert_eq!(paths(&g.view()), ["lib", "lib/lib.rs"]);
13581×
    }
1359
1360
    #[test]
13611×
    fn name_conflict_gets_suffixes() {
13621×
        let mut g = TreeGraph::new();
13631×
        add(&mut g, 1, 0, 1, NodeKind::File, NodeId::ROOT, "a.txt");
13641×
        add(&mut g, 2, 0, 2, NodeKind::File, NodeId::ROOT, "a.txt");
13651×
        let v = g.view();
13661×
        assert_eq!(paths(&v), ["a.txt.oxy-conflict-1", "a.txt.oxy-conflict-2"]);
13671×
        assert_eq!(
1368
            v.conflicts,
13691×
            vec![TreeConflict::Name {
13701×
                parent: NodeId::ROOT,
13711×
                name: "a.txt".into(),
13721×
                nodes: vec![nid(1), nid(2)]
13731×
            }]
1374
        );
13751×
    }
1376
1377
    #[test]
13781×
    fn concurrent_renames_are_multi_placement() {
13791×
        let mut g = TreeGraph::new();
13801×
        add(&mut g, 1, 0, 1, NodeKind::File, NodeId::ROOT, "a");
13811×
        g.apply(
13821×
            h(2),
1383
            0,
13841×
            &TreeOp::Move {
13851×
                node: nid(1),
13861×
                old: OpRef {
13871×
                    change: h(1),
13881×
                    index: 0,
13891×
                },
13901×
                parent: NodeId::ROOT,
13911×
                name: "b".into(),
13921×
            },
1393
        );
13941×
        g.apply(
13951×
            h(3),
1396
            0,
13971×
            &TreeOp::Move {
13981×
                node: nid(1),
13991×
                old: OpRef {
14001×
                    change: h(1),
14011×
                    index: 0,
14021×
                },
14031×
                parent: NodeId::ROOT,
14041×
                name: "c".into(),
14051×
            },
1406
        );
14071×
        let v = g.view();
14081×
        assert_eq!(paths(&v), ["b.oxy-conflict-1", "c.oxy-conflict-1"]);
14091×
        assert!(
14101×
            matches!(v.conflicts[0], TreeConflict::MultiPlacement { node, .. } if node == nid(1))
1411
        );
14121×
    }
1413
1414
    #[test]
14151×
    fn orphan_and_cycle() {
14161×
        let mut g = TreeGraph::new();
14171×
        add(&mut g, 1, 0, 1, NodeKind::Dir, NodeId::ROOT, "d");
14181×
        add(&mut g, 1, 1, 2, NodeKind::File, nid(1), "f");
1419
        // Concurrently: 2 removes d, 3 adds d/g.
14201×
        g.apply(
14211×
            h(2),
1422
            0,
14231×
            &TreeOp::RemoveNode {
14241×
                node: nid(1),
14251×
                placement: OpRef {
14261×
                    change: h(1),
14271×
                    index: 0,
14281×
                },
14291×
            },
1430
        );
14311×
        add(&mut g, 3, 0, 3, NodeKind::File, nid(1), "g");
14321×
        let v = g.view();
14331×
        assert_eq!(paths(&v), Vec::<String>::new());
14341×
        assert!(v.conflicts.contains(&TreeConflict::Orphan {
14351×
            node: nid(2),
14361×
            parent: nid(1)
14371×
        }));
14381×
        assert!(v.conflicts.contains(&TreeConflict::Orphan {
14391×
            node: nid(3),
14401×
            parent: nid(1)
14411×
        }));
1442
1443
        // Cycle: a/b, then concurrently move a under b and b under a's parent... simplest: move a into b.
14441×
        let mut g = TreeGraph::new();
14451×
        add(&mut g, 1, 0, 1, NodeKind::Dir, NodeId::ROOT, "a");
14461×
        add(&mut g, 1, 1, 2, NodeKind::Dir, nid(1), "b");
14471×
        g.apply(
14481×
            h(2),
1449
            0,
14501×
            &TreeOp::Move {
14511×
                node: nid(1),
14521×
                old: OpRef {
14531×
                    change: h(1),
14541×
                    index: 0,
14551×
                },
14561×
                parent: nid(2),
14571×
                name: "a".into(),
14581×
            },
1459
        );
14601×
        let v = g.view();
14611×
        assert!(
14621×
            v.conflicts
14631×
                .iter()
14641×
                .any(|c| matches!(c, TreeConflict::Cycle { .. })),
1465
            "{:?}",
1466
            v.conflicts
1467
        );
14681×
    }
1469
1470
    #[test]
14711×
    fn serialization_round_trip() {
14721×
        let mut g = TreeGraph::new();
14731×
        add(&mut g, 1, 0, 1, NodeKind::Dir, NodeId::ROOT, "src");
14741×
        add(&mut g, 1, 1, 2, NodeKind::File, nid(1), "main.rs");
14751×
        g.apply(
14761×
            h(2),
1477
            0,
14781×
            &TreeOp::Move {
14791×
                node: nid(2),
14801×
                old: OpRef {
14811×
                    change: h(1),
14821×
                    index: 1,
14831×
                },
14841×
                parent: nid(1),
14851×
                name: "lib.rs".into(),
14861×
            },
1487
        );
14881×
        g.apply(
14891×
            h(3),
1490
            0,
14911×
            &TreeOp::SetMode {
14921×
                node: nid(2),
14931×
                old: OpRef {
14941×
                    change: h(1),
14951×
                    index: 1,
14961×
                },
14971×
                mode: Mode {
14981×
                    exec: true,
14991×
                    opaque: false,
15001×
                },
15011×
            },
1502
        );
15031×
        let bytes = crate::cbor::encode(&g.to_value());
15041×
        let back = TreeGraph::from_value(&crate::cbor::decode(&bytes).unwrap()).unwrap();
15051×
        assert_eq!(back.view(), g.view());
15061×
        assert_eq!(back.introducer(&nid(2)), Some(h(1)));
15071×
        assert_eq!(crate::cbor::encode(&back.to_value()), bytes);
15081×
    }
1509
1510
    #[test]
15111×
    fn mode_conflict_and_resolution() {
15121×
        let mut g = TreeGraph::new();
15131×
        add(&mut g, 1, 0, 1, NodeKind::File, NodeId::ROOT, "run.sh");
15141×
        g.apply(
15151×
            h(2),
1516
            0,
15171×
            &TreeOp::SetMode {
15181×
                node: nid(1),
15191×
                old: OpRef {
15201×
                    change: h(1),
15211×
                    index: 0,
15221×
                },
15231×
                mode: Mode {
15241×
                    exec: true,
15251×
                    opaque: false,
15261×
                },
15271×
            },
1528
        );
15291×
        g.apply(
15301×
            h(3),
1531
            0,
15321×
            &TreeOp::SetMode {
15331×
                node: nid(1),
15341×
                old: OpRef {
15351×
                    change: h(1),
15361×
                    index: 0,
15371×
                },
15381×
                mode: Mode {
15391×
                    exec: false,
15401×
                    opaque: true,
15411×
                },
15421×
            },
1543
        );
15441×
        let v = g.view();
15451×
        assert!(matches!(v.conflicts[0], TreeConflict::Mode { .. }));
1546
        // Materialized with the greatest mode atom.
15471×
        assert_eq!(
15481×
            v.entries["run.sh"].mode,
1549
            Mode {
1550
                exec: false,
1551
                opaque: true
1552
            }
1553
        );
1554
        // The placement introduced by the same AddNode is unaffected.
15551×
        assert_eq!(v.entries["run.sh"].placement, (h(1), 0));
1556
        // Resolution: retire both live mode atoms; identical live values do not conflict.
15571×
        g.apply(
15581×
            h(4),
1559
            0,
15601×
            &TreeOp::SetMode {
15611×
                node: nid(1),
15621×
                old: OpRef {
15631×
                    change: h(2),
15641×
                    index: 0,
15651×
                },
15661×
                mode: Mode {
15671×
                    exec: true,
15681×
                    opaque: false,
15691×
                },
15701×
            },
1571
        );
15721×
        g.apply(
15731×
            h(4),
1574
            1,
15751×
            &TreeOp::SetMode {
15761×
                node: nid(1),
15771×
                old: OpRef {
15781×
                    change: h(3),
15791×
                    index: 0,
15801×
                },
15811×
                mode: Mode {
15821×
                    exec: true,
15831×
                    opaque: false,
15841×
                },
15851×
            },
1586
        );
15871×
        let v = g.view();
15881×
        assert!(!v.is_conflicted(), "{:?}", v.conflicts);
15891×
        assert_eq!(
15901×
            v.entries["run.sh"].mode,
1591
            Mode {
1592
                exec: true,
1593
                opaque: false
1594
            }
1595
        );
15961×
    }
1597
}