docs(cli): regenerate from updated help output

Author: RichardHerold

docs/cli/check.md

@@ -5,5 +5,11 @@ Generated from `soustack check --help`. Do not edit manually.
 ```text
 Usage: soustack check <file> --json
 
-Generate JSON conformance report for a recipe file
+Generate JSON conformance report for a recipe file.
+
+Options:
+  --json    Output results as JSON
+
+Example:
+  soustack check recipe.soustack.json --json
 ```

docs/cli/convert.md

@@ -5,5 +5,13 @@ Generated from `soustack convert --help`. Do not edit manually.
 ```text
 Usage: soustack convert --from <schemaorg|soustack> --to <schemaorg|soustack> <input> [-o <output>]
 
-Convert between Schema.org and Soustack formats
+Convert between Schema.org and Soustack formats.
+
+Options:
+  --from <format>      Source format: schemaorg or soustack
+  --to <format>        Target format: schemaorg or soustack
+  -o, --output <path>  Output file path (default: stdout)
+
+Example:
+  soustack convert --from schemaorg --to soustack recipe.json -o recipe.soustack.json
 ```

docs/cli/import.md

@@ -5,5 +5,12 @@ Generated from `soustack import --help`. Do not edit manually.
 ```text
 Usage: soustack import --url <url> [-o <soustack.json>]
 
-Import recipe from URL (alias for scrape)
+Import recipe from URL (alias for scrape).
+
+Options:
+  --url <url>          URL of the recipe to import
+  -o, --output <path>  Output file path (default: stdout)
+
+Example:
+  soustack import --url https://example.com/recipe -o recipe.soustack.json
 ```

docs/cli/ingest.md

@@ -5,5 +5,11 @@ Generated from `soustack ingest --help`. Do not edit manually.
 ```text
 Usage: soustack ingest <input> [--out <path>]
 
-Bulk pipeline for processing multiple recipes (requires @soustack/ingest)
+Bulk pipeline for processing multiple recipes (requires @soustack/ingest).
+
+Options:
+  --out <path>         Output directory or file path
+
+Example:
+  soustack ingest recipes/ --out output/
 ```

docs/cli/scale.md

@@ -5,5 +5,12 @@ Generated from `soustack scale --help`. Do not edit manually.
 ```text
 Usage: soustack scale <soustack.json> <multiplier>
 
-Scale a recipe by a multiplier
+Scale a recipe by a multiplier.
+
+Arguments:
+  <soustack.json>      Path to the recipe file
+  <multiplier>         Scaling factor (e.g., 2 for double, 0.5 for half)
+
+Example:
+  soustack scale recipe.soustack.json 2
 ```

docs/cli/scrape.md

@@ -3,7 +3,13 @@
 Generated from `soustack scrape --help`. Do not edit manually.
 
 ```text
-Usage: soustack scrape <url> -o <soustack.json>
+Usage: soustack scrape <url> [-o <soustack.json>]
 
-Scrape recipe from a URL (canonical URL ingestion)
+Scrape recipe from a URL (canonical URL ingestion).
+
+Options:
+  -o, --output <path>  Output file path (default: stdout)
+
+Example:
+  soustack scrape https://example.com/recipe -o recipe.soustack.json
 ```

docs/cli/test.md

@@ -3,7 +3,17 @@
 Generated from `soustack test --help`. Do not edit manually.
 
 ```text
-Usage: soustack test [--profile <name>] [--force-profile] [--schema-only] [--strict] [--json]
+Usage: soustack test [options]
 
-Validate all recipes in the repository
+Validate all recipes in the repository.
+
+Options:
+  --profile <name>     Validate against a specific profile
+  --force-profile      Override recipe profile with --profile value
+  --schema-only        Only validate against JSON schema
+  --strict            Treat warnings as errors
+  --json               Output results as JSON
+
+Example:
+  soustack test --profile base --strict
 ```

docs/cli/validate.md

@@ -3,7 +3,17 @@
 Generated from `soustack validate --help`. Do not edit manually.
 
 ```text
-Usage: soustack validate <fileOrGlob> [--profile <name>] [--force-profile] [--schema-only] [--strict] [--json]
+Usage: soustack validate <fileOrGlob> [options]
 
-Validate recipe files against schema and conformance rules
+Validate recipe files against schema and conformance rules.
+
+Options:
+  --profile <name>     Validate against a specific profile
+  --force-profile      Override recipe profile with --profile value
+  --schema-only        Only validate against JSON schema
+  --strict             Treat warnings as errors
+  --json               Output results as JSON
+
+Example:
+  soustack validate "**/*.soustack.json" --profile scalable --strict
 ```