Capgo Compatibility Checker

Use this skill when validating whether a bundle is safe to ship to a target channel.

Compatibility Layers

1. Package compatibility

• Capacitor core package major alignment
• updater package presence

2. Runtime compatibility

• CapacitorUpdater config present
• notifyAppReady() call path present on startup

3. Channel compatibility

• npx @capgo/cli@latest bundle compatibility pass against target channel
• npx @capgo/cli@latest bundle releaseType returns OTA when expected

4. Rollout compatibility

• Previous stable bundle available for rollback
• channel state and targeting validated before promotion

Commands

./scripts/check-capacitor-compatibility.sh --strict
npx @capgo/cli@latest bundle compatibility <appId> --channel <targetChannel>
npx @capgo/cli@latest bundle releaseType <appId> --channel <targetChannel>
npx @capgo/cli@latest channel currentBundle <targetChannel> <appId>
npx @capgo/cli@latest bundle list <appId>

Decision Matrix

• all green: proceed
• local fail: fix repository compatibility before any upload
• channel compatibility fail: stop promotion, investigate metadata/package mismatch
• release type = native: schedule store release, do not OTA

Required Output

• Gate results: pass/fail per layer
• Blocking issues: exact mismatch or missing config
• Remediation commands: concrete next steps
• Final decision: promote | hold