Skip to content

governance.md

Latest commit

 

History

History
70 lines (51 loc) · 2.4 KB

governance.md

File metadata and controls

70 lines (51 loc) · 2.4 KB
Raw

Repository governance

How changes land on main, and how macOS users install/update without cloning.

Branch protection (main)

Enforced via GitHub rulesets (Settings → Rules):

Rule Setting
Direct pushes Blocked (non_fast_forward + PR required)
Force push / delete Blocked
Merge method Squash only
Status checks rust (ubuntu-latest), rust (macos-latest), ui (strict); PR title lint is CI advisory
Conversations Must be resolved
Approvals 0 required (solo-friendly); stale reviews dismissed
Admin bypass Via pull request only

Release tags matching v* cannot be deleted or force-moved (admin bypass allowed).

Repo merge defaults: squash title = PR title, body = PR body, delete head branch on merge, auto-merge enabled.

Commit / PR conventions

  • PR titles must be Conventional Commits (feat:, fix:, docs:, adapter:, …) — enforced by the PR title workflow.
  • Squash merge uses the PR title as the commit subject, so main history stays conventional without a commit-message ruleset (unavailable on this plan).
  • See CONTRIBUTING.md and the PR template.

Releases

  1. Land changes on main via PR.
  2. Tag vX.Y.Z and push the tag → Release workflow builds archives and updates the Homebrew formula checksums.
  3. Users upgrade with brew update && brew upgrade microbridge, then run microbridge-app install to refresh the marker-owned signed app (the full workflow is below).

macOS install + auto-update (Homebrew)

This is the supported consumer path — not cloning the git repo. brew install microbridge installs prebuilt release binaries for the menu bar app and the daemon (not CLI-only; not a from-source Tauri build).

brew tap DevVig/microbridge https://github.com/DevVig/microbridge
brew install microbridge
microbridge-app install

Updates:

brew update && brew upgrade microbridge
microbridge-app install              # refresh the marker-owned signed app

Optional background updates (Homebrew’s own updater):

brew autoupdate start --upgrade --cleanup --immediate

The standard GUI app owns its bundled daemon. brew services start microbridge is retained as an explicit headless mode and is verified separately in release smokes.

Details: INSTALL.md.