releases

Forma v0.1.31

Cross-Host Graph lifecycle hardening, Linux GNU release compatibility, and a coordinated dependency refresh.

Scope

Publish the coordinated Public Preview patch after releases/forma-v0.1.30. This cutline completes the shared Graph View cross-Host hardening, makes Linux GNU and portable installer compatibility gates explicit, and refreshes the compatible pnpm and Cargo dependency sets without changing the Markdown-and-schema source-of-truth model.

Included Changes

  • Color Graph nodes from configured frontmatter fields and preserve Graph positions across refreshes while releasing Graph canvas backing stores, WebGL contexts, and renderer resources deterministically in WebApp and VS Code.
  • Complete cross-Host Graph parity evidence and keep VS Code workspace output budgets, fixture resolution, and lifecycle checks aligned with the shared renderer.
  • Stabilize Linux GNU release artifacts against the supported glibc baseline and add the corresponding packaging compatibility gate.
  • Make Unix installer checksum verification portable across available checksum tools and keep the deployment contract pinned to the refreshed Wrangler version.
  • Refresh compatible pnpm and Cargo dependencies, regenerate the bundled Lucide link-icon asset, and synchronize the release-version documentation and manifests at 0.1.31.

Validation

Required candidate evidence:

  1. mise run version:check -- v0.1.31, mise run release:record-check -- v0.1.31, and CI=true mise run check pass from the exact candidate.
  2. Forma check and workspace health pass with zero errors and zero warnings.
  3. The coordinated forma-0.1.31.vsix packages and passes isolated integration and smoke gates with a matching forma 0.1.31 binary.
  4. Unix and Windows installer tests, including portable checksum-tool handling and the Linux GNU compatibility gate, pass for the candidate.
  5. Main CI passes for the exact candidate commit before the annotated tag is created.
  6. The protected Release workflow builds the expected cross-platform archives, standalone binaries, VSIX, and sibling SHA-256 assets from the exact source.
  7. After publication, mise run release:verify -- v0.1.31 verifies the published asset inventory, checksums, CLI version, VSIX identity, and managed CLI installation.

Published Evidence

  • Candidate: b616ff041e6a48b994e1ac53a7158167d4928e6f.
  • Exact main CI: run 31942133543 passed Knowledge, Web, Rust, installer, static-site, VS Code, five-target CLI release-build, and source-bound deployment jobs for the exact candidate.
  • Release workflow: run 31942685118 validated the exact candidate, assembled and promoted the source-bound 22-asset release, verified the published payloads, and published or verified the Marketplace VSIX.
  • GitHub Release: Forma v0.1.31 is published as the coordinated Public Preview release.
  • Independent verification: mise run release:verify -- v0.1.31 passed for 22 assets and 11 payloads. The native macOS Arm64 CLI reported forma 0.1.31 with SHA-256 2a0b4fd587d2b8195ab753f857a5187c4229b79967284534fb1421130290e159; the VSIX reported choral-io.forma@0.1.31, engine ^1.110.0, and SHA-256 caf7621c065c8c7f07e4cde1f608907ef06628e5bee2152c73a55b731e1d53c6.
  • Managed installation: the production editor-extension installation implementation downloaded, checksum-verified, installed, and executed the published forma-macos-arm64 payload as forma 0.1.31.

Rollout Plan

  1. Completed the aligned candidate commit and local release gates.
  2. Pushed the candidate, passed exact-source main CI, and created the annotated v0.1.31 tag.
  3. Promoted the source-bound candidate through the protected Release workflow and verified the published GitHub assets.
  4. Published or verified the matching VS Code Marketplace extension and completed independent published-release verification.

Migration Or Operations Notes

  • Existing Forma workspaces and Markdown content require no migration.
  • The release remains a Public Preview and preserves the coordinated CLI, VS Code, and Zed version contract.
  • Remote SSH, Dev Container, WSL, code signing, notarization, Zed Registry publication, and non-native in-place replacement paths remain bounded acceptance areas unless exact release evidence closes them.

Release Notes

Forma v0.1.31 hardens the shared Graph experience across hosts, makes Linux GNU and portable installer compatibility explicit, and refreshes the coordinated dependency toolchain.

Rollback Plan

Do not move or overwrite a published tag or asset. Before publication, return a failed candidate to remediation. After publication, use the official installer as the recovery path and publish a higher coordinated version for any correction.

Post-Release Follow-Up

  • Keep remaining Host-specific and distribution-specific acceptance boundaries explicit in the next release review.
  • Continue tracking any correction through a higher coordinated version; do not move or overwrite the v0.1.31 tag or published assets.