@capgo/cli 8.106.1 → 8.107.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/README.md +44 -0
- package/dist/index.js +868 -827
- package/dist/notify-app-ready-worker.js +1 -1
- package/dist/onboarding-worker.js +1 -1
- package/dist/package.json +5 -3
- package/dist/src/build/onboarding/mcp/build-job.d.ts +2 -0
- package/dist/src/build/onboarding/mcp/build-tools.d.ts +18 -1
- package/dist/src/bundle/recommend-context.d.ts +13 -0
- package/dist/src/bundle/recommend.d.ts +12 -0
- package/dist/src/mcp/simulator-tools.d.ts +2 -0
- package/dist/src/schemas/index.d.ts +1 -0
- package/dist/src/schemas/simulator.d.ts +34 -0
- package/dist/src/sdk.js +1 -1
- package/dist/src/simulator/session.d.ts +61 -4
- package/dist/updater-installed-worker.js +74 -74
- package/package.json +5 -3
- package/skills/native-builds/SKILL.md +17 -1
- package/skills/release-management/SKILL.md +9 -0
- package/skills/usage/SKILL.md +1 -1
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@capgo/cli",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "8.
|
|
4
|
+
"version": "8.107.0",
|
|
5
5
|
"description": "A CLI to upload to capgo servers",
|
|
6
6
|
"author": "Martin martin@capgo.app",
|
|
7
7
|
"license": "Apache 2.0",
|
|
@@ -121,6 +121,7 @@
|
|
|
121
121
|
"test:mcp-credentials-manage": "bun test/test-mcp-credentials-manage.mjs",
|
|
122
122
|
"test:mcp-resume-prompt": "bun test/test-mcp-resume-prompt.mjs",
|
|
123
123
|
"test:mcp-build-job": "bun test/test-mcp-build-job.mjs",
|
|
124
|
+
"test:mcp-build-spawn": "bun test/test-mcp-build-spawn.mjs",
|
|
124
125
|
"test:mcp-build-tools": "bun test/test-mcp-build-tools.mjs",
|
|
125
126
|
"test:app-created-source": "bun test/test-app-created-source.mjs",
|
|
126
127
|
"test:app-add-exists": "bun test/test-app-add-exists.mjs",
|
|
@@ -204,7 +205,7 @@
|
|
|
204
205
|
"test:run": "bun scripts/run-test-suite.ts",
|
|
205
206
|
"test:serial": "bun run build && bun scripts/run-test-suite.ts --serial",
|
|
206
207
|
"test:monitoring": "bun test test/test-monitoring.test.ts",
|
|
207
|
-
"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-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",
|
|
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: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: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",
|
|
208
209
|
"test:build-platform-selection": "bun test/test-build-platform-selection.mjs",
|
|
209
210
|
"test:builder-project-discovery": "bun test/test-builder-project-discovery.mjs",
|
|
210
211
|
"test:builder-app-selection": "bun test/test-builder-app-selection.mjs",
|
|
@@ -258,7 +259,8 @@
|
|
|
258
259
|
"test:build-credentials-units": "bun test/test-credentials-migration.mjs && bun test/test-provisioning-map-validation.mjs && bun test/test-mobileprovision-parser.mjs",
|
|
259
260
|
"test:onboarding-generators": "bun test/test-diff-utils.mjs && bun test/test-workflow-generator.mjs",
|
|
260
261
|
"test:mcp-onboarding": "bun test ./test/build/onboarding/mcp/scoped-credential-path.test.ts && bun test/test-mcp-onboarding.mjs",
|
|
261
|
-
"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"
|
|
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:recommend": "bun test test/recommend-context.test.ts"
|
|
262
264
|
},
|
|
263
265
|
"dependencies": {
|
|
264
266
|
"@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
|
|
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.
|
package/skills/usage/SKILL.md
CHANGED
|
@@ -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`
|