feat: Add SQL logging support (v0.11.1)

.github/workflows/publish.yml

@@ -38,6 +38,21 @@ jobs:
     - name: Install uv
       uses: astral-sh/setup-uv@v6
 
+    - name: Set up Rust
+      uses: actions-rust-lang/setup-rust-toolchain@v1
+      with:
+        toolchain: stable
+
+    - name: Install maturin
+      run: pip install maturin
+
+    - name: Build fraiseql_rs extension
+      run: |
+        cd fraiseql_rs
+        maturin build --release
+        pip install target/wheels/*.whl
+        cd ..
+
     - name: Install dependencies
       run: |
         # Use uv for faster and more reliable dependency resolution
@@ -83,6 +98,18 @@ jobs:
         python-version: '3.13'
     - name: Install uv
       uses: astral-sh/setup-uv@v6
+    - name: Set up Rust
+      uses: actions-rust-lang/setup-rust-toolchain@v1
+      with:
+        toolchain: stable
+    - name: Install maturin
+      run: pip install maturin
+    - name: Build fraiseql_rs extension
+      run: |
+        cd fraiseql_rs
+        maturin build --release
+        pip install target/wheels/*.whl
+        cd ..
     - name: Install dependencies
       run: uv pip install --system -e ".[dev]"
     - name: Run ruff
@@ -101,6 +128,18 @@ jobs:
         python-version: '3.13'
     - name: Install uv
       uses: astral-sh/setup-uv@v6
+    - name: Set up Rust
+      uses: actions-rust-lang/setup-rust-toolchain@v1
+      with:
+        toolchain: stable
+    - name: Install maturin
+      run: pip install maturin
+    - name: Build fraiseql_rs extension
+      run: |
+        cd fraiseql_rs
+        maturin build --release
+        pip install target/wheels/*.whl
+        cd ..
     - name: Install dependencies
       run: uv pip install --system -e ".[dev]"
     - name: Run bandit

.gitignore

@@ -178,3 +178,6 @@ tests/fixtures/examples/.install_log.txt
 .ruff_cache/
 .mypy_cache/
 security_events.log
+
+# TODO directory (deployment analysis and guides)
+TODO/

.pre-commit-config.yaml

@@ -7,13 +7,21 @@ repos:
       - id: trailing-whitespace
       - id: end-of-file-fixer
       - id: check-yaml
+        exclude: ^(deploy/kubernetes/.*\.yaml|mkdocs\.yml)$
       - id: check-added-large-files
       - id: check-json
         exclude: ^benchmarks/.*\.json$
       - id: check-toml
       - id: check-merge-conflict
       - id: debug-statements
 
+  - repo: https://github.com/adrienverge/yamllint
+    rev: v1.35.1
+    hooks:
+      - id: yamllint
+        args: [-c=.yamllint.yaml]
+        files: ^deploy/kubernetes/[^/]+\.yaml$  # Only top-level K8s files, not helm/
+
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.12.7
     hooks:

.yamllint.yaml

@@ -0,0 +1,35 @@
+# yamllint configuration for Kubernetes manifests
+# Allows multi-document YAML files (common in K8s)
+
+extends: default
+
+rules:
+  # Allow multi-document YAML files (---separator)
+  document-start: disable  # Allow --- anywhere or nowhere
+
+  # Kubernetes manifests often have long lines
+  line-length:
+    max: 120
+    level: warning
+
+  # Allow trailing spaces (sometimes needed in multiline strings)
+  trailing-spaces: disable
+
+  # Indentation rules for Kubernetes (relaxed for auto-generated files)
+  indentation:
+    spaces: consistent  # Allow any consistent indentation
+    indent-sequences: consistent
+
+  # Allow empty values (common in K8s for optional fields)
+  empty-values:
+    forbid-in-block-mappings: false
+    forbid-in-flow-mappings: false
+
+  # Comments are OK
+  comments:
+    min-spaces-from-content: 1
+
+  # Truthy values - K8s uses true/false/yes/no/on/off
+  truthy:
+    allowed-values: ['true', 'false', 'yes', 'no', 'on', 'off']
+    check-keys: false

CHANGELOG.md

@@ -7,6 +7,116 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.11.0] - 2025-10-12
+
+### 🚀 Maximum Performance by Default - Zero Configuration Required
+
+This is a **major performance-focused release** that removes all performance configuration switches and makes FraiseQL deliver maximum speed out of the box. No configuration needed - you automatically get the fastest possible GraphQL API.
+
+#### **Breaking Changes**
+
+**Configuration Simplification**: The following configuration flags have been **removed** as their features are now always enabled:
+
+- `json_passthrough_enabled` / `json_passthrough_in_production` / `json_passthrough_cache_nested`
+- `pure_json_passthrough` - Now **always enabled** (25-60x faster queries)
+- `pure_passthrough_use_rust` - Now **always enabled** (10-80x faster JSON transformation)
+- `enable_query_caching` / `enable_turbo_router` - Now **always enabled**
+- `jsonb_extraction_enabled` / `jsonb_auto_detect` / `jsonb_default_columns` - Now **always enabled**
+- `unified_executor_enabled` / `turbo_enable_adaptive_caching` - Now **always enabled**
+- `passthrough_auto_detect_views` / `passthrough_cache_view_metadata` - Now **always enabled**
+- `enable_mode_hints` - Now **always enabled**
+- **`camelforge_function` / `camelforge_field_threshold`** - PostgreSQL CamelForge function **removed**, Rust handles all transformation
+
+**Migration Guide**: Simply remove these config flags from your `FraiseQLConfig`. The features they controlled are now always active, delivering maximum performance automatically.
+
+```python
+# Before v0.11.0
+config = FraiseQLConfig(
+    database_url="postgresql://...",
+    pure_json_passthrough=True,  # Remove this
+    pure_passthrough_use_rust=True,  # Remove this
+    enable_turbo_router=True,  # Remove this
+    jsonb_extraction_enabled=True,  # Remove this
+)
+
+# After v0.11.0 - Clean and simple!
+config = FraiseQLConfig(
+    database_url="postgresql://...",
+    # All performance features automatically enabled
+)
+```
+
+#### **Performance Improvements**
+
+1. **Pure JSON Passthrough (25-60x faster)** - Always enabled
+   - Uses `SELECT data::text` instead of field extraction
+   - Bypasses Python object creation
+   - Direct PostgreSQL → HTTP pipeline
+
+2. **Rust Transformation (10-80x faster)** - Always enabled
+   - Snake_case → camelCase conversion in Rust
+   - Automatic `__typename` injection
+   - Zero Python overhead
+
+3. **JSONB Extraction** - Always enabled
+   - Automatic detection of JSONB columns
+   - Intelligent column selection
+   - Optimized queries for hybrid tables
+
+4. **TurboRouter Caching** - Always enabled
+   - Registered queries execute instantly
+   - Adaptive caching based on complexity
+   - Zero overhead for cache hits
+
+5. **Rust-Only Transformation** - PostgreSQL CamelForge removed
+   - All camelCase transformation now handled by Rust
+   - No PostgreSQL function dependency required
+   - Simpler deployment and configuration
+
+#### **What This Means For You**
+
+- **Zero Configuration**: Maximum performance out of the box
+- **Simpler Code**: No performance flags to manage
+- **Faster APIs**: 25-60x query speedup automatically
+- **Better DX**: No need to tune performance settings
+
+#### **Files Changed**
+
+**Core Performance**:
+- `src/fraiseql/fastapi/config.py` - Removed 13 performance config flags
+- `src/fraiseql/db.py` - Pure passthrough always enabled
+- `src/fraiseql/core/raw_json_executor.py` - Rust transformation always enabled
+- `src/fraiseql/fastapi/dependencies.py` - Passthrough always enabled in production
+- `src/fraiseql/execution/mode_selector.py` - All modes always available
+- `src/fraiseql/fastapi/app.py` - TurboRouter always enabled
+
+**Tests Updated**:
+- `tests/test_pure_passthrough_sql.py` - Updated for always-on behavior
+- `tests/integration/auth/test_json_passthrough_config_fix.py` - Updated tests
+- Removed obsolete configuration test files
+
+#### **Backwards Compatibility**
+
+This release maintains API compatibility for:
+- All GraphQL query syntax
+- All mutation patterns
+- Database schema requirements
+- Type definitions and decorators
+- Authentication and authorization
+
+The only breaking changes are the **removed configuration flags** which are no longer needed since the features they controlled are now always active.
+
+#### **Upgrade Recommendation**
+
+✅ **Highly Recommended**: All users should upgrade to v0.11.0 to get automatic 25-60x performance improvements with simpler configuration.
+
+#### **Testing**
+
+- ✅ All 19 pure passthrough tests passing
+- ✅ All Rust transformation tests passing
+- ✅ Integration tests verified
+- ✅ Performance benchmarks confirmed
+
 ## [0.10.3] - 2025-10-06
 
 ### ✨ IpAddressString Scalar CIDR Notation Support

CONTRIBUTING.md

@@ -1,6 +1,35 @@
 # Contributing to FraiseQL
 
-Thank you for your interest in contributing to FraiseQL! This document provides guidelines for contributing to the project.
+## FraiseQL Craft Code
+
+FraiseQL is designed, written, and maintained by a single developer.
+In the age of AI, this is a feature — not a bug.
+It allows FraiseQL to stay coherent, elegant, and deeply considered at every level.
+
+### Principles
+
+- **Clarity.** Code should be readable, predictable, and shaped by intent.
+- **Correctness.** Type safety, explicitness, and well-defined behavior are non-negotiable.
+- **Care.** Quality emerges from attention, not from scale.
+- **Respect.** All collaborators and users deserve consideration, curiosity, and honesty.
+- **Frugality.** Simplicity and restraint are virtues — unnecessary complexity is not.
+
+### Collaboration
+
+FraiseQL welcomes discussion, feedback, and contributions that uphold these principles.
+Contributions that compromise clarity, correctness, or coherence will be declined — kindly but firmly.
+
+### The Spirit of FraiseQL
+
+FraiseQL is a work of craft.
+It values depth over breadth, signal over noise, and thoughtful architecture over endless abstraction.
+The goal is not to build a community of many, but a foundation of quality that endures.
+
+---
+
+*Inspired by the Contributor Covenant, reimagined for the era of individual craft.*
+
+---
 
 ## 🚀 Quick Start
 
@@ -26,11 +55,20 @@ Thank you for your interest in contributing to FraiseQL! This document provides
 
 ## 📋 Development Guidelines
 
-### Code Quality
-- **Type Hints**: All code must include type hints
-- **Documentation**: Document public APIs with docstrings
-- **Testing**: Maintain >95% test coverage for new code
-- **Style**: Code is automatically formatted with `black` and `ruff`
+### Code Quality (AI-Maintainability Standards)
+
+FraiseQL maintains **exceptional code quality** to ensure AI maintainability:
+
+- **Type Safety** (CRITICAL): All code must pass `pyright` with **0 errors**
+  ```bash
+  uv run pyright  # Must show: 0 errors, 0 warnings
+  ```
+- **Type Hints**: Full type annotations for all functions (no `Any` without justification)
+- **Documentation**: Document public APIs with Google-style docstrings
+- **Testing**: Maintain comprehensive test coverage (currently 3,448 tests)
+- **Style**: Code is automatically formatted with `ruff`
+
+**Why this matters**: FraiseQL is designed to be AI-maintainable. Perfect type safety means AI assistants (Claude Code, Copilot, Cursor) can understand and maintain the codebase reliably.
 
 ### Testing Strategy
 - **Unit Tests**: Add unit tests in `tests/unit/` for logic components
@@ -68,9 +106,6 @@ Thank you for your interest in contributing to FraiseQL! This document provides
 - **Chat**: Join our community discussions in GitHub Discussions
 - **Email**: Contact maintainer at lionel.hamayon@evolution-digitale.fr
 
-### Code of Conduct
-We are committed to providing a welcoming and inclusive community. By participating in this project, you agree to abide by our Code of Conduct (treating everyone with respect and kindness).
-
 ## 🏆 Recognition
 
 Contributors are recognized in: