# 1.0.0-beta.23 Standard Library Stability Tier Ledger And Catalog Alignment

## Scope

`1.0.0-beta.23` is a documentation/catalog clarity slice for the standard
library. It adds a public stability-tier ledger and aligns the surrounding
README, roadmap, release-note, and specification text with the generated API
catalog boundary.

This release does not change the source language, typed core, runtime
capabilities, standard-library helper surface, compiler-known runtime names,
ABI/layout policy, or package behavior. It does change generated catalog
output and release-gate checks so tier metadata is visible and enforced.

## Contract

The public standard-library docs use exactly these tier labels:

- `beta-supported`
- `experimental`
- `internal`

The generated `docs/language/STDLIB_API.md` catalog remains the exact exported
signature inventory generated from `lib/std/*.slo`. The new
`docs/language/STDLIB_TIERS.md` ledger records maturity and stability
expectations for those helpers and surrounding standard-library domains.

Experimental domains in the beta23 ledger include JSON, loopback networking,
random/time, and filesystem resource-handle helpers. Concrete vector modules
remain beta-supported concrete lanes; they are not a generic collections
freeze and do not imply executable generics, maps, sets, iterators, mutable
vectors, slice/view APIs, runtime collection changes, or stable ABI/layout.

## Non-Scope

This scope does not add:

- source-language syntax
- standard-library helpers
- compiler-known `std.*` runtime names
- runtime C capabilities
- package, workspace, import, or registry behavior
- stable standard-library/API compatibility freeze
- stable manifest schema freeze
- stable Markdown schema freeze
- stable ABI/layout
- performance claims
- beta maturity beyond the existing `1.0.0-beta` line

## Acceptance Criteria

- `docs/language/STDLIB_TIERS.md` defines the public tier labels and their
  current meaning.
- The tier ledger marks JSON, loopback networking, random/time, and filesystem
  resource-handle helpers as experimental domains.
- The tier ledger records concrete vector modules as beta-supported concrete
  lanes without claiming generic collection stability.
- README, `lib/std/README.md`, language release notes, language roadmap,
  post-beta roadmap, and the v1 spec link or describe the tier ledger.
- Documentation states beta23 is docs/catalog tooling clarity only and does
  not add language, stdlib, runtime, stable schema, or stable API behavior.
- The generated API catalog emits tier metadata, and the release gate checks
  that experimental tiers remain represented.

## Suggested Gates

```bash
node --check scripts/render-stdlib-api-doc.js
node --check scripts/check-stdlib-api-tiers.js
./scripts/render-stdlib-api-doc.sh
./scripts/check-stdlib-api-tiers.js
git diff --check
```
