S588 · Denetimli kurtarma · Sınırlı model servis callsite'ı

#![allow(unexpected_cfgs)]
#![allow(dead_code)]

//! S588 Supervised recovery · Bounded model service callsite.
//!
//! Separate typed R2 gate after S587, workstream 3
//! (Supervised recovery), step 4/9.
//! It advances only the fail-closed acceptance-readiness ledger.  Supported-profile
//! runtime observations, physical observations, operator authority, external
//! acceptance and R2 field acceptance all remain explicitly absent, and the
//! module is deliberately not linked into the board-rpi5 kernel.

use crate::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s587_r2_supervised_recovery_preflight::S587_SEQUENCE;
use crate::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s576_r2_scheduler_exclusion_runtime_contract::{
    advance_s576_to_s707_model_acceptance_gate, G8lR2AcceptanceError,
    G8lR2AcceptanceGateDescriptor, G8lR2AcceptanceLedger, G8lR2AcceptanceOutcome,
    G8lR2AcceptanceStep, S576_TO_S707_LINKED_INTO_BOARD_RPI5,
};

pub const S588_SEQUENCE: usize = 588;
pub const S588_EXPECTED_PREDECESSOR: usize = S587_SEQUENCE;
pub const S588_WORKSTREAM: usize = 3;
pub const S588_BLOCK_ORDINAL: usize = 2;
pub const S588_BLOCK_STEP_COUNT: usize = 9;
pub const S588_STEP_ORDINAL: usize = 4;
pub const S588_ACCEPTANCE_DOMAIN: &str = "supervised_recovery";
pub const S588_LINKED_INTO_BOARD_RPI5: bool = S576_TO_S707_LINKED_INTO_BOARD_RPI5;
pub const S588_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS: usize = 0;
pub const S588_PHYSICAL_OBSERVATIONS: usize = 0;
pub const S588_OPERATOR_AUTHORIZATIONS: usize = 0;
pub const S588_EXTERNAL_ACCEPTANCES: usize = 0;
pub const S588_PHYSICAL_OR_DEVICE_OPERATIONS: usize = 0;
pub const S588_ACCEPTANCE_COMPLETE: bool = false;
pub const S588_R2_FIELD_ACCEPTANCE_COMPLETE: bool = false;
pub const RUNBOOK_EXECUTED_IN_S588: bool = false;

pub const S588_DESCRIPTOR: G8lR2AcceptanceGateDescriptor = G8lR2AcceptanceGateDescriptor {
    sequence: S588_SEQUENCE,
    predecessor_sequence: S588_EXPECTED_PREDECESSOR,
    workstream: S588_WORKSTREAM,
    block_ordinal: S588_BLOCK_ORDINAL,
    block_step_count: S588_BLOCK_STEP_COUNT,
    step_ordinal: S588_STEP_ORDINAL,
    acceptance_domain: S588_ACCEPTANCE_DOMAIN,
    step: G8lR2AcceptanceStep::BoundedModelCallsite,
    runtime_evidence_required: true,
    physical_evidence_required: true,
    external_authority_required: false,
};

pub type G8lS588AcceptanceGateOutcome = G8lR2AcceptanceOutcome;
pub type G8lS588AcceptanceGateError = G8lR2AcceptanceError;

pub fn service_s588_model_r2_supervised_recovery_callsite(
    ledger: &mut G8lR2AcceptanceLedger,
    caller_cpu: usize,
) -> Result<G8lS588AcceptanceGateOutcome, G8lS588AcceptanceGateError> {
    advance_s576_to_s707_model_acceptance_gate(ledger, caller_cpu, S588_DESCRIPTOR)
}

use aselsan_microkernel_simulation::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s576_r2_scheduler_exclusion_runtime_contract::{
    advance_s576_to_s707_model_acceptance_gate,
    canonical_s576_to_s707_acceptance_descriptor, G8lR2AcceptanceAnchor,
    G8lR2AcceptanceError, G8lR2AcceptanceLedger, G8lR2AcceptanceOutcome,
    S575_PHYSICAL_REPEAT_SEQUENCE, S576_CANONICAL_ANCHOR, S576_FIRST_SEQUENCE,
    S707_LAST_SEQUENCE,
};
use aselsan_microkernel_simulation::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s588_r2_supervised_recovery_callsite as gate;

fn r2_anchor() -> G8lR2AcceptanceAnchor {
    S576_CANONICAL_ANCHOR
}

fn acceptance_ledger() -> G8lR2AcceptanceLedger {
    G8lR2AcceptanceLedger::from_s575(1, r2_anchor()).unwrap()
}

fn advance_before(ledger: &mut G8lR2AcceptanceLedger, sequence: usize) {
    for predecessor in S576_FIRST_SEQUENCE..sequence {
        let descriptor = canonical_s576_to_s707_acceptance_descriptor(predecessor).unwrap();
        assert!(matches!(
            advance_s576_to_s707_model_acceptance_gate(ledger, 1, descriptor),
            Ok(G8lR2AcceptanceOutcome::Advanced(_))
        ));
    }
}

#[test]
fn s588_descriptor_is_exact_and_canonical() {
    assert_eq!(gate::S588_SEQUENCE, 588);
    assert_eq!(gate::S588_EXPECTED_PREDECESSOR, 587);
    assert_eq!(gate::S588_WORKSTREAM, 3);
    assert_eq!(gate::S588_BLOCK_ORDINAL, 2);
    assert_eq!(gate::S588_BLOCK_STEP_COUNT, 9);
    assert_eq!(gate::S588_STEP_ORDINAL, 4);
    assert_eq!(gate::S588_ACCEPTANCE_DOMAIN, "supervised_recovery");
    assert_eq!(gate::S588_DESCRIPTOR.external_authority_required, false);
    assert!(gate::S588_DESCRIPTOR.physical_evidence_required);
    assert_eq!(
        canonical_s576_to_s707_acceptance_descriptor(588),
        Some(gate::S588_DESCRIPTOR)
    );
}

#[test]
fn s588_is_cpu1_scoped_and_waits_for_exact_predecessor() {
    let mut ledger = acceptance_ledger();
    assert_eq!(
        gate::service_s588_model_r2_supervised_recovery_callsite(&mut ledger, 0),
        Err(G8lR2AcceptanceError::WrongCpu)
    );
    assert_eq!(
        ledger.last_completed_sequence(),
        S575_PHYSICAL_REPEAT_SEQUENCE
    );
    if 588 == S576_FIRST_SEQUENCE {
        let future = canonical_s576_to_s707_acceptance_descriptor(577).unwrap();
        assert!(matches!(
            advance_s576_to_s707_model_acceptance_gate(&mut ledger, 1, future),
            Ok(G8lR2AcceptanceOutcome::AwaitingPredecessor {
                expected_predecessor: 576,
                observed_predecessor: 575,
                ..
            })
        ));
    } else {
        assert!(matches!(
            gate::service_s588_model_r2_supervised_recovery_callsite(&mut ledger, 1),
            Ok(G8lR2AcceptanceOutcome::AwaitingPredecessor {
                sequence: 588,
                expected_predecessor: 587,
                observed_predecessor: 575,
            })
        ));
    }
}

#[test]
fn s588_advances_once_with_non_acceptance_receipt() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 588);
    let G8lR2AcceptanceOutcome::Advanced(receipt) =
        gate::service_s588_model_r2_supervised_recovery_callsite(&mut ledger, 1).unwrap()
    else {
        panic!("S588 must advance")
    };
    assert_eq!((receipt.sequence, receipt.predecessor_sequence), (588, 587));
    assert_eq!(
        (
            receipt.workstream,
            receipt.block_ordinal,
            receipt.step_ordinal
        ),
        (3, 2, 4)
    );
    assert_eq!(receipt.acceptance_domain, "supervised_recovery");
    assert_eq!(receipt.completed_block_count, 1);
    assert_eq!(receipt.anchor_sequence, 575);
    assert_eq!(receipt.physical_repeat_sequence, 575);
    assert!(receipt.source_gate_complete);
    assert!(receipt.runtime_evidence_required);
    assert!(receipt.physical_evidence_required);
    assert_eq!(receipt.new_supported_profile_runtime_observations, 0);
    assert_eq!(receipt.new_physical_observations, 0);
    assert_eq!(receipt.retained_physical_observations, 2);
    assert!(!receipt.visible_scanout_observed);
    assert!(!receipt.physical_input_observed);
    assert!(!receipt.cross_profile_coverage_complete);
    assert!(!receipt.operator_authority_received);
    assert!(!receipt.external_authority_received);
    assert!(!receipt.linked_into_board_rpi5);
    assert!(!receipt.acceptance_complete);
    assert!(!receipt.r2_field_acceptance_complete);
    assert!(!receipt.runbook_executed);
}

#[test]
fn s588_replay_is_idempotent_and_historical_reentry_does_not_mutate() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 588);
    let G8lR2AcceptanceOutcome::Advanced(receipt) =
        gate::service_s588_model_r2_supervised_recovery_callsite(&mut ledger, 1).unwrap()
    else {
        panic!("advance")
    };
    assert_eq!(
        gate::service_s588_model_r2_supervised_recovery_callsite(&mut ledger, 1),
        Ok(G8lR2AcceptanceOutcome::Retained(receipt))
    );
    if 588 < S707_LAST_SEQUENCE {
        let next = canonical_s576_to_s707_acceptance_descriptor(588 + 1).unwrap();
        assert!(matches!(
            advance_s576_to_s707_model_acceptance_gate(&mut ledger, 1, next),
            Ok(G8lR2AcceptanceOutcome::Advanced(_))
        ));
        assert_eq!(
            gate::service_s588_model_r2_supervised_recovery_callsite(&mut ledger, 1),
            Ok(G8lR2AcceptanceOutcome::AlreadyCompleted {
                requested_sequence: 588,
                last_completed_sequence: 588 + 1,
            })
        );
    }
}

#[test]
fn s588_open_claim_boundary_is_preserved() {
    assert_eq!(gate::S588_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS, 0);
    assert_eq!(gate::S588_PHYSICAL_OBSERVATIONS, 0);
    assert_eq!(gate::S588_OPERATOR_AUTHORIZATIONS, 0);
    assert_eq!(gate::S588_EXTERNAL_ACCEPTANCES, 0);
    assert_eq!(gate::S588_PHYSICAL_OR_DEVICE_OPERATIONS, 0);
    assert!(!gate::S588_ACCEPTANCE_COMPLETE);
    assert!(!gate::S588_R2_FIELD_ACCEPTANCE_COMPLETE);
    assert!(!gate::S588_LINKED_INTO_BOARD_RPI5);
    assert!(!gate::RUNBOOK_EXECUTED_IN_S588);
}

#[test]
fn s588_is_simulation_only_and_adds_no_production_callsite() {
    const TARGET: &str = "g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s588_r2_supervised_recovery_callsite";
    let source = include_str!("../../kernel/src/g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s588_r2_supervised_recovery_callsite.rs");
    let kernel_registry = include_str!("../../kernel/src/main.rs");
    let simulation_registry = include_str!("../src/lib.rs");
    let exceptions = include_str!("../../kernel/src/arch/aarch64/exceptions.rs");
    assert!(source.contains("pub const S588_DESCRIPTOR"));
    assert_eq!(
        simulation_registry
            .matches(&format!("pub mod {TARGET};"))
            .count(),
        1
    );
    assert_eq!(
        kernel_registry.matches(&format!("mod {TARGET};")).count(),
        0
    );
    assert_eq!(exceptions.matches(TARGET).count(), 0);
    assert_eq!(exceptions.matches("service_s588_").count(), 0);
}

#[test]
fn s588_descriptor_mutation_fails_before_ledger_advance() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 588);
    let before = ledger.last_completed_sequence();
    let mut drift = gate::S588_DESCRIPTOR;
    drift.block_ordinal += 1;
    assert_eq!(
        advance_s576_to_s707_model_acceptance_gate(&mut ledger, 1, drift),
        Err(G8lR2AcceptanceError::DescriptorDrift)
    );
    assert_eq!(ledger.last_completed_sequence(), before);
}

#[test]
fn s588_rejects_missing_s575_pass_premature_acceptance_and_anchor_drift() {
    let mut without_repeat: G8lR2AcceptanceAnchor = S576_CANONICAL_ANCHOR;
    without_repeat.physical_repeat_observed = false;
    assert_eq!(
        G8lR2AcceptanceLedger::from_s575(1, without_repeat).err(),
        Some(G8lR2AcceptanceError::MissingS575PhysicalPass)
    );
    let mut unauthorized: G8lR2AcceptanceAnchor = S576_CANONICAL_ANCHOR;
    unauthorized.authorization_received = false;
    assert_eq!(
        G8lR2AcceptanceLedger::from_s575(1, unauthorized).err(),
        Some(G8lR2AcceptanceError::MissingS575PhysicalPass)
    );
    let mut overclaimed: G8lR2AcceptanceAnchor = S576_CANONICAL_ANCHOR;
    overclaimed.r2_field_acceptance_complete = true;
    assert_eq!(
        G8lR2AcceptanceLedger::from_s575(1, overclaimed).err(),
        Some(G8lR2AcceptanceError::PrematureAcceptanceClaim)
    );
    let mut scanout: G8lR2AcceptanceAnchor = S576_CANONICAL_ANCHOR;
    scanout.visible_scanout_observed = true;
    assert_eq!(
        G8lR2AcceptanceLedger::from_s575(1, scanout).err(),
        Some(G8lR2AcceptanceError::PrematureAcceptanceClaim)
    );
    let mut drifted: G8lR2AcceptanceAnchor = S576_CANONICAL_ANCHOR;
    drifted.repeat_status = "RED";
    assert_eq!(
        G8lR2AcceptanceLedger::from_s575(1, drifted).err(),
        Some(G8lR2AcceptanceError::S575AnchorDrift)
    );
    assert_eq!(
        G8lR2AcceptanceLedger::from_s575(0, S576_CANONICAL_ANCHOR).err(),
        Some(G8lR2AcceptanceError::WrongCpu)
    );
}

  {
    id: "g8l-s588-r2-supervised-recovery-callsite-partial",
    sequence: 588,
    slug: "r2_supervised_recovery_callsite",
    title: "Supervised recovery · Bounded model service callsite",
    titleTr: "Denetimli kurtarma · Sınırlı model servis callsite'ı",
    workstream: 3,
    focusedTests: 8,
    sourceBytes: 2817,
    sourceSha256: "21dae146a8f46efd2d6c9cda19816c68485280dd3d4b8298cd63e6e36a11e7ef",
    testBytes: 9227,
    testSha256: "61dd54f164e138deea1de3f69bd28aed35bb0ec99691b03b3f063ac4c9b1f422",
    blockOrdinal: 2,
    blockCount: 14,
    blockTitle: "Supervised recovery",
    blockTitleTr: "Denetimli kurtarma",
    blockStepCount: 9,
    stepOrdinal: 4,
    stepTitle: "Bounded model service callsite",
    stepTitleTr: "Sınırlı model servis callsite'ı",
    externalAuthorityRequired: false,
    acceptance: "S588, R1→R2 geçişinin 3. iş kolundaki Denetimli kurtarma bloğunun 4/9 Sınırlı model servis callsite'ı adımını exact S587 predecessor sonrasında ayrı typed descriptor ile fail-closed olarak kaydeder.",
    retainedBoundary: "Bu yalnız fail-closed software readiness kaydıdır; supported-profile runtime observation=0, physical observation=0, operatör yetkisi=0, dış kabul=0, acceptance_complete=false, r2_field_acceptance_complete=false, board-rpi5 kernel'e link=false ve RUNBOOK_EXECUTED_IN_S588=NO kalır. Bu iş kolu dış kabul otoritesi gerektirmez; fiziksel gözlem yine de zorunludur.",
  },