fix(ios): harden App Store release automation (#221)

## Summary

- replace the unsupported top-level App Store version collection with
Apple's app-scoped version endpoint
- add tested release-policy and availability readback for exact
version/build, `AFTER_APPROVAL`, Denmark only, no preorder, and no
automatic future territories
- strengthen the stable `App Store Readiness` check and align
Fastlane/candidate handoff with the approved 1.0.0 release policy

## Task contract

`truckwash-ios-release-20260723` — R4 (`ci-policy`, `release-policy`,
`credential-handling`, `branch-protection-or-rules`,
`mobile-store-submission`). The user explicitly approved implementation,
protected-master delivery, and the App Store release path.

## Changed files

- App Store Connect client and dependency-free Node tests
- App Store readiness and candidate workflows
- Fastlane candidate release configuration
- Apple App Store release runbook

## Verification

- `node --test tests/node/app-store-connect.test.mjs` — 10 passed
- `node scripts/mobile/validate-app-store.mjs --strict` — passed
- `node scripts/mobile/check-permissions.mjs` — passed
- App Store product-readiness Vitest — 5 passed
- ESLint on changed Node files — passed
- workflow YAML parsing — passed
- `git diff --check` — passed
- local Fastlane validation unavailable because Ruby/Bundler is not
installed on this host; `App Store Readiness` runs it on GitHub

## Release target

- iOS App Store
- bundle `io.truckwash.app`
- version `1.0.0`
- App Store Connect app `6792777794`
- Denmark only
- automatic release after approval
- no preorder or phased release for 1.0.0

The repository App Store automation switch remains disabled until this
change is merged and credential health is reverified.

docs/app-store-release.md

@@ -1,31 +1,32 @@
 # Apple App Store Release Runbook
 
 This is the operating runbook for the public iOS application and its signed
-GitHub Actions delivery. Public review submission and public release remain
-human actions in App Store Connect.
+GitHub Actions delivery. Public review submission remains a human action in App
+Store Connect; the approved version releases automatically after Apple approval.
 
 ## Storefront record
 
 Create or reconcile one App Store Connect record:
 
-| Setting | Value |
-| --- | --- |
-| Name | Truck Wash Kundeportal |
-| Bundle ID | `io.truckwash.app` |
-| SKU | `truckwash-ios` |
-| Primary language | Danish |
-| Category | Business |
-| Price | Free |
-| Availability | Denmark only |
-| Support URL | `https://truckwash.io/support` |
-| Privacy URL | `https://truckwash.io/privacy-policy` |
-| Marketing URL | `https://truckwash.io/` |
-| Release | Manual after approval |
+| Setting          | Value                                 |
+| ---------------- | ------------------------------------- |
+| Name             | Truck Wash                            |
+| Bundle ID        | `io.truckwash.app`                    |
+| SKU              | `truckwash-ios`                       |
+| Primary language | Danish                                |
+| Category         | Business                              |
+| Price            | Free                                  |
+| Availability     | Denmark only                          |
+| Support URL      | `https://truckwash.io/support`        |
+| Privacy URL      | `https://truckwash.io/privacy-policy` |
+| Marketing URL    | `https://truckwash.io/`               |
+| Release          | Automatically after approval          |
 
 Use the standard Apple EULA and do not configure in-app purchases. Payments in
 the product cover physical truck-wash services. Keep iPhone and iPad enabled;
 disable Apple-silicon Mac and Vision Pro compatibility until those targets have
-been tested deliberately.
+been tested deliberately. Do not enable preorder or phased release for version
+`1.0.0`, and disable automatic availability in newly added territories.
 
 The Account Holder or Admin must complete these console-only items before the
 first candidate:
@@ -95,7 +96,9 @@ Configure two GitHub environments:
 Private repositories on the Team plan cannot rely on environment required
 reviewers. Protect `ios-v*` creation/update/deletion with a repository ruleset
 limited to release managers. Manual App Review submission is the final human
-approval.
+approval. App Store Connect API readback must show `AFTER_APPROVAL`, Denmark
+(`DNK`) as the only available territory, preorder disabled, and automatic
+future territories disabled.
 
 Environment secrets:
 
@@ -179,11 +182,14 @@ delivery automatically. Stale or proofless releases do not sign or upload.
 4. `iOS App Store Candidate` locates the release manifest for that exact SHA,
    verifies the exact processed App Store build, enforces complete screenshots,
    synchronizes Danish metadata, attaches the existing build, and reads it back.
-   It does not rebuild, submit for review, or release publicly.
+   It also writes and verifies automatic release after approval, then verifies
+   Denmark-only availability and no preorder. It does not rebuild or submit for
+   review.
 5. In App Store Connect, review the rendered product page, review account,
    privacy/export/age answers, and candidate build. Submit manually.
-6. Release the first Denmark version manually after approval. Use phased release
-   for later updates unless there is a reason not to.
+6. Submit version `1.0.0` for review. Apple releases it automatically after
+   approval. Do not use phased release for `1.0.0`; use phased release for later
+   updates unless there is a reason not to.
 7. Merge the next `ios/release.json` version bump before further delivery after
    Apple closes the released version to new builds.