chore: docs updates and linting fixes

Author: Goldziher

.task/languages/csharp.yml

@@ -81,17 +81,20 @@ tasks:
       - dotnet test Kreuzberg.Tests/Kreuzberg.Tests.csproj -c Release --verbosity detailed
 
   lint:
-    desc: Lint C# code for style violations with auto-fix (dotnet format)
-    dir: packages/csharp
+    desc: Lint all C# code for style violations with auto-fix (dotnet format)
     cmds:
-      - dotnet format Kreuzberg.slnx
+      - cmd: bash scripts/task/csharp-lint.sh fix
+        platforms: [linux, darwin]
+      - cmd: cd packages/csharp && dotnet format Kreuzberg.slnx
+        platforms: [windows]
 
   lint:check:
-    desc: Check C# code style violations without modifications (dotnet format verify)
-    dir: packages/csharp
+    desc: Check all C# code style violations without modifications (dotnet format verify)
     cmds:
-      - dotnet restore Kreuzberg.slnx
-      - dotnet format Kreuzberg.slnx --verify-no-changes
+      - cmd: bash scripts/task/csharp-lint.sh check
+        platforms: [linux, darwin]
+      - cmd: cd packages/csharp && dotnet restore Kreuzberg.slnx && dotnet format Kreuzberg.slnx --verify-no-changes
+        platforms: [windows]
 
   format:
     desc: Format C# code with automatic style corrections (dotnet format)
@@ -124,9 +127,18 @@ tasks:
       - dotnet list Kreuzberg.slnx package --outdated || true
 
   e2e:generate:
-    desc: Generate C# E2E tests from fixtures
+    desc: Generate and format C# E2E tests from fixtures
     cmds:
       - cargo run -p kreuzberg-e2e-generator -- generate --lang csharp --fixtures fixtures --output e2e
+      - task: e2e:format
+
+  e2e:format:
+    desc: Format C# E2E code
+    cmds:
+      - cmd: bash -c "cd e2e/csharp && dotnet format Kreuzberg.E2E.csproj"
+        platforms: [linux, darwin]
+      - cmd: cd e2e/csharp && dotnet format Kreuzberg.E2E.csproj
+        platforms: [windows]
 
   e2e:lint:
     desc: Lint C# E2E code

.task/languages/elixir.yml

@@ -67,16 +67,16 @@ tasks:
       - mix test --warnings-as-errors --exclude ocr
 
   lint:
-    desc: Lint Elixir code with Credo
-    dir: packages/elixir
+    desc: Lint all Elixir code with auto-fix (format + credo)
     cmds:
-      - mix credo suggest --all --strict
+      - cmd: bash scripts/task/elixir-lint.sh fix
+        platforms: [linux, darwin]
 
   lint:check:
-    desc: Check Elixir code with Credo (no fixes)
-    dir: packages/elixir
+    desc: Check all Elixir code linting without modifications
     cmds:
-      - mix credo --strict
+      - cmd: bash scripts/task/elixir-lint.sh check
+        platforms: [linux, darwin]
 
   format:
     desc: Format Elixir code
@@ -121,12 +121,20 @@ tasks:
       - mix docs
 
   e2e:generate:
-    desc: Generate Elixir E2E tests from fixtures
+    desc: Generate and format Elixir E2E tests from fixtures
     cmds:
       - cmd: bash scripts/task/e2e-generate.sh elixir
         platforms: [linux, darwin]
       - cmd: echo "E2E generation not yet supported on Windows - use WSL or CI"
         platforms: [windows]
+      - task: e2e:format
+
+  e2e:format:
+    desc: Format Elixir E2E code
+    dir: e2e/elixir
+    cmds:
+      - mix deps.get --quiet
+      - mix format
 
   e2e:test:
     desc: Run generated Elixir E2E tests

.task/languages/go.yml

@@ -149,14 +149,15 @@ tasks:
         platforms: [windows]
 
   e2e:generate:
-    desc: Generate Go E2E tests from fixtures
+    desc: Generate and format Go E2E tests from fixtures
     cmds:
       - cmd: bash scripts/task/e2e-generate.sh go
         platforms: [linux, darwin]
       - cmd: echo "E2E generation not yet supported on Windows - use WSL or CI"
         platforms: [windows]
       - cmd: bash scripts/e2e/go/format.sh
         platforms: [linux, darwin]
+      - task: e2e:lint
 
   e2e:lint:
     desc: Lint Go E2E code

.task/languages/java.yml

@@ -95,44 +95,28 @@ tasks:
         platforms: [windows]
 
   lint:
-    desc: Lint Java code for code quality issues (checkstyle + PMD static analysis)
-    dir: packages/java
+    desc: Lint all Java code with auto-fix (spotless + checkstyle + PMD)
     cmds:
-      - cmd: bash -c 'if [ -f ~/.sdkman/bin/sdkman-init.sh ]; then source ~/.sdkman/bin/sdkman-init.sh && sdk use java 25.0.1-tem && sdk use maven 3.9.11; fi && mvn checkstyle:check && mvn pmd:check pmd:cpd-check'
+      - cmd: bash scripts/task/java-lint.sh fix
         platforms: [linux, darwin]
-      - cmd: |
-          mvn checkstyle:check
-          mvn pmd:check pmd:cpd-check
-        platforms: [windows]
 
   lint:check:
-    desc: Check Java code quality without modifications (checkstyle + PMD analysis)
-    dir: packages/java
+    desc: Check all Java code linting without modifications
     cmds:
-      - cmd: bash -c 'if [ -f ~/.sdkman/bin/sdkman-init.sh ]; then source ~/.sdkman/bin/sdkman-init.sh && sdk use java 25.0.1-tem && sdk use maven 3.9.11; fi && mvn checkstyle:check && mvn pmd:check pmd:cpd-check'
+      - cmd: bash scripts/task/java-lint.sh check
         platforms: [linux, darwin]
-      - cmd: |
-          mvn checkstyle:check
-          mvn pmd:check pmd:cpd-check
-        platforms: [windows]
 
   format:
-    desc: Format Java code with automatic style corrections (spotless)
-    dir: packages/java
+    desc: Format all Java code (spotless)
     cmds:
-      - cmd: bash -c 'if [ -f ~/.sdkman/bin/sdkman-init.sh ]; then source ~/.sdkman/bin/sdkman-init.sh && sdk use java 25.0.1-tem && sdk use maven 3.9.11; fi && mvn spotless:apply'
+      - cmd: bash scripts/task/java-lint.sh fix
         platforms: [linux, darwin]
-      - cmd: mvn spotless:apply
-        platforms: [windows]
 
   format:check:
-    desc: Check Java code formatting without modifications (spotless)
-    dir: packages/java
+    desc: Check all Java code formatting (spotless)
     cmds:
-      - cmd: bash -c 'if [ -f ~/.sdkman/bin/sdkman-init.sh ]; then source ~/.sdkman/bin/sdkman-init.sh && sdk use java 25.0.1-tem && sdk use maven 3.9.11; fi && mvn spotless:check'
+      - cmd: bash scripts/task/java-lint.sh check
         platforms: [linux, darwin]
-      - cmd: mvn spotless:check
-        platforms: [windows]
 
   clean:
     desc: Clean Java build artifacts
@@ -161,12 +145,20 @@ tasks:
         platforms: [windows]
 
   e2e:generate:
-    desc: Generate Java E2E tests from fixtures
+    desc: Generate and format Java E2E tests from fixtures
     cmds:
       - cmd: bash scripts/task/e2e-generate.sh java
         platforms: [linux, darwin]
       - cmd: echo "E2E generation not yet supported on Windows - use WSL or CI"
         platforms: [windows]
+      - task: e2e:format
+
+  e2e:format:
+    desc: Format Java E2E code
+    dir: e2e/java
+    cmds:
+      - cmd: bash -c 'if [ -f ~/.sdkman/bin/sdkman-init.sh ]; then source ~/.sdkman/bin/sdkman-init.sh && sdk use java 25.0.1-tem && sdk use maven 3.9.11; fi && if grep -q spotless-maven-plugin pom.xml; then mvn -q spotless:apply; fi'
+        platforms: [linux, darwin]
 
   e2e:lint:
     desc: Lint Java E2E code

.task/languages/node.yml

@@ -112,12 +112,13 @@ tasks:
       - pnpm up --latest
 
   e2e:generate:
-    desc: Generate TypeScript E2E tests
+    desc: Generate and format TypeScript E2E tests
     cmds:
       - cmd: bash scripts/task/e2e-typescript-generate.sh
         platforms: [linux, darwin]
       - cmd: echo "E2E generation not yet supported on Windows - use WSL or CI"
         platforms: [windows]
+      - task: e2e:lint
 
   e2e:lint:
     desc: Lint TypeScript E2E code

.task/languages/php.yml

@@ -86,18 +86,16 @@ tasks:
       - composer exec -- phpunit --coverage-html=coverage
 
   lint:
-    desc: Lint PHP code with auto-fix (php-cs-fixer + phpstan)
-    dir: packages/php
+    desc: Lint all PHP code with auto-fix (php-cs-fixer + phpstan)
     cmds:
-      - composer exec -- php-cs-fixer fix
-      - composer exec -- phpstan analyse --memory-limit=512M
+      - cmd: bash scripts/task/php-lint.sh fix
+        platforms: [linux, darwin]
 
   lint:check:
-    desc: Lint PHP code in check-only mode (php-cs-fixer + phpstan, no fixes)
-    dir: packages/php
+    desc: Lint all PHP code in check-only mode (php-cs-fixer + phpstan, no fixes)
     cmds:
-      - composer exec -- php-cs-fixer fix --dry-run --diff
-      - composer exec -- phpstan analyse --memory-limit=512M
+      - cmd: bash scripts/task/php-lint.sh check
+        platforms: [linux, darwin]
 
   lint:phpstan:
     desc: Run static analysis with PHPStan
@@ -148,13 +146,20 @@ tasks:
       - composer outdated
 
   e2e:generate:
-    desc: Generate PHP E2E tests from fixtures
-    dir: packages/php
+    desc: Generate and format PHP E2E tests from fixtures
     cmds:
       - cmd: bash scripts/task/e2e-generate.sh php
         platforms: [linux, darwin]
       - cmd: echo "E2E generation not yet supported on Windows - use WSL or CI"
         platforms: [windows]
+      - task: e2e:format
+
+  e2e:format:
+    desc: Format PHP E2E code
+    dir: e2e/php
+    cmds:
+      - cmd: bash -c "../../packages/php/vendor/bin/php-cs-fixer fix --rules='@PSR12,@PHP82Migration' --path-mode=override ."
+        platforms: [linux, darwin]
 
   e2e:lint:
     desc: Lint PHP E2E code

.task/languages/python.yml

@@ -147,12 +147,13 @@ tasks:
       - uv pip list --outdated || true
 
   e2e:generate:
-    desc: Generate Python E2E tests from fixtures
+    desc: Generate and format Python E2E tests from fixtures
     cmds:
       - cmd: bash scripts/task/e2e-generate.sh python
         platforms: [linux, darwin]
       - cmd: echo "E2E generation not yet supported on Windows - use WSL or CI"
         platforms: [windows]
+      - task: e2e:lint
 
   e2e:lint:
     desc: Lint Python E2E test code

.task/languages/r.yml

@@ -119,12 +119,19 @@ tasks:
       - R CMD INSTALL --no-multiarch --with-keep.source .
 
   e2e:generate:
-    desc: Generate R E2E tests from fixtures
+    desc: Generate and format R E2E tests from fixtures
     cmds:
       - cmd: bash scripts/task/e2e-generate.sh r
         platforms: [linux, darwin]
       - cmd: echo "E2E generation not yet supported on Windows"
         platforms: [windows]
+      - task: e2e:format
+
+  e2e:format:
+    desc: Format R E2E code
+    dir: e2e/r
+    cmds:
+      - Rscript -e "styler::style_dir('tests')"
 
   e2e:test:
     desc: Run R E2E tests

.task/languages/ruby.yml

@@ -87,30 +87,28 @@ tasks:
       - "{{.BUNDLE}} exec rspec --format documentation --color"
 
   lint:
-    desc: Auto-fix Ruby code linting (rubocop + steep)
-    dir: packages/ruby
+    desc: Lint all Ruby code with auto-fix (rubocop + steep across all directories)
     cmds:
-      - "{{.BUNDLE}} exec rubocop --config .rubocop.yml --autocorrect-all"
-      - "{{.BUNDLE}} exec steep check"
+      - cmd: bash scripts/task/ruby-lint.sh fix
+        platforms: [linux, darwin]
 
   lint:check:
-    desc: Check Ruby code linting without modifications (rubocop + steep, no fixes)
-    dir: packages/ruby
+    desc: Check all Ruby code linting without modifications (rubocop + steep)
     cmds:
-      - "{{.BUNDLE}} exec rubocop --config .rubocop.yml"
-      - "{{.BUNDLE}} exec steep check"
+      - cmd: bash scripts/task/ruby-lint.sh check
+        platforms: [linux, darwin]
 
   format:
-    desc: Format Ruby code with modifications (rubocop)
-    dir: packages/ruby
+    desc: Format all Ruby code with modifications (rubocop across all directories)
     cmds:
-      - "{{.BUNDLE}} exec rubocop --config .rubocop.yml --autocorrect-all"
+      - cmd: bash scripts/task/ruby-lint.sh fix
+        platforms: [linux, darwin]
 
   format:check:
-    desc: Check Ruby code formatting without modifications (rubocop)
-    dir: packages/ruby
+    desc: Check all Ruby code formatting without modifications (rubocop)
     cmds:
-      - "{{.BUNDLE}} exec rubocop --config .rubocop.yml"
+      - cmd: bash scripts/task/ruby-lint.sh check
+        platforms: [linux, darwin]
 
   typecheck:
     desc: Run steep type checking
@@ -141,12 +139,13 @@ tasks:
       - "{{.BUNDLE}} outdated || true"
 
   e2e:generate:
-    desc: Generate Ruby E2E tests from fixtures
+    desc: Generate and auto-fix Ruby E2E tests from fixtures
     cmds:
       - cmd: bash scripts/task/e2e-generate.sh ruby
         platforms: [linux, darwin]
       - cmd: echo "E2E generation not yet supported on Windows - use WSL or CI"
         platforms: [windows]
+      - task: e2e:format
 
   e2e:test:
     desc: Run Ruby E2E tests
@@ -155,11 +154,16 @@ tasks:
       - BUNDLE_GEMFILE="../../packages/ruby/Gemfile" {{.BUNDLE}} exec rspec
 
   e2e:lint:
-    desc: Lint Ruby E2E code
+    desc: Lint Ruby E2E code (check only)
+    dir: e2e/ruby
+    cmds:
+      - "{{.BUNDLE}} exec rubocop --config .rubocop.yaml"
+
+  e2e:format:
+    desc: Auto-fix Ruby E2E code formatting
     dir: e2e/ruby
     cmds:
-      - BUNDLE_GEMFILE="../../packages/ruby/Gemfile" {{.BUNDLE}} exec rubocop --config .rubocop.yml
-      - BUNDLE_GEMFILE="../../packages/ruby/Gemfile" {{.BUNDLE}} exec steep check
+      - "{{.BUNDLE}} exec rubocop --config .rubocop.yaml --autocorrect-all"
 
   e2e:verify:
     desc: Regenerate and validate Ruby E2E suite (generate + lint + test)

.task/languages/rust.yml

@@ -284,12 +284,14 @@ tasks:
       - cargo update --manifest-path tests/test_apps/rust/Cargo.toml
 
   e2e:generate:
-    desc: Generate Rust E2E tests from fixtures
+    desc: Generate and format Rust E2E tests from fixtures
     cmds:
       - cmd: bash scripts/task/e2e-generate.sh rust
         platforms: [linux, darwin]
       - cmd: echo "E2E generation not yet supported on Windows - use WSL or CI"
         platforms: [windows]
+      - task: e2e:format
+      - task: e2e:lint
 
   e2e:format:
     desc: Format generated Rust E2E sources