@knocklabs/cli 0.1.22 → 0.2.0

package/oclif.manifest.json

@@ -7,7 +7,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -38,6 +38,80 @@
         "knock.js"
       ]
     },
+    "login": {
+      "aliases": [],
+      "args": {},
+      "flags": {
+        "service-token": {
+          "env": "KNOCK_SERVICE_TOKEN",
+          "name": "service-token",
+          "required": false,
+          "summary": "The service token to authenticate with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-origin": {
+          "hidden": true,
+          "name": "api-origin",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "login",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginName": "@knocklabs/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "login.js"
+      ]
+    },
+    "logout": {
+      "aliases": [],
+      "args": {},
+      "flags": {
+        "service-token": {
+          "env": "KNOCK_SERVICE_TOKEN",
+          "name": "service-token",
+          "required": false,
+          "summary": "The service token to authenticate with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-origin": {
+          "hidden": true,
+          "name": "api-origin",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "logout",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginName": "@knocklabs/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "logout.js"
+      ]
+    },
     "ping": {
       "aliases": [],
       "args": {},
@@ -45,7 +119,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -83,7 +157,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -149,7 +223,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -230,7 +304,57 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
+          "summary": "The service token to authenticate with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-origin": {
+          "hidden": true,
+          "name": "api-origin",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "whoami",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginName": "@knocklabs/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Verify the provided service token.",
+      "enableJsonFlag": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "whoami.js"
+      ]
+    },
+    "commit:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "name": "id",
+          "required": true
+        }
+      },
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "service-token": {
+          "env": "KNOCK_SERVICE_TOKEN",
+          "name": "service-token",
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -247,28 +371,465 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "whoami",
+      "id": "commit:get",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginName": "@knocklabs/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Display a single commit",
+      "enableJsonFlag": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "commit",
+        "get.js"
+      ]
+    },
+    "commit": {
+      "aliases": [],
+      "args": {},
+      "flags": {
+        "service-token": {
+          "env": "KNOCK_SERVICE_TOKEN",
+          "name": "service-token",
+          "required": false,
+          "summary": "The service token to authenticate with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-origin": {
+          "hidden": true,
+          "name": "api-origin",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "name": "environment",
+          "summary": "Committing changes applies to the development environment only, use `commit promote` to promote changes to a subsequent environment.",
+          "default": "development",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "development"
+          ],
+          "type": "option"
+        },
+        "commit-message": {
+          "char": "m",
+          "name": "commit-message",
+          "summary": "Use the given value as the commit message.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "name": "force",
+          "summary": "Remove the confirmation prompt.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "commit",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginName": "@knocklabs/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Commit all changes in development environment.",
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "commit",
+        "index.js"
+      ]
+    },
+    "commit:list": {
+      "aliases": [],
+      "args": {},
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "service-token": {
+          "env": "KNOCK_SERVICE_TOKEN",
+          "name": "service-token",
+          "required": false,
+          "summary": "The service token to authenticate with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-origin": {
+          "hidden": true,
+          "name": "api-origin",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "name": "environment",
+          "summary": "The environment to use.",
+          "default": "development",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "promoted": {
+          "name": "promoted",
+          "summary": "Show only promoted or unpromoted changes between the given environment and the subsequent environment.",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "resource-type": {
+          "name": "resource-type",
+          "summary": "Filter commits by resource type. Must be used together with resource-id.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "email_layout",
+            "guide",
+            "message_type",
+            "partial",
+            "translation",
+            "workflow"
+          ],
+          "type": "option"
+        },
+        "resource-id": {
+          "name": "resource-id",
+          "summary": "Filter commits by resource identifier. Must be used together with resource-type. For most resources, this will be the resource key. In the case of translations, this will be the locale code and namespace, separated by a /. For example, en/courses or en.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "after": {
+          "name": "after",
+          "summary": "The cursor after which to fetch the next page.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "before": {
+          "name": "before",
+          "summary": "The cursor before which to fetch the previous page.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "name": "limit",
+          "summary": "The total number of entries to fetch per page.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "commit:list",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginName": "@knocklabs/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Display all commits in an environment",
+      "enableJsonFlag": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "commit",
+        "list.js"
+      ]
+    },
+    "commit:promote": {
+      "aliases": [],
+      "args": {},
+      "flags": {
+        "service-token": {
+          "env": "KNOCK_SERVICE_TOKEN",
+          "name": "service-token",
+          "required": false,
+          "summary": "The service token to authenticate with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-origin": {
+          "hidden": true,
+          "name": "api-origin",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "to": {
+          "name": "to",
+          "summary": "The destination environment to promote all changes from the preceding environment.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "name": "force",
+          "summary": "Remove the confirmation prompt.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "only": {
+          "name": "only",
+          "summary": "The target commit id to promote to the subsequent environment",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "commit:promote",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginName": "@knocklabs/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Promote one or all commits to the subsequent environment.",
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "commit",
+        "promote.js"
+      ]
+    },
+    "guide:activate": {
+      "aliases": [],
+      "args": {
+        "guideKey": {
+          "name": "guideKey",
+          "required": true
+        }
+      },
+      "description": "This enables or disables a guide in a given environment without\nneeding to go through environment promotion.\n\nYou can activate or deactivate a guide immediately or schedule it to be activated \nor deactivated at a later time using the --from and --until flags.",
+      "flags": {
+        "service-token": {
+          "env": "KNOCK_SERVICE_TOKEN",
+          "name": "service-token",
+          "required": false,
+          "summary": "The service token to authenticate with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-origin": {
+          "hidden": true,
+          "name": "api-origin",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "name": "environment",
+          "required": true,
+          "summary": "The environment to use.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "exclusive": [
+            "from",
+            "until"
+          ],
+          "name": "status",
+          "summary": "The guide active status to set. Cannot be used with --from/--until.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "true",
+            "false"
+          ],
+          "type": "option"
+        },
+        "from": {
+          "exclusive": [
+            "status"
+          ],
+          "name": "from",
+          "summary": "Activate the guide from this ISO8601 UTC datetime (e.g., '2024-01-15T10:30:00Z').",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "until": {
+          "exclusive": [
+            "status"
+          ],
+          "name": "until",
+          "summary": "Deactivate the guide at this ISO8601 UTC datetime (e.g., '2024-01-15T18:30:00Z').",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "name": "force",
+          "summary": "Remove the confirmation prompt.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "guide:activate",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginName": "@knocklabs/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Activate or deactivate a guide in a given environment.",
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "guide",
+        "activate.js"
+      ]
+    },
+    "guide:generate-types": {
+      "aliases": [],
+      "args": {},
+      "description": "Generate types for all guides in an environment and write them to a file.",
+      "flags": {
+        "service-token": {
+          "env": "KNOCK_SERVICE_TOKEN",
+          "name": "service-token",
+          "required": false,
+          "summary": "The service token to authenticate with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-origin": {
+          "hidden": true,
+          "name": "api-origin",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "name": "environment",
+          "summary": "Select the environment to generate types for.",
+          "default": "development",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-file": {
+          "name": "output-file",
+          "required": true,
+          "summary": "The output file to write the generated types to. We currently support .ts, .py, .go, .rb files only. Your file extension will determine the target language for the generated types.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "guide:generate-types",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginName": "@knocklabs/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "guide",
+        "generate-types.js"
+      ]
+    },
+    "guide:get": {
+      "aliases": [],
+      "args": {
+        "guideKey": {
+          "name": "guideKey",
+          "required": true
+        }
+      },
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "service-token": {
+          "env": "KNOCK_SERVICE_TOKEN",
+          "name": "service-token",
+          "required": false,
+          "summary": "The service token to authenticate with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-origin": {
+          "hidden": true,
+          "name": "api-origin",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "name": "environment",
+          "summary": "The environment to use.",
+          "default": "development",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "hide-uncommitted-changes": {
+          "name": "hide-uncommitted-changes",
+          "summary": "Hide any uncommitted changes.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "guide:get",
       "pluginAlias": "@knocklabs/cli",
       "pluginName": "@knocklabs/cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Verify the provided service token.",
+      "summary": "Display a single guide from an environment.",
       "enableJsonFlag": true,
       "isESM": false,
       "relativePath": [
         "dist",
         "commands",
-        "whoami.js"
+        "guide",
+        "get.js"
       ]
     },
-    "commit:get": {
+    "guide:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "name": "id",
-          "required": true
-        }
-      },
+      "args": {},
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -280,7 +841,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -293,33 +854,74 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "environment": {
+          "name": "environment",
+          "summary": "The environment to use.",
+          "default": "development",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "hide-uncommitted-changes": {
+          "name": "hide-uncommitted-changes",
+          "summary": "Hide any uncommitted changes.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "after": {
+          "name": "after",
+          "summary": "The cursor after which to fetch the next page.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "before": {
+          "name": "before",
+          "summary": "The cursor before which to fetch the previous page.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "name": "limit",
+          "summary": "The total number of entries to fetch per page.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "commit:get",
+      "id": "guide:list",
       "pluginAlias": "@knocklabs/cli",
       "pluginName": "@knocklabs/cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Display a single commit",
+      "summary": "Display all guides for an environment.",
       "enableJsonFlag": true,
       "isESM": false,
       "relativePath": [
         "dist",
         "commands",
-        "commit",
-        "get.js"
+        "guide",
+        "list.js"
       ]
     },
-    "commit": {
+    "guide:pull": {
       "aliases": [],
-      "args": {},
+      "args": {
+        "guideKey": {
+          "name": "guideKey",
+          "required": false
+        }
+      },
       "flags": {
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -335,23 +937,34 @@
         },
         "environment": {
           "name": "environment",
-          "summary": "Committing changes applies to the development environment only, use `commit promote` to promote changes to a subsequent environment.",
+          "summary": "The environment to use.",
           "default": "development",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "development"
-          ],
           "type": "option"
         },
-        "commit-message": {
-          "char": "m",
-          "name": "commit-message",
-          "summary": "Use the given value as the commit message.",
+        "all": {
+          "name": "all",
+          "summary": "Whether to pull all guides from the specified environment.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "guides-dir": {
+          "dependsOn": [
+            "all"
+          ],
+          "name": "guides-dir",
+          "summary": "The target directory path to pull all guides into.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "hide-uncommitted-changes": {
+          "name": "hide-uncommitted-changes",
+          "summary": "Hide any uncommitted changes.",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "force": {
           "name": "force",
           "summary": "Remove the confirmation prompt.",
@@ -360,37 +973,36 @@
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "commit",
+      "id": "guide:pull",
       "pluginAlias": "@knocklabs/cli",
       "pluginName": "@knocklabs/cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Commit all changes in development environment.",
+      "summary": "Pull one or more guides from an environment into a local file system.",
       "enableJsonFlag": false,
       "isESM": false,
       "relativePath": [
         "dist",
         "commands",
-        "commit",
-        "index.js"
+        "guide",
+        "pull.js"
       ]
     },
-    "commit:list": {
+    "guide:push": {
       "aliases": [],
-      "args": {},
+      "args": {
+        "guideKey": {
+          "name": "guideKey",
+          "required": false
+        }
+      },
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -406,65 +1018,80 @@
         },
         "environment": {
           "name": "environment",
-          "summary": "The environment to use.",
+          "summary": "Pushing a guide is only allowed in the development environment",
           "default": "development",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "development"
+          ],
           "type": "option"
         },
-        "promoted": {
-          "name": "promoted",
-          "summary": "Show only promoted or unpromoted changes between the given environment and the subsequent environment.",
-          "allowNo": true,
+        "all": {
+          "name": "all",
+          "summary": "Whether to push all guides from the target directory.",
+          "allowNo": false,
           "type": "boolean"
         },
-        "after": {
-          "name": "after",
-          "summary": "The cursor after which to fetch the next page.",
+        "guides-dir": {
+          "dependsOn": [
+            "all"
+          ],
+          "name": "guides-dir",
+          "summary": "The target directory path to find all guides to push.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "before": {
-          "name": "before",
-          "summary": "The cursor before which to fetch the previous page.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "commit": {
+          "name": "commit",
+          "summary": "Push and commit the guide(s) at the same time",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "limit": {
-          "name": "limit",
-          "summary": "The total number of entries to fetch per page.",
+        "commit-message": {
+          "char": "m",
+          "dependsOn": [
+            "commit"
+          ],
+          "name": "commit-message",
+          "summary": "Use the given value as the commit message",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "commit:list",
+      "id": "guide:push",
       "pluginAlias": "@knocklabs/cli",
       "pluginName": "@knocklabs/cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Display all commits in an environment",
-      "enableJsonFlag": true,
+      "summary": "Push one or more guides from a local file system to Knock.",
+      "enableJsonFlag": false,
       "isESM": false,
       "relativePath": [
         "dist",
         "commands",
-        "commit",
-        "list.js"
+        "guide",
+        "push.js"
       ]
     },
-    "commit:promote": {
+    "guide:validate": {
       "aliases": [],
-      "args": {},
+      "args": {
+        "guideKey": {
+          "name": "guideKey",
+          "required": false
+        }
+      },
       "flags": {
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -478,42 +1105,50 @@
           "multiple": false,
           "type": "option"
         },
-        "to": {
-          "name": "to",
-          "summary": "The destination environment to promote all changes from the preceding environment.",
+        "environment": {
+          "name": "environment",
+          "summary": "Validating a guide is only done in the development environment",
+          "default": "development",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "development"
+          ],
           "type": "option"
         },
-        "force": {
-          "name": "force",
-          "summary": "Remove the confirmation prompt.",
+        "all": {
+          "name": "all",
+          "summary": "Whether to validate all guides from the target directory.",
           "allowNo": false,
           "type": "boolean"
         },
-        "only": {
-          "name": "only",
-          "summary": "The target commit id to promote to the subsequent environment",
+        "guides-dir": {
+          "dependsOn": [
+            "all"
+          ],
+          "name": "guides-dir",
+          "summary": "The target directory path to find all guides to validate.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "commit:promote",
+      "id": "guide:validate",
       "pluginAlias": "@knocklabs/cli",
       "pluginName": "@knocklabs/cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Promote one or all commits to the subsequent environment.",
+      "summary": "Validate one or more guides from a local file system.",
       "enableJsonFlag": false,
       "isESM": false,
       "relativePath": [
         "dist",
         "commands",
-        "commit",
-        "promote.js"
+        "guide",
+        "validate.js"
       ]
     },
     "layout:get": {
@@ -535,7 +1170,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -595,7 +1230,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -674,7 +1309,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -757,7 +1392,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -848,7 +1483,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -929,7 +1564,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -990,7 +1625,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1070,7 +1705,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1151,7 +1786,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1240,7 +1875,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1319,7 +1954,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1379,7 +2014,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1458,7 +2093,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1538,7 +2173,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1626,7 +2261,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1705,7 +2340,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1777,7 +2412,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1857,7 +2492,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1950,7 +2585,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2039,7 +2674,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2111,7 +2746,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2172,12 +2807,12 @@
     "workflow:generate-types": {
       "aliases": [],
       "args": {},
-      "description": "Generate types for all workflows in the development environment and write them to a file.",
+      "description": "Generate types for all workflows in an environment and write them to a file.",
       "flags": {
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2243,7 +2878,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2303,7 +2938,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2382,7 +3017,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2440,7 +3075,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2520,7 +3155,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2608,7 +3243,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2692,7 +3327,7 @@
         "service-token": {
           "env": "KNOCK_SERVICE_TOKEN",
           "name": "service-token",
-          "required": true,
+          "required": false,
           "summary": "The service token to authenticate with.",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2752,5 +3387,5 @@
       ]
     }
   },
-  "version": "0.1.22"
+  "version": "0.2.0"
 }