# Architecture and development ```text CLI parsing and rendering (`bin_efo`) │ ▼ domain and persistence (`lib_efo`) │ ▼ `.epoch` and `epoch/*` ``` `bin_efo` defines the Clap command tree and presentation. `lib_efo` owns entities, statistics, identifiers, epochs, naming, and JSON persistence. New behavior should be a testable library operation with a thin CLI handler. The design direction is to make repository paths explicit; replace truncating writes with temporary-file plus rename; add locking; remove unsafe cache accessors; separate styling from semantic output; and retain unknown custom metadata as the model becomes organisation-agnostic. Library tests currently cover parsing, statistics, display snapshots, and parts of entity/epoch behavior. CLI integration coverage is the main gap. Routine CI should run formatting, all-target workspace tests, strict Clippy, and a release build. Tarpaulin and `rust_autobadges` remain local significant-release-only tools. See [AGENTS.md](../AGENTS.md) for contributor rules.