Skip to main content

Glossary

Terms used across the docs. Name origins are given where the English short form is non-obvious. CLI verbs live in the CLI guide.

Type model​

TermMeaning
AbsShort for abstract value (from abstract interpretation). Nudo’s only type system: shape × term × pred × conf. A computable value whose constraints participate in algebra (x > 0 ⇒ x + 1 > 1). Not a type name — the thing variables carry after execution.
shapeExtensional carrier: what the value looks like (prim / obj / arr / tuple / fn / eff / brand / sum / never / any / unknown).
termValue identity: lit (exact 42), var (symbolic α like A1), app (application like (x + 1)).
predConstraint relative to the term (e.g. x > 0, port ∈ [1, 65535]).
confHow exact the abstraction is (displayed as #exact, #path, …). Ladder from best to worst — confJoin keeps the weaker side. See conf grades.
anyUnconstrained JS value union — default for entry params without contracts. The developer may refine it.
unknownInference failed (engine debt) — not a synonym for any.
projectionOne-way, lossy view of Abs (formatShape, absToTSType, schema source). Nothing reads a projection back into analysis.

conf grades​

conf records how much of the value set is actually known. Displayed as #exact, #path, … Rank (strong → weak): exact → path → widened → mock → partial → opaque. Joins keep the weaker grade. Only exact / path project to constraints / dts detail.

GradeMeaningTypical source
exactLiteral or precisely evaluable — one definite value or fully known structure25 #exact, "ab"+"c" → "abc" #exact
pathDepends on path constraints / symbolic identity — precise relative to Φ and predsx + 1 with x > 0 → term (x+1) · > 1 #path
widenedStructure was lost; result is a conservative extensional domainloop joins, call-site budget overflow, selfAdd(number) → number #widened
mockFace comes from a declared mock / harvest, not from observed evaluation@nudo:mock / env harvest
partialIncomplete information — some content known, not the full setopen objects, incomplete modeling, default unknown
opaqueNo usable content for reasoning or projectionbudget truncation (unknown #opaque), unprovable goals, eval failure without a finer face

Product face​

TermMeaning
Observation (Day 0)Reading runtime-adjacent variables from check signatures and IDE hover/inlays.
Contracts (Day 1)Explicit obligations that check validates (actual ⊭ expected).
contractProduct term for those obligations: *.nudo.js sidecar / @nudo:contract. Handwritten = L1.
sidecar*.nudo.js / *.nudo.ts module auto-bound to same-name source exports. Plain JS modules + builders (fn, shape, number().gt(0)).
@nudo:contractIn-source contract; the constraint enters Abs as a Pred.
@nudo:caseDebug witness for nudo test / LSP scenarios — not the contract product.
L1Explicit contract layer: violations are errors (actual ⊭ expected).
L2JS runtime export boundary: undigested entry/export may-throw (nudo:entry-may-throw, default error).
call@Synthesized observation from a real call site (evidence).
entry@Fallback observation for exports with no call sites; params display as any.

Engine​

TermMeaning
evaluatorThe single production evaluation engine: transpile the target into algebra calls ($add, $fork, …) then new Function execute on Abs.
fail-closedOn non-eval sources or evaluation failure, the engine reports no information (unknown / empty exports) instead of guessing or falling back to another evaluator. Same idea for unprovable Pred goals and truncated cache keys.
abstract interpretationThe technique behind Nudo: execute on abstract values rather than concrete samples (tests) or pure AST analysis (classic type checkers).
leqAbsStructural “is at least as defined as” check on Abs used for some assignment shapes.
Pred implicationThe L1 gate: does the actual Abs imply the contract Pred? Bounded prover (linear / equality fragments); otherwise fail-closed.

Deep dives: Abs · Abstract interpretation · Concept layers · Limits · Diagnostics · CLI.