slovo/.llm/reviews/BETA_10_RELEASE_REVIEW.md

48 lines
1.9 KiB
Markdown

# 1.0.0-beta.10 Release Review
Status: ready for publication after the controller release gate.
## Verdict
No blocking issues found after integrating the stdlib API catalog worker and
the compiler symbol-metadata worker.
## Scope Checked
- `docs/language/STDLIB_API.md` now lists exact exported `lib/std` helper
signatures instead of helper names only.
- `scripts/render-stdlib-api-doc.js` verifies exported helpers have matching
`(fn ...)` forms, omits non-exported helpers and aliases, and normalizes
module-local concrete aliases in public signatures.
- `glagol symbols <file.slo|project|workspace>` emits deterministic
`slovo.symbols` metadata for modules, imports, exports, aliases, structs,
enums, functions, tests, spans/ranges, and workspace package labels.
- README, roadmaps, release notes, specification text, whitepapers, and PDFs
describe beta10 as tooling/API-discovery work only.
- Docs do not claim executable generics, maps, sets, new runtime helpers,
stable ABI/layout, LSP/watch protocols, or a stable stdlib API freeze.
## Verification
- `node scripts/render-stdlib-api-doc.js`
- `cargo fmt --check`
- `cargo check`
- `cargo test --test symbols_beta10`
- `cargo test --test dx_v1_7`
- `cargo test --test cli_v1_1`
- `cargo test --test promotion_gate`
- `MD_TO_PDF_PACKAGE=<local md-to-pdf package path> ./scripts/render-doc-pdfs.sh`
- `git diff --check`
- `./scripts/release-gate.sh`
Final full `./scripts/release-gate.sh` result: passed docs, generated stdlib
API catalog consistency, private-publication text checks, formatter checks, the
full cargo test suite, ignored promotion checks, binary smoke, and LLVM smoke.
## Residual Risk
The `symbols` command is a stable-shaped beta metadata export, not a complete
editor protocol. Future editor work still needs a separate LSP/watch contract,
diagnostic stability policy, local package API docs, and compatibility tests
before claiming full editor integration.