Interface Healing

All Superinterfaces:
org.aeonbits.owner.Config, EngineProperties<Healing>, Serializable
@Sources({"system:properties","file:src/main/resources/properties/custom.properties","file:src/main/resources/properties/default/custom.properties","classpath:custom.properties"}) public interface Healing extends EngineProperties<Healing>
Configuration for optional SHAFT Heal element recovery.

Healing is disabled by default. The deterministic SHAFT Heal provider is supplied by the optional io.github.shafthq:shaft-heal artifact.

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static class 
    Healing.SetProperty
    Fluent current-thread overrides for SHAFT Heal.

    Nested classes/interfaces inherited from interface org.aeonbits.owner.Config

    org.aeonbits.owner.Config.ConverterClass, org.aeonbits.owner.Config.DecryptorClass, org.aeonbits.owner.Config.DefaultValue, org.aeonbits.owner.Config.DisableableFeature, org.aeonbits.owner.Config.DisableFeature, org.aeonbits.owner.Config.EncryptedValue, org.aeonbits.owner.Config.HotReload, org.aeonbits.owner.Config.HotReloadType, org.aeonbits.owner.Config.Key, org.aeonbits.owner.Config.LoadPolicy, org.aeonbits.owner.Config.LoadType, org.aeonbits.owner.Config.PreprocessorClasses, org.aeonbits.owner.Config.Separator, org.aeonbits.owner.Config.Sources, org.aeonbits.owner.Config.TokenizerClass

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    aiEnabled()
     
    String
    aiTrigger()
     
    double
    ambiguityMargin()
     
    String
    evidenceCategories()
     
    boolean
    historyEnabled()
     
    int
    historyMaxEntries()
     
    String
    historyPath()
     
    int
    historyRetentionDays()
     
    double
    minimumConfidence()
     
    int
    minimumTrustPercentage()
     
    default Healing.SetProperty
    set()
    Returns a fluent builder for current-thread overrides.
    boolean
    sourcePatchEnabled()
     
    String
    strategy()
     
    String
    testIdAttributes()
     
    boolean
    visualEnabled()
     

  • Method Details

    • strategy

      @Key("healing.strategy") @DefaultValue("disabled") String strategy()
      Returns:
      disabled, healenium, shaft-heal, or composite

    • minimumConfidence

      @Key("healing.minimumConfidence") @DefaultValue("0.75") double minimumConfidence()
      Returns:
      minimum accepted deterministic confidence

    • minimumTrustPercentage

      @Key("healing.minimumTrustPercentage") @DefaultValue("-1") int minimumTrustPercentage()
      Returns:
      preferred minimum accepted trust percentage, or -1 to use healing.minimumConfidence

    • ambiguityMargin

      @Key("healing.ambiguityMargin") @DefaultValue("0.10") double ambiguityMargin()
      Returns:
      required score separation from the next candidate

    • evidenceCategories

      @Key("healing.evidenceCategories") @DefaultValue("accessibility,label,test-id,stable-id-name,semantic,dom-fingerprint,native-state,ancestor-context,history") String evidenceCategories()
      Returns:
      comma-separated evidence categories permitted for deterministic recovery

    • testIdAttributes

      @Key("healing.testIdAttributes") @DefaultValue("data-testid,data-test,data-qa") String testIdAttributes()
      Returns:
      comma-separated attributes treated as configured test IDs

    • historyEnabled

      @Key("healing.history.enabled") @DefaultValue("true") boolean historyEnabled()
      Returns:
      whether bounded local history is enabled

    • historyPath

      @Key("healing.history.path") @DefaultValue("target/shaft-heal/history.json") String historyPath()
      Returns:
      local history file path

    • historyMaxEntries

      @Key("healing.history.maxEntries") @DefaultValue("500") int historyMaxEntries()
      Returns:
      maximum retained history records

    • historyRetentionDays

      @Key("healing.history.retentionDays") @DefaultValue("30") int historyRetentionDays()
      Returns:
      maximum history age in days

    • visualEnabled

      @Key("healing.visual.enabled") @DefaultValue("false") boolean visualEnabled()
      Returns:
      whether optional visual evidence may be evaluated

    • aiEnabled

      @Key("healing.ai.enabled") @DefaultValue("false") boolean aiEnabled()
      Returns:
      whether optional provider reranking may be requested

    • aiTrigger

      @Key("healing.ai.trigger") @DefaultValue("ambiguous") String aiTrigger()
      Returns:
      when optional provider reranking may run: never, ambiguous, below-threshold, or always

    • sourcePatchEnabled

      @Key("healing.sourcePatch.enabled") @DefaultValue("false") boolean sourcePatchEnabled()
      Returns:
      whether reviewed source-patch proposals may be emitted

    • set

      default Healing.SetProperty set()
      Returns a fluent builder for current-thread overrides.
      Specified by:
      set in interface EngineProperties<Healing>
      Returns:
      current-thread property builder