Repository navigation
docs(mobile): establish native release baseline and Xcode profiles - #99
Conversation
|
@sfl review |
There was a problem hiding this comment.
🟡 Changes recommended
The release documentation still permits archives to use the workstation’s default Xcode instead of the pinned Xcode 26.6, leaving builds non-reproducible.
1 open issue
What changed in this PR
Documents the accepted Third Roll mobile release baseline, native-generation policy, mobile versioning, and local Xcode build profiles.
Changes:
- Records pinned native tooling, identity, versioning, and generation policies.
- Adds Debug, unsigned simulator Release, and unsigned device-archive workflows.
- Links the baseline from native simulator guidance and updates stale identity wording.
- Review notes request adding the timezone to the history entry and pinning
DEVELOPER_DIRfor the production-profile command.
This pull request requires changes.
| File | Description |
|---|---|
History/2026-11-02.md |
Records the mobile release baseline documentation update. |
docs/native-simulator.md |
Links the baseline guide and updates Third Roll identity and version wording. |
docs/mobile-release-baseline.md |
Defines native generation, versioning, identity, Xcode profiles, evidence, and remaining release scope. |
Review effort: Lite
|
SFL review stopped: head moved; post a fresh request. |
|
@sfl review |
There was a problem hiding this comment.
✅ Verdict: PASS • Round 1
Review done by claude-opus-5-5 (adversarial to codex)
Documentation-only change that adds a Third Roll native release baseline with three local Xcode profiles, links it from the native qualification guide, and updates that guide's stale identity wording. No defects were evidenced: the checked claims match exact-SHA configuration, runner code, workflow and the cited CI run, so there are no blocking findings.
🔨 Full-Spectrum Review Summary
Effort: high
Review time: 3m 0s
Token count: Unavailable
| Pass | 🔴 Critical | 🟠 High | 🟡 Medium | ⚪ Low |
|---|---|---|---|---|
| 🔒 Security | 0 | 0 | 0 | 0 |
| ✅ Accuracy | 0 | 0 | 0 | 0 |
| 🧰 Quality & Maintainability | 0 | 0 | 0 | 0 |
| Total | 0 | 0 | 0 | 0 |
Key Findings
No material defects found.
Coverage
- Files reviewed:
History/2026-11-02.mddocs/mobile-release-baseline.mddocs/native-simulator.md
- Context read:
AGENTS.mdCLAUDE.mdpackage.json.gitignore.github/workflows/quality.ymlapps/mobile/app.jsonapps/mobile/package.jsonapps/mobile/.gitignoreapps/mobile/native/README.mdapps/mobile/native/Podfile.lockapps/mobile/release/candidate.jsonapps/mobile/assets/README.mdapps/mobile/assets/provenance.jsonapps/mobile/APP-STORE.mdapps/mobile/CHANGELOG.mddocs/mobile-privacy-audit.mddocs/mobile-offline.mdscripts/ios-native/run.mjsscripts/ios-native/build.mjsscripts/ios-release/check.mjsscripts/ios-release/check.test.mjsscripts/ios-release/tracker.test.mjsHistory/2026-09-27.md
- Verified:
- Compare response returned
base_commit.sha0b01666a84152bfca16dfe3f9e5f80a9bbf32ffeand last commitcd5624972f50e1113fcb763c6975604d78478f0b; statusaheadby 2 commits, 3 files. - Base commit message is the Third Roll rename (#96), matching the accepted-revision claim.
app.jsonmatches the documented name,com.hemsoft.thirdroll, version 1.0.0, build 1, iOS 17.0, tablet support,requireFullScreen: false, automatic appearance, default orientation andthirdrollscheme, and sets no entitlement keys.apps/mobile/package.jsonpins Expo 57.0.31, React Native 0.86.3 and React 19.2.3, and setsbuildFromSourceforexpo-file-system.run.mjssetsDEVELOPER_DIRto Xcode_26.6 and asserts Xcode 26.6 (17F113), SDK 26.5, Node 24.12.0, Bun 1.4.2 and CocoaPods 1.17.0, which supports the claim that CI pins and verifies tools.build.mjsmatches the documented runner sequence: prebuild, lock copy,pod install --deployment, unsigned Release build, identity andmain.jsbundlechecks, and a retained artifact.- The manual profile blocks use the same prebuild, lock copy and
pod install --deploymentsteps asbuild.mjs;reports/andapps/mobile/ios/are git-ignored, and relative output paths resolve to the rootreports/. - Build job log for run 41523939067 shows
ThirdRoll.xcworkspaceand schemeThirdRoll, matching the documentedxcodebuildarguments. - Run 41523939067 has
headShaequal to the base; simulator build, Linux/Windows validation, mutation, phone-6 and tablet-10 succeeded; phone-5, tablet-8 andquality-gatefailed, as documented. quality.ymlfeeds one build artifact into four test groups, andquality-gaterequires every job, matching the documented gate.- Numbering policy is consistent with
APP-STORE.mdandcheck.mjs: candidate records are prepared separately and mismatches fail closed in release mode. - Identity wording matches
CHANGELOG.md(decided in #39) andpublicIdentityApprovedinprovenance.json;candidate.jsonkeepsbundleIdentifiernull. - Tree contains no
.swiftfiles oreas.json, and containsicon-source.svg, the icon variants andlaunch-mark.pngclaimed for #45. tracker.test.mjsassertions ondocs/native-simulator.mdstill match: theTogether, the four groupssentence remains and no former-owner URL was added.- Relative links in the new guide resolve to paths in the head tree;
dev:mobileexists in rootpackage.json.
- Compare response returned
- Not verified:
- Debug and unsigned device-archive commands were not executed; the PR also says they lack macOS evidence, so whether they succeed is unconfirmed, including the Debug build's generic simulator destination without the runner's
ARCHSrestriction. - Generated entitlements from prebuild were not inspected, because
apps/mobile/iosis not in the repository; the no-entitlement claim was checked only againstapp.json. no uncommitted redesign to importcannot be checked for local checkouts through the API; only the committed tree was read.- Root causes of the phone-5 and tablet-8 failures were not analyzed; only job conclusions were checked.
- External pages, including Expo's CNG documentation, were not fetched.
- PR-body validation claims about local gates and mutation runs were not checked, since they are not repository content.
- Debug and unsigned device-archive commands were not executed; the PR also says they lack macOS evidence, so whether they succeed is unconfirmed, including the Debug build's generic simulator destination without the runner's
- Tests run: None. Reviewer execution is disabled.
HemSoft full-spectrum review • 3 evidence-based passes • Reviewed head cd5624972f50e1113fcb763c6975604d78478f0b • SFL v0
|
@sfl review |
There was a problem hiding this comment.
✅ Verdict: PASS • Round 2
Since round 1
New: 0; still open (repeated): 0; resolved: 0.
Resolved means no matching finding in this review, not independent proof of a fix.
New (0)
- None.
Still open (repeated) (0)
- None.
Resolved (0)
- None.
Review done by claude-opus-5-5 (adversarial to codex)
This documentation-only change adds a native release baseline with three local Xcode profiles, links it from the simulator guide, updates the identity wording and adds a History entry. The verdict is clean: the static claims checked match exact-ref config, the runner and CI job results, the round 1 DEVELOPER_DIR gap is fixed at this head, and no evidenced defect was found within the stated coverage.
🔨 Full-Spectrum Review Summary
Effort: high
Review time: 2m 3s
Token count: Unavailable
| Pass | 🔴 Critical | 🟠 High | 🟡 Medium | ⚪ Low |
|---|---|---|---|---|
| 🔒 Security | 0 | 0 | 0 | 0 |
| ✅ Accuracy | 0 | 0 | 0 | 0 |
| 🧰 Quality & Maintainability | 0 | 0 | 0 | 0 |
| Total | 0 | 0 | 0 | 0 |
Key Findings
No material defects found.
Coverage
- Files reviewed:
History/2026-11-02.mddocs/mobile-release-baseline.mddocs/native-simulator.md
- Context read:
AGENTS.mdCLAUDE.mdpackage.jsonapps/mobile/app.jsonapps/mobile/package.jsonapps/mobile/.gitignoreapps/mobile/native/README.mdapps/mobile/assets/README.mdapps/mobile/assets/provenance.jsonapps/mobile/release/candidate.jsonapps/mobile/APP-STORE.mdscripts/ios-native/build.mjsscripts/ios-native/run.mjsscripts/ios-release/check.mjsscripts/ios-release/tracker.test.mjs.github/workflows/quality.yml.gitignoreconvex/lib/rules.tsdocs/mobile-offline.mddocs/mobile-privacy-audit.mddocs/mobile-release-brief.md
- Verified:
- Compare
base_commit.shais74d09ab68b654ad2be6089185d345e20f465aa9b; the last compare commit is41ef6759d3968e0a7d0fc5accdcf97b06108cf15; ahead 3, behind 0 0b01666a84152bfca16dfe3f9e5f80a9bbf32ffeis the #96 rename commit, and the only commit between it and the reviewed base changes docs and History- Run
41523939067has head0b01666; build, validation, mutation,phone-6andtablet-10succeeded;phone-5,tablet-8andquality-gatefailed, as documented - Expo, React Native and React versions, exact native pins and
expo-file-systembuildFromSourcematchapps/mobile/package.json - Name, bundle ID, scheme, version, build, orientation, appearance, tablet and full-screen settings match
apps/mobile/app.json;expo-build-propertiessets deployment target 17.0, andbuild.mjsasserts it in the built app - Node, Bun, CocoaPods, Xcode build and SDK pins match the assertions in
run.mjs; itsenvsets the sameDEVELOPER_DIR, so the simulator block needs no export - Debug and archive prebuild, lock copy and
pod install --deploymentsteps matchbuild.mjs; relative output paths resolve to the ignored rootreports/directory - Development and production blocks both export the pinned
DEVELOPER_DIRbefore prebuild,pod installandxcodebuild, resolving the round 1 review comment --build-onlycompiles Release withCODE_SIGNING_ALLOWED=NO, checks identity andmain.jsbundle, and CI reuses that run's artifact across four groupsbun run dev:mobileresolves to the mobile package'sexpo start;apps/mobile/.gitignoreignores generatedios/check.mjscompares candidate version and build withapp.json;candidate.jsonkeepsbundleIdentifiernull, and the doc says configuration is not store evidencetracker.test.mjsassertions ondocs/native-simulator.mdtarget unchanged text: canonical links and theTogether, the four groupssentence- Icon and launch files plus
icon-source.svgexist at the head, and asset docs state original authorship under MIT - All new relative doc links point to paths present in the exact-ref tree; issues #45 and #46 exist and are open
- Compare
- Not verified:
- Debug and unsigned device-archive commands were not executed; the document itself says they still need macOS execution evidence
- Hard-coded
ThirdRoll.xcworkspaceand scheme name: generated output is not in the repository, so the name is inferred, whilebuild.mjsdiscovers it dynamically - No push, iCloud, Game Center or associated-domain entitlement: checked against
app.jsonand its plugin list only, because generated entitlements are not readable no second rules implementation: only a partial tree listing and the head ofconvex/lib/rules.tswere inspected;scripts/ios-native/scoring.mjswas not readno uncommitted redesign to import: working-tree state on any workstation cannot be checked through the GitHub API- Expo CNG documentation link and upstream Expo behavior were not fetched; only repository sources and GitHub API data were read
- Current-head CI was still in progress when read and is not used as evidence; the cited baseline run's failure causes were not diagnosed
- Tests run: None. Reviewer execution is disabled.
HemSoft full-spectrum review • 3 evidence-based passes • Reviewed head 41ef6759d3968e0a7d0fc5accdcf97b06108cf15 • SFL v0

Change
Refs #40. Record the accepted Third Roll base, Expo native-generation policy, mobile-only version numbering and three local Xcode profiles: Debug development, unsigned Release simulator qualification and unsigned Release device-archive preparation. Link the guide from the existing native qualification instructions and replace the stale identity wording.
Product decision
Use local Xcode and the existing public macOS CI rather than introduce an EAS account or service. The repository already pins the toolchain, deploys the reviewed CocoaPods lock and tests a source-bound simulator artifact. Existing original MIT icon/launch artwork and deterministic capture tooling stay in place. No parallel writer's support, marketing, release records or metadata files change.
Validation
Remaining scope
Native archive automation/inspection belongs to #46. Signing credentials, provisioning, App Store Connect, TestFlight and submission remain outside this preparation. This PR does not close #40 until the documented profile evidence is complete.