Build and test

Run every command from the repository root. The scripts are defined in the root package.json; if a command on this page does not match the actual script, package.json wins.

Routine checks

pnpm check

It runs check:rust, check:frontend, check:licenses, check:ui-widget-layering, check:ui-component-ratchet, and check:ui-visual in order, covering Rust quality gates, frontend types and lint, third-party licenses, UI layering, component coexistence, and visual baselines. Individual subcommands:

Command	What it does
`pnpm check:rust`	Rust quality checks plus UI control tests.
`pnpm check:frontend`	Typecheck plus ESLint for each package.
`pnpm check:licenses`	Validate the dependency license policy.
`pnpm check:ui-visual`	Validate the visual baseline matrix.
`pnpm check:release`	Validate release identity and version consistency.
`pnpm check:module-ownership`	Validate module ownership boundaries.
`pnpm check:source-size`	Check source file size limits.
`pnpm check:native-content-package`	Check the packaging result of the native content runtime.
`pnpm check:move-only`	Validate move-only diffs.

Build gates

pnpm release:build-smoke

Validates the desktop, mobile, and Relay build graph. It is not the same as a signed release package. Targeted desktop checks:

cargo check -p vibex-desktop --locked
cargo test -p vibex-desktop --locked
pnpm smoke:first-frame
pnpm check:mobile-native

Smoke tests

The repository provides many deterministic smoke scripts:

Command	Coverage
`pnpm smoke:agents`	ACP bridge contract + Codex + Claude, equal to `smoke:acp:bridge-contract` + `smoke:codex` + `smoke:claude`.
`pnpm smoke:acp:bridge-contract`	The ACP bridge protocol contract.
`pnpm smoke:acp:opencode`	OpenCode ACP integration.
`pnpm smoke:files`	The file service.
`pnpm smoke:git`	The Git service.
`pnpm smoke:pty`	The terminal PTY.
`pnpm smoke:db`	The SQLite layer.
`pnpm smoke:backup`	Backup and restore.
`pnpm smoke:diagnostics`	Diagnostic bundle generation.
`pnpm smoke:relay:local`	Local Relay end to end.
`pnpm e2e:regression`	The end-to-end regression harness.
`pnpm baseline:performance`	Performance baselines.

The pnpm check:acp, pnpm check:code-workbench, pnpm check:terminal, and pnpm check:all commands that appeared in older documentation do not exist. ACP, the code workbench, and the terminal are covered by the smoke:* scripts above.

Release builds

pnpm release:preflight      # Validate release identity and write a preflight record
pnpm release:build-smoke
pnpm package:preview        # Or package:rc / package:stable

After you push a tag, .github/workflows/release.yml builds artifacts for every platform. Before a release, read docs/operations/release.md and docs/operations/release-packaging-matrix.md in the repository.

Contracts to watch when you run tests

Insufficient permission must return a structured error; the UI must not guess success.
A cursor / generation gap must trigger resync_required.
File writes use content revisions / CAS so they do not overwrite external edits.
Terminal and attachment streams must be established after authorization and closed on revocation.
Restart, disconnect, and stale states must be reproducible.

Before you commit

Commands can generate local evidence or capture files. Check .gitignore and the script notes, and do not commit artifacts that contain credentials, prompts, paths, diffs, or terminal content. Installers, runtime binaries, Release APKs, and signing material are build or release artifacts; do not commit them as source code.

​Routine checks

​Build gates

​Smoke tests

​Release builds

​Contracts to watch when you run tests

​Before you commit

Routine checks

Build gates

Smoke tests

Release builds

Contracts to watch when you run tests

Before you commit