testing-and-ci

name	testing-and-ci
description	Runs tests, lint, and format checks; explains CI workflows. Use when running or debugging tests, lint, or GitHub Actions.

Testing and CI

Commands

• make test-all – Run all Go tests (go test ./...).
• make check-fmt – Verify Go formatting (gofmt -s -l); fails if any file needs formatting.
• make lint – Run golangci-lint (requires golangci-lint installed).
• make build – Build the neptune binary.

CI Workflows

• test.yml – On push to main/release-* and on PRs. Path filter for Go files and Makefile. Runs make test-all and make check-fmt.
• lint.yml – On PRs. Path filter for Go and lint config. Runs golangci-lint.
• labeler.yml – On pull_request. Runs actions/labeler with .github/labeler.yml (path and head-branch rules).
• label-old-prs.yml – workflow_dispatch. Backfills labels: applies same rules as labeler to head branch and PR title (labeler has no branch context on manual run), then runs the labeler for path-based labels. Use state and limit inputs.
• release.yml – On push of tags v*.*.*. Runs GoReleaser to create the GitHub Release and artifacts.

Adding Tests

• Place *_test.go in the same package as the code (e.g. internal/config/loader_test.go).
• Use table-driven tests for multiple cases; single-case tests are fine when appropriate.
• Existing test packages: internal/config, internal/git, internal/run, internal/notifications/github. Add or extend tests when touching those areas or adding new packages.
• Do not depend on live GitHub or GCS in unit tests; use mocks or stubs.