chore(config): standardize YAML configurations and improve readability

- Added YAML document start indicators to various configuration files for consistency.
- Updated list formatting in `.pre-commit-config.yaml`, `.docker-compose.yml`, and other YAML files to use inline array syntax for improved clarity.
- Enhanced the `.codecov.yml` and `.markdownlint.yaml` files by consolidating ignore patterns and default settings.
- Refined the GitHub Actions workflow files to streamline job dependencies and trigger conditions.
- Improved organization and readability across multiple configuration files, ensuring a more maintainable codebase.

Author: kzndotsh

.codecov.yml

@@ -1,3 +1,4 @@
+---
 # ==============================================================================
 # TUX DISCORD BOT - CODECOV CONFIGURATION
 # ==============================================================================
@@ -90,8 +91,7 @@ coverage:
         target: 80%
         threshold: 2%  # Stricter threshold for critical code
         informational: true  # Don't block PRs while building up test suite
-        flags:         # Covered by main unit test suite
-          - unit
+        flags: [unit]  # Covered by main unit test suite
         paths:
           - tux/bot.py  # Main bot class and Discord client setup
           - tux/cog_loader.py  # Extension loading and management
@@ -107,9 +107,7 @@ coverage:
         target: 90%
         threshold: 1%  # Very strict threshold for data operations
         informational: true  # Don't block PRs while building up test suite
-        flags:                   # Covered by both unit and database-specific tests
-          - unit
-          - database
+        flags: [unit, database]  # Covered by both unit and database-specific tests
         paths:
           - tux/database/**/*  # All database controllers, models, and utilities
         only_pulls: true
@@ -121,8 +119,7 @@ coverage:
         target: 75%
         threshold: 2%
         informational: true  # Don't block PRs while building up test suite
-        flags:
-          - unit
+        flags: [unit]
         paths:
           - tux/modules/**/*  # All command modules and Discord slash commands
         only_pulls: true
@@ -134,8 +131,7 @@ coverage:
         target: 70%
         threshold: 3%  # More lenient for utility functions
         informational: true  # Don't block PRs while building up test suite
-        flags:
-          - unit
+        flags: [unit]
         paths:
           - tux/utils/**/*  # Configuration, helpers, constants, etc.
         only_pulls: true
@@ -147,8 +143,7 @@ coverage:
         target: 65%
         threshold: 3%
         informational: true  # Don't block PRs while building up test suite
-        flags:
-          - unit
+        flags: [unit]
         paths:
           - tux/cli/**/*  # Development and management CLI tools
         only_pulls: true
@@ -160,8 +155,7 @@ coverage:
         target: 80%
         threshold: 2%
         informational: true  # Don't block PRs while building up test suite
-        flags:
-          - unit
+        flags: [unit]
         paths:
           - tux/handlers/**/*  # Error handlers, event processors, activity handlers
         only_pulls: true
@@ -173,8 +167,7 @@ coverage:
         target: 70%
         threshold: 3%
         informational: true  # Don't block PRs while building up test suite
-        flags:
-          - unit
+        flags: [unit]
         paths:
           - tux/ui/**/*  # Discord embeds, buttons, modals, views
         only_pulls: true
@@ -186,8 +179,7 @@ coverage:
         target: 60%
         threshold: 4%  # Most lenient threshold due to external dependencies
         informational: true  # Don't block PRs while building up test suite
-        flags:
-          - unit
+        flags: [unit]
         paths:
           - tux/wrappers/**/*  # GitHub, XKCD, Godbolt, and other API wrappers
         only_pulls: true
@@ -216,8 +208,7 @@ coverage:
         target: 95%
         threshold: 2%  # Very strict for new database operations
         informational: true  # Don't block PRs while building up test suite
-        flags:
-          - database
+        flags: [database]
         paths:
           - tux/database/**/*
 
@@ -227,8 +218,7 @@ coverage:
         target: 90%
         threshold: 3%
         informational: true  # Don't block PRs while building up test suite
-        flags:
-          - unit
+        flags: [unit]
         paths:
           - tux/bot.py
           - tux/cog_loader.py
@@ -240,8 +230,7 @@ coverage:
         target: 90%
         threshold: 3%
         informational: true  # Don't block PRs while building up test suite
-        flags:
-          - unit
+        flags: [unit]
         paths:
           - tux/handlers/**/*
 # ==============================================================================
@@ -331,8 +320,7 @@ component_management:
   # DEFAULT COMPONENT RULES
   # Applied to all components unless overridden
   default_rules:
-    flag_regexes:         # Most components covered by unit tests
-      - unit
+    flag_regexes: [unit]  # Most components covered by unit tests
     statuses:
       - type: project
         target: auto  # Progressive improvement for all components
@@ -360,12 +348,10 @@ component_management:
       name: Database Layer
       paths:
         - tux/database/**/*  # Controllers, models, client, and utilities
-      flag_regexes:                   # Covered by both unit and DB-specific tests
+      flag_regexes: [unit, database]  # Covered by both unit and DB-specific tests
 
     # BOT COMMANDS AND FEATURES COMPONENT
     # User-facing Discord commands and integrations
-        - unit
-        - database
     - component_id: modules
       name: Bot Commands & Features
       paths:
@@ -439,22 +425,19 @@ flag_management:
     # UNIT TESTS FLAG
     # Main test suite covering individual functions and classes
     - name: unit
-      paths:         # Covers all application code
-        - tux/
+      paths: [tux/]  # Covers all application code
       carryforward: true
 
     # DATABASE TESTS FLAG
     # Specific tests for database operations and data integrity
     - name: database
-      paths:                      # Only covers database-related code
-        - tux/database/**/*
+      paths: [tux/database/**/*]  # Only covers database-related code
       carryforward: true
 
     # INTEGRATION TESTS FLAG
     # End-to-end tests covering full user workflows
     - name: integration
-      paths:         # Covers all application code in integrated scenarios
-        - tux/
+      paths: [tux/]  # Covers all application code in integrated scenarios
       carryforward: true
 # ==============================================================================
 # ADVANCED CODECOV SETTINGS

.github/actions/action-basedpyright/action.yml

@@ -1,3 +1,4 @@
+---
 name: action-basedpyright
 description: Run basedpyright with reviewdog on pull requests to improve code review
   experience
@@ -8,7 +9,7 @@ inputs:
   workdir:
     description: Working directory relative to the root directory.
     default: .
-  ### Flags for reviewdog ###
+  ### Flags for reviewdog  ###
   tool_name:
     description: Tool name to use for reviewdog reporter.
     default: basedpyright
@@ -32,7 +33,7 @@ inputs:
   reviewdog_flags:
     description: Additional reviewdog flags.
     default: ''
-  ### Flags for basedpyright ###
+  ### Flags for basedpyright  ###
   basedpyright_flags:
     description: Additional flags for basedpyright command.
     default: --outputjson

.github/actions/create-test-env/action.yml

@@ -1,3 +1,4 @@
+---
 name: Create Test Environment
 description: Create .env file with test configuration for CI/testing purposes
 inputs:

.github/actions/setup-python/action.yml

@@ -1,3 +1,4 @@
+---
 name: Setup Python Environment
 description: Set up Python with Uv and dependencies
 inputs:

.github/workflows/ci.yml

@@ -1,11 +1,10 @@
+---
 name: CI
 on:
   push:
-    branches:
-      - main
+    branches: [main]
   pull_request:
-    branches:
-      - main
+    branches: [main]
   workflow_dispatch:
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -106,8 +105,7 @@ jobs:
   quality:
     name: Python
     runs-on: ubuntu-latest
-    needs:
-      - changes
+    needs: [changes]
     if: needs.changes.outputs.python == 'true' || github.event_name == 'workflow_dispatch'
     permissions:
       contents: read
@@ -150,8 +148,7 @@ jobs:
   markdown:
     name: Markdown
     runs-on: ubuntu-latest
-    needs:
-      - changes
+    needs: [changes]
     if: needs.changes.outputs.markdown == 'true'
     permissions:
       contents: read
@@ -170,8 +167,7 @@ jobs:
   shell:
     name: Shell
     runs-on: ubuntu-latest
-    needs:
-      - changes
+    needs: [changes]
     if: needs.changes.outputs.shell == 'true'
     permissions:
       contents: read
@@ -197,8 +193,7 @@ jobs:
   workflows:
     name: Workflows
     runs-on: ubuntu-latest
-    needs:
-      - changes
+    needs: [changes]
     if: needs.changes.outputs.workflows == 'true'
     permissions:
       contents: read
@@ -217,8 +212,7 @@ jobs:
   docker:
     name: Docker
     runs-on: ubuntu-latest
-    needs:
-      - changes
+    needs: [changes]
     if: needs.changes.outputs.docker == 'true'
     permissions:
       contents: read
@@ -238,8 +232,7 @@ jobs:
   yaml:
     name: YAML
     runs-on: ubuntu-latest
-    needs:
-      - changes
+    needs: [changes]
     if: needs.changes.outputs.yaml == 'true'
     permissions:
       contents: read
@@ -258,8 +251,7 @@ jobs:
   security:
     name: Security
     runs-on: ubuntu-latest
-    needs:
-      - changes
+    needs: [changes]
     if: always()
     permissions:
       contents: read

.github/workflows/deploy.yml

@@ -1,17 +1,15 @@
+---
 name: Deploy
 on:
   release:
-    types:
-      - published
+    types: [published]
   workflow_dispatch:
     inputs:
       environment:
         description: Environment to deploy to
         required: true
         type: choice
-        options:
-          - staging
-          - production
+        options: [staging, production]
         default: staging
 concurrency:
   group: deploy-${{ github.event.inputs.environment || 'production' }}

.github/workflows/docker.yml

@@ -1,11 +1,10 @@
+---
 name: Docker
 on:
   push:
-    tags:
-      - v*
+    tags: [v*]
   pull_request:
-    branches:
-      - main
+    branches: [main]
   workflow_dispatch:
   schedule:
     - cron: 0 2 15 * *
@@ -97,8 +96,7 @@ jobs:
   build:
     name: Build & Push
     runs-on: ubuntu-latest
-    needs:
-      - validate
+    needs: [validate]
     if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
     permissions:
       contents: read

.github/workflows/maintenance.yml

@@ -1,8 +1,8 @@
+---
 name: Maintenance
 on:
   push:
-    branches:
-      - main
+    branches: [main]
   workflow_dispatch:
     inputs:
       cleanup_images:

.github/workflows/release.yml

@@ -1,8 +1,8 @@
+---
 name: Release
 on:
   push:
-    tags:
-      - v*
+    tags: [v*]
   workflow_dispatch:
     inputs:
       version:
@@ -58,9 +58,7 @@ jobs:
   create:
     name: Create Release
     runs-on: ubuntu-latest
-    needs:
-      - validate
-      - wait
+    needs: [validate, wait]
     steps:
       - name: Checkout
         uses: actions/checkout@v4

.github/workflows/security.yml

@@ -1,11 +1,10 @@
+---
 name: Security
 on:
   push:
-    branches:
-      - main
+    branches: [main]
   pull_request:
-    branches:
-      - main
+    branches: [main]
   schedule:
     - cron: 20 7 * * 1
 concurrency: