@capgo/cli 8.106.2 → 8.108.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@capgo/cli",
3
3
  "type": "module",
4
- "version": "8.106.2",
4
+ "version": "8.108.0",
5
5
  "description": "A CLI to upload to capgo servers",
6
6
  "author": "Martin martin@capgo.app",
7
7
  "license": "Apache 2.0",
@@ -105,6 +105,7 @@
105
105
  "test:analytics-org-resolver": "bun test/test-analytics-org-resolver.mjs",
106
106
  "test:api-perf": "bun test/test-api-perf.mjs",
107
107
  "test:preview-qr": "bun test/test-preview-qr.mjs",
108
+ "test:build-custom-msg": "bun test/test-build-custom-msg.mjs",
108
109
  "test:bundle-pages": "bun test test/test-bundle-pages.test.ts",
109
110
  "test:bundle-single-requests": "bun test test/test-bundle-single-requests.test.ts",
110
111
  "test:mcp-analytics": "bun test/test-mcp-analytics.mjs && bun test/test-mcp-telemetry-project.mjs",
@@ -205,7 +206,7 @@
205
206
  "test:run": "bun scripts/run-test-suite.ts",
206
207
  "test:serial": "bun run build && bun scripts/run-test-suite.ts --serial",
207
208
  "test:monitoring": "bun test test/test-monitoring.test.ts",
208
- "test:suite": "bun run test:monitoring && bun run test:helper-dce && bun run test:version-detection:setup && bun run test:bundle && bun run test:notify-app-ready-background && bun run test:bundle-validation && bun run test:functional && bun run test:semver && bun run test:auto-bump-version && bun run test:auto-bump-ai-diff && bun run test:version-edge-cases && bun run test:regex && bun run test:upload && bun run test:cordova-upload-mode && bun run test:fail-on-incompatible && bun run test:native-dependencies && bun run test:package-json-guard && bun run test:credentials && bun run test:credentials-export && bun run test:key-create-mode && bun run test:ios-provisioning-map && bun run test:ios-provisioning-command && bun run test:credentials-validation && bun run test:android-service-account-validation && bun run test:build-zip-filter && bun run test:offline-packers && bun run test:checksum && bun run test:build-needed && bun run test:cli-help && bun run test:build-cache-payload && bun run test:build-cancellation && bun run test:ci-prompts && bun run test:capgo-app-id-prompt && bun run test:ci-secrets && bun run test:android-onboarding-progress && bun run test:android-keystore-action && bun run test:android-google-play-action && bun run test:onboarding-telemetry && bun run test:v2-event-migration && bun run test:analytics && bun run test:cli-headers && bun run test:min-cli-version && bun run test:authenticated-command-invocation && bun run test:analytics-error-category && bun run test:analytics-org-resolver && bun run test:api-perf && bun run test:preview-qr && bun run test:bundle-pages && bun run test:bundle-single-requests && bun run test:app-set-options && bun run test:mcp-analytics && bun run test:mcp-instructions && bun run test:mcp-error-guidance && bun run test:mcp-live-update-onboarding && bun run test:mcp-stdout-guard && bun run test:mcp-project-dir && bun run test:mcp-host-fields && bun run test:mcp-platform-select && bun run test:mcp-explain-scopes && bun run test:mcp-oauth-reopen && bun run test:mcp-broker-oauth && bun run test:mcp-broker-session && bun run test:mcp-credentials-manage && bun run test:mcp-resume-prompt && bun run test:mcp-build-job && bun run test:mcp-build-spawn && bun run test:mcp-build-tools && bun run test:app-created-source && bun run test:app-add-exists && bun run test:app-add-getting-started && bun run test:app-list && bun run test:app-todo && bun run test:doctor-analytics && bun run test:posthog-exception && bun run test:cli-recovery && bun run test:create-capgo-client && bun run test:bundle-soft-delete && bun run test:no-supabase-sdk && bun run test:no-redirect-error && bun run test:build-platform-selection && bun run test:builder-project-discovery && bun run test:builder-app-selection && bun run test:builder-login-gate && 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-monorepo-targeting && bun run test:init-app-conflict && bun run test:channel-list && bun run test:channel-add-exists && bun run test:wait-log && bun run test:init-guardrails && bun run test:init-command-execution && bun run test:init-upload-recovery && bun run test:init-replay && bun run test:init-telemetry && bun run test:init-ota-checklist && bun run test:prompt-preferences && bun run test:esm-sdk && bun run test:mcp && bun run test:mcp-no-key-handshake && bun run test:auth-session && bun run test:version-detection && bun run test:platform-paths && bun run test:project-type-detection && bun run test:payload-split && bun run test:macos-signing && bun run test:asc-key-protocol && bun run test:apple-api-import-helpers && bun run test:apple-api-verify-key && 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:cicd-failure-help && 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:support && bun run test:self-update && bun run test:update-prompt && bun run test:apple-api-cert-create && bun run test:android-tail-engine && bun run test:android-tail-render && bun run test:android-tail-routing && bun run test:dev-gate-stripped && bun run test:ios-confirm-app-id && bun run test:ios-create-new && bun run test:ios-certificate-action && bun run test:ios-profile-action && bun run test:ios-credential-action && bun run test:ios-e2e && bun run test:ios-import-discovery && bun run test:ios-import-export && bun run test:ios-import-pickers && bun run test:ios-import-recovery && bun run test:ios-recovery && bun run test:ios-resume && bun run test:ios-tail-handoff && bun run test:ios-tui-render && bun run test:p8-error && bun run test:ios-tui-routing && bun run test:ios-updater-sync-validation && bun run test:ios-verify-app && bun run test:ios-marketing-version && bun run test:android-version && bun run test:platform-flow-contract && bun run test:tail-engine-shared && bun run test:prescan && bun run test:android-reporting-api && bun run test:android-gcp && bun run test:android-app-verification && bun run test:android-rename && bun run test:appflow-auth && bun run test:appflow-api-map && bun run test:appflow-validate && bun run test:appflow-flow && bun run test:appflow-gapfill && bun run test:appflow-engine && bun run test:appflow-tail && bun run test:appflow-fetch && bun run test:appflow-sa-decode && bun run test:app-permission-helper && bun run test:2fa-compliance-network && bun run test:retryable-capgo-api-error && bun run test:organization-set-api-host && bun run test:plan-validation && bun run test:setup-notices && bun run test:settings-parity && bun run test:init-browser-login && bun run test:android-onboarding-units && bun run test:build-credentials-units && bun run test:onboarding-generators && bun run test:mcp-onboarding",
209
+ "test:suite": "bun run test:monitoring && bun run test:helper-dce && bun run test:version-detection:setup && bun run test:bundle && bun run test:notify-app-ready-background && bun run test:bundle-validation && bun run test:functional && bun run test:semver && bun run test:auto-bump-version && bun run test:recommend && bun run test:auto-bump-ai-diff && bun run test:version-edge-cases && bun run test:regex && bun run test:upload && bun run test:cordova-upload-mode && bun run test:fail-on-incompatible && bun run test:native-dependencies && bun run test:package-json-guard && bun run test:credentials && bun run test:credentials-export && bun run test:key-create-mode && bun run test:ios-provisioning-map && bun run test:ios-provisioning-command && bun run test:credentials-validation && bun run test:android-service-account-validation && bun run test:build-zip-filter && bun run test:offline-packers && bun run test:checksum && bun run test:build-needed && bun run test:cli-help && bun run test:build-cache-payload && bun run test:build-cancellation && bun run test:ci-prompts && bun run test:capgo-app-id-prompt && bun run test:ci-secrets && bun run test:android-onboarding-progress && bun run test:android-keystore-action && bun run test:android-google-play-action && bun run test:onboarding-telemetry && bun run test:v2-event-migration && bun run test:analytics && bun run test:cli-headers && bun run test:min-cli-version && bun run test:authenticated-command-invocation && bun run test:analytics-error-category && bun run test:analytics-org-resolver && bun run test:api-perf && bun run test:preview-qr && bun run test:build-custom-msg && bun run test:bundle-pages && bun run test:bundle-single-requests && bun run test:app-set-options && bun run test:mcp-analytics && bun run test:mcp-instructions && bun run test:mcp-error-guidance && bun run test:mcp-live-update-onboarding && bun run test:mcp-stdout-guard && bun run test:mcp-project-dir && bun run test:mcp-host-fields && bun run test:mcp-platform-select && bun run test:mcp-explain-scopes && bun run test:mcp-oauth-reopen && bun run test:mcp-broker-oauth && bun run test:mcp-broker-session && bun run test:mcp-credentials-manage && bun run test:mcp-resume-prompt && bun run test:mcp-build-job && bun run test:mcp-build-spawn && bun run test:mcp-build-tools && bun run test:app-created-source && bun run test:app-add-exists && bun run test:app-add-getting-started && bun run test:app-list && bun run test:app-todo && bun run test:doctor-analytics && bun run test:posthog-exception && bun run test:cli-recovery && bun run test:create-capgo-client && bun run test:bundle-soft-delete && bun run test:no-supabase-sdk && bun run test:no-redirect-error && bun run test:build-platform-selection && bun run test:builder-project-discovery && bun run test:builder-app-selection && bun run test:builder-login-gate && 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-monorepo-targeting && bun run test:init-app-conflict && bun run test:channel-list && bun run test:channel-add-exists && bun run test:wait-log && bun run test:init-guardrails && bun run test:init-command-execution && bun run test:init-upload-recovery && bun run test:init-replay && bun run test:init-telemetry && bun run test:init-ota-checklist && bun run test:prompt-preferences && bun run test:esm-sdk && bun run test:mcp && bun run test:mcp-no-key-handshake && bun run test:auth-session && bun run test:version-detection && bun run test:platform-paths && bun run test:project-type-detection && bun run test:payload-split && bun run test:macos-signing && bun run test:asc-key-protocol && bun run test:apple-api-import-helpers && bun run test:apple-api-verify-key && 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:cicd-failure-help && 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:support && bun run test:self-update && bun run test:update-prompt && bun run test:apple-api-cert-create && bun run test:android-tail-engine && bun run test:android-tail-render && bun run test:android-tail-routing && bun run test:dev-gate-stripped && bun run test:ios-confirm-app-id && bun run test:ios-create-new && bun run test:ios-certificate-action && bun run test:ios-profile-action && bun run test:ios-credential-action && bun run test:ios-e2e && bun run test:ios-import-discovery && bun run test:ios-import-export && bun run test:ios-import-pickers && bun run test:ios-import-recovery && bun run test:ios-recovery && bun run test:ios-resume && bun run test:ios-tail-handoff && bun run test:ios-tui-render && bun run test:p8-error && bun run test:ios-tui-routing && bun run test:ios-updater-sync-validation && bun run test:ios-verify-app && bun run test:ios-marketing-version && bun run test:android-version && bun run test:platform-flow-contract && bun run test:tail-engine-shared && bun run test:prescan && bun run test:android-reporting-api && bun run test:android-gcp && bun run test:android-app-verification && bun run test:android-rename && bun run test:appflow-auth && bun run test:appflow-api-map && bun run test:appflow-validate && bun run test:appflow-flow && bun run test:appflow-gapfill && bun run test:appflow-engine && bun run test:appflow-tail && bun run test:appflow-fetch && bun run test:appflow-sa-decode && bun run test:app-permission-helper && bun run test:2fa-compliance-network && bun run test:retryable-capgo-api-error && bun run test:organization-set-api-host && bun run test:plan-validation && bun run test:setup-notices && bun run test:settings-parity && bun run test:init-browser-login && bun run test:android-onboarding-units && bun run test:build-credentials-units && bun run test:onboarding-generators && bun run test:mcp-onboarding",
209
210
  "test:build-platform-selection": "bun test/test-build-platform-selection.mjs",
210
211
  "test:builder-project-discovery": "bun test/test-builder-project-discovery.mjs",
211
212
  "test:builder-app-selection": "bun test/test-builder-app-selection.mjs",
@@ -259,7 +260,8 @@
259
260
  "test:build-credentials-units": "bun test/test-credentials-migration.mjs && bun test/test-provisioning-map-validation.mjs && bun test/test-mobileprovision-parser.mjs",
260
261
  "test:onboarding-generators": "bun test/test-diff-utils.mjs && bun test/test-workflow-generator.mjs",
261
262
  "test:mcp-onboarding": "bun test ./test/build/onboarding/mcp/scoped-credential-path.test.ts && bun test/test-mcp-onboarding.mjs",
262
- "test:setup-notices": "bun test ./test/test-setup-notices.mjs ./test/test-setup-progress-request.mjs ./test/test-setup-notice-background.mjs ./test/test-init-completion-notice.mjs && bun test ./test/test-builder-setup-notice.mjs"
263
+ "test:setup-notices": "bun test ./test/test-setup-notices.mjs ./test/test-setup-progress-request.mjs ./test/test-setup-notice-background.mjs ./test/test-init-completion-notice.mjs && bun test ./test/test-builder-setup-notice.mjs",
264
+ "test:recommend": "bun test test/recommend-context.test.ts"
263
265
  },
264
266
  "dependencies": {
265
267
  "@inkjs/ui": "^2.0.0",
@@ -355,7 +355,23 @@ npx @capgo/cli@latest simulator start com.example.app --platform android --name
355
355
  - `--json`: print the session JSON instead of the session id and URL.
356
356
  - `-a, --apikey <apikey>` and `--api-host <apiHost>`: same authentication override as the other commands.
357
357
 
358
- The command prints the session id, then the session URL. `simulator get` and `simulator stop` need that id. An iOS session boots a slim device. An Android session uses a small profile: 1536 MB RAM, 2 cores, no audio, no snapshot, and no boot animation.
358
+ The command prints the session id, then the session URL. `--json` also prints `remoteConfig` in the Expo device-run shape: `agentDeviceRemoteSessionUrl`, `agentDeviceRemoteSessionToken`, `webPreviewUrl`, `webPreviewToken`, and `previewApiUrl`. `simulator get`, `simulator command`, and `simulator stop` need the session id. An iOS session boots a slim device. An Android session uses a small profile: 1536 MB RAM, 2 cores, no audio, no snapshot, and no boot animation.
359
+
360
+ - `--build-job <buildJobId>`: install that saved iOS build into the new simulator.
361
+
362
+ Both the hosted Capgo MCP and `capgo mcp` expose `capgo_start_simulator`, `capgo_get_simulator`, `capgo_simulator_command`, and `capgo_stop_simulator`. `capgo_simulator_command` speaks the same agent-device commands as an Expo simulator session: `devices`, `screenshot`, `snapshot`, `home`, `lock`, `tap`, and `open`.
363
+
364
+ ### `simulator command <deviceCommand> [sessionId] [appId]`
365
+
366
+ ```bash
367
+ npx @capgo/cli@latest simulator command screenshot <session-id> com.example.app
368
+ npx @capgo/cli@latest simulator command tap <session-id> com.example.app --x 0.5 --y 0.4
369
+ npx @capgo/cli@latest simulator command open <session-id> com.example.app --bundle-id app.capgo.capdemo
370
+ ```
371
+
372
+ - `<deviceCommand>`: `devices`, `screenshot`, `snapshot`, `home`, `lock`, `tap`, or `open`.
373
+ - `--x <x>` and `--y <y>`: tap position. `0` to `1` is a fraction of the screen. A number above `1` is a point.
374
+ - `--bundle-id <bundleId>`: bundle id for `open`.
359
375
 
360
376
  ### `simulator get [sessionId] [appId]`
361
377
 
@@ -296,3 +296,12 @@ Use this skill for OTA update workflows in Capgo Cloud.
296
296
  ### `key delete_old`
297
297
 
298
298
  - Example: `npx @capgo/cli@latest key delete_old`
299
+
300
+ ## AI release recommendations
301
+
302
+ - `npx @capgo/cli@latest bundle recommend [appId] --since <ref> --changelog` suggests a next version using local Git summaries plus Capgo metadata. Requires an active paid subscription and upload permission.
303
+ - For GitHub history: add `--repo owner/repo --since <ref> --ref <ref>`; requires authenticated `gh`, and no GitHub token is sent to Capgo.
304
+ - Inspect `--dry-run` before sharing potentially sensitive commit subjects or paths. No source contents or untracked contents are collected.
305
+ - Use `--base-version` for the first release or a different baseline; otherwise the latest Capgo release is the baseline.
306
+ - `--json` emits JSON; `--changelog` adds a Markdown draft. Review the output. The command does not modify files, upload, tag, or publish, and does not reserve the suggested name.
307
+ - History is bounded and truncation is disclosed. AI/provider errors are surfaced, never silently converted to a version.
@@ -103,7 +103,7 @@ Load `skills/native-builds/SKILL.md` when working with:
103
103
 
104
104
  - `build request`
105
105
  - `build needed`
106
- - `simulator start`, `simulator get`, `simulator stop`
106
+ - `simulator start`, `simulator get`, `simulator command`, `simulator stop`
107
107
  - `build credentials save`
108
108
  - `build credentials list`
109
109
  - `build credentials clear`