@capgo/cli 8.14.1 → 8.15.0

package/README.md

@@ -75,6 +75,7 @@ Follow the documentation here: https://capacitorjs.com/docs/getting-started/
   - [Needed](#build-needed)
   - [Init](#build-init)
   - [Request](#build-request)
+  - [Prescan](#build-prescan)
   - [Last-output](#build-last-output)
   - [Credentials](#build-credentials)
     - [Apple-key](#build-credentials-apple-key)
@@ -1299,12 +1300,40 @@ npx @capgo/cli@latest build request com.example.app --platform ios --path .
 | **--skip-build-number-bump** | <code>boolean</code> | Skip automatic build number/version code incrementing. Uses whatever version is already in the project files. |
 | **--no-skip-build-number-bump** | <code>boolean</code> | Override saved credentials to re-enable automatic build number incrementing for this build only. |
 | **--ai-analytics** | <code>boolean</code> | On build failure, send logs to Capgo AI for diagnosis. In interactive terminals this skips the upfront confirmation; in CI this auto-uploads and prints the analysis to stderr. |
+| **--no-prescan** | <code>boolean</code> | Skip the automatic pre-build scan |
+| **--prescan-ignore-fatal** | <code>boolean</code> | Run the pre-build scan but never block the build (report only) |
+| **--fail-on-warnings** | <code>boolean</code> | Treat prescan warnings as fatal |
 | **--send-logs** | <code>boolean</code> | On a CI/CD build failure, automatically upload the build logs to Capgo support (no email required). Capgo support is notified and will follow up by email. Additive to --ai-analytics — both can be passed. |
 | **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 | **--verbose** | <code>boolean</code> | Enable verbose output with detailed logging |
 
+### <a id="build-prescan"></a> 🔹 **Prescan**
+
+```bash
+npx @capgo/cli@latest build prescan
+```
+
+Scan your project and saved credentials for problems that would fail a cloud build — before uploading anything.
+Checks credentials (expiry, passwords, profile pairing), project state (cap sync, node_modules layout), and platform config. Runs automatically inside `build request`; this command runs it standalone (e.g. in CI).
+
+**Options:**
+
+| Param          | Type          | Description          |
+| -------------- | ------------- | -------------------- |
+| **--platform** | <code>string</code> | Target platform: ios or android (required) |
+| **--path** | <code>string</code> | Path to the project directory (default: current directory) |
+| **-a** | <code>string</code> | API key to link to your account |
+| **--android-flavor** | <code>string</code> | Android: product flavor the build will use |
+| **--ios-dist** | <code>string</code> | iOS: distribution mode to validate against |
+| **--json** | <code>boolean</code> | Output a machine-readable JSON report |
+| **--fail-on-warnings** | <code>boolean</code> | Exit non-zero when warnings are found (CI) |
+| **--ignore-fatal** | <code>boolean</code> | Diagnostic mode: report everything but always exit 0 |
+| **--verbose** | <code>boolean</code> | Enable verbose output with detailed logging |
+| **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
+| **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
+
 ### <a id="build-last-output"></a> 🔹 **Last-output**
 
 ```bash