/** * Reading one value out of a report, for scripting. * * `stats --today --json` returns a whole nested object, so extracting a single * number needed `jq` or a Node one-liner -- and there was no exit-code signal to * branch on at all, which is what a scheduled job or an alert actually needs. */ export declare class FieldError extends Error { } /** * Resolves a dotted path, with numeric segments indexing arrays. * * A path that does not exist is an ERROR, not an empty string. A threshold check * against a silently-missing field would pass forever, which is the worst * possible failure mode for an alert: it looks like everything is fine. */ export declare function readField(data: unknown, path: string): unknown; /** Renders a scalar for a shell to consume: one value, no quotes, no formatting. */ export declare function renderField(value: unknown, path: string): string; /** * Whether a threshold was breached. * * Deliberately requires an explicit `--field`, and there is no default. * * "Fail if cost exceeded $25" has no single answer in this tool: reported and * estimated cost are separate figures that are never summed, so a default would * silently pick one and ignore every record priced the other way. The caller * names the figure, which also means the check reads as what it is -- * `--field cost.estimated --fail-over 25`. */ export declare function exceedsThreshold(value: unknown, threshold: number, path: string): boolean;