Clarify DOM XSS example in sentinel note

- Resolved the GitHub Actions CI deprecation warning by upgrading checkout/setup-python actions to support Node.js 24 (`v4.2.2` and `v5.4.0` respectively).
- Addressed the `pip-audit` failure (CVE-2026-4750) triggered by the malicious `fastar` dependency injection in `fastapi==0.136.3` by explicitly blocking that version (`fastapi[all]!=0.136.3`) in `requirements.txt`.

Co-authored-by: christianlouis <361235+christianlouis@users.noreply.github.com>

.github/workflows/ci.yml

@@ -27,9 +27,9 @@ jobs:
     name: Ruff Lint & Format
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v4.2.2
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v5.4.0
         with:
           python-version: "3.11"
           cache: 'pip'
@@ -48,9 +48,9 @@ jobs:
     name: Alembic Migration Chain Check
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v4.2.2
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v5.4.0
         with:
           python-version: "3.11"
       - name: Validate migration chain
@@ -60,9 +60,9 @@ jobs:
     name: HTML Accessibility Lint
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v4.2.2
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v5.4.0
         with:
           python-version: "3.11"
           cache: 'pip'
@@ -78,9 +78,9 @@ jobs:
     runs-on: ubuntu-latest
     needs: [lint]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v4.2.2
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v5.4.0
         with:
           python-version: "3.11"
           cache: 'pip'
@@ -93,9 +93,9 @@ jobs:
     runs-on: ubuntu-latest
     needs: [lint]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v4.2.2
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v5.4.0
         with:
           python-version: "3.11"
           cache: 'pip'
@@ -116,10 +116,10 @@ jobs:
         ports: ["5672:5672", "15672:15672"]
         options: --health-cmd "rabbitmq-diagnostics -q ping" --health-interval 10s --health-timeout 5s --health-retries 5
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v4.2.2
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v5.4.0
         with:
           python-version: "3.11"
           cache: 'pip'
@@ -154,7 +154,7 @@ jobs:
     if: github.event_name == 'push'
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v4.2.2
       - name: Generate Build Metadata
         run: |
           chmod +x scripts/generate_build_metadata.sh
@@ -212,7 +212,7 @@ jobs:
           echo "tag=main-${SHORT_SHA}" >> "$GITHUB_OUTPUT"
           echo "image=ghcr.io/${{ github.repository_owner }}/docuelevate:main-${SHORT_SHA}" >> "$GITHUB_OUTPUT"
       - name: Checkout k8s-cluster-state
-        uses: actions/checkout@v4
+        uses: actions/checkout@v4.2.2
         with:
           repository: christianlouis/k8s-cluster-state
           token: ${{ secrets.GH_PAT }}

.github/workflows/codeql.yml

@@ -35,7 +35,7 @@ jobs:
           build-mode: none
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v4.2.2
 
     - name: Initialize CodeQL
       uses: github/codeql-action/init@v4

.github/workflows/release.yml

@@ -23,13 +23,13 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v4.2.2
         with:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v5.4.0
         with:
           python-version: '3.11'
           cache: 'pip'

.github/workflows/ruff-auto-fix.yml

@@ -28,13 +28,13 @@ jobs:
 
     steps:
       - name: Checkout PR branch
-        uses: actions/checkout@v4
+        uses: actions/checkout@v4.2.2
         with:
           ref: ${{ github.head_ref }}
           token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v5.4.0
         with:
           python-version: "3.11"
 

.jules/sentinel.md

@@ -28,3 +28,7 @@
 **Vulnerability:** The `/process-url` endpoint used `httpx.AsyncClient(follow_redirects=True)` after validating the initial user-provided URL against SSRF protections. However, it did not validate the target URLs of any subsequent HTTP redirects, allowing an attacker to provide a safe URL that redirects to an internal/private IP, bypassing the security check.
 **Learning:** Initial URL validation is insufficient when the HTTP client is configured to follow redirects automatically. The client must be explicitly configured to validate every redirect target.
 **Prevention:** When using `httpx.AsyncClient(follow_redirects=True)` for user-provided URLs, always implement a redirect validator hook function (e.g., using `event_hooks={'response': [validate_redirect]}`) that resolves the `Location` header and passes it through the same SSRF validation logic before the redirect is followed.
+## 2026-05-27 - DOM-based XSS in upload.js
+**Vulnerability:** The `upload.js` frontend file directly injected the user-controlled `file.name` into a string literal passed to `row.innerHTML`. This allowed a malicious filename (e.g., `<img src=x onerror=alert(1)>`) to execute arbitrary JavaScript in the victim's browser context (DOM-based XSS).
+**Learning:** Even internal or local files uploaded by a user can contain malicious filenames. Any data dynamically interpolated into an HTML string that is subsequently rendered via `innerHTML` must be strictly sanitized.
+**Prevention:** Implement and apply an HTML escaping function (e.g., `_escapeHtml`) to replace dangerous characters (`&`, `<`, `>`, `"`, `'`) with their corresponding HTML entities before injecting user-controlled data into the DOM.

frontend/static/js/upload.js

@@ -293,13 +293,25 @@ function processFiles(files, progressContainer, statusMessage) {
     updateStatus();
   }
 
+  function _escapeHtml(unsafe) {
+    if (!unsafe) return '';
+    return String(unsafe)
+      .replace(/&/g, "&")
+      .replace(/</g, "&lt;")
+      .replace(/>/g, "&gt;")
+      .replace(/"/g, "&quot;")
+      .replace(/'/g, "&#039;");
+  }
+
   // Pre-create one progress row per file.
   const queueItems = fileArray.map((file) => {
     const row = document.createElement('div');
     row.className = 'flex flex-col mb-2';
+    const safeFileName = _escapeHtml(file.name);
+
     row.innerHTML = `
       <div class="flex justify-between">
-        <span class="text-sm truncate" title="${file.name}">${file.name}</span>
+        <span class="text-sm truncate" title="${safeFileName}">${safeFileName}</span>
         <span class="text-xs text-gray-500">${formatFileSize(file.size)}</span>
       </div>
       <div class="w-full bg-gray-200 h-2 rounded-full mt-1">

requirements.txt

@@ -1,66 +1,66 @@
-fastapi[all]  # Web framework with all extras
-uvicorn  # ASGI server
-celery  # Task queue
-redis  # Message broker for Celery
-sqlalchemy  # Database ORM
-pydantic  # Data validation
-cryptography>=41.0.0  # Encryption for sensitive settings in database
-openai  # GPT integration for metadata extraction
-pypdf>=3.9.0  # PDF processing for text extraction, metadata editing and rotation (upgraded from PyPDF2 to fix CVE-2023-36464)
-requests  # HTTP client
-click>=8.0.0  # CLI framework for docuelevate command
-puremagic>=1.25,<2.0  # File type detection (pure Python)
-filetype>=1.2.0,<2.0  # File type detection fallback (pure Python)
-dropbox>=11.36.0  # Dropbox integration
-azure-ai-documentintelligence  # Azure OCR service
-authlib>=1.6.5  # Authentication - fixed security vulnerabilities (GHSA-xxx)
-python-dotenv  # Environment variables
-starlette>=0.49.1  # ASGI toolkit (used by FastAPI) - fixed DoS vulnerability
-alembic  # Database migrations
-slowapi>=0.1.9  # Rate limiting middleware for FastAPI
-
-# Google Drive API
-google-api-python-client>=2.79.0
-google-auth>=2.22.0
-google-auth-oauthlib>=1.0.0
-
-# OneDrive/Microsoft Graph API
-msgraph-core>=1.0.0
-msal>=1.20.0
-
-# AWS S3
-boto3>=1.28.0
-
-# SFTP
-paramiko>=3.4.0  # SSH/SFTP implementation for Python (LGPL license)
-
-# iCloud Drive
-pyicloud>=2.4.0  # Unofficial Apple iCloud API client (MIT license)
-
-# Evernote
-evernote3>=1.25.14  # Evernote Cloud API SDK for Python 3 (BSD license)
-
-# Safe XML parsing (protection against XML bomb / XXE attacks)
-defusedxml>=0.7.1
-
-# Notification service
-apprise>=1.4.0
-
-# AI provider aggregator - enables Anthropic, Gemini, Ollama, and 100+ LLM providers
-litellm>=1.0.0,<2.0.0
-
-# Self-hosted OCR engines (optional – only required when the provider is enabled)
-pytesseract>=0.3.10  # Python wrapper for Tesseract OCR
-pdf2image>=1.17.0  # Convert PDF pages to images (used by Tesseract and EasyOCR providers)
-ocrmypdf>=16.0.0,<18.0.0  # Post-processing: embeds searchable text layers into PDFs via Tesseract
-meilisearch>=0.31.0  # Full-text search engine client
-stripe>=7.0.0,<16.0.0  # Stripe billing SDK (MIT license)
-
-# Error and performance monitoring
-sentry-sdk[fastapi,celery,sqlalchemy]>=2.20.0,<3.0.0
-
-# GraphQL API
-strawberry-graphql[fastapi]>=0.243.0,<1.0.0
-
-aiofiles>=24.1.0  # Asynchronous file I/O support
-segno>=1.6.0  # Pure-Python QR code generator (server-side rendering, no Pillow dependency)
+fastapi[all]!=0.136.3  # Web framework with all extras
+uvicorn  # ASGI server
+celery  # Task queue
+redis  # Message broker for Celery
+sqlalchemy  # Database ORM
+pydantic  # Data validation
+cryptography>=41.0.0  # Encryption for sensitive settings in database
+openai  # GPT integration for metadata extraction
+pypdf>=3.9.0  # PDF processing for text extraction, metadata editing and rotation (upgraded from PyPDF2 to fix CVE-2023-36464)
+requests  # HTTP client
+click>=8.0.0  # CLI framework for docuelevate command
+puremagic>=1.25,<2.0  # File type detection (pure Python)
+filetype>=1.2.0,<2.0  # File type detection fallback (pure Python)
+dropbox>=11.36.0  # Dropbox integration
+azure-ai-documentintelligence  # Azure OCR service
+authlib>=1.6.5  # Authentication - fixed security vulnerabilities (GHSA-xxx)
+python-dotenv  # Environment variables
+starlette>=0.49.1  # ASGI toolkit (used by FastAPI) - fixed DoS vulnerability
+alembic  # Database migrations
+slowapi>=0.1.9  # Rate limiting middleware for FastAPI
+
+# Google Drive API
+google-api-python-client>=2.79.0
+google-auth>=2.22.0
+google-auth-oauthlib>=1.0.0
+
+# OneDrive/Microsoft Graph API
+msgraph-core>=1.0.0
+msal>=1.20.0
+
+# AWS S3
+boto3>=1.28.0
+
+# SFTP
+paramiko>=3.4.0  # SSH/SFTP implementation for Python (LGPL license)
+
+# iCloud Drive
+pyicloud>=2.4.0  # Unofficial Apple iCloud API client (MIT license)
+
+# Evernote
+evernote3>=1.25.14  # Evernote Cloud API SDK for Python 3 (BSD license)
+
+# Safe XML parsing (protection against XML bomb / XXE attacks)
+defusedxml>=0.7.1
+
+# Notification service
+apprise>=1.4.0
+
+# AI provider aggregator - enables Anthropic, Gemini, Ollama, and 100+ LLM providers
+litellm>=1.0.0,<2.0.0
+
+# Self-hosted OCR engines (optional – only required when the provider is enabled)
+pytesseract>=0.3.10  # Python wrapper for Tesseract OCR
+pdf2image>=1.17.0  # Convert PDF pages to images (used by Tesseract and EasyOCR providers)
+ocrmypdf>=16.0.0,<18.0.0  # Post-processing: embeds searchable text layers into PDFs via Tesseract
+meilisearch>=0.31.0  # Full-text search engine client
+stripe>=7.0.0,<16.0.0  # Stripe billing SDK (MIT license)
+
+# Error and performance monitoring
+sentry-sdk[fastapi,celery,sqlalchemy]>=2.20.0,<3.0.0
+
+# GraphQL API
+strawberry-graphql[fastapi]>=0.243.0,<1.0.0
+
+aiofiles>=24.1.0  # Asynchronous file I/O support
+segno>=1.6.0  # Pure-Python QR code generator (server-side rendering, no Pillow dependency)