feat: align plugin with SDK v6 GA (iOS 6.0.0, Android 6.0.1, Flutter 6.0.0)

[kherembourg]

Summary

Audit source: Purchasely repos iOS (develop), Android (main), Flutter (main), Documentation (v6.0 branch), plus published npm/pub.dev/CocoaPods/Maven metadata.

Version pins → GA

• Native iOS: 6.0.0 (stable GA) — SPM primary (from: "6.0.0"), CocoaPods ~> 6.0.
• Native Android: 6.0.1 (stable GA) — chronology rc.1 → rc.2 → rc.3 → 6.0.1, no 6.0.0 tag was ever cut.
• Flutter: 6.0.0 (stable on pub.dev) — embeds native iOS 6.0.0 + Android core 6.0.1.
• React Native: 6.0.0-rc.3 (npm latest).
• Cordova: 6.0.0-rc.3 (npm dist-tag next; latest is still 5.7.3).

Factual fixes

• synchronize() is never called from inside the purchase/restore interceptor — returning SUCCESS already auto-synchronizes in Observer mode; manual calls are reserved for purchases handled outside the interceptor (BYOS, custom sell screens).
• React Native allowDeeplink defaults to true on every v6 platform — removed the last remaining "RN defaults to false" exceptions (purchasely-review SKILL.md and campaigns.md anti-patterns still had them).
• Removed-API attribution corrected: iOS never had presentSubscriptions() (v5 entry point was showController / PLYUIControllerType); Android's real removal is subscriptionsFragment(); displaySubscriptionCancellationInstruction() is removed, not a no-op.
• Android setDefaultPresentationDismissHandler never had a ResultHandler variant (Android always used that name; only iOS renamed to it in v6).
• Kotlin toolchain bumped to 2.3.21; themeMode() documented as available on both the Android DSL and Builder since 6.0.1.
• iOS 13.4+ deployment target reframed as inherited from the 5.x SDK, not a v6 change.

New references

• references/concepts/rendering-engine.md — iOS UIKit component tree + tolerant Safe<T> decoding, Android Views/fat-AAR, image cache, Lottie bridge, known rendering bugs.
• references/concepts/12-month-commitment.md — Apple "Monthly with 12-Month Commitment", Google native installments, {{MONTHLY_AMOUNT}} pricing tags, INSTALLMENT_* webhooks.
• references/concepts/web-checkout.md — Stripe Payment Links via the webCheckout action, audience targeting, WEB_CHECKOUT_* events.

New debug/review material

• New known-issues in purchasely-debug / support-known-issues.md: Lottie silent failure, stuck purchase spinner, Flutter display() hang, Indonesian locale pre-6.0.1, PRESENTATION_VIEWED eviction pre-rc.3, iPad campaign-close freeze, iOS 18.4/18.5 DEBUG image-cache bypass, video autoplay bug.
• New review checks: stale rc-era interceptAction import, Android close()-closes-all semantics, oneSignalPlayerId removal, allowCampaigns default flip.

Repo hygiene

• gemini-extension.json version aligned with every other manifest (was stuck at 1.1.0).
• purchasely-migrate coverage corrected to all 5 platforms in README.md, AGENTS.md, GEMINI.md, and hooks/intro.md (previously listed only 3).
• New "Release process" section in CLAUDE.md (direct-to-main releases, exhaustive manifest-bump checklist, bare-SemVer tags).
• npx --yes skills add . --list confirmed: Found 5 skills.

Test plan

• rg-equivalent sweep for stale 6.0.0-rc.1/6.0.0-rc.2 active pins — none remain outside legitimate chronology/historical mentions and CHANGELOG.
• No remaining React Native allowDeeplink false-by-default exceptions.
• presentSubscriptions() mentions all correctly scoped to Flutter/RN/Cordova (or explicit "iOS never had this").
• Sampled synchronize() call sites — none inside an interceptor without a "do not call here" caveat.
• Legacy API mentions (setDefaultPresentationResultHandler, readyToOpenDeeplink, setPaywallActionsInterceptor, io.purchasely.ext.interceptAction) all properly labeled as v5/legacy/detection patterns.
• sdk-versions.md / 5 SKILL.md files / root README.md cross-checked for consistent pins.
• New concept files exist, are indexed in concepts/README.md, and contain no wrapper-required language.
• npx --yes skills add . --list → Found 5 skills.
• CHANGELOG.md [Unreleased] reconciled against the actual diff.

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

This PR updates the plugin for the Purchasely v6 GA SDK line. The main changes are:

• Updates native and cross-platform SDK version guidance.
• Corrects migration, interceptor, campaign, and removed-API documentation.
• Adds rendering-engine, commitment-plan, and web-checkout references.
• Expands troubleshooting, review checks, and migration coverage.
• Documents the repository release process.

Confidence Score: 4/5

The migration command and release checklist inconsistencies need fixes before merging.

• The migration hint excludes three supported platforms and applies Android's target version generically.
• Two release checklists prescribe different manifest sets.
• The new Android theme example cannot be copied into compiling code.

purchasely/commands/migrate.md, CLAUDE.md, and purchasely/references/android/api-reference.md

Important Files Changed

Filename	Overview
purchasely/commands/migrate.md	Updates the target version but leaves the command hint inconsistent with its five-platform scope.
CLAUDE.md	Adds an exhaustive release process while leaving an older, conflicting manifest checklist in place.
purchasely/references/android/api-reference.md	Adds Android 6.0.1 APIs and behavior, including an incomplete theme initialization example.
purchasely/references/android/migration-v6.md	Updates Android dependency, toolchain, interceptor, synchronization, and removed-API guidance.
purchasely/references/sdk-versions.md	Centralizes the distinct GA and release-candidate versions for all supported platforms.
purchasely/references/concepts/12-month-commitment.md	Adds guidance for Apple commitment plans, Google installments, pricing tags, and webhook events.
purchasely/references/concepts/web-checkout.md	Adds Stripe Payment Link action, targeting, interception, and event guidance.
purchasely/references/concepts/rendering-engine.md	Documents native rendering, decoding, image caching, Lottie integration, and known limitations.

Prompt To Fix All With AI

Fix the following 3 code review issues. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 3
purchasely/commands/migrate.md:3
**Migration Hint Excludes Supported Targets**

The command now supports five platforms, but this hint still accepts only Android and iOS and uses Android's `6.0.1` as the shared target. Flutter, React Native, and Cordova users are excluded, while non-Android users are directed to a version that does not match the platform-specific pins documented by this PR.

```suggestion
argument-hint: "[platform: android|ios|flutter|react-native|cordova] [from:5.x] [to:6.x]"
```

### Issue 2 of 3
CLAUDE.md:20-21
**Release Checklists Still Conflict**

This section declares the nine-manifest list exhaustive, but the earlier release rule at line 11 still instructs maintainers to bump only `.claude-plugin/plugin.json` and `package.json`. Following that first checklist can still publish mismatched Cursor, marketplace, nested plugin, and Gemini versions.

### Issue 3 of 3
purchasely/references/android/api-reference.md:40
**Theme Example Is Not Runnable**

The newly documented `themeMode` call uses `...` instead of the Android parameter type or a valid enum value. A developer copying this initialization example gets a compile error and the surrounding text does not provide enough information to construct the required argument.

_{Reviews (1): Last reviewed commit: "docs(changelog): record v6 GA alignment ..." | Re-trigger Greptile}