docs: add mise tasks for documentation generation and validation

- Add docs:generate task to generate API documentation with Doxygen
- Add docs:validate task to run coverage and tag validation
- Document Doxygen installation via brew/apt in README
- Update CLAUDE.md with new mise commands
- Provide both mise and direct command usage examples

Note: Doxygen is not available in mise registry, so must be installed
separately via system package manager (brew, apt, etc.)

Author: tobyhede

CLAUDE.md

@@ -12,6 +12,8 @@ This project uses `mise` for task management. Common commands:
 - `mise run postgres:down` - Stop PostgreSQL containers
 - `mise run reset` - Reset database state
 - `mise run clean` (alias: `mise r k`) - Clean release files
+- `mise run docs:generate` - Generate API documentation (requires doxygen)
+- `mise run docs:validate` - Validate documentation coverage and tags
 
 ### Testing
 - Run all tests: `mise run test`

README.md

@@ -211,9 +211,25 @@ In order to enable searchable encryption, you will need to configure your Cipher
 
 All EQL functions and types are fully documented with Doxygen-style comments in the source code.
 
-**Generate API documentation** (requires [Doxygen](https://www.doxygen.nl/)):
+**Install Doxygen** (required for documentation generation):
 
 ```bash
+# macOS
+brew install doxygen
+
+# Ubuntu/Debian
+apt-get install doxygen
+
+# Other platforms: https://www.doxygen.nl/download.html
+```
+
+**Generate API documentation:**
+
+```bash
+# Using mise
+mise run docs:generate
+
+# Or directly with doxygen
 doxygen Doxyfile
 ```
 
@@ -236,14 +252,13 @@ For contribution guidelines, see [CLAUDE.md](./CLAUDE.md).
 Verify documentation quality using these scripts:
 
 ```bash
-# Check documentation coverage (should be 100%)
-./tasks/check-doc-coverage.sh
-
-# Validate required Doxygen tags
-./tasks/validate-required-tags.sh
+# Using mise (validates coverage and tags)
+mise run docs:validate
 
-# Validate SQL syntax
-./tasks/validate-documented-sql.sh
+# Or run individual checks
+./tasks/check-doc-coverage.sh      # Check 100% coverage
+./tasks/validate-required-tags.sh  # Validate @brief, @param, @return
+./tasks/validate-documented-sql.sh # Validate SQL syntax
 ```
 
 Documentation validation runs automatically in CI for all pull requests.

mise.toml

@@ -23,3 +23,21 @@ run = """
   rm -f release/cipherstash-encrypt-uninstall.sql
   rm -f release/cipherstash-encrypt.sql
 """
+
+[tasks."docs:generate"]
+description = "Generate API documentation with Doxygen"
+run = """
+  echo "Generating API documentation..."
+  doxygen Doxyfile
+  echo "Documentation generated at docs/api/html/index.html"
+"""
+
+[tasks."docs:validate"]
+description = "Validate SQL documentation"
+run = """
+  echo "Checking documentation coverage..."
+  ./tasks/check-doc-coverage.sh
+  echo ""
+  echo "Validating required tags..."
+  ./tasks/validate-required-tags.sh
+"""