serif::solver::detail serif::solver::detail::InitialEvaluation serif::solver::detail::NewtonFailure serif::solver::detail::QualifiedStep serif::solver::detail::SolveObservation typename Options bool bool serif::solver::detail::checkpointable_options checkpointable_options serif::solver::detail::checkpointable_options = std::same_as<std::remove_cvref_t<decltype(std::declval<Options>().strategies)>, StandardNewton> && std::same_as<std::remove_cvref_t<decltype(std::declval<Options>().metric)>, NormalizedResidualMetric> && std::same_as<std::remove_cvref_t<decltype(std::declval<Options>().linear_solver)>, linear::FGMRES> Only built-in stateless numerical policies currently have a complete restart contract. typename Problem typename State typename Options typename Observer auto auto serif::solver::detail::run_newton (Problem &problem, State initial_state, Options options, Observer observer, std::optional< NewtonProgress > restart) run_newton serif::solver::detail::run_newton Problem & problem State initial_state Options options Observer observer std::optional< NewtonProgress > restart Find equilibrium while retaining the last fully qualified physical state. Preparation belongs to the problem; this driver alone publishes accepted steps. Scratch vectors use the problem's native storage. Timing belongs entirely to observers. std::optional< std::string > std::optional< std::string > serif::solver::detail::preparation_rejection (const auto &problem, const auto &evaluation) preparation_rejection serif::solver::detail::preparation_rejection const auto & problem const auto & evaluation Preserve numerical preparation failures while propagating invalid physical configurations. std::expected< MetricEvaluation, NewtonFailure > std::expected< MetricEvaluation, NewtonFailure > serif::solver::detail::qualify_candidate (auto &problem, const auto &state, const auto &evaluation, auto &metric_function, auto &strategy, TrialAssessment assessment={}) qualify_candidate serif::solver::detail::qualify_candidate auto & problem const auto & state const auto & evaluation auto & metric_function auto & strategy TrialAssessment assessment {} Qualify one already evaluated candidate through the same physical and metric gates everywhere. bool bool serif::solver::detail::finite_correction (std::span< const double > correction, const int expected_size) finite_correction serif::solver::detail::finite_correction std::span< const double > correction const int expected_size Every custom backend must preserve the correction dimensions and finite coefficients. void void serif::solver::detail::validate_start (const auto &options, const std::optional< NewtonProgress > &restart, std::size_t size) validate_start serif::solver::detail::validate_start const auto & options const std::optional< NewtonProgress > & restart std::size_t size Validate controls and restored history before any physical preparation. typename Problem std::expected< InitialEvaluation< typename Problem::System >, NewtonFailure > std::expected< InitialEvaluation< typename Problem::System >, NewtonFailure > serif::solver::detail::evaluate_start (Problem &problem, auto &state, auto &options, const std::optional< NewtonProgress > &restart, SolveDiagnostics &diagnostics) evaluate_start serif::solver::detail::evaluate_start Problem & problem auto & state auto & options const std::optional< NewtonProgress > & restart SolveDiagnostics & diagnostics Qualify the initial state and verify a restart against its original convergence reference. std::expected< DirectionAssessment, NewtonFailure > std::expected< DirectionAssessment, NewtonFailure > serif::solver::detail::compute_direction (auto &problem, const auto &accepted, const auto &prepared, auto &options, SolveDiagnostics &diagnostics, auto &rhs, auto &correction, std::span< double > physical_direction) compute_direction serif::solver::detail::compute_direction auto & problem const auto & accepted const auto & prepared auto & options SolveDiagnostics & diagnostics auto & rhs auto & correction std::span< double > physical_direction Solve and qualify a normalized correction before exposing its physical direction to backtracking. typename Problem typename State typename System typename Model auto auto serif::solver::detail::find_acceptable_step (Problem &problem, const SolveResult< State, System, Model > &accepted, MetricEvaluation accepted_metric, const auto &correction, std::span< const double > physical_direction, const DirectionAssessment &direction, double step, auto &options, SolveDiagnostics &diagnostics, auto &observation) find_acceptable_step serif::solver::detail::find_acceptable_step Problem & problem const SolveResult< State, System, Model > & accepted MetricEvaluation accepted_metric const auto & correction std::span< const double > physical_direction const DirectionAssessment & direction double step auto & options SolveDiagnostics & diagnostics auto & observation Find a safe, sufficiently decreasing candidate without changing the accepted state. A nonterminal candidate must prepare its inverse before publication. Preparation failure terminates this attempt; the caller still owns the previously accepted physical star. void void serif::solver::detail::save_progress (auto &result, auto &options, SolveDiagnostics &diagnostics, MetricEvaluation metric, std::span< const double > correction, double next_step) save_progress serif::solver::detail::save_progress auto & result auto & options SolveDiagnostics & diagnostics MetricEvaluation metric std::span< const double > correction double next_step Snapshot only fully committed numerical history; reporting has no influence on restart.