Unify CI and justfile: all workflows call just recipes

- justfile: extract ios_scheme/ios_sim/ios_spm/runner_temp variables; add
  ios-resolve (SPM dep cache), ios-archive, ios-export recipes; pipe xcodebuild
  through xcpretty with raw fallback in ios-build/ios-test
- ios.yaml: replace raw xcodebuild calls with just ios-build / just ios-test;
  install just via brew; uncommented archive job stub now calls just ios-archive
  && just ios-export; add justfile to path trigger
- ci-scraper.yaml: install just via extractions/setup-just@v2; use just lint /
  just test; fix upload-artifact v3 -> v4; add justfile to path trigger
- ci-ui.yaml: install just; use just ui-install / just ui-check / just ui-build;
  add justfile to path trigger

justfile

@@ -1,9 +1,13 @@
 # justfile — libnovel-v2 task runner
 # Install just: https://just.systems
 
-scraper_dir := "scraper"
-ui_dir      := "ui"
-ios_dir     := "ios/LibNovel"
+scraper_dir  := "scraper"
+ui_dir       := "ui"
+ios_dir      := "ios/LibNovel"
+ios_scheme   := "LibNovel"
+ios_sim      := "platform=iOS Simulator,name=iPhone 17"
+ios_spm      := ".spm-cache"
+runner_temp  := env_var_or_default("RUNNER_TEMP", "/tmp")
 
 # ─── Build ────────────────────────────────────────────────────────────────────
 
@@ -19,7 +23,7 @@ build-all:
 
 # Run unit tests only (no integration services required)
 test:
-    cd {{scraper_dir}} && go test ./...
+    cd {{scraper_dir}} && go test -race -count=1 -timeout=60s ./...
 
 # Run integration tests (requires MinIO, PocketBase, optional Browserless)
 # Override env vars as needed, e.g.:
@@ -85,23 +89,63 @@ ui-build:
 ios-gen:
     cd {{ios_dir}} && xcodegen generate --spec project.yml --project .
 
-# Build the iOS app for the simulator (no signing required)
-ios-build: ios-gen
+# Resolve SPM package dependencies (cached to {{ios_spm}})
+ios-resolve:
     cd {{ios_dir}} && xcodebuild \
-        -project LibNovel.xcodeproj \
-        -scheme LibNovel \
+        -project {{ios_scheme}}.xcodeproj \
+        -scheme {{ios_scheme}} \
+        -resolvePackageDependencies \
+        -clonedSourcePackagesDirPath {{ios_spm}}
+
+# Build the iOS app for the simulator (no signing required)
+# Runs ios-gen first to ensure the project is up to date.
+ios-build: ios-gen ios-resolve
+    cd {{ios_dir}} && set -o pipefail && xcodebuild \
+        -project {{ios_scheme}}.xcodeproj \
+        -scheme {{ios_scheme}} \
         -configuration Debug \
         -destination 'generic/platform=iOS Simulator' \
-        CODE_SIGNING_ALLOWED=NO
+        -clonedSourcePackagesDirPath {{ios_spm}} \
+        CODE_SIGNING_ALLOWED=NO \
+        | xcpretty || xcodebuild \
+            -project {{ios_scheme}}.xcodeproj \
+            -scheme {{ios_scheme}} \
+            -configuration Debug \
+            -destination 'generic/platform=iOS Simulator' \
+            -clonedSourcePackagesDirPath {{ios_spm}} \
+            CODE_SIGNING_ALLOWED=NO
 
 # Run unit tests on the simulator
-ios-test: ios-gen
-    cd {{ios_dir}} && xcodebuild test \
-        -project LibNovel.xcodeproj \
-        -scheme LibNovel \
+# Runs ios-gen first to ensure the project is up to date.
+ios-test: ios-gen ios-resolve
+    cd {{ios_dir}} && set -o pipefail && xcodebuild test \
+        -project {{ios_scheme}}.xcodeproj \
+        -scheme {{ios_scheme}} \
         -configuration Debug \
-        -destination 'platform=iOS Simulator,name=iPhone 17' \
-        CODE_SIGNING_ALLOWED=NO
+        -destination '{{ios_sim}}' \
+        -clonedSourcePackagesDirPath {{ios_spm}} \
+        CODE_SIGNING_ALLOWED=NO \
+        | xcpretty --report junit --output test-results.xml || true
+
+# Archive a signed Release build (requires valid signing identity in keychain).
+# Output: {{runner_temp}}/LibNovel.xcarchive
+# Typically called from CI after importing certificate + provisioning profile.
+ios-archive: ios-gen ios-resolve
+    cd {{ios_dir}} && xcodebuild archive \
+        -project {{ios_scheme}}.xcodeproj \
+        -scheme {{ios_scheme}} \
+        -configuration Release \
+        -clonedSourcePackagesDirPath {{ios_spm}} \
+        -archivePath {{runner_temp}}/LibNovel.xcarchive
+
+# Export an IPA from the archive produced by ios-archive.
+# Requires ios/LibNovel/ExportOptions.plist.
+# Output: {{runner_temp}}/ipa/LibNovel.ipa
+ios-export:
+    cd {{ios_dir}} && xcodebuild -exportArchive \
+        -archivePath {{runner_temp}}/LibNovel.xcarchive \
+        -exportPath {{runner_temp}}/ipa \
+        -exportOptionsPlist ExportOptions.plist
 
 # ─── Docker Compose ───────────────────────────────────────────────────────────