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
name: CI
on:
push:
tags-ignore:
- "v*"
pull_request:
workflow_dispatch:
schedule:
- cron: "17 4 * * 1"
env:
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
jobs:
conventional-commits:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
with:
fetch-depth: 0
- uses: actions/setup-python@v7
with:
python-version: '3.12'
- name: Validate pull request title
if: github.event_name == 'pull_request'
run: python execution/conventional_commits.py check-subject "${{ github.event.pull_request.title }}"
- name: Validate pushed commit subjects
if: github.event_name == 'push'
run: python execution/conventional_commits.py check-push-range "${{ github.event.before }}" "$GITHUB_SHA"
- name: Validate manual run HEAD commit subject
if: github.event_name == 'workflow_dispatch'
run: python execution/conventional_commits.py check-range "HEAD^!"
release-version:
needs: conventional-commits
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- uses: actions/setup-python@v7
with:
python-version: '3.12'
- name: Run version sync tests
run: python -m unittest discover -s execution -p 'test_*.py'
- name: Verify release metadata stays aligned
run: python execution/version_sync.py check
rust:
needs: release-version
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- name: Free disk space for Rust builds
run: bash execution/free_runner_disk.sh
# rust-toolchain.toml is the single source of truth for the toolchain
# version; rustup resolves it natively (channel + components).
- name: Install Rust toolchain (rust-toolchain.toml)
run: rustup toolchain install
- name: Check Rust formatting
run: cargo fmt --check
- name: Run cargo check
run: cargo check
- name: Run clippy
run: cargo clippy --all-targets -- -D warnings
# stel_golden_replay needs gitignored phase0 corpora; without this step the
# integration tests skip vacuously and CI misses regressions operators see
# after cloning per tests/fixtures/phase0-corpus/README.md.
- name: Clone phase0 golden-replay corpora
run: bash execution/clone_phase0_corpora.sh
- name: Run Rust tests
run: cargo test --all-targets -- --test-threads=1
- name: Build release binary
run: cargo build --release
- name: Set up Node for tool-correctness harness
uses: actions/setup-node@v7
with:
node-version: '22'
# The harness grep oracle shells out to ripgrep as a completeness
# tripwire. ubuntu-latest doesn't ship rg, so without this the oracle
# silently degrades to REVIEW on every case — a disabled tripwire on a
# non-interactive runner is worthless. Install it so the oracle runs.
- name: Install ripgrep (harness grep oracle)
run: sudo apt-get update && sudo apt-get install -y ripgrep
- name: Verify tool correctness (both fixtures)
run: |
node scripts/verify-tools.cjs --bin target/release/symforge
node scripts/verify-tools.cjs --fixture verify-tools-real --bin target/release/symforge
embed-build:
needs: release-version
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
# rust-toolchain.toml is the single source of truth for the toolchain
# version; rustup resolves it natively (channel + components).
- name: Install Rust toolchain (rust-toolchain.toml)
run: rustup toolchain install
# Engine-only build for library embedders (e.g. AAP): no daemon / sidecar /
# protocol-server / CLI surface. Makes "an embedder can build symforge" a
# green gate, so a server-only break (e.g. a `#[cfg(unix)]` unsafe block that
# a Windows-only check cfg's out) can never silently reach embedders.
- name: Build engine-only embed feature
run: cargo build --no-default-features --features embed
- name: Clippy engine-only embed feature
run: cargo clippy --no-default-features --features embed --lib -- -D warnings
- name: Run embed-feature lib tests
run: cargo test --no-default-features --features embed --lib -- --test-threads=1
embed-musl:
needs: release-version
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
# rust-toolchain.toml is the single source of truth for the toolchain
# version; rustup resolves it natively. A hardcoded `toolchain:` input
# here silently loses when rust-toolchain.toml is bumped: cargo follows
# the toml and auto-installs that toolchain WITHOUT the musl target,
# which broke this job with E0463 "can't find crate for core" after the
# 1.95.0 -> 1.96.0 bump.
- name: Install Rust toolchain (rust-toolchain.toml)
run: rustup toolchain install && rustup target add x86_64-unknown-linux-musl
# Cross-compile the engine-only embed build to musl. AAP compiles the
# SymForge engine inside musl guest-agent VMs, so a musl regression must
# fail SymForge's own CI here, not downstream in AAP.
#
# musl-tools provides musl-gcc; the embed build statically links C deps
# built by the `cc` crate (19 tree-sitter grammars, rusqlite `bundled`
# sqlite) and by libgit2-sys (git2 `vendored-libgit2`, built via cmake,
# which is preinstalled on ubuntu-latest). Both `cc` and cmake-rs honor
# the target-scoped CC env var, so pointing it at musl-gcc makes every
# C-compiled crate link cleanly against musl. All currently pinned
# tree-sitter grammars ship pure-C scanners; if a future grammar bump
# reintroduces a C++ (.cc) scanner, also set
# CXX_x86_64_unknown_linux_musl (e.g. to a musl g++), since CC_<target>
# does not redirect the C++ compiler.
- name: Install musl C toolchain
run: sudo apt-get update && sudo apt-get install -y musl-tools
- name: Build engine-only embed feature for musl
env:
CC_x86_64_unknown_linux_musl: musl-gcc
run: cargo build --no-default-features --features embed --target x86_64-unknown-linux-musl
- name: Clippy engine-only embed feature for musl
env:
CC_x86_64_unknown_linux_musl: musl-gcc
run: cargo clippy --no-default-features --features embed --target x86_64-unknown-linux-musl --lib -- -D warnings
darwin-serve-port:
needs: release-version
runs-on: macos-latest
steps:
- uses: actions/checkout@v7
# rust-toolchain.toml is the single source of truth for the toolchain
# version; rustup resolves it natively (channel + components).
- name: Install Rust toolchain (rust-toolchain.toml)
run: rustup toolchain install
# `bind_listener` sets SO_REUSEADDR under `#[cfg(unix)]`, and macOS
# arm64/x64 are published targets — but every other job is ubuntu-latest,
# so the Darwin half of that gate ships unverified. It matters because
# `bind_listener` is also the occupancy probe (`probe_free_listener`), so a
# permitted wildcard-vs-specific overlap would let symforge bind
# 127.0.0.1:8080 over a live wildcard-bound dev server (or bind, print a
# healthy attach URL, and accept zero connections) instead of failing
# loudly per FR-002/003. `tests/serve_port.rs` already encodes that
# contract — `explicit_wildcard_over_live_specific_still_fails_loudly` is a
# tautology on Linux and only has teeth here — it just had no Darwin
# runner. One test binary, not a macOS matrix: this is the narrowest thing
# that answers the question.
- name: Run serve port-binding tests on Darwin
run: cargo test --test serve_port -- --test-threads=1
performance-smoke:
needs: release-version
if: github.event_name == 'workflow_dispatch' || github.event_name == 'schedule'
runs-on: ubuntu-latest
timeout-minutes: 30
steps:
- uses: actions/checkout@v7
# rust-toolchain.toml is the single source of truth for the toolchain
# version; rustup resolves it natively (channel + components).
- name: Install Rust toolchain (rust-toolchain.toml)
run: rustup toolchain install
- name: Run ignored 1000-file load performance smoke
run: cargo test --release --test live_index_integration test_load_perf_1000_files -- --ignored --test-threads=1
- name: Run portable coupling calibration smoke
run: cargo test --release --test coupling_calibration calibrate_current_repo_smoke -- --ignored --test-threads=1 --nocapture
npm:
needs: release-version
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
with:
node-version: 20
- name: Test npm package
working-directory: npm
run: npm test