A failure the engine can name carries an FLX-nnnn code. The thousands digit says which part of the engine raised it. fluxsim explain FLX-nnnn prints the same text offline, and fluxsim explain --list lists every code.
| Code | What it means |
|---|
| FLX-1001 | float value in a document being canonicalised |
| FLX-1002 | digest comparison across two domains |
| FLX-1003 | integer outside the JSON safe-integer domain |
| FLX-1004 | mapping key cannot be coerced to a string |
| FLX-1005 | value class has no canonical JSON form |
| FLX-1006 | non-finite Decimal in a document being canonicalised |
| FLX-1007 | two mapping keys collide after canonicalisation |
| Code | What it means |
|---|
| FLX-2101 | the bundle's inputDigest has moved since the plan was recorded |
| FLX-2102 | the recorded plan's own planDigest has moved |
| FLX-2103 | trace op outside the flux-trace/1 vocabulary |
| FLX-2104 | trace op field set does not match flux-trace/1 |
| FLX-2105 | golden update without a reason and a changelog row |
| FLX-2106 | a replay produced a different run digest than the one asserted |
| FLX-2107 | no recorded plan at this run id |
| FLX-2108 | the recorded seed-path list is missing or no longer matches the plan |
| FLX-2109 | no applied run at this run id |
| FLX-2110 | run artifacts do not reproduce the recorded run digest |
| FLX-2111 | a --committed-slice names an expose this run does not emit |
| FLX-2112 | the run id is not a safe identifier |
| FLX-2113 | the run directory does not belong to the plan it holds |
| FLX-2114 | the run digest moved from the recorded golden baseline |
| FLX-2201 | run touched a seed-tree path the plan did not anticipate |
| FLX-2202 | seed-tree input outside its declared domain |
| FLX-2301 | the run's cast does not resolve |
| FLX-2302 | journey transition is not in the taxonomy |
| FLX-2303 | journey step budget exhausted |
| Code | What it means |
|---|
| FLX-3001 | declared column type is outside the closed logical type set |
| FLX-3002 | binary floating-point value at the seam |
| FLX-3003 | value cannot be rendered as its declared logical type |
| FLX-3004 | expose schema cannot be compiled into an ordered column set |
| FLX-3101 | declared contractDigest does not match the in-bundle contract |
| FLX-3102 | emit productRef resolves to no FLUID document in the bundle |
| FLX-3103 | emit exposeId is not an expose of the referenced product |
| FLX-3104 | referenced contract does not satisfy the pinned fluidVersion |
| FLX-3105 | bundle does not validate, so its seam cannot be resolved |
| FLX-3106 | run artifact would be written inside the bundle |
| FLX-3107 | bundle directory not found |
| FLX-3108 | the bundle directory holds a file this engine does not recognise |
| FLX-3201 | row carries a column the expose does not declare |
| FLX-3202 | row is missing a required column |
| FLX-3203 | positional row does not match the declared column count |
| FLX-3301 | emit writer used out of order |
| FLX-3302 | a required expose column has no runtime attribute mapped onto it |
| FLX-3401 | no distribution family is available for this column |
| FLX-3402 | declared statistics do not parameterise the chosen family |
| Code | What it means |
|---|
| FLX-4001 | declared zone is outside the document's allowed zones |
| FLX-4002 | AI call denied by the document's agentPolicy |
| FLX-4003 | decision record does not satisfy the RFC-04 decision contract |
| FLX-4004 | cumulative token spend exceeds the effective budget across calls |
| FLX-4101 | fidelity: agentic declared without the agentic extension installed |
| FLX-4102 | skill binding is not permitted by the document's agentPolicy |
| FLX-4103 | fidelity: stochastic declared with no sweep executor available |
| FLX-4104 | Simulation.spec.fidelity names a value this engine does not recognise |
| FLX-4110 | no jurisdiction is known for a market |
| Code | What it means |
|---|
| FLX-5001 | intermediate magnitude outside the declared field capacity |
| FLX-5002 | encoding-error bound is not smaller than the declared tolerance |
| FLX-5003 | value on the fixed-point grid is not exact |
| FLX-5004 | declared grid parameter is invalid or not representable |
| FLX-5005 | statistic refused: sample outside the declared bounds |
| FLX-5010 | the check budget for this committed state is exhausted |
| FLX-5011 | the committed statistic was formed under different declarations |
| FLX-5012 | the committed state is older than the declared maximum age |
| FLX-5013 | the boundary store cannot supply this committed state's blinding value |
| FLX-5020 | declared weights do not sum to 1 |
| FLX-5021 | draw parameter outside its declared domain |
| FLX-5022 | virtual clock or scheduler input outside its declared domain |
| FLX-5030 | the fidelity block is malformed |
| FLX-5031 | a column named by the fidelity block is not a member of the expose |
| FLX-5032 | histogram bins do not partition the declared range |
| FLX-5033 | a correlation property is incompletely declared |
| FLX-5034 | a parameter the declared property needs is absent |
| FLX-5035 | the committed slice cannot be read as a committed state |
| FLX-5040 | population declaration cannot be materialised |
| FLX-5041 | value is outside the domain the kernel can hash |
| Code | What it means |
|---|
| FLX-6001 | not derivable from the flux-expr/1 grammar |
| FLX-6002 | reserved word held for flux-expr/2 |
| FLX-6003 | literal outside the declared closed set |
| FLX-6004 | unknown path for this scope |
| FLX-6005 | type mismatch |
| Code | What it means |
|---|
| FLX-7001 | observed readout predates its registered prediction |
| FLX-7002 | observed readout does not match its claimed prediction |
| FLX-7003 | prediction id is not a safe identifier |
| FLX-7004 | no prediction was registered at that registration timestamp |
| FLX-7005 | accuracy document does not have the required shape |
| FLX-7006 | an input document named on the command line does not exist |
| FLX-7010 | seam credibility gate not met |
| FLX-7011 | promotion policy document is malformed |
| Code | What it means |
|---|
| FLX-8001 | the ship gate withheld the bundle |
| FLX-8002 | the fidelity record is malformed or its signature does not verify |
| FLX-8030 | generated evidence prose contains a reserved word |
