Contributing

Everything in the repository — code, documentation, commit messages — is in English.

Workflow

1. Branch from main; main itself is protected (no direct pushes, for anyone).
2. Open a pull request. CI (fmt, clippy, tests, worker typecheck, the governance check, on x86_64 and aarch64) and E2E (real pacman through a local worker) must pass, and one maintainer other than the author approves — a push after the approval asks for it again. A maintainer merges what another opened. Keep docs/TESTING.md in step with what you change. A change to factory/MAINTAINERS.toml or CODEOWNERS asks for a code owner's review: every maintainer is one (docs/GOVERNANCE.md). The repository's admin can merge alone; GitHub records the bypass on the pull request. Packages are never pull requests: they are requested on the dashboard and built by the pool.
3. Pull requests are squash-merged; the title becomes the commit message and the release note, so write it as one clear sentence: Render databases per architecture, Fix Range handling for full responses.
4. Merging is releasing. release.yml tags the next version and deploys the worker (details in docs/RUNBOOK.md).

Versions

Releases are small and frequent, starting at v0.0.1:

Crate versions and worker/package.json stay at 0.0.0; the git tag is the source of truth and is compiled into the binaries (omarchy-cli --version).

Local checks

cargo fmt --all --check && cargo clippy --workspace --all-targets -- -D warnings && cargo test --workspace
(cd worker && npm ci && npm run typecheck && npm test)   # the Worker's tests run inside workerd, in seconds
tests/e2e-worker.sh          # needs docker or podman