Keepsake v0.1-alpha

v0.1-alpha

Status: active
Owner: Infinite Loop Audio
Updated: 2026-04-17
Roadmap refs:

• docs/roadmaps/g02/002-release-packaging-versioning-install-surface.md
• docs/roadmaps/g02/003-alpha-validation-matrix-and-evidence.md
• docs/roadmaps/g02/004-publish-v0.1-alpha.md
  Evidence refs:
• docs/releases/v0.1-alpha-validation-matrix.md
• docs/logs/2026-04/12-141500-g02-003-alpha-primary-validation.md
• docs/logs/2026-04/12-165054-g02-004-alpha-candidate-artifact-smoke.md
  Latest CI refs:
• release artifacts workflow exists: .github/workflows/release-binaries.yml
• latest push CI: 24551205423
• latest green release-artifact run: 24552158082
• published release URL:
  • https://github.com/infinite-loop-audio/keepsake/releases/tag/v0.1-alpha

Release Intent

v0.1-alpha is the first public alpha release surface for Keepsake, with a
deliberately conservative support claim.

Primary validated lane today:

• macOS
• REAPER
• VST2

Experimental / lightly proven:

• Windows
• Linux
• VST3
• AU v2
• 32-bit paths

Experimental means implementation exists and CI may be green, but the release
should not present these lanes as equally proven until the validation matrix
backs them.

Tag and Version

• release tag: v0.1-alpha
• build version: 0.1.0
• changelog entry: CHANGELOG.md

Release Highlights

• CLAP wrapper that exposes discovered legacy plugins as distinct CLAP entries
• out-of-process bridge with crash containment and configurable isolation
• hardened bridge lifecycle around bad stdout IPC, stuck init, and oversized
  shared-memory allocation failures
• working real-host REAPER smoke lane on macOS
• cross-platform CI covering macOS, Linux, and Windows builds

Artifact Surface

This is the current intended artifact list. Final publication should not broaden
it beyond the validated support envelope.

macOS

• keepsake-macos-arm64-v0.1-alpha.zip
  • contains keepsake.clap
  • bundle contains helper binaries under Contents/Helpers/
  • current local dry-run includes:
    • Contents/MacOS/keepsake
    • Contents/Helpers/keepsake-bridge
    • Contents/Helpers/keepsake-bridge-x86_64
  • local dry-run candidate path:
    • dist/v0.1-alpha/keepsake-macos-arm64-v0.1-alpha.zip
  • publishable artifact source:
    • GitHub Actions Release Binaries workflow

Windows

• keepsake-windows-x64-v0.1-alpha.zip
  • contains keepsake.clap
  • contains keepsake-bridge.exe adjacent to keepsake.clap
  • current posture:
    • experimental artifact available from CI
    • do not present as equally proven to macOS + REAPER + VST2

Linux

• keepsake-linux-x64-v0.1-alpha.tar.gz
  • contains keepsake.clap
  • contains keepsake-bridge adjacent to keepsake.clap
  • current posture:
    • experimental artifact available from CI
    • do not present as equally proven to macOS + REAPER + VST2

Release Attachments

• checksum manifest
• source archive from GitHub tag
• latest green artifact set:
  • keepsake-macos-arm64-v0.1-alpha.zip
  • keepsake-linux-x64-v0.1-alpha.tar.gz
  • keepsake-windows-x64-v0.1-alpha.zip
• local dry-run checksum manifest path:
  • dist/v0.1-alpha/SHA256SUMS.txt
• latest green CI checksums:
  • 3fc2deb5ce5bc2b4ba57df06a53d230324fdcdb444da0a2cd031bbbbf7c540f2 keepsake-macos-arm64-v0.1-alpha.zip
  • 0447b3f94abbfa67f72b6ce449bfa7abaf50dafd202ae55b0a5337c65943e942 keepsake-linux-x64-v0.1-alpha.tar.gz
  • fafcdd8ef6f608072ca778b2dc654d66db8844466f203d56a704a6e0129c0a05 keepsake-windows-x64-v0.1-alpha.zip

Install Surface

macOS

1. Unpack the release archive.
2. Copy keepsake.clap into:
   • ~/Library/Audio/Plug-Ins/CLAP/
   • or /Library/Audio/Plug-Ins/CLAP/
3. Rescan CLAP plugins in the host.

Notes:

• Helper binaries are expected inside the bundle.
• If the alpha ships unsigned or non-notarized, release notes must include the
  exact Gatekeeper workaround. Current alpha posture should assume this note is
  required until signing/notarization is settled.
• Replace flow from a local build or earlier alpha drop:
  • remove or overwrite the old keepsake.clap
  • copy the new bundle in its place
  • rescan CLAP plugins in the host

Windows

1. Unpack the release archive.
2. Copy the packaged keepsake.clap and adjacent keepsake-bridge.exe into a
   standard CLAP plugin location.
3. Rescan plugins in the host.

Notes:

• Current CLAP plugin locations:
  • %COMMONPROGRAMFILES%\\CLAP\\
  • %LOCALAPPDATA%\\Programs\\Common\\CLAP\\
• Keep the helper binary adjacent to the packaged keepsake.clap.
• Treat the Windows artifact as experimental for v0.1-alpha.
• Current publication posture: ship only as an explicitly experimental
  attachment, not as part of the supported claim.

Linux

1. Unpack the release archive.
2. Copy the packaged keepsake.clap and adjacent keepsake-bridge into a
   standard CLAP plugin location.
3. Rescan plugins in the host.

Notes:

• Current CLAP plugin locations:
  • ~/.clap/
  • /usr/lib/clap/
• Keep the helper binary adjacent to the packaged keepsake.clap.
• Treat the Linux artifact as experimental for v0.1-alpha.
• Current publication posture: ship only as an explicitly experimental
  attachment, not as part of the supported claim.

Known Issues Summary

Link directly to:

• ../known-issues-v0.1-alpha.md

Short public summary:

• strongest support is macOS + REAPER + VST2
• host cache behavior can affect rescans
• macOS live editor is the supported UI posture; preview is diagnostic-only
• broader platform/format support is still experimental
• CI green on Windows/Linux does not yet equal full release support proof

Release Notes Body

Keepsake v0.1-alpha is the first public alpha for the CLAP-based legacy
plugin bridge. It exposes discovered legacy plugins as named CLAP entries and
runs them out of process for crash isolation.

This alpha is intentionally conservative in what it claims. The strongest
current validation lane is macOS + REAPER + VST2. Windows, Linux, VST3, AU v2,
and 32-bit paths remain experimental until the release validation matrix proves
them strongly enough to widen support claims.

Highlights:

• out-of-process bridge with shared/per-binary/per-instance isolation
• hardened scan and bridge lifecycle
• real-host REAPER smoke tooling
• stable macOS live-editor posture for Serum, APC, and Khords
• green CI on macOS, Linux, and Windows

Packaging Checklist

• changelog aligned
• version aligned
• artifact names finalized
• helper-binary layout verified
• checksum manifest prepared
• install instructions verified on the primary alpha platform
• candidate packaging command works:
  • effigy release:candidate:alpha
• candidate output path confirmed:
  • dist/v0.1-alpha/
• release artifact workflow exists:
  • .github/workflows/release-binaries.yml
• CI-built artifacts are the release source of truth
• latest green release-artifact run:
  • 24552158082
• packaged-install smoke recorded:
  • docs/logs/2026-04/12-165054-g02-004-alpha-candidate-artifact-smoke.md
  • docs/logs/2026-04/17-074232-g02-003-alpha-evidence-refresh.md
  • docs/logs/2026-04/17-080000-v0.1-alpha-release-checkpoint.md
• publish checklist run:
  • v0.1-alpha-publish-checklist.md

Next Task

Use the published release as the authority now, then route follow-up work into
post-alpha stabilization instead of reopening the release surface.