Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -187,16 +187,18 @@ Verified against the current tree; sources in parentheses.
Canonical docs: [docs/ci-strategy.md](docs/ci-strategy.md) (design and
rationale) and
[docs/internal/release-pipeline.md](docs/internal/release-pipeline.md)
(release/promotion mechanics). The 13 workflows on `main`:
(release/promotion mechanics). The workflows on `main`:

| Workflow | One line |
|---|---|
| `ci` | Repo-wide checks: rustfmt, clippy, cargo-deny, a dogfood build smoke (Minimal building itself, reading prebuilt packages via the R2 mirror canary), `mip check`. |
| `ci-kani` | Kani bounded-verification harnesses over the security-load-bearing cores (rcache's `index_file` untrusted-bytes parse, sessions' `PathDecision` lattice); path-scoped inside the workflow, advisory until the harnesses have soaked. |
| `ci-linux-native` | Linux-native target lane: workspace tests, root-integration harnesses, session e2e against a host-native `minimald` (no VM). |
| `ci-linux-kvm` | Linux/KVM target lane (hosted x86_64): build-once/test-on-KVM split, minvmd VM harnesses, VM-backed session e2e. |
| `ci-macos` | macOS/HVF target lane: hosted arm64 unit/clippy tier (`minvmd` + `sessions`) plus the hypervisor e2e on the self-hosted Apple Silicon runner. |
| `ci-shell-installer` | POSIX-sh gate for the shell installer and the AppArmor profile installer (shellcheck + harness under sh/dash/macOS sh). |
| `commitlint` | Conventional Commits enforcement on PRs. |
| `spec-lint` | Advisory spec-format lint on PRs touching `docs/specs/**`, using foundry's `spec_lint.py`; posts/updates a single PR comment, never blocks merge. |
| `nightly-tests` | 06:00 UTC **test tier**: advisory re-checks, session-e2e soak, toolchain/dependency canaries, workflow hygiene; failures file tracking issues. |
| `nightly` | 10:00 UTC **channel cut**: reuses `release.yml` to build/stage/smoke, then blesses the `nightly` channel. |
| `release` | Manual (or nightly-called) build/sign/stage/smoke of all shipped artifacts; `versioned: true` builds with `MINIMAL_RELEASE_VERSION`, packages, stages `versions/<semver>/`, and parks a draft GitHub Release. Records smoke provenance on the staged row. Its verify-ci gate requires the five lane aggregators green on the commit. |
Expand All @@ -208,7 +210,10 @@ rationale) and
The required-check vocabulary is the **five aggregators**: `ci-success`,
`ci-linux-native-success`, `ci-linux-kvm-success`, `ci-macos-success`,
`ci-shell-installer-success`. Each is green when its lane's jobs succeeded
or were path-skipped. The two nightlies are distinct on purpose: `nightly-tests`
or were path-skipped. `ci-kani-success` is not among them: the Kani lane is
advisory until its harnesses have soaked, promoted by adding
`ci-kani-success` to the branch-protection ruleset (no workflow change
needed). The two nightlies are distinct on purpose: `nightly-tests`
proves, `nightly` ships.

## Conventions and hard rules
Expand Down
Loading