feat: findBy repository shortcuts (Java 21) and reified Query results (Kotlin)

[zantvoort]

Description

New API conveniences for the next release (1.11.7) plus a documentation/skills accuracy pass.

Java 21 API (storm-java21):

• findBy / getBy / findAllBy / findRefBy / findAllRefBy / getRefBy convenience default methods on EntityRepository and ProjectionRepository (@since 1.11), mirroring the Kotlin API.
• Template-based groupBy / having / orderBy on QueryBuilder are now public (were protected).

Kotlin API (storm-kotlin):

• Reified extensions on Query: resultList<T>(), singleResult<T>(), optionalResult<T>(), resultStream<T>(), resultFlow<T>() (@since 1.11), each delegating to the KClass-based methods. This makes the syntax advertised on the front page and docs — orm.query { ... }.resultList<User>() — actually compile. They coexist with the untyped resultList property (property access still resolves to the member).

Landing page:

• Simplified the repository aggregate example to usersPerCity(country) (no orderBy/limit).
• The sql scene now leads with plain SQL the QueryBuilder can't express (RANK() OVER), filtered by a $country bind variable and mapped to an ad-hoc data class; bind variables are annotated with inline SQL comments. The Show SQL panel mirrors both queries.

Docs (next) & skills:

• Kotlin examples updated to the reified syntax (sql-templates.md, hydration.md).
• Fixed Kotlin snippets that did not compile: error-handling.md used Java-style getSingleResult() / getOptionalResult(User::class) on QueryBuilder (now singleResult / optionalResult properties); security.md interpolated into a plain string passed to query(String) — not parameterized as claimed — now a template lambda.
• Accuracy pass across the storm-* skills; skills no longer reference concrete Storm versions.
• llms-full.txt regenerated from the current docs (was stale since March, hence the large diff).

Other:

• Corrected the stale @since 1.12 tag on TransactionContext (that API shipped in 1.11.4).
• Developer email updated in the parent POM.

The 1.11.6 versioned docs intentionally keep the resultList<User>() syntax and are left untouched; they become accurate when 1.11.7 is released.

Related Issue

None.

Type of Change

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update
• Refactoring (no functional changes)

Checklist

• My code follows the project's code style
• I have added tests that cover my changes
• All new and existing tests pass (mvn verify)
• I have updated relevant documentation
• My changes generate no new compiler warnings

Module(s) Affected

storm-java21, storm-kotlin, storm-core (javadoc only), website (landing page, docs, skills, llms-full.txt), parent POM

Breaking Changes

None. All API additions are backward compatible; widening groupBy/having/orderBy from protected to public is source- and binary-compatible.