# SPEC
## §G GOAL
`src/` — hub. code nodes of `characterminator`. ⊥ own logic itself.
## §F FEDERATION
rules|config files & flags, precedence, origin, rule resolution, fidelity choice|set contents, rewriting|-
scan|read text: positions, UTF-8 validity, binary skip|which chars are allowed, rewriting|-
fix|rewriting: map, families, equivalence classes, typography, emoji compression|which chars are allowed, reporting|-
lint|lint names, groups, levels, hazard, pedantic|char sets, rewriting|-
tokens|`itok` facade: counts w/ method label, git-tracked fileset|char sets, rewriting|-
judge|findings from rules, sets, lints, scan & fix; config assembly|argv, dotfile discovery, rendering|-
render|human & json output, stable json contract|what is reported|-
cli|arg dispatch, verbs, exit codes, `guard` hook adapter|every verb's logic|-
## §N NAV
self|src|the tool: charset presets, rule resolution, scan, fix, lint levels, token facade, render, CLI
sib|docs|human reference: memory, LLM disclaimer, third-party notices
sib|tests|integration tests that drive the `ctrm` binary
sib|dev|`characterminator-dev`, `publish = false`: README badges, notices closure & their drift checks
## §C CONSTRAINTS
- module = dir + `mod.rs`. `mod.rs` composes, ⊥ implements.
- ∀ external dep ! ONE facade node: `itok` → `src/tokens` · `unicode-normalization` & `unicode-security` → `src/lint/pedantic`.
## §V INVARIANTS
V38: `main.rs` & `lib.rs` dispatch & re-export only, ⊥ logic.
V39: node ⊥ dep sibling node except through its public surface ∴ a rule moves w/ its node.
V98: lib API = `lib.rs` re-exports ONLY, ∀ node `mod` private; exported error enums & growable structs `#[non_exhaustive]` (0.1.0 semver). runner: `unreachable_pub = deny`.