x0x 0.30.0

Agent-to-agent gossip network for AI systems — no winners, no losers, just cooperation
Documentation 
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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240

name: Integration & Soak Tests

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  schedule:
    - cron: '0 3 * * 1'  # Weekly Monday 3am UTC (soak)

env:
  CARGO_TERM_COLOR: always
  RUSTFLAGS: "-D warnings"

jobs:
  # ── Guardian: API coverage enforcement (every PR, ~30s) ────────────────
  api-coverage:
    name: API Coverage Guard
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
        with:
          submodules: recursive
      - name: Symlink dependencies
        run: |
          mkdir -p .deps
          git clone --depth 1 https://github.com/saorsa-labs/ant-quic .deps/ant-quic || true
          git clone --depth 1 https://github.com/saorsa-labs/saorsa-gossip .deps/saorsa-gossip || true
          ln -sf "$(pwd)/.deps/ant-quic" ../ant-quic
          ln -sf "$(pwd)/.deps/saorsa-gossip" ../saorsa-gossip
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - name: Run guardian tests
        run: cargo test --all-features --test api_coverage

  # ── Property tests (every PR, ~2min) ──────────────────────────────────
  proptest:
    name: Property Tests
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
        with:
          submodules: recursive
      - name: Symlink dependencies
        run: |
          mkdir -p .deps
          git clone --depth 1 https://github.com/saorsa-labs/ant-quic .deps/ant-quic || true
          git clone --depth 1 https://github.com/saorsa-labs/saorsa-gossip .deps/saorsa-gossip || true
          ln -sf "$(pwd)/.deps/ant-quic" ../ant-quic
          ln -sf "$(pwd)/.deps/saorsa-gossip" ../saorsa-gossip
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - uses: taiki-e/install-action@nextest
      - name: Run property tests
        # Scope compilation to ONLY the targets that host property tests
        # (--lib + the eight tests/proptest_*.rs binaries) instead of the
        # whole workspace. The full-workspace build links ~72 debug binaries
        # in parallel, which OOM-kills the runner at ~4m45s; this caps it to
        # ~9 targets and is several times faster.
        #
        # The filter is binary-scoped on purpose: the tests/proptest_*.rs
        # suites name their test functions descriptively (e.g.
        # `blocked_overrides_all`), NOT `proptest_*`, so a name filter like
        # `test(/proptest/)` silently matched only the 2 proptest-named tests
        # in src/presence.rs and skipped all 58 integration-file property
        # tests. `test(/^proptest_/) | test(/proptest/)` is kept to pull in
        # those presence lib tests; the eight `binary(...)` clauses cover the
        # rest. (60 tests total vs the prior 2.)
        # --build-jobs 2: belt-and-braces cap on parallel linking, since each
        # proptest binary links the (large) x0x crate.
        run: |
          cargo nextest run --all-features --build-jobs 2 --lib \
            --test proptest_connectivity --test proptest_crdt --test proptest_files \
            --test proptest_groups --test proptest_kv --test proptest_mls \
            --test proptest_presence --test proptest_trust \
            -E 'binary(proptest_connectivity) | binary(proptest_crdt) | binary(proptest_files) | binary(proptest_groups) | binary(proptest_kv) | binary(proptest_mls) | binary(proptest_presence) | binary(proptest_trust) | test(/^proptest_/) | test(/proptest/)'

  # ── Integration tests — split into parallel jobs (issue #197) ──────────
  #    The old monolithic `integration` job ran ~10 suites sequentially
  #    under a single 20-min ceiling and was structurally canceled at the
  #    wall-clock limit on every PR, despite all tests passing. It is now
  #    four jobs: three run in parallel on every PR (core + groups + net),
  #    and the de-flaked timing suites run only on the weekly schedule
  #    (mirroring the soak job's gating). Budgets assume a COLD rust-cache
  #    — new job names get fresh cache keys, so the first run pays the full
  #    release build; each PR job is capped at timeout-minutes: 20 and kept
  #    light enough to clear it with headroom. No suite is dropped —
  #    coverage is redistributed, not removed.
  #    --build-jobs 2 is intentionally omitted here: each nextest call
  #    targets a single test binary, so there's no parallel-linking OOM
  #    risk (unlike the proptest job, which links 8 binaries in one call).

  # Core: daemon API + D4 signed-commit suites (light load).
  integration-core:
    name: Integration (core)
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      - uses: actions/checkout@v5
        with:
          submodules: recursive
      - name: Symlink dependencies
        run: |
          mkdir -p .deps
          git clone --depth 1 https://github.com/saorsa-labs/ant-quic .deps/ant-quic || true
          git clone --depth 1 https://github.com/saorsa-labs/saorsa-gossip .deps/saorsa-gossip || true
          ln -sf "$(pwd)/.deps/ant-quic" ../ant-quic
          ln -sf "$(pwd)/.deps/saorsa-gossip" ../saorsa-gossip
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - uses: taiki-e/install-action@nextest
      - name: Build release binaries (shared across suites)
        run: cargo build --release --bin x0xd --bin x0x
      - name: Run daemon API integration tests
        run: cargo nextest run --all-features --test daemon_api_integration -- --ignored
      - name: Run named group D4 signed commit integration tests
        run: cargo nextest run --all-features --test named_group_d4_apply -- --ignored

  # Groups: the heavy named-group daemon suite (28 daemon-backed tests),
  # isolated on its own runner so it cannot stack on core's cold build.
  # See issue #197: core was cancelled at its budget when this suite rode
  # the same job as the release build on a cold rust-cache.
  integration-groups:
    name: Integration (groups)
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      - uses: actions/checkout@v5
        with:
          submodules: recursive
      - name: Symlink dependencies
        run: |
          mkdir -p .deps
          git clone --depth 1 https://github.com/saorsa-labs/ant-quic .deps/ant-quic || true
          git clone --depth 1 https://github.com/saorsa-labs/saorsa-gossip .deps/saorsa-gossip || true
          ln -sf "$(pwd)/.deps/ant-quic" ../ant-quic
          ln -sf "$(pwd)/.deps/saorsa-gossip" ../saorsa-gossip
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - uses: taiki-e/install-action@nextest
      - name: Build release binaries (shared across suites)
        run: cargo build --release --bin x0xd --bin x0x
      - name: Run named group integration tests
        run: cargo nextest run --all-features --test named_group_integration --run-ignored ignored-only

  # Net: GUI smoke + WebSocket + kv bootstrap + local-topic routing.
  integration-net:
    name: Integration (net)
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      - uses: actions/checkout@v5
        with:
          submodules: recursive
      - name: Symlink dependencies
        run: |
          mkdir -p .deps
          git clone --depth 1 https://github.com/saorsa-labs/ant-quic .deps/ant-quic || true
          git clone --depth 1 https://github.com/saorsa-labs/saorsa-gossip .deps/saorsa-gossip || true
          ln -sf "$(pwd)/.deps/ant-quic" ../ant-quic
          ln -sf "$(pwd)/.deps/saorsa-gossip" ../saorsa-gossip
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - uses: taiki-e/install-action@nextest
      - name: Build release binaries (shared across suites)
        run: cargo build --release --bin x0xd --bin x0x
      - name: Run GUI smoke tests
        run: cargo nextest run --all-features --test gui_smoke
      - name: Run WebSocket tests
        run: cargo nextest run --all-features --test ws_integration -- --ignored
      - name: Run KvStore first-join bootstrap tests (issue 96)
        run: cargo nextest run --all-features --test kv_first_join_bootstrap --test-threads 1 -- --ignored
      - name: Run local-topic routing tests (issue 89)
        run: cargo nextest run --all-features --test local_topics --test-threads 1 -- --ignored

  # ── De-flaked timing suites moved off the PR path (issue #197).
  #    These are convergence/jitter-prone budgets (the join-metadata suite
  #    alone is ~20-25 s ×7 ≈ 3 min) that previously inflated the
  #    monolithic integration job past its 20-min PR ceiling. Coverage is
  #    preserved by running them on the weekly schedule, mirroring the
  #    soak job's `if: github.event_name == 'schedule'` gating. None is a
  #    required status check, so this stays advisory.
  integration-timing:
    name: Integration Timing Suites (weekly)
    runs-on: ubuntu-latest
    timeout-minutes: 30
    if: github.event_name == 'schedule'
    steps:
      - uses: actions/checkout@v5
        with:
          submodules: recursive
      - name: Symlink dependencies
        run: |
          mkdir -p .deps
          git clone --depth 1 https://github.com/saorsa-labs/ant-quic .deps/ant-quic || true
          git clone --depth 1 https://github.com/saorsa-labs/saorsa-gossip .deps/saorsa-gossip || true
          ln -sf "$(pwd)/.deps/ant-quic" ../ant-quic
          ln -sf "$(pwd)/.deps/saorsa-gossip" ../saorsa-gossip
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - uses: taiki-e/install-action@nextest
      - name: Build release binaries (shared across suites)
        run: cargo build --release --bin x0xd --bin x0x
      - name: Run peer-lifecycle daemon tests (de-flaked, ignored-only)
        run: cargo nextest run --all-features --test peer_lifecycle_integration --run-ignored ignored-only
      - name: Run x0x_0041 reissue timing test (de-flaked, ignored-only)
        run: cargo nextest run --all-features --test x0x_0041_prefer_newest_test --run-ignored ignored-only
      - name: Run named-group join-metadata convergence tests (de-flaked, ignored-only)
        run: cargo nextest run --all-features --test named_group_join_metadata_event --run-ignored ignored-only

  # ── Soak test (weekly, ~90min) ────────────────────────────────────────
  soak:
    name: Soak Test
    runs-on: ubuntu-latest
    timeout-minutes: 90
    if: github.event_name == 'schedule'
    steps:
      - uses: actions/checkout@v5
        with:
          submodules: recursive
      - name: Symlink dependencies
        run: |
          mkdir -p .deps
          git clone --depth 1 https://github.com/saorsa-labs/ant-quic .deps/ant-quic || true
          git clone --depth 1 https://github.com/saorsa-labs/saorsa-gossip .deps/saorsa-gossip || true
          ln -sf "$(pwd)/.deps/ant-quic" ../ant-quic
          ln -sf "$(pwd)/.deps/saorsa-gossip" ../saorsa-gossip
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - uses: grafana/setup-k6-action@v1
      - name: Build release binaries
        run: cargo build --release --bin x0xd
      - name: Run 1-hour soak
        run: bash tests/soak/run_soak.sh --duration 1h
      - name: Upload soak results
        if: always()
        uses: actions/upload-artifact@v5
        with:
          name: soak-results
          path: tests/soak/results/