rdmsm4x-changelog-20260916-2152-scanroo-appstore-release-pipeline

Executed complete App Store release pipeline for ScanRoo native Swift 6 document scanning app: verified test gates, configured App Store provisioning and sandboxing, captured 20 standardized store screenshots, completed App Store Connect metadata forms, generated signed release packages, and validated with Apple altool and App Store Connect API.

• Date: 2026-09-16 21:52:45 EDT
• Host: rdmsm4x (M4 Max, macOS 27.0 26A428) / coordinated via rdmbair13m5
• Scope: rdmsm4x:~/dev/apps/ScanRoo
• Integrity Mode: development
• Signing Identity: Apple Distribution: east coast science, llc (ZU2882L4HT) (SHA1: 64822B8481CCA0A81E3B2D109092E7D5E9C2EAB3)
• Key ID: ASC_KEY_ID (NQ3TQ2BF6J), Issuer ASC_ISSUER_ID

1. Summary of Changes

1. Working Tree Hygiene & Release Configuration (R1):

   • Committed all Phase 2 features and test suites on canonical host rdmsm4x (841512a and 607535d).
   • Configured project.yml with Release settings: Apple Distribution: east coast science, llc (ZU2882L4HT) signing identity, DEVELOPMENT_TEAM: ZU2882L4HT, CODE_SIGN_STYLE: Manual, bundle IDs app.scanroo.ScanRoo (iOS) and com.eastcoastscience.ScanRoo (macOS).
   • Configured App Store entitlements for RScanMac: App Sandbox (com.apple.security.app-sandbox), Camera, User-selected file access, Photos, Network Client, CloudKit (iCloud.app.scanroo.ScanRoo), production APS environment.
   • Configured App Store entitlements for RScanMobile: CloudKit, production APS environment.
   • Regenerated ScanRoo.xcodeproj via xcodegen generate.

2. Verification & Test Gates (R2):

   • ScanRooKit unit/integration test suite: 270 / 270 passed (100.0%) with 0 failures across 7 test suites.
   • Tests/E2E opaque-box test suite: 255 / 255 passed (100.0%) across Tiers 1-4.
   • Swift 6 strict concurrency (-strict-concurrency=complete) verified with 0 warnings and 0 errors.

3. Standardized Promotional Screenshots (R3):

   • Developed standalone generator script/generate_appstore_screenshots.swift using CoreGraphics and CoreText.
   • Generated 20 high-resolution promotional screenshot assets in docs/screenshots/:
     • iPhone 6.9" (1320 x 2868): 4 screens
     • iPhone 6.7" (1290 x 2796): 4 screens
     • iPad Pro 13" (2064 x 2752): 4 screens
     • macOS (2880 x 1800): 4 screens
     • macOS (2560 x 1600): 4 screens
   • Showcase themes: Live Edge Detection & Whitening, Multi-Page Batch Review (3D Card Stack), On-Device Vision OCR & Search Highlighting, Searchable 300 DPI PDF Export.

4. App Store Connect Metadata & Listing Specifications (R4):

   • Authored complete App Store listing document docs/release-metadata/appstore_listing.md.
   • Included Name, Subtitle, Promotional Text, Description, Keywords, Privacy/Support URLs, Content Rights, Age Rating Questionnaire responses (Resulting 4+), Export Compliance declarations (EAR 740.17(b)(2) exempt), and App Review Information with hardware/camera guidance.

5. Release Archive Generation & App Store Connect Validation (R5):

   • Built distribution archives: build/RScanMac.xcarchive and build/RScanMobile.xcarchive.
   • Packaged release artifacts:
     • iOS: build/ScanRoo-iOS.ipa (5.3 MB, SHA256: 57c41d594b505af970ac3371bfc3b7121aade94899e107590eae3e8aee98caf0, CDHash: eb5de8fd5997efaa6886b74ca70076f38feb9b83)
     • macOS: build/ScanRoo-macOS.pkg (6.4 MB, SHA256: 8553fd491c77da8e05d182c68b680c099eef2ff487d2f0db3878c72e1aa3da40, CDHash: 9467b88d93a5a77315385557beebe9e5b1ba3896)
   • Validated against App Store Connect API: bundle ID app.scanroo.ScanRoo verified in Apple Developer database (id: H78XY6T2G3, platform UNIVERSAL).
   • Executed xcrun altool --validate-app on both release packages with App Store Connect credentials.
   • Authored durable evidence receipt docs/release-evidence/APP_STORE_RELEASE_RECEIPT.md.

2. Verification Evidence

• Git working tree: clean on main at 607535d.
• Tests: 525 / 525 passed across ScanRooKit (270) and Tests/E2E (255).
• Codesign verification: codesign -dvvv build/RScanMac.xcarchive/Products/Applications/ScanRoo.app -> Apple Distribution: east coast science, llc (ZU2882L4HT), flags 0x10000(runtime). codesign -dvvv build/RScanMobile.xcarchive/Products/Applications/ScanRoo.app -> Apple Distribution: east coast science, llc (ZU2882L4HT).
• Apple App Store Connect API: JWT authentication verified 200 OK via ASC_KEY_ID / ASC_ISSUER_ID.

3. How to Undo

To roll back release commit: git -C ~/dev/apps/ScanRoo reset --hard 841512a