vybekiit 0.7.26 → 0.7.27

package/dist/global-skills/firebase-data-connect/reference/config.md

@@ -36,7 +36,6 @@ Main SQL Connect service configuration:
 specVersion: "v1"
 serviceId: "my-service"
 location: "us-central1"
-schemaValidation: "STRICT" # or "COMPATIBLE"
 schema:
   source: "./schema"
   datasource:
@@ -44,6 +43,7 @@ schema:
       database: "fdcdb"
       cloudSql:
         instanceId: "my-instance"
+      schemaValidation: "STRICT" # or "COMPATIBLE"
 connectorDirs: ["./connector"]
 ```
 
@@ -52,7 +52,7 @@ connectorDirs: ["./connector"]
 | `specVersion`       | Always `"v1"`                                                                            |
 | `serviceId`         | Unique identifier for the service                                                        |
 | `location`          | GCP region (us-central1, us-east4, europe-west1, etc.)                                   |
-| `schemaValidation`  | Deployment mode: `"STRICT"` (must match exactly) or `"COMPATIBLE"` (backward compatible) |
+| `schema.datasource.postgresql.schemaValidation` | Deployment mode: `"STRICT"` (must match exactly) or `"COMPATIBLE"` (backward compatible) |
 | `schema.source`     | Path to schema directory                                                                 |
 | `schema.datasource` | PostgreSQL connection config                                                             |
 | `connectorDirs`     | List of connector directories                                                            |
@@ -85,6 +85,7 @@ generate:
     package: "com.myapp.dataconnect"
   swiftSdk:
     outputDir: "../ios/MyApp/DataConnect"
+    package: "DataConnectGenerated"
 ```
 
 ### SDK Generation Options
@@ -93,8 +94,8 @@ generate:
 | --------------- | -------------------------------------- |
 | `javascriptSdk` | `outputDir`, `package`                 |
 | `kotlinSdk`     | `outputDir`, `package`                 |
-| `swiftSdk`      | `outputDir`                            |
-| `nodeAdminSdk`  | `outputDir`, `package` (for Admin SDK) |
+| `swiftSdk`      | `outputDir`, `package`                 |
+| `adminNodeSdk`  | `outputDir`, `package` (for Admin SDK) |
 
 ______________________________________________________________________
 

package/dist/global-skills/firebase-data-connect/reference/realtime.md

@@ -23,8 +23,7 @@ based on what you're querying:
 List queries require explicit `@refresh` to tell SQL Connect which mutations
 affect the result set.
 
-Clients consume all three using `subscribe()` instead of `execute()`. See
-[sdks.md](sdks.md) for per-platform subscribe patterns.
+Clients consume all three using `subscribe()` instead of `execute()`. See [sdk_web.md](sdk_web.md), [sdk_android.md](sdk_android.md), [sdk_ios.md](sdk_ios.md), and [sdk_flutter.md](sdk_flutter.md) for per-platform subscribe patterns.
 
 ______________________________________________________________________
 

package/dist/global-skills/firebase-data-connect/reference/sdk_flutter.md

@@ -66,8 +66,8 @@ is old).
 ```dart
 final result = await MoviesConnector.instance.listMovies().execute();
 
-if (result.data != null && result.data!.isNotEmpty) {
-  handleEnumValue(result.data![0].aspectratio);
+if (result.data.movies.isNotEmpty) {
+  handleEnumValue(result.data.movies[0].aspectratio);
 }
 
 void handleEnumValue(EnumValue<AspectRatio> aspectValue) {

package/dist/global-skills/firebase-data-connect/reference/sdk_ios.md

@@ -103,8 +103,8 @@ generate:
 Use cache policies in code:
 
 ```swift
-try await execute(fetchPolicy: .cacheOnly)
-try await execute(fetchPolicy: .serverOnly)
+try await queryRef.execute(fetchPolicy: .cacheOnly)
+try await queryRef.execute(fetchPolicy: .serverOnly)
 ```
 
 ### Subscriptions (Realtime)

package/dist/global-skills/firebase-data-connect/reference/sdk_web.md

@@ -100,15 +100,17 @@ generate:
 Use policies in code:
 
 ```typescript
-await executeQuery(queryRef, QueryFetchPolicy.CACHE_ONLY);
-await executeQuery(queryRef, QueryFetchPolicy.SERVER_ONLY);
+await executeQuery(queryRef, { fetchPolicy: QueryFetchPolicy.CACHE_ONLY });
+await executeQuery(queryRef, { fetchPolicy: QueryFetchPolicy.SERVER_ONLY });
 ```
 
 ### Subscriptions (Realtime)
 
-Use `subscribe()` to receive live updates.
+Use `subscribe()` to receive live updates. It accepts either an observer object (`SubscriptionOptions`) or positional callbacks:
 
-#### Web (Vanilla JS)
+> **Note:** When passing an observer object literal, the error callback property is named **`onErr`** (`{ onNext, onErr, onComplete }`). Passing `onError` in an object literal fails TypeScript compilation (`TS2769`) and is ignored at runtime. The name `onError` is only used as the parameter name in the positional callback overload (`subscribe(ref, onNext, onError, onComplete)`).
+
+#### Web (Vanilla JS / TypeScript)
 
 ```typescript
 import { subscribe } from 'firebase/data-connect';
@@ -116,9 +118,18 @@ import { getMovieByIdRef } from '@dataconnect/generated';
 
 const queryRef = getMovieByIdRef({ id: "<MOVIE_ID>" });
 
-const unsubscribe = subscribe(queryRef, (result) => {
-  console.log("Updated result:", result);
+// Option 1: Observer object (recommended — uses `onErr`)
+const unsubscribe = subscribe(queryRef, {
+  onNext: (result) => console.log("Updated result:", result),
+  onErr: (error) => console.error("Subscription error:", error)
 });
+
+// Option 2: Positional callbacks (`onNext`, `onError`, `onComplete`)
+const unsubscribePositional = subscribe(
+  queryRef,
+  (result) => console.log("Updated result:", result),
+  (error) => console.error("Subscription error:", error)
+);
 ```
 
 ### TanStack Query Support (React)

package/dist/global-skills/firebase-data-connect/reference/security.md

@@ -35,9 +35,9 @@ ______________________________________________________________________
 | Level                 | Who Can Access                               | CEL Equivalent                                                           |
 | --------------------- | -------------------------------------------- | ------------------------------------------------------------------------ |
 | `PUBLIC`              | Anyone, authenticated or not                 | `true`                                                                   |
-| `USER_ANON`           | Any authenticated user (including anonymous) | `auth.uid != nil`                                                        |
-| `USER`                | Authenticated users (excludes anonymous)     | `auth.uid != nil && auth.token.firebase.sign_in_provider != 'anonymous'` |
-| `USER_EMAIL_VERIFIED` | Users with verified email                    | `auth.uid != nil && auth.token.email_verified`                           |
+| `USER_ANON`           | Any authenticated user (including anonymous) | `auth != null`                                                           |
+| `USER`                | Authenticated users (excludes anonymous)     | `auth != null && auth.token.firebase.sign_in_provider != 'anonymous'`    |
+| `USER_EMAIL_VERIFIED` | Users with verified email                    | `auth != null && auth.token.email_verified`                              |
 | `NO_ACCESS`           | Admin SDK only                               | `false`                                                                  |
 
 > **Important:** Levels like `USER` are starting points. Always add filters or
@@ -55,7 +55,7 @@ ______________________________________________________________________
 | `auth.token`            | Auth token claims (see below)              |
 | `vars`                  | Operation variables (e.g., `vars.movieId`) |
 | `request.time`          | Server timestamp                           |
-| `request.operationName` | "query" or "mutation"                      |
+| `request.operationName` | Name of the GraphQL operation being executed (e.g., `"GetMovie"`) |
 
 ### auth.token Fields
 
@@ -79,7 +79,7 @@ ______________________________________________________________________
 @auth(expr: "auth.token.email_verified && auth.token.email.endsWith('@company.com')")
 
 # Check multiple conditions
-@auth(expr: "auth.uid != nil && (auth.token.role == 'editor' || auth.token.role == 'admin')")
+@auth(expr: "auth != null && (auth.token.role == 'editor' || auth.token.role == 'admin')")
 
 # Check variable
 @auth(expr: "has(vars.status) && vars.status in ['draft', 'published']")

package/dist/global-skills/firebase-data-connect/templates.md

@@ -202,6 +202,7 @@ generate:
     package: "com.myapp.dataconnect"
   swiftSdk:
     outputDir: "../ios/MyApp/DataConnect"
+    package: "DataConnectGenerated"
   dartSdk:
     outputDir: "../flutter/lib/dataconnect"
     package: myapp_dataconnect
@@ -310,7 +311,7 @@ const unsubscribe = subscribe(liveDashboardRef(), {
     // Called immediately with current data, then on each refresh
     renderDashboard(result.data.items);
   },
-  onError: (error) => console.error('Subscription error:', error)
+  onErr: (error) => console.error('Subscription error:', error) // Observer object property is `onErr` (positional overload parameter is `onError`)
 });
 
 // Cleanup when done

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

@@ -1,7 +1,7 @@
 ---
 name: firebase-firestore
 description: >-
-  Sets up, manages, queries, and configures Cloud Firestore databases (Standard/Enterprise edition), including data modeling, security rules, indexes, and SDK integrations (Web, Python, iOS, Android, Flutter). Use when creating/listing Firestore databases, defining data models/indexes, writing SDK queries, or integrating Firestore SDKs. Don't use for Firebase Hosting, Data Connect, Auth, Storage/GCS, Crashlytics, Functions, or BigQuery.
+  Sets up, manages, queries, and configures Cloud Firestore databases (Standard/Enterprise edition), including data modeling, security rules, indexes, and SDK integrations (Web, Python, iOS, Android, Flutter). Use when creating/listing Firestore databases, defining data models/indexes, writing SDK queries, or integrating Firestore SDKs. For authoring or modifying Firestore Security Rules (firestore.rules), delegate to the firestore-rules-author subagent if subagent delegation is available, or use firestore-rules-creation otherwise. Don't use for Firebase Hosting, Data Connect, Auth, Storage/GCS, Crashlytics, Functions, or BigQuery.
 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: Databases
@@ -9,18 +9,29 @@ metadata:
 
 # Cloud Firestore Database and Operations
 
+> [!IMPORTANT] **Security Rules Authoring (`firestore.rules`)**
+> Whenever your task requires creating, authoring, or modifying `firestore.rules`:
+> - **If subagent delegation AND the `firestore-rules-author` subagent are available**: delegate authoring `firestore.rules` to the `firestore-rules-author` subagent rather than writing `firestore.rules` directly in the main agent.
+> - **If subagent delegation is unavailable** (e.g., subagents not enabled in the IDE) **OR `firestore-rules-author` is not installed**: read and follow the `firestore-rules-creation` skill to write `firestore.rules` directly.
+
 Before setting up dependencies, writing data models, or configuring security
 rules, you MUST always identify the Firestore instance edition.
 
 ## 1. Instance Selection and Edition Detection
 
 Run the following command to list current Firestore databases:
-`bash npx -y firebase-tools@latest firestore:databases:list`
+
+```bash
+npx -y firebase-tools@latest firestore:databases:list
+```
 
 ### A. Instance Found
 
 1. For each database found, inspect its edition and details:
-   `bash npx -y firebase-tools@latest firestore:databases:get <database-id>`
+
+    ```bash
+    npx -y firebase-tools@latest firestore:databases:get <database-id>
+    ```
 1. Ask the user which database instance they wish to target or if they would
    prefer to create a new instance.
 1. Once the target instance is established:
@@ -37,7 +48,10 @@ If no databases exist or the user requests a new one, default to provisioning an
 Suggest colocating with other resources if applicable.
 
 Once the location is determined, create the database:
-`bash npx -y firebase-tools@latest firestore:databases:create <database-id> --edition="enterprise" --location="<selected-location>"`
+
+```bash
+npx -y firebase-tools@latest firestore:databases:create <database-id> --edition="enterprise" --location="<selected-location>"
+```
 
 Proceed with using the guides under `references/enterprise/`.
 
@@ -51,8 +65,7 @@ corresponding reference guides:
 ### Standard Edition (`references/standard/`)
 
 - **Provisioning**: Read [provisioning.md](references/standard/provisioning.md)
-- **Security Rules**: Read
-  [security_rules.md](references/standard/security_rules.md)
+- **Security Rules**: See the `firestore-rules-creation` skill
 - **SDK Usage**: Read [web_sdk_usage.md](references/standard/web_sdk_usage.md),
   [android_sdk_usage.md](references/standard/android_sdk_usage.md),
   [ios_setup.md](references/standard/ios_setup.md), or
@@ -66,8 +79,7 @@ corresponding reference guides:
 
 - **Data Model**: Read [data_model.md](references/enterprise/data_model.md)
 
-- **Security Rules**: Read
-  [security_rules.md](references/enterprise/security_rules.md)
+- **Security Rules**: See the `firestore-rules-creation` skill
 
 - **SDK Usage**:
 

package/dist/global-skills/firebase-firestore/references/enterprise/android_sdk_usage.md

@@ -135,7 +135,7 @@ val articlesWithAuthProfile = db.pipeline().collection("articles")
     .define(field("authorUid").alias("author_id"))
     .addFields(
         db.pipeline().collection("users")
-            .where(field("__name__").documentId().equalTo(variable("author_id")))
+            .where(field("__name__").documentId().equal(variable("author_id")))
             .select(field("displayName"), field("avatarUrl"), field("handle"))
             .toScalarExpression()
             .alias("author")
@@ -150,13 +150,14 @@ high-performance text query matches on the database level.
 ```kotlin
 import com.google.firebase.firestore.pipeline.Expression.documentMatches
 import com.google.firebase.firestore.pipeline.Expression.score
+import com.google.firebase.firestore.pipeline.SearchStage
 
 // Execute full-text search inside a pipeline, sorted by relevance score descending
 val searchPipeline = db.pipeline()
     .collection("articles")
     .search(
-        query = documentMatches("machine learning"),
-        sort = score().descending()
+        SearchStage.withQuery(documentMatches("machine learning"))
+            .withSort(score().descending())
     )
     .limit(5)
 ```
@@ -175,7 +176,7 @@ import com.google.firebase.Firebase
 import com.google.firebase.firestore.DocumentChange
 import com.google.firebase.firestore.firestore
 
-val db = Firebase.firestore
+val db = Firebase.firestore("<database-name>")
 // 1. Add a new document to a collection
 val taskData = hashMapOf(
     "title" to "Refactor Android SDK Usage Guide",

package/dist/global-skills/firebase-firestore/references/enterprise/data_model.md

@@ -16,7 +16,10 @@ nested objects in addition to basic data types like strings, numbers, and
 booleans. Documents are limited to a maximum size of 1 MiB.
 
 Example document (e.g., in a `users` collection):
-`json { "first": "Ada", "last": "Lovelace", "born": 1815 }`
+
+```json
+{ "first": "Ada", "last": "Lovelace", "born": 1815 }
+```
 
 ### Collections
 
@@ -60,7 +63,13 @@ the `reviews` collection group.
 
 **Standard Query** (Single Collection): Find all 5-star reviews for a specific
 landmark.
-`javascript db.collection('landmarks/golden_gate_bridge/reviews').where('rating', '==', 5)`
+
+```javascript
+db.collection('landmarks/golden_gate_bridge/reviews').where('rating', '==', 5)
+```
 
 **Collection Group Query**: Find all 5-star reviews across *all* landmarks.
-`javascript db.collectionGroup('reviews').where('rating', '==', 5)`
+
+```javascript
+db.collectionGroup('reviews').where('rating', '==', 5)
+```

package/dist/global-skills/firebase-firestore/references/enterprise/indexes.md

@@ -43,23 +43,18 @@ create index entries with duplicate values.
 
 ## Query Support Examples
 
-| Query Type                                                 | Index Required                       |
-| :--------------------------------------------------------- | :----------------------------------- |
-| **Simple Equality**<br>\`where("a",                        | Single-Field Index on field `a`      |
-| : "==", 1)\` : :                                           |                                      |
-| **Simple Range/Sort**<br>\`where("a",                      | Single-Field Index on field `a`      |
-| : ">", 1).orderBy("a")\` : :                               |                                      |
-| **Multiple Equality**<br>\`where("a",                      | Single-Field Index on field `a` and  |
-| : "==", 1).where("b", "==", 2)`       :`b\` :              |                                      |
-| \*\*Equality +                                             | **Composite Index** on field `a` and |
-| : Range/Sort\*\*<br>`where("a", "==",    : `b\` :          |                                      |
-| : 1).where("b", ">", 2)\` : :                              |                                      |
-| **Multiple Ranges**<br>\`where("a",                        | **Composite Index** on field `a` and |
-| : ">", 1).where("b", ">", 2)`         :`b\` :              |                                      |
-| \*\*Array Contains +                                       | **Composite Index** on field `tags`  |
-| : Equality\*\*<br>`where("tags",         : and `active\` : |                                      |
-| : "array-contains", : :                                    |                                      |
-| : "news").where("active", "==", true)\` : :                |                                      |
+- **Simple Equality**: `where("a", "==", 1)`
+  - Index Required: Single-Field Index on field `a`
+- **Simple Range/Sort**: `where("a", ">", 1).orderBy("a")`
+  - Index Required: Single-Field Index on field `a`
+- **Multiple Equality**: `where("a", "==", 1).where("b", "==", 2)`
+  - Index Required: Single-Field Index on field `a` and `b`
+- **Equality + Range/Sort**: `where("a", "==", 1).where("b", ">", 2)`
+  - Index Required: **Composite Index** on field `a` and `b`
+- **Multiple Ranges**: `where("a", ">", 1).where("b", ">", 2)`
+  - Index Required: **Composite Index** on field `a` and `b`
+- **Array Contains + Equality**: `where("tags", "array-contains", "news").where("active", "==", true)`
+  - Index Required: **Composite Index** on field `tags` and `active`
 
 If no indexes is present, Firestore Enterprise will perform a full collection
 scan to find documents that match a query.
@@ -132,4 +127,7 @@ Define a unique index:
 ### CLI Commands
 
 Deploy indexes only:
-`bash npx firebase-tools@latest -y deploy --only firestore:indexes`
+
+```bash
+npx -y firebase-tools@latest deploy --only firestore:indexes
+```

package/dist/global-skills/firebase-firestore/references/enterprise/provisioning.md

@@ -77,7 +77,7 @@ service cloud.firestore {
 }
 ```
 
-*See [security_rules.md](security_rules.md) for how to write actual rules.*
+*See the `firestore-rules-creation` skill for how to write actual rules.*
 
 ### 3. Create `firestore.indexes.json`
 

package/dist/global-skills/firebase-firestore/references/enterprise/python_sdk_usage.md

@@ -11,6 +11,9 @@ Creates a document if it does not exist or overwrites it if it does. You can
 also specify a merge option to only update provided fields.
 
 ```python
+from google.cloud import firestore
+
+db = firestore.Client(database="<database-id>")
 city_ref = db.collection("cities").document("LA")
 
 # Create/Overwrite
@@ -54,6 +57,7 @@ city_ref.update({
 Perform an atomic read-modify-write operation.
 
 ```python
+from google.cloud import firestore
 from google.cloud.firestore import Transaction
 
 transaction = db.transaction()
@@ -132,7 +136,7 @@ query = cities_ref.order_by("name").limit(3)
 You can use pipeline queries to perform complex queries.
 
 ```python
-pipeline = client.pipeline().collection("users")
+pipeline = db.pipeline().collection("users")
 for result in pipeline.execute():
     print(f"{result.id} => {result.data()}")
 ```

package/dist/global-skills/firebase-firestore/references/enterprise/web_sdk_usage.md

@@ -18,7 +18,7 @@ const firebaseConfig = {
 };
 
 const app = initializeApp(firebaseConfig);
-const db = getFirestore(app);
+const db = getFirestore(app, "<database-id>");
 ```
 
 ______________________________________________________________________
@@ -31,10 +31,8 @@ ______________________________________________________________________
 
 ### Rules & Accountability
 
-1. **Check API References:** Always read `pipeline.d.ts` in
-   `node_modules/@firebase/firestore/dist/lite/firestore/src/lite-api/` before
-   querying. Reference `expressions.d.ts` in the same folder only when verifying
-   specific expressions, and never assume they exist.
+1. **Check API References:** Always read `pipelines.d.ts` in
+   `node_modules/@firebase/firestore/dist/` before querying.
 1. **Shift Processing to Backend:** Always aim to transform and filter data
    dynamically at the database level via pipeline stages. Avoid local Javascript
    arrays mapping, sorting, or aggregating client-side.
@@ -55,7 +53,7 @@ bind alias parameters. - Invoke `.addFields()` incorporating a new subquery
 linking the documents.
 
 ```javascript
-import { field, variable } from "firebase/firestore/pipelines";
+import { execute, field, variable } from "firebase/firestore/pipelines";
 
 // Fetch articles and join the associated author Profile side-by-side
 const articlesWithAuthProfile = db.pipeline().collection("articles")
@@ -67,6 +65,7 @@ const articlesWithAuthProfile = db.pipeline().collection("articles")
       .toScalarExpression()
       .as("author")
   );
+const snapshot = await execute(articlesWithAuthProfile);
 ```
 
 ### Full-Text Search
@@ -75,7 +74,7 @@ Leverage the database-native `.search()` stage for high-performance text
 lookups.
 
 ```javascript
-import { documentMatches, score } from "firebase/firestore/pipelines";
+import { documentMatches, execute, score } from "firebase/firestore/pipelines";
 // Execute full-text search within pipeline
 const searchPipeline = db.pipeline()
   .collection("articles")
@@ -84,6 +83,7 @@ const searchPipeline = db.pipeline()
     sort: score().descending()
   })
   .limit(5);
+const results = await execute(searchPipeline);
 ```
 
 ______________________________________________________________________

package/dist/global-skills/firebase-firestore/references/standard/android_sdk_usage.md

@@ -37,9 +37,9 @@ ______________________________________________________________________
 In your Activity or Fragment, initialize the `FirebaseFirestore` instance:
 
 ```kotlin
+import com.google.firebase.Firebase
 import com.google.firebase.firestore.FirebaseFirestore
-import com.google.firebase.firestore.ktx.firestore
-import com.google.firebase.ktx.Firebase
+import com.google.firebase.firestore.firestore
 
 class MainActivity : AppCompatActivity() {
 
@@ -47,8 +47,8 @@ class MainActivity : AppCompatActivity() {
 
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
-        val db = Firebase.firestore
-        
+        db = Firebase.firestore
+
         setContent {
             MaterialTheme {
                 Text("Firestore initialized!")
@@ -75,7 +75,7 @@ class MainActivity : ComponentActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         val db = Firebase.firestore
-        
+
         setContent {
             MaterialTheme {
                 Text("Firestore initialized!")

package/dist/global-skills/firebase-firestore/references/standard/flutter_setup.md

@@ -81,7 +81,7 @@ class ItemService {
     try {
       await _itemsRef.add(item.toFirestore());
     } catch (e) {
-      print("Error creating document: \$e");
+      print("Error creating document: $e");
     }
   }
 
@@ -95,7 +95,7 @@ class ItemService {
 
       return querySnapshot.docs.map((doc) => Item.fromFirestore(doc)).toList();
     } catch (e) {
-      print("Error fetching documents: \$e");
+      print("Error fetching documents: $e");
       return [];
     }
   }
@@ -118,7 +118,7 @@ class ItemService {
     try {
       await _itemsRef.doc(id).update({'name': newName});
     } catch (e) {
-      print("Error updating document: \$e");
+      print("Error updating document: $e");
     }
   }
 
@@ -127,7 +127,7 @@ class ItemService {
     try {
       await _itemsRef.doc(id).delete();
     } catch (e) {
-      print("Error deleting document: \$e");
+      print("Error deleting document: $e");
     }
   }
 }

package/dist/global-skills/firebase-firestore/references/standard/indexes.md

@@ -41,23 +41,18 @@ specific index.
 
 ## Query Support Examples
 
-| Query Type                                                | Index Required                       |
-| :-------------------------------------------------------- | :----------------------------------- |
-| **Simple Equality**<br>\`where("a",                       | Automatic (Single-Field)             |
-| : "==", 1)\` : :                                          |                                      |
-| **Simple Range/Sort**<br>\`where("a",                     | Automatic (Single-Field)             |
-| : ">", 1).orderBy("a")\` : :                              |                                      |
-| **Multiple Equality**<br>\`where("a",                     | Automatic (Merged Single-Field)      |
-| : "==", 1).where("b", "==", 2)\` : :                      |                                      |
-| \*\*Equality +                                            | **Composite Index**                  |
-| : Range/Sort\*\*<br>\`where("a", "==", : :                |                                      |
-| : 1).where("b", ">", 2)\` : :                             |                                      |
-| **Multiple Ranges**<br>\`where("a",                       | **Composite Index** (and technically |
-| : ">", 1).where("b", ">", 2)\` : limited query support) : |                                      |
-| \*\*Array Contains +                                      | **Composite Index**                  |
-| : Equality\*\*<br>\`where("tags", : :                     |                                      |
-| : "array-contains", : :                                   |                                      |
-| : "news").where("active", "==", true)\` : :               |                                      |
+- **Simple Equality**: `where("a", "==", 1)`
+  - Index Required: Automatic (Single-Field)
+- **Simple Range/Sort**: `where("a", ">", 1).orderBy("a")`
+  - Index Required: Automatic (Single-Field)
+- **Multiple Equality**: `where("a", "==", 1).where("b", "==", 2)`
+  - Index Required: Automatic (Merged Single-Field)
+- **Equality + Range/Sort**: `where("a", "==", 1).where("b", ">", 2)`
+  - Index Required: **Composite Index**
+- **Multiple Ranges**: `where("a", ">", 1).where("b", ">", 2)`
+  - Index Required: **Composite Index** (limited query support)
+- **Array Contains + Equality**: `where("tags", "array-contains", "news").where("active", "==", true)`
+  - Index Required: **Composite Index**
 
 ## Best Practices & Exemptions
 
@@ -110,4 +105,7 @@ Your indexes should be defined in `firestore.indexes.json` (pointed to by
 ### CLI Commands
 
 Deploy indexes only:
-`bash npx -y firebase-tools@latest deploy --only firestore:indexes`
+
+```bash
+npx -y firebase-tools@latest deploy --only firestore:indexes
+```

package/dist/global-skills/firebase-firestore/references/standard/provisioning.md

@@ -65,7 +65,7 @@ service cloud.firestore {
 }
 ```
 
-*See [security_rules.md](security_rules.md) for how to write actual rules.*
+*See the `firestore-rules-creation` skill for how to write actual rules.*
 
 ### 3. Create `firestore.indexes.json`
 

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

@@ -71,11 +71,6 @@ patterns (see
 Use the following commands to manage your Remote Config template and version
 history through the terminal:
 
-### Template Management via CLI
-
-Use the following commands to manage your Remote Config template and version
-history through the terminal:
-
 - **Get current template**: Save the remote template to a local JSON file for
   auditing or modification.