Goals

1. Cleaning out all cached artifacts from a repo

Non-goals

?

Background

Turborepo have knowledge on the outputs of tasks. For example, the following turbo.json declares the build outputs for the build task:

{
  "$schema": "https://turborepo.org/schema.json",
  "extends": ["//"],
  "tasks": {
    "build": {
      "outputs": [
        "package.json",
        "dist/**",
        "adapters/**",
        "http/**",
        "observable/**",
        "rpc/**",
        "shared/**",
        "unstable-core-do-not-import/**"
      ]
    }
  }
}

I usually put a clean script in all the repos I work with, since stale outputs can sometime be the culprit of many subtle bugs and issues when debugging. Currently, I need to declare all these artifacts multiple times and keep them in sync. In addition, I need to use cross-platform scripts to ensure it works for all contributors.

I believe it would be neat if turbo could have a built-in way to clean up artifacts, both on a per-task level and on the repo level.

Proposal

Introduce turbo clean:TASK command. Can be used e.g. turbo clean:build to clean all artifacts from the build task, or turbo clean:* to clean from all tasks. It should also work with --filter flag.