topmark.diagnostic package index¶
topmark / diagnostic
Diagnostic primitives and helpers.
This package provides internal, strongly-typed diagnostic objects used throughout TopMark to report informational messages, warnings, and errors in a consistent way.
Design
- Internal diagnostics are represented by immutable
Diagnosticinstances. - During processing, diagnostics are accumulated in a mutable
MutableDiagnosticLog. - Frozen snapshots (e.g.
FrozenConfig) store diagnostics as an immutableFrozenDiagnosticLog.
Machine-readable output
Machine-readable JSON/NDJSON representations live under
topmark.diagnostic.machine
and are reused by multiple domains (config, pipeline, registry, etc.).
Immediate children in this package¶
- topmark.diagnostic.machine
- Machine-output helpers for diagnostics.
- topmark.diagnostic.model
- Core diagnostic types and helpers for TopMark.
- topmark.diagnostic.types
- Structural typing helpers for TopMark diagnostic containers.