@capgo/cli 8.86.1 → 8.87.1
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 +1 -1
- package/dist/index.js +980 -975
- package/dist/notify-app-ready-worker.js +37 -37
- package/dist/onboarding-worker.js +143 -143
- package/dist/package.json +2 -2
- package/dist/src/app/builder-checklist.d.ts +26 -0
- package/dist/src/app/todo.d.ts +16 -0
- package/dist/src/build/onboarding/command.d.ts +2 -0
- package/dist/src/build/onboarding/ui/app-selection-gate.d.ts +1 -1
- package/dist/src/build/onboarding/ui/shell.d.ts +1 -0
- package/dist/src/init/builder-setup.d.ts +60 -0
- package/dist/src/init/command.d.ts +1 -1
- package/dist/src/sdk.js +191 -191
- package/dist/src/shared/cli-user-error.d.ts +1 -1
- package/dist/updater-installed-worker.js +37 -37
- package/package.json +2 -2
- package/skills/native-builds/SKILL.md +1 -0
- package/skills/usage/SKILL.md +2 -2
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.87.1",
|
|
5
5
|
"description": "A CLI to upload to capgo servers",
|
|
6
6
|
"author": "Martin martin@capgo.app",
|
|
7
7
|
"license": "Apache 2.0",
|
|
@@ -120,7 +120,7 @@
|
|
|
120
120
|
"test:app-add-exists": "bun test/test-app-add-exists.mjs",
|
|
121
121
|
"test:app-add-getting-started": "bun test/test-app-add-getting-started.mjs",
|
|
122
122
|
"test:app-list-output-text": "bun test/test-app-list-output-text.mjs",
|
|
123
|
-
"test:app-todo": "bun test/test-app-todo.mjs",
|
|
123
|
+
"test:app-todo": "bun test/test-app-todo.mjs && bun test/test-builder-only-checklist.mjs && bun test/test-builder-only-setup.mjs",
|
|
124
124
|
"test:doctor-analytics": "bun test/test-doctor-analytics.mjs",
|
|
125
125
|
"test:posthog-exception": "bun test/test-posthog-exception.mjs",
|
|
126
126
|
"test:cli-recovery": "bun test/test-cli-recovery.mjs",
|
|
@@ -41,6 +41,7 @@ Standalone: `build prescan` accepts `--skip` / `--warn`. Full catalog: `webdocs/
|
|
|
41
41
|
- The user creates ONE App Store Connect API key (.p8 file), then the CLI handles everything else.
|
|
42
42
|
- On macOS, offers a native file picker dialog for .p8 selection.
|
|
43
43
|
- Auto-detects Key ID from .p8 filename (e.g. `AuthKey_XXXX.p8`).
|
|
44
|
+
- For apps assigned only the supported Builder checklist, the saved platform is used when `--platform` is omitted; an explicit platform takes precedence. Generic `init` also hands these apps to this wizard. `app todo` shows both platforms independently, including backend-reported build failures. Finishing credential setup or requesting a build does not complete the checklist; Capgo must report a successful cloud build. OTA-only and dual-assigned apps retain their existing behavior.
|
|
44
45
|
- Progress persists in `~/.capgo-credentials/onboarding/<appId>.json` — safe to interrupt and resume.
|
|
45
46
|
- Saves credentials to the same `~/.capgo-credentials/credentials.json` used by `build request`.
|
|
46
47
|
- Optionally kicks off the first build at the end.
|
package/skills/usage/SKILL.md
CHANGED
|
@@ -33,7 +33,7 @@ TanStack Intent skills should stay focused and under the validator line limit, s
|
|
|
33
33
|
|
|
34
34
|
### Project setup and diagnostics
|
|
35
35
|
|
|
36
|
-
- `init [apikey] [appId]`: guided first-time setup for Capgo in a Capacitor app. The interactive flow now runs as a real Ink-based fullscreen onboarding so it uses the same UI stack as `build init` (alias: `build onboarding`), with a persistent dashboard, phase roadmap, progress cards, shared log area, and resume support. At startup, onboarding still recommends a clean git worktree before file edits; dirty repos show `Check again` first and also offer a non-recommended `Continue anyway` override. When dependency auto-detection fails on macOS, the flow opens a native file picker for `package.json` before falling back to manual path entry. If the onboarding bundle upload fails, recovery can retry immediately or ask for the monorepo/workspace root `package.json` and hoisted `node_modules` paths (not the app package folder) and then retry. If the local bundle ID already exists in the selected Capgo account, onboarding offers to reuse that app, then offers to delete and recreate it, then falls back to alternate bundle ID suggestions. If the user reuses a pending app that was already created in the web onboarding flow, the CLI syncs that selected dashboard app ID back into `capacitor.config.*` before the remaining steps continue. Outside that reused pending-app path, the CLI keeps using the local Capacitor app ID. It writes the new `autoUpdate` policy modes into config: `"atBackground"` for the default flow and `"always"` for instant updates. It can also offer a final `npx skills add https://github.com/Cap-go/capgo-skills -g -y` install step before the GitHub support prompt; if accepted, the support menu includes `Cap-go/capgo-skills` alongside the updater-only and all-Capgo choices. If native platforms are missing, the onboarding can offer to run `cap add` for you. The updater step now verifies that `@capgo/capacitor-updater` is both declared in the selected `package.json` and resolvable from `node_modules`; if automatic install or later build/sync fails, onboarding prints the manual command, waits for the user to type `ready`, re-checks, and only then continues. If the user enables instant updates, onboarding requires `@capacitor/splash-screen` for `autoSplashscreen`, offers to install it with the same auto-install/retry flow, and waits until it is declared and resolvable before writing config. During the iOS run-on-device step, onboarding asks whether to use a physical iPhone/iPad or a simulator; for physical devices, it asks the user to connect and unlock the device, then offers a check-again loop before launching with the detected target. If iOS sync validation fails during onboarding, the CLI can offer to run a one-line native reset command, wait for you to type `ready` after a manual fix, surface `doctor`, and save a support bundle before you leave the flow.
|
|
36
|
+
- `init [apikey] [appId]`: when the app has a supported Builder-only checklist assigned by Capgo, continues with `build init` and its existing credential/resume flow before OTA setup. OTA-only and dual-assigned apps retain the existing setup flow. For other assignments, provides guided first-time setup for Capgo in a Capacitor app. The interactive flow now runs as a real Ink-based fullscreen onboarding so it uses the same UI stack as `build init` (alias: `build onboarding`), with a persistent dashboard, phase roadmap, progress cards, shared log area, and resume support. At startup, onboarding still recommends a clean git worktree before file edits; dirty repos show `Check again` first and also offer a non-recommended `Continue anyway` override. When dependency auto-detection fails on macOS, the flow opens a native file picker for `package.json` before falling back to manual path entry. If the onboarding bundle upload fails, recovery can retry immediately or ask for the monorepo/workspace root `package.json` and hoisted `node_modules` paths (not the app package folder) and then retry. If the local bundle ID already exists in the selected Capgo account, onboarding offers to reuse that app, then offers to delete and recreate it, then falls back to alternate bundle ID suggestions. If the user reuses a pending app that was already created in the web onboarding flow, the CLI syncs that selected dashboard app ID back into `capacitor.config.*` before the remaining steps continue. Outside that reused pending-app path, the CLI keeps using the local Capacitor app ID. It writes the new `autoUpdate` policy modes into config: `"atBackground"` for the default flow and `"always"` for instant updates. It can also offer a final `npx skills add https://github.com/Cap-go/capgo-skills -g -y` install step before the GitHub support prompt; if accepted, the support menu includes `Cap-go/capgo-skills` alongside the updater-only and all-Capgo choices. If native platforms are missing, the onboarding can offer to run `cap add` for you. The updater step now verifies that `@capgo/capacitor-updater` is both declared in the selected `package.json` and resolvable from `node_modules`; if automatic install or later build/sync fails, onboarding prints the manual command, waits for the user to type `ready`, re-checks, and only then continues. If the user enables instant updates, onboarding requires `@capacitor/splash-screen` for `autoSplashscreen`, offers to install it with the same auto-install/retry flow, and waits until it is declared and resolvable before writing config. During the iOS run-on-device step, onboarding asks whether to use a physical iPhone/iPad or a simulator; for physical devices, it asks the user to connect and unlock the device, then offers a check-again loop before launching with the detected target. If iOS sync validation fails during onboarding, the CLI can offer to run a one-line native reset command, wait for you to type `ready` after a manual fix, surface `doctor`, and save a support bundle before you leave the flow.
|
|
37
37
|
- `init --no-analytics`: disables init onboarding analytics and terminal replay for that run.
|
|
38
38
|
- When `init` finds an existing app channel, it asks **Yes, use it** or **No, create a new one** before creating anything. It prefers the saved/production channel, then a default download channel, then another existing channel. Reusing continues onboarding with that channel; declining lets the user choose a new name.
|
|
39
39
|
- `run device [platform]`: run a Capacitor app on a connected device or simulator. In an interactive terminal, omitting `[platform]` asks whether to start on iOS or Android. The command lists available devices and simulators, includes a reload option, and resolves the `cap run` command. Use `npx @capgo/cli@latest run device ios --no-launch` to exercise iOS physical/simulator target selection and print the resolved command without launching the app.
|
|
@@ -47,7 +47,7 @@ TanStack Intent skills should stay focused and under the validator line limit, s
|
|
|
47
47
|
- `app add [appId]`: create an app in Capgo Cloud.
|
|
48
48
|
- `app list`: list apps under the current account. Pass `--filter-by-org-id <orgId>` to list only apps from one organization, `--show-org` to include organization names, and `--show-org-id` to include organization IDs. The CLI warns that the filter can hide other accessible apps. Use `npx @capgo/cli@latest app list --output-text` for plain status text with an embedded CSV app table and no interactive terminal formatting.
|
|
49
49
|
- `app delete [appId]`: remove an app.
|
|
50
|
-
- `app todo [appId]` (alias: `app todoList`): show the versioned onboarding checklist with done, skipped, and pending tasks, using the same live progress checks as the dashboard. Supports legacy v3 flat steps and v4 OTA steps under `setup.steps.ota` when `setup.ota_todo_list_version` is the string `"1"`. Skipped tasks count toward completed progress. Live checks can refresh saved OTA milestones; a warning means saved progress is shown for checks that failed. Requires `app.read`; additional checks depend on the key's read permissions. Omit the app ID to infer it from the current Capacitor project. Example: `npx @capgo/cli@latest app todo com.example.app`. Supports `-a, --apikey`, `--supa-host`, and `--supa-anon`.
|
|
50
|
+
- `app todo [appId]` (alias: `app todoList`): show the versioned onboarding checklist with done, skipped, and pending tasks, using the same live progress checks as the dashboard. Supports legacy v3 flat steps and v4 OTA steps under `setup.steps.ota` when `setup.ota_todo_list_version` is the string `"1"`. For a supported Builder-only V4 assignment, shows independent 🍎 iOS and 🤖 Android tasks, saved selection, timestamps, plain-language explanations of setup choices labeled `Note:` with each sentence on its own indented line, and actionable `Warning:` messages. Interactive terminals use colored headings and status markers; piped output and `NO_COLOR` stay plain. Use `npx @capgo/cli@latest build init` to resume; only a backend-reported successful cloud build completes the final task. OTA-only and dual-assigned apps retain the OTA checklist. Skipped tasks count toward completed progress. Live checks can refresh saved OTA milestones; a warning means saved progress is shown for checks that failed. Requires `app.read`; additional checks depend on the key's read permissions. Omit the app ID to infer it from the current Capacitor project. Example: `npx @capgo/cli@latest app todo com.example.app`. Supports `-a, --apikey`, `--supa-host`, and `--supa-anon`.
|
|
51
51
|
- `app set [appId]`: update app settings such as name, icon, retention, metadata exposure, preview access with `--preview` or `--no-preview`, and optional device data collection with `--collect-country` / `--no-collect-country` (same pattern for platform, os-version, plugin-version, version-build, is-emulator, is-prod, install-source). Unchecked fields are not stored; `/updates` still uses the live request.
|
|
52
52
|
- `app setting [path]`: update Capacitor config values programmatically.
|
|
53
53
|
- `app debug [appId]`: listen for live-update debug events, optionally for one device.
|