@capgo/cli 8.35.0 → 8.37.0

package/dist/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@capgo/cli",
   "type": "module",
-  "version": "8.35.0",
+  "version": "8.37.0",
   "description": "A CLI to upload to capgo servers",
   "author": "Martin martin@capgo.app",
   "license": "Apache 2.0",
@@ -114,6 +114,7 @@
     "test:wait-log": "bun test/test-wait-log.mjs",
     "test:init-guardrails": "bun test/test-init-guardrails.mjs",
     "test:init-replay": "bun test/test-init-replay.mjs",
+    "test:init-telemetry": "bun test/test-init-telemetry.mjs",
     "test:capacitor-config-target": "bun test/test-capacitor-config-target.mjs",
     "test:init-monorepo-targeting": "bun run test:capacitor-config-target && bun test/test-init-monorepo-targeting.mjs",
     "test:prompt-preferences": "bun test/test-prompt-preferences.mjs",
@@ -162,7 +163,7 @@
     "test:ios-marketing-version": "bun test/test-ios-marketing-version.mjs",
     "test:platform-flow-contract": "bun test/test-platform-flow-contract.mjs",
     "test:tail-engine-shared": "bun test/test-tail-engine-shared.mjs",
-    "test": "bun run build && bun run test:helper-dce && bun run test:version-detection:setup && bun run test:bundle && 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:fail-on-incompatible && bun run test:native-dependencies && bun run test:package-json-guard && 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:app-set-options && bun run test:mcp-analytics && bun run test:mcp-instructions && bun run test:mcp-live-update-onboarding && bun run test:mcp-stdout-guard && 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: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-monorepo-targeting && bun run test:init-app-conflict && bun run test:wait-log && bun run test:init-guardrails && bun run test:init-replay && 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:manifest-path-encoding && 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:ai-analyze-stream && bun run test:support-mailto && bun run test:support-redact && bun run test:support-internal-log && bun run test:support-help-menu && bun run test:support-contact && bun run test:support-upload-prompt && bun run test:support-bundle-files && 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:frame-fit-ios-shared && bun run test:ios-confirm-app-id && bun run test:ios-create-new && bun run test:ios-e2e && bun run test:ios-flow-contract && 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:platform-flow-contract && bun run test:tail-engine-shared && bun run test:prescan && bun run test:android-reporting-api && 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:organization-set-api-host && bun run test:trial-warning && bun run test:plan-validation",
+    "test": "bun run build && bun run test:helper-dce && bun run test:version-detection:setup && bun run test:bundle && 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:fail-on-incompatible && bun run test:native-dependencies && bun run test:package-json-guard && 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:app-set-options && bun run test:mcp-analytics && bun run test:mcp-instructions && bun run test:mcp-live-update-onboarding && bun run test:mcp-stdout-guard && 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: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-monorepo-targeting && bun run test:init-app-conflict && bun run test:wait-log && bun run test:init-guardrails && bun run test:init-replay && bun run test:init-telemetry && 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:manifest-path-encoding && 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:ai-analyze-stream && bun run test:support-mailto && bun run test:support-redact && bun run test:support-internal-log && bun run test:support-help-menu && bun run test:support-contact && bun run test:support-upload-prompt && bun run test:support-bundle-files && 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:frame-fit-ios-shared && bun run test:ios-confirm-app-id && bun run test:ios-create-new && bun run test:ios-e2e && bun run test:ios-flow-contract && 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:platform-flow-contract && bun run test:tail-engine-shared && bun run test:prescan && bun run test:android-reporting-api && 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:organization-set-api-host && bun run test:trial-warning && bun run test:plan-validation",
     "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/dist/src/api/app.d.ts

@@ -18,6 +18,18 @@ export declare function completePendingOnboardingApp(_supabase: SupabaseClient<D
     supaHost?: string;
     supaAnon?: string;
 }): Promise<void>;
+export interface AppOnboardingProgressPatch {
+    source?: 'manual' | 'cli' | 'mcp' | 'ai';
+    outcome?: 'in_progress' | 'completed' | 'skipped' | 'switched_to_manual';
+    steps?: Record<string, {
+        status: 'done' | 'skipped';
+        at?: string;
+    }>;
+}
+export declare function reportAppOnboardingProgress(apikey: string, appId: string, onboarding: AppOnboardingProgressPatch, options?: {
+    supaHost?: string;
+    supaAnon?: string;
+}): Promise<void>;
 /**
  * Check multiple app IDs at once for batch validation (e.g., for suggestions)
  */

package/dist/src/init/mcp/engine.d.ts

@@ -62,6 +62,7 @@ export interface EngineDeps {
         cwd?: string;
     };
     getGitStatus: (cwd?: string) => GitRepoStatus;
+    reportOnboardingStep?: (appId: string, stepDone: number) => void;
 }
 export interface LiveUpdateFacts {
     capacitorProject: boolean;

package/dist/src/init/onboarding-report.d.ts

@@ -0,0 +1,13 @@
+import type { InitOnboardingStepId } from './onboarding-steps';
+export declare function reportInitOnboardingStep(apikey: string, appId: string | undefined, stepNumber: number, status?: 'done' | 'skipped', options?: {
+    supaHost?: string;
+    supaAnon?: string;
+    outcome?: 'completed' | 'skipped' | 'in_progress';
+}): Promise<void>;
+export declare function reportInitOnboarding(apikey: string, appId: string, steps: Partial<Record<InitOnboardingStepId, {
+    status: 'done' | 'skipped';
+}>>, options?: {
+    supaHost?: string;
+    supaAnon?: string;
+    outcome?: 'completed' | 'skipped' | 'in_progress' | 'switched_to_manual';
+}): Promise<void>;

package/dist/src/init/onboarding-source.d.ts

@@ -0,0 +1,3 @@
+export type ReportedOnboardingSource = 'cli' | 'mcp' | 'ai';
+export declare function detectOnboardingSource(): ReportedOnboardingSource;
+export declare function isAiAgentEnvironment(environment?: NodeJS.ProcessEnv): boolean;

package/dist/src/init/onboarding-steps.d.ts

@@ -0,0 +1,9 @@
+export declare const INIT_ONBOARDING_STEP_IDS: readonly ["add_app", "add_channel", "add_updater", "add_code", "add_encryption", "select_platform", "build_project", "run_device", "add_code_change", "upload_bundle", "test_update", "completion"];
+export type InitOnboardingStepId = typeof INIT_ONBOARDING_STEP_IDS[number];
+export interface InitOnboardingStepDefinition {
+    id: InitOnboardingStepId;
+    title: string;
+    summary: string;
+    phase: string;
+}
+export declare const initOnboardingSteps: InitOnboardingStepDefinition[];

package/dist/src/init/telemetry.d.ts

@@ -0,0 +1,36 @@
+type TelemetryValue = string | number | boolean;
+type TelemetryProperties = Record<string, TelemetryValue>;
+export interface InitProgressTelemetry {
+    journey_id: string;
+    last_run_id?: string;
+}
+export interface InitTelemetryOptions {
+    capture?: (event: string, properties: TelemetryProperties, icon: string, appId?: string) => Promise<void> | void;
+    enabled?: boolean;
+    replaySessionId?: () => string | undefined;
+}
+export declare function parseInitProgressTelemetry(progress: unknown): InitProgressTelemetry | undefined;
+export declare function mergeInitProgressTelemetry<T extends Record<string, unknown>>(progress: T, telemetry?: InitProgressTelemetry): T | (T & {
+    telemetry: InitProgressTelemetry;
+});
+export declare function createInitTelemetry(options?: InitTelemetryOptions): {
+    readonly journeyId: string;
+    readonly runId: string;
+    clearScope(): void;
+    getLegacyBackfillMetadata: () => {
+        journey_id: string;
+    } | undefined;
+    getProgressMetadata: () => InitProgressTelemetry | undefined;
+    prepareResumeCandidate: (saved?: InitProgressTelemetry, savedStep?: number, totalSteps?: number) => {
+        last_run_id?: string | undefined;
+        journey_id: string;
+    } | undefined;
+    recordMilestone: (event: string, extra?: TelemetryProperties, icon?: string, eventAppId?: string | null) => Promise<void>;
+    recordResumeDecision: (nextChoice: "continue" | "restart") => Promise<void>;
+    recordResumePromptViewed: () => Promise<void>;
+    recordRunEnded: (outcome: "completed" | "cancelled" | "failed", exitCode: number) => Promise<void>;
+    recordRunStarted: () => Promise<void>;
+    setAuth: (orgId: string, apikey: string) => void;
+    setScope: (nextAppId?: string) => void;
+};
+export {};

package/dist/src/init/ui.d.ts

@@ -1,9 +1,5 @@
-export interface InitOnboardingStepDefinition {
-    title: string;
-    summary: string;
-    phase: string;
-}
-export declare const initOnboardingSteps: InitOnboardingStepDefinition[];
+import { initOnboardingSteps } from './onboarding-steps';
+export { initOnboardingSteps };
 export declare function renderInitOnboardingWelcome(totalSteps: number, analyticsEnabled?: boolean): void;
 export declare function renderInitOnboardingFrame(currentStepNumber: number, totalSteps: number, options?: {
     resumed?: boolean;

package/dist/src/schemas/build.d.ts

@@ -72,8 +72,8 @@ export declare const buildRequestOptionsSchema: z.ZodObject<{
         production: "production";
     }>>;
     androidReleaseStatus: z.ZodOptional<z.ZodEnum<{
-        draft: "draft";
         completed: "completed";
+        draft: "draft";
         inProgress: "inProgress";
         halted: "halted";
     }>>;

package/dist/src/schemas/sdk.d.ts

@@ -70,8 +70,8 @@ export declare const uploadOptionsSchema: z.ZodObject<{
         minor: "minor";
         patch: "patch";
         metadata: "metadata";
-        fix: "fix";
         ai: "ai";
+        fix: "fix";
     }>]>>;
     selfAssign: z.ZodOptional<z.ZodBoolean>;
     packageJsonPaths: z.ZodOptional<z.ZodString>;
@@ -384,8 +384,8 @@ export declare const requestBuildOptionsSchema: z.ZodObject<{
         production: "production";
     }>>;
     androidReleaseStatus: z.ZodOptional<z.ZodEnum<{
-        draft: "draft";
         completed: "completed";
+        draft: "draft";
         inProgress: "inProgress";
         halted: "halted";
     }>>;