pub mod evaluate;
pub mod evidence;
pub mod plan;
pub use evaluate::{
CheckOutcome, CheckReport, EvaluationContext, ExpectationReport, GateOutcome, GateReport,
evaluate,
};
pub use evidence::{
Actor, AuditReceipt, AuditVerdict, ExecutionReceipt, ManualObservation, ProcessStatus,
ReportedResult, VerifiedArtifacts,
};
pub use plan::{
CheckSpec, Evaluator, EvidenceCategory, Expectation, GatePolicy, Invocation, QualityPlan,
Stabilizer, Subject,
};
pub use sealmap_corpus::review::Artifact;
pub use sealmap_corpus::route::FamilyCatalogue;
use serde::de::DeserializeOwned;
use sha2::{Digest, Sha256};
#[derive(Debug, Clone, PartialEq, Eq, thiserror::Error)]
pub enum ContractError {
#[error("invalid JSON contract at line {line}, column {column}")]
Json {
line: usize,
column: usize,
},
#[error("invalid contract: {0}")]
Invalid(String),
}
pub fn sha256(bytes: &[u8]) -> String {
format!("{:x}", Sha256::digest(bytes))
}
pub fn from_json<T: DeserializeOwned>(bytes: &[u8]) -> Result<T, ContractError> {
serde_json::from_slice(bytes).map_err(|e| ContractError::Json {
line: e.line(),
column: e.column(),
})
}
pub(crate) fn require(condition: bool, message: impl Into<String>) -> Result<(), ContractError> {
if condition {
Ok(())
} else {
Err(ContractError::Invalid(message.into()))
}
}
pub(crate) fn nonempty(value: &str) -> bool {
!value.trim().is_empty() && !value.contains('\0')
}
pub(crate) fn identifier(value: &str) -> bool {
!value.is_empty()
&& value.len() <= 128
&& value
.bytes()
.all(|b| b.is_ascii_alphanumeric() || matches!(b, b'-' | b'_' | b'.'))
}
pub(crate) fn hex(value: &str, lengths: &[usize]) -> bool {
lengths.contains(&value.len())
&& value
.bytes()
.all(|b| b.is_ascii_digit() || (b'a'..=b'f').contains(&b))
}
pub(crate) fn artifact_shape(artifact: &Artifact) -> Result<(), ContractError> {
sealmap_corpus::review::validate_artifact(artifact).map_err(|_| {
ContractError::Invalid("artifact requires a confined relative path and SHA-256".into())
})
}
pub(crate) fn relative_path(path: &str) -> bool {
artifact_shape(&Artifact {
path: path.into(),
sha256: "0".repeat(64),
})
.is_ok()
}
#[cfg(feature = "process")]
pub mod process;
#[cfg(feature = "cli")]
pub mod deepsec;
#[cfg(feature = "cli")]
pub mod cli;
#[cfg(feature = "cli")]
mod git_metadata;