Scanned by phdoc 0.1.0 on 2026-11-22 (Exocortical Epoch 95). Project root: /home/wbic16/phdoc-sweep/proj/holo-phext/. Scanned at commit 50accbe7b15cafc2816846c4c1d6441d1d573a56. Every fact in this document was read from its own records: its manifests, its git log, and its source text. Nothing here was guessed.
This document holds: what the project depends on, who wrote it, how large and how complex it is, the state of its quality signals, the RFCs it declares, where its upstream repo lives, and a plain English note for every public method and command.
License stated in the manifest: MIT.
Direct dependencies: 4.
libphext [dependencies] — 0.6.2".Total packages in the lock file, this one included: 23.
License stated in the manifest: MIT.
Direct dependencies: 4.
Total packages in the lock file, this one included: 23.
The git log holds 5 commits.
The author of record is Will Bickford — 5 commits folded into his account. Will's ruling (2026-11-22): all Exocortical authors fold into his account — "I speak for the cluster." The fold is presentation only: the git history is unchanged, and the per-persona detail is kept as annotation.
Annotation, by persona (all folded into Will Bickford):
The measure is stated plainly, and no single score is made: lines are counted per file as total lines, blank lines, comment lines, and code lines (total minus blank minus comment). Functions are counted where the scanner reads them, and the largest functions are given by their span in lines.
All languages: 13 files, 2105 lines total, 1653 lines of code. Functions read: 104.
Largest files:
Largest functions, by span in lines:
Each signal is named and shown with its evidence. A signal is a fact the scanner read, not a grade.
No rfcs.json was found in this project, so it declares no RFCs. This is a finding, not an error: the project has not made an RFC declaration.
Every public method and command the scanner found, each with a plain English note. A note says where its words came from: the code's own doc comment, the item's signature, the user's agent, or it is marked awaiting a summary.
main (holo-edit/src/bin/holo-dump.rs:19) — The entry point: the program starts here.main (holo-edit/src/bin/holo-edit.rs:337) — The entry point: the program starts here.--local (holo-edit/src/bin/holo-edit.rs:344) — A command named --local.--port (holo-edit/src/bin/holo-edit.rs:347) — A command named --port.LatticeStore (src/compat.rs:35) — A data shape named LatticeStore.LatticeStore::open (src/compat.rs:42) — Function LatticeStore::open takes path: P and gives back io::Result<LatticeStore>.read_scroll (src/compat.rs:47) — Function read_scroll takes &self, coord: &Coordinate and gives back Option<String>.write_scroll (src/compat.rs:54) — Function write_scroll takes &mut self, coord: Coordinate, content: String and gives back bool.delete_scroll (src/compat.rs:63) — Function delete_scroll takes &mut self, coord: Coordinate and gives back nothing; it does its work on what it is given.has_scroll (src/compat.rs:67) — Function has_scroll takes &self, coord: &Coordinate and gives back bool.populated_coordinates (src/compat.rs:71) — Function populated_coordinates takes no inputs beyond the value it is called on, and gives back Vec<Coordinate>.scroll_count (src/compat.rs:89) — Function scroll_count takes no inputs beyond the value it is called on, and gives back usize.is_dirty (src/compat.rs:93) — Function is_dirty takes no inputs beyond the value it is called on, and gives back bool.pending_changes (src/compat.rs:97) — Function pending_changes takes no inputs beyond the value it is called on, and gives back usize.revert (src/compat.rs:101) — Function revert takes no inputs beyond the value it is called on, and gives back nothing; it does its work on what it issave (src/compat.rs:108) — Commits the staged changes as one transaction, then checkpoints — after save, the base file at path() is the completto_phext_bytes (src/compat.rs:121) — The merged document (base + committed overlay + staged), serialized — MappedLattice::to_phext_bytes.path (src/compat.rs:143) — Function path takes no inputs beyond the value it is called on, and gives back &Path.core (src/compat.rs:149) — Access to the underlying core, for servers that want the transactional interface alongside the lattice surface.Op (src/core.rs:38) — One write inside a transaction.Txn (src/core.rs:46) — A multi-scroll transaction: a set of ops applied atomically or not at all.Txn::new (src/core.rs:51) — Function Txn::new takes no inputs beyond the value it is called on, and gives back Txn.set (src/core.rs:54) — Function set takes mut self, coord: Coordinate, content: &str and gives back Txn.delete (src/core.rs:58) — Function delete takes mut self, coord: Coordinate and gives back Txn.is_empty (src/core.rs:62) — Function is_empty takes no inputs beyond the value it is called on, and gives back bool.BaseLattice (src/core.rs:68) — The read-only memory-mapped base lattice.BaseLattice::open (src/core.rs:74) — Function BaseLattice::open takes path: &Path and gives back io::Result<BaseLattice>.read_scroll (src/core.rs:88) — Function read_scroll takes &self, coord: &Coordinate and gives back Option<String>.bytes (src/core.rs:94) — Function bytes takes no inputs beyond the value it is called on, and gives back &[u8].coordinates (src/core.rs:98) — Function coordinates takes no inputs beyond the value it is called on, and gives back &[Coordinate].Shared (src/core.rs:105) — Shared, snapshot-able read state.Shared::snapshot (src/core.rs:112) — Function Shared::snapshot takes no inputs beyond the value it is called on, and gives back Snapshot.seq (src/core.rs:120) — Function seq takes no inputs beyond the value it is called on, and gives back u64.Snapshot (src/core.rs:126) — A frozen read view at one sequence number.Snapshot::seq (src/core.rs:133) — Function Snapshot::seq takes no inputs beyond the value it is called on, and gives back u64.base_bytes (src/core.rs:138) — The raw bytes of the base document under this snapshot.get (src/core.rs:142) — Function get takes &self, coord: &Coordinate and gives back Option<String>.contains (src/core.rs:149) — Function contains takes &self, coord: &Coordinate and gives back bool.coordinates (src/core.rs:154) — Every populated coordinate in this snapshot, ascending.Core (src/core.rs:211) — The synchronous engine.Core::open (src/core.rs:222) — Function Core::open takes base_path: &Path and gives back io::Result<Core>.Core::seq (src/core.rs:346) — Function Core::seq takes no inputs beyond the value it is called on, and gives back u64.checkpoint_seq (src/core.rs:350) — Function checkpoint_seq takes no inputs beyond the value it is called on, and gives back u64.wal_path (src/core.rs:354) — Function wal_path takes no inputs beyond the value it is called on, and gives back &Path.base_path (src/core.rs:358) — Function base_path takes no inputs beyond the value it is called on, and gives back &Path.commit_batch (src/core.rs:367) — Commits a batch of transactions: all of them are serialized into the WAL, written as one suffix, and synced ONCE; only then is each transaction applied, in order, one overlay swap per transaction.checkpoint (src/core.rs:439) — Folds the overlay into the base file (temp + sync + rename + directory sync), remaps the base, and restarts the WAL with only its meta scroll.ScrollSpan (src/index.rs:19) — A scroll's location within the raw phext byte buffer.ScrollSpan::len (src/index.rs:27) — Function ScrollSpan::len takes no inputs beyond the value it is called on, and gives back usize.is_empty (src/index.rs:31) — Function is_empty takes no inputs beyond the value it is called on, and gives back bool.Dimension (src/index.rs:38) — The nine phext dimensions, in address order.dimension_value (src/index.rs:51) — The value of one dimension of a coordinate.LatticeIndex (src/index.rs:67) — The lattice index: maps every populated coordinate to its byte span.LatticeIndex::build (src/index.rs:110) — Build an index by scanning the raw phext bytes once.from_entries (src/index.rs:151) — Build from (coordinate, span) pairs, e.g.get (src/index.rs:168) — Look up the byte span for a coordinate.contains (src/index.rs:173) — Check if a coordinate has content.scroll_count (src/index.rs:178) — Number of populated scrolls.spans (src/index.rs:183) — Spans in document order, parallel to coordinates().buffer_len (src/index.rs:188) — Total buffer size.coordinates (src/index.rs:193) — All populated coordinates in document order.next_populated (src/index.rs:198) — The next populated coordinate after coord, if any.prev_populated (src/index.rs:206) — The previous populated coordinate before coord, if any.coordinates_matching (src/index.rs:220) — All populated coordinates matching a predicate — the lattice navigator's workhorse.dimension_extent (src/index.rs:229) — The distinct values a dimension takes across all populated coordinates, sorted.core::{Core, Op, Snapshot, Txn} (src/lib.rs:34) — A re-export: core::{Core, Op, Snapshot, Txn} is made reachable through this module, so other code can use it from here.index::{Dimension, LatticeIndex, ScrollSpan} (src/lib.rs:35) — A re-export: index::{Dimension, LatticeIndex, ScrollSpan} is made reachable through this module, so other code can use iError (src/lib.rs:44) — Errors from the async interface.Result (src/lib.rs:67) — A type name, Result, that stands for another type.Update (src/lib.rs:71) — One committed transaction, dispatched to subscribers in order.HoloPhext (src/lib.rs:82) — An open HoloPhext store: an async handle over one Core.HoloPhext::open (src/lib.rs:92) — Opens (creating if needed) the store whose base document is at base_path; the WAL lives beside it.commit (src/lib.rs:155) — Commits one transaction atomically; resolves with its sequence number once the WAL write is synced and the transaction icheckpoint (src/lib.rs:163) — Folds all committed state into the base document and restarts the WAL (see Core::checkpoint).snapshot (src/lib.rs:171) — A frozen read view at the current sequence.read (src/lib.rs:176) — Reads one scroll from a fresh snapshot.seq (src/lib.rs:181) — The latest committed sequence.subscribe (src/lib.rs:188) — Subscribes to committed updates, in commit order.Found in holo-edit/src/bin/holo-dump.rs at line 19.
Signature: fn main() {
What it does: The entry point: the program starts here. It reads the command line and runs the command the user named.
(Where these words came from: signature.)
Found in holo-edit/src/bin/holo-edit.rs at line 337.
Signature: fn main() {
What it does: The entry point: the program starts here. It reads the command line and runs the command the user named.
(Where these words came from: signature.)
Found in holo-edit/src/bin/holo-edit.rs at line 344.
Signature: command "--local"
What it does: A command named --local. The program runs it when the user types this word on the command line.
(Where these words came from: signature.)
Found in holo-edit/src/bin/holo-edit.rs at line 347.
Signature: command "--port"
What it does: A command named --port. The program runs it when the user types this word on the command line.
(Where these words came from: signature.)
Found in src/compat.rs at line 35.
Signature: pub struct LatticeStore {
What it does: A data shape named LatticeStore. The scanner did not read its fields.
(Where these words came from: signature.)
Found in src/compat.rs at line 42.
Signature: pub fn open<P: AsRef<Path>>(path: P) -> io::Result<LatticeStore> {
What it does: Function LatticeStore::open takes path: P and gives back io::Result<LatticeStore>.
(Where these words came from: signature.)
Found in src/compat.rs at line 47.
Signature: pub fn read_scroll(&self, coord: &Coordinate) -> Option<String> {
What it does: Function read_scroll takes &self, coord: &Coordinate and gives back Option<String>.
(Where these words came from: signature.)
Found in src/compat.rs at line 54.
Signature: pub fn write_scroll(&mut self, coord: Coordinate, content: String) -> bool {
What it does: Function write_scroll takes &mut self, coord: Coordinate, content: String and gives back bool.
(Where these words came from: signature.)
Found in src/compat.rs at line 63.
Signature: pub fn delete_scroll(&mut self, coord: Coordinate) {
What it does: Function delete_scroll takes &mut self, coord: Coordinate and gives back nothing; it does its work on what it is given.
(Where these words came from: signature.)
Found in src/compat.rs at line 67.
Signature: pub fn has_scroll(&self, coord: &Coordinate) -> bool {
What it does: Function has_scroll takes &self, coord: &Coordinate and gives back bool.
(Where these words came from: signature.)
Found in src/compat.rs at line 71.
Signature: pub fn populated_coordinates(&self) -> Vec<Coordinate> {
What it does: Function populated_coordinates takes no inputs beyond the value it is called on, and gives back Vec<Coordinate>.
(Where these words came from: signature.)
Found in src/compat.rs at line 89.
Signature: pub fn scroll_count(&self) -> usize {
What it does: Function scroll_count takes no inputs beyond the value it is called on, and gives back usize.
(Where these words came from: signature.)
Found in src/compat.rs at line 93.
Signature: pub fn is_dirty(&self) -> bool {
What it does: Function is_dirty takes no inputs beyond the value it is called on, and gives back bool.
(Where these words came from: signature.)
Found in src/compat.rs at line 97.
Signature: pub fn pending_changes(&self) -> usize {
What it does: Function pending_changes takes no inputs beyond the value it is called on, and gives back usize.
(Where these words came from: signature.)
Found in src/compat.rs at line 101.
Signature: pub fn revert(&mut self) {
What it does: Function revert takes no inputs beyond the value it is called on, and gives back nothing; it does its work on what it is given.
(Where these words came from: signature.)
Found in src/compat.rs at line 108.
Signature: pub fn save(&mut self) -> io::Result<()> {
What it does: Commits the staged changes as one transaction, then checkpoints — after save, the base file at path() is the complete merged document, as with MappedLattice::save.
(Where these words came from: doc comment.)
Found in src/compat.rs at line 121.
Signature: pub fn to_phext_bytes(&self) -> Vec<u8> {
What it does: The merged document (base + committed overlay + staged), serialized — MappedLattice::to_phext_bytes.
(Where these words came from: doc comment.)
Found in src/compat.rs at line 143.
Signature: pub fn path(&self) -> &Path {
What it does: Function path takes no inputs beyond the value it is called on, and gives back &Path.
(Where these words came from: signature.)
Found in src/compat.rs at line 149.
Signature: pub fn core(&mut self) -> &mut Core {
What it does: Access to the underlying core, for servers that want the transactional interface alongside the lattice surface.
(Where these words came from: doc comment.)
Found in src/core.rs at line 38.
Signature: pub enum Op {
What it does: One write inside a transaction.
(Where these words came from: doc comment.)
Found in src/core.rs at line 46.
Signature: pub struct Txn {
What it does: A multi-scroll transaction: a set of ops applied atomically or not at all.
(Where these words came from: doc comment.)
Found in src/core.rs at line 51.
Signature: pub fn new() -> Txn {
What it does: Function Txn::new takes no inputs beyond the value it is called on, and gives back Txn.
(Where these words came from: signature.)
Found in src/core.rs at line 54.
Signature: pub fn set(mut self, coord: Coordinate, content: &str) -> Txn {
What it does: Function set takes mut self, coord: Coordinate, content: &str and gives back Txn.
(Where these words came from: signature.)
Found in src/core.rs at line 58.
Signature: pub fn delete(mut self, coord: Coordinate) -> Txn {
What it does: Function delete takes mut self, coord: Coordinate and gives back Txn.
(Where these words came from: signature.)
Found in src/core.rs at line 62.
Signature: pub fn is_empty(&self) -> bool {
What it does: Function is_empty takes no inputs beyond the value it is called on, and gives back bool.
(Where these words came from: signature.)
Found in src/core.rs at line 68.
Signature: pub struct BaseLattice {
What it does: The read-only memory-mapped base lattice.
(Where these words came from: doc comment.)
Found in src/core.rs at line 74.
Signature: pub fn open(path: &Path) -> io::Result<BaseLattice> {
What it does: Function BaseLattice::open takes path: &Path and gives back io::Result<BaseLattice>.
(Where these words came from: signature.)
Found in src/core.rs at line 88.
Signature: pub fn read_scroll(&self, coord: &Coordinate) -> Option<String> {
What it does: Function read_scroll takes &self, coord: &Coordinate and gives back Option<String>.
(Where these words came from: signature.)
Found in src/core.rs at line 94.
Signature: pub fn bytes(&self) -> &[u8] {
What it does: Function bytes takes no inputs beyond the value it is called on, and gives back &[u8].
(Where these words came from: signature.)
Found in src/core.rs at line 98.
Signature: pub fn coordinates(&self) -> &[Coordinate] {
What it does: Function coordinates takes no inputs beyond the value it is called on, and gives back &[Coordinate].
(Where these words came from: signature.)
Found in src/core.rs at line 105.
Signature: pub struct Shared {
What it does: Shared, snapshot-able read state. Writers swap Arcs; readers clone them into a Snapshot and are thereafter immune to new commits.
(Where these words came from: doc comment.)
Found in src/core.rs at line 112.
Signature: pub fn snapshot(&self) -> Snapshot {
What it does: Function Shared::snapshot takes no inputs beyond the value it is called on, and gives back Snapshot.
(Where these words came from: signature.)
Found in src/core.rs at line 120.
Signature: pub fn seq(&self) -> u64 {
What it does: Function seq takes no inputs beyond the value it is called on, and gives back u64.
(Where these words came from: signature.)
Found in src/core.rs at line 126.
Signature: pub struct Snapshot {
What it does: A frozen read view at one sequence number.
(Where these words came from: doc comment.)
Found in src/core.rs at line 133.
Signature: pub fn seq(&self) -> u64 {
What it does: Function Snapshot::seq takes no inputs beyond the value it is called on, and gives back u64.
(Where these words came from: signature.)
Found in src/core.rs at line 138.
Signature: pub fn base_bytes(&self) -> &[u8] {
What it does: The raw bytes of the base document under this snapshot.
(Where these words came from: doc comment.)
Found in src/core.rs at line 142.
Signature: pub fn get(&self, coord: &Coordinate) -> Option<String> {
What it does: Function get takes &self, coord: &Coordinate and gives back Option<String>.
(Where these words came from: signature.)
Found in src/core.rs at line 149.
Signature: pub fn contains(&self, coord: &Coordinate) -> bool {
What it does: Function contains takes &self, coord: &Coordinate and gives back bool.
(Where these words came from: signature.)
Found in src/core.rs at line 154.
Signature: pub fn coordinates(&self) -> Vec<Coordinate> {
What it does: Every populated coordinate in this snapshot, ascending.
(Where these words came from: doc comment.)
Found in src/core.rs at line 211.
Signature: pub struct Core {
What it does: The synchronous engine. The async interface drives one Core from a single writer task; the compat facade drives it directly.
(Where these words came from: doc comment.)
Found in src/core.rs at line 222.
Signature: pub fn open(base_path: &Path) -> io::Result<Core> {
What it does: Function Core::open takes base_path: &Path and gives back io::Result<Core>.
(Where these words came from: signature.)
Found in src/core.rs at line 346.
Signature: pub fn seq(&self) -> u64 {
What it does: Function Core::seq takes no inputs beyond the value it is called on, and gives back u64.
(Where these words came from: signature.)
Found in src/core.rs at line 350.
Signature: pub fn checkpoint_seq(&self) -> u64 {
What it does: Function checkpoint_seq takes no inputs beyond the value it is called on, and gives back u64.
(Where these words came from: signature.)
Found in src/core.rs at line 354.
Signature: pub fn wal_path(&self) -> &Path {
What it does: Function wal_path takes no inputs beyond the value it is called on, and gives back &Path.
(Where these words came from: signature.)
Found in src/core.rs at line 358.
Signature: pub fn base_path(&self) -> &Path {
What it does: Function base_path takes no inputs beyond the value it is called on, and gives back &Path.
(Where these words came from: signature.)
Found in src/core.rs at line 367.
Signature: pub fn commit_batch(&mut self, txns: Vec<Txn>) -> io::Result<Vec<u64>> {
What it does: Commits a batch of transactions: all of them are serialized into the WAL, written as one suffix, and synced ONCE; only then is each transaction applied, in order, one overlay swap per transaction. Returns the sequence of each transaction. This is the group-commit point the async writer drives.
(Where these words came from: doc comment.)
Found in src/core.rs at line 439.
Signature: pub fn checkpoint(&mut self) -> io::Result<()> {
What it does: Folds the overlay into the base file (temp + sync + rename + directory sync), remaps the base, and restarts the WAL with only its meta scroll. Crash between the rename and the WAL rewrite is safe: replaying already-folded transactions onto the new base is idempotent, because ops are absolute.
(Where these words came from: doc comment.)
Found in src/index.rs at line 19.
Signature: pub struct ScrollSpan {
What it does: A scroll's location within the raw phext byte buffer.
(Where these words came from: doc comment.)
Found in src/index.rs at line 27.
Signature: pub fn len(&self) -> usize {
What it does: Function ScrollSpan::len takes no inputs beyond the value it is called on, and gives back usize.
(Where these words came from: signature.)
Found in src/index.rs at line 31.
Signature: pub fn is_empty(&self) -> bool {
What it does: Function is_empty takes no inputs beyond the value it is called on, and gives back bool.
(Where these words came from: signature.)
Found in src/index.rs at line 38.
Signature: pub enum Dimension {
What it does: The nine phext dimensions, in address order.
(Where these words came from: doc comment.)
Found in src/index.rs at line 51.
Signature: pub fn dimension_value(coord: &Coordinate, dim: Dimension) -> usize {
What it does: The value of one dimension of a coordinate.
(Where these words came from: doc comment.)
Found in src/index.rs at line 67.
Signature: pub struct LatticeIndex {
What it does: The lattice index: maps every populated coordinate to its byte span.
(Where these words came from: doc comment.)
Found in src/index.rs at line 110.
Signature: pub fn build(buffer: &[u8]) -> LatticeIndex {
What it does: Build an index by scanning the raw phext bytes once. Time: O(n) in buffer length. Space: O(k) in populated scrolls. Empty runs between delimiter bytes are addressing, not scrolls, and get no span (a scroll exists iff it holds at least one byte — the phext definition).
(Where these words came from: doc comment.)
Found in src/index.rs at line 151.
Signature: pub fn from_entries(mut entries: Vec<(Coordinate, ScrollSpan)>, buffer_len: usize) -> LatticeIndex {
What it does: Build from (coordinate, span) pairs, e.g. a persisted span table or spans recorded while serializing. Pairs are normally already in document order; otherwise they are sorted. A repeated coordinate keeps its last span.
(Where these words came from: doc comment.)
Found in src/index.rs at line 168.
Signature: pub fn get(&self, coord: &Coordinate) -> Option<&ScrollSpan> {
What it does: Look up the byte span for a coordinate. O(log n).
(Where these words came from: doc comment.)
Found in src/index.rs at line 173.
Signature: pub fn contains(&self, coord: &Coordinate) -> bool {
What it does: Check if a coordinate has content.
(Where these words came from: doc comment.)
Found in src/index.rs at line 178.
Signature: pub fn scroll_count(&self) -> usize {
What it does: Number of populated scrolls.
(Where these words came from: doc comment.)
Found in src/index.rs at line 183.
Signature: pub fn spans(&self) -> &[ScrollSpan] {
What it does: Spans in document order, parallel to coordinates().
(Where these words came from: doc comment.)
Found in src/index.rs at line 188.
Signature: pub fn buffer_len(&self) -> usize {
What it does: Total buffer size.
(Where these words came from: doc comment.)
Found in src/index.rs at line 193.
Signature: pub fn coordinates(&self) -> &[Coordinate] {
What it does: All populated coordinates in document order.
(Where these words came from: doc comment.)
Found in src/index.rs at line 198.
Signature: pub fn next_populated(&self, coord: &Coordinate) -> Option<Coordinate> {
What it does: The next populated coordinate after coord, if any.
(Where these words came from: doc comment.)
Found in src/index.rs at line 206.
Signature: pub fn prev_populated(&self, coord: &Coordinate) -> Option<Coordinate> {
What it does: The previous populated coordinate before coord, if any.
(Where these words came from: doc comment.)
Found in src/index.rs at line 220.
Signature: pub fn coordinates_matching<F>(&self, predicate: F) -> Vec<Coordinate> where F: Fn(&Coordinate) -> bool, {
What it does: All populated coordinates matching a predicate — the lattice navigator's workhorse.
(Where these words came from: doc comment.)
Found in src/index.rs at line 229.
Signature: pub fn dimension_extent(&self, dim: Dimension) -> Vec<usize> {
What it does: The distinct values a dimension takes across all populated coordinates, sorted.
(Where these words came from: doc comment.)
Found in src/lib.rs at line 34.
Signature: pub use core::{Core, Op, Snapshot, Txn};
What it does: A re-export: core::{Core, Op, Snapshot, Txn} is made reachable through this module, so other code can use it from here.
(Where these words came from: signature.)
Found in src/lib.rs at line 35.
Signature: pub use index::{Dimension, LatticeIndex, ScrollSpan};
What it does: A re-export: index::{Dimension, LatticeIndex, ScrollSpan} is made reachable through this module, so other code can use it from here.
(Where these words came from: signature.)
Found in src/lib.rs at line 44.
Signature: pub enum Error {
What it does: Errors from the async interface.
(Where these words came from: doc comment.)
Found in src/lib.rs at line 67.
Signature: pub type Result<T> = std::result::Result<T, Error>;
What it does: A type name, Result, that stands for another type.
(Where these words came from: signature.)
Found in src/lib.rs at line 71.
Signature: pub struct Update {
What it does: One committed transaction, dispatched to subscribers in order.
(Where these words came from: doc comment.)
Found in src/lib.rs at line 82.
Signature: pub struct HoloPhext {
What it does: An open HoloPhext store: an async handle over one Core.
(Where these words came from: doc comment.)
Found in src/lib.rs at line 92.
Signature: pub async fn open(base_path: &Path) -> Result<HoloPhext> {
What it does: Opens (creating if needed) the store whose base document is at base_path; the WAL lives beside it. Recovery runs here: valid committed transactions replay, a torn tail is truncated.
(Where these words came from: doc comment.)
Found in src/lib.rs at line 155.
Signature: pub async fn commit(&self, txn: Txn) -> Result<u64> {
What it does: Commits one transaction atomically; resolves with its sequence number once the WAL write is synced and the transaction is visible to new snapshots.
(Where these words came from: doc comment.)
Found in src/lib.rs at line 163.
Signature: pub async fn checkpoint(&self) -> Result<()> {
What it does: Folds all committed state into the base document and restarts the WAL (see Core::checkpoint).
(Where these words came from: doc comment.)
Found in src/lib.rs at line 171.
Signature: pub fn snapshot(&self) -> Snapshot {
What it does: A frozen read view at the current sequence. Cheap: two Arc clones. The snapshot never observes a partial transaction.
(Where these words came from: doc comment.)
Found in src/lib.rs at line 176.
Signature: pub fn read(&self, coord: &Coordinate) -> Option<String> {
What it does: Reads one scroll from a fresh snapshot.
(Where these words came from: doc comment.)
Found in src/lib.rs at line 181.
Signature: pub fn seq(&self) -> u64 {
What it does: The latest committed sequence.
(Where these words came from: doc comment.)
Found in src/lib.rs at line 188.
Signature: pub fn subscribe(&self) -> broadcast::Receiver<Update> {
What it does: Subscribes to committed updates, in commit order. Lagging receivers skip (broadcast semantics) — a subscriber that must not miss changes should re-snapshot on Lagged.
(Where these words came from: doc comment.)
This documentation is produced for the export repo wbic16/phdoc (its chain of record lives at docs/holo-phext/chain.phext) and for the doc site https://docs.phext.io. Both targets are the project's own configuration, held in its .phdoc.json as "export-repo" and "doc-site"; when a project does not name them, the defaults are wbic16/phdoc and https://docs.phext.io.