# Contributing to TurnScope

Thanks for helping improve TurnScope.

## Development

TurnScope requires Go 1.26 or newer. npm packaging development additionally
requires Node.js 18 or newer.

```bash
git clone https://github.com/tageecc/turnscope.git
cd turnscope
go mod download
make test
make build
make npm-test
```

Run it against the default local Codex home:

```bash
./turnscope --latest
```

## Before opening a pull request

```bash
gofmt -w .
go vet ./...
go test -race ./...
go build ./cmd/turnscope
npm --prefix npm test
```

Build and validate all six npm platform packages locally:

```bash
make npm-packages
```

This target cross-compiles the Go binary for macOS, Linux, and Windows on ARM64
and x64, validates each npm tarball, installs the packages into a temporary
project, and executes `turnscope --version` through the npm command shim.

Keep changes focused. Include tests for parser, timing, or layout behavior when
the change affects those areas. Screenshots and rollout excerpts in issues must
use synthetic data.