@knocklabs/cli 0.1.5 → 0.1.7

package/README.md

@@ -16,7 +16,7 @@ $ npm install -g @knocklabs/cli
 $ knock COMMAND
 running command...
 $ knock (--version)
-@knocklabs/cli/0.1.5 linux-x64 node-v18.18.0
+@knocklabs/cli/0.1.7 linux-x64 node-v18.18.2
 $ knock --help [COMMAND]
 USAGE
   $ knock COMMAND
@@ -28,17 +28,9 @@ USAGE
 
 <!-- commands -->
 * [`knock commit`](#knock-commit)
+* [`knock commit get ID`](#knock-commit-get-id)
+* [`knock commit list`](#knock-commit-list)
 * [`knock commit promote`](#knock-commit-promote)
-* [`knock email-layout get EMAILLAYOUTKEY`](#knock-email-layout-get-emaillayoutkey)
-* [`knock email-layout list`](#knock-email-layout-list)
-* [`knock email-layout pull [EMAILLAYOUTKEY]`](#knock-email-layout-pull-emaillayoutkey)
-* [`knock email-layout push [EMAILLAYOUTKEY]`](#knock-email-layout-push-emaillayoutkey)
-* [`knock email-layout validate [EMAILLAYOUTKEY]`](#knock-email-layout-validate-emaillayoutkey)
-* [`knock email_layout get EMAILLAYOUTKEY`](#knock-email_layout-get-emaillayoutkey)
-* [`knock email_layout list`](#knock-email_layout-list)
-* [`knock email_layout pull [EMAILLAYOUTKEY]`](#knock-email_layout-pull-emaillayoutkey)
-* [`knock email_layout push [EMAILLAYOUTKEY]`](#knock-email_layout-push-emaillayoutkey)
-* [`knock email_layout validate [EMAILLAYOUTKEY]`](#knock-email_layout-validate-emaillayoutkey)
 * [`knock help [COMMANDS]`](#knock-help-commands)
 * [`knock layout get EMAILLAYOUTKEY`](#knock-layout-get-emaillayoutkey)
 * [`knock layout list`](#knock-layout-list)
@@ -85,252 +77,66 @@ FLAGS
   --service-token=<value>       (required) The service token to authenticate with.
 ```
 
-_See code: [dist/commands/commit/index.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/commit/index.ts)_
+_See code: [src/commands/commit/index.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/commit/index.ts)_
 
-## `knock commit promote`
+## `knock commit get ID`
 
-Promote all changes to the destination environment.
+Display a single commit
 
 ```
 USAGE
-  $ knock commit promote --service-token <value> --to <value> [--force]
+  $ knock commit get ID --service-token <value> [--json]
 
 FLAGS
-  --force                  Remove the confirmation prompt.
   --service-token=<value>  (required) The service token to authenticate with.
-  --to=<value>             (required) The destination environment to promote changes from the preceding environment.
-```
-
-_See code: [dist/commands/commit/promote.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/commit/promote.ts)_
-
-## `knock email-layout get EMAILLAYOUTKEY`
-
-Display a single email layout from an environment.
-
-```
-USAGE
-  $ knock email-layout get EMAILLAYOUTKEY --service-token <value> [--environment <value>] [--hide-uncommitted-changes]
-    [--json]
-
-FLAGS
-  --environment=<value>       [default: development] The environment to use.
-  --hide-uncommitted-changes  Hide any uncommitted changes.
-  --service-token=<value>     (required) The service token to authenticate with.
 
 GLOBAL FLAGS
   --json  Format output as json.
-
-ALIASES
-  $ knock email-layout get
-  $ knock email_layout get
-```
-
-## `knock email-layout list`
-
-Display all email layouts for an environment.
-
-```
-USAGE
-  $ knock email-layout list --service-token <value> [--environment <value>] [--hide-uncommitted-changes] [--after
-    <value>] [--before <value>] [--limit <value>] [--json]
-
-FLAGS
-  --after=<value>             The cursor after which to fetch the next page.
-  --before=<value>            The cursor before which to fetch the previous page.
-  --environment=<value>       [default: development] The environment to use.
-  --hide-uncommitted-changes  Hide any uncommitted changes.
-  --limit=<value>             The total number of entries to fetch per page.
-  --service-token=<value>     (required) The service token to authenticate with.
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-ALIASES
-  $ knock email-layout list
-  $ knock email_layout list
-```
-
-## `knock email-layout pull [EMAILLAYOUTKEY]`
-
-Pull one or more email layouts from an environment into a local file system.
-
-```
-USAGE
-  $ knock email-layout pull [EMAILLAYOUTKEY] --service-token <value> [--environment <value>] [--layouts-dir <value>
-    --all] [--hide-uncommitted-changes] [--force]
-
-FLAGS
-  --all                       Whether to pull all email layouts from the specified environment.
-  --environment=<value>       [default: development] The environment to use.
-  --force                     Remove the confirmation prompt.
-  --hide-uncommitted-changes  Hide any uncommitted changes.
-  --layouts-dir=<value>       The target directory path to pull all email layouts into.
-  --service-token=<value>     (required) The service token to authenticate with.
-
-ALIASES
-  $ knock email-layout pull
-  $ knock email_layout pull
 ```
 
-## `knock email-layout push [EMAILLAYOUTKEY]`
+_See code: [src/commands/commit/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/commit/get.ts)_
 
-Push one or more email layouts from a local file system to Knock.
+## `knock commit list`
 
-```
-USAGE
-  $ knock email-layout push [EMAILLAYOUTKEY] --service-token <value> [--environment development] [--layouts-dir <value>
-    --all] [-m <value> --commit]
-
-FLAGS
-  -m, --commit-message=<value>  Use the given value as the commit message
-  --all                         Whether to push all layouts from the target directory.
-  --commit                      Push and commit the layout(s) at the same time
-  --environment=<option>        [default: development] Pushing an email layout is only allowed in the development
-                                environment
-                                <options: development>
-  --layouts-dir=<value>         The target directory path to find all layouts to push.
-  --service-token=<value>       (required) The service token to authenticate with.
-
-ALIASES
-  $ knock email-layout push
-  $ knock email_layout push
-```
-
-## `knock email-layout validate [EMAILLAYOUTKEY]`
-
-Validate one or more layouts from a local file system.
+Display all commits in an environment
 
 ```
 USAGE
-  $ knock email-layout validate [EMAILLAYOUTKEY] --service-token <value> [--environment development] [--layouts-dir <value>
-    --all]
+  $ knock commit list --service-token <value> [--environment <value>] [--promoted] [--after <value>] [--before
+    <value>] [--limit <value>] [--json]
 
 FLAGS
-  --all                    Whether to validate all layouts from the target directory.
-  --environment=<option>   [default: development] Validating a layout is only done in the development environment
-                           <options: development>
-  --layouts-dir=<value>    The target directory path to find all layouts to validate.
+  --after=<value>          The cursor after which to fetch the next page.
+  --before=<value>         The cursor before which to fetch the previous page.
+  --environment=<value>    [default: development] The environment to use.
+  --limit=<value>          The total number of entries to fetch per page.
+  --[no-]promoted          Show only promoted or unpromoted changes between the given environment and the subsequent
+                           environment.
   --service-token=<value>  (required) The service token to authenticate with.
 
-ALIASES
-  $ knock email-layout validate
-  $ knock email_layout validate
-```
-
-## `knock email_layout get EMAILLAYOUTKEY`
-
-Display a single email layout from an environment.
-
-```
-USAGE
-  $ knock email_layout get EMAILLAYOUTKEY --service-token <value> [--environment <value>] [--hide-uncommitted-changes]
-    [--json]
-
-FLAGS
-  --environment=<value>       [default: development] The environment to use.
-  --hide-uncommitted-changes  Hide any uncommitted changes.
-  --service-token=<value>     (required) The service token to authenticate with.
-
 GLOBAL FLAGS
   --json  Format output as json.
-
-ALIASES
-  $ knock email-layout get
-  $ knock email_layout get
 ```
 
-## `knock email_layout list`
-
-Display all email layouts for an environment.
-
-```
-USAGE
-  $ knock email_layout list --service-token <value> [--environment <value>] [--hide-uncommitted-changes] [--after
-    <value>] [--before <value>] [--limit <value>] [--json]
-
-FLAGS
-  --after=<value>             The cursor after which to fetch the next page.
-  --before=<value>            The cursor before which to fetch the previous page.
-  --environment=<value>       [default: development] The environment to use.
-  --hide-uncommitted-changes  Hide any uncommitted changes.
-  --limit=<value>             The total number of entries to fetch per page.
-  --service-token=<value>     (required) The service token to authenticate with.
+_See code: [src/commands/commit/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/commit/list.ts)_
 
-GLOBAL FLAGS
-  --json  Format output as json.
-
-ALIASES
-  $ knock email-layout list
-  $ knock email_layout list
-```
-
-## `knock email_layout pull [EMAILLAYOUTKEY]`
-
-Pull one or more email layouts from an environment into a local file system.
-
-```
-USAGE
-  $ knock email_layout pull [EMAILLAYOUTKEY] --service-token <value> [--environment <value>] [--layouts-dir <value>
-    --all] [--hide-uncommitted-changes] [--force]
-
-FLAGS
-  --all                       Whether to pull all email layouts from the specified environment.
-  --environment=<value>       [default: development] The environment to use.
-  --force                     Remove the confirmation prompt.
-  --hide-uncommitted-changes  Hide any uncommitted changes.
-  --layouts-dir=<value>       The target directory path to pull all email layouts into.
-  --service-token=<value>     (required) The service token to authenticate with.
-
-ALIASES
-  $ knock email-layout pull
-  $ knock email_layout pull
-```
-
-## `knock email_layout push [EMAILLAYOUTKEY]`
-
-Push one or more email layouts from a local file system to Knock.
-
-```
-USAGE
-  $ knock email_layout push [EMAILLAYOUTKEY] --service-token <value> [--environment development] [--layouts-dir <value>
-    --all] [-m <value> --commit]
-
-FLAGS
-  -m, --commit-message=<value>  Use the given value as the commit message
-  --all                         Whether to push all layouts from the target directory.
-  --commit                      Push and commit the layout(s) at the same time
-  --environment=<option>        [default: development] Pushing an email layout is only allowed in the development
-                                environment
-                                <options: development>
-  --layouts-dir=<value>         The target directory path to find all layouts to push.
-  --service-token=<value>       (required) The service token to authenticate with.
-
-ALIASES
-  $ knock email-layout push
-  $ knock email_layout push
-```
-
-## `knock email_layout validate [EMAILLAYOUTKEY]`
+## `knock commit promote`
 
-Validate one or more layouts from a local file system.
+Promote one or all commits to the subsequent environment.
 
 ```
 USAGE
-  $ knock email_layout validate [EMAILLAYOUTKEY] --service-token <value> [--environment development] [--layouts-dir <value>
-    --all]
+  $ knock commit promote --service-token <value> [--to <value>] [--force] [--only <value>]
 
 FLAGS
-  --all                    Whether to validate all layouts from the target directory.
-  --environment=<option>   [default: development] Validating a layout is only done in the development environment
-                           <options: development>
-  --layouts-dir=<value>    The target directory path to find all layouts to validate.
+  --force                  Remove the confirmation prompt.
+  --only=<value>           The target commit id to promote to the subsequent environment
   --service-token=<value>  (required) The service token to authenticate with.
-
-ALIASES
-  $ knock email-layout validate
-  $ knock email_layout validate
+  --to=<value>             The destination environment to promote all changes from the preceding environment.
 ```
 
+_See code: [src/commands/commit/promote.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/commit/promote.ts)_
+
 ## `knock help [COMMANDS]`
 
 Display help for knock.
@@ -367,13 +173,9 @@ FLAGS
 
 GLOBAL FLAGS
   --json  Format output as json.
-
-ALIASES
-  $ knock email-layout get
-  $ knock email_layout get
 ```
 
-_See code: [dist/commands/layout/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/layout/get.ts)_
+_See code: [src/commands/layout/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/layout/get.ts)_
 
 ## `knock layout list`
 
@@ -394,13 +196,9 @@ FLAGS
 
 GLOBAL FLAGS
   --json  Format output as json.
-
-ALIASES
-  $ knock email-layout list
-  $ knock email_layout list
 ```
 
-_See code: [dist/commands/layout/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/layout/list.ts)_
+_See code: [src/commands/layout/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/layout/list.ts)_
 
 ## `knock layout pull [EMAILLAYOUTKEY]`
 
@@ -418,13 +216,9 @@ FLAGS
   --hide-uncommitted-changes  Hide any uncommitted changes.
   --layouts-dir=<value>       The target directory path to pull all email layouts into.
   --service-token=<value>     (required) The service token to authenticate with.
-
-ALIASES
-  $ knock email-layout pull
-  $ knock email_layout pull
 ```
 
-_See code: [dist/commands/layout/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/layout/pull.ts)_
+_See code: [src/commands/layout/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/layout/pull.ts)_
 
 ## `knock layout push [EMAILLAYOUTKEY]`
 
@@ -444,13 +238,9 @@ FLAGS
                                 <options: development>
   --layouts-dir=<value>         The target directory path to find all layouts to push.
   --service-token=<value>       (required) The service token to authenticate with.
-
-ALIASES
-  $ knock email-layout push
-  $ knock email_layout push
 ```
 
-_See code: [dist/commands/layout/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/layout/push.ts)_
+_See code: [src/commands/layout/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/layout/push.ts)_
 
 ## `knock layout validate [EMAILLAYOUTKEY]`
 
@@ -467,13 +257,9 @@ FLAGS
                            <options: development>
   --layouts-dir=<value>    The target directory path to find all layouts to validate.
   --service-token=<value>  (required) The service token to authenticate with.
-
-ALIASES
-  $ knock email-layout validate
-  $ knock email_layout validate
 ```
 
-_See code: [dist/commands/layout/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/layout/validate.ts)_
+_See code: [src/commands/layout/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/layout/validate.ts)_
 
 ## `knock plugins`
 
@@ -496,7 +282,7 @@ EXAMPLES
   $ knock plugins
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.6/src/commands/plugins/index.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.4/src/commands/plugins/index.ts)_
 
 ## `knock plugins:install PLUGIN...`
 
@@ -561,7 +347,7 @@ EXAMPLES
   $ knock plugins:inspect myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.6/src/commands/plugins/inspect.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.4/src/commands/plugins/inspect.ts)_
 
 ## `knock plugins:install PLUGIN...`
 
@@ -601,7 +387,7 @@ EXAMPLES
   $ knock plugins:install someuser/someplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.6/src/commands/plugins/install.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.4/src/commands/plugins/install.ts)_
 
 ## `knock plugins:link PLUGIN`
 
@@ -615,8 +401,9 @@ ARGUMENTS
   PATH  [default: .] path to plugin
 
 FLAGS
-  -h, --help     Show CLI help.
+  -h, --help      Show CLI help.
   -v, --verbose
+  --[no-]install  Install dependencies after linking the plugin.
 
 DESCRIPTION
   Links a plugin into the CLI for development.
@@ -630,7 +417,7 @@ EXAMPLES
   $ knock plugins:link myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.6/src/commands/plugins/link.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.4/src/commands/plugins/link.ts)_
 
 ## `knock plugins:uninstall PLUGIN...`
 
@@ -678,7 +465,7 @@ ALIASES
   $ knock plugins remove
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.6/src/commands/plugins/uninstall.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.4/src/commands/plugins/uninstall.ts)_
 
 ## `knock plugins:uninstall PLUGIN...`
 
@@ -719,7 +506,7 @@ DESCRIPTION
   Update installed plugins.
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.6/src/commands/plugins/update.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.4/src/commands/plugins/update.ts)_
 
 ## `knock translation get TRANSLATIONREF`
 
@@ -744,7 +531,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [dist/commands/translation/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/translation/get.ts)_
+_See code: [src/commands/translation/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/translation/get.ts)_
 
 ## `knock translation list`
 
@@ -767,7 +554,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [dist/commands/translation/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/translation/list.ts)_
+_See code: [src/commands/translation/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/translation/list.ts)_
 
 ## `knock translation pull [TRANSLATIONREF]`
 
@@ -792,7 +579,7 @@ FLAGS
   --translations-dir=<value>  The target directory path to pull all translations into.
 ```
 
-_See code: [dist/commands/translation/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/translation/pull.ts)_
+_See code: [src/commands/translation/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/translation/pull.ts)_
 
 ## `knock translation push [TRANSLATIONREF]`
 
@@ -819,7 +606,7 @@ FLAGS
   --translations-dir=<value>    The target directory path to find all translations to push.
 ```
 
-_See code: [dist/commands/translation/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/translation/push.ts)_
+_See code: [src/commands/translation/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/translation/push.ts)_
 
 ## `knock translation validate [TRANSLATIONREF]`
 
@@ -844,7 +631,7 @@ FLAGS
   --translations-dir=<value>  The target directory path to find all translations to validate.
 ```
 
-_See code: [dist/commands/translation/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/translation/validate.ts)_
+_See code: [src/commands/translation/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/translation/validate.ts)_
 
 ## `knock whoami`
 
@@ -861,7 +648,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [dist/commands/whoami.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/whoami.ts)_
 
 ## `knock workflow activate WORKFLOWKEY`
 
@@ -888,7 +675,7 @@ DESCRIPTION
   with `false` in order to deactivate it.
 ```
 
-_See code: [dist/commands/workflow/activate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/workflow/activate.ts)_
+_See code: [src/commands/workflow/activate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/workflow/activate.ts)_
 
 ## `knock workflow get WORKFLOWKEY`
 
@@ -908,7 +695,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [dist/commands/workflow/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/workflow/get.ts)_
+_See code: [src/commands/workflow/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/workflow/get.ts)_
 
 ## `knock workflow list`
 
@@ -931,7 +718,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [dist/commands/workflow/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/workflow/list.ts)_
+_See code: [src/commands/workflow/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/workflow/list.ts)_
 
 ## `knock workflow pull [WORKFLOWKEY]`
 
@@ -951,7 +738,7 @@ FLAGS
   --workflows-dir=<value>     The target directory path to pull all workflows into.
 ```
 
-_See code: [dist/commands/workflow/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/workflow/pull.ts)_
+_See code: [src/commands/workflow/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/workflow/pull.ts)_
 
 ## `knock workflow push [WORKFLOWKEY]`
 
@@ -972,7 +759,7 @@ FLAGS
   --workflows-dir=<value>       The target directory path to find all workflows to push.
 ```
 
-_See code: [dist/commands/workflow/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/workflow/push.ts)_
+_See code: [src/commands/workflow/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/workflow/push.ts)_
 
 ## `knock workflow run WORKFLOWKEY`
 
@@ -993,7 +780,7 @@ FLAGS
   --tenant=<value>         A tenant id for the workflow run.
 ```
 
-_See code: [dist/commands/workflow/run.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/workflow/run.ts)_
+_See code: [src/commands/workflow/run.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/workflow/run.ts)_
 
 ## `knock workflow validate [WORKFLOWKEY]`
 
@@ -1012,5 +799,5 @@ FLAGS
   --workflows-dir=<value>  The target directory path to find all workflows to validate.
 ```
 
-_See code: [dist/commands/workflow/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.5/dist/commands/workflow/validate.ts)_
+_See code: [src/commands/workflow/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/workflow/validate.ts)_
 <!-- commandsstop -->

package/dist/commands/commit/get.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: ()=>CommitGet
+});
+const _core = require("@oclif/core");
+const _baseCommand = /*#__PURE__*/ _interopRequireDefault(require("../../lib/base-command"));
+const _date = require("../../lib/helpers/date");
+const _request = require("../../lib/helpers/request");
+const _commit = require("../../lib/marshal/commit");
+function _interopRequireDefault(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+class CommitGet extends _baseCommand.default {
+    async run() {
+        const { flags  } = this.props;
+        const resp = await (0, _request.withSpinner)(()=>this.apiV1.getCommit(this.props));
+        if (flags.json) return resp.data;
+        this.render(resp.data);
+    }
+    render(commit) {
+        this.log(`‣ Showing commit \`${commit.id}\` in \`${commit.environment}\` environment`);
+        /*
+     * Commit table
+     */ const rows = [
+            {
+                key: "ID",
+                value: commit.id
+            },
+            {
+                key: "Resource",
+                value: commit.resource.type
+            },
+            {
+                key: "Identifier",
+                value: commit.resource.identifier
+            },
+            {
+                key: "Author",
+                value: (0, _commit.formatCommitAuthor)(commit)
+            },
+            {
+                key: "Created at",
+                value: (0, _date.formatDate)(commit.created_at)
+            }
+        ];
+        this.log("");
+        _core.ux.table(rows, {
+            key: {
+                header: "Commit",
+                minWidth: 18
+            },
+            value: {
+                header: "",
+                minWidth: 16
+            }
+        });
+        this.log("");
+        if (commit.commit_message) {
+            this.log(commit.commit_message);
+            this.log("");
+        }
+    }
+}
+CommitGet.summary = "Display a single commit";
+CommitGet.args = {
+    id: _core.Args.string({
+        required: true
+    })
+};
+CommitGet.enableJsonFlag = true;

package/dist/commands/commit/list.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: ()=>CommitList
+});
+const _core = require("@oclif/core");
+const _baseCommand = /*#__PURE__*/ _interopRequireDefault(require("../../lib/base-command"));
+const _date = require("../../lib/helpers/date");
+const _object = require("../../lib/helpers/object");
+const _page = require("../../lib/helpers/page");
+const _request = require("../../lib/helpers/request");
+const _commit = require("../../lib/marshal/commit");
+function _interopRequireDefault(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+class CommitList extends _baseCommand.default {
+    async run() {
+        const resp = await this.request();
+        const { flags  } = this.props;
+        if (flags.json) return resp.data;
+        this.render(resp.data);
+    }
+    async request(pageParams = {}) {
+        const props = (0, _object.merge)(this.props, {
+            flags: {
+                ...pageParams
+            }
+        });
+        return (0, _request.withSpinner)(()=>this.apiV1.listCommits(props));
+    }
+    async render(data) {
+        const { entries  } = data;
+        const { environment: env , promoted  } = this.props.flags;
+        let qualifier = "";
+        if (promoted === true) {
+            qualifier = "(showing only promoted)";
+        }
+        if (promoted === false) {
+            qualifier = "(showing only unpromoted)";
+        }
+        this.log(`‣ Showing ${entries.length} commits in \`${env}\` environment ${qualifier}\n`);
+        /*
+     * Commits table
+     */ _core.ux.table(entries, {
+            id: {
+                header: "ID"
+            },
+            resource: {
+                header: "Resource",
+                get: (entry)=>entry.resource.type
+            },
+            identifier: {
+                header: "Identifier",
+                get: (entry)=>entry.resource.identifier
+            },
+            author: {
+                header: "Author",
+                get: (entry)=>(0, _commit.formatCommitAuthor)(entry)
+            },
+            commit_message: {
+                header: "Commit message",
+                get: (entry)=>entry.commit_message ? entry.commit_message.trim() : ""
+            },
+            created_at: {
+                header: "Created at",
+                get: (entry)=>(0, _date.formatDate)(entry.created_at)
+            }
+        });
+        return this.prompt(data);
+    }
+    async prompt(data) {
+        const { page_info  } = data;
+        const pageAction = await (0, _page.maybePromptPageAction)(page_info);
+        const pageParams = pageAction && (0, _page.paramsForPageAction)(pageAction, page_info);
+        if (pageParams) {
+            this.log("\n");
+            const resp = await this.request(pageParams);
+            return this.render(resp.data);
+        }
+    }
+}
+CommitList.summary = "Display all commits in an environment";
+CommitList.flags = {
+    environment: _core.Flags.string({
+        default: "development",
+        summary: "The environment to use."
+    }),
+    promoted: _core.Flags.boolean({
+        summary: "Show only promoted or unpromoted changes between the given environment and the subsequent environment.",
+        allowNo: true
+    }),
+    ..._page.pageFlags
+};
+CommitList.enableJsonFlag = true;

package/dist/commands/commit/promote.js

@@ -8,7 +8,9 @@ Object.defineProperty(exports, "default", {
 });
 const _core = require("@oclif/core");
 const _baseCommand = /*#__PURE__*/ _interopRequireDefault(require("../../lib/base-command"));
+const _error = require("../../lib/helpers/error");
 const _request = require("../../lib/helpers/request");
+const _string = require("../../lib/helpers/string");
 const _ux = require("../../lib/helpers/ux");
 function _interopRequireDefault(obj) {
     return obj && obj.__esModule ? obj : {
@@ -17,6 +19,35 @@ function _interopRequireDefault(obj) {
 }
 class CommitPromote extends _baseCommand.default {
     async run() {
+        const { flags  } = this.props;
+        // Currently this command support two modes of operation based on the flags:
+        // * --to : Promotes all changes to the destination environment.
+        // * --only: Promotes one commit to the subsequent enviroment
+        // The absence or presence of both flags will result in an error.
+        if (flags.to && flags.only) {
+            throw new Error("`--to` and `--only` flags cannot be used together.\n See more help with --help");
+        }
+        if (!flags.to && !flags.only) {
+            throw new Error("You must specify either `--to` or `--only` flag.\n See more help with --help");
+        }
+        return flags.only ? this.promoteOneChange() : this.promoteAllChanges();
+    }
+    async promoteOneChange() {
+        const { flags  } = this.props;
+        // Confirm first as we are about to promote the commit, unless forced.
+        const prompt = `Promote the commit \`${flags.only}\` ?`;
+        const input = flags.force || await (0, _ux.promptToConfirm)(prompt);
+        if (!input) return;
+        const resp = await (0, _request.withSpinner)(()=>this.apiV1.promoteOneChange(this.props));
+        if (!(0, _request.isSuccessResp)(resp)) {
+            const message = (0, _request.formatErrorRespMessage)(resp);
+            return this.error(new _error.ApiError(message));
+        }
+        const { commit  } = resp.data;
+        this.log(`‣ Successfully promoted the commit \`${flags.only}\` into \`${commit.environment}\` environment`);
+        this.log((0, _string.indentString)(`Commit id: ${commit.id}`, 4));
+    }
+    async promoteAllChanges() {
         const { flags  } = this.props;
         // Confirm first as we are about to promote changes to go live in the target
         // environment, unless forced.
@@ -27,13 +58,15 @@ class CommitPromote extends _baseCommand.default {
         this.log(`‣ Successfully promoted all changes to \`${flags.to}\` environment`);
     }
 }
-CommitPromote.summary = "Promote all changes to the destination environment.";
+CommitPromote.summary = "Promote one or all commits to the subsequent environment.";
 CommitPromote.flags = {
     to: _core.Flags.string({
-        summary: "The destination environment to promote changes from the preceding environment.",
-        required: true
+        summary: "The destination environment to promote all changes from the preceding environment."
     }),
     force: _core.Flags.boolean({
         summary: "Remove the confirmation prompt."
+    }),
+    only: _core.Flags.string({
+        summary: "The target commit id to promote to the subsequent environment"
     })
 };

package/dist/commands/layout/get.js

@@ -76,10 +76,6 @@ class EmailLayoutGet extends _baseCommand.default {
         }
     }
 }
-EmailLayoutGet.aliases = [
-    "email-layout:get",
-    "email_layout:get"
-];
 EmailLayoutGet.summary = "Display a single email layout from an environment.";
 EmailLayoutGet.flags = {
     environment: _core.Flags.string({

package/dist/commands/layout/list.js

@@ -68,10 +68,6 @@ class EmailLayoutList extends _baseCommand.default {
         }
     }
 }
-EmailLayoutList.aliases = [
-    "email-layout:list",
-    "email_layout:list"
-];
 EmailLayoutList.summary = "Display all email layouts for an environment.";
 EmailLayoutList.flags = {
     environment: _core.Flags.string({

package/dist/commands/layout/pull.js

@@ -163,10 +163,6 @@ class EmailLayoutPull extends _baseCommand.default {
         return this.error("Missing 1 required arg:\nemailLayoutKey");
     }
 }
-EmailLayoutPull.aliases = [
-    "email-layout:pull",
-    "email_layout:pull"
-];
 EmailLayoutPull.summary = "Pull one or more email layouts from an environment into a local file system.";
 EmailLayoutPull.flags = {
     environment: _core.Flags.string({

package/dist/commands/layout/push.js

@@ -116,10 +116,6 @@ class EmailLayoutPush extends _baseCommand.default {
         this.log(`‣ Successfully ${actioned} ${layouts.length} layout(s):\n` + (0, _string.indentString)(layoutKeys.join("\n"), 4));
     }
 }
-EmailLayoutPush.aliases = [
-    "email-layout:push",
-    "email_layout:push"
-];
 EmailLayoutPush.summary = "Push one or more email layouts from a local file system to Knock.";
 EmailLayoutPush.flags = {
     environment: _core.Flags.string({

package/dist/commands/layout/validate.js

@@ -101,10 +101,6 @@ class EmailLayoutValidate extends _baseCommand.default {
         return errors;
     }
 }
-EmailLayoutValidate.aliases = [
-    "email-layout:validate",
-    "email_layout:validate"
-];
 EmailLayoutValidate.summary = "Validate one or more layouts from a local file system.";
 EmailLayoutValidate.flags = {
     environment: _core.Flags.string({

package/dist/lib/api-v1.js

@@ -94,6 +94,19 @@ class ApiV1 {
         });
     }
     // By resources: Commits
+    async listCommits({ flags  }) {
+        const params = (0, _object.prune)({
+            environment: flags.environment,
+            promoted: flags.promoted,
+            ...(0, _page.toPageParams)(flags)
+        });
+        return this.get("/commits", {
+            params
+        });
+    }
+    async getCommit({ args  }) {
+        return this.get(`/commits/${args.id}`);
+    }
     async commitAllChanges({ flags  }) {
         const params = (0, _object.prune)({
             environment: flags.environment,
@@ -111,6 +124,9 @@ class ApiV1 {
             params
         });
     }
+    async promoteOneChange({ flags  }) {
+        return this.put(`/commits/${flags.only}/promote`);
+    }
     // By resources: Translations
     async listTranslations({ flags  }, filters = {}) {
         const params = (0, _object.prune)({

package/dist/lib/marshal/commit/helpers.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "formatCommitAuthor", {
+    enumerable: true,
+    get: ()=>formatCommitAuthor
+});
+function formatCommitAuthor(commit) {
+    const email = commit.author.email;
+    const name = commit.author.name;
+    return name ? `${name} <${email}>` : `<${email}>`;
+}

package/dist/lib/marshal/commit/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_exportStar(require("./helpers"), exports);
+_exportStar(require("./types"), exports);
+function _exportStar(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) Object.defineProperty(to, k, {
+            enumerable: true,
+            get: function() {
+                return from[k];
+            }
+        });
+    });
+    return from;
+}

package/dist/lib/marshal/commit/types.js

@@ -0,0 +1,5 @@
+// Commit payload data from the API.
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.5",
+  "version": "0.1.7",
   "commands": {
     "knock": {
       "id": "knock",
@@ -86,6 +86,44 @@
       },
       "args": {}
     },
+    "commit:get": {
+      "id": "commit:get",
+      "summary": "Display a single commit",
+      "strict": true,
+      "pluginName": "@knocklabs/cli",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "flags": {
+        "service-token": {
+          "name": "service-token",
+          "type": "option",
+          "summary": "The service token to authenticate with.",
+          "required": true,
+          "multiple": false
+        },
+        "api-origin": {
+          "name": "api-origin",
+          "type": "option",
+          "hidden": true,
+          "required": false,
+          "multiple": false
+        },
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        }
+      },
+      "args": {
+        "id": {
+          "name": "id",
+          "required": true
+        }
+      }
+    },
     "commit": {
       "id": "commit",
       "summary": "Commit all changes in development environment.",
@@ -135,9 +173,73 @@
       },
       "args": {}
     },
+    "commit:list": {
+      "id": "commit:list",
+      "summary": "Display all commits in an environment",
+      "strict": true,
+      "pluginName": "@knocklabs/cli",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "flags": {
+        "service-token": {
+          "name": "service-token",
+          "type": "option",
+          "summary": "The service token to authenticate with.",
+          "required": true,
+          "multiple": false
+        },
+        "api-origin": {
+          "name": "api-origin",
+          "type": "option",
+          "hidden": true,
+          "required": false,
+          "multiple": false
+        },
+        "environment": {
+          "name": "environment",
+          "type": "option",
+          "summary": "The environment to use.",
+          "multiple": false,
+          "default": "development"
+        },
+        "promoted": {
+          "name": "promoted",
+          "type": "boolean",
+          "summary": "Show only promoted or unpromoted changes between the given environment and the subsequent environment.",
+          "allowNo": true
+        },
+        "after": {
+          "name": "after",
+          "type": "option",
+          "summary": "The cursor after which to fetch the next page.",
+          "multiple": false
+        },
+        "before": {
+          "name": "before",
+          "type": "option",
+          "summary": "The cursor before which to fetch the previous page.",
+          "multiple": false
+        },
+        "limit": {
+          "name": "limit",
+          "type": "option",
+          "summary": "The total number of entries to fetch per page.",
+          "multiple": false
+        },
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
     "commit:promote": {
       "id": "commit:promote",
-      "summary": "Promote all changes to the destination environment.",
+      "summary": "Promote one or all commits to the subsequent environment.",
       "strict": true,
       "pluginName": "@knocklabs/cli",
       "pluginAlias": "@knocklabs/cli",
@@ -161,8 +263,7 @@
         "to": {
           "name": "to",
           "type": "option",
-          "summary": "The destination environment to promote changes from the preceding environment.",
-          "required": true,
+          "summary": "The destination environment to promote all changes from the preceding environment.",
           "multiple": false
         },
         "force": {
@@ -170,6 +271,12 @@
           "type": "boolean",
           "summary": "Remove the confirmation prompt.",
           "allowNo": false
+        },
+        "only": {
+          "name": "only",
+          "type": "option",
+          "summary": "The target commit id to promote to the subsequent environment",
+          "multiple": false
         }
       },
       "args": {}
@@ -181,10 +288,7 @@
       "pluginName": "@knocklabs/cli",
       "pluginAlias": "@knocklabs/cli",
       "pluginType": "core",
-      "aliases": [
-        "email-layout:get",
-        "email_layout:get"
-      ],
+      "aliases": [],
       "flags": {
         "service-token": {
           "name": "service-token",
@@ -235,10 +339,7 @@
       "pluginName": "@knocklabs/cli",
       "pluginAlias": "@knocklabs/cli",
       "pluginType": "core",
-      "aliases": [
-        "email-layout:list",
-        "email_layout:list"
-      ],
+      "aliases": [],
       "flags": {
         "service-token": {
           "name": "service-token",
@@ -302,10 +403,7 @@
       "pluginName": "@knocklabs/cli",
       "pluginAlias": "@knocklabs/cli",
       "pluginType": "core",
-      "aliases": [
-        "email-layout:pull",
-        "email_layout:pull"
-      ],
+      "aliases": [],
       "flags": {
         "service-token": {
           "name": "service-token",
@@ -373,10 +471,7 @@
       "pluginName": "@knocklabs/cli",
       "pluginAlias": "@knocklabs/cli",
       "pluginType": "core",
-      "aliases": [
-        "email-layout:push",
-        "email_layout:push"
-      ],
+      "aliases": [],
       "flags": {
         "service-token": {
           "name": "service-token",
@@ -451,10 +546,7 @@
       "pluginName": "@knocklabs/cli",
       "pluginAlias": "@knocklabs/cli",
       "pluginType": "core",
-      "aliases": [
-        "email-layout:validate",
-        "email_layout:validate"
-      ],
+      "aliases": [],
       "flags": {
         "service-token": {
           "name": "service-token",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knocklabs/cli",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Knock CLI",
   "author": "@knocklabs",
   "bin": {
@@ -21,24 +21,24 @@
     "@oclif/plugin-help": "^5",
     "@oclif/plugin-plugins": "^3",
     "@prantlf/jsonlint": "^14.0.3",
-    "axios": "^1.4.0",
+    "axios": "^1.5.1",
     "date-fns": "^2.30.0",
     "enquirer": "^2.4.1",
     "fs-extra": "^11.1.1",
-    "liquidjs": "^10.8.4",
+    "liquidjs": "^10.9.3",
     "locale-codes": "^1.3.1",
     "lodash": "^4.17.21",
-    "yup": "^1.2.0"
+    "yup": "^1.3.2"
   },
   "devDependencies": {
-    "@oclif/test": "^2.3.23",
+    "@oclif/test": "^2.5.6",
     "@swc/cli": "^0.1.62",
     "@swc/core": "^1.3.37",
     "@swc/helpers": "^0.4.14",
     "@types/chai": "^4",
-    "@types/fs-extra": "^11.0.1",
+    "@types/fs-extra": "^11.0.3",
     "@types/mocha": "^10.0.1",
-    "@types/node": "^20.4.1",
+    "@types/node": "^20.9.0",
     "chai": "^4",
     "eslint": "^7.32.0",
     "eslint-config-oclif": "^4",
@@ -47,14 +47,14 @@
     "eslint-plugin-prettier": "^4.2.1",
     "eslint-plugin-simple-import-sort": "^10.0.0",
     "mocha": "^10",
-    "nock": "^13.3.1",
+    "nock": "^13.3.8",
     "oclif": "^3",
     "prettier": "2.8.8",
     "shx": "^0.3.4",
     "sinon": "^15.2.0",
     "ts-node": "^10.9.1",
     "tsconfig-paths": "^4.2.0",
-    "tslib": "^2.6.0",
+    "tslib": "^2.6.2",
     "typescript": "^5.1.6"
   },
   "oclif": {