V4 Web

CuraFrame 4.0 — The Era of Scientific Safety Intelligence

CuraFrame 4.0 is the largest and most ambitious release in the platform’s history. This update transforms CuraFrame from a deterministic evaluator into a multi‑domain, multi‑population, multi‑constraint scientific intelligence system. Four major subsystems land in this release, each representing a leap in analytical capability, architectural clarity, and scientific rigor.

---

1. Parameter Sweeping & Boundary Mapping (Interactive Sensitivity Analysis)

CuraFrame 4.0 introduces the highly anticipated Parameter Sweeping / Boundary Mapping tool across both the Streamlit Console and the FastAPI Web App.

Built on a clean, isolated backend sensitivity module (cura_frame/sensitivity.py), this feature allows researchers to:

• Sweep one or two parameters (e.g., logP, hERG_IC50) across defined ranges
• Visualize safety boundaries, inflection points, and transition zones
• Compare general vs stratified population profiles side‑by‑side
• Identify exactly where a candidate flips from ACCEPTED → INDET → REJECTED

This is a true scientific instrument — a dynamic map of the safety envelope.

Testing:
Full unit, integration, and end‑to‑end frontend verification completed with 100% success.

---

2. Logical Failure Diagnostic & Multi‑Constraint Gap Analysis Advisor

CuraFrame 4.0 adds a new advisory intelligence layer that explains why a candidate fails and exactly what must change to satisfy constraints.

Core Enhancements

• Added ConstraintGroup and LogicOp (AND, OR) to cura_frame/core.py
• Introduced a robust Advisor Engine (cura_frame/advisor.py) capable of computing:
  • exact numeric deltas
  • directional adjustments
  • ratio‑based corrections
  • structured scientific guidance text
• Integrated gap diagnostics into:
  • CLI serialization (serialize_result)
  • EvaluationResult summaries (summary())
  • CLI stdout
• Streamlit Console now includes a dedicated “🔬 Logical Failure Diagnostic & Gap Analysis” section with:
  • a flat summary table of required parameter adjustments
  • an expandable tree view of logical pathways and constraint groups

Example output:

“To satisfy the Core Safety bundle, logP must be reduced by ≥ 1.2 units OR hERG_IC50 must be increased by ≥ 5.0 μM.”

Testing:
Complete test suite under tests/test_advisor.py with 100% pass rate.

---

3. Custom Population Profile Creator & Editor

CuraFrame 4.0 introduces a first‑class Custom Population Profile Creator & Editor, enabling researchers to define and evaluate bespoke patient populations and comorbidity profiles.

Capabilities

• Create, edit, save, and export custom populations
• Apply modifiers such as:
  • reduced clearance
  • increased toxicity sensitivity
  • doubled selectivity requirements
  • comorbidity‑specific threshold shifts
• Evaluate candidates under custom physiological contexts
• Persist profiles using secure SQLite storage under the logged‑in user account
• Operates strictly in Calculator Mode, adhering to CuraFrame’s non‑free‑form execution philosophy

This feature empowers researchers to model real‑world patient variability with scientific precision.

---

4. Interactive Multi‑Bundle Evaluation Matrix (Cross‑Therapeutic Safety Intelligence)

CuraFrame 4.0 adds the Interactive Multi‑Bundle Evaluation Matrix as a first‑class analytical tab in the Streamlit Console.

Capabilities

• Evaluate a single candidate across all or selected constraint bundles
• Display bundle‑level statuses (ACCEPTED / REJECTED / INDET)
• Render a color‑coded parameter‑by‑bundle grid
• Detect and highlight cross‑therapeutic contradictions, such as:
  • CNS/Oncology acceptance paired with Cardiac hERG failure
  • Core Safety compliance overshadowed by domain‑specific toxicity
• Provide CSV and JSON exports for both summary and grid views

Global Candidate Definition Update

The candidate input form now dynamically displays the union of all active parameters across selected bundles — globally across all tabs — ensuring:

• no disappearing fields
• no lost data
• full consistency across Evaluation, Sweep, Custom Populations, and Matrix

Testing:
Comprehensive unit and integration tests added to validate matrix logic, contradiction detection, and global parameter union behavior.

---

CuraFrame 4.0 Summary

CuraFrame 4.0 delivers:

• Boundary Mapping
• Logical Gap Analysis
• Custom Population Modeling
• Multi‑Bundle Cross‑Therapeutic Evaluation

Together, these features elevate CuraFrame into a scientific safety intelligence platform capable of multi‑domain reasoning, population‑aware evaluation, and deterministic constraint analysis.

This is the strongest, most complete version of CuraFrame ever released.