Struct GroupingOptions 

pub struct GroupingOptions<'a, C: GroupingCache, A: ArtefactStore> {
    pub backend: &'a dyn LlmBackend,
    pub cache: &'a C,
    pub artefacts: &'a A,
    pub fetch: &'a str,
    pub progress: Option<&'a (dyn Fn(Progress) + Send + Sync)>,
}

Fields

backend: &'a dyn LlmBackend

The backend, always injected. dyn because config picks which command to run — the one runtime-open seam in this stage (ADR 0016, 0020).

Cancellation is a property of the backend the caller built (llmio::CommandBackend::with_cancel), not of the pipeline: killing an in-flight subprocess was never a pipeline concern.

cache: &'a C

Where groupings are pinned. Disabling is a state of the cache (FsGroupingCache::disabled()), not an Option here.

artefacts: &'a A

Where the pre-group document is left for the model to read (ADR 0022).

fetch: &'a str

The executable the model runs to fetch from that document — normally this process, so composition supplies it.

The backend’s tool allowlist MUST be built from the same string (llmio::CommandBackend::claude_cli), or the prompt names a command the model is not permitted to run.

progress: Option<&'a (dyn Fn(Progress) + Send + Sync)>

Stage notifications for renderers that show progress while the pipeline runs (the TUI’s splash screen). None reports nothing.