@knocklabs/cli 0.1.6 → 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.6 linux-x64 node-v18.18.0
+@knocklabs/cli/0.1.7 linux-x64 node-v18.18.2
 $ knock --help [COMMAND]
 USAGE
   $ knock COMMAND
@@ -28,6 +28,8 @@ 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 help [COMMANDS]`](#knock-help-commands)
 * [`knock layout get EMAILLAYOUTKEY`](#knock-layout-get-emaillayoutkey)
@@ -75,23 +77,65 @@ 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.6/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 get ID`
+
+Display a single commit
+
+```
+USAGE
+  $ knock commit get ID --service-token <value> [--json]
+
+FLAGS
+  --service-token=<value>  (required) The service token to authenticate with.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+```
+
+_See code: [src/commands/commit/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/commit/get.ts)_
+
+## `knock commit list`
+
+Display all commits in an environment
+
+```
+USAGE
+  $ knock commit list --service-token <value> [--environment <value>] [--promoted] [--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.
+  --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.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+```
+
+_See code: [src/commands/commit/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.7/src/commands/commit/list.ts)_
 
 ## `knock commit promote`
 
-Promote all changes to the destination environment.
+Promote one or all commits to the subsequent environment.
 
 ```
 USAGE
-  $ knock commit promote --service-token <value> --to <value> [--force]
+  $ knock commit promote --service-token <value> [--to <value>] [--force] [--only <value>]
 
 FLAGS
   --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.
-  --to=<value>             (required) The destination environment to promote changes from the preceding environment.
+  --to=<value>             The destination environment to promote all changes from the preceding environment.
 ```
 
-_See code: [dist/commands/commit/promote.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.6/dist/commands/commit/promote.ts)_
+_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]`
 
@@ -131,7 +175,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [dist/commands/layout/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.6/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`
 
@@ -154,7 +198,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [dist/commands/layout/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.6/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]`
 
@@ -174,7 +218,7 @@ FLAGS
   --service-token=<value>     (required) The service token to authenticate with.
 ```
 
-_See code: [dist/commands/layout/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.6/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]`
 
@@ -196,7 +240,7 @@ FLAGS
   --service-token=<value>       (required) The service token to authenticate with.
 ```
 
-_See code: [dist/commands/layout/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.6/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]`
 
@@ -215,7 +259,7 @@ FLAGS
   --service-token=<value>  (required) The service token to authenticate with.
 ```
 
-_See code: [dist/commands/layout/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.6/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`
 
@@ -238,7 +282,7 @@ EXAMPLES
   $ knock plugins
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.1/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...`
 
@@ -303,7 +347,7 @@ EXAMPLES
   $ knock plugins:inspect myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.1/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...`
 
@@ -343,7 +387,7 @@ EXAMPLES
   $ knock plugins:install someuser/someplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.1/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`
 
@@ -373,7 +417,7 @@ EXAMPLES
   $ knock plugins:link myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.1/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...`
 
@@ -421,7 +465,7 @@ ALIASES
   $ knock plugins remove
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.1/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...`
 
@@ -462,7 +506,7 @@ DESCRIPTION
   Update installed plugins.
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.9.1/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`
 
@@ -487,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.6/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`
 
@@ -510,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.6/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]`
 
@@ -535,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.6/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]`
 
@@ -562,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.6/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]`
 
@@ -587,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.6/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`
 
@@ -604,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.6/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`
 
@@ -631,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.6/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`
 
@@ -651,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.6/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`
 
@@ -674,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.6/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]`
 
@@ -694,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.6/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]`
 
@@ -715,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.6/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`
 
@@ -736,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.6/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]`
 
@@ -755,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.6/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/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.6",
+  "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": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knocklabs/cli",
-  "version": "0.1.6",
+  "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.8.6",
+    "@types/node": "^20.9.0",
     "chai": "^4",
     "eslint": "^7.32.0",
     "eslint-config-oclif": "^4",
@@ -47,7 +47,7 @@
     "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",