eas-cli 20.2.0 → 20.4.0

package/build/commandUtils/new/templates/AGENTS.md

@@ -1,162 +1,41 @@
-# AGENTS.md
-
-## Project Overview
-
 This is an Expo/React Native mobile application. Prioritize mobile-first patterns, performance, and cross-platform compatibility.
 
-## Documentation Resources
-
-When working on this project, **always consult the official Expo documentation** available at:
-
-- **https://docs.expo.dev/llms.txt** - Index of all available documentation files
-- **https://docs.expo.dev/llms-full.txt** - Complete Expo documentation including Expo Router, Expo Modules API, development process
-- **https://docs.expo.dev/llms-eas.txt** - Complete EAS (Expo Application Services) documentation
-- **https://docs.expo.dev/llms-sdk.txt** - Complete Expo SDK documentation
-- **https://reactnative.dev/docs/getting-started** - Complete React Native documentation
-
-These documentation files are specifically formatted for AI agents and should be your **primary reference** for:
+## Expo has changed — do not trust your training data
 
-- Expo APIs and best practices
-- Expo Router navigation patterns
-- EAS Build, Submit, and Update workflows
-- Expo SDK modules and their usage
-- Development and deployment processes
+Expo ships breaking changes every SDK release. APIs you remember are likely renamed, moved, or removed. Before writing any code that touches an Expo, EAS, or React Native API:
 
-## Project Structure
+1. Read the major version of the `expo` package in `package.json`.
+2. Fetch the matching versioned docs: `https://docs.expo.dev/versions/v<major>.0.0/`
+3. For anything else, fetch https://docs.expo.dev/llms.txt — an index of all Expo docs with corrections to common LLM misconceptions. Follow its links to the specific page you need; never answer from memory.
 
-```
-/
-├── app/                   # Expo Router file-based routing
-│   ├── (tabs)/            # Tab-based navigation screens
-│   │   ├── index.tsx      # Home screen
-│   │   ├── explore.tsx    # Explore screen
-│   │   └── _layout.tsx    # Tabs layout
-│   ├── _layout.tsx        # Root layout with theme provider
-│   └── modal.tsx          # Modal screen example
-├── components/            # Reusable React components
-│   ├── ui/                # UI primitives (IconSymbol, Collapsible)
-│   └── ...                # Feature components (themed, haptic, parallax)
-├── constants/             # App-wide constants (theme, colors)
-├── hooks/                 # Custom React hooks (color scheme, theme)
-├── assets/                # Static assets (images, fonts)
-├── scripts/               # Utility scripts (reset-project)
-├── .eas/workflows/        # EAS Workflows (CI/CD automation)
-├── app.json               # Expo configuration
-├── eas.json               # EAS Build/Submit configuration
-└── package.json           # Dependencies and scripts
-```
-
-## Essential Commands
+## Commands
 
-### Development
+Use `bunx` instead of `npx` if the project uses bun (`bun.lock` present).
 
 ```bash
-npx expo start                  # Start dev server
-npx expo start --clear          # Clear cache and start dev server
-npx expo install <package>      # Install packages with compatible versions
-npx expo install --check        # Check which installed packages need to be updated
-npx expo install --fix          # Automatically update any invalid package versions
-npm run development-builds      # Create development builds (workflow)
-npm run reset-project           # Reset to blank template
+npx expo install <package>  # ALWAYS use instead of npm/yarn/pnpm/bun add — resolves SDK-compatible versions
+npx expo start              # start the dev server
+npx expo lint               # lint
+npx tsc --noEmit            # typecheck
+npx expo-doctor             # diagnose dependency and config issues
+npx expo install --fix      # fix incompatible package versions
 ```
 
-### Building & Testing
-
-```bash
-npx expo doctor      # Check project health and dependencies
-npx expo lint        # Run ESLint
-npm run draft        # Publish preview update and website (workflow)
-```
-
-### Production
-
-```bash
-npx eas-cli@latest build --platform ios -s          # Use EAS to build for iOS platform and submit to App Store
-npx eas-cli@latest build --platform android -s      # Use EAS to build for Android platform and submit to Google Play Store
-npm run deploy                                      # Deploy to production (workflow)
-```
-
-## Development Guidelines
-
-### Code Style & Standards
-
-- **TypeScript First**: Use TypeScript for all new code with strict type checking
-- **Naming Conventions**: Use meaningful, descriptive names for variables, functions, and components
-- **Self-Documenting Code**: Write clear, readable code that explains itself; only add comments for complex business logic or design decisions
-- **React 19 Patterns**: Follow modern React patterns including:
-  - Function components with hooks
-  - Enable React Compiler
-  - Proper dependency arrays in useEffect
-  - Memoization when appropriate (useMemo, useCallback)
-  - Error boundaries for better error handling
-
-### Navigation & Routing
-
-- Use **Expo Router** for all navigation
-- Import `Link`, `router`, and `useLocalSearchParams` from `expo-router`
-- Docs: https://docs.expo.dev/router/introduction/
-
-### Recommended Libraries
-
-- **Navigation**: `expo-router` for navigation
-- **Images**: `expo-image` for optimized image handling and caching
-- **Animations**: `react-native-reanimated` for performant animations on native thread
-- **Gestures**: `react-native-gesture-handler` for native gesture recognition
-- **Storage**: Use `expo-sqlite` for persistent storage, `expo-sqlite/kv-store` for simple key-value storage
-
-## Debugging & Development Tools
-
-### DevTools Integration
-
-- **React Native DevTools**: Use MCP `open_devtools` command to launch debugging tools
-- **Network Inspection**: Monitor API calls and network requests in DevTools
-- **Element Inspector**: Debug component hierarchy and styles
-- **Performance Profiler**: Identify performance bottlenecks
-- **Logging**: Use `console.log` for debugging (remove before production), `console.warn` for deprecation notices, `console.error` for actual errors, and implement error boundaries for production error handling
-
-### Testing & Quality Assurance
-
-#### Automated Testing with MCP Tools
-
-Developers can configure the Expo MCP server with the following doc: https://docs.expo.dev/eas/ai/mcp/
-
-- **Component Testing**: Add `testID` props to components for automation
-- **Visual Testing**: Use MCP `automation_take_screenshot` to verify UI appearance
-- **Interaction Testing**: Use MCP `automation_tap_by_testid` to simulate user interactions
-- **View Verification**: Use MCP `automation_find_view_by_testid` to validate component rendering
-
-## EAS Workflows CI/CD
-
-This project is pre-configured with **EAS Workflows** for automating development and release processes. Workflows are defined in `.eas/workflows/` directory.
-
-When working with EAS Workflows, **always refer to**:
-
-- https://docs.expo.dev/eas/workflows/ for workflow examples
-- The `.eas/workflows/` directory for existing workflow configurations
-- You can check that a workflow YAML is valid using the workflows schema: https://exp.host/--/api/v2/workflows/schema
-
-### Build Profiles (eas.json)
-
-- **development**: Development builds with dev client
-- **development-simulator**: Development builds for iOS simulator
-- **preview**: Internal distribution preview builds
-- **production**: Production builds with auto-increment
-
-## Troubleshooting
-
-### Expo Go Errors & Development Builds
+Run lint and typecheck before declaring any task done.
 
-If there are errors in **Expo Go** or the project is not running, create a **development build**. **Expo Go** is a sandbox environment with a limited set of native modules. To create development builds, run `eas build:dev`. Additionally, after installing new packages or adding config plugins, new development builds are often required.
+## Navigation & Routing
 
-## AI Agent Instructions
+- Use **Expo Router** for all navigation. Routes live in `src/app/` — every file there is a screen, `_layout.tsx` files define navigators. Keep non-route code (components, hooks, utils) outside `src/app/`.
+- Import `Link`, `router`, and `useLocalSearchParams` from `expo-router`.
+- Docs: https://docs.expo.dev/router/introduction.md
 
-When working on this project:
+## Building with EAS
 
-1. **Always start by consulting the appropriate documentation**:
-   - For general Expo questions: https://docs.expo.dev/llms-full.txt
-   - For EAS/deployment questions: https://docs.expo.dev/llms-eas.txt
-   - For SDK/API questions: https://docs.expo.dev/llms-sdk.txt
+Use EAS to build, sign, and submit the app in the cloud (`eas build`, `eas submit`) and to ship over-the-air updates (`eas update`) — no local Xcode or Android Studio required. Run EAS CLI as `bunx eas-cli <command>` in Bun projects, or `npx eas-cli@latest <command>` otherwise; substitute that for bare `eas` in docs examples.
+Docs: https://docs.expo.dev/eas/index.md
 
-2. **Understand before implementing**: Read the relevant docs section before writing code
+## Rules
 
-3. **Follow existing patterns**: Look at existing components and screens for patterns to follow
+- If `ios/` and `android/` directories do not exist, they are generated (Continuous Native Generation). Never create or edit them by hand — configure native behavior in `app.json` and config plugins.
+- Expo Go only includes its bundled native modules. After adding a library with native code, the app needs a development build: `npx expo run:ios|android` locally, or `eas build --profile development`.
+- Prefer recommended Expo modules over third-party libraries, and check your available skills before adding dependencies. Docs: https://docs.expo.dev/versions/latest/index.md

package/build/commandUtils/new/templates/CLAUDE.md

@@ -1,9 +1 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-**Note**: This project uses `AGENTS.md` files for detailed guidance.
-
-## Primary Reference
-
-Please see `AGENTS.md` in this same directory for the main project documentation and guidance.
+@AGENTS.md

package/build/commandUtils/posthog.d.ts

@@ -0,0 +1,4 @@
+import { PostHogProjectData } from '../graphql/types/PostHogConnection';
+export declare function getPostHogProjectDashboardUrl(project: PostHogProjectData): string;
+export declare function formatPostHogProject(project: PostHogProjectData): string;
+export declare function logNoPostHogProject(projectName: string): void;

package/build/commandUtils/posthog.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPostHogProjectDashboardUrl = getPostHogProjectDashboardUrl;
+exports.formatPostHogProject = formatPostHogProject;
+exports.logNoPostHogProject = logNoPostHogProject;
+const tslib_1 = require("tslib");
+const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const log_1 = tslib_1.__importStar(require("../log"));
+function getPostHogProjectDashboardUrl(project) {
+    const host = project.posthogHost.replace(/\/$/, '');
+    return `${host}/project/${encodeURIComponent(project.posthogProjectIdentifier)}`;
+}
+function formatPostHogProject(project) {
+    return [
+        `${chalk_1.default.bold('Name')}: ${project.posthogProjectName}`,
+        `${chalk_1.default.bold('Host')}: ${project.posthogHost}`,
+        `${chalk_1.default.bold('Region')}: ${project.posthogOrganizationConnection.posthogRegion}`,
+        `${chalk_1.default.bold('Dashboard')}: ${(0, log_1.link)(getPostHogProjectDashboardUrl(project), { dim: false })}`,
+    ].join('\n');
+}
+function logNoPostHogProject(projectName) {
+    log_1.default.warn(`No PostHog project is linked to Expo app ${chalk_1.default.bold(projectName)} on EAS.`);
+}

package/build/commands/account/audit.d.ts

@@ -0,0 +1,17 @@
+import EasCommand from '../../commandUtils/EasCommand';
+export default class AccountAudit extends EasCommand {
+    static description: string;
+    static args: {
+        ACCOUNT_NAME: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        'non-interactive': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined>;
+        after: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    static contextDefinition: {
+        loggedIn: import("../../commandUtils/context/LoggedInContextField").default;
+    };
+    runAsync(): Promise<void>;
+}

package/build/commands/account/audit.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const EasCommand_1 = tslib_1.__importDefault(require("../../commandUtils/EasCommand"));
+const flags_1 = require("../../commandUtils/flags");
+const pagination_1 = require("../../commandUtils/pagination");
+const AuditLogQuery_1 = require("../../graphql/queries/AuditLogQuery");
+const log_1 = tslib_1.__importDefault(require("../../log"));
+const ora_1 = require("../../ora");
+const prompts_1 = require("../../prompts");
+const json_1 = require("../../utils/json");
+const renderTextTable_1 = tslib_1.__importDefault(require("../../utils/renderTextTable"));
+const AUDIT_LOGS_LIMIT = 50;
+class AccountAudit extends EasCommand_1.default {
+    static description = 'view the audit logs for an account';
+    static args = {
+        ACCOUNT_NAME: core_1.Args.string({
+            description: 'Account name to view audit logs for. If not provided, the account will be selected interactively (or defaults to the only account if there is just one)',
+        }),
+    };
+    static flags = {
+        limit: (0, pagination_1.getLimitFlagWithCustomValues)({ defaultTo: AUDIT_LOGS_LIMIT, limit: 100 }),
+        after: core_1.Flags.string({
+            description: 'Cursor for pagination. Use the endCursor from a previous query to fetch the next page.',
+        }),
+        ...flags_1.EasJsonOnlyFlag,
+        ...flags_1.EASNonInteractiveFlag,
+    };
+    static contextDefinition = {
+        ...this.ContextOptions.LoggedIn,
+    };
+    async runAsync() {
+        const { args: { ACCOUNT_NAME: accountName }, flags: { limit, after, json: jsonFlag, 'non-interactive': nonInteractive }, } = await this.parse(AccountAudit);
+        const json = jsonFlag || nonInteractive;
+        if (json) {
+            (0, json_1.enableJsonOutput)();
+        }
+        const { loggedIn: { graphqlClient, actor }, } = await this.getContextAsync(AccountAudit, { nonInteractive });
+        const pageSize = limit ?? AUDIT_LOGS_LIMIT;
+        let targetAccount;
+        const availableAccounts = actor.accounts.map(a => a.name).join(', ');
+        if (accountName) {
+            const found = actor.accounts.find(a => a.name === accountName);
+            if (!found) {
+                throw new Error(`Account "${accountName}" not found or you don't have access. Available accounts: ${availableAccounts}`);
+            }
+            targetAccount = found;
+        }
+        else if (nonInteractive) {
+            throw new Error('ACCOUNT_NAME argument must be provided when running in `--non-interactive` mode.');
+        }
+        else if (actor.accounts.length === 1) {
+            targetAccount = actor.accounts[0];
+        }
+        else {
+            targetAccount = await (0, prompts_1.selectAsync)('Select account to view audit logs for:', actor.accounts.map(account => ({
+                title: account.name,
+                value: account,
+            })));
+        }
+        if (json) {
+            const spinner = (0, ora_1.ora)(`Fetching audit logs for account ${targetAccount.name}`).start();
+            try {
+                const connection = await AuditLogQuery_1.AuditLogQuery.getAllForAccountAsync(graphqlClient, targetAccount.id, {
+                    first: pageSize,
+                    after,
+                });
+                spinner.stop();
+                (0, json_1.printJsonOnlyOutput)({
+                    auditLogs: connection.edges.map(edge => edge.node),
+                    pageInfo: connection.pageInfo,
+                });
+            }
+            catch (error) {
+                spinner.fail(`Failed to fetch audit logs for account ${targetAccount.name}`);
+                throw error;
+            }
+            return;
+        }
+        let cursor = after;
+        do {
+            const spinner = (0, ora_1.ora)(`Fetching audit logs for account ${targetAccount.name}`).start();
+            const connection = await AuditLogQuery_1.AuditLogQuery.getAllForAccountAsync(graphqlClient, targetAccount.id, {
+                first: pageSize,
+                after: cursor,
+            });
+            spinner.stop();
+            const logs = connection.edges.map(edge => edge.node);
+            renderPageOfAuditLogs(logs);
+            if (!connection.pageInfo.hasNextPage) {
+                break;
+            }
+            cursor = connection.pageInfo.endCursor ?? undefined;
+        } while (cursor && (await (0, prompts_1.confirmAsync)({ message: 'Load more audit logs?' })));
+    }
+}
+exports.default = AccountAudit;
+function renderPageOfAuditLogs(logs) {
+    if (logs.length === 0) {
+        log_1.default.log('No audit logs found.');
+        return;
+    }
+    log_1.default.log((0, renderTextTable_1.default)(['Date', 'Actor', 'Action', 'Entity', 'Message'], logs.map(log => [
+        new Date(log.createdAt).toLocaleString(),
+        log.actor?.displayName ?? 'Unknown',
+        log.targetEntityMutationType,
+        log.targetEntityTypePublicName,
+        log.websiteMessage,
+    ])));
+    log_1.default.addNewLineIfNone();
+}

package/build/commands/integrations/posthog/connect.d.ts

@@ -0,0 +1,27 @@
+import EasCommand from '../../../commandUtils/EasCommand';
+export default class IntegrationsPostHogConnect extends EasCommand {
+    static description: string;
+    static contextDefinition: {
+        loggedIn: import("../../../commandUtils/context/LoggedInContextField").default;
+        privateProjectConfig: import("../../../commandUtils/context/PrivateProjectConfigContextField").PrivateProjectConfigContextField;
+    };
+    static flags: {
+        region: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'session-replay': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'error-tracking': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'posthog-cli-api-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        overwrite: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'non-interactive': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    runAsync(): Promise<void>;
+    private resolveFeaturesAsync;
+    private resolveCliApiKeyAsync;
+    private resolveRegionAsync;
+    private installSdkPackagesAsync;
+    private addConfigPluginAsync;
+    private writeEnvLocalAsync;
+    private mergeEnvContent;
+    private upsertEasEnvVarAsync;
+    private printNextSteps;
+}