Documentation and Version Update

README.md

@@ -33,6 +33,7 @@ BattleWords is a vocabulary learning game inspired by classic Battleship mechani
 - Overlapping words on shared letters (Beta)
 - Daily and practice modes (Full)
 - Leaderboards, persistence, and advanced features (Full)
+- **Game ends when all words are guessed or all word letters are revealed**
 
 ## Installation
 1. Clone the repository:
@@ -82,7 +83,7 @@ streamlit run app.py
 1. Click grid squares to reveal letters or empty spaces.
 2. After revealing a letter, enter a guess for a word in the text box.
 3. Earn points for correct guesses and bonus points for unrevealed letters.
-4. The game ends when all six words are found. Your score tier is displayed.
+4. **The game ends when all six words are found or all word letters are revealed. Your score tier is displayed.**
 
 ## Development Phases
 

battlewords/__init__.py

@@ -1,2 +1,2 @@
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 __all__ = ["models", "generator", "logic", "ui"]

specs/requirements.md

@@ -81,7 +81,7 @@ Acceptance: Generator returns a valid `Puzzle` passing validation checks (no col
   - If incorrect: no points awarded.
   - After any guess, set `can_guess=False` and require another reveal before next guess.
   - Streamlit: `with st.form("guess"):` + `st.text_input("Your guess", key="guess_text")` + `st.form_submit_button("OK", disabled=not st.session_state.can_guess)`; after guess, call `st.rerun()`.
-- End of game when all 6 words are guessed; display summary and tier, then `st.stop()`.
+- **End of game when all 6 words are guessed or all word letters are revealed; display summary and tier, then `st.stop()`.**
 
 Acceptance: Unit tests cover scoring, guess gating, and reveal behavior.
 

specs/specs.md

@@ -20,6 +20,7 @@ Battlewords is inspired by the classic Battleship game, but uses words instead o
 - After revealing a letter, players may guess a word by entering it in a text box.
 - Guess submission triggers an immediate rerun to reflect results.
 - Only one guess per letter reveal; must uncover another letter before guessing again.
+- **The game ends when all six words are guessed or all word letters are revealed.**
 
 ## Scoring
 - Each correct word guess awards points:
@@ -29,6 +30,7 @@ Battlewords is inspired by the classic Battleship game, but uses words instead o
   - Good: 34-37
   - Great: 38-41
   - Fantastic: 42+
+- **Game over is triggered by either all words being guessed or all word letters being revealed.**
 
 ## POC (0.1.0) Rules
 - No overlaps: words do not overlap or share letters.