kazari (飾り)

The line-output face of the fleet. Typed, capability-honest, dark-Nord / blackmatter beautiful CLI output — banners, callouts, panels, rules, lists, badges (tables / trees / progress / diagnostics at M2) — as a pure-data, format!()-free Block IR.

kazari is the sibling of seki: seki dresses the prompt (before the command), kazari dresses the output (after the command), over the one ishou / irodori token spine that also feeds egaku-term (the cell-grid) and tela (the web). Four faces, one spine.

The wall is a type

A Block carries no color depth. render() requires a Capability supplied by the environment — so "assumed truecolor on a pipe" is a compile-shaped absence, not a runtime clamp. The same value degrades truecolor → 256 → 16 → NO_COLOR through one total morphism.

use kazari::prelude::*;

banner("sui — Rust-native Nix").print()?;          // rounded box, Frost accent
ok("realised /nix/store/…-hello (byte-parity)").print()?;   // ✓ Aurora green
warn("cache miss — rebuilding").print()?;          // ⚠ Aurora orange
error("exit 1").with_title("build").eprint()?;     // ✗ Aurora red

Panel::titled("store")
    .row("path", "/nix/store/…")
    .row("closure-size", "42 MiB")
    .print()?;

Piped or under NO_COLOR, the same code emits zero escape bytes and a plain [TAG] / ASCII-glyph projection.

Structured replies render as a Document: nested key/value output whose characters are valid YAML on every rung, with keys in the accent hue and state words painted at their severity. With the json feature a serde_json::Value converts straight in.

let doc = Document::new(Node::from(&value))
    .classify(|_path, text| (text == "live").then_some(CalloutSeverity::Ok));
doc.print()?;

Panel::row_role / row_fragments and Table::row_fragments take styled cells, Table::indented(n) aligns a table under panel rows, and Capability::probe_stream(Stream::Stderr) probes the stream actually being written.

kazari::live redraws a region of lines in place. On a colored tty each Live::frame repaints inside synchronized output (mode 2026), truncated to the terminal width by display width, at most once per 80 ms; the cursor is hidden while live and restored by finish() or drop. commit prints a permanent line above the region. Piped, under NO_COLOR or on a dumb terminal, nothing moves: commit appends plain lines and finish() prints the last frame once. Spinner, Meter (eighth blocks, multi-segment), Spark and Pulse build the fragments; each takes an injected tick, never a clock.

kazari::progress::Board is the live view of a graph of jobs: the plan folded into waves that converge on the root, the jobs running now with their phase or transfer meter, and the completion rate. A finished wave flashes, then settles. cargo run --example progress shows a 400-job graph on 8 workers.

let mut live = Live::stderr();
let bar = Meter::new(24).segments(&[(0.4, Role::Ok), (0.2, Role::Primary)]);
live.frame(&[[vec![Spinner::new().fragment(tick)], bar].concat()])?;
live.commit(&vec![Fragment::styled("✓ hello", Role::Ok)])?;
live.finish()?;

Consumers: sui (sui-spec), engenho (engenho status, engenho ctl).

What it owns vs reuses

• OWNS (the ~15% genuinely-new, 0-hit fleet gap): the ColorLevel capability wall, the RGB→256→16 nearest-in-linear quantizer, the line-block AST.
• CONSUMES irodori (Nord palette, no fork) · WRAPS anstyle (typed SGR — the escape bytes are anstyle's, never hand-spelled). The cursor and screen controls a live region needs are spelled once, in live::Control.

Dark-Nord by default (fully morphable). Design + tier-honest ledger: theory/KAZARI.md.

License

MIT.