@capgo/cli 8.5.3 → 8.7.0

package/dist/package.json

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

package/dist/src/analytics/global-props.d.ts

@@ -0,0 +1,22 @@
+export type InvocationSource = 'cli' | 'mcp';
+export declare function setInvocationSource(source: InvocationSource): void;
+export declare function getInvocationSource(): InvocationSource;
+export interface GlobalAnalyticsProps {
+    cli_version: string;
+    node_version: string;
+    os_platform: string;
+    os_arch: string;
+    os_release: string;
+    timezone: string;
+    is_ci: boolean;
+    is_tty: boolean;
+    invocation_source: InvocationSource;
+    ci_provider?: string;
+}
+/**
+ * Properties attached to every CLI telemetry event. Injected at the shared
+ * sendEvent() send path (see cli/src/utils.ts) so both trackEvent() and the
+ * many direct sendEvent() callers are tagged with the runtime OS, arch, OS
+ * release, timezone, CLI/Node versions and CI context.
+ */
+export declare function getGlobalAnalyticsProps(): GlobalAnalyticsProps;

package/dist/src/analytics/track.d.ts

@@ -1,19 +1,7 @@
 import { withSupabaseSource } from './supabase-perf';
-type InvocationSource = 'cli' | 'mcp';
-export declare function setInvocationSource(source: InvocationSource): void;
-export declare function getInvocationSource(): InvocationSource;
+export { getGlobalAnalyticsProps, getInvocationSource, setInvocationSource } from './global-props';
+export type { GlobalAnalyticsProps, InvocationSource } from './global-props';
 export declare function isTelemetryDisabled(): boolean;
-export interface GlobalAnalyticsProps {
-    cli_version: string;
-    node_version: string;
-    os_platform: string;
-    os_arch: string;
-    is_ci: boolean;
-    is_tty: boolean;
-    invocation_source: InvocationSource;
-    ci_provider?: string;
-}
-export declare function getGlobalAnalyticsProps(): GlobalAnalyticsProps;
 export declare function flushAnalytics(timeoutMs?: number): Promise<void>;
 export declare function resolveTrackingContext(apikey: string, signal?: AbortSignal): Promise<{
     appId?: string;

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

@@ -14,6 +14,8 @@ interface TrackBuildOnboardingWorkflowOptions extends WorkflowDiffTelemetry {
     appId: string;
     platform: 'ios' | 'android';
     apikey?: string;
+    /** Correlation id tying every event from one onboarding run together. */
+    journeyId?: string;
     decision?: BuildOnboardingWorkflowDecision;
     packageManager?: PackageManager;
     buildScriptType?: BuildScriptChoice['type'];

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

@@ -8,6 +8,11 @@ interface AppProps {
     /** Optional Capgo API key passed via -a/--apikey flag; takes precedence over saved key. */
     apikey?: string;
     supaHost?: string;
+    /** Correlation id for this onboarding run; emitted as `journey_id` on every analytics event. */
+    journeyId: string;
+    /** Reports the current step to the shell on every transition, so the caller can
+     *  record where the user dropped off for the quit event. */
+    onStep?: (step: string) => void;
     /** Reports the wizard outcome to the shell when it reaches build-complete, so
      *  the caller prints an accurate post-exit message + durable summary instead of
      *  always claiming success. Never fires on cancel/missing-platform exits. */

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

@@ -0,0 +1,16 @@
+/**
+ * A correlation id for a single Builder onboarding journey.
+ *
+ * Generated once per `build init` / onboarding process (in command.ts) and
+ * threaded through every analytics event the wizard emits — per-step funnel
+ * events, named action events, workflow-file events, and the terminal
+ * quit/cancel event. Without it, the events from one user's run are
+ * indistinguishable from another's in PostHog, so a "journey" can't be
+ * reconstructed when several runs overlap in the same window.
+ *
+ * The `bj_` prefix (Builder Journey) makes the id self-identifying in raw
+ * analytics payloads and easy to grep for. Scope is one process: a
+ * quit-and-resume starts a fresh journey id (cross-run stitching is a possible
+ * future enhancement, but each run is still fully correlated on its own).
+ */
+export declare function newBuilderJourneyId(): string;

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

@@ -4,6 +4,8 @@ export interface TrackBuilderOnboardingStepInput {
     apikey: string;
     appId: string;
     orgId: string;
+    /** Correlation id tying every event from one onboarding run together. */
+    journeyId: string;
     platform: Platform;
     step: OnboardingStep | AndroidOnboardingStep;
     durationMs?: number;
@@ -19,6 +21,8 @@ export interface TrackBuilderOnboardingActionInput {
     apikey: string;
     appId: string;
     orgId: string;
+    /** Correlation id tying every event from one onboarding run together. */
+    journeyId: string;
     platform: Platform;
     step: OnboardingStep | AndroidOnboardingStep;
     action: BuilderOnboardingAction;
@@ -26,3 +30,36 @@ export interface TrackBuilderOnboardingActionInput {
 }
 export declare function trackBuilderOnboardingStep(input: TrackBuilderOnboardingStepInput): Promise<void>;
 export declare function trackBuilderOnboardingAction(input: TrackBuilderOnboardingActionInput): Promise<void>;
+export interface TrackBuilderOnboardingCancelledInput {
+    apikey: string;
+    appId: string;
+    /** May be undefined when the owner org couldn't be resolved post-exit. */
+    orgId?: string;
+    /** Correlation id tying every event from one onboarding run together. */
+    journeyId: string;
+    /**
+     * The platform being onboarded, or undefined when the user quit BEFORE
+     * choosing one (e.g. on the platform picker). The undefined case is itself a
+     * useful signal — it isolates "left at the very first screen" drop-off.
+     */
+    platform?: Platform;
+    /** The step the user was on when they quit, when known. */
+    lastStep?: string;
+    /** Total wall-clock duration of the journey, from launch to quit. */
+    durationMs?: number;
+    /**
+     * Abort signal used to time-box the post-quit flush so a stalled network
+     * can't keep the CLI alive after the user has already exited the wizard.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Emits the terminal "Builder Onboarding Quit" event when a journey ends
+ * without reaching build-complete (user cancel, Ctrl+C, missing platform, or a
+ * fatal error that exits). Fired ONCE from command.ts after the wizard tears
+ * down — never mid-flow — so each journey has at most one quit marker. Unlike
+ * the per-step events this carries no org-scoped requirement: it sends with
+ * whatever org id could be resolved (possibly none) rather than dropping the
+ * event, because a quit is exactly when we most want the funnel exit recorded.
+ */
+export declare function trackBuilderOnboardingCancelled(input: TrackBuilderOnboardingCancelledInput): Promise<void>;

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

@@ -36,6 +36,11 @@ interface AppProps {
     /** Optional Capgo API key passed via -a/--apikey flag; takes precedence over saved key */
     apikey?: string;
     supaHost?: string;
+    /** Correlation id for this onboarding run; emitted as `journey_id` on every analytics event. */
+    journeyId: string;
+    /** Reports the current step to the shell on every transition, so the caller can
+     *  record where the user dropped off for the quit event. */
+    onStep?: (step: string) => void;
     /**
      * Reports the wizard outcome to the shell when it reaches build-complete, so
      *  the caller prints an accurate post-exit message + durable summary instead of

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

@@ -25,6 +25,8 @@ export interface OnboardingShellProps {
     guidedHelperUsable: boolean;
     apikey?: string;
     supaHost?: string;
+    /** Correlation id for this onboarding run; threaded into every analytics event the apps emit. */
+    journeyId: string;
     /** Pre-resolved platform (--platform flag or the single existing native dir); skips the picker. */
     initialPlatform?: Platform;
     /**
@@ -38,6 +40,9 @@ export interface OnboardingShellProps {
     };
     /** 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
+     *  where the user dropped off for the quit event. */
+    onStep?: (step: string) => void;
     /** Called by the mounted app when it reaches the build-complete screen, so the
      *  caller prints the accurate post-exit message + durable summary. If the wizard
      *  exits any other way (cancel / missing platform), this never fires and the

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

@@ -64,6 +64,7 @@ export declare const buildRequestOptionsSchema: z.ZodObject<{
         "auto-prompt": "auto-prompt";
         "caller-handled": "caller-handled";
     }>>;
+    builderJourneyId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type BuildRequestOptions = z.infer<typeof buildRequestOptionsSchema>;
 export declare const buildNeededOptionsSchema: z.ZodObject<{