G8l: scheduler-owner mutation-callsite source boundary

use crate::g8l_target_dispatch_scheduler_owner_mutation_permit::{
    G8lSchedulerOwnerMutationPermit, G8lSchedulerOwnerMutationPermitError,
};

#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum G8lSchedulerOwnerMutationCallsiteError {
    Permit(G8lSchedulerOwnerMutationPermitError),
    InvalidCallerCpu,
    RuntimePhaseMismatch,
    RuntimeInputMismatch,
}

impl From<G8lSchedulerOwnerMutationPermitError> for G8lSchedulerOwnerMutationCallsiteError {
    fn from(error: G8lSchedulerOwnerMutationPermitError) -> Self {
        Self::Permit(error)
    }
}

/// Non-Copy source-model proof that the S191 permit reached the future
/// production scheduler-mutation callsite on CPU1.
#[derive(Debug, PartialEq, Eq)]
pub struct G8lSchedulerOwnerMutationCallsite {
    runtime_instance_id: u64,
    task_id: u64,
    caller_cpu: usize,
    owner_cpu: usize,
    owner_epoch: u64,
    exact_s191_permit_consumed: bool,
}

impl G8lSchedulerOwnerMutationCallsite {
    /// Consume the exact S191 mutation permit by value.
    pub fn from_mutation_permit(
        runtime: &G8lRuntimeAuthority,
        authority: &G8lSchedulerOwnerAuthority,
        permit: G8lSchedulerOwnerMutationPermit,
        caller_cpu: usize,
    ) -> Result<Self, G8lSchedulerOwnerMutationCallsiteError> {
        if caller_cpu != CPU1 {
            return Err(G8lSchedulerOwnerMutationCallsiteError::InvalidCallerCpu);
        }
        permit.revalidate(authority, runtime)?;
        if runtime.phase() != RuntimePhase::Running1 {
            return Err(G8lSchedulerOwnerMutationCallsiteError::RuntimePhaseMismatch);
        }
        if runtime.migration_input().owner_cpu != CPU1
            || runtime.migration_input().task_id != permit.task_id()
            || permit.caller_cpu() != CPU1
            || permit.owner_cpu() != CPU1
            || permit.owner_epoch() != authority.epoch()
        {
            return Err(G8lSchedulerOwnerMutationCallsiteError::RuntimeInputMismatch);
        }
        Ok(Self {
            runtime_instance_id: permit.runtime_instance_id(),
            task_id: permit.task_id(),
            caller_cpu,
            owner_cpu: permit.owner_cpu(),
            owner_epoch: permit.owner_epoch(),
            exact_s191_permit_consumed: true,
        })
    }

    pub fn revalidate(
        &self,
        authority: &G8lSchedulerOwnerAuthority,
        runtime: &G8lRuntimeAuthority,
    ) -> Result<(), G8lSchedulerOwnerMutationCallsiteError> {
        if self.caller_cpu != CPU1
            || self.owner_cpu != CPU1
            || self.owner_epoch == 0
            || 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(G8lSchedulerOwnerMutationCallsiteError::RuntimeInputMismatch);
        }
        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_cpu(&self) -> usize {
        self.owner_cpu
    }

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

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

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

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

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

    pub const fn production_scheduler_mutated(&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
    }

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

#[test]
fn publishes_exact_s191_permit_as_cpu1_mutation_callsite() {
    let (runtime, authority, permit) = mutation_permit();
    let callsite =
        G8lSchedulerOwnerMutationCallsite::from_mutation_permit(&runtime, &authority, permit, CPU1)
            .unwrap();

    assert_eq!(callsite.runtime_instance_id(), runtime.instance_id());
    assert_eq!(callsite.task_id(), TASK);
    assert_eq!(callsite.caller_cpu(), CPU1);
    assert_eq!(callsite.owner_cpu(), CPU1);
    assert_eq!(callsite.owner_epoch(), OWNER_EPOCH + 1);
    assert!(callsite.exact_s191_permit_consumed());
    callsite.revalidate(&authority, &runtime).unwrap();
}

  {
    id: "g8l-s192-scheduler-owner-mutation-callsite-partial",
    date: "2026-08-24",
    sequence: 192,
    status: "passed",
    umbrella_status: "partial",
    title: "G8l: scheduler-owner mutation-callsite source boundary",
    summary:
      "S192, non-Copy S191 scheduler-owner mutation permit'ini by-value tüketen 10/10 allocation-free mutation-callsite sınırını kapattı. Aynı canlı Running1 runtime, task, CPU1 owner ve epoch 23→24 yeniden doğrulanıp source-model scheduler-mutation callsite yayınlandı; authority/runtime ve production scheduler değiştirilmedi. Foreign authority/runtime ile CPU0 caller fail-closed kaldı.",
    evidence: [
      "g8l_target_dispatch_scheduler_owner_mutation_callsite: 10/10 PASS; exact S191 mutation-permit by-value consumption, Running1/CPU1 owner revalidation and closed production claims.",
      "Odaklı test iki bağımsız koşuda 10/10 PASS ve byte-eşit kaldı: 125 B / SHA-256 7742173cc9d98f4cbe90debabdf83ee6b5d3e9e965e25428a46d090582275222.",
      "S155–S192 birleşik matris iki bağımsız koşuda 38 grup / 334/334 PASS ve 4652 B / SHA-256 87e14f2d0ab820a5cb3835f1eebd935f77863d934e99cd2fd651fd5fac6088c5 verdi.",
      "RPi5 AArch64 source compile PASS: 468 warning envanterlendi, hata yok; 205667 B log / SHA-256 b633d9313ccd76dead116eb9d617e9a54cf94dbe2e311c699619c09557cf7986. Zero-warning iddiası yoktur.",
      "Mutation callsite yalnız source-model typed handoff'tur; production task::scheduler::SCHEDULER mutation/global exclusion, GIC/SGI, CPU1 ERET assembly ve hardware authority iddiası üretmez.",
      "Kalıcı kapsam: `docs/M8.1-RPi5-G8l-S192-Scheduler-Owner-Mutation-Callsite-Proof.md`.",
      "S192 fiziksel/device operasyonu yapmadı: physical/device operations=0 ve RUNBOOK_EXECUTED_IN_S192=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ı.",
      "Web publication: npm test 285/285, lint, TypeScript ve statik 23/23 PASS; Cloudflare Pages Production/main deployment 4fdb7c32-f487-4249-8ad3-8c801c1457df yayımlandı.",
      "Custom-domain /operations/, /timeline/ ve /yol-haritasi/ çıktıları yerel out ile byte-exact PASS: 6229006 B / 5400db7f…, 905121 B / 4449824f…, 904869 B / b029f455…. Her üç route S192 marker'ını ve RUNBOOK_EXECUTED_IN_S192=NO taşıdı.",
      "S192_10_OF_10_G8L_SCHEDULER_OWNER_MUTATION_CALLSITE_SOURCE_EXACT_S191_SCHEDULER_OWNER_MUTATION_PERMIT_CONSUMED_BY_VALUE_NONCOPY_LIVE_RUNNING1_CPU1_OWNER_TASK_EPOCH23_TO24_REVALIDATED_MUTATION_CALLSITE_PUBLISHED_WRONG_CALLER_FOREIGN_AUTHORITY_FOREIGN_RUNTIME_FAIL_CLOSED_PRODUCTION_CONSTRUCTOR_WIRED_NOT_INVOKED_PRODUCTION_SCHEDULER_GLOBAL_EXCLUSION_GIC_HARDWARE_GLOBAL_SOURCE_LINEARITY_QEMU_PHYSICAL_CPU2_CPU3_HOTPLUG_SOAK_GENERIC_SMP_OPEN_FULL_PHYSICAL_RUNBOOK_VISIBLE_S352_TO_S402_S377_NO_RUNBOOK_EXECUTED_IN_S192_VERIFIED",
      "Immutable pages.dev direct fetch current host'tan 10 saniyelik connect timeout verdi; bu immutable probe PASS olarak sayılmadı.",
    ],
    commands: [
      "cargo test --quiet --test g8l_target_dispatch_scheduler_owner_mutation_callsite -- --test-threads=1",
      "cargo check --quiet --manifest-path kernel/Cargo.toml --target aarch64-unknown-none --no-default-features --features board-rpi5",
      "npm run deploy",
    ],
    terminalSessions: [
      {
        id: "s192-g8l-scheduler-owner-mutation-callsite",
        title: "G8l S192 scheduler-owner mutation-callsite source boundary",
        commandLines: [
          "cargo test --quiet --test g8l_target_dispatch_scheduler_owner_mutation_callsite -- --test-threads=1",
        ],
        outputLines: [
          "running 10 tests",
          "test result: ok; 10 passed; 0 failed",
          "S191 mutation permit consumed by value; Running1/CPU1 mutation callsite published",
          "production scheduler mutation/global exclusion/GIC/hardware: not invoked / not claimed",
        ],
        exitCode: 0,
        outputMode: "selected",
      },
    ],
    terminalSessionsNote:
      "Terminal özeti dar S192 source sınırını gösterir; QEMU veya fiziksel cihaz çalıştırması değildir.",
    limitations: [
      "S192 dar typed mutation-callsite source-model kabulü PASS'tir; gerçek production scheduler global lock/mutation, GIC/hardware runtime ve fiziksel çalışma açık kalır.",
      "S192 fiziksel/device operasyonu yapmadı; RUNBOOK_EXECUTED_IN_S192=NO.",
    ],
  },