docs: fix requirements.txt formatting

Remove AI preamble text, clean up section comments.

Author: itniuma2026

requirements.txt

@@ -1,138 +1,116 @@
-Based on the analysis, here's the updated requirements.txt with comments grouped by purpose/category:
-
-```txt
-# ============================================
-# CORE TERMINAL/CASINO FRAMEWORK DEPENDENCIES
-# ============================================
-
-# Terminal output styling and colors
-colorama==0.4.6          # Used by casino/utils.py for colored terminal output
-
-# Enhanced logging with colors
-coloredlogs==15.0.1      # Formatted logging output
-humanfriendly==10.0      # Human-readable logging (coloredlogs dependency)
-
-# Input handling for enhanced user interaction
-keyboard==0.13.5         # Keyboard input detection and handling
-
-# Windows terminal enhancement
-pyreadline3==3.4.1       # Readline functionality for Windows terminals
-
-
-# ============================================
-# AUDIO/VISUAL & GAME PRESENTATION
-# ============================================
-
-# Game audio and visual effects
-pygame==2.6.1            # Sound effects and audio playback for casino games
-
-# Screen automation and GUI interaction
-PyAutoGUI==0.9.54        # Screen automation and GUI control
-PyGetWindow==0.0.9       # Window management (PyAutoGUI dependency)
-PyMsgBox==1.0.9          # Message boxes (PyAutoGUI dependency)
-PyRect==0.2.0            # Rectangle operations (PyAutoGUI dependency)
-PyScreeze==0.1.29        # Screenshot functionality (PyAutoGUI dependency)
-pytweening==1.0.7        # Tweening animations (PyAutoGUI dependency)
-pyperclip==1.8.2         # Clipboard operations (PyAutoGUI dependency)
-pyscreenshot==3.1        # Screenshot capture (PyAutoGUI dependency)
-mss==9.0.1               # Fast screenshot capture (PyAutoGUI dependency)
-MouseInfo==0.1.3         # Mouse position info (PyAutoGUI dependency)
-EasyProcess==1.1         # Process management (PyAutoGUI dependency)
-entrypoint2==1.1         # Entry point utilities (PyAutoGUI dependency)
-
-
-# ============================================
-# CARD IMAGE PROCESSING (rembg dependencies)
-# ============================================
-
-# Background removal for card images
-rembg==2.0.56            # Remove backgrounds from card images
-
-# Image processing libraries
-Pillow==10.0.1           # Image manipulation (rembg dependency)
-opencv-python-headless==4.9.0.80  # Computer vision (rembg dependency)
-scikit-image==0.22.0     # Image processing algorithms (rembg dependency)
-imageio==2.34.0          # Image I/O operations (rembg dependency)
-tifffile==2024.2.12      # TIFF image support (rembg dependency)
-
-# Machine learning/AI for image processing
-onnxruntime==1.17.1      # ONNX model runtime (rembg dependency)
-numpy==1.26.4            # Numerical computing (rembg dependency)
-scipy==1.12.0            # Scientific computing (rembg dependency)
-
-# Performance optimization
-numba==0.59.1            # JIT compilation for performance (rembg dependency)
-llvmlite==0.42.0         # LLVM compiler infrastructure (numba dependency)
-
-# Data fetching and management
-pooch==1.8.1             # Data file fetcher (rembg dependency)
-
-# Advanced image matting
-PyMatting==1.1.12        # Alpha matting for image composition (rembg dependency)
-
-# Protocol and serialization
-protobuf==5.26.1         # Protocol buffers (rembg dependency)
-flatbuffers==24.3.25     # FlatBuffers serialization (rembg dependency)
-
-# Mathematical computations
-sympy==1.12              # Symbolic mathematics (rembg dependency)
-mpmath==1.3.0            # Arbitrary-precision arithmetic (sympy dependency)
-
-
-# ============================================
-# DATA HANDLING & ANALYTICS
 # ============================================
-
-# Data analysis and statistics
-pandas==2.1.1            # Data manipulation and analysis for game statistics
-
-# Timezone and date handling
-python-dateutil==2.8.2   # Date parsing (pandas dependency)
-pytz==2023.3.post1       # Timezone support (pandas dependency)
-tzdata==2023.3           # Timezone database (pandas dependency)
-six==1.16.0              # Python 2/3 compatibility (pandas dependency)
-
-
+# Terminal Casino - Requirements
 # ============================================
-# NETWORK & EXTERNAL COMMUNICATION
+# Organized by purpose. See each section for
+# which part of the project uses the package.
 # ============================================
 
-# HTTP requests for external services
-requests==2.31.0         # HTTP requests for API calls or data fetching
-certifi==2024.2.2        # SSL certificates (requests dependency)
-charset-normalizer==3.3.2 # Character encoding (requests dependency)
-idna==3.6                # Internationalized Domain Names (requests dependency)
-urllib3==2.2.1           # HTTP client (requests dependency)
-
-
-# ============================================
-# CONFIGURATION & VALIDATION
-# ============================================
-
-# Configuration schema validation
-jsonschema==4.21.1       # JSON schema validation for config files
-attrs==23.2.0            # Classes without boilerplate (jsonschema dependency)
-referencing==0.34.0      # JSON reference resolution (jsonschema dependency)
-rpds-py==0.18.0          # Persistent data structures (jsonschema dependency)
-jsonschema-specifications==2023.12.1  # JSON schema specs (jsonschema dependency)
-
-
-# ============================================
-# UTILITIES & MISC TOOLS
-# ============================================
-
-# Graph algorithms and data structures
-networkx==3.2.1          # Graph theory algorithms (potential for game logic)
-
-# Package version handling
-packaging==24.0          # Version parsing and comparison
-
-# Platform-specific directory handling
-platformdirs==4.2.0      # Platform-appropriate directories
-
-# Progress bars and loading indicators
-tqdm==4.66.2             # Progress bars for long operations
-
-# Lazy loading optimization
-lazy_loader==0.3         # Lazy loading of modules/resources
-```
+# ------------------------------------------
+# Core Framework (used by all games)
+# ------------------------------------------
+
+# Terminal colors and styled output (casino/utils.py)
+colorama==0.4.6
+
+# Logging
+coloredlogs==15.0.1
+humanfriendly==10.0      # coloredlogs dependency
+
+# Keyboard input handling
+keyboard==0.13.5
+
+# Windows readline support
+pyreadline3==3.4.1
+
+# ------------------------------------------
+# Audio & Game Display
+# ------------------------------------------
+
+# Sound effects and audio (used across all games)
+pygame==2.6.1
+
+# ------------------------------------------
+# Screen Automation (PyAutoGUI + dependencies)
+# ------------------------------------------
+
+PyAutoGUI==0.9.54
+MouseInfo==0.1.3         # PyAutoGUI dependency
+PyGetWindow==0.0.9       # PyAutoGUI dependency
+PyMsgBox==1.0.9          # PyAutoGUI dependency
+PyRect==0.2.0            # PyAutoGUI dependency
+PyScreeze==0.1.29        # PyAutoGUI dependency
+pytweening==1.0.7        # PyAutoGUI dependency
+pyperclip==1.8.2         # PyAutoGUI dependency
+pyscreenshot==3.1        # PyAutoGUI dependency
+mss==9.0.1               # PyAutoGUI dependency
+EasyProcess==1.1         # pyscreenshot dependency
+entrypoint2==1.1         # pyscreenshot dependency
+
+# ------------------------------------------
+# Card Image Processing (casino/card_assets.py)
+# Used by: Blackjack, Poker, UNO (card rendering)
+# ------------------------------------------
+
+# Background removal for card assets
+rembg==2.0.56
+onnxruntime==1.17.1      # rembg dependency
+opencv-python-headless==4.9.0.80  # rembg dependency
+Pillow==10.0.1           # rembg dependency
+PyMatting==1.1.12        # rembg dependency
+scikit-image==0.22.0     # rembg dependency
+imageio==2.34.0          # scikit-image dependency
+lazy_loader==0.3         # scikit-image dependency
+tifffile==2024.2.12      # scikit-image dependency
+pooch==1.8.1             # scikit-image dependency
+
+# Scientific computing (rembg/scikit-image dependencies)
+numpy==1.26.4
+scipy==1.12.0
+numba==0.59.1
+llvmlite==0.42.0         # numba dependency
+networkx==3.2.1          # scikit-image dependency
+
+# Protobuf / ONNX model support
+protobuf==5.26.1         # onnxruntime dependency
+flatbuffers==24.3.25     # onnxruntime dependency
+sympy==1.12              # onnxruntime dependency
+mpmath==1.3.0            # sympy dependency
+
+# ------------------------------------------
+# Data & Statistics
+# ------------------------------------------
+
+# Data handling (casino/stats.py)
+pandas==2.1.1
+python-dateutil==2.8.2   # pandas dependency
+pytz==2023.3.post1       # pandas dependency
+tzdata==2023.3           # pandas dependency
+six==1.16.0              # python-dateutil dependency
+
+# ------------------------------------------
+# Configuration & Validation
+# ------------------------------------------
+
+jsonschema==4.21.1
+jsonschema-specifications==2023.12.1  # jsonschema dependency
+attrs==23.2.0            # jsonschema dependency
+referencing==0.34.0      # jsonschema dependency
+rpds-py==0.18.0          # jsonschema dependency
+
+# ------------------------------------------
+# HTTP & Networking
+# ------------------------------------------
+
+requests==2.31.0
+certifi==2024.2.2        # requests dependency
+charset-normalizer==3.3.2  # requests dependency
+idna==3.6                # requests dependency
+urllib3==2.2.1           # requests dependency
+
+# ------------------------------------------
+# Miscellaneous
+# ------------------------------------------
+
+packaging==24.0
+platformdirs==4.2.0
+tqdm==4.66.2             # Progress bars