docs: add CLAUDE.md for Claude Code integration

chore(deps): update golang:1.25.5 docker digest to ad03ba9

See merge request unboundsoftware/shiny/presenter!105

.gitignore

@@ -1,2 +1,3 @@
 .idea
+.claude
 /release

.gitlab-ci.yml

@@ -7,7 +7,7 @@ include:
 - project: unboundsoftware/ci-templates
   file: Pre-Commit-Go.gitlab-ci.yml
 
-image: amd64/golang:1.25.3@sha256:9ac0edc3f9da2acc34e132363b6c2be45378feea0b73c451456a5449853af2aa
+image: amd64/golang:1.25.5@sha256:ad03ba93327b8a6143b49373790b5d92c28067bdb814418509466122ee9c9e63
 
 stages:
 - deps
@@ -32,7 +32,7 @@ test:
 
 vulnerabilities:
   stage: test
-  image: amd64/golang:1.25.3@sha256:9ac0edc3f9da2acc34e132363b6c2be45378feea0b73c451456a5449853af2aa
+  image: amd64/golang:1.25.5@sha256:ad03ba93327b8a6143b49373790b5d92c28067bdb814418509466122ee9c9e63
   script:
   - go install golang.org/x/vuln/cmd/govulncheck@latest
   - govulncheck ./...

.pre-commit-config.yaml

@@ -37,10 +37,10 @@ repos:
   - id: go-test
   - id: gofumpt
 - repo: https://github.com/golangci/golangci-lint
-  rev: v2.6.1
+  rev: v2.7.2
   hooks:
   - id: golangci-lint-full
 - repo: https://github.com/gitleaks/gitleaks
-  rev: v8.29.0
+  rev: v8.30.0
   hooks:
   - id: gitleaks

.version

@@ -1 +1 @@
-{"version":"v0.2.0"}
+{"version":"v0.2.2"}

CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.2] - 2025-11-24
+
+### 🐛 Bug Fixes
+
+- *(deps)* Update module github.com/99designs/gqlgen to v0.17.84
+
+### ⚙️ Miscellaneous Tasks
+
+- *(deps)* Update pre-commit hook golangci/golangci-lint to v2.6.2
+- *(deps)* Update golang:1.25.4 docker digest to efe81fa
+- *(deps)* Update pre-commit hook gitleaks/gitleaks to v8.29.1
+
+## [0.2.1] - 2025-11-13
+
+### 🐛 Bug Fixes
+
+- *(deps)* Update module github.com/99designs/gqlgen to v0.17.82
+- *(deps)* Update module github.com/99designs/gqlgen to v0.17.83
+
+### ⚙️ Miscellaneous Tasks
+
+- *(deps)* Update golang docker tag to v1.25.4
+
 ## [0.2.0] - 2025-11-05
 
 ### 🚀 Features

CLAUDE.md

@@ -0,0 +1,42 @@
+# presenter
+
+Shared Go library for GraphQL error presentation with coded errors.
+
+## Shared Documentation
+
+@../docs/claude/architecture.md
+@../docs/claude/go-services.md
+@../docs/claude/graphql.md
+@../docs/claude/conventions.md
+
+## Library Information
+
+### Purpose
+
+Provides a standardized GraphQL error presenter that handles coded errors across all microservices. Converts internal error codes to GraphQL error extensions.
+
+### Usage
+
+```go
+import "gitlab.com/unboundsoftware/shiny/presenter"
+
+// Create error presenter with valid codes and entities
+errorPresenter := presenter.New(logger, validCodes, validEntities, internalErrorCode)
+
+// Use in gqlgen server config
+srv := handler.NewDefaultServer(generated.NewExecutableSchema(cfg))
+srv.SetErrorPresenter(errorPresenter)
+```
+
+### Key Types
+
+- `CodedError` - Error type with code, entity, and params
+- `Code` - Error code type
+- `Entity` - Error entity type
+
+### Error Extensions
+
+Errors are presented with extensions:
+- `code` - The error code (mapped to valid codes or internal error)
+- `errorEntity` - The entity related to the error (optional)
+- `params` - Additional error parameters (optional)

go.mod

@@ -3,7 +3,7 @@ module gitlab.com/unboundsoftware/shiny/presenter
 go 1.24.1
 
 require (
-	github.com/99designs/gqlgen v0.17.81
+	github.com/99designs/gqlgen v0.17.85
 	github.com/stretchr/testify v1.11.1
 	github.com/vektah/gqlparser/v2 v2.5.31
 )

go.sum

@@ -1,5 +1,7 @@
-github.com/99designs/gqlgen v0.17.81 h1:kCkN/xVyRb5rEQpuwOHRTYq83i0IuTQg9vdIiwEerTs=
-github.com/99designs/gqlgen v0.17.81/go.mod h1:vgNcZlLwemsUhYim4dC1pvFP5FX0pr2Y+uYUoHFb1ig=
+github.com/99designs/gqlgen v0.17.85 h1:EkGx3U2FDcxQm8YDLQSpXIAVmpDyZ3IcBMOJi2nH1S0=
+github.com/99designs/gqlgen v0.17.85/go.mod h1:yvs8s0bkQlRfqg03YXr3eR4OQUowVhODT/tHzCXnbOU=
+github.com/agnivade/levenshtein v1.2.1 h1:EHBY3UOn1gwdy/VbFwgo4cxecRznFk7fKWN1KOX7eoM=
+github.com/agnivade/levenshtein v1.2.1/go.mod h1:QVVI16kDrtSuwcpd0p1+xMC6Z/VfhtCyDIjcwga4/DU=
 github.com/andreyvit/diff v0.0.0-20170406064948-c7f18ee00883 h1:bvNMNQO63//z+xNgfBlViaCIJKLlCJ6/fmUseuG0wVQ=
 github.com/andreyvit/diff v0.0.0-20170406064948-c7f18ee00883/go.mod h1:rCTlJbsFo29Kk6CurOXKm700vrz8f0KW0JNfpkRJY/8=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=