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**
@@ -106,7 +106,7 @@ Follow these steps to set up your local development environment. For more compre
 
     ```bash
     # Use --dev or rely on the default development mode
-    poetry run tux --dev db push
+    uv run tux --dev db push
     ```
 
 ## 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/setup-python/action.yml

@@ -1,66 +1,48 @@
 name: Setup Python Environment
-description: Set up Python with Poetry, dependencies, and optional Prisma client generation
+description: Set up Python with Uv, dependencies, and optional Prisma client generation
 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
+    default: 0.8.8
+  enable-cache:
+    description: Enable uv cache persistence
     required: false
-    default: default
+    default: 'true'
   generate-prisma:
     description: Whether to generate Prisma client
     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
       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
+      run: uv sync --frozen
 
     # 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 run prisma generate

.github/workflows/ci.yml

@@ -89,7 +89,7 @@ jobs:
           files: |
             **/*.py
             pyproject.toml
-            poetry.lock
+            uv.lock
 
       # EARLY TERMINATION FOR UNCHANGED FILES
       # Skips expensive Python setup if no relevant files changed
@@ -110,15 +110,14 @@ jobs:
         uses: ./.github/actions/setup-python
         with:
           python-version: '3.13'
-          install-groups: dev,types
-          cache-suffix: ci
           generate-prisma: 'true'
+          enable-cache: 'true'
 
       # STATIC TYPE CHECKING
       # basedpyright provides comprehensive type checking for Python
       # Annotations appear directly in PR for developer feedback
       - name: Run basedpyright type checker
-        run: poetry run basedpyright
+        run: uv run basedpyright
 
   # ============================================================================
   # MARKDOWN DOCUMENTATION LINTING

.github/workflows/maintenance.yml

@@ -126,7 +126,7 @@ jobs:
           ESCAPE: true                   # Handle special characters safely
           # EXCLUSION PATTERNS
           # Skip maintenance-heavy directories and lock files
-          IGNORE: .github/,node_modules/,dist/,build/,vendor/,poetry.lock
+          IGNORE: .github/,node_modules/,dist/,build/,vendor/,uv.lock
           PROJECTS_SECRET: ${{ secrets.ADMIN_PAT }}
         env:
           # MANUAL OVERRIDE SUPPORT
@@ -201,9 +201,9 @@ jobs:
       # Monitors for outdated dependencies requiring security or feature updates
       - name: Check for outdated dependencies
         run: |
-          if command -v poetry &> /dev/null; then
+          if command -v uv &> /dev/null; then
             echo "Checking for outdated dependencies..."
-            poetry show --outdated || echo "All dependencies up to date"
+            uv pip list --outdated || echo "All dependencies up to date"
           fi
 
       # PROJECT METRICS COLLECTION

.github/workflows/security.yml

@@ -176,18 +176,15 @@ jobs:
         uses: ./.github/actions/setup-python
         with:
           python-version: '3.13'
-          install-groups: main
-          cache-suffix: security
           generate-prisma: 'false'
+          enable-cache: 'true'
 
       # SECURITY VULNERABILITY SCANNING
       # Comprehensive security advisory checking with structured output
       - name: Run Safety check
         run: |
           pip install safety
-          # Ensure Poetry export plugin is available
-          poetry self add poetry-plugin-export
-          poetry export --without=dev --format=requirements.txt --output=requirements.txt
+          uv export --format requirements.txt --output-file requirements.txt
           safety check --json --output safety-report.json -r requirements.txt || true
 
       # SECURITY REPORT ARCHIVAL

.github/workflows/tests.yml

@@ -99,7 +99,7 @@ jobs:
           files: |
             **/*.py
             pyproject.toml
-            poetry.lock
+            uv.lock
             tests/**
             conftest.py
 
@@ -122,9 +122,8 @@ jobs:
         uses: ./.github/actions/setup-python
         with:
           python-version: ${{ matrix.python-version }}
-          install-groups: dev,test,types
-          cache-suffix: test
           generate-prisma: 'true'
+          enable-cache: 'true'
 
       # TEST ENVIRONMENT CONFIGURATION
       # Creates isolated test environment with SQLite for CI safety
@@ -154,13 +153,13 @@ jobs:
           # ADAPTIVE PARALLEL EXECUTION
           # Uses pytest-xdist for parallel execution when beneficial
           # Threshold of 10 tests balances overhead vs performance gain
-          TEST_COUNT=$(poetry run pytest --collect-only -q tests/ -m "not slow and not docker" 2>/dev/null | grep -c "test session starts" || echo "0")
+          TEST_COUNT=$(uv run pytest --collect-only -q tests/ -m "not slow and not docker" 2>/dev/null | grep -c "test session starts" || echo "0")
           if [ "$TEST_COUNT" -gt 10 ]; then
             echo "Running $TEST_COUNT tests in parallel..."
-            poetry run pytest tests/ -v --cov=tux --cov-branch --cov-report=xml:coverage-unit.xml --cov-report=term-missing -m "not slow and not docker" --junitxml=junit-unit.xml -o junit_family=legacy --cov-fail-under=0 -n auto
+            uv run pytest tests/ -v --cov=tux --cov-branch --cov-report=xml:coverage-unit.xml --cov-report=term-missing -m "not slow and not docker" --junitxml=junit-unit.xml -o junit_family=legacy --cov-fail-under=0 -n auto
           else
             echo "Running $TEST_COUNT tests sequentially..."
-            poetry run pytest tests/ -v --cov=tux --cov-branch --cov-report=xml:coverage-unit.xml --cov-report=term-missing -m "not slow and not docker" --junitxml=junit-unit.xml -o junit_family=legacy --cov-fail-under=0
+            uv run pytest tests/ -v --cov=tux --cov-branch --cov-report=xml:coverage-unit.xml --cov-report=term-missing -m "not slow and not docker" --junitxml=junit-unit.xml -o junit_family=legacy --cov-fail-under=0
           fi
           echo "Unit test coverage generation completed"
 
@@ -224,7 +223,7 @@ jobs:
       # Targets only database directory for precise scope
       - name: Run database tests with coverage
         if: steps.check_db_tests.outputs.has_tests == 'true'
-        run: poetry run pytest tests/tux/database/ -v --cov=tux/database --cov-branch
+        run: uv run pytest tests/tux/database/ -v --cov=tux/database --cov-branch
           --cov-report=xml:coverage-database.xml --junitxml=junit-database.xml -o
           junit_family=legacy --cov-fail-under=0
 
@@ -259,7 +258,7 @@ jobs:
           == 'workflow_dispatch'
         id: check_integration_tests
         run: |
-          if poetry run pytest --collect-only -m "slow" -q tests/ | grep -q "test session starts"; then
+          if uv run pytest --collect-only -m "slow" -q tests/ | grep -q "test session starts"; then
             echo "has_tests=true" >> "$GITHUB_OUTPUT"
             echo "Integration tests found"
           else
@@ -283,7 +282,7 @@ jobs:
       # Provides realistic end-to-end testing without blocking development
       - name: Run integration tests with coverage
         if: steps.check_integration_tests.outputs.has_tests == 'true'
-        run: poetry run pytest tests/ -v --cov=tux --cov-branch --cov-report=xml:coverage-integration.xml
+        run: uv run pytest tests/ -v --cov=tux --cov-branch --cov-report=xml:coverage-integration.xml
           -m "slow" --junitxml=junit-integration.xml -o junit_family=legacy --cov-fail-under=0
         continue-on-error: true  # Don't fail CI if integration tests fail
 

.gitignore

@@ -87,8 +87,8 @@ ipython_config.py
 # Pipenv
 Pipfile.lock
 
-# Poetry
-poetry.lock
+# uv
+uv.lock
 
 # Pdm
 .pdm.toml
@@ -181,3 +181,6 @@ prisma_binaries/
 .archive/
 
 reports/
+
+.kiro
+.audit

.markdownlintignore

@@ -29,3 +29,7 @@ prisma/
 typings/
 
 .github/
+
+.kiro/
+
+.audit/

.pre-commit-config.yaml

@@ -68,7 +68,7 @@ repos:
         additional_dependencies:
           - '@commitlint/cli'
           - '@commitlint/config-conventional'
-exclude: ^(\.archive/|.*typings/|node_modules/|\.venv/).*$
+exclude: ^(\.archive/|.*typings/|node_modules/|\.venv/|\.kiro/).*$
 ci:
   autofix_commit_msg: 'style: auto fixes from pre-commit hooks'
   autoupdate_commit_msg: 'chore: update pre-commit hook versions'