Merge branch 'develop' into fix/m7-ci-uitest-runner-sign

.gitea/workflows/macos.yml

@@ -14,83 +14,29 @@ jobs:
   build-and-test:
     # Prefer a self-hosted Mac runner if your Gitea has one. If not,
     # macos-14 works for this pipeline.
-    runs-on: macos-12
+    runs-on: macos-14
     env:
       DERIVED: build/DerivedData-test
-      # Tag name on tag pushes, branch name otherwise — scripts/version.sh
-      # only honours values matching 'v[0-9]*'.
-      RELEASE_TAG: ${{ github.ref_name }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-        with:
-          # Full history + tags: scripts/version.sh needs `git describe` and
-          # `git rev-list --count`; the default depth-1 clone has neither.
-          fetch-depth: 0
-
-      - name: Assert Xcode 14+ toolchain
-        run: |
-          line="$(xcodebuild -version | head -1)"
-          major="$(printf '%s' "$line" | sed -n 's/^Xcode \([0-9][0-9]*\)\..*/\1/p')"
-          if [ -z "$major" ] || [ "$major" -lt 14 ]; then
-            echo "Unexpected Xcode version: $line" >&2; exit 1
-          fi
-          echo "$line"
-
-      # Tag pushes whose name contains "prerelease" skip the test build and both
-      # test legs: they exist to package a build already validated elsewhere.
-      # The job still succeeds quickly so `package`'s `needs:` stays satisfied.
-      # Homebrew's xcodegen formula requires Xcode 15.3, which cannot be
-      # installed on macOS 12 (#109). The script installs a pinned
-      # prebuilt release instead. dmgbuild is not installed here — the
-      # test job does not package (#95).
-      - name: Ensure host tools
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        run: scripts/ensure-host-tools.sh
 
       - name: Generate Xcode project
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
         run: xcodegen generate --spec project.yml
 
-      # Tests only ever run on the runner's own architecture; build
-      # just that slice. Packaging (scripts/package-release.sh) still
-      # produces the universal Release binary.
-      - name: Build for testing (host arch)
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
+      - name: Build for testing (universal)
         run: |
-          # Stamp the test build with the same version triple packaging uses
-          # so CI-built apps are traceable (and mis-tags fail early) (#189).
-          eval "$(scripts/version.sh)"
-          echo "version=$MARKETING_VERSION build=$CURRENT_PROJECT_VERSION tag=$ICCERY_RELEASE_TAG"
           xcodebuild build-for-testing \
             -scheme ICCery \
             -destination 'platform=macOS' \
             -derivedDataPath "$DERIVED" \
             -configuration Debug \
-            ARCHS="$(uname -m)" \
+            ARCHS='arm64 x86_64' \
             ONLY_ACTIVE_ARCH=NO \
             CODE_SIGNING_ALLOWED=YES \
-            CODE_SIGN_IDENTITY='-' \
-            MARKETING_VERSION="$MARKETING_VERSION" \
-            CURRENT_PROJECT_VERSION="$CURRENT_PROJECT_VERSION" \
-            ICCERY_RELEASE_TAG="$ICCERY_RELEASE_TAG"
+            CODE_SIGN_IDENTITY='-'
 
-      # Xcode embeds the shared ICCeryCore package framework into the app
-      # and the test bundle without signing it. Ad-hoc hosts still require
-      # every loaded dylib to carry a cdhash — dyld killed the test host at
-      # launch (run 31992) — so sign every embedded copy once the build is
-      # done (embed steps run after any build script phase) (#119).
-      - name: Sign package product frameworks
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        run: |
-          find "$DERIVED/Build/Products/Debug" -depth -name '*_PackageProduct.framework' -print0 \
-            | while IFS= read -r -d '' fw; do
-                echo "signing $fw"
-                codesign --force --sign - --timestamp=none "$fw"
-              done
-
-      - name: Test unit (ICCeryCoreTests)
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
+      - name: Test (universal)
         run: |
           XCTESTRUN="$(find "$DERIVED" -name 'ICCery*.xctestrun' | head -n 1)"
           if [ -z "$XCTESTRUN" ] || [ ! -f "$XCTESTRUN" ]; then
@@ -100,127 +46,20 @@ jobs:
           echo "xctestrun: $XCTESTRUN"
           xcodebuild test-without-building \
             -xctestrun "$XCTESTRUN" \
-            -only-testing:ICCeryCoreTests \
             -destination 'platform=macOS' \
             -derivedDataPath "$DERIVED"
 
-      # UI tests need macOS Automation / Accessibility permission on the
-      # runner. The self-hosted Mac intermittently times out enabling
-      # that mode (run 29700) or launches the app into
-      # `.runningBackground` without ever activating it (run 29804).
-      # Kill any leftover unit-test host first; retry once; if the
-      # runner still cannot attach, do not fail the required gate so
-      # tag packaging can proceed. Real XCTest assertion failures
-      # still fail the job.
-      - name: Test UI (ICCeryUITests)
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        run: |
-          set -o pipefail
-          XCTESTRUN="$(find "$DERIVED" -name 'ICCery*.xctestrun' | head -n 1)"
-          LOG="$DERIVED/ui-test.log"
-          pkill -x ICCery 2>/dev/null || true
-          sleep 1
-
-          run_ui() {
-            local label="$1"
-            shift
-            echo "::group::UI tests $label"
-            set +e
-            xcodebuild test-without-building \
-              -xctestrun "$XCTESTRUN" \
-              -destination 'platform=macOS' \
-              -derivedDataPath "$DERIVED" \
-              "$@" | tee "$LOG"
-            rc=${PIPESTATUS[0]}
-            set -e
-            echo "::endgroup::"
-            return "$rc"
-          }
-
-          is_runner_attach_failure() {
-            grep -Eq "Timed out while enabling automation mode|Failed to activate application|current state: Running Background" "$LOG"
-          }
-
-          attempt=1
-          while [ "$attempt" -le 2 ]; do
-            # Probe one case first. A background-activate failure costs
-            # ~65s here instead of ~25 minutes for the whole suite (29804).
-            if ! run_ui "probe attempt $attempt" \
-                -only-testing:ICCeryUITests/AboutHelpUITests/testAboutDialogShowsVersionAndBuildDate; then
-              if is_runner_attach_failure; then
-                echo "warning: UI runner could not attach/activate the app (attempt $attempt)"
-                pkill -x ICCery 2>/dev/null || true
-                attempt=$((attempt + 1))
-                sleep 8
-                continue
-              fi
-              echo "error: UI probe failed with a real test error" >&2
-              exit 1
-            fi
-            if run_ui "full suite attempt $attempt" -only-testing:ICCeryUITests \
-                -skip-testing:ICCeryUITests/AboutHelpUITests/testAboutDialogShowsVersionAndBuildDate; then
-              exit 0
-            fi
-            if is_runner_attach_failure; then
-              echo "warning: UI runner lost activation mid-suite (attempt $attempt)"
-              pkill -x ICCery 2>/dev/null || true
-              attempt=$((attempt + 1))
-              sleep 8
-              continue
-            fi
-            echo "error: UI tests failed with a real test error" >&2
-            exit 1
-          done
-          echo "warning: skipping UI tests after repeated runner attach/activate failures"
-          exit 0
-
-      # XCTest stores the a11y hierarchy snapshot and screenshots in the
-      # xcresult on failure — upload it so UI failures can be triaged
-      # without access to the runner (#126).
-      - name: Prepare Node CA bundle (failure path)
-        if: "failure() && !(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        run: |
-          NODE_CA_FILE="/tmp/macos-ca-bundle.pem"
-          security find-certificate -a -p \
-            /System/Library/Keychains/SystemRootCertificates.keychain \
-            /Library/Keychains/System.keychain \
-            > "$NODE_CA_FILE" 2>/dev/null || true
-          if [ ! -s "$NODE_CA_FILE" ] && [ -f /etc/ssl/cert.pem ]; then
-            cp /etc/ssl/cert.pem "$NODE_CA_FILE"
-          fi
-
-      - name: Upload UI test xcresult
-        if: "failure() && !(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        uses: actions/upload-artifact@v3
-        env:
-          NODE_EXTRA_CA_CERTS: /tmp/macos-ca-bundle.pem
-        with:
-          name: ui-test-xcresult
-          path: build/DerivedData-test/Logs/Test
-
   package:
     needs: build-and-test
-    runs-on: macos-12
+    runs-on: macos-14
     if: github.ref == 'refs/heads/develop' || startsWith(github.ref, 'refs/tags/v')
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-        with:
-          # Full history + tags: scripts/version.sh needs `git describe` and
-          # `git rev-list --count`; the default depth-1 clone has neither.
-          fetch-depth: 0
-
-      # scripts/package-release.sh runs `xcodegen generate` and dmgbuild;
-      # see build-and-test for why brew is not used on macOS 12 (#109).
-      # INSTALL_DMGBUILD isolates dmgbuild in build/.venv-dmgbuild so
-      # the test job never pip-installs it (#95).
-      - name: Ensure host tools
-        run: INSTALL_DMGBUILD=1 scripts/ensure-host-tools.sh
 
       - name: Package release
         run: scripts/package-release.sh
         env:
-          RELEASE_TAG: ${{ github.ref_name }}
           GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
           CODESIGN_IDENTITY: ${{ secrets.CODESIGN_IDENTITY }}
           DEVELOPMENT_TEAM: ${{ secrets.DEVELOPMENT_TEAM }}
@@ -228,32 +67,8 @@ jobs:
           NOTARIZE_PASSWORD: ${{ secrets.NOTARIZE_PASSWORD }}
           APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
 
-      - name: Prepare Node CA bundle
-        run: |
-          NODE_CA_FILE="/tmp/macos-ca-bundle.pem"
-          security find-certificate -a -p \
-            /System/Library/Keychains/SystemRootCertificates.keychain \
-            /Library/Keychains/System.keychain \
-            > "$NODE_CA_FILE" 2>/dev/null || true
-          if [ ! -s "$NODE_CA_FILE" ] && [ -f /etc/ssl/cert.pem ]; then
-            cp /etc/ssl/cert.pem "$NODE_CA_FILE"
-          fi
-
       - name: Upload DMG artifact
         uses: actions/upload-artifact@v3
-        env:
-          NODE_EXTRA_CA_CERTS: /tmp/macos-ca-bundle.pem
         with:
           name: iccery-dmg
           path: ICCery-*.dmg
-
-      - name: Attach DMG to Gitea release
-        if: startsWith(github.ref, 'refs/tags/v')
-        run: scripts/attach-release-asset.sh
-        env:
-          GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
-          GITHUB_TOKEN: ${{ github.token }}
-          GITEA_SERVER_URL: ${{ github.server_url }}
-          GITHUB_REPOSITORY: ${{ github.repository }}
-          GITHUB_REF_NAME: ${{ github.ref_name }}
-          GITHUB_SHA: ${{ github.sha }}

.github/workflows/macos.yml

@@ -1,250 +0,0 @@
-# GitHub Actions twin of .gitea/workflows/macos.yml.
-# Deltas from the Gitea file (everything else is the same jobs/steps):
-#   - runs-on macos-14: github.com retired macos-12. Do not use
-#     macos-latest — in 2026 that is macos-26-arm64, where a 1280×800
-#     window hangs off the virtual display and XCTest marks sidebar
-#     controls (x ≈ -116) as not hittable (run 34864198118).
-#   - actions/upload-artifact@v4: v3 is shut down on github.com. Gitea act_runner
-#     still uses v3.
-#   - No NODE_EXTRA_CA_CERTS / System keychain bundle: that is only for the
-#     private Gitea CA when the runner talks to git.i3omb.com.
-#   - Tag DMGs go to a GitHub Release via `gh` instead of
-#     scripts/attach-release-asset.sh (Gitea /api/v1).
-name: macOS CI
-
-on:
-  push:
-    branches:
-      - develop
-    tags:
-      - 'v*'
-  pull_request:
-    branches:
-      - develop
-
-permissions:
-  contents: read
-
-jobs:
-  build-and-test:
-    runs-on: macos-14
-    env:
-      DERIVED: build/DerivedData-test
-      # Tag name on tag pushes, branch name otherwise — scripts/version.sh
-      # only honours values matching 'v[0-9]*'.
-      RELEASE_TAG: ${{ github.ref_name }}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          # Full history + tags: scripts/version.sh needs `git describe` and
-          # `git rev-list --count`; the default depth-1 clone has neither.
-          fetch-depth: 0
-
-      - name: Assert Xcode 14+ toolchain
-        run: |
-          line="$(xcodebuild -version | head -1)"
-          major="$(printf '%s' "$line" | sed -n 's/^Xcode \([0-9][0-9]*\)\..*/\1/p')"
-          if [ -z "$major" ] || [ "$major" -lt 14 ]; then
-            echo "Unexpected Xcode version: $line" >&2; exit 1
-          fi
-          echo "$line"
-
-      # Tag pushes whose name contains "prerelease" skip the test build and both
-      # test legs: they exist to package a build already validated elsewhere.
-      # The job still succeeds quickly so `package`'s `needs:` stays satisfied.
-      # Homebrew's xcodegen formula requires Xcode 15.3, which cannot be
-      # installed on macOS 12 (#109). The script installs a pinned
-      # prebuilt release instead. dmgbuild is not installed here — the
-      # test job does not package (#95).
-      - name: Ensure host tools
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        run: scripts/ensure-host-tools.sh
-
-      - name: Generate Xcode project
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        run: xcodegen generate --spec project.yml
-
-      # Tests only ever run on the runner's own architecture; build
-      # just that slice. Packaging (scripts/package-release.sh) still
-      # produces the universal Release binary.
-      - name: Build for testing (host arch)
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        run: |
-          # Stamp the test build with the same version triple packaging uses
-          # so CI-built apps are traceable (and mis-tags fail early) (#189).
-          eval "$(scripts/version.sh)"
-          echo "version=$MARKETING_VERSION build=$CURRENT_PROJECT_VERSION tag=$ICCERY_RELEASE_TAG"
-          xcodebuild build-for-testing \
-            -scheme ICCery \
-            -destination 'platform=macOS' \
-            -derivedDataPath "$DERIVED" \
-            -configuration Debug \
-            ARCHS="$(uname -m)" \
-            ONLY_ACTIVE_ARCH=NO \
-            CODE_SIGNING_ALLOWED=YES \
-            CODE_SIGN_IDENTITY='-' \
-            MARKETING_VERSION="$MARKETING_VERSION" \
-            CURRENT_PROJECT_VERSION="$CURRENT_PROJECT_VERSION" \
-            ICCERY_RELEASE_TAG="$ICCERY_RELEASE_TAG"
-
-      # Xcode embeds the shared ICCeryCore package framework into the app
-      # and the test bundle without signing it. Ad-hoc hosts still require
-      # every loaded dylib to carry a cdhash — dyld killed the test host at
-      # launch (run 31992) — so sign every embedded copy once the build is
-      # done (embed steps run after any build script phase) (#119).
-      - name: Sign package product frameworks
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        run: |
-          find "$DERIVED/Build/Products/Debug" -depth -name '*_PackageProduct.framework' -print0 \
-            | while IFS= read -r -d '' fw; do
-                echo "signing $fw"
-                codesign --force --sign - --timestamp=none "$fw"
-              done
-
-      - name: Test unit (ICCeryCoreTests)
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        run: |
-          XCTESTRUN="$(find "$DERIVED" -name 'ICCery*.xctestrun' | head -n 1)"
-          if [ -z "$XCTESTRUN" ] || [ ! -f "$XCTESTRUN" ]; then
-            echo "error: no xctestrun produced by build-for-testing" >&2
-            exit 1
-          fi
-          echo "xctestrun: $XCTESTRUN"
-          xcodebuild test-without-building \
-            -xctestrun "$XCTESTRUN" \
-            -only-testing:ICCeryCoreTests \
-            -destination 'platform=macOS' \
-            -derivedDataPath "$DERIVED"
-
-      # UI tests need macOS Automation / Accessibility permission on the
-      # runner. GitHub-hosted macos-14 images enable this; a self-hosted
-      # Mac can still time out enabling that mode (run 29700) or launch
-      # the app into `.runningBackground` (run 29804). Kill any leftover
-      # unit-test host first; retry once; if the runner still cannot
-      # attach, do not fail the required gate so tag packaging can
-      # proceed. Real XCTest assertion failures still fail the job.
-      - name: Test UI (ICCeryUITests)
-        if: "!(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        run: |
-          set -o pipefail
-          XCTESTRUN="$(find "$DERIVED" -name 'ICCery*.xctestrun' | head -n 1)"
-          LOG="$DERIVED/ui-test.log"
-          pkill -x ICCery 2>/dev/null || true
-          sleep 1
-
-          run_ui() {
-            local label="$1"
-            shift
-            echo "::group::UI tests $label"
-            set +e
-            xcodebuild test-without-building \
-              -xctestrun "$XCTESTRUN" \
-              -destination 'platform=macOS' \
-              -derivedDataPath "$DERIVED" \
-              "$@" | tee "$LOG"
-            rc=${PIPESTATUS[0]}
-            set -e
-            echo "::endgroup::"
-            return "$rc"
-          }
-
-          is_runner_attach_failure() {
-            grep -Eq "Timed out while enabling automation mode|Failed to activate application|current state: Running Background" "$LOG"
-          }
-
-          attempt=1
-          while [ "$attempt" -le 2 ]; do
-            # Probe one case first. A background-activate failure costs
-            # ~65s here instead of ~25 minutes for the whole suite (29804).
-            if ! run_ui "probe attempt $attempt" \
-                -only-testing:ICCeryUITests/AboutHelpUITests/testAboutDialogShowsVersionAndBuildDate; then
-              if is_runner_attach_failure; then
-                echo "warning: UI runner could not attach/activate the app (attempt $attempt)"
-                pkill -x ICCery 2>/dev/null || true
-                attempt=$((attempt + 1))
-                sleep 8
-                continue
-              fi
-              echo "error: UI probe failed with a real test error" >&2
-              exit 1
-            fi
-            if run_ui "full suite attempt $attempt" -only-testing:ICCeryUITests \
-                -skip-testing:ICCeryUITests/AboutHelpUITests/testAboutDialogShowsVersionAndBuildDate; then
-              exit 0
-            fi
-            if is_runner_attach_failure; then
-              echo "warning: UI runner lost activation mid-suite (attempt $attempt)"
-              pkill -x ICCery 2>/dev/null || true
-              attempt=$((attempt + 1))
-              sleep 8
-              continue
-            fi
-            echo "error: UI tests failed with a real test error" >&2
-            exit 1
-          done
-          echo "warning: skipping UI tests after repeated runner attach/activate failures"
-          exit 0
-
-      # XCTest stores the a11y hierarchy snapshot and screenshots in the
-      # xcresult on failure — upload it so UI failures can be triaged
-      # without access to the runner (#126).
-      - name: Upload UI test xcresult
-        if: "failure() && !(startsWith(github.ref, 'refs/tags/') && contains(github.ref_name, 'prerelease'))"
-        uses: actions/upload-artifact@v4
-        with:
-          name: ui-test-xcresult
-          path: build/DerivedData-test/Logs/Test
-
-  package:
-    needs: build-and-test
-    runs-on: macos-14
-    if: github.ref == 'refs/heads/develop' || startsWith(github.ref, 'refs/tags/v')
-    permissions:
-      contents: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          # Full history + tags: scripts/version.sh needs `git describe` and
-          # `git rev-list --count`; the default depth-1 clone has neither.
-          fetch-depth: 0
-
-      # scripts/package-release.sh runs `xcodegen generate` and dmgbuild;
-      # see build-and-test for why brew is not used on macOS 12 (#109).
-      # INSTALL_DMGBUILD isolates dmgbuild in build/.venv-dmgbuild so
-      # the test job never pip-installs it (#95).
-      - name: Ensure host tools
-        run: INSTALL_DMGBUILD=1 scripts/ensure-host-tools.sh
-
-      - name: Package release
-        run: scripts/package-release.sh
-        env:
-          RELEASE_TAG: ${{ github.ref_name }}
-          CODESIGN_IDENTITY: ${{ secrets.CODESIGN_IDENTITY }}
-          DEVELOPMENT_TEAM: ${{ secrets.DEVELOPMENT_TEAM }}
-          NOTARIZE_APPLE_ID: ${{ secrets.NOTARIZE_APPLE_ID }}
-          NOTARIZE_PASSWORD: ${{ secrets.NOTARIZE_PASSWORD }}
-          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
-
-      - name: Upload DMG artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: iccery-dmg
-          path: ICCery-*.dmg
-
-      - name: Attach DMG to GitHub release
-        if: startsWith(github.ref, 'refs/tags/v')
-        env:
-          GH_TOKEN: ${{ github.token }}
-        run: |
-          set -eu
-          TAG="$GITHUB_REF_NAME"
-          case "$TAG" in
-            *prerelease*) PRE_FLAG=--prerelease ;;
-            *)            PRE_FLAG= ;;
-          esac
-          if ! gh release view "$TAG" >/dev/null 2>&1; then
-            gh release create "$TAG" --title "$TAG" --target "$GITHUB_SHA" $PRE_FLAG
-          fi
-          gh release upload "$TAG" ICCery-*.dmg --clobber

.gitignore

@@ -18,9 +18,6 @@ Vendor/Argyll/
 # XcodeGen output (regenerate with `make gen`)
 ICCery.xcodeproj/
 
-# Local-only developer helpers (never committed)
-/set-version.sh
-
 # macOS
 .DS_Store
 
@@ -30,5 +27,3 @@ ICCery.xcodeproj/
 Release/
 notarization/
 build/
-docs/megaplans/*
-docs/megaplans

AGENTS.md

@@ -39,36 +39,17 @@ Empty cwd illegal (#59). Atomic writes = `.tmp` + rename (#213).
 User-supplied strings via SwiftUI `Text` only (#114).
 TIFF never rendered directly — host-side PNG preview (#58).
 
-## Versioning
-`scripts/version.sh` is the single source: tag/describe → `ICCERY_RELEASE_TAG`
-(About shows `tag (marketing)`), `MARKETING_VERSION` = strict `X.Y.Z`,
-`CURRENT_PROJECT_VERSION` = `git rev-list --count HEAD` (#189).
-`v*` tag builds hard-fail if tag's X.Y.Z ≠ `project.yml` MARKETING_VERSION —
-bump `project.yml` on `develop` before tagging. CI needs `fetch-depth: 0`.
-
 ## Branching
 `develop` ← `milestone/mN-<name>` ← `feat/<issue#>-<slug>`.
 PRs via Gitea MCP. Every issue/PR: `Project/ICCery-v2` + `Feature/*` or `Bug/*` + `Priority/*`.
 
 ## Verify
 ```
-xcodebuild test -scheme ICCery -destination 'platform=macOS' ARCHS="$(uname -m)"
+xcodebuild test -scheme ICCery -destination 'platform=macOS' ARCHS='arm64 x86_64' ONLY_ACTIVE_ARCH=NO
 codesign -dvv <sidecar>
 ```
-Universal (`ARCHS='arm64 x86_64' ONLY_ACTIVE_ARCH=NO`) is still required for release verification / packaging.
 
 ## Private ColorSync SPI
 2-arg `(PMPrintSession, CFStringRef) -> OSStatus`. Never pass integer `1`.
 Modes: `AP_ApplicationColorMatching` then `ApplicationColorMatching`.
 `lp` path and Quartz/`ICCeryPrintKit` path use **different** ColorSync dictionaries. Never mix.
-
-## Gitea issue dependencies
-Use the `gitea` MCP (custom build with blocking support — verified working):
-
-- `issue_write` methods:
-  - `add_dependency` — `blocking_issue` blocks `issue_number`.
-  - `remove_dependency` — removes `blocking_issue` from `issue_number`'s blockers.
-  - `block_issue` / `unblock_issue` — `issue_number` blocks/unblocks `blocked_issue`.
-- `issue_read` methods: `list_dependencies` (issues blocking N),
-  `list_blocks` (issues N blocks).
-- All issue numbers are *display numbers*, not db ids.

BUILD-PLAN.md

@@ -1,6 +1,6 @@
 # BUILD-PLAN.md — ICCery v2 Mac
 
-Spec snapshot: `docs/`. Source of tickets: Gitea milestones M1–M6 + M10 (id 32) + M11 (id 34) + Later.
+Spec snapshot: `docs/`. Source of tickets: Gitea milestones M1–M6 + Later.
 
 ## Sprint rule
 Do not start milestone N+1 implementation until milestone N **CI/mock gate** is green.
@@ -16,16 +16,9 @@ Hardware gates block *release of that sprint*, not filing, and not starting codi
 | M4 | Measurement | 18–22 | `chartread.mock`; 39+ classifier fixtures; ΔE₀₀; snapshot/average | Detect real instrument; one strip or XY through Done → `.ti3` |
 | M5 | Profile / verify / install | 23–27 | colprof → `.icc`; profcheck parse; atomic history; install into temp dir | Full `.ti1`→`.icc`; profile visible in ColorSync Utility |
 | M6 | Gamut, Stage 0, CGATS, release | 28–32 | `.gam` fixtures; cal argv; CGATS round-trip; signed sidecars; dmgbuild | Stage 0 on a real printer; gamut of a real profile |
-| M7 | Deduplicate & consolidate | 79–86 | Shared runner loop; JSONFileStore; preset↔config maps; Notice/log helper; ProcessManager factory; PrintSession VM; identity + colour-type cleanup | N/A |
-| M8 | Deduplicate & consolidate | 79–86 | (already shipped on `develop`) | N/A |
-| M9 | macOS 12 / Xcode 14.2 retarget | (milestone/m9-monterey, PR #145) | XCTest + ObservableObject + macos-12 CI | N/A |
-| M10 | Studio workflow | 146–149 | Media library + spot-read + gamut compare + project file unit/UI smoke | Real printer+paper+.cal; live spot-read; two `.gam`; reopen `.icceryproj` |
-| M11 | Printer settings completeness & dialog binding | 183, 180, 181, 186 | Quality/media/paper caps parse + `LpArgs` emit + picker UI smoke + panel capture-return | Real Epson: 7 `EPIJ_Qual` options; real Canon Pro9500: English media labels; dialog bound to non-default queue with paper/quality/media/orientation preselected; captured settings reach `lp` argv |
 | Later | Quartz / TargetPrint | 16 | `ICCeryPrintKit` standalone + seam test | 1:1 on paper vs TIFF |
 
-M8–M10 are merged to `develop`; M11 assembles on `milestone/m11-print-settings` from `736fd08`.
-
-Issue **16 is not an M3, M6, M10, or M11 exit gate.**
+Issue **16 is not an M3 or M6 exit gate.**
 
 ## Branch taxonomy
 

Packages/ICCeryCore/Package.swift

@@ -1,9 +1,9 @@
-// swift-tools-version: 5.7
+// swift-tools-version: 6.0
 import PackageDescription
 
 let package = Package(
     name: "ICCeryCore",
-    platforms: [.macOS(.v12)],
+    platforms: [.macOS(.v14)],
     products: [
         .library(name: "ICCeryCore", targets: ["ICCeryCore"]),
     ],

Packages/ICCeryCore/Sources/ICCeryCore/Argyll/ArgsBuilder.swift

@@ -1,35 +0,0 @@
-import Foundation
-
-/// Tiny argv helpers. Each Argyll tool keeps its own `*Args` enum —
-/// `-d` / `-u` / `-r` still mean different things per binary.
-public enum ArgsBuilder {
-    /// `["-f", value]` when `value` is non-nil.
-    public static func option(_ flag: String, _ value: String?) -> [String] {
-        guard let value else { return [] }
-        return [flag, value]
-    }
-
-    /// `["-f", trimmed]` when trimmed is non-empty.
-    public static func optionIfNonEmpty(_ flag: String, _ value: String?) -> [String] {
-        guard let raw = value?.trimmingCharacters(in: .whitespacesAndNewlines),
-              !raw.isEmpty else { return [] }
-        return [flag, raw]
-    }
-
-    /// Omits the flag when `value` is nil or within `epsilon` of `skip`.
-    public static func optionUnlessApprox(
-        _ flag: String,
-        _ value: Double?,
-        skip: Double,
-        epsilon: Double = 0.001,
-        format: String = "%.2f"
-    ) -> [String] {
-        guard let value, abs(value - skip) >= epsilon else { return [] }
-        return [flag, String(format: format, locale: Locale(identifier: "en_US_POSIX"), value)]
-    }
-
-    /// Bare flag when `when` is true.
-    public static func flag(_ flag: String, when: Bool) -> [String] {
-        when ? [flag] : []
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Argyll/ArgyllRunner.swift

@@ -2,41 +2,43 @@ import Foundation
 
 /// Errors from `ArgyllRunner` executions.
 public enum ArgyllRunnerError: LocalizedError, Equatable, Sendable {
-    case toolFailed(tool: String, code: Int32, logs: [String])
+    case processFailed(code: Int32, logs: [String])
     case missingArtefact(String)
     case malformedManifest(String)
     case instrumentDetectionFailed(String)
+    case chartreadFailed(String)
+    case averageFailed(String)
+    case colprofFailed(String)
+    case printcalFailed(String)
+    case applycalFailed(String)
+    case iccgamutFailed(String)
+    case profcheckFailed(String)
     case profcheckUnparseable
 
     public var errorDescription: String? {
         switch self {
-        case .toolFailed(let tool, let code, let logs):
-            let detail = logs.last.flatMap { $0.isEmpty ? nil : $0 }
-                ?? "exited with code \(code)"
-            switch tool {
-            case "chartread":
-                return "Chartread failed: \(detail)"
-            case "average":
-                return "Averaging failed: \(detail)"
-            case "colprof":
-                return "Profile creation failed: \(detail)"
-            case "printcal":
-                return "Calibration curve computation failed: \(detail)"
-            case "applycal":
-                return "Apply calibration failed: \(detail)"
-            case "iccgamut":
-                return "Gamut extraction failed: \(detail)"
-            case "profcheck":
-                return "Profile verification failed: \(detail)"
-            default:
-                return "Process exited with code \(code)"
-            }
+        case .processFailed(let code, _):
+            return "Process exited with code \(code)"
         case .missingArtefact(let path):
             return "Expected output file was not created: \(path)"
         case .malformedManifest(let reason):
             return "Failed to parse printtarg manifest: \(reason)"
         case .instrumentDetectionFailed(let reason):
             return "Instrument detection failed: \(reason)"
+        case .chartreadFailed(let reason):
+            return "Chartread failed: \(reason)"
+        case .averageFailed(let reason):
+            return "Averaging failed: \(reason)"
+        case .colprofFailed(let reason):
+            return "Profile creation failed: \(reason)"
+        case .printcalFailed(let reason):
+            return "Calibration curve computation failed: \(reason)"
+        case .applycalFailed(let reason):
+            return "Apply calibration failed: \(reason)"
+        case .iccgamutFailed(let reason):
+            return "Gamut extraction failed: \(reason)"
+        case .profcheckFailed(let reason):
+            return "Profile verification failed: \(reason)"
         case .profcheckUnparseable:
             return "Profile verification produced unparseable output"
         }
@@ -74,48 +76,6 @@ public struct ArgyllRunner: Sendable {
         self.binaryResolver = binaryResolver
     }
 
-    // MARK: - Shared streaming loop (issue #79)
-
-    private func runStreamingTool(
-        name: String,
-        id: String,
-        arguments: [String],
-        workingDirectory: URL?,
-        flushPartialLines: Bool = false,
-        onLogBatch: (@Sendable ([String]) -> Void)? = nil
-    ) async throws -> CollectedRun {
-        let binaryURL = binaryResolver.resolve(name)
-        await ensureNotRunning(id: id)
-        let events = processManager.events()
-        try await processManager.runStreaming(
-            id: id,
-            binary: binaryURL,
-            arguments: arguments,
-            workingDirectory: workingDirectory
-        )
-        let run = await collect(
-            id: id,
-            events: events,
-            onLogBatch: onLogBatch,
-            flushPartialLines: flushPartialLines
-        )
-        guard run.exitCode == 0 else {
-            throw ArgyllRunnerError.toolFailed(
-                tool: name,
-                code: run.exitCode ?? -1,
-                logs: run.lines
-            )
-        }
-        return run
-    }
-
-    private func requireArtefact(_ url: URL) throws -> URL {
-        guard FileManager.default.fileExists(atPath: url.path) else {
-            throw ArgyllRunnerError.missingArtefact(url.path)
-        }
-        return url
-    }
-
     // MARK: - targen (Stage 1)
 
     /// Runs `targen` streaming, collecting logs and verifying `.ti1`
@@ -127,16 +87,27 @@ public struct ArgyllRunner: Sendable {
         let cleanBasename = try PathSecurity.sanitizeBasename(config.basename)
         let cwd = PathSecurity.resolveSafeCwd(config.workingDirectory)
         let args = try TargenArgs.build(config: config)
+        let binaryURL = binaryResolver.resolve("targen")
         let processId = ProcessID.targen(cleanBasename)
-        _ = try await runStreamingTool(
-            name: "targen",
+
+        await ensureNotRunning(id: processId)
+        let events = processManager.events()
+        try await processManager.runStreaming(
             id: processId,
+            binary: binaryURL,
             arguments: args,
-            workingDirectory: cwd,
-            onLogBatch: onLogBatch
+            workingDirectory: cwd
         )
+        let run = await collect(id: processId, events: events, onLogBatch: onLogBatch)
+
+        guard run.exitCode == 0 else {
+            throw ArgyllRunnerError.processFailed(code: run.exitCode ?? -1, logs: run.lines)
+        }
         let ti1URL = cwd.appendingPathComponent("\(cleanBasename).ti1")
-        return try requireArtefact(ti1URL)
+        guard FileManager.default.fileExists(atPath: ti1URL.path) else {
+            throw ArgyllRunnerError.missingArtefact(ti1URL.path)
+        }
+        return ti1URL
     }
 
     // MARK: - printtarg (Stage 2)
@@ -151,15 +122,26 @@ public struct ArgyllRunner: Sendable {
         let cleanBasename = try PathSecurity.sanitizeBasename(config.basename)
         let cwd = PathSecurity.resolveSafeCwd(config.workingDirectory)
         let args = try PrinttargArgs.build(config: config)
+        let binaryURL = binaryResolver.resolve("printtarg")
         let processId = ProcessID.printtarg(cleanBasename)
-        let run = try await runStreamingTool(
-            name: "printtarg",
+
+        await ensureNotRunning(id: processId)
+        let events = processManager.events()
+        try await processManager.runStreaming(
             id: processId,
+            binary: binaryURL,
             arguments: args,
-            workingDirectory: cwd,
-            onLogBatch: onLogBatch
+            workingDirectory: cwd
         )
-        let ti2URL = try requireArtefact(cwd.appendingPathComponent("\(cleanBasename).ti2"))
+        let run = await collect(id: processId, events: events, onLogBatch: onLogBatch)
+
+        guard run.exitCode == 0 else {
+            throw ArgyllRunnerError.processFailed(code: run.exitCode ?? -1, logs: run.lines)
+        }
+        let ti2URL = cwd.appendingPathComponent("\(cleanBasename).ti2")
+        guard FileManager.default.fileExists(atPath: ti2URL.path) else {
+            throw ArgyllRunnerError.missingArtefact(ti2URL.path)
+        }
 
         let manifest: PrinttargManifest
         do {
@@ -192,18 +174,6 @@ public struct ArgyllRunner: Sendable {
 
     // MARK: - Shared collection
 
-    /// DEBUG-only fast path: under `ICCERY_UI_TESTING=1` polling/wait
-    /// intervals shrink ~10x — same env convention as `AppPaths.testRoot`.
-    /// Release builds compile the branch out entirely; no static state.
-    private static func testAwareDelay(_ nanos: UInt64) -> UInt64 {
-        #if DEBUG
-        if ProcessInfo.processInfo.environment["ICCERY_UI_TESTING"] == "1" {
-            return nanos / 10
-        }
-        #endif
-        return nanos
-    }
-
     /// Cancels any previous child with the same id and waits for it to
     /// finalize, so `runStreaming` / `runCaptured` never sees a
     /// `duplicateID` from a leftover process (#50, #52).
@@ -212,7 +182,7 @@ public struct ArgyllRunner: Sendable {
         await processManager.kill(id: id)
         var attempts = 0
         while await processManager.isRunning(id), attempts < 30 {
-            try? await Task.sleep(nanoseconds: Self.testAwareDelay(100_000_000))
+            try? await Task.sleep(for: .milliseconds(100))
             attempts += 1
         }
     }
@@ -255,7 +225,7 @@ public struct ArgyllRunner: Sendable {
         if flushPartialLines {
             dotFlushTask = Task { [processManager] in
                 while !Task.isCancelled {
-                    try? await Task.sleep(nanoseconds: 500_000_000)
+                    try? await Task.sleep(for: .milliseconds(500))
                     if Task.isCancelled { break }
                     await processManager.flushPartialLine(id: processId)
                 }
@@ -369,16 +339,28 @@ public struct ArgyllRunner: Sendable {
     ) async throws -> URL {
         let cwd = PathSecurity.resolveSafeCwd(config.workingDirectory)
         let args = try AverageArgs.build(config: config)
+        let binaryURL = binaryResolver.resolve("average")
         let processId = ProcessID.average(config.basename)
-        _ = try await runStreamingTool(
-            name: "average",
+
+        await ensureNotRunning(id: processId)
+        let events = processManager.events()
+        try await processManager.runStreaming(
             id: processId,
+            binary: binaryURL,
             arguments: args,
-            workingDirectory: cwd,
-            onLogBatch: onLogBatch
+            workingDirectory: cwd
         )
+        let run = await collect(id: processId, events: events, onLogBatch: onLogBatch)
+
+        guard run.exitCode == 0 else {
+            throw ArgyllRunnerError.averageFailed("average exited with code \(run.exitCode ?? -1)")
+        }
+
         let canonical = cwd.appendingPathComponent("\(config.basename).ti3")
-        return try requireArtefact(canonical)
+        guard FileManager.default.fileExists(atPath: canonical.path) else {
+            throw ArgyllRunnerError.missingArtefact(canonical.path)
+        }
+        return canonical
     }
 
     // MARK: - colprof (Stage 4)
@@ -392,15 +374,29 @@ public struct ArgyllRunner: Sendable {
         let cleanBasename = try PathSecurity.sanitizeBasename(config.basename)
         let cwd = PathSecurity.resolveSafeCwd(config.workingDirectory)
         let args = try ColprofArgs.build(config: config)
+        let binaryURL = binaryResolver.resolve("colprof")
         let processId = ProcessID.colprof(cleanBasename)
-        _ = try await runStreamingTool(
-            name: "colprof",
+
+        await ensureNotRunning(id: processId)
+        let events = processManager.events()
+        try await processManager.runStreaming(
             id: processId,
+            binary: binaryURL,
             arguments: args,
-            workingDirectory: cwd,
-            flushPartialLines: true,
-            onLogBatch: onLogBatch
+            workingDirectory: cwd
         )
+        let run = await collect(
+            id: processId,
+            events: events,
+            onLogBatch: onLogBatch,
+            flushPartialLines: true
+        )
+
+        guard run.exitCode == 0 else {
+            throw ArgyllRunnerError.colprofFailed(
+                "colprof exited with code \(run.exitCode ?? -1)"
+            )
+        }
 
         // Argyll may produce `.icm` on Windows, but on macOS we expect `.icc`.
         // `resolveProfile` checks `.icm` first, then `.icc`, matching #69.
@@ -460,20 +456,16 @@ public struct ArgyllRunner: Sendable {
             if Task.isCancelled {
                 throw CancellationError()
             }
-            throw ArgyllRunnerError.toolFailed(
-                tool: "applycal",
-                code: result.exitCode,
-                logs: [result.stderr.isEmpty
+            throw ArgyllRunnerError.applycalFailed(
+                result.stderr.isEmpty
                     ? "applycal exited with code \(result.exitCode)"
-                    : result.stderr]
+                    : result.stderr
             )
         }
 
         guard fm.fileExists(atPath: tmpURL.path) else {
-            throw ArgyllRunnerError.toolFailed(
-                tool: "applycal",
-                code: -1,
-                logs: ["applycal did not create temp profile"]
+            throw ArgyllRunnerError.applycalFailed(
+                "applycal did not create temp profile"
             )
         }
 
@@ -481,10 +473,8 @@ public struct ArgyllRunner: Sendable {
         let size = attrs?[.size] as? UInt64 ?? 0
         guard size >= 128 else {
             try? fm.removeItem(at: tmpURL)
-            throw ArgyllRunnerError.toolFailed(
-                tool: "applycal",
-                code: -1,
-                logs: ["calibrated profile is too small (\(size) bytes)"]
+            throw ArgyllRunnerError.applycalFailed(
+                "calibrated profile is too small (\(size) bytes)"
             )
         }
 
@@ -496,11 +486,7 @@ public struct ArgyllRunner: Sendable {
             }
         } catch {
             try? fm.removeItem(at: tmpURL)
-            throw ArgyllRunnerError.toolFailed(
-                tool: "applycal",
-                code: -1,
-                logs: [error.localizedDescription]
-            )
+            throw ArgyllRunnerError.applycalFailed(error.localizedDescription)
         }
 
         return inputURL
@@ -517,16 +503,30 @@ public struct ArgyllRunner: Sendable {
         let cwd = profileURL.deletingLastPathComponent()
         let stem = profileURL.deletingPathExtension().lastPathComponent
         let args = try IccgamutArgs.build(config: config)
+        let binaryURL = binaryResolver.resolve("iccgamut")
         let processId = ProcessID.iccgamut(stem: stem)
-        _ = try await runStreamingTool(
-            name: "iccgamut",
+
+        await ensureNotRunning(id: processId)
+        let events = processManager.events()
+        try await processManager.runStreaming(
             id: processId,
+            binary: binaryURL,
             arguments: args,
-            workingDirectory: cwd,
-            onLogBatch: onLogBatch
+            workingDirectory: cwd
         )
+        let run = await collect(id: processId, events: events, onLogBatch: onLogBatch)
+
+        guard run.exitCode == 0 else {
+            throw ArgyllRunnerError.iccgamutFailed(
+                "iccgamut exited with code \(run.exitCode ?? -1)"
+            )
+        }
+
         let gamURL = cwd.appendingPathComponent("\(stem).gam")
-        return try requireArtefact(gamURL)
+        guard FileManager.default.fileExists(atPath: gamURL.path) else {
+            throw ArgyllRunnerError.missingArtefact(gamURL.path)
+        }
+        return gamURL
     }
 
     // MARK: - profcheck (Stage 5 verification)
@@ -539,18 +539,30 @@ public struct ArgyllRunner: Sendable {
         let cwd = config.ti3URL.deletingLastPathComponent()
         let ti3Path = config.ti3URL.path
 
-        let iccURL = ArtefactProbe.resolveProfile(config.iccURL)
+        let iccURL = Self.resolveProfileForVerification(config.iccURL)
         let config = ProfcheckConfig(ti3URL: config.ti3URL, iccURL: iccURL)
 
         let args = try ProfcheckArgs.build(config: config)
+        let binaryURL = binaryResolver.resolve("profcheck")
         let processId = ProcessID.profcheck(ti3Path: ti3Path)
-        let run = try await runStreamingTool(
-            name: "profcheck",
+
+        await ensureNotRunning(id: processId)
+        let events = processManager.events()
+        try await processManager.runStreaming(
             id: processId,
+            binary: binaryURL,
             arguments: args,
-            workingDirectory: cwd,
-            onLogBatch: onLogBatch
+            workingDirectory: cwd
         )
+        let run = await collect(id: processId, events: events, onLogBatch: onLogBatch)
+
+        guard run.exitCode == 0 else {
+            throw ArgyllRunnerError.profcheckFailed(
+                run.stderr.isEmpty
+                    ? "profcheck exited with code \(run.exitCode ?? -1)"
+                    : run.stderr
+            )
+        }
 
         let output = (run.stdout + "\n" + run.stderr).trimmingCharacters(in: .whitespacesAndNewlines)
         let report = ProfcheckParser.parse(output)
@@ -560,6 +572,15 @@ public struct ArgyllRunner: Sendable {
         return report
     }
 
+    private static func resolveProfileForVerification(_ url: URL) -> URL {
+        let fm = FileManager.default
+        if fm.fileExists(atPath: url.path) { return url }
+        let alt = url.pathExtension.lowercased() == "icc"
+            ? url.deletingPathExtension().appendingPathExtension("icm")
+            : url.deletingPathExtension().appendingPathExtension("icc")
+        return fm.fileExists(atPath: alt.path) ? alt : url
+    }
+
     // MARK: - chartread (Stage 3 interactive)
 
     /// Runs `chartread` and returns an `AsyncStream` of typed events.
@@ -575,7 +596,7 @@ public struct ArgyllRunner: Sendable {
             cwd = PathSecurity.resolveSafeCwd(config.workingDirectory)
         } catch {
             return AsyncStream { continuation in
-                continuation.yield(.failed(ArgyllRunnerError.toolFailed(tool: "chartread", code: -1, logs: [error.localizedDescription])))
+                continuation.yield(.failed(ArgyllRunnerError.chartreadFailed(error.localizedDescription)))
                 continuation.finish()
             }
         }
@@ -585,7 +606,7 @@ public struct ArgyllRunner: Sendable {
             args = try ChartreadArgs.build(config: config)
         } catch {
             return AsyncStream { continuation in
-                continuation.yield(.failed(ArgyllRunnerError.toolFailed(tool: "chartread", code: -1, logs: [error.localizedDescription])))
+                continuation.yield(.failed(ArgyllRunnerError.chartreadFailed(error.localizedDescription)))
                 continuation.finish()
             }
         }
@@ -604,7 +625,7 @@ public struct ArgyllRunner: Sendable {
                 await processManager.setPreKillHook(id: processId) { [processManager] in
                     if isXY {
                         try? await processManager.sendStdin(id: processId, bytes: ChartreadInput.quit.bytes)
-                        try? await Task.sleep(nanoseconds: Self.testAwareDelay(500_000_000))
+                        try? await Task.sleep(for: .milliseconds(500))
                     }
                 }
 
@@ -616,7 +637,7 @@ public struct ArgyllRunner: Sendable {
                         workingDirectory: cwd
                     )
                 } catch {
-                    continuation.yield(.failed(ArgyllRunnerError.toolFailed(tool: "chartread", code: -1, logs: [error.localizedDescription])))
+                    continuation.yield(.failed(ArgyllRunnerError.chartreadFailed(error.localizedDescription)))
                     continuation.finish()
                     return
                 }
@@ -703,11 +724,7 @@ public struct ArgyllRunner: Sendable {
                         continuation.yield(.failed(ArgyllRunnerError.missingArtefact(canonical.path)))
                     }
                 } else {
-                    continuation.yield(.failed(ArgyllRunnerError.toolFailed(
-                        tool: "chartread",
-                        code: exitCode ?? -1,
-                        logs: ["chartread exited with code \(exitCode ?? -1)"]
-                    )))
+                    continuation.yield(.failed(ArgyllRunnerError.chartreadFailed("chartread exited with code \(exitCode ?? -1)")))
                 }
                 continuation.finish()
             }
@@ -742,148 +759,6 @@ public struct ArgyllRunner: Sendable {
         }
     }
 
-    // MARK: - spotread (spot-read console, issue #148)
-
-    /// Runs `spotread` and returns an `AsyncStream` of typed events.
-    ///
-    /// Same subscribe-before-spawn shape as `runChartread`, but there is
-    /// no artefact: the stream ends with `.exit(code)`. The single-lease
-    /// process id is `ProcessID.spotread` — never `chartread_{basename}`.
-    /// Missing sidecar surfaces as `.failed`; there is no `$PATH` or
-    /// `chartread` fallback (#116, R14/R21).
-    public func runSpotread(config: SpotReadConfig) -> AsyncStream<SpotReadEvent> {
-        let cwd = PathSecurity.resolveSafeCwd(config.workingDirectory)
-        let args = SpotReadArgs.build(config: config)
-        let binaryURL = binaryResolver.resolve("spotread")
-        let processId = ProcessID.spotread
-        let processManager = self.processManager
-        let isXY = config.isXY
-        let instrumentName = config.instrumentName
-        let instrumentPort = config.instrumentPort
-
-        return AsyncStream { continuation in
-            let task = Task {
-                await ensureNotRunning(id: processId)
-                let events = processManager.events()
-
-                // XY parking hook before any kill, same as chartread.
-                await processManager.setPreKillHook(id: processId) { [processManager] in
-                    if isXY {
-                        try? await processManager.sendStdin(id: processId, bytes: ChartreadInput.quit.bytes)
-                        try? await Task.sleep(nanoseconds: Self.testAwareDelay(500_000_000))
-                    }
-                }
-
-                guard binaryResolver.exists(binaryURL) else {
-                    continuation.yield(.failed(ArgyllRunnerError.toolFailed(
-                        tool: "spotread", code: -1,
-                        logs: ["spotread sidecar missing — run fetch-argyll"])))
-                    continuation.finish()
-                    return
-                }
-
-                do {
-                    try await processManager.runStreaming(
-                        id: processId,
-                        binary: binaryURL,
-                        arguments: args,
-                        workingDirectory: cwd
-                    )
-                } catch {
-                    continuation.yield(.failed(ArgyllRunnerError.toolFailed(
-                        tool: "spotread", code: -1, logs: [error.localizedDescription])))
-                    continuation.finish()
-                    return
-                }
-
-                var state: ChartreadState = .idle
-                var pendingLogs: [String] = []
-                var lastFlush = Date()
-                var exitCode: Int32?
-
-                func flushLogs() {
-                    guard !pendingLogs.isEmpty else { return }
-                    let batch = pendingLogs
-                    pendingLogs.removeAll(keepingCapacity: true)
-                    continuation.yield(.log(batch))
-                }
-
-                for await event in events {
-                    guard event.id == processId else { continue }
-
-                    switch event {
-                    case .stdout(_, let line):
-                        if let parsed = SpotReadParser.parse(line: line) {
-                            continuation.yield(.sample(SpotReadSample(
-                                lab: parsed.lab,
-                                xyz: parsed.xyz,
-                                instrumentName: instrumentName,
-                                port: instrumentPort,
-                                rawLine: line
-                            )))
-                        }
-                        let classified = SpotReadClassifier.classify(
-                            line: line, previousState: state)
-                        if classified.state != state
-                            || classified.requestedWarningKey != nil {
-                            state = classified.state
-                            continuation.yield(.prompt(classified))
-                        }
-                        pendingLogs.append(line)
-
-                    case .stderr(_, let line):
-                        pendingLogs.append(line)
-
-                    case .jsonRow:
-                        // spotread is never run with `-u`.
-                        break
-
-                    case .error(_, let message):
-                        pendingLogs.append("Error: \(message)")
-
-                    case .exit(_, let code):
-                        exitCode = code
-                    }
-
-                    if exitCode == nil,
-                       pendingLogs.count >= 20 || Date().timeIntervalSince(lastFlush) >= 0.1 {
-                        flushLogs()
-                        lastFlush = Date()
-                    }
-
-                    if exitCode != nil {
-                        flushLogs()
-                        break
-                    }
-                }
-
-                continuation.yield(.exit(exitCode ?? -1))
-                continuation.finish()
-            }
-
-            continuation.onTermination = { _ in
-                task.cancel()
-                Task {
-                    await processManager.kill(id: processId)
-                }
-            }
-        }
-    }
-
-    /// Send input bytes to the running `spotread` child. Reuses
-    /// `ChartreadInput` — the stdin protocol is identical.
-    public func sendSpotreadInput(_ input: ChartreadInput) async throws {
-        try await processManager.sendStdin(id: ProcessID.spotread, bytes: input.bytes)
-    }
-
-    /// Terminate a running `spotread` child. The XY park (`q\n` +
-    /// ~500 ms) runs in the pre-kill hook registered by `runSpotread`.
-    public func cancelSpotread() {
-        Task {
-            await processManager.kill(id: ProcessID.spotread)
-        }
-    }
-
     // MARK: - Stage 0 calibration
 
     /// Generates a calibration wedge `.ti1`.
@@ -893,19 +768,30 @@ public struct ArgyllRunner: Sendable {
     ) async throws -> URL {
         let args = try CalibrationTargenArgs.build(config: config)
         let cwd = PathSecurity.resolveSafeCwd(config.workingDirectory)
-        let cleanBasename = try PathSecurity.sanitizeBasename(
-            CalibrationIdentity.prefix(config.basename)
-        )
+        let calBasename = config.basename.hasPrefix("CAL_") ? config.basename : "CAL_\(config.basename)"
+        let cleanBasename = try PathSecurity.sanitizeBasename(calBasename)
+        let binaryURL = binaryResolver.resolve("targen")
         let processId = ProcessID.targen(cleanBasename)
-        _ = try await runStreamingTool(
-            name: "targen",
+
+        await ensureNotRunning(id: processId)
+        let events = processManager.events()
+        try await processManager.runStreaming(
             id: processId,
+            binary: binaryURL,
             arguments: args,
-            workingDirectory: cwd,
-            onLogBatch: onLogBatch
+            workingDirectory: cwd
         )
+        let run = await collect(id: processId, events: events, onLogBatch: onLogBatch)
+
+        guard run.exitCode == 0 else {
+            throw ArgyllRunnerError.processFailed(code: run.exitCode ?? -1, logs: run.lines)
+        }
+
         let ti1URL = cwd.appendingPathComponent("\(cleanBasename).ti1")
-        return try requireArtefact(ti1URL)
+        guard FileManager.default.fileExists(atPath: ti1URL.path) else {
+            throw ArgyllRunnerError.missingArtefact(ti1URL.path)
+        }
+        return ti1URL
     }
 
     /// Computes a `.cal` curve from a measured `CAL_*.ti3`.
@@ -919,7 +805,7 @@ public struct ArgyllRunner: Sendable {
         let args = try PrintcalArgs.build(config: config)
         let cwd = PathSecurity.resolveSafeCwd(config.workingDirectory)
         let binaryURL = binaryResolver.resolve("printcal")
-        let calBasename = CalibrationIdentity.prefix(config.ti3Basename)
+        let calBasename = config.ti3Basename.hasPrefix("CAL_") ? config.ti3Basename : "CAL_\(config.ti3Basename)"
         let processId = ProcessID.printcal(calBasename)
 
         await ensureNotRunning(id: processId)
@@ -935,12 +821,10 @@ public struct ArgyllRunner: Sendable {
         }
 
         guard result.exitCode == 0 else {
-            throw ArgyllRunnerError.toolFailed(
-                tool: "printcal",
-                code: result.exitCode,
-                logs: [result.stderr.isEmpty
+            throw ArgyllRunnerError.printcalFailed(
+                result.stderr.isEmpty
                     ? "printcal exited with code \(result.exitCode)"
-                    : result.stderr]
+                    : result.stderr
             )
         }
 
@@ -970,20 +854,6 @@ public enum ChartreadEvent: Sendable {
     case failed(ArgyllRunnerError)
 }
 
-/// Events emitted by a running `spotread` session (issue #148).
-public enum SpotReadEvent: Sendable {
-    /// Classified prompt / state update (reuses `ChartreadState`).
-    case prompt(ChartreadClassifyResult)
-    /// A parsed `Result is …` sample line.
-    case sample(SpotReadSample)
-    /// A batched log chunk (stdout + stderr lines).
-    case log([String])
-    /// Process exited with the given code.
-    case exit(Int32)
-    /// Failure (missing sidecar, spawn error).
-    case failed(ArgyllRunnerError)
-}
-
 /// Exact bytes sent to `chartread` stdin.
 public enum ChartreadInput: Sendable {
     case trigger    // " \n"

Packages/ICCeryCore/Sources/ICCeryCore/Argyll/PrinttargArgs.swift

@@ -56,19 +56,23 @@ public enum PrinttargArgs {
             }
             args.append(contentsOf: ["-R", "\(config.customSeed)"])
         case .raster:
-            args.append(contentsOf: ArgsBuilder.flag("-r", when: true))
+            args.append("-r")
         }
 
-        args.append(contentsOf: ArgsBuilder.optionIfNonEmpty("-d", config.label))
+        if let label = config.label?.trimmingCharacters(in: .whitespacesAndNewlines),
+           !label.isEmpty {
+            args.append(contentsOf: ["-d", label])
+        }
 
         guard (72...600).contains(config.dpi) else {
             throw PrinttargArgError.invalidDPI(config.dpi)
         }
         args.append(contentsOf: [config.bitDepth.flag, "\(config.dpi)"])
 
-        if !CalibrationIdentity.isCalibration(cleanBasename) {
-            args.append(contentsOf: ArgsBuilder.optionIfNonEmpty(
-                config.calibrationEmbedOnly ? "-I" : "-K", config.calibrationFile))
+        if !cleanBasename.hasPrefix("CAL_"),
+           let cal = config.calibrationFile?.trimmingCharacters(in: .whitespacesAndNewlines),
+           !cal.isEmpty {
+            args.append(contentsOf: [config.calibrationEmbedOnly ? "-I" : "-K", cal])
         }
 
         args.append(cleanBasename)

Packages/ICCeryCore/Sources/ICCeryCore/Argyll/SpotReadArgs.swift

@@ -1,28 +0,0 @@
-import Foundation
-
-/// Pure argv builder for Argyll's `spotread` tool (issue #148).
-public enum SpotReadArgs {
-
-    /// Builds `spotread` argv per the Gronod fork protocol.
-    ///
-    /// - Always `-v -e` (paper / reflective; never display `-d`).
-    /// - `-c N` is emitted only for `selectedPort != nil` and `N > 1`
-    ///   (Auto and port 1 omit it, #111).
-    /// - `-Y l` (letter L) is emitted only when `enableLEDs` is `true` (#204).
-    /// - Never `-u`: the v2.0 `-u` policy covers printtarg + chartread +
-    ///   profcheck only.
-    /// - No basename — `spotread` writes no artefact.
-    public static func build(config: SpotReadConfig) -> [String] {
-        var args: [String] = ["-v", "-e"]
-
-        if let port = config.selectedPort, port > 1 {
-            args.append(contentsOf: ["-c", "\(port)"])
-        }
-
-        if config.enableLEDs {
-            args.append(contentsOf: ["-Y", "l"])
-        }
-
-        return args
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Argyll/SpotReadConfig.swift

@@ -1,37 +0,0 @@
-import Foundation
-
-/// Configuration for a `spotread` invocation (issue #148).
-///
-/// `spotread` writes no artefact; `workingDirectory` is still required
-/// for the spawn (#59 — empty cwd is illegal).
-public struct SpotReadConfig: Codable, Equatable, Sendable {
-    public var workingDirectory: URL?
-    /// Communication port for `spotread -c`.
-    /// `nil` means omit `-c` (Auto or port 1, #111). Never an array index.
-    public var selectedPort: Int?
-    /// Enable i1Pro 2 visual LEDs (`-Y l`, #204).
-    public var enableLEDs: Bool
-    /// Whether the selected instrument is an XY table — controls the
-    /// `q\n` + ~500 ms park before kill on cancel.
-    public var isXY: Bool
-    /// Display name stamped onto each `SpotReadSample`.
-    public var instrumentName: String
-    /// Instrument port stamped onto each sample (nil for Auto).
-    public var instrumentPort: Int?
-
-    public init(
-        workingDirectory: URL? = nil,
-        selectedPort: Int? = nil,
-        enableLEDs: Bool = false,
-        isXY: Bool = false,
-        instrumentName: String = "",
-        instrumentPort: Int? = nil
-    ) {
-        self.workingDirectory = workingDirectory
-        self.selectedPort = selectedPort
-        self.enableLEDs = enableLEDs
-        self.isXY = isXY
-        self.instrumentName = instrumentName
-        self.instrumentPort = instrumentPort
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Argyll/TargenArgs.swift

@@ -70,12 +70,18 @@ public enum TargenArgs {
         if let n = config.neutralSteps, n > 0 {
             args.append(contentsOf: ["-n", "\(n)"])
         }
-        args.append(contentsOf: ArgsBuilder.optionUnlessApprox("-N", config.neutralConcentration, skip: 0.50))
-        args.append(contentsOf: ArgsBuilder.optionIfNonEmpty("-c", config.preconditioningProfile))
-        args.append(contentsOf: ArgsBuilder.flag("-G", when: config.ofpsHighQuality == true))
-        args.append(contentsOf: ArgsBuilder.option("-A", config.ofpsAdaptation.map {
-            String(format: "%.2f", locale: Locale(identifier: "en_US_POSIX"), $0)
-        }))
+        if let nConc = config.neutralConcentration, abs(nConc - 0.50) >= 0.001 {
+            args.append(contentsOf: ["-N", String(format: "%.2f", locale: Locale(identifier: "en_US_POSIX"), nConc)])
+        }
+        if let c = config.preconditioningProfile?.trimmingCharacters(in: .whitespacesAndNewlines), !c.isEmpty {
+            args.append(contentsOf: ["-c", c])
+        }
+        if config.ofpsHighQuality == true {
+            args.append("-G")
+        }
+        if let a = config.ofpsAdaptation {
+            args.append(contentsOf: ["-A", String(format: "%.2f", locale: Locale(identifier: "en_US_POSIX"), a)])
+        }
         if let algFlag = config.fullSpreadAlgorithm?.flag {
             args.append(algFlag)
         }
@@ -85,9 +91,11 @@ public enum TargenArgs {
             }
             args.append(contentsOf: ["-l", "\(inkLimit)"])
         }
-        args.append(contentsOf: ArgsBuilder.optionUnlessApprox("-V", config.darkEmphasis, skip: 1.0))
-        if let p = config.devicePower, p > 0 {
-            args.append(contentsOf: ArgsBuilder.optionUnlessApprox("-p", p, skip: 1.0))
+        if let v = config.darkEmphasis, abs(v - 1.0) >= 0.001 {
+            args.append(contentsOf: ["-V", String(format: "%.2f", locale: Locale(identifier: "en_US_POSIX"), v)])
+        }
+        if let p = config.devicePower, p > 0, abs(p - 1.0) >= 0.001 {
+            args.append(contentsOf: ["-p", String(format: "%.2f", locale: Locale(identifier: "en_US_POSIX"), p)])
         }
 
         args.append(cleanBasename)

Packages/ICCeryCore/Sources/ICCeryCore/CGATS/CGATSParser.swift

@@ -72,8 +72,8 @@ public enum CGATSParser {
     public static func parse(
         _ contents: String,
         sourceURL: URL? = nil
-    ) throws -> CGATSDataset {
-        guard !contents.isEmpty else { throw CGATSParseError.emptyFile }
+    ) throws(CGATSParseError) -> CGATSDataset {
+        guard !contents.isEmpty else { throw .emptyFile }
 
         let ext = sourceURL?.pathExtension.lowercased() ?? ""
         let isCSV = ext == "csv" || contents.trimmingCharacters(in: .whitespacesAndNewlines)
@@ -101,10 +101,10 @@ public enum CGATSParser {
         }
 
         guard let formatStart, let formatEnd, formatEnd > formatStart + 1 else {
-            throw CGATSParseError.missingBeginDataFormat
+            throw .missingBeginDataFormat
         }
         guard let dataStart, let dataEnd, dataEnd > dataStart + 1 else {
-            throw CGATSParseError.missingBeginData
+            throw .missingBeginData
         }
 
         let rawFieldNames = splitFields(lines[formatStart + 1])
@@ -139,7 +139,7 @@ public enum CGATSParser {
             let lineIndex = dataStart + offset
             let rawRow = splitFields(lines[lineIndex])
             guard rawRow.count == fieldNames.count else {
-                throw CGATSParseError.incorrectArity(line: lineIndex + 1, expected: fieldNames.count, got: rawRow.count)
+                throw .incorrectArity(line: lineIndex + 1, expected: fieldNames.count, got: rawRow.count)
             }
 
             var sample = RawSample(id: String(offset), lineIndex: lineIndex)
@@ -153,7 +153,7 @@ public enum CGATSParser {
                             groupMax[group, default: 0] = max(groupMax[group, default: 0], number)
                         }
                     } else if !cleaned.isEmpty {
-                        throw CGATSParseError.nonNumericValue(field: name, value: raw, line: lineIndex + 1)
+                        throw .nonNumericValue(field: name, value: raw, line: lineIndex + 1)
                     }
                 } else {
                     sample.strings[name] = raw
@@ -213,7 +213,7 @@ public enum CGATSParser {
     private static func preprocess(
         _ contents: String,
         isCSV: Bool
-    ) throws -> (CGATSFormat, [String]) {
+    ) throws(CGATSParseError) -> (CGATSFormat, [String]) {
         let allLines = contents.components(separatedBy: .newlines)
         var lines = [String]()
 
@@ -239,7 +239,7 @@ public enum CGATSParser {
             lines.append(line)
         }
 
-        guard !lines.isEmpty else { throw CGATSParseError.emptyFile }
+        guard !lines.isEmpty else { throw .emptyFile }
 
         // Wrap a bare CSV / ISO28178 file in the canonical CGATS block
         // structure so the boundary-based parser below can handle it.

Packages/ICCeryCore/Sources/ICCeryCore/Files/ArtefactFiles.swift

@@ -20,14 +20,8 @@ public enum ArtefactFiles {
         bundle: Bundle = .main
     ) -> (version: String, build: String, buildDate: String) {
         let info = bundle.infoDictionary ?? [:]
-        let short = info["CFBundleShortVersionString"] as? String ?? "0.0.0"
+        let version = info["CFBundleShortVersionString"] as? String ?? "0.0.0"
         let build = info["CFBundleVersion"] as? String ?? "0"
-        var tag = ""
-        if let url = bundle.url(forResource: "ICCeryReleaseTag", withExtension: nil),
-           let raw = try? String(contentsOf: url, encoding: .utf8) {
-            tag = raw
-        }
-        let version = displayVersion(shortVersion: short, releaseTag: tag)
 
         let url = bundle.executableURL ?? bundle.bundleURL
         let buildDate: String
@@ -43,15 +37,4 @@ public enum ArtefactFiles {
 
         return (version, build, buildDate)
     }
-
-    /// About "Version:" string from the release tag + marketing version
-    /// (#189): `v2.0.0-pre2 (2.0.0)`; dedupes to `v2.0.0` on an exact
-    /// release tag; falls back to the short version when untagged.
-    static func displayVersion(shortVersion: String, releaseTag: String) -> String {
-        let tag = releaseTag.trimmingCharacters(in: .whitespacesAndNewlines)
-        if tag.isEmpty || tag == shortVersion || tag == "v\(shortVersion)" {
-            return tag.isEmpty ? shortVersion : tag
-        }
-        return "\(tag) (\(shortVersion))"
-    }
 }

Packages/ICCeryCore/Sources/ICCeryCore/Files/ArtefactProbe.swift

@@ -78,21 +78,6 @@ public enum ArtefactProbe {
         return nil
     }
 
-    /// Resolve an explicit profile URL, flipping `.icc` ↔ `.icm` when the
-    /// requested path is missing (#69 / issue #83). Any other extension
-    /// (`.mpp`, `.txt`, …) is returned unchanged — never rewritten.
-    public static func resolveProfile(
-        _ url: URL,
-        fileManager: FileManager = .default
-    ) -> URL {
-        if fileManager.fileExists(atPath: url.path) { return url }
-        let ext = url.pathExtension.lowercased()
-        guard ext == "icc" || ext == "icm" else { return url }
-        let alt = url.deletingPathExtension()
-            .appendingPathExtension(ext == "icc" ? "icm" : "icc")
-        return fileManager.fileExists(atPath: alt.path) ? alt : url
-    }
-
     /// Default extension for a *new* profile on macOS (#69).
     public static let defaultProfileExtension = "icc"
 

Packages/ICCeryCore/Sources/ICCeryCore/Files/JSONFileStore.swift

@@ -1,85 +0,0 @@
-import Foundation
-
-/// Policy when a JSON file exists but cannot be decoded.
-public enum JSONCorruptPolicy: Sendable {
-    /// Return `defaultValue` and leave the file untouched.
-    case replaceWithDefault
-    /// Throw the decode error. Callers must not overwrite the file.
-    case throwCorrupt
-}
-
-/// Shared pretty-printed JSON file façade used by settings, wizard state,
-/// and verification history.
-public struct JSONFileStore<T: Codable & Sendable>: Sendable {
-    public let fileURL: URL
-    public let corrupt: JSONCorruptPolicy
-    private let defaultValue: @Sendable () -> T
-    private let encoder: JSONEncoder
-    private let decoder: JSONDecoder
-
-    public init(
-        fileURL: URL,
-        corrupt: JSONCorruptPolicy,
-        defaultValue: @escaping @Sendable () -> T,
-        dateEncoding: JSONEncoder.DateEncodingStrategy = .deferredToDate,
-        dateDecoding: JSONDecoder.DateDecodingStrategy = .deferredToDate
-    ) {
-        self.fileURL = fileURL
-        self.corrupt = corrupt
-        self.defaultValue = defaultValue
-        self.encoder = JSONEncoder.icceryPretty(dateEncoding: dateEncoding)
-        let decoder = JSONDecoder()
-        decoder.dateDecodingStrategy = dateDecoding
-        self.decoder = decoder
-    }
-
-    /// Encodes `value` with the shared pretty / sorted-keys encoder.
-    public func encodePretty(_ value: T) throws -> Data {
-        try encoder.encode(value)
-    }
-
-    public func load() throws -> T {
-        let fm = FileManager.default
-        guard fm.fileExists(atPath: fileURL.path) else {
-            return defaultValue()
-        }
-        let data: Data
-        do {
-            data = try Data(contentsOf: fileURL)
-        } catch {
-            switch corrupt {
-            case .replaceWithDefault:
-                return defaultValue()
-            case .throwCorrupt:
-                throw error
-            }
-        }
-        do {
-            return try decoder.decode(T.self, from: data)
-        } catch {
-            switch corrupt {
-            case .replaceWithDefault:
-                return defaultValue()
-            case .throwCorrupt:
-                throw error
-            }
-        }
-    }
-
-    public func save(_ value: T) throws {
-        try AtomicFileWriter.write(try encodePretty(value), to: fileURL)
-    }
-}
-
-extension JSONEncoder {
-    /// Shared pretty-printed, sorted-keys encoder used by `JSONFileStore`
-    /// and preset export.
-    static func icceryPretty(
-        dateEncoding: JSONEncoder.DateEncodingStrategy = .deferredToDate
-    ) -> JSONEncoder {
-        let encoder = JSONEncoder()
-        encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
-        encoder.dateEncodingStrategy = dateEncoding
-        return encoder
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Gamut/ApproximateLab.swift

@@ -1,64 +0,0 @@
-import Foundation
-
-/// Approximate sRGB → CIELab D50 conversion for the gamut inspect panel
-/// (issue #147).
-///
-/// This is a fixed-matrix helper, **not** a colour-management module: it
-/// never touches ICC profiles, ColorSync, or lcms. The UI labels its
-/// output "approx. Lab, not ColorSync".
-public enum ApproximateLab {
-
-    /// linear-sRGB → XYZ (D65) matrix, IEC 61966-2-1.
-    private static let srgbToXYZ: [[Double]] = [
-        [0.4124, 0.3576, 0.1805],
-        [0.2126, 0.7152, 0.0722],
-        [0.0193, 0.1192, 0.9505],
-    ]
-
-    /// 8-bit sRGB triple → Lab D50 (approximate).
-    public static func srgb8ToLab(r: Int, g: Int, b: Int) -> LabColor {
-        srgbToLab(DisplayRGB(
-            r: Double(r) / 255.0,
-            g: Double(g) / 255.0,
-            b: Double(b) / 255.0))
-    }
-
-    /// 0–1 sRGB triple → Lab D50 (approximate).
-    public static func srgbToLab(_ rgb: DisplayRGB) -> LabColor {
-        func linear(_ c: Double) -> Double {
-            c <= 0.04045 ? c / 12.92 : pow((c + 0.055) / 1.055, 2.4)
-        }
-        let v = [linear(rgb.r), linear(rgb.g), linear(rgb.b)]
-        // 0–1 XYZ D65 → the 0–100 scale `LabColorMath` works in.
-        let xyz65 = XYZColor(
-            x: (srgbToXYZ[0][0] * v[0] + srgbToXYZ[0][1] * v[1] + srgbToXYZ[0][2] * v[2]) * 100,
-            y: (srgbToXYZ[1][0] * v[0] + srgbToXYZ[1][1] * v[1] + srgbToXYZ[1][2] * v[2]) * 100,
-            z: (srgbToXYZ[2][0] * v[0] + srgbToXYZ[2][1] * v[1] + srgbToXYZ[2][2] * v[2]) * 100)
-        return LabColorMath.xyzToLab(adaptD65ToD50(xyz65))
-    }
-
-    /// Bradford D65 → D50 chromatic adaptation — the mirror of
-    /// `LabColorMath.adaptD50ToD65`.
-    private static func adaptD65ToD50(_ xyz: XYZColor) -> XYZColor {
-        let m = LabColorMath.bradford
-        let inv = LabColorMath.bradfordInv
-        let d65 = LabColorMath.d65White
-        let d50 = LabColorMath.d50White
-        let source = multiply(m, [xyz.x, xyz.y, xyz.z])
-        let srcWhite = multiply(m, [d65.X, d65.Y, d65.Z])
-        let dstWhite = multiply(m, [d50.X, d50.Y, d50.Z])
-        let scaled = [
-            source[0] * (dstWhite[0] / srcWhite[0]),
-            source[1] * (dstWhite[1] / srcWhite[1]),
-            source[2] * (dstWhite[2] / srcWhite[2]),
-        ]
-        return XYZColor(
-            x: inv[0][0] * scaled[0] + inv[0][1] * scaled[1] + inv[0][2] * scaled[2],
-            y: inv[1][0] * scaled[0] + inv[1][1] * scaled[1] + inv[1][2] * scaled[2],
-            z: inv[2][0] * scaled[0] + inv[2][1] * scaled[1] + inv[2][2] * scaled[2])
-    }
-
-    private static func multiply(_ m: [[Double]], _ v: [Double]) -> [Double] {
-        m.map { row in zip(row, v).reduce(0) { $0 + $1.0 * $1.1 } }
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Gamut/GamutContainment.swift

@@ -1,115 +0,0 @@
-import Foundation
-import simd
-
-/// Result of a point-in-gamut test (issue #147).
-public enum GamutContainment: String, Sendable, Equatable {
-    /// The point lies inside the mesh volume.
-    case inside
-    /// The point lies outside the mesh volume.
-    case outside
-    /// The mesh has no faces to test against.
-    case unknown
-}
-
-/// Point-in-mesh containment and volume estimation for ``GamutMesh``.
-///
-/// Both tests run on the scene-space positions stored on
-/// ``GamutVertex/position`` (`x = a*`, `y = L*`, `z = b*`), the same
-/// mapping the SceneKit viewer uses. No colour management is involved.
-public enum GamutGeometry {
-
-    /// Whether `lab` is inside `mesh`.
-    ///
-    /// Ray-casts through the face list: an odd crossing count means the
-    /// point is inside a closed surface. A ray that grazes a vertex or
-    /// edge gives an ambiguous count, so the test retries with off-axis
-    /// directions before answering. Meshes without faces report
-    /// ``GamutContainment/unknown``.
-    public static func containment(of lab: LabColor, in mesh: GamutMesh) -> GamutContainment {
-        guard !mesh.faces.isEmpty else { return .unknown }
-        let origin = SIMD3<Double>(lab.a, lab.l, lab.b)
-        for direction in rayDirections {
-            if let inside = castRay(from: origin, direction: direction, mesh: mesh) {
-                return inside ? .inside : .outside
-            }
-        }
-        return .unknown
-    }
-
-    /// Approximate mesh volume in Lab-cubic units.
-    ///
-    /// Sums signed tetrahedra from the vertex centroid to each face; for
-    /// a closed surface the magnitude equals the enclosed volume
-    /// regardless of face winding. Returns 0 for empty or face-less
-    /// meshes.
-    public static func volume(of mesh: GamutMesh) -> Double {
-        guard !mesh.faces.isEmpty, !mesh.vertices.isEmpty else { return 0 }
-        var centroid = SIMD3<Double>.zero
-        for vertex in mesh.vertices {
-            centroid += SIMD3<Double>(vertex.position)
-        }
-        centroid /= Double(mesh.vertices.count)
-
-        var sum = 0.0
-        let count = mesh.vertices.count
-        for face in mesh.faces {
-            guard Int(face.a) < count, Int(face.b) < count, Int(face.c) < count else {
-                continue
-            }
-            let a = SIMD3<Double>(mesh.vertices[Int(face.a)].position) - centroid
-            let b = SIMD3<Double>(mesh.vertices[Int(face.b)].position) - centroid
-            let c = SIMD3<Double>(mesh.vertices[Int(face.c)].position) - centroid
-            sum += simd_dot(a, simd_cross(b, c)) / 6.0
-        }
-        return abs(sum)
-    }
-
-    // MARK: - Ray casting
-
-    /// Primary +X ray, then off-axis retries for degenerate edge hits.
-    private static let rayDirections: [SIMD3<Double>] = [
-        SIMD3(1, 0, 0),
-        simd_normalize(SIMD3<Double>(0.71, 1.0, 0.53)),
-        simd_normalize(SIMD3<Double>(0.53, 0.71, 1.0)),
-    ]
-
-    /// Möller–Trumbore crossing count. Returns `nil` when a crossing
-    /// lands on a triangle edge or vertex (ambiguous parity) so the
-    /// caller can retry with a different direction.
-    private static func castRay(
-        from origin: SIMD3<Double>,
-        direction dir: SIMD3<Double>,
-        mesh: GamutMesh
-    ) -> Bool? {
-        let epsilon = 1e-9
-        var crossings = 0
-        let count = mesh.vertices.count
-        for face in mesh.faces {
-            guard Int(face.a) < count, Int(face.b) < count, Int(face.c) < count else {
-                continue
-            }
-            let va = SIMD3<Double>(mesh.vertices[Int(face.a)].position)
-            let vb = SIMD3<Double>(mesh.vertices[Int(face.b)].position)
-            let vc = SIMD3<Double>(mesh.vertices[Int(face.c)].position)
-
-            let e1 = vb - va
-            let e2 = vc - va
-            let p = simd_cross(dir, e2)
-            let det = simd_dot(e1, p)
-            if abs(det) < 1e-12 { continue }  // ray parallel to face
-            let inv = 1.0 / det
-            let tvec = origin - va
-            let u = simd_dot(tvec, p) * inv
-            let q = simd_cross(tvec, e1)
-            let v = simd_dot(dir, q) * inv
-            let t = simd_dot(e2, q) * inv
-
-            guard t > epsilon else { continue }
-            if u < -epsilon || v < -epsilon || u + v > 1 + epsilon { continue }
-            // Crossing on an edge or vertex — parity is ambiguous.
-            if u < epsilon || v < epsilon || u + v > 1 - epsilon { return nil }
-            crossings += 1
-        }
-        return crossings % 2 == 1
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Gamut/NamedGamut.swift

@@ -1,39 +0,0 @@
-import Foundation
-
-/// A parsed gamut mesh plus the display metadata the compare viewer
-/// needs (issue #147).
-///
-/// `displayName` is user-derived (a file name); views must render it
-/// through `Text` only (#114).
-public struct NamedGamut: Sendable, Equatable, Identifiable {
-
-    /// What the layer is used for in the compare UI.
-    public enum Role: String, Sendable, Equatable {
-        /// Bundled reference space (sRGB). Cannot be removed, only hidden.
-        case reference
-        /// The workflow's own profile gamut.
-        case profileA
-        /// The user-added compare gamut. Replaced, never stacked.
-        case profileB
-    }
-
-    public var id: String
-    public var displayName: String
-    public var role: Role
-    public var mesh: GamutMesh
-    public var sourceURL: URL
-
-    public init(
-        id: String,
-        displayName: String,
-        role: Role,
-        mesh: GamutMesh,
-        sourceURL: URL
-    ) {
-        self.id = id
-        self.displayName = displayName
-        self.role = role
-        self.mesh = mesh
-        self.sourceURL = sourceURL
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Library/ICCeryProject.swift

@@ -1,218 +0,0 @@
-import Foundation
-
-/// The `.icceryproj` file — a JSON **index** over a basename + working
-/// directory + optional media recipe/preset binding + last verification
-/// snapshot (issue #149, docs/06 §Project file).
-///
-/// The project is never a second source of truth: artefact gating stays
-/// on disk (`ArtefactProbe`), and `wizard_state.json` continues to
-/// persist the live session. snake_case keys match the v1 schema;
-/// `schema_version != 1` is a hard decode error — v2 fields are never
-/// partially decoded.
-public struct ICCeryProject: Codable, Equatable, Sendable {
-
-    /// The only schema version this build reads and writes.
-    public static let currentSchemaVersion = 1
-
-    public var schemaVersion: Int
-    public var name: String
-    public var notes: String
-    /// Run name without extension — never `CAL_`-persisted (#60/R11).
-    public var basename: String
-    /// Absolute working directory holding the artefacts (#59).
-    public var cwd: String
-    /// May differ from `basename` after a `.ti3` import (#94).
-    public var profileBasename: String?
-    /// CUPS queue id, when a printer was selected.
-    public var printerID: String?
-    public var printerDisplayName: String?
-    /// `MediaRecipe.id` — optional; ignored when the library file is
-    /// absent or the id is unknown (soft-dependency, #146).
-    public var mediaRecipeID: String?
-    public var presetID: String?
-    /// Absolute `.cal` path stored verbatim; `nil` = none.
-    public var calibrationURL: String?
-    public var lastVerification: VerificationSnapshot?
-    public var updated: Date
-
-    public init(
-        schemaVersion: Int = ICCeryProject.currentSchemaVersion,
-        name: String = "",
-        notes: String = "",
-        basename: String,
-        cwd: String,
-        profileBasename: String? = nil,
-        printerID: String? = nil,
-        printerDisplayName: String? = nil,
-        mediaRecipeID: String? = nil,
-        presetID: String? = nil,
-        calibrationURL: String? = nil,
-        lastVerification: VerificationSnapshot? = nil,
-        updated: Date = Date()
-    ) {
-        self.schemaVersion = schemaVersion
-        self.name = name
-        self.notes = notes
-        self.basename = basename
-        self.cwd = cwd
-        self.profileBasename = profileBasename
-        self.printerID = printerID
-        self.printerDisplayName = printerDisplayName
-        self.mediaRecipeID = mediaRecipeID
-        self.presetID = presetID
-        self.calibrationURL = calibrationURL
-        self.lastVerification = lastVerification
-        self.updated = updated
-    }
-
-    enum CodingKeys: String, CodingKey {
-        case schemaVersion = "schema_version"
-        case name, notes, basename, cwd
-        case profileBasename = "profile_basename"
-        case printerID = "printer_id"
-        case printerDisplayName = "printer_display_name"
-        case mediaRecipeID = "media_recipe_id"
-        case presetID = "preset_id"
-        case calibrationURL = "calibration_url"
-        case lastVerification = "last_verification"
-        case updated
-    }
-
-    /// Strict decode: `schema_version` is required and must equal 1 —
-    /// anything else throws before a single v2 field is read. Required
-    /// strings (`basename`, `cwd`) must be present; optionals default.
-    /// Unknown keys are ignored.
-    public init(from decoder: Decoder) throws {
-        let c = try decoder.container(keyedBy: CodingKeys.self)
-        let version = try c.decode(Int.self, forKey: .schemaVersion)
-        guard version == ICCeryProject.currentSchemaVersion else {
-            throw ValidationError.unsupportedSchema(version)
-        }
-        schemaVersion = version
-        name = try c.decodeIfPresent(String.self, forKey: .name) ?? ""
-        notes = try c.decodeIfPresent(String.self, forKey: .notes) ?? ""
-        basename = try c.decode(String.self, forKey: .basename)
-        cwd = try c.decode(String.self, forKey: .cwd)
-        profileBasename = try c.decodeIfPresent(String.self, forKey: .profileBasename)
-        printerID = try c.decodeIfPresent(String.self, forKey: .printerID)
-        printerDisplayName = try c.decodeIfPresent(String.self, forKey: .printerDisplayName)
-        mediaRecipeID = try c.decodeIfPresent(String.self, forKey: .mediaRecipeID)
-        presetID = try c.decodeIfPresent(String.self, forKey: .presetID)
-        calibrationURL = try c.decodeIfPresent(String.self, forKey: .calibrationURL)
-        lastVerification = try c.decodeIfPresent(VerificationSnapshot.self, forKey: .lastVerification)
-        updated = try c.decodeIfPresent(Date.self, forKey: .updated) ?? Date()
-    }
-
-    public enum ValidationError: LocalizedError, Equatable {
-        case unsupportedSchema(Int)
-        case emptyBasename
-        case invalidBasename(String)
-        case emptyCwd
-        case unsafeCwd(String)
-        case invalidCalibrationURL(String)
-
-        public var errorDescription: String? {
-            switch self {
-            case .unsupportedSchema:
-                return "This project file is not schema 1."
-            case .emptyBasename:
-                return "A project needs a target basename."
-            case .invalidBasename(let v):
-                return "Illegal project basename \"\(v)\"."
-            case .emptyCwd:
-                return "A project needs a working folder."
-            case .unsafeCwd(let v):
-                return "cwd must be an absolute path, got \"\(v)\"."
-            case .invalidCalibrationURL(let v):
-                return "calibration_url must be an absolute path without \"..\" or NUL, got \"\(v)\"."
-            }
-        }
-    }
-
-    /// Validates the index fields. Empty basename/cwd refuse (#59/#60);
-    /// basename still rejects `/`, `\`, `..`; cwd must be absolute. An
-    /// empty `name` falls back to the basename.
-    @discardableResult
-    public func validated() throws -> ICCeryProject {
-        var p = self
-        p.basename = basename.trimmingCharacters(in: .whitespacesAndNewlines)
-        p.name = name.trimmingCharacters(in: .whitespacesAndNewlines)
-        guard !p.basename.isEmpty else { throw ValidationError.emptyBasename }
-        guard PathSecurity.isValidBasename(p.basename) else {
-            throw ValidationError.invalidBasename(p.basename)
-        }
-        let trimmedCwd = p.cwd.trimmingCharacters(in: .whitespacesAndNewlines)
-        guard !trimmedCwd.isEmpty else { throw ValidationError.emptyCwd }
-        guard trimmedCwd.hasPrefix("/"), !trimmedCwd.contains("\0") else {
-            throw ValidationError.unsafeCwd(p.cwd)
-        }
-        p.cwd = trimmedCwd
-        if p.name.isEmpty { p.name = p.basename }
-        if let cal = p.calibrationURL, !cal.isEmpty {
-            guard cal.hasPrefix("/"), !cal.contains(".."), !cal.contains("\0") else {
-                throw ValidationError.invalidCalibrationURL(cal)
-            }
-        }
-        return p
-    }
-
-    /// Reads a `.icceryproj` file. Throws `unsupportedSchema` for
-    /// `schema_version != 1` and the decode/validation error otherwise;
-    /// callers must leave live state untouched on failure.
-    public static func load(from url: URL) throws -> ICCeryProject {
-        let data = try Data(contentsOf: url)
-        let decoder = JSONDecoder()
-        decoder.dateDecodingStrategy = .iso8601
-        return try decoder.decode(ICCeryProject.self, from: data).validated()
-    }
-
-    /// Atomic `.tmp` + rename write via `AtomicFileWriter` (#213).
-    /// Validation runs first — a refused project never touches disk.
-    public func save(to url: URL) throws {
-        let encoder = JSONEncoder.icceryPretty(dateEncoding: .iso8601)
-        try AtomicFileWriter.write(try encoder.encode(validated()), to: url)
-    }
-}
-
-/// The last `VerificationRecord` frozen into the project file — notes
-/// only, never gating truth.
-public struct VerificationSnapshot: Codable, Equatable, Sendable {
-    public var date: Date
-    public var avgDE00: Double
-    public var maxDE00: Double
-    /// `VerificationStatus.rawValue`.
-    public var status: String
-    public var profileFilename: String
-
-    public init(
-        date: Date,
-        avgDE00: Double,
-        maxDE00: Double,
-        status: String,
-        profileFilename: String
-    ) {
-        self.date = date
-        self.avgDE00 = avgDE00
-        self.maxDE00 = maxDE00
-        self.status = status
-        self.profileFilename = profileFilename
-    }
-
-    public init(record: VerificationRecord) {
-        self.init(
-            date: record.timestamp,
-            avgDE00: record.avgDE,
-            maxDE00: record.maxDE,
-            status: record.status.rawValue,
-            profileFilename: record.profileName
-        )
-    }
-
-    enum CodingKeys: String, CodingKey {
-        case date
-        case avgDE00 = "avg_de00"
-        case maxDE00 = "max_de00"
-        case status
-        case profileFilename = "profile_filename"
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Library/MediaLibraryStore.swift

@@ -1,117 +0,0 @@
-import Foundation
-
-/// Persistence for `MediaRecipe` entries (issue #146).
-///
-/// `media_library.json` is a sibling of `settings.json`, never a field
-/// inside it. Writes are atomic via `JSONFileStore` → `AtomicFileWriter`
-/// (`.tmp` + rename, #213). A corrupt file throws on load/upsert and is
-/// never overwritten — the view model turns the throw into an empty
-/// list plus a persistent warning banner.
-public actor MediaLibraryStore {
-
-    /// Default cap.
-    public static let defaultCapacity = 200
-
-    /// Path to the JSON store.
-    public let url: URL
-
-    /// In-memory cache, kept in sync with disk.
-    private var recipes: [MediaRecipe] = []
-
-    /// Explicit load flag — an empty file is still "loaded".
-    private var loaded = false
-
-    private let capacity: Int
-    private let fileStore: JSONFileStore<[MediaRecipe]>
-
-    public init(
-        url: URL = AppPaths.appDataDir.appendingPathComponent("media_library.json"),
-        capacity: Int = defaultCapacity
-    ) {
-        self.url = url
-        self.capacity = capacity
-        self.fileStore = JSONFileStore(
-            fileURL: url,
-            corrupt: .throwCorrupt,
-            defaultValue: { [] },
-            dateEncoding: .iso8601,
-            dateDecoding: .iso8601
-        )
-    }
-
-    /// Loads recipes from disk. Returns the existing cache if already
-    /// loaded.
-    ///
-    /// Throws when the file exists but cannot be parsed; the existing
-    /// file is never overwritten in that case and `loaded` stays false
-    /// so the next call re-reads.
-    public func load() throws -> [MediaRecipe] {
-        guard !loaded else { return recipes }
-        guard FileManager.default.fileExists(atPath: url.path) else {
-            loaded = true
-            return []
-        }
-        recipes = try fileStore.load()
-        loaded = true
-        return recipes
-    }
-
-    /// Returns all cached recipes.
-    public func all() -> [MediaRecipe] {
-        recipes
-    }
-
-    /// Inserts or replaces a recipe matched by `id`, then writes
-    /// atomically. Replacement preserves `created` and bumps `updated`;
-    /// inserts beyond `capacity` throw `.capacityReached` — no silent
-    /// eviction.
-    ///
-    /// Loads the existing library first and propagates any load error
-    /// so an unparseable file is never overwritten.
-    @discardableResult
-    public func upsert(_ recipe: MediaRecipe) throws -> [MediaRecipe] {
-        let validated = try recipe.validated()
-        try load()
-
-        var updated = recipes
-        if let index = updated.firstIndex(where: { $0.id == validated.id }) {
-            var existing = validated
-            existing.created = updated[index].created
-            existing.updated = Date()
-            updated[index] = existing
-        } else {
-            guard updated.count < capacity else {
-                throw MediaLibraryError.capacityReached(capacity)
-            }
-            updated.append(validated)
-        }
-
-        try fileStore.save(updated)
-        recipes = updated
-        return updated
-    }
-
-    /// Removes a recipe by id and writes atomically. Returns false when
-    /// no recipe with that id exists.
-    @discardableResult
-    public func delete(id: String) throws -> Bool {
-        try load()
-        let before = recipes.count
-        let updated = recipes.filter { $0.id != id }
-        guard updated.count != before else { return false }
-        try fileStore.save(updated)
-        recipes = updated
-        return true
-    }
-
-    public enum MediaLibraryError: LocalizedError, Equatable {
-        case capacityReached(Int)
-
-        public var errorDescription: String? {
-            switch self {
-            case .capacityReached(let cap):
-                return "Media library is full (\(cap)). Delete a recipe first."
-            }
-        }
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Library/MediaRecipe.swift

@@ -1,146 +0,0 @@
-import Foundation
-
-/// A media recipe: a named binding of CUPS queue + paper + ink set +
-/// optional `.cal` to a `ProfilingPreset` (issue #146, docs/22 §Media
-/// library).
-///
-/// snake_case keys match the v1 JSON schema so `media_library.json`
-/// stays import/export compatible. Identity + binding fields are
-/// required; every other field is optional-defaulted. Unknown keys are
-/// ignored on decode; missing required fields fail the whole array
-/// decode (corrupt-file policy, never silently dropped).
-public struct MediaRecipe: Codable, Equatable, Sendable, Identifiable {
-
-    /// `"recipe-<uuid>"`, never user-typed.
-    public var id: String
-    public var name: String
-    public var notes: String
-    /// CUPS queue id (`Printer.name` — `Printer` has no `id` member).
-    public var printerID: String
-    /// Human label from `Printer.displayName`.
-    public var printerDisplayName: String
-    /// Library metadata only — never written to targen `-P`/`-I` flags.
-    public var paperName: String
-    /// Last captured CUPS `media_type`, read-only.
-    public var driverMediaType: String?
-    /// Free text: `"PK"`, `"MK"`, `"Photo Black"`, …
-    public var inkSet: String
-    /// `"rgb"` | `"cmyk"` — must match the bound preset.
-    public var colourSpace: String
-    /// `ProfilingPreset.id` (built-in or custom).
-    public var presetID: String
-    /// Absolute `.cal` path stored verbatim; `nil` = none.
-    public var calibrationURL: String?
-    public var applyCalibration: Bool
-    public var created: Date
-    public var updated: Date
-
-    public init(
-        id: String,
-        name: String,
-        notes: String = "",
-        printerID: String,
-        printerDisplayName: String = "",
-        paperName: String = "",
-        driverMediaType: String? = nil,
-        inkSet: String = "",
-        colourSpace: String,
-        presetID: String,
-        calibrationURL: String? = nil,
-        applyCalibration: Bool = false,
-        created: Date = Date(),
-        updated: Date = Date()
-    ) {
-        self.id = id
-        self.name = name
-        self.notes = notes
-        self.printerID = printerID
-        self.printerDisplayName = printerDisplayName
-        self.paperName = paperName
-        self.driverMediaType = driverMediaType
-        self.inkSet = inkSet
-        self.colourSpace = colourSpace
-        self.presetID = presetID
-        self.calibrationURL = calibrationURL
-        self.applyCalibration = applyCalibration
-        self.created = created
-        self.updated = updated
-    }
-
-    enum CodingKeys: String, CodingKey {
-        case id, name, notes
-        case printerID = "printer_id"
-        case printerDisplayName = "printer_display_name"
-        case paperName = "paper_name"
-        case driverMediaType = "driver_media_type"
-        case inkSet = "ink_set"
-        case colourSpace = "colour_space"
-        case presetID = "preset_id"
-        case calibrationURL = "calibration_url"
-        case applyCalibration = "apply_calibration"
-        case created, updated
-    }
-
-    /// Strict decode: required identity + binding fields must be
-    /// present; optionals default. Unknown keys are ignored.
-    public init(from decoder: Decoder) throws {
-        let c = try decoder.container(keyedBy: CodingKeys.self)
-        id = try c.decode(String.self, forKey: .id)
-        name = try c.decode(String.self, forKey: .name)
-        notes = try c.decodeIfPresent(String.self, forKey: .notes) ?? ""
-        printerID = try c.decode(String.self, forKey: .printerID)
-        printerDisplayName = try c.decodeIfPresent(String.self, forKey: .printerDisplayName) ?? ""
-        paperName = try c.decodeIfPresent(String.self, forKey: .paperName) ?? ""
-        driverMediaType = try c.decodeIfPresent(String.self, forKey: .driverMediaType)
-        inkSet = try c.decodeIfPresent(String.self, forKey: .inkSet) ?? ""
-        colourSpace = try c.decode(String.self, forKey: .colourSpace)
-        presetID = try c.decode(String.self, forKey: .presetID)
-        calibrationURL = try c.decodeIfPresent(String.self, forKey: .calibrationURL)
-        applyCalibration = try c.decodeIfPresent(Bool.self, forKey: .applyCalibration) ?? false
-        created = try c.decodeIfPresent(Date.self, forKey: .created) ?? Date()
-        updated = try c.decodeIfPresent(Date.self, forKey: .updated) ?? Date()
-    }
-
-    public enum ValidationError: LocalizedError, Equatable {
-        case emptyName
-        case emptyPrinterID
-        case invalidColourSpace(String)
-        case emptyPresetID
-        case invalidCalibrationURL(String)
-
-        public var errorDescription: String? {
-            switch self {
-            case .emptyName: return "Media recipe is missing a name."
-            case .emptyPrinterID: return "Media recipe is missing a printer."
-            case .invalidColourSpace(let v):
-                return "colour_space must be \"rgb\" or \"cmyk\", got \"\(v)\"."
-            case .emptyPresetID: return "Media recipe is missing a preset."
-            case .invalidCalibrationURL(let v):
-                return "calibration_url must be an absolute path without \"..\" or NUL, got \"\(v)\"."
-            }
-        }
-    }
-
-    /// Validates the binding fields. `colourSpace` is normalized to
-    /// lowercase before comparison. `CAL_` cal names are **not**
-    /// rejected — that is an apply-time policy, not schema.
-    @discardableResult
-    public func validated() throws -> MediaRecipe {
-        var r = self
-        r.id = id.trimmingCharacters(in: .whitespacesAndNewlines)
-        r.name = name.trimmingCharacters(in: .whitespacesAndNewlines)
-        r.colourSpace = colourSpace.lowercased()
-        guard !r.name.isEmpty else { throw ValidationError.emptyName }
-        guard !r.printerID.isEmpty else { throw ValidationError.emptyPrinterID }
-        guard r.colourSpace == "rgb" || r.colourSpace == "cmyk" else {
-            throw ValidationError.invalidColourSpace(colourSpace)
-        }
-        guard !r.presetID.isEmpty else { throw ValidationError.emptyPresetID }
-        if let cal = r.calibrationURL, !cal.isEmpty {
-            guard cal.hasPrefix("/"), !cal.contains(".."), !cal.contains("\0") else {
-                throw ValidationError.invalidCalibrationURL(cal)
-            }
-        }
-        return r
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Library/ProjectReport.swift

@@ -1,95 +0,0 @@
-import Foundation
-
-/// `Save Report…` — a one-page UTF-8 Markdown summary written next to
-/// the artefacts as `{basename}-report.md` (issue #149). Generated
-/// output, safe to overwrite. Filenames only — never absolute paths —
-/// and no HTML.
-public enum ProjectReport {
-
-    /// `{cwd}/{basename}-report.md`.
-    public static func url(for project: ICCeryProject) -> URL {
-        URL(fileURLWithPath: project.cwd, isDirectory: true)
-            .appendingPathComponent("\(project.basename)-report.md")
-    }
-
-    /// Renders the report. `artefacts` is the live probe result so the
-    /// checklist shows what is actually on disk, not what the project
-    /// JSON claims (R18).
-    public static func markdown(
-        project: ICCeryProject,
-        recipeName: String?,
-        artefacts: StageArtefacts
-    ) -> String {
-        var lines: [String] = []
-        lines.append("# \(project.name)")
-        lines.append("")
-        if let printer = project.printerDisplayName ?? project.printerID,
-           !printer.isEmpty {
-            lines.append("- **Printer:** \(printer)")
-        }
-        if let recipeName, !recipeName.isEmpty {
-            lines.append("- **Media recipe:** \(recipeName)")
-        }
-        if let preset = project.presetID, !preset.isEmpty {
-            lines.append("- **Preset:** \(preset)")
-        }
-        lines.append("")
-
-        lines.append("## Artefacts")
-        lines.append("")
-        lines.append("| File | Status |")
-        lines.append("|------|--------|")
-        lines.append(row("\(project.basename).ti1", exists: artefacts.stage1Complete))
-        lines.append(row("\(project.basename).ti2", exists: artefacts.stage2Complete))
-        lines.append(row("\(project.basename).ti3", exists: artefacts.stage3Complete))
-        let profileName = artefacts.profilePath?.lastPathComponent
-            ?? "\(project.basename).\(ArtefactProbe.defaultProfileExtension)"
-        lines.append(row(profileName, exists: artefacts.stage4Complete))
-        if let gam = artefacts.gamPath {
-            lines.append(row(gam.lastPathComponent, exists: true))
-        }
-        lines.append("")
-
-        if let verification = project.lastVerification {
-            lines.append("## Last verification")
-            lines.append("")
-            lines.append(
-                "- avg ΔE₀₀ \(f(verification.avgDE00)), max ΔE₀₀ \(f(verification.maxDE00))"
-                    + " (\(verification.status))")
-            lines.append("- Profile: \(verification.profileFilename)")
-            lines.append("- Date: \(ISO8601DateFormatter().string(from: verification.date))")
-            lines.append("")
-        }
-
-        if !project.notes.isEmpty {
-            lines.append("## Notes")
-            lines.append("")
-            lines.append(project.notes)
-            lines.append("")
-        }
-        return lines.joined(separator: "\n")
-    }
-
-    /// Writes `{cwd}/{basename}-report.md` atomically, overwriting an
-    /// existing generated report.
-    @discardableResult
-    public static func write(
-        project: ICCeryProject,
-        recipeName: String?,
-        artefacts: StageArtefacts
-    ) throws -> URL {
-        let destination = url(for: project)
-        try AtomicFileWriter.write(
-            markdown(project: project, recipeName: recipeName, artefacts: artefacts),
-            to: destination)
-        return destination
-    }
-
-    private static func row(_ filename: String, exists: Bool) -> String {
-        "| \(filename) | \(exists ? "exists" : "missing") |"
-    }
-
-    private static func f(_ value: Double) -> String {
-        String(format: "%.2f", value)
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Library/RecentProjectsStore.swift

@@ -1,162 +0,0 @@
-import Foundation
-
-/// One row in `recent_projects.json` — bookmark `Data` *and* the plain
-/// absolute path so the entry still resolves when the bookmark can't.
-public struct RecentProjectEntry: Codable, Equatable, Sendable, Identifiable {
-    public var name: String
-    /// Absolute path to the `.icceryproj` file.
-    public var path: String
-    /// File bookmark; optional — path is the fallback.
-    public var bookmark: Data?
-    public var updated: Date
-
-    public var id: String { path }
-
-    /// Stable digest of `path` for `projectRecent-{hash}` menu ids —
-    /// FNV-1a 64, stable across launches unlike `hashValue`.
-    public var bookmarkHash: String {
-        var hash: UInt64 = 0xcbf29ce484222325
-        for byte in path.utf8 {
-            hash ^= UInt64(byte)
-            hash &*= 0x100000001b3
-        }
-        return String(hash, radix: 16)
-    }
-
-    public init(name: String, path: String, bookmark: Data? = nil, updated: Date = Date()) {
-        self.name = name
-        self.path = path
-        self.bookmark = bookmark
-        self.updated = updated
-    }
-
-    enum CodingKeys: String, CodingKey {
-        case name, path, bookmark, updated
-    }
-}
-
-/// Recent-projects list (issue #149). Lives in
-/// `AppPaths.appDataDir/recent_projects.json` — app data, never inside
-/// the project file (R12).
-///
-/// Cap 20, newest first, deduplicated by path. Entries whose file is
-/// gone are dropped by `pruneMissing()` (called when the Open Recent
-/// submenu builds). A corrupt file throws on load and is never
-/// overwritten — the view model shows an empty list and keeps the
-/// bytes (`.throwCorrupt`, R12).
-public actor RecentProjectsStore {
-
-    /// Default cap.
-    public static let defaultCapacity = 20
-
-    /// Path to the JSON store.
-    public let url: URL
-
-    /// In-memory cache, kept in sync with disk.
-    private var entries: [RecentProjectEntry] = []
-
-    /// Explicit load flag — an empty file is still "loaded".
-    private var loaded = false
-
-    private let capacity: Int
-    private let fileStore: JSONFileStore<[RecentProjectEntry]>
-    private let fileManager: FileManager
-
-    public init(
-        url: URL = AppPaths.appDataDir.appendingPathComponent("recent_projects.json"),
-        capacity: Int = defaultCapacity,
-        fileManager: FileManager = .default
-    ) {
-        self.url = url
-        self.capacity = capacity
-        self.fileManager = fileManager
-        self.fileStore = JSONFileStore(
-            fileURL: url,
-            corrupt: .throwCorrupt,
-            defaultValue: { [] },
-            dateEncoding: .iso8601,
-            dateDecoding: .iso8601
-        )
-    }
-
-    /// Loads entries from disk. Returns the existing cache if already
-    /// loaded. Throws when the file exists but cannot be parsed; the
-    /// existing file is never overwritten in that case.
-    public func load() throws -> [RecentProjectEntry] {
-        guard !loaded else { return entries }
-        guard fileManager.fileExists(atPath: url.path) else {
-            loaded = true
-            return []
-        }
-        entries = try fileStore.load()
-        loaded = true
-        return entries
-    }
-
-    /// Returns all cached entries, newest first.
-    public func all() -> [RecentProjectEntry] {
-        entries
-    }
-
-    /// Pushes a project to the front, deduplicating by path and
-    /// trimming to `capacity`. Writes atomically.
-    ///
-    /// Loads the existing list first and propagates any load error so
-    /// an unparseable file is never overwritten.
-    @discardableResult
-    public func add(url fileURL: URL, name: String) throws -> [RecentProjectEntry] {
-        try load()
-        let bookmark = try? fileURL.bookmarkData()
-        var updated = entries.filter { $0.path != fileURL.path }
-        updated.insert(
-            RecentProjectEntry(
-                name: name,
-                path: fileURL.path,
-                bookmark: bookmark,
-                updated: Date()),
-            at: 0)
-        if updated.count > capacity {
-            updated = Array(updated.prefix(capacity))
-        }
-        try fileStore.save(updated)
-        entries = updated
-        return updated
-    }
-
-    /// Removes an entry by path and writes atomically. Returns false
-    /// when no entry with that path exists.
-    @discardableResult
-    public func remove(path: String) throws -> Bool {
-        try load()
-        let before = entries.count
-        let updated = entries.filter { $0.path != path }
-        guard updated.count != before else { return false }
-        try fileStore.save(updated)
-        entries = updated
-        return true
-    }
-
-    /// `Clear Menu` — wipes the recents file only; `.icceryproj` files
-    /// are never deleted (R12).
-    public func clear() throws {
-        try load()
-        try fileStore.save([])
-        entries = []
-    }
-
-    /// Drops entries whose file is gone and rewrites the store.
-    /// Called when the Open Recent submenu builds — missing files are
-    /// dropped there, not at launch (issue #149).
-    @discardableResult
-    public func pruneMissing() throws -> [RecentProjectEntry] {
-        try load()
-        let kept = entries.filter {
-            fileManager.fileExists(atPath: $0.path)
-        }
-        if kept.count != entries.count {
-            try fileStore.save(kept)
-            entries = kept
-        }
-        return kept
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Measurement/ChartreadRow.swift

@@ -51,6 +51,58 @@ public struct PatchColor: Codable, Sendable, Equatable {
     }
 }
 
+public struct CIEXYZ: Codable, Sendable, Equatable {
+    public let x: Double
+    public let y: Double
+    public let z: Double
+
+    public init(from decoder: Decoder) throws {
+        var container = try decoder.unkeyedContainer()
+        self.x = try container.decode(Double.self)
+        self.y = try container.decode(Double.self)
+        self.z = try container.decode(Double.self)
+    }
+
+    public init(x: Double, y: Double, z: Double) {
+        self.x = x
+        self.y = y
+        self.z = z
+    }
+
+    public func encode(to encoder: Encoder) throws {
+        var container = encoder.unkeyedContainer()
+        try container.encode(x)
+        try container.encode(y)
+        try container.encode(z)
+    }
+}
+
+public struct CIELab: Codable, Sendable, Equatable {
+    public let l: Double
+    public let a: Double
+    public let b: Double
+
+    public init(from decoder: Decoder) throws {
+        var container = try decoder.unkeyedContainer()
+        self.l = try container.decode(Double.self)
+        self.a = try container.decode(Double.self)
+        self.b = try container.decode(Double.self)
+    }
+
+    public init(l: Double, a: Double, b: Double) {
+        self.l = l
+        self.a = a
+        self.b = b
+    }
+
+    public func encode(to encoder: Encoder) throws {
+        var container = encoder.unkeyedContainer()
+        try container.encode(l)
+        try container.encode(a)
+        try container.encode(b)
+    }
+}
+
 public struct SpectralData: Codable, Sendable, Equatable {
     public let bands: Int
     public let startNM: Double

Packages/ICCeryCore/Sources/ICCeryCore/Measurement/ColorDifference.swift

@@ -154,9 +154,11 @@ public enum ColorDifference {
 
     /// Resolve a Lab from a `PatchColor`, computing it from XYZ when Lab is absent.
     public static func resolveLab(_ color: PatchColor) -> LabColor? {
-        if let lab = color.lab { return lab }
+        if let lab = color.lab {
+            return LabColor(l: lab.l, a: lab.a, b: lab.b)
+        }
         guard let xyz = color.xyz else { return nil }
-        return LabColorMath.xyzToLab(xyz)
+        return LabColorMath.xyzToLab(XYZColor(x: xyz.x, y: xyz.y, z: xyz.z))
     }
 
     private static func atan2ToDegrees(_ y: Double, _ x: Double) -> Double {

Packages/ICCeryCore/Sources/ICCeryCore/Measurement/LabColor.swift

@@ -1,8 +1,7 @@
 import Foundation
 
 /// XYZ tristimulus values, stored in the 0–100 scale used by the Argyll fork.
-/// Unkeyed Codable matches `ROW_COLORS_JSON` `[x, y, z]`.
-public struct XYZColor: Codable, Sendable, Equatable {
+public struct XYZColor: Sendable, Equatable {
     public let x: Double
     public let y: Double
     public let z: Double
@@ -12,24 +11,10 @@ public struct XYZColor: Codable, Sendable, Equatable {
         self.y = y
         self.z = z
     }
-
-    public init(from decoder: Decoder) throws {
-        var container = try decoder.unkeyedContainer()
-        self.x = try container.decode(Double.self)
-        self.y = try container.decode(Double.self)
-        self.z = try container.decode(Double.self)
-    }
-
-    public func encode(to encoder: Encoder) throws {
-        var container = encoder.unkeyedContainer()
-        try container.encode(x)
-        try container.encode(y)
-        try container.encode(z)
-    }
 }
 
-/// CIELab value (D50). Unkeyed Codable matches `ROW_COLORS_JSON` `[L, a, b]`.
-public struct LabColor: Codable, Sendable, Equatable {
+/// CIELab value (D50).
+public struct LabColor: Sendable, Equatable {
     public let l: Double
     public let a: Double
     public let b: Double
@@ -39,26 +24,8 @@ public struct LabColor: Codable, Sendable, Equatable {
         self.a = a
         self.b = b
     }
-
-    public init(from decoder: Decoder) throws {
-        var container = try decoder.unkeyedContainer()
-        self.l = try container.decode(Double.self)
-        self.a = try container.decode(Double.self)
-        self.b = try container.decode(Double.self)
-    }
-
-    public func encode(to encoder: Encoder) throws {
-        var container = encoder.unkeyedContainer()
-        try container.encode(l)
-        try container.encode(a)
-        try container.encode(b)
-    }
 }
 
-/// JSON aliases used by `chartread` row payloads.
-public typealias CIEXYZ = XYZColor
-public typealias CIELab = LabColor
-
 /// sRGB colour in 0–1 display space.
 public struct DisplayRGB: Sendable, Equatable {
     public let r: Double

Packages/ICCeryCore/Sources/ICCeryCore/Measurement/SpotReadClassifier.swift

@@ -1,48 +0,0 @@
-import Foundation
-
-/// Line classifier for `spotread` stdout (issue #148).
-///
-/// `spotread` shares `chartread`'s white-tile calibration phrasing, so
-/// this wraps `ChartreadClassifier` and only intercepts the lines that
-/// would otherwise misclassify:
-///
-/// - `… and then hit any key to continue,` / `or hit Esc or Q to abort:`
-///   continuation lines that trail the calibration and spot prompts —
-///   sticky to the current prompt state instead of `PROMPT_CONTINUE`.
-/// - `Place instrument on a spot to be measured,` /
-///   `and hit a key to take a reading,` → `AWAITING_STRIP` (the Read
-///   prompt; the generic chartread matcher does not know "take a
-///   reading").
-///
-/// Sample lines (`Result is XYZ: …, D50 Lab: …`) are parsed by
-/// `SpotReadParser`, not classified here.
-public enum SpotReadClassifier {
-
-    public static func classify(
-        line: String,
-        previousState: ChartreadState
-    ) -> ChartreadClassifyResult {
-        let text = line.lowercased()
-
-        // Spot-read prompt continuations keep the current prompt state.
-        if previousState == .calibrating || previousState == .awaitingStrip {
-            if text.contains("hit any key")
-                || text.contains("hit space")
-                || text.contains("esc or")
-                || text.contains("abort")
-                || text.contains("to abort") {
-                return ChartreadClassifyResult(state: previousState)
-            }
-        }
-
-        // "Place instrument on a spot to be measured," /
-        // " and hit a key to take a reading," — the Read trigger prompt.
-        if text.contains("spot to be measured")
-            || text.contains("take a reading")
-            || text.contains("measure the spot") {
-            return ChartreadClassifyResult(state: .awaitingStrip)
-        }
-
-        return ChartreadClassifier.classify(line: line, previousState: previousState)
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Measurement/SpotReadSample.swift

@@ -1,80 +0,0 @@
-import Foundation
-
-/// One patch measurement emitted by a running `spotread` child (#148).
-public struct SpotReadSample: Codable, Sendable, Equatable, Identifiable {
-    public var id: UUID
-    public var timestamp: Date
-    /// D50 Lab (always present — derived from XYZ when needed).
-    public var lab: LabColor
-    /// XYZ on the 0–100 scale used by the fork, when the line carried it.
-    public var xyz: XYZColor?
-    public var instrumentName: String
-    public var port: Int?
-    /// Diagnostics only — never rendered as HTML or shown in the table.
-    public var rawLine: String
-
-    public init(
-        id: UUID = UUID(),
-        timestamp: Date = Date(),
-        lab: LabColor,
-        xyz: XYZColor? = nil,
-        instrumentName: String = "",
-        port: Int? = nil,
-        rawLine: String = ""
-    ) {
-        self.id = id
-        self.timestamp = timestamp
-        self.lab = lab
-        self.xyz = xyz
-        self.instrumentName = instrumentName
-        self.port = port
-        self.rawLine = rawLine
-    }
-}
-
-/// Parses `spotread` result lines into Lab / XYZ triples.
-///
-/// The fork's line shape is the upstream
-/// `Result is XYZ: <x> <y> <z>, D50 Lab: <L> <a> <b>`; a Lab-only line
-/// also parses, and an XYZ-only line derives Lab via
-/// `LabColorMath.xyzToLab` (D50).
-public enum SpotReadParser {
-
-    public static func parse(line: String) -> (xyz: XYZColor?, lab: LabColor)? {
-        guard line.range(of: "result is", options: .caseInsensitive) != nil
-            || line.range(of: #"\bLab\b"#, options: .regularExpression) != nil
-            || line.range(of: #"\bXYZ\b"#, options: .regularExpression) != nil
-        else { return nil }
-
-        var xyz: XYZColor?
-        var lab: LabColor?
-
-        if let m = triple(#"\bXYZ\b[:\s]"#, in: line) {
-            xyz = XYZColor(x: m.0, y: m.1, z: m.2)
-        }
-        if let m = triple(#"\bLab\b[:\s]"#, in: line) {
-            lab = LabColor(l: m.0, a: m.1, b: m.2)
-        }
-        if lab == nil, let xyz {
-            lab = LabColorMath.xyzToLab(xyz)
-        }
-        guard let lab else { return nil }
-        return (xyz, lab)
-    }
-
-    private static func triple(_ marker: String, in line: String) -> (Double, Double, Double)? {
-        let pattern = marker + #"\s*(-?\d+(?:\.\d+)?)\s+(-?\d+(?:\.\d+)?)\s+(-?\d+(?:\.\d+)?)"#
-        guard let regex = try? NSRegularExpression(pattern: pattern, options: .caseInsensitive),
-              let match = regex.firstMatch(
-                in: line, options: [], range: NSRange(line.startIndex..., in: line)),
-              match.numberOfRanges == 4,
-              let r1 = Range(match.range(at: 1), in: line),
-              let r2 = Range(match.range(at: 2), in: line),
-              let r3 = Range(match.range(at: 3), in: line),
-              let a = Double(line[r1]),
-              let b = Double(line[r2]),
-              let c = Double(line[r3])
-        else { return nil }
-        return (a, b, c)
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Process/ProcessID.swift

@@ -4,8 +4,6 @@ import Foundation
 /// filter events on `id` — historical bug #56 was an id mismatch.
 public enum ProcessID {
     public static let instlist = "instlist"
-    /// Spot-read console (issue #148) — single lease, like `instlist`.
-    public static let spotread = "spotread"
 
     public static func targen(_ basename: String) -> String { "targen_\(basename)" }
     public static func printtarg(_ basename: String) -> String { "printtarg_\(basename)" }

Packages/ICCeryCore/Sources/ICCeryCore/Process/ProcessManager.swift

@@ -136,26 +136,31 @@ public actor ProcessManager {
     ) throws {
         guard !isRunning(id) else { throw ProcessError.duplicateID(id) }
 
-        let prepared = makeProcess(
-            binary: binary,
-            arguments: arguments,
-            workingDirectory: workingDirectory,
-            environment: environment,
-            includeStdin: true
-        )
-        let process = prepared.process
+        let process = Process()
+        let stdinPipe = Pipe()
+        let stdoutPipe = Pipe()
+        let stderrPipe = Pipe()
+        process.executableURL = binary
+        process.arguments = arguments
+        process.currentDirectoryURL = workingDirectory
+        process.standardInput = stdinPipe
+        process.standardOutput = stdoutPipe
+        process.standardError = stderrPipe
+        process.environment = childEnvironment(extra: environment)
 
-        logSpawn(id: id, binary: binary, arguments: arguments, captured: false)
+        AppLogger(category: "process").debug(
+            "spawn \(id): \(binary.path) \(LogSanitizer.sanitizeArgs(arguments))"
+        )
 
         children[id] = RunningChild(
             process: process,
-            stdin: prepared.stdinPipe?.fileHandleForWriting,
+            stdin: stdinPipe.fileHandleForWriting,
             stdoutDecoder: ProcessLineDecoder(),
             stderrDecoder: ProcessLineDecoder()
         )
 
-        let stdoutHandle = prepared.stdoutPipe.fileHandleForReading
-        let stderrHandle = prepared.stderrPipe.fileHandleForReading
+        let stdoutHandle = stdoutPipe.fileHandleForReading
+        let stderrHandle = stderrPipe.fileHandleForReading
         stdoutHandle.readabilityHandler = { [weak self] handle in
             let data = handle.availableData
             guard let self else { return }
@@ -167,23 +172,27 @@ public actor ProcessManager {
             Task { await self.ingestOutput(data, id: id, isStderr: true, handle: handle) }
         }
 
-        attachTerminationHandler(process) { [weak self] code in
+        process.terminationHandler = { [weak self] proc in
             guard let self else { return }
-            Task { await self.didTerminate(id: id, code: code) }
+            Task { await self.didTerminate(id: id, code: proc.terminationStatus) }
         }
 
         do {
             try process.run()
+            // Fallback watchdog: very fast child exits can race past the
+            // terminationHandler delivery on a loaded host. waitUntilExit()
+            // blocks the detached thread and guarantees didTerminate runs.
+            Task.detached { [weak self, process] in
+                process.waitUntilExit()
+                guard let self else { return }
+                await self.didTerminate(id: id, code: process.terminationStatus)
+            }
         } catch {
             preKillHooks.removeValue(forKey: id)
             children.removeValue(forKey: id)
             emit(.error(id: id, message: error.localizedDescription))
             throw ProcessError.spawnFailed("\(binary.path): \(error.localizedDescription)")
         }
-        startWaitUntilExitWatchdog(process) { [weak self] code in
-            guard let self else { return }
-            Task { await self.didTerminate(id: id, code: code) }
-        }
     }
 
     // MARK: - Spawn (captured)
@@ -201,18 +210,19 @@ public actor ProcessManager {
     ) async throws -> CapturedResult {
         guard !isRunning(id) else { throw ProcessError.duplicateID(id) }
 
-        let prepared = makeProcess(
-            binary: binary,
-            arguments: arguments,
-            workingDirectory: workingDirectory,
-            environment: environment,
-            includeStdin: false
-        )
-        let process = prepared.process
-        let stdoutPipe = prepared.stdoutPipe
-        let stderrPipe = prepared.stderrPipe
+        let process = Process()
+        let stdoutPipe = Pipe()
+        let stderrPipe = Pipe()
+        process.executableURL = binary
+        process.arguments = arguments
+        process.currentDirectoryURL = workingDirectory
+        process.standardOutput = stdoutPipe
+        process.standardError = stderrPipe
+        process.environment = childEnvironment(extra: environment)
 
-        logSpawn(id: id, binary: binary, arguments: arguments, captured: true)
+        AppLogger(category: "process").debug(
+            "spawn(captured) \(id): \(binary.path) \(LogSanitizer.sanitizeArgs(arguments))"
+        )
 
         // Register and set up the termination hand-off before run() so
         // a very fast exit is never missed (#50, #52).
@@ -265,12 +275,20 @@ public actor ProcessManager {
             }
         }
         let box = Box()
-        attachTerminationHandler(capturedProcess) { status in
-            _ = box.resume(with: status)
+        capturedProcess.terminationHandler = { proc in
+            _ = box.resume(with: proc.terminationStatus)
         }
 
         do {
             try process.run()
+            // Fallback watchdog: very fast child exits can race past the
+            // terminationHandler delivery on a loaded host. waitUntilExit()
+            // blocks the detached thread and resumes the box if the handler
+            // did not already do so (#50, #52).
+            Task.detached { [capturedProcess] in
+                capturedProcess.waitUntilExit()
+                _ = box.resume(with: capturedProcess.terminationStatus)
+            }
         } catch {
             _ = box.resume(with: -1)
             captured.removeValue(forKey: id)
@@ -278,9 +296,6 @@ public actor ProcessManager {
             emit(.error(id: id, message: error.localizedDescription))
             throw ProcessError.spawnFailed("\(binary.path): \(error.localizedDescription)")
         }
-        startWaitUntilExitWatchdog(capturedProcess) { status in
-            _ = box.resume(with: status)
-        }
 
         // Close the parent write ends so readDataToEndOfFile() gets EOF
         // as soon as the child exits; the child still has its own copies.
@@ -356,7 +371,12 @@ public actor ProcessManager {
         guard var child = children[id], !child.finalized else { return }
 
         if let tail = child.stdoutDecoder.flushPartial() {
-            emitStdoutLine(id: id, line: tail)
+            if tail.hasPrefix(Self.rowColorsPrefix) {
+                let payload = Data(tail.dropFirst(Self.rowColorsPrefix.count).utf8)
+                emit(.jsonRow(id: id, payload: payload))
+            } else {
+                emit(.stdout(id: id, line: tail))
+            }
         }
         if let tail = child.stderrDecoder.flushPartial() {
             emit(.stderr(id: id, line: tail))
@@ -427,86 +447,6 @@ public actor ProcessManager {
 
     // MARK: - Internals
 
-    private struct PreparedProcess {
-        let process: Process
-        let stdinPipe: Pipe?
-        let stdoutPipe: Pipe
-        let stderrPipe: Pipe
-    }
-
-    private func makeProcess(
-        binary: URL,
-        arguments: [String],
-        workingDirectory: URL?,
-        environment: [String: String],
-        includeStdin: Bool
-    ) -> PreparedProcess {
-        let process = Process()
-        let stdoutPipe = Pipe()
-        let stderrPipe = Pipe()
-        let stdinPipe: Pipe? = includeStdin ? Pipe() : nil
-        process.executableURL = binary
-        process.arguments = arguments
-        process.currentDirectoryURL = workingDirectory
-        process.standardOutput = stdoutPipe
-        process.standardError = stderrPipe
-        if let stdinPipe {
-            process.standardInput = stdinPipe
-        }
-        process.environment = childEnvironment(extra: environment)
-        return PreparedProcess(
-            process: process,
-            stdinPipe: stdinPipe,
-            stdoutPipe: stdoutPipe,
-            stderrPipe: stderrPipe
-        )
-    }
-
-    private nonisolated func logSpawn(
-        id: String,
-        binary: URL,
-        arguments: [String],
-        captured: Bool
-    ) {
-        let prefix = captured ? "spawn(captured)" : "spawn"
-        AppLogger(category: "process").debug(
-            "\(prefix) \(id): \(binary.path) \(LogSanitizer.sanitizeArgs(arguments))"
-        )
-    }
-
-    /// `terminationHandler` can lose a fast-exit race on a loaded host;
-    /// `waitUntilExit` on a detached thread is the fallback (#50, #52).
-    /// The handler is attached before `run()`; the wait thread starts
-    /// only after a successful launch — `terminationStatus` on an
-    /// unlaunched NSTask raises NSInvalidArgumentException.
-    private func attachTerminationHandler(
-        _ process: Process,
-        onExit: @escaping @Sendable (Int32) -> Void
-    ) {
-        process.terminationHandler = { proc in
-            onExit(proc.terminationStatus)
-        }
-    }
-
-    private func startWaitUntilExitWatchdog(
-        _ process: Process,
-        onExit: @escaping @Sendable (Int32) -> Void
-    ) {
-        Task.detached { [process] in
-            process.waitUntilExit()
-            onExit(process.terminationStatus)
-        }
-    }
-
-    private func emitStdoutLine(id: String, line: String) {
-        if line.hasPrefix(Self.rowColorsPrefix) {
-            let payload = Data(line.dropFirst(Self.rowColorsPrefix.count).utf8)
-            emit(.jsonRow(id: id, payload: payload))
-        } else {
-            emit(.stdout(id: id, line: line))
-        }
-    }
-
     private func childEnvironment(extra: [String: String]) -> [String: String] {
         var env = ProcessInfo.processInfo.environment
         env["ARGYLL_NOT_INTERACTIVE"] = "1"
@@ -538,14 +478,15 @@ public actor ProcessManager {
 
         let log = AppLogger(category: "subprocess")
         for line in lines {
-            if !isStderr {
-                emitStdoutLine(id: id, line: line)
-                if !line.hasPrefix(Self.rowColorsPrefix) {
-                    log.info("[\(id)] \(line)")
-                }
-            } else {
+            if !isStderr, line.hasPrefix(Self.rowColorsPrefix) {
+                let payload = Data(line.dropFirst(Self.rowColorsPrefix.count).utf8)
+                emit(.jsonRow(id: id, payload: payload))
+            } else if isStderr {
                 log.warn("[\(id)] \(line)")
                 emit(.stderr(id: id, line: line))
+            } else {
+                log.info("[\(id)] \(line)")
+                emit(.stdout(id: id, line: line))
             }
         }
     }
@@ -559,7 +500,7 @@ public actor ProcessManager {
         // Start a watchdog in case the `readabilityHandler` EOFs never
         // arrive after the process exits (e.g. a hung pipe).
         child.finalizeTask = Task { [weak self] in
-            try? await Task.sleep(nanoseconds: 2_000_000_000)
+            try? await Task.sleep(for: .seconds(2))
             guard let self else { return }
             await self.forceKill(id: id)
             await self.forceFinalize(id: id)
@@ -587,7 +528,11 @@ public actor ProcessManager {
         // Flush unterminated tail lines.
         if var decoder = Optional(child.stdoutDecoder),
            let tail = decoder.finish() {
-            emitStdoutLine(id: id, line: tail)
+            if tail.hasPrefix(Self.rowColorsPrefix) {
+                emit(.jsonRow(id: id, payload: Data(tail.dropFirst(Self.rowColorsPrefix.count).utf8)))
+            } else {
+                emit(.stdout(id: id, line: tail))
+            }
         }
         if var decoder = Optional(child.stderrDecoder),
            let tail = decoder.finish() {

Packages/ICCeryCore/Sources/ICCeryCore/Profile/CalibrationIdentity.swift

@@ -1,54 +0,0 @@
-import Foundation
-
-/// Canonical `CAL_` / original-stem pairing for Stage 0 (issue #29 / #83).
-///
-/// The live wizard basename, the persisted `calibrationOriginalBasename`,
-/// and the runner all derive identity from this type. Do not add a second
-/// `hasPrefix("CAL_")` ternary elsewhere.
-public struct CalibrationIdentity: Equatable, Sendable {
-    /// Never has a `CAL_` prefix. Empty only when the live basename is empty.
-    public var originalBasename: String
-    /// Always `CAL_{original}` when original is non-empty.
-    public var calibrationBasename: String
-
-    public init(originalBasename: String, calibrationBasename: String) {
-        self.originalBasename = originalBasename
-        self.calibrationBasename = calibrationBasename
-    }
-
-    public static func isCalibration(_ basename: String) -> Bool {
-        basename.hasPrefix("CAL_")
-    }
-
-    /// The only place that adds a `CAL_` prefix.
-    public static func prefix(_ original: String) -> String {
-        if original.isEmpty { return original }
-        return original.hasPrefix("CAL_") ? original : "CAL_\(original)"
-    }
-
-    /// Strip a single leading `CAL_` if present.
-    public static func strip(_ basename: String) -> String {
-        basename.hasPrefix("CAL_") ? String(basename.dropFirst(4)) : basename
-    }
-
-    /// Derive identity from the live wizard basename and the persisted
-    /// original. A non-empty persisted original wins over a `CAL_` live
-    /// name (Force Quit mid-calibration). An empty live basename always
-    /// produces an empty identity — a persisted original must never
-    /// resurrect a target that no longer exists (#83).
-    public static func parse(liveBasename: String, persistedOriginal: String) -> CalibrationIdentity {
-        guard !liveBasename.isEmpty else {
-            return CalibrationIdentity(originalBasename: "", calibrationBasename: "")
-        }
-        let original: String
-        if liveBasename.hasPrefix("CAL_") {
-            original = persistedOriginal.isEmpty ? strip(liveBasename) : persistedOriginal
-        } else {
-            original = liveBasename
-        }
-        return CalibrationIdentity(
-            originalBasename: original,
-            calibrationBasename: prefix(original)
-        )
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Profile/CalibrationTargenArgs.swift

@@ -86,7 +86,7 @@ public enum CalibrationTargenArgs {
             args.append(contentsOf: ["-l", "\(inkLimit)"])
         }
 
-        let calBasename = CalibrationIdentity.prefix(cleanBasename)
+        let calBasename = cleanBasename.hasPrefix("CAL_") ? cleanBasename : "CAL_\(cleanBasename)"
         args.append(calBasename)
         return args
     }

Packages/ICCeryCore/Sources/ICCeryCore/Profile/ColprofArgs.swift

@@ -26,13 +26,18 @@ public enum ColprofArgs {
         let cleanBasename = try PathSecurity.sanitizeBasename(config.basename)
 
         var args: [String] = ["-v"]
+
         args.append(contentsOf: ["-a", config.algorithm])
         args.append(contentsOf: ["-q", config.quality])
-        args.append(contentsOf: ArgsBuilder.optionIfNonEmpty("-t", config.intent))
+
+        if let intent = config.intent?.trimmingCharacters(in: .whitespaces), !intent.isEmpty {
+            args.append(contentsOf: ["-t", intent])
+        }
 
         if let fwa = config.fwa?.trimmingCharacters(in: .whitespaces) {
             switch fwa.lowercased() {
             case "none", "":
+                // "none" omits the flag; an explicit empty string means bare -f.
                 if fwa.isEmpty {
                     args.append("-f")
                 }
@@ -41,20 +46,32 @@ public enum ColprofArgs {
             }
         }
 
-        args.append(contentsOf: ArgsBuilder.optionIfNonEmpty("-i", config.illuminant))
-        args.append(contentsOf: ArgsBuilder.optionIfNonEmpty("-o", config.observer))
+        if let illuminant = config.illuminant?.trimmingCharacters(in: .whitespaces), !illuminant.isEmpty {
+            args.append(contentsOf: ["-i", illuminant])
+        }
+
+        if let observer = config.observer?.trimmingCharacters(in: .whitespaces), !observer.isEmpty {
+            args.append(contentsOf: ["-o", observer])
+        }
 
         if let inputCond = config.inputViewingCond?.trimmingCharacters(in: .whitespaces),
            !inputCond.isEmpty, inputCond.lowercased() != "none" {
             args.append(contentsOf: ["-c", inputCond])
         }
+
         if let outputCond = config.outputViewingCond?.trimmingCharacters(in: .whitespaces),
            !outputCond.isEmpty, outputCond.lowercased() != "none" {
             args.append(contentsOf: ["-d", outputCond])
         }
 
-        args.append(contentsOf: ArgsBuilder.optionIfNonEmpty("-D", config.description))
-        args.append(contentsOf: ArgsBuilder.optionIfNonEmpty("-C", config.copyright))
+        let profileDescription = config.description?.trimmingCharacters(in: .whitespaces)
+        if let description = profileDescription, !description.isEmpty {
+            args.append(contentsOf: ["-D", description])
+        }
+
+        if let copyright = config.copyright?.trimmingCharacters(in: .whitespaces), !copyright.isEmpty {
+            args.append(contentsOf: ["-C", copyright])
+        }
 
         args.append(cleanBasename)
         return args

Packages/ICCeryCore/Sources/ICCeryCore/Profile/PrintcalArgs.swift

@@ -79,9 +79,16 @@ public enum PrintcalArgs {
 
         var args: [String] = ["-v", "-e"]
 
-        args.append(contentsOf: ArgsBuilder.flag("-I", when: config.noInkLimit))
-        args.append(contentsOf: ArgsBuilder.flag("-z", when: config.verify))
-        args.append(contentsOf: ArgsBuilder.optionIfNonEmpty("-a", config.previousCalPath))
+        if config.noInkLimit {
+            args.append("-I")
+        }
+        if config.verify {
+            args.append("-z")
+        }
+        if let previous = config.previousCalPath?.trimmingCharacters(in: .whitespacesAndNewlines),
+           !previous.isEmpty {
+            args.append(contentsOf: ["-a", previous])
+        }
         if let tac = config.totalInkLimit, tac > 0 {
             args.append(contentsOf: ["-m", String(format: "%.1f", tac)])
         } else if let tac = config.totalInkLimit {
@@ -100,7 +107,7 @@ public enum PrintcalArgs {
         }
         args.append(contentsOf: ["-o", config.outputURL.path])
 
-        let calBasename = CalibrationIdentity.prefix(cleanBasename)
+        let calBasename = cleanBasename.hasPrefix("CAL_") ? cleanBasename : "CAL_\(cleanBasename)"
         args.append(calBasename)
         return args
     }

Packages/ICCeryCore/Sources/ICCeryCore/Profile/VerificationHistoryStore.swift

@@ -13,7 +13,8 @@ public actor VerificationHistoryStore {
     private var records: [VerificationRecord] = []
 
     private let capacity: Int
-    private let fileStore: JSONFileStore<[VerificationRecord]>
+    private let encoder: JSONEncoder
+    private let decoder: JSONDecoder
 
     public init(
         url: URL = AppPaths.appDataDir.appendingPathComponent("verification_history.json"),
@@ -21,13 +22,13 @@ public actor VerificationHistoryStore {
     ) {
         self.url = url
         self.capacity = capacity
-        self.fileStore = JSONFileStore(
-            fileURL: url,
-            corrupt: .throwCorrupt,
-            defaultValue: { [] },
-            dateEncoding: .iso8601,
-            dateDecoding: .iso8601
-        )
+
+        self.encoder = JSONEncoder()
+        self.encoder.dateEncodingStrategy = .iso8601
+        self.encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
+
+        self.decoder = JSONDecoder()
+        self.decoder.dateDecodingStrategy = .iso8601
     }
 
     /// Loads records from disk. Returns the existing cache if already loaded.
@@ -36,8 +37,10 @@ public actor VerificationHistoryStore {
     /// is never overwritten in that case.
     public func load() throws -> [VerificationRecord] {
         guard records.isEmpty else { return records }
-        guard FileManager.default.fileExists(atPath: url.path) else { return [] }
-        records = try fileStore.load()
+        let fm = FileManager.default
+        guard fm.fileExists(atPath: url.path),
+              let data = try? Data(contentsOf: url) else { return [] }
+        records = try decoder.decode([VerificationRecord].self, from: data)
         return records
     }
 
@@ -73,11 +76,7 @@ public actor VerificationHistoryStore {
     }
 
     /// Removes all history and updates disk.
-    ///
-    /// Loads the existing history first and propagates any load error so an
-    /// unparseable file is never overwritten.
     public func clear() throws {
-        try load()
         try write([])
         records = []
     }
@@ -107,7 +106,8 @@ public actor VerificationHistoryStore {
 
     /// Writes `records` through a temp file and rename.
     private func write(_ records: [VerificationRecord]) throws {
-        try fileStore.save(records)
+        let data = try encoder.encode(records)
+        try AtomicFileWriter.write(data, to: url)
     }
 
     private func csvRow(_ fields: [String]) -> String {

Packages/ICCeryCore/Sources/ICCeryCore/Settings/PresetMapping.swift

@@ -1,225 +0,0 @@
-import Foundation
-
-extension TargenConfig {
-    /// Stage 1 fields of a profiling preset. Optional advanced flags stay
-    /// `nil` when the preset omitted them so argv builders skip the flag.
-    public init(preset: ProfilingPreset, basename: String, workingDirectory: URL?) {
-        self.init(
-            colourSpace: preset.colourSpace.lowercased() == "cmyk" ? .cmyk : .rgb,
-            patchCount: preset.patchCount,
-            whitePatches: preset.whitePatches,
-            blackPatches: preset.blackPatches,
-            greySteps: preset.greySteps,
-            singleChannelSteps: preset.singleChannelSteps,
-            neutralSteps: preset.neutralSteps,
-            neutralConcentration: preset.neutralConcentration,
-            preconditioningProfile: preset.preconditioningProfile,
-            // An explicit `false` is preserved — distinguishable from a
-            // missing key; `-G` is only emitted for `true` (#82).
-            ofpsHighQuality: preset.ofpsHighQuality,
-            ofpsAdaptation: preset.ofpsAdaptation,
-            fullSpreadAlgorithm: preset.fullSpreadAlgorithm.flatMap { FullSpreadAlgorithm(presetValue: $0) }.flatMap { $0 == .ofps ? nil : $0 },
-            totalInkLimit: preset.totalInkLimit,
-            darkEmphasis: preset.darkEmphasis,
-            devicePower: preset.devicePower,
-            basename: basename,
-            workingDirectory: workingDirectory
-        )
-    }
-}
-
-extension PrinttargConfig {
-    public init(
-        preset: ProfilingPreset,
-        basename: String,
-        workingDirectory: URL?,
-        calibrationFile: String?,
-        label: String? = nil
-    ) {
-        let page: PageSize
-        let customW: Double
-        let customH: Double
-        if let size = PageSize(rawValue: preset.pageSize) {
-            page = size
-            customW = 210
-            customH = 297
-        } else if let (w, h) = PageSize.parseCustom(preset.pageSize) {
-            page = .custom
-            customW = w
-            customH = h
-        } else {
-            page = .a4
-            customW = 210
-            customH = 297
-        }
-
-        let layout: LayoutOrder
-        let seed = preset.randomSeed ?? 1
-        if preset.noRandomize == true {
-            layout = .raster
-        } else if seed == 1 {
-            layout = .deterministic
-        } else {
-            layout = .customSeed
-        }
-
-        self.init(
-            instrument: PrintInstrument(rawValue: preset.instrument) ?? .i1,
-            pageSize: page,
-            customPageWidth: customW,
-            customPageHeight: customH,
-            bitDepth: preset.bitDepth == 16 ? .sixteen : .eight,
-            dpi: preset.dpi,
-            layoutOrder: layout,
-            customSeed: seed,
-            label: label,
-            calibrationFile: calibrationFile,
-            calibrationEmbedOnly: false,
-            basename: basename,
-            workingDirectory: workingDirectory
-        )
-    }
-}
-
-extension ColprofConfig {
-    public init(
-        preset: ProfilingPreset,
-        basename: String,
-        workingDirectory: URL?,
-        description: String? = nil,
-        copyright: String? = nil
-    ) {
-        self.init(
-            algorithm: preset.colprofAlgorithm ?? "l",
-            quality: preset.colprofQuality ?? "m",
-            intent: Self.nilIfEmpty(preset.colprofIntent),
-            fwa: preset.colprofFwa,
-            illuminant: Self.nilIfEmpty(preset.colprofIlluminant),
-            observer: Self.nilIfEmpty(preset.colprofObserver),
-            inputViewingCond: Self.nilIfEmpty(preset.colprofInputViewingCond),
-            outputViewingCond: Self.nilIfEmpty(preset.colprofOutputViewingCond),
-            description: description,
-            copyright: copyright,
-            basename: basename,
-            workingDirectory: workingDirectory
-        )
-    }
-
-    private static func nilIfEmpty(_ value: String?) -> String? {
-        guard let value, !value.isEmpty else { return nil }
-        return value
-    }
-}
-
-/// User-facing FWA selection for the Stage 4 form, plus the two
-/// directions of `colprof_fwa` conversion centralised here so the view
-/// models carry no mapping switches of their own (#82).
-public enum ColprofFwaSelection: String, CaseIterable, Sendable, Equatable {
-    case none = "none"
-    case empty = ""
-    case D50 = "D50"
-    case D65 = "D65"
-    case custom = "custom"
-
-    public var displayName: String {
-        switch self {
-        case .none: return "None"
-        case .empty: return "Bare (-f)"
-        case .D50: return "D50"
-        case .D65: return "D65"
-        case .custom: return "Custom .sp"
-        }
-    }
-
-    /// Preset `colprof_fwa` → selection. `nil`/`"none"` map to `.none`,
-    /// `""` to `.empty`, `D50`/`D65` case-insensitively, and any other
-    /// string is a custom `.sp` path.
-    public init(presetValue: String?) {
-        switch presetValue?.lowercased() {
-        case nil, "none": self = .none
-        case "": self = .empty
-        case "d50": self = .D50
-        case "d65": self = .D65
-        default: self = .custom
-        }
-    }
-
-    /// Selection → `colprof_fwa` value. `.custom` returns `customPath`.
-    public func presetValue(customPath: String) -> String? {
-        switch self {
-        case .none: return nil
-        case .empty: return ""
-        case .D50: return "D50"
-        case .D65: return "D65"
-        case .custom: return customPath
-        }
-    }
-}
-
-extension PageSize {
-    /// `"210x297"` custom page parse used by presets (issue #82).
-    public static func parseCustom(_ raw: String) -> (Double, Double)? {
-        let parts = raw.lowercased().split(separator: "x")
-        guard parts.count == 2,
-              let w = Double(parts[0]), let h = Double(parts[1]),
-              w >= 50, h >= 50 else { return nil }
-        return (w, h)
-    }
-}
-
-extension ProfilingPreset {
-    /// Snapshot of the three live configs plus calibration toggles.
-    public init(
-        id: String,
-        name: String,
-        description: String,
-        targen: TargenConfig,
-        printtarg: PrinttargConfig,
-        colprof: ColprofConfig,
-        calibrationFile: String?,
-        applyCalibration: Bool?
-    ) {
-        let pageSize: String
-        if printtarg.pageSize == .custom {
-            pageSize = "\(Int(printtarg.customPageWidth))x\(Int(printtarg.customPageHeight))"
-        } else {
-            pageSize = printtarg.pageSize.rawValue
-        }
-        self.init(
-            id: id,
-            name: name,
-            description: description,
-            colourSpace: targen.colourSpace == .cmyk ? "cmyk" : "rgb",
-            patchCount: targen.patchCount,
-            whitePatches: targen.whitePatches,
-            blackPatches: targen.blackPatches,
-            greySteps: targen.greySteps,
-            singleChannelSteps: targen.singleChannelSteps,
-            neutralSteps: targen.neutralSteps,
-            neutralConcentration: targen.neutralConcentration,
-            preconditioningProfile: targen.preconditioningProfile,
-            ofpsHighQuality: targen.ofpsHighQuality,
-            ofpsAdaptation: targen.ofpsAdaptation,
-            fullSpreadAlgorithm: (targen.fullSpreadAlgorithm ?? .ofps).presetValue,
-            totalInkLimit: targen.totalInkLimit,
-            darkEmphasis: targen.darkEmphasis,
-            devicePower: targen.devicePower,
-            instrument: printtarg.instrument.rawValue,
-            pageSize: pageSize,
-            bitDepth: printtarg.bitDepth.rawValue,
-            dpi: printtarg.dpi,
-            randomSeed: printtarg.layoutOrder == .deterministic ? 1 : printtarg.customSeed,
-            noRandomize: printtarg.layoutOrder == .raster,
-            calibrationFile: calibrationFile,
-            applyCalibration: applyCalibration,
-            colprofAlgorithm: colprof.algorithm,
-            colprofQuality: colprof.quality,
-            colprofIntent: colprof.intent,
-            colprofFwa: colprof.fwa,
-            colprofIlluminant: colprof.illuminant,
-            colprofObserver: colprof.observer,
-            colprofInputViewingCond: colprof.inputViewingCond,
-            colprofOutputViewingCond: colprof.outputViewingCond
-        )
-    }
-}

Packages/ICCeryCore/Sources/ICCeryCore/Settings/PresetStore.swift

@@ -60,7 +60,9 @@ public final class PresetStore: Sendable {
 
     /// Single-preset pretty JSON export.
     public func export(_ preset: ProfilingPreset) throws -> Data {
-        return try JSONEncoder.icceryPretty().encode(preset)
+        let encoder = JSONEncoder()
+        encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
+        return try encoder.encode(preset)
     }
 
     /// Parses + validates a preset from JSON. The preset is assigned a

Packages/ICCeryCore/Sources/ICCeryCore/Settings/SettingsStore.swift

@@ -4,8 +4,8 @@ import Foundation
 /// `~/Library/Application Support/com.gronod.iccery2/settings.json`
 /// (issue #5 — the v1 path is never read).
 ///
-/// Writes are atomic (`JSONFileStore` → `AtomicFileWriter`). Invalid/corrupt
-/// JSON falls back to defaults. Saving posts `settingsDidChange` so #20 can
+/// Writes are atomic (`AtomicFileWriter`). Invalid/corrupt JSON falls
+/// back to defaults. Saving posts `settingsDidChange` so #20 can
 /// reclassify swatches.
 public final class SettingsStore: Sendable {
 
@@ -14,19 +14,18 @@ public final class SettingsStore: Sendable {
         Notification.Name("com.gronod.iccery2.settingsDidChange")
 
     public let fileURL: URL
-    private let store: JSONFileStore<AppSettings>
 
     public init(fileURL: URL = AppPaths.appDataDir.appendingPathComponent("settings.json")) {
         self.fileURL = fileURL
-        self.store = JSONFileStore(
-            fileURL: fileURL,
-            corrupt: .replaceWithDefault,
-            defaultValue: { .default }
-        )
     }
 
     public func load() -> AppSettings {
-        (try? store.load()) ?? .default
+        guard let data = try? Data(contentsOf: fileURL),
+              let settings = try? JSONDecoder().decode(AppSettings.self, from: data)
+        else {
+            return .default
+        }
+        return settings
     }
 
     /// Validates before persisting — throws `SettingsError` listing
@@ -36,7 +35,9 @@ public final class SettingsStore: Sendable {
         guard errors.isEmpty else {
             throw SettingsError.validationFailed(errors)
         }
-        try store.save(settings)
+        let encoder = JSONEncoder()
+        encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
+        try AtomicFileWriter.write(encoder.encode(settings), to: fileURL)
         NotificationCenter.default.post(name: Self.settingsDidChange, object: nil)
     }
 

Packages/ICCeryCore/Sources/ICCeryCore/Wizard/WizardState.swift

@@ -74,24 +74,23 @@ public struct WizardState: Codable, Equatable, Sendable {
 /// Atomic JSON persistence for `WizardState` (issue #4).
 public final class WizardStateStore: Sendable {
     public let fileURL: URL
-    private let store: JSONFileStore<WizardState>
 
     public init(
         fileURL: URL = AppPaths.appDataDir.appendingPathComponent("wizard_state.json")
     ) {
         self.fileURL = fileURL
-        self.store = JSONFileStore(
-            fileURL: fileURL,
-            corrupt: .replaceWithDefault,
-            defaultValue: { .default }
-        )
     }
 
     public func load() -> WizardState {
-        (try? store.load()) ?? .default
+        guard let data = try? Data(contentsOf: fileURL),
+              let state = try? JSONDecoder().decode(WizardState.self, from: data)
+        else { return .default }
+        return state
     }
 
     public func save(_ state: WizardState) throws {
-        try store.save(state)
+        let encoder = JSONEncoder()
+        encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
+        try AtomicFileWriter.write(encoder.encode(state), to: fileURL)
     }
 }

README.md

@@ -1,76 +1,42 @@
 # ICCery
 
-Native macOS frontend for printer ICC/ICM profiling. ICCery walks a user from
-chart generation through measurement, `colprof`, verification, and ColorSync
-install. It is **not** a colour engine.
+Native macOS frontend for printer ICC/ICM profiling. ICCery walks a user from chart generation through measurement, `colprof`, verification, and ColorSync install. It is **not** a colour engine.
 
-**End-user guide:** the [repository wiki](https://git.i3omb.com/gronod/iccery-v2-mac/wiki)
-covers every screen (Getting Started through Troubleshooting). This README is
-for building, packaging, and contributing.
-
-All measurement, chart generation, and profile mathematics live in the
-[Gronod ArgyllCMS 3.5.0 fork](https://git.i3omb.com/gronod/argyllcms), spawned
-as AGPLv3 child processes. The GUI never `dlopen`s or links Argyll.
+All measurement, chart generation, and profile mathematics live in the [Gronod ArgyllCMS 3.5.0 fork](https://git.i3omb.com/gronod/argyllcms), spawned as AGPLv3 child processes. The GUI never `dlopen`s or links Argyll.
 
 | | |
 |---|---|
 | Product | ICCery v2 for macOS |
 | Bundle | `com.gronod.iccery2` |
-| Version | 2.0.0 |
-| Floor | macOS 12.0 Monterey, universal `arm64` + `x86_64` |
-| Toolchain | Xcode 14.2 / Swift 5.7 (project `SWIFT_VERSION` is 5.0) |
-| CI | Gitea Actions `macos-12` runner |
+| Floor | macOS 14 Sonoma, universal `arm64` + `x86_64` |
 | Default branch | `develop` |
-| M6 | Stage 0 calibration, CGATS import, SceneKit gamut viewer, packaging — shipped |
-| M7 | Pre-UAT hardening — shipped |
-| M8 | Deduplication contracts & UAT-ready hardening (#79–#86) — shipped |
-| M9 | macOS 12 / Xcode 14.2 retarget (PR #145) — shipped |
-| M10 | Studio workflow: media library (#146), gamut compare (#147), Spot Read (#148), project files (#149) — shipped on `develop` |
-| M11 | Printer settings completeness & dialog binding (#183, #180, #181, #186) — in flight on `milestone/m11-print-settings` |
+| M6 | Stage 0 calibration, CGATS import, SceneKit gamut viewer, packaging — shipped on `develop` |
+| M7 | UAT-ready hardening of the v2.0 wizard paths |
 | Licence | Proprietary source in [`LICENCE.md`](LICENCE.md); bundled Argyll sidecars remain AGPLv3 |
 
 ## What it does
 
 The wizard is artefact-gated:
 
-1. **Stage 1** — `targen` → `.ti1`
-2. **Stage 2** — `printtarg` → `.ti2` + TIFF, unmanaged `lp` spool, bound `NSPrintPanel`
-3. **Stage 3** — `instlist` + streaming `chartread` (strip / XY / handheld) → `.ti3`, multi-pass average, CIEDE2000
-4. **Stage 4** — `colprof` → `.icc` / `.icm`; optional `applycal`; `iccgamut` next to the profile
-5. **Stage 5** — `profcheck`, verification history, ColorSync user/system install
+1. **Stage 0** — printer calibration: `printcal` / `applycal` session, `CAL_` basename restore
+2. **Stage 1** — `targen` → `.ti1`
+3. **Stage 2** — `printtarg` → `.ti2` + TIFF, unmanaged `lp` spool, bound `NSPrintPanel`
+4. **Stage 3** — `instlist` + streaming `chartread` (strip / XY / handheld) → `.ti3`, multi-pass average, CIEDE2000
+5. **Stage 4** — `colprof` → `.icc` / `.icm`; optional `applycal`; `iccgamut` next to the profile
+6. **Stage 5** — `profcheck`, verification history, ColorSync user/system install
 
-Plus:
+Plus CGATS dataset import (`.ti3` / `.txt` / `.cgats` / `.csv`), SceneKit gamut preview with sRGB overlay, and signed `.dmg` packaging.
 
-- **Calibrate Printer** — optional `printcal` / `applycal` session under a `CAL_` basename
-- **CGATS import** — `.ti3` / `.txt` / `.cgats` / `.csv`
-- **Media recipes and presets** — printer + paper + ink bound to a preset and optional `.cal`
-- **Spot Read** — live one-patch Lab/XYZ from the instrument
-- **Project files** — `.icceryproj` bookmark over folder, basename, recipe, last ΔE
-- **Gamut viewer** — SceneKit Lab hull, sRGB overlay, second-profile compare, click-inspect
-- **Settings** — default instrument, ΔE good/warning cutoffs, install location, logging
-- Signed `.dmg` packaging with a HiDPI Finder background (Monterey through Sonoma)
-
-**Not this product:** display calibration (`dispwin` / `dispread`), i18n,
-Windows/Linux print trees, in-process Argyll, App Sandbox.
+**Not this product:** display calibration (`dispwin` / `dispread`), i18n, Windows/Linux print trees, in-process Argyll, App Sandbox.
 
 ## Requirements
 
-To **run** a packaged build:
-
-- macOS 12.0 Monterey or later (Intel or Apple silicon)
-
-To **build** on the supported CI/host floor:
-
-- macOS 12 with **Xcode 14.2** (macOS 12 SDK, Swift 5.7)
-- [XcodeGen](https://github.com/yonaskolb/XcodeGen) **2.38.0** (Homebrew’s current
-  formula needs Xcode 15.3; CI installs the pinned zip via
-  `scripts/ensure-host-tools.sh`)
+- macOS 14+
+- Xcode 15.4+ with the macOS 14 SDK and Swift 6.0
+- [XcodeGen](https://github.com/yonaskolb/XcodeGen)
 - Network once, to fetch Argyll sidecars
-- For DMGs: Python 3.9+ and `dmgbuild==1.6.7` in `build/.venv-dmgbuild`
-  (`INSTALL_DMGBUILD=1 scripts/ensure-host-tools.sh`)
 
-App Sandbox is **off**. Hardened Runtime is **on**. Entitlements live in
-`ICCery.entitlements`.
+App Sandbox is **off**. Hardened Runtime is **on**. Entitlements live in `ICCery.entitlements`.
 
 ## Build
 
@@ -80,7 +46,7 @@ cd iccery-v2-mac
 git checkout develop
 
 make fetch-argyll          # Vendor/Argyll/macos-universal/, ad-hoc signed
-make test                  # xcodegen + xcodebuild build test (host arch)
+make test                  # xcodegen + xcodebuild build test
 make universal             # ARCHS='arm64 x86_64' ONLY_ACTIVE_ARCH=NO
 ```
 
@@ -90,17 +56,10 @@ Equivalent without Make:
 xcodegen generate
 xcodebuild test -scheme ICCery \
   -destination 'platform=macOS' \
-  ARCHS="$(uname -m)"
+  ARCHS='arm64 x86_64' ONLY_ACTIVE_ARCH=NO
 ```
 
-`project.yml` sets `ARCHS: "$(ARCHS_STANDARD)"`. CI and `make test` override
-that with `ARCHS="$(uname -m)"` so unit/UI tests build the host slice only.
-Fat binaries are `make universal` / `scripts/package-release.sh`.
-
-Sidecars are **not** in git. `scripts/fetch-argyll.sh` pulls the latest (or
-`ARGYLL_RELEASE_TAG`) macOS-universal release from `gronod/argyllcms`, extracts
-to `Vendor/Argyll/macos-universal/`, ad-hoc signs every Mach-O, and fails if
-`codesign -dvv` or the `instlist` marker is missing.
+Sidecars are **not** in git. `scripts/fetch-argyll.sh` pulls the latest (or `ARGYLL_RELEASE_TAG`) macOS-universal release from `gronod/argyllcms`, extracts to `Vendor/Argyll/macos-universal/`, ad-hoc signs every Mach-O, and fails if `codesign -dvv` or the `instlist` marker is missing.
 
 ```bash
 # optional
@@ -110,11 +69,9 @@ export ARGYLL_RELEASE_TAG=…    # default: latest
 export GITEA_TOKEN=…           # private releases
 ```
 
-`make clean` drops `ICCery.xcodeproj`, `DerivedData`, and
-`Packages/ICCeryCore/.build`.
+`make clean` drops `ICCery.xcodeproj`, `DerivedData`, and `Packages/ICCeryCore/.build`.
 
-Do not open the generated xcodeproj as the source of truth. Edit `project.yml`
-and regenerate.
+Do not open the generated xcodeproj as the source of truth. Edit `project.yml` and regenerate.
 
 ## Release packaging
 
@@ -122,48 +79,11 @@ and regenerate.
 scripts/package-release.sh    # fetch → sign → universal build → verify → DMG
 ```
 
-The script builds with a fixed derived data path (`build/DerivedData`), locates
-`Release/ICCery.app` from it, signs the bundle, recursively verifies every
-bundled Mach-O sidecar (`scripts/verify-sidecar-signatures.sh`), builds a
-HiDPI TIFF from `Resources/dmg-background.png` (+ `@2x`) via `tiffutil`, and
-writes the DMG with `dmgbuild==1.6.7`.
-
-### Versioning
-
-`scripts/version.sh` resolves the version triple and is the single source for
-packaging and CI:
-
-- **`ICCERY_RELEASE_TAG`** — `RELEASE_TAG` env when it matches `v[0-9]*` (CI
-  tag builds), else `git describe --tags --always --dirty --match 'v[0-9]*'`.
-  Stamped into the bundle's `ICCeryReleaseTag` resource (a generated
-  Info.plist cannot carry custom keys); the About dialog shows
-  `tag (marketing)` — e.g. `v2.0.0-pre2-grok (2.0.0)` — falling back to the
-  plain version when untagged.
-- **`MARKETING_VERSION`** (`CFBundleShortVersionString`) — first three numeric
-  components of the tag core. Must equal `project.yml`'s
-  `MARKETING_VERSION` on tag builds — packaging hard-fails on mismatch, so
-  bump `project.yml` on `develop` *before* tagging.
-- **`CURRENT_PROJECT_VERSION`** (`CFBundleVersion`) — `BUILD_NUMBER` env
-  override, else `git rev-list --count HEAD`. A single monotonically
-  increasing integer per Apple's macOS convention (Mac build numbers never
-  reset per version, unlike iOS).
-
-Tagged/described DMGs carry the tag: `ICCery-2.0.0-pre2-grok-<build>.dmg`;
-plain releases keep `ICCery-<ver>-<build>.dmg`.
-
-Release procedure: bump `MARKETING_VERSION` in `project.yml` on `develop` →
-merge `develop` → `main` → tag the release commit `vX.Y.Z[-suffix]` → push
-the tag. CI builds, signs, notarizes (when secrets exist) and attaches the
-DMG to the release.
-
-Sidecars stay ad-hoc signed inside the bundle — the app is never
-`codesign --deep`ed.
-
-`dmgbuild` is **not** a test-job dependency. The package job sets
-`INSTALL_DMGBUILD=1` so `scripts/ensure-host-tools.sh` creates
-`build/.venv-dmgbuild`. On the Monterey runner (Python 3.9) that install uses
-`PIP_IGNORE_REQUIRES_PYTHON=1` and pins `pip>=24.3,<26.1` (pip 26.1+ needs
-3.10). Missing background art is a hard fail (#95).
+The script builds with a fixed derived data path (`build/DerivedData`),
+locates `Release/ICCery.app` from it, signs the bundle, recursively verifies
+every bundled Mach-O sidecar (`scripts/verify-sidecar-signatures.sh`), and
+writes `ICCery-${VERSION}-${BUILD_NUM}.dmg` via `dmgbuild`. Sidecars stay
+ad-hoc signed inside the bundle — the app is never `codesign --deep`ed.
 
 Environment variables read by the pipeline:
 
@@ -174,8 +94,6 @@ Environment variables read by the pipeline:
 | `CODESIGN_IDENTITY` | Developer ID identity for the outer `.app`; unset or `-` = ad-hoc |
 | `DEVELOPMENT_TEAM` | team ID passed to `xcodebuild` when signing |
 | `NOTARIZE_APPLE_ID` / `NOTARIZE_PASSWORD` / `APPLE_TEAM_ID` | `notarytool` + staple when all three are set |
-| `RELEASE_TAG` | release tag string (CI sets `github.ref_name`); stamped into the bundle + DMG name |
-| `BUILD_NUMBER` | `CFBundleVersion` override; default `git rev-list --count HEAD` |
 
 ## Layout
 
@@ -187,48 +105,28 @@ Resources/                 assets; Argyll reference files (not the tools)
 Vendor/Argyll/             fetched sidecars (gitignored)
 Tests/ICCeryCoreTests/     argv goldens, parsers, stores
 Tests/ICCeryUITests/       fixture / mock-binary UI tests
-scripts/ensure-host-tools.sh
 scripts/fetch-argyll.sh
-scripts/package-release.sh
 docs/                      functional spec + v2 ticket plan
 ```
 
-`ICCeryPrintKit` (issue #16, Quartz / AirPrint / TargetPrint) is v2.1 and is
-not in this tree.
+`ICCeryPrintKit` (issue #16, Quartz / AirPrint / TargetPrint) is v2.1 and is not in this tree.
 
 ## Architecture
 
-- **Spawn, never link.** Tools resolve through `BinaryResolver` inside the
-  bundle / `Vendor` tree. `$PATH` is not searched. `ARGYLL_NOT_INTERACTIVE=1`
-  is always set.
-- **`ProcessManager` actor** owns child lifetime. Streaming tools
-  (`chartread`, `printtarg`, `colprof`, …) use the event bus; one-shot tools
-  (`printcal`, `applycal`, CUPS) use `runCaptured`. Exclusive `ProcessID`
-  leases. Quit path: `q\n`, ~500 ms, kill; `killAll` on terminate.
-- **Argv builders** in ICCeryCore (`TargenArgs`, `PrinttargArgs`,
-  `ChartreadArgs`, `ColprofArgs`, `ApplycalArgs`, `IccgamutArgs`,
-  `ProfcheckArgs`, `LpArgs`, `SpotReadArgs`, …). UI must not concatenate flags.
-- **Atomic artefacts.** Writes go to `*.tmp` then `replaceItemAt`. `applycal`
-  must not replace the input profile on cancel or non-zero exit.
-- **Concurrency.** View models are `@MainActor`. No blocking I/O on the main
-  actor. Swift 5.7 / macOS 12: `ObservableObject`, not Observation
-  `@Observable`.
-- **Print.** Unmanaged `lp` with ColorSync suppression
-  (`AP_ColorMatchingMode` / `AP.ColorMatchingMode`). Captured `NSPrintPanel`
-  options win over derived CUPS keys. Never `lp -o raw`.
-- **SwiftUI ViewBuilder.** Xcode 14.2 / Swift 5.7 still has the ten-child
-  limit. Split large `VStack`/`Group` trees (#146).
+- **Spawn, never link.** Tools resolve through `BinaryResolver` inside the bundle / `Vendor` tree. `$PATH` is not searched. `ARGYLL_NOT_INTERACTIVE=1` is always set.
+- **`ProcessManager` actor** owns child lifetime. Streaming tools (`chartread`, `printcal`, etc.) use the event bus; one-shot tools use `runCaptured`. Exclusive `ProcessID` leases. Quit path: `q\n`, ~500 ms, kill; `killAll` on terminate.
+- **Argv builders** in ICCeryCore (`TargenArgs`, `PrinttargArgs`, `ChartreadArgs`, `ColprofArgs`, `ApplycalArgs`, `IccgamutArgs`, `ProfcheckArgs`, `LpArgs`, …). UI must not concatenate flags.
+- **Atomic artefacts.** Writes go to `*.tmp` then `replaceItemAt`. `applycal` must not replace the input profile on cancel or non-zero exit.
+- **Concurrency.** View models are `@MainActor`. No blocking I/O on the main actor. SwiftUI `@Observable` for new state.
+- **Print.** Unmanaged `lp` with ColorSync suppression (`AP_ColorMatchingMode` / `AP.ColorMatchingMode`). Captured `NSPrintPanel` options win over derived CUPS keys. Never `lp -o raw`.
 
 ## Tests
 
 ```bash
-# full suite (host arch) — same as CI
+# full suite (universal)
 xcodebuild test -scheme ICCery \
   -destination 'platform=macOS' \
-  ARCHS="$(uname -m)"
-
-# fat compile-check (not the default test path):
-#   ARCHS='arm64 x86_64' ONLY_ACTIVE_ARCH=NO
+  ARCHS='arm64 x86_64' ONLY_ACTIVE_ARCH=NO
 
 # examples
 xcodebuild test -scheme ICCery -destination 'platform=macOS' \
@@ -237,24 +135,9 @@ xcodebuild test -scheme ICCery -destination 'platform=macOS' \
   -only-testing:ICCeryUITests/Milestone5UITests
 ```
 
-CI (`.gitea/workflows/macos.yml` on Gitea, `.github/workflows/macos.yml` on
-GitHub) runs `build-and-test` then `package` on
-`develop` and on `v*` tags. Tags whose name contains `prerelease` skip the
-test job and still package. `pull_request` is wired for **`develop` only**.
-The GitHub file is the same pipeline on `macos-14` (github.com retired
-`macos-12`), `actions/upload-artifact@v4`, and `gh release upload` for tag
-DMGs.
+UI tests need an unlocked console (`IOConsoleLocked=false`). Mock Argyll / CUPS fixtures live under the test bundles; they must not be treated as proof that a real `.gam` / `.icc` was extracted.
 
-UI tests need an unlocked console (`IOConsoleLocked=false`). Mock Argyll /
-CUPS fixtures live under the test bundles; they must not be treated as proof
-that a real `.gam` / `.icc` was extracted.
-
-Hardware gates (real instrument, real printer, Gatekeeper-open `.dmg`) are
-manual and block release, not compile.
-
-`ArgyllRunnerPrinttargTests.testSuccess` can flake if streaming stdout is
-dropped on a fast mock exit; that is a `ProcessManager` drain race, not a
-missing fixture.
+Hardware gates (real instrument, real printer, Gatekeeper-open `.dmg`) are manual and block release, not compile.
 
 ## Instruments
 
@@ -265,18 +148,11 @@ Detected via bundled `instlist`:
 - SpyderPrint (`p3`)
 - SpectroScan (`SS`)
 - DTP20 / 22 / 41 / 51
-- XY tables (SpectroScan, i1iO) when the `instlist` name matches
-  `/spectro\s?scan|i1io/i`
+- XY tables (SpectroScan, i1iO) when the `instlist` name matches `/spectro\s?scan|i1io/i`
 
 ## Docs
 
-| Where | Audience |
-|---|---|
-| [Wiki](https://git.i3omb.com/gronod/iccery-v2-mac/wiki) | End users — screens, workflow, troubleshooting |
-| [`docs/`](docs/README.md) | Functional spec (normative for implementers) |
-| [`AGENTS.md`](AGENTS.md), [`BUILD-PLAN.md`](BUILD-PLAN.md) | Agent / branch rules |
-
-Implementation order in `docs/`:
+Normative spec is [`docs/`](docs/README.md). Implementation order:
 
 | Doc | Topic |
 |---|---|
@@ -284,40 +160,29 @@ Implementation order in `docs/`:
 | [`docs/03-ipc-and-process-manager.md`](docs/03-ipc-and-process-manager.md) | Spawn / stdin / kill |
 | [`docs/04-argyll-binaries.md`](docs/04-argyll-binaries.md) | CLI argv |
 | [`docs/06-wizard-and-artefacts.md`](docs/06-wizard-and-artefacts.md) | Gating |
-| [`docs/23-assets.md`](docs/23-assets.md) | Icons, DMG chrome |
 | [`docs/24-issues-invariants.md`](docs/24-issues-invariants.md) | Bugs that must not return |
 | [`docs/26-v2-mac-ticket-plan.md`](docs/26-v2-mac-ticket-plan.md) | Gitea tickets |
 | [`docs/PREUAT.md`](docs/PREUAT.md) | Pre-UAT tester kit |
 
+Agent / branch rules: [`AGENTS.md`](AGENTS.md), [`BUILD-PLAN.md`](BUILD-PLAN.md).
+
 ## Git
 
 ```
-develop          # integration; PRs land here unless a milestone branch is announced
-main             # protected release line (PR from develop)
-feat/<issue>-<slug>
-fix/<issue>-<slug>
+develop
+  └── milestone/mN-<slug>          # integration only
+        └── feat/<issue>-<slug>    # one issue per branch
 ```
 
-Open feature/fix PRs against **`develop`**. A `milestone/m…` integration
-branch is used only while that milestone is assembling — currently
-`milestone/m11-print-settings` (`milestone/m10-studio` was merged and
-deleted). Do not open umbrella “bugfix” branches that mix tickets.
-
-`main` is push-protected and requires status check
-`macOS CI / build-and-test (push)`. Protected **file** patterns on `main`
-block PR merges that touch matching paths — do not set that field to `*`.
+Feature PRs target the current milestone branch, not `develop`. The milestone branch merges to `develop` when its issues are green. M7 is small; its PRs target `develop` directly. Do not open umbrella "bugfix" branches that mix tickets.
 
 ## Licence
 
-GUI source: © 2026 Gordon Bolton — see [`LICENCE.md`](LICENCE.md). Viewing
-and personal evaluation only unless a separate grant says otherwise.
+GUI source: © 2026 Gordon Bolton — see [`LICENCE.md`](LICENCE.md). Viewing and personal evaluation only unless a separate grant says otherwise.
 
-ArgyllCMS binaries fetched into `Vendor/Argyll/` are **AGPLv3**. They stay
-subprocess-isolated (stdin / stdout / stderr only). Linking them, or spawning
-via `$PATH`, is a licence break.
+ArgyllCMS binaries fetched into `Vendor/Argyll/` are **AGPLv3**. They stay subprocess-isolated (stdin / stdout / stderr only). Linking them, or spawning via `$PATH`, is a licence break.
 
 ## Related
 
-- [User wiki](https://git.i3omb.com/gronod/iccery-v2-mac/wiki)
 - [gronod/argyllcms](https://git.i3omb.com/gronod/argyllcms) — Argyll 3.5.0 fork (`-u` JSON, `instlist`)
 - [gronod/ICCery](https://git.i3omb.com/gronod/ICCery) — v1 Tauri application (spec source, not this tree)

Resources/Assets.xcassets/AppIcon.appiconset/Contents.json

@@ -1,61 +1,51 @@
 {
   "images" : [
     {
-      "filename" : "icon_16x16.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "16x16"
     },
     {
-      "filename" : "icon_16x16@2x.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "16x16"
     },
     {
-      "filename" : "icon_32x32.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "32x32"
     },
     {
-      "filename" : "icon_32x32@2x.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "32x32"
     },
     {
-      "filename" : "icon_128x128.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "128x128"
     },
     {
-      "filename" : "icon_128x128@2x.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "128x128"
     },
     {
-      "filename" : "icon_256x256.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "256x256"
     },
     {
-      "filename" : "icon_256x256@2x.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "256x256"
     },
     {
-      "filename" : "icon_512x512.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "512x512"
     },
     {
-      "filename" : "icon_512x512@2x.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "512x512"

Resources/ICCery.Debug.entitlements

@@ -1,16 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-	<!-- App Sandbox intentionally absent: ICCery must spawn Argyll tools,
-	     read/write user-chosen working directories, and talk to lp/CUPS. -->
-	<key>com.apple.security.device.usb</key>
-	<true/>
-	<!-- Debug only: the shared ICCeryCore package framework embedded in the
-	     test products is ad-hoc signed with no Team ID, so hardened-runtime
-	     library validation kills the test host at launch (run 31992, #119).
-	     Release uses ICCery.entitlements and links the package statically. -->
-	<key>com.apple.security.cs.disable-library-validation</key>
-	<true/>
-</dict>
-</plist>

Sources/ICCery/AboutView.swift

@@ -1,4 +1,3 @@
-import AppKit
 import SwiftUI
 import ICCeryCore
 
@@ -6,18 +5,14 @@ import ICCeryCore
 struct AboutView: View {
     let onClose: () -> Void
 
-    @State private var showingLicenses = false
-
     private let info = ArtefactFiles.appInfo()
 
     var body: some View {
         VStack(spacing: 20) {
-            if let icon = NSImage(named: NSImage.applicationIconName) {
-                Image(nsImage: icon)
-                    .resizable()
-                    .scaledToFit()
-                    .frame(height: 64)
-            }
+            Image("ICCery-logo")
+                .resizable()
+                .scaledToFit()
+                .frame(height: 64)
 
             Text("ICCery")
                 .font(.title)
@@ -56,12 +51,6 @@ struct AboutView: View {
                 .foregroundStyle(.secondary)
                 .multilineTextAlignment(.center)
 
-            Button("View Licenses") {
-                showingLicenses = true
-            }
-            .controlSize(.large)
-            .accessibilityIdentifier("viewLicensesBtn")
-
             Button("Close") {
                 onClose()
             }
@@ -74,8 +63,5 @@ struct AboutView: View {
         .background(Theme.panel)
         .accessibilityElement(children: .contain)
         .accessibilityIdentifier("aboutDialog")
-        .sheet(isPresented: $showingLicenses) {
-            LicenseWindowView()
-        }
     }
 }

Sources/ICCery/AppEnvironment.swift

@@ -13,8 +13,6 @@ struct AppEnvironment: Sendable {
     let runner: ArgyllRunner
     let cupsService: CupsService
     let historyStore: VerificationHistoryStore
-    let mediaStore: MediaLibraryStore
-    let recentProjectsStore: RecentProjectsStore
 
     static func live(
         environment: [String: String] = ProcessInfo.processInfo.environment
@@ -22,15 +20,11 @@ struct AppEnvironment: Sendable {
         let settingsStore = SettingsStore()
         var overrideDir = settingsStore.load().argyllBinaryDir
             .map { URL(fileURLWithPath: $0) }
-        var bundledRoot = AppPaths.bundledArgyllDir
         var cupsDir = URL(fileURLWithPath: "/usr/bin")
         #if DEBUG
         if let dir = environment["ICCERY_ARGYLL_BINARY_DIR"], !dir.isEmpty {
             overrideDir = URL(fileURLWithPath: dir)
         }
-        if let dir = environment["ICCERY_ARGYLL_BUNDLED_ROOT"], !dir.isEmpty {
-            bundledRoot = URL(fileURLWithPath: dir)
-        }
         if let dir = environment["ICCERY_CUPS_BIN_DIR"], !dir.isEmpty {
             cupsDir = URL(fileURLWithPath: dir)
         }
@@ -41,15 +35,12 @@ struct AppEnvironment: Sendable {
             presetStore: PresetStore(settingsStore: settingsStore),
             runner: ArgyllRunner(
                 processManager: .shared,
-                binaryResolver: BinaryResolver(
-                    bundledRoot: bundledRoot, overrideDir: overrideDir)
+                binaryResolver: BinaryResolver(overrideDir: overrideDir)
             ),
             cupsService: CupsService(
                 processManager: .shared,
                 binaryDir: cupsDir),
-            historyStore: VerificationHistoryStore(),
-            mediaStore: MediaLibraryStore(),
-            recentProjectsStore: RecentProjectsStore()
+            historyStore: VerificationHistoryStore()
         )
     }
 }
@@ -83,26 +74,6 @@ enum UITestHooks {
     static var presetImportURL: URL? { url("ICCERY_TEST_PRESET_IMPORT") }
     /// Preset export destination.
     static var presetExportURL: URL? { url("ICCERY_TEST_PRESET_EXPORT") }
-    /// Spot-read CSV export destination (`selectCsvSavePath`, #148).
-    static var csvExportURL: URL? { url("ICCERY_TEST_CSV_EXPORT") }
-    /// `.gam` compare picker result (gamut sheet, #147). Unset → cancel.
-    static var gamutFileURL: URL? { url("ICCERY_TEST_GAMUT_FILE") }
-    /// `.icc/.icm` compare picker result (gamut sheet, #147). Unset → cancel.
-    static var gamutProfileURL: URL? { url("ICCERY_TEST_GAMUT_PROFILE") }
-    /// TIFF sample picker result (gamut sheet, #147). Unset → cancel.
-    static var gamutTiffURL: URL? { url("ICCERY_TEST_GAMUT_TIFF") }
-    /// `selectProjectFile` result (`.icceryproj` open, #149). Unset → cancel.
-    static var projectOpenURL: URL? { url("ICCERY_TEST_PROJECT_OPEN") }
-    /// `selectProjectSavePath` result (`.icceryproj` save-as, #149).
-    static var projectSaveURL: URL? { url("ICCERY_TEST_PROJECT_SAVE") }
-    /// Relocate-folder result when a project's `cwd` is missing (#149).
-    static var projectRelocateURL: URL? { url("ICCERY_TEST_PROJECT_RELOCATE") }
-    /// Forces the gamut sheet into its no-Metal fallback even on a GPU
-    /// host (#147). Set per-test only — never in a default launch env,
-    /// or CI's future GPU run would skip SceneKit too.
-    static var skipSceneKit: Bool {
-        isEnabled && env["ICCERY_TEST_SKIP_SCENEKIT"] == "1"
-    }
 
     // MARK: - Print panel / CUPS stubs (issue 13/17)
 

Sources/ICCery/CalibrationView.swift

@@ -3,139 +3,109 @@ import ICCeryCore
 
 /// Stage 0 calibration dashboard (issue #29, docs/07).
 struct CalibrationView: View {
-    @ObservedObject var model: CalibrationViewModel
-    @ObservedObject var wizard: WizardViewModel
+    @Bindable var model: CalibrationViewModel
 
     var body: some View {
-        VStack(spacing: 0) {
-            ScrollView {
-                VStack(alignment: .leading, spacing: 16) {
-                    Text("Calibrate Printer")
-                        .font(.title2.bold())
-                        .foregroundStyle(Theme.text)
-                    wedgeSection
-                    workflowSection
-                    if !model.calibrationLog.isEmpty { logSection }
-                }
-                .padding(20)
-                .frame(maxWidth: .infinity, alignment: .leading)
-            }
-            .background(Theme.background)
+        VStack(alignment: .leading, spacing: 0) {
+            Text("Calibrate Printer")
+                .font(.title2.bold())
+                .padding(.horizontal, 16)
+                .padding(.top, 16)
 
-            Divider().overlay(Theme.border)
+            Form {
+                Section("Wedge Settings") {
+                    Picker("Colour Space", selection: $model.colourSpace) {
+                        Text("RGB").tag(ColourSpace.rgb)
+                        Text("CMYK").tag(ColourSpace.cmyk)
+                    }
+
+                    HStack {
+                        Text("Steps per channel")
+                        Spacer()
+                        TextField("", value: $model.steps, format: .number)
+                            .frame(width: 60)
+                            .accessibilityIdentifier("calSteps")
+                    }
+
+                    HStack {
+                        Text("White patches")
+                        Spacer()
+                        TextField("", value: $model.whitePatches, format: .number)
+                            .frame(width: 60)
+                    }
+
+                    if model.colourSpace == .cmyk {
+                        HStack {
+                            Text("Ink-limit exploration")
+                            Spacer()
+                            TextField("", text: $model.inkLimit)
+                                .frame(width: 60)
+                                .accessibilityIdentifier("calInkExplore")
+                        }
+                    }
+
+                    Toggle("Neutral emphasis", isOn: $model.includeNeutralEmphasis)
+                }
+
+                Section("Workflow") {
+                    HStack(spacing: 12) {
+                        Button("Generate Target") { model.generateTarget() }
+                            .accessibilityIdentifier("btnCalGenerate")
+                            .disabled(!model.canGenerate)
+
+                        Button("Create Layout & Print") { model.createLayout() }
+                            .accessibilityIdentifier("btnCalLayout")
+                            .disabled(!model.canGenerate)
+
+                        Button("Measure") { model.measureChart() }
+                            .accessibilityIdentifier("btnCalMeasure")
+                            .disabled(model.calibrationTi3URL == nil)
+
+                        Button("Compute Curves") { model.computeCurves() }
+                            .accessibilityIdentifier("btnCalCompute")
+                            .disabled(!model.canCompute)
+                    }
+
+                    if let url = model.computedCalURL {
+                        Toggle("Apply calibration to next profile", isOn: $model.applyToProfile)
+                            .onChange(of: model.applyToProfile) { model.updateApplyToProfile() }
+                            .accessibilityIdentifier("calApplyToggle")
+
+                        Text("Loaded: \(url.lastPathComponent)")
+                            .font(.caption)
+                            .foregroundStyle(.secondary)
+                    }
+                }
+
+                if !model.calibrationLog.isEmpty {
+                    Section("Log") {
+                        ScrollView {
+                            VStack(alignment: .leading, spacing: 2) {
+                                ForEach(model.calibrationLog, id: \.self) { line in
+                                    Text(line)
+                                        .font(.system(.caption, design: .monospaced))
+                                }
+                            }
+                        }
+                        .frame(minHeight: 80, maxHeight: 120)
+                    }
+                }
+
+                if let error = model.lastError {
+                    Section {
+                        Text(error)
+                            .foregroundStyle(.red)
+                    }
+                }
+            }
+            .formStyle(.grouped)
 
             HStack {
                 Spacer()
-                Button("Return to Profiling", role: .cancel) { model.returnToProfiling() }
-                    .keyboardShortcut(.cancelAction)
+                Button("Return to Profiling") { model.returnToProfiling() }
                     .accessibilityIdentifier("btnCalReturn")
             }
             .padding(16)
         }
-        .accessibilityElement(children: .contain)
-        .accessibilityIdentifier("stage-cal")
-    }
-
-    // MARK: - Wedge settings
-
-    private var wedgeSection: some View {
-        VStack(alignment: .leading, spacing: 8) {
-            Text("Wedge Settings").font(.headline).foregroundStyle(Theme.text)
-            Picker("Colour Space", selection: $model.colourSpace) {
-                Text("RGB").tag(ColourSpace.rgb)
-                Text("CMYK").tag(ColourSpace.cmyk)
-            }
-            .pickerStyle(.segmented)
-            .frame(maxWidth: 220)
-
-            HStack(spacing: 12) {
-                Text("Steps per channel")
-                    .foregroundStyle(Theme.text)
-                    .frame(width: 140, alignment: .leading)
-                TextField("", value: $model.steps, format: .number)
-                    .textFieldStyle(.roundedBorder)
-                    .frame(width: 70)
-                    .accessibilityIdentifier("calSteps")
-            }
-
-            HStack(spacing: 12) {
-                Text("White patches")
-                    .foregroundStyle(Theme.text)
-                    .frame(width: 140, alignment: .leading)
-                TextField("", value: $model.whitePatches, format: .number)
-                    .textFieldStyle(.roundedBorder)
-                    .frame(width: 70)
-            }
-
-            if model.colourSpace == .cmyk {
-                HStack(spacing: 12) {
-                    Text("Ink-limit exploration")
-                        .foregroundStyle(Theme.text)
-                        .frame(width: 140, alignment: .leading)
-                    TextField("", text: $model.inkLimit)
-                        .textFieldStyle(.roundedBorder)
-                        .frame(width: 70)
-                        .accessibilityIdentifier("calInkExplore")
-                }
-            }
-
-            Toggle("Neutral emphasis", isOn: $model.includeNeutralEmphasis)
-                .toggleStyle(.checkbox)
-                .foregroundStyle(Theme.text)
-                .accessibilityIdentifier("calNeutralEmphasis")
-        }
-    }
-
-    // MARK: - Workflow
-
-    private var workflowSection: some View {
-        VStack(alignment: .leading, spacing: 8) {
-            Text("Workflow").font(.headline).foregroundStyle(Theme.text)
-            HStack(spacing: 12) {
-                Button("Generate Target") { model.generateTarget() }
-                    .accessibilityIdentifier("btnCalGenerate")
-                    .disabled(wizard.basename.isEmpty
-                              || wizard.effectiveWorkingDirectory == nil
-                              || model.isGenerating)
-
-                Button("Create Layout & Print") { model.createLayout() }
-                    .accessibilityIdentifier("btnCalLayout")
-                    .disabled(wizard.basename.isEmpty
-                              || wizard.effectiveWorkingDirectory == nil
-                              || model.isGenerating)
-
-                Button("Measure") { model.measureChart() }
-                    .accessibilityIdentifier("btnCalMeasure")
-                    .disabled(model.calibrationTi3URL == nil)
-
-                Button("Compute Curves") { model.computeCurves() }
-                    .accessibilityIdentifier("btnCalCompute")
-                    .disabled(!model.canCompute)
-            }
-
-            if let url = model.computedCalURL {
-                Toggle("Apply calibration to next profile", isOn: $model.applyToProfile)
-                    .toggleStyle(.checkbox)
-                    .foregroundStyle(Theme.text)
-                    .onChange(of: model.applyToProfile) { _ in model.updateApplyToProfile() }
-                    .accessibilityIdentifier("calApplyToggle")
-
-                Text("Loaded: \(url.lastPathComponent)")
-                    .font(.caption)
-                    .foregroundStyle(.secondary)
-            }
-        }
-    }
-
-    // MARK: - Log
-
-    private var logSection: some View {
-        ProcessLogView(
-            lines: model.calibrationLog,
-            minHeight: 80,
-            maxHeight: 120,
-            containerId: "calLogContainer",
-            logId: "calLog"
-        )
     }
 }

Sources/ICCery/CalibrationViewModel.swift

@@ -1,12 +1,13 @@
-import Combine
 import Foundation
+import Observation
 import SwiftUI
 import ICCeryCore
 
 /// Stage 0 calibration workflow: generate wedge, print, measure, and
 /// compute `.cal` curves.
 @MainActor
-final class CalibrationViewModel: ObservableObject {
+@Observable
+final class CalibrationViewModel {
 
     let workflow: TargetWorkflowViewModel
     let profile: ProfileWorkflowViewModel
@@ -14,16 +15,17 @@ final class CalibrationViewModel: ObservableObject {
 
     // MARK: - Form state
 
-    @Published var colourSpace: ColourSpace = .cmyk
-    @Published var steps: Int = 21
-    @Published var whitePatches: Int = 4
-    @Published var includeNeutralEmphasis: Bool = false
-    @Published var inkLimit: String = "320"
-    @Published var applyToProfile: Bool = false
-    @Published var computedCalURL: URL?
-    @Published var calibrationLog: [String] = []
-    @Published var isGenerating = false
-    @Published var isComputing = false
+    var colourSpace: ColourSpace = .cmyk
+    var steps: Int = 21
+    var whitePatches: Int = 4
+    var includeNeutralEmphasis: Bool = false
+    var inkLimit: String = "320"
+    var applyToProfile: Bool = false
+    var computedCalURL: URL?
+    var calibrationLog: [String] = []
+    var isGenerating = false
+    var isComputing = false
+    var lastError: String?
 
     init(workflow: TargetWorkflowViewModel, profile: ProfileWorkflowViewModel, environment: AppEnvironment) {
         self.workflow = workflow
@@ -48,15 +50,14 @@ final class CalibrationViewModel: ObservableObject {
         return cwd.appendingPathComponent("\(calBasename).ti3")
     }
 
-    private var identity: CalibrationIdentity {
-        CalibrationIdentity.parse(
-            liveBasename: wizard.basename,
-            persistedOriginal: wizard.calibrationOriginalBasename
-        )
+    private var calBasename: String {
+        if wizard.basename.hasPrefix("CAL_") { return wizard.basename }
+        let original = !wizard.calibrationOriginalBasename.isEmpty
+            ? wizard.calibrationOriginalBasename
+            : wizard.basename
+        return "CAL_\(original)"
     }
 
-    private var calBasename: String { identity.calibrationBasename }
-
     private var calOutputURL: URL? {
         guard let cwd = wizard.effectiveWorkingDirectory else { return nil }
         return cwd.appendingPathComponent("\(calBasename).cal")
@@ -67,38 +68,44 @@ final class CalibrationViewModel: ObservableObject {
     func generateTarget() {
         guard canGenerate, let cwd = wizard.effectiveWorkingDirectory else { return }
         // Snapshot the original (pre-CAL_) basename before changing the live one.
-        let identity = CalibrationIdentity.parse(
-            liveBasename: wizard.basename,
-            persistedOriginal: wizard.calibrationOriginalBasename
-        )
-        wizard.calibrationOriginalBasename = identity.originalBasename
-        wizard.basename = identity.calibrationBasename
+        if !wizard.basename.hasPrefix("CAL_") {
+            wizard.calibrationOriginalBasename = wizard.basename
+        } else if wizard.calibrationOriginalBasename.isEmpty {
+            wizard.calibrationOriginalBasename = String(wizard.basename.dropFirst(4))
+        }
+        let original = wizard.calibrationOriginalBasename
+        wizard.basename = "CAL_\(original)"
         wizard.sessionMode = .calibration
 
+        isGenerating = true
+        calibrationLog = []
+        lastError = nil
+
         let config = CalibrationTargenConfig(
             colourSpace: colourSpace,
             steps: steps,
             whitePatches: whitePatches,
             includeNeutralEmphasis: includeNeutralEmphasis,
             inkLimit: inkLimitValue,
-            basename: identity.originalBasename,
+            basename: original,
             workingDirectory: cwd
         )
 
-        Task { @MainActor in
+        Task { @MainActor [weak self] in
+            guard let self else { return }
+            defer { self.isGenerating = false }
+
             do {
-                _ = try await ProcessRunSupport.runLogged(
-                    setRunning: { self.isGenerating = $0 },
-                    resetLog: { self.calibrationLog = [] },
-                    onLog: { self.calibrationLog.append(contentsOf: $0) }
-                ) { onLog in
-                    try await self.environment.runner.runCalibrationTargen(
-                        config: config, onLogBatch: onLog)
+                _ = try await self.environment.runner.runCalibrationTargen(config: config) { batch in
+                    Task { @MainActor [weak self] in
+                        self?.calibrationLog.append(contentsOf: batch)
+                    }
                 }
                 self.wizard.refreshGating()
                 self.wizard.showNotice("Calibration target generated.")
                 self.wizard.go(to: .layOutPrint)
             } catch {
+                self.lastError = error.localizedDescription
                 self.wizard.showNotice(
                     "Calibration target failed: \(error.localizedDescription)",
                     kind: .error
@@ -133,13 +140,15 @@ final class CalibrationViewModel: ObservableObject {
         // "already exists" when the user declines overwrite. We do not
         // silently clobber.
         if FileManager.default.fileExists(atPath: outputURL.path) {
-            wizard.showNotice(
-                "\(outputURL.lastPathComponent) already exists. Rename or overwrite it first.",
-                kind: .error
-            )
+            lastError = "\(outputURL.lastPathComponent) already exists. Rename or overwrite it first."
+            wizard.showNotice(lastError!, kind: .error)
             return
         }
 
+        isComputing = true
+        calibrationLog = []
+        lastError = nil
+
         let config = PrintcalConfig(
             ti3Basename: calBasename,
             workingDirectory: cwd,
@@ -151,15 +160,15 @@ final class CalibrationViewModel: ObservableObject {
             channelLimits: []
         )
 
-        Task { @MainActor in
+        Task { @MainActor [weak self] in
+            guard let self else { return }
+            defer { self.isComputing = false }
+
             do {
-                let url = try await ProcessRunSupport.runLogged(
-                    setRunning: { self.isComputing = $0 },
-                    resetLog: { self.calibrationLog = [] },
-                    onLog: { self.calibrationLog.append(contentsOf: $0) }
-                ) { onLog in
-                    try await self.environment.runner.runPrintcal(
-                        config: config, onLogBatch: onLog)
+                let url = try await self.environment.runner.runPrintcal(config: config) { batch in
+                    Task { @MainActor [weak self] in
+                        self?.calibrationLog.append(contentsOf: batch)
+                    }
                 }
                 self.computedCalURL = url
                 self.profile.calibrationFile = url.path
@@ -167,6 +176,7 @@ final class CalibrationViewModel: ObservableObject {
                 self.wizard.showNotice("Calibration curves computed.")
                 self.wizard.restoreCalibration()
             } catch {
+                self.lastError = error.localizedDescription
                 self.wizard.showNotice(
                     "Calibration curve computation failed: \(error.localizedDescription)",
                     kind: .error

Sources/ICCery/FileDialogService.swift

@@ -29,8 +29,13 @@ final class FileDialogService {
 
     /// `selectTargetFile` — **save** panel for the new `.ti1` target.
     func selectTargetFile(startingAt start: URL? = nil) -> URL? {
-        save(named: "target.ti1", extensions: ["ti1"], startingAt: start,
-             message: "Choose the .ti1 target file to create")
+        let panel = NSSavePanel()
+        panel.nameFieldStringValue = "target.ti1"
+        panel.allowedContentTypes = utTypes(["ti1"])
+        panel.allowsOtherFileTypes = false
+        panel.directoryURL = start
+        panel.message = "Choose the .ti1 target file to create"
+        return run(panel)
     }
 
     /// `selectExistingTarget` — open `.ti1`/`.ti2` (docs/06 §Resume, #140).
@@ -61,7 +66,12 @@ final class FileDialogService {
 
     /// `selectCsvSavePath` — verification-history CSV export.
     func selectCsvSavePath(startingAt start: URL? = nil) -> URL? {
-        save(named: "verification-history.csv", extensions: ["csv"], startingAt: start)
+        let panel = NSSavePanel()
+        panel.nameFieldStringValue = "verification-history.csv"
+        panel.allowedContentTypes = utTypes(["csv"])
+        panel.allowsOtherFileTypes = false
+        panel.directoryURL = start
+        return run(panel)
     }
 
     /// `selectCalFile` — `.cal` calibration curves.
@@ -70,19 +80,6 @@ final class FileDialogService {
              message: "Choose a calibration file (.cal)")
     }
 
-    /// `selectGamutFile` — `.gam` surface mesh for the compare slot (#147).
-    func selectGamutFile(startingAt start: URL? = nil) -> URL? {
-        open(extensions: ["gam"], startingAt: start,
-             message: "Choose a .gam surface mesh",
-             allowsOtherFileTypes: false)
-    }
-
-    /// `selectTiffFile` — `.tif`/`.tiff` target page for gamut sampling (#147).
-    func selectTiffFile(startingAt start: URL? = nil) -> URL? {
-        open(extensions: ["tif", "tiff"], startingAt: start,
-             message: "Choose a target TIFF page")
-    }
-
     /// `btnImportPreset` — open a `.json` preset file.
     func selectPresetFile(startingAt start: URL? = nil) -> URL? {
         open(extensions: ["json"], startingAt: start,
@@ -91,60 +88,30 @@ final class FileDialogService {
 
     /// `btnExportActivePreset` — save a `.json` preset file.
     func selectPresetSavePath(name: String, startingAt start: URL? = nil) -> URL? {
-        save(named: "\(name).json", extensions: ["json"], startingAt: start,
-             message: "Export this preset as JSON")
-    }
-
-    /// `selectProjectFile` — open `.icceryproj` only (issue #149).
-    func selectProjectFile(startingAt start: URL? = nil) -> URL? {
-        open(extensions: ["icceryproj"], startingAt: start,
-             message: "Open ICCery Project",
-             title: "Open ICCery Project",
-             allowsOtherFileTypes: false)
-    }
-
-    /// `selectProjectSavePath` — save `.icceryproj`, suggested name
-    /// `{basename}.icceryproj` in the working folder (issue #149).
-    func selectProjectSavePath(
-        basename: String, startingAt start: URL? = nil
-    ) -> URL? {
-        save(named: "\(basename).icceryproj", extensions: ["icceryproj"],
-             startingAt: start, message: "Save ICCery Project")
+        let panel = NSSavePanel()
+        panel.nameFieldStringValue = "\(name).json"
+        panel.allowedContentTypes = utTypes(["json"])
+        panel.allowsOtherFileTypes = false
+        panel.directoryURL = start
+        panel.message = "Export this preset as JSON"
+        return run(panel)
     }
 
     // MARK: - Internals (private — not a shared public picker API)
 
-    private func save(
-        named: String,
-        extensions: [String],
-        startingAt start: URL?,
-        message: String? = nil
-    ) -> URL? {
-        let panel = NSSavePanel()
-        panel.nameFieldStringValue = named
-        panel.allowedContentTypes = utTypes(extensions)
-        panel.allowsOtherFileTypes = false
-        panel.directoryURL = start
-        if let message { panel.message = message }
-        return run(panel)
-    }
-
     private func open(
         extensions: [String],
         startingAt start: URL?,
-        message: String?,
-        title: String? = nil,
-        allowsOtherFileTypes: Bool = true
+        message: String?
     ) -> URL? {
         let panel = NSOpenPanel()
         panel.canChooseDirectories = false
         panel.canChooseFiles = true
         panel.allowsMultipleSelection = false
         panel.allowedContentTypes = utTypes(extensions)
-        panel.allowsOtherFileTypes = allowsOtherFileTypes
+        panel.allowsOtherFileTypes = true
         panel.directoryURL = start
         if let message { panel.message = message }
-        if let title { panel.title = title }
         return run(panel)
     }
 

Sources/ICCery/GamutView.swift

@@ -1,6 +1,5 @@
 import SwiftUI
 import SceneKit
-import Metal
 import ICCeryCore
 import simd
 
@@ -63,322 +62,77 @@ internal struct GamutSceneGeometryBuilder {
     }
 }
 
-/// Native SceneKit 3D gamut viewer (issues #28, #147).
+/// Native SceneKit 3D gamut viewer.
 ///
-/// Displays the bundled `sRGB.gam` reference plus up to two profile
-/// meshes with independent visibility toggles, a status line, and an
-/// inspect panel (click a mesh, type a Lab value, or sample a TIFF
-/// pixel). Uses the CIELAB coordinate convention `x = a*`, `y = L*`,
-/// `z = b*`.
+/// Displays a profile gamut mesh and the bundled `sRGB.gam` reference.  Uses
+/// the CIELAB coordinate convention `x = a*`, `y = L*`, `z = b*` so that the
+/// a* (green-red) axis is horizontal, L* (lightness) is vertical, and b*
+/// (blue-yellow) is depth.
 struct GamutView: View {
-    @StateObject private var viewModel: GamutViewModel
+    @State private var viewModel: GamutViewModel
     @State private var pause: () -> Void = {}
     @FocusState private var isFocused: Bool
-    @Environment(\.dismiss) private var dismiss
-    @Binding var showingAllHelp: Bool
 
-    init(
-        environment: AppEnvironment,
-        profileGamURL: URL? = nil,
-        showingAllHelp: Binding<Bool>
-    ) {
-        _viewModel = StateObject(wrappedValue: GamutViewModel(
-            environment: environment, profileGamURL: profileGamURL))
-        _showingAllHelp = showingAllHelp
+    init(profileGamURL: URL? = nil) {
+        _viewModel = State(wrappedValue: GamutViewModel(profileGamURL: profileGamURL))
     }
 
     var body: some View {
-        VStack(spacing: 0) {
-            toolbar
-            Divider().overlay(Theme.border)
-            sceneArea
-            Divider().overlay(Theme.border)
-            statusLine
-            inspectPanel
-            Divider().overlay(Theme.border)
-            footer
+        ZStack {
+            GamutSceneView(
+                profileMesh: viewModel.profileMesh,
+                referenceMesh: viewModel.sRGBMesh,
+                onReset: $viewModel.resetCamera,
+                onPause: $pause
+            )
+            .focusable()
+            .focused($isFocused)
+            .focusEffectDisabled()
+            .onKeyPress(.init("R"), action: {
+                viewModel.resetCamera()
+                return .handled
+            })
+            .onAppear { isFocused = true }
+
+            VStack {
+                HStack {
+                    Spacer()
+                    Button(action: { viewModel.resetCamera() }) {
+                        Text("Reset view")
+                    }
+                    .accessibilityIdentifier("btnResetGamutCamera")
+                    .padding(8)
+                }
+                Spacer()
+                HStack {
+                    Text(viewModel.status)
+                        .font(.caption)
+                        .padding(8)
+                        .background(.thinMaterial)
+                        .cornerRadius(6)
+                        .accessibilityIdentifier("gamutStatusText")
+                    Spacer()
+                }
+                .padding(8)
+            }
         }
-        .frame(minWidth: 720, minHeight: 520)
-        .background(Theme.background)
+        .frame(minWidth: 500, minHeight: 400)
         .onDisappear { pause() }
         .accessibilityElement(children: .contain)
         .accessibilityIdentifier("gamutView")
-        .sheet(isPresented: $viewModel.showingTiffPreview) {
-            tiffPreviewSheet
-        }
-    }
-
-    // MARK: - Toolbar
-
-    private var toolbar: some View {
-        HStack(spacing: 12) {
-            layerToggle(id: GamutViewModel.srgbLayerID, fallback: "sRGB")
-            layerToggle(id: GamutViewModel.profileLayerID, fallback: "Profile")
-            layerToggle(id: GamutViewModel.compareLayerID, fallback: "Compare")
-            Spacer()
-            addCompareMenu
-            Button("Remove compare") { viewModel.removeCompare() }
-                .disabled(viewModel.layer(id: GamutViewModel.compareLayerID) == nil)
-                .accessibilityIdentifier("btnGamutRemoveCompare")
-            Button("Sample TIFF…") { viewModel.openTiffSample() }
-                .accessibilityIdentifier("btnGamutSampleTiff")
-                .helpOverlay(
-                    "Sample a colour from a target TIFF page.",
-                    showing: $showingAllHelp)
-        }
-        .padding(.horizontal, 12)
-        .padding(.vertical, 8)
-    }
-
-    private func layerToggle(id: String, fallback: String) -> some View {
-        let layer = viewModel.layer(id: id)
-        return Toggle(isOn: Binding(
-            get: { layer != nil && viewModel.visibleIDs.contains(id) },
-            set: { on in
-                if on {
-                    viewModel.visibleIDs.insert(id)
-                } else {
-                    viewModel.visibleIDs.remove(id)
-                }
-            }
-        )) {
-            Text(layer?.displayName ?? fallback)
-        }
-        .toggleStyle(.checkbox)
-        .disabled(layer == nil)
-        .help(layer.map { $0.sourceURL.lastPathComponent } ?? "No profile .gam loaded")
-        // macOS 12 puts the identifier on the Toggle's container, an
-        // element that never reports isEnabled — combine so the a11y
-        // leaf is the checkbox itself.
-        .accessibilityElement(children: .combine)
-        .accessibilityIdentifier("gamutLayer-\(id)")
-    }
-
-    private var addCompareMenu: some View {
-        Menu("Add compare…") {
-            Button("Open .gam…") { viewModel.openCompareGam() }
-                .accessibilityIdentifier("btnGamutOpenGam")
-            Button("Open profile…") { viewModel.openCompareProfile() }
-                .accessibilityIdentifier("btnGamutOpenProfile")
-        }
-        .accessibilityIdentifier("btnGamutAddCompare")
-        .helpOverlay(
-            "Add a second profile or .gam mesh to compare against.",
-            showing: $showingAllHelp)
-    }
-
-    // MARK: - Scene
-
-    private var sceneArea: some View {
-        ZStack(alignment: .topTrailing) {
-            if viewModel.viewerUnavailable {
-                Text("3D gamut viewer is unavailable on this Mac; the rest of ICCery still works.")
-                    .font(.callout)
-                    .foregroundStyle(.secondary)
-                    .frame(maxWidth: .infinity, maxHeight: .infinity)
-                    .accessibilityIdentifier("gamutViewerUnavailable")
-            } else {
-                GamutSceneView(
-                    layers: viewModel.layers,
-                    visibleIDs: viewModel.visibleIDs,
-                    onReset: $viewModel.resetCamera,
-                    onPause: $pause,
-                    onUnavailable: { viewModel.viewerUnavailable = true },
-                    onInspect: { point, layerID in
-                        if let layerID {
-                            viewModel.inspectSceneHit(world: point, layerID: layerID)
-                        } else {
-                            viewModel.clearInspect()
-                        }
-                    }
-                )
-                .focusable()
-                .focused($isFocused)
-                .onAppear { isFocused = true }
-            }
-            Button(action: { viewModel.resetCamera() }) {
-                Text("Reset view")
-            }
-            .accessibilityIdentifier("btnResetGamutCamera")
-            .padding(8)
-        }
-        .frame(maxWidth: .infinity, maxHeight: .infinity)
-    }
-
-    // MARK: - Status
-
-    private var statusLine: some View {
-        HStack(spacing: 10) {
-            Text(viewModel.status)
-                .font(.caption)
-                .foregroundStyle(Theme.text)
-                .accessibilityIdentifier("gamutStatusText")
-            if let notice = viewModel.noticeText {
-                Text(notice)
-                    .font(.caption)
-                    .foregroundStyle(.secondary)
-                    .accessibilityIdentifier("gamutNoticeText")
-            }
-            Spacer()
-        }
-        .padding(.horizontal, 12)
-        .padding(.vertical, 6)
-    }
-
-    // MARK: - Inspect panel
-
-    private var inspectPanel: some View {
-        HStack(spacing: 12) {
-            if let lab = viewModel.inspectLab {
-                inspectSwatch
-                labReadout(lab)
-                containmentColumn
-                if viewModel.inspectIsApproximate {
-                    Text("approx. Lab, not ColorSync")
-                        .font(.caption2)
-                        .foregroundStyle(.secondary)
-                        .accessibilityIdentifier("gamutInspectApprox")
-                }
-            } else {
-                Text("Click the mesh, or enter Lab, to inspect.")
-                    .font(.caption)
-                    .foregroundStyle(.secondary)
-                    .accessibilityIdentifier("gamutInspectIdle")
-            }
-            Spacer()
-            labEntryFields
-        }
-        .padding(.horizontal, 12)
-        .padding(.vertical, 8)
-        .frame(minHeight: 56)
-        .background(Theme.panel)
-        .accessibilityElement(children: .contain)
-        .accessibilityIdentifier("gamutInspectPanel")
-        .helpOverlay(
-            "Inspect a Lab point against each loaded gamut.",
-            showing: $showingAllHelp)
-    }
-
-    @ViewBuilder
-    private var inspectSwatch: some View {
-        if let swatch = viewModel.inspectSwatch {
-            Color(red: swatch.r, green: swatch.g, blue: swatch.b)
-                .frame(width: 16, height: 16)
-                .clipShape(RoundedRectangle(cornerRadius: 2))
-                .overlay(RoundedRectangle(cornerRadius: 2).stroke(Theme.border))
-                .accessibilityIdentifier("gamutInspectSwatch")
-        }
-    }
-
-    private func labReadout(_ lab: LabColor) -> some View {
-        HStack(spacing: 10) {
-            Text(String(format: "L %.1f", lab.l))
-                .accessibilityIdentifier("gamutInspectL")
-            Text(String(format: "a %.1f", lab.a))
-                .accessibilityIdentifier("gamutInspectA")
-            Text(String(format: "b %.1f", lab.b))
-                .accessibilityIdentifier("gamutInspectB")
-        }
-        .font(.caption.monospacedDigit())
-        .foregroundStyle(Theme.text)
-    }
-
-    private var containmentColumn: some View {
-        HStack(spacing: 10) {
-            ForEach(viewModel.inspectResults, id: \.id) { result in
-                Text("\(result.name) \(containmentWord(result.containment))")
-                    .font(.caption)
-                    .foregroundStyle(Theme.text)
-                    .accessibilityIdentifier("gamutInspect-\(result.id)")
-            }
-        }
-    }
-
-    private func containmentWord(_ containment: GamutContainment) -> String {
-        switch containment {
-        case .inside: return "in"
-        case .outside: return "out"
-        case .unknown: return "?"
-        }
-    }
-
-    private var labEntryFields: some View {
-        HStack(spacing: 6) {
-            Text("Lab 0–100 · ±128")
-                .font(.caption2)
-                .foregroundStyle(.secondary)
-            TextField("L", text: $viewModel.labEntryL)
-                .textFieldStyle(.roundedBorder)
-                .frame(width: 56)
-                .accessibilityIdentifier("gamutLabEntryL")
-            TextField("a", text: $viewModel.labEntryA)
-                .textFieldStyle(.roundedBorder)
-                .frame(width: 56)
-                .accessibilityIdentifier("gamutLabEntryA")
-            TextField("b", text: $viewModel.labEntryB)
-                .textFieldStyle(.roundedBorder)
-                .frame(width: 56)
-                .accessibilityIdentifier("gamutLabEntryB")
-            Button("Inspect") { viewModel.inspectEnteredLab() }
-                .disabled(!viewModel.canInspectLab)
-                .accessibilityIdentifier("btnGamutInspectLab")
-        }
-    }
-
-    // MARK: - Footer
-
-    /// Always-visible Close (#147) — the fallback banner keeps it
-    /// reachable and Escape works via `.cancelAction` without SceneKit.
-    private var footer: some View {
-        HStack {
-            Spacer()
-            Button("Close") { dismiss() }
-                .keyboardShortcut(.cancelAction)
-                .accessibilityIdentifier("btnCloseGamut")
-        }
-        .padding(.horizontal, 12)
-        .padding(.vertical, 8)
-    }
-
-    // MARK: - TIFF sample sheet
-
-    private var tiffPreviewSheet: some View {
-        VStack(spacing: 12) {
-            Text("Click a pixel to sample its colour.")
-                .font(.headline)
-                .foregroundStyle(Theme.text)
-            if let png = viewModel.tiffPreviewPNG {
-                TiffSampleImageView(pngData: png) { r, g, b in
-                    viewModel.sampleTiffPixel(r: r, g: g, b: b)
-                }
-                .frame(minWidth: 320, minHeight: 240)
-            }
-            HStack {
-                Spacer()
-                Button("Cancel") { viewModel.showingTiffPreview = false }
-                    .accessibilityIdentifier("btnCloseGamutTiffPreview")
-            }
-        }
-        .padding(16)
-        .background(Theme.background)
-        .accessibilityElement(children: .contain)
-        .accessibilityIdentifier("gamutTiffPreview")
     }
 }
 
-/// `NSViewRepresentable` wrapper around an `SCNView` rendering one node
-/// per ``NamedGamut`` layer.
+/// `NSViewRepresentable` wrapper around an `SCNView` that builds the scene from
+/// one or two ``GamutMesh`` values.
 ///
-/// Layer toggles hide/show `SCNNode`s — the scene is built once and the
-/// camera is only reset through the explicit reset path, never on a
-/// mesh or visibility update.
+/// Scene construction and camera reset are coordinated through a typed callback
+/// binding owned by the view model.
 private struct GamutSceneView: NSViewRepresentable {
-    var layers: [NamedGamut]
-    var visibleIDs: Set<String>
+    var profileMesh: GamutMesh?
+    var referenceMesh: GamutMesh?
     var onReset: Binding<() -> Void>
     var onPause: Binding<() -> Void>
-    var onUnavailable: () -> Void
-    var onInspect: (SIMD3<Float>, String?) -> Void
 
     func makeNSView(context: Context) -> SCNView {
         let scnView = SCNView()
@@ -393,25 +147,13 @@ private struct GamutSceneView: NSViewRepresentable {
 
         context.coordinator.scnView = scnView
         context.coordinator.scene = scene
-        context.coordinator.onInspect = onInspect
-        context.coordinator.buildSceneOnce()
-        context.coordinator.syncLayers(layers, visibleIDs: visibleIDs)
-        context.coordinator.installKeyMonitor()
-        context.coordinator.installClickGesture()
-
-        // Safety net only — the primary no-Metal check is
-        // `GamutSceneAvailability.isAvailable`, evaluated before this
-        // view is mounted. Never respawn the view in a loop.
-        if MTLCreateSystemDefaultDevice() == nil {
-            DispatchQueue.main.async { onUnavailable() }
-        }
+        context.coordinator.buildScene(profile: profileMesh, reference: referenceMesh)
 
         return scnView
     }
 
     func updateNSView(_ nsView: SCNView, context: Context) {
-        context.coordinator.onInspect = onInspect
-        context.coordinator.syncLayers(layers, visibleIDs: visibleIDs)
+        context.coordinator.buildScene(profile: profileMesh, reference: referenceMesh)
     }
 
     func makeCoordinator() -> Coordinator {
@@ -426,10 +168,6 @@ private struct GamutSceneView: NSViewRepresentable {
     }
 
     static func dismantleNSView(_ nsView: SCNView, coordinator: Coordinator) {
-        coordinator.removeKeyMonitor()
-        if let click = coordinator.clickGesture {
-            nsView.removeGestureRecognizer(click)
-        }
         nsView.isPlaying = false
     }
 
@@ -437,14 +175,10 @@ private struct GamutSceneView: NSViewRepresentable {
     final class Coordinator: NSObject {
         weak var scnView: SCNView?
         weak var scene: SCNScene?
-        var onInspect: (SIMD3<Float>, String?) -> Void = { _, _ in }
-        private(set) var clickGesture: NSClickGestureRecognizer?
-        private var keyMonitor: Any?
 
-        /// One `SCNNode` per loaded layer, keyed by `NamedGamut.id`.
-        private var layerNodes: [String: SCNNode] = [:]
+        private let profileNode = SCNNode()
+        private let referenceGroup = SCNNode()
         private let axisNode = SCNNode()
-        private let layerGroup = SCNNode()
         private let cameraNode: SCNNode = {
             let node = SCNNode()
             node.camera = SCNCamera()
@@ -452,97 +186,33 @@ private struct GamutSceneView: NSViewRepresentable {
             return node
         }()
 
-        /// Builds the static scene furniture exactly once — axis
-        /// scaffold, lights, camera home. Layer content lives under
-        /// `layerGroup` and is managed by `syncLayers`.
-        func buildSceneOnce() {
-            guard let scene, scene.rootNode.childNodes.isEmpty else { return }
+        func buildScene(profile: GamutMesh?, reference: GamutMesh?) {
+            guard let scene else { return }
 
+            // Rebuild from scratch on every mesh change to avoid stale geometry.
+            scene.rootNode.childNodes.forEach { $0.removeFromParentNode() }
             scene.rootNode.addChildNode(axisNode)
-            scene.rootNode.addChildNode(layerGroup)
+            scene.rootNode.addChildNode(profileNode)
+            scene.rootNode.addChildNode(referenceGroup)
             scene.rootNode.addChildNode(cameraNode)
 
             buildAxisScaffold()
+
+            if let profile {
+                profileNode.addChildNode(profileMeshNode(profile, name: "profile"))
+            } else {
+                profileNode.childNodes.forEach { $0.removeFromParentNode() }
+            }
+
+            if let reference {
+                referenceGroup.childNodes.forEach { $0.removeFromParentNode() }
+                referenceGroup.addChildNode(referenceMeshNode(reference))
+            }
+
             addLights(to: scene)
             resetCamera()
         }
 
-        /// Reconciles the node set with `layers` and `visibleIDs`.
-        ///
-        /// New layers get a node; removed layers lose theirs; hidden
-        /// layers keep their mesh (`isHidden` only). Never rebuilds the
-        /// scene, so the camera is untouched by a checkbox toggle.
-        func syncLayers(_ layers: [NamedGamut], visibleIDs: Set<String>) {
-            guard scene != nil else { return }
-            let wanted = Set(layers.map { $0.id })
-            for (id, node) in layerNodes where !wanted.contains(id) {
-                node.removeFromParentNode()
-                layerNodes.removeValue(forKey: id)
-            }
-            for layer in layers {
-                if layerNodes[layer.id] == nil {
-                    let node = makeLayerNode(for: layer)
-                    layerNodes[layer.id] = node
-                    layerGroup.addChildNode(node)
-                }
-                layerNodes[layer.id]?.isHidden = !visibleIDs.contains(layer.id)
-            }
-        }
-
-        private func makeLayerNode(for layer: NamedGamut) -> SCNNode {
-            let node: SCNNode
-            switch layer.role {
-            case .reference:
-                node = referenceMeshNode(layer.mesh)
-            case .profileA:
-                node = profileMeshNode(layer.mesh)
-            case .profileB:
-                node = compareMeshNode(layer.mesh)
-            }
-            node.name = layer.id
-            return node
-        }
-
-        // MARK: - Click inspect (#147)
-
-        /// Click (not drag) hit-tests the scene. `NSClickGestureRecognizer`
-        /// only fires on a press+release in place, so orbit drags are
-        /// untouched.
-        func installClickGesture() {
-            guard let scnView, clickGesture == nil else { return }
-            let gesture = NSClickGestureRecognizer(target: self, action: #selector(handleClick(_:)))
-            scnView.addGestureRecognizer(gesture)
-            clickGesture = gesture
-        }
-
-        @objc private func handleClick(_ gesture: NSClickGestureRecognizer) {
-            guard let scnView else { return }
-            let point = gesture.location(in: scnView)
-            for hit in scnView.hitTest(point, options: nil) {
-                if let layerID = layerID(for: hit.node) {
-                    let world = hit.worldCoordinates
-                    onInspect(
-                        SIMD3<Float>(Float(world.x), Float(world.y), Float(world.z)),
-                        layerID)
-                    return
-                }
-            }
-            // Axis scaffold / empty background → back to idle.
-            onInspect(.zero, nil)
-        }
-
-        /// Walks the hit node's ancestor chain looking for a layer node.
-        private func layerID(for node: SCNNode) -> String? {
-            var current: SCNNode? = node
-            while let node = current {
-                if let name = node.name, layerNodes[name] != nil { return name }
-                current = node.parent
-            }
-            return nil
-        }
-
-        // MARK: - Scene furniture (unchanged from #28)
-
         private func addLights(to scene: SCNScene) {
             let ambient = SCNNode()
             ambient.light = SCNLight()
@@ -683,8 +353,7 @@ private struct GamutSceneView: NSViewRepresentable {
             return SCNNode(geometry: geometry)
         }
 
-        /// Profile A: solid vertex-coloured surface.
-        private func profileMeshNode(_ mesh: GamutMesh) -> SCNNode {
+        private func profileMeshNode(_ mesh: GamutMesh, name: String) -> SCNNode {
             let (geometry, _) = scnGeometry(for: mesh)
 
             let material = SCNMaterial()
@@ -694,26 +363,11 @@ private struct GamutSceneView: NSViewRepresentable {
             material.isDoubleSided = true
             geometry.materials = [material]
 
-            return SCNNode(geometry: geometry)
+            let node = SCNNode(geometry: geometry)
+            node.name = name
+            return node
         }
 
-        /// Compare profile B: same vertex colours at ~30 % opacity so
-        /// overlaps with A and the sRGB reference stay readable.
-        private func compareMeshNode(_ mesh: GamutMesh) -> SCNNode {
-            let (geometry, _) = scnGeometry(for: mesh)
-
-            let material = SCNMaterial()
-            material.lightingModel = .lambert
-            material.diffuse.contents = NSColor.white
-            material.transparency = 0.30
-            material.isDoubleSided = true
-            material.writesToDepthBuffer = false
-            geometry.materials = [material]
-
-            return SCNNode(geometry: geometry)
-        }
-
-        /// Bundled sRGB reference: faint fill + structural edge lines.
         private func referenceMeshNode(_ mesh: GamutMesh) -> SCNNode {
             let (geometry, _) = scnGeometry(for: mesh)
 
@@ -777,31 +431,6 @@ private struct GamutSceneView: NSViewRepresentable {
             scnView?.isPlaying = false
         }
 
-        /// Local key-down monitor for the R camera-reset shortcut (the
-        /// SwiftUI key-press modifier is unavailable on macOS 12). Only
-        /// events aimed at this view's window are handled; everything
-        /// else passes through untouched.
-        func installKeyMonitor() {
-            guard keyMonitor == nil else { return }
-            keyMonitor = NSEvent.addLocalMonitorForEvents(matching: .keyDown) {
-                [weak self] event in
-                guard let self,
-                      let scnView = self.scnView,
-                      event.window === scnView.window,
-                      event.charactersIgnoringModifiers?.uppercased() == "R"
-                else { return event }
-                self.resetCamera()
-                return nil
-            }
-        }
-
-        func removeKeyMonitor() {
-            if let keyMonitor {
-                NSEvent.removeMonitor(keyMonitor)
-                self.keyMonitor = nil
-            }
-        }
-
         func resetCamera() {
             guard let scnView else { return }
 
@@ -836,81 +465,3 @@ private struct GamutSceneView: NSViewRepresentable {
         }
     }
 }
-
-/// Click-to-sample image view for the TIFF preview sheet (#147).
-///
-/// The TIFF is already decoded to PNG on the host side (#58); the view
-/// reports 8-bit sRGB pixel values at the clicked point — the Lab
-/// conversion is the documented approximate matrix helper, not a CMM.
-private struct TiffSampleImageView: NSViewRepresentable {
-    let pngData: Data
-    var onSample: (Int, Int, Int) -> Void
-
-    func makeNSView(context: Context) -> TiffSampleNSView {
-        let view = TiffSampleNSView()
-        view.image = NSImage(data: pngData)
-        view.onSample = onSample
-        return view
-    }
-
-    func updateNSView(_ nsView: TiffSampleNSView, context: Context) {
-        nsView.onSample = onSample
-    }
-}
-
-private final class TiffSampleNSView: NSView {
-    var image: NSImage? {
-        didSet {
-            bitmapRep = image?.cgImage(forProposedRect: nil, context: nil, hints: nil)
-                .flatMap { NSBitmapImageRep(cgImage: $0) }
-            invalidateIntrinsicContentSize()
-            needsDisplay = true
-        }
-    }
-    var onSample: ((Int, Int, Int) -> Void)?
-    private var bitmapRep: NSBitmapImageRep?
-
-    override var intrinsicContentSize: NSSize {
-        image?.size ?? NSSize(width: 320, height: 240)
-    }
-
-    override var acceptsFirstResponder: Bool { true }
-
-    override func draw(_ dirtyRect: NSRect) {
-        NSColor(red: 0.055, green: 0.055, blue: 0.078, alpha: 1).setFill()
-        dirtyRect.fill()
-        guard let image else { return }
-        image.draw(in: imageRect())
-    }
-
-    override func mouseUp(with event: NSEvent) {
-        guard let rep = bitmapRep else { return }
-        let rect = imageRect()
-        let location = convert(event.locationInWindow, from: nil)
-        guard rect.contains(location), rect.width > 0, rect.height > 0 else { return }
-
-        let x = Int((location.x - rect.minX) / rect.width * CGFloat(rep.pixelsWide))
-        // This view is not flipped: y grows up, bitmap rows grow down.
-        let y = rep.pixelsHigh - 1
-            - Int((location.y - rect.minY) / rect.height * CGFloat(rep.pixelsHigh))
-        guard x >= 0, x < rep.pixelsWide, y >= 0, y < rep.pixelsHigh else { return }
-
-        guard let color = rep.colorAt(x: x, y: y)?.usingColorSpace(.sRGB) else { return }
-        onSample?(
-            Int((color.redComponent * 255).rounded()),
-            Int((color.greenComponent * 255).rounded()),
-            Int((color.blueComponent * 255).rounded()))
-    }
-
-    /// Aspect-fit rect of the image inside `bounds`.
-    private func imageRect() -> NSRect {
-        guard let image, image.size.width > 0, image.size.height > 0 else { return .zero }
-        let scale = min(bounds.width / image.size.width, bounds.height / image.size.height)
-        let size = NSSize(width: image.size.width * scale, height: image.size.height * scale)
-        return NSRect(
-            x: (bounds.width - size.width) / 2,
-            y: (bounds.height - size.height) / 2,
-            width: size.width,
-            height: size.height)
-    }
-}

Sources/ICCery/GamutViewModel.swift

@@ -1,318 +1,54 @@
-import Combine
 import Foundation
 import ICCeryCore
-import Metal
-import simd
+import Observation
 
-/// Whether the SceneKit gamut scene can render on this host (#147).
+/// View model for the native SceneKit gamut viewer.
 ///
-/// Checked **before** `GamutSceneView` is mounted — constructing an
-/// `SCNView` on a Metal-less machine can wedge the main thread, which
-/// also stalls app quit behind the open sheet.
-enum GamutSceneAvailability {
-    static var isAvailable: Bool {
-        if UITestHooks.skipSceneKit { return false }
-        return MTLCreateSystemDefaultDevice() != nil
-    }
-}
-
-/// View model for the native SceneKit gamut viewer (issues #28, #147).
-///
-/// Loads the bundled `sRGB.gam` reference immediately, the workflow's own
-/// profile `.gam` when one exists, and an optional compare mesh the user
-/// adds from the sheet toolbar. `iccgamut` failure is an in-sheet info
-/// notice, never fatal (#24).
+/// Loads the bundled `sRGB.gam` reference immediately and, optionally, a
+/// printer/profile `.gam` from the current working directory.
 @MainActor
-final class GamutViewModel: ObservableObject {
+@Observable
+final class GamutViewModel {
 
-    /// Stable layer ids — also the `gamutLayer-<id>` a11y suffixes.
-    static let srgbLayerID = "sRGB"
-    static let profileLayerID = "profile"
-    static let compareLayerID = "compare"
+    /// Parsed reference sRGB gamut mesh.
+    var sRGBMesh: GamutMesh?
 
-    /// Loaded meshes: bundled sRGB plus up to two profiles.
-    @Published var layers: [NamedGamut] = []
+    /// Parsed printer/profile gamut mesh.
+    var profileMesh: GamutMesh?
 
-    /// Layer ids currently shown in the scene. Toggling never unloads
-    /// the mesh — the `SCNNode` is hidden only.
-    @Published var visibleIDs: Set<String> = [srgbLayerID]
-
-    /// User-facing status line (`gamutStatusText`). Always non-empty
-    /// once set — `Milestone6GamutUITests` asserts it.
-    @Published var status = "Loading gamut…"
-
-    /// In-sheet info line (`gamutNoticeText`). The main `NoticeBanner`
-    /// sits behind the sheet, so notices surface here instead.
-    @Published var noticeText: String?
-
-    /// Set when `SCNView` cannot create a render context; the scene is
-    /// replaced by the docs/18 fallback text (`gamutViewerUnavailable`).
-    @Published var viewerUnavailable = false
+    /// User-facing status line.
+    var status = "Loading gamut…"
 
     /// Closure injected into the SceneKit view to request a camera reset.
-    @Published var resetCamera: () -> Void = {}
+    var resetCamera: () -> Void = {}
 
-    // MARK: - Inspect panel
-
-    /// Lab point currently inspected, or `nil` for the idle state.
-    @Published var inspectLab: LabColor?
-
-    /// Swatch colour: the hit vertex's `rgb`, or the approximate sRGB of
-    /// the inspected Lab.
-    @Published var inspectSwatch: DisplayRGB?
-
-    /// `true` when the swatch/Lab came from the approximate helper or a
-    /// typed value — drives the "approx. Lab, not ColorSync" caption.
-    @Published var inspectIsApproximate = false
-
-    /// Per-layer containment for `inspectLab`, in layer order.
-    @Published var inspectResults: [(id: String, name: String, containment: GamutContainment)] = []
-
-    /// Manual Lab entry fields (`gamutLabEntry*`).
-    @Published var labEntryL = ""
-    @Published var labEntryA = ""
-    @Published var labEntryB = ""
-
-    // MARK: - TIFF sampling
-
-    /// PNG bytes for the preview sheet (`gamutTiffPreview`).
-    @Published var tiffPreviewPNG: Data?
-    @Published var showingTiffPreview = false
-
-    private let environment: AppEnvironment
     private let profileGamURL: URL?
-    private let fileDialogs = FileDialogService.shared
 
-    init(environment: AppEnvironment, profileGamURL: URL? = nil) {
-        self.environment = environment
+    init(profileGamURL: URL? = nil) {
         self.profileGamURL = profileGamURL
-        // Never let the view mount an SCNView without Metal (#147).
-        viewerUnavailable = !GamutSceneAvailability.isAvailable
-        loadTask = Task { await load() }
+        Task { await load() }
     }
 
-    private var loadTask: Task<Void, Never>?
-
-    /// Awaits the initial sRGB/profile load — used by tests.
-    func awaitInitialLoad() async {
-        await loadTask?.value
-    }
-
-    func layer(id: String) -> NamedGamut? {
-        layers.first { $0.id == id }
-    }
-
-    // MARK: - Initial load
-
     private func load() async {
         do {
-            let referenceURL = environment.runner.binaryResolver.referenceGamut("sRGB")
+            let referenceURL = BinaryResolver().referenceGamut("sRGB")
             let reference = try await parse(url: referenceURL)
-            layers.append(NamedGamut(
-                id: Self.srgbLayerID,
-                displayName: "sRGB",
-                role: .reference,
-                mesh: reference,
-                sourceURL: referenceURL))
-            visibleIDs.insert(Self.srgbLayerID)
+            sRGBMesh = reference
+
+            if let profileGamURL {
+                let profile = try await parse(url: profileGamURL)
+                profileMesh = profile
+                status = "Profile gamut (\(profile.faces.count) faces) vs sRGB reference"
+            } else {
+                status = "sRGB reference gamut (\(reference.faces.count) faces)"
+            }
         } catch {
             status = "Could not load gamut: \(error.localizedDescription)"
-            return
-        }
-
-        if let profileGamURL {
-            do {
-                let profile = try await parse(url: profileGamURL)
-                layers.append(NamedGamut(
-                    id: Self.profileLayerID,
-                    displayName: profileGamURL.deletingPathExtension().lastPathComponent,
-                    role: .profileA,
-                    mesh: profile,
-                    sourceURL: profileGamURL))
-                visibleIDs.insert(Self.profileLayerID)
-            } catch {
-                // #24 — a missing/unparseable profile mesh is info, not fatal.
-                noticeText = "Profile gamut could not be loaded: \(error.localizedDescription)"
-            }
-        }
-        refreshStatus()
-    }
-
-    // MARK: - Compare slot (profile B)
-
-    /// `btnGamutOpenGam` — pick an existing `.gam` for the compare slot.
-    func openCompareGam() {
-        let url = UITestHooks.isEnabled
-            ? UITestHooks.gamutFileURL
-            : fileDialogs.selectGamutFile()
-        guard let url else { return }
-        Task { await loadCompareGam(url: url) }
-    }
-
-    /// `btnGamutOpenProfile` — pick `.icc/.icm`; uses a sibling `.gam`
-    /// when present, otherwise runs bundled `iccgamut -v -d 10` (#24).
-    func openCompareProfile() {
-        let url = UITestHooks.isEnabled
-            ? UITestHooks.gamutProfileURL
-            : fileDialogs.selectProfileFile()
-        guard let url else { return }
-        Task { await loadCompareProfile(url: url) }
-    }
-
-    /// `btnGamutRemoveCompare` — drops layer B, leaves sRGB + A.
-    func removeCompare() {
-        layers.removeAll { $0.id == Self.compareLayerID }
-        visibleIDs.remove(Self.compareLayerID)
-        refreshStatus()
-    }
-
-    /// Parses `url` into the compare slot. Internal for tests — the UI
-    /// reaches it through `openCompareGam` / `openCompareProfile`.
-    func loadCompareGam(url: URL) async {
-        do {
-            let mesh = try await parse(url: url)
-            installCompare(NamedGamut(
-                id: Self.compareLayerID,
-                displayName: url.deletingPathExtension().lastPathComponent,
-                role: .profileB,
-                mesh: mesh,
-                sourceURL: url))
-        } catch {
-            noticeText = "Could not load compare gamut: \(error.localizedDescription)"
         }
     }
 
-    /// `.icc/.icm` → sibling `.gam` or `iccgamut` → compare slot.
-    /// Internal for tests.
-    func loadCompareProfile(url: URL) async {
-        let gamURL = url.deletingPathExtension().appendingPathExtension("gam")
-        do {
-            if !FileManager.default.fileExists(atPath: gamURL.path) {
-                _ = try await environment.runner.runIccgamut(
-                    config: IccgamutConfig(profileURL: url))
-            }
-            await loadCompareGam(url: gamURL)
-        } catch {
-            noticeText = "Gamut extraction failed: \(error.localizedDescription)"
-        }
-    }
-
-    /// A third profile replaces B — the compare slot never stacks and
-    /// sRGB is never touched.
-    private func installCompare(_ gamut: NamedGamut) {
-        if layers.contains(where: { $0.id == gamut.id }) {
-            noticeText = "Compare slot holds one profile. The previous compare mesh was replaced."
-        }
-        layers.removeAll { $0.id == gamut.id }
-        layers.append(gamut)
-        visibleIDs.insert(gamut.id)
-        refreshStatus()
-    }
-
-    // MARK: - Status line
-
-    /// `sRGB 448v / 892 faces · Profile 1024v / 2048 faces · vol 62% of sRGB`.
-    /// Unloaded layers are omitted; the volume clause appears only when
-    /// both volumes are finite and positive.
-    private func refreshStatus() {
-        var clauses = layers.map {
-            "\($0.displayName) \($0.mesh.vertices.count)v / \($0.mesh.faces.count) faces"
-        }
-        if let srgb = layer(id: Self.srgbLayerID),
-           let profile = layer(id: Self.profileLayerID) {
-            let srgbVolume = GamutGeometry.volume(of: srgb.mesh)
-            let profileVolume = GamutGeometry.volume(of: profile.mesh)
-            if srgbVolume.isFinite, srgbVolume > 0,
-               profileVolume.isFinite, profileVolume > 0 {
-                clauses.append("vol \(Int((profileVolume / srgbVolume * 100).rounded()))% of sRGB")
-            }
-        }
-        status = clauses.isEmpty ? "No gamut loaded" : clauses.joined(separator: " · ")
-    }
-
-    // MARK: - Inspect
-
-    /// Whether every manual Lab field parses as a number; the Inspect
-    /// button is disabled while this is false.
-    var canInspectLab: Bool {
-        [labEntryL, labEntryA, labEntryB].allSatisfy { Double($0) != nil }
-    }
-
-    /// Runs containment for a Lab point and publishes the inspect row.
-    func inspect(lab: LabColor, swatch: DisplayRGB?, isApproximate: Bool) {
-        inspectLab = lab
-        inspectSwatch = swatch ?? LabColorMath.labToSRGB(lab)
-        inspectIsApproximate = isApproximate
-        inspectResults = layers.map {
-            ($0.id, $0.displayName, GamutGeometry.containment(of: lab, in: $0.mesh))
-        }
-    }
-
-    /// Click on the axis scaffold or empty background returns the panel
-    /// to idle.
-    func clearInspect() {
-        inspectLab = nil
-        inspectSwatch = nil
-        inspectIsApproximate = false
-        inspectResults = []
-    }
-
-    /// SceneKit hit callback: world `(x, y, z)` → Lab `(x→a*, y→L*, z→b*)`.
-    /// The swatch is the nearest vertex colour of the hit layer's mesh.
-    func inspectSceneHit(world: SIMD3<Float>, layerID: String) {
-        let lab = LabColor(l: Double(world.y), a: Double(world.x), b: Double(world.z))
-        var swatch: DisplayRGB?
-        var approximate = true
-        if let mesh = layer(id: layerID)?.mesh,
-           let nearest = mesh.vertices.min(by: {
-               simd_distance($0.position, world) < simd_distance($1.position, world)
-           }) {
-            swatch = nearest.rgb
-            approximate = false
-        }
-        inspect(lab: lab, swatch: swatch, isApproximate: approximate)
-    }
-
-    /// `btnGamutInspectLab` — typed L*a*b* path. No clamping; out-of-axis
-    /// values still run containment and report `?` outside every hull.
-    func inspectEnteredLab() {
-        guard let l = Double(labEntryL),
-              let a = Double(labEntryA),
-              let b = Double(labEntryB) else { return }
-        inspect(lab: LabColor(l: l, a: a, b: b), swatch: nil, isApproximate: true)
-    }
-
-    // MARK: - TIFF sampling
-
-    /// `btnGamutSampleTiff` — pick a target TIFF, decode a host-side PNG
-    /// preview (#58), and open the click-to-sample sheet.
-    func openTiffSample() {
-        let url = UITestHooks.isEnabled
-            ? UITestHooks.gamutTiffURL
-            : fileDialogs.selectTiffFile()
-        guard let url else { return }
-        guard let png = TiffPreview.previewPNG(tiff: url) else {
-            noticeText = "Could not decode TIFF preview."
-            return
-        }
-        tiffPreviewPNG = png
-        showingTiffPreview = true
-    }
-
-    /// Pixel tap inside the preview sheet: sRGB8 → approximate Lab D50.
-    func sampleTiffPixel(r: Int, g: Int, b: Int) {
-        inspect(
-            lab: ApproximateLab.srgb8ToLab(r: r, g: g, b: b),
-            swatch: DisplayRGB(
-                r: Double(r) / 255.0,
-                g: Double(g) / 255.0,
-                b: Double(b) / 255.0),
-            isApproximate: true)
-        showingTiffPreview = false
-    }
-
-    /// Parses a `.gam` file off the main actor so large meshes do not
-    /// stall the UI.
+    /// Parses a `.gam` file off the main actor so large meshes do not stall
+    /// the UI.
     private func parse(url: URL) async throws -> GamutMesh {
         try await Task.detached {
             try GamutMeshParser.parse(url: url)

Sources/ICCery/ICCeryApp.swift

@@ -5,11 +5,11 @@ import SwiftUI
 @main
 struct ICCeryApp: App {
     @NSApplicationDelegateAdaptor(AppDelegate.self) private var appDelegate
-    @StateObject private var workflow: TargetWorkflowViewModel
+    @State private var workflow: TargetWorkflowViewModel
 
     init() {
         let environment = AppEnvironment.live()
-        _workflow = StateObject(wrappedValue: TargetWorkflowViewModel(environment: environment))
+        _workflow = State(initialValue: TargetWorkflowViewModel(environment: environment))
         try? AppPaths.ensureDirectories()
         // Log level is runtime state — apply persisted settings at
         // startup (#158); the Settings sheet re-applies on save.
@@ -17,22 +17,15 @@ struct ICCeryApp: App {
     }
 
     var body: some Scene {
-        // Single fixed window (docs/21 §Shell: 1280×800, min 1100×700);
-        // metrics are applied by AppDelegate once the window exists.
-        WindowGroup("ICCery") {
+        // Single fixed window (docs/21 §Shell: 1280×800, min 1100×700).
+        Window("ICCery", id: "main") {
             RootView(workflow: workflow)
                 .frame(minWidth: 1100, minHeight: 700)
                 .preferredColorScheme(.dark)
         }
-        .commands {
-            // Single-window app: the File menu carries the project
-            // commands (issue #149). Replacing `.newItem` keeps
-            // SwiftUI's empty default New from stacking (R19 — the
-            // group is filled, so no second New appears).
-            CommandGroup(replacing: .newItem) {
-                ProjectCommands(workflow: workflow)
-            }
-        }
+        .defaultSize(width: 1280, height: 800)
+        .windowResizability(.contentMinSize)
+        .defaultPosition(.center)
     }
 }
 
@@ -43,62 +36,6 @@ struct ICCeryApp: App {
 final class AppDelegate: NSObject, NSApplicationDelegate {
     private var terminationRequested = false
 
-    func applicationDidFinishLaunching(_ notification: Notification) {
-        // SwiftUI scenes launched by XCTest stay `.runningBackground`
-        // unless the app takes regular activation and orders the window
-        // front (CI run 29804).
-        NSApp.setActivationPolicy(.regular)
-        for window in NSApp.windows {
-            configureMainWindow(window)
-            window.makeKeyAndOrderFront(nil)
-        }
-        NSApp.activate(ignoringOtherApps: true)
-    }
-
-    /// docs/21 §Shell: 1280×800 content, min 1100×700, centred.
-    /// GitHub-hosted Macs (and any display smaller than 1280×800) must
-    /// not get a window that hangs off-screen — XCTest then reports
-    /// sidebar controls at negative x as not hittable (run 34864198118).
-    private func configureMainWindow(_ window: NSWindow) {
-        let desired = NSSize(width: 1280, height: 800)
-        let minimum = NSSize(width: 1100, height: 700)
-        let visible = (window.screen ?? NSScreen.main)?.visibleFrame
-            ?? NSRect(origin: .zero, size: desired)
-
-        window.contentMinSize = NSSize(
-            width: min(minimum.width, visible.width),
-            height: min(minimum.height, visible.height)
-        )
-        window.setContentSize(NSSize(
-            width: min(desired.width, visible.width),
-            height: min(desired.height, max(minimum.height, visible.height - 40))
-        ))
-        window.center()
-
-        var frame = window.frame
-        if frame.width > visible.width {
-            frame.size.width = visible.width
-        }
-        if frame.height > visible.height {
-            frame.size.height = visible.height
-        }
-        frame.origin.x = min(
-            max(frame.origin.x, visible.minX),
-            visible.maxX - frame.width
-        )
-        frame.origin.y = min(
-            max(frame.origin.y, visible.minY),
-            visible.maxY - frame.height
-        )
-        window.setFrame(frame, display: true)
-    }
-
-    /// Dock-click reopen: let the WindowGroup re-show or recreate the
-    /// main window when none are visible.
-    func applicationShouldHandleReopen(_ sender: NSApplication, hasVisibleWindows flag: Bool) -> Bool {
-        true
-    }
-
     func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool {
         true
     }

Sources/ICCery/LicenseWindowView.swift

@@ -1,148 +0,0 @@
-import AppKit
-import SwiftUI
-
-/// Detailed license and attribution window (issue #31, docs/21 §Modals).
-struct LicenseWindowView: View {
-    @Environment(\.dismiss) private var dismiss
-
-    private let icceryLicense: String
-    private let argyllLicense: String
-
-    init() {
-        // ICCery license from LICENCE.md (embedded at compile time)
-        self.icceryLicense = """
-# LICENCE
-
-**Copyright (c) 2026 Gordon Bolton**  
-**All Rights Reserved.**
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), strictly to view the source code and execute the Software for the sole purpose of personal testing, evaluation, and providing feedback.
-
-Under this licence, you may **not**:
-
-* Modify, alter, or create derivative works of the Software.
-* Distribute, publish, or sublicense the Software or any derivatives.
-* Use the Software for any commercial or production purpose.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
----
-
-## Bundled ArgyllCMS sidecar binaries
-
-This application bundles and invokes command-line binaries from the Gronod fork of ArgyllCMS. Those binaries are licensed separately under the **GNU Affero General Public License v3 (AGPLv3)**. They are executed strictly as independent subprocesses — they are never linked, loaded, or incorporated into this application — and a copy of `License.txt` is shipped beside the binaries in `Resources/Argyll/`. The terms above apply only to the ICCery application source code, not to the ArgyllCMS binaries.
-"""
-
-        // ArgyllCMS license from bundled License.txt
-        if let url = Bundle.main.url(forResource: "License", withExtension: "txt", subdirectory: "Argyll"),
-           let content = try? String(contentsOf: url, encoding: .utf8) {
-            self.argyllLicense = content
-        } else {
-            self.argyllLicense = """
-ArgyllCMS license not found — run `scripts/fetch-argyll.sh` to bundle binaries and license.
-
-The ArgyllCMS binaries are licensed under the GNU Affero General Public License v3 (AGPLv3).
-A copy of the license should be present at Resources/Argyll/License.txt.
-
-See: https://git.i3omb.com/gronod/argyllcms/releases
-"""
-        }
-    }
-
-    var body: some View {
-        VStack(spacing: 0) {
-            // Title bar
-            HStack {
-                Text("Licenses & Attribution")
-                    .font(.headline)
-                    .foregroundStyle(Theme.text)
-                Spacer()
-                Button("Close") {
-                    dismiss()
-                }
-                .keyboardShortcut(.cancelAction)
-                .accessibilityIdentifier("closeLicenseBtn")
-            }
-            .padding(.horizontal, 20)
-            .padding(.vertical, 12)
-            .background(Theme.panel.opacity(0.9))
-
-            Divider()
-
-            ScrollView {
-                VStack(alignment: .leading, spacing: 24) {
-                    // Section 1: ICCery License
-                    licenseSection(
-                        title: "ICCery License",
-                        content: icceryLicense,
-                        identifier: "icceryLicenseSection"
-                    )
-
-                    Divider()
-
-                    // Section 2: ArgyllCMS License
-                    licenseSection(
-                        title: "ArgyllCMS License (AGPLv3)",
-                        content: argyllLicense,
-                        identifier: "argyllLicenseSection"
-                    )
-
-                    Divider()
-
-                    // Section 3: Attribution & Links
-                    VStack(alignment: .leading, spacing: 12) {
-                        Text("Attribution & Links")
-                            .font(.headline)
-                            .foregroundStyle(Theme.text)
-                            .accessibilityIdentifier("attributionHeader")
-
-                        VStack(alignment: .leading, spacing: 8) {
-                            Link("ArgyllCMS by Graeme Gill → https://www.argyllcms.com/",
-                                 destination: URL(string: "https://www.argyllcms.com/")!)
-                                .font(.callout)
-                                .foregroundStyle(Theme.accent)
-                                .accessibilityIdentifier("argyllUpstreamLink")
-
-                            Link("Gronod ArgyllCMS fork (v3.5.0-ICCery.1.x) → https://git.i3omb.com/gronod/argyllcms",
-                                 destination: URL(string: "https://git.i3omb.com/gronod/argyllcms")!)
-                                .font(.callout)
-                                .foregroundStyle(Theme.accent)
-                                .accessibilityIdentifier("argyllForkLink")
-                        }
-
-                        Text("ICCery bundles and invokes ArgyllCMS binaries as isolated subprocesses per AGPLv3 isolation requirements. The ArgyllCMS binaries are never linked, loaded, or incorporated into the ICCery application binary.")
-                            .font(.caption)
-                            .foregroundStyle(.secondary)
-                            .fixedSize(horizontal: false, vertical: true)
-                            .accessibilityIdentifier("agplIsolationNote")
-                    }
-                    .padding(.horizontal, 4)
-                    .accessibilityElement(children: .contain)
-                    .accessibilityIdentifier("attributionSection")
-                }
-                .padding(24)
-            }
-            .frame(minWidth: 600, minHeight: 500)
-            .background(Theme.panel)
-        }
-        .accessibilityElement(children: .contain)
-        .accessibilityIdentifier("licenseWindow")
-    }
-
-    private func licenseSection(title: String, content: String, identifier: String) -> some View {
-        VStack(alignment: .leading, spacing: 8) {
-            Text(title)
-                .font(.headline)
-                .foregroundStyle(Theme.text)
-                .accessibilityIdentifier(identifier + "Header")
-
-            Text(content)
-                .font(.system(.body, design: .monospaced))
-                .foregroundStyle(Theme.text)
-                .textSelection(.enabled)
-                .frame(maxWidth: .infinity, alignment: .leading)
-                .accessibilityIdentifier(identifier + "Content")
-        }
-        .padding(.horizontal, 4)
-    }
-}

Sources/ICCery/MeasurementWorkflowViewModel.swift

@@ -1,5 +1,5 @@
-import Combine
 import Foundation
+import Observation
 import SwiftUI
 import ICCeryCore
 
@@ -32,7 +32,8 @@ enum XYStep: Equatable, Sendable {
 
 /// Stage 3 workflow state and interaction (issues #18–#22).
 @MainActor
-final class MeasurementWorkflowViewModel: ObservableObject {
+@Observable
+final class MeasurementWorkflowViewModel {
 
     // MARK: - Authorities
 
@@ -41,37 +42,37 @@ final class MeasurementWorkflowViewModel: ObservableObject {
 
     // MARK: - Settings-driven thresholds
 
-    @Published private(set) var goodMax: Double = 2.0
-    @Published private(set) var warningMax: Double = 5.0
-    @Published private(set) var enableLEDs: Bool = false
+    private(set) var goodMax: Double = 2.0
+    private(set) var warningMax: Double = 5.0
+    private(set) var enableLEDs: Bool = false
 
     // MARK: - Instrument detection
 
-    @Published var instruments: [InstrumentDevice] = []
-    @Published var selectedInstrument: InstrumentSelection = .auto
-    @Published var isDetecting = false
-    @Published var detectionError: String?
+    var instruments: [InstrumentDevice] = []
+    var selectedInstrument: InstrumentSelection = .auto
+    var isDetecting = false
+    var detectionError: String?
 
     // MARK: - Chartread session
 
-    @Published var isChartreadRunning = false
-    @Published var chartreadState: ChartreadState = .idle
-    @Published var currentPrompt: String?
-    @Published var requestedWarningKey: String?
-    @Published var chartreadLog: [String] = []
-    @Published var rows: [ChartreadRow] = []
-    @Published var swatchRows: [SwatchRow] = []
-    @Published var showRemoveSheetNotice = false
-    /// Stage-local chartread error notice (`#chartreadLastError`, #80).
-    @Published var chartreadNotice: Notice?
+    var isChartreadRunning = false
+    var chartreadState: ChartreadState = .idle
+    var currentPrompt: String?
+    var requestedWarningKey: String?
+    var chartreadLog: [String] = []
+    var rows: [ChartreadRow] = []
+    var swatchRows: [SwatchRow] = []
+    var showRemoveSheetNotice = false
+    var lastError: String?
     private var chartreadTask: Task<Void, Never>?
 
     // MARK: - Averaging
 
-    @Published var passSnapshots: [URL] = []
-    @Published var isFinishing = false
-    @Published var finishNotice: Notice?
-    @Published var resumedFromTi2 = false
+    var passSnapshots: [URL] = []
+    var isFinishing = false
+    var finishNotice: String?
+    var finishNoticeIsError = false
+    var resumedFromTi2 = false
 
     init(wizard: WizardViewModel, environment: AppEnvironment) {
         self.wizard = wizard
@@ -185,7 +186,7 @@ final class MeasurementWorkflowViewModel: ObservableObject {
         isChartreadRunning = true
         chartreadState = .idle
         currentPrompt = nil
-        chartreadNotice = nil
+        lastError = nil
         chartreadLog.removeAll()
 
         // Optional: reset rows when starting a fresh first pass.
@@ -227,10 +228,7 @@ final class MeasurementWorkflowViewModel: ObservableObject {
 
         case .exit(let code):
             if code != 0 {
-                chartreadNotice = Notice(
-                    kind: .error,
-                    text: "chartread exited with code \(code)"
-                )
+                lastError = "chartread exited with code \(code)"
             }
 
         case .completed(let canonicalURL):
@@ -238,7 +236,7 @@ final class MeasurementWorkflowViewModel: ObservableObject {
             completePass(canonicalURL: canonicalURL)
 
         case .failed(let error):
-            chartreadNotice = Notice(kind: .error, text: error.localizedDescription)
+            lastError = error.localizedDescription
             chartreadState = .error
             isChartreadRunning = false
         }
@@ -384,10 +382,7 @@ final class MeasurementWorkflowViewModel: ObservableObject {
             discoverPassSnapshots()
             wizard.refreshGating()
         } catch {
-            chartreadNotice = Notice(
-                kind: .error,
-                text: "Could not snapshot pass: \(error.localizedDescription)"
-            )
+            lastError = "Could not snapshot pass: \(error.localizedDescription)"
         }
     }
 
@@ -403,32 +398,33 @@ final class MeasurementWorkflowViewModel: ObservableObject {
 
     func finishAndAverage() {
         guard !isFinishing, let cwd = workingDirectory, !passSnapshots.isEmpty else { return }
+        isFinishing = true
         finishNotice = nil
+        finishNoticeIsError = false
 
         Task { @MainActor [weak self] in
             guard let self else { return }
             do {
-                // No log reset: prior chartread output must be preserved.
-                let canonical = try await ProcessRunSupport.runLogged(
-                    setRunning: { self.isFinishing = $0 },
-                    resetLog: {},
-                    onLog: { self.chartreadLog.append(contentsOf: $0) }
-                ) { onLog in
-                    if self.passSnapshots.count == 1, let pass = self.passSnapshots.first {
-                        return try MeasurementArtefacts.promotePass(
-                            pass: pass,
-                            basename: self.basename,
-                            cwd: cwd
-                        )
-                    }
+                let canonical: URL
+                if self.passSnapshots.count == 1, let pass = self.passSnapshots.first {
+                    canonical = try MeasurementArtefacts.promotePass(
+                        pass: pass,
+                        basename: self.basename,
+                        cwd: cwd
+                    )
+                } else {
                     let config = AverageConfig(
                         workingDirectory: cwd,
                         basename: self.basename,
                         passFiles: self.passSnapshots
                     )
-                    return try await self.environment.runner.runAverage(
+                    canonical = try await self.environment.runner.runAverage(
                         config: config,
-                        onLogBatch: onLog
+                        onLogBatch: { [weak self] batch in
+                            Task { @MainActor [weak self] in
+                                self?.chartreadLog.append(contentsOf: batch)
+                            }
+                        }
                     )
                 }
                 self.discoverPassSnapshots()
@@ -436,11 +432,7 @@ final class MeasurementWorkflowViewModel: ObservableObject {
                 if self.wizard.isUnlocked(.buildProfile) {
                     self.wizard.go(to: .buildProfile)
                 } else {
-                    self.finishNotice = Notice(
-                        kind: .info,
-                        text: "Finished: \(canonical.lastPathComponent) ready.",
-                        autoHideAfter: nil
-                    )
+                    self.finishNotice = "Finished: \(canonical.lastPathComponent) ready."
                 }
             } catch {
                 // Fallback to pass 1 promotion if averaging failed.
@@ -453,26 +445,18 @@ final class MeasurementWorkflowViewModel: ObservableObject {
                         )
                         self.discoverPassSnapshots()
                         self.wizard.refreshGating()
-                        self.finishNotice = Notice(
-                            kind: .error,
-                            text: "Averaging failed — promoted first pass.",
-                            autoHideAfter: nil
-                        )
+                        self.finishNotice = "Averaging failed — promoted first pass."
+                        self.finishNoticeIsError = true
                     } catch {
-                        self.finishNotice = Notice(
-                            kind: .error,
-                            text: "Finish failed: \(error.localizedDescription)",
-                            autoHideAfter: nil
-                        )
+                        self.finishNotice = "Finish failed: \(error.localizedDescription)"
+                        self.finishNoticeIsError = true
                     }
                 } else {
-                    self.finishNotice = Notice(
-                        kind: .error,
-                        text: "Finish failed: \(error.localizedDescription)",
-                        autoHideAfter: nil
-                    )
+                    self.finishNotice = "Finish failed: \(error.localizedDescription)"
+                    self.finishNoticeIsError = true
                 }
             }
+            self.isFinishing = false
         }
     }
 }

Sources/ICCery/MediaLibraryDialogs.swift

@@ -1,278 +0,0 @@
-import SwiftUI
-import ICCeryCore
-
-/// `#saveMediaRecipeDialog` — capture the current printer + paper +
-/// ink + `.cal` bound to the selected preset (issue #146). Clones
-/// `SavePresetDialog` chrome; names render via `Text` only (#114).
-struct SaveMediaRecipeDialog: View {
-    @ObservedObject var workflow: TargetWorkflowViewModel
-    /// Observed directly: nested ObservableObjects are not tracked
-    /// through the parent's `objectWillChange`.
-    @ObservedObject private var media: MediaLibraryViewModel
-    @ObservedObject private var printSession: PrintSessionViewModel
-
-    init(workflow: TargetWorkflowViewModel) {
-        self.workflow = workflow
-        self._media = ObservedObject(wrappedValue: workflow.media)
-        self._printSession = ObservedObject(wrappedValue: workflow.print)
-    }
-
-    private var printerCaption: String {
-        let queue = printSession.selectedPrinter
-        guard !queue.isEmpty else { return "None" }
-        let display = printSession.printers
-            .first { $0.name == queue }?.displayName ?? queue
-        return "\(display) (\(queue))"
-    }
-
-    private func captureRow(
-        _ label: String, value: String, identifier: String
-    ) -> some View {
-        HStack {
-            Text(label).foregroundStyle(.secondary)
-            Spacer()
-            Text(value)
-                .foregroundStyle(Theme.text)
-                .lineLimit(1)
-                .truncationMode(.middle)
-                .accessibilityIdentifier(identifier)
-        }
-    }
-
-    private var saveDisabled: Bool {
-        media.saveMediaName.trimmingCharacters(in: .whitespaces).isEmpty
-            || media.saveMediaPaper.trimmingCharacters(in: .whitespaces).isEmpty
-            || media.saveMediaInk.trimmingCharacters(in: .whitespaces).isEmpty
-            || media.captureColourSpaceMismatch
-    }
-
-    // Swift 5.7 (Xcode 14.2 CI runner) caps a ViewBuilder body at 10
-    // children (#146); Group blocks are layout-transparent, so field
-    // order and every docs/21 id are unchanged.
-    private var fields: some View {
-        Group {
-            TextField("Name", text: $media.saveMediaName)
-                .textFieldStyle(.roundedBorder)
-                .accessibilityIdentifier("saveMediaName")
-            TextField("Notes (optional)", text: $media.saveMediaNotes)
-                .textFieldStyle(.roundedBorder)
-                .accessibilityIdentifier("saveMediaNotes")
-            TextField("Paper", text: $media.saveMediaPaper)
-                .textFieldStyle(.roundedBorder)
-                .accessibilityIdentifier("saveMediaPaper")
-            TextField("Ink set", text: $media.saveMediaInk)
-                .textFieldStyle(.roundedBorder)
-                .accessibilityIdentifier("saveMediaInk")
-        }
-    }
-
-    private var readOnlyRows: some View {
-        Group {
-            captureRow("Printer", value: printerCaption,
-                       identifier: "saveMediaPrinter")
-            captureRow("Preset",
-                       value: workflow.selectedPreset?.name ?? "No preset",
-                       identifier: "saveMediaPreset")
-            captureRow("Colour space",
-                       value: workflow.colourSpace.rawValue.uppercased(),
-                       identifier: "saveMediaColourSpace")
-            captureRow("Calibration",
-                       value: workflow.profile.calibrationFile.isEmpty
-                           ? "None" : workflow.profile.calibrationFile,
-                       identifier: "saveMediaCal")
-        }
-    }
-
-    var body: some View {
-        VStack(alignment: .leading, spacing: 14) {
-            Text("Save Media Recipe").font(.title3).foregroundStyle(Theme.text)
-            fields
-            readOnlyRows
-            Toggle("Apply calibration to profile",
-                   isOn: $media.saveMediaApplyCal)
-                .disabled(!media.calApplyable)
-                .accessibilityIdentifier("saveMediaApplyCal")
-
-            if media.captureColourSpaceMismatch {
-                Text("Colour space does not match the selected preset.")
-                    .font(.caption).foregroundStyle(.orange)
-            }
-            if let error = media.saveMediaError {
-                Text(error).font(.caption).foregroundStyle(.orange)
-            }
-
-            HStack {
-                Spacer()
-                Button("Cancel") { workflow.showingSaveMedia = false }
-                    .accessibilityIdentifier("btnCloseSaveMediaDialog")
-                Button("Save") {
-                    Task {
-                        if await media.captureFromSession() {
-                            workflow.showingSaveMedia = false
-                        }
-                    }
-                }
-                .disabled(saveDisabled)
-                .accessibilityIdentifier("btnConfirmSaveMedia")
-            }
-        }
-        .padding(20)
-        .frame(width: 380)
-        .background(Theme.background)
-        .accessibilityElement(children: .contain)
-        .accessibilityIdentifier("saveMediaRecipeDialog")
-    }
-}
-
-/// `#manageMediaDialog` — list, apply, delete, capture (issue #146).
-/// `List`, not `Table` — macOS 12 target. Clones `ManagePresetsDialog`.
-struct ManageMediaDialog: View {
-    @ObservedObject var workflow: TargetWorkflowViewModel
-    /// Observed directly: nested ObservableObjects are not tracked
-    /// through the parent's `objectWillChange`.
-    @ObservedObject private var media: MediaLibraryViewModel
-    @State private var selection: String?
-    @State private var pendingDelete: MediaRecipe?
-
-    init(workflow: TargetWorkflowViewModel) {
-        self.workflow = workflow
-        self._media = ObservedObject(wrappedValue: workflow.media)
-    }
-
-    private func presetCaption(for recipe: MediaRecipe) -> String {
-        workflow.presets.first { $0.id == recipe.presetID }?.name
-            ?? "Missing preset"
-    }
-
-    private func calCaption(for recipe: MediaRecipe) -> String {
-        if media.staleReasons[recipe.id]?.contains(.calibration) == true {
-            return "Stale"
-        }
-        if let days = media.calAgeDays[recipe.id] {
-            return "Cal \(days)d"
-        }
-        return "No cal"
-    }
-
-    private func applyAndDismiss(_ recipe: MediaRecipe) {
-        Task {
-            if await media.apply(recipe) {
-                workflow.showingManageMedia = false
-            }
-        }
-    }
-
-    private func presetMissing(_ recipe: MediaRecipe) -> Bool {
-        !workflow.presets.contains { $0.id == recipe.presetID }
-    }
-
-    private func calStale(_ recipe: MediaRecipe) -> Bool {
-        media.staleReasons[recipe.id]?.contains(.calibration) == true
-    }
-
-    @ViewBuilder
-    private func row(_ recipe: MediaRecipe) -> some View {
-        HStack {
-            VStack(alignment: .leading, spacing: 2) {
-                Text(recipe.name).foregroundStyle(Theme.text)
-                Text("\(recipe.printerDisplayName) · \(recipe.paperName) · \(recipe.inkSet)")
-                    .font(.caption).foregroundStyle(.secondary)
-                HStack(spacing: 8) {
-                    Text(presetCaption(for: recipe))
-                        .font(.caption)
-                        .foregroundStyle(presetMissing(recipe) ? .orange : .secondary)
-                    Text(calCaption(for: recipe))
-                        .font(.caption)
-                        .foregroundStyle(calStale(recipe) ? .orange : .secondary)
-                }
-            }
-            Spacer()
-            Button("Apply") { applyAndDismiss(recipe) }
-                .accessibilityIdentifier("btnMediaLibraryApply-\(recipe.id)")
-            Button("Delete", role: .destructive) {
-                pendingDelete = recipe
-            }
-            .accessibilityIdentifier("btnMediaLibraryDelete-\(recipe.id)")
-        }
-        .accessibilityElement(children: .contain)
-        .accessibilityIdentifier("mediaRow-\(recipe.id)")
-        .tag(recipe.id)
-        .contentShape(Rectangle())
-        .simultaneousGesture(
-            TapGesture(count: 2).onEnded { applyAndDismiss(recipe) }
-        )
-    }
-
-    var body: some View {
-        VStack(alignment: .leading, spacing: 12) {
-            Text("Manage Media Recipes").font(.title3).foregroundStyle(Theme.text)
-
-            List(selection: $selection) {
-                if media.recipes.isEmpty {
-                    Text("No media recipes yet. Capture the current printer, paper and preset.")
-                        .font(.callout).foregroundStyle(.secondary)
-                        .accessibilityIdentifier("mediaLibraryEmpty")
-                }
-                ForEach(media.recipes) { recipe in
-                    row(recipe)
-                }
-            }
-            .accessibilityIdentifier("mediaLibraryList")
-            .frame(minHeight: 260)
-
-            if let notice = media.manageApplyNotice {
-                Text(notice)
-                    .font(.callout)
-                    .foregroundStyle(.orange)
-                    .fixedSize(horizontal: false, vertical: true)
-                    .accessibilityIdentifier("manageMediaNotice")
-                    .accessibilityValue(notice)
-            }
-
-            HStack {
-                Button("Apply selected") {
-                    if let id = selection,
-                       let recipe = media.recipes.first(where: { $0.id == id }) {
-                        applyAndDismiss(recipe)
-                    }
-                }
-                .disabled(selection == nil)
-                .keyboardShortcut(.defaultAction)
-                .accessibilityIdentifier("btnMediaLibraryApply")
-                Button("Capture current…") {
-                    media.captureAfterManageDismiss = true
-                    workflow.showingManageMedia = false
-                }
-                .accessibilityIdentifier("btnMediaLibraryCaptureFromManage")
-                Spacer()
-                Button("Close") { workflow.showingManageMedia = false }
-                    .accessibilityIdentifier("btnCloseManageMediaDialog")
-            }
-        }
-        .padding(20)
-        .frame(width: 640)
-        .background(Theme.background)
-        .accessibilityElement(children: .contain)
-        .accessibilityIdentifier("manageMediaDialog")
-        .onAppear {
-            media.reload()
-            media.refreshStaleness()
-        }
-        .alert(
-            "Delete media recipe?",
-            isPresented: Binding(
-                get: { pendingDelete != nil },
-                set: { if !$0 { pendingDelete = nil } }
-            ),
-            presenting: pendingDelete
-        ) { recipe in
-            Button("Cancel", role: .cancel) { pendingDelete = nil }
-            Button("Delete", role: .destructive) {
-                media.delete(recipe)
-                pendingDelete = nil
-            }
-        } message: { recipe in
-            Text("Delete \"\(recipe.name)\"? This does not delete the .cal or the preset.")
-        }
-    }
-}

Sources/ICCery/MediaLibraryViewModel.swift

@@ -1,429 +0,0 @@
-import Combine
-import Foundation
-import ICCeryCore
-
-/// Media recipe library: capture / apply / staleness for issue #146.
-///
-/// A recipe binds a CUPS queue + paper + ink + `.cal` to a
-/// `ProfilingPreset`. Applying a recipe goes through the existing
-/// `applyPreset` (#82) path — there is no second Stage 1 form. Paper
-/// and ink are library metadata only; they are never written to the
-/// targen label fields.
-@MainActor
-final class MediaLibraryViewModel: ObservableObject {
-
-    /// Why a recipe row is flagged stale.
-    struct StaleReason: OptionSet {
-        let rawValue: Int
-        static let calibration = StaleReason(rawValue: 1 << 0)
-        static let printer = StaleReason(rawValue: 1 << 1)
-    }
-
-    let workflow: TargetWorkflowViewModel
-    let environment: AppEnvironment
-    private let store: MediaLibraryStore
-    private var cancellables = Set<AnyCancellable>()
-
-    @Published var recipes: [MediaRecipe] = []
-    /// Sidebar picker selection; `"none"` = no media recipe. Written
-    /// only on a successful apply so a failed apply snaps back.
-    @Published var selectedRecipeID = "none"
-    /// `recipe.id` → stale reasons for the sidebar badge / manage sheet.
-    @Published var staleReasons: [String: StaleReason] = [:]
-    /// `recipe.id` → whole days since the bound `.cal` was created.
-    @Published var calAgeDays: [String: Int] = [:]
-
-    // Save-sheet state (mirrors savePresetName/savePresetDesc).
-    @Published var saveMediaName = ""
-    @Published var saveMediaNotes = ""
-    @Published var saveMediaPaper = ""
-    @Published var saveMediaInk = ""
-    @Published var saveMediaApplyCal = false
-    /// Inline caption inside the capture sheet (no a11y id — roster complete).
-    @Published var saveMediaError: String?
-    /// Last failed Apply while Manage is open. The window banner sits
-    /// behind the sheet on Monterey, so the dialog shows this too (#170).
-    @Published var manageApplyNotice: String?
-
-    /// Pure flow flag — the manage sheet's "Capture current…" asks the
-    /// sheet's `onDismiss` to open the capture sheet, avoiding a
-    /// present-while-dismissing race.
-    var captureAfterManageDismiss = false
-
-    init(workflow: TargetWorkflowViewModel, environment: AppEnvironment) {
-        self.workflow = workflow
-        self.environment = environment
-        self.store = environment.mediaStore
-
-        reload()
-        refreshStaleness()
-        // The library needs queues enumerated at launch so Capture can
-        // enable and the not-installed badge is computable; Stage 2 only
-        // enumerates when a printtarg manifest exists.
-        if workflow.print.printers.isEmpty {
-            workflow.print.refreshPrinters()
-        }
-
-        NotificationCenter.default
-            .publisher(for: SettingsStore.settingsDidChange)
-            .sink { [weak self] _ in self?.refreshStaleness() }
-            .store(in: &cancellables)
-        workflow.print.$printers
-            .sink { [weak self] _ in self?.refreshStaleness() }
-            .store(in: &cancellables)
-        workflow.print.$selectedPrinter
-            .sink { [weak self] _ in self?.refreshStaleness() }
-            .store(in: &cancellables)
-    }
-
-    deinit { cancellables.removeAll() }
-
-    // MARK: - Load / corrupt
-
-    func reload() {
-        Task { await reloadAsync() }
-    }
-
-    func reloadAsync() async {
-        do {
-            recipes = try await store.load()
-        } catch {
-            // Corrupt-file policy: keep the file, keep the cache,
-            // persistent warning; the picker falls back to "none".
-            workflow.wizard.showNotice(
-                "Media library is unreadable — the existing file was kept.",
-                kind: .warning,
-                autoHideAfter: nil
-            )
-            if recipes.isEmpty { selectedRecipeID = "none" }
-        }
-    }
-
-    // MARK: - Selection / apply
-
-    /// Sidebar `mediaSelect` binding. `"none"` clears the selection
-    /// without resetting any Stage 1/2/4 field — it is not "reset to
-    /// factory".
-    func selectRecipe(_ id: String) {
-        if id == "none" {
-            selectedRecipeID = "none"
-            return
-        }
-        guard let recipe = recipes.first(where: { $0.id == id }) else { return }
-        Task { _ = await apply(recipe) }
-    }
-
-    /// The single apply path — sidebar picker, manage-row Apply, and
-    /// the manage footer all funnel here.
-    ///
-    /// Returns `false` when any bound resource is unresolved (missing
-    /// preset, colour-space mismatch, queue absent, missing/unparseable
-    /// `.cal`) so the manage sheet stays open and the picker reverts.
-    /// A `CAL_`-blocked calibration counts as applied (`true` — success
-    /// with warning; the refusal is permanent so re-clicking can't help).
-    @discardableResult
-    func apply(_ recipe: MediaRecipe) async -> Bool {
-        manageApplyNotice = nil
-        guard let r = try? recipe.validated() else {
-            return failApply("Media recipe is invalid — not applied.", kind: .error)
-        }
-        guard let preset = environment.presetStore.all()
-            .first(where: { $0.id == r.presetID })
-        else {
-            return failApply(
-                "Preset \(r.presetID) no longer exists — recipe not applied.",
-                kind: .error)
-        }
-        guard preset.colourSpace.lowercased() == r.colourSpace.lowercased() else {
-            return failApply(
-                "Recipe colour space does not match its preset — not applied.",
-                kind: .error)
-        }
-
-        // Existing #82 mapping: presetSelect jumps, Stage 1/2/4 fields.
-        workflow.applyPreset(preset)
-        // Literal per issue: displayName, not the queue id.
-        workflow.wizard.printerName = r.printerDisplayName
-
-        // Queue: enumerate fresh via the session's serialized path —
-        // listPrinters uses fixed process ids, so an overlapping
-        // enumeration would throw duplicateID. An empty result is a
-        // valid list.
-        if let queues = await workflow.print.enumeratePrinters() {
-            if queues.contains(where: { $0.name == r.printerID }) {
-                workflow.print.selectedPrinter = r.printerID
-                await workflow.print.reloadSelectedCapabilities()
-            } else {
-                return failApply(
-                    "Printer \(r.printerDisplayName) is not installed.",
-                    kind: .warning)
-            }
-        } else {
-            return failApply(
-                "Could not enumerate printers — queue left unchanged.",
-                kind: .warning)
-        }
-
-        // Calibration — the recipe is authoritative and runs after
-        // applyPreset so the preset's own cal fields don't win.
-        let calPath = r.calibrationURL?.trimmingCharacters(in: .whitespaces) ?? ""
-        let calStem = URL(fileURLWithPath: calPath)
-            .deletingPathExtension().lastPathComponent
-        let blocked = r.applyCalibration && !calPath.isEmpty
-            && (CalibrationIdentity.isCalibration(calStem)
-                || CalibrationIdentity.isCalibration(workflow.wizard.basename))
-
-        if blocked {
-            // Literal CAL_ refusal on both names (decision 1): keep the
-            // path for display but never let `printtarg -K` see it.
-            workflow.profile.applyCalibration = false
-            workflow.profile.calibrationFile = calPath
-            selectedRecipeID = r.id
-            refreshStaleness()
-            workflow.wizard.showNotice(
-                "Applied \(r.name) — CAL_ calibrations cannot enable printtarg -K.",
-                kind: .warning,
-                autoHideAfter: nil)
-            return true
-        }
-
-        if r.applyCalibration && !calPath.isEmpty {
-            guard FileManager.default.fileExists(atPath: calPath) else {
-                workflow.profile.applyCalibration = false
-                workflow.profile.calibrationFile = calPath
-                return failApply(
-                    "Calibration file is missing: \(calPath)", kind: .error)
-            }
-            do {
-                let staleDays = environment.settingsStore.load().calibrationStaleDays
-                let calStore = CalibrationStore(staleDays: staleDays)
-                try await calStore.load(url: URL(fileURLWithPath: calPath))
-                workflow.profile.calibrationFile = calPath
-                workflow.profile.applyCalibration = true
-                // Age check only — the .cal DESCRIPTOR is free text, not
-                // a queue id, so a name compare false-positives.
-                if await calStore.isStale() {
-                    workflow.wizard.showNotice(
-                        "Applied \(r.name) — calibration is stale.",
-                        kind: .warning)
-                }
-            } catch {
-                workflow.profile.applyCalibration = false
-                return failApply(
-                    "Could not load calibration: \(error.localizedDescription)",
-                    kind: .error)
-            }
-        } else {
-            workflow.profile.applyCalibration = false
-            workflow.profile.calibrationFile = calPath
-        }
-
-        selectedRecipeID = r.id
-        workflow.wizard.showNotice("Applied \(r.name)")
-        refreshStaleness()
-        return true
-    }
-
-    private func failApply(_ text: String, kind: Notice.Kind) -> Bool {
-        manageApplyNotice = text
-        workflow.wizard.showNotice(text, kind: kind)
-        refreshStaleness()
-        return false
-    }
-
-    // MARK: - Capture
-
-    /// Whether the live `profile.calibrationFile` may be applied:
-    /// non-empty, not a `CAL_` stem, and present on disk.
-    var calApplyable: Bool {
-        let path = workflow.profile.calibrationFile
-        guard !path.isEmpty else { return false }
-        let stem = URL(fileURLWithPath: path)
-            .deletingPathExtension().lastPathComponent
-        guard !CalibrationIdentity.isCalibration(stem) else { return false }
-        return FileManager.default.fileExists(atPath: path)
-    }
-
-    /// A bound preset whose colour space disagrees with the live form —
-    /// the sheet shows the mismatch caption and disables Save.
-    var captureColourSpaceMismatch: Bool {
-        guard let preset = workflow.selectedPreset else { return false }
-        return preset.colourSpace.lowercased() != workflow.colourSpace.rawValue
-    }
-
-    /// Opens the capture sheet, prefilled from the selected recipe else
-    /// the most recently captured one ("last recipe … or empty").
-    func beginCapture() {
-        let source = recipes.first(where: { $0.id == selectedRecipeID })
-            ?? recipes.last
-        saveMediaPaper = source?.paperName ?? ""
-        saveMediaInk = source?.inkSet ?? ""
-        saveMediaName = ""
-        saveMediaNotes = ""
-        saveMediaError = nil
-        saveMediaApplyCal = workflow.profile.applyCalibration && calApplyable
-        if workflow.print.printers.isEmpty {
-            workflow.print.refreshPrinters()
-        }
-        workflow.showingSaveMedia = true
-    }
-
-    /// Save button — the sheet closes only on `true`.
-    func captureFromSession() async -> Bool {
-        let name = saveMediaName.trimmingCharacters(in: .whitespacesAndNewlines)
-        let paper = saveMediaPaper.trimmingCharacters(in: .whitespacesAndNewlines)
-        let ink = saveMediaInk.trimmingCharacters(in: .whitespacesAndNewlines)
-        guard !name.isEmpty, !paper.isEmpty, !ink.isEmpty else {
-            saveMediaError = "Name, paper and ink are required."
-            return false
-        }
-
-        let queue = workflow.print.selectedPrinter
-        guard !queue.isEmpty else {
-            saveMediaError = "Select a printer in Stage 2 first."
-            return false
-        }
-
-        // Preset binding: the selected preset when its colour space
-        // matches the live form; otherwise auto-snapshot the live form
-        // as a custom preset (decision 2).
-        let presetID: String
-        if let bound = workflow.selectedPreset {
-            guard bound.colourSpace.lowercased() == workflow.colourSpace.rawValue else {
-                saveMediaError = "Colour space does not match the selected preset."
-                return false
-            }
-            presetID = bound.id
-        } else {
-            let snapshot = ProfilingPreset(
-                id: "custom-\(UUID().uuidString.lowercased())",
-                name: name,
-                description: "Auto-saved for media recipe",
-                targen: workflow.buildTargenConfig(),
-                printtarg: workflow.buildPrinttargConfig(),
-                colprof: workflow.profile.buildColprofConfig(),
-                calibrationFile: nil,
-                applyCalibration: nil
-            )
-            do {
-                try environment.presetStore.saveCustom(snapshot)
-                workflow.reloadPresets()
-                workflow.selectedPresetID = snapshot.id
-            } catch {
-                saveMediaError = "Could not save preset: \(error.localizedDescription)"
-                return false
-            }
-            presetID = snapshot.id
-        }
-
-        // The cal path is stored verbatim; applyCalibration is forced
-        // off for CAL_/missing paths via calApplyable.
-        let calPath = workflow.profile.calibrationFile
-        let printer = workflow.print.printers.first { $0.name == queue }
-        let now = Date()
-        let recipe = MediaRecipe(
-            id: "recipe-\(UUID().uuidString.lowercased())",
-            name: name,
-            notes: saveMediaNotes.trimmingCharacters(in: .whitespacesAndNewlines),
-            printerID: queue,
-            printerDisplayName: printer?.displayName ?? queue,
-            paperName: paper,
-            driverMediaType: workflow.print.selectedMediaType,
-            inkSet: ink,
-            colourSpace: workflow.colourSpace.rawValue,
-            presetID: presetID,
-            calibrationURL: calPath.isEmpty ? nil : calPath,
-            applyCalibration: saveMediaApplyCal && calApplyable,
-            created: now,
-            updated: now
-        )
-
-        do {
-            let validated = try recipe.validated()
-            try await store.upsert(validated)
-            await reloadAsync()
-            selectedRecipeID = validated.id
-            workflow.wizard.showNotice("Media recipe saved: \(validated.name)")
-            return true
-        } catch let error as MediaLibraryStore.MediaLibraryError {
-            saveMediaError = error.errorDescription
-            return false
-        } catch {
-            saveMediaError = "Could not save: \(error.localizedDescription)"
-            return false
-        }
-    }
-
-    // MARK: - Delete
-
-    func delete(_ recipe: MediaRecipe) {
-        Task {
-            do {
-                try await store.delete(id: recipe.id)
-                await reloadAsync()
-                if selectedRecipeID == recipe.id {
-                    selectedRecipeID = "none"
-                }
-            } catch {
-                workflow.wizard.showNotice(
-                    "Could not delete: \(error.localizedDescription)",
-                    kind: .error)
-            }
-        }
-    }
-
-    // MARK: - Staleness
-
-    func refreshStaleness() {
-        Task { await refreshStalenessAsync() }
-    }
-
-    /// Recomputes `staleReasons` + `calAgeDays` for every recipe.
-    ///
-    /// `.printer` fires only when `printerID` is absent from a
-    /// **non-empty** enumerated queue list — an un-enumerated list is
-    /// indeterminate, not stale (decision 5). `.calibration` is a pure
-    /// age check (`isStale()` with no `comparedTo:`) — the `.cal`
-    /// DESCRIPTOR is free text, not a queue id.
-    func refreshStalenessAsync() async {
-        let staleDays = environment.settingsStore.load().calibrationStaleDays
-        let queues = workflow.print.printers
-        let now = Date()
-        let calStore = CalibrationStore(staleDays: staleDays)
-
-        var reasons: [String: StaleReason] = [:]
-        var ages: [String: Int] = [:]
-        for r in recipes {
-            var flags: StaleReason = []
-            if !queues.isEmpty, !queues.contains(where: { $0.name == r.printerID }) {
-                flags.insert(.printer)
-            }
-            if let raw = r.calibrationURL?.trimmingCharacters(in: .whitespaces),
-               !raw.isEmpty,
-               FileManager.default.fileExists(atPath: raw),
-               (try? await calStore.load(url: URL(fileURLWithPath: raw))) != nil,
-               let created = await calStore.data?.created {
-                ages[r.id] = Calendar.current
-                    .dateComponents([.day], from: created, to: now).day ?? 0
-                if await calStore.isStale() {
-                    flags.insert(.calibration)
-                }
-            }
-            if !flags.isEmpty { reasons[r.id] = flags }
-        }
-        staleReasons = reasons
-        calAgeDays = ages
-    }
-
-    // MARK: - Manage sheet flow
-
-    /// Called from the manage sheet's `onDismiss`. A deferred capture
-    /// request opens the save sheet only now, after the manage sheet has
-    /// fully dismissed.
-    func manageDismissed() {
-        if captureAfterManageDismiss {
-            captureAfterManageDismiss = false
-            beginCapture()
-        }
-    }
-}

Sources/ICCery/NoticeBanner.swift

@@ -21,14 +21,6 @@ struct Notice: Identifiable, Equatable {
             case .error:   return .red
             }
         }
-
-        var accessibilityValue: String {
-            switch self {
-            case .info:    return "info"
-            case .warning: return "warning"
-            case .error:   return "error"
-            }
-        }
     }
 
     let id = UUID()

Sources/ICCery/PresetDialogs.swift

@@ -4,7 +4,7 @@ import ICCeryCore
 /// `#savePresetDialog` — save the live Stage 1/2 form as a custom
 /// preset (issue #11). Names/descriptions render via `Text` only (#114).
 struct SavePresetDialog: View {
-    @ObservedObject var workflow: TargetWorkflowViewModel
+    @Bindable var workflow: TargetWorkflowViewModel
 
     var body: some View {
         VStack(alignment: .leading, spacing: 14) {
@@ -35,7 +35,7 @@ struct SavePresetDialog: View {
 
 /// `#managePresetsDialog` — list, delete (custom only), import, export.
 struct ManagePresetsDialog: View {
-    @ObservedObject var workflow: TargetWorkflowViewModel
+    @Bindable var workflow: TargetWorkflowViewModel
 
     var body: some View {
         VStack(alignment: .leading, spacing: 12) {

Sources/ICCery/Print/PrintSessionViewModel.swift

@@ -1,200 +0,0 @@
-import Combine
-import Foundation
-import ICCeryCore
-
-/// CUPS queue selection, bound print panel, and `lp` spool (issues 12–15, 17 / #85).
-@MainActor
-final class PrintSessionViewModel: ObservableObject {
-    let wizard: WizardViewModel
-    let environment: AppEnvironment
-
-    @Published var printers: [Printer] = []
-    @Published var selectedPrinter = ""
-    @Published var printerCaps = PrinterCapabilities()
-    @Published var selectedTray: Int?
-    @Published var selectedMediaType: String?
-    @Published var printOrientation = "portrait"
-    @Published var capturedCupsOptions: [String: String] = [:]
-    @Published var printNotice: Notice?
-    @Published var isPrinting = false
-    private var printTask: Task<Void, Never>?
-
-    init(wizard: WizardViewModel, environment: AppEnvironment) {
-        self.wizard = wizard
-        self.environment = environment
-    }
-
-    private var printerEnumTask: Task<[Printer]?, Never>?
-
-    func refreshPrinters() {
-        Task { @MainActor in _ = await enumeratePrinters() }
-    }
-
-    /// Serialized queue enumeration — `listPrinters` uses fixed process
-    /// ids, so overlapping calls would throw `duplicateID`. Concurrent
-    /// callers coalesce onto the in-flight task (#146).
-    @discardableResult
-    func enumeratePrinters() async -> [Printer]? {
-        if let pending = printerEnumTask { return await pending.value }
-        let task = Task { @MainActor [weak self] () -> [Printer]? in
-            guard let self else { return nil }
-            do {
-                let list = try await self.environment.cupsService.listPrinters()
-                self.printers = list
-                if !list.contains(where: { $0.name == self.selectedPrinter }) {
-                    self.selectedPrinter = list.first { $0.isDefault }?.name
-                        ?? list.first?.name ?? ""
-                }
-                await self.reloadSelectedCapabilities()
-                return list
-            } catch {
-                self.printNotice = Notice(
-                    kind: .error,
-                    text: "Could not list printers: \(error.localizedDescription)"
-                )
-                return nil
-            }
-        }
-        printerEnumTask = task
-        let result = await task.value
-        printerEnumTask = nil
-        return result
-    }
-
-    func reloadSelectedCapabilities() async {
-        guard !selectedPrinter.isEmpty else {
-            printerCaps = PrinterCapabilities()
-            return
-        }
-        do {
-            printerCaps = try await environment.cupsService
-                .capabilities(for: selectedPrinter)
-            if selectedMediaType == nil {
-                selectedMediaType = printerCaps.mediaTypes.first?.id
-            }
-            if selectedTray == nil {
-                selectedTray = printerCaps.trays.first?.id
-            }
-        } catch {
-            printerCaps = PrinterCapabilities()
-        }
-    }
-
-    func openPrinterPreferences() {
-        guard !selectedPrinter.isEmpty else { return }
-        let queue = selectedPrinter
-        let displayName = printers.first { $0.name == queue }?.displayName
-        let cups = environment.cupsService
-        Task { @MainActor in
-            do {
-                guard let result = try await PrintPanelService()
-                    .showProperties(
-                        queue: queue, displayName: displayName,
-                        cupsService: cups)
-                else {
-                    printNotice = Notice(
-                        kind: .info,
-                        text: "Printer properties dialog cancelled.",
-                        autoHideAfter: nil
-                    )
-                    return
-                }
-                if let selected = result.selectedPrinter,
-                   printers.contains(where: { $0.name == selected }),
-                   selected != queue {
-                    selectedPrinter = selected
-                    await reloadSelectedCapabilities()
-                }
-                if let captured = result.options.cupsOptions {
-                    capturedCupsOptions[selectedPrinter] = captured
-                }
-                if let media = result.options.mediaType {
-                    selectedMediaType = media
-                }
-                printNotice = Notice(
-                    kind: .info,
-                    text: "Settings captured for \(selectedPrinter).",
-                    autoHideAfter: nil
-                )
-            } catch {
-                printNotice = Notice(kind: .error, text: error.localizedDescription)
-            }
-        }
-    }
-
-    func printAllPages(from result: PrinttargResult, pageSize: PageSize) {
-        guard !isPrinting else { return }
-        isPrinting = true
-        let task = Task { @MainActor [weak self] in
-            guard let self else { return }
-            // `defer` cannot mutate isolated state under Swift 5.7
-            // (Xcode 14.2 / macOS 12 runner), so clear explicitly (#113).
-            var printed = 0
-            for page in result.pages {
-                do {
-                    try await spool(page, index: page.index, pageSize: pageSize)
-                    printed += 1
-                } catch {
-                    printNotice = Notice(
-                        kind: .error,
-                        text: "Print failed on \(page.page.filename): "
-                            + error.localizedDescription
-                    )
-                    isPrinting = false
-                    self.printTask = nil
-                    return
-                }
-            }
-            printNotice = Notice(
-                kind: .info,
-                text: "Sent \(printed) page(s) to \(selectedPrinter).",
-                autoHideAfter: nil
-            )
-            isPrinting = false
-            self.printTask = nil
-        }
-        printTask = task
-    }
-
-    func printPage(_ page: GalleryPage, pageSize: PageSize) {
-        guard !isPrinting else { return }
-        isPrinting = true
-        let task = Task { @MainActor [weak self] in
-            guard let self else { return }
-            do {
-                try await spool(page, index: page.index, pageSize: pageSize)
-                printNotice = Notice(
-                    kind: .info,
-                    text: "Sent \(page.page.filename) to \(selectedPrinter).",
-                    autoHideAfter: nil
-                )
-            } catch {
-                printNotice = Notice(
-                    kind: .error,
-                    text: "Print failed: \(error.localizedDescription)"
-                )
-            }
-            isPrinting = false
-            self.printTask = nil
-        }
-        printTask = task
-    }
-
-    private func spool(_ page: GalleryPage, index: Int, pageSize: PageSize) async throws {
-        guard !selectedPrinter.isEmpty else {
-            throw CupsError.noPrinterSelected
-        }
-        let options = PrintOptions(
-            orientation: printOrientation,
-            paperSize: pageSize == .custom ? nil : pageSize.rawValue,
-            mediaType: selectedMediaType,
-            ppdUncorrectedPassthrough: true,
-            cupsOptions: capturedCupsOptions[selectedPrinter])
-        try await environment.cupsService.printTarget(
-            queue: selectedPrinter,
-            tiffPath: page.fileURL.path,
-            options: options,
-            page: index)
-        wizard.printerName = selectedPrinter
-    }
-}

Sources/ICCery/ProcessLogView.swift

@@ -1,27 +0,0 @@
-import SwiftUI
-
-/// Shared monospaced process-log disclosure used by Stage 1 and Stage 2.
-struct ProcessLogView: View {
-    let lines: [String]
-    var minHeight: CGFloat = 120
-    var maxHeight: CGFloat = 200
-    var containerId: String
-    var logId: String
-
-    var body: some View {
-        DisclosureGroup("Process log") {
-            ScrollView {
-                Text(lines.joined(separator: "\n"))
-                    .font(.system(.caption, design: .monospaced))
-                    .foregroundStyle(Theme.text)
-                    .frame(maxWidth: .infinity, alignment: .leading)
-                    .textSelection(.enabled)
-            }
-            .frame(minHeight: minHeight, maxHeight: maxHeight)
-            .accessibilityIdentifier(logId)
-        }
-        .foregroundStyle(Theme.text)
-        .accessibilityElement(children: .contain)
-        .accessibilityIdentifier(containerId)
-    }
-}

Sources/ICCery/ProcessRunSupport.swift

@@ -1,29 +0,0 @@
-import Foundation
-
-/// Shared hop for coalesced Argyll log batches (issue #80).
-/// The runner invokes the sink off the main actor; this is the single hop back.
-enum ProcessRunSupport {
-    static func logSink(
-        _ apply: @escaping @MainActor @Sendable ([String]) -> Void
-    ) -> @Sendable ([String]) -> Void {
-        { batch in
-            Task { @MainActor in apply(batch) }
-        }
-    }
-
-    /// Wraps a runner call with running/log bookkeeping.
-    /// `work` stays on the main actor so `T` does not cross isolation
-    /// (Swift 6: non-Sendable generic return from a nonisolated async fn).
-    @MainActor
-    static func runLogged<T>(
-        setRunning: (Bool) -> Void,
-        resetLog: () -> Void,
-        onLog: @escaping @MainActor @Sendable ([String]) -> Void,
-        work: @MainActor @escaping (@escaping @Sendable ([String]) -> Void) async throws -> T
-    ) async throws -> T {
-        setRunning(true)
-        resetLog()
-        defer { setRunning(false) }
-        return try await work(logSink(onLog))
-    }
-}

Sources/ICCery/ProfileWorkflowViewModel.swift

@@ -1,11 +1,31 @@
-import Combine
 import Foundation
+import Observation
 import SwiftUI
 import ICCeryCore
 
+/// User-facing FWA selection for the Stage 4 form.
+enum ColprofFwaSelection: String, CaseIterable, Sendable, Equatable {
+    case none = "none"
+    case empty = ""
+    case D50 = "D50"
+    case D65 = "D65"
+    case custom = "custom"
+
+    var displayName: String {
+        switch self {
+        case .none: return "None"
+        case .empty: return "Bare (-f)"
+        case .D50: return "D50"
+        case .D65: return "D65"
+        case .custom: return "Custom .sp"
+        }
+    }
+}
+
 /// Stage 4/5 workflow: build a profile, verify it, track drift, and install.
 @MainActor
-final class ProfileWorkflowViewModel: ObservableObject {
+@Observable
+final class ProfileWorkflowViewModel {
 
     let wizard: WizardViewModel
     let environment: AppEnvironment
@@ -13,50 +33,51 @@ final class ProfileWorkflowViewModel: ObservableObject {
 
     // MARK: - Stage 4 form
 
-    @Published var algorithm: String = "l"      // l | x | X | m
-    @Published var quality: String = "m"        // l | m | h | u
-    @Published var intent: String = ""          // usually empty at Stage 4
-    @Published var fwaSelection: ColprofFwaSelection = .none
-    @Published var fwaCustomPath: String = ""
-    @Published var illuminant: String = ""
-    @Published var observer: String = ""
-    @Published var inputViewingCond: String = ""
-    @Published var outputViewingCond: String = ""
-    @Published var profileDescription: String = ""
-    @Published var copyright: String = ""
+    var algorithm: String = "l"      // l | x | X | m
+    var quality: String = "m"        // l | m | h | u
+    var intent: String = ""          // usually empty at Stage 4
+    var fwaSelection: ColprofFwaSelection = .none
+    var fwaCustomPath: String = ""
+    var illuminant: String = ""
+    var observer: String = ""
+    var inputViewingCond: String = ""
+    var outputViewingCond: String = ""
+    var profileDescription: String = ""
+    var copyright: String = ""
 
     // MARK: - Run state
 
-    @Published var isColprofRunning = false
-    @Published var colprofLog: [String] = []
-    @Published var colprofProgress: String?
-    @Published var createdProfileURL: URL?
+    var isColprofRunning = false
+    var colprofLog: [String] = []
+    var colprofProgress: String?
+    var lastError: String?
+    var createdProfileURL: URL?
     /// Path to the `.gam` gamut mesh extracted post-`colprof` (issue #28).
-    @Published var createdGamutURL: URL?
+    var createdGamutURL: URL?
 
     // MARK: - Stage 4/5 calibration (issue #24)
 
-    @Published var applyCalibration = false
-    @Published var calibrationFile: String = ""
+    var applyCalibration = false
+    var calibrationFile: String = ""
 
     // MARK: - Stage 5 verification (issue #25)
 
-    @Published var profcheckReport: ProfcheckReport?
-    @Published var profcheckWarning: String?
-    @Published var isProfcheckRunning = false
+    var profcheckReport: ProfcheckReport?
+    var profcheckWarning: String?
+    var isProfcheckRunning = false
 
     // MARK: - History / drift (issue #26)
 
-    @Published var verificationHistory: [VerificationRecord] = []
-    @Published var driftPrinterFilter: String? = nil
-    @Published var driftAlert: String?
-    @Published var isHistoryStoreError: String?
+    var verificationHistory: [VerificationRecord] = []
+    var driftPrinterFilter: String? = nil
+    var driftAlert: String?
+    var isHistoryStoreError: String?
 
     // MARK: - Install (issue #27)
 
-    @Published var installResult: InstallProfileResult?
-    @Published var showingInstallCollision = false
-    @Published var installCollisionMessage: String = ""
+    var installResult: InstallProfileResult?
+    var showingInstallCollision = false
+    var installCollisionMessage: String = ""
     var pendingInstallOptions: InstallProfileOptions?
 
     init(wizard: WizardViewModel, environment: AppEnvironment) {
@@ -89,31 +110,39 @@ final class ProfileWorkflowViewModel: ObservableObject {
     }
 
     var fwaValue: String? {
-        fwaSelection.presetValue(customPath: fwaCustomPath)
+        switch fwaSelection {
+        case .none: return nil
+        case .empty: return ""
+        case .D50: return "D50"
+        case .D65: return "D65"
+        case .custom: return fwaCustomPath
+        }
     }
 
     // MARK: - Preset application
 
     func applyPreset(_ preset: ProfilingPreset?) {
         guard let preset else { return }
-        let config = ColprofConfig(
-            preset: preset,
-            basename: wizard.basename,
-            workingDirectory: wizard.effectiveWorkingDirectory
-        )
-        algorithm = config.algorithm
-        quality = config.quality
-        intent = config.intent ?? ""
-        fwaSelection = ColprofFwaSelection(presetValue: config.fwa)
-        fwaCustomPath = fwaSelection == .custom ? (config.fwa ?? "") : ""
-        illuminant = config.illuminant ?? ""
-        observer = config.observer ?? ""
-        inputViewingCond = config.inputViewingCond ?? ""
-        outputViewingCond = config.outputViewingCond ?? ""
-        profileDescription = ""
-        copyright = ""
-        applyCalibration = preset.applyCalibration == true
-        calibrationFile = preset.calibrationFile ?? ""
+        algorithm = preset.colprofAlgorithm ?? "l"
+        quality = preset.colprofQuality ?? "m"
+        intent = preset.colprofIntent ?? ""
+
+        if let fwa = preset.colprofFwa {
+            switch fwa.lowercased() {
+            case "none": fwaSelection = .none
+            case "": fwaSelection = .empty
+            case "d50": fwaSelection = .D50
+            case "d65": fwaSelection = .D65
+            default:
+                fwaSelection = .custom
+                fwaCustomPath = fwa
+            }
+        }
+
+        illuminant = preset.colprofIlluminant ?? ""
+        observer = preset.colprofObserver ?? ""
+        inputViewingCond = preset.colprofInputViewingCond ?? ""
+        outputViewingCond = preset.colprofOutputViewingCond ?? ""
     }
 
     /// Stage 4 form values for saving into a custom preset.
@@ -163,59 +192,65 @@ final class ProfileWorkflowViewModel: ObservableObject {
         guard canCreateProfile, let _ = wizard.effectiveWorkingDirectory else { return }
         let config = buildColprofConfig()
 
+        isColprofRunning = true
+        colprofLog = []
         colprofProgress = nil
+        lastError = nil
         createdProfileURL = nil
         createdGamutURL = nil
 
         let runner = environment.runner
         Task { @MainActor [weak self] in
             guard let self else { return }
+            defer { self.isColprofRunning = false }
+
             do {
-                let outcome = try await ProcessRunSupport.runLogged(
-                    setRunning: { self.isColprofRunning = $0 },
-                    resetLog: { self.colprofLog = [] },
-                    onLog: { batch in
+                let url = try await runner.runColprof(config: config) { [weak self] batch in
+                    Task { @MainActor [weak self] in
+                        guard let self else { return }
                         self.colprofLog.append(contentsOf: batch)
                         if let last = batch.last {
-                            self.updateProgress(ColprofProgressClassifier.classify(line: last))
+                            let progress = ColprofProgressClassifier.classify(line: last)
+                            self.updateProgress(progress)
                         }
                     }
-                ) { onLog in
-                    let url = try await runner.runColprof(config: config, onLogBatch: onLog)
-
-                    var finalProfileURL = url
-
-                    if self.applyCalibration, !self.calibrationFile.isEmpty {
-                        let applyConfig = ApplycalConfig(
-                            calibrationPath: self.calibrationFile,
-                            inputProfileURL: url
-                        )
-                        assert(!applyConfig.unapply, "applycal unapply is not supported in v2.0")
-                        finalProfileURL = try await runner.runApplycal(config: applyConfig)
-                        self.colprofLog.append("Calibration embedded: \(self.calibrationFile)")
-                    }
-
-                    // Gamut extraction is best-effort for Stage 5 / M6 viewer.
-                    var gamutURL: URL?
-                    do {
-                        let gamConfig = IccgamutConfig(profileURL: finalProfileURL)
-                        let url = try await runner.runIccgamut(config: gamConfig, onLogBatch: onLog)
-                        gamutURL = url
-                        self.colprofLog.append("Gamut mesh extracted: \(url.lastPathComponent)")
-                    } catch {
-                        self.wizard.showNotice(
-                            "Gamut extraction skipped: \(error.localizedDescription)",
-                            kind: .info
-                        )
-                    }
-                    return (profileURL: finalProfileURL, gamutURL: gamutURL)
                 }
-                self.createdProfileURL = outcome.profileURL
-                self.createdGamutURL = outcome.gamutURL
+
+                var finalProfileURL = url
+
+                if self.applyCalibration, !self.calibrationFile.isEmpty {
+                    let applyConfig = ApplycalConfig(
+                        calibrationPath: self.calibrationFile,
+                        inputProfileURL: url
+                    )
+                    assert(!applyConfig.unapply, "applycal unapply is not supported in v2.0")
+                    finalProfileURL = try await runner.runApplycal(config: applyConfig)
+                    self.colprofLog.append("Calibration embedded: \(self.calibrationFile)")
+                }
+
+                // Gamut extraction is best-effort for Stage 5 / M6 viewer.
+                do {
+                    let gamConfig = IccgamutConfig(profileURL: finalProfileURL)
+                    let gamURL = try await runner.runIccgamut(config: gamConfig) { [weak self] batch in
+                        Task { @MainActor [weak self] in
+                            self?.colprofLog.append(contentsOf: batch)
+                        }
+                    }
+                    self.createdGamutURL = gamURL
+                    self.colprofLog.append("Gamut mesh extracted: \(gamURL.lastPathComponent)")
+                } catch {
+                    self.wizard.showNotice(
+                        "Gamut extraction skipped: \(error.localizedDescription)",
+                        kind: .info
+                    )
+                }
+
+                self.createdProfileURL = finalProfileURL
                 self.wizard.refreshGating()
-                self.wizard.showNotice("Profile created: \(outcome.profileURL.lastPathComponent)")
+                self.wizard.showNotice("Profile created: \(finalProfileURL.lastPathComponent)")
                 self.wizard.go(to: .verifyInstall)
             } catch {
+                self.lastError = error.localizedDescription
                 self.wizard.showNotice(
                     "Profile creation failed: \(error.localizedDescription)",
                     kind: .error
@@ -282,28 +317,25 @@ final class ProfileWorkflowViewModel: ObservableObject {
         let ti3URL = ArtefactProbe.artefact(wizard.basename, "ti3", cwd)
         let config = ProfcheckConfig(ti3URL: ti3URL, iccURL: profileURL)
 
+        isProfcheckRunning = true
         profcheckReport = nil
         profcheckWarning = nil
 
         let runner = environment.runner
         Task { @MainActor [weak self] in
             guard let self else { return }
+            defer { self.isProfcheckRunning = false }
+
             do {
-                let outcome = try await ProcessRunSupport.runLogged(
-                    setRunning: { self.isProfcheckRunning = $0 },
-                    resetLog: {},
-                    onLog: { self.colprofLog.append(contentsOf: $0) }
-                ) { onLog in
-                    let report = try await runner.runProfcheck(config: config, onLogBatch: onLog)
-                    var history: [VerificationRecord]?
-                    if let record = self.makeVerificationRecord(from: report) {
-                        history = try await self.environment.historyStore.append(record)
+                let report = try await runner.runProfcheck(config: config) { [weak self] batch in
+                    Task { @MainActor [weak self] in
+                        self?.colprofLog.append(contentsOf: batch)
                     }
-                    return (report: report, history: history)
                 }
-                self.profcheckReport = outcome.report
-                if let history = outcome.history {
-                    self.verificationHistory = history
+                self.profcheckReport = report
+                if let record = self.makeVerificationRecord(from: report) {
+                    let updated = try await self.environment.historyStore.append(record)
+                    self.verificationHistory = updated
                     self.driftAlert = DriftAlert.compute(from: self.filteredHistory)
                 }
             } catch let error as ArgyllRunnerError where error == .profcheckUnparseable {

Sources/ICCery/ProjectSession.swift

@@ -1,689 +0,0 @@
-import AppKit
-import Combine
-import Foundation
-import ICCeryCore
-
-/// Project file session (issue #149): `.icceryproj` open/save/new/close,
-/// recents, the dirty flag, and the window title.
-///
-/// The project is an **index** — disk artefacts still own the stepper
-/// (R18). Open writes `WizardState` through the normal setters and ends
-/// in the same probe `windowDidBecomeKey` uses; it never auto-runs
-/// `targen`/`colprof`/`chartread` and never unlocks a stage the disk
-/// does not back.
-@MainActor
-final class ProjectSession: ObservableObject {
-
-    /// What to do once the dirty alert resolves.
-    enum PendingAction {
-        case new
-        case open(URL)
-        case close
-    }
-
-    /// A live session snapshot, compared against the bound project for
-    /// the dirty flag (title `•`, `btnProjectSave`).
-    private struct Snapshot: Equatable {
-        var basename: String
-        var cwd: String
-        var printerID: String?
-        var presetID: String?
-        var mediaRecipeID: String?
-        var calibrationURL: String?
-    }
-
-    let workflow: TargetWorkflowViewModel
-    let environment: AppEnvironment
-    private let fileDialogs = FileDialogService.shared
-    private let recentsStore: RecentProjectsStore
-    private var cancellables = Set<AnyCancellable>()
-
-    /// Bound project file location; `nil` = no project.
-    @Published var projectURL: URL?
-    /// Last saved/opened project payload.
-    @Published var project: ICCeryProject?
-    /// Open Recent entries, newest first, missing files pruned.
-    @Published var recents: [RecentProjectEntry] = []
-    /// JSON claimed a finished profile but disk stops earlier —
-    /// `projectChipStale` + info banner (R18).
-    @Published var diskBehindNotes = false
-    /// `ICCery` / `ICCery — {name}` / `ICCery — {name} •`.
-    @Published var windowTitle = "ICCery"
-    /// Live session fields differ from the bound project — computed
-    /// fresh so decision paths (`requestNew`/`requestClose`) never see
-    /// a stale willSet value.
-    var isDirty: Bool {
-        guard let project else { return false }
-        return liveSnapshot() != snapshot(of: project)
-    }
-
-    // Flow state for RootView.
-    @Published var showingNewAlert = false
-    @Published var showingDirtyAlert = false
-    @Published var showingRelocateSheet = false
-
-    private var pendingAction: PendingAction?
-    /// Loaded project whose `cwd` is missing — relocate sheet payload.
-    @Published private(set) var pendingRelocate:
-        (project: ICCeryProject, url: URL)?
-
-    init(workflow: TargetWorkflowViewModel, environment: AppEnvironment) {
-        self.workflow = workflow
-        self.environment = environment
-        self.recentsStore = environment.recentProjectsStore
-        refreshRecents()
-
-        // Dirty / title derive from live fields — observe each source;
-        // child VMs are not tracked through the parent's
-        // objectWillChange (R22-style weak sinks). `@Published` fires on
-        // willSet, so the recompute is deferred one main turn to read
-        // post-set values.
-        let wizard = workflow.wizard
-        let printSession = workflow.print
-        let media = workflow.media
-        let profile = workflow.profile
-        wizard.$basename.sink { [weak self] _ in self?.scheduleRecompute() }
-            .store(in: &cancellables)
-        wizard.$workingDirectory.sink { [weak self] _ in self?.scheduleRecompute() }
-            .store(in: &cancellables)
-        wizard.$printerName.sink { [weak self] _ in self?.scheduleRecompute() }
-            .store(in: &cancellables)
-        printSession?.$selectedPrinter.sink { [weak self] _ in self?.scheduleRecompute() }
-            .store(in: &cancellables)
-        workflow.$selectedPresetID.sink { [weak self] _ in self?.scheduleRecompute() }
-            .store(in: &cancellables)
-        media?.$selectedRecipeID.sink { [weak self] _ in self?.scheduleRecompute() }
-            .store(in: &cancellables)
-        profile.$calibrationFile.sink { [weak self] _ in self?.scheduleRecompute() }
-            .store(in: &cancellables)
-        recomputeDerived()
-    }
-
-    deinit { cancellables.removeAll() }
-
-    // MARK: - Derived
-
-    var isBound: Bool { project != nil }
-
-    /// A chartread / spotread / colprof child is live — project changes
-    /// wait for the instrument run to finish.
-    var childSessionLive: Bool {
-        workflow.measurement.isChartreadRunning
-            || workflow.spotRead.isRunning
-            || workflow.profile.isColprofRunning
-    }
-
-    /// Basename eligible for persistence. A live `CAL_` stem resolves
-    /// only through the persisted original — never by stripping, so a
-    /// bare `CAL_` (Force-Quit anomaly, empty persisted original) is
-    /// refused rather than trusted (R11).
-    var resolvedBasename: String? {
-        let live = workflow.wizard.basename
-        guard CalibrationIdentity.isCalibration(live) else {
-            return live.isEmpty ? nil : live
-        }
-        let original = workflow.wizard.calibrationOriginalBasename
-        return original.isEmpty ? nil : original
-    }
-
-    /// ⌘S / `btnProjectSave` enable rule. A `CAL_` live basename stays
-    /// enabled so the refusal can show its banner.
-    var canSave: Bool {
-        isBound && !workflow.wizard.basename.isEmpty
-            && workflow.wizard.workingDirectory != nil
-    }
-
-    /// `menuProjectSaveAs` — no binding required.
-    var canSaveAs: Bool {
-        !workflow.wizard.basename.isEmpty
-            && workflow.wizard.workingDirectory != nil
-    }
-
-    /// `menuProjectReport` — needs a real basename and cwd on disk.
-    var canReport: Bool {
-        !workflow.wizard.basename.isEmpty
-            && workflow.wizard.workingDirectory != nil
-    }
-
-    private func liveSnapshot() -> Snapshot {
-        Snapshot(
-            basename: resolvedBasename ?? "",
-            cwd: workflow.wizard.workingDirectory?.path ?? "",
-            printerID: workflow.print.selectedPrinter.isEmpty
-                ? nil : workflow.print.selectedPrinter,
-            presetID: workflow.selectedPresetID == "none"
-                ? nil : workflow.selectedPresetID,
-            mediaRecipeID: workflow.media.selectedRecipeID == "none"
-                ? nil : workflow.media.selectedRecipeID,
-            calibrationURL: workflow.profile.calibrationFile.isEmpty
-                ? nil : workflow.profile.calibrationFile)
-    }
-
-    private func snapshot(of project: ICCeryProject) -> Snapshot {
-        Snapshot(
-            basename: project.basename,
-            cwd: project.cwd,
-            printerID: project.printerID,
-            presetID: project.presetID,
-            mediaRecipeID: project.mediaRecipeID,
-            calibrationURL: project.calibrationURL)
-    }
-
-    /// Recomputes the window title from live fields.
-    func recomputeDerived() {
-        if let project {
-            windowTitle = "ICCery — \(project.name)" + (isDirty ? " •" : "")
-        } else {
-            windowTitle = "ICCery"
-        }
-    }
-
-    /// Defer the recompute one main turn — the Combine sinks fire on
-    /// willSet, before the changed property holds its new value.
-    private func scheduleRecompute() {
-        Task { @MainActor [weak self] in self?.recomputeDerived() }
-    }
-
-    // MARK: - New
-
-    /// ⌘N / `menuProjectNew`. Dirty sessions detour through the dirty
-    /// alert first; a live child gets a banner instead of the alert.
-    func requestNew() {
-        guard !childSessionLive else {
-            workflow.wizard.showNotice(
-                "Finish the instrument session before starting a project.",
-                kind: .warning)
-            return
-        }
-        if isDirty {
-            pendingAction = .new
-            showingDirtyAlert = true
-            return
-        }
-        showingNewAlert = true
-    }
-
-    /// `btnProjectNewConfirm` — unbinds and clears the basename. Empty
-    /// is the legal "no target yet" state (#60); artefacts and
-    /// `media_library.json` are never deleted (R18).
-    func confirmNew() {
-        showingNewAlert = false
-        projectURL = nil
-        project = nil
-        pendingRelocate = nil
-        diskBehindNotes = false
-        workflow.wizard.basename = ""
-        workflow.targetBasename = ""
-        workflow.media.selectedRecipeID = "none"
-        workflow.wizard.sessionMode = .profile
-        // Re-probe — an empty basename locks stages 2–5.
-        workflow.wizard.windowDidBecomeKey()
-        recomputeDerived()
-    }
-
-    // MARK: - Open
-
-    /// ⌘O / `btnProjectOpen` — `selectProjectFile` (`.icceryproj`
-    /// only). Cancel is a no-op.
-    func requestOpen() {
-        guard !childSessionLive else {
-            workflow.wizard.showNotice(
-                "Finish the instrument session before opening a project.",
-                kind: .warning)
-            return
-        }
-        let url = UITestHooks.isEnabled
-            ? UITestHooks.projectOpenURL
-            : fileDialogs.selectProjectFile()
-        guard let url else { return }
-        if isDirty {
-            pendingAction = .open(url)
-            showingDirtyAlert = true
-            return
-        }
-        open(url)
-    }
-
-    /// Open from the recents submenu — same path, no open panel. A
-    /// missing file is dropped with a banner; no relocate is offered.
-    func openRecent(_ entry: RecentProjectEntry) {
-        guard !childSessionLive else {
-            workflow.wizard.showNotice(
-                "Finish the instrument session before opening a project.",
-                kind: .warning)
-            return
-        }
-        let url = URL(fileURLWithPath: entry.path)
-        guard FileManager.default.fileExists(atPath: url.path) else {
-            Task { try? await recentsStore.remove(path: entry.path) }
-            refreshRecents()
-            workflow.wizard.showNotice("Project file is gone.", kind: .warning)
-            return
-        }
-        if isDirty {
-            pendingAction = .open(url)
-            showingDirtyAlert = true
-            return
-        }
-        open(url)
-    }
-
-    /// Shared open path — validates, routes to relocate when `cwd` is
-    /// gone, then applies. Failures leave live state untouched.
-    func open(_ url: URL) {
-        guard let loaded = loadProject(url) else { return }
-        apply(loaded, from: url)
-    }
-
-    /// Awaitable open for tests — identical to `open` but completes
-    /// after apply finishes.
-    func openAsync(_ url: URL) async {
-        guard let loaded = loadProject(url) else { return }
-        await applyAsync(loaded, from: url)
-    }
-
-    /// Decode + validate + cwd-existence check. Returns the project
-    /// ready to apply, or nil after presenting an error banner / the
-    /// relocate sheet.
-    private func loadProject(_ url: URL) -> ICCeryProject? {
-        let loaded: ICCeryProject
-        do {
-            loaded = try ICCeryProject.load(from: url)
-        } catch let error as ICCeryProject.ValidationError {
-            workflow.wizard.showNotice(
-                error.errorDescription ?? "Could not open project.",
-                kind: .error)
-            return nil
-        } catch {
-            workflow.wizard.showNotice(
-                "Could not open project: \(error.localizedDescription)",
-                kind: .error)
-            return nil
-        }
-        var isDir: ObjCBool = false
-        guard FileManager.default.fileExists(
-            atPath: loaded.cwd, isDirectory: &isDir), isDir.boolValue
-        else {
-            pendingRelocate = (loaded, url)
-            showingRelocateSheet = true
-            return nil
-        }
-        return loaded
-    }
-
-    /// Sync entry — the apply half runs in a Task so `media.apply`
-    /// (async) can run inside it.
-    private func apply(_ project: ICCeryProject, from url: URL) {
-        Task { @MainActor [weak self] in
-            await self?.applyAsync(project, from: url)
-        }
-    }
-
-    /// Apply order (issue #149):
-    /// 1. cwd + basename on the wizard **and** Stage 1 fields.
-    /// 2. `mediaRecipeID` → `MediaLibraryViewModel.apply`; else
-    ///    `presetID` → existing preset apply. Missing recipe is not
-    ///    fatal — open still succeeds.
-    /// 3. Re-probe via the existing window-focus path (#151).
-    /// 4. Never auto-run `targen` / `colprof` / `chartread`.
-    private func applyAsync(_ project: ICCeryProject, from url: URL) async {
-        let cwdURL = URL(fileURLWithPath: project.cwd, isDirectory: true)
-
-        workflow.wizard.setTarget(
-            basename: project.basename, workingDirectory: cwdURL)
-        workflow.targetBasename = project.basename
-        workflow.targetDirectory = cwdURL
-        workflow.wizard.printerName = project.printerDisplayName
-            ?? project.printerID
-        workflow.wizard.profileBasename = project.profileBasename
-        workflow.wizard.sessionMode = .profile
-        if let queue = project.printerID,
-           workflow.print.printers.contains(where: { $0.name == queue }) {
-            workflow.print.selectedPrinter = queue
-        }
-
-        var appliedRecipe = false
-        if let recipeID = project.mediaRecipeID {
-            if workflow.media.recipes.isEmpty {
-                await workflow.media.reloadAsync()
-            }
-            if let recipe = workflow.media.recipes
-                .first(where: { $0.id == recipeID }) {
-                appliedRecipe = await workflow.media.apply(recipe)
-            }
-        }
-        if !appliedRecipe, let presetID = project.presetID,
-           let preset = workflow.presets
-               .first(where: { $0.id == presetID }) {
-            workflow.applyPreset(preset)
-        }
-
-        // Disk owns the stepper — same probe window focus uses.
-        workflow.wizard.windowDidBecomeKey()
-
-        // JSON-vs-disk mismatch: notes say the profile is done but the
-        // artefacts stop earlier — index drift, not gating truth.
-        let artefacts = workflow.wizard.artefacts
-        if project.lastVerification != nil && !artefacts.stage4Complete {
-            let already = diskBehindNotes && projectURL == url
-            diskBehindNotes = true
-            if !already {
-                let last = artefacts.stage3Complete ? ".ti3"
-                    : artefacts.stage2Complete ? ".ti2"
-                    : artefacts.stage1Complete ? ".ti1" : nil
-                let detail = last.map { "artefacts on disk stop at \($0)." }
-                    ?? "no artefacts found on disk."
-                workflow.wizard.showNotice(
-                    "Project notes say profile done; \(detail)",
-                    kind: .info)
-            }
-        } else {
-            diskBehindNotes = false
-        }
-
-        self.project = project
-        projectURL = url
-        pushRecent(url: url, name: project.name)
-        recomputeDerived()
-    }
-
-    // MARK: - Relocate
-
-    /// `btnProjectRelocate` — pick a new cwd, rewrite the project file
-    /// atomically, then continue Apply.
-    func chooseRelocateFolder() {
-        guard let pending = pendingRelocate else { return }
-        let url = UITestHooks.isEnabled
-            ? UITestHooks.projectRelocateURL
-            : fileDialogs.selectDirectory()
-        guard let url else { return }
-        var rewritten = pending.project
-        rewritten.cwd = url.path
-        rewritten.updated = Date()
-        do {
-            try rewritten.save(to: pending.url)
-        } catch {
-            workflow.wizard.showNotice(
-                "Could not update project: \(error.localizedDescription)",
-                kind: .error)
-            return
-        }
-        pendingRelocate = nil
-        showingRelocateSheet = false
-        apply(rewritten, from: pending.url)
-    }
-
-    /// `btnProjectRelocateCancel` — aborts the open; live session
-    /// unchanged.
-    func cancelRelocate() {
-        pendingRelocate = nil
-        showingRelocateSheet = false
-    }
-
-    // MARK: - Save / Save As
-
-    /// ⌘S / `btnProjectSave` — writes the live session into the bound
-    /// URL. A live `CAL_` stem refuses unless the persisted original
-    /// resolves; `CAL_` is never persisted (R11).
-    func saveProject() {
-        Task { @MainActor in _ = await saveProjectAsync() }
-    }
-
-    @discardableResult
-    func saveProjectAsync() async -> Bool {
-        guard let url = projectURL, project != nil else { return false }
-        guard let basename = resolvedBasename else {
-            refuseUnsavable()
-            return false
-        }
-        return await write(to: url, basename: basename)
-    }
-
-    /// ⇧⌘S / `menuProjectSaveAs` — always shows the save picker, then
-    /// binds the chosen URL and pushes recents.
-    func saveProjectAs() {
-        guard let basename = resolvedBasename else {
-            refuseUnsavable()
-            return
-        }
-        guard let cwd = workflow.wizard.workingDirectory else {
-            refuseUnsavable()
-            return
-        }
-        let url = UITestHooks.isEnabled
-            ? UITestHooks.projectSaveURL
-            : fileDialogs.selectProjectSavePath(
-                basename: basename, startingAt: cwd)
-        guard let url else { return }
-        Task { @MainActor in _ = await write(to: url, basename: basename) }
-    }
-
-    private func refuseUnsavable() {
-        if CalibrationIdentity.isCalibration(workflow.wizard.basename) {
-            workflow.wizard.showNotice(
-                "Finish or exit calibration before saving a project.",
-                kind: .warning)
-        } else {
-            workflow.wizard.showNotice(
-                "Set a target basename and working folder before saving a project.",
-                kind: .warning)
-        }
-    }
-
-    /// Builds the project payload from live session fields and writes
-    /// it atomically. On success binds `url`, refreshes recents, and
-    /// clears the stale-chip flag. Failure → error banner, bound URL
-    /// unchanged.
-    @discardableResult
-    private func write(to url: URL, basename: String) async -> Bool {
-        guard let cwd = workflow.wizard.workingDirectory,
-              !cwd.path.isEmpty else {
-            refuseUnsavable()
-            return false
-        }
-        let stem = workflow.wizard.profileBasename ?? basename
-        let snapshot = await lastVerificationSnapshot(stem: stem)
-            ?? project?.lastVerification
-        let queue = workflow.print.selectedPrinter
-        let display = workflow.print.printers
-            .first { $0.name == queue }?.displayName
-            ?? workflow.wizard.printerName
-        let existing = project
-        let name = (existing?.name.isEmpty == false)
-            ? existing!.name : basename
-        let updated = ICCeryProject(
-            name: name,
-            notes: existing?.notes ?? "",
-            basename: basename,
-            cwd: cwd.path,
-            profileBasename: workflow.wizard.profileBasename,
-            printerID: queue.isEmpty ? nil : queue,
-            printerDisplayName: display,
-            mediaRecipeID: workflow.media.selectedRecipeID == "none"
-                ? nil : workflow.media.selectedRecipeID,
-            presetID: workflow.selectedPresetID == "none"
-                ? nil : workflow.selectedPresetID,
-            calibrationURL: workflow.profile.calibrationFile.isEmpty
-                ? nil : workflow.profile.calibrationFile,
-            lastVerification: snapshot,
-            updated: Date())
-        do {
-            try updated.save(to: url)
-        } catch {
-            workflow.wizard.showNotice(
-                "Could not save project: \(error.localizedDescription)",
-                kind: .error)
-            return false
-        }
-        project = updated
-        projectURL = url
-        diskBehindNotes = false
-        pushRecent(url: url, name: updated.name)
-        workflow.wizard.showNotice("Project saved: \(url.lastPathComponent)")
-        recomputeDerived()
-        return true
-    }
-
-    /// Last `VerificationHistoryStore` record for this profile stem,
-    /// if any — notes only.
-    private func lastVerificationSnapshot(
-        stem: String
-    ) async -> VerificationSnapshot? {
-        guard let records = try? await environment.historyStore.load()
-        else { return nil }
-        guard let record = records.last(where: {
-            $0.profileName == stem || $0.profileName == workflow.wizard.basename
-        }) else { return nil }
-        return VerificationSnapshot(record: record)
-    }
-
-    // MARK: - Close
-
-    /// `menuProjectClose` — unbinds; live basename/cwd/artefacts stay.
-    func requestClose() {
-        guard isBound else { return }
-        if isDirty {
-            pendingAction = .close
-            showingDirtyAlert = true
-            return
-        }
-        closeProject()
-    }
-
-    func closeProject() {
-        projectURL = nil
-        project = nil
-        diskBehindNotes = false
-        recomputeDerived()
-    }
-
-    // MARK: - Dirty alert
-
-    /// `btnProjectDirtySave` / `btnProjectDirtyDiscard`. Save proceeds
-    /// to the pending action only when the write succeeded.
-    func resolveDirty(save: Bool) {
-        showingDirtyAlert = false
-        guard let action = pendingAction else { return }
-        if save {
-            Task { @MainActor [weak self] in
-                guard let self else { return }
-                if await self.saveProjectAsync() {
-                    self.pendingAction = nil
-                    self.proceed(with: action)
-                }
-            }
-        } else {
-            pendingAction = nil
-            proceed(with: action)
-        }
-    }
-
-    /// `btnProjectDirtyCancel` — abandons the pending action.
-    func cancelDirty() {
-        pendingAction = nil
-        showingDirtyAlert = false
-    }
-
-    private func proceed(with action: PendingAction) {
-        switch action {
-        case .new:
-            confirmNew()
-        case .open(let url):
-            open(url)
-        case .close:
-            closeProject()
-        }
-    }
-
-    // MARK: - Report
-
-    /// `menuProjectReport` — writes `{cwd}/{basename}-report.md`
-    /// atomically (generated; overwrites). No picker.
-    func saveReport() {
-        guard canReport, let cwd = workflow.wizard.workingDirectory else {
-            return
-        }
-        let basename = workflow.wizard.basename
-        Task { @MainActor [weak self] in
-            guard let self else { return }
-            let stem = self.workflow.wizard.profileBasename ?? basename
-            let snapshot = await self.lastVerificationSnapshot(stem: stem)
-                ?? self.project?.lastVerification
-            let queue = self.workflow.print.selectedPrinter
-            let display = self.workflow.print.printers
-                .first { $0.name == queue }?.displayName
-                ?? self.workflow.wizard.printerName
-            let recipeName = self.workflow.media.recipes
-                .first { $0.id == self.workflow.media.selectedRecipeID }?.name
-            let payload = ICCeryProject(
-                name: self.project?.name.isEmpty == false
-                    ? self.project!.name : basename,
-                notes: self.project?.notes ?? "",
-                basename: basename,
-                cwd: cwd.path,
-                profileBasename: self.workflow.wizard.profileBasename,
-                printerID: queue.isEmpty ? nil : queue,
-                printerDisplayName: display,
-                mediaRecipeID: self.workflow.media.selectedRecipeID == "none"
-                    ? nil : self.workflow.media.selectedRecipeID,
-                presetID: self.workflow.selectedPresetID == "none"
-                    ? nil : self.workflow.selectedPresetID,
-                calibrationURL: self.workflow.profile.calibrationFile.isEmpty
-                    ? nil : self.workflow.profile.calibrationFile,
-                lastVerification: snapshot,
-                updated: Date())
-            do {
-                let written = try ProjectReport.write(
-                    project: payload,
-                    recipeName: recipeName,
-                    artefacts: self.workflow.wizard.artefacts)
-                self.workflow.wizard.showNotice(
-                    "Wrote \(written.lastPathComponent)")
-            } catch {
-                self.workflow.wizard.showNotice(
-                    "Report failed: \(error.localizedDescription)",
-                    kind: .error)
-            }
-        }
-    }
-
-    // MARK: - Recents / reveal
-
-    /// Rebuilds the recents list; entries whose file is gone are
-    /// dropped here (submenu build), not at launch. Corrupt → `[]`,
-    /// file kept (R12).
-    func refreshRecents() {
-        Task { @MainActor [weak self] in
-            guard let self else { return }
-            do {
-                self.recents = try await self.recentsStore.pruneMissing()
-            } catch {
-                self.recents = []
-            }
-        }
-    }
-
-    private func pushRecent(url: URL, name: String) {
-        Task { @MainActor [weak self] in
-            guard let self else { return }
-            try? await self.recentsStore.add(url: url, name: name)
-            self.refreshRecents()
-        }
-    }
-
-    /// `menuProjectRecentsClear` — wipes `recent_projects.json` only;
-    /// `.icceryproj` files are never deleted.
-    func clearRecents() {
-        Task { @MainActor [weak self] in
-            try? await self?.recentsStore.clear()
-            self?.recents = []
-        }
-    }
-
-    /// `btnProjectReveal` — reveals the bound **project file** in
-    /// Finder, not the cwd.
-    func revealInFinder() {
-        guard let projectURL else { return }
-        NSWorkspace.shared.activateFileViewerSelecting([projectURL])
-    }
-}

Sources/ICCery/ProjectUI.swift

@@ -1,151 +0,0 @@
-import SwiftUI
-import ICCeryCore
-
-/// File-menu commands for the project file (issue #149). Content of the
-/// `CommandGroup(replacing: .newItem)` in `ICCeryApp` — split out so the
-/// app body stays small (type-checker budget). Menu ids are distinct
-/// from the sidebar chip ids (`menuProject*` vs `btnProject*`).
-struct ProjectCommands: View {
-    @ObservedObject private var project: ProjectSession
-
-    init(workflow: TargetWorkflowViewModel) {
-        self._project = ObservedObject(wrappedValue: workflow.project)
-    }
-
-    var body: some View {
-        Button("New Project") { project.requestNew() }
-            .keyboardShortcut("n")
-            .accessibilityIdentifier("menuProjectNew")
-        Button("Open Project…") { project.requestOpen() }
-            .keyboardShortcut("o")
-            .accessibilityIdentifier("menuProjectOpen")
-        Menu("Open Recent") {
-            ForEach(project.recents) { entry in
-                // Names render via Text only (#114); never the raw path.
-                Button(entry.name) { project.openRecent(entry) }
-                    .accessibilityIdentifier("projectRecent-\(entry.bookmarkHash)")
-            }
-            Divider()
-            Button("Clear Menu") { project.clearRecents() }
-                .accessibilityIdentifier("menuProjectRecentsClear")
-        }
-        .disabled(project.recents.isEmpty)
-        .accessibilityIdentifier("menuProjectRecents")
-        Divider()
-        Button("Save Project") { project.saveProject() }
-            .keyboardShortcut("s")
-            .disabled(!project.canSave)
-            .accessibilityIdentifier("menuProjectSave")
-        Button("Save Project As…") { project.saveProjectAs() }
-            .keyboardShortcut("s", modifiers: [.command, .shift])
-            .disabled(!project.canSaveAs)
-            .accessibilityIdentifier("menuProjectSaveAs")
-        Button("Save Report…") { project.saveReport() }
-            .disabled(!project.canReport)
-            .accessibilityIdentifier("menuProjectReport")
-        Divider()
-        Button("Close Project") { project.requestClose() }
-            .disabled(!project.isBound)
-            .accessibilityIdentifier("menuProjectClose")
-    }
-}
-
-/// Compact project footer at the bottom of the 270 pt sidebar (issue
-/// #149) — never a fourth row of large buttons (R10).
-struct ProjectChip: View {
-    @ObservedObject var project: ProjectSession
-    @Binding var showingAllHelp: Bool
-
-    var body: some View {
-        VStack(alignment: .leading, spacing: 4) {
-            if let bound = project.project {
-                Text(bound.name)
-                    .font(.callout)
-                    .foregroundStyle(Theme.text)
-                    .lineLimit(1)
-                    .accessibilityIdentifier("projectChipName")
-                Text(URL(fileURLWithPath: bound.cwd).lastPathComponent)
-                    .font(.caption)
-                    .foregroundStyle(.secondary)
-                    .lineLimit(1)
-                    .truncationMode(.middle)
-                    // The raw path is a tooltip — never the window title.
-                    .help(bound.cwd)
-                    .accessibilityIdentifier("projectChipPath")
-                if project.diskBehindNotes {
-                    Text("Disk behind project notes")
-                        .font(.caption)
-                        .foregroundStyle(.orange)
-                        .accessibilityIdentifier("projectChipStale")
-                }
-                HStack(spacing: 8) {
-                    Button("Show in Finder") { project.revealInFinder() }
-                        .accessibilityIdentifier("btnProjectReveal")
-                    Button("Save") { project.saveProject() }
-                        .disabled(!project.canSave)
-                        .accessibilityIdentifier("btnProjectSave")
-                    Spacer()
-                }
-                .font(.caption)
-                .controlSize(.small)
-            } else {
-                HStack(spacing: 8) {
-                    Text("No project")
-                        .font(.callout)
-                        .foregroundStyle(.secondary)
-                        .accessibilityIdentifier("projectChipName")
-                    Spacer()
-                    Button("Open…") { project.requestOpen() }
-                        .controlSize(.small)
-                        .accessibilityIdentifier("btnProjectOpen")
-                }
-            }
-        }
-        .padding(8)
-        .background(
-            RoundedRectangle(cornerRadius: Theme.Metrics.cornerMedium)
-                .fill(Theme.panel)
-        )
-        .overlay(
-            RoundedRectangle(cornerRadius: Theme.Metrics.cornerMedium)
-                .stroke(Theme.border)
-        )
-        .accessibilityElement(children: .contain)
-        .accessibilityIdentifier("projectChip")
-        .helpOverlay(
-            "A project remembers printer, preset and folder. The stepper still follows files on disk.",
-            showing: $showingAllHelp)
-    }
-}
-
-/// `projectRelocateSheet` — shown when an opened project's `cwd` no
-/// longer exists (issue #149). Choosing a folder rewrites `cwd` in the
-/// project file atomically, then continues Apply; Cancel aborts the
-/// open with live state untouched.
-struct ProjectRelocateSheet: View {
-    @ObservedObject var project: ProjectSession
-
-    var body: some View {
-        VStack(alignment: .leading, spacing: 14) {
-            Text("Missing project folder")
-                .font(.title3)
-                .foregroundStyle(Theme.text)
-            Text(
-                "The folder for \(project.pendingRelocate?.project.name ?? "this project") is missing. Choose a new working folder."
-            )
-            .foregroundStyle(Theme.text)
-            HStack {
-                Spacer()
-                Button("Cancel") { project.cancelRelocate() }
-                    .accessibilityIdentifier("btnProjectRelocateCancel")
-                Button("Choose Folder…") { project.chooseRelocateFolder() }
-                    .accessibilityIdentifier("btnProjectRelocate")
-            }
-        }
-        .padding(20)
-        .frame(width: 420)
-        .background(Theme.background)
-        .accessibilityElement(children: .contain)
-        .accessibilityIdentifier("projectRelocateSheet")
-    }
-}

Sources/ICCery/RootView.swift

@@ -5,20 +5,12 @@ import ICCeryCore
 /// Root layout: 270 pt sidebar + main stage area with the notification
 /// banner pinned to the top (docs/21 §Shell).
 struct RootView: View {
-    @ObservedObject var workflow: TargetWorkflowViewModel
-    /// Observed directly: nested ObservableObjects are not tracked
-    /// through the parent's `objectWillChange`.
-    @ObservedObject private var model: WizardViewModel
-    @ObservedObject private var project: ProjectSession
+    @Bindable var workflow: TargetWorkflowViewModel
     @State private var showingSettings = false
     @State private var showingAbout = false
     @State private var showingAllHelp = false
 
-    init(workflow: TargetWorkflowViewModel) {
-        self.workflow = workflow
-        self._model = ObservedObject(wrappedValue: workflow.wizard)
-        self._project = ObservedObject(wrappedValue: workflow.project)
-    }
+    private var model: WizardViewModel { workflow.wizard }
 
     var body: some View {
         HStack(spacing: 0) {
@@ -37,9 +29,8 @@ struct RootView: View {
                 if let notice = model.notice {
                     NoticeBanner(notice: notice, onClose: model.dismissNotice)
                 }
-                WizardStageContent(model: model, workflow: workflow)
+                stageContent
             }
-            .frame(maxWidth: .infinity, maxHeight: .infinity)
         }
         .frame(minWidth: 1100, minHeight: 700)
         .background(Theme.background)
@@ -59,25 +50,6 @@ struct RootView: View {
         .sheet(isPresented: $workflow.showingManagePresets) {
             ManagePresetsDialog(workflow: workflow)
         }
-        // Media library sheets live on RootView, never inside the
-        // 270 pt sidebar column (#146).
-        .sheet(isPresented: $workflow.showingSaveMedia) {
-            SaveMediaRecipeDialog(workflow: workflow)
-        }
-        .sheet(
-            isPresented: $workflow.showingManageMedia,
-            onDismiss: { workflow.media.manageDismissed() }
-        ) {
-            ManageMediaDialog(workflow: workflow)
-        }
-        // Spot-read console sheet (issue #148). Dismiss runs the same
-        // `q\n` + ~500 ms + kill path as the sheet's Stop button.
-        .sheet(
-            isPresented: $workflow.showingSpotRead,
-            onDismiss: { workflow.spotRead.sheetClosed() }
-        ) {
-            SpotReadView(model: workflow.spotRead)
-        }
         .sheet(isPresented: $showingAbout) {
             AboutView { showingAbout = false }
         }
@@ -85,54 +57,12 @@ struct RootView: View {
             get: { workflow.wizard.showingGamutViewer },
             set: { workflow.wizard.showingGamutViewer = $0 }
         )) {
-            GamutView(
-                environment: workflow.environment,
-                profileGamURL: workflow.wizard.gamutProfileURL,
-                showingAllHelp: $showingAllHelp)
-        }
-        // Project file chrome (issue #149): window title, New confirm
-        // alert, dirty alert, relocate sheet. Panels never appear from
-        // a View — UITestHooks inject fixture paths instead.
-        .onReceive(project.$windowTitle) { title in
-            for window in NSApp.windows where !(window is NSPanel) {
-                window.title = title
-            }
-        }
-        .alert("Start a new project?", isPresented: $project.showingNewAlert) {
-            Button("Cancel", role: .cancel) {}
-                .accessibilityIdentifier("btnProjectNewCancel")
-            Button("Start") { project.confirmNew() }
-                .accessibilityIdentifier("btnProjectNewConfirm")
-        } message: {
-            Text("The working folder and targets on disk are not deleted.")
-                .accessibilityIdentifier("projectNewAlert")
-        }
-        .alert(
-            "Save the current project first?",
-            isPresented: $project.showingDirtyAlert
-        ) {
-            Button("Save") { project.resolveDirty(save: true) }
-                .accessibilityIdentifier("btnProjectDirtySave")
-            Button("Don't Save") { project.resolveDirty(save: false) }
-                .accessibilityIdentifier("btnProjectDirtyDiscard")
-            Button("Cancel", role: .cancel) { project.cancelDirty() }
-                .accessibilityIdentifier("btnProjectDirtyCancel")
-        }
-        .sheet(isPresented: $project.showingRelocateSheet) {
-            ProjectRelocateSheet(project: project)
+            GamutView(profileGamURL: workflow.wizard.gamutProfileURL)
         }
     }
 
-}
-
-/// Content for the active wizard stage. Isolated into its own view so that
-/// `WizardViewModel` is tracked via `@ObservedObject` instead of the parent's
-/// `TargetWorkflowViewModel`, which does not observe nested `wizard` mutations.
-private struct WizardStageContent: View {
-    @ObservedObject var model: WizardViewModel
-    @ObservedObject var workflow: TargetWorkflowViewModel
-
-    var body: some View {
+    @ViewBuilder
+    private var stageContent: some View {
         switch model.stage {
         case .generate:
             Stage1View(workflow: workflow)
@@ -145,9 +75,9 @@ private struct WizardStageContent: View {
         case .verifyInstall:
             Stage5View(model: workflow.profile)
         case .calibrate:
-            CalibrationView(model: workflow.calibration, wizard: workflow.wizard)
+            CalibrationView(model: workflow.calibration)
         @unknown default:
-            Stage1View(workflow: workflow)
+            StagePlaceholderView(stage: model.stage)
         }
     }
 }

Sources/ICCery/SettingsView.swift

@@ -4,7 +4,7 @@ import ICCeryCore
 /// Settings sheet (issue #5, docs/21 §Settings). Dark-theme Form with
 /// the full v1 field set; ΔE validation shows inline under the fields.
 struct SettingsView: View {
-    @StateObject var model = SettingsViewModel()
+    @State var model = SettingsViewModel()
     @Environment(\.dismiss) private var dismiss
 
     private static let instruments: [(code: String, label: String)] = [
@@ -58,7 +58,7 @@ struct SettingsView: View {
                             Text($0.label).tag($0.code)
                         }
                     }
-                    Text("Seeds Spot Read and Stage 3 when the instrument is plugged in. printtarg -i is still chosen on Stage 2.")
+                    Text("Display-only — Stage 2's instrument select is used for actual runs.")
                         .font(.caption)
                         .foregroundStyle(.secondary)
 
@@ -69,24 +69,22 @@ struct SettingsView: View {
                 }
 
                 Section("Verification") {
-                    TextField(
-                        "Good ΔE ≤",
-                        value: $model.settings.deltaEGoodMax,
-                        format: .number
-                    )
-                    .accessibilityIdentifier("settingsDeltaEGood")
-
-                    TextField(
-                        "Warning ΔE ≤",
-                        value: $model.settings.deltaEWarningMax,
-                        format: .number
-                    )
-                    .accessibilityIdentifier("settingsDeltaEWarning")
-
-                    Text("Swatch and verify status use these as the green / amber cutoffs. Fail is anything above Warning.")
-                        .font(.caption)
-                        .foregroundStyle(.secondary)
-
+                    HStack {
+                        Text("Good ΔE ≤")
+                        TextField(
+                            "2.0",
+                            value: $model.settings.deltaEGoodMax,
+                            format: .number
+                        )
+                        .frame(width: 60)
+                        Text("Warning ΔE ≤")
+                        TextField(
+                            "5.0",
+                            value: $model.settings.deltaEWarningMax,
+                            format: .number
+                        )
+                        .frame(width: 60)
+                    }
                     ForEach(model.validationErrors, id: \.self) { error in
                         Text(error)
                             .font(.caption)
@@ -95,12 +93,16 @@ struct SettingsView: View {
                 }
 
                 Section("Calibration") {
-                    TextField(
-                        "Stale after (days)",
-                        value: $model.settings.calibrationStaleDays,
-                        format: .number
-                    )
-                    .accessibilityIdentifier("settingsCalStaleDays")
+                    HStack {
+                        Text("Stale after")
+                        TextField(
+                            "30",
+                            value: $model.settings.calibrationStaleDays,
+                            format: .number
+                        )
+                        .frame(width: 60)
+                        Text("days")
+                    }
                 }
 
                 Section("Profile install") {
@@ -141,7 +143,7 @@ struct SettingsView: View {
                     }
                 }
             }
-            .padding(.leading, 45)
+            .formStyle(.grouped)
 
             Divider()
 

Sources/ICCery/SettingsViewModel.swift

@@ -1,5 +1,4 @@
 import AppKit
-import Combine
 import Foundation
 import ICCeryCore
 
@@ -7,11 +6,12 @@ import ICCeryCore
 /// validation; the log level is applied live via `LogSink` (#158) and a
 /// `settingsDidChange` notification fans out to #20.
 @MainActor
-final class SettingsViewModel: ObservableObject {
+@Observable
+final class SettingsViewModel {
 
-    @Published var settings: AppSettings
-    @Published var validationErrors: [String] = []
-    @Published var savedFlash = false
+    var settings: AppSettings
+    var validationErrors: [String] = []
+    var savedFlash = false
 
     private let store: SettingsStore
     private let sink: LogSink
@@ -33,7 +33,7 @@ final class SettingsViewModel: ObservableObject {
             sink.applySettings(settings)
             savedFlash = true
             Task {
-                try? await Task.sleep(nanoseconds: 1_500_000_000)
+                try? await Task.sleep(for: .seconds(1.5))
                 savedFlash = false
             }
             return true

Sources/ICCery/SidebarView.swift

@@ -4,54 +4,15 @@ import ICCeryCore
 /// 270 pt sidebar (docs/21 §Shell): logo, settings/about buttons, preset
 /// select, Calibrate Printer + status chip, and the 1–5 stepper.
 struct SidebarView: View {
-    @ObservedObject var workflow: TargetWorkflowViewModel
-    /// Observed directly: nested ObservableObjects are not tracked
-    /// through the parent's `objectWillChange`.
-    @ObservedObject private var model: WizardViewModel
-    @ObservedObject private var profile: ProfileWorkflowViewModel
-    @ObservedObject private var media: MediaLibraryViewModel
-    @ObservedObject private var printSession: PrintSessionViewModel
-    @ObservedObject private var measurement: MeasurementWorkflowViewModel
-    @ObservedObject private var project: ProjectSession
+    @Bindable var workflow: TargetWorkflowViewModel
     var onOpenSettings: () -> Void
     var onOpenAbout: () -> Void
     @Binding var showingAllHelp: Bool
 
-    init(
-        workflow: TargetWorkflowViewModel,
-        onOpenSettings: @escaping () -> Void,
-        onOpenAbout: @escaping () -> Void,
-        showingAllHelp: Binding<Bool>
-    ) {
-        self.workflow = workflow
-        self._model = ObservedObject(wrappedValue: workflow.wizard)
-        self._profile = ObservedObject(wrappedValue: workflow.profile)
-        self._media = ObservedObject(wrappedValue: workflow.media)
-        self._printSession = ObservedObject(wrappedValue: workflow.print)
-        self._measurement = ObservedObject(wrappedValue: workflow.measurement)
-        self._project = ObservedObject(wrappedValue: workflow.project)
-        self.onOpenSettings = onOpenSettings
-        self.onOpenAbout = onOpenAbout
-        self._showingAllHelp = showingAllHelp
-    }
+    private var model: WizardViewModel { workflow.wizard }
 
     var body: some View {
         VStack(alignment: .leading, spacing: 0) {
-            header
-            presetBlock
-            mediaBlock
-            studioButtons
-            stepperAndProject
-        }
-        .frame(width: Theme.Metrics.sidebarWidth)
-        .background(Theme.panel)
-    }
-
-    // Swift 5.7 (Xcode 14.2 CI runner) caps a ViewBuilder body at 10
-    // children (#146); these Group blocks are layout-transparent, so
-    // visual order, ids and the 270 pt column are unchanged.
-    private var header: some View {
-        Group {
             HStack {
                 Image("ICCery-logo")
                     .resizable()
@@ -80,11 +41,7 @@ struct SidebarView: View {
             .padding(12)
 
             Divider().overlay(Theme.border)
-        }
-    }
 
-    private var presetBlock: some View {
-        Group {
             // Preset select (`#presetSelect`) — issue #11. Selection
             // applies the preset immediately; names render via Text only.
             Picker("Preset", selection: Binding(
@@ -116,65 +73,7 @@ struct SidebarView: View {
             }
             .padding(.horizontal, 12)
             .padding(.bottom, 8)
-        }
-    }
 
-    private var mediaBlock: some View {
-        Group {
-            // Media library (`#mediaSelect`) — issue #146. Selection
-            // applies the recipe immediately, like presets; names render
-            // via Text only (#114). Never reuses `presetSelect` (#137).
-            Picker("Media", selection: Binding(
-                get: { media.selectedRecipeID },
-                set: { media.selectRecipe($0) }
-            )) {
-                Text("No media recipe").tag("none")
-                ForEach(media.recipes) { recipe in
-                    Text(recipe.name).tag(recipe.id)
-                }
-            }
-            .pickerStyle(.menu)
-            .accessibilityIdentifier("mediaSelect")
-            .padding(.horizontal, 12)
-            .padding(.vertical, 8)
-            .helpOverlay(
-                "Saved printer + paper + ink + .cal bound to a preset.",
-                showing: $showingAllHelp)
-
-            if let reasons = media.staleReasons[media.selectedRecipeID],
-               !reasons.isEmpty {
-                Text(reasons.contains(.printer)
-                     ? "Printer not installed" : "Calibration stale")
-                    .font(.caption)
-                    .foregroundStyle(.orange)
-                    .padding(.horizontal, 12)
-                    .accessibilityIdentifier("mediaRecipeStale")
-                    .helpOverlay(
-                        "Re-run Stage 0 or pick a different recipe.",
-                        showing: $showingAllHelp)
-            }
-
-            HStack(spacing: 8) {
-                Button("Capture") { media.beginCapture() }
-                    .disabled(printSession.selectedPrinter.isEmpty)
-                    .accessibilityIdentifier("btnMediaLibraryCapture")
-                    .helpOverlay(
-                        "Select a printer in Stage 2 first",
-                        showing: $showingAllHelp)
-                Button("Manage") { workflow.showingManageMedia = true }
-                    .accessibilityIdentifier("btnMediaLibraryManage")
-                    .helpOverlay(
-                        "Apply or delete saved media recipes.",
-                        showing: $showingAllHelp)
-                Spacer()
-            }
-            .padding(.horizontal, 12)
-            .padding(.bottom, 8)
-        }
-    }
-
-    private var studioButtons: some View {
-        Group {
             // Calibrate Printer (`#btnCalibratePrinter`).
             Button(action: { model.enterCalibration() }) {
                 Label("Calibrate Printer", systemImage: "slider.horizontal.3")
@@ -189,36 +88,9 @@ struct SidebarView: View {
                     .frame(maxWidth: .infinity)
             }
             .controlSize(.large)
-            .helpOverlay(
-                "View the profile gamut in 3D against sRGB.",
-                showing: $showingAllHelp)
             .accessibilityIdentifier("btnViewGamut")
             .padding(.horizontal, 12)
 
-            // Spot Read sheet (`#btnSpotRead`) — issue #148. Enabled
-            // only with a working folder (#59) and while no Stage 3
-            // chartread child is live; opening never kills
-            // `chartread_{basename}`.
-            Button(action: { workflow.showingSpotRead = true }) {
-                Label("Spot Read", systemImage: "eyedropper")
-                    .frame(maxWidth: .infinity)
-            }
-            .controlSize(.large)
-            .disabled(model.workingDirectory == nil || measurement.isChartreadRunning)
-            .helpOverlay(
-                model.workingDirectory == nil
-                    ? "Set a working folder in Stage 1 first."
-                    : (measurement.isChartreadRunning
-                        ? "Stop the Stage 3 chart read first."
-                        : "Read a single patch as Lab/XYZ from the instrument."),
-                showing: $showingAllHelp)
-            .accessibilityIdentifier("btnSpotRead")
-            .padding(.horizontal, 12)
-        }
-    }
-
-    private var stepperAndProject: some View {
-        Group {
             Divider().overlay(Theme.border)
                 .padding(.vertical, 8)
 
@@ -238,13 +110,9 @@ struct SidebarView: View {
             .padding(.horizontal, 6)
 
             Spacer()
-
-            // Project chip (issue #149) — a compact footer in the
-            // spacer's bottom, under the stepper. The 270 pt column
-            // cannot take four more large buttons (R10).
-            ProjectChip(project: project, showingAllHelp: $showingAllHelp)
-                .padding(8)
         }
+        .frame(width: Theme.Metrics.sidebarWidth)
+        .background(Theme.panel)
     }
 }
 

Sources/ICCery/SpotReadView.swift

@@ -1,360 +0,0 @@
-import SwiftUI
-import ICCeryCore
-
-/// Spot Read sheet (issue #148) — one patch Lab/XYZ from the live
-/// instrument. A `RootView` sheet, not a wizard stage and not a Stage 3
-/// tab; all identifiers are `spot*` — Stage 3 `chartread` ids are never
-/// reused here.
-struct SpotReadView: View {
-    @ObservedObject var model: SpotReadViewModel
-    @Environment(\.dismiss) private var dismiss
-
-    var body: some View {
-        VStack(alignment: .leading, spacing: 12) {
-            header
-            if !model.sidecarAvailable {
-                missingSidecar
-            } else {
-                ScrollView {
-                    VStack(alignment: .leading, spacing: 12) {
-                        instrumentCard
-                        promptLine
-                        transport
-                        lastSampleCard
-                        historySection
-                    }
-                }
-            }
-            footer
-        }
-        .padding(16)
-        .frame(width: 560, height: 640)
-        .background(Theme.background)
-        .accessibilityElement(children: .contain)
-        .accessibilityIdentifier("spotReadView")
-        .onAppear { model.sheetOpened() }
-        .onDisappear { model.sheetClosed() }
-    }
-
-    // MARK: - Header / missing sidecar
-
-    private var header: some View {
-        HStack(alignment: .firstTextBaseline) {
-            Text("Spot Read")
-                .font(.title3)
-                .foregroundStyle(Theme.text)
-            Spacer()
-            if model.isRunning {
-                ProgressView()
-                    .scaleEffect(0.8)
-            }
-        }
-    }
-
-    private var missingSidecar: some View {
-        VStack(alignment: .leading, spacing: 12) {
-            Text("spotread sidecar missing — run fetch-argyll")
-                .foregroundStyle(Theme.text)
-                .accessibilityIdentifier("spotSidecarMissing")
-            Spacer()
-        }
-    }
-
-    // MARK: - Instrument card (clones Stage 3 look, own ids)
-
-    private var instrumentCard: some View {
-        VStack(alignment: .leading, spacing: 10) {
-            HStack {
-                Text("Instrument")
-                    .font(.headline)
-                    .foregroundStyle(Theme.text)
-                Spacer()
-                Button(action: { model.detectInstruments() }) {
-                    Image(systemName: "arrow.clockwise")
-                }
-                .disabled(!model.canDetect)
-                .accessibilityIdentifier("btnSpotDetectInstruments")
-            }
-
-            if let error = model.detectionError {
-                Text(error)
-                    .font(.caption)
-                    .foregroundStyle(.red)
-                    .accessibilityIdentifier("spotDetectError")
-            }
-
-            Picker("Instrument", selection: Binding(
-                get: { instrumentTag },
-                set: { newTag in
-                    if newTag.isEmpty {
-                        model.selectedInstrument = .auto
-                    } else if let device = model.instruments.first(where: { "\($0.port)" == newTag }) {
-                        model.selectedInstrument = .device(device)
-                    }
-                }
-            )) {
-                Text("Auto (first available port)").tag("")
-                ForEach(model.instruments) { device in
-                    Text(device.displayName).tag("\(device.port)")
-                }
-            }
-            .pickerStyle(.menu)
-            .disabled(model.isRunning)
-            .accessibilityIdentifier("spotInstrumentSelect")
-
-            if model.defaultMissing {
-                Text("Saved default instrument not present")
-                    .font(.caption)
-                    .foregroundStyle(.orange)
-                    .accessibilityIdentifier("spotDefaultMissing")
-            }
-
-            Toggle("Also set as default instrument", isOn: Binding(
-                get: { model.setAsDefault },
-                set: { model.applyDefaultToggle($0) }
-            ))
-            .accessibilityIdentifier("spotSetDefault")
-
-            if model.selectedInstrument.isXY {
-                Text("XY tables use Stage 3. Spot Read is a handheld / reflective probe.")
-                    .font(.caption)
-                    .foregroundStyle(Theme.accent)
-                    .accessibilityIdentifier("spotXYHint")
-            }
-        }
-        .padding(16)
-        .background(Theme.panel)
-    }
-
-    private var instrumentTag: String {
-        switch model.selectedInstrument {
-        case .auto:
-            return ""
-        case .device(let device):
-            return "\(device.port)"
-        }
-    }
-
-    // MARK: - Prompt line
-
-    private var promptLine: some View {
-        VStack(alignment: .leading, spacing: 6) {
-            HStack {
-                Text("Status")
-                    .font(.headline)
-                    .foregroundStyle(Theme.text)
-                Spacer()
-                Text(model.prompt)
-                    .font(.callout)
-                    .foregroundStyle(Theme.text)
-                    .accessibilityIdentifier("spotPrompt")
-            }
-            if let error = model.lastError {
-                Text(error)
-                    .font(.caption)
-                    .foregroundStyle(.red)
-                    .accessibilityIdentifier("spotLastError")
-                    .accessibilityValue(error)
-            }
-            if !model.log.isEmpty {
-                ProcessLogView(
-                    lines: model.log,
-                    minHeight: 60,
-                    maxHeight: 100,
-                    containerId: "spotLogContainer",
-                    logId: "spotLog"
-                )
-            }
-        }
-        .padding(16)
-        .background(Theme.panel)
-    }
-
-    // MARK: - Transport
-
-    private var transport: some View {
-        HStack(spacing: 12) {
-            if !model.isRunning {
-                Button("Start") { model.start() }
-                    .disabled(!model.canStart)
-                    .accessibilityIdentifier("btnSpotStart")
-            } else {
-                switch model.state {
-                case .calibrating:
-                    Button("Calibrate") { model.calibrate() }
-                        .accessibilityIdentifier("btnSpotCalibrate")
-                case .awaitingStrip:
-                    Button("Read") { model.trigger() }
-                        .accessibilityIdentifier("btnSpotTrigger")
-                default:
-                    EmptyView()
-                }
-                Button("Stop") { model.stopIfNeeded() }
-                    .accessibilityIdentifier("btnSpotStop")
-            }
-            Spacer()
-        }
-        .padding(.horizontal, 4)
-    }
-
-    // MARK: - Last sample
-
-    @ViewBuilder
-    private var lastSampleCard: some View {
-        VStack(alignment: .leading, spacing: 8) {
-            Text("Last sample")
-                .font(.headline)
-                .foregroundStyle(Theme.text)
-
-            if let sample = model.displayedSample {
-                HStack(spacing: 16) {
-                    let rgb = LabColorMath.labToSRGB(sample.lab)
-                    RoundedRectangle(cornerRadius: 4)
-                        .fill(Color(red: rgb.r, green: rgb.g, blue: rgb.b))
-                        .frame(width: 32, height: 32)
-                        .overlay(RoundedRectangle(cornerRadius: 4).stroke(Theme.border))
-                        .accessibilityIdentifier("spotSwatch")
-
-                    VStack(alignment: .leading, spacing: 2) {
-                        HStack(spacing: 12) {
-                            Text(String(format: "L* %.1f", sample.lab.l))
-                                .accessibilityIdentifier("spotLabL")
-                            Text(String(format: "a* %.1f", sample.lab.a))
-                                .accessibilityIdentifier("spotLabA")
-                            Text(String(format: "b* %.1f", sample.lab.b))
-                                .accessibilityIdentifier("spotLabB")
-                        }
-                        .font(.callout)
-                        .foregroundStyle(Theme.text)
-
-                        if let xyz = sample.xyz {
-                            Text(String(format: "XYZ %.2f %.2f %.2f", xyz.x, xyz.y, xyz.z))
-                                .font(.caption)
-                                .foregroundStyle(.secondary)
-                                .accessibilityIdentifier("spotXYZ")
-                        }
-
-                        HStack(spacing: 8) {
-                            Text(sample.port.map { "\(sample.instrumentName) · port \($0)" }
-                                 ?? sample.instrumentName)
-                                .font(.caption)
-                                .foregroundStyle(.secondary)
-                                .accessibilityIdentifier("spotLastInstrument")
-
-                            if let de = model.displayedDeltaE {
-                                HStack(spacing: 6) {
-                                    Circle()
-                                        .fill(deltaEColor)
-                                        .frame(width: 8, height: 8)
-                                    Text(String(format: "ΔE %.2f", de))
-                                        .font(.caption)
-                                        .foregroundStyle(.secondary)
-                                }
-                                .accessibilityElement(children: .contain)
-                                .accessibilityIdentifier("spotDeltaE")
-                            }
-                        }
-
-                        if model.isDisplayedLabImplausible {
-                            Text("Implausible L*")
-                                .font(.caption)
-                                .foregroundStyle(.orange)
-                                .accessibilityIdentifier("spotLabImplausible")
-                        }
-                    }
-                    Spacer()
-                }
-                .accessibilityElement(children: .contain)
-                .accessibilityIdentifier("spotLastSample")
-            } else {
-                Text("No readings yet.")
-                    .font(.caption)
-                    .foregroundStyle(.secondary)
-                    .accessibilityIdentifier("spotLastEmpty")
-            }
-        }
-        .padding(16)
-        .background(Theme.panel)
-    }
-
-    private var deltaEColor: Color {
-        switch model.deltaEClassification {
-        case .good, nil: return .green
-        case .warning: return .orange
-        case .bad: return .red
-        }
-    }
-
-    // MARK: - History
-
-    @ViewBuilder
-    private var historySection: some View {
-        VStack(alignment: .leading, spacing: 8) {
-            Text("History")
-                .font(.headline)
-                .foregroundStyle(Theme.text)
-
-            if model.samples.isEmpty {
-                Text("No history.")
-                    .font(.caption)
-                    .foregroundStyle(.secondary)
-                    .accessibilityIdentifier("spotHistoryEmpty")
-            } else {
-                List {
-                    ForEach(Array(model.samples.enumerated()), id: \.element.id) { index, sample in
-                        historyRow(index: index, sample: sample)
-                    }
-                }
-                .frame(minHeight: 120)
-                .accessibilityIdentifier("spotHistoryTable")
-            }
-        }
-        .padding(16)
-        .background(Theme.panel)
-    }
-
-    private func historyRow(index: Int, sample: SpotReadSample) -> some View {
-        let previous = index + 1 < model.samples.count ? model.samples[index + 1] : nil
-        let deltaE = previous.map { ColorDifference.deltaE00($0.lab, sample.lab) }
-        return Button(action: { model.selectFromHistory(sample) }) {
-            HStack(spacing: 10) {
-                Text(sample.timestamp, style: .time)
-                    .frame(width: 70, alignment: .leading)
-                Text(String(format: "%.1f", sample.lab.l))
-                    .frame(width: 44, alignment: .trailing)
-                Text(String(format: "%.1f", sample.lab.a))
-                    .frame(width: 44, alignment: .trailing)
-                Text(String(format: "%.1f", sample.lab.b))
-                    .frame(width: 44, alignment: .trailing)
-                Text(deltaE.map { String(format: "%.2f", $0) } ?? "")
-                    .frame(width: 44, alignment: .trailing)
-                Text(sample.instrumentName)
-                    .lineLimit(1)
-                Spacer()
-            }
-            .font(.caption)
-            .foregroundStyle(Theme.text)
-            .contentShape(Rectangle())
-        }
-        .buttonStyle(.plain)
-        .accessibilityIdentifier("spotHistoryRow-\(sample.id.uuidString)")
-    }
-
-    // MARK: - Footer
-
-    private var footer: some View {
-        HStack(spacing: 12) {
-            Button("Copy Lab") { model.copyLab() }
-                .disabled(model.displayedSample == nil)
-                .accessibilityIdentifier("btnSpotCopyLab")
-            Button("Export CSV…") { model.exportCsv() }
-                .disabled(model.samples.isEmpty)
-                .accessibilityIdentifier("btnSpotExportCsv")
-            Spacer()
-            Button("Close") { dismiss() }
-                .keyboardShortcut(.cancelAction)
-                .accessibilityIdentifier("btnCloseSpotRead")
-        }
-        .padding(.top, 4)
-    }
-}

Sources/ICCery/SpotReadViewModel.swift

@@ -1,420 +0,0 @@
-import AppKit
-import Combine
-import Foundation
-import ICCeryCore
-
-/// Spot-read console state and interaction (issue #148).
-///
-/// Runs the bundled `spotread` sidecar under the single-lease process id
-/// `spotread`; Stage 3 `chartread` is untouched. `defaultInstrument`
-/// seeds the instrument picker on sheet open — it is never written into
-/// `printtarg -i` or `targen` argv (R15).
-@MainActor
-final class SpotReadViewModel: ObservableObject {
-
-    let workflow: TargetWorkflowViewModel
-    let environment: AppEnvironment
-    private let fileDialogs = FileDialogService.shared
-
-    // MARK: - Instrument card
-
-    @Published var instruments: [InstrumentDevice] = []
-    @Published var selectedInstrument: InstrumentSelection = .auto
-    @Published var isDetecting = false
-    @Published var detectionError: String?
-    /// `spotDefaultMissing` — set when `defaultInstrument` is saved but
-    /// no detected device matches it.
-    @Published var defaultMissing = false
-    /// `spotSetDefault` toggle state.
-    @Published var setAsDefault = false
-
-    // MARK: - Session
-
-    @Published var isRunning = false
-    @Published var state: ChartreadState = .idle
-    @Published var prompt = "Press Start to open the instrument."
-    @Published var lastError: String?
-    @Published var log: [String] = []
-
-    // MARK: - Samples / history (in-memory, cap 50, newest first)
-
-    @Published private(set) var samples: [SpotReadSample] = []
-    @Published private(set) var displayedSample: SpotReadSample?
-    @Published private(set) var displayedDeltaE: Double?
-
-    private let historyLimit = 50
-    private var streamTask: Task<Void, Never>?
-
-    init(workflow: TargetWorkflowViewModel, environment: AppEnvironment) {
-        self.workflow = workflow
-        self.environment = environment
-    }
-
-    // MARK: - Derived state
-
-    /// Whether the bundled `spotread` sidecar resolves to an executable.
-    /// `BinaryResolver` only — never `$PATH`, never `chartread`.
-    var sidecarAvailable: Bool {
-        let url = environment.runner.binaryResolver.resolve("spotread")
-        return environment.runner.binaryResolver.exists(url)
-    }
-
-    var isChartreadRunning: Bool { workflow.measurement.isChartreadRunning }
-
-    var canStart: Bool {
-        sidecarAvailable && !isDetecting && !isRunning && !isChartreadRunning
-            && workflow.wizard.effectiveWorkingDirectory != nil
-    }
-
-    var canDetect: Bool { !isDetecting && !isRunning }
-
-    var deltaEClassification: SwatchClassification? {
-        guard let de = displayedDeltaE else { return nil }
-        let settings = environment.settingsStore.load()
-        return ColorDifference.classify(
-            deltaE: de,
-            goodMax: settings.deltaEGoodMax,
-            warningMax: settings.deltaEWarningMax)
-    }
-
-    /// `spotLabImplausible` — L* outside 0…100 still displays, unclamped.
-    var isDisplayedLabImplausible: Bool {
-        guard let l = displayedSample?.lab.l else { return false }
-        return l < 0 || l > 100
-    }
-
-    // MARK: - Sheet lifecycle
-
-    /// Called from `SpotReadView.onAppear`. Resets the in-memory session
-    /// and runs detection once; a missing sidecar gets a wizard notice.
-    func sheetOpened() {
-        samples = []
-        displayedSample = nil
-        displayedDeltaE = nil
-        log = []
-        lastError = nil
-        state = .idle
-        prompt = "Press Start to open the instrument."
-
-        guard sidecarAvailable else {
-            workflow.wizard.showNotice(
-                "spotread sidecar missing — run fetch-argyll", kind: .error)
-            return
-        }
-        detectInstruments()
-    }
-
-    /// Called from `onDisappear` *and* the sheet's `onDismiss` — clearing
-    /// the flag alone is not enough; a live child must be quit and
-    /// killed (R14).
-    func sheetClosed() {
-        stopIfNeeded()
-        samples = []
-        displayedSample = nil
-        displayedDeltaE = nil
-        log = []
-        defaultMissing = false
-    }
-
-    // MARK: - Detection
-
-    func detectInstruments() {
-        guard canDetect else { return }
-        isDetecting = true
-        detectionError = nil
-
-        Task { @MainActor [weak self] in
-            guard let self else { return }
-            // `instlist` is an exclusive lease (#116) — never spawn a
-            // second one; surface the busy state instead.
-            if await self.environment.runner.processManager.isRunning(ProcessID.instlist) {
-                self.detectionError = "Instrument detection is already running."
-                self.isDetecting = false
-                return
-            }
-            do {
-                let devices = try await self.environment.runner.detectInstruments()
-                self.instruments = devices
-                self.seedDefault(from: devices)
-                if case .device(let selected) = self.selectedInstrument,
-                   !devices.contains(where: { $0.port == selected.port }) {
-                    self.selectedInstrument = .auto
-                }
-            } catch {
-                self.detectionError = error.localizedDescription
-            }
-            self.isDetecting = false
-        }
-    }
-
-    /// Seed the picker from `AppSettings.defaultInstrument`; no match →
-    /// `.auto` + `spotDefaultMissing`.
-    private func seedDefault(from devices: [InstrumentDevice]) {
-        guard let code = environment.settingsStore.load().defaultInstrument,
-              !code.isEmpty else {
-            defaultMissing = false
-            return
-        }
-        if let match = devices.first(where: { Self.matches(code: code, device: $0) }) {
-            selectedInstrument = .device(match)
-            defaultMissing = false
-        } else {
-            selectedInstrument = .auto
-            defaultMissing = true
-        }
-    }
-
-    /// Whether an `instlist` device corresponds to a `printtarg -i` /
-    /// settings instrument code (`i1`, `CM`, `p3`, `SS`, `20`/`22`/`41`/`51`).
-    static func matches(code: String, device: InstrumentDevice) -> Bool {
-        let haystack = "\(device.name) \(device.type)".lowercased()
-        switch code {
-        case "i1": return haystack.contains("i1pro") && !haystack.contains("i1pro 3") && !haystack.contains("i1pro3")
-        case "p3": return haystack.contains("i1pro 3") || haystack.contains("i1pro3")
-        case "CM": return haystack.contains("colormunki")
-        case "SS": return haystack.contains("specbos") || haystack.contains("spectraval") || haystack.contains("spectroscan") || haystack.contains("spectro scan")
-        case "20": return haystack.contains("display 2")
-        case "22": return haystack.contains("display")
-        case "41": return haystack.contains("spyder 4") || haystack.contains("spyder 5") || haystack.contains("spyder4") || haystack.contains("spyder5")
-        case "51": return haystack.contains("spyder x")
-        default: return false
-        }
-    }
-
-    /// Reverse of `matches` — most specific codes first.
-    static func code(for device: InstrumentDevice) -> String? {
-        for code in ["p3", "51", "41", "22", "20", "CM", "SS", "i1"]
-        where matches(code: code, device: device) {
-            return code
-        }
-        return nil
-    }
-
-    /// `spotSetDefault` — writes `AppSettings.defaultInstrument` only.
-    /// Never touches `printtarg -i` or `targen`.
-    func applyDefaultToggle(_ on: Bool) {
-        setAsDefault = on
-        var settings = environment.settingsStore.load()
-        if on, case .device(let device) = selectedInstrument {
-            settings.defaultInstrument = Self.code(for: device)
-        } else if !on {
-            settings.defaultInstrument = nil
-        }
-        try? environment.settingsStore.save(settings)
-    }
-
-    // MARK: - Session control
-
-    func start() {
-        guard sidecarAvailable else {
-            lastError = "spotread sidecar missing — run fetch-argyll"
-            return
-        }
-        guard !isChartreadRunning else {
-            lastError = "Stop the Stage 3 chart read first."
-            return
-        }
-        guard let cwd = workflow.wizard.effectiveWorkingDirectory else {
-            lastError = "Set a working folder in Stage 1 first."
-            return
-        }
-        Task { @MainActor [weak self] in
-            guard let self else { return }
-            // `spotread` is an exclusive lease — a second Start while a
-            // child is live is an error, not a kill + respawn (#116).
-            if await self.environment.runner.processManager.isRunning(ProcessID.spotread) {
-                self.lastError = "A spotread session is already running."
-                return
-            }
-            self.begin(config: self.buildConfig(cwd: cwd))
-        }
-    }
-
-    private func buildConfig(cwd: URL) -> SpotReadConfig {
-        let port: Int?
-        let name: String
-        switch selectedInstrument {
-        case .auto:
-            port = nil
-            name = "Auto"
-        case .device(let device):
-            port = device.port
-            name = device.name
-        }
-        return SpotReadConfig(
-            workingDirectory: cwd,
-            selectedPort: selectedInstrument.chartreadPort,
-            enableLEDs: environment.settingsStore.load().enableI1Pro2Leds,
-            isXY: selectedInstrument.isXY,
-            instrumentName: name,
-            instrumentPort: port
-        )
-    }
-
-    private func begin(config: SpotReadConfig) {
-        isRunning = true
-        state = .idle
-        lastError = nil
-        prompt = "Waiting for a reading…"
-
-        let stream = environment.runner.runSpotread(config: config)
-        streamTask = Task { @MainActor [weak self] in
-            guard let self else { return }
-            for await event in stream {
-                self.handle(event: event)
-            }
-            self.isRunning = false
-            self.state = .idle
-            if self.lastError == nil {
-                self.prompt = "Press Start to open the instrument."
-            }
-        }
-    }
-
-    private func handle(event: SpotReadEvent) {
-        switch event {
-        case .prompt(let result):
-            state = result.state
-            prompt = promptText(for: result.state)
-
-        case .sample(let sample):
-            let previous = samples.first
-            samples.insert(sample, at: 0)
-            if samples.count > historyLimit {
-                samples.removeLast()
-            }
-            displayedSample = sample
-            displayedDeltaE = previous.map {
-                ColorDifference.deltaE00($0.lab, sample.lab)
-            }
-
-        case .log(let batch):
-            log.append(contentsOf: batch)
-
-        case .exit(let code):
-            if code != 0 {
-                lastError = "spotread exited with code \(code)"
-            }
-
-        case .failed(let error):
-            lastError = error.localizedDescription
-        }
-    }
-
-    private func promptText(for state: ChartreadState) -> String {
-        switch state {
-        case .calibrating:
-            return "Place the instrument on the calibration tile, then Calibrate."
-        case .awaitingStrip:
-            return "Place on the patch, then Read."
-        case .reading, .promptContinue:
-            return "Waiting for a reading…"
-        case .warning:
-            return "Instrument warning — stop and restart if it persists."
-        case .error:
-            return "Read error — Stop, then Start again."
-        default:
-            return "Waiting for a reading…"
-        }
-    }
-
-    // MARK: - Transport
-
-    /// `btnSpotCalibrate` — same bytes Stage 3 sends for calibrate.
-    func calibrate() {
-        send(.trigger)
-    }
-
-    /// `btnSpotTrigger` — the Read key (`" \n"`).
-    func trigger() {
-        send(.trigger)
-    }
-
-    private func send(_ input: ChartreadInput) {
-        Task { @MainActor [weak self] in
-            guard let self, self.isRunning else { return }
-            try? await self.environment.runner.sendSpotreadInput(input)
-        }
-    }
-
-    /// `btnSpotStop` / sheet dismiss: `q\n`, ~500 ms, then kill if the
-    /// child is still live.
-    func stopIfNeeded() {
-        guard isRunning else { return }
-        streamTask?.cancel()
-        streamTask = nil
-        let processManager = environment.runner.processManager
-        Task { @MainActor in
-            try? await processManager.sendStdin(
-                id: ProcessID.spotread, bytes: ChartreadInput.quit.bytes)
-            try? await Task.sleep(nanoseconds: 500_000_000)
-            await processManager.kill(id: ProcessID.spotread)
-        }
-        isRunning = false
-        state = .idle
-        prompt = "Press Start to open the instrument."
-    }
-
-    // MARK: - History / export
-
-    /// Click a history row: copies that sample into the last-sample card.
-    /// Never re-triggers the instrument.
-    func selectFromHistory(_ sample: SpotReadSample) {
-        displayedSample = sample
-        if let index = samples.firstIndex(of: sample), index + 1 < samples.count {
-            displayedDeltaE = ColorDifference.deltaE00(samples[index + 1].lab, sample.lab)
-        } else {
-            displayedDeltaE = nil
-        }
-    }
-
-    /// `btnSpotCopyLab` — `L* a* b*` of the displayed sample as plain
-    /// text (`50.0 1.2 -3.4`).
-    func copyLab() {
-        guard let sample = displayedSample else { return }
-        let text = String(format: "%.1f %.1f %.1f", sample.lab.l, sample.lab.a, sample.lab.b)
-        NSPasteboard.general.clearContents()
-        NSPasteboard.general.setString(text, forType: .string)
-    }
-
-    /// `btnSpotExportCsv` — RFC-4180 via `selectCsvSavePath`. Cancel is
-    /// a no-op. Rows are newest-first, matching the history list.
-    func exportCsv() {
-        guard !samples.isEmpty else { return }
-        let url = UITestHooks.isEnabled
-            ? UITestHooks.csvExportURL
-            : fileDialogs.selectCsvSavePath()
-        guard let url else { return }
-
-        var out = "timestamp,L,a,b,dE00,instrument,port\r\n"
-        for (index, sample) in samples.enumerated() {
-            let deltaE = index + 1 < samples.count
-                ? String(format: "%.2f", ColorDifference.deltaE00(samples[index + 1].lab, sample.lab))
-                : ""
-            out += "\(csvField(iso8601(sample.timestamp))),\(f1(sample.lab.l)),\(f1(sample.lab.a)),\(f1(sample.lab.b)),\(deltaE),\(csvField(sample.instrumentName)),\(sample.port.map(String.init) ?? "")\r\n"
-        }
-
-        do {
-            try out.write(to: url, atomically: true, encoding: .utf8)
-            workflow.wizard.showNotice("Spot readings exported: \(url.lastPathComponent)")
-        } catch {
-            workflow.wizard.showNotice(
-                "Export failed: \(error.localizedDescription)", kind: .error)
-        }
-    }
-
-    private func f1(_ value: Double) -> String {
-        String(format: "%.1f", value)
-    }
-
-    private func iso8601(_ date: Date) -> String {
-        ISO8601DateFormatter().string(from: date)
-    }
-
-    private func csvField(_ text: String) -> String {
-        guard text.contains(",") || text.contains("\"") || text.contains("\n") else {
-            return text
-        }
-        return "\"\(text.replacingOccurrences(of: "\"", with: "\"\""))\""
-    }
-}

Sources/ICCery/Stage1View.swift

@@ -5,7 +5,7 @@ import ICCeryCore
 /// docs/08). All documented element ids are wired as accessibility
 /// identifiers so the UI-test contract stays stable.
 struct Stage1View: View {
-    @ObservedObject var workflow: TargetWorkflowViewModel
+    @Bindable var workflow: TargetWorkflowViewModel
 
     var body: some View {
         ScrollView {
@@ -238,12 +238,19 @@ struct Stage1View: View {
     }
 
     private var logSection: some View {
-        ProcessLogView(
-            lines: workflow.targenLog,
-            minHeight: 120,
-            maxHeight: 200,
-            containerId: "targenLogContainer",
-            logId: "targenLog"
-        )
+        DisclosureGroup("Process log") {
+            ScrollView {
+                Text(workflow.targenLog.joined(separator: "\n"))
+                    .font(.system(.caption, design: .monospaced))
+                    .foregroundStyle(Theme.text)
+                    .frame(maxWidth: .infinity, alignment: .leading)
+                    .textSelection(.enabled)
+            }
+            .frame(minHeight: 120, maxHeight: 200)
+            .accessibilityIdentifier("targenLog")
+        }
+        .foregroundStyle(Theme.text)
+        .accessibilityElement(children: .contain)
+        .accessibilityIdentifier("targenLogContainer")
     }
 }

Sources/ICCery/Stage2View.swift

@@ -5,19 +5,7 @@ import ICCeryCore
 /// issues #9/#10, docs/09). Print controls are visible but inert —
 /// real spooling lands in M3.
 struct Stage2View: View {
-    @ObservedObject var workflow: TargetWorkflowViewModel
-    /// Observed directly: nested ObservableObjects are not tracked
-    /// through the parent's `objectWillChange`.
-    @ObservedObject private var printSession: PrintSessionViewModel
-    @ObservedObject private var wizard: WizardViewModel
-
-    @State private var printGenerationTask: Task<Void, Never>?
-
-    init(workflow: TargetWorkflowViewModel) {
-        self.workflow = workflow
-        self._printSession = ObservedObject(wrappedValue: workflow.print)
-        self._wizard = ObservedObject(wrappedValue: workflow.wizard)
-    }
+    @Bindable var workflow: TargetWorkflowViewModel
 
     var body: some View {
         ScrollView {
@@ -183,13 +171,20 @@ struct Stage2View: View {
     }
 
     private var logSection: some View {
-        ProcessLogView(
-            lines: workflow.printtargLog,
-            minHeight: 100,
-            maxHeight: 180,
-            containerId: "printtargLogContainer",
-            logId: "printtargLog"
-        )
+        DisclosureGroup("Process log") {
+            ScrollView {
+                Text(workflow.printtargLog.joined(separator: "\n"))
+                    .font(.system(.caption, design: .monospaced))
+                    .foregroundStyle(Theme.text)
+                    .frame(maxWidth: .infinity, alignment: .leading)
+                    .textSelection(.enabled)
+            }
+            .frame(minHeight: 100, maxHeight: 180)
+            .accessibilityIdentifier("printtargLog")
+        }
+        .foregroundStyle(Theme.text)
+        .accessibilityElement(children: .contain)
+        .accessibilityIdentifier("printtargLogContainer")
     }
 
     // MARK: - TIFF gallery (#tiffGallery) — host-side PNG only (#58)
@@ -224,19 +219,18 @@ struct Stage2View: View {
         VStack(alignment: .leading, spacing: 10) {
             HStack(spacing: 12) {
                 Text("Print").font(.headline).foregroundStyle(Theme.text)
-                if let notice = workflow.print.printNotice {
-                    Image(systemName: notice.kind == .error
+                if let notice = workflow.printNotice {
+                    Image(systemName: workflow.printNoticeIsError
                           ? "xmark.circle.fill" : "info.circle.fill")
-                        .foregroundStyle(notice.kind == .error
+                        .foregroundStyle(workflow.printNoticeIsError
                                          ? .red : .blue)
                         .accessibilityIdentifier("printNotificationIcon")
-                        .accessibilityValue(notice.kind.accessibilityValue)
-                    Text(notice.text)
+                    Text(notice)
                         .font(.caption)
-                        .foregroundStyle(notice.kind == .error
+                        .foregroundStyle(workflow.printNoticeIsError
                                          ? .red : .secondary)
                         .accessibilityIdentifier("printNotificationText")
-                        .accessibilityValue(notice.text)
+                        .accessibilityValue(notice)
                 }
                 Spacer()
             }
@@ -244,21 +238,21 @@ struct Stage2View: View {
 
             // Printer row: select + status + refresh + Preferences.
             HStack(spacing: 10) {
-                Picker("Printer", selection: $workflow.print.selectedPrinter) {
-                    ForEach(workflow.print.printers, id: \.name) { printer in
+                Picker("Printer", selection: $workflow.selectedPrinter) {
+                    ForEach(workflow.printers, id: \.name) { printer in
                         Text(printer.displayName ?? printer.name)
                             .tag(printer.name)
                     }
                 }
                 .frame(maxWidth: 320)
                 .accessibilityIdentifier("printerSelect")
-                .onChange(of: workflow.print.selectedPrinter) { _ in
-                    workflow.print.selectedTray = nil
-                    workflow.print.selectedMediaType = nil
-                    Task { @MainActor in await workflow.print.reloadSelectedCapabilities() }
+                .onChange(of: workflow.selectedPrinter) { _, _ in
+                    workflow.selectedTray = nil
+                    workflow.selectedMediaType = nil
+                    Task { @MainActor in await workflow.reloadSelectedCapabilities() }
                 }
-                if let selected = workflow.print.printers
-                    .first(where: { $0.name == workflow.print.selectedPrinter }) {
+                if let selected = workflow.printers
+                    .first(where: { $0.name == workflow.selectedPrinter }) {
                     Text(selected.status.rawValue)
                         .font(.caption).foregroundStyle(.secondary)
                         .padding(.horizontal, 8).padding(.vertical, 3)
@@ -266,33 +260,33 @@ struct Stage2View: View {
                         .clipShape(Capsule())
                         .accessibilityIdentifier("printerStatusBadge")
                 }
-                Button(action: workflow.print.refreshPrinters) {
+                Button(action: workflow.refreshPrinters) {
                     Image(systemName: "arrow.clockwise")
                 }
                 .help("Refresh printer list")
                 .accessibilityIdentifier("btnRefreshPrinters")
-                Button(action: workflow.print.openPrinterPreferences) {
+                Button(action: workflow.openPrinterPreferences) {
                     Image(systemName: "gearshape")
                 }
                 .help("Printer properties — bound NSPrintPanel")
-                .disabled(workflow.print.selectedPrinter.isEmpty)
+                .disabled(workflow.selectedPrinter.isEmpty)
                 .accessibilityIdentifier("btnPrinterProperties")
             }
 
             // Tray / media / orientation — from queue capabilities.
             HStack(spacing: 14) {
-                if !workflow.print.printerCaps.trays.isEmpty {
-                    Picker("Tray", selection: $workflow.print.selectedTray) {
-                        ForEach(workflow.print.printerCaps.trays, id: \.id) {
+                if !workflow.printerCaps.trays.isEmpty {
+                    Picker("Tray", selection: $workflow.selectedTray) {
+                        ForEach(workflow.printerCaps.trays, id: \.id) {
                             Text($0.name).tag(Optional($0.id))
                         }
                     }
                     .frame(maxWidth: 200)
                     .accessibilityIdentifier("printerTraySelect")
                 }
-                if !workflow.print.printerCaps.mediaTypes.isEmpty {
-                    Picker("Media", selection: $workflow.print.selectedMediaType) {
-                        ForEach(workflow.print.printerCaps.mediaTypes, id: \.id) {
+                if !workflow.printerCaps.mediaTypes.isEmpty {
+                    Picker("Media", selection: $workflow.selectedMediaType) {
+                        ForEach(workflow.printerCaps.mediaTypes, id: \.id) {
                             Text($0.name).tag(Optional($0.id))
                         }
                     }
@@ -302,31 +296,27 @@ struct Stage2View: View {
                     .accessibilityIdentifier("printerMediaTypeSelect")
                 }
                 HStack(spacing: 0) {
-                    Button("Portrait") { workflow.print.printOrientation = "portrait" }
+                    Button("Portrait") { workflow.printOrientation = "portrait" }
                         .buttonStyle(.bordered)
-                        .tint(workflow.print.printOrientation == "portrait" ? .accentColor : .gray)
+                        .tint(workflow.printOrientation == "portrait" ? .accentColor : .gray)
                         .accessibilityIdentifier("btnOrientPortrait")
-                    Button("Landscape") { workflow.print.printOrientation = "landscape" }
+                    Button("Landscape") { workflow.printOrientation = "landscape" }
                         .buttonStyle(.bordered)
-                        .tint(workflow.print.printOrientation == "landscape" ? .accentColor : .gray)
+                        .tint(workflow.printOrientation == "landscape" ? .accentColor : .gray)
                         .accessibilityIdentifier("btnOrientLandscape")
                 }
                 Spacer()
             }
 
             HStack(spacing: 8) {
-                Button(action: {
-                    if let result = workflow.printtargResult {
-                        workflow.print.printAllPages(from: result, pageSize: workflow.pageSize)
-                    }
-                }) {
-                    Label(workflow.print.isPrinting ? "Printing…" : "Print All",
+                Button(action: workflow.printAllPages) {
+                    Label(workflow.isPrinting ? "Printing…" : "Print All",
                           systemImage: "printer")
                 }
                 .controlSize(.large)
-                .disabled(workflow.print.isPrinting
+                .disabled(workflow.isPrinting
                           || workflow.printtargResult == nil
-                          || workflow.print.selectedPrinter.isEmpty)
+                          || workflow.selectedPrinter.isEmpty)
                 .accessibilityIdentifier("btnPrintAll")
                 Spacer()
                 Button("Advance to Stage 3") { workflow.advanceToStage3() }
@@ -340,20 +330,11 @@ struct Stage2View: View {
         .clipShape(RoundedRectangle(cornerRadius: Theme.Metrics.cornerMedium))
         .accessibilityElement(children: .contain)
         .accessibilityIdentifier("rawPrintPanel")
-        .onAppear { schedulePrinterRefresh() }
-        .onChange(of: workflow.printtargResult?.pages.count) { _ in
-            schedulePrinterRefresh()
-        }
-    }
-
-    /// Auto-enumerates printers once a manifest exists and whenever it
-    /// changes (e.g. resume from .ti2). The explicit task handle keeps
-    /// a superseded run from racing the next one.
-    private func schedulePrinterRefresh() {
-        printGenerationTask?.cancel()
-        printGenerationTask = Task { @MainActor in
-            if workflow.print.printers.isEmpty, workflow.printtargResult != nil {
-                workflow.print.refreshPrinters()
+        .task(id: workflow.printtargResult?.pages.count) {
+            // Auto-enumerate once a manifest exists and whenever it
+            // changes (e.g. resume from .ti2).
+            if workflow.printers.isEmpty, workflow.printtargResult != nil {
+                workflow.refreshPrinters()
             }
         }
     }
@@ -362,16 +343,7 @@ struct Stage2View: View {
 /// One gallery cell: PNG preview + per-page Print button.
 private struct GalleryPageView: View {
     let page: GalleryPage
-    @ObservedObject var workflow: TargetWorkflowViewModel
-    /// Observed directly: `print` is a nested ObservableObject and its
-    /// `isPrinting`/`selectedPrinter` changes drive this cell's button.
-    @ObservedObject private var printSession: PrintSessionViewModel
-
-    init(page: GalleryPage, workflow: TargetWorkflowViewModel) {
-        self.page = page
-        self.workflow = workflow
-        self._printSession = ObservedObject(wrappedValue: workflow.print)
-    }
+    let workflow: TargetWorkflowViewModel
 
     var body: some View {
         VStack(spacing: 6) {
@@ -392,9 +364,9 @@ private struct GalleryPageView: View {
             Text("\(page.page.patches) patches · " +
                  "\(Int(page.page.widthMm))×\(Int(page.page.heightMm)) mm")
                 .font(.caption2).foregroundStyle(.secondary)
-            Button("Print") { workflow.print.printPage(page, pageSize: workflow.pageSize) }
-                .disabled(workflow.print.isPrinting
-                          || workflow.print.selectedPrinter.isEmpty)
+            Button("Print") { workflow.printPage(page) }
+                .disabled(workflow.isPrinting
+                          || workflow.selectedPrinter.isEmpty)
                 .accessibilityIdentifier("btnPrintPage-\(page.index)")
         }
         .padding(8)

Sources/ICCery/Stage3View.swift

@@ -4,15 +4,7 @@ import ICCeryCore
 
 /// Stage 3 — measurement, live swatches, and multi-pass averaging.
 struct Stage3View: View {
-    @ObservedObject var model: MeasurementWorkflowViewModel
-    /// `model.basename`/`model.workingDirectory` delegate to `wizard`;
-    /// observe it directly so header updates propagate.
-    @ObservedObject private var wizard: WizardViewModel
-
-    init(model: MeasurementWorkflowViewModel) {
-        self.model = model
-        self._wizard = ObservedObject(wrappedValue: model.wizard)
-    }
+    @Bindable var model: MeasurementWorkflowViewModel
 
     var body: some View {
         VStack(spacing: 0) {
@@ -172,22 +164,28 @@ struct Stage3View: View {
                     .foregroundStyle(Theme.accent)
             }
 
-            if let notice = model.chartreadNotice {
-                Text(notice.text)
+            if let lastError = model.lastError {
+                Text(lastError)
                     .font(.caption)
-                    .foregroundStyle(notice.kind.tint)
+                    .foregroundStyle(.red)
                     .accessibilityIdentifier("chartreadLastError")
-                    .accessibilityValue(notice.text)
+                    .accessibilityValue(lastError)
             }
 
             controlButtons
 
             if !model.chartreadLog.isEmpty {
-                ProcessLogView(
-                    lines: model.chartreadLog,
-                    containerId: "chartreadLogContainer",
-                    logId: "chartreadLog"
-                )
+                DisclosureGroup("Log") {
+                    VStack(alignment: .leading) {
+                        ForEach(model.chartreadLog, id: \.self) { line in
+                            Text(line)
+                                .font(.system(.caption, design: .monospaced))
+                                .foregroundStyle(.secondary)
+                        }
+                    }
+                }
+                .foregroundStyle(Theme.text)
+                .accessibilityIdentifier("chartreadLogContainer")
             }
         }
         .padding(16)
@@ -373,11 +371,9 @@ struct Stage3View: View {
                 }
 
                 if let notice = model.finishNotice {
-                    Text(notice.text)
+                    Text(notice)
                         .font(.caption)
-                        .foregroundStyle(notice.kind == .error ? .red : .green)
-                        .accessibilityIdentifier("chartreadFinishNotice")
-                        .accessibilityValue(notice.kind.accessibilityValue)
+                        .foregroundStyle(model.finishNoticeIsError ? .red : .green)
                 }
             }
             .padding(16)

Sources/ICCery/Stage4View.swift

@@ -3,15 +3,7 @@ import ICCeryCore
 
 /// Stage 4 — build an ICC/ICM profile from the canonical `.ti3`.
 struct Stage4View: View {
-    @ObservedObject var model: ProfileWorkflowViewModel
-    /// Header reads `model.wizard.basename`; observe the nested
-    /// ObservableObject directly.
-    @ObservedObject private var wizard: WizardViewModel
-
-    init(model: ProfileWorkflowViewModel) {
-        self.model = model
-        self._wizard = ObservedObject(wrappedValue: model.wizard)
-    }
+    @Bindable var model: ProfileWorkflowViewModel
 
     var body: some View {
         VStack(spacing: 0) {
@@ -138,20 +130,16 @@ struct Stage4View: View {
                 .textFieldStyle(.roundedBorder)
                 .accessibilityIdentifier("colprofCopyright")
 
-            // Nested VStack keeps the parent at the Swift 5.7 ViewBuilder
-            // 10-child limit (Xcode 14.2 / macOS 12 CI runner, #111).
-            VStack(alignment: .leading, spacing: 12) {
-                Toggle("Apply calibration curve", isOn: $model.applyCalibration)
-                    .accessibilityIdentifier("colprofApplyCalibration")
+            Toggle("Apply calibration curve", isOn: $model.applyCalibration)
+                .accessibilityIdentifier("colprofApplyCalibration")
 
-                if model.applyCalibration {
-                    HStack {
-                        TextField("Calibration .cal file", text: $model.calibrationFile)
-                            .textFieldStyle(.roundedBorder)
-                            .accessibilityIdentifier("colprofCalibrationFile")
-                        Button("Browse…") { model.browseForCalibrationFile() }
-                            .accessibilityIdentifier("btnBrowseCalibrationFile")
-                    }
+            if model.applyCalibration {
+                HStack {
+                    TextField("Calibration .cal file", text: $model.calibrationFile)
+                        .textFieldStyle(.roundedBorder)
+                        .accessibilityIdentifier("colprofCalibrationFile")
+                    Button("Browse…") { model.browseForCalibrationFile() }
+                        .accessibilityIdentifier("btnBrowseCalibrationFile")
                 }
             }
         }
@@ -178,14 +166,27 @@ struct Stage4View: View {
                 }
 
                 Spacer()
+
+                if let lastError = model.lastError {
+                    Text(lastError)
+                        .font(.caption)
+                        .foregroundStyle(.red)
+                        .accessibilityIdentifier("colprofLastError")
+                }
             }
 
             if !model.colprofLog.isEmpty {
-                ProcessLogView(
-                    lines: model.colprofLog,
-                    containerId: "colprofLogContainer",
-                    logId: "colprofLog"
-                )
+                DisclosureGroup("Log") {
+                    VStack(alignment: .leading) {
+                        ForEach(model.colprofLog, id: \.self) { line in
+                            Text(line)
+                                .font(.system(.caption, design: .monospaced))
+                                .foregroundStyle(.secondary)
+                        }
+                    }
+                }
+                .foregroundStyle(Theme.text)
+                .accessibilityIdentifier("colprofLogContainer")
             }
         }
         .padding(16)

Sources/ICCery/Stage5View.swift

@@ -3,15 +3,7 @@ import ICCeryCore
 
 /// Stage 5 — verify the generated profile, track drift, and install.
 struct Stage5View: View {
-    @ObservedObject var model: ProfileWorkflowViewModel
-    /// Header/buttons read `model.wizard.*`; observe the nested
-    /// ObservableObject directly.
-    @ObservedObject private var wizard: WizardViewModel
-
-    init(model: ProfileWorkflowViewModel) {
-        self.model = model
-        self._wizard = ObservedObject(wrappedValue: model.wizard)
-    }
+    @Bindable var model: ProfileWorkflowViewModel
 
     var body: some View {
         VStack(spacing: 0) {

Sources/ICCery/StagePlaceholderView.swift

@@ -0,0 +1,24 @@
+import SwiftUI
+import ICCeryCore
+
+/// Placeholder stage surface for M1. Real stage UIs arrive in M2–M5
+/// (issues #7–#31); Stage 0 lands in M6 (issue #29).
+struct StagePlaceholderView: View {
+    let stage: WizardStage
+
+    var body: some View {
+        VStack(spacing: 16) {
+            Image(systemName: stage.symbolName)
+                .font(.system(size: 44))
+                .foregroundStyle(Theme.accent)
+            Text(stage.title)
+                .font(.title2)
+                .foregroundStyle(Theme.text)
+            Text("This stage is not implemented yet — see the milestone plan.")
+                .font(.callout)
+                .foregroundStyle(.secondary)
+        }
+        .frame(maxWidth: .infinity, maxHeight: .infinity)
+        .background(Theme.background)
+    }
+}

Sources/ICCery/TargetWorkflowViewModel.swift

@@ -1,5 +1,5 @@
-import Combine
 import Foundation
+import Observation
 import ICCeryCore
 
 /// Stage 1/2 form state, runner orchestration, resume flow, and preset
@@ -10,7 +10,8 @@ import ICCeryCore
 /// All process work runs through `ArgyllRunner` off `@MainActor`; only
 /// coalesced log batches and completion hop back.
 @MainActor
-final class TargetWorkflowViewModel: ObservableObject {
+@Observable
+final class TargetWorkflowViewModel {
 
     let wizard: WizardViewModel
     let environment: AppEnvironment
@@ -18,112 +19,117 @@ final class TargetWorkflowViewModel: ObservableObject {
 
     // MARK: - Stage 1 form (targen)
 
-    @Published var colourSpace: ColourSpace = .rgb {
+    var colourSpace: ColourSpace = .rgb {
         didSet {
             guard colourSpace != oldValue else { return }
             // CMYK black patches default to 0, RGB to 4 (docs/08).
             blackPatches = colourSpace == .cmyk ? 0 : 4
         }
     }
-    @Published var patchPreset: PatchCountPreset = .standard800
+    var patchPreset: PatchCountPreset = .standard800
     /// `#patchCountCustom` — used when `patchPreset == .custom`.
-    @Published var customPatchCount = 2500
-    @Published var whitePatches = 4
-    @Published var blackPatches = 4
+    var customPatchCount = 2500
+    var whitePatches = 4
+    var blackPatches = 4
 
     // Advanced — each optional flag is enabled + value, so an untouched
     // control emits nothing (#advanced fields are opt-in).
-    @Published var greyStepsEnabled = false
-    @Published var greySteps = 5
-    @Published var singleChannelEnabled = false
-    @Published var singleChannelSteps = 5
-    @Published var neutralStepsEnabled = false
-    @Published var neutralSteps = 3
-    @Published var neutralConcEnabled = false
-    @Published var neutralConcentration = 0.50
-    @Published var preconditioningProfile: String?
-    @Published var highQuality = false
-    @Published var adaptationEnabled = false
-    @Published var adaptation = 0.10
-    @Published var algorithm: FullSpreadAlgorithm = .ofps
-    @Published var inkLimitEnabled = false
-    @Published var totalInkLimit = 320
-    @Published var darkEmphasisEnabled = false
-    @Published var darkEmphasis = 1.0
-    @Published var devicePowerEnabled = false
-    @Published var devicePower = 1.0
+    var greyStepsEnabled = false
+    var greySteps = 5
+    var singleChannelEnabled = false
+    var singleChannelSteps = 5
+    var neutralStepsEnabled = false
+    var neutralSteps = 3
+    var neutralConcEnabled = false
+    var neutralConcentration = 0.50
+    var preconditioningProfile: String?
+    var highQuality = false
+    var adaptationEnabled = false
+    var adaptation = 0.10
+    var algorithm: FullSpreadAlgorithm = .ofps
+    var inkLimitEnabled = false
+    var totalInkLimit = 320
+    var darkEmphasisEnabled = false
+    var darkEmphasis = 1.0
+    var devicePowerEnabled = false
+    var devicePower = 1.0
 
     /// `#targetBasename` — no placeholder is ever invented (#60).
-    @Published var targetBasename = ""
+    var targetBasename = ""
     /// `#selectedPathDisplay` / resolved cwd.
-    @Published var targetDirectory: URL?
+    var targetDirectory: URL?
 
     // MARK: - Stage 2 form (printtarg)
 
-    @Published var instrument: PrintInstrument = .i1
-    @Published var pageSize: PageSize = .a4
-    @Published var customPageW = 210.0
-    @Published var customPageH = 297.0
-    @Published var bitDepth: TiffBitDepth = .eight
+    var instrument: PrintInstrument = .i1
+    var pageSize: PageSize = .a4
+    var customPageW = 210.0
+    var customPageH = 297.0
+    var bitDepth: TiffBitDepth = .eight
     /// `#tiffDpi` — two-way bound; presets can change it (150-DPI draft
     /// regression must be visible here).
-    @Published var tiffDpi = 300
-    @Published var layoutOrder: LayoutOrder = .deterministic
-    @Published var customSeed = 1
-    @Published var labelIsCustom = false
-    @Published var customLabel = ""
-    @Published var metaPrinter = ""
-    @Published var metaInkSet = ""
-    @Published var metaDriverPaper = ""
-    @Published var metaActualPaper = ""
+    var tiffDpi = 300
+    var layoutOrder: LayoutOrder = .deterministic
+    var customSeed = 1
+    var labelIsCustom = false
+    var customLabel = ""
+    var metaPrinter = ""
+    var metaInkSet = ""
+    var metaDriverPaper = ""
+    var metaActualPaper = ""
 
     // MARK: - Run state
 
-    @Published var targenRunning = false
-    @Published var targenLog: [String] = []
-    @Published var printtargRunning = false
-    @Published var printtargLog: [String] = []
-    @Published var printtargResult: PrinttargResult?
+    var targenRunning = false
+    var targenLog: [String] = []
+    var printtargRunning = false
+    var printtargLog: [String] = []
+    var printtargResult: PrinttargResult?
     /// Sticky until the target changes: `.ti2` resume landed us on
     /// Stage 3 (`#stage3LoadedTargetBanner` data).
-    @Published var resumedFromTi2 = false
+    var resumedFromTi2 = false
+
+    // MARK: - Print panel (issue 17)
+
+    /// CUPS destinations from `lpstat` (#printerSelect).
+    var printers: [Printer] = []
+    /// Selected queue name.
+    var selectedPrinter = ""
+    /// Capabilities of the selected queue (#printerTraySelect /
+    /// #printerMediaTypeSelect / PageSize source).
+    var printerCaps = PrinterCapabilities()
+    var selectedTray: Int?
+    var selectedMediaType: String?
+    /// "portrait" | "landscape" (#btnOrientPortrait/#btnOrientLandscape).
+    var printOrientation = "portrait"
+    /// Per-queue captured `key=value` strings from Preferences — replayed
+    /// on `lp` (session-only, docs/11 §capturedCupsOptions).
+    var capturedCupsOptions: [String: String] = [:]
+    /// In-panel notice (#printNotification) — cancel → info, not error.
+    var printNotice: String?
+    var printNoticeIsError = false
+    var isPrinting = false
+    /// Strong reference to the active print task so the unstructured
+    /// `Task` is not dropped before it resumes.
+    private var printTask: Task<Void, Never>?
 
     // MARK: - Presets
 
-    @Published var presets: [ProfilingPreset] = []
-    @Published var selectedPresetID = "none"
-    @Published var showingSavePreset = false
-    @Published var showingManagePresets = false
-    @Published var savePresetName = ""
-    @Published var savePresetDesc = ""
-
-    // MARK: - Media library (issue #146)
-
-    @Published var showingSaveMedia = false
-    @Published var showingManageMedia = false
-
-    // MARK: - Spot read (issue #148)
-
-    /// `RootView` sheet binding for the spot-read console.
-    @Published var showingSpotRead = false
+    var presets: [ProfilingPreset] = []
+    var selectedPresetID = "none"
+    var showingSavePreset = false
+    var showingManagePresets = false
+    var savePresetName = ""
+    var savePresetDesc = ""
 
     /// Stage 3 measurement workflow, owned at the app level so it persists
     /// across stage switches and can observe settings changes.
-    @Published var measurement: MeasurementWorkflowViewModel
+    var measurement: MeasurementWorkflowViewModel
     /// Stage 4/5 profile workflow, owned at the app level so it persists
     /// across stage switches and can observe preset values.
-    @Published var profile: ProfileWorkflowViewModel
+    var profile: ProfileWorkflowViewModel
     /// Stage 0 calibration workflow.
-    @Published var calibration: CalibrationViewModel!
-    /// Stage 2 unmanaged print session.
-    @Published var print: PrintSessionViewModel!
-    /// Media recipe library — needs a complete `self`.
-    @Published var media: MediaLibraryViewModel!
-    /// Spot-read console — needs `wizard` / `measurement`.
-    @Published var spotRead: SpotReadViewModel!
-    /// Project file session (issue #149), created last — needs `media`
-    /// for recipe apply and `spotRead` for the live-child check.
-    @Published var project: ProjectSession!
+    var calibration: CalibrationViewModel!
 
     init(environment: AppEnvironment = .live()) {
         self.environment = environment
@@ -136,25 +142,12 @@ final class TargetWorkflowViewModel: ObservableObject {
             wizard: wizard,
             environment: environment
         )
-        self.print = PrintSessionViewModel(wizard: wizard, environment: environment)
         self.calibration = nil
         self.calibration = CalibrationViewModel(
             workflow: self,
             profile: self.profile,
             environment: environment
         )
-        self.media = MediaLibraryViewModel(
-            workflow: self,
-            environment: environment
-        )
-        self.spotRead = SpotReadViewModel(
-            workflow: self,
-            environment: environment
-        )
-        self.project = ProjectSession(
-            workflow: self,
-            environment: environment
-        )
         reloadPresets()
     }
 
@@ -234,16 +227,16 @@ final class TargetWorkflowViewModel: ObservableObject {
     func generateTarget() {
         guard canGenerate, !targenRunning else { return }
         let config = buildTargenConfig()
+        targenRunning = true
+        targenLog = []
         resumedFromTi2 = false
         let runner = environment.runner
         Task { @MainActor in
             do {
-                let url = try await ProcessRunSupport.runLogged(
-                    setRunning: { self.targenRunning = $0 },
-                    resetLog: { self.targenLog = [] },
-                    onLog: { self.targenLog.append(contentsOf: $0) }
-                ) { onLog in
-                    try await runner.runTargen(config: config, onLogBatch: onLog)
+                let url = try await runner.runTargen(config: config) { [weak self] batch in
+                    Task { @MainActor [weak self] in
+                        self?.targenLog.append(contentsOf: batch)
+                    }
                 }
                 wizard.setTarget(
                     basename: config.basename,
@@ -255,6 +248,7 @@ final class TargetWorkflowViewModel: ObservableObject {
                 wizard.showNotice(
                     "targen failed: \(error.localizedDescription)", kind: .error)
             }
+            targenRunning = false
         }
     }
 
@@ -267,12 +261,7 @@ final class TargetWorkflowViewModel: ObservableObject {
             ? UITestHooks.datasetImportURL
             : fileDialogs.selectDatasetFile()
         guard let url else { return }
-        importMeasurementDataset(from: url)
-    }
 
-    /// Test seam (issue #80): unit tests pass missing or malformed URLs
-    /// directly instead of mutating the global environment.
-    func importMeasurementDataset(from url: URL) {
         do {
             let dataset = try CGATSParser.parse(url: url)
             guard let directory = targetDirectory ?? wizard.effectiveWorkingDirectory else {
@@ -295,6 +284,8 @@ final class TargetWorkflowViewModel: ObservableObject {
             } else {
                 wizard.showNotice("Imported dataset is not ready for profiling.", kind: .warning)
             }
+        } catch let error as CGATSParseError {
+            wizard.showNotice("Import failed: \(error.localizedDescription)", kind: .error)
         } catch {
             wizard.showNotice("Import failed: \(error.localizedDescription)", kind: .error)
         }
@@ -369,25 +360,28 @@ final class TargetWorkflowViewModel: ObservableObject {
     func createLayout() {
         guard wizard.isUnlocked(.layOutPrint), !printtargRunning else { return }
         let config = buildPrinttargConfig()
+        printtargRunning = true
+        printtargLog = []
         printtargResult = nil
         let runner = environment.runner
         Task { @MainActor in
             do {
-                let result = try await ProcessRunSupport.runLogged(
-                    setRunning: { self.printtargRunning = $0 },
-                    resetLog: { self.printtargLog = [] },
-                    onLog: { self.printtargLog.append(contentsOf: $0) }
-                ) { onLog in
-                    try await runner.runPrinttarg(config: config, onLogBatch: onLog)
+                let result = try await runner.runPrinttarg(config: config) { [weak self] batch in
+                    Task { @MainActor [weak self] in
+                        self?.printtargLog.append(contentsOf: batch)
+                    }
                 }
                 printtargResult = result
                 wizard.refreshGating()
                 wizard.showNotice(
                     "Layout created — \(result.manifest.pages.count) page(s) ready.")
             } catch {
+                // Stay on Stage 2: non-zero exit, malformed manifest, or
+                // missing .ti2 must never advance the wizard (#156).
                 wizard.showNotice(
                     "printtarg failed: \(error.localizedDescription)", kind: .error)
             }
+            printtargRunning = false
         }
     }
 
@@ -397,6 +391,160 @@ final class TargetWorkflowViewModel: ObservableObject {
         wizard.go(to: .measure)
     }
 
+    // MARK: - Print panel actions (issue 17)
+
+    /// `#btnRefreshPrinters` — re-enumerate CUPS destinations and load
+    /// capabilities for the selection. Auto-runs when the panel first
+    /// appears with a manifest.
+    func refreshPrinters() {
+        let cups = environment.cupsService
+        Task { @MainActor in
+            do {
+                let list = try await cups.listPrinters()
+                printers = list
+                if !list.contains(where: { $0.name == selectedPrinter }) {
+                    selectedPrinter = list.first { $0.isDefault }?.name
+                        ?? list.first?.name ?? ""
+                }
+                await reloadSelectedCapabilities()
+            } catch {
+                printNotice = "Could not list printers: \(error.localizedDescription)"
+                printNoticeIsError = true
+            }
+        }
+    }
+
+    /// Capabilities for `selectedPrinter` — trays / media / sizes feed
+    /// the selects.
+    func reloadSelectedCapabilities() async {
+        guard !selectedPrinter.isEmpty else {
+            printerCaps = PrinterCapabilities()
+            return
+        }
+        do {
+            printerCaps = try await environment.cupsService
+                .capabilities(for: selectedPrinter)
+            // Default selections only when the captured options didn't
+            // already pin them (Preferences round-trip wins).
+            if selectedMediaType == nil {
+                selectedMediaType = printerCaps.mediaTypes.first?.id
+            }
+            if selectedTray == nil {
+                selectedTray = printerCaps.trays.first?.id
+            }
+        } catch {
+            printerCaps = PrinterCapabilities()
+        }
+    }
+
+    /// `#btnPrinterProperties` — bound NSPrintPanel ("Use Settings").
+    /// Cancel → info notice, never an error, cache untouched. On OK the
+    /// captured options are stored per-queue; a panel-side queue switch
+    /// updates `printerSelect` when the returned CUPS id is in the list.
+    func openPrinterPreferences() {
+        guard !selectedPrinter.isEmpty else { return }
+        let queue = selectedPrinter
+        let displayName = printers.first { $0.name == queue }?.displayName
+        let cups = environment.cupsService
+        Task { @MainActor in
+            do {
+                guard let result = try await PrintPanelService()
+                    .showProperties(
+                        queue: queue, displayName: displayName,
+                        cupsService: cups)
+                else {
+                    printNotice = "Printer properties dialog cancelled."
+                    printNoticeIsError = false
+                    return
+                }
+                if let selected = result.selectedPrinter,
+                   printers.contains(where: { $0.name == selected }),
+                   selected != queue {
+                    selectedPrinter = selected
+                    await reloadSelectedCapabilities()
+                }
+                if let captured = result.options.cupsOptions {
+                    capturedCupsOptions[selectedPrinter] = captured
+                }
+                if let media = result.options.mediaType {
+                    selectedMediaType = media
+                }
+                printNotice = "Settings captured for \(selectedPrinter)."
+                printNoticeIsError = false
+            } catch {
+                printNotice = error.localizedDescription
+                printNoticeIsError = true
+            }
+        }
+    }
+
+    /// `#btnPrintAll` — spool every gallery TIFF, sequentially. Stops on
+    /// the first failure so the user sees which page failed.
+    func printAllPages() {
+        guard let result = printtargResult, !isPrinting else { return }
+        isPrinting = true
+        let task = Task { @MainActor [weak self] in
+            guard let self else { return }
+            defer { self.printTask = nil }
+            var printed = 0
+            for page in result.pages {
+                do {
+                    try await spool(page, index: page.index)
+                    printed += 1
+                } catch {
+                    printNotice = "Print failed on \(page.page.filename): "
+                        + error.localizedDescription
+                    printNoticeIsError = true
+                    isPrinting = false
+                    return
+                }
+            }
+            printNotice = "Sent \(printed) page(s) to \(selectedPrinter)."
+            printNoticeIsError = false
+            isPrinting = false
+        }
+        printTask = task
+    }
+
+    /// `#btnPrintPage-N` — one TIFF.
+    func printPage(_ page: GalleryPage) {
+        guard !isPrinting else { return }
+        isPrinting = true
+        let task = Task { @MainActor [weak self] in
+            guard let self else { return }
+            defer { self.printTask = nil }
+            do {
+                try await spool(page, index: page.index)
+                printNotice = "Sent \(page.page.filename) to \(selectedPrinter)."
+                printNoticeIsError = false
+            } catch {
+                printNotice = "Print failed: \(error.localizedDescription)"
+                printNoticeIsError = true
+            }
+            isPrinting = false
+        }
+        printTask = task
+    }
+
+    private func spool(_ page: GalleryPage, index: Int) async throws {
+        guard !selectedPrinter.isEmpty else {
+            throw CupsError.noPrinterSelected
+        }
+        let options = PrintOptions(
+            orientation: printOrientation,
+            paperSize: pageSize == .custom ? nil : pageSize.rawValue,
+            mediaType: selectedMediaType,
+            ppdUncorrectedPassthrough: true,
+            cupsOptions: capturedCupsOptions[selectedPrinter])
+        try await environment.cupsService.printTarget(
+            queue: selectedPrinter,
+            tiffPath: page.fileURL.path,
+            options: options,
+            page: index)
+        // For Stage 5 history (#95): record which queue printed.
+        wizard.printerName = selectedPrinter
+    }
+
     // MARK: - Presets
 
     func reloadPresets() {
@@ -406,61 +554,55 @@ final class TargetWorkflowViewModel: ObservableObject {
     /// Applies every Stage 1/2 field of the preset to the live form
     /// (bidirectional — the draft preset's dpi=150 must be visible).
     func applyPreset(_ preset: ProfilingPreset) {
-        let targen = TargenConfig(preset: preset, basename: targetBasename, workingDirectory: targetDirectory)
-        applyTargenForm(targen)
-        // Stage 4 state (incl. calibration) is applied before Stage 2 so
-        // the layout config receives the preset's calibration path, not
-        // stale live state (#82).
+        colourSpace = preset.colourSpace == "cmyk" ? .cmyk : .rgb
+        patchPreset = PatchCountPreset(rawValue: "\(preset.patchCount)") ?? .custom
+        customPatchCount = preset.patchCount
+        whitePatches = preset.whitePatches
+        blackPatches = preset.blackPatches
+        greySteps = preset.greySteps ?? 5; greyStepsEnabled = preset.greySteps != nil
+        singleChannelSteps = preset.singleChannelSteps ?? 5
+        singleChannelEnabled = preset.singleChannelSteps != nil
+        neutralSteps = preset.neutralSteps ?? 3
+        neutralStepsEnabled = preset.neutralSteps != nil
+        neutralConcentration = preset.neutralConcentration ?? 0.50
+        neutralConcEnabled = preset.neutralConcentration != nil
+        preconditioningProfile = preset.preconditioningProfile
+        highQuality = preset.ofpsHighQuality == true
+        adaptation = preset.ofpsAdaptation ?? 0.10
+        adaptationEnabled = preset.ofpsAdaptation != nil
+        algorithm = preset.fullSpreadAlgorithm
+            .flatMap { FullSpreadAlgorithm(presetValue: $0) } ?? .ofps
+        totalInkLimit = preset.totalInkLimit ?? 320
+        inkLimitEnabled = preset.totalInkLimit != nil
+        darkEmphasis = preset.darkEmphasis ?? 1.0
+        darkEmphasisEnabled = preset.darkEmphasis != nil
+        devicePower = preset.devicePower ?? 1.0
+        devicePowerEnabled = preset.devicePower != nil
+
+        instrument = PrintInstrument(rawValue: preset.instrument) ?? .i1
+        if let size = PageSize(rawValue: preset.pageSize) {
+            pageSize = size
+        } else if let (w, h) = Self.parseCustomPage(preset.pageSize) {
+            pageSize = .custom; customPageW = w; customPageH = h
+        } else {
+            pageSize = .a4
+        }
+        bitDepth = preset.bitDepth == 16 ? .sixteen : .eight
+        tiffDpi = preset.dpi
+        if preset.noRandomize == true {
+            layoutOrder = .raster
+        } else if (preset.randomSeed ?? 1) == 1 {
+            layoutOrder = .deterministic
+        } else {
+            layoutOrder = .customSeed
+        }
+        customSeed = preset.randomSeed ?? 1
+
         profile.applyPreset(preset)
-        let printtarg = PrinttargConfig(
-            preset: preset,
-            basename: wizard.basename,
-            workingDirectory: wizard.effectiveWorkingDirectory,
-            calibrationFile: profile.applyCalibration && !profile.calibrationFile.isEmpty
-                ? profile.calibrationFile : nil
-        )
-        applyPrinttargForm(printtarg)
+
         selectedPresetID = preset.id
     }
 
-    private func applyTargenForm(_ config: TargenConfig) {
-        colourSpace = config.colourSpace
-        patchPreset = PatchCountPreset(rawValue: "\(config.patchCount)") ?? .custom
-        customPatchCount = config.patchCount
-        whitePatches = config.whitePatches
-        blackPatches = config.blackPatches
-        greySteps = config.greySteps ?? 5
-        greyStepsEnabled = config.greySteps != nil
-        singleChannelSteps = config.singleChannelSteps ?? 5
-        singleChannelEnabled = config.singleChannelSteps != nil
-        neutralSteps = config.neutralSteps ?? 3
-        neutralStepsEnabled = config.neutralSteps != nil
-        neutralConcentration = config.neutralConcentration ?? 0.50
-        neutralConcEnabled = config.neutralConcentration != nil
-        preconditioningProfile = config.preconditioningProfile
-        highQuality = config.ofpsHighQuality == true
-        adaptation = config.ofpsAdaptation ?? 0.10
-        adaptationEnabled = config.ofpsAdaptation != nil
-        algorithm = config.fullSpreadAlgorithm ?? .ofps
-        totalInkLimit = config.totalInkLimit ?? 320
-        inkLimitEnabled = config.totalInkLimit != nil
-        darkEmphasis = config.darkEmphasis ?? 1.0
-        darkEmphasisEnabled = config.darkEmphasis != nil
-        devicePower = config.devicePower ?? 1.0
-        devicePowerEnabled = config.devicePower != nil
-    }
-
-    private func applyPrinttargForm(_ config: PrinttargConfig) {
-        instrument = config.instrument
-        pageSize = config.pageSize
-        customPageW = config.customPageWidth
-        customPageH = config.customPageHeight
-        bitDepth = config.bitDepth
-        tiffDpi = config.dpi
-        layoutOrder = config.layoutOrder
-        customSeed = config.customSeed
-    }
-
     /// Snapshot of the live Stage 1/2 form as a custom preset.
     func saveCurrentAsPreset() {
         let name = savePresetName.trimmingCharacters(in: .whitespacesAndNewlines)
@@ -472,11 +614,39 @@ final class TargetWorkflowViewModel: ObservableObject {
             id: "custom-\(UUID().uuidString.lowercased())",
             name: name,
             description: savePresetDesc.trimmingCharacters(in: .whitespacesAndNewlines),
-            targen: buildTargenConfig(),
-            printtarg: buildPrinttargConfig(),
-            colprof: profile.buildColprofConfig(),
+            colourSpace: colourSpace == .cmyk ? "cmyk" : "rgb",
+            patchCount: effectivePatchCount,
+            whitePatches: whitePatches,
+            blackPatches: blackPatches,
+            greySteps: greyStepsEnabled ? greySteps : nil,
+            singleChannelSteps: singleChannelEnabled ? singleChannelSteps : nil,
+            neutralSteps: neutralStepsEnabled ? neutralSteps : nil,
+            neutralConcentration: neutralConcEnabled ? neutralConcentration : nil,
+            preconditioningProfile: preconditioningProfile,
+            ofpsHighQuality: highQuality ? true : nil,
+            ofpsAdaptation: adaptationEnabled ? adaptation : nil,
+            fullSpreadAlgorithm: algorithm.presetValue,
+            totalInkLimit: inkLimitEnabled ? totalInkLimit : nil,
+            darkEmphasis: darkEmphasisEnabled ? darkEmphasis : nil,
+            devicePower: devicePowerEnabled ? devicePower : nil,
+            instrument: instrument.rawValue,
+            pageSize: pageSize == .custom
+                ? "\(Int(customPageW))x\(Int(customPageH))"
+                : pageSize.rawValue,
+            bitDepth: bitDepth.rawValue,
+            dpi: tiffDpi,
+            randomSeed: layoutOrder == .deterministic ? 1 : customSeed,
+            noRandomize: layoutOrder == .raster,
             calibrationFile: profile.calibrationFile.isEmpty ? nil : profile.calibrationFile,
-            applyCalibration: profile.applyCalibration ? true : nil
+            applyCalibration: profile.applyCalibration ? true : nil,
+            colprofAlgorithm: profile.algorithm,
+            colprofQuality: profile.quality,
+            colprofIntent: profile.intent.isEmpty ? nil : profile.intent,
+            colprofFwa: profile.fwaValue,
+            colprofIlluminant: profile.illuminant.isEmpty ? nil : profile.illuminant,
+            colprofObserver: profile.observer.isEmpty ? nil : profile.observer,
+            colprofInputViewingCond: profile.inputViewingCond.isEmpty ? nil : profile.inputViewingCond,
+            colprofOutputViewingCond: profile.outputViewingCond.isEmpty ? nil : profile.outputViewingCond
         )
         do {
             try environment.presetStore.saveCustom(preset)
@@ -540,6 +710,10 @@ final class TargetWorkflowViewModel: ObservableObject {
     }
 
     static func parseCustomPage(_ raw: String) -> (Double, Double)? {
-        PageSize.parseCustom(raw)
+        let parts = raw.lowercased().split(separator: "x")
+        guard parts.count == 2,
+              let w = Double(parts[0]), let h = Double(parts[1]),
+              w >= 50, h >= 50 else { return nil }
+        return (w, h)
     }
 }

Sources/ICCery/WizardViewModel.swift

@@ -1,5 +1,5 @@
-import Combine
 import Foundation
+import Observation
 import ICCeryCore
 
 /// Wizard state machine + artefact gating (issue #4, docs/06).
@@ -10,46 +10,47 @@ import ICCeryCore
 /// `wizard_state.json`; unlocks come from `ArtefactProbe.verify` —
 /// navigation is disk, not buttons.
 @MainActor
-final class WizardViewModel: ObservableObject {
+@Observable
+final class WizardViewModel {
 
     // MARK: - wizardState fields (persisted)
 
-    @Published var stage: WizardStage {
+    var stage: WizardStage {
         didSet { if stage != oldValue { persist() } }
     }
     /// `wizardState.basename` — empty until a real artefact names it (#60).
-    @Published var basename: String {
+    var basename: String {
         didSet { if basename != oldValue { refreshGating(); persist() } }
     }
     /// `wizardState.cwd` — resolved via `resolveSafeCwd` (#59).
-    @Published var workingDirectory: URL? {
+    var workingDirectory: URL? {
         didSet { if workingDirectory != oldValue { refreshGating(); persist() } }
     }
-    @Published var printerName: String? {
+    var printerName: String? {
         didSet { if printerName != oldValue { persist() } }
     }
-    @Published var sessionMode: SessionMode {
+    var sessionMode: SessionMode {
         didSet { if sessionMode != oldValue { persist() } }
     }
     /// `profileBasename` may differ after a `.ti3` import (#94).
-    @Published var profileBasename: String? {
+    var profileBasename: String? {
         didSet { if profileBasename != oldValue { persist() } }
     }
     /// Pre-`CAL_` basename, persisted so relaunch/Force Quit can restore it (#29).
-    @Published var calibrationOriginalBasename: String {
+    var calibrationOriginalBasename: String {
         didSet { if calibrationOriginalBasename != oldValue { persist() } }
     }
 
     // MARK: - Ephemeral
 
     /// Banner notice currently displayed (`#wizardNotification`).
-    @Published var notice: Notice?
+    var notice: Notice?
     /// Current artefact probe result; recomputed on `refreshGating()`.
-    @Published private(set) var artefacts = StageArtefacts()
+    private(set) var artefacts = StageArtefacts()
     /// Whether the 3D gamut viewer sheet is open (issue #28).
-    @Published var showingGamutViewer = false
+    var showingGamutViewer = false
     /// Optional `.gam` URL to show alongside the sRGB reference.
-    @Published var gamutProfileURL: URL?
+    var gamutProfileURL: URL?
 
     private let stateStore: WizardStateStore
     private var noticeDismissTask: Task<Void, Never>?
@@ -66,12 +67,8 @@ final class WizardViewModel: ObservableObject {
         self.calibrationOriginalBasename = s.calibrationOriginalBasename
         // A Force Quit mid-calibration leaves a CAL_ basename behind; restore
         // the original before the UI can do anything with it (#29).
-        if CalibrationIdentity.isCalibration(basename), !calibrationOriginalBasename.isEmpty {
-            let identity = CalibrationIdentity.parse(
-                liveBasename: basename,
-                persistedOriginal: calibrationOriginalBasename
-            )
-            basename = identity.originalBasename
+        if basename.hasPrefix("CAL_"), !calibrationOriginalBasename.isEmpty {
+            basename = calibrationOriginalBasename
             calibrationOriginalBasename = ""
             sessionMode = .profile
             stage = .generate
@@ -131,7 +128,7 @@ final class WizardViewModel: ObservableObject {
     /// refused and the original basename is restored (#29).
     func go(to target: WizardStage) {
         guard target != .calibrate else { enterCalibration(); return }
-        if CalibrationIdentity.isCalibration(basename) {
+        if basename.hasPrefix("CAL_") {
             guard !calibrationOriginalBasename.isEmpty else {
                 showNotice(
                     "Cannot leave calibration — the original target name is missing.",
@@ -155,7 +152,7 @@ final class WizardViewModel: ObservableObject {
     }
 
     func enterCalibration() {
-        if !basename.isEmpty, !CalibrationIdentity.isCalibration(basename), calibrationOriginalBasename.isEmpty {
+        if !basename.isEmpty, !basename.hasPrefix("CAL_"), calibrationOriginalBasename.isEmpty {
             calibrationOriginalBasename = basename
         }
         sessionMode = .calibration
@@ -200,7 +197,7 @@ final class WizardViewModel: ObservableObject {
         self.notice = notice
         if let delay = notice.autoHideAfter {
             noticeDismissTask = Task { [weak self] in
-                try? await Task.sleep(nanoseconds: UInt64(delay * 1_000_000_000))
+                try? await Task.sleep(for: .seconds(delay))
                 guard !Task.isCancelled else { return }
                 if self?.notice?.id == notice.id {
                     self?.notice = nil

Tests/ICCeryCoreTests/AppPathsTests.swift

@@ -1,25 +1,27 @@
-import XCTest
+import Testing
 import Foundation
 @testable import ICCeryCore
 
-final class AppPathsTests: XCTestCase {
-    func testAppDataDirUsesBundleID() {
-        XCTAssertTrue(AppPaths.appDataDir.path.contains("Library/Application Support/com.gronod.iccery2"))
+@Suite("AppPaths")
+struct AppPathsTests {
+    @Test func appDataDirUsesBundleID() {
+        #expect(AppPaths.appDataDir.path.contains("Library/Application Support/com.gronod.iccery2"))
     }
 
-    func testLogFileIsUnderLibraryLogs() {
-        XCTAssertEqual(AppPaths.logFile.lastPathComponent, "iccery.log")
-        XCTAssertTrue(AppPaths.logFile.path.contains("Library/Logs/com.gronod.iccery2"))
+    @Test func logFileIsUnderLibraryLogs() {
+        #expect(AppPaths.logFile.lastPathComponent == "iccery.log")
+        #expect(AppPaths.logFile.path.contains("Library/Logs/com.gronod.iccery2"))
     }
 
-    func testBundledArgyllDirIsInsideResources() {
-        XCTAssertEqual(AppPaths.bundledArgyllDir.lastPathComponent, "Argyll")
+    @Test func bundledArgyllDirIsInsideResources() {
+        #expect(AppPaths.bundledArgyllDir.lastPathComponent == "Argyll")
     }
 }
 
-final class WizardStageTests: XCTestCase {
-    func testStepperOrderIsOneThroughFive() {
-        XCTAssertEqual(WizardStage.stepperStages.map(\.stepperIndex), [1, 2, 3, 4, 5])
-        XCTAssertNil(WizardStage.calibrate.stepperIndex)
+@Suite("WizardStage")
+struct WizardStageTests {
+    @Test func stepperOrderIsOneThroughFive() {
+        #expect(WizardStage.stepperStages.map(\.stepperIndex) == [1, 2, 3, 4, 5])
+        #expect(WizardStage.calibrate.stepperIndex == nil)
     }
 }

Tests/ICCeryCoreTests/ApplycalArgsTests.swift

@@ -1,19 +1,22 @@
 import Foundation
-import XCTest
+import Testing
 @testable import ICCeryCore
 
-final class ApplycalArgsTests: XCTestCase {
+@Suite("ApplycalArgs")
+struct ApplycalArgsTests {
 
-    func testApplyArgv() throws {
+    @Test("Apply argv")
+    func applyArgv() throws {
         let config = ApplycalConfig(
             calibrationPath: "/tmp/cal.cal",
             inputProfileURL: URL(fileURLWithPath: "/tmp/profile.icc")
         )
         let args = try ApplycalArgs.build(config: config)
-        XCTAssertEqual(args, ["-v", "-a", "/tmp/cal.cal", "/tmp/profile.icc"])
+        #expect(args == ["-v", "-a", "/tmp/cal.cal", "/tmp/profile.icc"])
     }
 
-    func testUnapplyEmittedWhenConfigSet() throws {
+    @Test("Unapply is emitted when the caller explicitly sets it")
+    func unapplyEmittedWhenConfigSet() throws {
         let config = ApplycalConfig(
             calibrationPath: "/tmp/cal.cal",
             inputProfileURL: URL(fileURLWithPath: "/tmp/profile.icc"),
@@ -22,6 +25,6 @@ final class ApplycalArgsTests: XCTestCase {
         let args = try ApplycalArgs.build(config: config)
         // Builder emits -u only when the caller explicitly sets unapply.
         // The UI layer never passes unapply: true in v2.0.
-        XCTAssertEqual(args, ["-v", "-u", "/tmp/cal.cal", "/tmp/profile.icc"])
+        #expect(args == ["-v", "-u", "/tmp/cal.cal", "/tmp/profile.icc"])
     }
 }

Tests/ICCeryCoreTests/ApproximateLabTests.swift

@@ -1,39 +0,0 @@
-import Foundation
-import XCTest
-@testable import ICCeryCore
-
-/// ``ApproximateLab`` sanity tests (issue #147).
-///
-/// These are loose sanity checks on a fixed-matrix approximation — not
-/// ColorSync goldens.
-final class ApproximateLabTests: XCTestCase {
-
-    func testWhiteMapsToHighLStar() {
-        let lab = ApproximateLab.srgb8ToLab(r: 255, g: 255, b: 255)
-        XCTAssertGreaterThan(lab.l, 95)
-        XCTAssertEqual(lab.a, 0, accuracy: 2)
-        XCTAssertEqual(lab.b, 0, accuracy: 2)
-    }
-
-    func testBlackMapsToZeroLStar() {
-        let lab = ApproximateLab.srgb8ToLab(r: 0, g: 0, b: 0)
-        XCTAssertEqual(lab.l, 0, accuracy: 1)
-    }
-
-    func testPureRedIsChromatic() {
-        let lab = ApproximateLab.srgb8ToLab(r: 255, g: 0, b: 0)
-        // sRGB red ≈ Lab D50 (54, 81, 70) — loose bounds only.
-        XCTAssertGreaterThan(lab.l, 40)
-        XCTAssertLessThan(lab.l, 65)
-        XCTAssertGreaterThan(lab.a, 60)
-        XCTAssertGreaterThan(lab.b, 40)
-    }
-
-    func testMidGreyIsNeutral() {
-        let lab = ApproximateLab.srgb8ToLab(r: 128, g: 128, b: 128)
-        XCTAssertGreaterThan(lab.l, 45)
-        XCTAssertLessThan(lab.l, 65)
-        XCTAssertEqual(lab.a, 0, accuracy: 1)
-        XCTAssertEqual(lab.b, 0, accuracy: 1)
-    }
-}

Tests/ICCeryCoreTests/ArgsBuilderTests.swift

@@ -1,80 +0,0 @@
-import XCTest
-import Foundation
-@testable import ICCeryCore
-
-final class ArgsBuilderTests: XCTestCase {
-
-    // MARK: - option
-
-    func testOptionNil() {
-        XCTAssertEqual(ArgsBuilder.option("-f", nil), [])
-    }
-
-    func testOptionPresent() {
-        XCTAssertEqual(ArgsBuilder.option("-f", "abc"), ["-f", "abc"])
-        XCTAssertEqual(ArgsBuilder.option("-f", ""), ["-f", ""])
-        XCTAssertEqual(ArgsBuilder.option("-f", "  padded  "), ["-f", "  padded  "])
-    }
-
-    // MARK: - optionIfNonEmpty
-
-    func testOptionIfNonEmptyNilEmpty() {
-        XCTAssertEqual(ArgsBuilder.optionIfNonEmpty("-d", nil), [])
-        XCTAssertEqual(ArgsBuilder.optionIfNonEmpty("-d", ""), [])
-    }
-
-    func testOptionIfNonEmptyWhitespace() {
-        XCTAssertEqual(ArgsBuilder.optionIfNonEmpty("-d", "   "), [])
-        XCTAssertEqual(ArgsBuilder.optionIfNonEmpty("-d", " \t\n "), [])
-    }
-
-    func testOptionIfNonEmptyTrims() {
-        XCTAssertEqual(ArgsBuilder.optionIfNonEmpty("-d", "  label  "), ["-d", "label"])
-        XCTAssertEqual(ArgsBuilder.optionIfNonEmpty("-d", "\tcal.cal\n"), ["-d", "cal.cal"])
-    }
-
-    // MARK: - optionUnlessApprox
-
-    func testOptionUnlessApproxNil() {
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-N", nil, skip: 0.50), [])
-    }
-
-    func testOptionUnlessApproxExactSkip() {
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-N", 0.50, skip: 0.50), [])
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-V", 1.0, skip: 1.0), [])
-    }
-
-    func testOptionUnlessApproxWithinEpsilon() {
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-N", 0.5005, skip: 0.50), [])
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-V", 0.9995, skip: 1.0), [])
-    }
-
-    func testOptionUnlessApproxOutsideEpsilon() {
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-N", 0.75, skip: 0.50), ["-N", "0.75"])
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-V", 1.50, skip: 1.0), ["-V", "1.50"])
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-N", 0.498, skip: 0.50), ["-N", "0.50"])
-    }
-
-    func testOptionUnlessApproxPOSIX() {
-        // 1234.5 must never produce a grouping separator or comma decimal.
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-p", 1234.5, skip: 1.0), ["-p", "1234.50"])
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-p", 2.0, skip: 1.0), ["-p", "2.00"])
-    }
-
-    func testOptionUnlessApproxCustom() {
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-x", 1.005, skip: 1.0, epsilon: 0.01), [])
-        XCTAssertEqual(ArgsBuilder.optionUnlessApprox("-x", 1.5, skip: 1.0, format: "%.1f"), ["-x", "1.5"])
-    }
-
-    // MARK: - flag
-
-    func testFlagTrue() {
-        XCTAssertEqual(ArgsBuilder.flag("-G", when: true), ["-G"])
-        XCTAssertEqual(ArgsBuilder.flag("-r", when: true), ["-r"])
-    }
-
-    func testFlagFalse() {
-        XCTAssertEqual(ArgsBuilder.flag("-G", when: false), [])
-        XCTAssertEqual(ArgsBuilder.flag("-r", when: false), [])
-    }
-}

Tests/ICCeryCoreTests/ArgyllRunnerCalibrationTests.swift

@@ -1,16 +1,17 @@
 import Foundation
-import XCTest
+import Testing
 @testable import ICCeryCore
 
-final class ArgyllRunnerCalibrationTests: XCTestCase {
+@Suite("ArgyllRunner Calibration")
+struct ArgyllRunnerCalibrationTests {
 
-    private func makeRunner(processManager: ProcessManager = ProcessManager()) -> ArgyllRunner {
+    private func makeRunner() -> ArgyllRunner {
         let binDir = URL(fileURLWithPath: #filePath)
             .deletingLastPathComponent()
             .deletingLastPathComponent()
             .appendingPathComponent("ICCeryUITests/Fixtures/bin")
         return ArgyllRunner(
-            processManager: processManager,
+            processManager: .shared,
             binaryResolver: BinaryResolver(overrideDir: binDir)
         )
     }
@@ -22,7 +23,8 @@ final class ArgyllRunnerCalibrationTests: XCTestCase {
         return root
     }
 
-    func testCalibrationTargenProducesTi1() async throws {
+    @Test("Calibration targen produces CAL_*.ti1")
+    func calibrationTargenProducesTi1() async throws {
         let testRoot = try makeTestDir()
         let runner = makeRunner()
         let config = CalibrationTargenConfig(
@@ -34,41 +36,13 @@ final class ArgyllRunnerCalibrationTests: XCTestCase {
 
         let url = try await runner.runCalibrationTargen(config: config)
 
-        XCTAssertEqual(url.lastPathComponent, "CAL_demo.ti1")
-        XCTAssertTrue(FileManager.default.fileExists(atPath: url.path))
+        #expect(url.lastPathComponent == "CAL_demo.ti1")
+        #expect(FileManager.default.fileExists(atPath: url.path))
         try? FileManager.default.removeItem(at: testRoot)
     }
 
-    func testCalibrationTargenProcessId() async throws {
-        let testRoot = try makeTestDir()
-        let pm = ProcessManager()
-        let runner = makeRunner(processManager: pm)
-        let events = pm.events()
-        // Subscribed before spawn; the exit event is emitted before
-        // runCalibrationTargen returns, so this always terminates.
-        let sawExit = Task {
-            for await event in events {
-                guard event.id == "targen_CAL_foo" else { continue }
-                if case .exit = event { return true }
-            }
-            return false
-        }
-        let config = CalibrationTargenConfig(
-            colourSpace: .rgb,
-            steps: 21,
-            basename: "foo",
-            workingDirectory: testRoot
-        )
-
-        let url = try await runner.runCalibrationTargen(config: config)
-
-        XCTAssertEqual(url.lastPathComponent, "CAL_foo.ti1")
-        let sawExitEvent = await sawExit.value
-        XCTAssertTrue(sawExitEvent)
-        try? FileManager.default.removeItem(at: testRoot)
-    }
-
-    func testPrintcalProducesCal() async throws {
+    @Test("printcal captured run creates .cal")
+    func printcalProducesCal() async throws {
         let testRoot = try makeTestDir()
         let runner = makeRunner()
         let output = testRoot.appendingPathComponent("CAL_demo.cal")
@@ -80,32 +54,15 @@ final class ArgyllRunnerCalibrationTests: XCTestCase {
 
         let url = try await runner.runPrintcal(config: config)
 
-        XCTAssertEqual(url.lastPathComponent, "CAL_demo.cal")
-        XCTAssertTrue(FileManager.default.fileExists(atPath: url.path))
+        #expect(url.lastPathComponent == "CAL_demo.cal")
+        #expect(FileManager.default.fileExists(atPath: url.path))
         try? FileManager.default.removeItem(at: testRoot)
     }
 
-    func testPrintcalFailureThrows() async throws {
+    @Test("printcal failure throws printcalFailed")
+    func printcalFailureThrows() async throws {
         let testRoot = try makeTestDir()
-        defer { try? FileManager.default.removeItem(at: testRoot) }
-
-        // Per-test mock printcal that always fails — no global
-        // environment mutation, no shared fixture changes.
-        let binDir = try makeTestDir()
-        defer { try? FileManager.default.removeItem(at: binDir) }
-        let mockURL = binDir.appendingPathComponent("printcal")
-        try """
-        #!/bin/sh
-        echo "printcal mock failure" >&2
-        exit 1
-        """.write(to: mockURL, atomically: true, encoding: .utf8)
-        try FileManager.default.setAttributes(
-            [.posixPermissions: 0o755], ofItemAtPath: mockURL.path)
-
-        let runner = ArgyllRunner(
-            processManager: ProcessManager(),
-            binaryResolver: BinaryResolver(bundledRoot: binDir, overrideDir: binDir)
-        )
+        let runner = makeRunner()
         let output = testRoot.appendingPathComponent("CAL_demo.cal")
         let config = PrintcalConfig(
             ti3Basename: "CAL_demo",
@@ -113,11 +70,12 @@ final class ArgyllRunnerCalibrationTests: XCTestCase {
             outputURL: output
         )
 
-        await assertAsyncThrows(expectedType: ArgyllRunnerError.self) {
+        setenv("ICCERY_MOCK_PRINTCAL_EXIT", "1", 1)
+        defer { unsetenv("ICCERY_MOCK_PRINTCAL_EXIT") }
+
+        await #expect(throws: (any Error).self) {
             _ = try await runner.runPrintcal(config: config)
-        } errorHandler: { error in
-            XCTAssertEqual(error, .toolFailed(
-                tool: "printcal", code: 1, logs: ["printcal mock failure\n"]))
         }
+        try? FileManager.default.removeItem(at: testRoot)
     }
 }

Tests/ICCeryCoreTests/ArgyllRunnerColprofTests.swift

@@ -1,5 +1,5 @@
 import Foundation
-import XCTest
+import Testing
 @testable import ICCeryCore
 
 final class LogHolder: @unchecked Sendable {
@@ -19,9 +19,11 @@ final class LogHolder: @unchecked Sendable {
     }
 }
 
-final class ArgyllRunnerColprofTests: XCTestCase {
+@Suite("ArgyllRunner colprof")
+struct ArgyllRunnerColprofTests {
 
-    func testColprofProducesIcc() async throws {
+    @Test("Mock colprof produces .icc")
+    func colprofProducesIcc() async throws {
         let binDir = URL(fileURLWithPath: #filePath)
             .deletingLastPathComponent()
             .deletingLastPathComponent()
@@ -31,7 +33,7 @@ final class ArgyllRunnerColprofTests: XCTestCase {
         try FileManager.default.createDirectory(at: testRoot, withIntermediateDirectories: true)
 
         let runner = ArgyllRunner(
-            processManager: ProcessManager(),
+            processManager: .shared,
             binaryResolver: BinaryResolver(overrideDir: binDir)
         )
 
@@ -41,39 +43,10 @@ final class ArgyllRunnerColprofTests: XCTestCase {
             holder.append(batch)
         }
 
-        XCTAssertEqual(url.lastPathComponent, "testrun.icc")
-        XCTAssertTrue(FileManager.default.fileExists(atPath: url.path))
-        XCTAssertTrue(holder.lines.contains { $0.contains("Gamut mapping") })
+        #expect(url.lastPathComponent == "testrun.icc")
+        #expect(FileManager.default.fileExists(atPath: url.path))
+        #expect(holder.lines.contains { $0.contains("Gamut mapping") })
 
         try? FileManager.default.removeItem(at: testRoot)
     }
-
-    func testColprofFailureThrowsToolFailed() async throws {
-        let dir = FileManager.default.temporaryDirectory
-            .appendingPathComponent("colprof-fail-\(UUID().uuidString)")
-        try FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)
-        defer { try? FileManager.default.removeItem(at: dir) }
-
-        let mockURL = dir.appendingPathComponent("colprof")
-        try """
-        #!/bin/sh
-        echo "colprof broke" >&2
-        exit 4
-        """.write(to: mockURL, atomically: true, encoding: .utf8)
-        try FileManager.default.setAttributes(
-            [.posixPermissions: 0o755], ofItemAtPath: mockURL.path)
-
-        let runner = ArgyllRunner(
-            processManager: ProcessManager(),
-            binaryResolver: BinaryResolver(bundledRoot: dir, overrideDir: dir)
-        )
-        let config = ColprofConfig(basename: "failrun", workingDirectory: dir)
-
-        await assertAsyncThrows(expectedType: ArgyllRunnerError.self) {
-            try await runner.runColprof(config: config)
-        } errorHandler: { error in
-            XCTAssertEqual(error, .toolFailed(
-                tool: "colprof", code: 4, logs: ["colprof broke"]))
-        }
-    }
 }

Tests/ICCeryCoreTests/ArgyllRunnerStreamingLoopTests.swift

@@ -1,158 +0,0 @@
-import Foundation
-import XCTest
-@testable import ICCeryCore
-
-/// Focused contracts for the shared `runStreamingTool` loop (#79).
-///
-/// Every test uses a per-test temporary directory, unique basenames,
-/// and a fresh `ProcessManager` — no shared UI fixture scripts and no
-/// process-environment mutation.
-final class ArgyllRunnerStreamingLoopTests: XCTestCase {
-
-    private func makeTempDir() throws -> URL {
-        let dir = FileManager.default.temporaryDirectory
-            .appendingPathComponent("runner-loop-\(UUID().uuidString)")
-        try FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)
-        return dir
-    }
-
-    private func writeMock(_ name: String, _ body: String, in dir: URL) throws {
-        let url = dir.appendingPathComponent(name)
-        try body.write(to: url, atomically: true, encoding: .utf8)
-        try FileManager.default.setAttributes(
-            [.posixPermissions: 0o755], ofItemAtPath: url.path)
-    }
-
-    private func makeRunner(binDir: URL) -> ArgyllRunner {
-        ArgyllRunner(
-            processManager: ProcessManager(),
-            binaryResolver: BinaryResolver(bundledRoot: binDir, overrideDir: binDir))
-    }
-
-    func testNonZeroExitThrowsToolFailed() async throws {
-        let dir = try makeTempDir()
-        defer { try? FileManager.default.removeItem(at: dir) }
-        try writeMock("targen", """
-            #!/bin/sh
-            echo "Generating patches..."
-            echo "targen: too few patches" >&2
-            exit 3
-            """, in: dir)
-        let runner = makeRunner(binDir: dir)
-        let config = TargenConfig(
-            colourSpace: .rgb, patchCount: 800, whitePatches: 4,
-            blackPatches: 4, basename: "fail", workingDirectory: dir)
-
-        do {
-            _ = try await runner.runTargen(config: config)
-            XCTFail("Expected toolFailed")
-        } catch let error as ArgyllRunnerError {
-            guard case .toolFailed(let tool, let code, let logs) = error else {
-                XCTFail("Expected toolFailed, got \(error)")
-                return
-            }
-            XCTAssertEqual(tool, "targen")
-            XCTAssertEqual(code, 3)
-            XCTAssertTrue(logs.contains("Generating patches..."))
-            XCTAssertTrue(logs.contains("targen: too few patches"))
-        }
-    }
-
-    func testZeroExitMissingArtefact() async throws {
-        let dir = try makeTempDir()
-        defer { try? FileManager.default.removeItem(at: dir) }
-        try writeMock("targen", """
-            #!/bin/sh
-            echo "done but wrote nothing"
-            exit 0
-            """, in: dir)
-        let runner = makeRunner(binDir: dir)
-        let expectedPath = dir.appendingPathComponent("gone.ti1").path
-        let config = TargenConfig(
-            colourSpace: .rgb, patchCount: 800, whitePatches: 4,
-            blackPatches: 4, basename: "gone", workingDirectory: dir)
-
-        await assertAsyncThrows(expectedType: ArgyllRunnerError.self) {
-            try await runner.runTargen(config: config)
-        } errorHandler: { error in
-            XCTAssertEqual(error, .missingArtefact(expectedPath))
-        }
-    }
-
-    func testImmediateExitDeliversLine() async throws {
-        let dir = try makeTempDir()
-        defer { try? FileManager.default.removeItem(at: dir) }
-        try writeMock("targen", """
-            #!/bin/sh
-            last=""
-            for arg in "$@"; do last="$arg"; done
-            echo "only line"
-            touch "$last.ti1"
-            exit 0
-            """, in: dir)
-        let runner = makeRunner(binDir: dir)
-        let config = TargenConfig(
-            colourSpace: .rgb, patchCount: 800, whitePatches: 4,
-            blackPatches: 4, basename: "quick", workingDirectory: dir)
-
-        let holder = LogHolder()
-        let url = try await runner.runTargen(config: config) { batch in
-            holder.append(batch)
-        }
-        XCTAssertEqual(url.lastPathComponent, "quick.ti1")
-        XCTAssertTrue(FileManager.default.fileExists(atPath: url.path))
-        XCTAssertTrue(holder.lines.contains("only line"))
-    }
-
-    func testColprofPartialLineFlush() async throws {
-        let dir = try makeTempDir()
-        defer { try? FileManager.default.removeItem(at: dir) }
-        // The fragment is printed without a newline, then the mock sleeps
-        // past the 500 ms partial-line flush interval before writing the
-        // artefact and exiting — so the tail is delivered mid-run.
-        try writeMock("colprof", """
-            #!/bin/sh
-            last=""
-            for arg in "$@"; do last="$arg"; done
-            printf 'Doing gamut mapping'
-            sleep 2
-            touch "$last.icc"
-            exit 0
-            """, in: dir)
-        let runner = makeRunner(binDir: dir)
-        let config = ColprofConfig(basename: "frag", workingDirectory: dir)
-
-        let holder = LogHolder()
-        let url = try await runner.runColprof(config: config) { batch in
-            holder.append(batch)
-        }
-        XCTAssertEqual(url.lastPathComponent, "frag.icc")
-        XCTAssertTrue(FileManager.default.fileExists(atPath: url.path))
-        XCTAssertTrue(holder.lines.contains("Doing gamut mapping"))
-    }
-
-    func testToolDescriptions() {
-        let cases: [(tool: String, expected: String)] = [
-            (tool: "chartread", expected: "Chartread failed: boom"),
-            (tool: "average", expected: "Averaging failed: boom"),
-            (tool: "colprof", expected: "Profile creation failed: boom"),
-            (tool: "printcal", expected: "Calibration curve computation failed: boom"),
-            (tool: "applycal", expected: "Apply calibration failed: boom"),
-            (tool: "iccgamut", expected: "Gamut extraction failed: boom"),
-            (tool: "profcheck", expected: "Profile verification failed: boom"),
-        ]
-        for (tool, expected) in cases {
-            let error = ArgyllRunnerError.toolFailed(tool: tool, code: 1, logs: ["boom"])
-            XCTAssertEqual(error.errorDescription, expected)
-        }
-    }
-
-    func testGenericFallbacks() {
-        let unknown = ArgyllRunnerError.toolFailed(tool: "targen", code: 7, logs: ["boom"])
-        XCTAssertEqual(unknown.errorDescription, "Process exited with code 7")
-
-        let emptyLogs = ArgyllRunnerError.toolFailed(tool: "colprof", code: 2, logs: [])
-        XCTAssertEqual(emptyLogs.errorDescription,
-            "Profile creation failed: exited with code 2")
-    }
-}

Tests/ICCeryCoreTests/ArtefactFilesTests.swift

@@ -1,4 +1,4 @@
-import XCTest
+import Testing
 import Foundation
 import ImageIO
 import UniformTypeIdentifiers
@@ -10,8 +10,9 @@ private func tempURL(_ name: String) -> URL {
         .appendingPathComponent(name)
 }
 
-final class Ti2HeaderTests: XCTestCase {
-    func testParsesKeywordsAndSibling() throws {
+@Suite("Ti2Header")
+struct Ti2HeaderTests {
+    @Test func parsesKeywordsAndSibling() throws {
         let dir = FileManager.default.temporaryDirectory
             .appendingPathComponent("iccery-ti2-\(UUID().uuidString)")
         try FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)
@@ -30,18 +31,18 @@ final class Ti2HeaderTests: XCTestCase {
         )
 
         let h = Ti2Header.parse(dir.appendingPathComponent("job.ti2"))
-        XCTAssertEqual(h.instrument, "i1iO")
-        XCTAssertEqual(h.patchCount, 800)
-        XCTAssertEqual(h.pageCount, 3)
-        XCTAssertTrue(h.hasSiblingTi1)
+        #expect(h.instrument == "i1iO")
+        #expect(h.patchCount == 800)
+        #expect(h.pageCount == 3)
+        #expect(h.hasSiblingTi1)
     }
 
-    func testMissingFileYieldsEmptyHeader() {
+    @Test func missingFileYieldsEmptyHeader() {
         let h = Ti2Header.parse(URL(fileURLWithPath: "/nonexistent/x.ti2"))
-        XCTAssertTrue(h.instrument == nil && h.patchCount == nil && !h.hasSiblingTi1)
+        #expect(h.instrument == nil && h.patchCount == nil && !h.hasSiblingTi1)
     }
 
-    func testNumberOfFieldsIsNotPatchCount() throws {
+    @Test func numberOfFieldsIsNotPatchCount() throws {
         let url = tempURL("t.ti2")
         try FileManager.default.createDirectory(
             at: url.deletingLastPathComponent(), withIntermediateDirectories: true
@@ -49,11 +50,12 @@ final class Ti2HeaderTests: XCTestCase {
         try "NUMBER_OF_FIELDS 9\nNUMBER_OF_SETS 52\nBEGIN_DATA\n".write(
             to: url, atomically: true, encoding: .utf8
         )
-        XCTAssertEqual(Ti2Header.parse(url).patchCount, 52)
+        #expect(Ti2Header.parse(url).patchCount == 52)
     }
 }
 
-final class TiffPreviewTests: XCTestCase {
+@Suite("TiffPreview")
+struct TiffPreviewTests {
     /// Builds a real 2000×1000 TIFF in a temp dir via ImageIO.
     private func makeTiff(width: Int = 2000, height: Int = 1000) throws -> URL {
         let url = tempURL("big.tif")
@@ -79,190 +81,44 @@ final class TiffPreviewTests: XCTestCase {
         return url
     }
 
-    func testProducesCappedPNG() throws {
+    @Test func producesCappedPNG() throws {
         let tiff = try makeTiff()
         let png = TiffPreview.previewPNG(tiff: tiff)
-        XCTAssertNotNil(png)
+        #expect(png != nil)
         // PNG magic
-        XCTAssertEqual(png!.prefix(8), Data([0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A]))
+        #expect(png!.prefix(8) == Data([0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A]))
         // Verify the cap by decoding the thumbnail header.
         let src = CGImageSourceCreateWithData(png! as CFData, nil)!
         let img = CGImageSourceCreateImageAtIndex(src, 0, nil)!
-        XCTAssertTrue(max(img.width, img.height) <= TiffPreview.maxEdge)
-        XCTAssertEqual(img.width, 1200)
+        #expect(max(img.width, img.height) <= TiffPreview.maxEdge)
+        #expect(img.width == 1200)
     }
 
-    func testNonTiffReturnsNil() throws {
+    @Test func nonTiffReturnsNil() throws {
         let url = tempURL("not-tiff.txt")
         try FileManager.default.createDirectory(
             at: url.deletingLastPathComponent(), withIntermediateDirectories: true
         )
         try "hello".write(to: url, atomically: true, encoding: .utf8)
-        XCTAssertNil(TiffPreview.previewPNG(tiff: url))
+        #expect(TiffPreview.previewPNG(tiff: url) == nil)
     }
 }
 
-final class AppInfoTests: XCTestCase {
-    // MARK: displayVersion (#189)
-
-    func testNoTagFallsBackToShortVersion() {
-        XCTAssertEqual(
-            ArtefactFiles.displayVersion(shortVersion: "2.0.0", releaseTag: ""),
-            "2.0.0"
-        )
-    }
-
-    func testWhitespaceTagFallsBackToShortVersion() {
-        XCTAssertEqual(
-            ArtefactFiles.displayVersion(shortVersion: "2.0.0", releaseTag: "  "),
-            "2.0.0"
-        )
-    }
-
-    func testExactReleaseTagDedupes() {
-        XCTAssertEqual(
-            ArtefactFiles.displayVersion(shortVersion: "2.0.0", releaseTag: "v2.0.0"),
-            "v2.0.0"
-        )
-    }
-
-    func testBareVersionTagDedupes() {
-        XCTAssertEqual(
-            ArtefactFiles.displayVersion(shortVersion: "2.0.0", releaseTag: "2.0.0"),
-            "2.0.0"
-        )
-    }
-
-    func testPrereleaseTagShowsMarketingInParens() {
-        XCTAssertEqual(
-            ArtefactFiles.displayVersion(
-                shortVersion: "2.0.0", releaseTag: "v2.0.0-pre2-grok"),
-            "v2.0.0-pre2-grok (2.0.0)"
-        )
-    }
-
-    func testDescribeStringShowsMarketingInParens() {
-        XCTAssertEqual(
-            ArtefactFiles.displayVersion(
-                shortVersion: "2.0.0", releaseTag: "v2.0.0-5-gdeadbee"),
-            "v2.0.0-5-gdeadbee (2.0.0)"
-        )
-    }
-
-    func testAppInfoUsesComposedVersion() {
-        // .main in the test host is the ICCery app under test; whatever it
-        // resolves to, build must be a non-empty digits-or-default string.
-        let info = ArtefactFiles.appInfo()
-        XCTAssertFalse(info.version.isEmpty)
-        XCTAssertFalse(info.build.isEmpty)
-    }
-}
-
-final class ArtefactFilesTests: XCTestCase {
-    func testBase64RoundTrip() throws {
+@Suite("ArtefactFiles")
+struct ArtefactFilesTests {
+    @Test func base64RoundTrip() throws {
         let url = tempURL("a.txt")
         try FileManager.default.createDirectory(
             at: url.deletingLastPathComponent(), withIntermediateDirectories: true
         )
         try "hello".write(to: url, atomically: true, encoding: .utf8)
         let b64 = try ArtefactFiles.readBase64(url)
-        XCTAssertEqual(Data(base64Encoded: b64), Data("hello".utf8))
+        #expect(Data(base64Encoded: b64) == Data("hello".utf8))
     }
 
-    func testDefaultWorkingDirExists() {
-        XCTAssertTrue(FileManager.default.fileExists(
+    @Test func defaultWorkingDirExists() {
+        #expect(FileManager.default.fileExists(
             atPath: ArtefactFiles.defaultWorkingDirectory().path
         ))
     }
 }
-
-final class ArtefactProbeProfileTests: XCTestCase {
-    private func makeDir() throws -> URL {
-        let dir = FileManager.default.temporaryDirectory
-            .appendingPathComponent("probe-\(UUID().uuidString)")
-        try FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)
-        return dir
-    }
-
-    // MARK: Basename probe matrix (#69)
-
-    func testOnlyIcc() throws {
-        let dir = try makeDir()
-        let icc = dir.appendingPathComponent("job.icc")
-        try Data("icc".utf8).write(to: icc)
-        XCTAssertEqual(ArtefactProbe.resolveProfile(basename: "job", cwd: dir)?.path, icc.path)
-    }
-
-    func testOnlyIcm() throws {
-        let dir = try makeDir()
-        let icm = dir.appendingPathComponent("job.icm")
-        try Data("icm".utf8).write(to: icm)
-        XCTAssertEqual(ArtefactProbe.resolveProfile(basename: "job", cwd: dir)?.path, icm.path)
-    }
-
-    func testIcmWins() throws {
-        let dir = try makeDir()
-        try Data("icc".utf8).write(to: dir.appendingPathComponent("job.icc"))
-        let icm = dir.appendingPathComponent("job.icm")
-        try Data("icm".utf8).write(to: icm)
-        let url = ArtefactProbe.resolveProfile(basename: "job", cwd: dir)
-        XCTAssertEqual(url?.path, icm.path)
-    }
-
-    func testNeitherExists() throws {
-        let dir = try makeDir()
-        XCTAssertNil(ArtefactProbe.resolveProfile(basename: "job", cwd: dir))
-    }
-
-    // MARK: Explicit URL matrix (#69 / #83)
-
-    func testExplicitIccWins() throws {
-        let dir = try makeDir()
-        let icc = dir.appendingPathComponent("job.icc")
-        try Data("icc".utf8).write(to: icc)
-        try Data("icm".utf8).write(to: dir.appendingPathComponent("job.icm"))
-        XCTAssertEqual(ArtefactProbe.resolveProfile(icc).path, icc.path)
-    }
-
-    func testExplicitIcmWins() throws {
-        let dir = try makeDir()
-        try Data("icc".utf8).write(to: dir.appendingPathComponent("job.icc"))
-        let icm = dir.appendingPathComponent("job.icm")
-        try Data("icm".utf8).write(to: icm)
-        XCTAssertEqual(ArtefactProbe.resolveProfile(icm).path, icm.path)
-    }
-
-    func testFlipExtension() throws {
-        let dir = try makeDir()
-        let icc = dir.appendingPathComponent("job.icc")
-        let icm = dir.appendingPathComponent("job.icm")
-        try Data("icm".utf8).write(to: icm)
-        let resolved = ArtefactProbe.resolveProfile(icc)
-        XCTAssertEqual(resolved.path, icm.path)
-    }
-
-    func testFlipToIcc() throws {
-        let dir = try makeDir()
-        let icc = dir.appendingPathComponent("job.icc")
-        let icm = dir.appendingPathComponent("job.icm")
-        try Data("icc".utf8).write(to: icc)
-        XCTAssertEqual(ArtefactProbe.resolveProfile(icm).path, icc.path)
-    }
-
-    func testMissingBoth() throws {
-        let dir = try makeDir()
-        let icc = dir.appendingPathComponent("job.icc")
-        XCTAssertEqual(ArtefactProbe.resolveProfile(icc).path, icc.path)
-    }
-
-    func testUnrelatedExtension() throws {
-        let dir = try makeDir()
-        let mpp = dir.appendingPathComponent("job.mpp")
-        let icc = dir.appendingPathComponent("job.icc")
-        try Data("icc".utf8).write(to: icc)
-        // Even though a sibling .icc exists, a missing .mpp stays .mpp.
-        XCTAssertEqual(ArtefactProbe.resolveProfile(mpp).path, mpp.path)
-        let txt = dir.appendingPathComponent("job.txt")
-        XCTAssertEqual(ArtefactProbe.resolveProfile(txt).path, txt.path)
-    }
-}

Tests/ICCeryCoreTests/BinaryResolverTests.swift

@@ -1,8 +1,9 @@
-import XCTest
+import Testing
 import Foundation
 @testable import ICCeryCore
 
-final class BinaryResolverTests: XCTestCase {
+@Suite("BinaryResolver")
+struct BinaryResolverTests {
 
     private func makeTree(_ body: (URL) throws -> Void) throws -> URL {
         let root = FileManager.default.temporaryDirectory
@@ -21,16 +22,16 @@ final class BinaryResolverTests: XCTestCase {
         }
     }
 
-    func testOverrideDirWinsWhenFileExists() throws {
+    @Test func overrideDirWinsWhenFileExists() throws {
         let override = try makeTree { root in
             try touch(root.appendingPathComponent("targen"))
         }
         let bundled = try makeTree { _ in }
         let r = BinaryResolver(bundledRoot: bundled, overrideDir: override)
-        XCTAssertEqual(r.resolve("targen"), override.appendingPathComponent("targen"))
+        #expect(r.resolve("targen") == override.appendingPathComponent("targen"))
     }
 
-    func testOverrideFallsThroughWhenMissing() throws {
+    @Test func overrideFallsThroughWhenMissing() throws {
         let override = try makeTree { _ in }
         let bundled = try makeTree { root in
             let dir = root.appendingPathComponent("macos-universal")
@@ -38,10 +39,10 @@ final class BinaryResolverTests: XCTestCase {
             try touch(dir.appendingPathComponent("instlist"))
         }
         let r = BinaryResolver(bundledRoot: bundled, overrideDir: override)
-        XCTAssertTrue(r.resolve("targen").path.contains("macos-universal/targen"))
+        #expect(r.resolve("targen").path.contains("macos-universal/targen"))
     }
 
-    func testUniversalPreferredWhenMarkerPresent() throws {
+    @Test func universalPreferredWhenMarkerPresent() throws {
         let bundled = try makeTree { root in
             for dir in ["macos-universal", "macos-x86_64"] {
                 let d = root.appendingPathComponent(dir)
@@ -50,10 +51,10 @@ final class BinaryResolverTests: XCTestCase {
             }
         }
         let r = BinaryResolver(bundledRoot: bundled)
-        XCTAssertEqual(r.platformDir(), "macos-universal")
+        #expect(r.platformDir() == "macos-universal")
     }
 
-    func testFallsBackToArchDir() throws {
+    @Test func fallsBackToArchDir() throws {
         let bundled = try makeTree { root in
             let d = root.appendingPathComponent("macos-x86_64")
             try FileManager.default.createDirectory(at: d, withIntermediateDirectories: true)
@@ -63,20 +64,20 @@ final class BinaryResolverTests: XCTestCase {
             bundledRoot: bundled,
             archDirs: ["macos-universal", "macos-x86_64"]
         )
-        XCTAssertEqual(r.platformDir(), "macos-x86_64")
+        #expect(r.platformDir() == "macos-x86_64")
     }
 
-    func testMissingEverythingReturnsConstructedPath() throws {
+    @Test func missingEverythingReturnsConstructedPath() throws {
         let bundled = try makeTree { _ in }
         let r = BinaryResolver(bundledRoot: bundled)
         // v1 semantic: path is returned; spawn surfaces the error.
-        XCTAssertTrue(r.resolve("targen").path.hasSuffix("macos-universal/targen"))
-        XCTAssertFalse(r.exists(r.resolve("targen")))
+        #expect(r.resolve("targen").path.hasSuffix("macos-universal/targen"))
+        #expect(!r.exists(r.resolve("targen")))
     }
 
-    func testMockAndGamutPaths() throws {
+    @Test func mockAndGamutPaths() throws {
         let r = BinaryResolver(bundledRoot: URL(fileURLWithPath: "/x"))
-        XCTAssertEqual(r.mock("chartread").path, "/x/mocks/chartread.mock")
-        XCTAssertEqual(r.referenceGamut("sRGB.gam").path, "/x/reference_gamuts/sRGB.gam")
+        #expect(r.mock("chartread").path == "/x/mocks/chartread.mock")
+        #expect(r.referenceGamut("sRGB.gam").path == "/x/reference_gamuts/sRGB.gam")
     }
 }

Tests/ICCeryCoreTests/CGATSParserTests.swift

@@ -1,8 +1,9 @@
 import Foundation
-import XCTest
+import Testing
 @testable import ICCeryCore
 
-final class CGATSParserTests: XCTestCase {
+@Suite("CGATS Parser & Writer")
+struct CGATSParserTests {
 
     private static let canonicalCTI3 = """
     CTI3
@@ -20,40 +21,44 @@ final class CGATSParserTests: XCTestCase {
     END_DATA
     """
 
-    func testParseCTI3() throws {
+    @Test("Parses CTI3 with canonical field names")
+    func parseCTI3() throws {
         let dataset = try CGATSParser.parse(Self.canonicalCTI3)
-        XCTAssertEqual(dataset.format, .cti3)
-        XCTAssertEqual(dataset.samples.count, 2)
-        XCTAssertEqual(dataset.colorRep, "RGB")
-        XCTAssertEqual(dataset.deviceClass, "DISPLAY")
-        XCTAssertEqual(dataset.samples[0].id, "1")
-        XCTAssertEqual(dataset.samples[0].loc, "A1")
-        XCTAssertEqual(dataset.samples[1].values["RGB_G"], "50.0000")
+        #expect(dataset.format == .cti3)
+        #expect(dataset.samples.count == 2)
+        #expect(dataset.colorRep == "RGB")
+        #expect(dataset.deviceClass == "DISPLAY")
+        #expect(dataset.samples[0].id == "1")
+        #expect(dataset.samples[0].loc == "A1")
+        #expect(dataset.samples[1].values["RGB_G"] == "50.0000")
     }
 
-    func testRoundTrip() throws {
+    @Test("Round-trips parse, write, reparse")
+    func roundTrip() throws {
         let first = try CGATSParser.parse(Self.canonicalCTI3)
         let text = try CGATSWriter.write(first)
         let second = try CGATSParser.parse(text)
-        XCTAssertEqual(second.format, first.format)
-        XCTAssertEqual(second.samples.count, first.samples.count)
-        XCTAssertEqual(second.colorRep, first.colorRep)
-        XCTAssertEqual(second.deviceClass, first.deviceClass)
+        #expect(second.format == first.format)
+        #expect(second.samples.count == first.samples.count)
+        #expect(second.colorRep == first.colorRep)
+        #expect(second.deviceClass == first.deviceClass)
     }
 
-    func testParseCSV() throws {
+    @Test("Parses CSV with comma delimiters")
+    func parseCSV() throws {
         let csv = """
         SAMPLE_ID,SAMPLE_LOC,RGB_R,RGB_G,RGB_B,XYZ_X,XYZ_Y,XYZ_Z,LAB_L,LAB_A,LAB_B
         1,A1,50,0,0,20,10,5,50,60,30
         2,A2,0,50,0,10,30,5,60,-50,40
         """
         let dataset = try CGATSParser.parse(csv, sourceURL: URL(fileURLWithPath: "/tmp/sample.csv"))
-        XCTAssertEqual(dataset.format, .csv)
-        XCTAssertEqual(dataset.samples.count, 2)
-        XCTAssertEqual(dataset.samples[0].values["RGB_R"], "50.0000")
+        #expect(dataset.format == .csv)
+        #expect(dataset.samples.count == 2)
+        #expect(dataset.samples[0].values["RGB_R"] == "50.0000")
     }
 
-    func testConverts255To100() throws {
+    @Test("Converts 0-255 device values to 0-100")
+    func converts255To100() throws {
         let rgb = """
         CTI3
         COLOR_REP RGB
@@ -67,11 +72,12 @@ final class CGATSParserTests: XCTestCase {
         END_DATA
         """
         let dataset = try CGATSParser.parse(rgb)
-        XCTAssertEqual(dataset.samples[0].values["RGB_R"], "100.0000")
-        XCTAssertEqual(dataset.samples[0].values["RGB_G"], "50.1961")
+        #expect(dataset.samples[0].values["RGB_R"] == "100.0000")
+        #expect(dataset.samples[0].values["RGB_G"] == "50.1961")
     }
 
-    func testSynthesizesMetadata() throws {
+    @Test("Synthesizes COLOR_REP and DEVICE_CLASS when missing")
+    func synthesizesMetadata() throws {
         let cmyk = """
         CTI3
         NUMBER_OF_FIELDS 6
@@ -84,15 +90,19 @@ final class CGATSParserTests: XCTestCase {
         END_DATA
         """
         let dataset = try CGATSParser.parse(cmyk)
-        XCTAssertEqual(dataset.colorRep, "CMYK")
-        XCTAssertEqual(dataset.deviceClass, "PRINTER")
+        #expect(dataset.colorRep == "CMYK")
+        #expect(dataset.deviceClass == "PRINTER")
     }
 
-    func testRejectsEmpty() {
-        XCTAssertThrowsError(try CGATSParser.parse(""))
+    @Test("Rejects empty file")
+    func rejectsEmpty() {
+        #expect(throws: (any Error).self) {
+            _ = try CGATSParser.parse("")
+        }
     }
 
-    func testRejectsArity() {
+    @Test("Rejects malformed arity")
+    func rejectsArity() {
         let bad = """
         CTI3
         NUMBER_OF_FIELDS 2
@@ -104,18 +114,21 @@ final class CGATSParserTests: XCTestCase {
         1
         END_DATA
         """
-        XCTAssertThrowsError(try CGATSParser.parse(bad))
+        #expect(throws: (any Error).self) {
+            _ = try CGATSParser.parse(bad)
+        }
     }
 
-    func testWriterFormat() throws {
+    @Test("Writer emits valid .ti3 with tabs and required keywords")
+    func writerFormat() throws {
         let dataset = try CGATSParser.parse(Self.canonicalCTI3)
         let text = try CGATSWriter.write(dataset)
-        XCTAssertTrue(text.contains("CTI3"))
-        XCTAssertTrue(text.contains("BEGIN_DATA_FORMAT"))
-        XCTAssertTrue(text.contains("BEGIN_DATA"))
-        XCTAssertTrue(text.contains("END_DATA"))
-        XCTAssertTrue(text.contains("COLOR_REP"))
-        XCTAssertTrue(text.contains("DEVICE_CLASS"))
-        XCTAssertTrue(text.contains("\t"))
+        #expect(text.contains("CTI3"))
+        #expect(text.contains("BEGIN_DATA_FORMAT"))
+        #expect(text.contains("BEGIN_DATA"))
+        #expect(text.contains("END_DATA"))
+        #expect(text.contains("COLOR_REP"))
+        #expect(text.contains("DEVICE_CLASS"))
+        #expect(text.contains("\t"))
     }
 }

Tests/ICCeryCoreTests/CalibrationIdentityTests.swift

@@ -1,67 +0,0 @@
-import Foundation
-import XCTest
-@testable import ICCeryCore
-
-/// Issue #83 — canonical `CAL_` / original-stem pairing.
-final class CalibrationIdentityTests: XCTestCase {
-    func testLivePlain() {
-        let id = CalibrationIdentity.parse(liveBasename: "foo", persistedOriginal: "")
-        XCTAssertEqual(id.originalBasename, "foo")
-        XCTAssertEqual(id.calibrationBasename, "CAL_foo")
-    }
-
-    func testLivePlainIgnoresPersisted() {
-        let id = CalibrationIdentity.parse(liveBasename: "foo", persistedOriginal: "bar")
-        XCTAssertEqual(id.originalBasename, "foo")
-        XCTAssertEqual(id.calibrationBasename, "CAL_foo")
-    }
-
-    func testLiveCalPersisted() {
-        let id = CalibrationIdentity.parse(liveBasename: "CAL_foo", persistedOriginal: "foo")
-        XCTAssertEqual(id.originalBasename, "foo")
-        XCTAssertEqual(id.calibrationBasename, "CAL_foo")
-    }
-
-    func testLiveCalNoPersist() {
-        let id = CalibrationIdentity.parse(liveBasename: "CAL_foo", persistedOriginal: "")
-        XCTAssertEqual(id.originalBasename, "foo")
-        XCTAssertEqual(id.calibrationBasename, "CAL_foo")
-    }
-
-    func testPersistedWins() {
-        let id = CalibrationIdentity.parse(liveBasename: "CAL_foo", persistedOriginal: "bar")
-        XCTAssertEqual(id.originalBasename, "bar")
-        XCTAssertEqual(id.calibrationBasename, "CAL_bar")
-    }
-
-    func testEmptyLiveWithPersisted() {
-        let id = CalibrationIdentity.parse(liveBasename: "", persistedOriginal: "foo")
-        XCTAssertTrue(id.originalBasename.isEmpty)
-        XCTAssertTrue(id.calibrationBasename.isEmpty)
-    }
-
-    func testEmptyLive() {
-        let id = CalibrationIdentity.parse(liveBasename: "", persistedOriginal: "")
-        XCTAssertTrue(id.originalBasename.isEmpty)
-        XCTAssertTrue(id.calibrationBasename.isEmpty)
-    }
-
-    func testAlreadyPrefixed() {
-        XCTAssertEqual(CalibrationIdentity.prefix("CAL_foo"), "CAL_foo")
-        XCTAssertEqual(CalibrationIdentity.prefix("foo"), "CAL_foo")
-        let id = CalibrationIdentity.parse(liveBasename: "CAL_CAL_foo", persistedOriginal: "")
-        XCTAssertEqual(id.originalBasename, "CAL_foo")
-        XCTAssertEqual(id.calibrationBasename, "CAL_foo")
-    }
-
-    func testPrefixEmpty() {
-        XCTAssertTrue(CalibrationIdentity.prefix("").isEmpty)
-        XCTAssertEqual(CalibrationIdentity.strip("foo"), "foo")
-        XCTAssertEqual(CalibrationIdentity.strip("CAL_foo"), "foo")
-    }
-
-    func testProcessIdMatches() {
-        let cal = CalibrationIdentity.prefix("foo")
-        XCTAssertEqual(ProcessID.targen(cal), "targen_CAL_foo")
-    }
-}