slovo/.llm/reviews/BETA_10_RELEASE_REVIEW.md

1.9 KiB

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.