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
name: CI
on:
push:
branches:
pull_request:
schedule:
# Weekly (Mon 06:00 UTC): re-run the advisory scan so a newly-disclosed CVE against the
# deliberately `=`-pinned dependency tree surfaces even with no code change.
- cron: "0 6 * * 1"
# Cancel superseded runs on the same ref.
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
env:
CARGO_TERM_COLOR: always
jobs:
# The same green gate enforced locally: format, lints, and the full test suite.
gate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: dtolnay/rust-toolchain@stable
with:
components: clippy, rustfmt
- uses: Swatinem/rust-cache@v2
- name: rustfmt
run: cargo fmt --all --check
- name: clippy
run: cargo clippy --all-targets --locked
- name: layering guard
# Enforce the two load-bearing dependency edges the architecture relies on (AR-02). Greps
# the `use crate::` import form only, so doc-comment rustdoc links can't false-positive.
run: |
if grep -rnE '^[[:space:]]*use crate::' src/predict.rs; then
echo "::error::predict.rs must import nothing from crate:: — keep it a standalone vt100-only library"
exit 1
fi
if grep -rnE '^[[:space:]]*use crate::wire' src/server src/client; then
echo "::error::server/client must not 'use crate::wire' directly — reach the wire through ssp::Transport"
exit 1
fi
echo "layering edges OK"
- name: test
run: cargo test --locked
- name: docs (deny broken intra-doc links)
# Catches workspace-era / renamed intra-doc links before they ship a broken docs.rs build.
run: cargo doc --no-deps --locked
env:
RUSTDOCFLAGS: "-D rustdoc::broken_intra_doc_links"
# Supply-chain tripwire: the `=` pins buy reproducibility, so this is what keeps them from
# silently aging into a CVE. Advisory ignores (and the rationale) live in deny.toml.
advisories:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: EmbarkStudios/cargo-deny-action@v2
with:
command: check advisories
# Coverage-guided fuzzing of the untrusted-input decode surfaces (the OpenSSH/OSS-Fuzz doctrine:
# one harness per attacker-reachable parser). Builds the harnesses, then a short smoke run that
# MUST stay crash-free — `screen_apply` proves the vt100 panic containment holds, `wire_decode`
# proves the wire decoders only Err (never panic) on arbitrary bytes.
fuzz:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: dtolnay/rust-toolchain@nightly
- uses: Swatinem/rust-cache@v2
- name: install cargo-fuzz
run: cargo install cargo-fuzz --locked
- name: build fuzz targets
run: cargo +nightly fuzz build
- name: smoke (must stay crash-free)
run: |
cargo +nightly fuzz run screen_apply -- -max_total_time=45 -rss_limit_mb=4096
cargo +nightly fuzz run wire_decode -- -max_total_time=45 -rss_limit_mb=4096