Stability & Compatibility

Hale is pre-1.0. What a release may change, and how you hear about it, is written down in STABILITY.md. In short:

Hale is pre-1.0. What a release may change, and how you hear about it, is written down in STABILITY.md. In short:

Tiers

Section titled “Tiers”

Every stdlib namespace and every file of the specification is marked stable or experimental. Before 1.0 the mark is information: it says which surface is settled and which is new or still moving (each experimental row says why). Both may change in any release. At 1.0 the stable tier is what the 1.x promise covers.

A function whose name begins with __ is a compiler hook, not surface, whatever its namespace’s tier. The table below is generated from spec/stability.toml. A test keeps it in step with the stdlib and the spec, so a new namespace or spec file cannot land without a tier.

Standard library

Section titled “Standard library”
namespace tier notes
std::api experimental the api binding’s surface rows are still converging (GH #1417, R-series)
std::bus stable
std::bytes stable
std::bytes::builder stable
std::compress stable
std::crypto stable experimental: keccak256, rsa_pss_sha256_sign, rsa_pss_sha256_verify, secp256k1_public_key, secp256k1_sign, secp256k1_verify, secp256k1_recover. the chain-signing primitives are new (#1935)
std::decimal stable
std::diag experimental counters for tests and leak hunts, not a program’s interface
std::env stable
std::hex stable
std::http stable
std::i16 experimental new (GH #2132)
std::i256 experimental new (GH #1934)
std::i32 experimental new (GH #2132)
std::i8 experimental new (GH #2132)
std::io::file stable
std::io::fs stable
std::io::h2 experimental the HTTP/2 transport is young and its hooks are all internal
std::io::mirror experimental the double-mapped receive ring’s hooks; internal to the transports
std::io::sockopt stable
std::io::stdin stable
std::io::stdout stable
std::io::tcp stable
std::io::tls stable
std::io::udp stable
std::io::unix stable
std::json stable
std::json::Value stable
std::log stable
std::math stable
std::metrics experimental observability is becoming pluggable; the metric API will move with it
std::net experimental new (GH #1908): resolve only, its return shape may grow a pinned-address dial
std::observe experimental the observe backends are new (GH #1592) and pluggable observability is in progress
std::os stable
std::process stable
std::rand stable
std::regex stable
std::ring experimental the SPSC ring’s hooks; internal to the shared-memory bus
std::secret experimental the local vault serves DNA and the habitat, whose shape still moves
std::shm experimental timestamps of the zero-copy bus’s last record; tied to the shm_ring layout
std::str stable experimental: cut, cut_last, eq_ignore_case, last_index_of, lines, parse_bool, split, trim_end, trim_prefix, trim_start, trim_suffix, words. the splits and trims and the for sources split, lines and words are new (#1995); promoted after one minor
std::tar experimental added for DNA’s packaging; the API is the minimum DNA needed
std::term stable
std::test stable
std::text stable
std::text::base64 stable
std::time stable
std::ts experimental the tree-sitter shim parses Go only, for DNA’s ingest
std::u16 experimental new (GH #2132)
std::u256 experimental new (GH #1934)
std::u32 experimental new (GH #2132)
std::u64 experimental new (GH #2121)
std::u8 experimental new (GH #2132)
std::url stable

Specification

Section titled “Specification”
file tier notes
spec/api-description.schema.json experimental the api description’s schema moves with spec/api.md
spec/api.md experimental the api binding’s surfaces, transports and clients are still converging (GH #1417)
spec/decisions.md stable non-normative record.
spec/design-rationale.md stable non-normative record.
spec/dna.md experimental DNA is a library built on the language, and its surfaces move with its delivery
spec/ffi.md stable experimental: § WASM host interface; § C→Hale re-entry: @export fn on native (Crumb batch 2, 2026-07-27).
spec/forms.md stable
spec/glossary.md stable non-normative record.
spec/grammar.ebnf stable
spec/habitat.md experimental the habitat’s verbs, rows and backends move with DNA
spec/keywords.txt stable
spec/memory.md stable experimental: § Allocator implementation outline; § What the compiler emits; § Codegen ABI (v0).
spec/model.md experimental the canonical model’s tables grow with every judgment family; its Reserved families have no producer
spec/packages.md experimental the manifest, the lockfile and hale fetch are a first cut; registries and version resolution are not designed
spec/precedence.md stable
spec/projects.md stable
spec/registry.md experimental a generated index of the compiler’s own families; it describes the implementation, not the language
spec/runtime.md stable experimental: § Observe backends; § Diagnostic + tuning env vars; § Runtime size budget.
spec/semantics.md stable experimental: § Probes; § Observe backends (GH #1592).
spec/stdlib.md stable
spec/styleguide.md stable
spec/testing.md stable experimental: § Property-based testing.
spec/tokens.md stable
spec/types.md stable experimental: § U64 — a 64-bit unsigned integer; § Fixed-width integers — I32, U32, I16, U16, I8, U8; § U256 and I256 — 256-bit integers; § Scalar types (GH #1076); § Roles (GH #1109, #1417); § Working-set estimator (F.32-2).
spec/units.md experimental the unit dialect is new (GH #1076) and its rows are still growing
spec/verification.md stable experimental: § Fleet composition (GH #408 Phase 1); § The requirements artifact (GH #1835).

The graph registry’s Reserved families (runs_under, transitions, view) are experimental until they have a producer.

Keywords

Section titled “Keywords”

The keyword list is pinned: spec/keywords.txt holds every hard and contextual keyword, and a test fails on any change to it, so a change is deliberate. Before 1.0 a change needs no RFC: adding, removing or reclassifying a keyword takes a decision entry in spec/decisions.md and a CHANGELOG fragment. F.47 freed trait, impl, async, await, macro and export: each is an ordinary name.