# Proven verification commands (https://jackin.tailrocks.com/research/engineering/desktop-verification/commands/)



## Summary [#summary]

The desktop CI stack establishes the canonical build, binding, native-app, verification, and release command set.
Questions: exact build/test/lint/verify commands executor plans may cite for
crates (`jackin-usage`, `jackin-usage-ffi`), the UniFFI bindings drift gate,
the Swift app, and release verification.
Informs: jackin-desktop
Method: codebase read (commands proven by CI green usage, not guessed)
Vetted: 2026-07-24

## Findings [#findings]

### Crates tests [#crates-tests]

* `cargo nextest run -p jackin-usage -p jackin-usage-ffi --locked` — exact CI
  step in job "Native usage menu bar" — <RepoFile path=".github/workflows/ci.yml" /> (job
  name), step at ci.yml \~line 1147 (`run: cargo nextest run -p jackin-usage -p
  jackin-usage-ffi --locked`) (confidence: HIGH)
* General runner and filters: `cargo nextest run`, `-E 'test(name)'`,
  `--all-features` — <RepoFile path="TESTING.md" /> (confidence: HIGH)

### Bindings drift gate [#bindings-drift-gate]

* `cargo xtask desktop bindings` then
  `git diff --exit-code -- native/Generated native/Sources/JackinUsageBridge/jackin_usage_ffi.swift`
  — CI step, <RepoFile path=".github/workflows/ci.yml" /> (around lines 1150–1152); requires
  `cargo install uniffi --version 0.32.0 --features cli --locked` (CI installs
  it; mise `cargo:uniffi` provides `uniffi-bindgen` per `native/README.md`)
  (confidence: HIGH)

### App build / verify / run [#app-build--verify--run]

* `cargo xtask desktop build --version "$JACKIN_APP_VERSION" --build "$JACKIN_APP_BUILD"`
  → `native/dist/JackinDesktop.app`; `cargo xtask desktop verify
  native/dist/JackinDesktop.app [zip]` — CI steps (\~ci.yml:1154-1160);
  operator wrappers `mise run desktop-build|desktop-verify|desktop-run|desktop`
  — <RepoFile path="mise.toml" /> (confidence: HIGH)
* CI also soft-launches the app binary and checks the log
  (`"$APP_BIN" > /tmp/jackin-desktop-launch.log`, ci.yml:1177-1197)
  (confidence: HIGH)

### Swift tests [#swift-tests]

* `cargo xtask desktop test` (mise `desktop-test`, <RepoFile path="mise.toml" />);
  macOS-only guard `require_macos("desktop test")` —
  `crates/jackin-xtask/src/desktop.rs:157`; full-Xcode alternative printed by
  xtask: `cd native && swift test -c release` —
  `crates/jackin-xtask/src/desktop.rs:197` (confidence: HIGH)
* **Snapshot runner stability:** GitHub's current official runner-image
  catalog exposes macOS 26 GA under explicit `macos-26` labels, while the
  moving `macos-latest` alias was scheduled to transition in June 2026.
  Native system-font/SF-Symbol golden tests must use explicit `macos-26`,
  freeze Dynamic Type/accessibility/animation inputs, and keep tolerant
  pixel comparison; otherwise the runner major can change without a source
  diff. —
  [https://github.com/actions/runner-images#available-images](https://github.com/actions/runner-images#available-images)
  (confidence: HIGH)

### Workspace lint/fmt gates [#workspace-lintfmt-gates]

* `cargo clippy --workspace --all-targets --all-features --locked -- -D warnings`
  and `cargo fmt` — workspace baseline, <RepoFile path="crates/CLAUDE.md" /> (lint section);
  merge-readiness: `cargo xtask ci` / `cargo xtask ci --fast` —
  `CONTRIBUTING.md` (confidence: HIGH)

### Release verification [#release-verification]

* `cargo xtask desktop sign-notarize` (mise `desktop-sign-notarize`),
  `--release` verify requires Developer ID + notarization/staple/Gatekeeper —
  `native/README.md` (build/verify + CI/release contracts tables); release
  artifact naming `jackin-desktop-<VERSION>-aarch64-apple-darwin.zip` —
  `.github/workflows/release.yml:523-549` (confidence: HIGH)

## Dead ends and contradictions [#dead-ends-and-contradictions]

* None; commands converge across mise.toml, xtask source, CI, and docs.

## Limitations and open questions [#limitations-and-open-questions]

* None load-bearing; notarization steps need org Apple secrets
  (`release-macos` environment — names only, `native/README.md`).