fix: resolve critical and minor issues from C++ subsystem validation

CMakeLists.txt

@@ -0,0 +1,63 @@
+cmake_minimum_required(VERSION 3.14)
+project(CuraFrame VERSION 3.0.0 LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+# All constraint-bundle translation units
+set(BUNDLE_SOURCES
+    constraints/anti_infective/AntiInfectiveBundle.cpp
+    constraints/cardiac/CardiacBundle.cpp
+    constraints/cns/CNSBundle.cpp
+    constraints/formulation/FormulationBundle.cpp
+    constraints/hepatic/HepaticBundle.cpp
+    constraints/immunologic/ImmunologicBundle.cpp
+    constraints/metabolic/MetabolicBundle.cpp
+    constraints/oncology/OncologyBundle.cpp
+    constraints/pkpd/PKPDBundle.cpp
+    constraints/renal/RenalBundle.cpp
+    constraints/safety/SafetyBundle.cpp
+    constraints/systemic_exposure/SystemicExposureBundle.cpp
+)
+
+# Scoring subsystem translation units
+set(SCORING_SOURCES
+    scoring/WeightProfile.cpp
+    scoring/WeightedScoringEngine.cpp
+    scoring/ScoringPipeline.cpp
+)
+
+# Static library bundling all C++ constraint and scoring logic.
+# The repository root is exposed as the include root so that all relative
+# includes (e.g. "constraint_core/Candidate.hpp" or "../scoring/...") resolve
+# correctly regardless of which translation unit is being compiled.
+add_library(curaframe_cpp STATIC
+    ${BUNDLE_SOURCES}
+    ${SCORING_SOURCES}
+)
+
+target_include_directories(curaframe_cpp PUBLIC
+    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}>
+)
+
+target_compile_options(curaframe_cpp PRIVATE
+    $<$<CXX_COMPILER_ID:GNU,Clang,AppleClang>:-Wall -Wextra -Wpedantic>
+    $<$<CXX_COMPILER_ID:MSVC>:/W4>
+)
+
+# NOTE: Each bundle uses the REGISTER_CONSTRAINT_BUNDLE self-registration macro,
+# which installs a static initialiser in its own translation unit.  When linking
+# this library into an executable, force the linker to include every object file
+# so that all initialisers run, even those with no externally referenced symbols:
+#
+#   GCC / Clang (Linux):
+#     target_link_libraries(my_app PRIVATE
+#         -Wl,--whole-archive curaframe_cpp -Wl,--no-whole-archive)
+#
+#   Clang (macOS):
+#     target_link_libraries(my_app PRIVATE
+#         -Wl,-force_load,$<TARGET_FILE:curaframe_cpp>)
+#
+#   MSVC:
+#     target_link_libraries(my_app PRIVATE /WHOLEARCHIVE:curaframe_cpp)

constraint_core/MultiBundleEvaluator.hpp

@@ -5,13 +5,14 @@
 #include "EvaluationReport.hpp"
 #include "ConstraintRegistry.hpp"
 #include "../scoring/ScoringPipeline.hpp"
+#include "../scoring/ScoringReport.hpp"
 #include "../scoring/WeightProfile.hpp"
 #include <sstream>
 
 // Unified Evaluation Layer
 class MultiBundleEvaluator {
 public:
-    EvaluationReport evaluate(const Candidate& candidate) {
+    EvaluationReport evaluate(const Candidate& candidate) const {
         EvaluationReport report;
         report.candidate_id = candidate.id;
 

constraints/anti_infective/AntiInfectiveBundle.cpp

@@ -1 +1,4 @@
 #include "AntiInfectiveBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("AntiInfective", AntiInfectiveBundle)

constraints/anti_infective/AntiInfectiveBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_ANTI_INFECTIVE_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class AntiInfectiveBundle : public ConstraintBundle {
@@ -58,6 +57,4 @@ class AntiInfectiveBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("AntiInfective", AntiInfectiveBundle)
-
 #endif // CURAFRAME_ANTI_INFECTIVE_BUNDLE_HPP

constraints/cardiac/CardiacBundle.cpp

@@ -1 +1,4 @@
 #include "CardiacBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("Cardiac", CardiacBundle)

constraints/cardiac/CardiacBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_CARDIAC_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class CardiacBundle : public ConstraintBundle {
@@ -59,6 +58,4 @@ class CardiacBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("Cardiac", CardiacBundle)
-
 #endif // CURAFRAME_CARDIAC_BUNDLE_HPP

constraints/cns/CNSBundle.cpp

@@ -1 +1,4 @@
 #include "CNSBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("CNS", CNSBundle)

constraints/cns/CNSBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_CNS_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class CNSBundle : public ConstraintBundle {
@@ -59,6 +58,4 @@ class CNSBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("CNS", CNSBundle)
-
 #endif // CURAFRAME_CNS_BUNDLE_HPP

constraints/formulation/FormulationBundle.cpp

@@ -1 +1,4 @@
 #include "FormulationBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("Formulation", FormulationBundle)

constraints/formulation/FormulationBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_FORMULATION_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class FormulationBundle : public ConstraintBundle {
@@ -57,6 +56,4 @@ class FormulationBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("Formulation", FormulationBundle)
-
 #endif // CURAFRAME_FORMULATION_BUNDLE_HPP

constraints/hepatic/HepaticBundle.cpp

@@ -1 +1,4 @@
 #include "HepaticBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("Hepatic", HepaticBundle)

constraints/hepatic/HepaticBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_HEPATIC_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class HepaticBundle : public ConstraintBundle {
@@ -59,6 +58,4 @@ class HepaticBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("Hepatic", HepaticBundle)
-
 #endif // CURAFRAME_HEPATIC_BUNDLE_HPP

constraints/immunologic/ImmunologicBundle.cpp

@@ -1 +1,4 @@
 #include "ImmunologicBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("Immunologic", ImmunologicBundle)

constraints/immunologic/ImmunologicBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_IMMUNOLOGIC_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class ImmunologicBundle : public ConstraintBundle {
@@ -60,6 +59,4 @@ class ImmunologicBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("Immunologic", ImmunologicBundle)
-
 #endif // CURAFRAME_IMMUNOLOGIC_BUNDLE_HPP

constraints/metabolic/MetabolicBundle.cpp

@@ -1 +1,4 @@
 #include "MetabolicBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("Metabolic", MetabolicBundle)

constraints/metabolic/MetabolicBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_METABOLIC_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class MetabolicBundle : public ConstraintBundle {
@@ -75,6 +74,4 @@ class MetabolicBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("Metabolic", MetabolicBundle)
-
 #endif // CURAFRAME_METABOLIC_BUNDLE_HPP

constraints/oncology/OncologyBundle.cpp

@@ -1 +1,4 @@
 #include "OncologyBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("Oncology", OncologyBundle)

constraints/oncology/OncologyBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_ONCOLOGY_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class OncologyBundle : public ConstraintBundle {
@@ -59,6 +58,4 @@ class OncologyBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("Oncology", OncologyBundle)
-
 #endif // CURAFRAME_ONCOLOGY_BUNDLE_HPP

constraints/pkpd/PKPDBundle.cpp

@@ -1 +1,4 @@
 #include "PKPDBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("PKPD", PKPDBundle)

constraints/pkpd/PKPDBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_PKPD_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class PKPDBundle : public ConstraintBundle {
@@ -58,6 +57,4 @@ class PKPDBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("PKPD", PKPDBundle)
-
 #endif // CURAFRAME_PKPD_BUNDLE_HPP

constraints/renal/RenalBundle.cpp

@@ -1 +1,4 @@
 #include "RenalBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("Renal", RenalBundle)

constraints/renal/RenalBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_RENAL_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class RenalBundle : public ConstraintBundle {
@@ -59,6 +58,4 @@ class RenalBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("Renal", RenalBundle)
-
 #endif // CURAFRAME_RENAL_BUNDLE_HPP

constraints/safety/SafetyBundle.cpp

@@ -1 +1,4 @@
 #include "SafetyBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("Safety", SafetyBundle)

constraints/safety/SafetyBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_SAFETY_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class SafetyBundle : public ConstraintBundle {
@@ -56,6 +55,4 @@ class SafetyBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("Safety", SafetyBundle)
-
 #endif // CURAFRAME_SAFETY_BUNDLE_HPP

constraints/systemic_exposure/SystemicExposureBundle.cpp

@@ -1 +1,4 @@
 #include "SystemicExposureBundle.hpp"
+#include "../../constraint_core/ConstraintRegistry.hpp"
+
+REGISTER_CONSTRAINT_BUNDLE("SystemicExposure", SystemicExposureBundle)

constraints/systemic_exposure/SystemicExposureBundle.hpp

@@ -2,7 +2,6 @@
 #define CURAFRAME_SYSTEMIC_EXPOSURE_BUNDLE_HPP
 
 #include "../../constraint_core/ConstraintBundle.hpp"
-#include "../../constraint_core/ConstraintRegistry.hpp"
 #include <sstream>
 
 class SystemicExposureBundle : public ConstraintBundle {
@@ -64,6 +63,4 @@ class SystemicExposureBundle : public ConstraintBundle {
     std::string narrative_summary() const override { return summary; }
 };
 
-REGISTER_CONSTRAINT_BUNDLE("SystemicExposure", SystemicExposureBundle)
-
 #endif // CURAFRAME_SYSTEMIC_EXPOSURE_BUNDLE_HPP

docs/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to the C++ parallel evaluation universe will be documented in this file.
 
-## [3.0.0] - Weighted Scoring Engine
+## [3.0.0] - 2026-04-10 - Weighted Scoring Engine
 
 ### Added
 - **Weighted Multi-Constraint Scoring Engine**: Introduced a unified scoring engine that computes a Composite Stability Score (0-100) from constraint bundle outputs.
@@ -14,7 +14,7 @@ All notable changes to the C++ parallel evaluation universe will be documented i
 ### Changed
 - Bumped project version to 3.0.0.
 
-## [2.5.0] - Constraint-Bundle Universe
+## [2.5.0] - 2026-04-10 - Constraint-Bundle Universe
 
 ### Added
 - **C++ Core Architecture:** Introduced `Candidate.hpp`, `EvaluationReport.hpp`, `ConstraintBundle.hpp`, `ConstraintRegistry.hpp`, and `MultiBundleEvaluator.hpp` in the `constraint_core/` directory to serve as the unified parallel evaluation layer.

docs/constraint_bundles.md

@@ -25,4 +25,4 @@ CuraFrame features a parallel C++ constraint-bundle universe evaluating therapeu
 ### Physicochemical & Pharmacological
 - **Formulation (`FormulationBundle`):** Solubility deficits, chemical instability, delivery-vector incompatibilities.
 - **PK/PD (`PKPDBundle`):** Dose-response slope analysis, receptor saturation, effect-window decoupling flags.
-- **Global Safety (`SafetyBundle`):** Multi-organ stress aggregation, systemic catastrophe triggers.
+- **Safety (`SafetyBundle`):** Multi-organ stress aggregation, systemic catastrophe triggers.

docs/evaluation_pipeline.md

@@ -27,13 +27,13 @@ int main() {
     EvaluationReport report = evaluator.evaluate(c);
 
     if (!report.is_viable()) {
-        std::cout << "Candidate Falsified. Triggers:\\n";
+        std::cout << "Candidate Falsified. Triggers:\n";
         for (const auto& flag : report.falsification_flags) {
-            std::cout << "- " << flag << "\\n";
+            std::cout << "- " << flag << "\n";
         }
     }
 
-    std::cout << "\\nNarrative Summary:\\n" << report.combined_narrative << "\\n";
+    std::cout << "\nNarrative Summary:\n" << report.combined_narrative << "\n";
     return 0;
 }
 ```

pyproject.toml

@@ -1,3 +1,9 @@
 [build-system]
 requires = ["setuptools>=61.0"]
 build-backend = "setuptools.build_meta"
+
+[project]
+name = "CuraFrame"
+version = "3.0.0"
+description = "Constraint-driven therapeutic design reasoning framework."
+requires-python = ">=3.9"

scoring/ScoringReport.hpp

@@ -11,7 +11,8 @@ struct ScoringReport {
     // Per-bundle weighted contributions
     std::map<std::string, double> bundle_contributions;
 
-    // Breakdowns
+    // Breakdowns — keys are formatted as "domain_name::signal_name"
+    // (e.g. "Cardiac::qt_prolongation_risk").
     std::map<std::string, double> penalty_breakdown;
     std::map<std::string, double> bonus_breakdown;
 

scoring/WeightProfile.cpp

@@ -1,4 +1,8 @@
 #include "WeightProfile.hpp"
 
-// Intentionally left blank or simple implementations if needed.
-// Weight profiles are currently fully implemented inline in the header for simplicity and polymorphism.
+// All WeightProfile methods are implemented inline in WeightProfile.hpp because
+// the class relies entirely on virtual dispatch with small, default-valued
+// implementations that benefit from inlining.  This translation unit exists to
+// compile the header as part of the curaframe_cpp static library, ensuring that
+// the vtable and RTTI for WeightProfile, DefaultResearchProfile, and
+// HighSafetyProfile are emitted exactly once.