S837 · SDK, ABI ve geliştirici platformu · Kabul sözleşmesi kaydı

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

//! S837 SDK, ABI and developer platform · Acceptance contract registration.
//!
//! Separate typed gate after S836, release track R3,
//! phase R3.1 (SDK, ABI and developer platform), 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_s836_r2r3_field_operations_product_family_scale_independent_assessment::S836_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 S837_SEQUENCE: usize = 837;
pub const S837_EXPECTED_PREDECESSOR: usize = S836_SEQUENCE;
pub const S837_TRACK: &str = "R3";
pub const S837_PHASE: &str = "R3.1";
pub const S837_BLOCK_ORDINAL: usize = 13;
pub const S837_BLOCK_STEP_COUNT: usize = 9;
pub const S837_STEP_ORDINAL: usize = 1;
pub const S837_ACCEPTANCE_DOMAIN: &str = "sdk_abi_developer_platform";
pub const S837_LINKED_INTO_BOARD_RPI5: bool = S708_TO_S899_LINKED_INTO_BOARD_RPI5;
pub const S837_NEW_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS: usize = 0;
pub const S837_NEW_PHYSICAL_OBSERVATIONS: usize = 0;
pub const S837_OPERATOR_AUTHORIZATIONS: usize = 0;
pub const S837_EXTERNAL_ACCEPTANCES: usize = 0;
pub const S837_PHYSICAL_OR_DEVICE_OPERATIONS: usize = 0;
pub const S837_ACCEPTANCE_COMPLETE: bool = false;
pub const S837_RELEASE_TRACK_COMPLETE: bool = false;
pub const RUNBOOK_EXECUTED_IN_S837: bool = false;

pub const S837_DESCRIPTOR: G8lProductAcceptanceGateDescriptor =
    G8lProductAcceptanceGateDescriptor {
        sequence: S837_SEQUENCE,
        predecessor_sequence: S837_EXPECTED_PREDECESSOR,
        track: S837_TRACK,
        phase: S837_PHASE,
        block_ordinal: S837_BLOCK_ORDINAL,
        block_step_count: S837_BLOCK_STEP_COUNT,
        step_ordinal: S837_STEP_ORDINAL,
        acceptance_domain: S837_ACCEPTANCE_DOMAIN,
        step: G8lProductAcceptanceStep::ContractRegistration,
        runtime_evidence_required: true,
        physical_evidence_required: true,
        external_authority_required: false,
    };

pub type G8lS837AcceptanceGateOutcome = G8lProductAcceptanceOutcome;
pub type G8lS837AcceptanceGateError = G8lProductAcceptanceError;

pub fn service_s837_model_r3_sdk_abi_developer_platform_contract(
    ledger: &mut G8lProductAcceptanceLedger,
    caller_cpu: usize,
) -> Result<G8lS837AcceptanceGateOutcome, G8lS837AcceptanceGateError> {
    advance_s708_to_s899_model_acceptance_gate(ledger, caller_cpu, S837_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_s837_r3_sdk_abi_developer_platform_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 s837_descriptor_is_exact_and_canonical() {
    assert_eq!(gate::S837_SEQUENCE, 837);
    assert_eq!(gate::S837_EXPECTED_PREDECESSOR, 836);
    assert_eq!(gate::S837_TRACK, "R3");
    assert_eq!(gate::S837_PHASE, "R3.1");
    assert_eq!(gate::S837_BLOCK_ORDINAL, 13);
    assert_eq!(gate::S837_BLOCK_STEP_COUNT, 9);
    assert_eq!(gate::S837_STEP_ORDINAL, 1);
    assert_eq!(gate::S837_ACCEPTANCE_DOMAIN, "sdk_abi_developer_platform");
    assert_eq!(gate::S837_DESCRIPTOR.external_authority_required, false);
    assert!(gate::S837_DESCRIPTOR.physical_evidence_required);
    assert_eq!(
        canonical_s708_to_s899_acceptance_descriptor(837),
        Some(gate::S837_DESCRIPTOR)
    );
}

#[test]
fn s837_is_cpu1_scoped_and_waits_for_exact_predecessor() {
    let mut ledger = acceptance_ledger();
    assert_eq!(
        gate::service_s837_model_r3_sdk_abi_developer_platform_contract(&mut ledger, 0),
        Err(G8lProductAcceptanceError::WrongCpu)
    );
    assert_eq!(ledger.last_completed_sequence(), S708_CHAIN_TIP_SEQUENCE);
    if 837 == 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_s837_model_r3_sdk_abi_developer_platform_contract(&mut ledger, 1),
            Ok(G8lProductAcceptanceOutcome::AwaitingPredecessor {
                sequence: 837,
                expected_predecessor: 836,
                observed_predecessor: 707,
            })
        ));
    }
}

#[test]
fn s837_advances_once_with_non_acceptance_receipt() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 837);
    let G8lProductAcceptanceOutcome::Advanced(receipt) =
        gate::service_s837_model_r3_sdk_abi_developer_platform_contract(&mut ledger, 1).unwrap()
    else {
        panic!("S837 must advance")
    };
    assert_eq!((receipt.sequence, receipt.predecessor_sequence), (837, 836));
    assert_eq!(receipt.track, "R3");
    assert_eq!(receipt.phase, "R3.1");
    assert_eq!((receipt.block_ordinal, receipt.step_ordinal), (13, 1));
    assert_eq!(receipt.acceptance_domain, "sdk_abi_developer_platform");
    assert_eq!(receipt.completed_block_count, 12);
    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 s837_replay_is_idempotent_and_historical_reentry_does_not_mutate() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 837);
    let G8lProductAcceptanceOutcome::Advanced(receipt) =
        gate::service_s837_model_r3_sdk_abi_developer_platform_contract(&mut ledger, 1).unwrap()
    else {
        panic!("advance")
    };
    assert_eq!(
        gate::service_s837_model_r3_sdk_abi_developer_platform_contract(&mut ledger, 1),
        Ok(G8lProductAcceptanceOutcome::Retained(receipt))
    );
    if 837 < S899_LAST_SEQUENCE {
        let next = canonical_s708_to_s899_acceptance_descriptor(837 + 1).unwrap();
        assert!(matches!(
            advance_s708_to_s899_model_acceptance_gate(&mut ledger, 1, next),
            Ok(G8lProductAcceptanceOutcome::Advanced(_))
        ));
        assert_eq!(
            gate::service_s837_model_r3_sdk_abi_developer_platform_contract(&mut ledger, 1),
            Ok(G8lProductAcceptanceOutcome::AlreadyCompleted {
                requested_sequence: 837,
                last_completed_sequence: 837 + 1,
            })
        );
    }
}

#[test]
fn s837_open_claim_boundary_is_preserved() {
    assert_eq!(gate::S837_NEW_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS, 0);
    assert_eq!(gate::S837_NEW_PHYSICAL_OBSERVATIONS, 0);
    assert_eq!(gate::S837_OPERATOR_AUTHORIZATIONS, 0);
    assert_eq!(gate::S837_EXTERNAL_ACCEPTANCES, 0);
    assert_eq!(gate::S837_PHYSICAL_OR_DEVICE_OPERATIONS, 0);
    assert!(!gate::S837_ACCEPTANCE_COMPLETE);
    assert!(!gate::S837_RELEASE_TRACK_COMPLETE);
    assert!(!gate::S837_LINKED_INTO_BOARD_RPI5);
    assert!(!gate::RUNBOOK_EXECUTED_IN_S837);
}

#[test]
fn s837_is_simulation_only_and_adds_no_production_callsite() {
    const TARGET: &str = "g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s837_r3_sdk_abi_developer_platform_contract";
    let source = include_str!("../../kernel/src/g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s837_r3_sdk_abi_developer_platform_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 S837_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_s837_").count(), 0);
}

#[test]
fn s837_descriptor_mutation_fails_before_ledger_advance() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 837);
    let before = ledger.last_completed_sequence();
    let mut drift = gate::S837_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 s837_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-s837-r3-sdk-abi-developer-platform-contract-partial",
    sequence: 837,
    slug: "r3_sdk_abi_developer_platform_contract",
    title: "SDK, ABI and developer platform · Acceptance contract registration",
    titleTr: "SDK, ABI ve geliştirici platformu · Kabul sözleşmesi kaydı",
    track: "R3",
    trackTitle: "Broad consumer ecosystem",
    trackTitleTr: "Geniş / tüketici ekosistemi",
    phase: "R3.1",
    focusedTests: 8,
    sourceBytes: 3169,
    sourceSha256: "b2eb67626f3c8cd29ed08c84fd96af159d35a618a56ff1c2c8601c469d551e95",
    testBytes: 9354,
    testSha256: "18addc541cd6dd69562c7237a63ca1bc52630460e561f5ab2a73e8724157a866",
    blockOrdinal: 13,
    blockCount: 19,
    blockTitle: "SDK, ABI and developer platform",
    blockTitleTr: "SDK, ABI ve geliştirici platformu",
    blockStepCount: 9,
    stepOrdinal: 1,
    stepTitle: "Acceptance contract registration",
    stepTitleTr: "Kabul sözleşmesi kaydı",
    externalAuthorityRequired: false,
    acceptance: "S837, Geniş / tüketici ekosistemi izinin R3.1 fazındaki SDK, ABI ve geliştirici platformu bloğunun 1/9 Kabul sözleşmesi kaydı adımını exact S836 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_S837=NO kalır. Bu faz dış kabul otoritesi gerektirmez; fiziksel gözlem yine de zorunludur.",
  },