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.4@sha256:efe81fa41fdf81fb873ab7cd931b9bb29bd10aced6c252cbd91739c34e654f01
+image: amd64/golang:1.25.5@sha256:ad03ba93327b8a6143b49373790b5d92c28067bdb814418509466122ee9c9e63
 
 stages:
 - deps
@@ -32,7 +32,7 @@ test:
 
 vulnerabilities:
   stage: test
-  image: amd64/golang:1.25.4@sha256:efe81fa41fdf81fb873ab7cd931b9bb29bd10aced6c252cbd91739c34e654f01
+  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.2
+  rev: v2.7.2
   hooks:
   - id: golangci-lint-full
 - repo: https://github.com/gitleaks/gitleaks
-  rev: v8.29.1
+  rev: v8.30.0
   hooks:
   - id: gitleaks

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.84
+	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,5 @@
-github.com/99designs/gqlgen v0.17.84 h1:iVMdiStgUVx/BFkMb0J5GAXlqfqtQ7bqMCYK6v52kQ0=
+github.com/99designs/gqlgen v0.17.85 h1:EkGx3U2FDcxQm8YDLQSpXIAVmpDyZ3IcBMOJi2nH1S0=
-github.com/99designs/gqlgen v0.17.84/go.mod h1:qjoUqzTeiejdo+bwUg8unqSpeYG42XrcrQboGIezmFA=
+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=