docs: flagship README for the 8.0 GA; GA version is 8.0.1

Rewrites the README around the feature-showcase structure: write->index->query
table, runnable quick start (subtype-correct on the 8.0 strict default, real
VerbTypes), feature tour with per-pillar code, the scale-up path to
@soulcraft/cor, and measured-only performance claims with benchmark citations.

GA retargets to 8.0.1: npm permanently retired the 8.0.0 version number after
a January development-cycle publish/unpublish, so the first stable 8.x release
is 8.0.1. RELEASES.md documents this; the phantom 8.0.0 CHANGELOG entry is
removed (the release run regenerates it as 8.0.1).
This commit is contained in:
David Snelling 2026-07-02 15:11:41 -07:00
parent bf4a333f9b
commit e44620e91d
3 changed files with 138 additions and 397 deletions

View file

@ -10,9 +10,14 @@ Full auto-generated changelog: `CHANGELOG.md` · Releases: https://github.com/so
---
## v8.0.0 — 2026-07-02 (GA, npm tag `latest`)
## v8.0.1 — 2026-07-02 (GA, npm tag `latest`)
**8.0.0 is the first stable major on the u64-id core.** It ships in lockstep with the optional
> **Why 8.0.1, not 8.0.0:** the `8.0.0` version number was consumed on npm by a January
> development-cycle publish that was immediately unpublished — npm permanently retires an
> unpublished version number. `8.0.1` is the first stable release of the 8.x line; there is no
> separate 8.0.0.
**8.0.1 is the first stable major on the u64-id core.** It ships in lockstep with the optional
native provider's `3.0` (the billion-scale path). Everything below works standalone on the open-core
JS engine — a native provider is feature-detected and only changes the scale ceiling, never the API.
@ -134,7 +139,7 @@ rebuild). Opt out of the backup with `migrationBackup: false`.
surfaces, hard renames (no aliases, no deprecation period), and one flipped
default. This entry **is** the migration guide: the find/replace pairs, the
sed snippet, and the upgrade checklist below are the complete story — there is
no separate migration doc. **`8.0.0` is GA on `latest`** — install with
no separate migration doc. **`8.0.1` is GA on `latest`** — install with
`npm i @soulcraft/brainy@latest`.
> **rc.3rc.5 additions (2026-06-24):**