Skip to content

BuildFossil v0.1.0-alpha.2 — Second Public Alpha

Pre-release
Pre-release

Choose a tag to compare

@slambek slambek released this 11 Oct 14:07
· 57 commits to main since this release
f084207

BuildFossil v0.1.0-alpha.2

Second Public Alpha

Capture a failed build. Replay the failure offline.

BuildFossil is an experimental open-source CLI for capturing failed Go builds into portable, verifiable .bfc capsules and reproducing them in isolated Docker environments.

What's changed

Capture Go projects without go.sum

Schema-v3 capture now supports dependency-free Go projects that do not contain a go.sum file.

  • Automatically embeds an empty go.sum inside the capsule when no external Go modules are selected.
  • Does not create or modify go.sum in the original project.
  • Preserves existing dependency integrity checks.
  • Rejects existing go.sum files omitted from the capture includes.

Fixes #23 via PR #24.

More reliable Docker integration testing

Improved snapshot rollback testing to verify cleanup of only the Docker volumes belonging to the tested operation.

This reduces false-positive failures caused by concurrent tests using the same Docker daemon.

Implemented in PR #25.

Supported platforms

  • macOS ARM64 (Apple Silicon)
  • Linux AMD64

Docker is required for replay.

Quick start

Capture a failed build from a Go project without external dependencies:

CGO_ENABLED=0 GOFLAGS='' GOWORK=off GOOS=linux GOARCH=amd64 \
  buildfossil capture --v3 \
  --include go.mod \
  --include main.go \
  -- go build ./...

Replay the captured failure:

buildfossil replay --v3 --allow-command failure.bfc

BuildFossil supports a restricted Go 1.26.6 workflow. Adjust included source files to match your project.

Download verification

Download the archive for your platform alongside SHA256SUMS, then verify its checksum before extracting it.

Validation

This release was validated by GitHub Actions, including Go tests, static analysis, Docker integration testing, and cross-platform binary builds.

Release source commit:

f084207468d2b14b2ce0d4516f00a9f7320b2a0e

Alpha limitations

  • Experimental software; not production-ready.
  • Replay currently targets Linux AMD64.
  • Capture supports a restricted set of Go build configurations and external dependencies.
  • Docker is required for replay.
  • Reproduction is not guaranteed for every build failure.
  • macOS binaries are not Developer ID signed or notarized and may require explicit Gatekeeper approval.
  • Do not replay untrusted capsules without assessing the security implications.

Feedback

Report bugs and share reproducible failure cases:

https://github.com/buildfossil/buildfossil/issues

Thank you for testing BuildFossil.