cli-is-pure-formatter

IN premise

Every cmd_* function delegates to api.* and only formats the returned dict for terminal output; no business logic lives in the CLI layer.

Summary

The command-line interface is a thin presentation layer. Each CLI command calls into the API module to do the real work, then just formats whatever comes back for display in the terminal, meaning you can safely swap out or test the API layer independently without worrying about hidden logic in the CLI handlers.

Dependents

These beliefs depend on this one:

cli-is-pure-delegation-layer — The CLI is a pure delegation layer: every handler dispatches through a flat dict lookup to API functions with no business logic, producing binary exit codes and correct stream separation — a complete separation of formatting from computation.
three-layer-stack-has-clean-boundaries — The architecture enforces strict layer separation: pure data model at bottom, context-managed API with dict returns in the middle, and pure-formatter CLI at the top

Details

Source

entries/2026/04/23/reasons_lib-cli.md