From b52e60444878aaea9060c7a00cf1db937b4d9a4b Mon Sep 17 00:00:00 2001
From: Chris Herman <crherman7@gmail.com>
Date: Mon, 9 Dec 2024 11:59:02 -0500
Subject: [PATCH] feat(env): update schema

---
 packages/app-env/.flagshipcoderc.json |  9 +++------
 packages/cli/schema.json              | 18 ++++++++++++++++--
 2 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/packages/app-env/.flagshipcoderc.json b/packages/app-env/.flagshipcoderc.json
index f7b736b6e2..8079e92c1d 100644
--- a/packages/app-env/.flagshipcoderc.json
+++ b/packages/app-env/.flagshipcoderc.json
@@ -2,23 +2,20 @@
   "options": [
     {
       "flags": "--app-env-initial <value>",
-      "description": "Specifies the initial environment to be used when the application starts.",
+      "description": "Specifies the initial environment to be used when the application starts (e.g., 'development', 'staging', or 'production').",
       "required": true,
-      "valueDescription": "The name of the environment, such as 'development', 'staging', or 'production'.",
       "example": "--app-env-initial development"
     },
     {
       "flags": "--app-env-dir <value>",
-      "description": "Defines the directory path where environment configuration files are stored.",
+      "description": "Defines the directory path where environment configuration files are stored (relative or absolute path).",
       "required": true,
-      "valueDescription": "A relative or absolute path to the environments directory.",
       "example": "--app-env-dir ./config/environments"
     },
     {
       "flags": "--app-env-hide <value>",
-      "description": "Specifies one or more environments to hide from selection or visibility.",
+      "description": "Specifies one or more environments to hide from selection or visibility (comma-separated list).",
       "required": false,
-      "valueDescription": "A comma-separated list of environment names to hide.",
       "example": "--app-env-hide staging,test"
     }
   ]
diff --git a/packages/cli/schema.json b/packages/cli/schema.json
index 6586036f53..4b49ef8254 100644
--- a/packages/cli/schema.json
+++ b/packages/cli/schema.json
@@ -23,8 +23,22 @@
           },
           "description": {
             "type": "string",
-            "description": "A brief description of the option for the CLI help output.",
-            "minLength": 1
+            "description": "A brief description of the option, including the expected value format or type.",
+            "minLength": 1,
+            "examples": [
+              "Specifies the initial environment to use, e.g., 'development', 'staging', or 'production'.",
+              "Defines the path to the environments directory.",
+              "A comma-separated list of environments to hide."
+            ]
+          },
+          "example": {
+            "type": "string",
+            "description": "A concrete example showing how to use the option.",
+            "examples": [
+              "--app-env-initial development",
+              "--app-env-dir ./config/environments",
+              "--app-env-hide staging,test"
+            ]
           },
           "defaultValue": {
             "description": "The default value for the option if it is not specified by the user.",