Starstruk Logo MarkStarstruk

v0.6.7

JackismyShephard/ultimate-rvcv0.6.7Jul 25, 2026by github-actions[bot]

AI Summary

This release focuses on significant stability improvements for filesystem operations and snapshot exports, alongside breaking changes to the sandbox specification and SDK path handling. It also includes CLI enhancements, networking fixes, and extensive documentation updates.

Key Highlights

  • Optimized snapshot export performance by implementing a custom sparse archive codec to handle file holes efficiently.
  • Improved filesystem stability by fixing host file descriptor exhaustion issues on virtiofs shares.
  • Enhanced networking reliability with fixes for IPv6 DNS edge cases.
  • Added top-level CLI aliases for update, upgrade, and downgrade commands.
  • Improved Windows path handling in the SDK by typing guest paths as strings.

Breaking Changes

  • Type guest paths as strings and fix Windows path handling in the SDK.
  • Replace oci-upper-size with a structured root-disk spec.

New Features

  • Add top-level update, upgrade, and downgrade aliases to the CLI.
  • Make sandbox spec types more explicit.
  • Add default-on mount-root symlink protection with opt-out.
  • Own the sparse archive codec end to end for snapshots.
  • Survive host fd exhaustion on virtiofs shares.

Full Release Notes

## What's Changed
* sync mintlify to v0.5.4 by @github-actions[bot] in https://github.com/superradcompany/microsandbox/pull/868
* fix: correct broken SSH overview link in changelog by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/870
* docs: normalize collector self-observability blurb to second person by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/871
* fix: correct broken SSH overview link in changelog by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/872
* sync mintlify to v0.5.5 by @github-actions[bot] in https://github.com/superradcompany/microsandbox/pull/925
* docs: fix typos and orphaned parameters table by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/929
* docs: add changelog for week of June 5, 2026 by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/928
* docs(changelog): tighten week of june 5 entry by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/932
* docs: align June 5 changelog feature headings with prior style by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/933
* docs(mintlify): realign branch with main by @appcypher in https://github.com/superradcompany/microsandbox/pull/956
* docs(mintlify): record main ancestry by @appcypher in https://github.com/superradcompany/microsandbox/pull/957
* docs(mintlify): sync docs to v0.5.6 by @appcypher in https://github.com/superradcompany/microsandbox/pull/958
* docs: tighten voice and terminology from style audit by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/959
* docs: fix capitalization and broken SSH anchor links by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/961
* docs: align SDK secrets headings with sentence case style by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/960
* docs(mintlify): sync Docker recipe from main by @appcypher in https://github.com/superradcompany/microsandbox/pull/964
* docs: add changelog for week of June 12, 2026 by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/975
* docs: add changelog for week of June 19, 2026 by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1001
* sync mintlify to v0.5.9 by @github-actions[bot] in https://github.com/superradcompany/microsandbox/pull/1018
* Fix broken links by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1025
* Apply brand tone and writing style fixes by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1026
* Fix typos and grammar by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1027
* sync mintlify to v0.5.10 by @github-actions[bot] in https://github.com/superradcompany/microsandbox/pull/1033
* Fix typos and grammar by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1039
* Apply brand tone and writing style fixes by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1038
* sync mintlify to v0.6.0 by @github-actions[bot] in https://github.com/superradcompany/microsandbox/pull/1046
* Apply brand tone and writing style fixes by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1052
* Fix typos and grammar by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1053
* docs(sdk): improve rendering and styles  by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/1060
* Apply brand tone and writing style fixes by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1064
* Fix typos and grammar by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1065
* Changelog: week of June 26, 2026 by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1051
* sync mintlify to v0.6.1 by @github-actions[bot] in https://github.com/superradcompany/microsandbox/pull/1062
* Apply brand tone and writing style fixes by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1067
* fix(network): handle IPv6 DNS edge cases by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/1072
* Fix typos and grammar by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1077
* sync mintlify to v0.6.3 by @github-actions[bot] in https://github.com/superradcompany/microsandbox/pull/1097
* Apply brand tone and writing style fixes by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1100
* Fix typos and grammar by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1101
* docs(mintlify): sync latest main and fix stale SDK refs by @appcypher in https://github.com/superradcompany/microsandbox/pull/1105
* Apply brand tone and writing style fixes by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1109
* Fix typos and grammar by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1110
* docs: restore platform troubleshooting guides by @appcypher in https://github.com/superradcompany/microsandbox/pull/1111
* docs: soften code action backgrounds by @appcypher in https://github.com/superradcompany/microsandbox/pull/1112
* docs(sdk): document modify() in all four SDK references by @appcypher in https://github.com/superradcompany/microsandbox/pull/1103
* Apply brand tone and writing style fixes by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1113
* sync mintlify to v0.6.4 by @github-actions[bot] in https://github.com/superradcompany/microsandbox/pull/1116
* Apply brand tone and writing style fixes by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1123
* Changelog: week of July 5, 2026 by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1120
* docs: streamline sandbox guides and SDK references by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/1124
* Fix typos and grammar by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1129
* chore: refresh npm lockfile after v0.6.6 by @github-actions[bot] in https://github.com/superradcompany/microsandbox/pull/1146
* sync mintlify to v0.6.6 by @github-actions[bot] in https://github.com/superradcompany/microsandbox/pull/1145
* feat(types): more explicit sandbox spec types by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/1144
* feat(cli): add top-level update, upgrade, and downgrade aliases by @appcypher in https://github.com/superradcompany/microsandbox/pull/1147
* docs(types): simplify cloud wire type doc comments by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/1158
* docs: sync DEVELOPMENT.md and AGENTS.md with current repo layout by @ya-luotao in https://github.com/superradcompany/microsandbox/pull/1155
* fix(sdk)!: type guest paths as strings and fix Windows path handling by @appcypher in https://github.com/superradcompany/microsandbox/pull/1148
* chore(lint): fix clippy 1.97 lints in cli and python sdk by @appcypher in https://github.com/superradcompany/microsandbox/pull/1160
* feat(filesystem): default-on mount-root symlink protection with opt-out by @appcypher in https://github.com/superradcompany/microsandbox/pull/1149
* fix(filesystem): survive host fd exhaustion on virtiofs shares by @appcypher in https://github.com/superradcompany/microsandbox/pull/1157
* perf(snapshot): store files with holes as GNU sparse tar entries on export by @nuri-yoo in https://github.com/superradcompany/microsandbox/pull/1150
* feat(sandbox)!: replace oci-upper-size with structured root-disk spec by @appcypher in https://github.com/superradcompany/microsandbox/pull/1165
* ci: shrink integration-test debuginfo and harden runner disk cleanup by @appcypher in https://github.com/superradcompany/microsandbox/pull/1164
* feat(snapshot): own the sparse archive codec end to end by @appcypher in https://github.com/superradcompany/microsandbox/pull/1166
* fix(snapshot): purposeful errors when snapshotting tmpfs or disk-image root disks by @appcypher in https://github.com/superradcompany/microsandbox/pull/1169
* feat(sdk): expose Image.load and Image.save for local image archives by @ya-luotao in https://github.com/superradcompany/microsandbox/pull/1151
* fix(sdk/go): forward guest-write quota to bind mounts by @zhuanyongxigua in https://github.com/superradcompany/microsandbox/pull/1161
* feat(sdk): extend image load/save to Node and Go SDKs by @appcypher in https://github.com/superradcompany/microsandbox/pull/1174
* Changelog: week of July 10, 2026 by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1172
* feat(snapshot): finalize descriptor and api contract by @appcypher in https://github.com/superradcompany/microsandbox/pull/1118
* fix(network): allow duplicate secret placeholders by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/1178
* fix(sdk/node): add default export condition for CommonJS consumers by @appcypher in https://github.com/superradcompany/microsandbox/pull/1179
* build(libkrunfw): update vendor to 5.6.0 by @appcypher in https://github.com/superradcompany/microsandbox/pull/1182
* Changelog: week of July 17, 2026 by @mintlify[bot] in https://github.com/superradcompany/microsandbox/pull/1185
* deps: bump hickory to 0.26.1, migrating hickory-client to hickory-net by @nuri-yoo in https://github.com/superradcompany/microsandbox/pull/1186
* fix(python): restore Python 3.10 compatibility for typed enums by @ya-luotao in https://github.com/superradcompany/microsandbox/pull/1152
* chore(docs): sync latest mintlify changes into main by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/1189
* ci(python): add a 3.10 lower-bound test job for the python sdk by @appcypher in https://github.com/superradcompany/microsandbox/pull/1188
* feat(go-sdk): support tty exec sessions by @kingfs in https://github.com/superradcompany/microsandbox/pull/1173
* feat(sdk): expose exec tty resize by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/1190
* feat: add Windows support to the Go SDK (FFI loader + release build) by @lyb2320 in https://github.com/superradcompany/microsandbox/pull/1187
* fix(sdk): complete go windows setup by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/1193
* feat(types): sandbox status_reason + rename failure-message field by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/1197
* fix(installer): discover packaged libkrunfw version by @appcypher in https://github.com/superradcompany/microsandbox/pull/1196
* feat(network)!: add composable network profiles by @appcypher in https://github.com/superradcompany/microsandbox/pull/1198
* fix(cli): run image defaults in detached mode by @appcypher in https://github.com/superradcompany/microsandbox/pull/1203
* feat(snapshot): add bidirectional v0.6.6 format migration by @appcypher in https://github.com/superradcompany/microsandbox/pull/1200
* build(deps-dev): bump the npm_and_yarn group across 2 directories with 1 update by @dependabot[bot] in https://github.com/superradcompany/microsandbox/pull/1204
* build(deps): bump quinn-proto from 0.11.14 to 0.11.16 in the cargo group across 1 directory by @dependabot[bot] in https://github.com/superradcompany/microsandbox/pull/1206
* chore(release): bump microsandbox to 0.6.7 by @appcypher in https://github.com/superradcompany/microsandbox/pull/1199

## New Contributors
* @ya-luotao made their first contribution in https://github.com/superradcompany/microsandbox/pull/1155
* @kingfs made their first contribution in https://github.com/superradcompany/microsandbox/pull/1173
* @lyb2320 made their first contribution in https://github.com/superradcompany/microsandbox/pull/1187

**Full Changelog**: https://github.com/superradcompany/microsandbox/compare/v0.6.6...v0.6.7