vgi-java/.github/workflows/ci.yml at main · Query-farm/vgi-java · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
# Copyright 2026 Query Farm LLC - https://query.farm
#
# Unit tests and a javadoc build for the SDK itself. The Integration suite
# workflow covers the protocol end-to-end against a real DuckDB, but it only
# ever compiles the example worker -- vgi/src/test carried 278 JUnit tests that
# nothing in CI ran. This workflow is that gate.
#
# Resolve the same Maven Central RPC dependencies as published SDK consumers.
name: CI

on:
  push:
  pull_request:
  workflow_dispatch:

permissions:
  contents: read

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true

env:
  # Disable local sibling substitution: validate the released Maven dependency.
  VGI_RPC_JAVA_DIR: /nonexistent

jobs:
  test:
    name: Unit tests (JDK 25)
    runs-on: ubuntu-latest
    steps:
      - name: Checkout vgi-java
        uses: actions/checkout@v4

      - name: Set up JDK 25
        uses: actions/setup-java@v4
        with:
          distribution: temurin
          java-version: '25'

      - name: Cache Gradle
        uses: actions/cache@v4
        with:
          path: |
            ~/.gradle/caches
            ~/.gradle/wrapper
          key: gradle-${{ runner.os }}-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
          restore-keys: gradle-${{ runner.os }}-

      - name: Unit tests
        run: ./gradlew --no-daemon :vgi:test

      # The published artifact carries javadoc, so a doc comment that does not
      # build is a broken release, not a warning.
      - name: Javadoc
        run: ./gradlew --no-daemon :vgi:javadoc

      - name: Upload test report on failure
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: test-results
          path: vgi/build/reports/tests/test

  # vgi-rpc's hosted-protocols group against the example worker on stdio, unix
  # and HTTP: conformance.Secondary.v1 hosted beside vgi.v2 through
  # Worker.hostedProtocols, the error model, the traceback policy, and over HTTP
  # the vgi_rpc.Identity.v2 conformance policy (--identity).
  #
  # The reference is cloned from main, deliberately unpinned -- the same pattern
  # vgi-rpc-java's conformance lanes use: it is the yardstick, and a pinned
  # yardstick lets a lane stay green against a stale contract.
  hosted-protocols:
    name: Hosted protocols (stdio, unix, http)
    runs-on: ubuntu-latest
    steps:
      - name: Checkout vgi-java
        uses: actions/checkout@v4

      - name: Set up JDK 25
        uses: actions/setup-java@v4
        with:
          distribution: temurin
          java-version: '25'

      - name: Set up Python 3.13
        uses: actions/setup-python@v5
        with:
          python-version: '3.13'

      - name: Cache Gradle
        uses: actions/cache@v4
        with:
          path: |
            ~/.gradle/caches
            ~/.gradle/wrapper
          key: gradle-${{ runner.os }}-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
          restore-keys: gradle-${{ runner.os }}-

      - name: Clone vgi-rpc-python reference (main, deliberately unpinned)
        run: git clone --depth 1 https://github.com/Query-farm/vgi-rpc-python.git "$RUNNER_TEMP/vgi-rpc-python"

      - name: Install the reference's conformance runner
        run: |
          python -m pip install --upgrade pip
          python -m pip install "$RUNNER_TEMP/vgi-rpc-python[http,conformance]" pytest pytest-timeout

      - name: Build example worker
        run: ./gradlew --no-daemon :vgi-example-worker:installDist

      - name: Run hosted-protocols group
        run: ci/run-hosted-protocols.sh
        env:
          VGI_WORKER_BIN: ${{ github.workspace }}/vgi-example-worker/build/install/vgi-example-worker/bin/vgi-example-worker