mod/data: document verified swap-to-vault semantics + save MEN tune spec

RaidAutomationPlugin.Mutations.cs: comment-only — record the live-verified
behavior that an artifact swap commits on the RECEIVER and sends the receiver's
old piece to the VAULT (the donor is NOT given a hand-me-down), so the
"/bulk-equip doesn't commit" misdiagnosis isn't repeated.

data/targets/men_force_daily_robust.json: the MEN speed-tune spec
(292/174/225/178/162) with tight min==max targets, for the team gear optimizer.
Holds Magic/Spirit/Void; NOT Force-robust (documented in memory).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: SnoopLawg

data/targets/men_force_daily_robust.json

@@ -0,0 +1,11 @@
+{
+  "_doc": "MEN daily-robust Force tune. Exact SPD tuple 292/174/225/178/162 holds Magic/Spirit/Void (Y/Y/Y) and Force 100% (validated 2026-06-24 via speed_tune_finder --all-affinities --mc). Pinned min==max because the 5-hero cadence is COUPLED — overshooting Demytha->175 or Venomage->163 breaks the stable days (see project_cb_tune_equip_flow). Field with: team_gear_optimizer.py --spec this --equipped-only --json, then loadouts.apply (snapshot team+donors first), then re-validate LIVE speeds.",
+  "team": [
+    {"hero": "Maneater",  "mode": "survivability", "min": {"SPD": 292}, "max": {"SPD": 292}},
+    {"hero": "Demytha",   "mode": "survivability", "min": {"SPD": 174}, "max": {"SPD": 174}, "weight": {"ACC": 1}},
+    {"hero": "Ninja",     "mode": "damage",        "min": {"SPD": 225}, "max": {"SPD": 225}},
+    {"hero": "Geomancer", "mode": "survivability", "min": {"SPD": 178}, "max": {"SPD": 178}},
+    {"hero": "Venomage",  "mode": "damage",        "min": {"SPD": 162}, "max": {"SPD": 162}}
+  ],
+  "priority": ["Ninja", "Maneater", "Demytha", "Geomancer", "Venomage"]
+}

mod/bepinex/RaidAutomationPlugin.Mutations.cs

@@ -552,7 +552,15 @@ private string BulkEquipArtifacts(string heroIdStr, string artifactsJson)
 
                     if (existingArtId > 0)
                     {
-                        // Slot occupied — use SwapArtifactCmd
+                        // Slot occupied — use SwapArtifactCmd.
+                        // VERIFIED LIVE (2026-06-24): this commits reliably on the
+                        // RECEIVER. SwapArtifactCmd(hero, owner, fromId, toId) pulls
+                        // `toId` onto `hero` and sends `hero`'s old piece (`fromId`)
+                        // to the VAULT — the donor `owner` is left with an EMPTY slot
+                        // and does NOT receive `fromId` (the param name is misleading).
+                        // That's correct Raid equip semantics. Execute() applies the
+                        // optimistic edit synchronously on the main thread, so the
+                        // change is visible in /all-heroes immediately after.
                         int ownerId = GetArtifactOwner(equipment, artId);
                         if (ownerId <= 0) ownerId = heroId;
                         if (swapCmdType != null)