feat(docker): Comprehensive Docker Setup Enhancement with Performance & Security Improvements

.cursor/rules/cli_usage.mdc

@@ -1,5 +1,5 @@
 ---
-description: 
+description:
 globs: tux/cli/**,README.md,DEVELOPER.md,pyproject.toml,docs/**
 alwaysApply: false
 ---
@@ -40,5 +40,12 @@ See [tux/utils/env.py](mdc:tux/utils/env.py) for environment logic.
   - `down`: Stops Docker services.
   - `logs`: Shows container logs.
   - `exec`: Executes a command inside a running container.
+  - `shell`: Opens an interactive shell in the container.
+  - `ps`: Shows running containers.
+  - `restart`: Restarts Docker services.
+  - `health`: Shows health status of containers.
+  - `cleanup`: Cleans up Tux-related Docker resources.
+  - `config`: Validates and displays Docker Compose configuration.
+  - `pull`: Pulls latest images from registry.
 
 Refer to [DEVELOPER.md](mdc:DEVELOPER.md) for detailed examples and explanations.

.cursor/rules/core.mdc

@@ -1,6 +1,6 @@
 ---
-description: 
-globs: 
+description:
+globs:
 alwaysApply: false
 ---
 # Core Functionality
@@ -15,4 +15,4 @@ This rule describes the core components and processes of the Tux bot.
 - **Configuration (`tux/utils/config.py` & `tux/utils/env.py`)**: Configuration is managed through environment variables (loaded via `tux/utils/env.py`, likely using `.env` files) and a primary settings file (`config/settings.yml`) loaded and accessed via `tux/utils/config.py`. [tux/utils/config.py](mdc:tux/utils/config.py), [tux/utils/env.py](mdc:tux/utils/env.py), [config/settings.yml](mdc:config/settings.yml)
 - **Error Handling (`tux/handlers/error.py`)**: Contains centralized logic for handling errors that occur during command execution or other bot operations. It remaps the tree for app command errors, defines `on_command_error` listeners and formats error messages for users and logging. [tux/handlers/error.py](mdc:tux/handlers/error.py)
 - **Custom Help Command (`tux/help.py`)**: Implements a custom help command, overriding the default `discord.py` help behavior to provide a tailored user experience for discovering commands and features. [tux/help.py](mdc:tux/help.py)
-- **Utilities (`tux/utils/`)**: A collection of helper modules providing various utility functions used across the codebase (e.g., logging setup, embed creation, time formatting, constants). [tux/utils/](mdc:tux/utils)
+- **Utilities (`tux/utils/`)**: A collection of helper modules providing various utility functions used across the codebase (e.g., logging setup, embed creation, time formatting, constants). [tux/utils/](mdc:tux/utils)

.cursor/rules/database_patterns.mdc

@@ -1,5 +1,5 @@
 ---
-description: 
+description:
 globs: tux/database/**,prisma/**,tux/cli/database.py
 alwaysApply: false
 ---

.cursor/rules/development_setup.mdc

@@ -1,5 +1,5 @@
 ---
-description: 
+description:
 globs: tux/cli/**,README.md,DEVELOPER.md,docs/**,pyproject.toml,.env
 alwaysApply: false
 ---

.cursor/rules/docker_environment.mdc

@@ -1,5 +1,5 @@
 ---
-description: 
+description:
 globs: docker-compose.yml,docker-compose.dev.yml,Dockerfile,README.md,.github/workflows/docker-image.yml,tux/cli/docker.py,.dockerignore
 alwaysApply: false
 ---
@@ -34,7 +34,7 @@ Commands are run using the `tux` CLI's `docker` group (ensure you are in develop
     ```
     - Uses `docker-compose.dev.yml`.
     - Mounts the codebase using `develop: watch:` for live code syncing (replaces Python hot-reloading).
-    - Runs `python -m tux --dev bot start` inside the `app` container.
+    - Runs `python -m tux --dev bot start` inside the `tux` container.
 
 3.  **Stop Services:**
     ```bash
@@ -43,21 +43,21 @@ Commands are run using the `tux` CLI's `docker` group (ensure you are in develop
 
 ## Interacting with Containers
 
-Use `poetry run tux --dev docker exec app <command>` to run commands inside the `app` container.
+Use `poetry run tux --dev docker exec tux <command>` to run commands inside the `tux` container.
 
 - **Logs:** `poetry run tux --dev docker logs -f`
-- **Shell:** `poetry run tux --dev docker exec app bash`
+- **Shell:** `poetry run tux --dev docker exec tux bash`
 - **Database Commands:** Must be run *inside* the container.
   ```bash
   # Example: Push schema
-  poetry run tux --dev docker exec app poetry run tux --dev db push
+  poetry run tux --dev docker exec tux poetry run tux --dev db push
   # Example: Create migration
-  poetry run tux --dev docker exec app poetry run tux --dev db migrate --name <name>
+  poetry run tux --dev docker exec tux poetry run tux --dev db migrate --name <name>
   ```
 - **Linting/Formatting/Type Checking:** Must be run *inside* the container.
   ```bash
-  poetry run tux --dev docker exec app poetry run tux dev lint
-  poetry run tux --dev docker exec app poetry run tux dev format
+  poetry run tux --dev docker exec tux poetry run tux dev lint
+  poetry run tux --dev docker exec tux poetry run tux dev format
   # etc.
   ```
 

.cursor/rules/extensions_system.mdc

@@ -1,6 +1,6 @@
 ---
-description: 
-globs: 
+description:
+globs:
 alwaysApply: false
 ---
 # Extensions System

.cursor/rules/project_structure.mdc

@@ -1,6 +1,6 @@
 ---
-description: 
-globs: 
+description:
+globs:
 alwaysApply: false
 ---
 # Tux Project Structure

.devcontainer/devcontainer.json

@@ -2,14 +2,8 @@
   "name": "Tux Development Container",
   "dockerFile": "../Dockerfile",
   "context": "..",
-  "runArgs": [
-    "--init",
-    "--env-file",
-    ".env"
-  ],
-  "forwardPorts": [
-    3000
-  ],
+  "runArgs": ["--init", "--env-file", ".env"],
+  "forwardPorts": [3000],
   "build": {
     "target": "dev",
     "args": {

.dockerignore

@@ -1,10 +1,57 @@
-.env
+# Environment files
+.env*
+!.env.example
+
+# Python virtual environment and caches
 .venv/
-.cache/
 __pycache__/
-*.pyc
-assets/
+*.py[cod]
+*$py.class
+.pytest_cache/
+.coverage
+.mypy_cache/
+.ruff_cache/
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# IDE/Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Documentation and development files
 docs-build/
 site/
+*.md
+!README.md
+!LICENSE.md
+!requirements.md
+
+# Development configuration
 .cursorrules
 .editorconfig
+.pre-commit-config.yaml
+
+# Logs
+*.log
+logs/
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# Docker files (prevent recursive inclusion)
+Dockerfile*
+docker-compose*.yml
+.dockerignore
+
+# Cache directories
+.cache/

.editorconfig

@@ -0,0 +1,89 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Default settings for all files
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+# Python files
+[*.py]
+indent_size = 4
+max_line_length = 120
+
+# Python stub files
+[*.pyi]
+indent_size = 4
+max_line_length = 120
+
+# Configuration files (YAML, TOML, JSON)
+[*.{yaml,yml}]
+indent_size = 2
+
+[*.toml]
+indent_size = 4
+
+[*.json]
+indent_size = 2
+
+# Docker files
+[{Dockerfile,*.dockerfile}]
+indent_size = 4
+
+[docker-compose*.yml]
+indent_size = 2
+
+# Shell scripts
+[*.{sh,bash,zsh,fish}]
+indent_size = 2
+
+# Nix files
+[*.nix]
+indent_size = 2
+
+# Web files (if any)
+[*.{html,css,js,ts,jsx,tsx}]
+indent_size = 2
+
+# Markdown files
+[*.md]
+indent_size = 2
+trim_trailing_whitespace = false
+
+# Environment files
+[.env*]
+indent_size = 4
+
+# Git files
+[.git*]
+indent_size = 4
+
+# Lock files (read-only, preserve formatting)
+[{poetry.lock,package-lock.json,yarn.lock,Pipfile.lock}]
+insert_final_newline = false
+trim_trailing_whitespace = false
+
+# Makefile (requires tabs)
+[{Makefile,makefile,*.mk}]
+indent_style = tab
+indent_size = 4
+
+# Batch files (Windows)
+[*.{bat,cmd}]
+end_of_line = crlf
+
+# Archive directory (preserve original formatting)
+[.archive/**]
+insert_final_newline = false
+trim_trailing_whitespace = false
+
+# Generated/cache directories (ignore)
+[{__pycache__,*.pyc,.mypy_cache,.pytest_cache,.ruff_cache,node_modules}/**]
+insert_final_newline = false
+trim_trailing_whitespace = false