Fluxzero 1.75.0

1.75.0 (2026-02-03)

Documentation

• docs(release): package agent instructions as GitHub release artifacts (#111) (f23c2d1)

  * docs(release): package agent instructions as GitHub release artifacts

  Add agents-java.zip and agents-kotlin.zip to GitHub releases. These zip
  files contain AI coding assistant instructions (guidelines, code samples,
  and FQN references) to help AI tools generate correct Fluxzero code.

  The workflow creates the zips during build, uploads them as artifacts,
  and attaches them to the GitHub release.

  * fix: guidelines should refer to .fluxzero/agents

  * Rename to agents

  * docs(agent-instructions): convert Kotlin examples to idiomatic Kotlin syntax

  Converted all code examples in agent-instructions/kotlin/ from Java syntax
  to proper Kotlin syntax and idioms:

  - Replaced Java records with Kotlin data classes
  - Changed method declarations to Kotlin function syntax
  - Updated builder patterns to use .copy() instead of .toBuilder().build()
  - Converted Java interfaces to Kotlin interfaces with property syntax
  - Changed static members to use companion object or object declarations
  - Replaced List.of() with listOf()
  - Updated lambda syntax to Kotlin style
  - Fixed nullability handling with Kotlin's ? syntax
  - Changed file references from .java to .kt in guidelines
  - Updated project structure references from src/main/java to src/main/kotlin

  This ensures AI assistants receive accurate Kotlin examples when working
  with Fluxzero projects, improving code generation quality and reducing
  the need for manual syntax corrections.

  Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

  * fix(agent-instructions): address Kotlin examples code review feedback

  Applied review feedback from PR #111:

  Guidelines fixes:
  - Use ::class instead of ::class.java for Fluxzero SDK methods (generateId, search, etc.)
  - Document that Instant or Message should be injected for time handling in @​Apply methods, not Clock
  - Require fully qualified names in JSON test files for Kotlin (not simple names)
  - Clarify that searchable aggregates are indexed when modified
  - Remove incorrect mvn clean suggestion

  Code samples fixes:
  - Replace all ::class.java with ::class for Fluxzero SDK method calls
  - Update JSON test file example to show FQN requirement for Kotlin
  - Keep ::class.java only for Java interop methods (getPayloadAs, TestFixture methods)

  These changes ensure Kotlin examples follow SDK best practices and avoid common
  pitfalls when working with Kotlin and the Fluxzero framework.