@capgo/cli 8.46.0 → 8.47.0

package/dist/src/types/supabase.types.d.ts

@@ -5608,6 +5608,12 @@ export type Database = {
                 };
                 Returns: boolean;
             };
+            verify_getting_started: {
+                Args: {
+                    p_app_id: string;
+                };
+                Returns: Json;
+            };
             verify_mfa: {
                 Args: never;
                 Returns: boolean;
@@ -5621,7 +5627,7 @@ export type Database = {
             cron_task_type: "function" | "queue" | "function_queue";
             disable_update: "major" | "minor" | "patch" | "version_number" | "none";
             platform_os: "ios" | "android" | "electron";
-            stats_action: "delete" | "reset" | "set" | "get" | "set_fail" | "update_fail" | "download_fail" | "windows_path_fail" | "canonical_path_fail" | "directory_path_fail" | "unzip_fail" | "low_mem_fail" | "download_10" | "download_20" | "download_30" | "download_40" | "download_50" | "download_60" | "download_70" | "download_80" | "download_90" | "download_complete" | "decrypt_fail" | "app_moved_to_foreground" | "app_moved_to_background" | "uninstall" | "needPlanUpgrade" | "missingBundle" | "noNew" | "disablePlatformIos" | "disablePlatformAndroid" | "disableAutoUpdateToMajor" | "cannotUpdateViaPrivateChannel" | "disableAutoUpdateToMinor" | "disableAutoUpdateToPatch" | "channelMisconfigured" | "disableAutoUpdateMetadata" | "disableAutoUpdateUnderNative" | "disableDevBuild" | "disableEmulator" | "cannotGetBundle" | "checksum_fail" | "NoChannelOrOverride" | "setChannel" | "getChannel" | "rateLimited" | "disableAutoUpdate" | "keyMismatch" | "ping" | "InvalidIp" | "blocked_by_server_url" | "download_manifest_start" | "download_manifest_complete" | "download_zip_start" | "download_zip_complete" | "download_manifest_file_fail" | "download_manifest_checksum_fail" | "download_manifest_brotli_fail" | "backend_refusal" | "download_0" | "disableProdBuild" | "disableDevice" | "disablePlatformElectron" | "customIdBlocked" | "app_crash" | "app_crash_native" | "app_anr" | "app_killed_low_memory" | "app_killed_excessive_resource_usage" | "app_initialization_failure" | "app_memory_warning" | "webview_javascript_error" | "webview_unhandled_rejection" | "webview_resource_error" | "webview_security_policy_violation" | "webview_unclean_restart" | "webview_render_process_gone" | "webview_content_process_terminated" | "os_version_changed" | "native_app_version_changed";
+            stats_action: "delete" | "reset" | "set" | "get" | "set_fail" | "update_fail" | "download_fail" | "windows_path_fail" | "canonical_path_fail" | "directory_path_fail" | "unzip_fail" | "low_mem_fail" | "download_10" | "download_20" | "download_30" | "download_40" | "download_50" | "download_60" | "download_70" | "download_80" | "download_90" | "download_complete" | "decrypt_fail" | "app_moved_to_foreground" | "app_moved_to_background" | "uninstall" | "needPlanUpgrade" | "missingBundle" | "noNew" | "disablePlatformIos" | "disablePlatformAndroid" | "disableAutoUpdateToMajor" | "cannotUpdateViaPrivateChannel" | "disableAutoUpdateToMinor" | "disableAutoUpdateToPatch" | "channelMisconfigured" | "disableAutoUpdateMetadata" | "disableAutoUpdateUnderNative" | "disableDevBuild" | "disableEmulator" | "cannotGetBundle" | "checksum_fail" | "NoChannelOrOverride" | "setChannel" | "getChannel" | "rateLimited" | "disableAutoUpdate" | "keyMismatch" | "ping" | "InvalidIp" | "blocked_by_server_url" | "download_manifest_start" | "download_manifest_complete" | "download_zip_start" | "download_zip_complete" | "download_manifest_file_fail" | "download_manifest_checksum_fail" | "download_manifest_brotli_fail" | "backend_refusal" | "download_0" | "disableProdBuild" | "disableDevice" | "disablePlatformElectron" | "customIdBlocked" | "app_crash" | "app_crash_native" | "app_anr" | "app_killed_low_memory" | "app_killed_excessive_resource_usage" | "app_initialization_failure" | "app_memory_warning" | "webview_javascript_error" | "webview_unhandled_rejection" | "webview_resource_error" | "webview_security_policy_violation" | "webview_unclean_restart" | "webview_render_process_gone" | "webview_content_process_terminated" | "os_version_changed" | "native_app_version_changed" | "app_nav";
             stripe_status: "created" | "succeeded" | "updated" | "failed" | "deleted" | "canceled";
             user_role: "read" | "upload" | "write" | "admin";
             version_action: "get" | "fail" | "install" | "uninstall";
@@ -5722,7 +5728,7 @@ export declare const Constants: {
             readonly cron_task_type: readonly ["function", "queue", "function_queue"];
             readonly disable_update: readonly ["major", "minor", "patch", "version_number", "none"];
             readonly platform_os: readonly ["ios", "android", "electron"];
-            readonly stats_action: readonly ["delete", "reset", "set", "get", "set_fail", "update_fail", "download_fail", "windows_path_fail", "canonical_path_fail", "directory_path_fail", "unzip_fail", "low_mem_fail", "download_10", "download_20", "download_30", "download_40", "download_50", "download_60", "download_70", "download_80", "download_90", "download_complete", "decrypt_fail", "app_moved_to_foreground", "app_moved_to_background", "uninstall", "needPlanUpgrade", "missingBundle", "noNew", "disablePlatformIos", "disablePlatformAndroid", "disableAutoUpdateToMajor", "cannotUpdateViaPrivateChannel", "disableAutoUpdateToMinor", "disableAutoUpdateToPatch", "channelMisconfigured", "disableAutoUpdateMetadata", "disableAutoUpdateUnderNative", "disableDevBuild", "disableEmulator", "cannotGetBundle", "checksum_fail", "NoChannelOrOverride", "setChannel", "getChannel", "rateLimited", "disableAutoUpdate", "keyMismatch", "ping", "InvalidIp", "blocked_by_server_url", "download_manifest_start", "download_manifest_complete", "download_zip_start", "download_zip_complete", "download_manifest_file_fail", "download_manifest_checksum_fail", "download_manifest_brotli_fail", "backend_refusal", "download_0", "disableProdBuild", "disableDevice", "disablePlatformElectron", "customIdBlocked", "app_crash", "app_crash_native", "app_anr", "app_killed_low_memory", "app_killed_excessive_resource_usage", "app_initialization_failure", "app_memory_warning", "webview_javascript_error", "webview_unhandled_rejection", "webview_resource_error", "webview_security_policy_violation", "webview_unclean_restart", "webview_render_process_gone", "webview_content_process_terminated", "os_version_changed", "native_app_version_changed"];
+            readonly stats_action: readonly ["delete", "reset", "set", "get", "set_fail", "update_fail", "download_fail", "windows_path_fail", "canonical_path_fail", "directory_path_fail", "unzip_fail", "low_mem_fail", "download_10", "download_20", "download_30", "download_40", "download_50", "download_60", "download_70", "download_80", "download_90", "download_complete", "decrypt_fail", "app_moved_to_foreground", "app_moved_to_background", "uninstall", "needPlanUpgrade", "missingBundle", "noNew", "disablePlatformIos", "disablePlatformAndroid", "disableAutoUpdateToMajor", "cannotUpdateViaPrivateChannel", "disableAutoUpdateToMinor", "disableAutoUpdateToPatch", "channelMisconfigured", "disableAutoUpdateMetadata", "disableAutoUpdateUnderNative", "disableDevBuild", "disableEmulator", "cannotGetBundle", "checksum_fail", "NoChannelOrOverride", "setChannel", "getChannel", "rateLimited", "disableAutoUpdate", "keyMismatch", "ping", "InvalidIp", "blocked_by_server_url", "download_manifest_start", "download_manifest_complete", "download_zip_start", "download_zip_complete", "download_manifest_file_fail", "download_manifest_checksum_fail", "download_manifest_brotli_fail", "backend_refusal", "download_0", "disableProdBuild", "disableDevice", "disablePlatformElectron", "customIdBlocked", "app_crash", "app_crash_native", "app_anr", "app_killed_low_memory", "app_killed_excessive_resource_usage", "app_initialization_failure", "app_memory_warning", "webview_javascript_error", "webview_unhandled_rejection", "webview_resource_error", "webview_security_policy_violation", "webview_unclean_restart", "webview_render_process_gone", "webview_content_process_terminated", "os_version_changed", "native_app_version_changed", "app_nav"];
             readonly stripe_status: readonly ["created", "succeeded", "updated", "failed", "deleted", "canceled"];
             readonly user_role: readonly ["read", "upload", "write", "admin"];
             readonly version_action: readonly ["get", "fail", "install", "uninstall"];

package/dist/src/utils.d.ts

@@ -5667,6 +5667,12 @@ export declare function createSupabaseClient(apikey: string, supaHost?: string,
             };
             Returns: boolean;
         };
+        verify_getting_started: {
+            Args: {
+                p_app_id: string;
+            };
+            Returns: import("./types/supabase.types").Json;
+        };
         verify_mfa: {
             Args: never;
             Returns: boolean;
@@ -5680,7 +5686,7 @@ export declare function createSupabaseClient(apikey: string, supaHost?: string,
         cron_task_type: "function" | "queue" | "function_queue";
         disable_update: "major" | "minor" | "patch" | "version_number" | "none";
         platform_os: "ios" | "android" | "electron";
-        stats_action: "delete" | "reset" | "set" | "get" | "set_fail" | "update_fail" | "download_fail" | "windows_path_fail" | "canonical_path_fail" | "directory_path_fail" | "unzip_fail" | "low_mem_fail" | "download_10" | "download_20" | "download_30" | "download_40" | "download_50" | "download_60" | "download_70" | "download_80" | "download_90" | "download_complete" | "decrypt_fail" | "app_moved_to_foreground" | "app_moved_to_background" | "uninstall" | "needPlanUpgrade" | "missingBundle" | "noNew" | "disablePlatformIos" | "disablePlatformAndroid" | "disableAutoUpdateToMajor" | "cannotUpdateViaPrivateChannel" | "disableAutoUpdateToMinor" | "disableAutoUpdateToPatch" | "channelMisconfigured" | "disableAutoUpdateMetadata" | "disableAutoUpdateUnderNative" | "disableDevBuild" | "disableEmulator" | "cannotGetBundle" | "checksum_fail" | "NoChannelOrOverride" | "setChannel" | "getChannel" | "rateLimited" | "disableAutoUpdate" | "keyMismatch" | "ping" | "InvalidIp" | "blocked_by_server_url" | "download_manifest_start" | "download_manifest_complete" | "download_zip_start" | "download_zip_complete" | "download_manifest_file_fail" | "download_manifest_checksum_fail" | "download_manifest_brotli_fail" | "backend_refusal" | "download_0" | "disableProdBuild" | "disableDevice" | "disablePlatformElectron" | "customIdBlocked" | "app_crash" | "app_crash_native" | "app_anr" | "app_killed_low_memory" | "app_killed_excessive_resource_usage" | "app_initialization_failure" | "app_memory_warning" | "webview_javascript_error" | "webview_unhandled_rejection" | "webview_resource_error" | "webview_security_policy_violation" | "webview_unclean_restart" | "webview_render_process_gone" | "webview_content_process_terminated" | "os_version_changed" | "native_app_version_changed";
+        stats_action: "delete" | "reset" | "set" | "get" | "set_fail" | "update_fail" | "download_fail" | "windows_path_fail" | "canonical_path_fail" | "directory_path_fail" | "unzip_fail" | "low_mem_fail" | "download_10" | "download_20" | "download_30" | "download_40" | "download_50" | "download_60" | "download_70" | "download_80" | "download_90" | "download_complete" | "decrypt_fail" | "app_moved_to_foreground" | "app_moved_to_background" | "uninstall" | "needPlanUpgrade" | "missingBundle" | "noNew" | "disablePlatformIos" | "disablePlatformAndroid" | "disableAutoUpdateToMajor" | "cannotUpdateViaPrivateChannel" | "disableAutoUpdateToMinor" | "disableAutoUpdateToPatch" | "channelMisconfigured" | "disableAutoUpdateMetadata" | "disableAutoUpdateUnderNative" | "disableDevBuild" | "disableEmulator" | "cannotGetBundle" | "checksum_fail" | "NoChannelOrOverride" | "setChannel" | "getChannel" | "rateLimited" | "disableAutoUpdate" | "keyMismatch" | "ping" | "InvalidIp" | "blocked_by_server_url" | "download_manifest_start" | "download_manifest_complete" | "download_zip_start" | "download_zip_complete" | "download_manifest_file_fail" | "download_manifest_checksum_fail" | "download_manifest_brotli_fail" | "backend_refusal" | "download_0" | "disableProdBuild" | "disableDevice" | "disablePlatformElectron" | "customIdBlocked" | "app_crash" | "app_crash_native" | "app_anr" | "app_killed_low_memory" | "app_killed_excessive_resource_usage" | "app_initialization_failure" | "app_memory_warning" | "webview_javascript_error" | "webview_unhandled_rejection" | "webview_resource_error" | "webview_security_policy_violation" | "webview_unclean_restart" | "webview_render_process_gone" | "webview_content_process_terminated" | "os_version_changed" | "native_app_version_changed" | "app_nav";
         stripe_status: "created" | "succeeded" | "updated" | "failed" | "deleted" | "canceled";
         user_role: "read" | "upload" | "write" | "admin";
         version_action: "get" | "fail" | "install" | "uninstall";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@capgo/cli",
   "type": "module",
-  "version": "8.46.0",
+  "version": "8.47.0",
   "description": "A CLI to upload to capgo servers",
   "author": "Martin martin@capgo.app",
   "license": "Apache 2.0",

package/skills/_artifacts/domain_map.yaml

@@ -11,6 +11,11 @@ domains:
       - webdocs/star.mdx
       - webdocs/star-all.mdx
       - src/index.ts
+  - name: observe
+    summary: Query Observe findings, launch and WebView timings, device timelines, and per-screen routes from the CLI and MCP.
+    primary_sources:
+      - webdocs/observe.mdx
+      - src/index.ts
   - name: ota-release-management
     summary: OTA bundle uploads, channel operations, preview QR codes, compatibility checks, cleanup, and encryption-key workflows.
     primary_sources:

package/skills/_artifacts/skill_spec.md

@@ -2,7 +2,7 @@
 
 ## Goal
 
-Provide a small Capgo CLI skill set that helps an agent choose and invoke the correct CLI commands for app setup, OTA release operations, organization administration, MCP setup, GitHub support commands, and native cloud builds without exceeding TanStack Intent size limits.
+Provide a small Capgo CLI skill set that helps an agent choose and invoke the correct CLI commands for app setup, OTA release operations, organization administration, MCP setup, GitHub support commands, Observe queries, and native cloud builds without exceeding TanStack Intent size limits.
 
 ## Sources
 
@@ -13,6 +13,7 @@ Provide a small Capgo CLI skill set that helps an agent choose and invoke the co
 ## Skill set
 
 - `usage`: routing, setup, diagnostics, app commands, docs generation, MCP, and GitHub support commands.
+- `observe`: Observe query commands and MCP (`summary`, `metrics`, `events`, `device`, `versions`, `routes`).
 - `release-management`: bundle, channel, compatibility, cleanup, and encryption-key workflows.
 - `native-builds`: native cloud build requests and build credential storage/update flows.
 - `organization-management`: account ID lookup, organization admin flows, and deprecated `organisation` aliases.

package/skills/_artifacts/skill_tree.yaml

@@ -3,6 +3,10 @@ skills:
     path: skills/usage/SKILL.md
     domain: cli-usage
     focus: High-level routing and shared invocation rules.
+  - name: observe
+    path: skills/observe/SKILL.md
+    domain: observe
+    focus: Query Observe findings, metrics, device timelines, and navigation routes.
   - name: release-management
     path: skills/release-management/SKILL.md
     domain: ota-release-management

package/skills/observe/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: observe
+description: Use when querying Capgo Observe metrics, launch timings, crashes, WebView loads, device timelines, or per-screen navigation from the CLI, SDK, or MCP.
+---
+
+# Capgo Observe
+
+Query existing Observe stats so agents and scripts can act on the data. Dashboards stay visual; this surface is for `findings` plus a next query.
+
+Capgo has no session id. Treat `device_id` + time window as the session. Start with `summary` and follow `findings[].next`.
+
+Navigation does not need Expo Router. Listen to `history.pushState`, `history.replaceState`, `popstate`, `hashchange`, and Capacitor App `appUrlOpen`, then send stats action `app_nav` with `metadata.route` (or `path`) and optional `duration_ms`.
+
+## CLI
+
+```bash
+npx @capgo/cli@latest observe summary
+npx @capgo/cli@latest observe metrics --action app_launch_ready --sort slowest --json
+npx @capgo/cli@latest observe events --action app_crash_native
+npx @capgo/cli@latest observe device DEVICE_ID --json
+npx @capgo/cli@latest observe versions
+npx @capgo/cli@latest observe routes --json
+```
+
+Shared flags: `-a, --apikey`, `--days` (`1`, `3`, `7`, `30`), `--action`, `--sort`, `--limit`, `--version-name`, `--json`.
+
+## MCP
+
+Call `capgo_observe` with `view=summary` first. Follow `findings[].next`. Use `view=device` and `deviceId` for the timeline.
+
+## Views
+
+- `summary`: findings, handoff prompt, overview
+- `metrics`: timed samples (launch, WebView, `app_nav`)
+- `events`: action counts and latest devices
+- `device`: ordered timeline for one `device_id`
+- `versions`: per-bundle launch/issue breakdown
+- `routes`: grouped by `metadata.route` / `path` / `url`

package/skills/usage/SKILL.md

@@ -10,6 +10,7 @@ Use this skill as the entry point for the Capgo CLI skill set.
 TanStack Intent skills should stay focused and under the validator line limit, so the Capgo CLI guidance is split into multiple skills:
 
 - `usage`: high-level command routing, shared invocation rules, and quick command selection.
+- `observe`: Observe query commands and MCP (`summary`, `metrics`, `events`, `device`, `versions`, `routes`).
 - `release-management`: OTA bundle, channel, and encryption-key workflows.
 - `native-builds`: native cloud build request and build-credential workflows.
 - `organization-management`: organization, account, and deprecated organisation-alias workflows.
@@ -31,6 +32,7 @@ TanStack Intent skills should stay focused and under the validator line limit, s
 - `login [apikey]`: store an API key locally.
 - `doctor`: inspect installation health and gather troubleshooting details.
 - `probe`: test whether the update endpoint would deliver an update.
+- `observe summary|metrics|events|device|versions|routes`: query Observe findings, timings, device timelines, and per-screen routes. Start with `observe summary`. Use `observe device DEVICE_ID` as the session timeline. Navigation uses `app_nav` + `metadata.route` (history/popstate/hashchange/appUrlOpen, no Expo Router). Pass `--json` for agents.
 
 ### App-level operations
 
@@ -43,7 +45,7 @@ TanStack Intent skills should stay focused and under the validator line limit, s
 
 ### Docs and agent integrations
 
-- `mcp`: start the Capgo MCP server for AI-agent integrations; pass `--capacitor-config <path>` when its config-writing tools should target an app-specific source.
+- `mcp`: start the Capgo MCP server for AI-agent integrations; pass `--capacitor-config <path>` when its config-writing tools should target an app-specific source. Observe queries use `capgo_observe` (start at `view=summary`).
 
 ### GitHub support commands
 
@@ -52,6 +54,13 @@ TanStack Intent skills should stay focused and under the validator line limit, s
 
 ## Related skills
 
+### `observe`
+
+Load `skills/observe/SKILL.md` when working with:
+
+- `observe summary`, `observe metrics`, `observe events`, `observe device`, `observe versions`, `observe routes`
+- MCP `capgo_observe`
+
 ### `release-management`
 
 Load `skills/release-management/SKILL.md` when working with: