dotcom-tool-kit 1.0.0-beta.3 → 1.0.0-beta.30

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAoB,MAAM,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAmC,MAAM,YAAY,CAAA;AAYtE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;IACjC,KAAK,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;KAAE,CAAA;IACxD,SAAS,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAA;IAC1D,OAAO,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,SAAS,CAAA;KAAE,CAAA;IAC9E,KAAK,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;KAAE,CAAA;CACzD;AAED,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,KAAK,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IAClC,SAAS,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,CAAA;IACrC,OAAO,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,CAAA;IACxC,KAAK,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;CACnC;AAmBD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,YAAmB,EAAE;;CAAK,GAAG,OAAO,CAAC,WAAW,CAAC,CA0EvG;AAED,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AACvG,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAoB,MAAM,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAmC,MAAM,YAAY,CAAA;AAYtE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;IACjC,KAAK,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;KAAE,CAAA;IACxD,SAAS,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAA;IAC1D,OAAO,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,SAAS,CAAA;KAAE,CAAA;IAC9E,KAAK,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;KAAE,CAAA;CACzD;AAED,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,KAAK,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IAClC,SAAS,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,CAAA;IACrC,OAAO,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,CAAA;IACxC,KAAK,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;CACnC;AAmBD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,YAAmB,EAAE;;CAAK,GAAG,OAAO,CAAC,WAAW,CAAC,CAmFvG;AAED,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AACvG,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA"}

package/lib/config.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadConfig = exports.validateConfig = void 0;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const path_1 = (0, tslib_1.__importDefault)(require("path"));
 const plugin_1 = require("./plugin");
 const conflict_1 = require("./conflict");
 const error_1 = require("@dotcom-tool-kit/error");
@@ -21,38 +21,46 @@ async function asyncFilter(items, predicate) {
     return results.filter(({ keep }) => keep).map(({ item }) => item);
 }
 async function validateConfig(config, { checkInstall = true } = {}) {
-    const hookTaskConflicts = conflict_1.findConflicts(Object.values(config.hookTasks));
-    const hookConflicts = conflict_1.findConflicts(Object.values(config.hooks));
-    const taskConflicts = conflict_1.findConflicts(Object.values(config.tasks));
-    const optionConflicts = conflict_1.findConflicts(Object.values(config.options));
+    const hookTaskConflicts = (0, conflict_1.findConflicts)(Object.values(config.hookTasks));
+    const hookConflicts = (0, conflict_1.findConflicts)(Object.values(config.hooks));
+    const taskConflicts = (0, conflict_1.findConflicts)(Object.values(config.tasks));
+    const optionConflicts = (0, conflict_1.findConflicts)(Object.values(config.options));
+    const definedHookTaskConflicts = hookTaskConflicts.filter((conflict) => {
+        return conflict.conflicting[0].id in config.hooks;
+    });
     let shouldThrow = false;
     const error = new error_1.ToolKitError('There are problems with your Tool Kit configuration.');
     error.details = '';
     if (hookConflicts.length > 0 ||
-        hookTaskConflicts.length > 0 ||
+        definedHookTaskConflicts.length > 0 ||
         taskConflicts.length > 0 ||
         optionConflicts.length > 0) {
         shouldThrow = true;
         if (hookConflicts.length) {
-            error.details += messages_1.formatHookConflicts(hookConflicts);
+            error.details += (0, messages_1.formatHookConflicts)(hookConflicts);
         }
-        if (hookTaskConflicts.length) {
-            error.details += messages_1.formatHookTaskConflicts(hookTaskConflicts);
+        if (definedHookTaskConflicts.length) {
+            error.details += (0, messages_1.formatHookTaskConflicts)(definedHookTaskConflicts);
         }
         if (taskConflicts.length) {
-            error.details += messages_1.formatTaskConflicts(taskConflicts);
+            error.details += (0, messages_1.formatTaskConflicts)(taskConflicts);
         }
         if (optionConflicts.length) {
-            error.details += messages_1.formatOptionConflicts(optionConflicts);
+            error.details += (0, messages_1.formatOptionConflicts)(optionConflicts);
         }
     }
-    const configuredHookTasks = conflict_1.withoutConflicts(Object.values(config.hookTasks));
-    const definedHooks = conflict_1.withoutConflicts(Object.values(config.hooks));
+    const configuredHookTasks = (0, conflict_1.withoutConflicts)(Object.values(config.hookTasks));
+    const definedHooks = (0, conflict_1.withoutConflicts)(Object.values(config.hooks));
     const definedHookIds = new Set(Object.keys(config.hooks));
-    const undefinedHookTasks = configuredHookTasks.filter((hook) => !definedHookIds.has(hook.id));
+    const undefinedHookTasks = configuredHookTasks.filter((hookTask) => {
+        // we only care about undefined hooks that were configured by the app, not default config from plugins
+        const fromApp = hookTask.plugin.root === process.cwd();
+        const hookDefined = definedHookIds.has(hookTask.id);
+        return fromApp && !hookDefined;
+    });
     if (undefinedHookTasks.length > 0) {
         shouldThrow = true;
-        error.details += messages_1.formatUndefinedHookTasks(undefinedHookTasks, Array.from(definedHookIds));
+        error.details += (0, messages_1.formatUndefinedHookTasks)(undefinedHookTasks, Array.from(definedHookIds));
     }
     const missingTasks = configuredHookTasks
         .map((hook) => ({
@@ -62,7 +70,7 @@ async function validateConfig(config, { checkInstall = true } = {}) {
         .filter(({ tasks }) => tasks.length > 0);
     if (missingTasks.length > 0) {
         shouldThrow = true;
-        error.details += messages_1.formatMissingTasks(missingTasks, Object.keys(config.tasks));
+        error.details += (0, messages_1.formatMissingTasks)(missingTasks, Object.keys(config.tasks));
     }
     if (checkInstall) {
         const uninstalledHooks = await asyncFilter(definedHooks, async (Hook) => {
@@ -71,7 +79,7 @@ async function validateConfig(config, { checkInstall = true } = {}) {
         });
         if (uninstalledHooks.length > 0) {
             shouldThrow = true;
-            error.details += messages_1.formatUninstalledHooks(uninstalledHooks);
+            error.details += (0, messages_1.formatUninstalledHooks)(uninstalledHooks);
         }
     }
     if (shouldThrow) {
@@ -82,7 +90,7 @@ async function validateConfig(config, { checkInstall = true } = {}) {
 exports.validateConfig = validateConfig;
 async function loadConfig({ validate = true, checkInstall = true } = {}) {
     // start loading config and child plugins, starting from the consumer app directory
-    const config = await plugin_1.loadPluginConfig({
+    const config = await (0, plugin_1.loadPluginConfig)({
         id: 'app root',
         root: process.cwd()
     }, createConfig());

package/lib/help.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const config_1 = require("./config");
 const messages_1 = require("./messages");
 async function showHelp(hooks) {
-    const config = await config_1.loadConfig({ checkInstall: false });
+    const config = await (0, config_1.loadConfig)();
     if (hooks.length === 0) {
         hooks = Object.keys(config.hooks).sort();
     }
@@ -16,7 +16,7 @@ Tool Kit is modern, maintainable & modular developer tooling for FT.com projects
 ${messages_1.styles.URL('https://github.com/financial-times/dotcom-tool-kit')}
 
 ${messages_1.styles.ruler()}
-${messages_1.styles.dim(hooks.length === 0
+${Object.keys(config.hooks).length === 0 ? `there are no hooks available. you'll need to install plugins that define hooks to be able to run Tool Kit tasks.` : messages_1.styles.dim(hooks.length === 0
         ? 'available hooks'
         : `help for ${hooks.length - missingHooks.length} ${hooks.length - missingHooks.length > 1 ? 'hooks' : 'hook'}`)}:
 `);

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC7D;AAED,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAC5C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsE7D;AAED,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAC5C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,WAAW,CAAA"}

package/lib/index.js

@@ -9,7 +9,7 @@ const config_1 = require("./config");
 const messages_1 = require("./messages");
 async function runTasks(hooks) {
     var _a;
-    const config = await config_1.loadConfig();
+    const config = await (0, config_1.loadConfig)();
     const availableHooks = Object.keys(config.hooks)
         .sort()
         .map((id) => `- ${id}`)
@@ -24,6 +24,7 @@ ${availableHooks}`;
         throw error;
     }
     for (const hook of hooks) {
+        const errors = [];
         if (!config.hookTasks[hook]) {
             console.warn(messages_1.styles.warning(`no task configured for ${hook}: skipping assignment...}`));
             continue;
@@ -36,7 +37,31 @@ ${availableHooks}`;
             // but typescript doesn't, so cast it to any.
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const task = new Task(options);
-            await task.run();
+            try {
+                await task.run();
+            }
+            catch (error) {
+                // allow subsequent hook tasks to run on error
+                errors.push({
+                    hook,
+                    task: id,
+                    error
+                });
+            }
+        }
+        if (errors.length > 0) {
+            const error = new error_1.ToolKitError(`error running tasks for ${messages_1.styles.hook(hook)}`);
+            error.details = errors
+                .map(({ hook, task, error }) => `${messages_1.styles.heading(`${messages_1.styles.task(task)}:`)}
+
+${error.message}${error instanceof error_1.ToolKitError
+                ? `
+
+${error.details}`
+                : ''}`)
+                .join(`\n${messages_1.styles.dim(messages_1.styles.ruler())}\n`);
+            error.exitCode = errors.length + 1;
+            throw error;
         }
     }
 }

package/lib/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAMA,wBAA8B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB1D"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAGA,wBAA8B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA6B1D"}

package/lib/install.js

@@ -2,16 +2,28 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const config_1 = require("./config");
 const error_1 = require("@dotcom-tool-kit/error");
-const isRejected = (result) => result.status === 'rejected';
 async function installHooks() {
-    const config = await config_1.loadConfig({ checkInstall: false });
-    const results = await Promise.allSettled(Object.values(config.hooks).map(async (Hook) => {
+    const config = await (0, config_1.loadConfig)({ checkInstall: false });
+    const tasks = Object.values(config.hooks).map((Hook) => async () => {
         const hook = new Hook();
         if (!(await hook.check())) {
             await hook.install();
         }
-    }));
-    const errors = results.filter(isRejected).map((result) => result.reason);
+    });
+    const errors = [];
+    for (const task of tasks) {
+        try {
+            await task();
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                errors.push(err);
+            }
+            else {
+                throw err;
+            }
+        }
+    }
     if (errors.length) {
         const error = new error_1.ToolKitError('could not automatically install hooks:');
         error.details = errors.map((error) => error.message).join('\n\n');

package/lib/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAA;AAEjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAItD,QAAA,MAAM,CAAC;;;;;;;;;oBASW,MAAM,KAAG,MAAM;sBACb,MAAM,KAAG,MAAM;iBACtB,MAAM;CAClB,CAAA;AAED,OAAO,EAAE,CAAC,IAAI,MAAM,EAAE,CAAA;AAStB,eAAO,MAAM,mBAAmB,cAAe,SAAS,SAAS,CAAC,EAAE,KAAG,MAKE,CAAA;AASzE,eAAO,MAAM,mBAAmB,cAAe,SAAS,SAAS,CAAC,EAAE,KAAG,MAKE,CAAA;AAazE,eAAO,MAAM,uBAAuB,cAAe,SAAS,QAAQ,CAAC,EAAE,KAAG,MAQzE,CAAA;AAOD,eAAO,MAAM,qBAAqB,cAAe,SAAS,aAAa,CAAC,EAAE,KAAG,MAU5E,CAAA;AAMD,eAAO,MAAM,wBAAwB,mBACnB,QAAQ,EAAE,gBACZ,MAAM,EAAE,KACrB,MAOF,CAAA;AAED,eAAO,MAAM,sBAAsB,qBACf,SAAS,EAAE,KAC5B,MAKF,CAAA;AAED,aAAK,OAAO,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAOlD,eAAO,MAAM,kBAAkB,iBACf,OAAO,EAAE,SAChB,MAAM,EAAE,KACd,MAOF,CAAA"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAA;AAEjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAItD,QAAA,MAAM,CAAC;;;;;;;;;oBASW,MAAM,KAAG,MAAM;sBACb,MAAM,KAAG,MAAM;iBACtB,MAAM;CAClB,CAAA;AAED,OAAO,EAAE,CAAC,IAAI,MAAM,EAAE,CAAA;AAStB,eAAO,MAAM,mBAAmB,cAAe,SAAS,SAAS,CAAC,EAAE,KAAG,MAKE,CAAA;AASzE,eAAO,MAAM,mBAAmB,cAAe,SAAS,SAAS,CAAC,EAAE,KAAG,MAKE,CAAA;AAazE,eAAO,MAAM,uBAAuB,cAAe,SAAS,QAAQ,CAAC,EAAE,KAAG,MAQzE,CAAA;AAOD,eAAO,MAAM,qBAAqB,cAAe,SAAS,aAAa,CAAC,EAAE,KAAG,MAU5E,CAAA;AAMD,eAAO,MAAM,wBAAwB,mBACnB,QAAQ,EAAE,gBACZ,MAAM,EAAE,KACrB,MAWF,CAAA;AAED,eAAO,MAAM,sBAAsB,qBACf,SAAS,EAAE,KAC5B,MAKF,CAAA;AAED,aAAK,OAAO,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAOlD,eAAO,MAAM,kBAAkB,iBACf,OAAO,EAAE,SAChB,MAAM,EAAE,KACd,MAOF,CAAA"}

package/lib/messages.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatMissingTasks = exports.formatUninstalledHooks = exports.formatUndefinedHookTasks = exports.formatOptionConflicts = exports.formatHookTaskConflicts = exports.formatHookConflicts = exports.formatTaskConflicts = exports.styles = void 0;
 const tslib_1 = require("tslib");
-const ansi_colors_1 = tslib_1.__importDefault(require("ansi-colors"));
+const ansi_colors_1 = (0, tslib_1.__importDefault)(require("ansi-colors"));
 // consistent styling use cases for terminal colours
 // don't use ansi-colors directly, define a style please
 const s = {
@@ -58,13 +58,15 @@ You must resolve this conflict by providing options in your app's Tool Kit confi
 exports.formatOptionConflicts = formatOptionConflicts;
 const formatPlugin = (plugin) => plugin.id === 'app root' ? s.app('your app') : `plugin ${s.plugin(plugin.id)}`;
 // TODO text similarity "did you mean...?"
-const formatUndefinedHookTasks = (undefinedHooks, definedHooks) => `These hooks don't exist, but are configured to run tasks:
+const formatUndefinedHookTasks = (undefinedHooks, definedHooks) => `Hooks must be defined by a plugin before you can configure a task to run for them. In your Tool Kit configuration you've configured hooks that aren't defined:
 
-${undefinedHooks.map((hook) => `- ${s.hook(hook.id)} assigned by ${formatPlugin(hook.plugin)}`).join('\n')}
+${undefinedHooks.map((hook) => `- ${s.hook(hook.id)}`).join('\n')}
 
-They could be misspelt, or defined by a Tool Kit plugin that isn't used by this app.
+They could be misspelt, or defined by a Tool Kit plugin that isn't installed in this app.
 
-Available hooks are: ${definedHooks.map(s.hook).join(', ')}.
+${definedHooks.length > 0
+    ? `Hooks that are defined and available for tasks are: ${definedHooks.map(s.hook).join(', ')}`
+    : `There are no hooks defined by this app's plugins. You probably need to install some plugins to define hooks.`}.
 `;
 exports.formatUndefinedHookTasks = formatUndefinedHookTasks;
 const formatUninstalledHooks = (uninstalledHooks) => `These hooks aren't installed into your app:

package/lib/plugin.js

@@ -2,18 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadPlugins = exports.loadPlugin = exports.loadPluginConfig = void 0;
 const tslib_1 = require("tslib");
-const import_from_1 = tslib_1.__importDefault(require("import-from"));
-const resolve_from_1 = tslib_1.__importDefault(require("resolve-from"));
-const lodash_mergewith_1 = tslib_1.__importDefault(require("lodash.mergewith"));
+const import_from_1 = (0, tslib_1.__importDefault)(require("import-from"));
+const resolve_from_1 = (0, tslib_1.__importDefault)(require("resolve-from"));
+const lodash_mergewith_1 = (0, tslib_1.__importDefault)(require("lodash.mergewith"));
 const conflict_1 = require("./conflict");
 const rc_file_1 = require("./rc-file");
 async function loadPluginConfig(plugin, config) {
-    const { plugins = [], hooks = {}, options = {} } = await rc_file_1.loadToolKitRC(plugin.root);
+    const { plugins = [], hooks = {}, options = {} } = await (0, rc_file_1.loadToolKitRC)(plugin.root);
     // load any plugins requested by this plugin
     await loadPlugins(plugins, config, plugin);
     // load plugin hook tasks. do this after loading child plugins, so
     // parent hooks get assigned after child hooks and can override them
-    lodash_mergewith_1.default(config.hookTasks, hooks, 
+    (0, lodash_mergewith_1.default)(config.hookTasks, hooks, 
     // handle conflicts between hooks from different plugins
     (existingHookTask, configHookTask, id) => {
         const newHookTask = {
@@ -30,7 +30,7 @@ async function loadPluginConfig(plugin, config) {
         // return a conflict either listing this hook and the siblings,
         // or merging in a previously-generated hook
         if (existingFromSibling) {
-            const conflicting = conflict_1.isConflict(existingHookTask) ? existingHookTask.conflicting : [existingHookTask];
+            const conflicting = (0, conflict_1.isConflict)(existingHookTask) ? existingHookTask.conflicting : [existingHookTask];
             const conflict = {
                 plugin,
                 conflicting: conflicting.concat(newHookTask)
@@ -43,7 +43,7 @@ async function loadPluginConfig(plugin, config) {
     });
     // merge options from this plugin's config with any options we've collected already
     // TODO this is almost the exact same code as for hooks, refactor
-    lodash_mergewith_1.default(config.options, options, (existingOptions, configOptions, id) => {
+    (0, lodash_mergewith_1.default)(config.options, options, (existingOptions, configOptions, id) => {
         const pluginOptions = {
             options: configOptions,
             plugin,
@@ -58,7 +58,7 @@ async function loadPluginConfig(plugin, config) {
         // return a conflict either listing these options and the sibling's,
         // or merging in previously-generated options
         if (existingFromSibling) {
-            const conflicting = conflict_1.isConflict(existingOptions) ? existingOptions.conflicting : [existingOptions];
+            const conflicting = (0, conflict_1.isConflict)(existingOptions) ? existingOptions.conflicting : [existingOptions];
             const conflict = {
                 plugin,
                 conflicting: conflicting.concat(pluginOptions)
@@ -79,8 +79,8 @@ async function loadPlugin(id, config, parent) {
     }
     const root = parent ? parent.root : process.cwd();
     // load plugin relative to the parent plugin
-    const pluginRoot = resolve_from_1.default(root, id);
-    const basePlugin = import_from_1.default(root, id);
+    const pluginRoot = (0, resolve_from_1.default)(root, id);
+    const basePlugin = (0, import_from_1.default)(root, id);
     const plugin = {
         ...basePlugin,
         id,
@@ -89,13 +89,13 @@ async function loadPlugin(id, config, parent) {
     };
     config.plugins[id] = plugin;
     // add plugin tasks to our task registry, handling any conflicts
-    lodash_mergewith_1.default(config.tasks, Object.fromEntries((plugin.tasks || []).map((task) => [task.name, task])), (existingTask, newTask, taskId) => {
+    (0, lodash_mergewith_1.default)(config.tasks, Object.fromEntries((plugin.tasks || []).map((task) => [task.name, task])), (existingTask, newTask, taskId) => {
         newTask.plugin = plugin;
         newTask.id = taskId;
         if (!existingTask) {
             return newTask;
         }
-        const conflicting = conflict_1.isConflict(existingTask) ? existingTask.conflicting : [existingTask];
+        const conflicting = (0, conflict_1.isConflict)(existingTask) ? existingTask.conflicting : [existingTask];
         return {
             plugin,
             conflicting: conflicting.concat(newTask)
@@ -103,13 +103,13 @@ async function loadPlugin(id, config, parent) {
     });
     // add hooks to the registry, handling any conflicts
     // TODO refactor with command conflict handler
-    lodash_mergewith_1.default(config.hooks, plugin.hooks, (existingHook, newHook, hookId) => {
+    (0, lodash_mergewith_1.default)(config.hooks, plugin.hooks, (existingHook, newHook, hookId) => {
         newHook.id = hookId;
         newHook.plugin = plugin;
         if (!existingHook) {
             return newHook;
         }
-        const conflicting = conflict_1.isConflict(existingHook) ? existingHook.conflicting : [existingHook];
+        const conflicting = (0, conflict_1.isConflict)(existingHook) ? existingHook.conflicting : [existingHook];
         return {
             plugin,
             conflicting: conflicting.concat(newHook)

package/lib/rc-file.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadToolKitRC = void 0;
 const cosmiconfig_1 = require("cosmiconfig");
-const explorer = cosmiconfig_1.cosmiconfig('toolkit', { ignoreEmptySearchPlaces: false });
+const explorer = (0, cosmiconfig_1.cosmiconfig)('toolkit', { ignoreEmptySearchPlaces: false });
 async function loadToolKitRC(root) {
     const result = await explorer.search(root);
     if (!result || !result.config)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotcom-tool-kit",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.30",
   "description": "modern, maintainable, modular developer tooling for FT.com projects",
   "author": "FT.com Platforms Team <platforms-team.customer-products@ft.com>",
   "license": "MIT",
@@ -30,8 +30,8 @@
     "ts-node": "^8.10.2"
   },
   "dependencies": {
-    "@dotcom-tool-kit/error": "^1.0.0-beta.3",
-    "@dotcom-tool-kit/wait-for-ok": "^1.0.0-beta.3",
+    "@dotcom-tool-kit/error": "^1.0.0-beta.30",
+    "@dotcom-tool-kit/wait-for-ok": "^1.0.0-beta.30",
     "ansi-colors": "^4.1.1",
     "cosmiconfig": "^7.0.0",
     "import-from": "^3.0.0",
@@ -47,5 +47,8 @@
     "/bin",
     "/lib",
     "/npm-shrinkwrap.json"
-  ]
+  ],
+  "volta": {
+    "extends": "../../package.json"
+  }
 }