v0.1.0rc5

.codecov.yml

@@ -117,14 +117,14 @@ coverage:
       # BOT COMMANDS AND FEATURES (High standards - 75% target)
       # User-facing commands and Discord integrations
       # High standards because these directly impact user experience
-      cogs:
+      modules:
         target: 75%
         threshold: 2%
         informational: true  # Don't block PRs while building up test suite
         flags:
           - unit
         paths:
-          - tux/cogs/**/*  # All command cogs and Discord slash commands
+          - tux/modules/**/*  # All command modules and Discord slash commands
         only_pulls: true
 
       # UTILITIES AND HELPERS (Moderate standards - 70% target)
@@ -366,10 +366,10 @@ component_management:
     # User-facing Discord commands and integrations
         - unit
         - database
-    - component_id: cogs
+    - component_id: modules
       name: Bot Commands & Features
       paths:
-        - tux/cogs/**/*  # All command cogs organized by category
+        - tux/modules/**/*  # All command modules organized by category
       flag_regexes:
         - unit
 

.editorconfig

@@ -65,7 +65,7 @@ indent_size = 4
 indent_size = 4
 
 # Lock files (read-only, preserve formatting)
-[{poetry.lock,package-lock.json,yarn.lock,Pipfile.lock}]
+[{uv.lock,package-lock.json,yarn.lock,Pipfile.lock}]
 insert_final_newline = false
 trim_trailing_whitespace = false
 

.gitattributes

@@ -70,10 +70,10 @@ docker-compose*.yml text eol=lf
 #
 # Lock Files (binary-like treatment)
 #
-poetry.lock text eol=lf linguist-generated=true
 package-lock.json text eol=lf linguist-generated=true
 yarn.lock text eol=lf linguist-generated=true
 Pipfile.lock text eol=lf linguist-generated=true
+uv.lock text eol=lf linguist-generated=true
 
 #
 # Binary Files

.github/CONTRIBUTING.md

@@ -13,15 +13,15 @@ Before you start, ensure you have:
 * [Python](https://www.python.org/) (3.13+ recommended)
   * If you don't have Python installed, we suggest using something like [mise](https://mise.jdx.dev/) or [pyenv](https://github.com/pyenv/pyenv) to manage your Python installations.
 
-* [Poetry](https://python-poetry.org/docs/) (1.2+ recommended)
-  * If you don't have Poetry installed, you can use one of the official methods. We recommend using the official installer:
+* [Uv](https://docs.astral.sh/uv/) (recommended)
+  * If you don't have Uv installed, use the official installer and verify:
 
     ```bash
-    # Linux, macOS, Windows (WSL)
-    curl -sSL https://install.python-poetry.org | python3 -
+    # Linux/macOS
+    curl -LsSf https://astral.sh/uv/install.sh | sh
 
-    # After installation and ensuring Poetry is in your PATH, you can verify it by running:
-    poetry --version
+    # Verify installation
+    uv --version
     ```
 
 * A PostgreSQL Database (local or remote)
@@ -61,19 +61,19 @@ Follow these steps to set up your local development environment. For more compre
     git remote -v
     ```
 
-2. **Install Dependencies with Poetry**
+2. **Install Dependencies with Uv**
 
-    Ensure Poetry is installed and configured to use the correct Python version (e.g., 3.13.5).
+    Ensure Uv is installed and using the correct Python version (project requires 3.13.x).
 
     ```bash
-    # Create a virtual environment
-    poetry env use 3.13.5
+    # (Optional) Pin the Python version used by uv
+    uv python pin 3.13.5
 
-    # Install project dependencies and dev tools
-    poetry install
+    # Create the virtual environment and install all dependencies
+    uv sync
 
     # Install pre-commit hooks for quality checks
-    poetry run pre-commit install
+    uv run pre-commit install
     ```
 
 3. **Configure Environment Variables**
@@ -102,11 +102,11 @@ Follow these steps to set up your local development environment. For more compre
 
 5. **Initialize Development Database**
 
-    Push the Prisma schema to your development database. This also generates the Prisma client.
+    Run database migrations to set up your development database.
 
     ```bash
     # Use --dev or rely on the default development mode
-    poetry run tux --dev db push
+    uv run tux --dev db upgrade
     ```
 
 ## Development Workflow
@@ -164,16 +164,16 @@ Follow these steps to set up your local development environment. For more compre
 
     ```bash
     # Format code using Ruff
-    poetry run tux dev format
+    uv run tux dev format
 
     # Lint code using Ruff
-    poetry run tux dev lint-fix
+    uv run tux dev lint-fix
 
-    # Type-check code using basedpyright
-    poetry run tux dev type-check
+    # Type-check code using Pyright
+    uv run tux dev type-check
 
     # Run all pre-commit checks (includes formatting, linting, etc.)
-    poetry run tux dev pre-commit
+    uv run tux dev pre-commit
     ```
 
     Fix any issues reported by these tools.

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

@@ -0,0 +1,55 @@
+name: action-basedpyright
+description: Run basedpyright with reviewdog on pull requests to improve code review
+  experience
+inputs:
+  github_token:
+    description: GITHUB_TOKEN
+    default: ${{ github.token }}
+  workdir:
+    description: Working directory relative to the root directory.
+    default: .
+  ### Flags for reviewdog ###
+  tool_name:
+    description: Tool name to use for reviewdog reporter.
+    default: basedpyright
+  level:
+    description: Report level for reviewdog [info,warning,error].
+    default: warning
+  reporter:
+    description: Reporter of reviewdog command [github-check,github-pr-review,github-pr-check,sarif].
+    default: github-pr-review
+  filter_mode:
+    description: |
+      Filtering mode for the reviewdog command [added,diff_context,file,nofilter].
+      Default is `added` except that sarif reporter uses `nofilter`.
+    default: file
+  fail_level:
+    description: |
+      If set to `none`, always use exit code 0 for reviewdog. Otherwise, exit code 1 for reviewdog if it finds at least 1 issue with severity greater than or equal to the given level.
+      Possible values: [none,any,info,warning,error]
+      Default is `none`.
+    default: none
+  reviewdog_flags:
+    description: Additional reviewdog flags.
+    default: ''
+  ### Flags for basedpyright ###
+  basedpyright_flags:
+    description: Additional flags for basedpyright command.
+    default: --outputjson
+runs:
+  using: composite
+  steps:
+    - name: Run basedpyright with reviewdog
+      shell: bash
+      working-directory: ${{ inputs.workdir }}
+      run: |
+        uv run basedpyright ${{ inputs.basedpyright_flags }} | \
+        reviewdog -f=rdjson \
+          -reporter=${{ inputs.reporter }} \
+          -level=${{ inputs.level }} \
+          -filter-mode=${{ inputs.filter_mode }} \
+          -fail-level=${{ inputs.fail_level }} \
+          -name=${{ inputs.tool_name }} \
+          ${{ inputs.reviewdog_flags }}
+      env:
+        REVIEWDOG_GITHUB_API_TOKEN: ${{ inputs.github_token }}

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

@@ -1,66 +1,37 @@
 name: Setup Python Environment
-description: Set up Python with Poetry, dependencies, and optional Prisma client generation
+description: Set up Python with Uv and dependencies
 inputs:
   python-version:
     description: Python version to use
     required: false
     default: '3.13'
-  install-groups:
-    description: Poetry groups to install (comma-separated)
+  uv-version:
+    description: Uv version to install (e.g. 0.8.8)
     required: false
-    default: dev,types
-  cache-suffix:
-    description: Cache key suffix for differentiation
-    required: false
-    default: default
-  generate-prisma:
-    description: Whether to generate Prisma client
+    default: 0.8.8
+  enable-cache:
+    description: Enable uv cache persistence
     required: false
     default: 'true'
 runs:
   using: composite
   steps:
-    # POETRY INSTALLATION
-    # Uses pipx for isolated Poetry installation without conflicts
-    - name: Install Poetry
-      shell: bash
-      run: pipx install poetry
-
-    # PYTHON ENVIRONMENT SETUP
-    # Configures Python with integrated Poetry cache support
+    # PYTHON ENVIRONMENT SETUP (use GitHub's cached Python)
     - name: Set up Python
-      uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ inputs.python-version }}
-        cache: poetry
 
-    # ADVANCED DEPENDENCY CACHING
-    # Multi-level caching strategy for maximum cache hit rate
-    - name: Cache Poetry dependencies
-      uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4
+    # UV INSTALLATION
+    # Installs uv and optionally enables cache persistence
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
       with:
-        path: |
-          ~/.cache/pypoetry
-          ~/.cache/pip
-        key: poetry-${{ inputs.cache-suffix }}-${{ runner.os }}-${{ hashFiles('poetry.lock')
-          }}
-        restore-keys: |
-          poetry-${{ inputs.cache-suffix }}-${{ runner.os }}-
+        version: ${{ inputs.uv-version }}
+        enable-cache: ${{ inputs.enable-cache }}
 
     # DEPENDENCY INSTALLATION
-    # Installs specified Poetry groups with CI-optimized settings
+    # Install project with locked dependencies
     - name: Install dependencies
       shell: bash
-      run: |
-        if [[ "${{ inputs.install-groups }}" == "main" ]]; then
-          poetry install --only=main --no-interaction --no-ansi
-        else
-          poetry install --with=${{ inputs.install-groups }} --no-interaction --no-ansi
-        fi
-
-    # CONDITIONAL PRISMA CLIENT GENERATION
-    # Generates Prisma database client when needed for database operations
-    - name: Generate Prisma client
-      if: ${{ inputs.generate-prisma == 'true' }}
-      shell: bash
-      run: poetry run prisma generate
+      run: uv sync --frozen