S873 · Erişilebilirlik ve yerelleştirme · Kabul sözleşmesi kaydı

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

//! S873 Accessibility and localization coverage · Acceptance contract registration.
//!
//! Separate typed gate after S872, release track R3,
//! phase R3.5 (Accessibility and localization coverage), step
//! 1/9 of the acceptance ladder.
//!
//! It advances only the fail-closed readiness ledger.  The retained S571/S575
//! physical observations are carried read-only; new runtime and physical
//! observations, operator authority, external acceptance, cross-profile
//! coverage and release-track completion 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_s872_r3_camera_sensor_gpu_isp_pipeline_regression_guard::S872_SEQUENCE;
use crate::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s708_r2_production_platform_isolation_contract::{
    advance_s708_to_s899_model_acceptance_gate, G8lProductAcceptanceError,
    G8lProductAcceptanceGateDescriptor, G8lProductAcceptanceLedger,
    G8lProductAcceptanceOutcome, G8lProductAcceptanceStep,
    S708_TO_S899_LINKED_INTO_BOARD_RPI5,
};

pub const S873_SEQUENCE: usize = 873;
pub const S873_EXPECTED_PREDECESSOR: usize = S872_SEQUENCE;
pub const S873_TRACK: &str = "R3";
pub const S873_PHASE: &str = "R3.5";
pub const S873_BLOCK_ORDINAL: usize = 17;
pub const S873_BLOCK_STEP_COUNT: usize = 9;
pub const S873_STEP_ORDINAL: usize = 1;
pub const S873_ACCEPTANCE_DOMAIN: &str = "accessibility_localization_coverage";
pub const S873_LINKED_INTO_BOARD_RPI5: bool = S708_TO_S899_LINKED_INTO_BOARD_RPI5;
pub const S873_NEW_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS: usize = 0;
pub const S873_NEW_PHYSICAL_OBSERVATIONS: usize = 0;
pub const S873_OPERATOR_AUTHORIZATIONS: usize = 0;
pub const S873_EXTERNAL_ACCEPTANCES: usize = 0;
pub const S873_PHYSICAL_OR_DEVICE_OPERATIONS: usize = 0;
pub const S873_ACCEPTANCE_COMPLETE: bool = false;
pub const S873_RELEASE_TRACK_COMPLETE: bool = false;
pub const RUNBOOK_EXECUTED_IN_S873: bool = false;

pub const S873_DESCRIPTOR: G8lProductAcceptanceGateDescriptor =
    G8lProductAcceptanceGateDescriptor {
        sequence: S873_SEQUENCE,
        predecessor_sequence: S873_EXPECTED_PREDECESSOR,
        track: S873_TRACK,
        phase: S873_PHASE,
        block_ordinal: S873_BLOCK_ORDINAL,
        block_step_count: S873_BLOCK_STEP_COUNT,
        step_ordinal: S873_STEP_ORDINAL,
        acceptance_domain: S873_ACCEPTANCE_DOMAIN,
        step: G8lProductAcceptanceStep::ContractRegistration,
        runtime_evidence_required: true,
        physical_evidence_required: true,
        external_authority_required: false,
    };

pub type G8lS873AcceptanceGateOutcome = G8lProductAcceptanceOutcome;
pub type G8lS873AcceptanceGateError = G8lProductAcceptanceError;

pub fn service_s873_model_r3_accessibility_localization_coverage_contract(
    ledger: &mut G8lProductAcceptanceLedger,
    caller_cpu: usize,
) -> Result<G8lS873AcceptanceGateOutcome, G8lS873AcceptanceGateError> {
    advance_s708_to_s899_model_acceptance_gate(ledger, caller_cpu, S873_DESCRIPTOR)
}

use aselsan_microkernel_simulation::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s708_r2_production_platform_isolation_contract::{
    advance_s708_to_s899_model_acceptance_gate,
    canonical_s708_to_s899_acceptance_descriptor, G8lProductAcceptanceAnchor,
    G8lProductAcceptanceError, G8lProductAcceptanceLedger, G8lProductAcceptanceOutcome,
    S708_CANONICAL_ANCHOR, S708_CHAIN_TIP_SEQUENCE, S708_FIRST_SEQUENCE, S899_LAST_SEQUENCE,
};
use aselsan_microkernel_simulation::g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s873_r3_accessibility_localization_coverage_contract as gate;

fn product_anchor() -> G8lProductAcceptanceAnchor {
    S708_CANONICAL_ANCHOR
}

fn acceptance_ledger() -> G8lProductAcceptanceLedger {
    G8lProductAcceptanceLedger::from_s707(1, product_anchor()).unwrap()
}

fn advance_before(ledger: &mut G8lProductAcceptanceLedger, sequence: usize) {
    for predecessor in S708_FIRST_SEQUENCE..sequence {
        let descriptor = canonical_s708_to_s899_acceptance_descriptor(predecessor).unwrap();
        assert!(matches!(
            advance_s708_to_s899_model_acceptance_gate(ledger, 1, descriptor),
            Ok(G8lProductAcceptanceOutcome::Advanced(_))
        ));
    }
}

#[test]
fn s873_descriptor_is_exact_and_canonical() {
    assert_eq!(gate::S873_SEQUENCE, 873);
    assert_eq!(gate::S873_EXPECTED_PREDECESSOR, 872);
    assert_eq!(gate::S873_TRACK, "R3");
    assert_eq!(gate::S873_PHASE, "R3.5");
    assert_eq!(gate::S873_BLOCK_ORDINAL, 17);
    assert_eq!(gate::S873_BLOCK_STEP_COUNT, 9);
    assert_eq!(gate::S873_STEP_ORDINAL, 1);
    assert_eq!(
        gate::S873_ACCEPTANCE_DOMAIN,
        "accessibility_localization_coverage"
    );
    assert_eq!(gate::S873_DESCRIPTOR.external_authority_required, false);
    assert!(gate::S873_DESCRIPTOR.physical_evidence_required);
    assert_eq!(
        canonical_s708_to_s899_acceptance_descriptor(873),
        Some(gate::S873_DESCRIPTOR)
    );
}

#[test]
fn s873_is_cpu1_scoped_and_waits_for_exact_predecessor() {
    let mut ledger = acceptance_ledger();
    assert_eq!(
        gate::service_s873_model_r3_accessibility_localization_coverage_contract(&mut ledger, 0),
        Err(G8lProductAcceptanceError::WrongCpu)
    );
    assert_eq!(ledger.last_completed_sequence(), S708_CHAIN_TIP_SEQUENCE);
    if 873 == S708_FIRST_SEQUENCE {
        let future = canonical_s708_to_s899_acceptance_descriptor(709).unwrap();
        assert!(matches!(
            advance_s708_to_s899_model_acceptance_gate(&mut ledger, 1, future),
            Ok(G8lProductAcceptanceOutcome::AwaitingPredecessor {
                expected_predecessor: 708,
                observed_predecessor: 707,
                ..
            })
        ));
    } else {
        assert!(matches!(
            gate::service_s873_model_r3_accessibility_localization_coverage_contract(
                &mut ledger,
                1
            ),
            Ok(G8lProductAcceptanceOutcome::AwaitingPredecessor {
                sequence: 873,
                expected_predecessor: 872,
                observed_predecessor: 707,
            })
        ));
    }
}

#[test]
fn s873_advances_once_with_non_acceptance_receipt() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 873);
    let G8lProductAcceptanceOutcome::Advanced(receipt) =
        gate::service_s873_model_r3_accessibility_localization_coverage_contract(&mut ledger, 1)
            .unwrap()
    else {
        panic!("S873 must advance")
    };
    assert_eq!((receipt.sequence, receipt.predecessor_sequence), (873, 872));
    assert_eq!(receipt.track, "R3");
    assert_eq!(receipt.phase, "R3.5");
    assert_eq!((receipt.block_ordinal, receipt.step_ordinal), (17, 1));
    assert_eq!(
        receipt.acceptance_domain,
        "accessibility_localization_coverage"
    );
    assert_eq!(receipt.completed_block_count, 16);
    assert_eq!(receipt.chain_tip_sequence, 707);
    assert_eq!(receipt.retained_runtime_baselines, 2);
    assert_eq!(receipt.retained_physical_observations, 2);
    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!(!receipt.operator_authority_received);
    assert!(!receipt.external_authority_received);
    assert!(!receipt.linked_into_board_rpi5);
    assert!(!receipt.cross_profile_coverage_complete);
    assert!(!receipt.acceptance_complete);
    assert!(!receipt.r2_field_acceptance_complete);
    assert!(!receipt.release_track_complete);
    assert!(!receipt.runbook_executed);
}

#[test]
fn s873_replay_is_idempotent_and_historical_reentry_does_not_mutate() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 873);
    let G8lProductAcceptanceOutcome::Advanced(receipt) =
        gate::service_s873_model_r3_accessibility_localization_coverage_contract(&mut ledger, 1)
            .unwrap()
    else {
        panic!("advance")
    };
    assert_eq!(
        gate::service_s873_model_r3_accessibility_localization_coverage_contract(&mut ledger, 1),
        Ok(G8lProductAcceptanceOutcome::Retained(receipt))
    );
    if 873 < S899_LAST_SEQUENCE {
        let next = canonical_s708_to_s899_acceptance_descriptor(873 + 1).unwrap();
        assert!(matches!(
            advance_s708_to_s899_model_acceptance_gate(&mut ledger, 1, next),
            Ok(G8lProductAcceptanceOutcome::Advanced(_))
        ));
        assert_eq!(
            gate::service_s873_model_r3_accessibility_localization_coverage_contract(
                &mut ledger,
                1
            ),
            Ok(G8lProductAcceptanceOutcome::AlreadyCompleted {
                requested_sequence: 873,
                last_completed_sequence: 873 + 1,
            })
        );
    }
}

#[test]
fn s873_open_claim_boundary_is_preserved() {
    assert_eq!(gate::S873_NEW_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS, 0);
    assert_eq!(gate::S873_NEW_PHYSICAL_OBSERVATIONS, 0);
    assert_eq!(gate::S873_OPERATOR_AUTHORIZATIONS, 0);
    assert_eq!(gate::S873_EXTERNAL_ACCEPTANCES, 0);
    assert_eq!(gate::S873_PHYSICAL_OR_DEVICE_OPERATIONS, 0);
    assert!(!gate::S873_ACCEPTANCE_COMPLETE);
    assert!(!gate::S873_RELEASE_TRACK_COMPLETE);
    assert!(!gate::S873_LINKED_INTO_BOARD_RPI5);
    assert!(!gate::RUNBOOK_EXECUTED_IN_S873);
}

#[test]
fn s873_is_simulation_only_and_adds_no_production_callsite() {
    const TARGET: &str = "g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s873_r3_accessibility_localization_coverage_contract";
    let source = include_str!("../../kernel/src/g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s873_r3_accessibility_localization_coverage_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 S873_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_s873_").count(), 0);
}

#[test]
fn s873_descriptor_mutation_fails_before_ledger_advance() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 873);
    let before = ledger.last_completed_sequence();
    let mut drift = gate::S873_DESCRIPTOR;
    drift.block_ordinal += 1;
    assert_eq!(
        advance_s708_to_s899_model_acceptance_gate(&mut ledger, 1, drift),
        Err(G8lProductAcceptanceError::DescriptorDrift)
    );
    assert_eq!(ledger.last_completed_sequence(), before);
}

#[test]
fn s873_rejects_premature_acceptance_and_chain_tip_drift() {
    let mut promoted: G8lProductAcceptanceAnchor = S708_CANONICAL_ANCHOR;
    promoted.r2_field_acceptance_complete = true;
    assert_eq!(
        G8lProductAcceptanceLedger::from_s707(1, promoted).err(),
        Some(G8lProductAcceptanceError::PrematureAcceptanceClaim)
    );
    let mut linked: G8lProductAcceptanceAnchor = S708_CANONICAL_ANCHOR;
    linked.linked_into_board_rpi5 = true;
    assert_eq!(
        G8lProductAcceptanceLedger::from_s707(1, linked).err(),
        Some(G8lProductAcceptanceError::PrematureAcceptanceClaim)
    );
    let mut ran: G8lProductAcceptanceAnchor = S708_CANONICAL_ANCHOR;
    ran.chain_tip_runbook_executed = true;
    assert_eq!(
        G8lProductAcceptanceLedger::from_s707(1, ran).err(),
        Some(G8lProductAcceptanceError::PrematureAcceptanceClaim)
    );
    let mut invented: G8lProductAcceptanceAnchor = S708_CANONICAL_ANCHOR;
    invented.retained_physical_observations = 3;
    assert_eq!(
        G8lProductAcceptanceLedger::from_s707(1, invented).err(),
        Some(G8lProductAcceptanceError::ChainTipDrift)
    );
    let mut moved: G8lProductAcceptanceAnchor = S708_CANONICAL_ANCHOR;
    moved.chain_tip_sequence = 706;
    assert_eq!(
        G8lProductAcceptanceLedger::from_s707(1, moved).err(),
        Some(G8lProductAcceptanceError::ChainTipDrift)
    );
    assert_eq!(
        G8lProductAcceptanceLedger::from_s707(0, S708_CANONICAL_ANCHOR).err(),
        Some(G8lProductAcceptanceError::WrongCpu)
    );
}

  {
    id: "g8l-s873-r3-accessibility-localization-coverage-contract-partial",
    sequence: 873,
    slug: "r3_accessibility_localization_coverage_contract",
    title: "Accessibility and localization coverage · Acceptance contract registration",
    titleTr: "Erişilebilirlik ve yerelleştirme · Kabul sözleşmesi kaydı",
    track: "R3",
    trackTitle: "Broad consumer ecosystem",
    trackTitleTr: "Geniş / tüketici ekosistemi",
    phase: "R3.5",
    focusedTests: 8,
    sourceBytes: 3188,
    sourceSha256: "6726d8d7c06ebf062d2a6214ff1c144cdadaae71a05d29bb887bdccb3c9523eb",
    testBytes: 9615,
    testSha256: "784495e89d42b74cb6c265cdfa0aa969ad0386a8fccb39a2691b7b6173993c98",
    blockOrdinal: 17,
    blockCount: 19,
    blockTitle: "Accessibility and localization coverage",
    blockTitleTr: "Erişilebilirlik ve yerelleştirme",
    blockStepCount: 9,
    stepOrdinal: 1,
    stepTitle: "Acceptance contract registration",
    stepTitleTr: "Kabul sözleşmesi kaydı",
    externalAuthorityRequired: false,
    acceptance: "S873, Geniş / tüketici ekosistemi izinin R3.5 fazındaki Erişilebilirlik ve yerelleştirme bloğunun 1/9 Kabul sözleşmesi kaydı adımını exact S872 predecessor sonrasında ayrı typed descriptor ile fail-closed olarak kaydeder.",
    retainedBoundary: "Bu yalnız fail-closed software readiness kaydıdır. S571/S575 fiziksel gözlemleri salt-okunur taşınır (retained=2); yeni runtime/fiziksel gözlem=0, operatör yetkisi=0, dış kabul=0, cross-profile kapsam=false, acceptance_complete=false, release_track_complete=false, board-rpi5 kernel'e link=false ve RUNBOOK_EXECUTED_IN_S873=NO kalır. Bu faz dış kabul otoritesi gerektirmez; fiziksel gözlem yine de zorunludur.",
  },