yog 0.0.3

yog: a balls-oriented session manager for lernie loops (egui frontend)
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

//! egui/eframe frontend for the lernie agent harness — the balls-oriented
//! manager for lernie loops.
//!
//! This crate is the desktop UI: a stateless renderer over on-disk state that
//! issues user actions as `lernie` and `bl` subcommand invocations. Every
//! render is a pure function of filesystem state at the current tick, and the
//! public view-model API is reentrant, so a future `lernie-ui-web` runs
//! concurrently against the same repo without coordination.
//!
//! **`docs/DESIGN.md` is the authority** for the state inventory, the attention
//! model, and the module map; the module docs below stay terse
//! and defer to it. The shape in brief: pure view-model modules (no egui) — the
//! per-tick [`git_tree`], the [`nav`] roster, [`attention`], [`projects`]/
//! [`binding`], [`start`], [`ui_state`], the inspector VMs ([`transcript`],
//! [`steps_view`], [`jsonview`], [`inboxview`], [`budgets`]) composed by the
//! tested [`inspector`] tab dispatch, [`composer`] (the §11 inbox-composer's
//! queue/fold-line/snap derivations, bl-929d), [`config_edit`] — fronted by the thin
//! egui glue in [`shell`] (§11). [`app`] re-exports `Args`, `Roots`,
//! `Focus`, and the multi-workspace [`AppModel`]; [`keymap`] is the pure §11
//! key → intent table; [`cli_outbound`] execs the binaries; [`actions`] holds
//! the message/stop/scan/close/unclaim/create/update verb surface; [`delete`]
//! the §3.6 unmaking (its gate, its typed-name confirmation, its plan); [`theme`]
//! is the congeries palette — the single colour/visuals authority (§11).
//!
//! The crate root is deliberately declaration-only. A root carrying a
//! coverable `impl` or `fn` accrues an llvm-cov phantom uncovered region on
//! its header line each time the `pub mod` list above it grows and shifts
//! byte offsets (this cost 99.90% coverage after the Y2/Y7/Y15 folds). With
//! all coverable code in submodules, new `pub mod` lines have no root-level
//! line to mis-attribute, so coverage stays at 100% as modules land.

pub mod actions;
/// The §6 attention strip escalated to the desktop (bl-e160) — what a decision
/// queue row becomes when the window is buried, and the one spawn that says it.
pub mod alert;
pub mod app;
pub mod attention;
pub mod binding;
pub mod board;
pub mod boundary;
pub mod budgets;
/// The embedded brazen host (§16.7 W10) — internal, not library surface.
pub(crate) mod bz_host;
pub mod cli_outbound;
pub mod composer;
pub mod config_edit;
/// How full a conversation's context is (§5.1 #35) — the latest step's prompt
/// against the window `models.yaml` declares. Fullness, not spend.
pub mod context;
/// The capability control (§8.6, VISION §4.11) — the adjudicator lernie's
/// tool-control seam consults before every granted tool invocation.
pub mod control;
pub mod delete;
/// Where to cut a string that will not fit (QUALITY G1, L4) — one rule, cut
/// where the information is not. Machine strings only; prose keeps its head.
pub(crate) mod elide;
/// The one assembly both faces boot (VISION §5 V5) — model, worker, bridge,
/// gesture consumer; the window and `yog serve` differ only in what they add
/// beside it.
pub mod engine;
/// The VISION §4.10 mutating fan — N isolated candidate attempts over one
/// delivery obligation, materialized through balls' attempt capability.
pub mod fan;
pub mod files_view;
/// The VISION §4.3 armed loop — off until the operator arms it per workspace.
pub mod fleet;
pub mod fork;
pub mod fs_watcher;
pub mod git_env;
pub mod git_tree;
pub mod inboxview;
pub mod inspector;
pub mod jsonview;
pub mod keymap;
pub mod login;
pub mod model_pick;
pub mod monitor;
pub mod multiplex;
pub mod names;
pub mod naming;
pub mod nav;
pub mod opslog;
pub mod projects;
pub mod rail;
/// The REMOTE §4 client registry (bl-8bbc): who participates in which
/// workspace, and each client's own per-seat home.
pub mod registry;
/// I3's scratch temp (§2, §5.2): its one naming, and the startup sweep of
/// leftovers — internal, not library surface.
pub(crate) mod scratch;
pub mod search;
pub mod shell;
pub mod spend;
pub mod start;
pub mod state;
pub mod steps_view;
/// The §11 tail idiom every tail-anchored view shows through — internal, not
/// library surface.
pub(crate) mod tail;
pub mod theme;
/// yog's lernie tool injection (REMOTE §5, bl-c907) — the `clients` tool, the
/// agent's durable loaded set, and the router the executor consults.
pub mod tool_host;
pub mod transcript;
pub mod ui_state;
pub mod watch;
/// The client/server wire (REMOTE §9.5, bl-b6fa) — the engine's mTLS listener,
/// a seat's transport, and the framing between them.
pub mod wire;
pub mod workdiff;
pub mod world;
pub mod xdg;

pub use app::{AppModel, Args, Focus, Roots};

pub(crate) mod layout;
#[cfg(test)]
pub(crate) mod paint_probe;
#[cfg(test)]
pub(crate) mod test_support;