# FlexonForge Ultimate CLI

Run `FlexonForge Ultimate.exe --cli help` for the machine-readable command inventory.

Commands: `status`, `inventory`, `encode`, `decode`, `inspect`, `validate`, `keygen`, `sign`, `verify`, `bundle-create`, `bundle-extract`, `benchmark`, `batch`, `history`, and `monitor`.

Common switches: `--input`, `--output`, `--compression`, `--encryption`, `--kdf`, `--schema`, `--private`, `--public`, `--signature`, `--folder`, `--rounds`, `--yes`, `--dry-run`, `--quiet`, `--once`, and `--interval`.

Bundle switches: `--attachments explicit|marked|discover`, `--resolve-files` (Discover alias), repeated `--attach [logical=]source`, `--base-dir`, and `--max-attachment-bytes`. Marked mode recognizes exact JSON objects such as `{"$flexonFile":"assets/image.png"}` and restores them as normal path strings when extracted.

Examples:

```powershell
FlexonForge Ultimate.exe --cli encode --input data.json --output data.flexon --compression Brotli
$env:FLEXONFORGE_PASSWORD='use-a-strong-secret'
FlexonForge Ultimate.exe --cli encode --input data.json --output secure.flexon --encryption Aes256Gcm
FlexonForge Ultimate.exe --cli inspect --input secure.flexon
FlexonForge Ultimate.exe --cli validate --input secure.flexon --schema schema.json
FlexonForge Ultimate.exe --cli keygen --private private.pem --public public.pem
FlexonForge Ultimate.exe --cli sign --input secure.flexon --private private.pem --signature secure.sig
FlexonForge Ultimate.exe --cli verify --input secure.flexon --public public.pem --signature secure.sig
FlexonForge Ultimate.exe --cli bundle-create --manifest manifest.json --attachments discover --base-dir C:\Project --output transport.flexon --encryption ChaCha20Poly1305
FlexonForge Ultimate.exe --cli bundle-create --manifest manifest.json --attachments marked --base-dir C:\Project --dry-run
FlexonForge Ultimate.exe --cli bundle-create --manifest manifest.json --attach assets/image.png=C:\Source\image.png --attach payload.bin=C:\Source\payload.bin --output transport.flexon
FlexonForge Ultimate.exe --cli bundle-extract --input transport.flexon --output extracted --yes
FlexonForge Ultimate.exe --cli monitor --once
```

Exit codes: `0` success, `1` runtime failure, `2` usage or overwrite guard, `3` operation/validation failure, `6` invalid signature. Existing output files require `--yes`. `--dry-run` never writes output.
