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
//! Lernie — a git-backed agent harness, exposed as its command surface.
//!
//! The crate's entire public API is [`cmd`] (ARCH §3.4 "One command
//! surface, two bindings"): the `Cli`/`Command` clap definitions, one
//! **entry** per verb, the binding seam ([`cmd::Fx`], [`cmd::Outcome`],
//! [`cmd::Error`]), and the binding preludes ([`cmd::prelude`]). Nothing
//! else is public. That is the parity invariant (§3.4, CI-enforced by
//! `tests/command_surface_parity/`): the library surface *is* the
//! command surface — the crate exposes nothing public that is not a
//! verb's entry, its arguments, its products, or the binding preludes,
//! and no verb lacks its entry.
//!
//! Consume it two ways, both the *same* control plane: exec the `lernie`
//! binary (the exec binding, `src/bin/lernie`) or link the crate and call
//! the same entries in-process (the linked binding, §3.5). The linked
//! binding promises **pin-exact 0.x consumption only** — no semver
//! stability, the posture brazen takes toward lernie (§4.4).
//!
//! Everything below `cmd` is private machinery, reachable only through a
//! verb's entry — pub-in-private, so externally unreachable:
//! - `config`: parses and validates the config-commit files (§2.2) and
//! generates their JSON Schemas (`config::schemas`).
//! - `harness_root`: resolves the XDG-split installation root, collapsed
//! by `LERNIE_HOME` (§2.2).
//! - `install`: founds that root, seed-if-absent — the `prime` verb (§2.2).
//! - `workspace`: the workspace physical model — the bare `repo.git`, the
//! `config/*` / `agents/*` ref namespaces, governing-config resolution
//! (§2.2–§2.3).
//! - `template`: the config-commit skeleton `lernie new` authors from.
//! - `prompt`: the executor — steps, tools, dispatch, inbox, stop (§2, §6).
//! - `provider`: the response-segment classifier over brazen's `v=1`
//! event vocabulary (§4.4).
//! - `archive`: bundle/replay of an agent subtree (§9.2).
//! - `skill`: the skill-pool descriptor surface (§3.3).