Publish versioned docs runtimes

[hellovai]

Outcome

Every nightly, canary, and stable BAML release now produces an immutable browser runtime beside its generated standard-library metadata.

The exact stamped release:

• builds bridge_wasm once in the Web SDK build job;
• packages v<version>/runtime.json plus content-addressed JavaScript and WASM;
• integrity-binds version, source revision, runtime commit, toolchain, sizes, and hashes;
• runs every registered example through both the exact native CLI and exact packaged WASM;
• uploads immutable files before promoting docs/versions.json;
• records the runtime path and payload checksum next to stdlib.json in the version index;
• produces the same runtime tree in release dry runs.

Historical index entries without a runtime remain readable for migration, but every newly promoted entry is statically required by the release contract to include one.

End-user impact

This closes the producer half of version-correct runnable docs. A follow-up stack layer will make the TypeScript-only Fumadocs build consume the selected runtime and remove the transitional checked-in snapshot.

Verification

• 40 docs tests pass.
• All 14 release workflow graph tests pass.
• Workflow YAML validation passes.
• Docs typecheck passes against two immutable toolchain versions.
• The real 18 MB 0.18.0 runtime packaged successfully and matched the native CLI output for the registered runnable example.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
beps	Ready	Preview	Sep 1, 2026 7:44am UTC
developer-docs	Ready	Preview	Sep 1, 2026 7:44am UTC
promptfiddle2	Ready	Preview	Sep 1, 2026 7:44am UTC

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

⏭️ Performance benchmarks were skipped

Perf benchmarks (CodSpeed) are opt-in on pull requests — they no longer run on every push. They always run automatically after merge to canary/main.

To run them on this PR, do any of the following, then push a commit (or re-run CI):

• Add RUN_CODSPEED=1 to the PR description, or
• Include run-perf or /perf in the PR title or any commit message.

[github-actions]

Binary size checks passed

✅ 7 passed

	Artifact	Platform	File	Gzip	Gated on	Baseline	Delta	Status
✅	baml-cli	Linux	🔒 72.9 MB	27.5 MB	file	72.9 MB	+12.1 KB (+0.0%)	OK
✅	packed-program	Linux	🔒 28.6 MB	10.9 MB	file	28.6 MB	-20.0 KB (-0.1%)	OK
✅	baml-cli	macOS	🔒 63.4 MB	25.2 MB	file	63.3 MB	+33.2 KB (+0.1%)	OK
✅	packed-program	macOS	🔒 25.8 MB	10.2 MB	file	25.8 MB	-43.8 KB (-0.2%)	OK
✅	baml-cli	Windows	🔒 83.1 MB	27.9 MB	file	83.0 MB	+91.9 KB (+0.1%)	OK
✅	packed-program	Windows	🔒 30.9 MB	10.8 MB	file	30.9 MB	-73.3 KB (-0.2%)	OK
✅	bridge_wasm	WASM	22.2 MB	🔒 5.7 MB	gzip	5.7 MB	+32.2 KB (+0.6%)	OK

🔒 = the size this artifact is GATED on (ceiling + delta). Binaries gate on file size (installed binary); WASM gates on gzip (download size). The other size is shown for information only.

---

Generated by cargo size-gate · workflow run

[hellovai]

Closing at the author's request; the docs work will restart from scratch.