Operational UX refinement for return-home nudge timing, contact-switch blocker, popup cooldown, and credit visibility

DEC-0061 - Operational UX refinement for return-home nudge timing, contact-switch blocker, popup cooldown, and credit visibility

Context

DEC-0060 locked directionally correct behavior, but some execution details still needed precision to avoid inconsistent implementation across Home, checkout blockers, and result lock interactions.

Decision

Return-to-home nudge timing:

• Goal nudge suppression applies only at immediate return-to-protected context.
• On first Home entry later in the same session, goal nudge can be shown if daily cap allows.

Checkout blocker interaction:

• If checkout is blocked by missing verified recoverable contact, user can switch verify channel immediately on blocker UI.
• Default suggested channel still prioritizes last-auth-used channel.

Yearly savings comparison basis:

• For one-time package savings badges:
  • 6-month compares to 3-month,
  • 12-month compares to 6-month.

Locked popup cadence:

• Locked AI section opens popup at each tap.
• Apply reopen cooldown of 1-2 seconds between popup opens to prevent spam-loop.

Retained-credit visibility:

• On Pro Max -> Pro downgrade with remaining AI credits:
  • retain credit balance,
  • show explicit retained but usage-locked messaging in Result context and Billing/Subscription.

Decision Value

• Preserves learning continuity while still surfacing onboarding nudges at valid moments.
• Reduces checkout abandonment by giving quick channel-switch recovery.
• Makes savings communication deterministic and auditable.
• Keeps popup behavior responsive but controlled.
• Improves trust by exposing retained-credit state transparently.

Rationale

These refinements remove implementation ambiguity without increasing system complexity, and keep the UX predictable at high-frequency touchpoints.