S508 · Display, input and controlled application flow · Acceptance contract registration

#![allow(unexpected_cfgs)]

//! S508 Display, input and controlled application flow · Acceptance contract registration.
//!
//! This is a separate typed gate after S507.  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_s507_network_connectivity_boundary::S507_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 S508_SEQUENCE: usize = 508;
pub const S508_EXPECTED_PREDECESSOR: usize = S507_SEQUENCE;
pub const S508_BLOCK_ORDINAL: usize = 12;
pub const S508_STEP_ORDINAL: usize = 1;
pub const S508_ACCEPTANCE_DOMAIN: &str = "ui_application";
pub const S508_SOURCE_AUDIT_UNITS: usize = S431_SOURCE_AUDIT_UNITS;
pub const S508_DIRECT_ACCESS_SITES: usize = S431_DIRECT_ACCESS_SITES;
pub const S508_SOURCE_MODEL_COVERED_DIRECT_ACCESS_SITES: usize =
    S431_SOURCE_MODEL_COVERED_DIRECT_ACCESS_SITES;
pub const S508_PRODUCTION_GUARDED_DIRECT_ACCESS_SITES: usize =
    S431_PRODUCTION_GUARDED_DIRECT_ACCESS_SITES;
pub const S508_UNROUTED_DIRECT_ACCESS_SITES: usize = S431_UNROUTED_DIRECT_ACCESS_SITES;
pub const RUNBOOK_EXECUTED_IN_S508: bool = false;
pub const S508_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS: usize = 0;
pub const S508_PHYSICAL_OBSERVATIONS: usize = 0;
pub const S508_ACCEPTANCE_COMPLETE: bool = false;

pub const S508_DESCRIPTOR: G8lS431ToS535AcceptanceGateDescriptor =
    G8lS431ToS535AcceptanceGateDescriptor {
        sequence: S508_SEQUENCE,
        predecessor_sequence: S508_EXPECTED_PREDECESSOR,
        block_ordinal: S508_BLOCK_ORDINAL,
        step_ordinal: S508_STEP_ORDINAL,
        acceptance_domain: S508_ACCEPTANCE_DOMAIN,
        step: G8lS431ToS535AcceptanceStep::ContractRegistration,
        runtime_evidence_required: true,
        physical_evidence_required: true,
    };

pub type G8lS508AcceptanceGateOutcome = G8lS431ToS535AcceptanceOutcome;
pub type G8lS508AcceptanceGateError = G8lS431ToS535AcceptanceError;

pub fn service_s508_model_ui_application_contract(
    ledger: &mut G8lS431ToS535AcceptanceLedger,
    caller_cpu: usize,
) -> Result<G8lS508AcceptanceGateOutcome, G8lS508AcceptanceGateError> {
    advance_s431_to_s535_model_acceptance_gate(ledger, caller_cpu, S508_DESCRIPTOR)
}

#[cfg(all(target_arch = "aarch64", target_os = "none", feature = "board-rpi5"))]
pub fn service_s508_ui_application_contract_on_cpu1(
) -> Result<G8lS508AcceptanceGateOutcome, G8lS508AcceptanceGateError> {
    crate::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s431_runtime_evidence_contract::service_s431_to_s535_production_acceptance_gate_on_cpu1(
        S508_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_s508_ui_application_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 s508_descriptor_is_exact_and_canonical() {
    assert_eq!(gate::S508_SEQUENCE, 508);
    assert_eq!(gate::S508_EXPECTED_PREDECESSOR, 507);
    assert_eq!(gate::S508_BLOCK_ORDINAL, 12);
    assert_eq!(gate::S508_STEP_ORDINAL, 1);
    assert_eq!(gate::S508_ACCEPTANCE_DOMAIN, "ui_application");
    assert_eq!(
        canonical_s431_to_s535_acceptance_descriptor(508),
        Some(gate::S508_DESCRIPTOR)
    );
}

#[test]
fn s508_is_cpu1_scoped_and_waits_for_exact_predecessor() {
    let mut ledger = acceptance_ledger();
    assert_eq!(
        gate::service_s508_model_ui_application_contract(&mut ledger, 0),
        Err(G8lS431ToS535AcceptanceError::WrongCpu)
    );
    assert_eq!(ledger.last_completed_sequence(), 430);
    if 508 == 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_s508_model_ui_application_contract(&mut ledger, 1),
            Ok(G8lS431ToS535AcceptanceOutcome::AwaitingPredecessor {
                sequence: 508,
                expected_predecessor: 507,
                observed_predecessor: 430,
            })
        ));
    }
}

#[test]
fn s508_advances_once_with_non_acceptance_receipt() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 508);
    let G8lS431ToS535AcceptanceOutcome::Advanced(receipt) =
        gate::service_s508_model_ui_application_contract(&mut ledger, 1).unwrap()
    else {
        panic!("S508 must advance")
    };
    assert_eq!((receipt.sequence, receipt.predecessor_sequence), (508, 507));
    assert_eq!((receipt.block_ordinal, receipt.step_ordinal), (12, 1));
    assert_eq!(receipt.completed_block_count, 11);
    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 s508_replay_is_idempotent_and_historical_reentry_does_not_mutate() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 508);
    let first = gate::service_s508_model_ui_application_contract(&mut ledger, 1).unwrap();
    let G8lS431ToS535AcceptanceOutcome::Advanced(receipt) = first else {
        panic!("advance")
    };
    assert_eq!(
        gate::service_s508_model_ui_application_contract(&mut ledger, 1),
        Ok(G8lS431ToS535AcceptanceOutcome::Retained(receipt))
    );
    if 508 < S535_LAST_SEQUENCE {
        let next = canonical_s431_to_s535_acceptance_descriptor(508 + 1).unwrap();
        assert!(matches!(
            advance_s431_to_s535_model_acceptance_gate(&mut ledger, 1, next),
            Ok(G8lS431ToS535AcceptanceOutcome::Advanced(_))
        ));
        assert_eq!(
            gate::service_s508_model_ui_application_contract(&mut ledger, 1),
            Ok(G8lS431ToS535AcceptanceOutcome::AlreadyCompleted {
                requested_sequence: 508,
                last_completed_sequence: 508 + 1,
            })
        );
    }
}

#[test]
fn s508_coverage_and_open_claim_boundary_are_preserved() {
    assert_eq!(gate::S508_SOURCE_AUDIT_UNITS, 7);
    assert_eq!(gate::S508_DIRECT_ACCESS_SITES, 113);
    assert_eq!(gate::S508_SOURCE_MODEL_COVERED_DIRECT_ACCESS_SITES, 113);
    assert_eq!(gate::S508_PRODUCTION_GUARDED_DIRECT_ACCESS_SITES, 113);
    assert_eq!(gate::S508_UNROUTED_DIRECT_ACCESS_SITES, 0);
    assert_eq!(gate::S508_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS, 0);
    assert_eq!(gate::S508_PHYSICAL_OBSERVATIONS, 0);
    assert!(!gate::S508_ACCEPTANCE_COMPLETE);
    assert!(!gate::RUNBOOK_EXECUTED_IN_S508);
}

#[test]
fn s508_has_separate_kernel_simulation_and_production_wiring() {
    const TARGET: &str = "g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s508_ui_application_contract";
    const SERVICE: &str = "service_s508_ui_application_contract_on_cpu1";
    let source = include_str!("../../kernel/src/g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s508_ui_application_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 S508_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_s507_network_connectivity_boundary_on_cpu1")
        .unwrap();
    let current = exceptions.find(SERVICE).unwrap();
    assert!(previous < current);
    let successor_service = "service_s509_ui_application_request_on_cpu1";
    if !successor_service.is_empty() {
        assert!(current < exceptions.find(successor_service).unwrap());
    }
}

#[test]
fn s508_descriptor_mutation_fails_before_ledger_advance() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 508);
    let before = ledger.last_completed_sequence();
    let mut drift = gate::S508_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-s508-ui-application-contract-partial",
    sequence: 508,
    slug: "ui_application_contract",
    title: "Display, input and controlled application flow · Acceptance contract registration",
    focusedTests: 7,
    sourceBytes: 3280,
    sourceSha256: "fdce516eedaaed03d2c6dbbcf274ca9ef6ed90d081f902fa959196f86895f236",
    testBytes: 7806,
    testSha256: "960a541367281ee7bff221b5208c319c1a384423a46922ada4dbc56642ae6ed7",
    blockOrdinal: 12,
    blockTitle: "Display, input and controlled application flow",
    stepOrdinal: 1,
    stepTitle: "Acceptance contract registration",
    acceptance: "S508, Display, input and controlled application flow bloğının Acceptance contract registration adımını exact S507 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_S508=NO kalır.",
  },