NNNN — Title

WARNING

This RFC is draft. It is under refinement and is not the contract.

Summary

One paragraph: what this RFC proposes and what changes if it lands.

Motivation

The problem this solves and why now. Concrete scenarios that are awkward, broken, or impossible without it. Reference issues, prior RFCs, or external evidence.

Detailed design

The actual proposal in enough depth that someone unfamiliar with the discussion that produced it can implement it. Be specific about Lua surface, error semantics, and acceptance criteria. Diagrams are welcome — vitepress-mermaid-renderer is wired up, so fenced ```mermaid blocks render.

Drawbacks

What this costs. Friction added, surface widened, footguns introduced, migration burden, anything else that argues against it.

Alternatives

What else was considered and why it was rejected. Include the "do nothing" alternative.

Open questions

Questions still to answer before this can move from draft to accepted. This section should be empty by the time the RFC is accepted.

Implementation notes

Optional. Pointers for the implementation PR(s) that follow — file paths, modules touched, sequencing constraints. Not a substitute for the design above.