Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 30 additions & 2 deletions languages/golang/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,42 @@

Changes to the Go module `github.com/cipherstash/stack/languages/golang`:
the SDK (`encrypt`), the generator (`stashgen`, `cmd/stashgen`) and the
credential package (`auth`).
credential package (`auth`). From rc.6 it also covers the module
`github.com/cipherstash/stack/languages/golang/encrypt/encrypttest`, which
is released at the same version.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
The module is pre-1.0, so a minor version may break the API; every break is
listed under **Breaking**. Releases are tagged `languages/golang/vX.Y.Z`.
listed under **Breaking**. Releases are tagged `languages/golang/vX.Y.Z`,
and `languages/golang/encrypt/encrypttest/vX.Y.Z` on the same commit.
Comment on lines +11 to +12

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

minor This line gives the encrypttest tag for every release, but languages/golang/encrypt/encrypttest/v0.1.0-rc.5 and earlier tags do not exist, because the package lived inside the SDK module until rc.6. Limit it to rc.6 and later, as lines 5-7 already do.

Suggested change
listed under **Breaking**. Releases are tagged `languages/golang/vX.Y.Z`,
and `languages/golang/encrypt/encrypttest/vX.Y.Z` on the same commit.
listed under **Breaking**. Releases are tagged `languages/golang/vX.Y.Z`,
and, from rc.6, `languages/golang/encrypt/encrypttest/vX.Y.Z` on the same commit.

Source: code-review · claude-opus-5-5


Generated by Claude Code


## [Unreleased]

## [0.1.0-rc.6] - 2026-11-18

### Upgrading from rc.5

Update the SDK:

```sh
go get github.com/cipherstash/stack/languages/golang@v0.1.0-rc.6
```

If your program imports `encrypttest`, add its module at the same version.
Without it, the program does not build. The Breaking section explains why.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

minor encrypttest is meant to be imported only from _test.go files (line 51, client.go:108), and go build ./... does not load test-only imports, so it still succeeds without the second go get. Only go test and go vet fail with "no required module provides package". The same wording is at line 60 ("stops building").

Suggested change
Without it, the program does not build. The Breaking section explains why.
Without it, your tests do not build. The Breaking section explains why.

Source: code-review · claude-opus-5-5


Generated by Claude Code


```sh
go get github.com/cipherstash/stack/languages/golang/encrypt/encrypttest@v0.1.0-rc.6
```

The EQL SQL has not changed since rc.5. The `eql-v4-install.sql` attached
to this release differs from rc.5's only in its version stamp. If you
installed rc.5's bundle, you do not need to run it again.

Run `go generate ./...` again only if you generate code under Go 1.27 and
a struct has a `json.RawMessage` field. The Fixed section describes the
change.
Comment on lines +37 to +39

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

minor The trigger is jsonv2 being on when the code was generated, not Go 1.27. On Go 1.26 with GOEXPERIMENT=jsonv2, rc.5 also wrote jsontext.Value, and that file does not build without the experiment. The condition is also too broad: only a json.RawMessage member (or an alias of it) of an ordered path's array element changed (memberTypeExpr, stashgen/read.go:1564), not every json.RawMessage field.

Suggested change
Run `go generate ./...` again only if you generate code under Go 1.27 and
a struct has a `json.RawMessage` field. The Fixed section describes the
change.
Run `go generate ./...` again if you generated code with `GOEXPERIMENT=jsonv2`
(the default from Go 1.27) and an ordered path names a member of an array
element whose type is `json.RawMessage` or an alias of it. The Fixed section
describes the change.

Source: code-review · claude-opus-5-5


Generated by Claude Code


### Added

- **`encrypttest.NewClient`: a client for your application's tests that
Expand Down
Loading