F24.3 — Declared CLI surfaces reject unknown keys
| State | Closed |
| Parent | E24 |
| Iteration | Release 9 |
| Start Date | 2026-11-17 |
| Closed Date | 2026-11-17 |
| Predecessors | — |
Stories: 1 Closed
| Story | State | Depends on |
|---|---|---|
| S24.3.1 — Load the surface strictly | Closed (2026-11-17) | — |
A typo in a [cli] table fails at load time instead of being dropped.
S24.3.1 — Load the surface strictly
State: Closed (2026-11-17)
Acceptance:
CliSurface.loadraisesAppExceptionfor a key that names no field, at the top level or in acommandsentry, and the message lists each such key by its dotted path (comands,commands.0.hlep).- Every surface the existing tests load still loads.
Settled contract: CliSurface and CommandSurface use StrictDataclassMixin;
the message is Invalid CliSurface: unknown key(s) <dotted paths>. A document
with no cli table but a top-level name is read as the surface, so its other
top-level keys fail too.