chore(release): prepare v0.5.0

[chaliy]

Minor release 0.4.1 → 0.5.0. Two new builtins (shuf, truncate), a coreutils-codegen pipeline that ports uutils' uu_app() clap definitions for cat/tac/truncate/shuf/readlink, and tool_def flag-syntax improvements.

Highlights

• Coreutils argument surface via codegen — Ports uutils' uu_app() clap definitions into bashkit so builtins share the real coreutils argument shape; cat, tac, truncate, shuf, and readlink now flow through this surface, with a coreutils differential testing harness to catch parity drift. Pipeline reads a single pinned uutils revision so generated builtins, the differential harness, and CI all agree on the upstream source of truth (feat(builtins): port uutils argument surfaces via codegen (POC: cat, tac) #1529, test(builtins): add coreutils differential testing harness #1535, feat(builtins): add truncate via codegen-ported argument surface #1536, chore(builtins): pin uutils revision as single source of truth #1537, feat(builtins): add shuf via codegen with helper-fn inlining #1538, refactor(builtins): migrate readlink to codegen-ported argument surface #1542).
• Site updates — Bashkit agent skill is now published on the site, alongside rustdoc guides and content signal declarations for discoverability.

What's Changed

• refactor(builtins): migrate readlink to codegen-ported argument surface (refactor(builtins): migrate readlink to codegen-ported argument surface #1542)
• chore(site): publish bashkit agent skill (chore(site): publish bashkit agent skill #1541)
• chore(site): declare content signals
• docs(site): publish rustdoc guides
• feat(builtins): add shuf via codegen with helper-fn inlining (feat(builtins): add shuf via codegen with helper-fn inlining #1538)
• chore(builtins): pin uutils revision as single source of truth (chore(builtins): pin uutils revision as single source of truth #1537)
• feat(builtins): add truncate via codegen-ported argument surface (feat(builtins): add truncate via codegen-ported argument surface #1536)
• test(builtins): add coreutils differential testing harness (test(builtins): add coreutils differential testing harness #1535)
• feat(builtins): port uutils argument surfaces via codegen (POC: cat, tac) (feat(builtins): port uutils argument surfaces via codegen (POC: cat, tac) #1529)
• feat(tool_def): accept --flag key=value... syntax for object/array flags (feat(tool_def): accept --flag key=value... syntax for object/array flags #1528)
• fix(tool_def): coerce stringified JSON for array/object flag schemas (fix(tool_def): coerce stringified JSON for array/object flag schemas #1527)

Publish-readiness report

Per the updated specs/release-process.md:

• cargo fmt --check clean
• cargo clippy --all-targets --all-features -- -D warnings clean
• cargo build clean
• Versions synced across Cargo.toml, crates/bashkit-cli/Cargo.toml, crates/bashkit-js/package.json, package-lock.json, Cargo.lock
• cargo publish --dry-run -p bashkit --allow-dirty (after CI's monty-strip): success
• cargo publish --dry-run -p bashkit-cli: blocked only on ordering (bashkit 0.5.0 not yet on crates.io) — resolves at real publish time when publish-bashkit runs first per publish.yml's needs: chain.
• New 0.5.0 > latest published versions on crates.io / PyPI / npm (0.4.1).

Companion change

This branch also includes chore(specs): document publish verification and post-merge monitoring, codifying the verify-before-tag and watch-after-merge flow that this release follows.

On merge, release.yml will create the GitHub Release v0.5.0 and dispatch publish workflows for crates.io, PyPI, npm, and Homebrew.

Full Changelog: v0.4.1...v0.5.0

---

Generated by Claude Code

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	bashkit	d04afbf	Commit Preview URL Branch Preview URL	May 06 2026, 12:28 AM