Core runtime structure description
Goal: Give subsequent maintainers a structural diagram of "from entry to capability layer" to avoid continuing to pile logic back to
runtime-core.ts.
Module layering
Maintain boundaries
runtime-core.ts
Only responsible for:
- runtime main class public API
- Ability assembly
- Connect / close / collection / db / model and other entry delegates
The heap should not continue:
- Complex write orchestration
- expression parsing details
- sync records/stores details
- compat-only type cleaning logic
runtime-helpers.ts / runtime-compat-accessors.ts
Responsible for:
- Assembly details of runtime and model/accessor
- getter/cache/dbInstance bridge for v1 compatible paths
capability / adapter layer
Responsible for:
- True behavioral semantics
- Corresponding module’s internal helpers, queues, storage, and orchestration
Current hot spot governance results
Subsequent maintenance rules
- New capabilities are given priority to enter
capabilities/oradapters/, do not changeruntime-core.tsfirst. - When compat-only logic is involved,
runtime-compat-accessors.tsis entered first. - After hotspot reconstruction, at least add
test:refactor-guard+ corresponding capability layer regression.