@capgo/cli 8.0.0 → 8.0.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@capgo/cli",
   "type": "module",
-  "version": "8.0.0",
+  "version": "8.0.2",
   "description": "A CLI to upload to capgo servers",
   "author": "Martin martin@capgo.app",
   "license": "Apache 2.0",
@@ -86,6 +86,7 @@
     "test:analytics-error-category": "bun test/test-analytics-error-category.mjs",
     "test:analytics-org-resolver": "bun test/test-analytics-org-resolver.mjs",
     "test:supabase-perf": "bun test/test-supabase-perf.mjs",
+    "test:preview-qr": "bun test/test-preview-qr.mjs",
     "test:mcp-analytics": "bun test/test-mcp-analytics.mjs",
     "test:app-created-source": "bun test/test-app-created-source.mjs",
     "test:doctor-analytics": "bun test/test-doctor-analytics.mjs",
@@ -110,7 +111,7 @@
     "test:app-verification": "bun test/test-app-verification.mjs",
     "test:pbxproj-parser": "bun test/test-pbxproj-parser.mjs",
     "test:manifest-path-encoding": "bun test/test-manifest-path-encoding.mjs",
-    "test": "bun run build && bun run test:version-detection:setup && bun run test:bundle && bun run test:functional && bun run test:semver && bun run test:version-edge-cases && bun run test:regex && bun run test:upload && bun run test:fail-on-incompatible && bun run test:credentials && bun run test:credentials-validation && bun run test:android-service-account-validation && bun run test:build-zip-filter && bun run test:checksum && bun run test:build-needed && bun run test:ci-prompts && bun run test:ci-secrets && bun run test:android-onboarding-progress && bun run test:onboarding-telemetry && bun run test:v2-event-migration && bun run test:analytics && bun run test:analytics-error-category && bun run test:analytics-org-resolver && bun run test:supabase-perf && bun run test:mcp-analytics && bun run test:app-created-source && bun run test:doctor-analytics && bun run test:posthog-exception && bun run test:build-platform-selection && bun run test:onboarding-recovery && bun run test:onboarding-progress && bun run test:onboarding-run-targets && bun run test:run-device-command && bun run test:init-app-conflict && bun run test:init-guardrails && bun run test:prompt-preferences && bun run test:esm-sdk && bun run test:mcp && bun run test:version-detection && bun run test:platform-paths && bun run test:payload-split && bun run test:manifest-path-encoding && bun run test:macos-signing && bun run test:apple-api-import-helpers && bun run test:bundle-id-detector && bun run test:apple-api-app-list && bun run test:app-verification && bun run test:pbxproj-parser && bun run test:ai-log-capture && bun run test:ai-analyze-flow && bun run test:ai-sse-parser && bun run test:ai-render-markdown && bun run test:ai-stream-markdown && bun run test:ai-onboarding-mode && bun run test:ai-fit && bun run test:platform-layout && bun run test:frame-fit && bun run test:onboarding-min-size && bun run test:min-size-gate && bun run test:shell-size-gate && bun run test:build-log-sanitize && bun run test:build-output-viewport && bun run test:diff-viewer-viewport && bun run test:build-complete-exit && bun run test:ai-analyze-stream",
+    "test": "bun run build && bun run test:version-detection:setup && bun run test:bundle && bun run test:functional && bun run test:semver && bun run test:version-edge-cases && bun run test:regex && bun run test:upload && bun run test:fail-on-incompatible && bun run test:credentials && bun run test:credentials-validation && bun run test:android-service-account-validation && bun run test:build-zip-filter && bun run test:checksum && bun run test:build-needed && bun run test:ci-prompts && bun run test:ci-secrets && bun run test:android-onboarding-progress && bun run test:onboarding-telemetry && bun run test:v2-event-migration && bun run test:analytics && bun run test:analytics-error-category && bun run test:analytics-org-resolver && bun run test:supabase-perf && bun run test:preview-qr && bun run test:mcp-analytics && bun run test:app-created-source && bun run test:doctor-analytics && bun run test:posthog-exception && bun run test:build-platform-selection && bun run test:onboarding-recovery && bun run test:onboarding-progress && bun run test:onboarding-run-targets && bun run test:run-device-command && bun run test:init-app-conflict && bun run test:init-guardrails && bun run test:prompt-preferences && bun run test:esm-sdk && bun run test:mcp && bun run test:version-detection && bun run test:platform-paths && bun run test:payload-split && bun run test:manifest-path-encoding && bun run test:macos-signing && bun run test:apple-api-import-helpers && bun run test:bundle-id-detector && bun run test:apple-api-app-list && bun run test:app-verification && bun run test:pbxproj-parser && bun run test:ai-log-capture && bun run test:ai-analyze-flow && bun run test:ai-sse-parser && bun run test:ai-render-markdown && bun run test:ai-stream-markdown && bun run test:ai-onboarding-mode && bun run test:ai-fit && bun run test:platform-layout && bun run test:frame-fit && bun run test:onboarding-min-size && bun run test:min-size-gate && bun run test:shell-size-gate && bun run test:build-log-sanitize && bun run test:build-output-viewport && bun run test:diff-viewer-viewport && bun run test:build-complete-exit && bun run test:ai-analyze-stream",
     "test:build-platform-selection": "bun test/test-build-platform-selection.mjs",
     "test:ai-log-capture": "bun test/test-ai-log-capture.mjs",
     "test:ai-analyze-flow": "bun test/test-ai-analyze-flow.mjs",

package/skills/release-management/SKILL.md

@@ -12,6 +12,24 @@ Use this skill for OTA update workflows in Capgo Cloud.
 - Prefer `npx @capgo/cli@latest ...` examples.
 - `appId` can often be inferred from the current Capacitor project.
 - Shared public flags often include `-a, --apikey`.
+- Preview QR workflows require app preview to be enabled before the QR code can be printed.
+
+## Preview QR workflows
+
+### `get-qr [appId] [target]`
+
+- Example: `npx @capgo/cli@latest get-qr com.example.app --bundle 1.2.3`
+- Example: `npx @capgo/cli@latest get-qr com.example.app --channel production`
+- Example: `npx @capgo/cli@latest get-qr com.example.app production --type channel`
+- Use to print a terminal QR code for a bundle or channel preview.
+- The target can be a bundle name, bundle id, channel name, or channel id.
+- If a positional target matches both a bundle and a channel, add `--type bundle` or `--type channel`.
+- Preview must already be enabled for the app; enable it with `npx @capgo/cli@latest app set com.example.app --preview`.
+- Key options:
+  - `--bundle <bundle>`
+  - `--channel <channel>`
+  - `--type <bundle|channel>`
+  - `-a, --apikey <apikey>`
 
 ## Bundle workflows
 
@@ -26,6 +44,7 @@ Use this skill for OTA update workflows in Capgo Cloud.
   - Encryption is recommended for trustless distribution.
   - Interactive prompts are disabled automatically in CI and other non-interactive sessions so uploads do not block automation.
   - Optional upload prompts can remember the user's answer on the current machine so future uploads can skip the same question.
+  - Use `--qr-preview` to print a terminal QR code for the uploaded bundle after a successful upload. App preview must be enabled first.
 - Important options:
   - `-p, --path <path>`
   - `-c, --channel <channel>`
@@ -58,6 +77,7 @@ Use this skill for OTA update workflows in Capgo Cloud.
   - `--disable-brotli`
   - `--version-exists-ok`
   - `--self-assign`
+  - `--qr-preview`
   - S3 options: `--s3-region`, `--s3-apikey`, `--s3-apisecret`, `--s3-endpoint`, `--s3-bucket-name`, `--s3-port`, `--no-s3-ssl`
   - Signing options: `--key-v2`, `--key-data-v2`, `--bundle-url`, `--no-key`, `--display-iv-session`
   - Deprecated options still supported: `--multipart`, `--partial`, `--partial-only`
@@ -179,6 +199,7 @@ Use this skill for OTA update workflows in Capgo Cloud.
   - One channel must remain default.
   - Supports update policies `major`, `minor`, `metadata`, `patch`, and `none`.
   - Supports platform and device targeting.
+  - Use `--qr-preview` to print a terminal QR code for the updated channel. App preview must be enabled first.
 - Key options:
   - `-b, --bundle <bundle>`
   - `-s, --state <state>`
@@ -195,6 +216,7 @@ Use this skill for OTA update workflows in Capgo Cloud.
   - `--device`, `--no-device`
   - `--package-json <packageJson>`
   - `--ignore-metadata-check`
+  - `--qr-preview`
 
 ## Encryption key workflows
 

package/skills/usage/SKILL.md

@@ -35,7 +35,7 @@ TanStack Intent skills should stay focused and under the validator line limit, s
 - `app add [appId]`: create an app in Capgo Cloud.
 - `app list`: list apps under the current account.
 - `app delete [appId]`: remove an app.
-- `app set [appId]`: update app settings such as name, icon, retention, and metadata exposure.
+- `app set [appId]`: update app settings such as name, icon, retention, metadata exposure, and preview access with `--preview` or `--no-preview`.
 - `app setting [path]`: update Capacitor config values programmatically.
 - `app debug [appId]`: listen for live-update debug events, optionally for one device.
 
@@ -57,6 +57,7 @@ Load `skills/release-management/SKILL.md` when working with:
 - `bundle upload`, `bundle list`, `bundle delete`, `bundle cleanup`
 - `bundle compatibility`, `bundle releaseType`, `bundle zip`, `bundle encrypt`, `bundle decrypt`
 - `channel add`, `channel list`, `channel delete`, `channel set`, `channel currentBundle`
+- `get-qr`
 - `key save`, `key create`, `key delete_old`
 
 ### `native-builds`
@@ -88,5 +89,6 @@ npx @capgo/cli@latest login YOUR_API_KEY
 npx @capgo/cli@latest doctor
 npx @capgo/cli@latest probe --platform ios
 npx @capgo/cli@latest app add com.example.app --name "My App"
+npx @capgo/cli@latest get-qr com.example.app --channel production
 npx @capgo/cli@latest star-all
 ```