Add fishing area to Fish ranking dimensions

Author: metyatech

AGENTS.md

@@ -89,6 +89,7 @@ Source: github:metyatech/agent-rules@HEAD/rules/global/command-execution.md
 - Do not assume agent platform capabilities beyond what is available; fail explicitly when unavailable.
 - When building a CLI, follow standard conventions: --help/-h, --version/-V, stdin/stdout piping, --json output, --dry-run for mutations, deterministic exit codes, and JSON Schema config validation.
 - Treat `agent-browser` sessions as temporary resources: close them immediately when they are no longer needed, and before concluding a task verify that no sessions spawned for that task remain open.
+- When launching `agent-browser` on Windows, do not rely on the implicit default session; always provide an explicit `--session <name>` or set `AGENT_BROWSER_SESSION` to a chosen session name before use, and if a localhost bind/access error occurs (for example `os error 10013`), retry with a different explicit session name instead of reusing the blocked default session, then report the working session name or the remaining failure.
 - For federated identity flows (Google, Apple, Microsoft, GitHub, etc.), when automation-launched browser contexts are blocked, degraded, or risky, hand off only the IdP step to a real browser/session via CDP or explicit user interaction, then resume automation after the redirect; do not try to bypass provider anti-automation or embedded-browser restrictions.
 ## Codex-only PowerShell safety
 - `Remove-Item` (aliases: `rm`, `ri`, `del`, `erase`) ↁEUse: `if ([IO.File]::Exists($p)) { [IO.File]::SetAttributes($p,[IO.FileAttributes]::Normal); [IO.File]::Delete($p) }`

CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project are documented here.
 
 ## [Unreleased]
 
+## [0.12.71] - 2026-03-16
+
+### Changed
+
+- **Fishing Area is now a first-class ranking dimension**: ranking mode can treat `釣り場` like `Rod / Line / Bobber / Enchant`, so you can rank areas directly or include area alongside gear in combination searches instead of hiding area choice inside setup only.
+- **The ranking and optimizer internals now carry area identity all the way through the result rows**: subset searches, multi-slot rankings, and result tables keep `areaId` / area name attached to each candidate, which lets the UI show area-aware rankings without special-case postprocessing.
+
 ## [0.12.70] - 2026-03-16
 
 ### Changed

README.md

@@ -88,7 +88,7 @@ npm run dev
 - **今の装備を見たまま候補を比べられる**: 候補パネルを開いても左の現在装備表は隠れないので、ほかの装備や合計ステータスを見失わずに選び直せます。
 - **入力が先、結果は後**: 先に場所や装備を決めてから候補や結果を見る流れにしているため、初見でも手順を追いやすくしています。
 - **いまの目的を常に表示**: `基準装備 / 釣り場 / 時間帯 / 天気 / この条件の目安` をコンテキスト欄に固定し、何を見ているかを見失いにくくしています。
-- **ランキングはスロット順位として読める**: 選んだ欄だけを入れ替え、ほかの欄は今の装備のまま固定して順位を出します。Fishing Area を自動のまま使うと、同じ装備でも釣り場ごとに別行で順位が出ます。
+- **ランキングは欄ごとの順位として読める**: `Rod / Line / Bobber / Enchant / 釣り場` のうち選んだ欄だけを入れ替え、ほかの欄は今の装備のまま固定して順位を出します。釣り場を選べば「同じ装備でどの場所が強いか」、Rod と釣り場を同時に選べば「Rod と釣り場をセットで替えたときの順位」をそのまま見られます。
 - **次に試す候補をすぐ出す**: `今の装備から次を探す` では、その目的に合わせた最初の候補と期待値/時間の差をすぐ提示します。
 - **細かい設定は後ろへ**: `詳細調整` に推定前提やレア度上書きをまとめ、必要になるまで初期表示から退かせています。
 
@@ -109,12 +109,12 @@ npm run dev
 - `入手場所` は 1 つだけでなく、`さらに絞る` から複数の場所をまとめて残せます。
 - まず 1 か所だけ変えて比べたいときに使います。
 
-### 組み合わせ最適化（複数スロット）
+### 組み合わせ最適化（複数欄）
 
-- `Rod / Line / Bobber / Enchant` の4つを複数選択すると、変えるスロットを自由に組み合わせて探せます（最低 1 つ）。
+- ランキングでは `Rod / Line / Bobber / Enchant / 釣り場` を複数選択すると、変える欄を自由に組み合わせて探せます（最低 1 つ）。
 - **全スロット選択**（デフォルト）は全装備の組み合わせ候補（理論上 15 × 8 × 8 × 43 = **41,280 通り**）から、能力的に完全に劣る Rod / Line / Bobber を先に外した exact search を行い、期待値/時間の上位候補を一覧表示します。
-- **部分サブセット**（例: Rod + Enchant）を選ぶと、固定スロットはいまの装備のまま、変えるスロットだけを組み合わせて探します。
-- 変えるスロットは画面の `Rod / Line / Bobber / Enchant` ボタンを複数選択して切り替えます。現在の選択は説明カードで常に確認できます。
+- **部分サブセット**（例: Rod + Enchant、Rod + 釣り場）を選ぶと、固定欄はいまの装備 / 条件のまま、選んだ欄だけを組み合わせて探します。
+- 変える欄はランキングの `Rod / Line / Bobber / Enchant / 釣り場` ボタンを複数選択して切り替えます。現在の選択は説明カードで常に確認できます。
 - 上位 K 候補への枝刈りなし。除外された装備はありません。
 - Luck スケーリング・時間モデル・Big Catch weight percentile などの experimental 近似モデルを前提とした推定値です。
 - 検索中にスピナーとプログレスバーで進捗を表示し、途中経過の上位候補をリアルタイムで確認できます（「速報」として表示）。
@@ -144,7 +144,7 @@ npm run dev
 
 5. **次に、比べる欄を選ぶ**: `Rod / Line / Bobber / Enchant` の4つを押して、1欄だけ見るか、複数スロットを同時に探すかを切り替えます。
 
-6. **ランキングは、見たい欄を先に選ぶ**: `2. 順位を見る欄を選ぶ` で `Rod / Line / Bobber / Enchant` を1つ選ぶと個別順位、複数選ぶと組み合わせ最適化になります。Fishing Area が自動なら、同じ装備でも `Coconut Bay` / `Tangleyew Marshes` のように釣り場ごとに別行で並びます。
+6. **ランキングは、見たい欄を先に選ぶ**: `2. 順位を見る欄を選ぶ` で `Rod / Line / Bobber / Enchant / 釣り場` を1つ選ぶと個別順位、複数選ぶとその欄だけを同時に入れ替えた順位になります。釣り場だけを選べば「この装備でどの場所が強いか」、Rod と釣り場を選べば「Rod と場所を同時に替えたときの順位」をそのまま見られます。
 
 7. **`3. 順位を見る` でそのまま比較する**: 先に順位を見て、必要ならあとで `4. 必要なら条件を変える` を開きます。Fishing Area を固定したときはその釣り場だけ、Fishing Area を自動にしたときは釣り場ごとの順位をそのまま確認できます。
 

e2e/smoke.spec.ts

@@ -135,12 +135,13 @@ test('calculator updates summary cards and fish list when loadout and filters ch
     })
     .click();
   expect(await page.getByTestId('slot-picker-panel').count()).toBe(0);
-  await page.getByLabel('釣り場').selectOption('open-sea');
-  await page.getByLabel('時間帯').selectOption('night');
-  await page.getByLabel('天気').selectOption('rainy');
-  await page.getByLabel('投げてから着水まで (sec)').fill('1.4');
-  await page.getByLabel('`!` が出てから反応するまで (sec)').fill('0.25');
-  await page.getByLabel('ミス率').fill('0.12');
+  const setupSection = page.getByTestId('setup-section');
+  await setupSection.getByLabel('釣り場').selectOption('open-sea');
+  await setupSection.getByLabel('時間帯').selectOption('night');
+  await setupSection.getByLabel('天気').selectOption('rainy');
+  await setupSection.getByLabel('投げてから着水まで (sec)').fill('1.4');
+  await setupSection.getByLabel('`!` が出てから反応するまで (sec)').fill('0.25');
+  await setupSection.getByLabel('ミス率').fill('0.12');
 
   await page.getByRole('button', { name: /今の装備から次を探す/ }).click();
   await page.getByTestId('compare-slot-button-enchant').click();

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "vrchat-fish-guide",
-  "version": "0.12.70",
+  "version": "0.12.71",
   "private": true,
   "description": "Unofficial community guide and probability calculator for the VRChat world Fish!",
   "homepage": "https://metyatech.github.io/vrchat-fish-guide/",

package.json

@@ -23,7 +23,7 @@ import {
   formatCurrency,
   getDefaultParams,
 } from '@/lib/calculator';
-import { rankAllSlots, RankSlot } from '@/lib/ranking';
+import { rankAllSlots, RankDimension, RankSlot } from '@/lib/ranking';
 import {
   createBuildFrom,
   createDefaultBuild,
@@ -36,14 +36,16 @@ import {
 } from '@/lib/url-state';
 import { BuildConfig, CalculatorParams, DistributionResult, Rarity } from '@/types';
 
-const SLOT_LABELS: Record<RankSlot, string> = {
+const SLOT_LABELS: Record<RankDimension, string> = {
   rod: 'Rod',
   line: 'Line',
   bobber: 'Bobber',
   enchant: 'Enchant',
+  area: '釣り場',
 };
 
-const ALL_SLOTS: RankSlot[] = ['rod', 'line', 'bobber', 'enchant'];
+const EQUIPMENT_SLOTS: RankSlot[] = ['rod', 'line', 'bobber', 'enchant'];
+const RANKING_SLOTS: RankDimension[] = ['rod', 'line', 'bobber', 'enchant', 'area'];
 
 const GOAL_HELPER_COPY: Record<CalculatorGoal, string> = {
   ranking: '見たい欄を選ぶと、その候補が強い順に並びます。',
@@ -132,7 +134,7 @@ export function CalculatorPageClient() {
   const [activeId, setActiveId] = useState(initialActiveId);
   const [chartMode, setChartMode] = useState<'per-catch' | 'per-hour'>('per-hour');
   const [urlRestoreError, setUrlRestoreError] = useState<string | undefined>(initialUrlError);
-  const [selectedSlots, setSelectedSlots] = useState<RankSlot[]>(['rod']);
+  const [selectedSlots, setSelectedSlots] = useState<RankDimension[]>(['rod']);
   const [goalView, setGoalView] = useState<CalculatorGoal>(() =>
     initialBuilds.length > 1 ? 'compare' : 'ranking',
   );
@@ -156,6 +158,12 @@ export function CalculatorPageClient() {
   // Ref to the setup section (step 2); used to scroll into view after goal selection.
   const nextSectionRef = useRef<HTMLElement | null>(null);
   const handleGoalChange = useCallback((goal: CalculatorGoal) => {
+    if (goal !== 'ranking') {
+      setSelectedSlots((prev) => {
+        const next = EQUIPMENT_SLOTS.filter((slot) => prev.includes(slot));
+        return next.length > 0 ? next : ['rod'];
+      });
+    }
     setGoalView(goal);
     requestAnimationFrame(() => {
       nextSectionRef.current?.scrollIntoView({ behavior: 'smooth', block: 'nearest' });
@@ -195,7 +203,9 @@ export function CalculatorPageClient() {
   // ── Build operations ───────────────────────────────────────────────────────
 
   const activeBuild = builds.find((b) => b.id === activeId) ?? builds[0];
-  const orderedSelectedSlots = ALL_SLOTS.filter((slot) => selectedSlots.includes(slot));
+  const isRankingGoal = goalView === 'ranking';
+  const availableRankSlots = isRankingGoal ? RANKING_SLOTS : EQUIPMENT_SLOTS;
+  const orderedSelectedSlots = availableRankSlots.filter((slot) => selectedSlots.includes(slot));
   const isSingleSlotSelection = orderedSelectedSlots.length === 1;
   const primarySlot = orderedSelectedSlots[0] ?? 'rod';
 
@@ -245,7 +255,7 @@ export function CalculatorPageClient() {
   }, []);
 
   const handleCreateSlotComparison = useCallback(
-    (slot: RankSlot, itemId: string, itemName: string) => {
+    (slot: RankDimension, itemId: string, itemName: string) => {
       if (!activeBuild) return;
 
       const currentItemId =
@@ -255,18 +265,24 @@ export function CalculatorPageClient() {
             ? activeBuild.params.loadout.lineId
             : slot === 'bobber'
               ? activeBuild.params.loadout.bobberId
-              : activeBuild.params.loadout.enchantId;
+              : slot === 'enchant'
+                ? activeBuild.params.loadout.enchantId
+                : activeBuild.params.areaId;
 
       if (itemId === currentItemId) return;
 
       const nextBuild = createBuildFrom(activeBuild, builds.length);
       nextBuild.name = `${itemName} を試す`;
       nextBuild.params = {
         ...nextBuild.params,
-        loadout: {
-          ...nextBuild.params.loadout,
-          [`${slot}Id`]: itemId,
-        },
+        ...(slot === 'area'
+          ? { areaId: itemId }
+          : {
+              loadout: {
+                ...nextBuild.params.loadout,
+                [`${slot}Id`]: itemId,
+              },
+            }),
       };
 
       setBuilds((prev) => [...prev, nextBuild]);
@@ -292,7 +308,9 @@ export function CalculatorPageClient() {
           ? activeBuild.params.loadout.lineId
           : primarySlot === 'bobber'
             ? activeBuild.params.loadout.bobberId
-            : activeBuild.params.loadout.enchantId;
+            : primarySlot === 'enchant'
+              ? activeBuild.params.loadout.enchantId
+              : activeBuild.params.areaId;
 
     if (bestEntry.item.id === currentItemId) return;
 
@@ -309,7 +327,7 @@ export function CalculatorPageClient() {
       if (!activeBuild) return;
       const nextBuild = createBuildFrom(activeBuild, builds.length);
       const varyingLabel =
-        orderedSelectedSlots.length === ALL_SLOTS.length
+        orderedSelectedSlots.length === EQUIPMENT_SLOTS.length
           ? '4スロット比較'
           : orderedSelectedSlots.map((slot) => SLOT_LABELS[slot]).join('+');
       nextBuild.name = rank === 0 ? `${varyingLabel}のおすすめ` : `${varyingLabel} ${rank + 1}`;
@@ -384,10 +402,9 @@ export function CalculatorPageClient() {
   const selectionThemeKey: CompareTarget = isSingleSlotSelection ? primarySlot : 'full-build';
   const compareTargetTheme = SLOT_THEME[selectionThemeKey];
   const selectedSlotsLabel = orderedSelectedSlots.map((slot) => SLOT_LABELS[slot]).join(' + ');
-  const fixedSlots = ALL_SLOTS.filter((slot) => !orderedSelectedSlots.includes(slot));
+  const fixedSlots = availableRankSlots.filter((slot) => !orderedSelectedSlots.includes(slot));
   const fixedSlotsLabel =
     fixedSlots.length > 0 ? fixedSlots.map((slot) => SLOT_LABELS[slot]).join(' / ') : 'なし';
-  const isRankingGoal = goalView === 'ranking';
   const isUpgradeGoal = goalView === 'upgrade';
   const showSelectionTools = isRankingGoal || isUpgradeGoal;
   const selectionHelperText = isSingleSlotSelection
@@ -687,7 +704,7 @@ export function CalculatorPageClient() {
               </div>
 
               <div data-testid="compare-slot-selector" className="mb-4 flex flex-wrap gap-2">
-                {ALL_SLOTS.map((slot) => {
+                {availableRankSlots.map((slot) => {
                   const isSelected = orderedSelectedSlots.includes(slot);
                   const theme = SLOT_THEME[slot];
                   return (
@@ -701,11 +718,11 @@ export function CalculatorPageClient() {
                               ? prev.filter((candidate) => candidate !== slot)
                               : prev
                             : [...prev, slot];
-                          return ALL_SLOTS.filter((candidate) => next.includes(candidate));
+                          return availableRankSlots.filter((candidate) => next.includes(candidate));
                         })
                       }
                       aria-pressed={isSelected}
-                      aria-label={`${SLOT_LABELS[slot]} ${isSelected ? '選択中' : '未選択'}`}
+                      aria-label={`順位に含める ${SLOT_LABELS[slot]} ${isSelected ? '選択中' : '未選択'}`}
                       data-state={isSelected ? 'selected' : 'idle'}
                       data-testid={`compare-slot-button-${slot}`}
                       className={`flex min-w-[9.5rem] items-center justify-between gap-3 rounded-2xl border px-4 py-2.5 text-left text-sm font-semibold transition-all duration-150 hover:-translate-y-0.5 active:translate-y-0 ${
@@ -860,22 +877,16 @@ export function CalculatorPageClient() {
                     alwaysOpen={true}
                     onPickItem={isRankingGoal ? undefined : handleCreateSlotComparison}
                     showPickActions={!isRankingGoal}
-                    includeAreaBreakdown={
-                      isRankingGoal && activeBuild.params.areaId === BEST_AREA_ID
-                    }
+                    includeAreaBreakdown={false}
                     title={isRankingGoal ? undefined : `${SLOT_LABELS[primarySlot]} の候補一覧`}
                     description={
                       isRankingGoal
-                        ? activeBuild.params.areaId === BEST_AREA_ID
-                          ? `${SLOT_LABELS[primarySlot]} だけを入れ替えた順位を、釣り場ごとに並べています。${fixedSlotsLabel} は今の装備のまま固定です。`
-                          : `${SLOT_LABELS[primarySlot]} だけを入れ替えた順位です。${fixedSlotsLabel} は今の装備のまま固定です。`
+                        ? `${SLOT_LABELS[primarySlot]} だけを入れ替えた順位です。${fixedSlotsLabel} は今の装備のまま固定です。`
                         : undefined
                     }
                     helperText={
                       isRankingGoal
-                        ? activeBuild.params.areaId === BEST_AREA_ID
-                          ? `${SLOT_LABELS[primarySlot]} だけを変えた結果を、釣り場ごとに見ます。`
-                          : `${SLOT_LABELS[primarySlot]} だけを変えた結果です。`
+                        ? `${SLOT_LABELS[primarySlot]} だけを変えた結果です。`
                         : undefined
                     }
                   />