Repository navigation
BuildFossil v0.1.0-alpha.2 — Second Public Alpha
Pre-releaseBuildFossil 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.suminside the capsule when no external Go modules are selected. - Does not create or modify
go.sumin the original project. - Preserves existing dependency integrity checks.
- Rejects existing
go.sumfiles omitted from the capture includes.
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.bfcBuildFossil 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.