@knocklabs/cli 0.1.0-rc.3 → 0.1.0

package/dist/commands/workflow/push.js

@@ -6,15 +6,17 @@ Object.defineProperty(exports, "default", {
     enumerable: true,
     get: ()=>WorkflowPush
 });
-const _nodePath = /*#__PURE__*/ _interopRequireWildcard(require("node:path"));
 const _core = require("@oclif/core");
 const _baseCommand = /*#__PURE__*/ _interopRequireDefault(require("../../lib/base-command"));
 const _const = require("../../lib/helpers/const");
 const _error = require("../../lib/helpers/error");
+const _flag = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/helpers/flag"));
 const _object = require("../../lib/helpers/object");
 const _request = require("../../lib/helpers/request");
+const _string = require("../../lib/helpers/string");
+const _ux = require("../../lib/helpers/ux");
 const _workflow = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/marshal/workflow"));
-const _runContext = require("../../lib/run-context");
+const _validate = /*#__PURE__*/ _interopRequireDefault(require("./validate"));
 function _interopRequireDefault(obj) {
     return obj && obj.__esModule ? obj : {
         default: obj
@@ -61,55 +63,57 @@ function _interopRequireWildcard(obj, nodeInterop) {
 }
 class WorkflowPush extends _baseCommand.default {
     async run() {
-        // 1. Retrieve the target workflow directory context.
-        const dirContext = await this.getWorkflowDirContext();
-        this.log(`‣ Reading \`${dirContext.key}\` at ${dirContext.abspath}`);
-        // 2. Read the workflow.json with its template files.
-        const [workflow, errors] = await _workflow.readWorkflowDir(dirContext, {
+        const { flags  } = this.props;
+        // 1. First read all workflow directories found for the given command.
+        const target = await _workflow.ensureValidCommandTarget(this.props, this.runContext);
+        const [workflows, readErrors] = await _workflow.readAllForCommandTarget(target, {
             withExtractedFiles: true
         });
-        if (errors.length > 0) {
-            this.error(`Found the following errors in \`${dirContext.key}\` ${_workflow.WORKFLOW_JSON}\n\n` + (0, _error.formatErrors)(errors));
+        if (readErrors.length > 0) {
+            this.error((0, _error.formatErrors)(readErrors, {
+                prependBy: "\n\n"
+            }));
         }
-        // 3. Push up the compiled workflow data.
-        const resp = await (0, _request.withSpinner)(()=>{
+        if (workflows.length === 0) {
+            this.error(`No workflow directories found in ${target.context.abspath}`);
+        }
+        // 2. Then validate them all ahead of pushing them.
+        _ux.spinner.start(`‣ Validating`);
+        const apiErrors = await _validate.default.validateAll(this.apiV1, this.props, workflows);
+        if (apiErrors.length > 0) {
+            this.error((0, _error.formatErrors)(apiErrors, {
+                prependBy: "\n\n"
+            }));
+        }
+        _ux.spinner.stop();
+        // 3. Finally push up each workflow, abort on the first error.
+        _ux.spinner.start(`‣ Pushing`);
+        for (const workflow of workflows){
             const props = (0, _object.merge)(this.props, {
-                args: {
-                    workflowKey: dirContext.key
-                },
                 flags: {
                     annotate: true
                 }
             });
-            return this.apiV1.upsertWorkflow(props, workflow);
-        });
-        // 4. Update the workflow directory with the successfully pushed workflow
-        // payload from the server.
-        await _workflow.writeWorkflowDirFromData(dirContext, resp.data.workflow);
-        this.log(`‣ Successfully pushed \`${dirContext.key}\`, and updated ${dirContext.abspath}`);
-    }
-    async getWorkflowDirContext() {
-        const { workflowKey  } = this.props.args;
-        const { resourceDir , cwd: runCwd  } = this.runContext;
-        if (resourceDir) {
-            const target = {
-                commandId: _baseCommand.default.id,
-                type: "workflow",
-                key: workflowKey
-            };
-            return (0, _runContext.ensureResourceDirForTarget)(resourceDir, target);
-        }
-        if (workflowKey) {
-            const dirPath = _nodePath.resolve(runCwd, workflowKey);
-            const exists = await _workflow.isWorkflowDir(dirPath);
-            return exists ? {
-                type: "workflow",
-                key: workflowKey,
-                abspath: dirPath,
-                exists
-            } : this.error(`Cannot locate a workflow directory for \`${workflowKey}\``);
+            // eslint-disable-next-line no-await-in-loop
+            const resp = await this.apiV1.upsertWorkflow(props, {
+                ...workflow.content,
+                key: workflow.key
+            });
+            if ((0, _request.isSuccessResp)(resp)) {
+                // Update the workflow directory with the successfully pushed workflow
+                // payload from the server.
+                // eslint-disable-next-line no-await-in-loop
+                await _workflow.writeWorkflowDirFromData(workflow, resp.data.workflow);
+                continue;
+            }
+            const error = new _error.SourceError((0, _request.formatErrorRespMessage)(resp), _workflow.workflowJsonPath(workflow), "ApiError");
+            this.error((0, _error.formatError)(error));
         }
-        return this.error("Missing 1 required arg:\nworkflowKey");
+        _ux.spinner.stop();
+        // 4. Display a success message.
+        const workflowKeys = workflows.map((w)=>w.key);
+        const actioned = flags.commit ? "pushed and committed" : "pushed";
+        this.log(`‣ Successfully ${actioned} ${workflows.length} workflow(s):\n` + (0, _string.indentString)(workflowKeys.join("\n"), 4));
     }
 }
 WorkflowPush.flags = {
@@ -120,6 +124,12 @@ WorkflowPush.flags = {
             _const.KnockEnv.Development
         ]
     }),
+    all: _core.Flags.boolean(),
+    "workflows-dir": _flag.dirPath({
+        dependsOn: [
+            "all"
+        ]
+    }),
     commit: _core.Flags.boolean({
         summary: "Push and commit the workflow(s) at the same time"
     }),

package/dist/commands/workflow/validate.js

@@ -6,15 +6,15 @@ Object.defineProperty(exports, "default", {
     enumerable: true,
     get: ()=>WorkflowValidate
 });
-const _nodePath = /*#__PURE__*/ _interopRequireWildcard(require("node:path"));
 const _core = require("@oclif/core");
 const _baseCommand = /*#__PURE__*/ _interopRequireDefault(require("../../lib/base-command"));
 const _const = require("../../lib/helpers/const");
 const _error = require("../../lib/helpers/error");
-const _object = require("../../lib/helpers/object");
+const _flag = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/helpers/flag"));
 const _request = require("../../lib/helpers/request");
+const _string = require("../../lib/helpers/string");
+const _ux = require("../../lib/helpers/ux");
 const _workflow = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/marshal/workflow"));
-const _runContext = require("../../lib/run-context");
 function _interopRequireDefault(obj) {
     return obj && obj.__esModule ? obj : {
         default: obj
@@ -61,51 +61,46 @@ function _interopRequireWildcard(obj, nodeInterop) {
 }
 class WorkflowValidate extends _baseCommand.default {
     async run() {
-        // 1. Retrieve the target workflow directory context.
-        const dirContext = await this.getWorkflowDirContext();
-        this.log(`‣ Reading \`${dirContext.key}\` at ${dirContext.abspath}`);
-        // 2. Read the workflow.json with its template files.
-        const [workflow, errors] = await _workflow.readWorkflowDir(dirContext, {
+        // 1. Read all workflow directories found for the given command.
+        const target = await _workflow.ensureValidCommandTarget(this.props, this.runContext);
+        const [workflows, readErrors] = await _workflow.readAllForCommandTarget(target, {
             withExtractedFiles: true
         });
-        if (errors.length > 0) {
-            this.error(`Found the following errors in \`${dirContext.key}\` ${_workflow.WORKFLOW_JSON}\n\n` + (0, _error.formatErrors)(errors));
+        if (readErrors.length > 0) {
+            this.error((0, _error.formatErrors)(readErrors, {
+                prependBy: "\n\n"
+            }));
         }
-        // 3. Validate the compiled workflow data.
-        await (0, _request.withSpinner)(()=>{
-            const props = (0, _object.merge)(this.props, {
-                args: {
-                    workflowKey: dirContext.key
-                }
-            });
-            return this.apiV1.validateWorkflow(props, workflow);
-        }, {
-            action: "‣ Validating"
-        });
-        this.log(`‣ Successfully validated \`${dirContext.key}\``);
-    }
-    async getWorkflowDirContext() {
-        const { workflowKey  } = this.props.args;
-        const { resourceDir , cwd: runCwd  } = this.runContext;
-        if (resourceDir) {
-            const target = {
-                commandId: _baseCommand.default.id,
-                type: "workflow",
-                key: workflowKey
-            };
-            return (0, _runContext.ensureResourceDirForTarget)(resourceDir, target);
+        if (workflows.length === 0) {
+            this.error(`No workflow directories found in ${target.context.abspath}`);
         }
-        if (workflowKey) {
-            const dirPath = _nodePath.resolve(runCwd, workflowKey);
-            const exists = await _workflow.isWorkflowDir(dirPath);
-            return exists ? {
-                type: "workflow",
-                key: workflowKey,
-                abspath: dirPath,
-                exists
-            } : this.error(`Cannot locate a workflow directory for \`${workflowKey}\``);
+        // 2. Validate each workflow data.
+        _ux.spinner.start(`‣ Validating`);
+        const apiErrors = await WorkflowValidate.validateAll(this.apiV1, this.props, workflows);
+        if (apiErrors.length > 0) {
+            this.error((0, _error.formatErrors)(apiErrors, {
+                prependBy: "\n\n"
+            }));
         }
-        return this.error("Missing 1 required arg:\nworkflowKey");
+        _ux.spinner.stop();
+        // 3. Display a success message.
+        const workflowKeys = workflows.map((w)=>w.key);
+        this.log(`‣ Successfully validated ${workflows.length} workflow(s):\n` + (0, _string.indentString)(workflowKeys.join("\n"), 4));
+    }
+    static async validateAll(api, props, workflows) {
+        // TODO: Throw an error if a non validation error (e.g. authentication error)
+        // instead of printing out same error messages repeatedly.
+        const errorPromises = workflows.map(async (workflow)=>{
+            const resp = await api.validateWorkflow(props, {
+                ...workflow.content,
+                key: workflow.key
+            });
+            if ((0, _request.isSuccessResp)(resp)) return;
+            const error = new _error.SourceError((0, _request.formatErrorRespMessage)(resp), _workflow.workflowJsonPath(workflow), "ApiError");
+            return error;
+        });
+        const errors = (await Promise.all(errorPromises)).filter((e)=>Boolean(e));
+        return errors;
     }
 }
 WorkflowValidate.flags = {
@@ -115,6 +110,12 @@ WorkflowValidate.flags = {
         options: [
             _const.KnockEnv.Development
         ]
+    }),
+    all: _core.Flags.boolean(),
+    "workflows-dir": _flag.dirPath({
+        dependsOn: [
+            "all"
+        ]
     })
 };
 WorkflowValidate.args = [

package/dist/lib/api-v1.js

@@ -20,6 +20,9 @@ class ApiV1 {
     async ping() {
         return this.get("/ping");
     }
+    async whoami() {
+        return this.get("/whoami");
+    }
     // By resources: Workflows
     async listWorkflows({ flags  }) {
         const params = (0, _object.prune)({
@@ -42,7 +45,7 @@ class ApiV1 {
             params
         });
     }
-    async upsertWorkflow({ args , flags  }, workflow) {
+    async upsertWorkflow({ flags  }, workflow) {
         const params = (0, _object.prune)({
             environment: flags.environment,
             annotate: flags.annotate,
@@ -52,18 +55,18 @@ class ApiV1 {
         const data = {
             workflow
         };
-        return this.put(`/workflows/${args.workflowKey}`, data, {
+        return this.put(`/workflows/${workflow.key}`, data, {
             params
         });
     }
-    async validateWorkflow({ args , flags  }, workflow) {
+    async validateWorkflow({ flags  }, workflow) {
         const params = (0, _object.prune)({
             environment: flags.environment
         });
         const data = {
             workflow
         };
-        return this.put(`/workflows/${args.workflowKey}/validate`, data, {
+        return this.put(`/workflows/${workflow.key}/validate`, data, {
             params
         });
     }
@@ -95,16 +98,28 @@ class ApiV1 {
         });
     }
     // By resources: Translations
-    async listTranslations({ flags  }) {
+    async listTranslations({ flags  }, filters = {}) {
         const params = (0, _object.prune)({
             environment: flags.environment,
             hide_uncommitted_changes: flags["hide-uncommitted-changes"],
+            locale_code: filters.localeCode,
+            namespace: filters.namespace,
             ...(0, _page.toPageParams)(flags)
         });
         return this.get("/translations", {
             params
         });
     }
+    async getTranslation({ flags  }, translation) {
+        const params = (0, _object.prune)({
+            environment: flags.environment,
+            hide_uncommitted_changes: flags["hide-uncommitted-changes"],
+            namespace: translation.namespace
+        });
+        return this.get(`/translations/${translation.localeCode}`, {
+            params
+        });
+    }
     async upsertTranslation({ flags  }, translation) {
         const params = (0, _object.prune)({
             environment: flags.environment,

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

@@ -9,6 +9,8 @@ function _export(target, all) {
     });
 }
 _export(exports, {
+    formatLanguage: ()=>formatLanguage,
+    formatRef: ()=>formatRef,
     isValidLocale: ()=>isValidLocale,
     isTranslationDir: ()=>isTranslationDir,
     buildTranslationFileCtx: ()=>buildTranslationFileCtx,
@@ -65,6 +67,11 @@ function _interopRequireWildcard(obj, nodeInterop) {
     }
     return newObj;
 }
+const formatLanguage = (translation)=>{
+    const lang = _localeCodes.default.getByTag(translation.locale_code);
+    return lang.location ? `${lang.name}, ${lang.location}` : lang.name;
+};
+const formatRef = ({ locale_code , namespace  })=>namespace ? `${namespace}.${locale_code}` : locale_code;
 const isValidLocale = (localeCode)=>Boolean(_localeCodes.default.getByTag(localeCode));
 const isTranslationDir = (dirPath)=>{
     const locale = _nodePath.basename(dirPath);
@@ -87,7 +94,8 @@ const parseTranslationRef = (reference)=>{
     // Locale code only (e.g. `en`)
     if (strings.length === 1) {
         return {
-            localeCode: strings[0]
+            localeCode: strings[0],
+            namespace: undefined
         };
     }
     // Locale code prefixed with a namespace (e.g. `admin.en`)
@@ -114,7 +122,7 @@ const ensureValidCommandTarget = async (props, runContext)=>{
     // No translationRef arg, which means --all flag is used.
     if (!args.translationRef) {
         // Targeting all translation files in the current locale directory.
-        if (resourceDirCtx) {
+        if (resourceDirCtx && !flags["translations-dir"]) {
             return {
                 type: "translationDir",
                 context: resourceDirCtx
@@ -135,7 +143,7 @@ const ensureValidCommandTarget = async (props, runContext)=>{
     // From this point on, we have translationRef so parse and validate the format.
     const parsedRef = parseTranslationRef(args.translationRef);
     if (!parsedRef) {
-        return _core.CliUx.ux.error(`Invalid translationRef arg \`${args.translationRef}\`, use valid <locale> or <namespace>.<locale> for namespaced translations`);
+        return _core.CliUx.ux.error(`Invalid translation ref \`${args.translationRef}\`, use valid <locale> or <namespace>.<locale> for namespaced translations`);
     }
     const { localeCode , namespace  } = parsedRef;
     // If we are in the translation dir, make sure the locale matches.

package/dist/lib/marshal/translation/reader.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, "readTranslationFilesForCommandTarget", {
+Object.defineProperty(exports, "readAllForCommandTarget", {
     enumerable: true,
-    get: ()=>readTranslationFilesForCommandTarget
+    get: ()=>readAllForCommandTarget
 });
 const _nodePath = /*#__PURE__*/ _interopRequireWildcard(require("node:path"));
 const _core = require("@oclif/core");
@@ -56,6 +56,9 @@ function _interopRequireWildcard(obj, nodeInterop) {
  * translation file data.
  *
  * Note, it assumes they are valid file paths to translation files.
+ *
+ * TODO: Refactor to take translation file contexts instead of raw file paths,
+ * to keep things consistent with the workflow reader module.
  */ const readTranslationFiles = async (filePaths)=>{
     const translations = [];
     const errors = [];
@@ -69,27 +72,27 @@ function _interopRequireWildcard(obj, nodeInterop) {
         if (readJsonErrors.length > 0) {
             const e = new _error.SourceError((0, _error.formatErrors)(readJsonErrors), abspath);
             errors.push(e);
+            continue;
         }
-        if (content) {
-            translations.push({
-                ref: translationRef,
-                localeCode,
-                namespace,
-                abspath,
-                exists: true,
-                content: JSON.stringify(content)
-            });
-        }
+        translations.push({
+            ref: translationRef,
+            localeCode,
+            namespace,
+            abspath,
+            exists: true,
+            content: JSON.stringify(content)
+        });
     }
     return [
         translations,
         errors
     ];
 };
-const readTranslationFilesForCommandTarget = async (target)=>{
+const readAllForCommandTarget = async (target)=>{
     const { type: targetType , context: targetCtx  } = target;
     if (!targetCtx.exists) {
-        return _core.CliUx.ux.error(`Cannot locate translation file(s) at \`${targetCtx.abspath}\``);
+        const subject = targetType === "translationFile" ? "a translation file at" : "translation files in";
+        return _core.CliUx.ux.error(`Cannot locate ${subject} \`${targetCtx.abspath}\``);
     }
     switch(targetType){
         case "translationFile":

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

@@ -1,3 +1,4 @@
+// Translation payload data from the API.
 "use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true

package/dist/lib/marshal/translation/writer.js

@@ -2,9 +2,15 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, "writeTranslationsIndexDir", {
-    enumerable: true,
-    get: ()=>writeTranslationsIndexDir
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    writeTranslationFile: ()=>writeTranslationFile,
+    writeTranslationFiles: ()=>writeTranslationFiles
 });
 const _nodePath = /*#__PURE__*/ _interopRequireWildcard(require("node:path"));
 const _fsExtra = /*#__PURE__*/ _interopRequireWildcard(require("fs-extra"));
@@ -51,30 +57,36 @@ function _interopRequireWildcard(obj, nodeInterop) {
     }
     return newObj;
 }
-const writeTranslationsIndexDir = async (indexDirCtx, translations)=>{
+const writeTranslationFile = async (translationFileCtx, translation)=>_fsExtra.outputJson(translationFileCtx.abspath, JSON.parse(translation.content), {
+        spaces: _json.DOUBLE_SPACES
+    });
+const writeTranslationFiles = async (targetDirCtx, translations)=>{
     const backupDirPath = _nodePath.resolve(_const.sandboxDir, (0, _lodash.uniqueId)("backup"));
     try {
         // If the index directory already exists, back it up in the temp sandbox
         // before wiping it clean.
-        if (indexDirCtx.exists) {
-            await _fsExtra.copy(indexDirCtx.abspath, backupDirPath);
-            await _fsExtra.remove(indexDirCtx.abspath);
+        if (targetDirCtx.exists) {
+            await _fsExtra.copy(targetDirCtx.abspath, backupDirPath);
+            await _fsExtra.emptyDir(targetDirCtx.abspath);
         }
         // Write given remote translations into the given translations directory path.
         const writeTranslationDirPromises = translations.map(async (translation)=>{
-            const translationDirPath = _nodePath.resolve(indexDirCtx.abspath, translation.locale_code);
-            const translationFileCtx = await (0, _helpers.buildTranslationFileCtx)(translationDirPath, translation.locale_code, translation.namespace);
-            return _fsExtra.outputJson(translationFileCtx.abspath, JSON.parse(translation.content), {
-                spaces: _json.DOUBLE_SPACES
-            });
+            // If TranslationDirContext, then that is the locale directory we want
+            // to write translation files in; otherwise for translations index
+            // directory, we want to nest translation files under each locale dir.
+            const localeDirPath = "key" in targetDirCtx ? targetDirCtx.abspath : _nodePath.resolve(targetDirCtx.abspath, translation.locale_code);
+            const translationFileCtx = await (0, _helpers.buildTranslationFileCtx)(localeDirPath, translation.locale_code, translation.namespace);
+            return writeTranslationFile(translationFileCtx, translation);
         });
         await Promise.all(writeTranslationDirPromises);
     } catch (error) {
         // In case of any error, wipe the index directory that is likely in a bad
         // state then restore the backup if one existed before.
-        await _fsExtra.remove(indexDirCtx.abspath);
-        if (indexDirCtx.exists) {
-            await _fsExtra.copy(backupDirPath, indexDirCtx.abspath);
+        if (targetDirCtx.exists) {
+            await _fsExtra.emptyDir(targetDirCtx.abspath);
+            await _fsExtra.copy(backupDirPath, targetDirCtx.abspath);
+        } else {
+            await _fsExtra.remove(targetDirCtx.abspath);
         }
         throw error;
     } finally{

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

@@ -11,6 +11,7 @@ function _export(target, all) {
 _export(exports, {
     WORKFLOW_JSON: ()=>WORKFLOW_JSON,
     VISUAL_BLOCKS_JSON: ()=>VISUAL_BLOCKS_JSON,
+    workflowJsonPath: ()=>workflowJsonPath,
     FILEPATH_MARKER: ()=>FILEPATH_MARKER,
     FILEPATH_MARKED_RE: ()=>FILEPATH_MARKED_RE,
     validateWorkflowKey: ()=>validateWorkflowKey,
@@ -18,9 +19,11 @@ _export(exports, {
     isWorkflowDir: ()=>isWorkflowDir,
     formatCategories: ()=>formatCategories,
     formatStepSummary: ()=>formatStepSummary,
-    formatStatus: ()=>formatStatus
+    formatStatus: ()=>formatStatus,
+    ensureValidCommandTarget: ()=>ensureValidCommandTarget
 });
 const _nodePath = /*#__PURE__*/ _interopRequireWildcard(require("node:path"));
+const _core = require("@oclif/core");
 const _fsExtra = /*#__PURE__*/ _interopRequireWildcard(require("fs-extra"));
 const _lodash = require("lodash");
 const _string = require("../../helpers/string");
@@ -66,6 +69,7 @@ function _interopRequireWildcard(obj, nodeInterop) {
 }
 const WORKFLOW_JSON = "workflow.json";
 const VISUAL_BLOCKS_JSON = "visual_blocks.json";
+const workflowJsonPath = (workflowDirCtx)=>_nodePath.resolve(workflowDirCtx.abspath, WORKFLOW_JSON);
 const FILEPATH_MARKER = "@";
 const FILEPATH_MARKED_RE = new RegExp(`${FILEPATH_MARKER}$`);
 const validateWorkflowKey = (input)=>{
@@ -77,7 +81,7 @@ const validateWorkflowKey = (input)=>{
     return undefined;
 };
 const lsWorkflowJson = async (dirPath)=>{
-    const workflowJsonPath = _nodePath.join(dirPath, WORKFLOW_JSON);
+    const workflowJsonPath = _nodePath.resolve(dirPath, WORKFLOW_JSON);
     const exists = await _fsExtra.pathExists(workflowJsonPath);
     return exists ? workflowJsonPath : undefined;
 };
@@ -149,3 +153,61 @@ const formatStepSummary = (step)=>{
 const formatStatus = (workflow)=>{
     return workflow.active ? "active" : "inactive";
 };
+const ensureValidCommandTarget = async (props, runContext)=>{
+    const { args , flags  } = props;
+    const { commandId , resourceDir: resourceDirCtx , cwd: runCwd  } = runContext;
+    // If the target resource is a different type than the current resource dir
+    // type, error out.
+    if (resourceDirCtx && resourceDirCtx.type !== "workflow") {
+        return _core.CliUx.ux.error(`Cannot run ${commandId} inside a ${resourceDirCtx.type} directory`);
+    }
+    // Cannot accept both workflow key arg and --all flag.
+    if (flags.all && args.workflowKey) {
+        return _core.CliUx.ux.error(`workflowKey arg \`${args.workflowKey}\` cannot also be provided when using --all`);
+    }
+    // --all flag is given, which means no workflow key arg.
+    if (flags.all) {
+        // If --all flag used inside a workflow directory, then require a workflows
+        // dir path.
+        if (resourceDirCtx && !flags["workflows-dir"]) {
+            return _core.CliUx.ux.error("Missing required flag workflows-dir");
+        }
+        // Targeting all workflow dirs in the workflows index dir.
+        // TODO: Default to the knock project config first if present before cwd.
+        const defaultToCwd = {
+            abspath: runCwd,
+            exists: true
+        };
+        const indexDirCtx = flags["workflows-dir"] || defaultToCwd;
+        return {
+            type: "workflowsIndexDir",
+            context: indexDirCtx
+        };
+    }
+    // Workflow key arg is given, which means no --all flag.
+    if (args.workflowKey) {
+        if (resourceDirCtx && resourceDirCtx.key !== args.workflowKey) {
+            return _core.CliUx.ux.error(`Cannot run ${commandId} \`${args.workflowKey}\` inside another workflow directory:\n${resourceDirCtx.key}`);
+        }
+        const targetDirPath = resourceDirCtx ? resourceDirCtx.abspath : _nodePath.resolve(runCwd, args.workflowKey);
+        const workflowDirCtx = {
+            type: "workflow",
+            key: args.workflowKey,
+            abspath: targetDirPath,
+            exists: await isWorkflowDir(targetDirPath)
+        };
+        return {
+            type: "workflowDir",
+            context: workflowDirCtx
+        };
+    }
+    // From this point on, we have neither a workflow key arg nor --all flag.
+    // If running inside a workflow directory, then use that workflow directory.
+    if (resourceDirCtx) {
+        return {
+            type: "workflowDir",
+            context: resourceDirCtx
+        };
+    }
+    return _core.CliUx.ux.error("Missing 1 required arg:\nworkflowKey");
+};