changed perms

fix(ci): shift GeoLite2 update to Sunday targeting development branch

.archive/legacy-tests-phase3/frontend-e2e/security-mobile.spec.ts

@@ -1,297 +0,0 @@
-/**
- * Security Dashboard Mobile Responsive E2E Tests
- * Test IDs: MR-01 through MR-10
- *
- * Tests mobile viewport (375x667), tablet viewport (768x1024),
- * touch targets, scrolling, and layout responsiveness.
- */
-import { test, expect } from '@bgotink/playwright-coverage'
-
-const base = process.env.CHARON_BASE_URL || 'http://localhost:8080'
-
-test.describe('Security Dashboard Mobile (375x667)', () => {
-  test.use({ viewport: { width: 375, height: 667 } })
-
-  test('MR-01: cards stack vertically on mobile', async ({ page }) => {
-    await page.goto(`${base}/security`)
-
-    // Wait for page to load
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // On mobile, grid should be single column
-    const grid = page.locator('.grid.grid-cols-1')
-    await expect(grid).toBeVisible()
-
-    // Get the computed grid-template-columns
-    const cardsContainer = page.locator('.grid').first()
-    const gridStyle = await cardsContainer.evaluate((el) => {
-      const style = window.getComputedStyle(el)
-      return style.gridTemplateColumns
-    })
-
-    // Single column should have just one value (not multiple columns like "repeat(4, ...)")
-    const columns = gridStyle.split(' ').filter((s) => s.trim().length > 0)
-    expect(columns.length).toBeLessThanOrEqual(2) // Single column or flexible
-  })
-
-  test('MR-04: toggle switches have accessible touch targets', async ({ page }) => {
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // Check CrowdSec toggle
-    const crowdsecToggle = page.getByTestId('toggle-crowdsec')
-    const crowdsecBox = await crowdsecToggle.boundingBox()
-
-    // Touch target should be at least 24px (component) + padding
-    // Most switches have a reasonable touch target
-    expect(crowdsecBox).not.toBeNull()
-    if (crowdsecBox) {
-      expect(crowdsecBox.height).toBeGreaterThanOrEqual(20)
-      expect(crowdsecBox.width).toBeGreaterThanOrEqual(35)
-    }
-
-    // Check WAF toggle
-    const wafToggle = page.getByTestId('toggle-waf')
-    const wafBox = await wafToggle.boundingBox()
-    expect(wafBox).not.toBeNull()
-    if (wafBox) {
-      expect(wafBox.height).toBeGreaterThanOrEqual(20)
-    }
-  })
-
-  test('MR-05: config buttons are tappable on mobile', async ({ page }) => {
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // Find config/configure buttons
-    const configButtons = page.locator('button:has-text("Config"), button:has-text("Configure")')
-    const buttonCount = await configButtons.count()
-
-    expect(buttonCount).toBeGreaterThan(0)
-
-    // Check first config button has reasonable size
-    const firstButton = configButtons.first()
-    const box = await firstButton.boundingBox()
-    expect(box).not.toBeNull()
-    if (box) {
-      expect(box.height).toBeGreaterThanOrEqual(28) // Minimum tap height
-    }
-  })
-
-  test('MR-06: page content is scrollable on mobile', async ({ page }) => {
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // Check if page is scrollable (content height > viewport)
-    const bodyHeight = await page.evaluate(() => document.body.scrollHeight)
-    const viewportHeight = 667
-
-    // If content is taller than viewport, page should scroll
-    if (bodyHeight > viewportHeight) {
-      // Attempt to scroll down
-      await page.evaluate(() => window.scrollBy(0, 200))
-      const scrollY = await page.evaluate(() => window.scrollY)
-      expect(scrollY).toBeGreaterThan(0)
-    }
-  })
-
-  test('MR-10: navigation is accessible on mobile', async ({ page }) => {
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // On mobile, there should be some form of navigation
-    // Check if sidebar or mobile menu toggle exists
-    const sidebar = page.locator('nav, aside, [role="navigation"]')
-    const sidebarCount = await sidebar.count()
-
-    // Navigation should exist in some form
-    expect(sidebarCount).toBeGreaterThanOrEqual(0) // May be hidden on mobile
-  })
-
-  test('MR-06b: overlay renders correctly on mobile', async ({ page }) => {
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // Skip if Cerberus is disabled (toggles would be disabled)
-    const cerberusDisabled = await page.locator('text=Cerberus Disabled').isVisible()
-    if (cerberusDisabled) {
-      test.skip()
-      return
-    }
-
-    // Trigger loading state by clicking a toggle
-    const wafToggle = page.getByTestId('toggle-waf')
-    const isDisabled = await wafToggle.isDisabled()
-
-    if (!isDisabled) {
-      await wafToggle.click()
-
-      // Check for overlay (may appear briefly)
-      // Use a short timeout since it might disappear quickly
-      try {
-        const overlay = page.locator('.fixed.inset-0')
-        await overlay.waitFor({ state: 'visible', timeout: 2000 })
-
-        // If overlay appeared, verify it fits screen
-        const box = await overlay.boundingBox()
-        if (box) {
-          expect(box.width).toBeLessThanOrEqual(375 + 10) // Allow small margin
-        }
-      } catch {
-        // Overlay might have disappeared before we could check
-        // This is acceptable for a fast operation
-      }
-    }
-  })
-})
-
-test.describe('Security Dashboard Tablet (768x1024)', () => {
-  test.use({ viewport: { width: 768, height: 1024 } })
-
-  test('MR-02: cards show 2 columns on tablet', async ({ page }) => {
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // On tablet (md breakpoint), should have md:grid-cols-2
-    const grid = page.locator('.grid').first()
-    await expect(grid).toBeVisible()
-
-    // Get computed style
-    const gridStyle = await grid.evaluate((el) => {
-      const style = window.getComputedStyle(el)
-      return style.gridTemplateColumns
-    })
-
-    // Should have 2 columns at md breakpoint
-    const columns = gridStyle.split(' ').filter((s) => s.trim().length > 0 && s !== 'none')
-    expect(columns.length).toBeGreaterThanOrEqual(2)
-  })
-
-  test('MR-08: cards have proper spacing on tablet', async ({ page }) => {
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // Check gap between cards
-    const grid = page.locator('.grid.gap-6').first()
-    const hasGap = await grid.isVisible()
-    expect(hasGap).toBe(true)
-  })
-})
-
-test.describe('Security Dashboard Desktop (1920x1080)', () => {
-  test.use({ viewport: { width: 1920, height: 1080 } })
-
-  test('MR-03: cards show 4 columns on desktop', async ({ page }) => {
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // On desktop (lg breakpoint), should have lg:grid-cols-4
-    const grid = page.locator('.grid').first()
-    await expect(grid).toBeVisible()
-
-    // Get computed style
-    const gridStyle = await grid.evaluate((el) => {
-      const style = window.getComputedStyle(el)
-      return style.gridTemplateColumns
-    })
-
-    // Should have 4 columns at lg breakpoint
-    const columns = gridStyle.split(' ').filter((s) => s.trim().length > 0 && s !== 'none')
-    expect(columns.length).toBeGreaterThanOrEqual(4)
-  })
-})
-
-test.describe('Security Dashboard Layout Tests', () => {
-  test('cards maintain correct order across viewports', async ({ page }) => {
-    // Test on mobile
-    await page.setViewportSize({ width: 375, height: 667 })
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // Get card headings
-    const getCardOrder = async () => {
-      const headings = await page.locator('h3').allTextContents()
-      return headings.filter((h) => ['CrowdSec', 'Access Control', 'Coraza', 'Rate Limiting'].includes(h))
-    }
-
-    const mobileOrder = await getCardOrder()
-
-    // Test on tablet
-    await page.setViewportSize({ width: 768, height: 1024 })
-    await page.waitForTimeout(100) // Allow reflow
-    const tabletOrder = await getCardOrder()
-
-    // Test on desktop
-    await page.setViewportSize({ width: 1920, height: 1080 })
-    await page.waitForTimeout(100) // Allow reflow
-    const desktopOrder = await getCardOrder()
-
-    // Order should be consistent
-    expect(mobileOrder).toEqual(tabletOrder)
-    expect(tabletOrder).toEqual(desktopOrder)
-    expect(desktopOrder).toEqual(['CrowdSec', 'Access Control', 'Coraza', 'Rate Limiting'])
-  })
-
-  test('MR-09: all security cards are visible on scroll', async ({ page }) => {
-    await page.setViewportSize({ width: 375, height: 667 })
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // Scroll to each card type
-    const cardTypes = ['CrowdSec', 'Access Control', 'Coraza', 'Rate Limiting']
-
-    for (const cardType of cardTypes) {
-      const card = page.locator(`h3:has-text("${cardType}")`)
-      await card.scrollIntoViewIfNeeded()
-      await expect(card).toBeVisible()
-    }
-  })
-})
-
-test.describe('Security Dashboard Interaction Tests', () => {
-  test.use({ viewport: { width: 375, height: 667 } })
-
-  test('MR-07: config buttons navigate correctly on mobile', async ({ page }) => {
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // Skip if Cerberus disabled
-    const cerberusDisabled = await page.locator('text=Cerberus Disabled').isVisible()
-    if (cerberusDisabled) {
-      test.skip()
-      return
-    }
-
-    // Find and click WAF Configure button
-    const configureButton = page.locator('button:has-text("Configure")').first()
-
-    if (await configureButton.isVisible()) {
-      await configureButton.click()
-
-      // Should navigate to a config page
-      await page.waitForTimeout(500)
-      const url = page.url()
-
-      // URL should include security/waf or security/rate-limiting etc
-      expect(url).toMatch(/security\/(waf|rate-limiting|access-lists|crowdsec)/i)
-    }
-  })
-
-  test('documentation button works on mobile', async ({ page }) => {
-    await page.goto(`${base}/security`)
-    await page.waitForSelector('[data-testid="toggle-crowdsec"]', { timeout: 10000 })
-
-    // Find documentation button
-    const docButton = page.locator('button:has-text("Documentation"), a:has-text("Documentation")').first()
-
-    if (await docButton.isVisible()) {
-      // Check it has correct external link behavior
-      const href = await docButton.getAttribute('href')
-
-      // Should open external docs
-      if (href) {
-        expect(href).toContain('wikid82.github.io')
-      }
-    }
-  })
-})

.archive/legacy-tests-phase3/frontend-e2e/waf.spec.ts

@@ -1,34 +0,0 @@
-import { test, expect } from '@bgotink/playwright-coverage'
-
-const base = process.env.CHARON_BASE_URL || 'http://localhost:8080'
-
-// Hit an API route inside /api/v1 to ensure Cerberus middleware executes.
-const targetPath = '/api/v1/system/my-ip'
-
-test.describe('WAF blocking and monitoring', () => {
-  test('blocks malicious query when mode=block', async ({ request }) => {
-    // Use literal '<script>' to trigger naive WAF check
-    const res = await request.get(`${base}${targetPath}?<script>=x`)
-    expect([400, 401]).toContain(res.status())
-    // When WAF runs before auth, expect 400; if auth runs first, we still validate that the server rejects
-    if (res.status() === 400) {
-      const body = await res.json()
-      expect(body?.error).toMatch(/WAF: suspicious payload/i)
-    }
-  })
-
-  test('does not block when mode=monitor (returns 401 due to auth)', async ({ request }) => {
-    const res = await request.get(`${base}${targetPath}?safe=yes`)
-    // Unauthenticated → expect 401, not 400; proves WAF did not block
-    expect([401, 403]).toContain(res.status())
-  })
-
-  test('metrics endpoint exposes Prometheus counters', async ({ request }) => {
-    const res = await request.get(`${base}/metrics`)
-    expect(res.status()).toBe(200)
-    const text = await res.text()
-    expect(text).toContain('charon_waf_requests_total')
-    expect(text).toContain('charon_waf_blocked_total')
-    expect(text).toContain('charon_waf_monitored_total')
-  })
-})

.archive/legacy-tests-phase3/frontend-tests/login.smoke.spec.ts

@@ -1,26 +0,0 @@
-import { test, expect } from '@bgotink/playwright-coverage'
-
-test.describe('Login - smoke', () => {
-  test('renders and has no console errors on load', async ({ page }) => {
-    const consoleErrors: string[] = []
-
-    page.on('console', msg => {
-      if (msg.type() === 'error') {
-        consoleErrors.push(msg.text())
-      }
-    })
-
-    await page.goto('/login', { waitUntil: 'domcontentloaded' })
-
-    await expect(page).toHaveURL(/\/login(?:\?|$)/)
-
-    const emailInput = page.getByRole('textbox', { name: /email/i })
-    const passwordInput = page.getByLabel(/password/i)
-
-    await expect(emailInput).toBeVisible()
-    await expect(passwordInput).toBeVisible()
-    await expect(page.getByRole('button', { name: /sign in/i })).toBeVisible()
-
-    expect(consoleErrors, 'Console errors during /login load').toEqual([])
-  })
-})

.codecov.yml

@@ -1,135 +0,0 @@
-# =============================================================================
-# Codecov Configuration
-# Require 75% overall coverage, exclude test files and non-source code
-# =============================================================================
-
-coverage:
-  status:
-    project:
-      default:
-        target: 85%
-        threshold: 0%
-
-# Fail CI if Codecov upload/report indicates a problem
-require_ci_to_pass: yes
-
-# -----------------------------------------------------------------------------
-# Exclude from coverage reporting
-# -----------------------------------------------------------------------------
-ignore:
-  # Test files
-  - "**/tests/**"
-  - "**/test/**"
-  - "**/__tests__/**"
-  - "**/test_*.go"
-  - "**/*_test.go"
-  - "**/*.test.ts"
-  - "**/*.test.tsx"
-  - "**/*.spec.ts"
-  - "**/*.spec.tsx"
-  - "**/vitest.config.ts"
-  - "**/vitest.setup.ts"
-
-  # E2E tests
-  - "**/e2e/**"
-  - "**/integration/**"
-
-  # Documentation
-  - "docs/**"
-  - "*.md"
-
-  # CI/CD & Config
-  - ".github/**"
-  - "scripts/**"
-  - "tools/**"
-  - "*.yml"
-  - "*.yaml"
-  - "*.json"
-
-  # Frontend build artifacts & dependencies
-  - "frontend/node_modules/**"
-  - "frontend/dist/**"
-  - "frontend/coverage/**"
-  - "frontend/test-results/**"
-  - "frontend/public/**"
-
-  # Backend non-source files
-  - "backend/cmd/seed/**"
-  - "backend/data/**"
-  - "backend/coverage/**"
-  - "backend/bin/**"
-  - "backend/*.cover"
-  - "backend/*.out"
-  - "backend/*.html"
-  - "backend/codeql-db/**"
-
-  # Docker-only code (not testable in CI)
-  - "backend/internal/services/docker_service.go"
-  - "backend/internal/api/handlers/docker_handler.go"
-
-  # CodeQL artifacts
-  - "codeql-db/**"
-  - "codeql-db-*/**"
-  - "codeql-agent-results/**"
-  - "codeql-custom-queries-*/**"
-  - "*.sarif"
-
-  # Config files (no logic)
-  - "**/tailwind.config.js"
-  - "**/postcss.config.js"
-  - "**/eslint.config.js"
-  - "**/vite.config.ts"
-  - "**/tsconfig*.json"
-
-  # Type definitions only
-  - "**/*.d.ts"
-
-  # Import/data directories
-  - "import/**"
-  - "data/**"
-  - ".cache/**"
-
-  # CrowdSec config files (no logic to test)
-  - "configs/crowdsec/**"
-
-  # ==========================================================================
-  # Backend packages excluded from coverage (match go-test-coverage.sh)
-  # These are entrypoints and infrastructure code that don't benefit from
-  # unit tests - they are tested via integration tests instead.
-  # ==========================================================================
-
-  # Main entry points (bootstrap code only)
-  - "backend/cmd/api/**"
-
-  # Infrastructure packages (logging, metrics, tracing)
-  # These are thin wrappers around external libraries with no business logic
-  - "backend/internal/logger/**"
-  - "backend/internal/metrics/**"
-  - "backend/internal/trace/**"
-
-  # Backend test utilities (test infrastructure, not application code)
-  # These files contain testing helpers that take *testing.T and are only
-  # callable from *_test.go files - they cannot be covered by production code
-  - "backend/internal/api/handlers/testdb.go"
-  - "backend/internal/api/handlers/test_helpers.go"
-
-  # DNS provider implementations (tested via integration tests, not unit tests)
-  # These are plugin implementations that interact with external DNS APIs
-  # and are validated through service-level integration tests
-  - "backend/pkg/dnsprovider/builtin/**"
-
-  # ==========================================================================
-  # Frontend test utilities and helpers
-  # These are test infrastructure, not application code
-  # ==========================================================================
-
-  # Test setup and utilities directory
-  - "frontend/src/test/**"
-
-  # Vitest setup files
-  - "frontend/vitest.config.ts"
-  - "frontend/src/setupTests.ts"
-
-  # Playwright E2E config
-  - "frontend/playwright.config.ts"
-  - "frontend/e2e/**"

.docker/README.md

@@ -94,7 +94,12 @@ Configure the application via `docker-compose.yml`:
 | `CHARON_ENV` | `production` | Set to `development` for verbose logging (`CPM_ENV` supported for backward compatibility). |
 | `CHARON_HTTP_PORT` | `8080` | Port for the Web UI (`CPM_HTTP_PORT` supported for backward compatibility). |
 | `CHARON_DB_PATH` | `/app/data/charon.db` | Path to the SQLite database (`CPM_DB_PATH` supported for backward compatibility). |
-| `CHARON_CADDY_ADMIN_API` | `http://localhost:2019` | Internal URL for Caddy API (`CPM_CADDY_ADMIN_API` supported for backward compatibility). |
+| `CHARON_CADDY_ADMIN_API` | `http://localhost:2019` | Internal URL for Caddy API (`CPM_CADDY_ADMIN_API` supported for backward compatibility). Must resolve to an internal allowlisted host on port `2019`. |
+| `CHARON_CADDY_CONFIG_ROOT` | `/config` | Path to Caddy autosave configuration directory. |
+| `CHARON_CADDY_LOG_DIR` | `/var/log/caddy` | Directory for Caddy access logs. |
+| `CHARON_CROWDSEC_LOG_DIR` | `/var/log/crowdsec` | Directory for CrowdSec logs. |
+| `CHARON_PLUGINS_DIR` | `/app/plugins` | Directory for DNS provider plugins. |
+| `CHARON_SINGLE_CONTAINER_MODE` | `true` | Enables permission repair endpoints for single-container deployments. |
 
 ## NAS Deployment Guides
 
@@ -213,6 +218,8 @@ environment:
   - CPM_CADDY_ADMIN_API=http://your-caddy-host:2019
 ```
 
+If using a non-localhost internal hostname, add it to `CHARON_SSRF_INTERNAL_HOST_ALLOWLIST`.
+
 **Warning**: Charon will replace Caddy's entire configuration. Backup first!
 
 ## Performance Tuning

.docker/compose/docker-compose.dev.yml

@@ -32,6 +32,8 @@ services:
       #- CPM_SECURITY_RATELIMIT_ENABLED=false
       #- CPM_SECURITY_ACL_ENABLED=false
       - FEATURE_CERBERUS_ENABLED=true
+    # Docker socket group access: copy docker-compose.override.example.yml
+    # to docker-compose.override.yml and set your host's docker GID.
     volumes:
       - /var/run/docker.sock:/var/run/docker.sock:ro # For local container discovery
       - crowdsec_data:/app/data/crowdsec

.docker/compose/docker-compose.local.yml

@@ -27,6 +27,8 @@ services:
       - FEATURE_CERBERUS_ENABLED=true
       # Emergency "break-glass" token for security reset when ACL blocks access
       - CHARON_EMERGENCY_TOKEN=03e4682c1164f0c1cb8e17c99bd1a2d9156b59824dde41af3bb67c513e5c5e92
+    # Docker socket group access: copy docker-compose.override.example.yml
+    # to docker-compose.override.yml and set your host's docker GID.
     extra_hosts:
       - "host.docker.internal:host-gateway"
     cap_add:
@@ -45,7 +47,7 @@ services:
 #      - <PATH_TO_YOUR_CADDYFILE>:/import/Caddyfile:ro
 #      - <PATH_TO_YOUR_SITES_DIR>:/import/sites:ro # If your Caddyfile imports other files
     healthcheck:
-      test: ["CMD-SHELL", "curl -fsS http://localhost:8080/api/v1/health || exit 1"]
+      test: ["CMD-SHELL", "wget -qO /dev/null http://localhost:8080/api/v1/health || exit 1"]
       interval: 30s
       timeout: 10s
       retries: 3

.docker/compose/docker-compose.override.example.yml

@@ -0,0 +1,26 @@
+# Docker Compose override — copy to docker-compose.override.yml to activate.
+#
+# Use case: grant the container access to the host Docker socket so that
+# Charon can discover running containers.
+#
+# 1. cp docker-compose.override.example.yml docker-compose.override.yml
+# 2. Uncomment the service that matches your compose file:
+#      - "charon" for docker-compose.local.yml
+#      - "app"    for docker-compose.dev.yml
+# 3. Replace <GID> with the output of:  stat -c '%g' /var/run/docker.sock
+# 4. docker compose up -d
+
+services:
+  # Uncomment for docker-compose.local.yml
+  charon:
+    group_add:
+      - "<GID>"   # e.g. "988" — run: stat -c '%g' /var/run/docker.sock
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+
+  # Uncomment for docker-compose.dev.yml
+  app:
+    group_add:
+      - "<GID>"   # e.g. "988" — run: stat -c '%g' /var/run/docker.sock
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro

.docker/compose/docker-compose.playwright-ci.yml

@@ -27,7 +27,7 @@ services:
   # Charon Application - Core E2E Testing Service
   # =============================================================================
   charon-app:
-    # CI provides CHARON_E2E_IMAGE_TAG=charon:e2e-test (locally built image)
+    # CI provides CHARON_E2E_IMAGE_TAG=charon:e2e-test (retagged from shared digest)
     # Local development uses the default fallback value
     image: ${CHARON_E2E_IMAGE_TAG:-charon:e2e-test}
     container_name: charon-playwright
@@ -85,8 +85,9 @@ services:
       - playwright_data:/app/data
       - playwright_caddy_data:/data
       - playwright_caddy_config:/config
+      - /var/run/docker.sock:/var/run/docker.sock:ro # For container discovery in tests
     healthcheck:
-      test: ["CMD", "curl", "-sf", "http://localhost:8080/api/v1/health"]
+      test: ["CMD-SHELL", "wget -qO /dev/null http://localhost:8080/api/v1/health || exit 1"]
       interval: 5s
       timeout: 3s
       retries: 12
@@ -111,6 +112,7 @@ services:
     volumes:
       - playwright_crowdsec_data:/var/lib/crowdsec/data
       - playwright_crowdsec_config:/etc/crowdsec
+      - /var/run/docker.sock:/var/run/docker.sock:ro # For container discovery in tests
     healthcheck:
       test: ["CMD", "cscli", "version"]
       interval: 10s

.docker/compose/docker-compose.playwright-local.yml

@@ -48,9 +48,12 @@ services:
     tmpfs:
       # True tmpfs for E2E test data - fresh on every run, in-memory only
       # mode=1777 allows any user to write (container runs as non-root)
-      - /app/data:size=100M,mode=1777
+      # 256M gives headroom for the backup service's 100MB disk-space check
+      - /app/data:size=256M,mode=1777
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro # For container discovery in tests
     healthcheck:
-      test: ["CMD-SHELL", "curl -fsS http://localhost:8080/api/v1/health || exit 1"]
+      test: ["CMD-SHELL", "wget -qO /dev/null http://localhost:8080/api/v1/health || exit 1"]
       interval: 5s
       timeout: 5s
       retries: 10

.docker/compose/docker-compose.yml

@@ -52,7 +52,7 @@ services:
       # - ./my-existing-Caddyfile:/import/Caddyfile:ro
       # - ./sites:/import/sites:ro # If your Caddyfile imports other files
     healthcheck:
-      test: ["CMD-SHELL", "curl -fsS http://localhost:8080/api/v1/health || exit 1"]
+      test: ["CMD-SHELL", "wget -qO /dev/null http://localhost:8080/api/v1/health || exit 1"]
       interval: 30s
       timeout: 10s
       retries: 3

.docker/docker-entrypoint.sh

@@ -18,6 +18,36 @@ run_as_charon() {
     fi
 }
 
+get_group_by_gid() {
+    if command -v getent >/dev/null 2>&1; then
+        getent group "$1" 2>/dev/null || true
+    else
+        awk -F: -v gid="$1" '$3==gid {print $0}' /etc/group 2>/dev/null || true
+    fi
+}
+
+create_group_with_gid() {
+    if command -v addgroup >/dev/null 2>&1; then
+        addgroup -g "$1" "$2" 2>/dev/null || true
+        return
+    fi
+
+    if command -v groupadd >/dev/null 2>&1; then
+        groupadd -g "$1" "$2" 2>/dev/null || true
+    fi
+}
+
+add_user_to_group() {
+    if command -v addgroup >/dev/null 2>&1; then
+        addgroup "$1" "$2" 2>/dev/null || true
+        return
+    fi
+
+    if command -v usermod >/dev/null 2>&1; then
+        usermod -aG "$2" "$1" 2>/dev/null || true
+    fi
+}
+
 # ============================================================================
 # Volume Permission Handling for Non-Root User
 # ============================================================================
@@ -89,24 +119,32 @@ if [ -S "/var/run/docker.sock" ] && is_root; then
     DOCKER_SOCK_GID=$(stat -c '%g' /var/run/docker.sock 2>/dev/null || echo "")
     if [ -n "$DOCKER_SOCK_GID" ] && [ "$DOCKER_SOCK_GID" != "0" ]; then
         # Check if a group with this GID exists
-        if ! getent group "$DOCKER_SOCK_GID" >/dev/null 2>&1; then
+        GROUP_ENTRY=$(get_group_by_gid "$DOCKER_SOCK_GID")
+        if [ -z "$GROUP_ENTRY" ]; then
             echo "Docker socket detected (gid=$DOCKER_SOCK_GID) - creating docker group and adding charon user..."
             # Create docker group with the socket's GID
-            groupadd -g "$DOCKER_SOCK_GID" docker 2>/dev/null || true
+            create_group_with_gid "$DOCKER_SOCK_GID" docker
             # Add charon user to the docker group
-            usermod -aG docker charon 2>/dev/null || true
+            add_user_to_group charon docker
             echo "Docker integration enabled for charon user"
         else
             # Group exists, just add charon to it
-            GROUP_NAME=$(getent group "$DOCKER_SOCK_GID" | cut -d: -f1)
+            GROUP_NAME=$(echo "$GROUP_ENTRY" | cut -d: -f1)
             echo "Docker socket detected (gid=$DOCKER_SOCK_GID, group=$GROUP_NAME) - adding charon user..."
-            usermod -aG "$GROUP_NAME" charon 2>/dev/null || true
+            add_user_to_group charon "$GROUP_NAME"
             echo "Docker integration enabled for charon user"
         fi
     fi
 elif [ -S "/var/run/docker.sock" ]; then
-    echo "Note: Docker socket mounted but container is running non-root; skipping docker.sock group setup."
+    DOCKER_SOCK_GID=$(stat -c '%g' /var/run/docker.sock 2>/dev/null || echo "unknown")
-    echo "      If Docker discovery is needed, run with matching group permissions (e.g., --group-add)"
+    echo "Note: Docker socket mounted (GID=$DOCKER_SOCK_GID) but container is running non-root; skipping docker.sock group setup."
+    echo "      If Docker discovery is needed, add 'group_add: [\"$DOCKER_SOCK_GID\"]' to your compose service."
+    if [ "$DOCKER_SOCK_GID" = "0" ]; then
+        if [ "${ALLOW_DOCKER_SOCK_GID_0:-false}" != "true" ]; then
+            echo "⚠️  WARNING: Docker socket GID is 0 (root group). group_add: [\"0\"] grants root-group access."
+            echo "   Set ALLOW_DOCKER_SOCK_GID_0=true to acknowledge this risk."
+        fi
+    fi
 else
     echo "Note: Docker socket not found. Docker container discovery will be unavailable."
 fi
@@ -152,22 +190,42 @@ if command -v cscli >/dev/null; then
     # Initialize persistent config if key files are missing
     if [ ! -f "$CS_CONFIG_DIR/config.yaml" ]; then
         echo "Initializing persistent CrowdSec configuration..."
-        if [ -d "/etc/crowdsec.dist" ] && [ -n "$(ls -A /etc/crowdsec.dist 2>/dev/null)" ]; then
+
-            cp -r /etc/crowdsec.dist/* "$CS_CONFIG_DIR/" || {
+        # Check if .dist has content
+        if [ -d "/etc/crowdsec.dist" ] && find /etc/crowdsec.dist -mindepth 1 -maxdepth 1 -print -quit 2>/dev/null | grep -q .; then
+            echo "Copying config from /etc/crowdsec.dist..."
+            if ! cp -r /etc/crowdsec.dist/* "$CS_CONFIG_DIR/"; then
                 echo "ERROR: Failed to copy config from /etc/crowdsec.dist"
+                echo "DEBUG: Contents of /etc/crowdsec.dist:"
+                ls -la /etc/crowdsec.dist/
                 exit 1
-            }
+            fi
-            echo "Successfully initialized config from .dist directory"
+
-        elif [ -d "/etc/crowdsec" ] && [ ! -L "/etc/crowdsec" ] && [ -n "$(ls -A /etc/crowdsec 2>/dev/null)" ]; then
+            # Verify critical files were copied
-            cp -r /etc/crowdsec/* "$CS_CONFIG_DIR/" || {
+            if [ ! -f "$CS_CONFIG_DIR/config.yaml" ]; then
-                echo "ERROR: Failed to copy config from /etc/crowdsec"
+                echo "ERROR: config.yaml was not copied to $CS_CONFIG_DIR"
+                echo "DEBUG: Contents of $CS_CONFIG_DIR after copy:"
+                ls -la "$CS_CONFIG_DIR/"
                 exit 1
-            }
+            fi
-            echo "Successfully initialized config from /etc/crowdsec"
+            echo "✓ Successfully initialized config from .dist directory"
+        elif [ -d "/etc/crowdsec" ] && [ ! -L "/etc/crowdsec" ] && find /etc/crowdsec -mindepth 1 -maxdepth 1 -print -quit 2>/dev/null | grep -q .; then
+            echo "Copying config from /etc/crowdsec (fallback)..."
+            if ! cp -r /etc/crowdsec/* "$CS_CONFIG_DIR/"; then
+                echo "ERROR: Failed to copy config from /etc/crowdsec (fallback)"
+                exit 1
+            fi
+            echo "✓ Successfully initialized config from /etc/crowdsec"
         else
-            echo "ERROR: No config source found (neither .dist nor /etc/crowdsec available)"
+            echo "ERROR: No config source found!"
+            echo "DEBUG: /etc/crowdsec.dist contents:"
+            ls -la /etc/crowdsec.dist/ 2>/dev/null || echo "  (directory not found or empty)"
+            echo "DEBUG: /etc/crowdsec contents:"
+            ls -la /etc/crowdsec 2>/dev/null || echo "  (directory not found or empty)"
             exit 1
         fi
+    else
+        echo "✓ Persistent config already exists: $CS_CONFIG_DIR/config.yaml"
     fi
 
     # Verify symlink exists (created at build time)
@@ -175,10 +233,24 @@ if command -v cscli >/dev/null; then
     # Non-root users cannot create symlinks in /etc, so this must be done at build time
     if [ -L "/etc/crowdsec" ]; then
         echo "CrowdSec config symlink verified: /etc/crowdsec -> $CS_CONFIG_DIR"
+
+        # Verify the symlink target is accessible and has config.yaml
+        if [ ! -f "/etc/crowdsec/config.yaml" ]; then
+            echo "ERROR: /etc/crowdsec/config.yaml is not accessible via symlink"
+            echo "DEBUG: Symlink target verification:"
+            ls -la /etc/crowdsec 2>/dev/null || echo "  (symlink broken or missing)"
+            echo "DEBUG: Directory contents:"
+            ls -la "$CS_CONFIG_DIR/" 2>/dev/null | head -10 || echo "  (directory not found)"
+            exit 1
+        fi
+        echo "✓ /etc/crowdsec/config.yaml is accessible via symlink"
     else
-        echo "WARNING: /etc/crowdsec symlink not found. This may indicate a build issue."
+        echo "ERROR: /etc/crowdsec symlink not found"
         echo "Expected: /etc/crowdsec -> /app/data/crowdsec/config"
-        # Try to continue anyway - config may still work if CrowdSec uses CFG env var
+        echo "This indicates a critical build-time issue. Symlink must be created at build time as root."
+        echo "DEBUG: Directory check:"
+        find /etc -mindepth 1 -maxdepth 1 -name '*crowdsec*' -exec ls -ld {} \; 2>/dev/null || echo "  (no crowdsec entry found)"
+        exit 1
     fi
 
     # Create/update acquisition config for Caddy logs
@@ -231,6 +303,19 @@ ACQUIS_EOF
     # Also handle case where it might be without trailing slash
     sed -i 's|log_dir: /var/log$|log_dir: /var/log/crowdsec|g' "$CS_CONFIG_DIR/config.yaml"
 
+    # Redirect CrowdSec LAPI database to persistent volume
+    # Default path /var/lib/crowdsec/data/crowdsec.db is ephemeral (not volume-mounted),
+    # so it is destroyed on every container rebuild. The bouncer API key (stored on the
+    # persistent volume at /app/data/crowdsec/) survives rebuilds but the LAPI database
+    # that validates it does not — causing perpetual key rejection.
+    # Redirecting db_path to the volume-mounted CS_DATA_DIR fixes this.
+    sed -i "s|db_path: /var/lib/crowdsec/data/crowdsec.db|db_path: ${CS_DATA_DIR}/crowdsec.db|g" "$CS_CONFIG_DIR/config.yaml"
+    if grep -q "db_path:.*${CS_DATA_DIR}" "$CS_CONFIG_DIR/config.yaml"; then
+        echo "✓ CrowdSec LAPI database redirected to persistent volume: ${CS_DATA_DIR}/crowdsec.db"
+    else
+        echo "⚠️  WARNING: Could not verify LAPI db_path redirect — bouncer keys may not survive rebuilds"
+    fi
+
     # Verify LAPI configuration was applied correctly
     if grep -q "listen_uri:.*:8085" "$CS_CONFIG_DIR/config.yaml"; then
         echo "✓ CrowdSec LAPI configured for port 8085"
@@ -238,10 +323,11 @@ ACQUIS_EOF
         echo "✗ WARNING: LAPI port configuration may be incorrect"
     fi
 
-    # Update hub index to ensure CrowdSec can start
+    # Always refresh hub index on startup (stale index causes hash mismatch errors on collection install)
-    if [ ! -f "/etc/crowdsec/hub/.index.json" ]; then
+    echo "Updating CrowdSec hub index..."
-        echo "Updating CrowdSec hub index..."
+    if ! timeout 60s cscli hub update 2>&1; then
-        timeout 60s cscli hub update 2>/dev/null || echo "⚠️ Hub update timed out or failed, continuing..."
+        echo "⚠️ Hub index update failed (network issue?). Collections may fail to install."
+        echo "   CrowdSec will still start with whatever index is cached."
     fi
 
     # Ensure local machine is registered (auto-heal for volume/config mismatch)
@@ -249,12 +335,11 @@ ACQUIS_EOF
     echo "Registering local machine..."
     cscli machines add -a --force 2>/dev/null || echo "Warning: Machine registration may have failed"
 
-    # Install hub items (parsers, scenarios, collections) if local mode enabled
+    # Always ensure required collections are present (idempotent — already-installed items are skipped).
-    if [ "$SECURITY_CROWDSEC_MODE" = "local" ]; then
+    # Collections are just config files with zero runtime cost when CrowdSec is disabled.
-        echo "Installing CrowdSec hub items..."
+    echo "Ensuring CrowdSec hub items are installed..."
-        if [ -x /usr/local/bin/install_hub_items.sh ]; then
+    if [ -x /usr/local/bin/install_hub_items.sh ]; then
-            /usr/local/bin/install_hub_items.sh 2>/dev/null || echo "Warning: Some hub items may not have installed"
+        /usr/local/bin/install_hub_items.sh || echo "⚠️ Some hub items may not have installed. CrowdSec can still start."
-        fi
     fi
 
     # Fix ownership AFTER cscli commands (they run as root and create root-owned files)
@@ -293,7 +378,7 @@ echo "Caddy started (PID: $CADDY_PID)"
 echo "Waiting for Caddy admin API..."
 i=1
 while [ "$i" -le 30 ]; do
-    if curl -sf http://127.0.0.1:2019/config/ > /dev/null 2>&1; then
+    if wget -qO /dev/null http://127.0.0.1:2019/config/ 2>/dev/null; then
         echo "Caddy is ready!"
         break
     fi

.dockerignore

@@ -9,13 +9,12 @@
 .git/
 .gitignore
 .github/
-.pre-commit-config.yaml
+codecov.yml
-.codecov.yml
 .goreleaser.yaml
 .sourcery.yml
 
 # -----------------------------------------------------------------------------
-# Python (pre-commit, tooling)
+# Python (tooling)
 # -----------------------------------------------------------------------------
 __pycache__/
 *.py[cod]
@@ -80,7 +79,6 @@ backend/node_modules/
 backend/internal/api/tests/data/
 backend/lint*.txt
 backend/fix_*.sh
-backend/codeql-db-*/
 
 # Backend data (created at runtime)
 backend/data/
@@ -185,8 +183,6 @@ codeql-db/
 codeql-db-*/
 codeql-agent-results/
 codeql-custom-queries-*/
-codeql-*.sarif
-codeql-results*.sarif
 .codeql/
 
 # -----------------------------------------------------------------------------
@@ -208,7 +204,6 @@ playwright.config.js
 # -----------------------------------------------------------------------------
 # Root-level artifacts
 # -----------------------------------------------------------------------------
-coverage/
 coverage.txt
 provenance*.json
 trivy-*.txt

.github/agents/Backend_Dev.agent.md

@@ -2,18 +2,28 @@
 name: 'Backend Dev'
 description: 'Senior Go Engineer focused on high-performance, secure backend implementation.'
 argument-hint: 'The specific backend task from the Plan (e.g., "Implement ProxyHost CRUD endpoints")'
-tools:
+tools: vscode/getProjectSetupInfo, vscode/installExtension, vscode/memory, vscode/runCommand, vscode/vscodeAPI, vscode/extensions, vscode/askQuestions, execute, read, edit, search, web, browser, github/add_comment_to_pending_review, github/add_issue_comment, github/add_reply_to_pull_request_comment, github/assign_copilot_to_issue, github/create_branch, github/create_or_update_file, github/create_pull_request, github/create_pull_request_with_copilot, github/create_repository, github/delete_file, github/fork_repository, github/get_commit, github/get_copilot_job_status, github/get_file_contents, github/get_label, github/get_latest_release, github/get_me, github/get_release_by_tag, github/get_tag, github/get_team_members, github/get_teams, github/issue_read, github/issue_write, github/list_branches, github/list_commits, github/list_issue_types, github/list_issues, github/list_pull_requests, github/list_releases, github/list_tags, github/merge_pull_request, github/pull_request_read, github/pull_request_review_write, github/push_files, github/request_copilot_review, github/search_code, github/search_issues, github/search_pull_requests, github/search_repositories, github/search_users, github/sub_issue_write, github/update_pull_request, github/update_pull_request_branch, playwright/*, github/*, io.github.goreleaser/mcp/*, mcp-refactor-typescript/*, microsoftdocs/mcp/*, vscode.mermaid-chat-features/renderMermaidDiagram, github.vscode-pull-request-github/issue_fetch, github.vscode-pull-request-github/labels_fetch, github.vscode-pull-request-github/notification_fetch, github.vscode-pull-request-github/doSearch, github.vscode-pull-request-github/activePullRequest, github.vscode-pull-request-github/pullRequestStatusChecks, github.vscode-pull-request-github/openPullRequest, ms-azuretools.vscode-containers/containerToolsConfig, ms-python.python/getPythonEnvironmentInfo, ms-python.python/getPythonExecutableCommand, ms-python.python/installPythonPackage, ms-python.python/configurePythonEnvironment, todo
-  ['execute', 'read', 'agent', 'edit/createDirectory', 'edit/createFile', 'edit/editFiles', 'edit/editNotebook', 'search', 'todo']
+
-model: 'Cloaude Sonnet 4.5'
+
+
+target: vscode
+user-invocable: true
+disable-model-invocation: false
+
 ---
 You are a SENIOR GO BACKEND ENGINEER specializing in Gin, GORM, and System Architecture.
 Your priority is writing code that is clean, tested, and secure by default.
 
 <context>
+
+- **Governance**: When this agent file conflicts with canonical instruction
+    files (`.github/instructions/**`), defer to the canonical source as defined
+    in the precedence hierarchy in `copilot-instructions.md`.
 - **MANDATORY**: Read all relevant instructions in `.github/instructions/` for the specific task before starting.
 - **Project**: Charon (Self-hosted Reverse Proxy)
 - **Stack**: Go 1.22+, Gin, GORM, SQLite.
 - **Rules**: You MUST follow `.github/copilot-instructions.md` explicitly.
+- **References**: Use `gopls` mcp server for Go code understanding and generation.
 </context>
 
 <workflow>
@@ -35,23 +45,33 @@ Your priority is writing code that is clean, tested, and secure by default.
         - Define the structs in `internal/models` to fix compilation errors.
     - **Step 3 (The Logic)**:
         - Implement the handler in `internal/api/handlers`.
-    - **Step 4 (The Green Light)**:
+    - **Step 4 (Lint and Format)**:
+        - Run `lefthook run pre-commit` to ensure code quality.
+    - **Step 5 (The Green Light)**:
         - Run `go test ./...`.
         - **CRITICAL**: If it fails, fix the *Code*, NOT the *Test* (unless the test was wrong about the contract).
 
 3. **Verification (Definition of Done)**:
     - Run `go mod tidy`.
     - Run `go fmt ./...`.
-    - Run `go test ./...` to ensure no regressions.
+        - Run `go test ./...` to ensure no regressions.
+        - **Conditional GORM Gate**: If task changes include model/database-related
+            files (`backend/internal/models/**`, GORM query logic, migrations), run
+            GORM scanner in check mode and treat CRITICAL/HIGH findings as blocking:
+                - Run: `lefthook run pre-commit` (which includes manual gorm-security-scan) OR `./scripts/scan-gorm-security.sh --check`
+                - Policy: Process-blocking gate even while automation is manual stage
+    - **Local Patch Coverage Preflight (MANDATORY)**: Run VS Code task `Test: Local Patch Report` or `bash scripts/local-patch-report.sh` before backend coverage runs.
+        - Ensure artifacts exist: `test-results/local-patch-report.md` and `test-results/local-patch-report.json`.
+        - Use the file-level coverage gap list to target tests before final coverage validation.
     - **Coverage (MANDATORY)**: Run the coverage task/script explicitly and confirm Codecov Patch view is green for modified lines.
         - **MANDATORY**: Patch coverage must cover 100% of new/modified code. This prevents CodeCov Report failing CI.
         - **VS Code Task**: Use "Test: Backend with Coverage" (recommended)
         - **Manual Script**: Execute `/projects/Charon/scripts/go-test-coverage.sh` from the root directory
         - **Minimum**: 85% coverage (configured via `CHARON_MIN_COVERAGE` or `CPM_MIN_COVERAGE`)
         - **Critical**: If coverage drops below threshold, write additional tests immediately. Do not skip this step.
-        - **Why**: Coverage tests are in manual stage of pre-commit for performance. You MUST run them via VS Code tasks or scripts before completing your task.
+        - **Why**: Coverage tests are in manual stage of lefthook for performance. You MUST run them via VS Code tasks or scripts before completing your task.
     - Ensure coverage goals are met as well as all tests pass. Just because Tests pass does not mean you are done. Goal Coverage Needs to be met even if the tests to get us there are outside the scope of your task. At this point, your task is to maintain coverage goal and all tests pass because we cannot commit changes if they fail.
-    - Run `pre-commit run --all-files` as final check (this runs fast hooks only; coverage was verified above).
+    - Run `lefthook run pre-commit` as final check (this runs fast hooks only; coverage was verified above).
 </workflow>
 
 <constraints>
@@ -65,5 +85,3 @@ Your priority is writing code that is clean, tested, and secure by default.
 - **NO CONVERSATION**: If the task is done, output "DONE". If you need info, ask the specific question.
 - **USE DIFFS**: When updating large files (>100 lines), use `sed` or `replace_string_in_file` tools if available. If re-writing the file, output ONLY the modified functions/blocks.
 </constraints>
-
-```

.github/agents/DevOps.agent.md

@@ -2,11 +2,12 @@
 name: 'DevOps'
 description: 'DevOps specialist for CI/CD pipelines, deployment debugging, and GitOps workflows focused on making deployments boring and reliable'
 argument-hint: 'The CI/CD or infrastructure task (e.g., "Debug failing GitHub Action workflow")'
-tools:
+tools: vscode/getProjectSetupInfo, vscode/installExtension, vscode/memory, vscode/runCommand, vscode/vscodeAPI, vscode/extensions, vscode/askQuestions, execute, read, edit, search, web, browser, github/add_comment_to_pending_review, github/add_issue_comment, github/add_reply_to_pull_request_comment, github/assign_copilot_to_issue, github/create_branch, github/create_or_update_file, github/create_pull_request, github/create_pull_request_with_copilot, github/create_repository, github/delete_file, github/fork_repository, github/get_commit, github/get_copilot_job_status, github/get_file_contents, github/get_label, github/get_latest_release, github/get_me, github/get_release_by_tag, github/get_tag, github/get_team_members, github/get_teams, github/issue_read, github/issue_write, github/list_branches, github/list_commits, github/list_issue_types, github/list_issues, github/list_pull_requests, github/list_releases, github/list_tags, github/merge_pull_request, github/pull_request_read, github/pull_request_review_write, github/push_files, github/request_copilot_review, github/search_code, github/search_issues, github/search_pull_requests, github/search_repositories, github/search_users, github/sub_issue_write, github/update_pull_request, github/update_pull_request_branch, playwright/*, github/*, io.github.goreleaser/mcp/*, mcp-refactor-typescript/*, microsoftdocs/mcp/*, vscode.mermaid-chat-features/renderMermaidDiagram, github.vscode-pull-request-github/issue_fetch, github.vscode-pull-request-github/labels_fetch, github.vscode-pull-request-github/notification_fetch, github.vscode-pull-request-github/doSearch, github.vscode-pull-request-github/activePullRequest, github.vscode-pull-request-github/pullRequestStatusChecks, github.vscode-pull-request-github/openPullRequest, ms-azuretools.vscode-containers/containerToolsConfig, ms-python.python/getPythonEnvironmentInfo, ms-python.python/getPythonExecutableCommand, ms-python.python/installPythonPackage, ms-python.python/configurePythonEnvironment, todo
-  ['execute', 'read', 'agent', 'github/*', 'github/*', 'io.github.goreleaser/mcp/*', 'edit/createDirectory', 'edit/createFile', 'edit/editFiles', 'edit/editNotebook', 'search', 'web', 'github/*', 'todo', 'ms-azuretools.vscode-containers/containerToolsConfig']
+
-model: 'Cloaude Sonnet 4.5'
+
-mcp-servers:
+target: vscode
-  - github
+user-invocable: true
+disable-model-invocation: false
 ---
 
 # GitOps & CI Specialist
@@ -135,6 +136,7 @@ main:
    - Look for error messages
    - Check timing (timeout vs crash)
    - Environment variables set correctly?
+    - If MCP web fetch lacks auth, pull workflow logs with `gh` CLI
 
 3. **Verify environment configuration**
    ```bash
@@ -248,5 +250,3 @@ git revert HEAD && git push
 ```
 
 Remember: The best deployment is one nobody notices. Automation, monitoring, and quick recovery are key.
-
-````

.github/agents/Doc_Writer.agent.md

@@ -2,11 +2,12 @@
 name: 'Docs Writer'
 description: 'User Advocate and Writer focused on creating simple, layman-friendly documentation.'
 argument-hint: 'The feature to document (e.g., "Write the guide for the new Real-Time Logs")'
-tools:
+tools: vscode/getProjectSetupInfo, vscode/installExtension, vscode/memory, vscode/runCommand, vscode/vscodeAPI, vscode/extensions, vscode/askQuestions, execute, read, edit, search, web, browser, github/add_comment_to_pending_review, github/add_issue_comment, github/add_reply_to_pull_request_comment, github/assign_copilot_to_issue, github/create_branch, github/create_or_update_file, github/create_pull_request, github/create_pull_request_with_copilot, github/create_repository, github/delete_file, github/fork_repository, github/get_commit, github/get_copilot_job_status, github/get_file_contents, github/get_label, github/get_latest_release, github/get_me, github/get_release_by_tag, github/get_tag, github/get_team_members, github/get_teams, github/issue_read, github/issue_write, github/list_branches, github/list_commits, github/list_issue_types, github/list_issues, github/list_pull_requests, github/list_releases, github/list_tags, github/merge_pull_request, github/pull_request_read, github/pull_request_review_write, github/push_files, github/request_copilot_review, github/search_code, github/search_issues, github/search_pull_requests, github/search_repositories, github/search_users, github/sub_issue_write, github/update_pull_request, github/update_pull_request_branch, playwright/*, github/*, io.github.goreleaser/mcp/*, mcp-refactor-typescript/*, microsoftdocs/mcp/*, vscode.mermaid-chat-features/renderMermaidDiagram, github.vscode-pull-request-github/issue_fetch, github.vscode-pull-request-github/labels_fetch, github.vscode-pull-request-github/notification_fetch, github.vscode-pull-request-github/doSearch, github.vscode-pull-request-github/activePullRequest, github.vscode-pull-request-github/pullRequestStatusChecks, github.vscode-pull-request-github/openPullRequest, ms-azuretools.vscode-containers/containerToolsConfig, ms-python.python/getPythonEnvironmentInfo, ms-python.python/getPythonExecutableCommand, ms-python.python/installPythonPackage, ms-python.python/configurePythonEnvironment, todo
-  ['read/getNotebookSummary', 'read/problems', 'read/readFile', 'read/readNotebookCellOutput', 'read/terminalSelection', 'read/terminalLastCommand', 'read/getTaskOutput', 'edit/createDirectory', 'edit/createFile', 'edit/editFiles', 'edit/editNotebook', 'search/changes', 'search/codebase', 'search/fileSearch', 'search/listDirectory', 'search/searchResults', 'search/textSearch', 'search/usages', 'search/searchSubagent', 'web/fetch', 'github/add_comment_to_pending_review', 'github/add_issue_comment', 'github/assign_copilot_to_issue', 'github/create_branch', 'github/create_or_update_file', 'github/create_pull_request', 'github/create_repository', 'github/delete_file', 'github/fork_repository', 'github/get_commit', 'github/get_file_contents', 'github/get_label', 'github/get_latest_release', 'github/get_me', 'github/get_release_by_tag', 'github/get_tag', 'github/get_team_members', 'github/get_teams', 'github/issue_read', 'github/issue_write', 'github/list_branches', 'github/list_commits', 'github/list_issue_types', 'github/list_issues', 'github/list_pull_requests', 'github/list_releases', 'github/list_tags', 'github/merge_pull_request', 'github/pull_request_read', 'github/pull_request_review_write', 'github/push_files', 'github/request_copilot_review', 'github/search_code', 'github/search_issues', 'github/search_pull_requests', 'github/search_repositories', 'github/search_users', 'github/sub_issue_write', 'github/update_pull_request', 'github/update_pull_request_branch', 'github/add_comment_to_pending_review', 'github/add_issue_comment', 'github/assign_copilot_to_issue', 'github/create_branch', 'github/create_or_update_file', 'github/create_pull_request', 'github/create_repository', 'github/delete_file', 'github/fork_repository', 'github/get_commit', 'github/get_file_contents', 'github/get_label', 'github/get_latest_release', 'github/get_me', 'github/get_release_by_tag', 'github/get_tag', 'github/get_team_members', 'github/get_teams', 'github/issue_read', 'github/issue_write', 'github/list_branches', 'github/list_commits', 'github/list_issue_types', 'github/list_issues', 'github/list_pull_requests', 'github/list_releases', 'github/list_tags', 'github/merge_pull_request', 'github/pull_request_read', 'github/pull_request_review_write', 'github/push_files', 'github/request_copilot_review', 'github/search_code', 'github/search_issues', 'github/search_pull_requests', 'github/search_repositories', 'github/search_users', 'github/sub_issue_write', 'github/update_pull_request', 'github/update_pull_request_branch', 'github/add_comment_to_pending_review', 'github/add_issue_comment', 'github/assign_copilot_to_issue', 'github/create_branch', 'github/create_or_update_file', 'github/create_pull_request', 'github/create_repository', 'github/delete_file', 'github/fork_repository', 'github/get_commit', 'github/get_file_contents', 'github/get_label', 'github/get_latest_release', 'github/get_me', 'github/get_release_by_tag', 'github/get_tag', 'github/get_team_members', 'github/get_teams', 'github/issue_read', 'github/issue_write', 'github/list_branches', 'github/list_commits', 'github/list_issue_types', 'github/list_issues', 'github/list_pull_requests', 'github/list_releases', 'github/list_tags', 'github/merge_pull_request', 'github/pull_request_read', 'github/pull_request_review_write', 'github/push_files', 'github/request_copilot_review', 'github/search_code', 'github/search_issues', 'github/search_pull_requests', 'github/search_repositories', 'github/search_users', 'github/sub_issue_write', 'github/update_pull_request', 'github/update_pull_request_branch', 'vscode.mermaid-chat-features/renderMermaidDiagram', 'todo']
+
-model: 'Cloaude Sonnet 4.5'
+
-mcp-servers:
+target: vscode
-  - github
+user-invocable: true
+disable-model-invocation: false
 ---
 You are a USER ADVOCATE and TECHNICAL WRITER for a self-hosted tool designed for beginners.
 Your goal is to translate "Engineer Speak" into simple, actionable instructions.

.github/agents/Frontend_Dev.agent.md

@@ -2,9 +2,13 @@
 name: 'Frontend Dev'
 description: 'Senior React/TypeScript Engineer for frontend implementation.'
 argument-hint: 'The frontend feature or component to implement (e.g., "Implement the Real-Time Logs dashboard component")'
-tools:
+tools: vscode/getProjectSetupInfo, vscode/installExtension, vscode/memory, vscode/runCommand, vscode/vscodeAPI, vscode/extensions, vscode/askQuestions, execute, read, edit, search, web, browser, github/add_comment_to_pending_review, github/add_issue_comment, github/add_reply_to_pull_request_comment, github/assign_copilot_to_issue, github/create_branch, github/create_or_update_file, github/create_pull_request, github/create_pull_request_with_copilot, github/create_repository, github/delete_file, github/fork_repository, github/get_commit, github/get_copilot_job_status, github/get_file_contents, github/get_label, github/get_latest_release, github/get_me, github/get_release_by_tag, github/get_tag, github/get_team_members, github/get_teams, github/issue_read, github/issue_write, github/list_branches, github/list_commits, github/list_issue_types, github/list_issues, github/list_pull_requests, github/list_releases, github/list_tags, github/merge_pull_request, github/pull_request_read, github/pull_request_review_write, github/push_files, github/request_copilot_review, github/search_code, github/search_issues, github/search_pull_requests, github/search_repositories, github/search_users, github/sub_issue_write, github/update_pull_request, github/update_pull_request_branch, playwright/*, github/*, io.github.goreleaser/mcp/*, mcp-refactor-typescript/*, microsoftdocs/mcp/*, vscode.mermaid-chat-features/renderMermaidDiagram, github.vscode-pull-request-github/issue_fetch, github.vscode-pull-request-github/labels_fetch, github.vscode-pull-request-github/notification_fetch, github.vscode-pull-request-github/doSearch, github.vscode-pull-request-github/activePullRequest, github.vscode-pull-request-github/pullRequestStatusChecks, github.vscode-pull-request-github/openPullRequest, ms-azuretools.vscode-containers/containerToolsConfig, ms-python.python/getPythonEnvironmentInfo, ms-python.python/getPythonExecutableCommand, ms-python.python/installPythonPackage, ms-python.python/configurePythonEnvironment, todo
-  ['vscode', 'execute', 'read', 'agent', 'edit/createDirectory', 'edit/createFile', 'edit/editFiles', 'edit/editNotebook', 'search', 'todo']
+
-model: 'Cloaude Sonnet 4.5'
+
+
+target: vscode
+user-invocable: true
+disable-model-invocation: false
 ---
 You are a SENIOR REACT/TYPESCRIPT ENGINEER with deep expertise in:
 - React 18+, TypeScript 5+, TanStack Query, TanStack Router
@@ -37,13 +41,15 @@ You are a SENIOR REACT/TYPESCRIPT ENGINEER with deep expertise in:
    - Add proper error boundaries and loading states
 
 3. **Testing**:
+   - **Run local patch preflight first**: Execute VS Code task `Test: Local Patch Report` or `bash scripts/local-patch-report.sh` before unit/coverage test runs.
+   - Confirm artifacts exist: `test-results/local-patch-report.md` and `test-results/local-patch-report.json`.
+   - Use the report's file-level uncovered list to prioritize frontend test additions.
    - Write unit tests with Vitest and Testing Library
    - Cover edge cases and error states
    - Run tests with `npm test` in `frontend/` directory
 
 4. **Quality Checks**:
-   - Run `npm run lint` to check for linting issues
+   - Run `lefthook run pre-commit` to ensure linting and formatting
-   - Run `npm run typecheck` for TypeScript errors
    - Ensure accessibility with proper ARIA attributes
 </workflow>
 

.github/agents/Management.agent.md

@@ -2,9 +2,13 @@
 name: 'Management'
 description: 'Engineering Director. Delegates ALL research and execution. DO NOT ask it to debug code directly.'
 argument-hint: 'The high-level goal (e.g., "Build the new Proxy Host Dashboard widget")'
-tools:
+
-  ['vscode', 'execute', 'read', 'agent', 'edit', 'search', 'web', 'github/*', 'github/*', 'github/*', 'io.github.goreleaser/mcp/*', 'playwright/*', 'trivy-mcp/*', 'playwright/*', 'vscode.mermaid-chat-features/renderMermaidDiagram', 'github.vscode-pull-request-github/issue_fetch', 'github.vscode-pull-request-github/suggest-fix', 'github.vscode-pull-request-github/searchSyntax', 'github.vscode-pull-request-github/doSearch', 'github.vscode-pull-request-github/renderIssues', 'github.vscode-pull-request-github/activePullRequest', 'github.vscode-pull-request-github/openPullRequest', 'ms-azuretools.vscode-containers/containerToolsConfig', 'todo']
+tools: vscode/extensions, vscode/getProjectSetupInfo, vscode/installExtension, vscode/memory, vscode/runCommand, vscode/vscodeAPI, vscode/askQuestions, execute, read, agent, edit, search, web, 'github/*', 'playwright/*', 'github/*', 'github/*', 'io.github.goreleaser/mcp/*', 'mcp-refactor-typescript/*', 'microsoftdocs/mcp/*', browser, vscode.mermaid-chat-features/renderMermaidDiagram, github.vscode-pull-request-github/issue_fetch, github.vscode-pull-request-github/labels_fetch, github.vscode-pull-request-github/notification_fetch, github.vscode-pull-request-github/doSearch, github.vscode-pull-request-github/activePullRequest, github.vscode-pull-request-github/pullRequestStatusChecks, github.vscode-pull-request-github/openPullRequest, ms-azuretools.vscode-containers/containerToolsConfig, ms-python.python/getPythonEnvironmentInfo, ms-python.python/getPythonExecutableCommand, ms-python.python/installPythonPackage, ms-python.python/configurePythonEnvironment, todo
-model: 'Cloaude Sonnet 4.5'
+
+
+target: vscode
+user-invocable: true
+disable-model-invocation: false
 ---
 You are the ENGINEERING DIRECTOR.
 **YOUR OPERATING MODEL: AGGRESSIVE DELEGATION.**
@@ -12,31 +16,34 @@ You are "lazy" in the smartest way possible. You never do what a subordinate can
 
 <global_context>
 
-1.  **MANDATORY**: Read all relevant instructions in `.github/instructions/` for the specific task before starting.
+1. **Initialize**: ALWAYS read `.github/instructions/copilot-instructions.md` first to load global project rules.
-2. **Initialize**: ALWAYS read `.github/copilot-instructions.md` first to load global project rules.
+2.  **MANDATORY**: Read all relevant instructions in `.github/instructions/**` for the specific task before starting.
-3. **Team Roster**:
+3. **Governance**: When this agent file conflicts with canonical instruction
+    files (`.github/instructions/**`), defer to the canonical source as defined
+    in the precedence hierarchy in `copilot-instructions.md`.
+4. **Team Roster**:
     - `Planning`: The Architect. (Delegate research & planning here).
     - `Supervisor`: The Senior Advisor. (Delegate plan review here).
-    - `Backend_Dev`: The Engineer. (Delegate Go implementation here).
+    - `Backend Dev`: The Engineer. (Delegate Go implementation here).
-    - `Frontend_Dev`: The Designer. (Delegate React implementation here).
+    - `Frontend Dev`: The Designer. (Delegate React implementation here).
-    - `QA_Security`: The Auditor. (Delegate verification and testing here).
+    - `QA Security`: The Auditor. (Delegate verification and testing here).
-    - `Docs_Writer`: The Scribe. (Delegate docs here).
+    - `Docs Writer`: The Scribe. (Delegate docs here).
     - `DevOps`: The Packager. (Delegate CI/CD and infrastructure here).
-    - `Playwright_Dev`: The E2E Specialist. (Delegate Playwright test creation and maintenance here).
+    - `Playwright Dev`: The E2E Specialist. (Delegate Playwright test creation and maintenance here).
-4. **Parallel Execution**:
+5. **Parallel Execution**:
     - You may delegate to `runSubagent` multiple times in parallel if tasks are independent. The only exception is `QA_Security`, which must run last as this validates the entire codebase after all changes.
-5. **Implementation Choices**:
+6. **Implementation Choices**:
-    - When faced with multiple implementation options, ALWAYS choose the "Prroper" fix over a "Quick" fix. This ensures long-term maintainability and saves double work. The "Quick" fix will only cause more work later when the "Proper" fix is eventually needed.
+    - When faced with multiple implementation options, ALWAYS choose the "Long Term" fix over a "Quick" fix. This ensures long-term maintainability and saves double work. The "Quick" fix will only cause more work later when the "Long Term" fix is eventually needed.
 </global_context>
 
 <workflow>
 
 1.  **Phase 1: Assessment and Delegation**:
-    -   **Read Instructions**: Read `.github/instructions` and `.github/Management.agent.md`.
+    -   **Read Instructions**: Read `.github/instructions` and `.github/agents/Management.agent.md`.
     -   **Identify Goal**: Understand the user's request.
     -   **STOP**: Do not look at the code. Do not run `list_dir`. No code is to be changed or implemented until there is a fundamentally sound plan of action that has been approved by the user.
     -   **Action**: Immediately call `Planning` subagent.
-        -   *Prompt*: "Research the necessary files for '{user_request}' and write a comprehensive plan detailing as many specifics as possible to `docs/plans/current_spec.md`. Be an artist with directions and discriptions. Include file names, function names, and component names wherever possible. Break the plan into phases based on the least amount of requests. Review and suggest updaetes to `.gitignore`, `codecov.yml`, `.dockerignore`, and `Dockerfile` if necessary. Return only when the plan is complete."
+        -   *Prompt*: "Research the necessary files for '{user_request}' and write a comprehensive plan detailing as many specifics as possible to `docs/plans/current_spec.md`. Be an artist with directions and discriptions. Include file names, function names, and component names wherever possible. Break the plan into phases based on the least amount of requests. Include a Commit Slicing Strategy section that organizes work into logical commits within a single PR — one feature = one PR, with ordered commits (Commit 1, Commit 2, …) each defining scope, files, dependencies, and validation gates. Review and suggest updaetes to `.gitignore`, `codecov.yml`, `.dockerignore`, and `Dockerfile` if necessary. Return only when the plan is complete."
     - **Task Specifics**:
         - If the task is to just run tests or audits, there is no need for a plan. Directly call `QA_Security` to perform the tests and write the report. If issues are found, return to `Planning` for a remediation plan and delegate the fixes to the corresponding subagents.
 
@@ -52,20 +59,28 @@ You are "lazy" in the smartest way possible. You never do what a subordinate can
     -   **Ask**: "Plan created. Shall I authorize the construction?"
 
 4. **Phase 4: Execution (Waterfall)**:
-    - **Backend**: Call `Backend_Dev` with the plan file.
+        - **Read Commit Slicing Strategy**: Read the Commit Slicing Strategy in `docs/plans/current_spec.md` to understand the ordered commits.
-    - **Frontend**: Call `Frontend_Dev` with the plan file.
+        - **Single PR, Multiple Commits**: All work ships as one PR. Each commit maps to a phase in the plan.
+            - **Backend**: Call `Backend_Dev` with the plan file.
+            - **Frontend**: Call `Frontend_Dev` with the plan file.
+        - Execute commits in dependency order. Each commit must pass its validation gates before the next commit begins.
+        - The PR is merged only when all commits are complete and all DoD gates pass.
+        - **MANDATORY**: Implementation agents must perform linting and type checks locally before declaring their commit "DONE". This is a critical step that must not be skipped to avoid broken commits and security issues.
 
 5. **Phase 5: Review**:
     - **Supervisor**: Call `Supervisor` to review the implementation against the plan. Provide feedback and ensure alignment with best practices.
 
 6. **Phase 6: Audit**:
-    - **QA**: Call `QA_Security` to meticulously test current implementation as well as regression test. Run all linting, security tasks, and manual pre-commit checks. Write a report to `docs/reports/qa_report.md`. Start back at Phase 1 if issues are found.
+    - Review Security: Read `security.md.instrutctions.md` and `SECURITY.md` to understand the security requirements and best practices for Charon. Ensure that any open concerns or issues are addressed in the QA Audit and `SECURITY.md` is updated accordingly.
+    - **QA**: Call `QA_Security` to meticulously test current implementation as well as regression test. Run all linting, security tasks, and manual lefthook checks. Write a report to `docs/reports/qa_report.md`. Start back at Phase 1 if issues are found.
 
 7. **Phase 7: Closure**:
     - **Docs**: Call `Docs_Writer`.
     - **Manual Testing**: create a new test plan in `docs/issues/*.md` for tracking manual testing focused on finding potential bugs of the implemented features.
     - **Final Report**: Summarize the successful subagent runs.
-    - **Commit Message**: Provide a copy and paste code block commit message at the END of the response on format laid out in `.github/instructions/commit-message.instructions.md`
+    - **Commit Roadmap**: Include a concise summary of completed and remaining commits within the PR.
+
+**Mandatory Commit Message**: When you reach a stopping point, provide a copy and paste code block commit message at the END of the response on format laid out in `.github/instructions/commit-message.instructions.md`
         - **STRICT RULES**:
             - ❌ DO NOT mention file names
             - ❌ DO NOT mention line counts (+10/-2)
@@ -127,12 +142,22 @@ fix: harden security suite integration test expectations
 The task is not complete until ALL of the following pass with zero issues:
 
 1. **Playwright E2E Tests (MANDATORY - Run First)**:
-    - **PREREQUISITE**: Rebuild E2E container before each test run:
+        - **PREREQUISITE**: Rebuild the E2E container when application or Docker build inputs change; skip rebuild for test-only changes if the container is already healthy:
-      ```bash
+            ```bash
-      .github/skills/scripts/skill-runner.sh docker-rebuild-e2e
+            .github/skills/scripts/skill-runner.sh docker-rebuild-e2e
-      ```
+            ```
       This ensures the container has latest code and proper environment variables (emergency token, encryption key from `.env`).
     - **Run**: `npx playwright test --project=chromium --project=firefox --project=webkit` from project root
+
+1.5. **GORM Security Scan (Conditional Gate)**:
+        - **Delegation Verification:** If implementation touched backend models
+            (`backend/internal/models/**`) or database-interaction paths
+            (GORM services, migrations), confirm `QA_Security` (or responsible
+            subagent) ran the GORM scanner using check mode (`--check`) and resolved
+            all CRITICAL/HIGH findings before accepting task completion
+        - **Manual Stage Clarification:** Scanner execution is manual
+            (not automated pre-commit), but enforcement is process-blocking for DoD
+            when triggered
     - **No Truncation**: Never pipe output through `head`, `tail`, or other truncating commands. Playwright requires user input to quit when piped, causing hangs.
     - **Why First**: If the app is broken at E2E level, unit tests may need updates. Catch integration issues early.
     - **Scope**: Run tests relevant to modified features (e.g., `tests/manual-dns-provider.spec.ts`)
@@ -146,14 +171,23 @@ The task is not complete until ALL of the following pass with zero issues:
     - **Why**: These are in manual stage of pre-commit for performance. Subagents MUST run them via VS Code tasks or scripts.
     - Minimum coverage: 85% for both backend and frontend.
     - All tests must pass with zero failures.
+    - **Outputs**: `backend/coverage.txt` and `frontend/coverage/lcov.info` — these are required inputs for step 3.
 
-3. **Type Safety (Frontend)**:
+3. **Local Patch Coverage Report (MANDATORY - After Coverage Tests)**:
+    - **Purpose**: Identify uncovered lines in files modified by this task so missing tests are written before declaring Done. This is the bridge between "overall coverage is fine" and "the actual lines I changed are tested."
+    - **Prerequisites**: `backend/coverage.txt` and `frontend/coverage/lcov.info` must exist (generated by step 2). If missing, run coverage tests first.
+    - **Run**: VS Code task `Test: Local Patch Report` or `bash scripts/local-patch-report.sh`.
+    - **Verify artifacts**: Both `test-results/local-patch-report.md` and `test-results/local-patch-report.json` must exist with non-empty results.
+    - **Act on findings**: If patch coverage for any changed file is below **90%**, delegate to the responsible agent (`Backend_Dev` or `Frontend_Dev`) to add targeted tests covering the uncovered lines. Re-run coverage (step 2) and this report until the threshold is met.
+    - **Blocking gate**: 90% overall patch coverage. Do not proceed to pre-commit or security scans until resolved or explicitly waived by the user.
+
+4. **Type Safety (Frontend)**:
     - Ensure `Frontend_Dev` ran VS Code task "Lint: TypeScript Check" or `npm run type-check`
     - **Why**: This check is in manual stage of pre-commit for performance. Subagents MUST run it explicitly.
 
-4. **Pre-commit Hooks**: Ensure `QA_Security` ran `pre-commit run --all-files` (fast hooks only; coverage was verified in step 2)
+5. **Pre-commit Hooks**: Ensure `QA_Security` ran `pre-commit run --all-files` (fast hooks only; coverage was verified in step 2)
 
-5. **Security Scans**: Ensure `QA_Security` ran the following with zero Critical or High severity issues:
+6. **Security Scans**: Ensure `QA_Security` ran the following with zero Critical or High severity issues:
    - **Trivy Filesystem Scan**: Fast scan of source code and dependencies
    - **Docker Image Scan (MANDATORY)**: Comprehensive scan of built Docker image
      - **Critical Gap**: This scan catches vulnerabilities that Trivy misses:
@@ -167,7 +201,9 @@ The task is not complete until ALL of the following pass with zero issues:
    - **CodeQL Scans**: Static analysis for Go and JavaScript
    - **QA_Security Requirements**: Must run BOTH Trivy and Docker Image scans, compare results, and block approval if image scan reveals additional vulnerabilities not caught by Trivy
 
-6. **Linting**: All language-specific linters must pass
+7. **Linting**: All language-specific linters must pass
+
+8: **Provide Detailed Commit Message**: Write a comprehensive commit message following the format and rules outlined in `.github/instructions/commit-message.instructions.md`. The message must be meaningful without viewing the diff and should explain the behavior changes, reasons for the change, and any important side effects or considerations.
 
 **Your Role**: You delegate implementation to subagents, but YOU are responsible for verifying they completed the Definition of Done. Do not accept "DONE" from a subagent until you have confirmed they ran coverage tests, type checks, and security scans explicitly.
 
@@ -179,5 +215,3 @@ The task is not complete until ALL of the following pass with zero issues:
 - **MANDATORY DELEGATION**: Your first thought should always be "Which agent handles this?", not "How do I solve this?"
 - **WAIT FOR APPROVAL**: Do not trigger Phase 3 without explicit user confirmation.
 </constraints>
-
-````

.github/agents/Planning.agent.md

@@ -2,12 +2,16 @@
 name: 'Planning'
 description: 'Principal Architect for technical planning and design decisions.'
 argument-hint: 'The feature or system to plan (e.g., "Design the architecture for Real-Time Logs")'
-tools:
+tools: vscode/getProjectSetupInfo, vscode/installExtension, vscode/memory, vscode/runCommand, vscode/vscodeAPI, vscode/extensions, vscode/askQuestions, execute, read, edit, search, web, browser, github/add_comment_to_pending_review, github/add_issue_comment, github/add_reply_to_pull_request_comment, github/assign_copilot_to_issue, github/create_branch, github/create_or_update_file, github/create_pull_request, github/create_pull_request_with_copilot, github/create_repository, github/delete_file, github/fork_repository, github/get_commit, github/get_copilot_job_status, github/get_file_contents, github/get_label, github/get_latest_release, github/get_me, github/get_release_by_tag, github/get_tag, github/get_team_members, github/get_teams, github/issue_read, github/issue_write, github/list_branches, github/list_commits, github/list_issue_types, github/list_issues, github/list_pull_requests, github/list_releases, github/list_tags, github/merge_pull_request, github/pull_request_read, github/pull_request_review_write, github/push_files, github/request_copilot_review, github/search_code, github/search_issues, github/search_pull_requests, github/search_repositories, github/search_users, github/sub_issue_write, github/update_pull_request, github/update_pull_request_branch, playwright/*, github/*, io.github.goreleaser/mcp/*, mcp-refactor-typescript/*, microsoftdocs/mcp/*, vscode.mermaid-chat-features/renderMermaidDiagram, github.vscode-pull-request-github/issue_fetch, github.vscode-pull-request-github/labels_fetch, github.vscode-pull-request-github/notification_fetch, github.vscode-pull-request-github/doSearch, github.vscode-pull-request-github/activePullRequest, github.vscode-pull-request-github/pullRequestStatusChecks, github.vscode-pull-request-github/openPullRequest, ms-azuretools.vscode-containers/containerToolsConfig, ms-python.python/getPythonEnvironmentInfo, ms-python.python/getPythonExecutableCommand, ms-python.python/installPythonPackage, ms-python.python/configurePythonEnvironment, todo
-  ['execute/runNotebookCell', 'execute/testFailure', 'execute/getTerminalOutput', 'execute/awaitTerminal', 'execute/killTerminal', 'execute/runTask', 'execute/createAndRunTask', 'execute/runTests', 'execute/runInTerminal', 'read/getNotebookSummary', 'read/problems', 'read/readFile', 'read/readNotebookCellOutput', 'read/terminalSelection', 'read/terminalLastCommand', 'read/getTaskOutput', 'agent/runSubagent', 'edit/createDirectory', 'edit/createFile', 'edit/createJupyterNotebook', 'edit/editFiles', 'edit/editNotebook', 'search/changes', 'search/codebase', 'search/fileSearch', 'search/listDirectory', 'search/searchResults', 'search/textSearch', 'search/usages', 'search/searchSubagent', 'web/fetch', 'github/add_comment_to_pending_review', 'github/add_issue_comment', 'github/assign_copilot_to_issue', 'github/create_branch', 'github/create_or_update_file', 'github/create_pull_request', 'github/create_repository', 'github/delete_file', 'github/fork_repository', 'github/get_commit', 'github/get_file_contents', 'github/get_label', 'github/get_latest_release', 'github/get_me', 'github/get_release_by_tag', 'github/get_tag', 'github/get_team_members', 'github/get_teams', 'github/issue_read', 'github/issue_write', 'github/list_branches', 'github/list_commits', 'github/list_issue_types', 'github/list_issues', 'github/list_pull_requests', 'github/list_releases', 'github/list_tags', 'github/merge_pull_request', 'github/pull_request_read', 'github/pull_request_review_write', 'github/push_files', 'github/request_copilot_review', 'github/search_code', 'github/search_issues', 'github/search_pull_requests', 'github/search_repositories', 'github/search_users', 'github/sub_issue_write', 'github/update_pull_request', 'github/update_pull_request_branch', 'github/add_comment_to_pending_review', 'github/add_issue_comment', 'github/assign_copilot_to_issue', 'github/create_branch', 'github/create_or_update_file', 'github/create_pull_request', 'github/create_repository', 'github/delete_file', 'github/fork_repository', 'github/get_commit', 'github/get_file_contents', 'github/get_label', 'github/get_latest_release', 'github/get_me', 'github/get_release_by_tag', 'github/get_tag', 'github/get_team_members', 'github/get_teams', 'github/issue_read', 'github/issue_write', 'github/list_branches', 'github/list_commits', 'github/list_issue_types', 'github/list_issues', 'github/list_pull_requests', 'github/list_releases', 'github/list_tags', 'github/merge_pull_request', 'github/pull_request_read', 'github/pull_request_review_write', 'github/push_files', 'github/request_copilot_review', 'github/search_code', 'github/search_issues', 'github/search_pull_requests', 'github/search_repositories', 'github/search_users', 'github/sub_issue_write', 'github/update_pull_request', 'github/update_pull_request_branch', 'github/add_comment_to_pending_review', 'github/add_issue_comment', 'github/assign_copilot_to_issue', 'github/create_branch', 'github/create_or_update_file', 'github/create_pull_request', 'github/create_repository', 'github/delete_file', 'github/fork_repository', 'github/get_commit', 'github/get_file_contents', 'github/get_label', 'github/get_latest_release', 'github/get_me', 'github/get_release_by_tag', 'github/get_tag', 'github/get_team_members', 'github/get_teams', 'github/issue_read', 'github/issue_write', 'github/list_branches', 'github/list_commits', 'github/list_issue_types', 'github/list_issues', 'github/list_pull_requests', 'github/list_releases', 'github/list_tags', 'github/merge_pull_request', 'github/pull_request_read', 'github/pull_request_review_write', 'github/push_files', 'github/request_copilot_review', 'github/search_code', 'github/search_issues', 'github/search_pull_requests', 'github/search_repositories', 'github/search_users', 'github/sub_issue_write', 'github/update_pull_request', 'github/update_pull_request_branch', 'vscode.mermaid-chat-features/renderMermaidDiagram', 'todo']
+
-model: 'Cloaude Sonnet 4.5'
+
-mcp-servers:
+
-  - github
+target: vscode
+user-invocable: true
+disable-model-invocation: false
+
 ---
+
 You are a PRINCIPAL ARCHITECT responsible for technical planning and system design.
 
 <context>
@@ -34,12 +38,18 @@ You are a PRINCIPAL ARCHITECT responsible for technical planning and system desi
    - Specify database schema changes
    - Document component interactions and data flow
    - Identify potential risks and mitigation strategies
+   - Determine commit sizing and how to organize work into logical commits within a single PR for safer and faster review
 
 3. **Documentation**:
    - Write plan to `docs/plans/current_spec.md`
    - Include acceptance criteria
    - Break down into implementable tasks using examples, diagrams, and tables
    - Estimate complexity for each component
+    - Add a **Commit Slicing Strategy** section with:
+       - Decision: single PR with ordered logical commits (one feature = one PR)
+       - Trigger reasons (scope, risk, cross-domain changes, review size)
+       - Ordered commits (`Commit 1`, `Commit 2`, ...), each with scope, files, dependencies, and validation gates
+       - Rollback and contingency notes for the PR as a whole
 
 4. **Handoff**:
    - Once plan is approved, delegate to `Supervisor` agent for review.
@@ -84,6 +94,7 @@ You are a PRINCIPAL ARCHITECT responsible for technical planning and system desi
 - **DETAILED SPECS**: Plans must include specific file paths, function signatures, and API schemas
 - **NO IMPLEMENTATION**: Do not write implementation code, only specifications
 - **CONSIDER EDGE CASES**: Document error handling and edge cases
+- **SLICE FOR SPEED**: Prefer multiple small PRs when it improves review quality, delivery speed, or rollback safety
 </constraints>
 
 ```

.github/agents/Playwright_Dev.agent.md

@@ -2,9 +2,14 @@
 name: 'Playwright Dev'
 description: 'E2E Testing Specialist for Playwright test automation.'
 argument-hint: 'The feature or flow to test (e.g., "Write E2E tests for the login flow")'
-tools:
+
-  ['vscode', 'execute', 'read', 'agent', 'playwright/*', 'edit/createDirectory', 'edit/createFile', 'edit/editFiles', 'edit/editNotebook', 'search', 'web', 'playwright/*', 'todo']
+tools: vscode/getProjectSetupInfo, vscode/installExtension, vscode/memory, vscode/runCommand, vscode/vscodeAPI, vscode/extensions, vscode/askQuestions, execute, read, edit, search, web, browser, github/add_comment_to_pending_review, github/add_issue_comment, github/add_reply_to_pull_request_comment, github/assign_copilot_to_issue, github/create_branch, github/create_or_update_file, github/create_pull_request, github/create_pull_request_with_copilot, github/create_repository, github/delete_file, github/fork_repository, github/get_commit, github/get_copilot_job_status, github/get_file_contents, github/get_label, github/get_latest_release, github/get_me, github/get_release_by_tag, github/get_tag, github/get_team_members, github/get_teams, github/issue_read, github/issue_write, github/list_branches, github/list_commits, github/list_issue_types, github/list_issues, github/list_pull_requests, github/list_releases, github/list_tags, github/merge_pull_request, github/pull_request_read, github/pull_request_review_write, github/push_files, github/request_copilot_review, github/search_code, github/search_issues, github/search_pull_requests, github/search_repositories, github/search_users, github/sub_issue_write, github/update_pull_request, github/update_pull_request_branch, playwright/*, github/*, io.github.goreleaser/mcp/*, mcp-refactor-typescript/*, microsoftdocs/mcp/*, vscode.mermaid-chat-features/renderMermaidDiagram, github.vscode-pull-request-github/issue_fetch, github.vscode-pull-request-github/labels_fetch, github.vscode-pull-request-github/notification_fetch, github.vscode-pull-request-github/doSearch, github.vscode-pull-request-github/activePullRequest, github.vscode-pull-request-github/pullRequestStatusChecks, github.vscode-pull-request-github/openPullRequest, ms-azuretools.vscode-containers/containerToolsConfig, ms-python.python/getPythonEnvironmentInfo, ms-python.python/getPythonExecutableCommand, ms-python.python/installPythonPackage, ms-python.python/configurePythonEnvironment, todo
-model: 'Cloaude Sonnet 4.5'
+
+
+
+target: vscode
+user-invocable: true
+disable-model-invocation: false
 ---
 You are a PLAYWRIGHT E2E TESTING SPECIALIST with expertise in:
 - Playwright Test framework
@@ -16,6 +21,7 @@ You do not write code, strictly tests. If code changes are needed, inform the Ma
 
 <context>
 
+- **MCP Server**: Use the Microsoft Playwright MCP server for all interactions with the codebase, including reading files, creating/editing files, and running commands. Do not use any other method to interact with the codebase.
 - **MANDATORY**: Read all relevant instructions in `.github/instructions/` for the specific task before starting.
 - **MANDATORY**: Follow `.github/instructions/playwright-typescript.instructions.md` for all test code
 - Architecture information: `ARCHITECTURE.md` and `.github/architecture.instructions.md`
@@ -27,10 +33,10 @@ You do not write code, strictly tests. If code changes are needed, inform the Ma
 <workflow>
 
 1. **MANDATORY: Start E2E Environment**:
-   - **ALWAYS rebuild the E2E container before running tests**:
+    - **Rebuild the E2E container when application or Docker build inputs change. For test-only changes, reuse the running container if healthy; rebuild only when the container is not running or state is suspect**:
-     ```bash
+       ```bash
-     .github/skills/scripts/skill-runner.sh docker-rebuild-e2e
+       .github/skills/scripts/skill-runner.sh docker-rebuild-e2e
-     ```
+       ```
    - This ensures the container has the latest code and proper environment variables
    - The container exposes: port 8080 (app), port 2020 (emergency), port 2019 (Caddy admin)
    - Verify container is healthy before proceeding
@@ -54,7 +60,13 @@ You do not write code, strictly tests. If code changes are needed, inform the Ma
    - Handle async operations correctly
 
 5. **Execution**:
-   - Run tests with `npx playwright test --project=chromium`
+   - Only run the entire test suite when necessary (e.g., after significant changes or to verify stability). For iterative development and remediation, run targeted tests or test files to get faster feedback.
+   - **MANDATORY**: When failing tests are encountered:
+      - Create a E2E triage report using `execute/testFailure` to capture full output and artifacts for analysis. This is crucial for diagnosing issues without losing information due to truncation.
+      - Use EARS for structured analysis of failures.
+      - Use Planning and Supervisor `runSubagent` for research and next steps based on failure analysis.
+      - When bugs are identified that require code changes, report them to the Management agent for delegation. DO NOT SKIP THE TEST. The tests are to trace bug fixes and ensure they are properly addressed and skipping tests can lead to a false sense of progress and unaddressed issues.
+   - Run tests with `cd /projects/Charon npx playwright test --project=firefox`
    - Use `test_failure` to analyze failures
    - Debug with headed mode if needed: `--headed`
    - Generate report: `npx playwright show-report`

.github/agents/QA_Security.agent.md

@@ -2,23 +2,28 @@
 name: 'QA Security'
 description: 'Quality Assurance and Security Engineer for testing and vulnerability assessment.'
 argument-hint: 'The component or feature to test (e.g., "Run security scan on authentication endpoints")'
-tools:
+tools: vscode/getProjectSetupInfo, vscode/installExtension, vscode/memory, vscode/runCommand, vscode/vscodeAPI, vscode/extensions, vscode/askQuestions, execute, read, edit, search, web, browser, github/add_comment_to_pending_review, github/add_issue_comment, github/add_reply_to_pull_request_comment, github/assign_copilot_to_issue, github/create_branch, github/create_or_update_file, github/create_pull_request, github/create_pull_request_with_copilot, github/create_repository, github/delete_file, github/fork_repository, github/get_commit, github/get_copilot_job_status, github/get_file_contents, github/get_label, github/get_latest_release, github/get_me, github/get_release_by_tag, github/get_tag, github/get_team_members, github/get_teams, github/issue_read, github/issue_write, github/list_branches, github/list_commits, github/list_issue_types, github/list_issues, github/list_pull_requests, github/list_releases, github/list_tags, github/merge_pull_request, github/pull_request_read, github/pull_request_review_write, github/push_files, github/request_copilot_review, github/search_code, github/search_issues, github/search_pull_requests, github/search_repositories, github/search_users, github/sub_issue_write, github/update_pull_request, github/update_pull_request_branch, playwright/*, github/*, io.github.goreleaser/mcp/*, mcp-refactor-typescript/*, microsoftdocs/mcp/*, vscode.mermaid-chat-features/renderMermaidDiagram, github.vscode-pull-request-github/issue_fetch, github.vscode-pull-request-github/labels_fetch, github.vscode-pull-request-github/notification_fetch, github.vscode-pull-request-github/doSearch, github.vscode-pull-request-github/activePullRequest, github.vscode-pull-request-github/pullRequestStatusChecks, github.vscode-pull-request-github/openPullRequest, ms-azuretools.vscode-containers/containerToolsConfig, ms-python.python/getPythonEnvironmentInfo, ms-python.python/getPythonExecutableCommand, ms-python.python/installPythonPackage, ms-python.python/configurePythonEnvironment, todo
-  ['vscode/extensions', 'vscode/getProjectSetupInfo', 'vscode/installExtension', 'vscode/openSimpleBrowser', 'vscode/runCommand', 'vscode/askQuestions', 'vscode/switchAgent', 'vscode/vscodeAPI', 'execute', 'read', 'agent', 'playwright/*', 'trivy-mcp/*', 'edit', 'search', 'web', 'playwright/*', 'todo']
+
-model: 'Cloaude Sonnet 4.5'
+
-mcp-servers:
+
-  - trivy-mcp
+target: vscode
-  - playwright
+user-invocable: true
+disable-model-invocation: false
 ---
 You are a QA AND SECURITY ENGINEER responsible for testing and vulnerability assessment.
 
 <context>
 
-- **MANDATORY**: Read all relevant instructions in `.github/instructions/` for the specific task before starting.
+- **Governance**: When this agent file conflicts with canonical instruction
+   files (`.github/instructions/**`), defer to the canonical source as defined
+   in the precedence hierarchy in `copilot-instructions.md`.
+- **MANDATORY**: Read all relevant instructions in `.github/instructions/**` for the specific task before starting.
+- **MANDATORY**: When a security vulnerability is identified, research documentation to determine if it is a known issue with an existing fix or workaround. If it is a new issue, document it clearly with steps to reproduce, severity assessment, and potential remediation strategies.
 - Charon is a self-hosted reverse proxy management tool
 - Backend tests: `.github/skills/test-backend-unit.SKILL.md`
 - Frontend tests: `.github/skills/test-frontend-react.SKILL.md`
       - The mandatory minimum coverage is 85%, however, CI calculculates a little lower. Shoot for 87%+ to be safe.
-- E2E tests: `npx playwright test --project=chromium --project=firefox --project=webkit`
+- E2E tests: The entire E2E suite takes a long time to run, so target specific suites/files based on the scope of changes and risk areas. Use Playwright test runner with `--project=firefox` for best local reliability. The entire suite will be run in CI, so local testing is for targeted validation and iteration.
 - Security scanning:
    - GORM: `.github/skills/security-scan-gorm.SKILL.md`
    - Trivy: `.github/skills/security-scan-trivy.SKILL.md`
@@ -27,26 +32,44 @@ You are a QA AND SECURITY ENGINEER responsible for testing and vulnerability ass
 
 <workflow>
 
-1. **MANDATORY**: Rebuild the e2e image and container to make sure you have the latest changes using `.github/skills/scripts/skill-runner.sh docker-rebuild-e2e`. Rebuild every time code changes are made before running tests again.
+1. **MANDATORY**: Rebuild the e2e image and container when application or Docker build inputs change using `.github/skills/scripts/skill-runner.sh docker-rebuild-e2e`. Skip rebuild for test-only changes when the container is already healthy; rebuild if the container is not running or state is suspect.
 
-2. **Test Analysis**:
+2. **Local Patch Coverage Preflight (MANDATORY before unit coverage checks)**:
+   - Run VS Code task `Test: Local Patch Report` or `bash scripts/local-patch-report.sh` from repo root.
+   - Verify both artifacts exist: `test-results/local-patch-report.md` and `test-results/local-patch-report.json`.
+   - Use file-level uncovered changed-line output to drive targeted unit-test recommendations.
+
+3. **Test Analysis**:
    - Review existing test coverage
    - Identify gaps in test coverage
    - Review test failure outputs with `test_failure` tool
 
-3. **Security Scanning**:
+4. **Security Scanning**:
+   - - Review Security: Read `security.md.instrutctions.md` and `SECURITY.md` to understand the security requirements and best practices for Charon. Ensure that any open concerns or issues are addressed in the QA Audit and `SECURITY.md` is updated accordingly.
+    - **Conditional GORM Scan**: When backend model/database-related changes are
+       in scope (`backend/internal/models/**`, GORM services, migrations), run
+       GORM scanner in check mode and report pass/fail as DoD gate:
+       - Run: VS Code task `Lint: GORM Security Scan` OR
+          `./scripts/scan-gorm-security.sh --check`
+       - Block approval on unresolved CRITICAL/HIGH findings
+    - **Gotify Token Review**: Verify no Gotify tokens appear in:
+       - Logs, test artifacts, screenshots
+       - API examples, report output
+       - Tokenized URL query strings (e.g., `?token=...`)
+       - Verify URL query parameters are redacted in
+          diagnostics/examples/log artifacts
    - Run Trivy scans on filesystem and container images
    - Analyze vulnerabilities with `mcp_trivy_mcp_findings_list`
    - Prioritize by severity (CRITICAL > HIGH > MEDIUM > LOW)
    - Document remediation steps
 
-4. **Test Implementation**:
+5. **Test Implementation**:
    - Write unit tests for uncovered code paths
    - Write integration tests for API endpoints
    - Write E2E tests for user workflows
    - Ensure tests are deterministic and isolated
 
-5. **Reporting**:
+6. **Reporting**:
    - Document findings in clear, actionable format
    - Provide severity ratings and remediation guidance
    - Track security issues in `docs/security/`

.github/agents/Supervisor.agent.md

@@ -2,11 +2,12 @@
 name: 'Supervisor'
 description: 'Code Review Lead for quality assurance and PR review.'
 argument-hint: 'The PR or code change to review (e.g., "Review PR #123 for security issues")'
-tools:
+tools: vscode/getProjectSetupInfo, vscode/installExtension, vscode/memory, vscode/runCommand, vscode/vscodeAPI, vscode/extensions, vscode/askQuestions, execute, read, edit, search, web, browser, github/add_comment_to_pending_review, github/add_issue_comment, github/add_reply_to_pull_request_comment, github/assign_copilot_to_issue, github/create_branch, github/create_or_update_file, github/create_pull_request, github/create_pull_request_with_copilot, github/create_repository, github/delete_file, github/fork_repository, github/get_commit, github/get_copilot_job_status, github/get_file_contents, github/get_label, github/get_latest_release, github/get_me, github/get_release_by_tag, github/get_tag, github/get_team_members, github/get_teams, github/issue_read, github/issue_write, github/list_branches, github/list_commits, github/list_issue_types, github/list_issues, github/list_pull_requests, github/list_releases, github/list_tags, github/merge_pull_request, github/pull_request_read, github/pull_request_review_write, github/push_files, github/request_copilot_review, github/search_code, github/search_issues, github/search_pull_requests, github/search_repositories, github/search_users, github/sub_issue_write, github/update_pull_request, github/update_pull_request_branch, playwright/*, github/*, io.github.goreleaser/mcp/*, mcp-refactor-typescript/*, microsoftdocs/mcp/*, vscode.mermaid-chat-features/renderMermaidDiagram, github.vscode-pull-request-github/issue_fetch, github.vscode-pull-request-github/labels_fetch, github.vscode-pull-request-github/notification_fetch, github.vscode-pull-request-github/doSearch, github.vscode-pull-request-github/activePullRequest, github.vscode-pull-request-github/pullRequestStatusChecks, github.vscode-pull-request-github/openPullRequest, ms-azuretools.vscode-containers/containerToolsConfig, ms-python.python/getPythonEnvironmentInfo, ms-python.python/getPythonExecutableCommand, ms-python.python/installPythonPackage, ms-python.python/configurePythonEnvironment, todo
-  ['vscode/memory', 'execute', 'read', 'search', 'web', 'github/*', 'todo']
+
-model: 'Cloaude Sonnet 4.5'
+
-mcp-servers:
+target: vscode
-  - github
+user-invocable: true
+disable-model-invocation: false
 ---
 You are a CODE REVIEW LEAD responsible for quality assurance and maintaining code standards.
 
@@ -14,8 +15,10 @@ You are a CODE REVIEW LEAD responsible for quality assurance and maintaining cod
 
 - **MANDATORY**: Read all relevant instructions in `.github/instructions/` for the specific task before starting.
 - Charon is a self-hosted reverse proxy management tool
+- The codebase includes Go for backend and TypeScript for frontend
 - Code style: Go follows `gofmt`, TypeScript follows ESLint config
 - Review guidelines: `.github/instructions/code-review-generic.instructions.md`
+   - Think "mature Saas product codebase with security-sensitive features and a high standard for code quality" over "open source project with varying contribution quality"
 - Security guidelines: `.github/instructions/security-and-owasp.instructions.md`
 </context>
 
@@ -31,7 +34,15 @@ You are a CODE REVIEW LEAD responsible for quality assurance and maintaining cod
    - Verify error handling is appropriate
    - Review for security vulnerabilities (OWASP Top 10)
    - Check for performance implications
+   - Ensure code is modular and reusable
+   - Verify tests cover the changes
    - Ensure tests cover the changes
+   - Use `suggest_fix` for minor issues
+   - Provide detailed feedback for major issues
+   - Reference specific lines and provide examples
+   - Distinguish between blocking issues and suggestions
+   - Be constructive and educational
+   - Always check for security implications and possible linting issues
    - Verify documentation is updated
 
 3. **Feedback**:

.github/instructions/ARCHITECTURE.instructions.md

@@ -8,20 +8,20 @@
 
 ## Table of Contents
 
-- [Overview](#overview)
+- Overview
-- [System Architecture](#system-architecture)
+- System Architecture
-- [Technology Stack](#technology-stack)
+- Technology Stack
-- [Directory Structure](#directory-structure)
+- Directory Structure
-- [Core Components](#core-components)
+- Core Components
-- [Security Architecture](#security-architecture)
+- Security Architecture
-- [Data Flow](#data-flow)
+- Data Flow
-- [Deployment Architecture](#deployment-architecture)
+- Deployment Architecture
-- [Development Workflow](#development-workflow)
+- Development Workflow
-- [Testing Strategy](#testing-strategy)
+- Testing Strategy
-- [Build & Release Process](#build--release-process)
+- Build & Release Process
-- [Extensibility](#extensibility)
+- Extensibility
-- [Known Limitations](#known-limitations)
+- Known Limitations
-- [Maintenance & Updates](#maintenance--updates)
+- Maintenance & Updates
 
 ---
 
@@ -122,15 +122,15 @@ graph TB
 
 | Component | Technology | Version | Purpose |
 |-----------|-----------|---------|---------|
-| **Language** | Go | 1.25.6 | Primary backend language |
+| **Language** | Go | 1.26.0 | Primary backend language |
 | **HTTP Framework** | Gin | Latest | Routing, middleware, HTTP handling |
 | **Database** | SQLite | 3.x | Embedded database |
 | **ORM** | GORM | Latest | Database abstraction layer |
-| **Reverse Proxy** | Caddy Server | 2.11.0-beta.2 | Embedded HTTP/HTTPS proxy |
+| **Reverse Proxy** | Caddy Server | 2.11.2 | Embedded HTTP/HTTPS proxy |
 | **WebSocket** | gorilla/websocket | Latest | Real-time log streaming |
 | **Crypto** | golang.org/x/crypto | Latest | Password hashing, encryption |
 | **Metrics** | Prometheus Client | Latest | Application metrics |
-| **Notifications** | Shoutrrr | Latest | Multi-platform alerts |
+| **Notifications** | Notify | Latest | Multi-platform alerts |
 | **Docker Client** | Docker SDK | Latest | Container discovery |
 | **Logging** | Logrus + Lumberjack | Latest | Structured logging with rotation |
 
@@ -751,7 +751,7 @@ COPY frontend/ ./
 RUN npm run build
 
 # Stage 2: Build backend
-FROM golang:1.25-bookworm AS backend-builder
+FROM golang:1.26-bookworm AS backend-builder
 WORKDIR /app/backend
 COPY backend/go.* ./
 RUN go mod download
@@ -858,7 +858,7 @@ services:
 
 1. **Prerequisites:**
    ```bash
-   - Go 1.25+ (backend development)
+   - Go 1.26+ (backend development)
    - Node.js 23+ and npm (frontend development)
    - Docker 24+ (E2E testing)
    - SQLite 3.x (database)
@@ -970,7 +970,7 @@ Closes #123
 **Execution:**
 ```bash
 # Run against Docker container
-npx playwright test --project=chromium
+cd /projects/Charon npx playwright test --project=firefox
 
 # Run with coverage (Vite dev server)
 .github/skills/scripts/skill-runner.sh test-e2e-playwright-coverage
@@ -1263,8 +1263,8 @@ docker exec charon /app/scripts/restore-backup.sh \
    - Future: Dynamic plugin loading for custom providers
 
 2. **Notification Channels:**
-   - Shoutrrr provides 40+ channels (Discord, Slack, Email, etc.)
+   - Notify provides multi-platform channels (Discord, Slack, Gotify, etc.)
-   - Custom channels via Shoutrrr service URLs
+   - Provider-based configuration with per-channel feature flags
 
 3. **Authentication Providers:**
    - Current: Local database authentication
@@ -1480,14 +1480,14 @@ graph TB
 
 ## Additional Resources
 
-- **[README.md](README.md)** - Project overview and quick start
+- README.md - Project overview and quick start
-- **[CONTRIBUTING.md](CONTRIBUTING.md)** - Contribution guidelines
+- CONTRIBUTING.md - Contribution guidelines
-- **[docs/features.md](docs/features.md)** - Detailed feature documentation
+- docs/features.md - Detailed feature documentation
-- **[docs/api.md](docs/api.md)** - REST API reference
+- docs/api.md - REST API reference
-- **[docs/database-schema.md](docs/database-schema.md)** - Database structure
+- docs/database-schema.md - Database structure
-- **[docs/cerberus.md](docs/cerberus.md)** - Security suite documentation
+- docs/cerberus.md - Security suite documentation
-- **[docs/getting-started.md](docs/getting-started.md)** - User guide
+- docs/getting-started.md - User guide
-- **[SECURITY.md](SECURITY.md)** - Security policy and vulnerability reporting
+- SECURITY.md - Security policy and vulnerability reporting
 
 ---
 

.github/instructions/copilot-instructions.md

@@ -17,6 +17,23 @@ Every session should improve the codebase, not just add to it. Actively refactor
 - **READABLE**: Maintain comments and clear naming for complex logic. Favor clarity over cleverness.
 - **CONVENTIONAL COMMITS**: Write commit messages using `feat:`, `fix:`, `chore:`, `refactor:`, or `docs:` prefixes.
 
+## Governance & Precedence
+
+When policy statements conflict across documentation sources, resolve using this precedence hierarchy:
+
+1. **Highest Precedence**: `.github/instructions/**` files (canonical source of truth)
+2. **Agent Overrides**: `.github/agents/**` files (agent-specific customizations)
+3. **Operator Documentation**: `SECURITY.md`, `docs/security.md`,
+   `docs/features/notifications.md` (user-facing guidance)
+
+**Reconciliation Rule**: When conflicts arise, the stricter security requirement
+wins. Update downstream documentation to match canonical text in
+`.github/instructions/**`.
+
+**Example**: If `.github/instructions/security.instructions.md` mandates token
+redaction but operator docs suggest logging is acceptable, token redaction
+requirement takes precedence and operator docs must be updated.
+
 ## 🚨 CRITICAL ARCHITECTURE RULES 🚨
 
 - **Single Frontend Source**: All frontend code MUST reside in `frontend/`. NEVER create `backend/frontend/` or any other nested frontend directory.
@@ -50,7 +67,7 @@ Before proposing ANY code change or fix, you must build a mental map of the feat
 
 - **Run**: `cd backend && go run ./cmd/api`.
 - **Test**: `go test ./...`.
-- **Static Analysis (BLOCKING)**: Fast linters run automatically on every commit via pre-commit hooks.
+- **Static Analysis (BLOCKING)**: Fast linters run automatically on every commit via lefthook pre-commit-phase hooks.
   - **Staticcheck errors MUST be fixed** - commits are BLOCKED until resolved
   - Manual run: `make lint-fast` or VS Code task "Lint: Staticcheck (Fast)"
   - Staticcheck-only: `make lint-staticcheck-only`
@@ -62,7 +79,7 @@ Before proposing ANY code change or fix, you must build a mental map of the feat
 - **Security**: Sanitize all file paths using `filepath.Clean`. Use `fmt.Errorf("context: %w", err)` for error wrapping.
 - **Graceful Shutdown**: Long-running work must respect `server.Run(ctx)`.
 
-### Troubleshooting Pre-Commit Staticcheck Failures
+### Troubleshooting Lefthook Staticcheck Failures
 
 **Common Issues:**
 
@@ -123,28 +140,64 @@ Before proposing ANY code change or fix, you must build a mental map of the feat
 - **Beta**: `feature/beta-release` always builds.
 - **History-Rewrite PRs**: If a PR touches files in `scripts/history-rewrite/` or `docs/plans/history_rewrite.md`, the PR description MUST include the history-rewrite checklist from `.github/PULL_REQUEST_TEMPLATE/history-rewrite.md`. This is enforced by CI.
 
+## PR Sizing & Decomposition
+
+- **Default Rule**: Prefer smaller, reviewable PRs over one large PR when work spans multiple domains.
+- **Split into Multiple PRs When**:
+    - The change touches backend + frontend + infrastructure/security in one effort
+    - The estimated diff is large enough to reduce review quality or increase rollback risk
+    - The work can be delivered in independently testable slices without breaking behavior
+    - A foundational refactor is needed before feature delivery
+- **Suggested PR Sequence**:
+    1. Foundation PR (types/contracts/refactors, no behavior change)
+    2. Backend PR (API/model/service changes + tests)
+    3. Frontend PR (UI integration + tests)
+    4. Hardening PR (security/CI/docs/follow-up fixes)
+- **Per-PR Requirement**: Every PR must remain deployable, pass DoD checks, and include a clear dependency note on prior PRs.
+
 ## ✅ Task Completion Protocol (Definition of Done)
 
 Before marking an implementation task as complete, perform the following in order:
 
 1. **Playwright E2E Tests** (MANDATORY - Run First):
-    - **Run**: `npx playwright test --project=chromium` from project root
+    - **Run**: `cd /projects/Charon npx playwright test --project=firefox` from project root
     - **Why First**: If the app is broken at E2E level, unit tests may need updates. Catch integration issues early.
     - **Scope**: Run tests relevant to modified features (e.g., `tests/manual-dns-provider.spec.ts`)
     - **On Failure**: Trace root cause through frontend → backend flow before proceeding
     - **Base URL**: Uses `PLAYWRIGHT_BASE_URL` or default from `playwright.config.js`
     - All E2E tests must pass before proceeding to unit tests
 
-2. **Security Scans** (MANDATORY - Zero Tolerance):
+1.5. **GORM Security Scan** (CONDITIONAL, BLOCKING):
-    - **CodeQL Go Scan**: Run VS Code task "Security: CodeQL Go Scan (CI-Aligned)" OR `pre-commit run codeql-go-scan --all-files`
+    - **Trigger Condition**: Execute this gate when changes include backend models or database interaction logic:
+        - `backend/internal/models/**`
+        - GORM query/service layers
+        - Database migrations or seeding logic
+    - **Exclusions**: Skip this gate for docs-only (`**/*.md`) or frontend-only (`frontend/**`) changes
+    - **Run One Of**:
+        - VS Code task: `Lint: GORM Security Scan`
+        - Lefthook: `lefthook run pre-commit` (includes gorm-security-scan)
+        - Direct: `./scripts/scan-gorm-security.sh --check`
+        - **Gate Enforcement**: DoD is process-blocking until scanner reports zero
+            CRITICAL/HIGH findings, even while automation remains in manual stage
+        - **Check Mode Required**: Gate decisions must use check mode semantics
+            (`--check` flag or equivalent task wiring) for pass/fail determination
+
+2. **Local Patch Coverage Preflight** (MANDATORY - Run Before Unit/Coverage Tests):
+    - **Run**: VS Code task `Test: Local Patch Report` or `bash scripts/local-patch-report.sh` from repo root.
+    - **Purpose**: Surface exact changed files and uncovered changed lines before adding/refining unit tests.
+    - **Required Artifacts**: `test-results/local-patch-report.md` and `test-results/local-patch-report.json`.
+    - **Expected Behavior**: Report may warn (non-blocking rollout), but artifact generation is mandatory.
+
+3. **Security Scans** (MANDATORY - Zero Tolerance):
+    - **CodeQL Go Scan**: Run VS Code task "Security: CodeQL Go Scan (CI-Aligned)" OR `lefthook run pre-commit`
         - Must use `security-and-quality` suite (CI-aligned)
         - **Zero high/critical (error-level) findings allowed**
         - Medium/low findings should be documented and triaged
-    - **CodeQL JS Scan**: Run VS Code task "Security: CodeQL JS Scan (CI-Aligned)" OR `pre-commit run codeql-js-scan --all-files`
+    - **CodeQL JS Scan**: Run VS Code task "Security: CodeQL JS Scan (CI-Aligned)" OR `lefthook run pre-commit`
         - Must use `security-and-quality` suite (CI-aligned)
         - **Zero high/critical (error-level) findings allowed**
         - Medium/low findings should be documented and triaged
-    - **Validate Findings**: Run `pre-commit run codeql-check-findings --all-files` to check for HIGH/CRITICAL issues
+    - **Validate Findings**: Run `lefthook run pre-commit` to check for HIGH/CRITICAL issues
     - **Trivy Container Scan**: Run VS Code task "Security: Trivy Scan" for container/dependency vulnerabilities
     - **Results Viewing**:
         - Primary: VS Code SARIF Viewer extension (`MS-SarifVSCode.sarif-viewer`)
@@ -157,12 +210,12 @@ Before marking an implementation task as complete, perform the following in orde
         - Database creation: `--threads=0 --overwrite`
         - Analysis: `--sarif-add-baseline-file-info`
 
-3. **Pre-Commit Triage**: Run `pre-commit run --all-files`.
+4. **Lefthook Triage**: Run `lefthook run pre-commit`.
     - If errors occur, **fix them immediately**.
     - If logic errors occur, analyze and propose a fix.
     - Do not output code that violates pre-commit standards.
 
-4. **Staticcheck BLOCKING Validation**: Pre-commit hooks automatically run fast linters including staticcheck.
+5. **Staticcheck BLOCKING Validation**: Pre-commit hooks automatically run fast linters including staticcheck.
     - **CRITICAL:** Staticcheck errors are BLOCKING - you MUST fix them before commit succeeds.
     - Manual verification: Run VS Code task "Lint: Staticcheck (Fast)" or `make lint-fast`
     - To check only staticcheck: `make lint-staticcheck-only`
@@ -170,8 +223,9 @@ Before marking an implementation task as complete, perform the following in orde
     - If pre-commit fails: Fix the reported issues, then retry commit
     - **Do NOT** use `--no-verify` to bypass this check unless emergency hotfix
 
-5. **Coverage Testing** (MANDATORY - Non-negotiable):
+6. **Coverage Testing** (MANDATORY - Non-negotiable):
-    - **MANDATORY**: Patch coverage must cover 100% of modified lines (Codecov Patch view must be green). If patch coverage fails, add targeted tests for the missing patch line ranges.
+    - **Overall Coverage**: Minimum 85% coverage is MANDATORY and will fail the PR if not met.
+    - **Patch Coverage**: Developers should aim for 100% coverage of modified lines (Codecov Patch view). If patch coverage is incomplete, add targeted tests. However, patch coverage is a suggestion and will not block PR approval.
     - **Backend Changes**: Run the VS Code task "Test: Backend with Coverage" or execute `scripts/go-test-coverage.sh`.
         - Minimum coverage: 85% (set via `CHARON_MIN_COVERAGE` or `CPM_MIN_COVERAGE`).
         - If coverage drops below threshold, write additional tests to restore coverage.
@@ -183,21 +237,21 @@ Before marking an implementation task as complete, perform the following in orde
     - **Critical**: Coverage tests are NOT run by default pre-commit hooks (they are in manual stage for performance). You MUST run them explicitly via VS Code tasks or scripts before completing any task.
     - **Why**: CI enforces coverage in GitHub Actions. Local verification prevents CI failures and maintains code quality.
 
-6. **Type Safety** (Frontend only):
+7. **Type Safety** (Frontend only):
     - Run the VS Code task "Lint: TypeScript Check" or execute `cd frontend && npm run type-check`.
     - Fix all type errors immediately. This is non-negotiable.
     - This check is also in manual stage for performance but MUST be run before completion.
 
-7. **Verify Build**: Ensure the backend compiles and the frontend builds without errors.
+8. **Verify Build**: Ensure the backend compiles and the frontend builds without errors.
     - Backend: `cd backend && go build ./...`
     - Frontend: `cd frontend && npm run build`
 
-8. **Fixed and New Code Testing**:
+9. **Fixed and New Code Testing**:
     - Ensure all existing and new unit tests pass with zero failures.
     - When failures and errors are found, deep-dive into root causes. Using the correct `subAgent`, update the working plan, review the implementation, and fix the issues.
     - No issue is out of scope for investigation and resolution. All issues must be addressed before task completion.
 
-9. **Clean Up**: Ensure no debug print statements or commented-out blocks remain.
+10. **Clean Up**: Ensure no debug print statements or commented-out blocks remain.
     - Remove `console.log`, `fmt.Println`, and similar debugging statements.
     - Delete commented-out code blocks.
     - Remove unused imports.

.github/instructions/documentation-coding-best-practices.instructions.md

@@ -0,0 +1,43 @@
+---
+description: This file describes the documentation and coding best practices for the project.
+applyTo: '*'
+---
+
+
+# Documentation & Coding Best Practices
+
+The following instructions govern how you should generate and update documentation and code. These rules are absolute.
+
+## 1. Zero-Footprint Attribution (The Ghostwriter Rule)
+* **No AI Branding:** You are a ghostwriter. You must **NEVER** add sections titled "AI Notes," "Generated by," "Model Commentary," or "LLM Analysis."
+* **Invisible Editing:** The documentation must appear as if written 100% by the project maintainer. Do not leave "scars" or meta-tags indicating an AI touched the file.
+* **The "Author" Field:** * **Existing Files:** NEVER modify an existing `Author` field.
+    * **New Files:** Do NOT add an `Author` field unless explicitly requested.
+    * **Strict Prohibition:** You are strictly forbidden from placing "GitHub Copilot," "AI," "Assistant," or your model name in any `Author`, `Credits`, or `Contributor` field.
+
+## 2. Documentation Style
+* **Direct & Professional:** The documentation itself is the "note." Do not add a separate preamble or postscript explaining what you wrote.
+* **No Conversational Filler:** When asked to generate documentation, output *only* the documentation content. Do not wrap it in "Here is the updated file:" or "I have added the following..."
+* **Maintenance:** When updating a file, respect the existing formatting style (headers, indentation, bullet points) perfectly. Do not "fix" style choices unless they are actual syntax errors.
+* **Consistency:** Follow the existing style of the file. If the file uses a specific format for sections, maintain that format. Do not introduce new formatting styles.
+* **Clarity & Brevity:** Be concise and clear. Avoid unnecessary verbosity or overly technical jargon unless the file's existing style is already very technical. Match the tone and complexity of the existing documentation.
+
+## 3. Interaction Constraints
+* **Calm & Concise:** Be succinct. Do not offer unsolicited advice or "bonus" refactoring unless it is critical for security.
+* **Context Retention:** Assume the user knows what they are doing. Do not explain basic concepts unless asked.
+* **No Code Generation in Documentation Files:** When editing documentation files, do not generate code snippets unless they are explicitly requested. Focus on the documentation content itself.
+* **No Meta-Comments:** Do not include comments about the editing process, your thought process, or any "notes to self" in the documentation. The output should be clean and ready for use.
+* **Respect User Intent:** If the user asks for a specific change, do only that change. Do not add additional edits or improvements unless they are critical for security or correctness.
+* **No "Best Practices" Sections:** Do not add sections titled "Best Practices," "Recommendations," or "Guidelines" unless the existing file already has such a section. If the file does not have such a section, do not create one.
+* **No "Next Steps" or "Further Reading":** Do not add sections that suggest next steps, further reading, or related topics unless the existing file already includes such sections.
+* **No Personalization:** Do not personalize the documentation with phrases like "As a developer, you should..." or "In this project, we recommend..." Keep the tone neutral and professional.
+* **No Apologies or Uncertainty:** Do not include phrases like "I hope this helps," "Sorry for the confusion," or "Please let me know if you have any questions." The documentation should be authoritative and confident.
+* **No Redundant Information:** Do not include information that is already clearly stated in the existing documentation. Avoid redundancy.
+* **No Unsolicited Refactoring:** Do not refactor existing documentation for style or clarity unless it contains critical errors. Focus on the specific changes requested by the user.
+* **No "Summary" or "Overview" Sections:** Do not add summary or overview sections unless the existing file already has them. If the file does not have such sections, do not create them.
+* **No "How It Works" Sections:** Do not add sections explaining how the code works unless the existing documentation already includes such sections. If the file does not have such sections, do not create them.
+* **No "Use Cases" or "Examples":** Do not add use cases, examples, or case studies unless the existing documentation already has such sections. If the file does not have such sections, do not create them.
+* **No "Troubleshooting" Sections:** Do not add troubleshooting sections unless the existing documentation already includes them. Toubleshooting is its own section of the docs and should not be added ad-hoc to unrelated files.
+* **No "FAQ" Sections:** Do not add FAQ sections unless the existing documentation already has them. If the file does not have such sections, do not create them.
+* **No "Contact" or "Support" Sections:** Do not add contact information, support channels, or similar sections unless the existing documentation already includes them. If the file does not have such sections, do not create them.
+* **No "Contributing" Sections:** Contributing has its on documentation file. Do not add contributing guidelines to unrelated documentation files unless they already have such sections.

.github/instructions/github-actions-ci-cd-best-practices.instructions.md

@@ -502,6 +502,8 @@ This checklist provides a granular set of criteria for reviewing GitHub Actions
 
 This section provides an expanded guide to diagnosing and resolving frequent problems encountered when working with GitHub Actions workflows.
 
+Note: If workflow logs are not accessible via MCP web fetch due to missing auth, retrieve logs with the authenticated `gh` CLI.
+
 ### **1. Workflow Not Triggering or Jobs/Steps Skipping Unexpectedly**
 - **Root Causes:** Mismatched `on` triggers, incorrect `paths` or `branches` filters, erroneous `if` conditions, or `concurrency` limitations.
 - **Actionable Steps:**

.github/instructions/go.instructions.md

@@ -353,7 +353,7 @@ Follow idiomatic Go practices and community standards when writing Go code. Thes
 ### Development Practices
 
 - Run tests before committing
-- Use pre-commit hooks for formatting and linting
+- Use lefthook pre-commit-phase hooks for formatting and linting
 - Keep commits focused and atomic
 - Write meaningful commit messages
 - Review diffs before committing

.github/instructions/html-css-style-color-guide.instructions.md

@@ -0,0 +1,104 @@
+---
+description: 'Color usage guidelines and styling rules for HTML elements to ensure accessible, professional designs.'
+applyTo: '**/*.html, **/*.css, **/*.js'
+---
+
+# HTML CSS Style Color Guide
+
+Follow these guidelines when updating or creating HTML/CSS styles for browser rendering. Color names
+represent the full spectrum of their respective hue ranges (e.g., "blue" includes navy, sky blue, etc.).
+
+## Color Definitions
+
+- **Hot Colors**: Oranges, reds, and yellows
+- **Cool Colors**: Blues, greens, and purples
+- **Neutral Colors**: Grays and grayscale variations
+- **Binary Colors**: Black and white
+- **60-30-10 Rule**
+  - **Primary Color**: Use 60% of the time (*cool or light color*)
+  - **Secondary Color**: Use 30% of the time (*cool or light color*)
+  - **Accent**: Use 10% of the time (*complementary hot color*)
+
+## Color Usage Guidelines
+
+Balance the colors used by applying the **60-30-10 rule** to graphic design elements like backgrounds,
+buttons, cards, etc...
+
+### Background Colors
+
+**Never Use:**
+
+- Purple or magenta
+- Red, orange, or yellow
+- Pink
+- Any hot color
+
+**Recommended:**
+
+- White or off-white
+- Light cool colors (e.g., light blues, light greens)
+- Subtle neutral tones
+- Light gradients with minimal color shift
+
+### Text Colors
+
+**Never Use:**
+
+- Yellow (poor contrast and readability)
+- Pink
+- Pure white or light text on light backgrounds
+- Pure black or dark text on dark backgrounds
+
+**Recommended:**
+
+- Dark neutral colors (e.g., #1f2328, #24292f)
+- Near-black variations (#000000 to #333333)
+  - Ensure background is a light color
+- Dark grays (#4d4d4d, #6c757d)
+- High-contrast combinations for accessibility
+- Near-white variations (#ffffff to #f0f2f3)
+  - Ensure background is a dark color
+
+### Colors to Avoid
+
+Unless explicitly required by design specifications or user request, avoid:
+
+- Bright purples and magentas
+- Bright pinks and neon colors
+- Highly saturated hot colors
+- Colors with low contrast ratios (fails WCAG accessibility standards)
+
+### Colors to Use Sparingly
+
+**Hot Colors** (red, orange, yellow):
+
+- Reserve for critical alerts, warnings, or error messages
+- Use only when conveying urgency or importance
+- Limit to small accent areas rather than large sections
+- Consider alternatives like icons or bold text before using hot colors
+
+## Gradients
+
+Apply gradients with subtle color transitions to maintain professional aesthetics.
+
+### Best Practices
+
+- Keep color shifts minimal (e.g., #E6F2FF to #F5F7FA)
+- Use gradients within the same color family
+- Avoid combining hot and cool colors in a single gradient
+- Prefer linear gradients over radial for backgrounds
+
+### Appropriate Use Cases
+
+- Background containers and sections
+- Button hover states and interactive elements
+- Drop shadows and depth effects
+- Header and navigation bars
+- Card components and panels
+
+## Additional Resources
+
+- [Color Tool](https://civicactions.github.io/uswds-color-tool/)
+- [Government or Professional Color Standards](https://designsystem.digital.gov/design-tokens/color/overview/)
+- [UI Color Palette Best Practices](https://www.interaction-design.org/literature/article/ui-color-palette)
+- [Color Combination Resource](https://www.figma.com/resource-library/color-combinations/)

.github/instructions/markdown.instructions.md

@@ -24,7 +24,7 @@ Follow these guidelines for formatting and structuring your markdown content:
 - **Headings**: Use `##` for H2 and `###` for H3. Ensure that headings are used in a hierarchical manner. Recommend restructuring if content includes H4, and more strongly recommend for H5.
 - **Lists**: Use `-` for bullet points and `1.` for numbered lists. Indent nested lists with two spaces.
 - **Code Blocks**: Use triple backticks (`) to create fenced code blocks. Specify the language after the opening backticks for syntax highlighting (e.g., `csharp).
-- **Links**: Use `[link text](URL)` for links. Ensure that the link text is descriptive and the URL is valid.
+- **Links**: Use `[link text](https://example.com)` for links. Ensure that the link text is descriptive and the URL is valid.
 - **Images**: Use `![alt text](image URL)` for images. Include a brief description of the image in the alt text.
 - **Tables**: Use `|` to create tables. Ensure that columns are properly aligned and headers are included.
 - **Line Length**: Break lines at 80 characters to improve readability. Use soft line breaks for long paragraphs.
@@ -37,13 +37,8 @@ Ensure compliance with the following validation requirements:
 - **Front Matter**: Include the following fields in the YAML front matter:
 
   - `post_title`: The title of the post.
-  - `author1`: The primary author of the post.
-  - `post_slug`: The URL slug for the post.
-  - `microsoft_alias`: The Microsoft alias of the author.
-  - `featured_image`: The URL of the featured image.
   - `categories`: The categories for the post. These categories must be from the list in /categories.txt.
   - `tags`: The tags for the post.
-  - `ai_note`: Indicate if AI was used in the creation of the post.
   - `summary`: A brief summary of the post. Recommend a summary based on the content when possible.
   - `post_date`: The publication date of the post.
 

.github/instructions/playwright-typescript.instructions.md

@@ -9,7 +9,6 @@ applyTo: '**'
 - **Locators**: Prioritize user-facing, role-based locators (`getByRole`, `getByLabel`, `getByText`, etc.) for resilience and accessibility. Use `test.step()` to group interactions and improve test readability and reporting.
 - **Assertions**: Use auto-retrying web-first assertions. These assertions start with the `await` keyword (e.g., `await expect(locator).toHaveText()`). Avoid `expect(locator).toBeVisible()` unless specifically testing for visibility changes.
 - **Timeouts**: Rely on Playwright's built-in auto-waiting mechanisms. Avoid hard-coded waits or increased default timeouts.
-- **Switch/Toggle Components**: Use helper functions from `tests/utils/ui-helpers.ts` (`clickSwitch`, `expectSwitchState`, `toggleSwitch`) for reliable interactions. Never use `{ force: true }` or direct clicks on hidden inputs.
 - **Clarity**: Use descriptive test and step titles that clearly state the intent. Add comments only to explain complex logic or non-obvious interactions.
 
 
@@ -30,123 +29,6 @@ applyTo: '**'
 - **Element Counts**: Use `toHaveCount` to assert the number of elements found by a locator.
 - **Text Content**: Use `toHaveText` for exact text matches and `toContainText` for partial matches.
 - **Navigation**: Use `toHaveURL` to verify the page URL after an action.
-- **Switch States**: Use `expectSwitchState(locator, boolean)` to verify toggle states. This is more reliable than `toBeChecked()` directly.
-
-### Switch/Toggle Interaction Patterns
-
-Switch components use a hidden `<input>` with styled siblings, requiring special handling:
-
-```typescript
-import { clickSwitch, expectSwitchState, toggleSwitch } from './utils/ui-helpers';
-
-// ✅ RECOMMENDED: Click switch with helper
-const aclSwitch = page.getByRole('switch', { name: /acl/i });
-await clickSwitch(aclSwitch);
-
-// ✅ RECOMMENDED: Assert switch state
-await expectSwitchState(aclSwitch, true); // Checked
-
-// ✅ RECOMMENDED: Toggle and verify state change
-const newState = await toggleSwitch(aclSwitch);
-console.log(`Switch is now ${newState ? 'enabled' : 'disabled'}`);
-
-// ❌ AVOID: Direct click on hidden input
-await aclSwitch.click(); // May fail in WebKit/Firefox
-
-// ❌ AVOID: Force clicking (anti-pattern)
-await aclSwitch.click({ force: true }); // Bypasses real user behavior
-
-// ❌ AVOID: Hard-coded waits
-await page.waitForTimeout(500); // Non-deterministic, slows tests
-```
-
-**When to Use**:
-- Settings pages with enable/disable toggles
-- Security dashboard module switches (CrowdSec, ACL, WAF, Rate Limiting)
-- Access lists and configuration toggles
-- Any UI component using the `Switch` primitive from shadcn/ui
-
-**References**:
-- [Helper Implementation](../../tests/utils/ui-helpers.ts)
-- [QA Report](../../docs/reports/qa_report.md)
-
-### Testing Scope: E2E vs Integration
-
-**CRITICAL:** Playwright E2E tests verify **UI/UX functionality** on the Charon management interface (port 8080). They should NOT test middleware enforcement behavior.
-
-#### What E2E Tests SHOULD Cover
-
-✅ **User Interface Interactions:**
-- Form submissions and validation
-- Navigation and routing
-- Visual state changes (toggles, badges, status indicators)
-- Authentication flows (login, logout, session management)
-- CRUD operations via the management API
-- Responsive design (mobile vs desktop layouts)
-- Accessibility (ARIA labels, keyboard navigation)
-
-✅ **Example E2E Assertions:**
-```typescript
-// GOOD: Testing UI state
-await expect(aclToggle).toBeChecked();
-await expect(statusBadge).toHaveText('Active');
-await expect(page).toHaveURL('/proxy-hosts');
-
-// GOOD: Testing API responses in management interface
-const response = await request.post('/api/v1/proxy-hosts', { data: hostConfig });
-expect(response.ok()).toBeTruthy();
-```
-
-#### What E2E Tests should NOT Cover
-
-❌ **Middleware Enforcement Behavior:**
-- Rate limiting blocking requests (429 responses)
-- ACL denying access based on IP rules (403 responses)
-- WAF blocking malicious payloads (SQL injection, XSS)
-- CrowdSec IP bans
-
-❌ **Example Wrong E2E Assertions:**
-```typescript
-// BAD: Testing middleware behavior (rate limiting)
-for (let i = 0; i < 6; i++) {
-  await request.post('/api/v1/emergency/reset');
-}
-expect(response.status()).toBe(429); // ❌ This tests Caddy middleware
-
-// BAD: Testing WAF blocking
-await request.post('/api/v1/data', { data: "'; DROP TABLE users--" });
-expect(response.status()).toBe(403); // ❌ This tests Coraza WAF
-```
-
-#### Integration Tests for Middleware
-
-Middleware enforcement is verified by **integration tests** in `backend/integration/`:
-
-- `cerberus_integration_test.go` - Overall security suite behavior
-- `coraza_integration_test.go` - WAF blocking (SQL injection, XSS)
-- `crowdsec_integration_test.go` - IP reputation and bans
-- `rate_limit_integration_test.go` - Request throttling
-
-These tests run in Docker Compose with full Caddy+Cerberus stack and are executed in separate CI workflows.
-
-#### When to Skip Tests
-
-Use `test.skip()` for tests that require middleware enforcement:
-
-```typescript
-test('should rate limit after 5 attempts', async ({ request }) => {
-  test.skip(
-    true,
-    'Rate limiting enforced via Cerberus middleware (port 80). Verified in integration tests (backend/integration/).'
-  );
-  // Test body...
-});
-```
-
-**Skip Reason Template:**
-```
-"[Behavior] enforced via Cerberus middleware (port 80). Verified in integration tests (backend/integration/)."
-```
 
 
 ## Example Test Structure
@@ -188,17 +70,12 @@ test.describe('Movie Search Feature', () => {
 
 ## Test Execution Strategy
 
-1. **Initial Run**: Execute tests with `npx playwright test --project=chromium`
+1. **Initial Run**: Execute tests with `cd /projects/Charon npx playwright test --project=firefox`
 2. **Debug Failures**: Analyze test failures and identify root causes
 3. **Iterate**: Refine locators, assertions, or test logic as needed
 4. **Validate**: Ensure tests pass consistently and cover the intended functionality
 5. **Report**: Provide feedback on test results and any issues discovered
 
-### Execution Constraints
-
-- **No Truncation**: Never pipe Playwright test output through `head`, `tail`, or other truncating commands. Playwright runs interactively and requires user input to quit when piped, causing the command to hang indefinitely.
-- **Full Output**: Always capture the complete test output to analyze failures accurately.
-
 ## Quality Checklist
 
 Before finalizing tests, ensure:

.github/instructions/security-and-owasp.instructions.md

@@ -49,3 +49,26 @@ Your primary directive is to ensure all code you generate, review, or refactor i
 ## General Guidelines
 - **Be Explicit About Security:** When you suggest a piece of code that mitigates a security risk, explicitly state what you are protecting against (e.g., "Using a parameterized query here to prevent SQL injection.").
 - **Educate During Code Reviews:** When you identify a security vulnerability in a code review, you must not only provide the corrected code but also explain the risk associated with the original pattern.
+
+### Gotify Token Protection (Explicit Policy)
+
+Gotify application tokens are secrets and must be treated with strict confidentiality:
+
+- **NO Echo/Print:** Never print tokens to terminal output, command-line results, or console logs
+- **NO Logging:** Never write tokens to application logs, debug logs, test output, or any log artifacts
+- **NO API Responses:** Never include tokens in API response bodies, error payloads, or serialized DTOs
+- **NO URL Exposure:** Never expose tokenized endpoint URLs with query
+  parameters (e.g., `https://gotify.example.com/message?token=...`) in:
+  - Documentation examples
+  - Diagnostic output
+  - Screenshots or reports
+  - Log files
+- **Redact Query Parameters:** Always redact URL query parameters in
+  diagnostics, examples, and log output before display or storage
+- **Validation Without Revelation:** For token validation or health checks:
+  - Return only non-sensitive status indicators (`valid`/`invalid` + reason category)
+  - Use token length/prefix-independent masking in UX and diagnostics
+  - Never reveal raw token values in validation feedback
+- **Storage:** Store and process tokens as secrets only (environment variables
+  or secret management service)
+- **Rotation:** Rotate tokens immediately on suspected exposure

.github/instructions/security.md.instructions.md

@@ -0,0 +1,204 @@
+---
+applyTo: SECURITY.md
+---
+
+# Instructions: Maintaining `SECURITY.md`
+
+`SECURITY.md` is the project's living security record. It serves two audiences simultaneously: users who need to know what risks exist right now, and the broader community who need confidence that vulnerabilities are being tracked and remediated with discipline. Treat it like a changelog, but for security events — every known issue gets an entry, every resolved issue keeps its entry.
+
+---
+
+## File Structure
+
+`SECURITY.md` must always contain the following top-level sections, in this order:
+
+1. A brief project security policy preamble (responsible disclosure contact, response SLA)
+2. **`## Known Vulnerabilities`** — active, unpatched issues
+3. **`## Patched Vulnerabilities`** — resolved issues, retained permanently for audit trail
+
+No other top-level sections are required. Do not collapse or remove sections even when they are empty — use the explicit empty-state placeholder defined below.
+
+---
+
+## Section 1: Known Vulnerabilities
+
+This section lists every vulnerability that is currently unpatched or only partially mitigated. Entries must be sorted with the highest severity first, then by discovery date descending within the same severity tier.
+
+### Entry Format
+
+Each entry is an H3 heading followed by a structured block:
+
+```markdown
+### [SEVERITY] CVE-XXXX-XXXXX · Short Title
+
+| Field        | Value |
+|--------------|-------|
+| **ID**       | CVE-XXXX-XXXXX (or `CHARON-YYYY-NNN` if no CVE assigned yet) |
+| **Severity** | Critical / High / Medium / Low · CVSS v3.1 score if known (e.g. `8.1 · High`) |
+| **Status**   | Investigating / Fix In Progress / Awaiting Upstream / Mitigated (partial) |
+
+**What**
+One to three sentences describing the vulnerability class and its impact.
+Be specific: name the weakness type (e.g. SQL injection, path traversal, SSRF).
+
+**Who**
+- Discovered by: [Reporter name or handle, or "Internal audit", or "Automated scan (tool name)"]
+- Reported: YYYY-MM-DD
+- Affects: [User roles, API consumers, unauthenticated users, etc.]
+
+**Where**
+- Component: [Module or service name]
+- File(s): `path/to/affected/file.go`, `path/to/other/file.ts`
+- Versions affected: `>= X.Y.Z` (or "all versions" / "prior to X.Y.Z")
+
+**When**
+- Discovered: YYYY-MM-DD
+- Disclosed (if public): YYYY-MM-DD (or "Not yet publicly disclosed")
+- Target fix: YYYY-MM-DD (or sprint/milestone reference)
+
+**How**
+A concise technical description of the attack vector, prerequisites, and exploitation
+method. Omit proof-of-concept code. Reference CVE advisories or upstream issue
+trackers where appropriate.
+
+**Planned Remediation**
+Describe the fix strategy: library upgrade, logic refactor, config change, etc.
+If a workaround is available in the meantime, document it here.
+Link to the tracking issue: [#NNN](https://github.com/owner/repo/issues/NNN)
+```
+
+### Empty State
+
+When there are no known vulnerabilities:
+
+```markdown
+## Known Vulnerabilities
+
+No known unpatched vulnerabilities at this time.
+Last reviewed: YYYY-MM-DD
+```
+
+---
+
+## Section 2: Patched Vulnerabilities
+
+This section is a permanent, append-only ledger. Entries are never deleted. Sort newest-patched first. This section builds community trust by demonstrating that issues are resolved promptly and transparently.
+
+### Entry Format
+
+```markdown
+### ✅ [SEVERITY] CVE-XXXX-XXXXX · Short Title
+
+| Field        | Value |
+|--------------|-------|
+| **ID**       | CVE-XXXX-XXXXX (or internal ID) |
+| **Severity** | Critical / High / Medium / Low · CVSS v3.1 score |
+| **Patched**  | YYYY-MM-DD in `vX.Y.Z` |
+
+**What**
+Same description carried over from the Known Vulnerabilities entry.
+
+**Who**
+- Discovered by: [Reporter or method]
+- Reported: YYYY-MM-DD
+
+**Where**
+- Component: [Module or service name]
+- File(s): `path/to/affected/file.go`
+- Versions affected: `< X.Y.Z`
+
+**When**
+- Discovered: YYYY-MM-DD
+- Patched: YYYY-MM-DD
+- Time to patch: N days
+
+**How**
+Same technical description as the original entry.
+
+**Resolution**
+Describe exactly what was changed to fix the issue.
+- Commit: [`abc1234`](https://github.com/owner/repo/commit/abc1234)
+- PR: [#NNN](https://github.com/owner/repo/pull/NNN)
+- Release: [`vX.Y.Z`](https://github.com/owner/repo/releases/tag/vX.Y.Z)
+
+**Credit**
+[Optional] Thank the reporter if they consented to attribution.
+```
+
+### Empty State
+
+```markdown
+## Patched Vulnerabilities
+
+No patched vulnerabilities on record yet.
+```
+
+---
+
+## Lifecycle: Moving an Entry from Known → Patched
+
+When a fix ships:
+
+1. Remove the entry from `## Known Vulnerabilities` entirely.
+2. Add a new entry to the **top** of `## Patched Vulnerabilities` using the patched format above.
+3. Carry forward all original fields verbatim — do not rewrite the history of the issue.
+4. Add the `**Resolution**` and `**Credit**` blocks with patch details.
+5. Update the `Last reviewed` date on the Known Vulnerabilities section if it is now empty.
+
+Do not edit or backfill existing Patched entries once they are committed.
+
+---
+
+## Severity Classification
+
+Use the following definitions consistently:
+
+| Severity | CVSS Range | Meaning |
+|----------|------------|---------|
+| **Critical** | 9.0–10.0 | Remote code execution, auth bypass, full data exposure |
+| **High**     | 7.0–8.9  | Significant data exposure, privilege escalation, DoS |
+| **Medium**   | 4.0–6.9  | Limited data exposure, requires user interaction or auth |
+| **Low**      | 0.1–3.9  | Minimal impact, difficult to exploit, defense-in-depth |
+
+When a CVE CVSS score is not yet available, assign a preliminary severity based on these definitions and note it as `(preliminary)` until confirmed.
+
+---
+
+## Internal IDs
+
+If a vulnerability has no CVE assigned, use the format `CHARON-YYYY-NNN` where `YYYY` is the year and `NNN` is a zero-padded sequence number starting at `001` for each year. Example: `CHARON-2025-003`. Assign a CVE ID in the entry retroactively if one is issued later, and add the internal ID as an alias in parentheses.
+
+---
+
+## Responsible Disclosure Preamble
+
+The preamble at the top of `SECURITY.md` (before the vulnerability sections) must include:
+
+- The preferred contact method for reporting vulnerabilities (e.g. a GitHub private advisory link, a security email address, or both)
+- An acknowledgment-first response commitment: confirm receipt within 48 hours, even if the full investigation takes longer
+- A statement that reporters will not be penalized or publicly named without consent
+- A link to the full disclosure policy if one exists
+
+Example:
+
+```markdown
+## Reporting a Vulnerability
+
+To report a security issue, please use
+[GitHub Private Security Advisories](https://github.com/owner/repo/security/advisories/new)
+or email `security@example.com`.
+
+We will acknowledge your report within **48 hours** and provide a remediation
+timeline within **7 days**. Reporters are credited with their consent.
+We do not pursue legal action against good-faith security researchers.
+```
+
+---
+
+## Maintenance Rules
+
+- **Review cadence**: Update the `Last reviewed` date in the Known Vulnerabilities section at least once per release cycle, even if no entries changed.
+- **No silent patches**: Every security fix — no matter how minor — must produce an entry in `## Patched Vulnerabilities` before or alongside the release.
+- **No redaction**: Do not redact or soften historical entries. Accuracy builds trust; minimizing past issues destroys it.
+- **Dependency vulnerabilities**: Transitive dependency CVEs that affect Charon's exposed attack surface must be tracked here the same as first-party vulnerabilities. Pure dev-dependency CVEs with no runtime impact may be omitted at maintainer discretion, but must still be noted in the relevant dependency update PR.
+- **Partial mitigations**: If a workaround is deployed but the root cause is not fixed, the entry stays in `## Known Vulnerabilities` with `Status: Mitigated (partial)` and the workaround documented in `**Planned Remediation**`.

.github/instructions/structure.instructions.md

@@ -9,7 +9,7 @@ description: 'Repository structure guidelines to maintain organized file placeme
 
 The repository root should contain ONLY:
 
-- Essential config files (`.gitignore`, `.pre-commit-config.yaml`, `Makefile`, etc.)
+- Essential config files (`.gitignore`, `Makefile`, etc.)
 - Standard project files (`README.md`, `CONTRIBUTING.md`, `LICENSE`, `CHANGELOG.md`)
 - Go workspace files (`go.work`, `go.work.sum`)
 - VS Code workspace (`Chiron.code-workspace`)

.github/instructions/subagent.instructions.md

@@ -23,10 +23,22 @@ runSubagent({
 
 - Validate: `plan_file` exists and contains a `Handoff Contract` JSON.
 - Kickoff: call `Planning` to create the plan if not present.
+- Decide: check how to organize work into logical commits within a single PR (size, risk, cross-domain impact).
 - Run: execute `Backend Dev` then `Frontend Dev` sequentially.
 - Parallel: run `QA and Security`, `DevOps` and `Doc Writer` in parallel for CI / QA checks and documentation.
 - Return: a JSON summary with `subagent_results`, `overall_status`, and aggregated artifacts.
 
+2.1) Multi-Commit Slicing Protocol
+
+- All work for a single feature ships as one PR with ordered logical commits.
+- Each commit must have:
+  - Scope boundary (what is included/excluded)
+  - Dependency on previous commits
+  - Validation gates (tests/scans required for that commit)
+  - Explicit rollback notes for the PR as a whole
+- Do not start the next commit until the current commit is complete and verified.
+- Keep each commit independently reviewable within the PR.
+
 3) Return Contract that all subagents must return
 
 ```
@@ -43,6 +55,7 @@ runSubagent({
 
 - On a subagent failure, the Management agent must capture `tests.output` and decide to retry (1 retry maximum), or request a revert/rollback.
 - Clearly mark the `status` as `failed`, and include `errors` and `failing_tests` in the `summary`.
+- For multi-commit execution, mark failed commit as blocked and stop downstream commits until resolved.
 
 5) Example: Run a full Feature Implementation
 

.github/instructions/testing.instructions.md

@@ -4,13 +4,63 @@ description: 'Strict protocols for test execution, debugging, and coverage valid
 ---
 # Testing Protocols
 
+**Governance Note**: This file is subject to the precedence hierarchy defined in
+`.github/instructions/copilot-instructions.md`. When conflicts arise, canonical
+instruction files take precedence over agent files and operator documentation.
+
 ## 0. E2E Verification First (Playwright)
 
 **MANDATORY**: Before running unit tests, verify the application UI/UX functions correctly end-to-end.
 
+## 0.5 Local Patch Coverage Report (After Coverage Tests)
+
+**MANDATORY**: After running backend and frontend coverage tests (which generate
+`backend/coverage.txt` and `frontend/coverage/lcov.info`), run the local patch
+report to identify uncovered lines in changed files.
+
+**Purpose**: Overall coverage can be healthy while the specific lines you changed
+are untested. This step catches that gap. If uncovered lines are found in
+feature code, add targeted tests before completing the task.
+
+**Prerequisites**: Coverage artifacts must exist before running the report:
+- `backend/coverage.txt` — generated by `scripts/go-test-coverage.sh`
+- `frontend/coverage/lcov.info` — generated by `scripts/frontend-test-coverage.sh`
+
+Run one of the following from `/projects/Charon`:
+
+```bash
+# Preferred (task)
+Test: Local Patch Report
+
+# Script
+bash scripts/local-patch-report.sh
+```
+
+Required output artifacts:
+- `test-results/local-patch-report.md`
+- `test-results/local-patch-report.json`
+
+**Action on results**: If patch coverage for any changed file is below 90%, add
+tests targeting the uncovered changed lines. Re-run coverage and this report to
+verify improvement. Artifact generation is required for DoD regardless of
+threshold results.
+
 ### PREREQUISITE: Start E2E Environment
 
-**CRITICAL**: Always rebuild the E2E container before running Playwright tests:
+**CRITICAL**: Rebuild the E2E container when application or Docker build inputs change. If changes are test-only and the container is already healthy, reuse it. If the container is not running or state is suspect, rebuild.
+
+**Rebuild required (application/runtime changes):**
+- Application code or dependencies: backend/**, frontend/**, backend/go.mod, backend/go.sum, package.json, package-lock.json.
+- Container build/runtime configuration: Dockerfile, .docker/**, .docker/compose/docker-compose.playwright-*.yml, .docker/docker-entrypoint.sh.
+- Runtime behavior changes baked into the image.
+
+**Rebuild optional (test-only changes):**
+- Playwright tests and fixtures: tests/**.
+- Playwright config and runners: playwright.config.js, playwright.caddy-debug.config.js.
+- Documentation or planning files: docs/**, requirements.md, design.md, tasks.md.
+- CI/workflow changes that do not affect runtime images: .github/workflows/**.
+
+When a rebuild is required (or the container is not running), use:
 
 ```bash
 .github/skills/scripts/skill-runner.sh docker-rebuild-e2e
@@ -35,6 +85,7 @@ This step:
 - Ensure forms submit correctly
 - Check navigation and page rendering
 - **Port: 8080 (Charon Management Interface)**
+- **Default Browser: Firefox** (provides best cross-browser compatibility baseline)
 
 **Integration Tests (Middleware Enforcement):**
 - Test Cerberus security module enforcement
@@ -61,7 +112,7 @@ For general integration testing without coverage:
 
 ```bash
 # Against Docker container (default)
-npx playwright test --project=chromium --project=firefox --project=webkit
+cd /projects/Charon && npx playwright test --project=chromium --project=firefox --project=webkit
 
 # With explicit base URL
 PLAYWRIGHT_BASE_URL=http://localhost:8080 npx playwright test --project=chromium --project=firefox --project=webkit
@@ -134,18 +185,41 @@ Before pushing code, verify E2E coverage:
 ## 3. Coverage & Completion
 * **Coverage Gate:** A task is not "Complete" until a coverage report is generated.
 * **Threshold Compliance:** You must compare the final coverage percentage against the project's threshold (Default: 85% unless specified otherwise). If coverage drops, you must identify the "uncovered lines" and add targeted tests.
-* **Patch Coverage Gate (Codecov):** If production code is modified, Codecov **patch coverage must be 100%** for the modified lines. Do not relax thresholds; add targeted tests.
+* **Patch Coverage (Suggestion):** Codecov reports patch coverage as an indicator. While developers should aim for 100% coverage of modified lines, patch coverage is **not a hard requirement** and will not block PR approval. If patch coverage is low, consider adding targeted tests to improve the metric.
-* **Patch Triage Requirement:** Plans must include the exact missing/partial patch line ranges copied from Codecov’s **Patch** view.
+* **Review Patch Coverage:** When reviewing patch coverage reports, assess whether missing lines represent genuine gaps or are acceptable (e.g., error handling branches, deprecated code paths). Use the report to inform testing decisions, not as an absolute gate.
+
 ## 4. GORM Security Validation (Manual Stage)
 
-**Requirement:** All backend changes involving GORM models or database interactions must pass the GORM Security Scanner.
+**Requirement:** For any change that touches backend models or
+database-related logic, the GORM Security Scanner is a mandatory local DoD gate
+and must pass with zero CRITICAL/HIGH findings.
 
-### When to Run
+**Policy vs. Automation Reconciliation:** "Manual stage" describes execution
+mechanism only (not automated pre-commit hook); policy enforcement remains
+process-blocking for DoD. Gate decisions must use check semantics
+(`./scripts/scan-gorm-security.sh --check` or equivalent task wiring).
 
-* **Before Committing:** When modifying GORM models (files in `backend/internal/models/`)
+### When to Run (Conditional Trigger Matrix)
-* **Before Opening PR:** Verify no security issues introduced
+
-* **After Code Review:** If model-related changes were requested
+**Mandatory Trigger Paths (Include):**
-* **Definition of Done:** Scanner must pass with zero CRITICAL/HIGH issues
+- `backend/internal/models/**` — GORM model definitions
+- Backend services/repositories with GORM query logic
+- Database migrations or seeding logic affecting model persistence behavior
+
+**Explicit Exclusions:**
+- Docs-only changes (`**/*.md`, governance documentation)
+- Frontend-only changes (`frontend/**`)
+
+**Gate Decision Rule:** IF any Include path matches, THEN scanner execution in
+check mode is mandatory DoD gate. IF only Exclude paths match, THEN GORM gate
+is not required for that change set.
+
+### Definition of Done
+- **Before Committing:** When modifying trigger paths listed above
+- **Before Opening PR:** Verify no security issues introduced
+- **After Code Review:** If model-related changes were requested
+- **Blocking Gate:** Scanner must pass with zero CRITICAL/HIGH issues before
+   task completion
 
 ### Running the Scanner
 

.github/renovate.json

@@ -6,13 +6,14 @@
     ":separateMultipleMajorReleases",
     "helpers:pinGitHubActionDigests"
   ],
-  "baseBranches": [
+  "baseBranchPatterns": [
     "feature/beta-release",
     "development"
-
   ],
+  "postUpdateOptions": ["npmDedupe"],
   "timezone": "America/New_York",
   "dependencyDashboard": true,
+  "dependencyDashboardApproval": true,
   "prConcurrentLimit": 10,
   "prHourlyLimit": 0,
   "labels": [
@@ -26,19 +27,31 @@
   "rebaseWhen": "auto",
 
   "vulnerabilityAlerts": {
-    "enabled": true
+    "enabled": true,
+    "dependencyDashboardApproval": false,
+    "automerge": false,
+    "labels": ["security", "vulnerability"]
   },
 
-  "schedule": [
-    "before 8am on monday"
-  ],
-
   "rangeStrategy": "bump",
   "automerge": false,
   "automergeType": "pr",
   "platformAutomerge": true,
 
   "customManagers": [
+    {
+      "customType": "regex",
+      "description": "Track caddy-security plugin version in Dockerfile",
+      "managerFilePatterns": [
+        "/^Dockerfile$/"
+      ],
+      "matchStrings": [
+        "ARG CADDY_SECURITY_VERSION=(?<currentValue>[^\\s]+)"
+      ],
+      "depNameTemplate": "github.com/greenpau/caddy-security",
+      "datasourceTemplate": "go",
+      "versioningTemplate": "semver"
+    },
     {
       "customType": "regex",
       "description": "Track Go dependencies patched in Dockerfile for Caddy CVE fixes",
@@ -53,15 +66,48 @@
     },
     {
       "customType": "regex",
-      "description": "Track Debian base image digest in Dockerfile for security updates",
+      "description": "Track Alpine base image digest in Dockerfile for security updates",
       "managerFilePatterns": ["/^Dockerfile$/"],
       "matchStrings": [
-        "#\\s*renovate:\\s*datasource=docker\\s+depName=debian.*\\nARG CADDY_IMAGE=debian:(?<currentValue>trixie-slim@sha256:[a-f0-9]+)"
+        "#\\s*renovate:\\s*datasource=docker\\s+depName=alpine.*\\nARG ALPINE_IMAGE=alpine:(?<currentValue>[^@\\s]+)@(?<currentDigest>sha256:[a-f0-9]+)"
       ],
-      "depNameTemplate": "debian",
+      "depNameTemplate": "alpine",
       "datasourceTemplate": "docker",
       "versioningTemplate": "docker"
     },
+    {
+      "customType": "regex",
+      "description": "Track Go toolchain version ARG in Dockerfile",
+      "managerFilePatterns": ["/^Dockerfile$/"],
+      "matchStrings": [
+        "#\\s*renovate:\\s*datasource=docker\\s+depName=golang.*\\nARG GO_VERSION=(?<currentValue>[^\\s]+)"
+      ],
+      "depNameTemplate": "golang",
+      "datasourceTemplate": "docker",
+      "versioningTemplate": "docker"
+    },
+    {
+      "customType": "regex",
+      "description": "Track expr-lang version ARG in Dockerfile",
+      "managerFilePatterns": ["/^Dockerfile$/"],
+      "matchStrings": [
+        "#\\s*renovate:\\s*datasource=go\\s+depName=github\\.com/expr-lang/expr.*\\nARG EXPR_LANG_VERSION=(?<currentValue>[^\\s]+)"
+      ],
+      "depNameTemplate": "github.com/expr-lang/expr",
+      "datasourceTemplate": "go",
+      "versioningTemplate": "semver"
+    },
+    {
+      "customType": "regex",
+      "description": "Track golang.org/x/net version ARG in Dockerfile",
+      "managerFilePatterns": ["/^Dockerfile$/"],
+      "matchStrings": [
+        "#\\s*renovate:\\s*datasource=go\\s+depName=golang\\.org/x/net.*\\nARG XNET_VERSION=(?<currentValue>[^\\s]+)"
+      ],
+      "depNameTemplate": "golang.org/x/net",
+      "datasourceTemplate": "go",
+      "versioningTemplate": "semver"
+    },
     {
       "customType": "regex",
       "description": "Track Delve version in Dockerfile",
@@ -84,6 +130,32 @@
       "datasourceTemplate": "go",
       "versioningTemplate": "semver"
     },
+    {
+      "customType": "regex",
+      "description": "Track gotestsum version in codecov workflow",
+      "managerFilePatterns": [
+        "/^\\.github/workflows/codecov-upload\\.yml$/"
+      ],
+      "matchStrings": [
+        "gotestsum@v(?<currentValue>[^\\s]+)"
+      ],
+      "depNameTemplate": "gotest.tools/gotestsum",
+      "datasourceTemplate": "go",
+      "versioningTemplate": "semver"
+    },
+    {
+      "customType": "regex",
+      "description": "Track gotestsum version in quality checks workflow",
+      "managerFilePatterns": [
+        "/^\\.github/workflows/quality-checks\\.yml$/"
+      ],
+      "matchStrings": [
+        "gotestsum@v(?<currentValue>[^\\s]+)"
+      ],
+      "depNameTemplate": "gotest.tools/gotestsum",
+      "datasourceTemplate": "go",
+      "versioningTemplate": "semver"
+    },
     {
       "customType": "regex",
       "description": "Track govulncheck version in scripts",
@@ -116,35 +188,98 @@
       "depNameTemplate": "golang/go",
       "datasourceTemplate": "golang-version",
       "versioningTemplate": "semver"
+    },
+    {
+      "customType": "regex",
+      "description": "Track GO_VERSION in Actions workflows",
+      "managerFilePatterns": ["/^\\.github/workflows/.*\\.yml$/"],
+      "matchStrings": [
+        "GO_VERSION: ['\"]?(?<currentValue>[\\d\\.]+)['\"]?"
+      ],
+      "depNameTemplate": "golang/go",
+      "datasourceTemplate": "golang-version",
+      "versioningTemplate": "semver"
+    },
+    {
+      "customType": "regex",
+      "description": "Track Syft version in workflows and scripts",
+      "managerFilePatterns": [
+        "/^\\.github/workflows/nightly-build\\.yml$/",
+        "/^\\.github/skills/security-scan-docker-image-scripts/run\\.sh$/"
+      ],
+      "matchStrings": [
+        "SYFT_VERSION=\\\"v(?<currentValue>[^\\\"\\s]+)\\\"",
+        "set_default_env \\\"SYFT_VERSION\\\" \\\"v(?<currentValue>[^\\\"]+)\\\""
+      ],
+      "depNameTemplate": "anchore/syft",
+      "datasourceTemplate": "github-releases",
+      "versioningTemplate": "semver",
+      "extractVersionTemplate": "^v(?<version>.*)$"
+    },
+    {
+      "customType": "regex",
+      "description": "Track Grype version in workflows and scripts",
+      "managerFilePatterns": [
+        "/^\\.github/workflows/supply-chain-pr\\.yml$/",
+        "/^\\.github/skills/security-scan-docker-image-scripts/run\\.sh$/"
+      ],
+      "matchStrings": [
+        "anchore/grype/main/install\\.sh \\| sh -s -- -b /usr/local/bin v(?<currentValue>[0-9]+\\.[0-9]+\\.[0-9]+)",
+        "set_default_env \\\"GRYPE_VERSION\\\" \\\"v(?<currentValue>[^\\\"]+)\\\""
+      ],
+      "depNameTemplate": "anchore/grype",
+      "datasourceTemplate": "github-releases",
+      "versioningTemplate": "semver",
+      "extractVersionTemplate": "^v(?<version>.*)$"
+    },
+    {
+      "customType": "regex",
+      "description": "Track go-version in skill example workflows",
+      "managerFilePatterns": ["/^\\.github/skills/examples/.*\\.yml$/"],
+      "matchStrings": [
+        "go-version: [\"']?(?<currentValue>[\\d\\.]+)[\"']?"
+      ],
+      "depNameTemplate": "golang/go",
+      "datasourceTemplate": "golang-version",
+      "versioningTemplate": "semver"
     }
   ],
 
+  "github-actions": {
+    "managerFilePatterns": [
+      "/^\\.github/skills/examples/.*\\.ya?ml$/"
+    ]
+  },
+
   "packageRules": [
     {
-      "description": "THE MEGAZORD: Group ALL non-major updates (NPM, Docker, Go, Actions) into one weekly PR",
+      "description": "THE MEGAZORD: Group ALL non-major updates (NPM, Docker, Go, Actions) into one PR",
-      "matchPackagePatterns": ["*"],
       "matchUpdateTypes": [
         "minor",
         "patch",
         "pin",
         "digest"
       ],
-      "groupName": "weekly-non-major-updates"
+      "groupName": "non-major-updates",
+      "matchPackageNames": [
+        "*"
+      ]
     },
-    {
+        {
-      "description": "Feature branches: Always require manual approval",
+      "description": "Feature branches: Auto-merge non-major updates after proven stable",
-      "matchBaseBranches": ["feature/*"],
+      "matchBaseBranches": ["feature/**"],
+      "matchUpdateTypes": ["minor", "patch", "pin", "digest"],
       "automerge": false
     },
     {
       "description": "Development branch: Auto-merge non-major updates after proven stable",
       "matchBaseBranches": ["development"],
       "matchUpdateTypes": ["minor", "patch", "pin", "digest"],
-      "automerge": true,
+      "automerge": false,
-      "minimumReleaseAge": "3 days"
+      "minimumReleaseAge": "14 days"
     },
     {
-      "description": "Preserve your custom Caddy patch labels but allow them to group into the weekly PR",
+      "description": "Preserve your custom Caddy patch labels but allow them to group into a single PR",
       "matchManagers": ["custom.regex"],
       "matchFileNames": ["Dockerfile"],
       "labels": ["caddy-patch", "security"],
@@ -160,11 +295,41 @@
       "matchPackageNames": ["caddy"],
       "allowedVersions": "<3.0.0"
     },
+    {
+      "description": "Go: keep pgx within v4 (CrowdSec requires pgx/v4 module path)",
+      "matchDatasources": ["go"],
+      "matchPackageNames": ["github.com/jackc/pgx/v4"],
+      "allowedVersions": "<5.0.0"
+    },
+    {
+      "description": "Go: keep go-jose/v3 within v3 (v4 is a different Go module path)",
+      "matchDatasources": ["go"],
+      "matchPackageNames": ["github.com/go-jose/go-jose/v3"],
+      "allowedVersions": "<4.0.0"
+    },
+    {
+      "description": "Go: keep go-jose/v4 within v4 (v5 would be a different Go module path)",
+      "matchDatasources": ["go"],
+      "matchPackageNames": ["github.com/go-jose/go-jose/v4"],
+      "allowedVersions": "<5.0.0"
+    },
     {
       "description": "Safety: Keep MAJOR updates separate and require manual review",
       "matchUpdateTypes": ["major"],
       "automerge": false,
       "labels": ["manual-review"]
+    },
+    {
+      "description": "Fix Renovate lookup for geoip2-golang v2 module path",
+      "matchDatasources": ["go"],
+      "matchPackageNames": ["github.com/oschwald/geoip2-golang/v2"],
+      "sourceUrl": "https://github.com/oschwald/geoip2-golang"
+    },
+    {
+      "description": "Fix Renovate lookup for google/uuid",
+      "matchDatasources": ["go"],
+      "matchPackageNames": ["github.com/google/uuid"],
+      "sourceUrl": "https://github.com/google/uuid"
     }
   ]
 }

.github/security-severity-policy.yml

@@ -0,0 +1,55 @@
+version: 1
+effective_date: 2026-02-25
+scope:
+  - local pre-commit manual security hooks
+  - github actions security workflows
+
+defaults:
+  blocking:
+    - critical
+    - high
+  medium:
+    mode: risk-based
+    default_action: report
+    require_sla: true
+    default_sla_days: 14
+    escalation:
+      trigger: high-signal class or repeated finding
+      action: require issue + owner + due date
+  low:
+    action: report
+
+codeql:
+  severity_mapping:
+    error: high_or_critical
+    warning: medium_or_lower
+    note: informational
+  blocking_levels:
+    - error
+  warning_policy:
+    default_action: report
+    escalation_high_signal_rule_ids:
+      - go/request-forgery
+      - js/missing-rate-limiting
+      - js/insecure-randomness
+
+trivy:
+  blocking_severities:
+    - CRITICAL
+    - HIGH
+  medium_policy:
+    action: report
+    escalation: issue-with-sla
+
+grype:
+  blocking_severities:
+    - Critical
+    - High
+  medium_policy:
+    action: report
+    escalation: issue-with-sla
+
+enforcement_contract:
+  codeql_local_vs_ci: "local and ci block on codeql error-level findings only"
+  supply_chain_medium: "medium vulnerabilities are non-blocking by default and require explicit triage"
+  auth_regression_guard: "state-changing routes must remain protected by auth middleware"