hh-core 0.1.0-beta.1

Halfhand core: storage, blob store, event model, config
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

//! hh-core — storage, blob store, event model, and config for Halfhand.
//!
//! This crate implements the local-first data layer (SRS §4) used by the `hh`
//! binary and the recorder. It is intentionally free of any I/O runtime or
//! CLI concern: the binary drives it, not the other way around.
//!
//! Per CLAUDE.md, every public item is documented (`missing_docs` is denied
//! here) and `clippy::pedantic` is enabled via the workspace lint table.

#![deny(missing_docs)]

pub mod adapter;
pub mod blob;
pub mod config;
pub mod error;
pub mod event;
pub mod migrations;
pub mod step;
pub mod store;
pub mod timeline;

// Re-export the most commonly used types at the crate root for ergonomics.
pub use adapter::{
    resolve_override as resolve_adapter_override, select as select_adapter, Adapter,
    AdapterContext, AdapterHandle, AdapterOutcome,
};
pub use blob::{BlobStore, PutOutcome};
pub use config::{parse_bytes, Config, Paths, RecordConfig, ReplayConfig, StorageConfig, Theme};
pub use error::{BlobError, ConfigError, Error, ResolveError, Result, StorageError};
pub use event::{
    truncate_summary, AdapterStatus, AgentKind, ChangeKind, Event, EventDetail, EventIndexRow,
    EventKind, EventRow, FileChange, NewSession, SessionRow, SessionStatus,
};
// `Uuid` is part of the public surface already (`now_v7` returns it,
// `NewSession::id` holds it); re-exporting it lets downstream crates name the
// type without adding `uuid` as a direct dependency.
pub use step::assign_steps;
pub use store::{CreatedSession, EventWriter, Store};
pub use timeline::{build_timeline, StepEntry, TerminalSegment, TimelineRow};
pub use uuid::Uuid;