aontu

Error codes

Every error aontu raises carries a code, and every code has a class. The class says what kind of thing went wrong, which is what decides your next move.

This is the registry itself, not a description of it: test/spec/errcodes.tsv is a shared contract both implementations execute, and each asserts set equality against: a code in one engine and not the file fails that engine's suite. Codes are append-only; renames are forbidden.

Machine-readable: /errors.json, or /errors/<code>.json for one.

parse 53

the text is not a document: fix the syntax at the site the frame points at

conflict 55

two values cannot both hold: one of them is wrong: aontu model why names both and where they were written

incomplete 11

nothing contradicts, but the value is not concrete: supply what is missing, or accept it with --partial

reference 27

a path names nothing: check the spelling; aontu model get $ --keys lists what is there

compat 13

a change breaks an earlier version: that is aontu subsume / aontu breaking talking: widen the change or version it

budget 7

evaluation hit a deterministic limit: usually a cycle; simplify, or raise the budget deliberately

internal 6

the engine surprised itself: a bug worth reporting