cli/CONTRIBUTING.md

Rama main · réplica de lectura del repositorio original.

# Developer Guide

## Requirements

We use nix to manage the development environment, the build process and for running tests.

### With Nix (Recommended)

Run `nix develop \#cli` to get a complete development environment.

### Without Nix

Check `project.nix` (checkDeps, buildInputs, buildNativeInputs) for manual dependency installation. Alternatively, you can run `make nixops-container-env` in the root of the repository to enter a Docker container with nix and all dependencies pre-installed (note it is a large image).

## Development Workflow

### Running Tests

**With Nix:**
```bash
make dev-env-up
make check
```

**Without Nix:**
```bash
# Start development environment
make dev-env-up

# Lint Go code
golangci-lint run ./...

# Run tests
go test -v ./...
```

### Formatting

Format code before committing:
```bash
golines -w --base-formatter=gofumpt .
```

## Building

### Local Build

Build the project (output in `./result`):
```bash
make build
```

### Docker Image

Build and import Docker image with skopeo:
```bash
make build-docker-image
```

If you run the command above inside the dockerized nixops-container-env and you get an error like:

```
FATA[0000] writing blob: io: read/write on closed pipe
```

then you need to run the following command outside of the container (needs skopeo installed on the host):

```bash
cd cli
make build-docker-image-import-bare
```

### Multi-Platform Builds

Build for multiple platforms (Darwin/Linux, ARM64/AMD64):
```bash
make build-multiplatform
```

This produces binaries for:
- darwin/arm64
- darwin/amd64
- linux/arm64
- linux/amd64