hh-core 1.0.0

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
41
42
43
44
45
46
47
48
49
50
51
52
53

//! 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 bundle;
pub mod config;
pub mod deprecation;
pub mod error;
pub mod event;
pub mod migrations;
pub mod redact;
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 bundle::{Bundle, FORMAT_VERSION};
pub use config::{
    parse_bytes, Config, Paths, RecordConfig, RedactionConfig, RedactionRule, ReplayConfig,
    StorageConfig, Theme,
};
pub use deprecation::warn_deprecated;
pub use error::{BlobError, BundleError, ConfigError, Error, ResolveError, Result, StorageError};
pub use event::{
    truncate_summary, AdapterStatus, AgentKind, ChangeKind, Event, EventDetail, EventIndexRow,
    EventKind, EventRow, FileChange, NewSession, RawEventRow, SessionRow, SessionStatus,
    JSON_SCHEMA_VERSION,
};
pub use redact::{Detectors, Finding, SecretKind};
// `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, FindingLocation, LargestSession, PruneStats, RedactOutcome,
    ScanFinding, SearchFilters, SearchResult, SecretSummary, Store, StoreStats,
};
pub use timeline::{build_timeline, StepEntry, TerminalSegment, TimelineRow};
pub use uuid::Uuid;