The CLI performs a small, ordered workflow:
- Refresh the cached shared dictionary only when the configured authority is newer than the valid local cache.
- Load the cached dictionary and merge
typos.local.tomlwhen the overlay is present. - Render
typos.tomldeterministically. - Atomically write the rendered content, or compare it with the tracked file
when
--checkis set.
The refresh operation preserves a valid cache when an explicitly configured authority is temporarily unavailable. A first offline run without a valid cache fails because no shared policy can be established.
The builder only generates and checks configuration. The consumer remains
responsible for invoking its pinned Typos binary after the configuration check.
Typos tokenizes hyphenated phrases as separate words, so entries under
[phrases.corrections] remain shared policy metadata for the consumer's phrase
gate rather than being rendered as ineffective extend-words entries.