PropertyDamage.FailureIntelligence.Similarity (PropertyDamage v0.2.0)

@type comparison() :: %{
  score: score(),
  breakdown: %{
    failure_type: score(),
    check_name: score(),
    command_type: score(),
    command_shape: score(),
    event_types: score(),
    sequence_shape: score(),
    error_category: score(),
    error_pattern: score()
  },
  is_similar: boolean()
}

score()

@type score() :: float()

Functions

compare(fp1, fp2)

@spec compare(
  PropertyDamage.FailureIntelligence.Fingerprint.t(),
  PropertyDamage.FailureIntelligence.Fingerprint.t()
) :: comparison()

Performs a detailed comparison between two fingerprints.

Returns the overall score, per-component breakdown, and similarity determination.

find_most_similar(target, fingerprints)

@spec find_most_similar(PropertyDamage.FailureIntelligence.Fingerprint.t(), [
  PropertyDamage.FailureIntelligence.Fingerprint.t()
]) :: {PropertyDamage.FailureIntelligence.Fingerprint.t(), score()} | nil

Finds the most similar fingerprint from a list.

Returns {fingerprint, score} or nil if no fingerprints are provided.

find_similar(target, fingerprints, opts \\ [])

@spec find_similar(
  PropertyDamage.FailureIntelligence.Fingerprint.t(),
  [PropertyDamage.FailureIntelligence.Fingerprint.t()],
  keyword()
) :: [{PropertyDamage.FailureIntelligence.Fingerprint.t(), score()}]

Finds all fingerprints similar to the target.

Returns a list of {fingerprint, score} pairs, sorted by score descending.

score(fp1, fp2)

@spec score(
  PropertyDamage.FailureIntelligence.Fingerprint.t(),
  PropertyDamage.FailureIntelligence.Fingerprint.t()
) :: score()

Computes the similarity score between two fingerprints.

Returns a score between 0.0 (completely different) and 1.0 (identical).

similar?(fp1, fp2)

@spec similar?(
  PropertyDamage.FailureIntelligence.Fingerprint.t(),
  PropertyDamage.FailureIntelligence.Fingerprint.t()
) :: boolean()

Checks if two fingerprints are similar based on the threshold.

similar?(fp1, fp2, threshold)

@spec similar?(
  PropertyDamage.FailureIntelligence.Fingerprint.t(),
  PropertyDamage.FailureIntelligence.Fingerprint.t(),
  float()
) :: boolean()

Checks if two fingerprints are similar using a custom threshold.

similarity_matrix(fingerprints)

@spec similarity_matrix([PropertyDamage.FailureIntelligence.Fingerprint.t()]) :: %{
  required({non_neg_integer(), non_neg_integer()}) => score()
}

Computes a similarity matrix for a list of fingerprints.

Returns a map where keys are {index1, index2} and values are scores. Only computes upper triangle (i < j) since similarity is symmetric.