@capgo/cli 7.113.0 → 7.114.1

package/dist/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@capgo/cli",
   "type": "module",
-  "version": "7.113.0",
+  "version": "7.114.1",
   "description": "A CLI to upload to capgo servers",
   "author": "Martin martin@capgo.app",
   "license": "Apache 2.0",
@@ -81,6 +81,12 @@
     "test:android-onboarding-progress": "bun test/test-android-onboarding-progress.mjs",
     "test:onboarding-telemetry": "bun test/test-onboarding-telemetry.mjs",
     "test:v2-event-migration": "bun test/test-v2-event-migration.mjs",
+    "test:analytics": "bun test/test-analytics.mjs",
+    "test:analytics-error-category": "bun test/test-analytics-error-category.mjs",
+    "test:analytics-org-resolver": "bun test/test-analytics-org-resolver.mjs",
+    "test:mcp-analytics": "bun test/test-mcp-analytics.mjs",
+    "test:app-created-source": "bun test/test-app-created-source.mjs",
+    "test:doctor-analytics": "bun test/test-doctor-analytics.mjs",
     "test:posthog-exception": "bun test/test-posthog-exception.mjs",
     "test:onboarding-recovery": "bun test/test-onboarding-recovery.mjs",
     "test:onboarding-progress": "bun test/test-onboarding-progress.mjs",
@@ -98,7 +104,7 @@
     "test:macos-signing": "bun test/test-macos-signing.mjs",
     "test:apple-api-import-helpers": "bun test/test-apple-api-import-helpers.mjs",
     "test:manifest-path-encoding": "bun test/test-manifest-path-encoding.mjs",
-    "test": "bun run build && 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: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: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:version-detection && bun run test:platform-paths && bun run test:payload-split && bun run test:manifest-path-encoding && bun run test:macos-signing && bun run test:apple-api-import-helpers && bun run test:ai-log-capture && bun run test:ai-analyze-flow && bun run test:ai-render-markdown",
+    "test": "bun run build && 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: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:mcp-analytics && 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:version-detection && bun run test:platform-paths && bun run test:payload-split && bun run test:manifest-path-encoding && bun run test:macos-signing && bun run test:apple-api-import-helpers && bun run test:ai-log-capture && bun run test:ai-analyze-flow && bun run test:ai-render-markdown",
     "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/analytics/error-category.d.ts

@@ -0,0 +1,6 @@
+export type CliErrorCategory = 'network_error' | 'timeout' | 'unauthorized' | 'forbidden' | 'not_found' | 'payload_too_large' | 'validation_error' | 'server_error' | 'commander' | 'unknown';
+/**
+ * Maps an arbitrary thrown value to a closed enum so telemetry never leaks
+ * error text, paths, or user input. Returns 'unknown' for anything unmatched.
+ */
+export declare function categorizeCliError(error: unknown): CliErrorCategory;

package/dist/src/analytics/org-resolver.d.ts

@@ -0,0 +1,11 @@
+import { createSupabaseClient } from '../utils';
+export interface OrgResolverDeps {
+    /** Injectable for tests; defaults to the real Supabase client factory. */
+    createClient?: typeof createSupabaseClient;
+}
+/**
+ * Resolves an app's owner organization id (`apps.owner_org`), promise-cached
+ * per `(apikey, appId)`. Returns undefined on any error — never throws.
+ * Extracted so the analytics layer and onboarding analytics share one path.
+ */
+export declare function resolveOwnerOrgId(apikey: string, appId: string, deps?: OrgResolverDeps, signal?: AbortSignal): Promise<string | undefined>;

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

@@ -0,0 +1,68 @@
+type InvocationSource = 'cli' | 'mcp';
+export declare function setInvocationSource(source: InvocationSource): void;
+export declare function getInvocationSource(): InvocationSource;
+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;
+    orgId?: string;
+}>;
+export interface TrackEventInput {
+    channel: string;
+    event: string;
+    icon?: string;
+    /** Org id for actor-scoped attribution. Omitted => resolved best-effort. */
+    orgId?: string;
+    /** App id (also lets the backend verify org ownership). */
+    appId?: string;
+    /** Explicit key; falls back to the saved key. No key => no event. */
+    apikey?: string;
+    tags?: Record<string, string | number | boolean>;
+}
+/**
+ * Generic v2 actor-scoped event. Never throws. Does nothing when telemetry is
+ * disabled or no API key is resolvable (the accepted unauthenticated gap).
+ * When the caller omits appId/orgId, both are resolved best-effort from the
+ * local Capacitor config (app_id → owner_org) so local commands still get
+ * user + org attribution when the user is logged in.
+ */
+export declare function trackEvent(input: TrackEventInput): Promise<void>;
+export interface CommandContext {
+    flags: string[];
+    positional_arg_count: number;
+}
+interface CommanderLike {
+    args: readonly string[];
+    opts: () => Record<string, unknown>;
+    getOptionValueSource: (key: string) => string | undefined;
+}
+/**
+ * Pulls only privacy-safe context from a Commander command: the NAMES of
+ * user-provided flags (never their values) and the positional arg count.
+ */
+export declare function extractCommandContext(command: CommanderLike): CommandContext;
+export declare function trackCommandInvoked(commandPath: string, ctx: CommandContext): void;
+export declare function trackCommandSucceeded(commandPath: string): void;
+export declare function trackCommandFailed(commandPath: string, opts: {
+    errorCategory: string;
+    exitCode: number;
+}): void;
+type AnyAsyncFn = (...args: any[]) => Promise<any>;
+/**
+ * Wraps an MCP tool handler to emit a `MCP Tool Invoked` event with the tool
+ * name, success flag, and duration. Re-throws so behavior is unchanged.
+ */
+export declare function withMcpToolTracking<H extends AnyAsyncFn>(toolName: string, handler: H): H;
+export declare function trackMcpServerStarted(hasApikey: boolean): void;
+export {};

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

@@ -1,7 +1,9 @@
 import type { AppOptions } from '../schemas/app';
 import type { Organization } from '../utils';
 export declare const reverseDomainRegex: RegExp;
-export declare function addAppInternal(initialAppId: string, options: AppOptions, organization?: Organization, silent?: boolean): Promise<{
+export type AppCreateSource = 'cli-direct' | 'onboarding' | 'mcp';
+export declare function resolveAppCreateSource(explicit?: AppCreateSource): AppCreateSource;
+export declare function addAppInternal(initialAppId: string, options: AppOptions, organization?: Organization, silent?: boolean, source?: AppCreateSource): Promise<{
     appId: any;
     organizationUid: string;
     userId: string;

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

@@ -1,6 +1,11 @@
 interface DoctorInfoOptions {
     packageJson?: string;
 }
+export declare function computeDoctorAnalyticsTags(installed: Record<string, string>, latest: Record<string, string>): {
+    is_outdated: boolean;
+    dependency_count: number;
+    outdated_count: number;
+};
 export declare function getInfoInternal(options: DoctorInfoOptions, silent?: boolean): Promise<{
     appName: string;
     appId: any;

package/dist/src/posthog.d.ts

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