Add and accept the promoted Lifetime Pro purchase flow

[lightcloud00]

Outcome

Let the approved Lifetime Pro non-consumable appear on the App Store and safely continue an App Store-initiated purchase inside ParkNudge.

Dependencies

• Lifetime Pro product configuration and Sandbox outcomes in Configure Lifetime Pro in App Store Connect and accept StoreKit Sandbox outcomes #7
• Final product-page assets in Finalize legal, privacy, App Store metadata, and screenshots #8

Plan

• Add protocol-backed handling for StoreKit PurchaseIntent on the iOS 17 deployment target.
• Route an App Store-initiated intent to the same verified purchase/entitlement authority as the in-app paywall.
• Handle already-entitled, success, cancelled, pending, unverified, unavailable, and interrupted launches.
• Create a compliant 1024-by-1024 promotional image distinct from the app icon and without important lower-left content.
• Add StoreKitTest coverage and a physical-device Sandbox checklist.
• Configure promotion only after the product and metadata are approved.

Guardrails

• Render only StoreKit localized displayPrice.
• Never unlock from cached preference or an unverified transaction.
• Promotion is optional; a failure must leave the complete free workflow usable.

Acceptance

• Tests cover all outcomes and cold/warm launch routing.
• Sandbox receipt demonstrates App Store-initiated purchase and restore.
• Public product-page visibility is read back after approval.

Apple guidance: https://developer.apple.com/help/app-store-connect/configure-in-app-purchase-settings/promote-in-app-purchases/

---

Scope / non-scope

Only the work and evidence already described in this issue are in scope. Merge, deployment, provider or store mutation, spend, billing, customer contact, device acceptance, indexing, and release remain separate gates unless this issue explicitly includes them and fresh proof is recorded.

Evidence and closure

Close only from exact current-source evidence plus the applicable independent readback. Keep local, GitHub/CI, provider, deployment, device, store, commerce, indexing, traffic, and revenue evidence distinct; one does not imply another.

Owner / lane

The repository delivery lane owns ordinary implementation and verification. The operator owns only actions explicitly marked as operator-only or protected.

Resolution plan

• Verified: 2026-08-25T05:34:22Z against main@04a6cd5e808720983471ee9595fd40bc94e1f0fe (commit time 2026-08-25T00:53:29Z).
• Source basis: Original issue body, all 0 comment(s), current default-branch tree, disposition-appropriate source-path checks, and referenced pull-request states.
• Disposition: Operator or external gate - execute only the bounded proof steps and stop at protected actions.
• Outcome: Let the approved Lifetime Pro non-consumable appear on the App Store and safely continue an App Store-initiated purchase inside ParkNudge.

Current evidence and corrected premise

The issue remains open and requires the resolution steps below.
All 0 issue comment(s) were read. There are no comments.

Resolution steps

1. Refresh the authoritative external state and bind it to the exact account, app, build, deployment, or provider identity.
2. Reconcile that readback with the issue-authored work below and identify the smallest remaining action.
3. Prepare the protected action, rollback, and failure receipt without exposing credentials or inferring authority.
4. Stop for the required operator decision or action, then execute it once through the owning workflow.
5. Validate the official readback and map it to every acceptance item before closure.

Grounded issue-authored detail

Scope / non-scope

Only the work and evidence already described in this issue are in scope. Merge, deployment, provider or store mutation, spend, billing, customer contact, device acceptance, indexing, and release remain separate gates unless this issue explicitly includes them and fresh proof is recorded.

Tests and acceptance

Acceptance

• Tests cover all outcomes and cold/warm launch routing.
• Sandbox receipt demonstrates App Store-initiated purchase and restore.
• Public product-page visibility is read back after approval.

Apple guidance: https://developer.apple.com/help/app-store-connect/configure-in-app-purchase-settings/promote-in-app-purchases/

---

Dependencies and stop gates

Dependencies

• Lifetime Pro product configuration and Sandbox outcomes in Configure Lifetime Pro in App Store Connect and accept StoreKit Sandbox outcomes #7
• Final product-page assets in Finalize legal, privacy, App Store metadata, and screenshots #8
• Do not close this issue until every acceptance item is mapped to exact merged-head evidence.

Next AI first action

Only the work and evidence already described in this issue are in scope. Merge, deployment, provider or store mutation, spend, billing, customer contact, device acceptance, indexing, and release remain separate gates unless this issue explicitly includes them and fresh proof is recorded.

[lightcloud00]

Verified issue disposition — diagnostic

This is the current managed disposition for lightcloud00/parknudge#18 at default-branch 5c3d185143a2.

Current evidence

• Current stable snapshot for Add and accept the promoted Lifetime Pro purchase flow #18 at 5c3d185143a2 keeps the issue open with body hash 2f9325fe09e3; the validated grounded planner classified it as blocked_external.

Files or owner actions

• For Add and accept the promoted Lifetime Pro purchase flow #18, bind the issue title 'Add and accept the promoted Lifetime Pro purchase flow' to one existing source path or named owner action before implementation.

Bounded plan

• For Add and accept the promoted Lifetime Pro purchase flow #18: Resolve the recorded targeted-source diagnostic or bind a canonical checkout before any implementation attempt.
• For Add and accept the promoted Lifetime Pro purchase flow #18: Record the canonical checkout, default-branch SHA, worktree dirt, and issue body hash before probing.
• For Add and accept the promoted Lifetime Pro purchase flow #18: Trace the issue-named behavior through these bounded source concepts or surfaces: accept, promoted, Lifetime, purchase, flow.
• For Add and accept the promoted Lifetime Pro purchase flow #18: Write a source-bound diagnostic receipt with reproduced/refuted state, root cause, implicated paths, and the smallest safe change boundary.
• For Add and accept the promoted Lifetime Pro purchase flow #18: Only after that receipt exists, implement the bounded fix and run the focused check followed by the repository-wide gate.

Commands

• Run git grep -n -F accept main for Add and accept the promoted Lifetime Pro purchase flow #18 and retain sanitized output.
• Run git grep -n -F promoted main for Add and accept the promoted Lifetime Pro purchase flow #18 and retain sanitized output.
• Run git grep -n -F Lifetime main for Add and accept the promoted Lifetime Pro purchase flow #18 and retain sanitized output.
• Run git grep -n -F purchase main for Add and accept the promoted Lifetime Pro purchase flow #18 and retain sanitized output.
• Run git grep -n -F flow main for Add and accept the promoted Lifetime Pro purchase flow #18 and retain sanitized output.
• Run python3 -m pytest -q for Add and accept the promoted Lifetime Pro purchase flow #18 and retain sanitized output.

Acceptance tests

• For Add and accept the promoted Lifetime Pro purchase flow #18: [ ] Tests cover all outcomes and cold/warm launch routing.
• For Add and accept the promoted Lifetime Pro purchase flow #18: [ ] Sandbox receipt demonstrates App Store-initiated purchase and restore.
• For Add and accept the promoted Lifetime Pro purchase flow #18: [ ] Public product-page visibility is read back after approval.
• For Add and accept the promoted Lifetime Pro purchase flow #18: [ ] Tests cover all outcomes and cold/warm launch routing.
• For Add and accept the promoted Lifetime Pro purchase flow #18: [ ] Sandbox receipt demonstrates App Store-initiated purchase and restore.
• For Add and accept the promoted Lifetime Pro purchase flow #18: [ ] Public product-page visibility is read back after approval.

Risks

• For Add and accept the promoted Lifetime Pro purchase flow #18, a false source binding could widen the change or invalidate this plan; Revert only the exact task-branch change after capturing source and runtime identity; never reset or restore an owner worktree.

Stop gates

• For Add and accept the promoted Lifetime Pro purchase flow #18: no issue close, reopen, body edit, pull-request, branch, or merge mutation while implementing this plan
• For Add and accept the promoted Lifetime Pro purchase flow #18: the managed plan comment and disposition-specific readiness labels are the only authorized issue mutations in the planning lane
• For Add and accept the promoted Lifetime Pro purchase flow #18: no push, protected-branch update, force-push, or merge
• For Add and accept the promoted Lifetime Pro purchase flow #18: no deploy, upload, App Store Connect, TestFlight, or public release
• For Add and accept the promoted Lifetime Pro purchase flow #18: no credential value disclosure, rotation, billing, or provider change
• For Add and accept the promoted Lifetime Pro purchase flow #18: no owner-worktree restore, reset, checkout, process signal, or queue reorder

---

Ledger schema: aos.github-issue-plan-coverage.v1 · issue body: 2f9325fe09e3