Builder workflow

Updated Jul 14, 2026

The CLI performs a small, ordered workflow:

  1. Refresh the cached shared dictionary only when the configured authority is newer than the valid local cache.
  2. Load the cached dictionary and merge typos.local.toml when the overlay is present.
  3. Render typos.toml deterministically.
  4. Atomically write the rendered content, or compare it with the tracked file when --check is 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.