docs: per-module README + root navigation hub + CI/release workflows

- README.md в каждом подмодуле: для библиотек — описание проблемы, подключение через maven-central/caffeine, версии в gradle/libs.versions.toml. Для запускаемых модулей — команды запуска + переменные среды с дефолтами. - Корневой README.md переписан как навигационный хаб: что это, где клиенты, где серверы, как собрать, как опубликовать. - build.gradle.kts: per-module POM-description через единую карту в rootProject.extra (порядок важен — нужно ДО apply плагина KMP, поэтому beforeEvaluate в subprojects). - .gitea/workflows/ci.yml (новый): build + jvmTest + shadowJar на PR/push main. - .gitea/workflows/release.yml (обновлён): публикует библиотеки в caffeine Nexus + собирает 3 fatjar'а и крепит их к release как бинарные ассеты.
2026-09-16 16:24:03 +03:00
parent e68db11aaa
commit 0fdc12695e
18 changed files with 1279 additions and 364 deletions
@@ -0,0 +1,88 @@
+# PR / push-build. Прогоняет unit-тесты на JVM и линтер gradle-плагинов.
+# Артефакты не публикует — этим занимается .gitea/workflows/release.yml.
+#
+# Требуемые Gitea Action Secrets: нет (только gradle-cache).
+# Опционально: GRADLE_DOWNLOAD_TOKEN — если хочется переиспользовать кэш между
+# репами (через actions/cache + restore-keys).
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-jvm:
+    name: JVM build + tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'adopt'
+
+      - name: Gradle cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.gradle/caches
+            ~/.gradle/wrapper
+            .gradle
+          key: ${{ runner.os }}-gradle-agentik-${{ hashFiles('**/*.gradle.kts', '**/gradle/libs.versions.toml', 'gradle/wrapper/gradle-wrapper.properties') }}
+          restore-keys: |
+            ${{ runner.os }}-gradle-agentik-
+
+      - name: Build + test (JVM only — самые быстрые таргеты)
+        shell: bash
+        run: |
+          ./gradlew jvmTest \
+            -Dorg.gradle.jvmargs=-Xmx4096M \
+            --no-daemon --no-watch-fs --stacktrace
+
+      - name: Build :standalone shadowJar (smoke — запускаемый артефакт)
+        shell: bash
+        run: |
+          ./gradlew :standalone:shadowJar \
+            -Dorg.gradle.jvmargs=-Xmx4096M \
+            --no-daemon --no-watch-fs --stacktrace
+          test -f standalone/build/libs/standalone-all.jar \
+            && echo "shadowJar OK: $(du -h standalone/build/libs/standalone-all.jar)"
+
+      - name: Build :agentik-cli shadowJar
+        shell: bash
+        run: |
+          ./gradlew :agentik-cli:shadowJar \
+            -Dorg.gradle.jvmargs=-Xmx4096M \
+            --no-daemon --no-watch-fs --stacktrace
+          test -f agentik-cli/build/libs/agentik-cli-all.jar \
+            && echo "shadowJar OK: $(du -h agentik-cli/build/libs/agentik-cli-all.jar)"
+
+      - name: Build :agentik-tui shadowJar
+        shell: bash
+        run: |
+          ./gradlew :agentik-tui:shadowJar \
+            -Dorg.gradle.jvmargs=-Xmx4096M \
+            --no-daemon --no-watch-fs --stacktrace
+          test -f agentik-tui/build/libs/agentik-tui-all.jar \
+            && echo "shadowJar OK: $(du -h agentik-tui/build/libs/agentik-tui-all.jar)"
+
+      - name: Upload shadowJars
+        uses: actions/upload-artifact@v4
+        with:
+          name: agentik-jars
+          path: |
+            standalone/build/libs/standalone-all.jar
+            agentik-cli/build/libs/agentik-cli-all.jar
+            agentik-tui/build/libs/agentik-tui-all.jar
+          if-no-files-found: error
+          retention-days: 7
@@ -1,9 +1,7 @@
 # Триггерится при публикации релиза в Gitea. Публикует все KMP-библиотеки
-# (jvm + native таргеты) в домашний Nexus-репозиторий "caffeine".
-#
-# Сборку :standalone fatjar'a и прикрепление JAR к release было решено убрать
-# из CI (2026-09-15, итерация с публикацией затянулась). JAR собирается локально
-# через `./gradlew :standalone:shadowJar` — его достаточно для запуска.
+# (jvm + native таргеты) в домашний Nexus-репозиторий "caffeine", а также
+# собирает fatjar'ы запускаемых модулей и прикрепляет их к релизу как
+# бинарные ассеты.
 #
 # Требуемые Gitea Action Variables:
 #   BINOM_REPO_URL — например http://nexus.xx/repository/caffeine/
@@ -15,10 +13,15 @@ on:
  release:
    types: [published]

+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
 jobs:
  publish-libraries:
    name: Publish KMP libraries → caffeine Nexus
    runs-on: ubuntu-latest
+    timeout-minutes: 120
    steps:
      - name: Checkout
        uses: actions/checkout@v4
@@ -29,7 +32,18 @@ jobs:
          java-version: '21'
          distribution: 'adopt'

-      - name: Publish libraries
+      - name: Gradle cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.gradle/caches
+            ~/.gradle/wrapper
+            .gradle
+          key: ${{ runner.os }}-gradle-agentik-${{ hashFiles('**/*.gradle.kts', '**/gradle/libs.versions.toml', 'gradle/wrapper/gradle-wrapper.properties') }}
+          restore-keys: |
+            ${{ runner.os }}-gradle-agentik-
+
+      - name: Publish libraries (all KMP targets, all modules)
        shell: bash
        env:
          BINOM_REPO_USER: ${{ secrets.BINOM_REPO_USER }}
@@ -44,3 +58,76 @@ jobs:
            publish \
            -Dorg.gradle.jvmargs=-Xmx4096M \
            --no-daemon --no-watch-fs --stacktrace
+
+  build-fatjars:
+    name: Build runnable fatjars
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'adopt'
+
+      - name: Gradle cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.gradle/caches
+            ~/.gradle/wrapper
+            .gradle
+          key: ${{ runner.os }}-gradle-agentik-${{ hashFiles('**/*.gradle.kts', '**/gradle/libs.versions.toml', 'gradle/wrapper/gradle-wrapper.properties') }}
+          restore-keys: |
+            ${{ runner.os }}-gradle-agentik-
+
+      - name: Build :standalone shadowJar
+        shell: bash
+        run: |
+          ./gradlew :standalone:shadowJar \
+            -Pdisable-javadoc=true \
+            -Dorg.gradle.jvmargs=-Xmx4096M \
+            --no-daemon --no-watch-fs --stacktrace
+
+      - name: Build :agentik-cli shadowJar
+        shell: bash
+        run: |
+          ./gradlew :agentik-cli:shadowJar \
+            -Pdisable-javadoc=true \
+            -Dorg.gradle.jvmargs=-Xmx4096M \
+            --no-daemon --no-watch-fs --stacktrace
+
+      - name: Build :agentik-tui shadowJar
+        shell: bash
+        run: |
+          ./gradlew :agentik-tui:shadowJar \
+            -Pdisable-javadoc=true \
+            -Dorg.gradle.jvmargs=-Xmx4096M \
+            --no-daemon --no-watch-fs --stacktrace
+
+      - name: Upload fatjars as release assets
+        uses: actions/upload-artifact@v4
+        with:
+          name: agentik-fatjars
+          path: |
+            standalone/build/libs/standalone-all.jar
+            agentik-cli/build/libs/agentik-cli-all.jar
+            agentik-tui/build/libs/agentik-tui-all.jar
+          if-no-files-found: error
+          retention-days: 90
+
+      - name: Attach to release
+        uses: https://git.binom.pw/actions/forgejo-release@v1
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          url: ${{ github.server_url }}
+          repo: ${{ github.repository }}
+          token: ${{ secrets.GITEA_TOKEN }}
+          tag: ${{ github.ref_name }}
+          files: |
+            standalone/build/libs/standalone-all.jar
+            agentik-cli/build/libs/agentik-cli-all.jar
+            agentik-tui/build/libs/agentik-tui-all.jar