toonenc

const (
	// ModeOff disables the feature: the encoder is never invoked and
	// responses are byte-identical to pre-feature behavior (FR-002). Default.
	ModeOff Mode = "off"
	// ModeAdaptive encodes a block iff it is tabular-uniform (FR-003b) AND
	// the complete encoded emission beats the exact passthrough emission by
	// at least the configured threshold (FR-003c).
	ModeAdaptive Mode = "adaptive"
	// ModeAlways encodes every JSON-parseable text block regardless of
	// tabular classification or size comparison (benchmark/debug only,
	// FR-009). Non-JSON text still passes through unmarked.
	ModeAlways Mode = "always"
)

const (
	// ReasonNotJSON — the block text did not parse as a single JSON value
	// (plain text, base64, binary, malformed JSON, trailing garbage).
	ReasonNotJSON NotTabularReason = "not-json"
	// ReasonNotArray — the parsed value is not an array (and not a
	// single-key envelope object wrapping an array).
	ReasonNotArray NotTabularReason = "not-array"
	// ReasonTooFewRows — the array has fewer than 4 elements (empty
	// included).
	ReasonTooFewRows NotTabularReason = "too-few-rows"
	// ReasonNonObjectElements — at least one array element is not a JSON
	// object.
	ReasonNonObjectElements NotTabularReason = "non-object-elements"
	// ReasonNestedValues — at least one row field holds a nested object or
	// array (v1 is flat-scalar-only, FR-003b).
	ReasonNestedValues NotTabularReason = "nested-values"
	// ReasonTooRagged — the rows disagree beyond the 90% key-presence
	// tolerance, or the union key set collapses to empty.
	ReasonTooRagged NotTabularReason = "too-ragged"
	// ReasonNonRoundtrippableNumber — the value contains a JSON number whose
	// literal does not survive the float64 round-trip toon-go applies to
	// json.Number (e.g. integers beyond 2^53, large uint64). Encoding would
	// silently corrupt the number, so the block passes through (FR-004/FR-006
	// no data loss). Not an encoder fault — it belongs to the
	// passthrough-not-tabular family, never logged or counted.
	ReasonNonRoundtrippableNumber NotTabularReason = "non-roundtrippable-number"
)

const (
	// OutcomeEncoded — the block was replaced with Marker + "\n" + TOON body.
	OutcomeEncoded Outcome = "encoded"
	// OutcomePassthroughNotTabular — non-JSON input, or (adaptive mode) a
	// JSON value that did not classify tabular-uniform. Ordinary traffic,
	// never logged.
	OutcomePassthroughNotTabular Outcome = "passthrough-not-tabular"
	// OutcomePassthroughBelowThreshold — the encoding did not beat the
	// passthrough emission by the configured margin, or the truncation
	// budget was too small to hold marker + one data row.
	OutcomePassthroughBelowThreshold Outcome = "passthrough-below-threshold"
	// OutcomePassthroughError — a genuine encoder failure on input that
	// already parsed as JSON. The only outcome the caller logs and counts
	// (FR-006).
	OutcomePassthroughError Outcome = "passthrough-error"
)