docs: document cumulative rulesLevel filter and allChassis example

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: graylikeme

README.md

@@ -219,6 +219,16 @@ The server starts on `http://localhost:8080`. In debug builds, GraphiQL is avail
   }
 }
 
+# List chassis filtered by rules level (cumulative)
+{
+  allChassis(unitType: MECH, rulesLevel: STANDARD) {
+    slug
+    name
+    techBase
+    tonnage
+  }
+}
+
 # Equipment with stats and ammo relationships
 {
   equipment(slug: "autocannon-10") {
@@ -269,7 +279,7 @@ The `units` query supports the following filters:
 |--------|------|-------------|
 | `nameSearch` | String | Case-insensitive substring match on `fullName` and `clanName` |
 | `techBase` | String | `inner_sphere`, `clan`, `mixed`, `primitive` |
-| `rulesLevel` | String | `introductory`, `standard`, `advanced`, `experimental`, `unofficial` |
+| `rulesLevel` | Enum | Cumulative rules level filter. E.g. `ADVANCED` includes introductory, standard, and advanced |
 | `tonnageMin` / `tonnageMax` | Float | Weight range in metric tons |
 | `factionSlug` | String | Units available to this faction (e.g. `"clan-wolf"`) |
 | `eraSlug` | String | Units available in this era (e.g. `"clan-invasion"`) |
@@ -286,7 +296,7 @@ The `allEquipment` query supports additional builder-oriented filters:
 | `nameSearch` | String | Case-insensitive substring match on equipment name |
 | `category` | String | Equipment category in snake_case (e.g. `"energy_weapon"`) |
 | `techBase` | String | `inner_sphere`, `clan`, `mixed`, `primitive` |
-| `rulesLevel` | String | `introductory`, `standard`, `advanced`, `experimental`, `unofficial` |
+| `rulesLevel` | Enum | Cumulative rules level filter. E.g. `ADVANCED` includes introductory, standard, and advanced |
 | `maxTonnage` | Float | Equipment weighing at most this many tons |
 | `maxCrits` | Int | Equipment consuming at most this many critical slots |
 | `observedLocation` | String | Equipment observed at this location (e.g. `"right_arm"`) |

crates/api/src/handlers/llms_txt.rs

@@ -19,7 +19,7 @@ GET {base_url}/schema.graphql
 - **Slugs**: lowercase, hyphen-separated identifiers. Examples: "atlas-as7-d", "clan-wolf", "medium-laser". Chassis slugs include the unit type suffix: "atlas-mech", "demolisher-vehicle"
 - **Years**: in-universe BattleTech timeline years (e.g. 3025, 3055), not real-world dates
 - **Tech base** (enum TechBaseFilter): INNER_SPHERE, CLAN, MIXED, PRIMITIVE
-- **Rules level** (enum RulesLevelFilter): INTRODUCTORY, STANDARD, ADVANCED, EXPERIMENTAL, UNOFFICIAL
+- **Rules level** (enum RulesLevelFilter): INTRODUCTORY, STANDARD, ADVANCED, EXPERIMENTAL, UNOFFICIAL — filter is cumulative: e.g. ADVANCED returns introductory + standard + advanced
 - **Equipment category** (enum EquipmentCategoryFilter): ENERGY_WEAPON, BALLISTIC_WEAPON, MISSILE_WEAPON, PHYSICAL_WEAPON, AMMUNITION, EQUIPMENT, ARMOR, STRUCTURE, ENGINE, GYRO, COCKPIT, ACTUATOR, HEAT_SINK, JUMP_JET, TARGETING_COMPUTER
 - **Unit type** (enum UnitTypeFilter): MECH, VEHICLE, FIGHTER, OTHER
 - **Era** (enum EraFilter): AGE_OF_WAR, STAR_LEAGUE, EARLY_SUCCESSION_WARS, LATE_SUCCESSION_WARS, RENAISSANCE, CLAN_INVASION, CIVIL_WAR, JIHAD, DARK_AGE, IL_CLAN
@@ -403,6 +403,18 @@ To paginate: pass `endCursor` from the previous response as `after` in the next
   }}
 }}
 ```
+
+### List chassis filtered by rules level and unit type
+```graphql
+{{
+  allChassis(unitType: MECH, rulesLevel: STANDARD) {{
+    slug
+    name
+    techBase
+    tonnage
+  }}
+}}
+```
 "#,
         base_url = base_url,
     )