Home / Docs / Specification / 13. Diagnostics, Agent ABI and project files

13.4 Code registry

Release v0.4.0

(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.