G8l: guarded scheduler-mutation receipt → typed acknowledgement

use crate::g8l_target_dispatch_scheduler_owner_scheduler_mutation_guarded_callsite_receipt::{
    G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceipt,
    G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptError,
};

#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptAckError {
    GuardedCallsiteReceipt(G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptError),
    InvalidCallerCpu,
    RuntimeInputMismatch,
}

impl From<G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptError>
    for G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptAckError
{
    fn from(error: G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptError) -> Self {
        Self::GuardedCallsiteReceipt(error)
    }
}

/// Non-`Copy` S202 source-model proof that the S201 receipt reaches a typed
/// acknowledgement while retaining the exact S198 exclusion lease until drop.
#[derive(Debug)]
pub struct G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptAck<'a> {
    receipt: G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceipt<'a>,
    runtime_instance_id: u64,
    task_id: u64,
    caller_cpu: usize,
    owner_epoch: u64,
    exact_s201_receipt_consumed: bool,
}

impl<'a> G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptAck<'a> {
    /// Consume the exact S201 guarded-callsite receipt by value at the
    /// acknowledgement seam.
    pub fn from_guarded_callsite_receipt(
        runtime: &G8lRuntimeAuthority,
        authority: &G8lSchedulerOwnerAuthority,
        receipt: G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceipt<'a>,
        caller_cpu: usize,
    ) -> Result<Self, G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptAckError> {
        if caller_cpu != CPU1 {
            return Err(
                G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptAckError::InvalidCallerCpu,
            );
        }
        receipt.revalidate(authority, runtime)?;
        if runtime.phase() != RuntimePhase::Running1
            || runtime.migration_input().owner_cpu != CPU1
            || runtime.migration_input().task_id != receipt.task_id()
            || receipt.caller_cpu() != CPU1
            || receipt.owner_epoch() != authority.epoch()
        {
            return Err(
                G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptAckError::RuntimeInputMismatch,
            );
        }
        Ok(Self {
            runtime_instance_id: runtime.instance_id(),
            task_id: receipt.task_id(),
            caller_cpu,
            owner_epoch: receipt.owner_epoch(),
            exact_s201_receipt_consumed: true,
            receipt,
        })
    }

    pub fn revalidate(
        &self,
        authority: &G8lSchedulerOwnerAuthority,
        runtime: &G8lRuntimeAuthority,
    ) -> Result<(), G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptAckError> {
        if self.caller_cpu != CPU1
            || self.task_id != authority.task_id()
            || authority.owner_cpu() != CPU1
            || authority.epoch() != self.owner_epoch
            || runtime.instance_id() != self.runtime_instance_id
            || runtime.phase() != RuntimePhase::Running1
            || runtime.migration_input().owner_cpu != CPU1
            || runtime.migration_input().task_id != self.task_id
        {
            return Err(
                G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptAckError::RuntimeInputMismatch,
            );
        }
        self.receipt.revalidate(authority, runtime)?;
        Ok(())
    }

    pub const fn runtime_instance_id(&self) -> u64 {
        self.runtime_instance_id
    }

    pub const fn task_id(&self) -> u64 {
        self.task_id
    }

    pub const fn caller_cpu(&self) -> usize {
        self.caller_cpu
    }

    pub const fn owner_epoch(&self) -> u64 {
        self.owner_epoch
    }

    pub const fn exclusion_token(&self) -> u64 {
        self.receipt.exclusion_token()
    }

    /// Consume this acknowledgement and release the exact S198 token.
    pub fn release(
        self,
    ) -> Result<
        G8lSchedulerMutationExclusionReleaseReceipt,
        G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceiptAckError,
    > {
        self.receipt.release().map_err(Into::into)
    }

    pub const fn exact_s201_receipt_consumed(&self) -> bool {
        self.exact_s201_receipt_consumed
    }

    pub const fn production_constructor_wired(&self) -> bool {
        true
    }

    pub const fn production_constructor_invoked(&self) -> bool {
        false
    }

    pub const fn guarded_callsite_receipt_ack_published(&self) -> bool {
        true
    }

    pub const fn production_scheduler_mutated(&self) -> bool {
        false
    }

    pub const fn all_scheduler_accesses_covered(&self) -> bool {
        false
    }

    pub const fn global_scheduler_exclusion_proven(&self) -> bool {
        false
    }

    pub const fn gic_delivery_wired(&self) -> bool {
        false
    }

    pub const fn hardware_execution_proven(&self) -> bool {
        false
    }
}

#[test]
fn source_boundary_consumes_receipt_by_value_without_scheduler_import() {
    let source = include_str!(
        "../../kernel/src/g8l_target_dispatch_scheduler_owner_scheduler_mutation_guarded_callsite_receipt_ack.rs"
    );
    let handoff = source
        .split("pub fn from_guarded_callsite_receipt")
        .nth(1)
        .unwrap();
    assert!(
        handoff.contains("receipt: G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceipt<'a>")
    );
    assert!(!handoff.contains("receipt: &G8lSchedulerOwnerSchedulerMutationGuardedCallsiteReceipt"));
    assert!(source.contains("receipt.revalidate(authority, runtime)?"));
    assert!(!source.contains("use crate::task"));
    assert!(source.contains("S202"));
}

  {
    id: "g8l-s202-scheduler-mutation-guarded-callsite-receipt-ack-partial",
    date: "2026-08-25",
    sequence: 202,
    status: "passed",
    umbrella_status: "partial",
    title: "G8l: guarded scheduler-mutation receipt → typed acknowledgement",
    summary:
      "S202, non-Copy S201 guarded-callsite receipt'ini by-value tüketip exact S198 exclusion token'ını typed acknowledgement boyunca tutan 10/10 allocation-free source sınırını kapattı. Canlı Running1 runtime, CPU1 owner/task ve epoch 23→24 yeniden doğrulanıyor; acknowledgement drop ve wrong-caller error yollarında exact token serbest kalıyor. Production scheduler import edilmedi, çağrılmadı veya değiştirilmedi.",
    evidence: [
      "g8l_target_dispatch_scheduler_owner_scheduler_mutation_guarded_callsite_receipt_ack: 10/10 PASS; exact S201 receipt by-value consumption, acknowledgement retention, Running1/CPU1 owner/task/epoch revalidation and closed production claims.",
      "Exact-token lifecycle: acknowledgement yaşarken S198 token tutuluyor; acknowledgement drop ve wrong-caller error sonrasında token serbest kalıyor.",
      "Odaklı test iki bağımsız koşuda byte-eşit kaldı: 125 B / SHA-256 7742173cc9d98f4cbe90debabdf83ee6b5d3e9e965e25428a46d090582275222.",
      "S155–S202 sıra-düzenli birleşik matris iki bağımsız koşuda 48 grup / 437/437 PASS ve 5905 B / SHA-256 d0b79c11096c478dddf4beb7ec70ed199bcd2054e13ec02d90a82909a577749c verdi.",
      "RPi5 AArch64 compile PASS: 505 warning envanterlendi, hata yok; 235722 B / SHA-256 657d023d875f6aca32c33a6d43db8b6ec0380d8b845ce248ff18bb75c74f70ff. Zero-warning iddiası yoktur.",
      "RPi5 AArch64 smp compile PASS: 505 warning envanterlendi, hata yok; 235664 B / SHA-256 14f528d293099fb4e30a9c775d8222fd30dd8480e5d31cb86903fe191e9dd312. Zero-warning iddiası yoktur.",
      "Kalıcı kapsam: `docs/M8.1-RPi5-G8l-S202-Scheduler-Mutation-Guarded-Callsite-Receipt-Ack-Proof.md`.",
      "S202 fiziksel/device operasyonu yapmadı: physical/device operations=0 ve RUNBOOK_EXECUTED_IN_S202=NO.",
      "Görünür fiziksel sıra: Gücü kapat → SD kartı Pi'den çıkar → SD kartı Mac'e tak → Yetkili write/verify/read-back işlemini tamamla → SD kartı Mac'ten güvenli çıkar → SD kartı güçsüz Pi'ye tak → UART capture pre-arm ve exact identity kapısını doğrula → Güç ver. Bu sıra yalnız tarihsel S124'te tamamlandı; S202'de uygulanmadı.",
      "Canlı marker: S202_10_OF_10_G8L_SCHEDULER_MUTATION_GUARDED_CALLSITE_RECEIPT_ACK_SOURCE_EXACT_S201_RECEIPT_CONSUMED_BY_VALUE_NONCOPY_EXACT_S198_TOKEN_RETAINED_UNTIL_ACKNOWLEDGEMENT_DROP_AND_RELEASED_ON_ERROR_LIVE_RUNNING1_CPU1_OWNER_TASK_EPOCH23_TO24_REVALIDATED_PRODUCTION_CONSTRUCTOR_WIRED_NOT_INVOKED_PRODUCTION_SCHEDULER_NOT_IMPORTED_NOT_MUTATED_LEGACY_SCHEDULER_ACCESSES_UNCOVERED_WHOLE_SCHEDULER_GLOBAL_EXCLUSION_GIC_HARDWARE_QEMU_PHYSICAL_CPU2_CPU3_HOTPLUG_SOAK_GENERIC_SMP_OPEN_FULL_PHYSICAL_RUNBOOK_VISIBLE_S362_TO_S412_S387_NO_RUNBOOK_EXECUTED_IN_S202_VERIFIED; deployment-specific route/hash evidence is recorded in the project-status manifest.",
    ],
    commands: [
      "cargo test --quiet --test g8l_target_dispatch_scheduler_owner_scheduler_mutation_guarded_callsite_receipt_ack -- --test-threads=1",
      "cargo check --quiet --manifest-path kernel/Cargo.toml --target aarch64-unknown-none --no-default-features --features board-rpi5",
      "cargo check --quiet --manifest-path kernel/Cargo.toml --target aarch64-unknown-none --no-default-features --features board-rpi5,smp",
    ],
    terminalSessions: [
      {
        id: "s202-g8l-scheduler-mutation-guarded-callsite-receipt-ack",
        title: "G8l S202 guarded-callsite receipt acknowledgement",
        commandLines: [
          "cargo test --quiet --test g8l_target_dispatch_scheduler_owner_scheduler_mutation_guarded_callsite_receipt_ack -- --test-threads=1",
        ],
        outputLines: [
          "running 10 tests",
          "test result: ok; 10 passed; 0 failed",
          "S201 receipt consumed by value; exact S198 token retained through typed acknowledgement",
          "production scheduler mutation/global exclusion/GIC/hardware: not invoked / not claimed",
        ],
        exitCode: 0,
        outputMode: "selected",
      },
    ],
    terminalSessionsNote:
      "Terminal özeti S202 host/source acknowledgement kabulünü gösterir; QEMU veya fiziksel cihaz çalıştırması değildir.",
    limitations: [
      "S202 exact S201 guarded-callsite receipt'ini typed acknowledgement'a taşır; production scheduler mutation constructor'ını invoke etmez.",
      "Legacy static mut SCHEDULER erişimleri acknowledgement kapsamına alınmadığı için whole-scheduler global exclusion açık kalır.",
      "S202 fiziksel/device operasyonu yapmadı; RUNBOOK_EXECUTED_IN_S202=NO.",
    ],
  },