fix(ci): use mise tasks for documentation validation

- Fix validate-required-tags.sh to use BSD-compatible sed instead of grep -P
- Update GitHub workflow to use 'mise run docs:validate' instead of direct scripts
- Update CLAUDE.md to recommend mise tasks as primary validation method
- Maintain backward compatibility with direct script execution

The grep -oP flag is a GNU extension not available in BSD grep (macOS).
Replaced with sed pattern matching for cross-platform compatibility.

CI now uses mise for consistency with local development workflow.

Author: tobyhede

.github/workflows/test-eql.yml

@@ -33,15 +33,15 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Check documentation coverage
-        run: |
-          chmod +x tasks/check-doc-coverage.sh
-          ./tasks/check-doc-coverage.sh
+      - uses: jdx/mise-action@v2
+        with:
+          version: 2025.1.6
+          install: true
+          cache: true
 
-      - name: Validate required Doxygen tags
+      - name: Validate SQL documentation
         run: |
-          chmod +x tasks/validate-required-tags.sh
-          ./tasks/validate-required-tags.sh
+          mise run docs:validate
 
   test:
     name: "Test EQL SQL components"

CLAUDE.md

@@ -122,11 +122,17 @@ CREATE FUNCTION eql_v2.create_encrypted_index(...)
 
 ### Validation Tools
 
-Use these scripts to verify documentation quality:
+Verify documentation quality:
 
-- `tasks/check-doc-coverage.sh` - Check documentation coverage (should be 100%)
-- `tasks/validate-required-tags.sh` - Verify required tags are present
-- `tasks/validate-documented-sql.sh` - Validate SQL syntax
+```bash
+# Using mise (recommended - validates coverage and tags)
+mise run docs:validate
+
+# Or run individual scripts directly
+tasks/check-doc-coverage.sh      # Check 100% coverage
+tasks/validate-required-tags.sh  # Verify @brief, @param, @return tags
+tasks/validate-documented-sql.sh # Validate SQL syntax (requires database)
+```
 
 ### Template Files
 

tasks/validate-required-tags.sh

@@ -24,7 +24,8 @@ for file in $(find src -name "*.sql" -not -name "*_test.sql"); do
     comment_block=$(sed -n "${start},${line_no}p" "$file" | grep "^--!" | tail -20)
 
     function_sig=$(sed -n "${line_no}p" "$file")
-    function_name=$(echo "$function_sig" | grep -oP 'CREATE FUNCTION \K[^\(]+' | xargs || echo "unknown")
+    # Extract function name (compatible with BSD sed/grep)
+    function_name=$(echo "$function_sig" | sed -n 's/^CREATE FUNCTION[[:space:]]*\([^(]*\).*/\1/p' | xargs || echo "unknown")
 
     # Check for @brief
     if ! echo "$comment_block" | grep -q "@brief"; then
@@ -62,7 +63,8 @@ for file in $(find src -name "*.template"); do
     comment_block=$(sed -n "${start},${line_no}p" "$file" | grep "^--!" | tail -20)
 
     function_sig=$(sed -n "${line_no}p" "$file")
-    function_name=$(echo "$function_sig" | grep -oP 'CREATE FUNCTION \K[^\(]+' | xargs || echo "unknown")
+    # Extract function name (compatible with BSD sed/grep)
+    function_name=$(echo "$function_sig" | sed -n 's/^CREATE FUNCTION[[:space:]]*\([^(]*\).*/\1/p' | xargs || echo "unknown")
 
     if ! echo "$comment_block" | grep -q "@brief"; then
       echo "ERROR: $file:$line_no $function_name - Missing @brief"