Skip to content

BatchWeaver v0.1.0-beta.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@Voskan Voskan released this 02 Aug 11:59
· 26 commits to main since this release
v0.1.0-beta.1
ec6ae03
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

BatchWeaver 0.1.0-beta.1 Release Notes

Status: public beta prerelease. This is not a stable-v1 or production-readiness
claim.

Summary

BatchWeaver is a proof-gated Go compiler/runtime toolkit that turns supported
scalar access patterns into reviewed batch execution. This beta packages the
compiler, proof engine, overlay-first transformer, typed runtime, adapter
contracts, daemon/LSP, VS Code extension, and release assurance tooling.

Why BatchWeaver

Manual batching can improve throughput but can also change ordering, errors,
cancellation, authorization boundaries, and transaction identity. BatchWeaver
requires a semantic proof for each supported transformation and rejects cases it
cannot justify conservatively.

Included and supported

  • static loop prefetch and certified runtime-call lowering for documented shapes;
  • explicit typed batch providers and database/sql/net/http integrations;
  • deterministic plans, diffs, overlays, transformed tests, materialize/revert;
  • macOS arm64 native validation and five cross-platform archives;
  • standalone LSP, optional gopls proxy, and a release-asset VSIX.

Installation

go install github.com/Voskan/BatchWeaver/cmd/batchweaver@v0.1.0-beta.1
batchweaver version
batchweaver doctor

Archives must be checked against SHA256SUMS before execution. The VSIX can be
installed locally with
code --install-extension batchweaver-vscode-0.1.0-beta.1.vsix.

Five-minute quickstart

git clone https://github.com/Voskan/BatchWeaver.git
cd BatchWeaver
git checkout v0.1.0-beta.1
go run ./cmd/batchweaver scan ./examples/static-prefetch/...
go run ./cmd/batchweaver prove ./examples/static-prefetch/...
go test -race ./examples/static-prefetch/...

Preview and test before any explicit materialization. Source remains unchanged
by default.

Compatibility and known limitations

Go 1.26.5 is the supported toolchain. Native evidence is strongest on
macOS/arm64; other artifact targets have limited cross-build evidence as recorded
in release/compatibility.json. Concrete pgx, go-redis, gqlgen, and grpc-go
bindings are not included. The VSIX installs and activates in a real Visual
Studio Code 1.131.0 Extension Host on macOS arm64. See KNOWN-ISSUES.md.

Breaking-change policy

This is a beta. Public Go APIs, schemas, runtime ABI, and generated artifacts may
change between prereleases with changelog and migration guidance. Tags and
released assets are immutable.

Upgrade, rollback, and verification

Keep tool/runtime/extension versions aligned, regenerate plans after upgrades,
and invalidate versioned caches. Roll back by disabling transformations, using
the scalar path, reverting materialized changes, clearing versioned caches, and
installing the prior version. Verify artifacts with sha256sum -c SHA256SUMS or
shasum -a 256 -c SHA256SUMS, then run batchweaver release verify when the
manifest and complete asset set are together.

The tag and artifacts are unsigned. SHA256SUMS provides integrity verification,
the supplied provenance statement is local and unsigned, and no hosted SLSA
level is claimed.

Security and feedback

Do not report vulnerabilities or transformation isolation failures in a public
issue; follow SECURITY.md. Reproducible bugs and beta feedback use the GitHub
issue forms. BatchWeaver uploads no source or runtime data and adds no telemetry.

Contributors

This prerelease was produced from the repository history. No external
adoption, contributor, or production-validation claim is made.

Superseded: New installations should use v0.1.0-beta.3. Earlier tags and assets remain unchanged for auditability.

Assets 22
Loading