SPB Git

Repository Public

APPLE-APPS.md 28.2 KB 365 lines markdown

1# Apple apps — MacLustr Command Center23State at 2026-11-18. The macOS app and the shared Swift package exist; the iOS / iPadOS app is described in4section 11. Everything below is either verified (and says how) or explicitly marked **not verified**.56## 1. Pieces78| Piece | Path | Role |9|---|---|---|10| `MCCCore` (Swift package, macOS 15 / iOS 18) | `packages/swift-core` | generated API client, transport policy, identity (passkeys), session store, event stream, offline cache, repositories, formatting + localization, shared SwiftUI components and feature models |11| macOS app | `apps/macos` | windows, navigation, screens, menu bar extra, notifications, deep links, local lock |12| Provisioning script | `infra/apple/provision.py` (+ `asc.py`) | bundle ids, capabilities, provisioning profiles through the App Store Connect API |1314## 2. Bundles and identifiers1516| | macOS Release | macOS Debug | iOS / iPadOS (section 11) |17|---|---|---|---|18| Bundle id | `ai.spboucher.clustr` | `ai.spboucher.clustr.debug` | `ai.spboucher.clustr.ios` (Debug: `ai.spboucher.clustr.ios.debug`) |19| Team | `3YM54G49SN` | same | same |20| Signing | Developer ID Application + profile "MCC macOS Developer ID" (`MAC_APP_DIRECT`) | ad-hoc ("sign to run locally"), no restricted entitlement | — |21| Server | `https://clustr.spboucher.ai` (fixed) | overridable (`MCC_BASE_URL`) | — |22| Passkeys | system (`ASAuthorizationPlatformPublicKeyCredentialProvider`, RP `clustr.spboucher.ai`) | system, or the software authenticator with `MCC_PASSKEY=software` | — |2324The Debug build has its own bundle id on purpose: a second registered copy of the production id makes the system25passkey sheet fail (error 1004), as does running from under `~/Desktop` — builds go to `/tmp/mcc-swift`, and the26release build must be run from `/Applications`.2728## 3. Entitlements2930Release (`apps/macos/Support/MCC.entitlements`):3132| Entitlement | Value | Why |33|---|---|---|34| `com.apple.security.app-sandbox` | true | App Sandbox |35| `com.apple.security.network.client` | true | HTTPS to the server |36| `com.apple.security.files.user-selected.read-write` | true | save panels (audit export, calendar .ics) |37| `com.apple.developer.associated-domains` | `webcredentials:clustr.spboucher.ai`, `applinks:clustr.spboucher.ai` | passkeys of the web RP, universal links |38| `keychain-access-groups` | `3YM54G49SN.ai.spboucher.clustr` | data-protection Keychain for the session |39| `com.apple.application-identifier`, `com.apple.developer.team-identifier` | `3YM54G49SN.ai.spboucher.clustr`, `3YM54G49SN` | required by the two above |40| `com.apple.developer.aps-environment` | `production` | remote notifications |4142Hardened Runtime is on (no exception). Associated Domains, the keychain group and push are *restricted*43entitlements on macOS: they are only honoured when the embedded provisioning profile authorises them, hence the44Developer ID profile. Debug (`MCC-Debug.entitlements`) keeps only the sandbox, the network client and the45user-selected files; consequently a Debug build has no system passkeys for the product domain, no data-protection46Keychain (it uses the login keychain, or a file store in UI tests) and no remote notifications.4748## 4. Associated Domains (AASA)4950`control-api` serves `/.well-known/apple-app-site-association` from `MCC_APPLE_APP_IDS`:51`webcredentials.apps` and `applinks.details[].appIDs` = the configured app ids, with components `/setup` and52`/open/*`. Production must be started with53`MCC_APPLE_APP_IDS=3YM54G49SN.ai.spboucher.clustr` (add `3YM54G49SN.ai.spboucher.clustr.ios` for iOS).54Apple's CDN caches the file: publish it **before** the first launch of the app, otherwise the passkey sheet fails55with 1004 until the cache expires. Checked locally only (`curl http://localhost:8760/.well-known/apple-app-site-association`).5657Universal links handled by the app: `https://clustr.spboucher.ai/setup#<token>` (the token is exchanged at once,58kept in memory only, never logged) and `/open/<section>`, `/open/{nodes|actions|alerts|incidents|services|jobs|models|maintenance}/<uuid>`.5960## 5. Sessions and secrets on the device6162- Access token (10 min) + rotating refresh token + `device_id` in the Keychain: generic password,63  `kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly`, `kSecAttrSynchronizable = false`, data-protection keychain,64  access group configurable (`KeychainSecureStore(service:accessGroup:dataProtection:)`). Never in UserDefaults,65  never in logs (`SessionTokens` redacts its own description).66- Sign-out wipes the tokens; a rejected refresh (expired, revoked session or device, reuse of a rotated token)67  wipes tokens, device id, in-memory state and the offline cache, and returns to the sign-in screen.68- The local lock (LocalAuthentication) is a convenience only; step-up always is a passkey ceremony verified by the server.6970## 6. Push notifications (APNs)7172- The app registers for remote notifications when the build carries `aps-environment` and the user accepted73  notifications, and sends the device token with `PUT /me/devices/current/push-token` (`environment` taken from74  the entitlement).75- Local notifications for firing / resolved alerts received over the event stream work while the app runs.76- **Not verified:** remote delivery. The server has no APNs key (`action-orchestrator` logs "push notifications77  inactive … missing MCC_APNS_KEY_FILE"), and a Debug build has no `aps-environment`. The token upload endpoint78  itself is verified by an integration test.7980## 7. Provisioning (App Store Connect API)8182`infra/apple/provision.py` (idempotent, `--check` mode) registers `ai.spboucher.clustr` and83`ai.spboucher.clustr.debug`, enables Associated Domains and Push Notifications, creates and installs the profiles84"MCC macOS Developer ID" (`MAC_APP_DIRECT`) and "MCC macOS Debug Development" (`MAC_APP_DEVELOPMENT`), and only85ever replaces profiles carrying exactly those two names.8687```sh88ASC_KEY_ID=L379BDKR69 ASC_ISSUER_ID=<issuer uuid> python3 infra/apple/provision.py --check89ASC_KEY_ID=L379BDKR69 ASC_ISSUER_ID=<issuer uuid> python3 infra/apple/provision.py90```9192**Status: NOT RUN.** `ASC_ISSUER_ID` was not in the environment and is not where it was expected93(`ios-release.sh` of another project has no `ISSUER_ID` default); no call was made to the App Store Connect API,94so no bundle id, capability, device or profile was created. The script has therefore never been exercised against95the real API; its request payloads are untested.9697## 8. Release: signing, notarization, verification9899```sh100apps/macos/Scripts/release.sh            # archive (Release) → Developer ID signature → notarize + staple the app101                                         # → dmg → sign → notarize + staple the dmg → SHA-256 → verify-release.sh102apps/macos/Scripts/verify-release.sh dist/macos/MacLustr-Command-Center-1.0.0-1.dmg103```104105`release.sh` refuses to start without the "MCC macOS Developer ID" profile. `verify-release.sh` checks, without106installing or launching anything: `codesign --verify --deep --strict`, `spctl -a -vv` (app and dmg),107`stapler validate`, Hardened Runtime flag, bundle id, each entitlement, the embedded profile, the absence of108Debug-only code (`SoftwareAuthenticator`, `DebugFileSecureStore`, `MCC_*` launch overrides) and of any ATS exception.109Notarization uses the keychain profile `MacLustr-Notarize`.110111**Status: NOT PRODUCED.** Without the provisioning profile (section 7) a Release build cannot be signed in a form112that macOS would run (restricted entitlements without a profile are refused at launch), so no dmg was built, no113notarization was submitted and `dist/macos/` is empty. What was verified instead: the Release configuration114compiles (see the test matrix).115116## 9. Test matrix117118| Suite | Command | What it covers | Result (2026-11-18) |119|---|---|---|---|120| `MCCCore` unit | `cd packages/swift-core && swift test` | URLProtocol stub server: error mapping, bearer + single-flight refresh (20 concurrent 401 → 1 refresh), refresh rejected → wipe, GET-only retries, offline guard, cancellation, idempotency keys, dates, WebAuthn JSON mapping, software-authenticator vectors, step-up retry, SSE parser / resume / dedupe / resync / heartbeat / pause, offline cache, `Resource` states, event patching, formatting, catalogs | 52 tests pass |121| `MCCCore` integration | `packages/swift-core/Scripts/integration-test.sh` | REAL local `control-api` + throwaway PostgreSQL: invitation setup → session, passkey sign-in, forged signature and wrong origin refused, single-flight refresh, refresh reuse → both holders signed out, revoked device, step-up retry, operator invitation + profile, link flow, passkey add/rename/delete/last-passkey, sign-out, push token, SSE resume without loss or duplicate + resync, live probe of 39 read endpoints (all live, all decode) | 14 tests pass (66 with the unit tests, 10 suites) |122| App unit | `apps/macos/Scripts/test.sh unit` | logic and view models of every section, deep links, catalogs complete in fr/en (1 416 keys) | 54 tests pass |123| App UI | `apps/macos/Scripts/test.sh ui` | XCUITest against a real local backend + orchestrator (software authenticator): invitation setup, used-link dead end, passkey sign-in; action `node.maintenance.set` end to end; maintenance window + note; backend stop → offline read-only with timestamps → restart → reconnection; language switch; tour of every section + universal search | 6 tests pass |124| Generated code | `packages/swift-core/Scripts/generate.sh --check` | client and tokens are in sync with the contract and `tokens.json` | up to date |125| Release compile | `xcodebuild -configuration Release … CODE_SIGNING_ALLOWED=NO build` | Release configuration compiles; binary free of Debug-only code; no ATS exception | build succeeded (unsigned, not distributable) |126| iOS compile of `MCCCore` | `xcodebuild -scheme MCCCore -destination 'generic/platform=iOS' build` | the package builds for iOS 18 | build succeeded |127128## 10. Results and known limits129130Screenshots of a Debug run against the local backend (real server data, empty cluster plus one manually declared node) are in `docs/screenshots/macos/`. Limits:131132- **Real system passkeys: not verified.** A native app can only use system passkeys for a domain that serves its133  AASA over HTTPS; production is not deployed. The `ASAuthorization` path is covered by construction and by unit134  tests of the JSON mapping (`WebAuthnJSON`), and every flow is exercised end to end with the software135  authenticator, whose attestations and assertions the real server verifies (no server-side test hook).136- **Universal links on the real domain, APNs delivery, Keychain access group in a provisioned build: not verified.**137- **Release build, notarization: not produced** (section 8).138- The UI-test runner is sandboxed by Xcode: it drives the backend and saves screenshots through139  `apps/macos/Scripts/ui-test-control.py`.140- The generated client uses closed enums: a NEW enum value sent by a newer server fails the decoding of that141  response (the screen then shows an error with the correlation id). Event topics are handled leniently: an unknown142  topic or payload triggers a full reload instead.143144## 11. iOS / iPadOS app145146State at 2026-11-19. Sources in `apps/ios` (see `apps/ios/README.md` for the layout and the commands). SwiftUI only,147universal (iPhone + iPad), iOS 18.0+, Swift 6 language mode. It consumes `MCCCore` like the macOS app; its148navigation and layouts are its own (tabs on iPhone, sidebar + side-by-side panes on iPad).149150### 11.1 Bundle151152| | Release (TestFlight / App Store) | Debug (simulator, Xcode) |153|---|---|---|154| Product / display name | `MacLustr` / `MacLustr CC` | same |155| Bundle id | `ai.spboucher.clustr.ios` (ASC bundle resource `DF4Z2ZU7UX`) | `ai.spboucher.clustr.ios.debug` (`4C4D7R2VU4`) |156| App Store Connect record | id `6836652715`, name "MacLustr CC", SKU `maclustr-cc-ios-001`, primary locale fr-CA | — |157| Team | `3YM54G49SN` | same |158| Server | `https://clustr.spboucher.ai` (fixed) | overridable (`MCC_BASE_URL`) |159| Passkeys | system (`ASAuthorizationPlatformPublicKeyCredentialProvider`, RP `clustr.spboucher.ai`) | system, or the software authenticator with `MCC_PASSKEY=software` |160| Session store | Keychain | Keychain, or `MCC_SECURE_STORE=file|memory` |161| ATS | no exception | `NSAllowsLocalNetworking` (localhost backend) |162| URL scheme | none | `mcc-ios-debug://` (simulates links on a simulator) |163| APNs environment sent with the token | `production` | `development` |164165Info.plist: `NSFaceIDUsageDescription`, `ITSAppUsesNonExemptEncryption = NO` (HTTPS and system cryptography only),166`UIApplicationSupportsMultipleScenes`, background mode `remote-notification`, all orientations on iPad, portrait +167landscape on iPhone, `LSApplicationCategoryType` developer tools. `Scripts/release.sh verify` checks that the Release168binary contains none of the Debug-only code (`SoftwareAuthenticator`, `DebugFileSecureStore`, `MCC_*` overrides, the169Debug scheme) and no ATS exception.170171### 11.2 Entitlements (`apps/ios/Support/MCC.entitlements`, `MCC-Debug.entitlements`)172173| Entitlement | Value | Why |174|---|---|---|175| `com.apple.developer.associated-domains` | `webcredentials:clustr.spboucher.ai`, `applinks:clustr.spboucher.ai` | passkeys of the web RP, universal links |176| `aps-environment` | `production` (Release) / `development` (Debug) | remote notifications |177| `keychain-access-groups` | `3YM54G49SN.<bundle id>` | the app's own group; NOT shared with the macOS app (each device signs in with its own session and device id) |178| `application-identifier`, `com.apple.developer.team-identifier` | added by Xcode from the profile | — |179180The session (access token, rotating refresh token, device id) is stored exactly as on macOS (section 5): generic181password, `kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly`, never synchronised to iCloud Keychain. No explicit182access group is passed: on iOS an item lands in the app's first keychain group, the one above.183184### 11.3 Universal links and the invitation flow185186The server must list the iOS app in its AASA: start `control-api` with187`MCC_APPLE_APP_IDS=3YM54G49SN.ai.spboucher.clustr,3YM54G49SN.ai.spboucher.clustr.ios` (section 4), **before** the188first launch of the app (Apple's CDN caches the file; a missing entry makes the passkey sheet fail with 1004 and189the links open Safari). **Not verified against production from this work** — check with190`curl https://clustr.spboucher.ai/.well-known/apple-app-site-association`.191192- `https://clustr.spboucher.ai/setup#<token>` → `onOpenURL` / `NSUserActivityTypeBrowsingWeb` → `AppModel.handle(url:)`193  → the token is exchanged immediately (`InvitationSetupModel.begin`), lives in memory only, is never logged nor194  stored; review (who invites, which role) → profile when required → passkey; for an invitation aimed at an195  existing account: sign-in → explicit confirmation (the server asks for step-up). A used, expired or revoked link is196  a dead end with the correlation id. The link can also be pasted on the sign-in screen.197- `https://clustr.spboucher.ai/open/<section>` and `/open/{nodes|alerts|incidents|actions|services|models|jobs|maintenance}/<uuid>`198  → the destination waits until a scene is signed in and unlocked, then opens.199- On a simulator the same handler is driven through the Debug-only scheme: `xcrun simctl openurl <udid> "mcc-ios-debug://setup#<token>"`200  (the UI tests do this; iOS shows an "Open in MacLustr CC?" prompt for custom schemes) or the Debug launch201  variable `MCC_OPEN_URL`.202203### 11.4 Push notifications — status204205- The app registers for remote notifications once the user accepted them (asked from Settings → Notifications,206  never at launch) and a session exists, and uploads the token with `PUT /me/devices/current/push-token`207  (`environment`: `production` for Release builds, `development` for Debug).208- One notification category (`MCC_ALERT`) with one action, "Open" (foreground). **No destructive action, no action209  that changes server state**: a tap only opens the alert (`alert_id`) or the action (`action_id`), and only in a210  signed-in, unlocked scene; acknowledging, resolving or running anything goes through the in-app flows211  (confirmation, justification, step-up).212- Local notifications for firing, non-suppressed alerts received over the event stream while the app is active213  (can be turned off in Settings).214- **Not verified: delivery.** Nothing was received from APNs in this work: the simulators used for the tests do not215  obtain a production token, and no physical device is registered. The token upload call is the one covered by the216  core integration test. Whether the server's APNs key is in place is a server-side matter (section 6).217218### 11.5 Background behaviour219220- Scene goes to the background → the event stream is paused (`AppSession.setActive(false)`), nothing runs in the221  background (no background fetch). Back to the foreground → the stream resumes with `Last-Event-ID`; if the app222  stayed away more than 20 s (`AppModel.staleAfter`) every read model on screen is reloaded as well, so that all223  timestamps are recent. A `resync` from the server reloads everything (core behaviour).224- Transient inactivity (app switcher, the passkey sheet) does not pause the stream.225- App lock (optional): locks at launch and when the app goes to the background (immediately, or after a grace226  period of 1 or 5 minutes); Face ID / Touch ID with the device passcode as fallback (`LocalAuthentication`).227  It hides the UI; it never replaces sign-in or step-up, which stay passkey ceremonies verified by the server.228- Offline: banner "offline since hh:mm", cached data with its timestamp, every mutation disabled (nothing is229  queued); "reconnecting" banner while the event stream backs off. Reads are retried by the core (GET only).230- Requests of keyed resources (node detail, metrics, processes, alert detail…) are cancelled when their view231  disappears (`Resource.cancelLoad`, added to `MCCCore` for this).232- State restoration per scene: selected tab / section and the open item (`@SceneStorage`). A session end resets it.233234### 11.6 Provisioning and signing235236```sh237ASC_KEY_ID=L379BDKR69 ASC_ISSUER_ID=<issuer> python3 infra/apple/provision.py --ios --check238ASC_KEY_ID=L379BDKR69 ASC_ISSUER_ID=<issuer> python3 infra/apple/provision.py --ios239```240241The `--ios` mode (added next to the macOS mode, which is unchanged) registers the two bundle ids with Associated242Domains and Push Notifications, creates the profile "MCC iOS App Store" (`IOS_APP_STORE`) **only if** the keychain243holds an Apple / iPhone Distribution identity, the profile "MCC iOS Debug Development" **only if** the team has244registered iOS devices, and reports whether the App Store Connect record exists.245246**Run on 2026-11-19:** both bundle ids registered (`DF4Z2ZU7UX`, `4C4D7R2VU4`; capabilities ASSOCIATED_DOMAINS,247PUSH_NOTIFICATIONS, plus Apple's default IN_APP_PURCHASE). No named profile was created: this Mac has no248distribution identity in its keychain and the team has no registered iOS device. Signing is therefore **Xcode249automatic signing authenticated by the API key** (`-allowProvisioningUpdates -authenticationKeyPath/-ID/-IssuerID`):250the archive is signed with the Apple Development identity, the export re-signs with the cloud-managed251"Apple Distribution: Simon-Pierre Boucher (3YM54G49SN)" certificate and the profile252"iOS Team Store Provisioning Profile: ai.spboucher.clustr.ios".253254### 11.7 TestFlight procedure255256```sh257cd apps/ios258ASC_ISSUER_ID=<issuer> Scripts/release.sh archive      # bump CURRENT_PROJECT_VERSION in project.yml (or MCC_BUILD_NUMBER) first259Scripts/release.sh verify                              # 18 checks on the IPA260ASC_ISSUER_ID=<issuer> Scripts/release.sh upload       # checks the app record through the API, then `xcrun altool --upload-app`261ASC_ISSUER_ID=<issuer> python3 ../../infra/apple/testflight.py [--apply]   # processing state, export compliance, internal group262```263264The app record cannot be created through the public API; it was created by hand in App Store Connect (id265`6836652715`). `testflight.py --apply` declares `usesNonExemptEncryption = false` on a build that lacks it, reuses266the app's internal beta group (or creates "Interne"), makes sure the account holder is a tester and adds the build267when the group does not receive every build automatically. Results of the first upload: see section 11.9.268269### 11.8 Test matrix (2026-11-19)270271| Suite | Command | What it covers | Result |272|---|---|---|---|273| String catalogs | `apps/ios/Scripts/test.sh unit` (first step) | every key has fr + en with the same format specifiers; every literal key used in the sources exists | 1 054 keys complete in fr and en; 756 literal keys used, all present |274| App unit (Swift Testing, hosted by the Debug app, iPhone 17 Pro simulator) | `apps/ios/Scripts/test.sh unit` | navigation on both layouts, deep links, state restoration, app lock state machine, notification routing, launch configuration, mutation errors, logic of every area (nodes, services, models, jobs, network, storage, alerts, actions, activity, audit, maintenance calendar and notes, settings), keys built at runtime | 54 tests in 7 suites pass |275| App UI, iPhone 17 Pro simulator (iOS 26.5) | `apps/ios/Scripts/test.sh ui iphone` | 12 scenarios below | 12 tests pass (≈ 14 min) |276| App UI, iPad Pro 13-inch (M5) simulator (iOS 26.5), landscape | `apps/ios/Scripts/test.sh ui ipad` | the same 12 scenarios on the sidebar layout | 12 tests pass (≈ 11 min) |277| `MCCCore` unit | `cd packages/swift-core && swift test` | + `Resource.cancelLoad` | 67 tests in 10 suites pass |278| macOS after the core changes | `apps/macos/Scripts/build.sh`, `apps/macos/Scripts/test.sh unit` | the macOS app still builds; its unit tests | build succeeded; 54 tests pass |279| Release IPA | `apps/ios/Scripts/release.sh archive && Scripts/release.sh verify` | App Store signature, profile, entitlements, version, no Debug-only code, no ATS exception | 18 / 18 checks ok |280281UI scenarios (XCUITest, REAL local `control-api` + `action-orchestrator` on 127.0.0.1:8780 / :8782, throwaway282PostgreSQL database `mcc_ios_test_<random>` seeded by `apps/ios/Scripts/seed.sql` with synthetic nodes283`ios-test-node-01…04`, software authenticator — nothing server-side is bypassed; never run against production):2842851. setup link (`simctl openurl`, Debug scheme) → review → passkey → signed in; the same link again → dead end2862. sign-out, passkey sign-in2873. overview counts by freshness with timestamps, nodes list with the four seeded rows, node detail with the CPU288   performance levels by their reported names; accessibility audit of overview, nodes, node detail, alerts,289   actions, maintenance, settings2904. action `node.maintenance.set` end to end: catalog-driven form → explicit confirmation → executed by the291   orchestrator (`succeeded`) → the node shows its maintenance mode2925. maintenance window created with a node in scope, then a note on its occurrence2936. seeded alert acknowledged with a comment2947. backend stopped → offline banner, cached rows with their timestamp, mutations disabled → backend restarted →295   banner gone, mutations enabled, data reloaded2968. background 25 s / foreground: overview refreshed, session kept, event stream `connected`2979. language switch fr → en → fr at runtime29810. largest Dynamic Type size (`AccessibilityXXXL`): key elements of Overview / Nodes / Alerts exist and are299    hittable, no visible text clipped (audit), screenshots30011. screenshots (French, dark) → `docs/screenshots/ios/*-iphone.png`, `*-ipad.png`30112. the owner creates a viewer invitation (one-time link + QR code), signs out; the viewer sets up from the link,302    admin panes are hidden, and the viewer's action request is refused by the server — the 403 is displayed303304Accessibility audit (`performAccessibilityAudit`: contrast, element detection, hit region, element description,305clipped text, traits), policy in `UITests/MCCiOSUITests.swift`:306307- fixed because of it: primary buttons (the system prominent style put a white label on the light accent — now the308  token's contrast colour), text buttons of the overview cards (44 pt hit area), one-line freshness and state labels309  that clipped at large sizes (they wrap now; `StatusBadge` / `StatusLabel` of `MCCCore` no longer limit to one310  line), card headers at accessibility sizes (the accessory goes under the title);311- excluded, with the reason next to each rule: system bars; text scrolled under the translucent tab bar / at the312  scroll edge; the iPad sidebar (system List on the system material); contrast or "potentially inaccessible text"313  findings that carry no element (decorative, accessibility-hidden glyphs; image analysis); hit-region findings on314  read-only labels; the `dynamicType` heuristic (replaced by the real run at the largest size, scenario 10);315  a finding must also persist on a second pass (live data is still arriving on the first).316317### 11.9 Distribution results318319- `provision.py --ios`: bundle ids `ai.spboucher.clustr.ios` (`DF4Z2ZU7UX`) and `ai.spboucher.clustr.ios.debug`320  (`4C4D7R2VU4`) registered with ASSOCIATED_DOMAINS and PUSH_NOTIFICATIONS; no named profile (11.6).321- `release.sh archive`: `** ARCHIVE SUCCEEDED **`, `** EXPORT SUCCEEDED **` → `dist/ios/MacLustr-CC-1.0.0-1.ipa` and322  `MacLustr-CC-1.0.0-2.ipa` (git-ignored); `release.sh verify`: 18 / 18.323- `release.sh upload` (altool, API key): build 1 — "UPLOAD SUCCEEDED with no errors", delivery324  `448e3e27-0d56-4087-851e-55d80fdb3e21`; build 2 (adjacent-month day numbers of the calendar in the secondary text325  colour, otherwise identical) — "UPLOAD SUCCEEDED with no errors", delivery `fed79d85-a934-4dbf-9fbd-248f3148fe69`.326- `testflight.py`: both builds `processingState = VALID`, `usesNonExemptEncryption = false` (taken from the327  Info.plist, nothing to declare), `internalBuildState = IN_BETA_TESTING`. The app already had an internal group,328  "Test" (`60b30f15-fc51-4144-aac9-136e72210239`, access to all builds, 1 tester = the account holder): it was329  reused, so no group "Interne" was created and no change was needed.330- **Not verified:** installation from the TestFlight app on a device, and anything listed in 11.10.331332### 11.10 To validate on a real device (owner, through TestFlight)333334No physical iPhone or iPad is registered on the developer account: everything above ran on simulators with the335software authenticator. Remaining checks:3363371. **Passkey with iCloud Keychain** against `clustr.spboucher.ai`: sign-in, setup from an invitation, adding a338   passkey, step-up before a high-criticality action or an audit export. Requires the AASA to list339   `3YM54G49SN.ai.spboucher.clustr.ios` (11.3). The `ASAuthorization` path is covered by construction and by the340   unit tests of the JSON mapping only.3412. **Universal link from Mail / Messages**: `https://clustr.spboucher.ai/setup#<token>` opens the app (not Safari)342   and starts the setup; `/open/alerts/<uuid>` opens the alert.3433. **Face ID / Touch ID lock**: enable in Settings → App lock, background the app, come back; check the grace344   period and the passcode fallback. (`NSFaceIDUsageDescription` is present; the lock was only unit-tested.)3454. **Keychain**: the session survives a relaunch and a device restart after first unlock; it is gone after346   sign-out.3475. **Push**: accept notifications in Settings → Notifications, check that the device shows `push enabled` in348   Settings → Devices, then (once the server sends) that a firing alert arrives and that the tap opens the alert349   without acting on it.3506. **VoiceOver pass** on the main screens (overview, nodes, node detail charts — summary and audio graph —, alerts,351   action form and confirmation, maintenance calendar cells), plus Reduce Motion, Increase Contrast and352   Differentiate Without Color.3537. iPad: Stage Manager / Split View widths (the shell switches between sidebar and tabs), a second window,354   keyboard shortcuts (⌘1…⌘9, ⌘R, ⌘F, ⇧⌘N), pointer hover.3558. Poor connectivity on a cellular network (timeouts, reconnection banner).356357## 12. macOS 27.0 workarounds in the app (keep until re-tested on a newer system)358359- Root screens are swapped ~150 ms after the state change (`RootView`), never from inside the click that causes it:360  an immediate swap left AppKit with a tracking area whose owner was gone (crash in361  `-[NSTrackingArea _dispatchMouseEntered:]`, seen in the UI tests, intermittent).362- `.inspector` is not used: in the detail column of the main `NavigationSplitView` it put the window in an endless363  "Update Constraints" pass (NSGenericException). Detail panes use the plain `sidePane` modifier.364- `openWindow(id: "main")` always creates a window: `AppModel.show` activates the existing main window instead.365
Files main
Menu

Theme