Error codes
Every diagnostic archec reports — in the terminal, in VS Code, in the playground — ends with its code, [unresolved]. Each code has its page here: what it means, how to fix it, and the automatic fix when archec has one. In the terminal, archec explain <code> says the same.
Style: how the model reads (archec vet)#
19 codes · archec explain style
naming | hint | A name not in its case (archec vet). |
bad-place | error | A canvas line that places something other than a block. |
canvas | hint | A canvas line to write differently (a block placed twice, a size without a place). |
arche-body | hint | A Python body that says only what the action language says (archec vet). |
code-in-model | hint | A long Python block in a model file (archec vet). |
declaration-set | hint | A declaration of the Arche app outside app/*.arche (archec vet). |
defaults | hint | A property every requirement of the file gives alike. |
defaults-child | warning | A declaration inside defaults. |
duration-math | hint | Arithmetic on durations that could be written as one value. |
empty-system | hint | A system with no parts yet. |
extends | hint | A definition built on another written in the long form. |
long-form | hint | A long form (archec vet). |
no-system | hint | No system declared. |
position-twice | warning | A block placed in its own at and in a canvas. |
property-group | hint | Properties that go together written apart (archec vet). |
property-order | hint | Properties out of their order (archec vet). |
same-line | hint | Two items on one line (archec vet). |
vague-word | warning | A requirement that says a word that cannot be verified ("as fast as possible", "TBD"). |
advanced | hint | In a project at level simple, a declaration beyond the 1.0 core (docs/core.md: a process, a hazard, the Arche app…). |
Parse and files#
16 codes · archec explain parse
syntax | error | The text does not parse. |
include-not-found | error | An include names a file that does not exist. |
include-cycle | warning | Files include each other (each is still loaded once). |
schema | error | Generated YAML that fails the Arche project schema (archec build, archec validate). |
alias-keyword | warning | An old spelling of a keyword or a property (msg, porttype, unit "m/s"), or a word written in its other meaning (mode for a state: mode is for operati… |
renamed | warning error | An old name of a declaration a library renamed (its library.arche says renamed "1.0", { Led: GpioLed }). |
not-core | error | With archec check --core only. |
old-form | warning | A second way of writing the same thing. |
emit | warning | Something the emitter could not write to Arche (an address it could not resolve). |
hyphen-minus | error | A name with a - read as one name where a subtraction was meant. |
include-twice | error | A part of a body included twice. |
missing-separator | warning | A word read as part of the Python before it. |
optional-here | error | optional on a variable or an argument, which always holds a value. |
requires-in-body | error | requires inside a body. |
unknown-defaults | error | defaults for a declaration that takes no properties. |
edition | error | A project edition archec cannot read (write edition "0.12"), or newer than this archec knows. |
Names and references#
20 codes · archec explain names
duplicate | error | Two declarations share an id in the same scope. |
unresolved | error | A name does not resolve. |
unknown-property | warning | A property the element does not have (with a did-you-mean). |
instance-cycle | error | A component definition contains an instance of itself. |
unknown-porttype | warning | A port type that is neither built in nor declared. |
unused | hint | A message, type or component definition never referenced. |
dangling-ref | warning | An Arche address written as a string that names nothing of the project. |
extends-cycle | error | A definition that extends itself, directly or not. |
extends-instance | error | extends on a part. |
index | error | An index on a block that is not a repeated part, or out of its range. |
interface-cycle | error | An interface that extends itself. |
rule | warning | A breach of one of the project's rules, or rules that could not be run. |
expand-depth | error | expand with something else than how many calls down it goes (expand 2). |
expand-nothing | warning | expand on a step whose target has no such function, or whose function calls nothing. |
calls-not-in-body | hint | A function that lists calls g while its ```arche body never calls g(). |
seqstep-not-called | warning | A step from a component to one inside it that none of its functions lists in its calls. |
seqref-cycle | error | A sequence whose ref comes back to it, directly or through other sequences. |
seqref-participant | warning | A ref to another scenario's sequence whose steps reach components that are not participants of this one. |
text-ref | warning | A [name] in a text that names nothing in the model. |
translation | warning | An entry of a translations block that names nothing, or says again what is written inline. |
Types, values and units#
17 codes · archec explain types
property-value | warning | A property value of the wrong shape, or not one of the allowed values. |
missing-unit | warning | A duration written without a time unit, or with a non-time unit. |
bad-unit | warning | A duration written without a time unit, or with a non-time unit. |
out-of-range | error | A value does not fit its integer type, or a named type's range. |
type-mismatch | warning | A value of the wrong kind for its type, or a list of the wrong length. |
array-length | warning | A value of the wrong kind for its type, or a list of the wrong length. |
pointer-value | error | A pointer (*T) initialised with something that is not an address. |
pointer-on-wire | warning | A pointer in a message payload. |
void-value | error | void used as a value type. |
flow-unit | warning | A link between ports in different units. |
tolerance | warning | A tolerance on something with nothing to vary. |
union | warning | A union with no cases, or a case named case. |
unit-mismatch | warning | Quantities of different kinds added or compared. |
range-reversed | warning | A range lo..hi (or a force-range) whose lo is above its hi. |
unknown-unit | info | A unit not in the units catalog. |
generic-args | error | A generic struct used with the wrong arguments. |
native-type | warning | A type … native that names itself in no language (cpp "ns::T" include "t.h", rust "crate::T"), or a language's name on a type that is not native. |
Ports, links and interfaces#
36 codes · archec explain links
direction | warning | sends on an in port, handlers on an out port. |
link-direction | warning | A link from an input port or to an output port. |
link-type-mismatch | warning | The two ends of a link have different port types. |
carries-unsent | warning | A link carries a message its source port does not send. |
handler-kind | warning | A message handler on a port type that answers HTTP (or nothing), or the reverse. |
unhandled-message | warning | A link delivers a message the target port has no handler for. |
gpio-payload | warning | A GPIO port sending several messages or a non-bool message. |
contract-unmet | warning | At a link, what the sending end guarantees does not imply what the receiving end assumes. |
contract-unknown | hint | An assumption archec cannot decide at a link. |
bad-endpoint | error | A link end that is neither a port nor a component. |
comm-property | warning | A delivery property (pattern, buffer, depth…) where it means nothing. |
delegate-conflict | error | A delegated port with another type than the port it stands for. |
flow-mismatch | warning | A link carrying one quantity into a port that takes another. |
implicit-interface | hint | An interface used and not declared. |
missing-operation | warning | A port that provides an interface whose operations its component does not implement. |
no-reply | error | A request-reply server port with no handler. |
no-subscriber | hint | A published topic nothing subscribes to. |
operation-signature | warning | An operation implemented with another number of arguments than its interface says. |
pattern-mismatch | error | Two ends of a link with different interaction patterns. |
request-direction | hint | A request-reply client port that is an in. |
self-link | hint | A link from a component to itself. |
wire-field | error | A message field its wire format cannot hold. |
wire-overlap | error | Two fields of a message's wire format share a bit of the frame. |
wire-size | error | A field of a message's wire format past the frame's size, or a size that is not a whole number of bytes. |
wire-range | warning | A field's range its bits do not carry once scaled (raw × scale + offset), an enum literal that does not fit its bits. |
wire-frame | warning | A message a route puts on a CAN bus is longer than the frame. |
unprovided-interface | warning | A link from a port that requires an interface to one that does not provide it. |
wrong-side | warning | A port used from the wrong side of a link (an in as a source, an out as a target). |
oneway-result | error warning | A oneway operation that gives something back. |
raises-not-exception | warning | An operation that raises a struct, a type or an enum. |
param-direction | warning | An out or inout argument with a default. |
dataflow-source | warning | A dataflow sink linked to a port that is not a dataflow source, or to a source that streams another type of sample (vector). |
dataflow-backpressure | warning | The two ends of a dataflow link that do not say the same backpressure. |
no-service | warning | A port that calls a service no in port serves. |
topic-wired | warning | A pub-sub port with a topic that is also linked. |
topic-part | warning | A part of a topic ({id}) that is not a field of the messages the port carries, or ({id: T}) whose type is not one. |
Behaviour: states, actions and tests#
17 codes · archec explain behaviour
unreachable-state | warning | A state no transition reaches from the initial state (initial X, else the first state). |
deadlock-state | warning hint | A reachable state with no way out (nor from a state around it) that is not pseudo final. |
unknown-trigger | warning hint | A transition's trigger that is neither a message, nor an event, nor a port or member of its part, nor raised in any code of the model. |
dead-transition | warning | A transition on a message no input port of the component receives, or with a guard that is false. |
shadowed-transition | warning | A transition an earlier one from the same state, on the same trigger and with no guard, always beats. |
nondeterministic | hint | Two transitions from the same state on the same trigger whose guards are not plainly exclusive (else, not g, x < 0 / x >= 0). |
block-not-simulated | hint | A blocking queue. |
test-line | error | A test case's line in the action language (at 1ms do send probe.water WATER { temperature: 20.0 }, within 50ms expect ctl.state == Idle) that does not chec… |
arche-test-line | hint | A Python test line that the action language says too (send(p.out, M(a=1)) → send p.out M { a: 1 }, True → true, x.state == "S" → x.state == S). |
decision-incomplete | warning | An accepted decision that does not say what was chosen or why. |
decision-option | warning | A decision whose choice is not one of the options weighed. |
mode-initial | warning | Two initial operating modes. |
no-step | hint | A periodic thread with no step. |
step-without-period | warning | A step on a thread with no period. |
timeline | warning | A moment of a test case earlier than the one before it. |
action | error | A body in the action language (```arche) that does not parse or does not type. |
bad-fault | error | A fault in a test step that names no link end, part or function it can act on. |
Code: TypeScript, Python and code blocks#
19 codes · archec explain code
no-body | warning info | Python calls self.f() (or a handler names f) but f has no body, so Arche cannot run it. |
missing-await | warning | A component function called from Python without await. |
not-simulated | hint | A Python body the action language cannot say (a list comprehension, sorted(…, key=…), try). |
code-not-found | error | A code property names a .ts or .py file that does not exist. |
handlers | error | A handlers property that names no handler language. |
handlers-language | warning | Code in another language than the one Arche runs the project in (simulation.yaml behavioral.language, from the project's handlers). |
test-typescript | warning | Test code (a do, an expect, a setup) in a TypeScript project that archec cannot write as TypeScript. |
code-language | error | A body in a ``` block of a language that is not a handler language. |
ts | error warning | TypeScript that does not read (a syntax error, on its line), what has no JavaScript of its own (an enum, a namespace), an import of a module (Arche runs ea… |
ts-portable | info warning | A TypeScript body outside the portable subset (docs/handlers.md, "Portable TypeScript"). |
convert-todo | warning | A statement archec convert-handlers could not translate, kept as a TODO(convert): comment with the original. |
py-not-found | error | A code property names a function that no .py or .ts file in scope defines (quick fix: create it). |
py-params | error | A function's parameters are not self and the fn's arguments, or name something Arche does not give that hook (in TypeScript, a message's hook takes `self, ms… |
py-duplicate | error | Two .py files in the same scope define the same name. |
python | error warning | A .py file that cannot be read (unclosed bracket or string), a top-level name changed by a function (the change is lost when the call ends), or top-level code … |
py-shadowed | warning | A ``` block where the component's .py file also has the def of the same name. |
py-unused | warning | A def of a .py file the model does not use (neither named, bound by its name, nor called). |
fn-placement | hint | A function analysed on one thread but simulated on its part's thread. |
component-not-self-contained | warning | A component folder that uses a name declared outside it. |
Requirements and traces#
11 codes · archec explain requirements
bad-trace-kind | error | A trace with an unknown relationship kind. |
requirement-unverified | info | No test plan or case verifies the requirement. |
requirement-unsatisfied | info | No element satisfies the requirement. |
requirement-no-text | info hint | A requirement without text, or without "shall". |
requirement-wording | info hint | A requirement without text, or without "shall". |
requirement-link | warning | A link to a requirement written from its far end. |
duplicate-trace | hint | The same trace written twice. |
suspect | warning | A link to a requirement reworded since the last baseline. |
ears | error | A requirement's ears sentence archec cannot read, or about a part, a state or a message the model does not have. |
formal | error | A requirement's formal property archec verify cannot read. |
req-conflict | warning | Requirements no implementation can satisfy together (archec verify --conflicts). |
Safety and security#
21 codes · archec explain safety
asil-inherit | warning | A requirement that derives from one with an ASIL (a safety goal, a requirement) and has a lower one that is not a decomposition asil "B(D)", or none written … |
dal-inherit | warning | A requirement that derives from one with a DO-178C DAL and has a lower one, or none written (info). |
asil-decomposition | warning | Decomposed requirements (asil "B(D)") of one parent that do not add up to its ASIL (ISO 26262-9: D = C+A = B+B = D+QM, C = B+A = C+QM, B = A+A = B+QM), or a … |
asil-independence | warning | Two requirements that decompose the same parent and are satisfied by the same element. |
asil-allocation | warning | An element written with a lower ASIL than a requirement it satisfies. |
dal-allocation | warning | An element written with a lower DAL than a requirement it satisfies. |
asil-too-low | warning | A safety goal written with a lower ASIL than its hazard needs (from severity, exposure and controllability). |
cal-too-low | warning | A security goal written with a lower CAL than its threats need. |
error-unreached | info | A hazard whose error … on … no error source reaches. |
fmea-mismatch | warning | A failure mode whose written causes are not the hazards its error reaches in the error model. |
fmea-rpn | warning | A failure mode with a high RPN that nothing mitigates. |
fta-mismatch | warning | A hazard whose fault tree as written (caused-by, gates) has other minimal cut sets than the one derived from the error model. |
gate-cycle | error | A fault-tree gate that contains itself. |
hazard-no-goal | warning | A hazard with an ASIL and no safety goal answering it. |
hazard-target | warning | A hazard whose rate from its causes is above its target. |
stpa-incomplete | warning hint | A control action not considered for each of the four types of unsafe control action (nor said not-applicable), one with no controller or process, a UCA with … |
stpa-no-path | warning | A control action no link carries from its controller to its process, or feedback no link brings back. |
uca-untraced | warning | An unsafe control action that leads to no hazard (causes) or that no constraint prevents (constraint, a requirement). |
mixed-criticality | warning | Safety levels mixed in one address space, with no freedom from interference. |
security-risk | warning | A threat with a high risk and no treatment. |
tara-incomplete | warning | An attack path whose feasibility is unknown. |
Timing and budgets#
15 codes · archec explain timing
watchdog-timeout | error | A watchdog with no timeout (an error: when would it run out?) or no on-timeout (a warning: nothing happens). |
budget-on-system | info | A budget on a system. |
budget-over | warning | What the parts beneath draw adds up to more than the budget. |
budget-unit | warning | A draw in another unit than its budget. |
bus-load | warning | A bus loaded above 70 %. |
chain-gap | warning | A latency chain with two steps no link joins. |
chain-incomplete | hint | A latency chain whose duration cannot be bounded (a step with no known cost). |
deadline | warning | A thread whose worst-case response time is above its deadline. |
deadline-handler | warning | An on-deadline with no deadline (it never runs), or a transition's deadline with no on-deadline (past it, the transition is only dropped). |
e2e-budget | warning | A latency chain longer than its budget. |
handler-blocking | warning | A thread that can miss its deadline because a message handler runs first. |
memory-budget | warning | Processes that may use more memory than their processor has. |
missing-wcet | hint | A periodic thread whose cost is unknown (no wcet). |
overload | error | A core loaded above 100 %. |
unbounded-queue | hint | A queue with no size on a thread of a deployment. |
Deployment: processors, cores and routes#
23 codes · archec explain deployment
allocation-target | warning | Something allocated to an element that is not a component. |
memory-overlap | warning | Two memory blocks of a component overlap in the address space. |
memory-misaligned | warning | A memory block of 2-, 4- or 8-byte elements at an address that is not a multiple of its element. |
memory-field-width | warning | A field of a memory block past the bits of one element (bits "15:8" in a uint8 block), wider than its type holds, or with bits that do not read as "hi:lo". |
memory-field-overlap | warning | Two fields of a memory block share a bit. |
bus-address | error | Two devices with the same address on one I²C bus (a board's port, or a bus component). |
binary-target | error | A binary that runs on no processor (on …). |
simulation-only | warning | A deployment that puts a simulation-only part (its Python runs only in simulation) on a microcontroller. |
bus-unreachable | error | A route over a bus a processor is not linked to. |
core-override | hint | A thread placed on a core outside its process. |
deployment-choice | warning | Several deployments and none named. |
deployment-system | error | A deployment that does not say which system it places (system …). |
double-allocation | error | A part or a function on two threads. |
no-route | error | A link between two processors with no route over a bus. |
not-a-processor | warning | A binary placed on a component with no cores. |
route-bus | error | A route with no bus (over …), or over a component that is not one. |
route-link | warning | A route for a link that does not exist. |
route-local | hint | A route for a link whose two ends run on one processor. |
rtos-process | hint | A process on an RTOS. |
runs-target | error | A thread that runs something other than a part or a function. |
unallocated | warning | A part with behaviour that runs on no thread of the deployment. |
unknown-core | error | A thread placed on a core its processor does not have. |
unpinned | hint | A thread or a process with no core. |
Containers#
9 codes · archec explain containers
container-binary-on | error | A binary inside a container that also says on. |
container-cpuset | error | A thread of a container placed on a core outside the container's core list (its cpuset). |
container-can | warning | A container whose link goes over a CAN bus without network host. |
container-device | warning | A container whose link goes over a bus other than CAN (a serial line…) while it sees no host device (device "/dev/…"). |
container-empty | warning | A container that runs no binary of the model. |
container-host | error | A container on a processor that is not Linux, or has no container runtime. |
container-image | warning | A container that names no image after its id. |
container-network | error | A link leaving a container that has network none. |
container-rt | warning | A policy fifo / rr thread in a container without capabilities sys_nice. |
Boards, pins and parts#
11 codes · archec explain hardware
implicit-catalog | warning | A kind, layer or tag used without being declared. |
board-pin | warning | A pin in pins { … } on a board (or a part of one) that its chip does not name so, or a role archec does not read. |
pin-function | warning | A pin the board cannot use for that role. |
pin-conflict | warning | One pin used by two ports of a board (those the system links, or whose pins a part writes; a Linux header pin's port and the bus on it), or by two roles of one… |
pin-pair | warning | A link whose ends' pins do not pair. |
pin-level | warning | A link between two ports whose pins { level … } differ (3.3V and 5V), a board's io-level being its ports' level. |
board-peripheral | warning | Two ports on one peripheral of a board (both on I2C1, two servos on the PWM0 channel), or more ports of a kind than the board has (a 5th I²C on a board with 4,… |
board-supply | warning | A part powered from a board's rail whose voltage it does not take (voltage on both power ports: a 3.3 V sensor on the 5 V rail, a 5 V sonar on the 3.3 V one). |
board-current | warning | The parts powered from one rail draw more than it gives (current on the rail and on each part's power port, or a part's power over the rail's voltage). |
part-lifecycle | warning | A part number at its end of life, or not recommended for new designs, as the last archec parts found (.arche/parts-cache.json, with its date). |
part-stock | warning | A part number none of which is in stock, or that the distributor does not know, as the last archec parts found. |
Physics and simulation#
11 codes · archec explain physics
equation | error | An equation not written der(x) = … or y = …, or a name in it the component does not have. |
physical-balance | error | A part with physical ports whose equations are not as many as its unknowns. |
physical-structure | error | A physical network that cannot be sorted. |
physical-link | error | A link that joins a physical port to a port of another type, or to a port that is not physical. |
physical-value | error | A parameter of a physical part whose value is not a number archec can work out. |
fit-no-influence | warning | archec fit. |
fit-correlated | warning | archec fit. |
body | error | A part's shape or joint that does not read. |
realism-port | warning | How a sensor reads (noise, resolution) said where no sensor reads — on an in port that provides no interface, or on a part that is not kind sensor — or h… |
keyframe-name | error | A line of a keyframe that names nothing it can set. |
body-unmapped | warning | In a system whose parts say their shape or joint, a part archec gen --target mujoco cannot place. |
CAD: geometry, limits and clearances (archec cad)#
20 codes · archec explain cad
cad-file | error | A cad that names no Python file that is there, or a material or density that cannot be read. |
cad-limit | error | A limit on a geometry that cannot be read. |
cad-clearance | error | A clearance that cannot be read. |
cad-place | error | A part placed (at box.mount) on a part that is not there, that has no geometry, or that has no such anchor. |
cad-limit-over | warning | What archec cad measured of a geometry does not keep a limit of a requirement. |
cad-clearance-short | warning | Two placed parts are nearer than a clearance asks, or run into each other. |
cad-fit | error | A fits that cannot be read. |
cad-fit-off | warning | A standoff the box gives a board is not under one of its mounting holes, within the tolerance of fits. |
cad-board | error | A board's pcb that names no KiCad board that is there or has no outline, or an outline or a hole that cannot be read. |
cad-board-read | warning | Something of a board's mechanics is read with a doubt. |
cad-outline-differs | warning | A board's geometry (cad) is not the size its outline says (its pcb, or outline). |
cad-sourced | error | A sourced that names no system. |
cad-unsourced | warning | A requirement asks that a system is sourced, and a bought part of it has no part number. |
cad-sourcing | info | A bought part, in a system whose parts have a geometry, has no part number (product { part-number "…" }). |
cad-erc | warning | KiCad's electrical rules check (kicad-cli sch erc) found violations in the schematic beside a board's pcb, when archec cad last ran it. |
cad-drc | warning | KiCad's design rules check (kicad-cli pcb drc) found violations in a board's pcb, when archec cad last ran it. |
cad-mass-differs | warning | A part says a mass that is not the one measured of its geometry (by more than 1 %). |
cad-shape-differs | warning | A part says a shape whose size is not that of its built geometry (by more than 2 %, and 1 mm). |
cad-stale | info | A geometry's file changed since archec cad built it. |
cad-not-built | info | A geometry archec cad has not built yet. |
FPGA components: what can be synthesised, widths (archec gen --target vhdl), the device and the limits of archec synth#
12 codes · archec explain fpga
fpga-synthesis | error | In an FPGA component (one with clock clk 100MHz). |
fpga-recursion | error | In an FPGA component. |
fpga-width | warning | In an FPGA component. |
fpga-cdc | error | A link between two FPGA parts on different clocks. |
fpga-overflow | warning | In an FPGA component. |
fpga-divide | warning | In an FPGA component. |
fpga-loop | warning | In an FPGA component. |
synth-limit | error | A limit on what synthesis measures (limit Pwm.luts <= 500, limit Pwm.fmax >= 100MHz) that cannot be read. |
synth-device | warning | The chip of a kind fpga part is not a device archec synth can build for. |
fpga-clock | error | An FPGA component's clock that cannot be read (clock clk 100MHz: a name, then a frequency above zero) — or, as a warning, a cycle that is not a whole numbe… |
fpga-reset | error | An FPGA component's reset that cannot be read. |
fpga-step | error | An FPGA component's step that names no function of the component, or one that takes parameters. |
Execution and memory: threads, placements, allocators, buffering#
13 codes · archec explain execution
exec-no-thread | error | A part placed execution active that no thread runs. |
exec-conflict | error | A part said passive or protected that a thread runs (it is active), or placed in another process than the thread that runs it. |
runs-port | error | A thread that runs an out port. |
affinity-core | warning | A thread whose core is not among the cores of its affinity. |
alloc-size | warning | An allocator with no block-size. |
alloc-memory | error | An allocator in a memory of another processor that is not shared. |
alloc-local-mapped | error | An allocator in a local memory (not shared) that is mapped. |
alloc-overflow | error | An allocator too small for what is in it. |
alloc-other-process | error | A part (or a port's buffering) that takes memory from an allocator of another process or binary. |
memory-role | warning | A memory saved|tmp (an algorithm's working memory) for a part that is not an algorithm, or a memory other than comm on a port. |
buffering-share-destroy | error | A dataflow port's buffering that shares its buffer (transfer share) and frees it once sent (destroy after-transfer). |
buffering-reuse | error | build reuse on an input, without the input it reuses, or naming one that is not an input of the part. |
buffering-port | warning | buffering on a place of a part. |
Signal processing: algorithms, composites, metrics, dataflow links#
6 codes · archec explain dataflow
algo-stereotype | warning | A stereotype on a component that is not kind algorithm, an instance's stereotype (disable-thresholds, bypass-config-threading) on a definition or an algo… |
algo-parameter | warning | A parameter configuration|internal on a variable of a component that is not kind algorithm. |
algo-composite | warning | A part of a composite algorithm that is not an algorithm. |
algo-execute | hint | An algorithm with nothing to run. |
algo-precedence | error | Parts of a composite that run after each other in a circle, or one after itself. |
metric-no-producer | warning | An input that reads a metric on a topic filter (/chain/*/SNR) that no part publishes on. |
Libraries, generators and what leaves the machine#
14 codes · archec explain libraries
gen-stranded | warning | Your code in a USER CODE region of generated/ belongs to an element the model no longer has. |
generator | error | A generator says what it is in more than one way (or in none: templates, script or command), names a folder or a file that does not exist, starts `from… |
generator-option | warning | A generator (an importer, an exporter, or a binary's or a process's options <generator> { … }) sets an option that it, or the one it starts from, does not … |
egress | error | A project allow or deny that names no service (claude, local-ai, store, polarion, parts, issues, libraries, sigstore, github, or all), a URL without its sc… |
library-archec | error | A library that needs another archec version. |
library-changed | warning | A library whose files changed under the version arche.lock recorded. |
library-conflict | error | Two versions of one library asked for. |
library-lock | warning | A library not in arche.lock, or not in the version it names. |
library-trust | error | A package from the Arche Store that the project's trust does not accept. |
library-sigstore | error | A package from the Arche Store taken without a Sigstore bundle cosign verified, in a project whose trust asks for one (trust reviewed, sigstore). |
library-yanked | warning | A package from the Arche Store its publisher yanked (archec store outdated records it). |
library-missing | error | A library the project uses that is in none of its libraries folders. |
library-version | error | A version range that is not one, or that no version of the library is in. |
shelf-suggest | hint | Something written by hand that a shelf of the store already has. |
Views, animations and stories#
11 codes · archec explain presentation
animation-template | error | An animation names a template Arche does not have (archec animation list shows them), or has neither a template nor code "x.html". |
animation-code | error | An animation's code names an HTML file that does not exist (relative to the file the animation is written in). |
animation-data | warning | An animation gives its template data it does not read, of the wrong shape (a word where a number is wanted, a field its records do not have), a path that nam… |
animation-binding | error warning | An animation's machine or scenario names nothing (or a component with no state machine, a scenario with no sequence) — an error. |
animation-param | warning | An animation's params names something that is not a constant or parameter, or its own drawing (code) reads a parameter params does not send — it would … |
animation-library | info | This build of archec has no animation library (vendor/animations.js). |
animation-visual | warning | A story step animates something that is not a visual or an animation of the project. |
latex-unbalanced | warning | Unbalanced $ or braces in LaTeX math. |
bad-color | warning | A color literal that is not #rgb / #rrggbb. |
view-empty | warning | A term of a view's query (include, exclude) that matches nothing in its system, or a view that shows nothing. |
view-query | error | A term of a view's query that cannot be read. |
The product's user interface#
10 codes · archec explain ui
ui-structure | error warning | A ui that does not hold together. |
ui-binding | error warning | What a ui element is bound to, or what its action does, that does not hold. |
ui-dead-press | warning hint | A press that reaches nothing. |
ui-test | error warning | A ui step of a test case that does not hold. |
ui-unreachable | warning | A screen no goto reaches from the one the ui starts on, or a screen (not the start) with no way out — no back, no goto from it or from an overlay. |
ui-safety | warning hint | A safety-relevant message — on a port a hazard's error … on names, said in a hazard's or a safety goal's text, or tagged safety — shown on some screens only,… |
ui-fit | warning | A screen whose content needs more than the display (an estimate: the elements' usual sizes, the gaps), a text wider than the display, a touch target under 9 mm… |
ui-bound | error warning hint | A for whose list can hold more items than its max (Fault[9] with max 8: the last ones are never shown; the quick fix draws them all), a for with no `… |
ui-a11y | warning hint | Contrast under WCAG AA — the theme's text on its backgrounds and buttons (4.5:1), a colored text (4.5:1) or a colored telltale, gauge or bar (3:1) on the backg… |
ui-text | warning | A text of the ui not translated into a language the project's other texts are ("…" en "…", or a translations entry). |