Refactor: Clarify required options for buy and scale commands

Co-authored-by: danieltaox <[email protected]>

Author: cursoragent

src/lib/buy/index.tsx

@@ -47,7 +47,7 @@ export function _registerBuy(program: Command) {
     .showHelpAfterError()
     .option(
       "-t, --type <type>",
-      "Type of GPU",
+      "[Required: --type or --zone or --colocate] Type of GPU",
     )
     .option(
       "-n, --accelerators <quantity>",
@@ -57,7 +57,7 @@ export function _registerBuy(program: Command) {
     )
     .option(
       "-d, --duration <duration>",
-      "Duration of reservation (rounded up to the nearest hour)",
+      "[Required: --duration or --end] Duration of reservation (rounded up to the nearest hour)",
       parseDuration,
     )
     .option(
@@ -73,7 +73,7 @@ export function _registerBuy(program: Command) {
     .addOption(
       new Option(
         "-e, --end <end>",
-        "End time (date or relative time like '+1d', rounded up to nearest hour)",
+        "[Required: --duration or --end] End time (date or relative time like '+1d', rounded up to nearest hour)",
       )
         .argParser(parseEnd)
         .conflicts("duration"),
@@ -91,7 +91,7 @@ export function _registerBuy(program: Command) {
     .option("-y, --yes", "Automatically confirm the order")
     .option(
       "-colo, --colocate <contract_id>",
-      "Colocate with existing contracts. If provided, `-t`/`--type` will be ignored.",
+      "[Required: --type or --zone or --colocate] Colocate with existing contracts. If provided, `-t`/`--type` will be ignored.",
     )
     .option(
       "-q, --quote",
@@ -103,11 +103,11 @@ export function _registerBuy(program: Command) {
     )
     .option(
       "-z, --zone <zone>",
-      "Send into a specific zone. If provided, \`-t\`/`--type` will be ignored.",
+      "[Required: --type or --zone or --colocate] Send into a specific zone. If provided, \`-t\`/`--type` will be ignored.",
     )
     .option(
       "-c, --cluster <cluster>",
-      "Send into a specific cluster (deprecated, alias for --zone). If provided, \`-t\`/`--type` will be ignored.",
+      "[Required: --type or --zone or --colocate] Send into a specific cluster (deprecated, alias for --zone). If provided, \`-t\`/`--type` will be ignored.",
     )
     .hook("preAction", (command) => {
       const { type, zone, cluster, colocate } = command.opts();

src/lib/scale/update.tsx

@@ -358,17 +358,17 @@ $ sf scale update <procurement_id...> -p 1.50
   .argument("<procurement_id...>", "ID of the procurement to update")
   .option(
     "-n, --accelerators <accelerators>",
-    "Desired number of GPUs (0 to turn off)",
+    "[Required: at least one of --accelerators, --horizon, or --price] Desired number of GPUs (0 to turn off)",
     parseAccelerators,
   )
   .option(
     "-d, --horizon <horizon>",
-    "The minimum amount of time to reserve the GPUs for. That is, start buying more compute if the remaining time is less than this threshold.",
+    "[Required: at least one of --accelerators, --horizon, or --price] The minimum amount of time to reserve the GPUs for. That is, start buying more compute if the remaining time is less than this threshold.",
     parseHorizonArg,
   )
   .option(
     "-p, --price <price>",
-    "Limit price per GPU per hour, in dollars. Buy compute only if it's at most this price. Defaults to the current market price times 1.5, or $2.65 if we can't get a price estimate.",
+    "[Required: at least one of --accelerators, --horizon, or --price] Limit price per GPU per hour, in dollars. Buy compute only if it's at most this price. Defaults to the current market price times 1.5, or $2.65 if we can't get a price estimate.",
     parsePriceArg,
   )
   .option("-y, --yes", "Automatically confirm the command.")