S840 · SDK, ABI ve geliştirici platformu · Sınırlı model servis callsite'ı

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

//! S840 SDK, ABI and developer platform · Bounded model service callsite.
//!
//! Separate typed gate after S839, release track R3,
//! phase R3.1 (SDK, ABI and developer platform), step
//! 4/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_s839_r3_sdk_abi_developer_platform_preflight::S839_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 S840_SEQUENCE: usize = 840;
pub const S840_EXPECTED_PREDECESSOR: usize = S839_SEQUENCE;
pub const S840_TRACK: &str = "R3";
pub const S840_PHASE: &str = "R3.1";
pub const S840_BLOCK_ORDINAL: usize = 13;
pub const S840_BLOCK_STEP_COUNT: usize = 9;
pub const S840_STEP_ORDINAL: usize = 4;
pub const S840_ACCEPTANCE_DOMAIN: &str = "sdk_abi_developer_platform";
pub const S840_LINKED_INTO_BOARD_RPI5: bool = S708_TO_S899_LINKED_INTO_BOARD_RPI5;
pub const S840_NEW_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS: usize = 0;
pub const S840_NEW_PHYSICAL_OBSERVATIONS: usize = 0;
pub const S840_OPERATOR_AUTHORIZATIONS: usize = 0;
pub const S840_EXTERNAL_ACCEPTANCES: usize = 0;
pub const S840_PHYSICAL_OR_DEVICE_OPERATIONS: usize = 0;
pub const S840_ACCEPTANCE_COMPLETE: bool = false;
pub const S840_RELEASE_TRACK_COMPLETE: bool = false;
pub const RUNBOOK_EXECUTED_IN_S840: bool = false;

pub const S840_DESCRIPTOR: G8lProductAcceptanceGateDescriptor =
    G8lProductAcceptanceGateDescriptor {
        sequence: S840_SEQUENCE,
        predecessor_sequence: S840_EXPECTED_PREDECESSOR,
        track: S840_TRACK,
        phase: S840_PHASE,
        block_ordinal: S840_BLOCK_ORDINAL,
        block_step_count: S840_BLOCK_STEP_COUNT,
        step_ordinal: S840_STEP_ORDINAL,
        acceptance_domain: S840_ACCEPTANCE_DOMAIN,
        step: G8lProductAcceptanceStep::BoundedModelCallsite,
        runtime_evidence_required: true,
        physical_evidence_required: true,
        external_authority_required: false,
    };

pub type G8lS840AcceptanceGateOutcome = G8lProductAcceptanceOutcome;
pub type G8lS840AcceptanceGateError = G8lProductAcceptanceError;

pub fn service_s840_model_r3_sdk_abi_developer_platform_callsite(
    ledger: &mut G8lProductAcceptanceLedger,
    caller_cpu: usize,
) -> Result<G8lS840AcceptanceGateOutcome, G8lS840AcceptanceGateError> {
    advance_s708_to_s899_model_acceptance_gate(ledger, caller_cpu, S840_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_s840_r3_sdk_abi_developer_platform_callsite 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 s840_descriptor_is_exact_and_canonical() {
    assert_eq!(gate::S840_SEQUENCE, 840);
    assert_eq!(gate::S840_EXPECTED_PREDECESSOR, 839);
    assert_eq!(gate::S840_TRACK, "R3");
    assert_eq!(gate::S840_PHASE, "R3.1");
    assert_eq!(gate::S840_BLOCK_ORDINAL, 13);
    assert_eq!(gate::S840_BLOCK_STEP_COUNT, 9);
    assert_eq!(gate::S840_STEP_ORDINAL, 4);
    assert_eq!(gate::S840_ACCEPTANCE_DOMAIN, "sdk_abi_developer_platform");
    assert_eq!(gate::S840_DESCRIPTOR.external_authority_required, false);
    assert!(gate::S840_DESCRIPTOR.physical_evidence_required);
    assert_eq!(
        canonical_s708_to_s899_acceptance_descriptor(840),
        Some(gate::S840_DESCRIPTOR)
    );
}

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

#[test]
fn s840_advances_once_with_non_acceptance_receipt() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 840);
    let G8lProductAcceptanceOutcome::Advanced(receipt) =
        gate::service_s840_model_r3_sdk_abi_developer_platform_callsite(&mut ledger, 1).unwrap()
    else {
        panic!("S840 must advance")
    };
    assert_eq!((receipt.sequence, receipt.predecessor_sequence), (840, 839));
    assert_eq!(receipt.track, "R3");
    assert_eq!(receipt.phase, "R3.1");
    assert_eq!((receipt.block_ordinal, receipt.step_ordinal), (13, 4));
    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 s840_replay_is_idempotent_and_historical_reentry_does_not_mutate() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 840);
    let G8lProductAcceptanceOutcome::Advanced(receipt) =
        gate::service_s840_model_r3_sdk_abi_developer_platform_callsite(&mut ledger, 1).unwrap()
    else {
        panic!("advance")
    };
    assert_eq!(
        gate::service_s840_model_r3_sdk_abi_developer_platform_callsite(&mut ledger, 1),
        Ok(G8lProductAcceptanceOutcome::Retained(receipt))
    );
    if 840 < S899_LAST_SEQUENCE {
        let next = canonical_s708_to_s899_acceptance_descriptor(840 + 1).unwrap();
        assert!(matches!(
            advance_s708_to_s899_model_acceptance_gate(&mut ledger, 1, next),
            Ok(G8lProductAcceptanceOutcome::Advanced(_))
        ));
        assert_eq!(
            gate::service_s840_model_r3_sdk_abi_developer_platform_callsite(&mut ledger, 1),
            Ok(G8lProductAcceptanceOutcome::AlreadyCompleted {
                requested_sequence: 840,
                last_completed_sequence: 840 + 1,
            })
        );
    }
}

#[test]
fn s840_open_claim_boundary_is_preserved() {
    assert_eq!(gate::S840_NEW_SUPPORTED_PROFILE_RUNTIME_OBSERVATIONS, 0);
    assert_eq!(gate::S840_NEW_PHYSICAL_OBSERVATIONS, 0);
    assert_eq!(gate::S840_OPERATOR_AUTHORIZATIONS, 0);
    assert_eq!(gate::S840_EXTERNAL_ACCEPTANCES, 0);
    assert_eq!(gate::S840_PHYSICAL_OR_DEVICE_OPERATIONS, 0);
    assert!(!gate::S840_ACCEPTANCE_COMPLETE);
    assert!(!gate::S840_RELEASE_TRACK_COMPLETE);
    assert!(!gate::S840_LINKED_INTO_BOARD_RPI5);
    assert!(!gate::RUNBOOK_EXECUTED_IN_S840);
}

#[test]
fn s840_is_simulation_only_and_adds_no_production_callsite() {
    const TARGET: &str = "g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s840_r3_sdk_abi_developer_platform_callsite";
    let source = include_str!("../../kernel/src/g8l_target_dispatch_scheduler_owner_scheduler_mutation_production_migration_lifecycle_s840_r3_sdk_abi_developer_platform_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 S840_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_s840_").count(), 0);
}

#[test]
fn s840_descriptor_mutation_fails_before_ledger_advance() {
    let mut ledger = acceptance_ledger();
    advance_before(&mut ledger, 840);
    let before = ledger.last_completed_sequence();
    let mut drift = gate::S840_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 s840_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-s840-r3-sdk-abi-developer-platform-callsite-partial",
    sequence: 840,
    slug: "r3_sdk_abi_developer_platform_callsite",
    title: "SDK, ABI and developer platform · Bounded model service callsite",
    titleTr: "SDK, ABI ve geliştirici platformu · Sınırlı model servis callsite'ı",
    track: "R3",
    trackTitle: "Broad consumer ecosystem",
    trackTitleTr: "Geniş / tüketici ekosistemi",
    phase: "R3.1",
    focusedTests: 8,
    sourceBytes: 3141,
    sourceSha256: "1776f824d1294a1b1695e5e10af05042f2ff634e81bd176eb3ac6367e82f353d",
    testBytes: 9354,
    testSha256: "838d953894d200ae560c0f6299ce5e8a52fa9c291a333f9af49b43ca9bbd2ca7",
    blockOrdinal: 13,
    blockCount: 19,
    blockTitle: "SDK, ABI and developer platform",
    blockTitleTr: "SDK, ABI ve geliştirici platformu",
    blockStepCount: 9,
    stepOrdinal: 4,
    stepTitle: "Bounded model service callsite",
    stepTitleTr: "Sınırlı model servis callsite'ı",
    externalAuthorityRequired: false,
    acceptance: "S840, Geniş / tüketici ekosistemi izinin R3.1 fazındaki SDK, ABI ve geliştirici platformu bloğunun 4/9 Sınırlı model servis callsite'ı adımını exact S839 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_S840=NO kalır. Bu faz dış kabul otoritesi gerektirmez; fiziksel gözlem yine de zorunludur.",
  },