feat: add @ValuePool to propagate values to types

[oetr]

This allows the users provide values directly to types by annotating them with @ValuePool.
All types, other than those that need cached-based mutators, are supported.

  public static Stream<?> myPool() {
    return Stream.of(
        "0123456789abcdef".repeat(50),
        "sitting duck suprime".repeat(53),
        123);
  }

  @FuzzTest
  @ValuePool("myPool")
  public static void fuzzerTestOneInput(
      @NotNull @WithUtf8Length(max = 10000) String data,
      @NotNull @WithUtf8Length(max = 10000) String data2) {
    if (data.equals("0123456789abcdef".repeat(50))
        && data2.equals("sitting duck suprime".repeat(53))) {
      throw new FuzzerSecurityIssueLow("Found the long string!");
    }
  }

[Copilot]

Pull Request Overview

This PR adds dictionary provider support to the mutation framework, enabling users to provide custom dictionary values for fuzzing through the @DictionaryProvider annotation. The implementation:

• Introduces MutatorRuntime class to provide runtime information (including the fuzz test method) to mutators
• Adds @DictionaryProvider annotation that references static methods returning Stream<?> of dictionary values
• Updates all MutatorFactory implementations to accept MutatorRuntime parameter
• Implements dictionary support for String and integral mutators using weighted sampling
• Adds SamplingUtils with Vose's alias method for efficient O(1) weighted sampling
• Includes comprehensive tests for the new functionality

Reviewed Changes

Copilot reviewed 85 out of 85 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
DictionaryProvider.java	New annotation for specifying dictionary provider methods with probability control
MutatorRuntime.java	New runtime info class providing fuzz test method to mutators
DictionaryProviderSupport.java	Helper methods to extract dictionary values from provider methods
IgnoreRecursiveConflicts.java	Meta-annotation to allow duplicate annotations during type hierarchy propagation
SamplingUtils.java	Weighted sampling utilities using Vose's alias method
StringMutatorFactory.java	Implements dictionary support for String mutators
IntegralMutatorFactory.java	Implements dictionary support for integral type mutators
MutatorFactory.java	Updated interface to accept MutatorRuntime parameter
ArgumentsMutator.java	Forwards method-level @DictionaryProvider annotations to parameters
TestSupport.java	Adds helper methods for creating dummy MutatorRuntime in tests
All other factory files	Updated to pass through MutatorRuntime parameter

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[simonresch]

Cool feature!

I'm not entirely sure that the ability to have different dictionaries per field warrants the added complexity & state in the MutatorRuntime. Is this an essential part of the custom dictionary in your opinion? Having a single @DictionaryProvider per fuzz test could simplify the mutator instantiation and maybe even make it simpler to use for users.
Otherwise my main concern would be the duplication with DictionaryEntry and similar annotations (see other comment).

[simonresch]

Thanks for the changes! I really like the ValuePool name and the more centralized implementation. Really cool that it works for (almost) all mutators. Only have some minor comments regarding doc strings. Nice work!