S480 · Verified boot and rollback · Acceptance contract registration

#![allow(unexpected_cfgs)]

//! S480 Verified boot and rollback · Acceptance contract registration.
//!
//! This is a separate typed gate after S479.  It advances only the
//! acceptance-readiness ledger; supported-profile runtime observations,
//! physical observations and product acceptance remain explicitly absent.

use crate::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s479_secure_update_boundary::S479_SEQUENCE;
use crate::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s431_runtime_evidence_contract::{
    advance_s431_to_s535_model_acceptance_gate,
    G8lS431ToS535AcceptanceError, G8lS431ToS535AcceptanceGateDescriptor,
    G8lS431ToS535AcceptanceLedger, G8lS431ToS535AcceptanceOutcome,
    G8lS431ToS535AcceptanceStep, S431_DIRECT_ACCESS_SITES,
    S431_PRODUCTION_GUARDED_DIRECT_ACCESS_SITES, S431_SOURCE_AUDIT_UNITS,
    S431_SOURCE_MODEL_COVERED_DIRECT_ACCESS_SITES, S431_UNROUTED_DIRECT_ACCESS_SITES,
};

pub const S480_SEQUENCE: usize = 480;
pub const S480_EXPECTED_PREDECESSOR: usize = S479_SEQUENCE;
pub const S480_BLOCK_ORDINAL: usize = 8;
pub const S480_STEP_ORDINAL: usize = 1;
pub const S480_ACCEPTANCE_DOMAIN: &str = "boot_rollback";
pub const S480_SOURCE_AUDIT_UNITS: usize = S431_SOURCE_AUDIT_UNITS;
pub const S480_DIRECT_ACCESS_SITES: usize = S431_DIRECT_ACCESS_SITES;
pub const S480_SOURCE_MODEL_COVERED_DIRECT_ACCESS_SITES: usize =
    S431_SOURCE_MODEL_COVERED_DIRECT_ACCESS_SITES;
pub const S480_PRODUCTION_GUARDED_DIRECT_ACCESS_SITES: usize =
    S431_PRODUCTION_GUARDED_DIRECT_ACCESS_SITES;
pub const S480_UNROUTED_DIRECT_ACCESS_SITES: usize = S431_UNROUTED_DIRECT_ACCESS_SITES;
pub const RUNBOOK_EXECUTED_IN_S480: bool = false;
pub const S480_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS: usize = 0;
pub const S480_PHYSICAL_OBSERVATIONS: usize = 0;
pub const S480_ACCEPTANCE_COMPLETE: bool = false;

pub const S480_DESCRIPTOR: G8lS431ToS535AcceptanceGateDescriptor =
    G8lS431ToS535AcceptanceGateDescriptor {
        sequence: S480_SEQUENCE,
        predecessor_sequence: S480_EXPECTED_PREDECESSOR,
        block_ordinal: S480_BLOCK_ORDINAL,
        step_ordinal: S480_STEP_ORDINAL,
        acceptance_domain: S480_ACCEPTANCE_DOMAIN,
        step: G8lS431ToS535AcceptanceStep::ContractRegistration,
        runtime_evidence_required: true,
        physical_evidence_required: true,
    };

pub type G8lS480AcceptanceGateOutcome = G8lS431ToS535AcceptanceOutcome;
pub type G8lS480AcceptanceGateError = G8lS431ToS535AcceptanceError;

pub fn service_s480_model_boot_rollback_contract(
    ledger: &mut G8lS431ToS535AcceptanceLedger,
    caller_cpu: usize,
) -> Result<G8lS480AcceptanceGateOutcome, G8lS480AcceptanceGateError> {
    advance_s431_to_s535_model_acceptance_gate(ledger, caller_cpu, S480_DESCRIPTOR)
}

#[cfg(all(target_arch = "aarch64", target_os = "none", feature = "board-rpi5"))]
pub fn service_s480_boot_rollback_contract_on_cpu1(
) -> Result<G8lS480AcceptanceGateOutcome, G8lS480AcceptanceGateError> {
    crate::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s431_runtime_evidence_contract::service_s431_to_s535_production_acceptance_gate_on_cpu1(
        S480_DESCRIPTOR,
    )
}

use aselsan_microkernel_simulation::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s430_final_software_boundary::G8lS430FinalSoftwareBoundaryStatus;
use aselsan_microkernel_simulation::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s431_runtime_evidence_contract::{
    advance_s431_to_s535_model_acceptance_gate,
    canonical_s431_to_s535_acceptance_descriptor, G8lS431ToS535AcceptanceError,
    G8lS431ToS535AcceptanceLedger, G8lS431ToS535AcceptanceOutcome,
    S431_FIRST_SEQUENCE, S535_LAST_SEQUENCE,
};
use aselsan_microkernel_simulation::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s480_boot_rollback_contract as gate;

fn s430_anchor() -> G8lS430FinalSoftwareBoundaryStatus {
    G8lS430FinalSoftwareBoundaryStatus {
        attempt_id: 4301,
        provider_request_id: 4302,
        exclusive_token: 4303,
        completed_gate_count: 30,
        software_source_path_complete: true,
        whole_scheduler_exclusion_source_handshake_complete: true,
        main_migration_lifecycle_source_path_complete: true,
        supported_profile_runtime_acceptance_complete: false,
        physical_acceptance_complete: false,
        r2_product_acceptance_complete: false,
        runbook_executed: false,
    }
}

fn acceptance_ledger() -> G8lS431ToS535AcceptanceLedger {
    G8lS431ToS535AcceptanceLedger::from_s430(1, s430_anchor()).unwrap()
}

fn advance_before(ledger: &mut G8lS431ToS535AcceptanceLedger, sequence: usize) {
    for predecessor in S431_FIRST_SEQUENCE..sequence {
        let descriptor = canonical_s431_to_s535_acceptance_descriptor(predecessor).unwrap();
        assert!(matches!(
            advance_s431_to_s535_model_acceptance_gate(ledger, 1, descriptor),
            Ok(G8lS431ToS535AcceptanceOutcome::Advanced(_))
        ));
    }
}

#[test]
fn s480_descriptor_is_exact_and_canonical() {
    assert_eq!(gate::S480_SEQUENCE, 480);
    assert_eq!(gate::S480_EXPECTED_PREDECESSOR, 479);
    assert_eq!(gate::S480_BLOCK_ORDINAL, 8);
    assert_eq!(gate::S480_STEP_ORDINAL, 1);
    assert_eq!(gate::S480_ACCEPTANCE_DOMAIN, "boot_rollback");
    assert_eq!(
        canonical_s431_to_s535_acceptance_descriptor(480),
        Some(gate::S480_DESCRIPTOR)
    );
}

#[test]
fn s480_is_cpu1_scoped_and_waits_for_exact_predecessor() {
    let mut ledger = acceptance_ledger();
    assert_eq!(
        gate::service_s480_model_boot_rollback_contract(&mut ledger, 0),
        Err(G8lS431ToS535AcceptanceError::WrongCpu)
    );
    assert_eq!(ledger.last_completed_sequence(), 430);
    if 480 == S431_FIRST_SEQUENCE {
        let future = canonical_s431_to_s535_acceptance_descriptor(432).unwrap();
        assert!(matches!(
            advance_s431_to_s535_model_acceptance_gate(&mut ledger, 1, future),
            Ok(G8lS431ToS535AcceptanceOutcome::AwaitingPredecessor {
                expected_predecessor: 431,
                observed_predecessor: 430,
                ..
            })
        ));
    } else {
        assert!(matches!(
            gate::service_s480_model_boot_rollback_contract(&mut ledger, 1),
            Ok(G8lS431ToS535AcceptanceOutcome::AwaitingPredecessor {
                sequence: 480,
                expected_predecessor: 479,
                observed_predecessor: 430,
            })
        ));
    }
}

#[test]
fn s480_advances_once_with_non_acceptance_receipt() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 480);
    let G8lS431ToS535AcceptanceOutcome::Advanced(receipt) =
        gate::service_s480_model_boot_rollback_contract(&mut ledger, 1).unwrap()
    else {
        panic!("S480 must advance")
    };
    assert_eq!((receipt.sequence, receipt.predecessor_sequence), (480, 479));
    assert_eq!((receipt.block_ordinal, receipt.step_ordinal), (8, 1));
    assert_eq!(receipt.completed_block_count, 7);
    assert!(receipt.source_gate_complete);
    assert!(receipt.runtime_evidence_required);
    assert!(!receipt.supported_profile_runtime_observed);
    assert!(!receipt.physical_observed);
    assert!(!receipt.acceptance_complete);
    assert!(!receipt.runbook_executed);
}

#[test]
fn s480_replay_is_idempotent_and_historical_reentry_does_not_mutate() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 480);
    let first = gate::service_s480_model_boot_rollback_contract(&mut ledger, 1).unwrap();
    let G8lS431ToS535AcceptanceOutcome::Advanced(receipt) = first else {
        panic!("advance")
    };
    assert_eq!(
        gate::service_s480_model_boot_rollback_contract(&mut ledger, 1),
        Ok(G8lS431ToS535AcceptanceOutcome::Retained(receipt))
    );
    if 480 < S535_LAST_SEQUENCE {
        let next = canonical_s431_to_s535_acceptance_descriptor(480 + 1).unwrap();
        assert!(matches!(
            advance_s431_to_s535_model_acceptance_gate(&mut ledger, 1, next),
            Ok(G8lS431ToS535AcceptanceOutcome::Advanced(_))
        ));
        assert_eq!(
            gate::service_s480_model_boot_rollback_contract(&mut ledger, 1),
            Ok(G8lS431ToS535AcceptanceOutcome::AlreadyCompleted {
                requested_sequence: 480,
                last_completed_sequence: 480 + 1,
            })
        );
    }
}

#[test]
fn s480_coverage_and_open_claim_boundary_are_preserved() {
    assert_eq!(gate::S480_SOURCE_AUDIT_UNITS, 7);
    assert_eq!(gate::S480_DIRECT_ACCESS_SITES, 113);
    assert_eq!(gate::S480_SOURCE_MODEL_COVERED_DIRECT_ACCESS_SITES, 113);
    assert_eq!(gate::S480_PRODUCTION_GUARDED_DIRECT_ACCESS_SITES, 113);
    assert_eq!(gate::S480_UNROUTED_DIRECT_ACCESS_SITES, 0);
    assert_eq!(gate::S480_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS, 0);
    assert_eq!(gate::S480_PHYSICAL_OBSERVATIONS, 0);
    assert!(!gate::S480_ACCEPTANCE_COMPLETE);
    assert!(!gate::RUNBOOK_EXECUTED_IN_S480);
}

#[test]
fn s480_has_separate_kernel_simulation_and_production_wiring() {
    const TARGET: &str = "g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s480_boot_rollback_contract";
    const SERVICE: &str = "service_s480_boot_rollback_contract_on_cpu1";
    let source = include_str!("../../kernel/src/g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s480_boot_rollback_contract.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 S480_DESCRIPTOR"));
    assert_eq!(
        kernel_registry.matches(&format!("mod {TARGET};")).count(),
        1
    );
    assert_eq!(
        simulation_registry
            .matches(&format!("pub mod {TARGET};"))
            .count(),
        1
    );
    assert_eq!(exceptions.matches(SERVICE).count(), 1);
    let previous = exceptions
        .find("service_s479_secure_update_boundary_on_cpu1")
        .unwrap();
    let current = exceptions.find(SERVICE).unwrap();
    assert!(previous < current);
    let successor_service = "service_s481_boot_rollback_request_on_cpu1";
    if !successor_service.is_empty() {
        assert!(current < exceptions.find(successor_service).unwrap());
    }
}

#[test]
fn s480_descriptor_mutation_fails_before_ledger_advance() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 480);
    let before = ledger.last_completed_sequence();
    let mut drift = gate::S480_DESCRIPTOR;
    drift.block_ordinal += 1;
    assert_eq!(
        advance_s431_to_s535_model_acceptance_gate(&mut ledger, 1, drift),
        Err(G8lS431ToS535AcceptanceError::DescriptorDrift)
    );
    assert_eq!(ledger.last_completed_sequence(), before);
}

  {
    id: "g8l-s480-boot-rollback-contract-partial",
    sequence: 480,
    slug: "boot_rollback_contract",
    title: "Verified boot and rollback · Acceptance contract registration",
    focusedTests: 7,
    sourceBytes: 3249,
    sourceSha256: "6dac46dead203c062056a740f07e2a8c3cde33df1e01ea51f123c1266e47f276",
    testBytes: 7784,
    testSha256: "e83d3f2d0beaa24ed769d3ee29064565cbdb57e8e659be9343493d6fbabaf61f",
    blockOrdinal: 8,
    blockTitle: "Verified boot and rollback",
    stepOrdinal: 1,
    stepTitle: "Acceptance contract registration",
    acceptance: "S480, Verified boot and rollback bloğının Acceptance contract registration adımını exact S479 predecessor sonrasında ayrı typed descriptor ve ayrı CPU1 production service callsite ile kaydeder.",
    retainedBoundary: "Bu yalnız fail-closed software readiness kaydıdır; supported-profile runtime observation=0, physical observation=0, acceptance_complete=false ve RUNBOOK_EXECUTED_IN_S480=NO kalır.",
  },