KB: full staleness audit + sweep -- 35 verified corrections across 16 topics, 15 new glossary terms

Adversarially-verified audit (18 agents) against the task #46-#56 landings:
MP/current-state understatements, superseded punch readings, retired env
gates, dead paths, line-cite drift; env-gate hub table completed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

reference/glossary.yaml

@@ -126,6 +126,36 @@ DIV-BIZ2:
   related_terms: [BGF, BMF, PFBIZTAG]
   related_topics: [bgf-format, asset-formats]
 
+PMESH:
+  kind: format
+  definition: The BGF mesh-container chunk inside a PATCH (geogroup) — interleaved float32 vertices plus faces carried in CONN and/or PCONN lists.
+  related_terms: [BGF, CONN, PCONN]
+  related_topics: [bgf-format]
+
+CONN:
+  kind: format
+  definition: BGF CONNECTION_LIST (0x0047) — a FLAT TRIANGLE LIST (3 indices/face; corpus-verified n%3==0), NOT "one polygon, fan-triangulate". COEXISTS with PCONN in one pmesh (370/841 GEO models mix them — dropping the CONN triangles was a real bug).
+  related_terms: [BGF, PMESH, PCONN]
+  related_topics: [bgf-format]
+
+PCONN:
+  kind: format
+  definition: BGF PCONN_LIST — packed quad/hex faces of a PMESH (quads must be triangulated). Can coexist with loose CONN triangles in the same pmesh.
+  related_terms: [BGF, PMESH, CONN]
+  related_topics: [bgf-format]
+
+LOD:
+  kind: concept
+  definition: Level-of-detail band selection in BGF models. Each LOD chunk's 0x2046 header = a [near..far) viewing band; the board drew the LOD whose band contains the camera distance. ADDITIVE_LODS models instead draw EVERY LOD with d < OutDist (near detail adds onto coarser massing).
+  related_terms: [BGF, SV_SPECIAL, DIV-BIZ2]
+  related_topics: [bgf-format]
+
+SV_SPECIAL:
+  kind: format
+  definition: The BGF name-driven special-behavior token chunk (0x2037) — dz_* damage/articulation tokens, object-level ADDITIVE_LODS (draw-all-LODs arena structures), patch-level PUNCH (dpl_Punchize stencil-cut, e.g. the cockpit canopy windows).
+  related_terms: [BGF, DIV-BIZ2, LOD]
+  related_topics: [bgf-format]
+
 BMF:
   kind: format
   definition: DIV-BIZ2 (FILETYPE=1) material+texture LIBRARY (no pixels). Material -> DIFFUSE color + MATERIAL_TEXTURE -> texture -> TEXTURE_MAP image basename. Tag 0x18 BITSLICE selects a BSL sub-image; 0x28 ramp ref; 0x26 emissive.
@@ -138,6 +168,12 @@ BSL:
   related_terms: [BMF, VTX, TGA, material-ramp]
   related_topics: [asset-formats, rendering]
 
+VTX:
+  kind: format
+  definition: DIV-VTX2 — a small texture container with trailing raw RGB pixels (e.g. VIDEO/TEX/BINTA.VTX, 64x64 RGB, pixels at offset 57 — the translocation-warp gradient). One of the three texture-pixel sources alongside .tga and .bsl.
+  related_terms: [BSL, BMF]
+  related_topics: [asset-formats, translocation-warp]
+
 SKL:
   kind: format
   definition: INI joint skeleton. [joint] parent=, Type=(hingex/y/z|ball|balltranslate), Object=part.bgf, dzone=, tranx/y/z, pitch/yaw/roll. Build a DCS tree; neutral pose ~ translations.
@@ -186,6 +222,12 @@ VMF:
   related_terms: [BMF, BSL, beam]
   related_topics: [rendering]
 
+beam:
+  kind: concept
+  definition: The weapon discharge visual drawn from the Emitter sim state (Emitter::FireWeapon builds a muzzle->target beam). The dpl_* beam renderable was never ported — the port draws it via BTPushBeam/BTDrawBeams (L4VIDEO), the ermlaser.bgf tube with the scrolling bexp grit (.VMF SCROLL); ER lasers red, PPC blue, standard yellow.
+  related_terms: [VMF, DPL, BGF]
+  related_topics: [rendering, combat-damage]
+
 material-ramp:
   kind: concept
   definition: The IG board colours no-normal geometry (terrain/mesas/sky/buildings/mech) by a material's 2-endpoint RAMP (dpl_SetMaterialRamp) — texture luminance indexes a low->high gradient. Normal-bearing geometry (vehicles) is LIT instead. Applying the ramp to lit geometry = the "white blobs" bug.
@@ -213,6 +255,12 @@ EntitySegment:
   related_terms: [joint, subsystem-roster, GetSegment]
   related_topics: [locomotion, combat-damage]
 
+siteeyepoint:
+  kind: concept
+  definition: The skeleton SITE segment naming the cockpit eye camera mount — a child of jointeye (WriteMechJoint drives jointeye - translation = the eye-position spring, rotation = the body-tip spring). The eye ctor caller (part_014.c:5525-66, BTL4VID.CPP) gates on this segment name and mounts the eye via the segment's GetBaseOffset() under its PARENT draw component.
+  related_terms: [EntitySegment, joint, SKL]
+  related_topics: [cockpit-view]
+
 subsystem-roster:
   kind: concept
   definition: subsystemArray @mech+0x128 (count @0x124) — the inherited Entity table of the mech's Subsystem* instances (heat/weapons/gyro/sensor/...). A +0x128-style owner offset in subsystem code is the ROSTER, NOT the segment table (a classic bug source).
@@ -225,6 +273,12 @@ subsystem:
   related_terms: [subsystem-roster, factory, ClassID, PoweredSubsystem]
   related_topics: [subsystems, decomp-reference]
 
+PoweredSubsystem:
+  kind: class
+  definition: Subsystem base class drawing power from the generator chain (ClassID 0xBC2, ctor @004b0f74, sizeof 0x31C). The heat leaf chains PoweredSubsystem:HeatSink:HeatableSubsystem:MechSubsystem — Emitter/PPC/Sensor/Myomers/weapons descend here. Publishes InputVoltage to the gauge system.
+  related_terms: [subsystem, ClassID, gauge]
+  related_topics: [subsystems, decomp-reference]
+
 factory:
   kind: concept
   definition: The Mech-ctor per-class subsystem factory (switch on resource ClassID). The case LABELS are systematically MISLABELED — the real class is the ctor-address comment reconciled via CLASSMAP.md, not the case name. Each real class wired via a Create<Class>Subsystem bridge.
@@ -237,6 +291,18 @@ ClassID:
   related_terms: [factory, subsystem, CLASSMAP]
   related_topics: [subsystems, decomp-reference]
 
+SequenceController:
+  kind: class
+  definition: The BT animation clip player driving a joint channel (seqctl.cpp; SelectSequence@004277a8, Advance@0042790c). Two embedded on the Mech, 0x60 bytes each — legAnimation@0x65c (the LOCAL sim - travel + the displayed pose) and bodyAnimation@0x6bc (the replication projector feeding update records).
+  related_terms: [ANI, RootTranslation, joint]
+  related_topics: [locomotion]
+
+MechControlsMapper:
+  kind: class
+  definition: The roster slot 0 subsystem mapping pilot controls -> demands (mechmppr.cpp @004afbe0; btl4mppr.cpp mappers) — interprets input into speedDemand/turnDemand, the LEG channel's live source and the update-record speedDemand feed. NOTE recon MISLABELS Mech[0x10d] (+0x434) as controlsMapper; that cache is the SubsystemMessageManager — the real mapper is roster slot 0.
+  related_terms: [subsystem-roster, RIO, SequenceController]
+  related_topics: [locomotion, pod-hardware]
+
 master:
   kind: concept
   definition: A locally-simulated entity (the pod's own mech + spawned dummies). Ticks its full drive/subsystems and EMITS network update records. Contrast replicant.
@@ -249,6 +315,12 @@ replicant:
   related_terms: [master, dead-reckon, multiplayer]
   related_topics: [multiplayer]
 
+dead-reckon:
+  kind: concept
+  definition: The replicant motion model — extrapolate from the last network update record and converge toward the master's replicated origin (engine DeadReckon; velocity feed = projectedVelocity/worldLinearVelocity). Replicant TRAVEL stays DeadReckon; the leg channel animates joints only (task #50).
+  related_terms: [replicant, master, SequenceController]
+  related_topics: [multiplayer, locomotion]
+
 viewpoint-entity:
   kind: concept
   definition: application->GetViewpointEntity() — the local pod's own mech (the cockpit view + player controls). Gate player-only logic on `this == GetViewpointEntity()` (Mech::PerformAndWatch runs for EVERY mech).
@@ -312,6 +384,12 @@ methodDescription:
   related_terms: [gauge, attribute-pointer, GaugeRenderer]
   related_topics: [gauges-hud]
 
+gauge:
+  kind: concept
+  definition: A cockpit instrument (widget) rendered by the GaugeRenderer onto the pod's MFD surfaces. Built from gauge\l4gauge.cfg keywords (each resolving to a methodDescription) and bound to game state by NAME via the attribute-pointer system.
+  related_terms: [GaugeRenderer, methodDescription, attribute-pointer, MFD]
+  related_topics: [gauges-hud]
+
 GaugeRenderer:
   kind: class
   definition: The engine gauge system. BuildConfigurationFile parses gauge\l4gauge.cfg via GaugeInterpreter (Initialize->GetProcedureBody->ParsePrimitive). Builds LAZILY -> a too-early process kill shows a false "not built". Composites onto the pod's SVGA16 bit-plane surfaces.
@@ -324,12 +402,24 @@ MFD:
   related_terms: [gauge, GaugeRenderer, SVGA16, pod]
   related_topics: [gauges-hud, pod-hardware]
 
+SVGA16:
+  kind: class
+  definition: The pod's 16-color SVGA gauge surface — ONE shared pixelBuffer the MFD bit-plane masks overlay. SVGA16::BuildWindows makes a fullscreen device + window per gauge/MFD surface on the pod's multi-adapter hardware; SVGA16::DrawDevSurface renders the off-pod dev composite (BT_DEV_GAUGES).
+  related_terms: [MFD, gauge, GaugeRenderer, pod]
+  related_topics: [pod-hardware, gauges-hud]
+
 damage-zone:
   kind: class
   definition: Mech__DamageZone (engine DamageZone base). Armor model: damageLevel += damageAmount*damageScale[type], accumulates to 1.0 (destroyed). Built by the Mech ctor from the DamageZoneStreamResourceType (0x14) resource. Aimed hits route via Entity::TakeDamageMessage.
   related_terms: [DZM, TakeDamage, DZ]
   related_topics: [combat-damage]
 
+TakeDamage:
+  kind: concept
+  definition: The Entity damage message — Entity::TakeDamageMessageID = 18 (NOT 21; runtime-confirmed). Entity::TakeDamageMessage(id, size, inflictingEntityID, zone, Damage&) -> target->Dispatch; the base handler IGNORES zone==-1, the Mech override (@0x4a037a) cylinder-maps unaimed hits and routes damageZones[zone]->TakeDamage.
+  related_terms: [damage-zone, replicant, master]
+  related_topics: [combat-damage, multiplayer]
+
 ground-model:
   kind: concept
   definition: The authentic 1995 vertical-position model (FUN_004a9b5c). NO GRAVITY — an ABSOLUTE per-frame ground SNAP via the zone BoundingBoxTree (FindBoundingBoxUnder), lift = 5% of volume X-width. Walls block by FULL FRAME REJECTION; crushable props pass with a crunch.