effectcraft/docs
bflatastic 50f26e6a47 CLI: unknown options are usage errors (#168)
Args::parse kept any unrecognised `--option` as a valueless flag nobody
read, so `exec comp.new --bogus` ran with defaults and exit 0, and a
misspelt valued option left its value behind as a positional:
`--saveas z.ecproj` opened z.ecproj as the project and failed with an
unrelated "cannot read" error.

Options are now checked against the declared lists (VALUED and the new
FLAGS) before anything runs; unknown ones are a usage error naming them
(exit 2), and `--flag=value` on a flag says it takes no value.
render-frame's `--transparent` (the MCP render_frame option) was one of
the silently ignored options; it now keeps the frame's alpha.

Tests: unknown_options_are_refused, every_option_read_is_declared (every
option the code reads is declared, so none is refused),
unknown_options_are_usage_errors (exit 2, nothing runs or renders, and
--transparent renders alpha).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 15:48:17 +07:00
..
brand Licensing: standard LICENSE files, NOTICE, ArtCraft brand terms 2026-10-04 10:05:24 -04:00
fidelity G2: improve editing reliability and Windows rendering fidelity 2026-10-06 00:00:31 -05:00
images M0.11: README rewrite with headless screenshots (hero, graph editor, effects, 3D, render queue) 2026-10-01 23:31:40 -04:00
agents.md CLI: unknown options are usage errors (#168) 2026-10-07 15:48:17 +07:00
architecture.md fix: contain GPU initialization and retire failed readbacks 2026-10-06 16:40:12 -05:00
control-protocol.md Control: close the connection on input that isn't a request 2026-10-06 22:54:21 -04:00
effects.md Merge main into M13.28 worktree 2026-10-04 02:57:55 -04:00
gaps.md Docs: gaps.md records the community fixes of 7 October (#135, #139, #141, #142) 2026-10-07 07:54:28 +07:00
parity.md Docs: user issues #85–#117 in gaps, parity, ROADMAP and README 2026-10-07 02:34:15 +07:00
plugins.md M13.12: docs (pdf README, parity, plug-ins), EPS Type 3 fonts reported 2026-10-03 09:51:22 -04:00
preferences.md G9: persist Japanese menu language without bundled fonts 2026-10-06 16:22:23 +09:00
releasing.md Docs: releasing.md, the release procedure release.yml points to (#136) 2026-10-07 11:53:50 +07:00
testing.md M13.27: sim effects golden hashes 2026-10-04 00:50:03 -04:00
web.md Docs: the web hosting guide matches what the build ships (#164, #165, #174, #180) 2026-10-07 13:56:23 +07:00