feat(rust): RaidableBases — feed, raids map layer, Warlord, Spawn a raid base, profiles (PLAN_REDESIGNS §11.4)

PLAN_REDESIGNS §11.4 (D202-D208, D386-D391), protocol 14. Spec: docs
rust-link/PROTOCOL.md §20.12.

- raid.started, raid.completed, raid.purchased and raid.locked public,
  raid.ended staff's; raidableBases.js reads each row per viewer (raiders'
  and a buyer's names only for the presence audience, D376/D390; Steam ids,
  position and a run's key only for staff). Feed lines in the World filter.
- The step rust.raidbase.spawn, "Spawn a raid base" (ledgered, budget
  rust.raids): difficulty, profile and base from option sources listing each
  server's own names (D386), a spot as a world call's location with a height
  adjustment or an exact height, and PvP/NPCs/lock as on/off/blank. A base
  the raids helper made is a world resource, so eventWorld's revert and
  reconcile serve it and world.expired marks it expired; one it did not make
  records nothing and the run log says it despawns on its own timer. Refused
  at verify for a server that said it cannot; a dry run with a spot returns
  the spot check as detail.warnings (MODULE_API 1.16.0, D391). rb-not-ready
  retries in ten minutes.
- Warlord: raids_completed, title category raidscompleted, the leaderboard's
  Raid bases column (sort=raidsCompleted).
- The map's raids layer (D114), public by default with its own audience; the
  run's key is dropped before any viewer gets it.
- Server settings' line for RaidableBases; its profiles in Mod configuration
  under a virtual path (D205).
- Swagger fragment, bundle and README.

Tests: server 684/684 (raidableBases.test.js new, every name in it invented);
client 99/99, build and externals.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

server/swagger/doc.js

@@ -294,6 +294,46 @@ module.exports = {
                 description: 'Protocol 14 (PLAN_REDESIGNS §14.3.6, D374): whether ZLevels Remastered is loaded, and nothing more. Its levels are never read; its XP boosts are permissions an event lends through a Permissions until the event ends step.',
                 properties: { loaded: { type: 'boolean', example: true }, version: { type: 'string', example: '3.3.1' } },
               },
+              raidableBases: {
+                type: 'object',
+                description: 'Protocol 14 (PLAN_REDESIGNS §11.4): where loaded, its bases reach the feed, the map’s raids layer and Warlord, and a step may spawn one. Every difficulty, profile and base name is the installed plugin’s own (D386). `gridReady` and `profiles` come only with a patched raids helper (RunicGatewayRaids.cs), which is also what makes a step’s base the run’s.',
+                properties: {
+                  loaded: { type: 'boolean', example: true },
+                  version: { type: 'string', example: '3.2.2' },
+                  premium: { type: 'boolean', description: 'The plugin’s own IsPremium().', example: true },
+                  spawnCall: { type: 'boolean', description: 'Whether the paid edition’s SpawnRandomBase call is there, looked for by name (D348).', example: true },
+                  copyPaste: { type: 'object', properties: { loaded: { type: 'boolean', example: true }, version: { type: 'string', example: '4.3.0' } } },
+                  difficulties: {
+                    type: 'array',
+                    items: { type: 'object', properties: { name: { type: 'string', example: 'Hard' }, level: { type: 'integer', example: 2 } } },
+                  },
+                  helper: {
+                    type: 'object',
+                    properties: {
+                      state: { type: 'string', enum: ['missing', 'patched', 'unsupported', 'no-raidablebases'], example: 'patched' },
+                      version: { type: 'string', example: '0.1.0' },
+                      reason: { type: 'string', description: 'Why it is not patched.' },
+                    },
+                  },
+                  gridReady: { type: 'boolean', description: 'Whether its spawn grid is built; until it is, it refuses every spawn.', example: true },
+                  profiles: {
+                    type: 'array',
+                    items: {
+                      type: 'object',
+                      properties: {
+                        name: { type: 'string', example: 'Hard Bases' },
+                        difficulty: { type: 'string', example: 'Hard' },
+                        level: { type: 'integer', example: 2 },
+                        enabled: { type: 'boolean', example: true },
+                        pvp: { type: 'boolean', example: true },
+                        bases: { type: 'array', items: { type: 'string' }, example: ['raidhard1', 'raidhard2'] },
+                        seabed: { type: 'boolean', description: 'A seabed chance above 0 (D389).', example: false },
+                        float: { type: 'boolean', description: 'Allows bases to float above water (D389).', example: false },
+                      },
+                    },
+                  },
+                },
+              },
             },
           },
           console: {
@@ -806,7 +846,7 @@ module.exports = {
             type: 'object',
             description: 'The live map’s switches and each server’s picture (phase 14).',
             properties: {
-              layers: { type: 'array', items: { type: 'string' }, example: ['world', 'events', 'players', 'bases', 'pvp'] },
+              layers: { type: 'array', items: { type: 'string' }, example: ['world', 'events', 'players', 'bases', 'pvp', 'raids'] },
               minorLabels: {
                 type: 'array',
                 items: { type: 'string' },
@@ -821,6 +861,7 @@ module.exports = {
                   players: { $ref: '#/components/schemas/RustAudience' },
                   bases: { $ref: '#/components/schemas/RustAudience' },
                   pvp: { $ref: '#/components/schemas/RustAudience' },
+                  raids: { $ref: '#/components/schemas/RustAudience' },
                   mates: { type: 'boolean', example: true },
                   markers: { type: 'object', description: 'D196: a monument label key (lower case) to true (drawn) or false (hidden). Only the labels somebody switched; every other label follows the default.', additionalProperties: { type: 'boolean' }, example: { substation: true } },
                 },
@@ -959,6 +1000,7 @@ module.exports = {
               players: { $ref: '#/components/schemas/RustMapLayer' },
               bases: { $ref: '#/components/schemas/RustMapLayer' },
               pvp: { $ref: '#/components/schemas/RustMapLayer' },
+              raids: { $ref: '#/components/schemas/RustMapLayer' },
             },
           },
           mates: {
@@ -1056,6 +1098,23 @@ module.exports = {
               },
             },
           },
+          raids: {
+            type: 'array',
+            description: 'Protocol 14 (§11.4): RaidableBases’ live bases, with the plugin’s own difficulty and base names (D386). `runId` is set for a base this site’s event spawned; the run’s key is never sent.',
+            items: {
+              type: 'object',
+              properties: {
+                x: { type: 'number' },
+                z: { type: 'number' },
+                level: { type: 'integer', example: 2 },
+                difficulty: { type: 'string', example: 'Hard' },
+                base: { type: 'string', example: 'raidhard2' },
+                pvp: { type: 'boolean', example: true },
+                despawnAt: { type: 'integer', description: 'When the plugin despawns it, unix milliseconds.' },
+                runId: { type: 'string', example: '12' },
+              },
+            },
+          },
           mates: {
             type: 'array',
             description: 'The viewer’s own positions (their sleeper too) and their online first-party clan mates on this server.',