Remove obsolete migration, roadmap and research documentation. Describe the current native/ZX/Wasm pipeline, manual safety and offline learning. Refresh current guides and remove historical website prose while preserving unpublished audio work.
2.4 KiB
Implementation status
This reference covers Ziran 0.6.0 and Unreleased work on master. Query the
installed tool with ziran version, ziran features --json and
ziran capabilities --json for its exact contracts and target limits.
Compilation and execution
Source → ZIR → LIR → optimized LIR → ZX → native (ELF/PE, x86-64/AArch64/ARMv7). WebAssembly lowers from verified ZX through zx2wasm. C and Go export from ZIR through zi2c and zi2go.
ziran build FILE.zi defaults to direct native output. Explicit targets are
--target=c, --target=go, --target=wasm and --target=zx.
ziran run FILE.zi checks and runs the entry; Linux x86-64, AArch64 and ARMv7
use native execution. Native lowering failures report a named gap before
execution. They do not retry on the instruction engine.
ZX is revision 28 executable output. zi2zx --emit lir exposes the linked
inspection view; --opt --emit lir exposes optimized LIR and
--opt --emit opt-report reports optimizations. Optimization precedes ZX
emission. zx2native consumes decoded and verified ZX; zx2wasm emits wasm32.
See ZX, ZIR and architecture.
Language and library reference
The checker supports procedures, records, enums, generic specialization,
imports, fixed arrays, slices, vectors, compile-time execution, laws and
explicit foreign bindings within the contracts reported by ziran features.
A checked program can still use operations unavailable on its selected target;
check the actual target before distributing it.
- Language reference
- Compiler and standard library guide
- Owned values
- Laws and proofs
- Unicode
- Packages
- Feature registry
- Authoring workflow
Runtime safety
Safety is manual by default. --checks opts into build-wide runtime checks;
#checks retains bounds checks in selected regions. The instruction engine
always checks. Generated Go also has its own runtime checks. These mechanisms
have different coverage; see checks.
Learning
Native builds record a local corpus by default. ziran learn off disables
recording; ZIRAN_LEARN=off overrides it for a command. Benchmarks run with
learning off. C-teacher verification and policy training are offline commands;
normal builds use the checked-in policy table. See learning.