v0.2.2 fixes: split only text sources, report a mode change once, don't block on open

doc/cli.md

@@ -1,14 +1,18 @@
 # Command-line arguments
 
 `LoadCLI` accepts `--server.port=9000`, `--server.port 9000`, and bare boolean flags
-such as `--debug`. Arguments after `--` are positional and are not parsed. Other
-positional arguments are ignored. There is no short-flag parser; use Go's flag package
-when that interface is needed. Paths must obey registration's dot-separated key syntax.
+such as `--debug`. A bare flag is the boolean true, so on a path that is not
+boolean (`--dir --debug`) it fails with "--dir needs a value". Arguments after `--`
+are positional and are not parsed. There is no short-flag parser; use Go's flag
+package when that interface is needed. Paths must obey registration's dot-separated
+key syntax.
 
-Values remain strings and are validated against registered types before publication.
-Each successful call replaces the complete CLI source, including an empty argument
-list. Omitted flags lose their previous overrides. Unknown paths are recorded in
-`UnknownCLIKeys` in sorted order and are not registered. The returned list is a copy.
+Values remain strings and are validated against registered types before publication;
+a slice or array path splits them at commas. Each successful call replaces the
+complete CLI source, including an empty argument list. Omitted flags lose their
+previous overrides. Unknown paths are recorded in `UnknownCLIKeys` in sorted order,
+followed by the arguments before `--` that are no `--` flag (a positional word, a
+`-q`), and are not registered. The returned list is a copy.
 
 `GenerateFlags` creates a flag.FlagSet from defaults. `BindFlags` atomically replaces
 the CLI source with explicitly visited flags, rejects unregistered flags, and uses