Expand description
Provider-neutral, deterministic, bounded log-reduction state machine.
This crate owns only the execution-independent mechanics: input framing, scopes, parser lifecycle, provenance, output transformation, arbitration, exact deduplication, ranking, and serialized byte budgets. Parser packs and provider adapters live in downstream crates.
Structs§
- Budget
- Combined item and serialized-finding byte limits.
- Diagnostic
- One normalized and redacted diagnostic.
- Emitter
- Bounded parser output sink. Contextual provenance is supplied by the engine.
- Generic
Ranker - Generic ranking prefers compiler, test, lint, infrastructure, then tool diagnostics and uses parser-emitted evidence quality instead of message substring heuristics.
- Limits
- Hard bounds for incremental input and candidate retention.
- Location
- Optional source coordinate extracted from diagnostic text.
- LogLine
- One normalized input line delivered to an immutable parser plan.
- NoPath
Mapping - Identity path policy used by generic CLI and CI consumers.
- NoRedaction
- Explicit identity redactor for already-sanitized or non-sensitive inputs.
- Output
Policy - Output transformations and ranking shared by batch and streaming callers.
- Parser
Plan - Immutable ordered set of trusted native parsers.
- Provenance
- Caller and state-machine provenance for one returned finding.
- RankKey
- Stable typed rank key; lower values are retained first.
- Reduction
- Bounded result and explicit truncation accounting.
- Reduction
Options - Stable options for one synchronous batch reduction call.
- Reduction
Session - Incremental, chunk-invariant reduction session.
- Reduction
Stats - Accounting that never contains raw input text.
- Scope
- Caller-owned identity for one independently bounded parser scope.
- Session
Options - Options for an incremental reduction session.
- Test
Failure - Structured failed-test evidence independent of a particular test provider.
- Text
Input - Borrowed text plus optional owned output provenance.
Enums§
- Diagnostic
Class - Provider-neutral diagnostic family used by presentation adapters.
- EndReason
- Why a parser scope ended.
- Evidence
Quality - How directly a finding is supported by the observed evidence.
- Fallback
Policy - Controls whether unclaimed actionable lines may become tool diagnostics.
- Parser
Plan Error - Invalid immutable parser-plan construction.
- Scope
Boundary - Parser lifecycle notification for a caller-owned scope.
- Scope
Kind - Provider-neutral unit that owns a related log stream.
- Severity
- Severity assigned by a parser or structured-input adapter.
- Stream
- Input channel within a scope.
Traits§
- Parser
- Deterministic, synchronous parser contract.
- Path
Mapper - Pure provider-supplied path normalization performed before redaction.
- Ranker
- Provider-selectable ranking policy that never inspects raw log state.
- Redactor
- Infallible transformation applied to every untrusted returned string.
Functions§
- deduplicate_
lines - Exact line deduplication that preserves first-seen order.
- finalize_
findings - Applies output policy, exact deduplication, typed ranking, and byte budgets.
- normalize_
terminal_ text - Removes terminal control sequences and normalizes progress redraws to lines.