docs: README/docs audit, gh-pages source, fix links and metrics

- README/README.ru: Discussions→Issues, support email, factual metrics
- docs: faq, getting-started, contributing, performance wording
- gh-pages: new folder for GitHub Pages, workflow deploys from it
- SDK kotlin-enhanced: commonMain/jvmMain/iosMain layout
- Remove openapi.ru.yaml links (use openapi.yaml)

Author: MaxLuxs

.github/workflows/pages.yml

@@ -5,7 +5,7 @@ on:
     branches:
       - main
     paths:
-      - 'docs/**'
+      - 'gh-pages/**'
       - '.github/workflows/pages.yml'
   workflow_dispatch:
 
@@ -34,7 +34,7 @@ jobs:
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: './docs'
+          path: './gh-pages'
 
       - name: Deploy to GitHub Pages
         id: deployment

.github/workflows/release.yml

@@ -101,14 +101,59 @@ jobs:
         run: |
           ./gradlew build --no-daemon -x test
           ./gradlew :backend:distZip --no-daemon
-          ./gradlew :backend:jar :ktor-flagent:jar :kotlin-client:jar :kotlin-client:sourcesJar :kotlin-client:javadocJar --no-daemon
+          ./gradlew :backend:jar :ktor-flagent:jar :kotlin-client:jar :kotlin-client:sourcesJar :kotlin-client:javadocJar :kotlin-enhanced:jar :kotlin-debug-ui:jar :java-client:jar :java-client:sourcesJar :java-client:javadocJar :flagent-spring-boot-starter:jar :flagent-spring-boot-starter:sourcesJar --no-daemon
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Set version for JS SDKs
+        id: js_version
+        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> "$GITHUB_OUTPUT"
+
+      - name: Build and pack JavaScript SDKs
+        run: |
+          VERSION="${{ steps.js_version.outputs.VERSION }}"
+          for dir in sdk/javascript sdk/javascript-enhanced sdk/javascript-debug-ui; do
+            (cd "$dir" && sed -i "s/\"version\": \"[^\"]*\"/\"version\": \"$VERSION\"/" package.json && npm install && npm run build && npm pack)
+          done
+
+      - name: Pack Go SDKs
+        run: |
+          VERSION="${GITHUB_REF#refs/tags/v}"
+          tar czvf flagent-go-sdk-$VERSION.tar.gz -C sdk go
+          tar czvf flagent-go-enhanced-sdk-$VERSION.tar.gz -C sdk go-enhanced
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Build and pack Python SDK
+        run: |
+          VERSION="${GITHUB_REF#refs/tags/v}"
+          cd sdk/python
+          sed -i "s/version=\"[^\"]*\"/version=\"$VERSION\"/" setup.py
+          sed -i "s/__version__ = \"[^\"]*\"/__version__ = \"$VERSION\"/" src/flagent/__init__.py 2>/dev/null || true
+          pip install build
+          python -m build --sdist --wheel
+          mv dist/*.tar.gz dist/*.whl ../..
+          cd ../..
+
+      - name: Pack Swift SDKs
+        run: |
+          VERSION="${GITHUB_REF#refs/tags/v}"
+          tar czvf flagent-swift-sdk-$VERSION.tar.gz -C sdk swift
+          tar czvf flagent-swift-enhanced-sdk-$VERSION.tar.gz -C sdk swift-enhanced
+          tar czvf flagent-swift-debug-ui-sdk-$VERSION.tar.gz -C sdk swift-debug-ui
 
       - name: Publish to GitHub Packages
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           VERSION="${GITHUB_REF#refs/tags/v}"
-          ./gradlew :shared:publish :ktor-flagent:publish :kotlin-client:publish :kotlin-enhanced:publish :kotlin-debug-ui:publish --no-daemon -Pversion="$VERSION"
+          ./gradlew :shared:publish :ktor-flagent:publish :kotlin-client:publish :kotlin-enhanced:publish :kotlin-debug-ui:publish :java-client:publish :flagent-spring-boot-starter:publish --no-daemon -Pversion="$VERSION"
       
       - name: Extract version from tag
         id: tag
@@ -126,5 +171,19 @@ jobs:
             backend/build/libs/*.jar
             ktor-flagent/build/libs/*.jar
             sdk/kotlin/build/libs/*.jar
+            sdk/kotlin-enhanced/build/libs/*.jar
+            sdk/kotlin-debug-ui/build/libs/*.jar
+            sdk/java/build/libs/*.jar
+            sdk/spring-boot-starter/build/libs/*.jar
+            sdk/javascript/*.tgz
+            sdk/javascript-enhanced/*.tgz
+            sdk/javascript-debug-ui/*.tgz
+            flagent-go-sdk-*.tar.gz
+            flagent-go-enhanced-sdk-*.tar.gz
+            flagent-python-client-*.tar.gz
+            flagent_python_client-*.whl
+            flagent-swift-sdk-*.tar.gz
+            flagent-swift-enhanced-sdk-*.tar.gz
+            flagent-swift-debug-ui-sdk-*.tar.gz
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

README.md

@@ -36,7 +36,7 @@
 
   <p>
     <a href="#-quick-start">Quick Start</a> •
-    <a href="https://maxluxs.github.io/Flagent">Documentation</a> •
+    <a href="https://maxluxs.github.io/Flagent/getting-started.md">Documentation</a> •
     <a href="#-key-features">Features</a> •
     <a href="#-sdks">SDKs</a> •
     <a href="#-use-cases">Use Cases</a> •
@@ -63,8 +63,8 @@
 - **A/B Insights** - Automated experiment analysis
 
 ### Enterprise-Ready
-- **Production-Proven** - 70+ test files, comprehensive coverage
-- **High Performance** - Sub-millisecond evaluation, 10k+ req/s
+- **Extensive test coverage** - 200+ test files
+- **High Performance** - Low latency, high throughput (see backend PerformanceTest: >100 req/s)
 - **Multi-Tenancy** - Isolated environments for teams (Roadmap)
 - **Real-Time Updates** - SSE in Kotlin Enhanced, Go Enhanced
 
@@ -93,8 +93,8 @@ open http://localhost:18000
 - ✅ **Advanced Targeting** - Segment users by attributes, percentages, or complex constraint rules
 - ✅ **Multi-Environment** - Separate configurations for dev, staging, and production
 - ✅ **Data Recorders** - Kafka, Kinesis, PubSub integration for analytics
-- ✅ **High Performance** - Sub-millisecond evaluation with EvalCache and TTL
-- ✅ **Client-Side Evaluation** - Offline-first local evaluation (< 1ms) in Kotlin Enhanced, Go Enhanced
+- ✅ **High Performance** - Low-latency evaluation with EvalCache and TTL
+- ✅ **Client-Side Evaluation** - Offline-first local evaluation in Kotlin Enhanced, Go Enhanced
 - ✅ **Real-Time Updates** - SSE for instant flag changes in Kotlin Enhanced, Go Enhanced
 - ✅ **Multiple Databases** - PostgreSQL, MySQL, SQLite support
 - ✅ **Docker Ready** - Production-ready Docker images with Compose
@@ -112,10 +112,10 @@ open http://localhost:18000
 
 ## 📖 Documentation
 
-- 📖 **[Full Documentation](https://maxluxs.github.io/Flagent)** - Complete guides, API reference, and examples
-- 📖 **[Getting Started Guide](README.md#-quick-start)** - Quick start and setup instructions
-- 📖 **[API Documentation](https://maxluxs.github.io/Flagent/api/openapi.yaml)** - OpenAPI specification
-- 📖 **[Architecture Documentation](https://maxluxs.github.io/Flagent/#/architecture/backend)** - System architecture and design
+- 📖 **[Getting Started](https://maxluxs.github.io/Flagent/getting-started.md)** - Quick start and setup
+- 📖 **[API Reference](https://maxluxs.github.io/Flagent)** - API docs and OpenAPI
+- 📖 **[OpenAPI spec](https://maxluxs.github.io/Flagent/api/openapi.yaml)** - OpenAPI specification
+- 📖 **[Architecture](https://maxluxs.github.io/Flagent/architecture/backend.md)** - System design
 
 ## 🏗️ Project Structure
 
@@ -134,7 +134,7 @@ flagent/
 
 ### Requirements
 - JDK 21+
-- Gradle 9.0
+- Gradle 8.13 (wrapper)
 
 ### Build
 ```bash
@@ -213,7 +213,7 @@ Published artifacts: `shared` (KMP: root + `shared-jvm`, `shared-js`), `ktor-fla
 
 - **Ktor Plugin** - [ktor-flagent](ktor-flagent) - First-class Ktor integration with middleware support
 
-See [SDK Documentation](https://maxluxs.github.io/Flagent) for detailed usage guides.
+See [Getting Started](https://maxluxs.github.io/Flagent/getting-started.md) and [API Reference](https://maxluxs.github.io/Flagent) for usage guides.
 
 ## 🛠️ Technology Stack
 
@@ -250,7 +250,7 @@ cd Flagent
 ./gradlew :backend:run
 ```
 
-See [Deployment Guide](https://maxluxs.github.io/Flagent/#/deployment) for production setup.
+See [Deployment Guide](https://maxluxs.github.io/Flagent/deployment.md) for production setup.
 
 ## 🤝 Contributing
 
@@ -260,7 +260,7 @@ We welcome contributions from the community! Flagent is built with love by devel
 
 1. **Fork the repository**
 2. **Create your feature branch** (`git checkout -b feature/amazing-feature`)
-3. **Make your changes** - Follow our [code style guidelines](https://maxluxs.github.io/Flagent/#/contributing)
+3. **Make your changes** - Follow our [code style guidelines](https://maxluxs.github.io/Flagent/contributing.md)
 4. **Add tests** - Ensure your changes are well-tested
 5. **Commit your changes** (`git commit -m 'Add some amazing feature'`)
 6. **Push to the branch** (`git push origin feature/amazing-feature`)
@@ -276,7 +276,7 @@ We welcome contributions from the community! Flagent is built with love by devel
 - ⚡ **Performance** - Optimize evaluation speed
 - 🧪 **Tests** - Increase test coverage
 
-For more details, see our [Contributing Guide](https://maxluxs.github.io/Flagent/#/contributing) and [Development Setup](README.md#development).
+For more details, see our [Contributing Guide](https://maxluxs.github.io/Flagent/contributing.md) and [Development Setup](README.md#development).
 
 ## 📄 License
 
@@ -341,9 +341,8 @@ Join our growing community of developers building better feature flag systems!
 
 ### Get Help
 
-- 💬 **[GitHub Discussions](https://github.com/MaxLuxs/Flagent/discussions)** - Ask questions, share ideas, and connect with other users
-- 🐛 **[GitHub Issues](https://github.com/MaxLuxs/Flagent/issues)** - Report bugs or request new features
-- 📚 **[Documentation](https://maxluxs.github.io/Flagent)** - Comprehensive guides, API reference, and tutorials
+- 🐛 **[GitHub Issues](https://github.com/MaxLuxs/Flagent/issues)** - Ask questions, report bugs, or request features
+- 📚 **[Documentation](https://maxluxs.github.io/Flagent/getting-started.md)** - Guides and API reference
 - 💻 **[Code Examples](samples)** - Real-world examples in Kotlin, Python, JavaScript, Swift, and Go
 - 🎯 **[Roadmap](docs/roadmap.md)** - Our journey to becoming the best open-source feature flag platform
 
@@ -362,7 +361,7 @@ Need help deploying Flagent in production? Want custom features or SLA guarantee
 - 🔒 **Priority Support** - Faster response times and dedicated Slack channel
 - 🚀 **Managed Hosting** (Coming Soon) - Fully managed SaaS solution
 
-Contact us at: **support@flagent.io** (Coming Soon)
+Contact: **max.developer.luxs@gmail.com**
 
 ## 🎯 Use Cases
 
@@ -377,11 +376,11 @@ Contact us at: **support@flagent.io** (Coming Soon)
 
 ## 📊 Performance & Scalability
 
-- **Sub-millisecond latency** - Typical evaluation time under 1ms
-- **10,000+ evaluations/second** per instance
+- **Low latency** - Typical evaluation under 10ms (see backend PerformanceTest)
+- **High throughput** - 100+ req/s per instance (see backend PerformanceTest)
 - **Horizontal scaling** - Stateless architecture supports multiple instances
-- **Low memory footprint** - ~200MB base memory usage
-- **EvalCache with TTL** - Intelligent caching reduces database load by 90%
+- **Modest memory** - Approximately 200MB typical base usage
+- **EvalCache with TTL** - Caching significantly reduces database load
 - **Deterministic bucketing** - Consistent user assignments using MurmurHash3
 
 ## 👥 Who's Using Flagent?
@@ -392,14 +391,15 @@ Flagent is trusted by teams building high-performance Kotlin applications:
 - 🔬 **Research Projects** - Used in academic and research environments
 - 🏢 **Internal Tools** - Powering feature flags for internal applications
 
-*Are you using Flagent in production? [Let us know!](https://github.com/MaxLuxs/Flagent/discussions/new?category=show-and-tell)*
+*Are you using Flagent in production? [Let us know](https://github.com/MaxLuxs/Flagent/issues) or email max.developer.luxs@gmail.com.*
 
 ## 🔗 Links
 
-- 📖 **[Documentation](https://maxluxs.github.io/Flagent)**
-- 🐳 **[Docker Hub](https://github.com/MaxLuxs/Flagent/pkgs/container/flagent)**
+- 📖 **[Documentation](https://maxluxs.github.io/Flagent/getting-started.md)**
+- 📖 **[API Reference](https://maxluxs.github.io/Flagent)**
+- 🐳 **[Container image (GHCR)](https://github.com/MaxLuxs/Flagent/pkgs/container/flagent)**
 - 📦 **[Releases](https://github.com/MaxLuxs/Flagent/releases)**
-- 💬 **[Discussions](https://github.com/MaxLuxs/Flagent/discussions)**
+- 🐛 **[Issues](https://github.com/MaxLuxs/Flagent/issues)**
 
 ---
 

README.ru.md

@@ -37,8 +37,8 @@
 - **A/B Insights** - Автоматический анализ экспериментов
 
 ### Enterprise-Ready
-- **Production-Proven** - 70+ тестовых файлов, комплексное покрытие
-- **Высокая производительность** - Sub-millisecond evaluation, 10k+ req/s
+- **Расширенное тестовое покрытие** - 200+ тестовых файлов
+- **Высокая производительность** - Низкая задержка, высокая пропускная способность (см. backend PerformanceTest: >100 req/s)
 - **Multi-Tenancy** - Изолированные окружения для команд (в планах)
 - **Real-Time обновления** - SSE в Kotlin Enhanced, Go Enhanced
 
@@ -67,7 +67,7 @@ open http://localhost:18000
 - ✅ **Продвинутый таргетинг** - Сегментация пользователей по атрибутам, процентам или сложным правилам ограничений
 - ✅ **Multi-Environment** - Отдельные конфигурации для dev, staging и production
 - ✅ **Data Recorders** - Интеграция с Kafka, Kinesis, PubSub для аналитики
-- ✅ **Высокая производительность** - Sub-millisecond evaluation с EvalCache и TTL
+- ✅ **Высокая производительность** - Низкая задержка evaluation с EvalCache и TTL
 - ✅ **Несколько БД** - Поддержка PostgreSQL, MySQL, SQLite
 - ✅ **Docker Ready** - Production-ready Docker образы с Compose
 - ✅ **Официальные SDK** - Kotlin, JavaScript/TypeScript, Swift, Python, Go с Enhanced вариантами
@@ -86,13 +86,13 @@ open http://localhost:18000
 
 ## 📖 Документация
 
-- 📖 **[Полная документация](https://maxluxs.github.io/Flagent)** - Полные руководства, справочник API и примеры
-- 📖 **[Руководство по началу работы](https://maxluxs.github.io/Flagent/#/getting-started_ru)** - Быстрый старт и инструкции по настройке
-- 📖 **[Документация API](https://maxluxs.github.io/Flagent/api/openapi.yaml)** - OpenAPI спецификация
-- 📖 **[Документация архитектуры](https://maxluxs.github.io/Flagent/#/architecture/backend)** - Системная архитектура и дизайн
-- 📖 **[Конфигурация](https://maxluxs.github.io/Flagent/#/configuration_ru)** - Настройка переменных окружения
-- 📖 **[Развертывание](https://maxluxs.github.io/Flagent/#/deployment_ru)** - Руководство по production развертыванию
-- 📖 **[Сценарии использования](https://maxluxs.github.io/Flagent/#/use-cases_ru)** - Примеры из реального мира
+- 📖 **[Начало работы](https://maxluxs.github.io/Flagent/getting-started.ru.md)** - Быстрый старт и настройка
+- 📖 **[API Reference](https://maxluxs.github.io/Flagent)** - Документация API
+- 📖 **[OpenAPI спецификация](https://maxluxs.github.io/Flagent/api/openapi.yaml)** - OpenAPI YAML
+- 📖 **[Архитектура](https://maxluxs.github.io/Flagent/architecture/backend.md)** - Дизайн системы
+- 📖 **[Конфигурация](https://maxluxs.github.io/Flagent/configuration.ru.md)** - Переменные окружения
+- 📖 **[Развертывание](https://maxluxs.github.io/Flagent/deployment.ru.md)** - Production развертывание
+- 📖 **[Сценарии использования](https://maxluxs.github.io/Flagent/use-cases.ru.md)** - Примеры
 
 ## 🏗️ Структура проекта
 
@@ -144,7 +144,7 @@ cd Flagent
 ./gradlew :backend:run
 ```
 
-См. [Руководство по развертыванию](https://maxluxs.github.io/Flagent/#/deployment_ru) для production настройки.
+См. [Руководство по развертыванию](https://maxluxs.github.io/Flagent/deployment.ru.md) для production настройки.
 
 ## 🎯 SDK и интеграции
 
@@ -309,10 +309,10 @@ Flagent полностью локализован для СНГ рынка:
 
 ## 💬 Сообщество и поддержка
 
-- 💬 **[GitHub Discussions](https://github.com/MaxLuxs/Flagent/discussions)** - Задавайте вопросы и делитесь идеями
-- 🐛 **[GitHub Issues](https://github.com/MaxLuxs/Flagent/issues)** - Сообщайте о багах или запрашивайте функции
-- 📚 **[Документация](https://maxluxs.github.io/Flagent)** - Полные руководства и справочник API
+- 🐛 **[GitHub Issues](https://github.com/MaxLuxs/Flagent/issues)** - Вопросы, баги, запросы функций
+- 📚 **[Документация](https://maxluxs.github.io/Flagent/getting-started.ru.md)** - Руководства и API
 - 💻 **[Примеры](samples)** - Примеры кода и туториалы
+- 📧 **Поддержка:** max.developer.luxs@gmail.com
 
 ## ⭐ Звезды
 

backend/docs/index.html

@@ -1316,7 +1316,7 @@
     }
   },
   "example" : {
-    "version" : "1.0.0",
+    "version" : "0.1.0",
     "buildTime" : "2024-01-01T00:00:00Z",
     "gitCommit" : "abc123"
   }
@@ -1718,7 +1718,7 @@ <h1>Flagent API</h1>
         <div id="header">
           <div id="api-_">
             <h2 id="welcome-to-apidoc">API and SDK Documentation</h2>
-              <div class="app-desc">Version: 1.0.0</div>
+              <div class="app-desc">Version: 0.1.0</div>
             <hr>
             <div><p>Flagent is a feature flagging, A/B testing and dynamic configuration microservice. The base path for all the APIs is &quot;/api/v1&quot;.</p>
 <h2>Authentication</h2>

build.gradle.kts

@@ -24,6 +24,15 @@ allprojects {
         google()
         maven("https://maven.pkg.jetbrains.space/public/p/compose/dev")
     }
+
+    // Replace org.lz4:lz4-java with at.yawk.lz4 fork to fix CVE-2025-12183, CVE-2025-66566 (transitive from kafka-clients)
+    configurations.all {
+        resolutionStrategy {
+            dependencySubstitution {
+                substitute(module("org.lz4:lz4-java")).using(module("at.yawk.lz4:lz4-java:1.10.2"))
+            }
+        }
+    }
 }
 
 subprojects {

docs/contributing.md

@@ -18,7 +18,7 @@ There are many ways to contribute to Flagent:
 ### Prerequisites
 
 - **JDK 21+** for backend development
-- **Gradle 9.0+** for building
+- **Gradle 8.13** (wrapper) for building
 - **Docker** for running services
 - **Git** for version control
 
@@ -266,9 +266,9 @@ Create an issue on [GitHub](https://github.com/MaxLuxs/Flagent/issues) with the
 
 ## Questions?
 
-- [GitHub Discussions](https://github.com/MaxLuxs/Flagent/discussions) - Ask questions
-- [GitHub Issues](https://github.com/MaxLuxs/Flagent/issues) - Report bugs or request features
+- [GitHub Issues](https://github.com/MaxLuxs/Flagent/issues) - Ask questions, report bugs, or request features
 - [Documentation](getting-started.md) - Read the documentation
+- **Contact** - max.developer.luxs@gmail.com
 
 ## Recognition