hh-record 0.1.0-beta.1

Halfhand recorder: PTY runner, FS watcher, MCP proxy
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

//! `hh-record` — the Halfhand recorder layer (SRS §6).
//!
//! Drives a PTY-recorded agent session: spawns the agent in a PTY
//! ([`runner`]), watches the working tree for file changes ([`watcher`]),
//! feeds both into the single-writer SQLite store via `hh-core`, and — when a
//! structured-event adapter applies (FR-1.5, Claude Code today) — drains its
//! parsed events into the same store with `tool_call`→`tool_result` correlation.
//! The MCP stdio proxy (FR-2) lives in [`mcp_proxy`].
//!
//! The threads-vs-tokio decision is recorded in
//! `docs/adr/0001-threads-vs-tokio.md`.

#![deny(missing_docs)]

mod agent;
mod error;
mod git;
mod mcp_proxy;
mod runner;
mod watcher;

pub use agent::detect_agent;
pub use error::{RecordError, Result};
pub use git::GitMeta;
pub use mcp_proxy::{run_mcp_proxy, McpProxyOptions, McpProxyOutcome};
pub use runner::{run, RunOptions, RunOutcome};
pub use watcher::{spawn_watcher, WatchOptions, WatcherHandle};

// Re-export the core types the binary needs to construct RunOptions without
// reaching into hh-core directly (keeps the binary's `use` surface small).
pub use hh_core::store::Store;