@knocklabs/cli 0.2.1 → 0.2.3

package/dist/commands/branch/switch.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return BranchSwitch;
+    }
+});
+const _nodepath = /*#__PURE__*/ _interop_require_wildcard(require("node:path"));
+const _core = require("@oclif/core");
+const _findup = /*#__PURE__*/ _interop_require_default(require("find-up"));
+const _fsextra = /*#__PURE__*/ _interop_require_wildcard(require("fs-extra"));
+const _basecommand = /*#__PURE__*/ _interop_require_default(require("../../lib/base-command"));
+const _arg = require("../../lib/helpers/arg");
+const _branch = require("../../lib/helpers/branch");
+const _error = require("../../lib/helpers/error");
+const _git = require("../../lib/helpers/git");
+const _request = require("../../lib/helpers/request");
+const _ux = require("../../lib/helpers/ux");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+class BranchSwitch extends _basecommand.default {
+    async run() {
+        const { args } = this.props;
+        const currDir = process.cwd();
+        let branchFilePath = await (0, _findup.default)(_branch.BRANCH_FILE_NAME, {
+            cwd: currDir
+        });
+        if (!branchFilePath) {
+            const projectRoot = await (0, _branch.findProjectRoot)();
+            branchFilePath = await this.promptToCreateBranchFile(projectRoot);
+            // User declined to create the branch file
+            if (!branchFilePath) return;
+            const isBranchFileIgnoredByGit = await (0, _git.isFileIgnoredByGit)(projectRoot, branchFilePath);
+            if (!isBranchFileIgnoredByGit) {
+                await this.promptToUpdateGitIgnoreFile(projectRoot);
+            }
+        }
+        await this.switchToBranch(branchFilePath, args.slug);
+    }
+    async promptToCreateBranchFile(projectRoot) {
+        const { flags } = this.props;
+        const prompt = `Create \`${_branch.BRANCH_FILE_NAME}\` at ${projectRoot}?`;
+        const input = flags.force || await (0, _ux.promptToConfirm)(prompt);
+        if (!input) return undefined;
+        return _nodepath.resolve(projectRoot, _branch.BRANCH_FILE_NAME);
+    }
+    async promptToUpdateGitIgnoreFile(projectRoot) {
+        const { flags } = this.props;
+        const gitIgnoreFilePath = _nodepath.resolve(projectRoot, ".gitignore");
+        const gitIgnoreFileExists = await _fsextra.exists(gitIgnoreFilePath);
+        const prompt = gitIgnoreFileExists ? `Update \`${gitIgnoreFilePath}\` to ignore \`${_branch.BRANCH_FILE_NAME}\`?` : `Create \`${gitIgnoreFilePath}\` to ignore \`${_branch.BRANCH_FILE_NAME}\`?`;
+        const input = flags.force || await (0, _ux.promptToConfirm)(prompt);
+        if (!input) return;
+        await (0, _branch.appendBranchFileToGitIgnore)(gitIgnoreFilePath, gitIgnoreFileExists);
+    }
+    async switchToBranch(branchFilePath, slug) {
+        this.log(`‣ Switching to branch \`${slug}\``);
+        const branch = await this.resolveBranch(slug);
+        await (0, _branch.writeSlugToBranchFile)(branchFilePath, branch.slug);
+        this.log(`‣ Successfully switched to branch \`${branch.slug}\``);
+    }
+    async resolveBranch(slug) {
+        const { flags } = this.props;
+        try {
+            return await this.fetchBranch(slug);
+        } catch (error) {
+            // Create the branch when --create flag is provided and the branch is not found
+            if (flags.create && error instanceof _error.ApiError && error.status === 404 && error.code === "branch_not_found") {
+                return this.createBranch(slug);
+            }
+            throw error;
+        }
+    }
+    async fetchBranch(slug) {
+        return (0, _request.withSpinnerV2)(()=>this.apiV1.mgmtClient.get(`/v1/branches/${slug}`), {
+            action: "‣ Fetching branch"
+        });
+    }
+    async createBranch(slug) {
+        return (0, _request.withSpinnerV2)(()=>this.apiV1.mgmtClient.post(`/v1/branches/${slug}`), {
+            action: "‣ Creating branch"
+        });
+    }
+}
+// Hide until branches are released in GA
+_define_property(BranchSwitch, "hidden", true);
+_define_property(BranchSwitch, "summary", "Switches to an existing branch with the given slug.");
+_define_property(BranchSwitch, "flags", {
+    create: _core.Flags.boolean({
+        summary: "Create the branch if it doesn't yet exist."
+    }),
+    force: _core.Flags.boolean({
+        summary: "Remove the confirmation prompt."
+    })
+});
+_define_property(BranchSwitch, "args", {
+    slug: _arg.CustomArgs.slug({
+        required: true,
+        description: "The slug of the branch to switch to"
+    })
+});

package/dist/commands/commit/get.js

@@ -33,10 +33,10 @@ function _interop_require_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);
+        const { flags, args } = this.props;
+        const resp = await (0, _request.withSpinnerV2)(()=>this.apiV1.mgmtClient.commits.retrieve(args.id));
+        if (flags.json) return resp;
+        this.render(resp);
     }
     render(commit) {
         this.log(`‣ Showing commit \`${commit.id}\` in \`${commit.environment}\` environment`);

package/dist/commands/commit/index.js

@@ -10,7 +10,9 @@ Object.defineProperty(exports, "default", {
 });
 const _core = require("@oclif/core");
 const _basecommand = /*#__PURE__*/ _interop_require_default(require("../../lib/base-command"));
+const _command = require("../../lib/helpers/command");
 const _const = require("../../lib/helpers/const");
+const _flag = /*#__PURE__*/ _interop_require_wildcard(require("../../lib/helpers/flag"));
 const _request = require("../../lib/helpers/request");
 const _ux = require("../../lib/helpers/ux");
 function _define_property(obj, key, value) {
@@ -31,16 +33,58 @@ function _interop_require_default(obj) {
         default: obj
     };
 }
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
 class Commit extends _basecommand.default {
     async run() {
         const { flags } = this.props;
+        const scope = (0, _command.formatCommandScope)(flags);
         // Confirm first as we are about to commit changes to go live in the
         // development environment, unless forced.
-        const prompt = "Commit all changes in the development environment?";
+        const prompt = `Commit all changes in the ${scope}?`;
         const input = flags.force || await (0, _ux.promptToConfirm)(prompt);
         if (!input) return;
         await (0, _request.withSpinner)(()=>this.apiV1.commitAllChanges(this.props));
-        this.log(`‣ Successfully committed all changes in \`${flags.environment}\` environment`);
+        this.log(`‣ Successfully committed all changes in ${scope}`);
     }
 }
 _define_property(Commit, "summary", "Commit all changes in development environment.");
@@ -52,6 +96,7 @@ _define_property(Commit, "flags", {
             _const.KnockEnv.Development
         ]
     }),
+    branch: _flag.branch,
     "commit-message": _core.Flags.string({
         summary: "Use the given value as the commit message.",
         char: "m"

package/dist/commands/commit/list.js

@@ -10,7 +10,9 @@ Object.defineProperty(exports, "default", {
 });
 const _core = require("@oclif/core");
 const _basecommand = /*#__PURE__*/ _interop_require_default(require("../../lib/base-command"));
+const _command = require("../../lib/helpers/command");
 const _date = require("../../lib/helpers/date");
+const _flag = /*#__PURE__*/ _interop_require_wildcard(require("../../lib/helpers/flag"));
 const _objectisomorphic = require("../../lib/helpers/object.isomorphic");
 const _page = require("../../lib/helpers/page");
 const _request = require("../../lib/helpers/request");
@@ -33,6 +35,47 @@ function _interop_require_default(obj) {
         default: obj
     };
 }
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
 class CommitList extends _basecommand.default {
     async run() {
         // Validate that resource-type and resource-id are used together
@@ -56,7 +99,7 @@ class CommitList extends _basecommand.default {
     }
     async render(data) {
         const { entries } = data;
-        const { environment: env, promoted } = this.props.flags;
+        const { promoted } = this.props.flags;
         let qualifier = "";
         if (promoted === true) {
             qualifier = "(showing only promoted)";
@@ -64,32 +107,36 @@ class CommitList extends _basecommand.default {
         if (promoted === false) {
             qualifier = "(showing only unpromoted)";
         }
-        this.log(`‣ Showing ${entries.length} commits in \`${env}\` environment ${qualifier}\n`);
+        const scope = (0, _command.formatCommandScope)(this.props.flags);
+        this.log(`‣ Showing ${entries.length} commits in ${scope} ${qualifier}\n`);
         /*
      * Commits table
-     */ _core.ux.table(entries, {
+     */ const formattedEntries = entries.map((entry)=>({
+                id: entry.id,
+                resource: entry.resource.type,
+                identifier: entry.resource.identifier,
+                author: (0, _commit.formatCommitAuthor)(entry),
+                commit_message: entry.commit_message ? entry.commit_message.trim() : "",
+                created_at: (0, _date.formatDate)(entry.created_at)
+            }));
+        _core.ux.table(formattedEntries, {
             id: {
                 header: "ID"
             },
             resource: {
-                header: "Resource",
-                get: (entry)=>entry.resource.type
+                header: "Resource"
             },
             identifier: {
-                header: "Identifier",
-                get: (entry)=>entry.resource.identifier
+                header: "Identifier"
             },
             author: {
-                header: "Author",
-                get: (entry)=>(0, _commit.formatCommitAuthor)(entry)
+                header: "Author"
             },
             commit_message: {
-                header: "Commit message",
-                get: (entry)=>entry.commit_message ? entry.commit_message.trim() : ""
+                header: "Commit message"
             },
             created_at: {
-                header: "Created at",
-                get: (entry)=>(0, _date.formatDate)(entry.created_at)
+                header: "Created at"
             }
         });
         return this.prompt(data);
@@ -111,6 +158,7 @@ _define_property(CommitList, "flags", {
         default: "development",
         summary: "The environment to use."
     }),
+    branch: _flag.branch,
     promoted: _core.Flags.boolean({
         summary: "Show only promoted or unpromoted changes between the given environment and the subsequent environment.",
         allowNo: true

package/dist/commands/guide/activate.js

@@ -10,7 +10,8 @@ Object.defineProperty(exports, "default", {
 });
 const _core = require("@oclif/core");
 const _basecommand = /*#__PURE__*/ _interop_require_default(require("../../lib/base-command"));
-const _flag = require("../../lib/helpers/flag");
+const _command = require("../../lib/helpers/command");
+const _flag = /*#__PURE__*/ _interop_require_wildcard(require("../../lib/helpers/flag"));
 const _request = require("../../lib/helpers/request");
 const _ux = require("../../lib/helpers/ux");
 function _define_property(obj, key, value) {
@@ -31,9 +32,51 @@ function _interop_require_default(obj) {
         default: obj
     };
 }
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
 class GuideActivate extends _basecommand.default {
     async run() {
         const { args, flags } = this.props;
+        const scope = (0, _command.formatCommandScope)(flags);
         // Validate that either status OR from/until is provided
         const hasStatus = flags.status !== undefined;
         const hasFrom = Boolean(flags.from);
@@ -52,7 +95,7 @@ class GuideActivate extends _basecommand.default {
             action = `Deactivate at ${flags.until}`;
         }
         // 1. Confirm before activating or deactivating the guide, unless forced.
-        const prompt = `${action} \`${args.guideKey}\` guide in \`${flags.environment}\` environment?`;
+        const prompt = `${action} \`${args.guideKey}\` guide in ${scope}?`;
         const input = flags.force || await (0, _ux.promptToConfirm)(prompt);
         if (!input) return;
         // 2. Proceed to make a request to set the guide status.
@@ -73,7 +116,7 @@ class GuideActivate extends _basecommand.default {
         } else {
             actioned = "scheduled";
         }
-        this.log(`‣ Successfully ${actioned} \`${args.guideKey}\` guide in \`${flags.environment}\` environment`);
+        this.log(`‣ Successfully ${actioned} \`${args.guideKey}\` guide in ${scope}`);
     }
 }
 _define_property(GuideActivate, "summary", "Activate or deactivate a guide in a given environment.");
@@ -81,7 +124,7 @@ _define_property(GuideActivate, "description", `
 This enables or disables a guide in a given environment without
 needing to go through environment promotion.
 
-You can activate or deactivate a guide immediately or schedule it to be activated 
+You can activate or deactivate a guide immediately or schedule it to be activated
 or deactivated at a later time using the --from and --until flags.
 `.trim());
 _define_property(GuideActivate, "flags", {
@@ -91,6 +134,7 @@ _define_property(GuideActivate, "flags", {
         required: true,
         summary: "The environment to use."
     }),
+    branch: _flag.branch,
     status: (0, _flag.booleanStr)({
         summary: "The guide active status to set. Cannot be used with --from/--until.",
         exclusive: [

package/dist/commands/guide/generate-types.js

@@ -12,6 +12,7 @@ const _nodepath = /*#__PURE__*/ _interop_require_default(require("node:path"));
 const _core = require("@oclif/core");
 const _fsextra = /*#__PURE__*/ _interop_require_wildcard(require("fs-extra"));
 const _basecommand = /*#__PURE__*/ _interop_require_default(require("../../lib/base-command"));
+const _command = require("../../lib/helpers/command");
 const _const = require("../../lib/helpers/const");
 const _error = require("../../lib/helpers/error");
 const _flag = /*#__PURE__*/ _interop_require_wildcard(require("../../lib/helpers/flag"));
@@ -109,7 +110,8 @@ class GuideGenerateTypes extends _basecommand.default {
             const lines = _guide.generateIndexTypeTS(mapping);
             await _fsextra.appendFile(outputFilePath, lines.join("\n"));
         }
-        this.log(`‣ Successfully generated types for ${count} message type(s) and wrote them to ${outputFilePath}`);
+        const scope = (0, _command.formatCommandScope)(flags);
+        this.log(`‣ Successfully generated types for ${count} message type(s) using ${scope} and wrote them to ${outputFilePath}`);
     }
     async listAllGuides(pageParams = {}, guidesFetchedSoFar = []) {
         const props = (0, _objectisomorphic.merge)(this.props, {
@@ -141,6 +143,7 @@ _define_property(GuideGenerateTypes, "flags", {
         summary: "Select the environment to generate types for.",
         default: _const.KnockEnv.Development
     }),
+    branch: _flag.branch,
     "output-file": _flag.filePath({
         summary: `The output file to write the generated types to. We currently support ${supportedExts} files only. Your file extension will determine the target language for the generated types.`,
         required: true

package/dist/commands/guide/get.js

@@ -10,8 +10,10 @@ Object.defineProperty(exports, "default", {
 });
 const _core = require("@oclif/core");
 const _basecommand = /*#__PURE__*/ _interop_require_default(require("../../lib/base-command"));
+const _command = require("../../lib/helpers/command");
 const _date = require("../../lib/helpers/date");
 const _error = require("../../lib/helpers/error");
+const _flag = /*#__PURE__*/ _interop_require_wildcard(require("../../lib/helpers/flag"));
 const _request = require("../../lib/helpers/request");
 const _ux = require("../../lib/helpers/ux");
 const _conditions = require("../../lib/marshal/conditions");
@@ -34,6 +36,47 @@ function _interop_require_default(obj) {
         default: obj
     };
 }
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
 class GuideGet extends _basecommand.default {
     async run() {
         _ux.spinner.start("‣ Loading");
@@ -57,7 +100,8 @@ class GuideGet extends _basecommand.default {
         const { guideKey } = this.props.args;
         const { environment: env, "hide-uncommitted-changes": committedOnly } = this.props.flags;
         const qualifier = env === "development" && !committedOnly ? "(including uncommitted)" : "";
-        this.log(`‣ Showing guide \`${guideKey}\` in \`${env}\` environment ${qualifier}\n`);
+        const scope = (0, _command.formatCommandScope)(this.props.flags);
+        this.log(`‣ Showing guide \`${guideKey}\` in ${scope} ${qualifier}\n`);
         /*
      * Guide table
      */ const rows = [
@@ -120,13 +164,12 @@ class GuideGet extends _basecommand.default {
     }
 }
 _define_property(GuideGet, "summary", "Display a single guide from an environment.");
-// Hide until guides are released in GA.
-_define_property(GuideGet, "hidden", true);
 _define_property(GuideGet, "flags", {
     environment: _core.Flags.string({
         default: "development",
         summary: "The environment to use."
     }),
+    branch: _flag.branch,
     "hide-uncommitted-changes": _core.Flags.boolean({
         summary: "Hide any uncommitted changes."
     })

package/dist/commands/guide/list.js

@@ -10,7 +10,9 @@ Object.defineProperty(exports, "default", {
 });
 const _core = require("@oclif/core");
 const _basecommand = /*#__PURE__*/ _interop_require_default(require("../../lib/base-command"));
+const _command = require("../../lib/helpers/command");
 const _date = require("../../lib/helpers/date");
+const _flag = /*#__PURE__*/ _interop_require_wildcard(require("../../lib/helpers/flag"));
 const _objectisomorphic = require("../../lib/helpers/object.isomorphic");
 const _page = require("../../lib/helpers/page");
 const _request = require("../../lib/helpers/request");
@@ -33,6 +35,47 @@ function _interop_require_default(obj) {
         default: obj
     };
 }
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
 class GuideList extends _basecommand.default {
     async run() {
         const resp = await this.request();
@@ -52,7 +95,8 @@ class GuideList extends _basecommand.default {
         const { entries } = data;
         const { environment: env, "hide-uncommitted-changes": committedOnly } = this.props.flags;
         const qualifier = env === "development" && !committedOnly ? "(including uncommitted)" : "";
-        this.log(`‣ Showing ${entries.length} guides in \`${env}\` environment ${qualifier}\n`);
+        const scope = (0, _command.formatCommandScope)(this.props.flags);
+        this.log(`‣ Showing ${entries.length} guides in ${scope} ${qualifier}\n`);
         /*
      * Guides list table
      */ _core.ux.table(entries, {
@@ -97,13 +141,12 @@ class GuideList extends _basecommand.default {
     }
 }
 _define_property(GuideList, "summary", "Display all guides for an environment.");
-// Hide until guides are released in GA.
-_define_property(GuideList, "hidden", true);
 _define_property(GuideList, "flags", {
     environment: _core.Flags.string({
         default: "development",
         summary: "The environment to use."
     }),
+    branch: _flag.branch,
     "hide-uncommitted-changes": _core.Flags.boolean({
         summary: "Hide any uncommitted changes."
     }),