Inf 08 Turbo

Preconditions

• pnpm-workspace.yaml exists and lists all paths from the packages input
• Each package listed in packages has the task scripts from the tasks input in its own package.json

Workflow

1. Verify each path in the packages input is listed in pnpm-workspace.yaml. If a path is missing, add it to pnpm-workspace.yaml before continuing.

2. Install Turborepo as a root dev dependency:

pnpm add -D turbo -w

3. Create turbo.json at the monorepo root. Include only the task entries listed in the tasks input. For each task, substitute the output glob from outputsMap.<taskName> (omit outputs if outputsMap has no entry for that task):

{
  "$schema": "https://turbo.build/schema.json",
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"]
    },
    "lint": {
      "dependsOn": [],
      "outputs": []
    },
    "typecheck": {
      "dependsOn": ["^build"],
      "outputs": []
    },
    "test": {
      "dependsOn": [],
      "outputs": ["coverage/**"]
    }
  }
}

Remove any task block not present in the tasks input. Replace each outputs value with the corresponding entry from outputsMap — for example, outputsMap.build → ["dist/**"] and outputsMap.test → ["coverage/lcov.info"]. For lint and typecheck, the outputs array stays [] since they produce no cacheable artifacts (unless outputsMap provides values for them).

4. Update root package.json scripts to delegate to Turborepo (add only the tasks from the tasks input):

"lint": "turbo run lint",
"test": "turbo run test",
"build": "turbo run build",
"typecheck": "turbo run typecheck"

5. Run pnpm lint from the monorepo root — verify Turborepo picks up all apps and logs each package's output

6. Run pnpm lint again — verify cache hits appear as cache hit, replaying logs (FULL TURBO)

Error conditions

• E_TASK_CYCLE: Circular dependsOn → remove the cycle; tasks within the same package cannot depend on each other via ^ — only cross-package dependency chains are supported
• E_OUTPUTS_MISSING: Cache invalidates on every run → ensure the outputs glob from outputsMap matches the actual build artifact paths emitted by the compiler

Reference

See docs/project-overview.md → "INF-08 — Monorepo task graph (turbo.json)".