# AI Agent Context for graphql-java

## Rules

- **Tests in Spock (Groovy)**, not JUnit: `src/test/groovy/graphql/`
- **No new dependencies** (firm policy)
- **No wildcard imports**, no inner classes, no `Optional`
- Max 2 indent levels; early returns; extract methods to reduce nesting
- Immutable data classes w/ Builder: `newFoo()` factory, `foo(value)` setters, `transform()` method
- Use `graphql.Assert` not `Objects.requireNonNull`
- Use `@Public`/`@Internal` annotations — never package-private/protected
- `@NullMarked` on all public API classes; `@NullUnmarked` on their Builder classes; use `@Nullable` for nullable params/returns; NullAway enforced via ErrorProne
- Full style guide: `coding-guidelines.md`

## Test Execution

```bash
./gradlew test
```

This runs tests on Java 25 only. Other JVM versions (11, 17, 21) require explicit tasks (e.g. `testWithJava11`).