hallouminate 0.2.2

A markdown corpus indexer for LLMs to build and query their own per-repo wikis.
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

//! Local daemon: the single owner of the configured LanceDB ground
//! directory, repository registry, per-corpus mutation locks, and the
//! global write-lane.
//!
//! See `.cheese/specs/repository-daemon-wikis.md` for the design.
//! Operational summary:
//!
//! - One daemon per user-local socket (`HALLOUMINATE_SOCKET`,
//!   `$XDG_RUNTIME_DIR/hallouminate/daemon.sock`, or
//!   `~/.cache/hallouminate/daemon.sock`).
//! - Single-instance enforced via `flock` on `<socket>.lock`.
//! - Interactive CLI subcommands (`ground`, `index`, …) become clients of
//!   the daemon and fail loudly when it is unreachable rather than silently
//!   auto-starting — the user sees a clear hint to run `hallouminate daemon`.
//! - The non-interactive MCP `serve` transport calls `ensure_daemon_running`
//!   to spawn a detached daemon when one is not already up. The flock keeps
//!   concurrent spawns safe: only one daemon wins the lock, the rest exit.
//!
//! Lock order across the dispatcher is documented in `state.rs`.

mod bootstrap;
mod client;
mod dispatch;
mod ipc;
mod lifecycle;
mod server;
mod socket;
mod state;
mod watch;

pub use bootstrap::ensure_daemon_running;
pub use client::{
    DaemonClient, DaemonRpcError, client_for, connect_at, daemon_client, daemon_client_unavailable,
};
pub use ipc::{
    AddMarkdownRequest, AddMarkdownResult, CorpusEntry, CorpusStatsResult, DaemonRequest,
    DaemonRequestPayload, DaemonResponse, DeleteMarkdownRequest, DeleteMarkdownResult, ErrorKind,
    GroundRequest, GroundResult, IndexRequest, LineRange, ListCorporaResult, ListFilesRequest,
    ListFilesResult, ListTreeRequest, ListTreeResult, Position, ReadMarkdownRequest,
    ReadMarkdownResult,
};
pub use lifecycle::{DaemonStatus, restart, restart_with, status, stop};
pub use server::{DaemonArgs, run_daemon, serve, spawn_signal_handlers};
pub use socket::daemon_socket_path;
pub use state::DaemonState;