Struct Playbook 

pub struct Playbook {
    pub id: String,
    pub target_class: TargetClass,
    pub description: String,
    pub acquisition: AcquisitionDefaults,
    pub proxy_preference: ProxyPreference,
    pub pacing: PacingProfile,
    pub escalation: EscalationStrategy,
}

A single codified playbook for one anti-bot tier.

Example

use stygian_charon::playbooks::{
    AcquisitionDefaults, EscalationStrategy, PacingProfile, Playbook, ProxyPreference,
};
use stygian_charon::acquisition::AcquisitionModeHint;
use stygian_charon::types::TargetClass;

let pb = Playbook {
    id: "tier1-static".to_string(),
    target_class: TargetClass::ContentSite,
    description: "Static content sites".to_string(),
    acquisition: AcquisitionDefaults::default_for(TargetClass::ContentSite),
    proxy_preference: ProxyPreference::default(),
    pacing: PacingProfile::default(),
    escalation: EscalationStrategy::Capped { ceiling: AcquisitionModeHint::Resilient },
};
assert!(pb.validate().is_ok());

Fields

id: String

Stable identifier ("tier1-static", "tier1-js", "tier2-hostile", etc.). Required, non-empty, unique within a resolver bundle.

target_class: TargetClass

Target class this playbook belongs to.

description: String

Human-readable description for operator logs.

acquisition: AcquisitionDefaults

Acquisition-mode defaults.

proxy_preference: ProxyPreference

Proxy preference.

pacing: PacingProfile

Pacing profile.

escalation: EscalationStrategy

Escalation strategy.

Implementations

impl Playbook

pub fn validate(&self) -> Result<(), ValidationError>

Validate the playbook’s internal consistency. Reports the first failing field with a structured error that includes both the field path and the bad value.

Errors

Returns ValidationError on the first inconsistency. The error embeds the field path and the bad value so operators can locate the offending TOML line without re-running the loader.

Example

use stygian_charon::playbooks::{
    AcquisitionDefaults, EscalationStrategy, PacingProfile, Playbook, ProxyPreference,
};
use stygian_charon::acquisition::AcquisitionModeHint;
use stygian_charon::types::{ExecutionMode, SessionMode, TargetClass, TelemetryLevel};

let bad = Playbook {
    id: String::new(),
    target_class: TargetClass::ContentSite,
    description: String::new(),
    acquisition: AcquisitionDefaults {
        mode: AcquisitionModeHint::Fast,
        execution_mode: ExecutionMode::Http,
        session_mode: SessionMode::Stateless,
        telemetry_level: TelemetryLevel::Basic,
        sticky_session_ttl_secs: None,
        enable_warmup: false,
        retry_budget: 0,
        backoff_base_ms: 250,
    },
    proxy_preference: ProxyPreference::default(),
    pacing: PacingProfile::default(),
    escalation: EscalationStrategy::Capped { ceiling: AcquisitionModeHint::Fast },
};
let err = bad.validate().expect_err("id is empty");
assert!(err.to_string().contains("id"));

pub const fn to_runtime_policy_hints(&self) -> RuntimePolicyHints

Convenience helper that converts the resolved playbook into a crate::acquisition::RuntimePolicyHints block ready to feed into crate::acquisition::map_policy_hints. The mapping is pure and deterministic.

Example

use stygian_charon::playbooks::{Playbook, AcquisitionDefaults};
use stygian_charon::types::TargetClass;

let pb = Playbook {
    id: "tier1-static".to_string(),
    target_class: TargetClass::ContentSite,
    description: String::new(),
    acquisition: AcquisitionDefaults::default_for(TargetClass::ContentSite),
    proxy_preference: Default::default(),
    pacing: Default::default(),
    escalation: Default::default(),
};
let _hints = pb.to_runtime_policy_hints();

Trait Implementations

impl Clone for Playbook

fn clone(&self) -> Playbook

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Playbook

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Playbook

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Playbook

fn eq(&self, other: &Playbook) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Playbook

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Playbook