Merge branch 'main' into extend-multiplayer

README.md

@@ -140,4 +140,55 @@ terminal_quest/
 ## Best Practices
 
 ### Code Organization
-- Modular design
+- Modular design with clear separation of concerns
+- Configuration centralized in settings.py
+- Type hints throughout the codebase
+- Comprehensive documentation and comments
+
+### CI/CD
+- Automated testing on pull requests
+- Dependency updates via Dependabot
+- Code quality checks:
+  - Type checking with mypy
+  - Linting with flake8
+  - Formatting with black
+  - Security scanning with bandit
+- Automated test coverage reporting
+
+### Error Handling
+- Graceful fallback system for AI failures
+- Input validation for all user interactions
+- Proper exception handling for file and API operations
+
+### Game Balance
+- Configurable game constants in settings.py
+- Balanced stat ranges for characters and items
+- Progressive difficulty scaling
+- Fair item drop rates and shop prices
+
+### Performance
+- Efficient status effect processing
+- Minimal API calls with caching
+- Optimized combat calculations
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Follow the established code style:
+   - Use type hints
+   - Follow PEP 8
+   - Add docstrings for functions and classes
+   - Update tests if applicable
+4. Submit a pull request
+
+## Future Enhancements
+- Quest system
+- More character classes
+- Additional status effects
+- Enhanced AI integration
+- Saving/loading system
+- Multiplayer support
+
+## License
+This project is licensed under the MIT License - see the LICENSE file for details.

main.py

@@ -106,6 +106,8 @@ def main():
 
     base_view.clear_screen()
 
+    base_view.clear_screen()
+
     # Main game loop
     while player.health > 0:
         BaseView.clear_screen()

src/models/character.py

@@ -2,7 +2,6 @@
 from typing import Dict, List, Optional, Any
 
 from .skills import Skill
-
 from ..display.common.message_view import MessageView
 from .base_types import GameEntity, EffectTrigger
 from .effects.base import BaseEffect
@@ -196,7 +195,7 @@ def __init__(self, name: str, char_class: CharacterClass):
 
         # Session management attributes
         self.session_id = None
-
+    
     def equip_item(self, item: "Equipment") -> bool:
         """
         Equip an item to the appropriate slot
@@ -349,7 +348,6 @@ def deserialize(cls, data: Dict[str, Any]) -> "Player":
         player.session_id = data["session_id"]
         return player
 
-
 class Enemy(Character):
     def __init__(
         self,

src/services/combat.py

@@ -16,13 +16,11 @@
 from src.services.shop import Shop
 from src.services.boss import BossService
 
-
 class CombatResult(Enum):
     VICTORY = auto()
     DEFEAT = auto()
     RETREAT = auto()
 
-
 def calculate_damage(
     attacker: "Character", defender: "Character", base_damage: int
 ) -> int:
@@ -289,7 +287,6 @@ def combat(
 
     return not enemy_queue  # True for victory, False for defeat
 
-
 def handle_level_up(player: Player):
     """Handle level up logic and display"""
     player.level += 1

src/services/shop.py

@@ -13,7 +13,6 @@
 import psycopg2
 from src.config.settings import DATABASE_SETTINGS
 
-
 class ShopType(Enum):
     GENERAL = "general"
     BLACKSMITH = "blacksmith"  # Weapons and armor