@capgo/cli 8.10.0 → 8.11.0

package/dist/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@capgo/cli",
   "type": "module",
-  "version": "8.10.0",
+  "version": "8.11.0",
   "description": "A CLI to upload to capgo servers",
   "author": "Martin martin@capgo.app",
   "license": "Apache 2.0",
@@ -109,6 +109,7 @@
     "test:run-device-command": "bun test/test-run-device-command.mjs",
     "test:init-app-conflict": "bun test/test-init-app-conflict.mjs",
     "test:init-guardrails": "bun test/test-init-guardrails.mjs",
+    "test:init-replay": "bun test/test-init-replay.mjs",
     "test:prompt-preferences": "bun test/test-prompt-preferences.mjs",
     "test:esm-sdk": "node test/test-sdk-esm.mjs",
     "test:auth-session": "bun test/test-auth-session.mjs",
@@ -152,7 +153,7 @@
     "test:ios-verify-app": "bun test/test-ios-verify-app.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:version-edge-cases && bun run test:regex && bun run test:upload && bun run test:fail-on-incompatible && 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:mcp-analytics && bun run test:mcp-instructions && 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-app-conflict && bun run test:init-guardrails && bun run test:prompt-preferences && bun run test:esm-sdk && bun run test:mcp && 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: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: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-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:platform-flow-contract && bun run test:tail-engine-shared",
+    "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:version-edge-cases && bun run test:regex && bun run test:upload && bun run test:fail-on-incompatible && 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:mcp-analytics && bun run test:mcp-instructions && 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-app-conflict && 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: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: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: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-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:platform-flow-contract && bun run test:tail-engine-shared",
     "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",
@@ -180,17 +181,23 @@
   },
   "dependencies": {
     "@inkjs/ui": "^2.0.0",
+    "@rrweb/types": "^2.0.1",
+    "@xterm/addon-serialize": "^0.14.0",
+    "@xterm/headless": "^6.0.0",
+    "happy-dom": "^20.10.4",
     "ink": "^7.0.4",
     "ink-spinner": "^5.0.0",
     "jsonwebtoken": "^9.0.3",
     "node-forge": "^1.4.0",
     "qrcode": "^1.5.4",
     "react": "^19.2.6",
+    "rrweb-snapshot": "^2.0.1",
     "string-width": "^8.2.1"
   },
   "optionalDependencies": {
     "@capgo/cli-helper-darwin-arm64": "^1.1.1",
-    "@capgo/cli-helper-darwin-x64": "^1.1.1"
+    "@capgo/cli-helper-darwin-x64": "^1.1.1",
+    "node-pty": "^1.1.0"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^9.0.0",

package/dist/src/analytics/opt-out.d.ts

@@ -0,0 +1,2 @@
+export declare function applyCommandAnalyticsOptOut(commandPath: string, options: Record<string, unknown>, targetEnv?: NodeJS.ProcessEnv): boolean;
+export declare function applyRawCommandAnalyticsOptOut(argv?: string[], targetEnv?: NodeJS.ProcessEnv): boolean;

package/dist/src/app/debug.d.ts

@@ -1,7 +1,7 @@
 import type { AppDebugOptions } from '../schemas/app';
 import type { Database } from '../types/supabase.types';
 export type { AppDebugOptions as OptionsBaseDebug } from '../schemas/app';
-export declare function markSnag(channel: string, orgId: string, apikey: string, event: string, appId?: string, icon?: string): Promise<void>;
+export declare function markSnag(channel: string, orgId: string, apikey: string, event: string, appId?: string, icon?: string, tags?: Record<string, string | number | boolean>): Promise<void>;
 export declare function cancelCommand(channel: string, command: boolean | symbol, orgId: string, apikey: string): Promise<void>;
 interface Order {
     key: string;

package/dist/src/build/onboarding/android/ui/app.d.ts

@@ -1,6 +1,7 @@
 import type { FC } from 'react';
 import type { AndroidOnboardingProgress } from '../types.js';
 import type { OnboardingResult } from '../../types.js';
+import type { OnboardingBeforeExit } from '../../ui/exit.js';
 interface AppProps {
     appId: string;
     initialProgress: AndroidOnboardingProgress | null;
@@ -17,6 +18,8 @@ interface AppProps {
      *  the caller prints an accurate post-exit message + durable summary instead of
      *  always claiming success. Never fires on cancel/missing-platform exits. */
     onResult?: (result: OnboardingResult) => void;
+    /** Awaited immediately before Ink exits so replay can capture the alt-screen frame. */
+    onBeforeExit?: OnboardingBeforeExit;
 }
 declare const AndroidOnboardingApp: FC<AppProps>;
 export default AndroidOnboardingApp;

package/dist/src/build/onboarding/command.d.ts

@@ -1,4 +1,5 @@
 export interface OnboardingBuilderOptions {
+    analytics?: boolean;
     apikey?: string;
     platform?: string;
     supaHost?: string;

package/dist/src/build/onboarding/telemetry.d.ts

@@ -15,6 +15,7 @@ export interface TrackBuilderOnboardingStepInput {
     error?: unknown;
     /** Pre-computed category. Takes precedence over `error` if both are present. */
     errorCategory?: OnboardingErrorCategory | AndroidOnboardingErrorCategory;
+    replaySessionId?: string;
 }
 export type BuilderOnboardingAction = 'resume_prompt_decision' | 'android_sa_method_selected' | 'android_sa_validation_recovery_selected' | 'android_sa_validation_result';
 export interface TrackBuilderOnboardingActionInput {
@@ -27,6 +28,7 @@ export interface TrackBuilderOnboardingActionInput {
     step: OnboardingStep | AndroidOnboardingStep;
     action: BuilderOnboardingAction;
     tags?: Record<string, boolean | number | string>;
+    replaySessionId?: string;
 }
 export declare function trackBuilderOnboardingStep(input: TrackBuilderOnboardingStepInput): Promise<void>;
 export declare function trackBuilderOnboardingAction(input: TrackBuilderOnboardingActionInput): Promise<void>;
@@ -52,6 +54,7 @@ export interface TrackBuilderOnboardingCancelledInput {
      * can't keep the CLI alive after the user has already exited the wizard.
      */
     signal?: AbortSignal;
+    replaySessionId?: string;
 }
 /**
  * Emits the terminal "Builder Onboarding Quit" event when a journey ends

package/dist/src/build/onboarding/ui/app.d.ts

@@ -1,5 +1,6 @@
 import type { FC } from 'react';
 import type { OnboardingProgress, OnboardingResult } from '../types.js';
+import type { OnboardingBeforeExit } from './exit.js';
 interface AppProps {
     /**
      * Capgo lookup key (progress files, saved credentials, Capgo SaaS build
@@ -47,6 +48,8 @@ interface AppProps {
      *  always claiming success. Never fires on cancel/missing-platform exits.
      */
     onResult?: (result: OnboardingResult) => void;
+    /** Awaited immediately before Ink exits so replay can capture the alt-screen frame. */
+    onBeforeExit?: OnboardingBeforeExit;
 }
 declare const OnboardingApp: FC<AppProps>;
 export default OnboardingApp;

package/dist/src/build/onboarding/ui/exit.d.ts

@@ -0,0 +1,2 @@
+export type OnboardingBeforeExit = () => Promise<void> | void;
+export declare function exitAfterOnboardingBeforeExit(onBeforeExit: OnboardingBeforeExit | undefined, exit: () => void): void;

package/dist/src/build/onboarding/ui/shell.d.ts

@@ -1,5 +1,6 @@
 import type { FC } from 'react';
 import type { OnboardingResult, Platform } from '../types.js';
+import type { OnboardingBeforeExit } from './exit.js';
 export declare function useTerminalSize(): {
     cols: number;
     rows: number;
@@ -38,6 +39,8 @@ export interface OnboardingShellProps {
         currentVersion: string;
         latestVersion: string;
     };
+    /** Shows the terminal replay/analytics opt-out notice on the first shell screen. */
+    analyticsNotice?: boolean;
     /** Called once a platform is chosen so the caller can print the completion breadcrumb. */
     onResolvePlatform?: (platform: Platform) => void;
     /** Called by the mounted app on every step transition, so the caller can record
@@ -48,6 +51,8 @@ export interface OnboardingShellProps {
      *  exits any other way (cancel / missing platform), this never fires and the
      *  caller treats it as cancelled. */
     onResult?: (result: OnboardingResult) => void;
+    /** Awaited immediately before Ink exits so replay can capture the alt-screen frame. */
+    onBeforeExit?: OnboardingBeforeExit;
 }
 declare const OnboardingShell: FC<OnboardingShellProps>;
 export default OnboardingShell;

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

@@ -2,6 +2,7 @@ import type { Options } from '../api/app';
 import { spawnSync } from 'node:child_process';
 import { getPMAndCommand } from '../utils';
 interface SuperOptions extends Options {
+    analytics?: boolean;
     local: boolean;
 }
 export type RunDeviceCancelHandler = () => Promise<never>;
@@ -54,10 +55,20 @@ export interface CapacitorRunTarget {
     id: string;
 }
 export declare function runPackageRunnerSync(runner: string, args: string[], options: Parameters<typeof spawnSync>[2]): import("node:child_process").SpawnSyncReturns<string | NonSharedBuffer>;
+interface InheritedCommandResult {
+    error?: Error;
+    signal: NodeJS.Signals | number | null;
+    status: number | null;
+}
+interface InheritedCommandOptions {
+    cwd?: string;
+    forcePty?: boolean;
+}
+export declare function runInheritedCommand(command: string, args: string[], options?: InheritedCommandOptions): Promise<InheritedCommandResult>;
 export declare function parseCapacitorRunTargetList(output: string): CapacitorRunTarget[];
 export declare function getPhysicalIosRunTargets(targets: CapacitorRunTarget[]): CapacitorRunTarget[];
 export declare function getSimulatorIosRunTargets(targets: CapacitorRunTarget[]): CapacitorRunTarget[];
 export declare function resolveRunDeviceCommand(cancelHandler: RunDeviceCancelHandler, pm: PackageManagerInfo, platformName: PlatformChoice, projectDir?: string): Promise<RunDeviceStepOutcome>;
 export declare function normalizeRunDevicePlatform(platformName: string): PlatformChoice;
-export declare function initApp(apikeyCommand: string, appId: string, options: SuperOptions): Promise<void>;
+export declare function initApp(apikeyCommand: string, appId: string, options: SuperOptions): Promise<never>;
 export {};

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

@@ -0,0 +1,91 @@
+import type { eventWithTime, serializedNodeWithId } from '@rrweb/types';
+interface TerminalSnapshot {
+    node: serializedNodeWithId;
+    terminalNodeId: number;
+}
+export interface TerminalReplayFrame {
+    height: number;
+    html: string;
+    text: string;
+    width: number;
+}
+export interface TerminalPixelSize {
+    height: number;
+    width: number;
+}
+interface InitReplayGateInput {
+    analyticsEnabled?: boolean;
+    apikey?: string;
+    isCi?: boolean;
+    stdinIsTTY?: boolean;
+    stdoutIsTTY?: boolean;
+    telemetryDisabled?: boolean;
+}
+interface InitReplaySnapshotBody {
+    event: '$snapshot';
+    properties: {
+        $current_url: string;
+        $lib: string;
+        $lib_version: string;
+        $session_id: string;
+        $snapshot_bytes: number;
+        $snapshot_data: eventWithTime[];
+        $snapshot_source: string;
+        $window_id: string;
+    };
+    timestamp: string;
+}
+type InitReplayTransport = (url: string, body: InitReplaySnapshotBody, apikey: string, signal?: AbortSignal) => Promise<boolean>;
+interface StartInitReplayOptions {
+    analyticsEnabled?: boolean;
+    apikey?: string;
+    ariaLabel?: string;
+    cols?: number;
+    currentUrl?: string;
+    replayUrl?: string;
+    rows?: number;
+    sessionPrefix?: string;
+    supaAnon?: string;
+    supaHost?: string;
+    throttleMs?: number;
+    terminalPixelSize?: TerminalPixelSize;
+    transport?: InitReplayTransport;
+}
+export interface InitReplayController {
+    finish: () => Promise<void>;
+    sessionId: string;
+}
+export declare function getActiveCliReplaySessionId(): string | undefined;
+export declare function finishActiveCliReplay(): Promise<void>;
+export declare function isCliTelemetryDisabled(): boolean;
+export declare function shouldStartInitReplay(input: InitReplayGateInput): boolean;
+export declare function resolveCapgoReplayUrl(host?: string): string | undefined;
+export declare function resolveSupabaseReplayUrl(supaHost?: string): string | undefined;
+export declare function resolveReplayUrlForFlush(replayUrl: Promise<string | undefined>, timeoutMs?: number, onTimeout?: () => void): Promise<string | undefined>;
+export declare function parseTerminalPixelSizeResponse(input: string): TerminalPixelSize | undefined;
+export declare function getReplayViewportSize(cols?: number, rows?: number, terminalPixelSize?: TerminalPixelSize): {
+    height: number;
+    width: number;
+};
+export declare function queryTerminalPixelSize(timeoutMs?: number): Promise<TerminalPixelSize | undefined>;
+export declare function renderRedactedTerminalFrame(rawAnsi: string, cols?: number, rows?: number, terminalPixelSize?: TerminalPixelSize): Promise<TerminalReplayFrame>;
+export declare function renderRedactedTerminalText(rawAnsi: string, cols?: number, rows?: number): Promise<string>;
+export declare function createTerminalSnapshot(frameInput: TerminalReplayFrame | string, options?: {
+    ariaLabel?: string;
+    currentUrl?: string;
+}): Promise<TerminalSnapshot>;
+export declare function createTerminalSnapshotNode(frame: TerminalReplayFrame | string): Promise<serializedNodeWithId>;
+export declare function createTerminalInteractionEvents(input: {
+    terminalNodeId: number;
+    text: string;
+    timestamp: number;
+}): eventWithTime[];
+export declare function buildInitReplayBody(input: {
+    currentUrl?: string;
+    events: eventWithTime[];
+    sessionId: string;
+    timestamp: string;
+    windowId: string;
+}): InitReplaySnapshotBody;
+export declare function startInitReplay(options?: StartInitReplayOptions): InitReplayController | undefined;
+export {};

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

@@ -4,7 +4,7 @@ export interface InitOnboardingStepDefinition {
     phase: string;
 }
 export declare const initOnboardingSteps: InitOnboardingStepDefinition[];
-export declare function renderInitOnboardingWelcome(totalSteps: number): void;
+export declare function renderInitOnboardingWelcome(totalSteps: number, analyticsEnabled?: boolean): void;
 export declare function renderInitOnboardingFrame(currentStepNumber: number, totalSteps: number, options?: {
     resumed?: boolean;
 }): void;

package/dist/src/posthog.d.ts

@@ -7,6 +7,7 @@ interface CapturePosthogExceptionPayload {
     status?: number;
 }
 export declare function isTruthyEnvValue(value: string | undefined): boolean;
+export declare function getPosthogToken(): string | undefined;
 export declare function shouldCapturePosthogException(error: unknown): boolean;
 export declare function getCommandPath(command: Command): string;
 export declare function capturePosthogException(payload: CapturePosthogExceptionPayload): Promise<boolean>;

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

@@ -2,6 +2,7 @@ import { z } from 'zod';
 export declare const nativePackageSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodString;
+    requested_version: z.ZodOptional<z.ZodString>;
     ios_checksum: z.ZodOptional<z.ZodString>;
     android_checksum: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -10,6 +11,7 @@ export declare const incompatibilityReasonSchema: z.ZodEnum<{
     new_plugin: "new_plugin";
     removed_plugin: "removed_plugin";
     version_mismatch: "version_mismatch";
+    requested_version_changed: "requested_version_changed";
     ios_code_changed: "ios_code_changed";
     android_code_changed: "android_code_changed";
     both_platforms_changed: "both_platforms_changed";
@@ -19,6 +21,8 @@ export declare const compatibilitySchema: z.ZodObject<{
     name: z.ZodString;
     localVersion: z.ZodOptional<z.ZodString>;
     remoteVersion: z.ZodOptional<z.ZodString>;
+    localRequestedVersion: z.ZodOptional<z.ZodString>;
+    remoteRequestedVersion: z.ZodOptional<z.ZodString>;
     localIosChecksum: z.ZodOptional<z.ZodString>;
     remoteIosChecksum: z.ZodOptional<z.ZodString>;
     localAndroidChecksum: z.ZodOptional<z.ZodString>;
@@ -31,6 +35,7 @@ export declare const compatibilityDetailsSchema: z.ZodObject<{
         new_plugin: "new_plugin";
         removed_plugin: "removed_plugin";
         version_mismatch: "version_mismatch";
+        requested_version_changed: "requested_version_changed";
         ios_code_changed: "ios_code_changed";
         android_code_changed: "android_code_changed";
         both_platforms_changed: "both_platforms_changed";