vybekiit 0.7.29 → 0.7.32

package/dist/global-skills/firebase-auth-basics/SKILL.md

@@ -4,6 +4,7 @@ description: Guide for setting up and using Firebase Authentication. Use this sk
 compatibility: This skill is best used with the Firebase CLI, but does not require it. Firebase CLI can be accessed through `npx -y firebase-tools@latest`.
 metadata:
   category: Identity
+disable-model-invocation: true
 ---
 
 ## Prerequisites
@@ -74,7 +75,7 @@ Configure Firebase Authentication in `firebase.json` by adding an 'auth' block:
         "supportEmail": "support@example.com",
         "authorizedRedirectUris": [
           "https://my-project-id.firebaseapp.com/__/auth/handler",
-          "http://localhost:4000"
+          "http://localhost"
         ]
       }
     }
@@ -84,11 +85,15 @@ Configure Firebase Authentication in `firebase.json` by adding an 'auth' block:
 
 > [!NOTE] If the Google Sign-In popup opens and immediately closes with the
 > error `[firebase_auth/unauthorized-domain]`, it means the domain is not
-> authorized. For local development, ensure `localhost` is included in the
-> **Authorized Domains** list in the Firebase Console (Authentication >
-> Settings > Authorized domains). **CRITICAL**: Do NOT include the protocol or
-> port number in the Authorized Domains list (e.g., use `localhost`, NOT
-> `http://localhost:9090`).
+> authorized. For local development, add `http://localhost` to
+> `authorizedRedirectUris` in `firebase.json` (or ensure `localhost` is included
+> in the **Authorized Domains** list in the Firebase Console under
+> Authentication > Settings > Authorized domains). **CRITICAL**: Do NOT include
+> the port number in `authorizedRedirectUris` (e.g., use `http://localhost`, NOT
+> `http://localhost:9090` or `http://localhost:4000`), and do NOT include the
+> protocol or port number in the Console Authorized Domains list (use
+> `localhost`). Including a port number in `authorizedRedirectUris` causes
+> `firebase deploy --only auth` to fail with `INVALID_AUTHORIZED_DOMAIN`.
 
 **CRITICAL**: After configuring `firebase.json`, you MUST deploy the auth
 configuration to the Firebase backend for the changes to take effect. This is

package/dist/global-skills/firebase-auth-basics/references/client_sdk_android.md

@@ -1,12 +1,26 @@
-# Firebase Authentication on Android (Kotlin)
+# Firebase Authentication - Android Setup Guide (Kotlin)
 
-This guide walks you through using Firebase Authentication in your Android app
-using Kotlin DSL (`build.gradle.kts`) and Kotlin code.
+This guide describes the SDK setup and basic usage patterns for
+Firebase Authentication in an Android app using
+Kotlin DSL (`build.gradle.kts`) and Kotlin code.
 
-### 1, Enable Authentication via CLI
+## Prerequisites
 
-Before adding dependencies in your app, make sure you enable the Auth service in
-your Firebase Project using the Firebase CLI:
+IMPORTANT: Before specifically working with Firebase Authentication, make sure
+to use the skill and reference `firebase_basics/references/android_setup` to
+ensure the following is done.
+
+- The Firebase CLI is available and authenticated.
+- An Android project exists and is registered with a Firebase Project.
+- The Android project has a Firebase config file (`google-services.json`) and
+  the Google services Gradle plugin (`google-services`).
+
+______________________________________________________________________
+
+## 1. Enable Authentication via CLI
+
+Enable the Firebase Authentication service in the Firebase Project using the
+Firebase CLI:
 
 ```bash
 npx -y firebase-tools@latest init auth
@@ -14,27 +28,48 @@ npx -y firebase-tools@latest init auth
 
 ______________________________________________________________________
 
-### 2. Add Dependencies
-
-In your module-level `build.gradle.kts` (usually `app/build.gradle.kts`), add
-the dependency for Firebase Authentication:
+## 2. Add dependencies to Gradle build files
+
+> [!IMPORTANT] **[AGENT] RESOLVING THE SDK VERSION DETERMINISTICALLY**
+> Never guess or hardcode a memorized out-of-date SDK or plugin version.
+> Before adding dependencies, you MUST query the latest available versions
+> directly from the Google Maven Repository:
+>
+> ```bash
+> # Find the latest Firebase Android BoM version
+> curl -s https://dl.google.com/dl/android/maven2/com/google/firebase/firebase-bom/maven-metadata.xml | grep -oE '<latest>[^<]+' | cut -d'>' -f2
+>
+> # Find the latest firebase-auth version
+> curl -s https://dl.google.com/dl/android/maven2/com/google/firebase/firebase-auth/maven-metadata.xml | grep -oE '<latest>[^<]+' | cut -d'>' -f2
+> ```
+>
+> If the dependency is already declared, fetch the exact resolved version
+> currently active in the workspace's build graph:
+>
+> ```bash
+> ./gradlew -q :app:dependencyInsight --dependency firebase-auth --configuration releaseRuntimeClasspath
+> ```
+
+In the **module (app-level)** `build.gradle.kts` (usually
+`<project>/<app-module>/build.gradle.kts`), add the dependency for
+Firebase Authentication:
 
 ```kotlin
 dependencies {
-    // [AGENT] Fetch the latest available BoM version from https://firebase.google.com/support/release-notes/android before adding this
+    // [AGENT] Fetch the latest resolved version using the Gradle command above
     implementation(platform("com.google.firebase:firebase-bom:<latest_bom_version>"))
 
     // Add the dependency for the Firebase Authentication library
-    // When using the BoM, you don't specify versions in Firebase library dependencies
+    // When using the BoM, don't specify versions in Firebase library dependencies
     implementation("com.google.firebase:firebase-auth")
 }
 ```
 
 ______________________________________________________________________
 
-### 3. Initialize FirebaseAuth
+## 3. Initialize FirebaseAuth
 
-In your Activity or Fragment, initialize the `FirebaseAuth` instance:
+In the Activity or Fragment, initialize the `FirebaseAuth` instance:
 
 ```kotlin
 import com.google.firebase.Firebase
@@ -48,6 +83,7 @@ class MainActivity : AppCompatActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         auth = Firebase.auth
+
         setContent {
             MaterialTheme {
                 Text("Auth initialized!")
@@ -57,7 +93,7 @@ class MainActivity : AppCompatActivity() {
 }
 ```
 
-#### Jetpack Compose (Modern)
+### Jetpack Compose (Modern)
 
 Initialize inside a `ComponentActivity` using `setContent`:
 
@@ -86,9 +122,9 @@ class MainActivity : ComponentActivity() {
 
 ______________________________________________________________________
 
-### 4. Check Current Auth State
+## 4. Check current Auth state
 
-You should check if a user is already signed in when your activity starts:
+Check if a user is already signed in when the activity starts:
 
 ```kotlin
 public override fun onStart() {
@@ -105,7 +141,11 @@ public override fun onStart() {
 
 ______________________________________________________________________
 
-### 5. Sign Up New Users (Email/Password)
+## 5. Use sign-in providers in the app
+
+### Email/Password
+
+#### Sign up NEW users with Email/Password
 
 Use `createUserWithEmailAndPassword` to register new users:
 
@@ -125,11 +165,9 @@ fun signUpUser(email: String, password: String) {
 }
 ```
 
-______________________________________________________________________
-
-### 6. Sign In Existing Users (Email/Password)
+#### Sign in EXISTING users with Email/Password
 
-Use `signInWithEmailAndPassword` to log in existing users:
+Use `signInWithEmailAndPassword` to sign in existing users:
 
 ```kotlin
 fun signInUser(email: String, password: String) {
@@ -149,7 +187,7 @@ fun signInUser(email: String, password: String) {
 
 ______________________________________________________________________
 
-### 7. Sign Out
+## 6. Sign out users
 
 To sign out a user, call `signOut()` on the `FirebaseAuth` instance:
 

package/dist/global-skills/firebase-basics/SKILL.md

@@ -4,6 +4,8 @@ description: >-
   Provides foundational Firebase CLI setup, CLI installation, version checks (`firebase-tools@latest --version`), CLI login (including --no-localhost), project creation, project selection (`firebase use`), and app config file downloads (`google-services.json`, `GoogleService-Info.plist`). Use ONLY for CLI login, project creation/switching, or downloading app config files. Don't use for Firebase Hosting deploy, Firestore, Auth, App Hosting, Data Connect, Crashlytics, or Remote Config.
 metadata:
   category: CloudInfrastructureAndServices
+  version: "1.0.0"
+disable-model-invocation: true
 ---
 
 # Prerequisites

package/dist/global-skills/firebase-basics/references/android_setup.md

@@ -1,41 +1,183 @@
-# 🛠️ Firebase Android Setup Guide
+# Firebase Android Setup Guide
 
 ______________________________________________________________________
 
-## 📋 Prerequisites
+## Prerequisites
 
-## Before running these commands, ensure you are authenticated: `npx -y firebase-tools@latest login` (or `npx -y firebase-tools@latest login --no-localhost` on remote servers)
+1.  **Firebase CLI**: Make sure the Firebase CLI is available and authenticated.
 
-## 0. Create an Android application
+    For detailed instructions about the Firebase CLI, see
+    `firebase_basics/references/local-env-setup`. Here are high-level
+    instructions for setting up the Firebase CLI.
 
-if you haven't already created an android application, create one.
+    1.  Ensure the Firebase CLI is available:
 
-## 1. Create a Firebase Project
+        ```bash
+        npx -y firebase-tools@latest --version
+        ```
 
-If you haven't already created a project, create a new cloud project with a
-unique ID:
-`npx -y firebase-tools@latest projects:create <UNIQUE_PROJECT_ID> --display-name '<DISPLAY_NAME>'`
-*Example:*
-`npx -y firebase-tools@latest projects:create my-cool-app-20260330 --display-name 'MyCoolApp'`
+    2.  Login to the CLI:
+
+        - local:
+
+          ```bash
+          npx -y firebase-tools@latest login
+          ```
+
+        - remote servers:
+
+          ```bash
+          npx -y firebase-tools@latest login --no-localhost
+          ```
+
+2.  **Android project**: Create or use an existing Android project in an
+    Android-development IDE.
+
+______________________________________________________________________
+
+## 1. Check if the Android project is connected to a Firebase Project
+
+Check if the Android project already has a `google-services.json` file in its
+**module (app-level)** root directory.
+
+### `google-services.json` file is present
+
+If the Android project already has a `google-services.json` file, do NOT create
+a new Firebase project or re-register the app — skip steps 2 through 4 below.
+Instead, verify the existing Firebase setup within the codebase and fix anything
+that is missing:
+
+- The `google-services.json` file is in the **module (app-level)** root
+  directory: `app/google-services.json`
+
+- The Google services Gradle plugin (`google-services`) is added to *both* the
+  project-level and module (app-level) Gradle build files. If it is missing from
+  either file, add it by following step 5 below.
+
+### `google-services.json` file is NOT present
+
+If the Android project does NOT already have a `google-services.json` file, then
+proceed with the remaining steps in this guide.
+
+______________________________________________________________________
+
+## 2. Create a new Firebase project or use an existing one
+
+Check if there's an existing Firebase Project available for use with the
+Android project:
+
+```bash
+npx -y firebase-tools@latest projects:list
+```
+
+- **If existing Firebase Project:**
+  Ask the human user if they want to use the existing project.
+
+- **If no existing Firebase Project or human user does not want to use an
+  existing project:**
+  Create a new Firebase Project.
+
+  Provide a required unique PROJECT_ID and an optional PROJECT_DISPLAY_NAME:
+
+  ```bash
+  npx -y firebase-tools@latest projects:create <UNIQUE_PROJECT_ID> --display-name <PROJECT_DISPLAY_NAME>
+  ```
+
+  *Example:*
 
-### 2. Register Your Android App
+  ```bash
+  npx -y firebase-tools@latest projects:create my-cool-app-20260330 --display-name MyCoolApp
+  ```
+
+______________________________________________________________________
+
+## 3. Register the Android project
+
+Register the app module (package name) of the Android project with the Firebase
+project. Provide an optional APP_DISPLAY_NAME and required PACKAGE_NAME:
+
+```bash
+npx -y firebase-tools@latest apps:create ANDROID <APP_DISPLAY_NAME> --package-name <PACKAGE_NAME> --project <PROJECT_ID>
+```
 
-Link your Android app module (package name) to your project. Notice that the
-display name is passed as a positional argument at the end:
-`npx -y firebase-tools@latest apps:create ANDROID '<APP_DISPLAY_NAME>' --package-name '<PACKAGE_NAME>' --project <PROJECT_ID>`
 *Example:*
-`npx -y firebase-tools@latest apps:create ANDROID 'MyApplication' --package-name 'com.example.myapplication' --project my-cool-app-20260330`
 
-### 3. Download `google-services.json`
+```bash
+npx -y firebase-tools@latest apps:create ANDROID MyApplication --package-name com.example.myapplication --project my-cool-app-20260330
+```
+
+NOTE: A package name is often referred to as an *application ID* within an
+Android project. Find an app's package name in the module (app-level) Gradle
+file, usually `app/build.gradle.kts`.
+
+______________________________________________________________________
+
+## 4. Obtain and save `google-services.json`
+
+1.  Fetch the Firebase configuration file (`google-services.json`) using the
+    Firebase Android APP_ID (which is printed in the output of the previous
+    `apps:create` command):
+
+    ```bash
+    npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>
+    ```
+
+2.  Save the configuration file within the **module (app-level)** root directory
+    of the Android project: `app/google-services.json`
+
+______________________________________________________________________
+
+## 5. Add the `google-services` plugin
+
+> [!IMPORTANT] **[AGENT] RESOLVING THE PLUGIN VERSION DETERMINISTICALLY**
+> Never guess or hardcode a memorized out-of-date plugin version.
+> Before adding dependencies, you MUST query the latest available versions
+> directly from the Google Maven Repository:
+>
+> ```bash
+> # Find the latest Google services Gradle plugin version
+> curl -s https://dl.google.com/dl/android/maven2/com/google/gms/google-services/maven-metadata.xml | grep -oE '<latest>[^<]+' | cut -d'>' -f2
+> ```
+
+These changes are made to the Android project's Gradle files.
+
+### Project-level `build.gradle.kts` (`<project>/build.gradle.kts`)
+
+Add the latest version of the Google services Gradle plugin to the `plugins`
+block:
+
+```kotlin
+plugins {
+    // ... other plugins
+
+    // [AGENT] Fetch the latest resolved version using the Gradle command above
+    id("com.google.gms.google-services") version "<latest_plugin_version>" apply false
+}
+```
+
+### Module (app-level) `build.gradle.kts` (`<project>/<app-module>/build.gradle.kts`)
+
+Add the Google services Gradle plugin to the `plugins` block:
+
+```kotlin
+plugins {
+    // ... other plugins
+    id("com.google.gms.google-services")
+}
+```
+
+______________________________________________________________________
 
-## Fetch the configuration file using the App ID (which is printed in the output of the previous command): `npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>` *Example output extraction to file:* ` # (Output must be saved as app/google-services.json)`
+## Verification plan
 
-## ✅ Verification Plan
+### Manual verification
 
-### Manual Verification
+Validate that the Firebase Project was created and the Firebase Android App was
+registered successfully:
 
-Validate that the project was created and registered successfully:
-`npx -y firebase-tools@latest projects:list`
-`npx -y firebase-tools@latest apps:list --project <PROJECT_ID>`
+```bash
+npx -y firebase-tools@latest projects:list
+npx -y firebase-tools@latest apps:list --project <PROJECT_ID>
+```
 
 ______________________________________________________________________

package/dist/global-skills/firebase-crashlytics/SKILL.md

@@ -4,6 +4,7 @@ description: Comprehensive guide for Firebase Crashlytics, including provisionin
 compatibility: This skill is best used with the Firebase CLI, but does not require it. Firebase CLI can be accessed through `npx -y firebase-tools@latest`.
 metadata:
   category: CloudObservabilityAndMonitoring
+disable-model-invocation: true
 ---
 
 # Crashlytics