-- SPDX-FileCopyrightText: 2026 Alexandra de Wit
--
-- SPDX-License-Identifier: MIT

{- | Decide public artifact admission and retain skipped or unreached rule evidence.
The serve path and worker share rules, filename selection, and integrity-floor checks.
-}
module Ecluse.Core.Package.Admission (
    ArtifactAdmission (..),
    admissionTransience,
    admitArtifactWithDecision,
) where

import Ecluse.Core.Package (Artifact, Hash, PackageDetails, artFilename, artHashes, pkgArtifacts)
import Ecluse.Core.Package.Integrity (
    MinIntegrity,
    VersionIntegrity (BelowFloor, MeetsFloor, NoIntegrity),
    classifyDigests,
 )
import Ecluse.Core.Rules (PreparedRule, evalRules)
import Ecluse.Core.Rules.Types (
    Decision (Admitted, Blocked, BlockedByDefault, Undecidable),
    EvalContext,
    Transience (WontResolve),
    completeEvidence,
 )
import Ecluse.Core.Server.Path (Filename, unFilename)

-- | A public artifact verdict. Inability retains the shared serve and worker retry classification.
data ArtifactAdmission
    = -- | The matched filename and artifact, with digests that meet the integrity floor.
      AdmissionAdmit Filename Artifact (NonEmpty Hash)
    | -- | A decisive rule or deny-by-default refusal.
      AdmissionDenied Decision
    | -- | A fail-closed inability whose decision carries retry advice.
      AdmissionUndecidable Decision
    | -- | Current metadata contains no artifact with the requested filename.
      AdmissionFileAbsent
    | -- | The selected artifact has no digest.
      AdmissionIntegrityMissing
    | -- | The selected artifact has digests, but none meets the public floor.
      AdmissionBelowFloor
    deriving stock (Int -> ArtifactAdmission -> ShowS
[ArtifactAdmission] -> ShowS
ArtifactAdmission -> String
(Int -> ArtifactAdmission -> ShowS)
-> (ArtifactAdmission -> String)
-> ([ArtifactAdmission] -> ShowS)
-> Show ArtifactAdmission
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
$cshowsPrec :: Int -> ArtifactAdmission -> ShowS
showsPrec :: Int -> ArtifactAdmission -> ShowS
$cshow :: ArtifactAdmission -> String
show :: ArtifactAdmission -> String
$cshowList :: [ArtifactAdmission] -> ShowS
showList :: [ArtifactAdmission] -> ShowS
Show)

-- | Retain the evaluated decision for a mirror publication audit without running the rules again.
admitArtifactWithDecision :: EvalContext -> [PreparedRule] -> MinIntegrity -> Filename -> PackageDetails -> IO (ArtifactAdmission, Decision)
admitArtifactWithDecision :: EvalContext
-> [PreparedRule]
-> MinIntegrity
-> Filename
-> PackageDetails
-> IO (ArtifactAdmission, Decision)
admitArtifactWithDecision EvalContext
ctx [PreparedRule]
rules MinIntegrity
minIntegrity Filename
file PackageDetails
details = do
    decision <- EvalContext -> [PreparedRule] -> RuleEvidence -> IO Decision
evalRules EvalContext
ctx [PreparedRule]
rules (PackageDetails -> RuleEvidence
completeEvidence PackageDetails
details)
    pure (admissionOf minIntegrity file details decision, decision)

-- The filename and integrity steps over a settled rules decision.
admissionOf :: MinIntegrity -> Filename -> PackageDetails -> Decision -> ArtifactAdmission
admissionOf :: MinIntegrity
-> Filename -> PackageDetails -> Decision -> ArtifactAdmission
admissionOf MinIntegrity
minIntegrity Filename
file PackageDetails
details Decision
decision =
    case Decision
decision of
        Admitted{} -> MinIntegrity -> Filename -> PackageDetails -> ArtifactAdmission
admitFile MinIntegrity
minIntegrity Filename
file PackageDetails
details
        Blocked{} -> Decision -> ArtifactAdmission
AdmissionDenied Decision
decision
        BlockedByDefault{} -> Decision -> ArtifactAdmission
AdmissionDenied Decision
decision
        Undecidable{} -> Decision -> ArtifactAdmission
AdmissionUndecidable Decision
decision

-- The filename and integrity steps, once the rules engine has admitted the version.
admitFile :: MinIntegrity -> Filename -> PackageDetails -> ArtifactAdmission
admitFile :: MinIntegrity -> Filename -> PackageDetails -> ArtifactAdmission
admitFile MinIntegrity
minIntegrity Filename
file PackageDetails
details = case Filename -> PackageDetails -> Maybe Artifact
artifactFor Filename
file PackageDetails
details of
    Maybe Artifact
Nothing -> ArtifactAdmission
AdmissionFileAbsent
    Just Artifact
artifact -> case MinIntegrity -> [Hash] -> VersionIntegrity
forall floor.
IntegrityFloor floor =>
floor -> [Hash] -> VersionIntegrity
classifyDigests MinIntegrity
minIntegrity (Artifact -> [Hash]
artHashes Artifact
artifact) of
        VersionIntegrity
MeetsFloor ->
            -- 'MeetsFloor' guarantees a digest is present, but 'artHashes' is a plain list.
            -- The unreachable empty case fails closed, as if no digest existed.
            ArtifactAdmission
-> (NonEmpty Hash -> ArtifactAdmission)
-> Maybe (NonEmpty Hash)
-> ArtifactAdmission
forall b a. b -> (a -> b) -> Maybe a -> b
maybe ArtifactAdmission
AdmissionIntegrityMissing (Filename -> Artifact -> NonEmpty Hash -> ArtifactAdmission
AdmissionAdmit Filename
file Artifact
artifact) ([Hash] -> Maybe (NonEmpty Hash)
forall a. [a] -> Maybe (NonEmpty a)
nonEmpty (Artifact -> [Hash]
artHashes Artifact
artifact))
        VersionIntegrity
BelowFloor -> ArtifactAdmission
AdmissionBelowFloor
        VersionIntegrity
NoIntegrity -> ArtifactAdmission
AdmissionIntegrityMissing

-- | Retry advice for an inability, shared by the serve and worker paths.
admissionTransience :: ArtifactAdmission -> Maybe Transience
admissionTransience :: ArtifactAdmission -> Maybe Transience
admissionTransience = \case
    AdmissionUndecidable (Undecidable Transience
transience Reason
_) -> Transience -> Maybe Transience
forall a. a -> Maybe a
Just Transience
transience
    -- 'AdmissionUndecidable' carries only an 'Undecidable' here, so another decision is a
    -- construction fault. Fail closed: an inability no retry clears.
    AdmissionUndecidable Decision
_ -> Transience -> Maybe Transience
forall a. a -> Maybe a
Just Transience
WontResolve
    AdmissionAdmit{} -> Maybe Transience
forall a. Maybe a
Nothing
    AdmissionDenied{} -> Maybe Transience
forall a. Maybe a
Nothing
    ArtifactAdmission
AdmissionFileAbsent -> Maybe Transience
forall a. Maybe a
Nothing
    ArtifactAdmission
AdmissionIntegrityMissing -> Maybe Transience
forall a. Maybe a
Nothing
    ArtifactAdmission
AdmissionBelowFloor -> Maybe Transience
forall a. Maybe a
Nothing

-- 'Nothing' when no artifact carries the filename: a forwarded miss, never a fabricated location.
artifactFor :: Filename -> PackageDetails -> Maybe Artifact
artifactFor :: Filename -> PackageDetails -> Maybe Artifact
artifactFor Filename
file PackageDetails
details =
    (Artifact -> Bool) -> NonEmpty Artifact -> Maybe Artifact
forall (t :: * -> *) a. Foldable t => (a -> Bool) -> t a -> Maybe a
find ((Text -> Text -> Bool
forall a. Eq a => a -> a -> Bool
== Filename -> Text
unFilename Filename
file) (Text -> Bool) -> (Artifact -> Text) -> Artifact -> Bool
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Artifact -> Text
artFilename) (PackageDetails -> NonEmpty Artifact
pkgArtifacts PackageDetails
details)