Standardize command help and version discovery

.github/workflows/ci.yaml

@@ -63,6 +63,13 @@ jobs:
         run: python3 scripts/validate-render.py
       - name: Smoke test command metadata
         run: |
+          ./target/release/stack help
+          ./target/release/stack help render
+          ./target/release/stack help icons list
+          ./target/release/stack version
+          ./target/release/stack -h
+          ./target/release/stack -v
+          ./target/release/stack -V
           ./target/release/stack --help
           ./target/release/stack --version
           ./target/release/stack check --help

README.md

@@ -7,6 +7,9 @@ The repository contains native validation, formatting, and rendering commands. T
 ## Commands
 
 ```text
+stack help
+stack help render
+stack version
 stack check arch.stack
 stack fmt arch.stack
 stack fmt --check arch.stack
@@ -20,6 +23,8 @@ stack icons import simple-icons --accept-terms
 stack render arch.stack -o arch.svg --notice arch.NOTICE.md
 ```
 
+`stack help`, `stack -h`, and `stack --help` print top-level help. Use `stack help <COMMAND>` or `<COMMAND> -h` / `<COMMAND> --help` for command-specific usage and examples; nested icon help is available through `stack help icons <COMMAND>`. `stack version`, `stack -v`, `stack -V`, and `stack --version` print the same Cargo package version. Help and version output use standard output and exit with status `0`. Invalid arguments and unknown commands use standard error and status `2`; close command typos include a suggested command and the relevant help invocation.
+
 `stack check` reads the file as bytes and runs the full compiler, theme, layout, and routing validation pipeline without changing the source. Diagnostics are written to standard error in source order. Standard output remains empty.
 
 `stack fmt` uses the engine formatter and preserves comments. File mode replaces changed source atomically through a temporary file in the same directory; unchanged files are not replaced. Syntax, encoding, and host I/O failures leave the original file untouched. `stack fmt -` reads bytes from standard input and writes only canonical source to standard output. `--check` never writes source and exits with status `1` when formatting is required.