From b3e8b13ef4aa939be1eb6bea52e192bcc32074f5 Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Mon, 16 Nov 2026 13:39:26 +0100 Subject: [PATCH] Document v0.8.0 publication and macOS compiler setup --- .gitignore | 1 + docs/canvas-pilot/changelog.md | 10 +++- docs/canvas-pilot/plan.md | 2 +- docs/development/release-notes/v0.8.0.md | 53 +++++++++++++------- docs/development/releases.md | 61 ++++++++++++++++++------ scripts/release/Containerfile.apple | 3 ++ 6 files changed, 96 insertions(+), 34 deletions(-) create mode 100644 scripts/release/Containerfile.apple diff --git a/.gitignore b/.gitignore index fa8d51e..2a816f2 100644 --- a/.gitignore +++ b/.gitignore @@ -8,3 +8,4 @@ __pycache__/ /gitea-token.txt .env /.rust-release/ +/dist/ diff --git a/docs/canvas-pilot/changelog.md b/docs/canvas-pilot/changelog.md index e41f663..570535c 100644 --- a/docs/canvas-pilot/changelog.md +++ b/docs/canvas-pilot/changelog.md @@ -8,10 +8,16 @@ No changes yet. ## v0.8.0 — 2026-11-16 +- Published Windows, Linux, Apple Silicon and Intel macOS binaries and portable + bundles, with templates, an offline manual, checksums and build provenance. + macOS uses the documented Rust 1.100 compiler-image recipe because the original + pinned image is too old for the locked CAD dependencies. Linux startup was + checked; native Windows/macOS runtime acceptance remains separate. + Standalone Canvas Pilot and advanced exchange milestone. See the [release notes](../development/release-notes/v0.8.0.md) for highlights, -compatibility and remaining release validation. This version is prepared for -release; downloadable binaries are not yet published. +compatibility and remaining release validation. See the [release page](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/tag/v0.8.0) +for published downloads and platform validation. - Import/paste can optionally rename destination layers from supplied editor names, with proposed names shown before applying and a name-only mode. Folders and IDs diff --git a/docs/canvas-pilot/plan.md b/docs/canvas-pilot/plan.md index 3607e9c..dab48c3 100644 --- a/docs/canvas-pilot/plan.md +++ b/docs/canvas-pilot/plan.md @@ -13,7 +13,7 @@ device readback and physical-screen acceptance. ## Release milestone -**v0.8.0 — Standalone and advanced exchange** is prepared as a source milestone. +**v0.8.0 — Standalone and advanced exchange** is published with four-platform binaries. See its [release notes](../development/release-notes/v0.8.0.md) and [build/publication procedure](../development/releases.md). Remaining acceptance checks and stretch goals below remain open; the tag does not mark them complete. diff --git a/docs/development/release-notes/v0.8.0.md b/docs/development/release-notes/v0.8.0.md index e11dadb..fdb3773 100644 --- a/docs/development/release-notes/v0.8.0.md +++ b/docs/development/release-notes/v0.8.0.md @@ -37,23 +37,44 @@ Default builds include vendor codecs. Illustrator files require the external VectorCraft converter. Builds using `no_proprietary` exclude optional vendor codecs; release builds should keep the default features. -## Validation and release status +## Downloads -The feature baseline passed default, all-feature and restricted-build tests, -Clippy with warnings denied, formatting, rustdoc, and manual link/anchor checks. -Whole-application line coverage at the feature milestone is **91.09%**. Name -round trips cover all available codecs except native Illustrator conversion, -which requires VectorCraft. SVG text naming is tested separately. +Choose a **portable bundle** below, extract it, then open Canvas Pilot. The bundles +include icons, a launcher helper and a quick-start guide. -This is a source milestone and release candidate for packaging, not a claim that -platform binaries have been built or smoke-tested. Before public binary release: +| Platform | Portable download | +| --- | --- | +| Windows 64-bit | [Download ZIP](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-portable-x86_64-pc-windows-gnu-v0.8.0.zip) | +| Linux x86-64 | [Download TGZ](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-portable-x86_64-unknown-linux-gnu-v0.8.0.tgz) | +| macOS Apple Silicon | [Download ZIP](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-portable-aarch64-apple-darwin-v0.8.0.zip) | +| macOS Intel | [Download ZIP](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-portable-x86_64-apple-darwin-v0.8.0.zip) | -- Build and package Windows x86-64, Linux x86-64, Apple Silicon and Intel macOS - using the pinned release configuration on a capable build host. -- Check archive contents and application startup on the target platforms. -- Verify the published canonical archives with cargo-binstall. +Also available: canonical cargo-binstall archives, standalone binaries, SHA-256 +checksums and the machine-readable build manifest. Platform packages are unsigned. -Emulator/readback evidence does not replace physical-output acceptance. Remaining -precision questions and acceptance work stay in the [project plan](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/tag/v0.8.0/docs/canvas-pilot/plan.md). -See [release preparation](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/tag/v0.8.0/docs/development/releases.md) for the exact build command, and the -[changelog](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/tag/v0.8.0/docs/canvas-pilot/changelog.md#v080--2026-11-16) for the detailed changes. +- [Offline manual](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-offline-manual-v0.8.0.zip): extract and open `index.html`. +- [Starter templates](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-starter-templates-v0.8.0.zip): editable Full HD and UHD examples. +- [Online manual](https://books.dandaedre.com/manuals/canvas-pilot/). + +## Validation + +Rust tests, formatting, Clippy, rustdoc and book checks passed for the feature +baseline; whole-application line coverage was **91.09%**. The release-version +package tests and 26 Python checks also passed. Name round trips cover available +codecs except native Illustrator conversion, which requires VectorCraft. + +The built Linux binary passed an isolated GUI startup/render check with an empty +startup log. Archive integrity, checksums and architecture checks are recorded by the release +tooling. Cross compilation does not establish native Windows/macOS GUI behavior; +no macOS runtime runner is available here. Emulator/readback evidence likewise +does not replace physical-output acceptance. Remaining acceptance work stays in +the [project plan](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/tag/v0.8.0/docs/canvas-pilot/plan.md). + +## Build reproducibility + +The tagged source and lockfile were unchanged. The original macOS image had Rust +1.93, below the locked CAD dependencies' requirement. macOS therefore uses the same +SDK image with Rust 1.100.0 installed; Linux and Windows also used Rust 1.100.0. +The [build instructions](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/BUILDING-v0.8.0.md), compiler recipe and effective release configuration +are attached, with checksums. The artifact manifest distinguishes packaging checks +from native runtime checks. macOS requires 13.0 or newer; binaries are not notarized. diff --git a/docs/development/releases.md b/docs/development/releases.md index e3b1f28..3bb6fca 100644 --- a/docs/development/releases.md +++ b/docs/development/releases.md @@ -1,25 +1,56 @@ # Release preparation -## Current milestone: v0.8.0 +## Published milestone: v0.8.0 -[Release notes](release-notes/v0.8.0.md) record the standalone Canvas Pilot and -advanced exchange milestone. The workspace and lockfile use version 0.8.0. -The annotated local `v0.8.0` tag identifies the committed release preparation. -Tags and commits are not pushed automatically, and no binaries are published by -this preparation task. +[Download v0.8.0](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/tag/v0.8.0). +The annotated tag identifies source commit `eb82dc7cc91105793d2d31552da71763d2218df5`; +subsequent publication documentation does not move that tag. The release has 21 +assets: four portable bundles, four canonical cargo-binstall archives, four raw +binaries, the artifact manifest/checksums, and seven manual/template/build extras. +The [release notes](release-notes/v0.8.0.md) describe compatibility and downloads. -On a capable build host with this tagged commit checked out: +All four builds passed. Linux GUI startup/render passed with isolated settings. +Both macOS binaries passed Mach-O architecture, minimum macOS 13.0, system-library, +archive-layout and checksum checks. Native Windows/macOS runtime testing was not +available. All 21 assets were downloaded and hash-checked before publication and +again anonymously after publication. cargo-binstall retrieved all four targets +from the public release; each installed binary matched the built artifact SHA-256. + +### Required macOS compiler override + +The original pinned SDK image contains Rust 1.93, but the locked CAD dependencies +require Rust 1.95 or newer. The first real release build exposed this mismatch; +the earlier dry run could not detect it. v0.8.0 keeps its application source and +lockfile unchanged and uses Rust 1.100.0 for all targets. + +The [compiler recipe](../../scripts/release/Containerfile.apple) extends the original +immutable image with Rust 1.100.0 and both Apple target libraries. Its built digest, +Cross image digests and validation boundaries are in the release's +`build-provenance.json`. The macOS configuration used is attached as +`rust-release-v0.8.0.toml`; the image is locally built, not a public registry upload. + +For a fresh build host, download `Containerfile.apple`, `BUILDING-v0.8.0.md` and +`rust-release-v0.8.0.toml` from the release. Build the recipe, then set the supplied +configuration's `build.apple.image` to your local image's immutable digest, as +explained in the build instructions. A rebuilt image's digest can differ because +of build timestamps. From a clean tagged checkout: ```sh -rust_realease . --package canvas-pilot --tag v0.8.0 --dry-run -rust_realease . --package canvas-pilot --tag v0.8.0 --compile-only +rust_realease . --package canvas-pilot --tag v0.8.0 --dry-run --config /path/to/rust-release-v0.8.0.toml +rust_realease . --package canvas-pilot --tag v0.8.0 --compile-only --artifact-format both --config /path/to/rust-release-v0.8.0.toml ``` -The second command performs the expensive four-target builds and packaging; it -creates no remote release. Keep default features enabled for vendor formats. -After target-platform smoke tests, a separately authorized publishing run can -use `--message-file docs/development/release-notes/v0.8.0.md` and the configured -credential mechanism. Do not use `--replace-assets` for a first publication. +Keep default features enabled for vendor formats. The second command builds and +packages all targets without publishing. For this publication, the successful +Linux/Windows binaries were retained after the first macOS failure; macOS was +rerun with the compatible compiler. Retained binaries were packaged to the same +configured layouts with entry/hash/permission/architecture verification. The +combined artifact manifest records this rather than claiming one uninterrupted run. + +Release assets were uploaded as a draft using the authorized token, verified, then +published through Gitea. Credentials and generated archives remain outside Git. +Do not replace existing public assets or move the release tag for future fixes; +prepare a new version instead. ## Packaging configuration @@ -52,7 +83,7 @@ artifacts. Run it later on a capable build host: rust_realease . --package canvas-pilot --compile-only ``` -### Readiness audit — 2026-11-16 +### Historical readiness audit — 2026-11-16 (before the milestone) Checked with `rust_realease 0.1.6-rc.3`, without compiling or publishing: diff --git a/scripts/release/Containerfile.apple b/scripts/release/Containerfile.apple new file mode 100644 index 0000000..87d1c62 --- /dev/null +++ b/scripts/release/Containerfile.apple @@ -0,0 +1,3 @@ +FROM ghcr.io/rust-cross/cargo-zigbuild@sha256:9b4f6b3eb9e8f9fefb3960fe288ddba576627d66d9eff851ce7f62d2455564a5 +RUN rustup toolchain install 1.100.0 --profile minimal --target aarch64-apple-darwin,x86_64-apple-darwin +ENV RUSTUP_TOOLCHAIN=1.100.0