Answer architecture round 3, stability round 2, product-owner round 2 and prose round 1: the CLI renders exactly the template on stdin and adds nothing, --separator defaults to empty, whitespace around JSON is dropped, a lone reference under --format allows one newline, a blank stdin is refused, an unexpected argument names the spelling to use, and the prose names one lone reference

2026-10-07 21:39:06 +02:00
parent 58a7b16a7f
commit e5babf413d
9 changed files with 188 additions and 182 deletions
@@ -39,9 +39,9 @@ In [docs/decisions.md](docs/decisions.md):
 - Options and fields share one namespace
 - `{a|b}` stays beside nested choices
 - Flags follow getopt_long
- A struct tag is a template by its shape, not by a flag
- The CLI renders the template on its stdin, keeping a format string's every byte
- A template that does not compile is misuse (exit 2), including a reference that resolves to nothing, save the CLI's lone reference until item 129
+- A struct tag is a template by its shape
+- The CLI renders exactly the template on its stdin, and adds nothing
+- A template that does not compile is misuse (exit 2), including a reference that resolves to nothing, save a lone reference under the CLI's `--format` until item 129
 - A padded JSON template is rejected, not trimmed
 - `FakeTemplate` and `NewTemplate` both stay
 - The shipped data is embedded, not discovered