@capgo/cli 7.120.0 → 7.121.0

package/dist/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@capgo/cli",
   "type": "module",
-  "version": "7.120.0",
+  "version": "7.121.0",
   "description": "A CLI to upload to capgo servers",
   "author": "Martin martin@capgo.app",
   "license": "Apache 2.0",
@@ -105,11 +105,22 @@
     "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:analytics && bun run test:analytics-error-category && bun run test:analytics-org-resolver && bun run test:supabase-perf && 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": "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:supabase-perf && 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 && 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",
     "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",
-    "test:ai-render-markdown": "bun test/test-ai-render-markdown.mjs"
+    "test:ai-render-markdown": "bun test/test-ai-render-markdown.mjs",
+    "test:ai-onboarding-mode": "bun test/test-ai-onboarding-mode.mjs",
+    "test:ai-fit": "bun test/test-ai-fit.mjs",
+    "test:platform-layout": "bun test/test-platform-layout.mjs",
+    "test:frame-fit": "bun test/run-frame-fit.mjs",
+    "test:onboarding-min-size": "bun test/test-onboarding-min-size.mjs",
+    "test:min-size-gate": "bun test/test-min-size-gate.mjs",
+    "test:shell-size-gate": "bun test/test-shell-size-gate.mjs",
+    "test:build-log-sanitize": "bun test/test-build-log-sanitize.mjs",
+    "test:build-output-viewport": "bun test/test-build-output-viewport.mjs",
+    "test:diff-viewer-viewport": "bun test/test-diff-viewer-viewport.mjs",
+    "test:build-complete-exit": "bun test/test-build-complete-exit.mjs"
   },
   "dependencies": {
     "@inkjs/ui": "^2.0.0",
@@ -142,6 +153,7 @@
     "@types/ws": "^8.18.1",
     "@typescript/native-preview": "7.0.0-dev.20260526.1",
     "@vercel/ncc": "^0.38.4",
+    "@xterm/headless": "^6.0.0",
     "adm-zip": "^0.5.17",
     "ci-info": "^4.4.0",
     "commander": "^14.0.3",

package/dist/src/ai/analyze.d.ts

@@ -27,3 +27,11 @@ export type PostAnalyzeResult = {
 export declare function postAnalyzeRequest(input: PostAnalyzeInput): Promise<PostAnalyzeResult>;
 export declare const HARD_LOG_SIZE_LIMIT: number;
 export declare function isLogTooBig(jobId: string): Promise<boolean>;
+export interface RunCapgoAiAnalysisInput {
+    apiHost: string;
+    apikey: string;
+    jobId: string;
+    appId: string;
+}
+export declare function runCapgoAiAnalysis(input: RunCapgoAiAnalysisInput): Promise<PostAnalyzeResult>;
+export declare function releaseCapturedLogs(jobId: string): Promise<void>;

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

@@ -1,5 +1,5 @@
-export type AiAnalysisChoice = 'capgo_ai' | 'local_ai' | 'skip' | 'auto_upload';
-export type AiAnalysisTriggeredBy = 'menu' | 'ci_flag';
+export type AiAnalysisChoice = 'capgo_ai' | 'local_ai' | 'skip' | 'auto_upload' | 'retry';
+export type AiAnalysisTriggeredBy = 'menu' | 'ci_flag' | 'onboarding';
 export type AiAnalysisResult = 'success' | 'already_analyzed' | 'too_big' | 'error';
 export interface TrackAiAnalysisChoiceInput {
     apikey: string;

package/dist/src/build/onboarding/ai-fit.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Fit estimation for the AI analysis result step in the onboarding TUI.
+ *
+ * The on-failure AI flow can return a multi-screen markdown diagnosis. If
+ * that text doesn't fit in the user's current terminal viewport we MUST
+ * route it through the scrollable `FullscreenAiViewer` — otherwise the
+ * earlier lines scroll out of view and the onboarding wizard ends up in
+ * an unreadable state.
+ *
+ * The estimator deliberately errs on the side of "doesn't fit": a
+ * false-positive scroll is fine (just one more keystroke for the user),
+ * but a false-negative inline render is bad UX (text disappears off the
+ * top of the screen).
+ */
+export declare const AI_RESULT_CHROME_ROWS = 10;
+/** Strip ANSI SGR escape codes so length matches what the user actually sees. */
+export declare function stripAnsi(text: string): string;
+/**
+ * Estimate how many terminal rows a multi-line, possibly ANSI-styled string
+ * will occupy when rendered by Ink at the given column width.
+ *
+ * Each logical line (split on '\n') becomes `ceil(visibleLen / cols)` rows,
+ * with a floor of 1 to account for empty lines that still consume a row.
+ */
+export declare function estimateRenderedRows(text: string, terminalCols: number): number;
+/**
+ * Decide whether the AI analysis text should be routed through the
+ * scrollable fullscreen viewer. Conservative — prefers true (scroll) when
+ * the estimate is close to the available row budget.
+ *
+ * @param text         The AI analysis markdown (already rendered to ANSI).
+ * @param terminalRows Total terminal rows from `useStdout().stdout?.rows`.
+ * @param terminalCols Total terminal cols from `useStdout().stdout?.columns`.
+ * @param chromeRows   Reserved rows for the surrounding wizard chrome.
+ *                     Defaults to `AI_RESULT_CHROME_ROWS`.
+ */
+export declare function isAiAnalysisTooTall(text: string, terminalRows: number, terminalCols: number, chromeRows?: number): boolean;
+export type AiResultStep = 'ai-analysis-result' | 'ai-analysis-result-scroll';
+/**
+ * Decide which AI-result step should be active for the CURRENT terminal size.
+ *
+ * Routing is BIDIRECTIONAL and driven by the single `isAiAnalysisTooTall`
+ * predicate, so it settles deterministically at any size — at a given size
+ * exactly one outcome is stable, so it can't oscillate:
+ *   - inline + now too tall (terminal shrank)  → scroll
+ *   - scroll + now fits      (terminal grew)    → inline   ← the missing case
+ *
+ * Before, only the inline→scroll direction existed: once the viewer opened
+ * (e.g. after shrinking), growing the terminal never returned to the inline
+ * render — the user was stuck in the scroll viewer showing "all N lines" with
+ * empty space.
+ *
+ * `viewedFull` (the user manually dismissed the viewer with Esc/Enter) pins the
+ * inline step so a later resize can't shove a dismissed analysis back into the
+ * viewer. It only gates the inline→scroll direction; leaving the viewer when it
+ * fits is always allowed.
+ *
+ * @returns the step to switch to, or `null` when the current step is already
+ *   correct (so the caller can skip a no-op `setStep`).
+ */
+export declare function resolveAiResultRoute(params: {
+    current: AiResultStep;
+    text: string | null;
+    viewedFull: boolean;
+    terminalRows: number;
+    terminalCols: number;
+}): AiResultStep | null;
+/**
+ * Pick the slice of `lines` starting at `scrollOffset` that PACKS the
+ * `viewportRows` rendered rows of a terminal `terminalCols` wide.
+ *
+ * Packs lines until the cumulative wrapped row count reaches or exceeds
+ * `viewportRows`, INCLUDING the line that crosses the boundary. That last line
+ * may render past the viewport; the viewer clips it with `overflow: hidden` so
+ * the visible area is always FULL of text when more lines remain. (Stopping
+ * before the boundary line — the old behaviour — left the unused rows as an
+ * empty gap when a long line couldn't fully fit.)
+ *
+ * Always returns at least one line if the input is non-empty and the
+ * `scrollOffset` is in-range — even if that line wraps to more rows than the
+ * viewport.
+ */
+export declare function pickVisibleLines(lines: string[], scrollOffset: number, viewportRows: number, terminalCols: number): string[];
+/**
+ * Compute the largest `scrollOffset` that still keeps content visible at the
+ * bottom of the viewport — i.e. the offset where the LAST line is rendered
+ * within the viewport. Walks backwards from the end, packing as many tail
+ * lines as fit (accounting for wrap), and returns the offset of the first
+ * fully-visible tail line.
+ */
+export declare function computeMaxScrollOffset(lines: string[], viewportRows: number, terminalCols: number): number;

package/dist/src/build/onboarding/android/types.d.ts

@@ -1,4 +1,4 @@
-export type AndroidOnboardingStep = 'welcome' | 'credentials-exist' | 'backing-up' | 'no-platform' | 'keystore-method-select' | 'keystore-explainer' | 'keystore-existing-path' | 'keystore-existing-picker' | 'keystore-existing-store-password' | 'keystore-existing-detecting-alias' | 'keystore-existing-alias-select' | 'keystore-existing-alias' | 'keystore-existing-key-password' | 'keystore-new-alias' | 'keystore-new-password-method' | 'keystore-new-store-password' | 'keystore-new-key-password' | 'keystore-new-cn' | 'keystore-generating' | 'service-account-method-select' | 'sa-json-existing-path' | 'sa-json-existing-picker' | 'sa-json-validating' | 'sa-json-validation-failed' | 'google-sign-in' | 'google-sign-in-running' | 'play-developer-id-input' | 'gcp-projects-loading' | 'gcp-projects-select' | 'gcp-project-create-name' | 'android-package-select' | 'gcp-setup-running' | 'saving-credentials' | 'detecting-ci-secrets' | 'ci-secrets-setup' | 'ci-secrets-target-select' | 'ask-ci-secrets' | 'checking-ci-secrets' | 'confirm-ci-secret-overwrite' | 'uploading-ci-secrets' | 'ci-secrets-failed' | 'ask-github-actions-setup' | 'confirm-secrets-push' | 'ask-export-env' | 'exporting-env' | 'confirm-env-export-overwrite' | 'overwrite-and-export-env' | 'pick-package-manager' | 'pick-build-script' | 'pick-build-script-custom' | 'preview-workflow-file' | 'view-workflow-diff' | 'writing-workflow-file' | 'ask-build' | 'requesting-build' | 'build-complete' | 'error';
+export type AndroidOnboardingStep = 'welcome' | 'credentials-exist' | 'backing-up' | 'no-platform' | 'keystore-method-select' | 'keystore-explainer' | 'keystore-existing-path' | 'keystore-existing-picker' | 'keystore-existing-store-password' | 'keystore-existing-detecting-alias' | 'keystore-existing-alias-select' | 'keystore-existing-alias' | 'keystore-existing-key-password' | 'keystore-new-alias' | 'keystore-new-password-method' | 'keystore-new-store-password' | 'keystore-new-key-password' | 'keystore-new-cn' | 'keystore-generating' | 'service-account-method-select' | 'sa-json-existing-path' | 'sa-json-existing-picker' | 'sa-json-validating' | 'sa-json-validation-failed' | 'google-sign-in' | 'google-sign-in-running' | 'play-developer-id-input' | 'gcp-projects-loading' | 'gcp-projects-select' | 'gcp-project-create-name' | 'android-package-select' | 'gcp-setup-running' | 'saving-credentials' | 'detecting-ci-secrets' | 'ci-secrets-setup' | 'ci-secrets-target-select' | 'ask-ci-secrets' | 'checking-ci-secrets' | 'confirm-ci-secret-overwrite' | 'uploading-ci-secrets' | 'ci-secrets-failed' | 'ask-github-actions-setup' | 'confirm-secrets-push' | 'ask-export-env' | 'exporting-env' | 'confirm-env-export-overwrite' | 'overwrite-and-export-env' | 'pick-package-manager' | 'pick-build-script' | 'pick-build-script-custom' | 'preview-workflow-file' | 'view-workflow-diff' | 'writing-workflow-file' | 'ask-build' | 'requesting-build' | 'ai-analysis-prompt' | 'ai-analysis-running' | 'ai-analysis-result' | 'ai-analysis-result-scroll' | 'build-complete' | 'error';
 export type AndroidOnboardingErrorCategory = 'keystore_invalid' | 'google_oauth_failed' | 'play_account_id_invalid' | 'sa_json_shape_invalid' | 'sa_json_token_rejected' | 'sa_json_no_app_access' | 'sa_json_network_error' | 'unknown';
 export type KeystoreMethod = 'existing' | 'generate';
 export type ServiceAccountMethod = 'existing' | 'generate';

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

@@ -1,12 +1,16 @@
 import type { FC } from 'react';
 import type { AndroidOnboardingProgress } from '../types.js';
+import type { OnboardingResult } from '../../types.js';
 interface AppProps {
     appId: string;
     initialProgress: AndroidOnboardingProgress | null;
     androidDir: string;
     /** Optional Capgo API key passed via -a/--apikey flag; takes precedence over saved key. */
     apikey?: string;
-    terminalRows?: number;
+    /** 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. */
+    onResult?: (result: OnboardingResult) => void;
 }
 declare const AndroidOnboardingApp: FC<AppProps>;
 export default AndroidOnboardingApp;

package/dist/src/build/onboarding/build-log.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Turn a raw streamed build-log chunk into clean display lines.
+ *
+ * Splits on `\n` AND bare `\r` (an in-place redraw becomes its own line rather
+ * than fusing with another), strips ANSI/escape/control bytes, trims trailing
+ * whitespace, and drops the empty element a trailing newline would add (interior
+ * blank lines — e.g. the intentional spacer before the first log line — are
+ * kept). A chunk may be a single line or several; callers spread the result.
+ */
+export declare function sanitizeBuildLogLines(chunk: string): string[];

package/dist/src/build/onboarding/min-terminal-size.d.ts

@@ -0,0 +1,16 @@
+export declare const MIN_COLS = 80;
+export declare const IOS_MIN_ROWS = 38;
+export declare const ANDROID_MIN_ROWS = 49;
+export declare const MIN_ROWS: number;
+/** The full-onboarding row floor for a given platform. */
+export declare function onboardingMinRows(platform: 'ios' | 'android'): number;
+/**
+ * True when the given terminal size can run a platform's onboarding without a
+ * mid-flow resize. `platform` defaults to the conservative 'android' (larger)
+ * floor for platform-agnostic callers.
+ */
+export declare function terminalFitsOnboarding(cols: number, rows: number, platform?: 'ios' | 'android'): boolean;
+export declare const PICKER_MIN_COLS = 44;
+export declare const PICKER_MIN_ROWS = 11;
+/** True when the terminal can render the platform picker (banner + picker). */
+export declare function terminalFitsPicker(cols: number, rows: number): boolean;

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

@@ -48,3 +48,4 @@ export declare function getResumeStep(progress: OnboardingProgress | null): Onbo
  * Returns the step to land on after a successful Keychain scan.
  */
 export declare function getImportEntryStep(progress: OnboardingProgress | null): OnboardingStep;
+export declare function extractKeyIdFromP8Path(filePath: string): string;

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

@@ -1,5 +1,22 @@
 export type Platform = 'ios' | 'android';
-export type OnboardingStep = 'welcome' | 'platform-select' | 'adding-platform' | 'credentials-exist' | 'backing-up' | 'setup-method-select' | 'import-scanning' | 'import-distribution-mode' | 'import-pick-identity' | 'import-pick-profile' | 'import-no-match-recovery' | 'import-fetching-profile' | 'import-create-profile-only' | 'import-export-warning' | 'import-compiling-helper' | 'import-exporting' | 'api-key-instructions' | 'p8-method-select' | 'input-p8-path' | 'input-key-id' | 'input-issuer-id' | 'verifying-key' | 'creating-certificate' | 'cert-limit-prompt' | 'revoking-certificate' | 'creating-profile' | 'duplicate-profile-prompt' | 'deleting-duplicate-profiles' | 'saving-credentials' | 'detecting-ci-secrets' | 'ci-secrets-setup' | 'ci-secrets-target-select' | 'ask-ci-secrets' | 'checking-ci-secrets' | 'confirm-ci-secret-overwrite' | 'uploading-ci-secrets' | 'ci-secrets-failed' | 'ask-github-actions-setup' | 'confirm-secrets-push' | 'ask-export-env' | 'exporting-env' | 'confirm-env-export-overwrite' | 'overwrite-and-export-env' | 'pick-package-manager' | 'pick-build-script' | 'pick-build-script-custom' | 'preview-workflow-file' | 'view-workflow-diff' | 'writing-workflow-file' | 'ask-build' | 'requesting-build' | 'build-complete' | 'no-platform' | 'error';
+export interface OnboardingCompletionSummary {
+    /** The Capgo dashboard build URL, when a build was kicked off. */
+    buildUrl?: string;
+    /** One-line CI-secret upload summary, when secrets were pushed. */
+    ciSecretUploadSummary?: string | null;
+    /** Path to the generated GitHub Actions workflow file, when written. */
+    workflowFilePath?: string | null;
+    /** Path to the exported .env file, when the user chose the env-export fallback. */
+    envExportPath?: string | null;
+    /** The "run anytime" build-request command shown on the final screen. */
+    buildRequestCommand?: string;
+}
+export interface OnboardingResult {
+    outcome: 'completed' | 'cancelled';
+    /** Present only when outcome === 'completed'. */
+    summary?: OnboardingCompletionSummary;
+}
+export type OnboardingStep = 'welcome' | 'platform-select' | 'adding-platform' | 'credentials-exist' | 'backing-up' | 'setup-method-select' | 'import-scanning' | 'import-distribution-mode' | 'import-pick-identity' | 'import-pick-profile' | 'import-no-match-recovery' | 'import-fetching-profile' | 'import-create-profile-only' | 'import-export-warning' | 'import-compiling-helper' | 'import-exporting' | 'api-key-instructions' | 'p8-method-select' | 'input-p8-path' | 'input-key-id' | 'input-issuer-id' | 'verifying-key' | 'creating-certificate' | 'cert-limit-prompt' | 'revoking-certificate' | 'creating-profile' | 'duplicate-profile-prompt' | 'deleting-duplicate-profiles' | 'saving-credentials' | 'detecting-ci-secrets' | 'ci-secrets-setup' | 'ci-secrets-target-select' | 'ask-ci-secrets' | 'checking-ci-secrets' | 'confirm-ci-secret-overwrite' | 'uploading-ci-secrets' | 'ci-secrets-failed' | 'ask-github-actions-setup' | 'confirm-secrets-push' | 'ask-export-env' | 'exporting-env' | 'confirm-env-export-overwrite' | 'overwrite-and-export-env' | 'pick-package-manager' | 'pick-build-script' | 'pick-build-script-custom' | 'preview-workflow-file' | 'view-workflow-diff' | 'writing-workflow-file' | 'ask-build' | 'requesting-build' | 'ai-analysis-prompt' | 'ai-analysis-running' | 'ai-analysis-result' | 'ai-analysis-result-scroll' | 'build-complete' | 'no-platform' | 'error';
 export type OnboardingErrorCategory = 'apple_api_unauthorized' | 'apple_api_rate_limited' | 'cert_limit_reached' | 'profile_creation_failed' | 'p8_invalid' | 'keychain_no_identities' | 'keychain_export_failed' | 'keychain_helper_compile_failed' | 'profile_no_match' | 'profile_read_failed' | 'unknown';
 export interface ApiKeyData {
     keyId: string;

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

@@ -1,5 +1,5 @@
 import type { FC } from 'react';
-import type { OnboardingProgress } from '../types.js';
+import type { OnboardingProgress, OnboardingResult } from '../types.js';
 interface AppProps {
     appId: string;
     initialProgress: OnboardingProgress | null;
@@ -7,7 +7,10 @@ interface AppProps {
     iosDir: string;
     /** Optional Capgo API key passed via -a/--apikey flag; takes precedence over saved key */
     apikey?: string;
-    terminalRows?: number;
+    /** 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. */
+    onResult?: (result: OnboardingResult) => void;
 }
 declare const OnboardingApp: FC<AppProps>;
 export default OnboardingApp;

package/dist/src/build/onboarding/ui/completed-steps-log.d.ts

@@ -0,0 +1,9 @@
+import type { FC } from 'react';
+export interface LogEntry {
+    text: string;
+    color?: string;
+}
+export declare const CompletedStepsLog: FC<{
+    entries: LogEntry[];
+    maxRows: number;
+}>;

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

@@ -3,6 +3,9 @@ import type { DiffLine } from '../diff-utils.js';
 export declare const Divider: FC<{
     width?: number;
 }>;
+export declare const BOX_HEADER_ROWS = 5;
+export declare const COMPACT_HEADER_ROWS = 1;
+export declare const WIZARD_PADDING_ROWS = 2;
 export declare const SpinnerLine: FC<{
     text: string;
 }>;
@@ -13,6 +16,12 @@ export declare const SuccessLine: FC<{
 export declare const ErrorLine: FC<{
     text: string;
 }>;
+export type AiResultKind = 'already_analyzed' | 'too_big' | 'error';
+export declare const AiResultBanner: FC<{
+    kind: AiResultKind;
+    message: string;
+    dense?: boolean;
+}>;
 /**
  * Custom TextInput that filters out specific characters (e.g. '=').
  * @inkjs/ui's TextInput is uncontrolled and can't filter keystrokes,
@@ -24,7 +33,55 @@ export declare const FilteredTextInput: FC<{
     mask?: boolean;
     onSubmit: (value: string) => void;
 }>;
-export declare const Header: FC;
+export declare const Header: FC<{
+    compact?: boolean;
+}>;
+/**
+ * Scrollable, fullscreen viewer for the AI build-analysis markdown when it
+ * is taller than the user's terminal viewport. Mirrors the shape of the
+ * workflow-file diff viewer on main, but for pre-rendered ANSI lines (no
+ * `add`/`del` colouring — the markdown renderer already styled them).
+ *
+ * Keybindings:
+ *   ↑/k        scroll one line up
+ *   ↓/j        scroll one line down
+ *   PgUp/u     jump up one viewport
+ *   PgDn/d/␣   jump down one viewport
+ *   Home/g     jump to top
+ *   End/G      jump to bottom
+ *   Esc/Enter  dismiss the viewer (returns control to the parent step)
+ */
+export declare const FullscreenAiViewer: FC<{
+    title: string;
+    subtitle?: string;
+    lines: string[];
+    terminalRows: number;
+    onExit: () => void;
+}>;
+export declare function isBuildCompleteDismissKey(input: string, key: {
+    return?: boolean;
+    escape?: boolean;
+}): boolean;
+export interface BuildScrollState {
+    scrollOffset: number;
+    follow: boolean;
+}
+export declare function buildScrollAction(input: string, key: {
+    upArrow?: boolean;
+    downArrow?: boolean;
+    pageUp?: boolean;
+    pageDown?: boolean;
+}, state: {
+    scrollOffset: number;
+    maxScrollOffset: number;
+    viewportRows: number;
+}): BuildScrollState | null;
+export declare function formatElapsed(ms: number): string;
+export declare const FullscreenBuildOutput: FC<{
+    title: string;
+    lines: string[];
+    terminalRows: number;
+}>;
 /**
  * Minimal bordered table component for the confirm-secrets-push step.
  *

package/dist/src/build/onboarding/ui/frame-fit.d.ts

@@ -0,0 +1,10 @@
+export type PlatformPickerLayout = 'cards' | 'list';
+export declare const PLATFORM_CARDS_MIN_COLS = 44;
+export declare const PLATFORM_CARDS_MIN_ROWS = 16;
+export declare function pickPlatformLayout(cols: number, rows: number): PlatformPickerLayout;
+export declare function logBudgetRows(terminalRows: number, headerRows: number, bodyHeight: number): number;
+export interface CappedLog<T> {
+    hidden: number;
+    visible: T[];
+}
+export declare function capLogRows<T>(entries: T[], maxRows: number): CappedLog<T>;

package/dist/src/build/onboarding/ui/min-size-gate.d.ts

@@ -0,0 +1,20 @@
+import type { FC, ReactNode } from 'react';
+export interface TerminalTooSmallPromptProps {
+    cols: number;
+    rows: number;
+    /** Minimum columns this screen needs. Defaults to the full onboarding floor;
+     *  the platform picker passes its smaller PICKER_MIN_COLS. */
+    minCols?: number;
+    /** Minimum rows this screen needs. Defaults to the full onboarding floor; the
+     *  platform picker passes its smaller PICKER_MIN_ROWS. So the prompt always
+     *  states the floor of the screen that's actually too small (e.g. "11 rows" on
+     *  the picker, not the wizard's 49). */
+    minRows?: number;
+}
+export declare const TerminalTooSmallPrompt: FC<TerminalTooSmallPromptProps>;
+export interface MinSizeGateProps {
+    cols: number;
+    rows: number;
+    children: ReactNode;
+}
+export declare const MinSizeGate: FC<MinSizeGateProps>;

package/dist/src/build/onboarding/ui/platform-picker.d.ts

@@ -0,0 +1,19 @@
+import type { FC } from 'react';
+import type { Platform } from '../types.js';
+import type { PlatformPickerLayout } from './frame-fit.js';
+export type PlatformKeyAction = {
+    type: 'select';
+    platform: Platform;
+} | {
+    type: 'confirm';
+} | null;
+export declare function platformKeyAction(input: string, key: {
+    leftArrow?: boolean;
+    rightArrow?: boolean;
+    return?: boolean;
+}): PlatformKeyAction;
+export interface PlatformPickerProps {
+    layout: PlatformPickerLayout;
+    onSelect: (platform: Platform) => void;
+}
+export declare const PlatformPicker: FC<PlatformPickerProps>;

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

@@ -0,0 +1,23 @@
+import type { FC } from 'react';
+import type { OnboardingResult, Platform } from '../types.js';
+export declare function useTerminalSize(): {
+    cols: number;
+    rows: number;
+};
+export interface OnboardingShellProps {
+    appId: string;
+    iosDir: string;
+    androidDir: string;
+    apikey?: string;
+    /** Pre-resolved platform (--platform flag or the single existing native dir); skips the picker. */
+    initialPlatform?: Platform;
+    /** Called once a platform is chosen so the caller can print the completion breadcrumb. */
+    onResolvePlatform?: (platform: Platform) => 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
+     *  caller treats it as cancelled. */
+    onResult?: (result: OnboardingResult) => void;
+}
+declare const OnboardingShell: FC<OnboardingShellProps>;
+export default OnboardingShell;

package/dist/src/build/onboarding/ui/steps/android-ci.d.ts

@@ -0,0 +1,45 @@
+import type { FC } from 'react';
+import type { CiSecretSetupAdvice } from '../../ci-secrets.js';
+export interface SelectOption {
+    label: string;
+    value: string;
+}
+export declare const SavingCredentialsStep: FC;
+export declare const DetectingCiSecretsStep: FC;
+export interface CiSecretsSetupStepProps {
+    advice: CiSecretSetupAdvice[];
+    onChoose: (choice: 'retry' | 'skip') => void;
+    dense?: boolean;
+}
+export declare const CiSecretsSetupStep: FC<CiSecretsSetupStepProps>;
+export interface CiSecretsTargetSelectStepProps {
+    options: SelectOption[];
+    onChange: (value: string) => void;
+    dense?: boolean;
+}
+export declare const CiSecretsTargetSelectStep: FC<CiSecretsTargetSelectStepProps>;
+export interface AskCiSecretsStepProps {
+    entryCount: number;
+    targetLabel: string;
+    cli: string;
+    onChoose: (choice: 'yes' | 'no') => void;
+    dense?: boolean;
+}
+export declare const AskCiSecretsStep: FC<AskCiSecretsStepProps>;
+export interface ConfirmCiSecretOverwriteStepProps {
+    existingKeys: string[];
+    onChoose: (choice: 'replace' | 'skip') => void;
+    dense?: boolean;
+}
+export declare const ConfirmCiSecretOverwriteStep: FC<ConfirmCiSecretOverwriteStepProps>;
+export interface CiSecretsFailedStepProps {
+    error: string | null;
+    onChoose: (choice: 'retry' | 'continue') => void;
+    dense?: boolean;
+}
+export declare const CiSecretsFailedStep: FC<CiSecretsFailedStepProps>;
+export interface AskBuildStepProps {
+    onChoose: (choice: 'yes' | 'no') => void;
+    dense?: boolean;
+}
+export declare const AskBuildStep: FC<AskBuildStepProps>;

package/dist/src/build/onboarding/ui/steps/android-keystore.d.ts

@@ -0,0 +1,75 @@
+import type { FC } from 'react';
+export type KeystoreMethodChoice = 'existing' | 'generate' | 'learn';
+export interface KeystoreMethodSelectStepProps {
+    onChoose: (choice: KeystoreMethodChoice) => void;
+    dense?: boolean;
+}
+export declare const KeystoreMethodSelectStep: FC<KeystoreMethodSelectStepProps>;
+export interface KeystoreExplainerStepProps {
+    onBack: () => void;
+    dense?: boolean;
+}
+export declare const KeystoreExplainerStep: FC<KeystoreExplainerStepProps>;
+export interface KeystoreExistingPathStepProps {
+    /** When true, render the picker-vs-manual chooser; else the path text input. */
+    showChooser: boolean;
+    onChoosePicker: () => void;
+    onChooseManual: () => void;
+    onSubmitPath: (value: string) => void;
+    dense?: boolean;
+}
+export declare const KeystoreExistingPathStep: FC<KeystoreExistingPathStepProps>;
+export declare const KeystoreExistingPickerStep: FC;
+export interface KeystoreExistingStorePasswordStepProps {
+    onSubmit: (value: string) => void;
+    dense?: boolean;
+}
+export declare const KeystoreExistingStorePasswordStep: FC<KeystoreExistingStorePasswordStepProps>;
+export declare const KeystoreExistingDetectingAliasStep: FC;
+export interface KeystoreExistingAliasSelectStepProps {
+    aliases: string[];
+    onSelect: (alias: string) => void;
+    dense?: boolean;
+}
+export declare const KeystoreExistingAliasSelectStep: FC<KeystoreExistingAliasSelectStepProps>;
+export interface KeystoreExistingAliasStepProps {
+    onSubmit: (value: string) => void;
+    dense?: boolean;
+}
+export declare const KeystoreExistingAliasStep: FC<KeystoreExistingAliasStepProps>;
+export interface KeystoreExistingKeyPasswordStepProps {
+    /** `probing` shows a spinner while we auto-detect; `prompt` asks the user. */
+    mode: 'probing' | 'prompt';
+    onSubmit: (value: string) => void;
+    dense?: boolean;
+}
+export declare const KeystoreExistingKeyPasswordStep: FC<KeystoreExistingKeyPasswordStepProps>;
+export interface KeystoreNewAliasStepProps {
+    onSubmit: (value: string) => void;
+    dense?: boolean;
+}
+export declare const KeystoreNewAliasStep: FC<KeystoreNewAliasStepProps>;
+export type KeystorePasswordMethodChoice = 'random' | 'manual';
+export interface KeystoreNewPasswordMethodStepProps {
+    onChoose: (choice: KeystorePasswordMethodChoice) => void;
+    dense?: boolean;
+}
+export declare const KeystoreNewPasswordMethodStep: FC<KeystoreNewPasswordMethodStepProps>;
+export interface KeystoreNewStorePasswordStepProps {
+    onSubmit: (value: string) => void;
+    dense?: boolean;
+}
+export declare const KeystoreNewStorePasswordStep: FC<KeystoreNewStorePasswordStepProps>;
+export interface KeystoreNewKeyPasswordStepProps {
+    onSubmit: (value: string) => void;
+    dense?: boolean;
+}
+export declare const KeystoreNewKeyPasswordStep: FC<KeystoreNewKeyPasswordStepProps>;
+export interface KeystoreNewCommonNameStepProps {
+    /** Placeholder shown for the default (the app id). */
+    appId: string;
+    onSubmit: (value: string) => void;
+    dense?: boolean;
+}
+export declare const KeystoreNewCommonNameStep: FC<KeystoreNewCommonNameStepProps>;
+export declare const KeystoreGeneratingStep: FC;