support snapper as a familiar

src/familiar/freeFightFamiliar.ts

@@ -1,5 +1,17 @@
 import { Familiar, familiarWeight, inebrietyLimit, Location, myInebriety } from "kolmafia";
-import { $familiar, $item, $location, clamp, findLeprechaunMultiplier, get, have } from "libram";
+import {
+  $familiar,
+  $item,
+  $location,
+  $monsters,
+  $phylum,
+  $skill,
+  clamp,
+  findLeprechaunMultiplier,
+  get,
+  have,
+  Snapper,
+} from "libram";
 import { canOpenRedPresent } from ".";
 import { garboValue } from "../value";
 import getConstantValueFamiliars from "./constantValueFamiliars";
@@ -69,6 +81,46 @@ export function menu(options: MenuOptions = {}): GeneralFamiliar[] {
         limit: "special",
       });
     }
+    if (
+      location === $location`Barf Mountain` &&
+      Snapper.have() &&
+      Snapper.getTrackedPhylum() === $phylum`dude`
+    ) {
+      /*
+      # E stands for olfacted Garbage Tourist, A is angry toursit, F is horrible tourist family
+      import itertools
+      def rate(q):
+        m = ["E"] * 5 + ["A"] * 2 + ["F"] * 2
+        options = list(itertools.product(m, m))
+        dude = [m for m in options if (m[0] in ["A", "F"] and m[0] not in q) or (m[1] in ["A", "F"] and m[0] in q and m[0] != "E")]
+        return len(dude) / 81
+      */
+
+      const dudes = $monsters`angry tourist, horrible tourist family`.filter((m) =>
+        $location`Barf Mountain`.combatQueue.includes(`${m}`),
+      ).length;
+
+      // if you don't have olfaction, just assume a simple rate calculation
+      const noOlfactRate = 4 / (1 + 4 + (have($skill`Gallapagosian Mating Call`) ? 1 : 0));
+
+      // when you have olfaction, you
+      // using the above python script, dude rate for number of dudes in queue is:
+      const olfactRate =
+        [
+          0.44, // 0 dudes = 44% chance
+          0.32, // 1 dude = 32% chance
+          0.19, // 2 dudes = 19% chance
+        ][dudes] ?? 0;
+
+      const dudeRate = have($skill`Transcendent Olfaction`) ? olfactRate : noOlfactRate;
+
+      familiarMenu.push({
+        familiar: $familiar`Red-Nosed Snapper`,
+        expectedValue: (dudeRate * garboValue($item`human musk`)) / 11,
+        leprechaunMultiplier: 0,
+        limit: "none",
+      });
+    }
   }
 
   const meatFam = meatFamiliar();

src/fights.ts

@@ -106,6 +106,7 @@ import {
   Requirement,
   Robortender,
   set,
+  Snapper,
   SourceTerminal,
   sum,
   tryFindFreeRun,
@@ -994,7 +995,9 @@ const freeFightSources = [
   new FreeFight(
     () => (wantPills() ? 5 - get("_saberForceUses") : 0),
     () => {
-      if (have($familiar`Red-Nosed Snapper`)) cliExecute(`snapper ${$phylum`dude`}`);
+      if (Snapper.have() && Snapper.getTrackedPhylum() !== $phylum`dude`) {
+        Snapper.trackPhylum($phylum`dude`);
+      }
       setChoice(1387, 3);
       if (
         have($skill`Comprehensive Cartography`) &&

src/tasks/dailyFamiliars.ts

@@ -18,11 +18,13 @@ import {
   $familiars,
   $item,
   $items,
+  $phylum,
   CrimboShrub,
   get,
   have,
   Robortender,
   set,
+  Snapper,
   sum,
   withProperty,
 } from "libram";
@@ -227,6 +229,12 @@ const DailyFamiliarTasks: GarboTask[] = [
       !!get("garbo_felizValue", 0) || today - get("garbo_felizValueDate", 0) < 24 * 60 * 60 * 1000,
     do: () => felizValue,
   },
+  {
+    name: "Snapper Hunts Dudes",
+    ready: () => Snapper.have(),
+    completed: () => Snapper.getTrackedPhylum() === $phylum`dude`,
+    do: () => Snapper.trackPhylum($phylum`dude`),
+  },
 ];
 
 export const DailyFamiliarsQuest: Quest<GarboTask> = {