SC-NeuroCore — Stable Engine Bridge Contracts¶
Stable engine consumers should use explicit wrapper modules under
bridge/sc_neurocore_engine/, not the top-level sc_neurocore_engine
namespace as a generic export bag.
Current maintained wrapper surfaces:
sc_neurocore_engine.networksc_neurocore_engine.studiosc_neurocore_engine.world_modelsc_neurocore_engine.photonicssc_neurocore_engine.dnasc_neurocore_engine.quantum
Why:
- explicit import points are easier to test
- capability failure becomes local and diagnosable
- consumers stop depending on unrelated re-export churn in
bridge/sc_neurocore_engine/__init__.py - mypy can be paid down module by module instead of treating the entire top-level bridge as one dynamic surface
Rule:
- runtime code should import the narrow wrapper it actually needs
- top-level re-exports remain compatibility surface, not the preferred implementation contract