Governance

Welcome to Governance, the foundational module detailing the constitutional rules, physical unit guarantees, argument validation protocols, dependency management architecture, precision standards, and diagnostic monitoring systems of MolSysMT.

Governance establishes the framework’s reliability contract: ensuring unit safety across all calculations, enforcing strict public versus private API boundaries, dynamically managing soft third-party dependencies, and monitoring execution health with SMonitor.

---

Contents

• Quantities & Units
  Unit-safety guarantees, canonical internal base units (nm, ps, K, e), pyunitwizard integration, and fast-track unit bypass.

• Argument Digestion
  Centralized argument digestion with @digest, input selection interpretation, and the explicit trusted boundary of skip_digestion=True.

• Public API & Lifecycle Standards
  Public versus _private module boundaries, @digest scope rules, API lifecycle integrity standards, and deprecation policies.

• Dependency Management
  Hard versus soft dependencies, central mapping in molsysmt._depdigest, lazy loading of third-party libraries, and @dep_digest capability enforcement.

• Configuration Options
  Global session configuration options via molsysmt.configure and contextual environment overrides.

• Numeric Precision & Data Standards
  Numeric precision policies (float32/float64), coordinate array dimension invariants, and string identifier normalization (*_id as strings).

• SMonitor & Diagnostic Telemetry
  Real-time diagnostic monitoring, RAM memory pressure warnings (MemoryPressureWarning), and execution telemetry managed by SMonitor.