Struct ReliabilityScorer 

pub struct ReliabilityScorer { /* private fields */ }

Computes a ReliabilityScore for an ExtractionResult.

The scorer is pure and deterministic — it derives every sub-score from the result’s metadata plus an externally-supplied retry count. There is no I/O and no clock dependency.

Example

use stygian_plugin::domain::{ExtractionResult, IdempotencyKey, RegionStatus};
use stygian_plugin::reliability::ReliabilityScorer;
use std::collections::HashMap;

let mut result = ExtractionResult::new(IdempotencyKey::new());
result.metadata.region_status.insert(
    "title".to_string(),
    RegionStatus { success: true, matched_count: 1, error: None },
);

let score = ReliabilityScorer::new().score_extraction(&result, 0);
assert!((score.overall - 1.0).abs() < f32::EPSILON);

Implementations

impl ReliabilityScorer

pub const MAX_RETRIES_FOR_PENALTY: u32 = 5

Maximum retry count the retry_penalty sub-score saturates at.

Beyond this many retries the retry_penalty sub-score is 1.0 regardless of the actual count, so a single retry-bloated call can never zero out the rest of the score on its own.

pub fn new() -> Self

Build a scorer with the default ScoringWeights.

Example

use stygian_plugin::reliability::ReliabilityScorer;
let _scorer = ReliabilityScorer::new();

pub fn with_weights(weights: ScoringWeights) -> Result<Self>

Build a scorer with custom weights.

Errors

Returns crate::error::PluginError::TemplateValidationError when any weight is outside [0.0, 1.0] (see ScoringWeights::validate).

pub fn score_extraction( &self, result: &ExtractionResult, retry_count: u32, ) -> ReliabilityScore

Score an extraction result. retry_count is the number of retries the caller had to take to produce this result.

Example

use stygian_plugin::domain::{ExtractionResult, IdempotencyKey, RegionStatus};
use stygian_plugin::reliability::{ReliabilityScorer, ReliabilityBand};
use std::collections::HashMap;

let mut result = ExtractionResult::new(IdempotencyKey::new());
result.metadata.region_status.insert(
    "title".to_string(),
    RegionStatus { success: false, matched_count: 0, error: Some("missing".into()) },
);

let score = ReliabilityScorer::new().score_extraction(&result, 0);
assert_eq!(score.band, ReliabilityBand::Low);

pub fn score_metadata( &self, metadata: &ExtractionMetadata, retry_count: u32, ) -> ReliabilityScore

Score from raw ExtractionMetadata without needing the full result.

Useful when the metadata has been serialized over the wire (e.g. into a MCP debug payload) and the caller only has the metadata.

Trait Implementations

impl Clone for ReliabilityScorer

fn clone(&self) -> ReliabilityScorer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ReliabilityScorer

impl Debug for ReliabilityScorer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ReliabilityScorer

fn default() -> Self

Returns the “default value” for a type.