From 8856915f6e0a34b4f8907acd096c38c6c9cb6e08 Mon Sep 17 00:00:00 2001 From: Gemini CLI Date: Wed, 29 Apr 2026 13:14:36 +0000 Subject: [PATCH 1/2] [#59] clarify documentation for My WS-1 handicap --- tests/playwright/001-battle-hud/001-battle-hud.spec.ts | 4 ++-- tests/playwright/001-battle-hud/DOCS.md | 8 ++++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/tests/playwright/001-battle-hud/001-battle-hud.spec.ts b/tests/playwright/001-battle-hud/001-battle-hud.spec.ts index 39c18996..d44398de 100644 --- a/tests/playwright/001-battle-hud/001-battle-hud.spec.ts +++ b/tests/playwright/001-battle-hud/001-battle-hud.spec.ts @@ -400,14 +400,14 @@ test("documents the battle HUD controls and timebases", async ({ ], documentation: { summary: - "Press **,** again to continue past the regular calculation into `My WS-1`. A negative local weapons adjustment grants the other side of the battle the weapons advantage for the local projection.", + "Press **,** again to continue past the regular calculation into `My WS-1`. This \"My WS-1\" setting credits your side (the side NPA is modeling) with an extra weapons level (+1), granting you the advantage. Although the label shows -1, it represents a +1 weapons advantage for your side.", howToUse: [ "Start from the regular weapons calculation.", "Press **,** one more time to display `My WS-1`.", ], expectedResult: [ "The footer overlay changes to show `My WS-1`.", - "The survivor estimate reflects the opposite weapons assumption, effectively granting your opponent the advantage.", + "The survivor estimate reflects the extra weapons level, granting your side the weapons advantage.", ], caveats: [ "These adjustments follow the same perspective rule: the label is relative to the side NPA is currently modeling as 'you' in the planning view.", diff --git a/tests/playwright/001-battle-hud/DOCS.md b/tests/playwright/001-battle-hud/DOCS.md index 54b7a838..2981abf3 100644 --- a/tests/playwright/001-battle-hud/DOCS.md +++ b/tests/playwright/001-battle-hud/DOCS.md @@ -97,11 +97,11 @@ Press **,** to remove weapons adjustments and return the battle HUD to the regul - The footer no longer shows an adjustment, returning you to the baseline projection. - The selected synthetic fleet and route toward its destination remain visible for easy comparison. -## Model the opposite weapons advantage with My WS-1 +## Model a weapons advantage with My WS-1 -Press **,** again to continue past the regular calculation into `My WS-1`. A negative local weapons adjustment grants the other side of the battle the weapons advantage for the local projection. +Press **,** again to continue past the regular calculation into `My WS-1`. This "My WS-1" setting credits your side (the side NPA is modeling) with an extra weapons level (+1), granting you the advantage. Although the label shows -1, it represents a +1 weapons advantage for your side. -![Model the opposite weapons advantage with My WS-1](./screenshots/006-apply-my-ws-minus-one.png) +![Model a weapons advantage with My WS-1](./screenshots/006-apply-my-ws-minus-one.png) ### How to use it - Start from the regular weapons calculation. @@ -109,7 +109,7 @@ Press **,** again to continue past the regular calculation into `My WS-1`. A neg ### What to expect - The footer overlay changes to show `My WS-1`. -- The survivor estimate reflects the opposite weapons assumption, effectively granting your opponent the advantage. +- The survivor estimate reflects the extra weapons level, granting your side the weapons advantage. ### Caveats - These adjustments follow the same perspective rule: the label is relative to the side NPA is currently modeling as 'you' in the planning view. From c2ebe54d37865b318ed7e0037e57827d0866c601 Mon Sep 17 00:00:00 2001 From: Gemini CLI Date: Wed, 29 Apr 2026 13:32:39 +0000 Subject: [PATCH 2/2] [#59] thoroughly clarify My WS-1 documentation and remove remaining inconsistencies --- tests/playwright/001-battle-hud/001-battle-hud.spec.ts | 4 ++-- tests/playwright/001-battle-hud/DOCS.md | 2 +- tests/playwright/001-battle-hud/README.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/tests/playwright/001-battle-hud/001-battle-hud.spec.ts b/tests/playwright/001-battle-hud/001-battle-hud.spec.ts index d44398de..370e91c4 100644 --- a/tests/playwright/001-battle-hud/001-battle-hud.spec.ts +++ b/tests/playwright/001-battle-hud/001-battle-hud.spec.ts @@ -354,7 +354,7 @@ test("documents the battle HUD controls and timebases", async ({ ], documentation: { summary: - "Press **,** to remove weapons adjustments and return the battle HUD to the regular calculation. This gives you a visual checkpoint for the baseline survivor estimate before trying the opposite assumption.", + "Press **,** to remove weapons adjustments and return the battle HUD to the regular calculation. This gives you a visual checkpoint for the baseline survivor estimate before modeling your own weapons advantage.", howToUse: [ "Start from the `Enemy WS+1` view.", "Press **,** once to step the weapons adjustment back to zero.", @@ -368,7 +368,7 @@ test("documents the battle HUD controls and timebases", async ({ await frameAndAssertBattleMap(appPage); await helper.step("apply-my-ws-minus-one", { - description: "Model the opposite weapons advantage with My WS-1", + description: "Model a weapons advantage with My WS-1", verifications: [ { spec: "Pressing , again displays My WS-1 and changes the footer calculation from the regular baseline", diff --git a/tests/playwright/001-battle-hud/DOCS.md b/tests/playwright/001-battle-hud/DOCS.md index 2981abf3..a850a51c 100644 --- a/tests/playwright/001-battle-hud/DOCS.md +++ b/tests/playwright/001-battle-hud/DOCS.md @@ -85,7 +85,7 @@ You can manually adjust the weapons technology assumptions for a fight to see if ## Return to the regular weapons calculation -Press **,** to remove weapons adjustments and return the battle HUD to the regular calculation. This gives you a visual checkpoint for the baseline survivor estimate before trying the opposite assumption. +Press **,** to remove weapons adjustments and return the battle HUD to the regular calculation. This gives you a visual checkpoint for the baseline survivor estimate before modeling your own weapons advantage. ![Return to the regular weapons calculation](./screenshots/005-clear-combat-handicap.png) diff --git a/tests/playwright/001-battle-hud/README.md b/tests/playwright/001-battle-hud/README.md index bc10263f..70f918cb 100644 --- a/tests/playwright/001-battle-hud/README.md +++ b/tests/playwright/001-battle-hud/README.md @@ -61,9 +61,9 @@ Companion user documentation: [DOCS.md](./DOCS.md) - [x] The fake enemy fleet and battle route remain selected after clearing the handicap - [x] The regular-calculation screenshot keeps Hot Sham, the selected fleet route, and the battle HUD footer in frame -## Model the opposite weapons advantage with My WS-1 +## Model a weapons advantage with My WS-1 -![Model the opposite weapons advantage with My WS-1](./screenshots/006-apply-my-ws-minus-one.png) +![Model a weapons advantage with My WS-1](./screenshots/006-apply-my-ws-minus-one.png) ### Verifications - [x] Pressing , again displays My WS-1 and changes the footer calculation from the regular baseline