feat(linear-static-mitc4-shell): step 9 - shell-analysis-state

include/fesa/analysis/analysis_state.hpp

@@ -1,9 +1,11 @@
 #pragma once
 
+#include "fesa/core/status.hpp"
 #include "fesa/fem/dof_manager.hpp"
 #include "fesa/math/vector.hpp"
 #include "fesa/results/result_records.hpp"
 
+#include <array>
 #include <cstddef>
 #include <vector>
 
@@ -32,6 +34,13 @@ public:
     const std::vector<GaussResultRow>& gaussResults() const noexcept;
     std::vector<StressS11Row>& stressResults() noexcept;
     const std::vector<StressS11Row>& stressResults() const noexcept;
+    Status commitShellResults(
+        const std::vector<EntityIndex>& expectedElementOrder,
+        ShellStateCandidate candidate);
+    const std::vector<ShellResultRow>& shellResults() const noexcept;
+    double physicalStrainEnergy() const noexcept;
+    const std::array<double, 6>& equilibrium() const noexcept;
+    const std::array<double, 3>& verificationMetrics() const noexcept;
 
 private:
     AnalysisState(std::size_t fullDofCount, StepFrameIdentity identity);
@@ -47,6 +56,11 @@ private:
     std::vector<EndpointResultRow> endpointResults_;
     std::vector<GaussResultRow> gaussResults_;
     std::vector<StressS11Row> stressResults_;
+    // Shell recovery is replaced only through validated candidate commit.
+    std::vector<ShellResultRow> shellResults_;
+    double physicalStrainEnergy_{0.0};
+    std::array<double, 6> equilibrium_{};
+    std::array<double, 3> verificationMetrics_{};
 };
 
 } // namespace fesa