Expand description
End-to-end pipeline for the face binary.
run is the library entry point: it accepts a parsed cli::Cli
and an Io with explicit stdin/stdout/stderr handles, runs the §3
pipeline (sniff → parse → detect → strategy → cluster → render), and
emits output. Stream injection via Io lets tests drive the
pipeline against in-memory buffers without touching the real OS
handles.
§Pipeline shape (§4–§8 of docs/design.md)
- Validate flag combinations (§11.3).
- Sniff the input format (§4.1) — or honor
--format-in. - Parse stdin into a
ParsedInput(§4.2). --schemashort-circuits and prints the input shape.- Detect score field (§4.3) and preset (§4.4) when not pinned.
- Plan axes / strategies via
face_core::auto_strategy(§4.5). --explainshort-circuits and prints the full reasoning.- Build the cluster tree via
face_core::build_tree(§5.5). - Drill into a cluster if
--clusterwas supplied (§6). - Compose the [
Envelope] and render via the chosen format (§7, §8). - With
--verbose, write provenance and per-record skip lines to stderr (§11.1).
Modules§
- cli
- Current clap surface for the
facebinary.
Structs§
Functions§
- run
- Library entry point with explicit I/O.