GitComet/CONTRIBUTING.md

Contributing

Workspace layout

• crates/gitcomet-core: domain types, merge algorithm, conflict session, text utils.
• crates/gitcomet-git: Git abstraction + no-op backend.
• crates/gitcomet-git-gix: gix/gitoxide backend implementation.
• crates/gitcomet-state: MVU state store, reducers, effects, conflict session management.
• crates/gitcomet-ui: UI model/state (toolkit-independent).
• crates/gitcomet-ui-gpui: gpui views/components (focused diff/merge windows, conflict resolver, word diff).
• crates/gitcomet: binary entrypoint, CLI (clap), difftool/mergetool/setup/uninstall modes.

Getting started

Windows prerequisites (Windows 10/11):

• Install Visual Studio 2022 (Community or Build Tools).
• Install the Desktop development with C++ workload.
• Ensure both MSVC tools and Windows 10/11 SDK components are installed.
• This repo configures Cargo to use scripts/windows/msvc-linker.cmd, so cargo build works from a regular PowerShell/CMD shell when those components are present.

Offline-friendly default build (does not build the UI or the Git backend):

cargo build

To build the actual app you'll enable features (requires network for dependencies):

cargo build -p gitcomet --features ui,gix

To also compile the gpui-based UI crate:

cargo build -p gitcomet --features ui-gpui,gix

Run (opens the repo passed as the first arg, or falls back to the current directory):

cargo run -p gitcomet --features ui-gpui,gix -- /path/to/repo

Testing

Full headless test suite (CI mode):

cargo test --workspace --no-default-features --features gix

Clippy (CI mode):

cargo clippy --workspace --no-default-features --features gix -- -D warnings

Coverage (local + CI-compatible):

rustup component add llvm-tools-preview
cargo install --locked cargo-llvm-cov
bash scripts/coverage.sh

This writes:

• target/llvm-cov/lcov.info (used by CI upload)
• target/llvm-cov/html/index.html (local detailed report)

Release packaging

macOS packaging is handled by:

scripts/package-macos.sh --version 0.2.0 --arch arm64 --release
scripts/package-macos.sh --version 0.2.0 --arch x86_64 --release

Use --skip-dmg when running in restricted/sandboxed environments where hdiutil create is unavailable.

The release workflow .github/workflows/build-release-artifacts.yml builds and publishes:

• Windows: portable ZIP + MSI
• Linux: tar.gz + AppImage + .deb
• macOS: DMG + tar.gz for arm64 and x86_64
• Homebrew formula asset: gitcomet.rb (generated from macOS + Linux x86_64 tarballs and their SHA256 values)

Homebrew deployment

To push Formula/gitcomet.rb into a Homebrew tap repo automatically on release:

1. Create a tap repository (default expected name: OWNER/homebrew-gitcomet).
2. In this repo, configure:
   • secret HOMEBREW_TAP_TOKEN: GitHub token with contents:write access to the tap repository.
   • variable HOMEBREW_TAP_REPO: tap repository in OWNER/REPO form.
   • optional variable HOMEBREW_TAP_BRANCH: target branch (default main).
3. Run .github/workflows/release-manual-main.yml with draft=false.

This release flow will:

• build and upload release artifacts
• publish the GitHub release
• call .github/workflows/deploy-homebrew-tap.yml to update Formula/gitcomet.rb in the tap repo

You can also run .github/workflows/deploy-homebrew-tap.yml manually for backfills or dry-runs.