@dereekb/dbx-components-mcp 13.11.14 → 13.11.16

package/generated/rule-catalog.generated.json

@@ -264,7 +264,7 @@
     "whatItFlags": "A composite index required by tagged factories is missing from the committed `firestore.indexes.json`.",
     "whenItApplies": "Every entry in the generated composite set that has no equal entry in the committed JSON.",
     "whenItDoesNotApply": "Factories tagged `@dbxModelFirebaseIndexManual` — their shapes are author-managed and excluded from drift.",
-    "canonicalFix": "Run the `scan-model-firebase-indexes` / `generate-firestore-indexes` CLIs and commit the regenerated `firestore.indexes.json`."
+    "canonicalFix": "Run `dbx-cli-generate-firestore-indexes --component <dir>` (and the `scan-model-firebase-indexes` CLI if the manifest is also stale) and commit the regenerated `firestore.indexes.json`."
   },
   {
     "code": "MODEL_FIREBASE_INDEX_COMPOSITE_REMOVED",
@@ -286,6 +286,22 @@
     "whenItDoesNotApply": "Intentional aliases — they should target the same composite, in which case keep one factory.",
     "canonicalFix": "Pick distinct slugs (or distinct function names) so each factory is addressable."
   },
+  {
+    "code": "MODEL_FIREBASE_INDEX_EXCLUDED",
+    "source": "dbx_model_firebase_index_validate_app",
+    "severity": "warning",
+    "title": "A tagged factory carries `@dbxModelFirebaseIndexExclude` — its constraints are parsed but the analyzer suppresses composite + fieldOverride emission",
+    "whatItFlags": "A tagged factory carries `@dbxModelFirebaseIndexExclude` — its constraints are parsed but the analyzer suppresses composite + fieldOverride emission.",
+    "whenItApplies": "Every `@dbxModelFirebaseIndex`-tagged factory that also declares `@dbxModelFirebaseIndexExclude`. The warning fires on every scan so the deliberate exclusion stays auditable in CI logs.",
+    "whenItDoesNotApply": "Factories using `@dbxModelFirebaseIndexSkip` (silent — no warning emitted) or `@dbxModelFirebaseIndexManual` (composites are author-managed, no audit signal needed).",
+    "canonicalFix": "If the exclusion is no longer required, delete the `@dbxModelFirebaseIndexExclude` tag and let the analyzer emit the implied composite. If the factory should be permanently silent, switch to `@dbxModelFirebaseIndexSkip` and document the rationale next to the tag.",
+    "seeAlso": [
+      {
+        "kind": "tool",
+        "target": "dbx_model_firebase_index_validate_app"
+      }
+    ]
+  },
   {
     "code": "MODEL_FIREBASE_INDEX_FIELD_OVERRIDE_ADDED",
     "source": "dbx_model_firebase_index_validate_app",
@@ -395,6 +411,22 @@
     "whenItDoesNotApply": "Sequences with at most one direction per field.",
     "canonicalFix": "Pick one direction per field, or split into two factories — Firestore can only deploy one direction at a time per composite."
   },
+  {
+    "code": "MODEL_FIREBASE_INDEX_SPEC_FILES_ONLY_VIOLATION",
+    "source": "dbx_model_firebase_index_validate_app",
+    "severity": "error",
+    "title": "A factory tagged `@dbxModelFirebaseIndexSpecFilesOnly` is referenced from at least one non-spec file",
+    "whatItFlags": "A factory tagged `@dbxModelFirebaseIndexSpecFilesOnly` is referenced from at least one non-spec file.",
+    "whenItApplies": "Every `@dbxModelFirebaseIndexSpecFilesOnly` factory whose name appears in a `.ts` file under `apps/`, `components/`, or `packages/` that is NOT a `*.spec.ts` / `*.spec.tsx` file. The tag is a contract that the factory exists for tests only; a production caller breaks that contract and would leak a query shape the index generator deliberately skipped.",
+    "whenItDoesNotApply": "Spec-only factories whose references are confined to `*.spec.ts` / `*.spec.tsx` files (the intended state), or factories not tagged `@dbxModelFirebaseIndexSpecFilesOnly`.",
+    "canonicalFix": "Either move the production call-site into a tagged, non-spec-only factory (and update its callers), or remove the `@dbxModelFirebaseIndexSpecFilesOnly` tag and ensure the produced composite/fieldOverride is declared so the generator emits the required Firestore index.",
+    "seeAlso": [
+      {
+        "kind": "tool",
+        "target": "dbx_model_firebase_index_list_app"
+      }
+    ]
+  },
   {
     "code": "MODEL_FIREBASE_INDEX_TRANSITIVE_CYCLE",
     "source": "dbx_model_firebase_index_validate_app",
@@ -478,8 +510,8 @@
     "title": "A field uses the `array-contains-any` operator — index support is partial",
     "whatItFlags": "A field uses the `array-contains-any` operator — index support is partial.",
     "whenItApplies": "Every constraint sequence with at least one `array-contains-any` `where`.",
-    "whenItDoesNotApply": "Queries using `array-contains` (singular) — those have full composite support.",
-    "canonicalFix": "Confirm the deployed composite supports `array-contains-any` for the field set, or restructure to `array-contains` with a denormalised flag."
+    "whenItDoesNotApply": "Queries using `array-contains` (singular) — those have full composite support. Also suppressed when the factory is tagged `@dbxModelFirebaseIndexAllowArrayContainsAny`.",
+    "canonicalFix": "Confirm the deployed composite supports `array-contains-any` for the field set and add `@dbxModelFirebaseIndexAllowArrayContainsAny` to silence the advisory, or restructure to `array-contains` with a denormalised flag."
   },
   {
     "code": "MODEL_FIREBASE_INDEX_UNSUPPORTED_SCOPE",
@@ -491,6 +523,22 @@
     "whenItDoesNotApply": "Factories that omit the tag — scope falls back to COLLECTION_GROUP for nested models, COLLECTION for root models.",
     "canonicalFix": "Set the tag value to exactly `COLLECTION` or `COLLECTION_GROUP`."
   },
+  {
+    "code": "MODEL_FIREBASE_INDEX_UNUSED_FACTORY",
+    "source": "dbx_model_firebase_index_validate_app",
+    "severity": "warning",
+    "title": "A tagged factory has zero callers anywhere in the workspace",
+    "whatItFlags": "A tagged factory has zero callers anywhere in the workspace.",
+    "whenItApplies": "Every `@dbxModelFirebaseIndex`-tagged factory whose exported name does not appear in any `.ts` file under `apps/`, `components/`, or `packages/` (excluding `*.d.ts`, `node_modules/`, and build outputs). For regular factories only non-spec callers count toward \"used\" — a factory whose only references are inside `*.spec.ts` files still triggers this warning unless it is opted in via `@dbxModelFirebaseIndexSpecFilesOnly`. The check uses word-boundary text scanning so renames + stale exports surface here.",
+    "whenItDoesNotApply": "Factories marked `@dbxModelFirebaseIndexSkip` (the author already opted out of emission), `@dbxModelFirebaseIndexManual` (author-managed index, not necessarily wired through normal call sites), or `@dbxModelFirebaseIndexSpecFilesOnly` that have at least one `*.spec.ts` caller (the intended state for test-only helpers).",
+    "canonicalFix": "Either delete the factory (and its `*.query.ts` file if empty), wire up a production caller, or — if the factory is intentionally a `*.spec.ts`-only helper — tag it `@dbxModelFirebaseIndexSpecFilesOnly`. `@dbxModelFirebaseIndexSkip` still works for \"retain pending a future caller\".",
+    "seeAlso": [
+      {
+        "kind": "tool",
+        "target": "dbx_model_firebase_index_list_app"
+      }
+    ]
+  },
   {
     "code": "archetype-inconsistent",
     "source": "dbx_model_fixture_validate_app",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-components-mcp",
-  "version": "13.11.14",
+  "version": "13.11.16",
   "type": "module",
   "bin": {
     "dbx-components-mcp": "dbx-components-mcp.js"
@@ -15,19 +15,19 @@
     "@angular/core": "21.2.11",
     "@angular/forms": "21.2.11",
     "@angular/material": "^21.2.9",
-    "@dereekb/dbx-cli": "13.11.14",
-    "@dereekb/dbx-core": "13.11.14",
-    "@dereekb/dbx-firebase": "13.11.14",
-    "@dereekb/dbx-form": "13.11.14",
-    "@dereekb/dbx-web": "13.11.14",
-    "@dereekb/firebase": "13.11.14",
-    "@dereekb/firebase-server": "13.11.14",
-    "@dereekb/rxjs": "13.11.14",
-    "@dereekb/util": "13.11.14",
+    "@dereekb/dbx-cli": "13.11.16",
+    "@dereekb/dbx-core": "13.11.16",
+    "@dereekb/dbx-firebase": "13.11.16",
+    "@dereekb/dbx-form": "13.11.16",
+    "@dereekb/dbx-web": "13.11.16",
+    "@dereekb/firebase": "13.11.16",
+    "@dereekb/firebase-server": "13.11.16",
+    "@dereekb/rxjs": "13.11.16",
+    "@dereekb/util": "13.11.16",
     "@uirouter/angular": "21.0.0",
     "rxjs": "^7.8.2"
   },
   "devDependencies": {
-    "@dereekb/model": "13.11.14"
+    "@dereekb/model": "13.11.16"
   }
 }