Design notes

NOF keeps its runtime surface small by moving repetitive framework work into source generators and explicit architectural building blocks. These notes explain the decisions behind those building blocks.

• Request dispatch — how requests are routed through the framework.
• Handler registration — compile-time discovery and dependency registration.
• Source generators — generated infrastructure and diagnostics.
• Repository and unit of work — persistence boundaries and transaction flow.
• Value objects — strongly typed domain values with generated support.
• Mapping — mapping conventions and generated implementations.
• Steps — composable application pipelines.
• Public API — compatibility and surface-area rules.

For types and members, continue to the API reference.