LEGACY DOCS · 12.0Stable is 13.2. This page stays because it still owns historical or unchanged contracts.CURRENT 13.2 →
RELEASE LINE13.2 HISTORICAL13.1 PREDECESSOR13.0 PREVIOUS12.4 NATIVE MIRARCHIVE

V12.0 BASE CONTRACT

DBYTE 12.0 CANONICAL MANUAL

CURRENT PACKAGE IS 12.2.1 PACKAGING CORRECTION; SEMANTIC CONTRACTS REMAIN 12.2.0 MODERN NATIVE FOUNDATION. THIS PAGE REMAINS THE 12.0 CANONICAL BASE CONTRACT.
AUTHORITY    v12.0.0 TAGGED CONTRACT
PIPELINE     AST -> CANONICAL HIR -> MONO -> PROFILE -> BACKEND
LANGUAGE     GENERICS / ENUMS / OWNERSHIP / VIEWS / CLOSURES / DEFER
HOSTED       TREE + BYTECODE VM
NATIVE       i686 ELF32 OBJECTS / ARCHIVES / LINKER
INTEROP      i686 CDECL SUBSET
SYSTEMS      KERNEL + USER PROFILES
DEFERRED     OWNED STRING / ARRAY / DROP / COLLECTIONS / X86_64 APPS

00 canonical law§

  1. Parsing is shared; canonical project analysis owns meaning.
  2. HIR records resolved identity, types, places, ownership actions, layouts and call conventions.
  3. Monomorphization produces closed concrete HIR before a backend runs.
  4. Profile validation rejects unavailable capabilities but does not reinterpret valid language semantics.
  5. Backends adapt representations; they do not resolve names or type-check v12 syntax again.
  6. Website prose links back to tagged mirrors and executable fixtures; it is not a new specification.

10 start here§

  • 10INSTALL — exact archive identity, extraction, PATH setup and smoke checks.
  • 11FIRST PROGRAM — one source executed by tree and VM.
  • 12BUILD · RUN · TEST — hosted and native commands plus failure semantics.
  • 13RELEASE 12.0.0 — artifact, feature, target and evidence boundary.

20 language semantics§

TopicRead forRepresentation · rule
TYPESCanonical identities and target layout.Fixed integers, usize, pointers, views, aggregates, enums and callables.
FUNCTIONSResolved direct/indirect calls.DByte or C convention recorded in HIR.
GENERICSSymbolic body checks and specialization.GenericDefId + TypeId list; no runtime dictionary.
STRUCTSNamed construction and field identity.Declaration-order target layout.
ENUMSPayload construction and ABI.u32 tag plus aligned payload.
MATCHExhaustiveness and move/borrow modes.Resolved arms and unreachable default edge.
RESULT + ?Single evaluation and propagation.Exact Err TypeId plus cleanup path.
OWNERSHIPCopy, move and illegal reuse.Action annotation on every value use.
BORROWINGLexical aliases and return provenance.Shared immutable or exclusive mutable.
SLICESBorrowed indexed views.Two-word non-null pointer + length.
STRINGVIEWBorrowed UTF-8 storage.const byte pointer + byte length.
FUNCTION VALUESIndirect calls and coercion.Checked callable shape and convention.
CLOSURESExplicit captures.Concrete source-order environment.
DEFERCleanup on every lexical exit.Explicit LIFO HIR edges.
POINTERSMutability, arithmetic and dereference.ptr[T] · const_ptr[T], usize casts only.
C ABIi686 cdecl calls and callbacks.Scalar ABI plus pointers to repr(C) aggregates.

30 toolchain manual§

  • 30CLI — command ownership and target/emit combinations.
  • 31ELF OBJECTS — ET_REL sections, symbols, metadata and relocations.
  • 32STATIC ARCHIVES — canonical Unix ar and fixed-point extraction.
  • 33LINKER — symbol resolution, REL addends and entry synthesis.
  • 34INSPECT — HIR/layout and binary structure views.
  • 35TARGETS — hosted, VM, freestanding/kernel and user capability gates.

40 systems path§

  • 40DBYTE32 — legacy scalar ABI plus additive aggregate rules.
  • 41LAYOUTS — normal, repr(C), packed, array and compile-time queries.
  • 42INTRINSICS — bounded privileged instruction surface.
  • 43INTERRUPTS — classes, frame layouts, stubs and IRETD.
  • 44BARE METAL — source-to-object-to-link-to-QEMU path.
  • 45USER PROCESS — Ring3/TSS/private CR3/syscall/fault containment.
  • 46DBYTEOS — frozen machine-ownership lineage.

50 implementation internals§

60 hard reference§

F0 evidence discipline§

SEMANTICS   CANONICAL HIR SNAPSHOT + PARITY CORPUS
ARTIFACT    SHA256 + ELF/ar PARSE + OBJDUMP
ABI         DISASSEMBLY + CROSS-CALL EXECUTION
NATIVE      QEMU SERIAL + INTERRUPT/FAULT TRACE
STORAGE     GUEST WRITES + INDEPENDENT HOST PARSER
BOUNDARY    NEGATIVE PROFILE TESTS + FORBIDDEN TOKEN GATES
DELIVERY    SOURCE MIRROR HASH + FIXTURE INJECTION + ZERO JS

70 developer surfaces§

  • 70PLATFORM STATUS — current Windows host distribution, Linux and macOS nonclaims, host-vs-target law.
  • 71API + STDLIB CATALOG — one landing map for language, hosted compatibility and systems APIs.
  • 72REPRODUCE PROOFS — release verifier, machine-proof classes and evidence-record format.
  • 73POST-V12 ROADMAP — v12.1 runtime, v12.2 collections, historical v12.3 modern-native plan (superseded by v12.2); future only.

FF next read§

For the complete hosted-to-machine history, continue to DBYTE ROOT MAP. For artifact identity and the precise release boundary, continue to DBYTE 12.0.0 RELEASE.