Authoritative project documentation

ApiaryLens Preview 1 (build 0.1.0-preview.5)

Release date: 2026-07-18

Superseded by build 0.1.0-preview.6, which ships as ApiaryLens Preview 1 under the same public name. This build's air-gap bundle cannot be installed on hosts whose Docker Engine uses the containerd image store — the default on current Docker Engine (#91): the post-load identity gate recorded only the classic-graphdriver form of the image ID and therefore refuses the bundle's own images at install. Independently, this build's published artifacts claim source commit 1f348e0 while their bytes were built from 8c43e5f in a dirty local tree, so the release identity chain cannot be audited (#92). Use the 0.1.0-preview.6 artifacts instead. The historical notes below are retained as published.

Preview 1 is the first public preview of the rebooted ApiaryLens product: the platform core plus the web client/PWA as the primary product surface. The public preview counter restarted with this reboot (owner decision, 2026-07-18); earlier public previews — including the July 2026 Windows-era "Preview 1" and the "Preview 2" build 0.1.0-preview.4, whose GitHub release is now titled "Superseded internal build — do not use" — do not count in the new sequence. The wire/semver build ordinal is unaffected and only ever increases, so this Preview 1 ships as build 0.1.0-preview.5 and supersedes build 0.1.0-preview.4. Tags, manifests, updater ordering, and artifact names carry the build number; announcements lead with the public name Preview 1.

Why this build supersedes 0.1.0-preview.4

Air-gap bundle defect fixed (#82). The air-gap bundle shipped with build 0.1.0-preview.4 recorded Docker image IDs that docker load does not reproduce, so its fail-closed lifecycle scripts refused install/update on every real host. The bundle build now records load-reproducible image IDs, and the release workflow proves — before anything is published — that the IDs recorded in the packed bundle are reproducible from the bundle's own archive bytes. Use this build's air-gap bundle; do not use the 0.1.0-preview.4 air-gap bundle.
Owner-feedback web features. The Overview Members card is offline-aware, and the consented external-provider weather capture works alongside manual weather entry (FB-006, FB-011).
Corrected operator documentation carried since 0.1.0-preview.4 shipped, including the Compose secrets procedure and the versioned docker/.env.example identity (#83, #85).

No Windows build in this release

This build ships platform and web artifacts only: the Cloudflare deployment bundle, the Compose deployment bundle, the air-gapped Compose bundle, and their evidence (SBOM, license report, provenance, compatibility manifest, checksums, attestations).

The Windows desktop client is deferred pending a full rewrite (owner decision, 2026-07-18) and was not rebuilt for this release. No Windows Setup is attached to the v0.1.0-preview.5 release. The most recent Windows preview build remains the one attached to the v0.1.0-preview.4 release; it carries the known deferred defect #84 (first launch of the packaged app can skip the mode chooser, and the Sync button is visible in the standalone context) and receives no further preview fixes before the rewrite. The primary supported product surface is the web client/PWA against a Cloudflare or Compose backend.

Unsigned preview

The artifacts in this release are not code signed. They ship under the unsigned-preview conditions of the accepted platform design: SHA-256 checksums are published beside the downloads in SHA256SUMS, and every published subject carries a GitHub (Sigstore) keyless attestation. Release-candidate and stable channels remain fail-closed on real signatures.

Verify before use:

Download the artifact and SHA256SUMS from the v0.1.0-preview.5 GitHub release.
Verify the checksum (sha256sum --check SHA256SUMS on Linux, or Get-FileHash on Windows) against the entry in SHA256SUMS.
Verify the keyless attestation: gh attestation verify <artifact> --repo ApiaryLens/apiarylens
If the hash or attestation does not verify, delete the file and do not use it.

Compatibility

Product: 0.1.0-preview.5
API contract: 1.0
Sync contract: 1
Database migration head: 0004
Deployment-plan contract: 1
Minimum direct upgrade source: 0.1.0-preview.1

Scout Bee is independently versioned; the compatibility manifest published with this release records the exact artifact identities.

Known limitations

No Windows artifact ships in this build; the previously released Windows preview build carries deferred defect #84 and is not maintained pending the rewrite.
winget and Chocolatey submissions are explicitly excluded until the first signed stable release (GV4); draft manifests exist in-repo only.
The extended manual assistive-technology matrix (NVDA, VoiceOver, retail Windows High Contrast, native zoom) remains scheduled beyond the preview.
Native iPhone and Android applications, AI, video, sensors, passkeys, and OIDC federation are post-MVP.