Spectre.Skill.Applicability (Spectre v0.3.0)

Structured, portable applicability contract for one Skill.

Scope and tags decide eligibility. Positive and negative examples are an executable anti-hijack corpus; they never grant authority or become an unstructured model instruction.

Summary

Types

t()

Functions

conflicts?(applicability, id)

Returns true when this declaration conflicts with a mount or Skill id.

from_data(data)

Restores applicability from its portable representation.

matches?(applicability, context)

Returns true when a structured host context is eligible.

new(applicability)

Builds and validates structured applicability.

new!(attrs)

Builds applicability or raises with its stable validation reason.

schema_version()

Returns the current applicability schema version.

specificity(applicability)

Returns a deterministic specificity used to detect ambiguous Skills.

to_data(applicability)

Returns the portable representation included in Definition identity.

Types

t()

@type t() :: %Spectre.Skill.Applicability{
  conflicts: [term()],
  forbidden_tags: [term()],
  negative: [String.t()],
  positive: [String.t()],
  required_tags: [term()],
  schema_version: pos_integer(),
  scopes: [term()]
}

Functions

conflicts?(applicability, id)

@spec conflicts?(t(), term()) :: boolean()

Returns true when this declaration conflicts with a mount or Skill id.

from_data(data)

@spec from_data(map()) :: {:ok, t()} | {:error, term()}

Restores applicability from its portable representation.

matches?(applicability, context)

@spec matches?(t(), map()) :: boolean()

Returns true when a structured host context is eligible.

new(applicability)

@spec new(t() | map() | keyword()) :: {:ok, t()} | {:error, term()}

Builds and validates structured applicability.

new!(attrs)

@spec new!(t() | map() | keyword()) :: t()

Builds applicability or raises with its stable validation reason.

schema_version()

@spec schema_version() :: pos_integer()

Returns the current applicability schema version.

specificity(applicability)

@spec specificity(t()) :: non_neg_integer()

Returns a deterministic specificity used to detect ambiguous Skills.

to_data(applicability)

@spec to_data(t()) :: map()

Returns the portable representation included in Definition identity.