Home / Docs / Specification / 13. Diagnostics, Agent ABI and project files
13.4 Code registry
(v0.2, ADR 0056.) The codes U2017 to U2021, of the memory model (spec/17 §10), are in the table. (v0.2, ADR 0057.) U2022, of fixed-width integers (spec/18 §8), is in the table. (v0.2, ADR 0065.) U2023 and U2024, of structured concurrency (spec/19 §10), are in the table. (v0.2, ADR 0066.) U2025 to U2027, of constraints on generics (spec/20 §10), are in the table.
| Code | Domain | Meaning |
|---|---|---|
| U0001 | syntax | Invalid character, byte order mark or lone carriage return |
| U0002 | syntax | Tab in indentation |
| U0003 | syntax | Inconsistent indentation |
| U0004 | syntax | Unterminated text literal |
| U0005 | syntax | Invalid escape sequence |
| U0006 | syntax | Text literal inside interpolation |
| U0007 | syntax | Malformed literal |
| U0101 | syntax | Unexpected token |
| U0102 | syntax | Clause out of order or repeated |
| U0103 | syntax | Reserved keyword not available in the package's edition |
| U1001 | names | Unresolved name |
| U1002 | names | Duplicate definition |
| U1003 | names | Import cycle |
| U1004 | names | Use of a private declaration from another module |
| U1005 | names | Naming convention violation |
| U1006 | names | Undeclared requirement in derived from |
| U1007 | names | Generated requirement marked active |
| U1008 | names | Module path does not match file path |
| U1009 | names | Reserved module name |
| U1010 | names | A module whose first path segment is a dependency's local name |
| U2001 | types | Type mismatch |
| U2002 | types | Unknown or ill-formed type |
| U2003 | types | Wrong number of type arguments |
| U2004 | types | Missing argument label |
| U2005 | types | Unknown argument label |
| U2006 | types | Duplicate argument |
| U2007 | types | Non-exhaustive when over variants |
| U2008 | types | Unreachable arm or misplaced else |
| U2009 | types | Missing or unknown field in constructor |
| U2010 | types | Cannot infer lambda parameter type |
| U2011 | types | Statement value is not Unit |
| U2012 | types | result outside ensures or expect |
| U2013 | types | it or error outside its allowed position |
| U2014 | types | Expression outside the refinement language |
| U2015 | types | Invalid predicate body (impure, failing, recursive or outside RL for reflect) |
| U2016 | types | Opaque predicate called outside checked |
| U2017 | types | Use of a binding after it was passed by take |
| U2018 | types | An edit argument together with another use of its binding in the same call |
| U2019 | types | Assignment to a binding that is not editable |
| U2020 | types | A parameter convention (edit, take) not matched at the call site, or declared where none is allowed |
| U2021 | types | A function with edit or take parameters used as a value |
| U2022 | types | Integer literal does not fit its type |
| U2023 | types | A binding declared outside a together branch assigned, or passed as edit or take, inside it |
| U2024 | types | A together body with a statement other than let, or fewer than two branches |
| U2025 | types | A type argument does not satisfy the constraint of its parameter |
| U2026 | types | An operation on a type parameter that its constraint does not allow |
| U2027 | types | An unknown constraint name |
| U2028 | types | Values of different units meet, or a measured and a unitless value |
| U2029 | types | An invalid unit declaration or unit expression |
| U2030 | types | A unit conversion without an expected unit, or not exact |
| U2031 | types | A float literal rounds to an infinity, or is not zero and rounds to zero |
| U2032 | types | A float literal other than zero, or a float range, as a pattern |
| U2033 | types | A comparison of an F64 with a float literal zero |
| U2034 | types | stop or skip outside a loop body, or across a task boundary |
| U2035 | types | first of with fewer than two branches, or a line that is not an expression; start outside the block of a tasks, inside a task within it, or with a with clause |
| U2037 | types | A decimal scale out of place |
| U2038 | types | A tensor shape, index, permutation or axis out of place |
| U2039 | types | A map, zip_map or update in a function with simd required whose lambda cannot be vectorized for a listed target |
| U2040 | types | A statement after stop or skip in the same block, which never runs |
| U3001 | authority | Capability not in scope |
| U3002 | authority | Operation not permitted by capability type |
| U3003 | authority | Effects exceed declared uses |
| U3004 | authority | Capability used in a pure function |
| U3005 | authority | Capability reference used as a value |
| U3006 | authority | Effectful or failing lambda escapes |
| U3007 | authority | Fallible expression without handling |
| U3008 | authority | if error pass with a different error kind |
| U3009 | authority | Failure variant not in the declared error kind |
| U3010 | authority | Handler does not match its capability |
| U3011 | authority | Handler missing an operation |
| U3012 | authority | Host capability in main not granted by una run |
| U3013 | authority | Effectful or fallible call nested inside an expression |
| U3014 | authority | Host capability used in an example |
| U3015 | authority | std.testing used outside a handler or example |
| U3016 | authority | Second-class type used as a type argument |
| U3017 | authority | of clause that names no parameter |
| U3018 | authority | of clause that names a parameter not of function type |
| U3019 | authority | of clause that names a function type with its own uses or fails |
| U3020 | authority | Call into a boundary module whose capability is not granted with with |
| U3021 | authority | Call that grants a boundary module more than its ceiling |
| U3022 | authority | Labeled operation passed to code that reads it lower |
| U3023 | authority | Header that grants more than its lock in una.toml |
| U3024 | authority | Call into a boundary module from which a release is reachable |
| U3025 | authority | if error clause on an expression that cannot fail |
| U3026 | authority | attempt of a call that cannot fail |
| U3027 | authority | Code that may run forever where it is not allowed to |
| U3028 | authority | A function that says diverges, used as a value |
| U3029 | authority | A failure that must be handled where it is not |
| U3032 | authority | A simd required clause outside a systems package of edition 0.5 |
| U3033 | authority | An operation of HttpServer in the effect set of a together branch, a together for body, a first of branch, or handle or on_stop of a serve module |
| U4001 | security | Flow to a lower label |
| U4002 | security | Implicit flow through control, failure or call under raised pc |
| U4003 | security | Sink label exceeded |
| U4004 | security | policy outside a trusted module |
| U4005 | security | Invalid policy (public via, or type mismatch) |
| U4007 | security | Unknown label category |
| U4008 | security | A text literal with interpolation in a pattern |
| U5001 | verification | Obligation refuted |
| U5002 | verification | Obligation unknown |
| U5003 | verification | Solver missing or version mismatch |
| U6001 | runtime | main failed |
| U6003 | runtime | Call depth or memory limit exceeded |
| U6004 | runtime | A header value contains a control character |
| U6005 | runtime | A host value is not valid UTF-8 |
| U6006 | runtime | The floating-point environment of the platform is not the default one |
| U6007 | runtime | The host stopped the run before it finished |
| U6009 | runtime | The host gave no random bytes for keyed hashing |
| U7001 | project | Non-canonical formatting |
| U7002 | project | Invalid una.toml |
| U7003 | project | Escape budget exceeded |
| U7004 | project | Missing or invalid verification.lock |
| U7005 | project | Trusted module not declared in both header and una.toml |
| U7008 | project | Invalid ita.una or itaty.una |
| U7009 | project | Missing, invalid or inconsistent ita.lock |
| U7010 | project | A package, archive, statement, root, checkpoint or log proof that fails verification |
| U7011 | project | A locked package that is neither in the vendor directory nor in Itaoca |
| U7012 | project | A dependency the root may not use as written |
| U7013 | project | No resolution: no release meets a need, or a bound of resolution is exceeded |
| U7014 | project | A locked release yanked, under an advisory or signed after a stated compromise, or a pending recovery, a key change or a transfer of its owner |
| U7015 | project | The executable cannot be laid out: a branch beyond its target's range, or a section larger than its format allows |
| U8001 | internal | Internal compiler error (always a bug) |
Codes are never reused. Retired codes stay in this table marked retired. Gaps in the numbering, such as U4006 and U6002, are unassigned numbers, not retired codes (ADR 0012). una explain <code> prints a paragraph and a minimal failing and fixed example for every code, but five. U8001 is an internal error, a bug of the compiler, so its text has no example and says how to report it (ADR 0034). U6005 comes from the host's data, which no program text causes, so its text has no example and says how to fix the data (ADR 0086). U6006 comes from the platform's floating-point environment, which no program text causes either (ADR 0114). U7013 comes from una ita when it resolves, from una ita verify for a package it cannot verify yet, and from a load for a registry package whose provenance cannot be verified offline (spec/30 §9 rule 9), which only a registry's signed documents cause, so its text has no example either (ADR 0122 and its amendment of 2026-11-03). U7014 comes from una ita alone, from audit, and from lock and update for a key change, and una check never reports it: its examples are audited against a stated registry state, in which the failing example's locked release is yanked. (v0.4, ADR 0124.) U7015 comes from the linker of una build alone, for an executable too large to lay out, which una check never reports, so its text has no example either.