DashboardcliAlways preserve positional syntax invar…

Always preserve positional syntax invariants with property tests

Category: preference
Confidence: 0.80
ID: 01a08c54-41d4-7ef7-80ab-f68957482947
Project ID: c760f4f9-42b0-4ce0-b36d-6b8c38d770b2
Cross-project: No
Recalled in other projects: 0
Source session: 0iRbOD1VHj1PKYbvU
Created: 2026-09-10 17:18:47
Updated: 2026-09-10 17:18:47

Content

When changing CLI introspection or documentation generation, maintain exact positional rendering invariants and encode them in property-based regressions. Array positionals must always remain variadic and include ...; determine required versus optional syntax independently from variadicity, using positive minimum cardinality for <name...> and absent minimum for [<name...>]. Extracted placeholders should exclude the ellipsis while metadata keeps variadic: true. Tuple positionals must always use angle-bracket placeholders, rendering required values as <name> and optional values as [<name>], with deterministic fallback names. Ensure generated signatures and argument tables use the same canonical formatter rather than duplicate logic.

Move to: