Cottontail 0.5.0 ships without cottontail-core, breaking mainProcess cottontail builds

Author: ronimuliawanCreated Sep 18, 2026Updated Sep 18, 2026

Summary

Building an app with build.mainProcess: "cottontail" fails at the packaging step because the Cottontail 0.5.0 release in the Hutch store has no cottontail-core binary.

Environment

  • Hutch 0.26.0 (Linux x64)
  • Electrobun devkit 2.0.1 (project pins electrobun.version per its ADR)
  • Cottontail 0.5.0 (e5660061b8e64b5ea044799da8518780a9987391, paired by the 2.0.1 devkit)

Repro

  1. Any Electrobun 2.0.1 project with build: { mainProcess: "cottontail", cottontail: { entrypoint: "src/bun/index.ts" } }.
  2. hutch run build (vite step succeeds).

Result

hutch electrobun: Cottontail capabilities discovered by scan: [ffi]
hutch electrobun: required source is missing: /home/<user>/.hutch/releases/cottontail/0.5.0/e5660061b8e64b5ea044799da8518780a9987391/linux-x64/bin/cottontail-core
error: CopySourceMissing

Notes

  • bin/ in the 0.5.0 release contains only cottontail (plus stdlib/js vendor files). Deleting the release and re-running hutch electrobun prepare re-downloads 0.5.0 identically — still no cottontail-core. Not a stale cache.
  • Cottontail 0.6.0 (5e1085c5dc41157a7faf49355629b5dfddcd72e0) in the same store IS complete (cottontail, cottontail-core, cottontail-stdlib), but no stable Electrobun release pairs it (only 2.0.2-betas beyond 2.0.1).
  • Impact: blocks adopting the Cottontail main process on the stable channel entirely. Happy to provide any further diagnostics.