Monorepo plugin

core/cli/src/help.ts

@@ -5,6 +5,7 @@ import YAML from 'yaml'
 import $t from 'endent'
 import { CommandTask, OptionsForTask } from '@dotcom-tool-kit/plugin'
 import { ValidConfig } from '@dotcom-tool-kit/config'
+import { runInit } from './init'
 
 const toolKitIntro = s.box(
   $t`
@@ -84,6 +85,8 @@ export default async function showHelp(logger: Logger, commands: string[]): Prom
     commands = Object.keys(config.commandTasks).sort()
   }
 
+  await runInit(logger, config)
+
   logger.info(toolKitIntro)
 
   const definedCommands = commands.filter((command) => config.commandTasks[command])

core/cli/src/init.ts

@@ -16,5 +16,7 @@ export async function runInit(logger: Logger, config: ValidConfig): Promise<void
   const initResults = await loadInitEntrypoints(logger, config)
   const inits = initResults.unwrap('plugin initialisation classes were invalid!')
 
-  await Promise.all(inits.map(async (init) => init.init()))
+  await Promise.all(inits.map(async (init) => init.init({
+    cwd: config.root
+  })))
 }

lib/base/src/init.ts

@@ -2,6 +2,10 @@ import type { Logger } from 'winston'
 import { initSymbol, typeSymbol } from './symbols'
 import { Base } from './base'
 
+export type InitContext = {
+  cwd: string
+}
+
 export abstract class Init extends Base {
   logger: Logger
 
@@ -18,7 +22,7 @@ export abstract class Init extends Base {
     return initSymbol
   }
 
-  abstract init(): Promise<void>
+  abstract init(context: InitContext): Promise<void>
 }
 
 export type InitConstructor = {

lib/schemas/src/tasks.ts

@@ -13,6 +13,7 @@ import { SmokeTestSchema } from './tasks/n-test'
 import { CypressSchema } from './tasks/cypress'
 import { HerokuProductionSchema } from './tasks/heroku-production'
 import { ServerlessRunSchema } from './tasks/serverless-run'
+import { WorkspaceCommandSchema } from './tasks/workspace-command'
 import { z } from 'zod'
 
 export const TaskSchemas = {
@@ -39,7 +40,8 @@ export const TaskSchemas = {
   ServerlessTeardown: z.object({}).describe('Tear down existing serverless functions'),
   TypeScript: TypeScriptSchema,
   UploadAssetsToS3: UploadAssetsToS3Schema,
-  Webpack: WebpackSchema
+  Webpack: WebpackSchema,
+  WorkspaceCommand: WorkspaceCommandSchema
 }
 
 export type TaskOptions = InferSchemaOptions<typeof TaskSchemas>

lib/schemas/src/tasks/workspace-command.ts

@@ -0,0 +1,65 @@
+import { z } from 'zod'
+
+export const WorkspaceCommandSchema = z.object({
+  command: z.string().optional().describe('A specific command to run instead of the command that ran this task.'),
+  packageFilter: z.string().optional().describe('By default, the command will run in every workspace command that has that command assigned to a task. This option is a glob pattern to filter the packages the command will run on. For example, if your workspace has packages in the `plugins` and `lib` folders, set `packageFilter` to `plugins/*` to only run only in the packages in `plugins`.'),
+}).describe(`Runs a Tool Kit command in all workspace packages that have that command. By default, runs the command that was used to run this task.
+
+For example, imagine a monorepo with these \`.toolkitrc.yml\` files:
+
+<details><summary><code>.toolkitrc.yml</code></summary>
+
+~~~yml
+commands:
+  run:local: WorkspaceCommand
+  build:local: WorkspaceCommand
+~~~
+
+</details>
+
+<details><summary><code>packages/api/.toolkitrc.yml</code></summary>
+
+~~~yml
+commands:
+  run:local: Node
+~~~
+
+</details>
+
+<details><summary><code>packages/client/.toolkitrc.yml</code></summary>
+
+~~~yml
+commands:
+  build:local: TypeScript
+~~~
+
+</details>
+
+<details><summary><code>packages/components/.toolkitrc.yml</code></summary>
+
+~~~yml
+commands:
+  build:local: Webpack
+  run:local:
+    Webpack:
+      watch: true
+~~~
+
+</details>
+
+Running \`dotcom-tool-kit run:local\` at the root level will run the \`Node\` task in \`packages/api\` and the \`Webpack\` task in watch mode in \`packages/components\`; running \`dotcom-tool-kit build:local\` will run \`TypeScript\` in \`packages/client\` and \`Webpack\` in \`packages/components\`.
+
+To run a particular command in the workspace instead of dynamically inferring the command from which was run at root level, set the \`command\` option for the task:
+
+~~~yml
+commands:
+  build:ci:
+    WorkspaceCommand:
+      command: build:local
+~~~
+
+`)
+
+export type WorkspaceCommandOptions = z.infer<typeof WorkspaceCommandSchema>
+
+export const Schema = WorkspaceCommandSchema