hh-record 1.0.0

//! `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, watcher_smoke_test, WatchOptions, WatcherHandle};

/// Fuzz-only entry points into the MCP JSON-RPC line classifier; see
/// [`mcp_proxy::fuzzing`].
#[cfg(feature = "fuzzing")]
pub use mcp_proxy::fuzzing;

// 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;

/// Build the recorder's shared blob store handle: redacting when a
/// record-time redactor is configured (`[redaction] at_record`), plain
/// otherwise. Centralized so the PTY runner and the MCP proxy cannot drift —
/// every recorder blob write goes through the same enforcement point
/// (docs/redaction-design.md).
pub(crate) fn make_blob_store(
    store: &Store,
    redactor: Option<std::sync::Arc<hh_core::redact::Detectors>>,
) -> hh_core::blob::BlobStore {
    let root = store.blobs().root().to_path_buf();
    match redactor {
        Some(r) => hh_core::blob::BlobStore::with_redactor(root, r),
        None => hh_core::blob::BlobStore::new(root),
    }
}