@turbo/types 2.7.5-canary.1 → 2.7.5-canary.11

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2025 Vercel, Inc
+Copyright (c) 2026 Vercel, Inc
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/README.md

@@ -4,4 +4,4 @@ TypeScript types for `turbo.json`
 
 ---
 
-For more information about Turborepo, visit [turborepo.com](https://turborepo.com) and follow us on X ([@turborepo](https://x.com/turborepo))!
+For more information about Turborepo, visit [turborepo.dev](https://turborepo.dev) and follow us on X ([@turborepo](https://x.com/turborepo))!

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@turbo/types",
-  "version": "2.7.5-canary.1",
+  "version": "2.7.5-canary.11",
   "description": "Turborepo types",
   "type": "commonjs",
-  "homepage": "https://turborepo.com",
+  "homepage": "https://turborepo.dev",
   "license": "MIT",
   "repository": {
     "type": "git",

package/schemas/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "RawTurboJson",
-  "description": "Configuration schema for turbo.json.\n\nAn object representing the task dependency graph of your project. turbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.com/docs/reference/configuration",
+  "description": "Configuration schema for turbo.json.\n\nAn object representing the task dependency graph of your project. turbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration",
   "type": "object",
   "properties": {
     "$schema": {
@@ -27,7 +27,7 @@
       ]
     },
     "cacheDir": {
-      "description": "Specify the filesystem cache directory.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#cachedir",
+      "description": "Specify the filesystem cache directory.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#cachedir",
       "anyOf": [
         {
           "$ref": "#/definitions/String"
@@ -38,7 +38,7 @@
       ]
     },
     "concurrency": {
-      "description": "Set/limit the maximum concurrency for task execution.\n\nMust be an integer greater than or equal to `1` or a percentage value like `50%`. Use `1` to force serial execution (one task at a time). Use `100%` to use all available logical processors.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#concurrency",
+      "description": "Set/limit the maximum concurrency for task execution.\n\nMust be an integer greater than or equal to `1` or a percentage value like `50%`. Use `1` to force serial execution (one task at a time). Use `100%` to use all available logical processors.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#concurrency",
       "anyOf": [
         {
           "$ref": "#/definitions/String"
@@ -49,7 +49,7 @@
       ]
     },
     "daemon": {
-      "description": "Turborepo runs a background process to pre-calculate some expensive operations. This standalone process (daemon) is a performance optimization, and not required for proper functioning of `turbo`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#daemon",
+      "description": "Turborepo runs a background process to pre-calculate some expensive operations. This standalone process (daemon) is a performance optimization, and not required for proper functioning of `turbo`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#daemon",
       "anyOf": [
         {
           "$ref": "#/definitions/Boolean"
@@ -71,7 +71,7 @@
       ]
     },
     "envMode": {
-      "description": "Turborepo's Environment Modes allow you to control which environment variables are available to a task at runtime.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#envmode",
+      "description": "Turborepo's Environment Modes allow you to control which environment variables are available to a task at runtime.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#envmode",
       "anyOf": [
         {
           "$ref": "#/definitions/EnvMode"
@@ -104,28 +104,28 @@
       ]
     },
     "globalDependencies": {
-      "description": "A list of globs to include in the set of implicit global hash dependencies.\n\nThe contents of these files will be included in the global hashing algorithm and affect the hashes of all tasks.\n\nThis is useful for busting the cache based on: - `.env` files (not in Git) - Any root level file that impacts package tasks that are not represented in the traditional dependency graph (e.g. a root `tsconfig.json`, `jest.config.ts`, `.eslintrc`, etc.)\n\nDocumentation: https://turborepo.com/docs/reference/configuration#globaldependencies",
+      "description": "A list of globs to include in the set of implicit global hash dependencies.\n\nThe contents of these files will be included in the global hashing algorithm and affect the hashes of all tasks.\n\nThis is useful for busting the cache based on: - `.env` files (not in Git) - Any root level file that impacts package tasks that are not represented in the traditional dependency graph (e.g. a root `tsconfig.json`, `jest.config.ts`, `.eslintrc`, etc.)\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#globaldependencies",
       "type": ["array", "null"],
       "items": {
         "$ref": "#/definitions/String"
       }
     },
     "globalEnv": {
-      "description": "A list of environment variables for implicit global hash dependencies.\n\nThe variables included in this list will affect all task hashes.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#globalenv",
+      "description": "A list of environment variables for implicit global hash dependencies.\n\nThe variables included in this list will affect all task hashes.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#globalenv",
       "type": ["array", "null"],
       "items": {
         "$ref": "#/definitions/String"
       }
     },
     "globalPassThroughEnv": {
-      "description": "An allowlist of environment variables that should be made to all tasks, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#globalpassthroughenv",
+      "description": "An allowlist of environment variables that should be made to all tasks, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#globalpassthroughenv",
       "type": ["array", "null"],
       "items": {
         "$ref": "#/definitions/String"
       }
     },
     "noUpdateNotifier": {
-      "description": "When set to `true`, disables the update notification that appears when a new version of `turbo` is available.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#noupdatenotifier",
+      "description": "When set to `true`, disables the update notification that appears when a new version of `turbo` is available.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#noupdatenotifier",
       "anyOf": [
         {
           "$ref": "#/definitions/Boolean"
@@ -136,7 +136,7 @@
       ]
     },
     "remoteCache": {
-      "description": "Configuration options when interfacing with the remote cache.\n\nDocumentation: https://turborepo.com/docs/core-concepts/remote-caching",
+      "description": "Configuration options when interfacing with the remote cache.\n\nDocumentation: https://turborepo.dev/docs/core-concepts/remote-caching",
       "anyOf": [
         {
           "$ref": "#/definitions/RemoteCache"
@@ -158,14 +158,14 @@
       ]
     },
     "tasks": {
-      "description": "An object representing the task dependency graph of your project.\n\nturbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#tasks",
+      "description": "An object representing the task dependency graph of your project.\n\nturbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#tasks",
       "type": ["object", "null"],
       "additionalProperties": {
         "$ref": "#/definitions/Pipeline"
       }
     },
     "ui": {
-      "description": "Enable use of the UI for `turbo`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#ui",
+      "description": "Enable use of the UI for `turbo`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#ui",
       "anyOf": [
         {
           "$ref": "#/definitions/UI"
@@ -237,7 +237,7 @@
       }
     },
     "EnvMode": {
-      "description": "Turborepo's Environment Modes allow you to control which environment variables are available to a task at runtime.\n\n- `strict`: Filter environment variables to only those that are specified in the `env` and `globalEnv` keys in `turbo.json`. - `loose`: Allow all environment variables for the process to be available.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#envmode",
+      "description": "Turborepo's Environment Modes allow you to control which environment variables are available to a task at runtime.\n\n- `strict`: Filter environment variables to only those that are specified in the `env` and `globalEnv` keys in `turbo.json`. - `loose`: Allow all environment variables for the process to be available.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#envmode",
       "oneOf": [
         {
           "description": "Allow all environment variables for the process to be available.",
@@ -262,7 +262,7 @@
       }
     },
     "OutputLogs": {
-      "description": "Output mode for the task.\n\n- `full`: Displays all output - `hash-only`: Show only the hashes of the tasks - `new-only`: Only show output from cache misses - `errors-only`: Only show output from task failures - `none`: Hides all task output\n\nDocumentation: https://turborepo.com/docs/reference/run#--output-logs-option",
+      "description": "Output mode for the task.\n\n- `full`: Displays all output - `hash-only`: Show only the hashes of the tasks - `new-only`: Only show output from cache misses - `errors-only`: Only show output from task failures - `none`: Hides all task output\n\nDocumentation: https://turborepo.dev/docs/reference/run#--output-logs-option",
       "oneOf": [
         {
           "description": "Displays all output.",
@@ -324,7 +324,7 @@
       "type": "object",
       "properties": {
         "cache": {
-          "description": "Whether or not to cache the outputs of the task.\n\nSetting cache to false is useful for long-running \"watch\" or development mode tasks.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#cache",
+          "description": "Whether or not to cache the outputs of the task.\n\nSetting cache to false is useful for long-running \"watch\" or development mode tasks.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#cache",
           "anyOf": [
             {
               "$ref": "#/definitions/Boolean"
@@ -335,7 +335,7 @@
           ]
         },
         "dependsOn": {
-          "description": "The list of tasks that this task depends on.\n\nPrefixing an item in `dependsOn` with a `^` prefix tells turbo that this task depends on the package's topological dependencies completing the task first. Items without a `^` prefix express the relationships between tasks within the same package.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#dependson",
+          "description": "The list of tasks that this task depends on.\n\nPrefixing an item in `dependsOn` with a `^` prefix tells turbo that this task depends on the package's topological dependencies completing the task first. Items without a `^` prefix express the relationships between tasks within the same package.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#dependson",
           "anyOf": [
             {
               "$ref": "#/definitions/Array_of_String"
@@ -345,22 +345,33 @@
             }
           ]
         },
+        "description": {
+          "description": "A human-readable description of what this task does.\n\nThis field is for documentation purposes only and does not affect task execution or caching behavior.",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/String"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "env": {
-          "description": "A list of environment variables that this task depends on.\n\nNote: If you are migrating from a turbo version 1.5 or below, you may be used to prefixing your variables with a `$`. You no longer need to use the `$` prefix.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#env",
+          "description": "A list of environment variables that this task depends on.\n\nNote: If you are migrating from a turbo version 1.5 or below, you may be used to prefixing your variables with a `$`. You no longer need to use the `$` prefix.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#env",
           "type": ["array", "null"],
           "items": {
             "$ref": "#/definitions/String"
           }
         },
         "inputs": {
-          "description": "The set of glob patterns to consider as inputs to this task.\n\nChanges to files covered by these globs will cause a cache miss and the task will be rerun. If a file has been changed that is **not** included in the set of globs, it will not cause a cache miss. If omitted or empty, all files in the package are considered as inputs.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#inputs",
+          "description": "The set of glob patterns to consider as inputs to this task.\n\nChanges to files covered by these globs will cause a cache miss and the task will be rerun. If a file has been changed that is **not** included in the set of globs, it will not cause a cache miss. If omitted or empty, all files in the package are considered as inputs.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#inputs",
           "type": ["array", "null"],
           "items": {
             "$ref": "#/definitions/String"
           }
         },
         "interactive": {
-          "description": "Mark a task as interactive allowing it to receive input from stdin.\n\nInteractive tasks must be marked with `\"cache\": false` as the input they receive from stdin can change the outcome of the task.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#interactive",
+          "description": "Mark a task as interactive allowing it to receive input from stdin.\n\nInteractive tasks must be marked with `\"cache\": false` as the input they receive from stdin can change the outcome of the task.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#interactive",
           "anyOf": [
             {
               "$ref": "#/definitions/Boolean"
@@ -371,7 +382,7 @@
           ]
         },
         "interruptible": {
-          "description": "Label a persistent task as interruptible to allow it to be restarted by `turbo watch`.\n\n`turbo watch` watches for changes to your packages and automatically restarts tasks that are affected. However, if a task is persistent, it will not be restarted by default. To enable restarting persistent tasks, set `interruptible` to `true`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#interruptible",
+          "description": "Label a persistent task as interruptible to allow it to be restarted by `turbo watch`.\n\n`turbo watch` watches for changes to your packages and automatically restarts tasks that are affected. However, if a task is persistent, it will not be restarted by default. To enable restarting persistent tasks, set `interruptible` to `true`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#interruptible",
           "anyOf": [
             {
               "$ref": "#/definitions/Boolean"
@@ -382,7 +393,7 @@
           ]
         },
         "outputLogs": {
-          "description": "Output mode for the task.\n\nDocumentation: https://turborepo.com/docs/reference/run#--output-logs-option",
+          "description": "Output mode for the task.\n\nDocumentation: https://turborepo.dev/docs/reference/run#--output-logs-option",
           "anyOf": [
             {
               "$ref": "#/definitions/OutputLogs"
@@ -393,21 +404,21 @@
           ]
         },
         "outputs": {
-          "description": "The set of glob patterns indicating a task's cacheable filesystem outputs.\n\nTurborepo captures task logs for all tasks. This enables us to cache tasks whose runs produce no artifacts other than logs (such as linters). Logs are always treated as a cacheable artifact and never need to be specified.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#outputs",
+          "description": "The set of glob patterns indicating a task's cacheable filesystem outputs.\n\nTurborepo captures task logs for all tasks. This enables us to cache tasks whose runs produce no artifacts other than logs (such as linters). Logs are always treated as a cacheable artifact and never need to be specified.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#outputs",
           "type": ["array", "null"],
           "items": {
             "$ref": "#/definitions/String"
           }
         },
         "passThroughEnv": {
-          "description": "An allowlist of environment variables that should be made available in this task's environment, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#passthroughenv",
+          "description": "An allowlist of environment variables that should be made available in this task's environment, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#passthroughenv",
           "type": ["array", "null"],
           "items": {
             "$ref": "#/definitions/String"
           }
         },
         "persistent": {
-          "description": "Indicates whether the task exits or not.\n\nSetting `persistent` to `true` tells turbo that this is a long-running task and will ensure that other tasks cannot depend on it.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#persistent",
+          "description": "Indicates whether the task exits or not.\n\nSetting `persistent` to `true` tells turbo that this is a long-running task and will ensure that other tasks cannot depend on it.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#persistent",
           "anyOf": [
             {
               "$ref": "#/definitions/Boolean"
@@ -418,7 +429,7 @@
           ]
         },
         "with": {
-          "description": "A list of tasks that will run alongside this task.\n\nTasks in this list will not be run until completion before this task starts execution.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#with",
+          "description": "A list of tasks that will run alongside this task.\n\nTasks in this list will not be run until completion before this task starts execution.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#with",
           "type": ["array", "null"],
           "items": {
             "$ref": "#/definitions/String"
@@ -427,11 +438,11 @@
       }
     },
     "RemoteCache": {
-      "description": "Configuration options that control how turbo interfaces with the remote cache.\n\nDocumentation: https://turborepo.com/docs/core-concepts/remote-caching",
+      "description": "Configuration options that control how turbo interfaces with the remote cache.\n\nDocumentation: https://turborepo.dev/docs/core-concepts/remote-caching",
       "type": "object",
       "properties": {
         "apiUrl": {
-          "description": "Set endpoint for API calls to the remote cache.\n\nDocumentation: https://turborepo.com/docs/core-concepts/remote-caching#self-hosting",
+          "description": "Set endpoint for API calls to the remote cache.\n\nDocumentation: https://turborepo.dev/docs/core-concepts/remote-caching#self-hosting",
           "anyOf": [
             {
               "$ref": "#/definitions/String"
@@ -442,7 +453,7 @@
           ]
         },
         "enabled": {
-          "description": "Indicates if the remote cache is enabled.\n\nWhen `false`, Turborepo will disable all remote cache operations, even if the repo has a valid token. If `true`, remote caching is enabled, but still requires the user to login and link their repo to a remote cache.\n\nDocumentation: https://turborepo.com/docs/core-concepts/remote-caching",
+          "description": "Indicates if the remote cache is enabled.\n\nWhen `false`, Turborepo will disable all remote cache operations, even if the repo has a valid token. If `true`, remote caching is enabled, but still requires the user to login and link their repo to a remote cache.\n\nDocumentation: https://turborepo.dev/docs/core-concepts/remote-caching",
           "anyOf": [
             {
               "$ref": "#/definitions/Boolean"
@@ -453,7 +464,7 @@
           ]
         },
         "loginUrl": {
-          "description": "Set endpoint for requesting tokens during `turbo login`.\n\nDocumentation: https://turborepo.com/docs/core-concepts/remote-caching#self-hosting",
+          "description": "Set endpoint for requesting tokens during `turbo login`.\n\nDocumentation: https://turborepo.dev/docs/core-concepts/remote-caching#self-hosting",
           "anyOf": [
             {
               "$ref": "#/definitions/String"
@@ -563,7 +574,7 @@
       }
     },
     "UI": {
-      "description": "Enable use of the UI for `turbo`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#ui",
+      "description": "Enable use of the UI for `turbo`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#ui",
       "oneOf": [
         {
           "description": "Use the terminal user interface.",

package/schemas/schema.v1.json

@@ -17,7 +17,7 @@
       "properties": {
         "$schema": {
           "type": "string",
-          "default": "https://turborepo.com/schema.v1.json"
+          "default": "https://turborepo.dev/schema.v1.json"
         },
         "pipeline": {
           "type": "object",
@@ -25,7 +25,7 @@
             "$ref": "#/definitions/PipelineV1",
             "description": "The name of a task that can be executed by turbo. If turbo finds a workspace package with a package.json scripts object with a matching key, it will apply the pipeline task configuration to that npm script during execution."
           },
-          "description": "An object representing the task dependency graph of your project. turbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#tasks",
+          "description": "An object representing the task dependency graph of your project. turbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#tasks",
           "default": {}
         },
         "extends": {
@@ -48,7 +48,7 @@
           "items": {
             "type": "string"
           },
-          "description": "The list of tasks that this task depends on.\n\nPrefixing an item in dependsOn with a ^ prefix tells turbo that this task depends on the package's topological dependencies completing the task first. (e.g. \"A package's build tasks should only run once all of its workspace dependencies have completed their own build commands.\")\n\nItems in dependsOn without a ^ prefix express the relationships between tasks within the same package (e.g. \"A package's test and lint commands depend on its own build being completed first.\")\n\nDocumentation: https://turborepo.com/docs/reference/configuration#dependson",
+          "description": "The list of tasks that this task depends on.\n\nPrefixing an item in dependsOn with a ^ prefix tells turbo that this task depends on the package's topological dependencies completing the task first. (e.g. \"A package's build tasks should only run once all of its workspace dependencies have completed their own build commands.\")\n\nItems in dependsOn without a ^ prefix express the relationships between tasks within the same package (e.g. \"A package's test and lint commands depend on its own build being completed first.\")\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#dependson",
           "default": []
         },
         "env": {
@@ -56,7 +56,7 @@
           "items": {
             "$ref": "#/definitions/EnvWildcardV1"
           },
-          "description": "A list of environment variables that this task depends on.\n\nNote: If you are migrating from a turbo version 1.5 or below, you may be used to prefixing your variables with a $. You no longer need to use the $ prefix. (e.g. $GITHUB_TOKEN → GITHUB_TOKEN)\n\nDocumentation: https://turborepo.com/docs/reference/configuration#env",
+          "description": "A list of environment variables that this task depends on.\n\nNote: If you are migrating from a turbo version 1.5 or below, you may be used to prefixing your variables with a $. You no longer need to use the $ prefix. (e.g. $GITHUB_TOKEN → GITHUB_TOKEN)\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#env",
           "default": []
         },
         "passThroughEnv": {
@@ -71,7 +71,7 @@
               }
             }
           ],
-          "description": "An allowlist of environment variables that should be made available in this task's environment, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#passthroughenv",
+          "description": "An allowlist of environment variables that should be made available in this task's environment, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#passthroughenv",
           "default": null
         },
         "dotEnv": {
@@ -94,12 +94,12 @@
           "items": {
             "type": "string"
           },
-          "description": "The set of glob patterns indicating a task's cacheable filesystem outputs.\n\nTurborepo captures task logs for all tasks. This enables us to cache tasks whose runs produce no artifacts other than logs (such as linters). Logs are always treated as a cacheable artifact and never need to be specified.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#outputs",
+          "description": "The set of glob patterns indicating a task's cacheable filesystem outputs.\n\nTurborepo captures task logs for all tasks. This enables us to cache tasks whose runs produce no artifacts other than logs (such as linters). Logs are always treated as a cacheable artifact and never need to be specified.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#outputs",
           "default": []
         },
         "cache": {
           "type": "boolean",
-          "description": "Whether or not to cache the outputs of the task.\n\nSetting cache to false is useful for long-running \"watch\" or development mode tasks.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#cache",
+          "description": "Whether or not to cache the outputs of the task.\n\nSetting cache to false is useful for long-running \"watch\" or development mode tasks.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#cache",
           "default": true
         },
         "inputs": {
@@ -107,22 +107,22 @@
           "items": {
             "type": "string"
           },
-          "description": "The set of glob patterns to consider as inputs to this task.\n\nChanges to files covered by these globs will cause a cache miss and the task will be rerun.\n\nIf a file has been changed that is **not** included in the set of globs, it will not cause a cache miss.\n\nIf omitted or empty, all files in the package are considered as inputs.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#inputs",
+          "description": "The set of glob patterns to consider as inputs to this task.\n\nChanges to files covered by these globs will cause a cache miss and the task will be rerun.\n\nIf a file has been changed that is **not** included in the set of globs, it will not cause a cache miss.\n\nIf omitted or empty, all files in the package are considered as inputs.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#inputs",
           "default": []
         },
         "outputMode": {
           "$ref": "#/definitions/OutputModeV1",
-          "description": "Output mode for the task.\n\n\"full\": Displays all output\n\n\"hash-only\": Show only the hashes of the tasks\n\n\"new-only\": Only show output from cache misses\n\n\"errors-only\": Only show output from task failures\n\n\"none\": Hides all task output\n\nDocumentation: https://turborepo.com/docs/reference/run#--output-logs-option",
+          "description": "Output mode for the task.\n\n\"full\": Displays all output\n\n\"hash-only\": Show only the hashes of the tasks\n\n\"new-only\": Only show output from cache misses\n\n\"errors-only\": Only show output from task failures\n\n\"none\": Hides all task output\n\nDocumentation: https://turborepo.dev/docs/reference/run#--output-logs-option",
           "default": "full"
         },
         "persistent": {
           "type": "boolean",
-          "description": "Indicates whether the task exits or not. Setting `persistent` to `true` tells turbo that this is a long-running task and will ensure that other tasks cannot depend on it.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#persistent",
+          "description": "Indicates whether the task exits or not. Setting `persistent` to `true` tells turbo that this is a long-running task and will ensure that other tasks cannot depend on it.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#persistent",
           "default": false
         },
         "interactive": {
           "type": "boolean",
-          "description": "Mark a task as interactive allowing it to receive input from stdin. Interactive tasks must be marked with \"cache\": false as the input they receive from stdin can change the outcome of the task.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#interactive",
+          "description": "Mark a task as interactive allowing it to receive input from stdin. Interactive tasks must be marked with \"cache\": false as the input they receive from stdin can change the outcome of the task.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#interactive",
           "default": false
         }
       },
@@ -143,7 +143,7 @@
       "properties": {
         "$schema": {
           "type": "string",
-          "default": "https://turborepo.com/schema.v1.json"
+          "default": "https://turborepo.dev/schema.v1.json"
         },
         "pipeline": {
           "type": "object",
@@ -151,7 +151,7 @@
             "$ref": "#/definitions/PipelineV1",
             "description": "The name of a task that can be executed by turbo. If turbo finds a workspace package with a package.json scripts object with a matching key, it will apply the pipeline task configuration to that npm script during execution."
           },
-          "description": "An object representing the task dependency graph of your project. turbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#tasks",
+          "description": "An object representing the task dependency graph of your project. turbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#tasks",
           "default": {}
         },
         "globalDependencies": {
@@ -159,7 +159,7 @@
           "items": {
             "type": "string"
           },
-          "description": "A list of globs to include in the set of implicit global hash dependencies.\n\nThe contents of these files will be included in the global hashing algorithm and affect the hashes of all tasks.\n\nThis is useful for busting the cache based on:\n\n- .env files (not in Git)\n\n- any root level file that impacts package tasks that are not represented in the traditional dependency graph (e.g. a root tsconfig.json, jest.config.ts, .eslintrc, etc.)\n\nDocumentation: https://turborepo.com/docs/reference/configuration#globaldependencies",
+          "description": "A list of globs to include in the set of implicit global hash dependencies.\n\nThe contents of these files will be included in the global hashing algorithm and affect the hashes of all tasks.\n\nThis is useful for busting the cache based on:\n\n- .env files (not in Git)\n\n- any root level file that impacts package tasks that are not represented in the traditional dependency graph (e.g. a root tsconfig.json, jest.config.ts, .eslintrc, etc.)\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#globaldependencies",
           "default": []
         },
         "globalEnv": {
@@ -167,7 +167,7 @@
           "items": {
             "$ref": "#/definitions/EnvWildcardV1"
           },
-          "description": "A list of environment variables for implicit global hash dependencies.\n\nThe variables included in this list will affect all task hashes.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#globalenv",
+          "description": "A list of environment variables for implicit global hash dependencies.\n\nThe variables included in this list will affect all task hashes.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#globalenv",
           "default": []
         },
         "globalPassThroughEnv": {
@@ -182,7 +182,7 @@
               }
             }
           ],
-          "description": "An allowlist of environment variables that should be made to all tasks, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#globalpassthroughenv",
+          "description": "An allowlist of environment variables that should be made to all tasks, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#globalpassthroughenv",
           "default": null
         },
         "globalDotEnv": {
@@ -202,12 +202,12 @@
         },
         "remoteCache": {
           "$ref": "#/definitions/RemoteCacheV1",
-          "description": "Configuration options that control how turbo interfaces with the remote cache.\n\nDocumentation: https://turborepo.com/docs/core-concepts/remote-caching",
+          "description": "Configuration options that control how turbo interfaces with the remote cache.\n\nDocumentation: https://turborepo.dev/docs/core-concepts/remote-caching",
           "default": {}
         },
         "experimentalUI": {
           "type": "boolean",
-          "description": "Enable use of the new UI for `turbo`\n\nDocumentation: https://turborepo.com/docs/reference/configuration#ui",
+          "description": "Enable use of the new UI for `turbo`\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#ui",
           "default": false
         }
       },
@@ -224,7 +224,7 @@
         },
         "enabled": {
           "type": "boolean",
-          "description": "Indicates if the remote cache is enabled. When `false`, Turborepo will disable all remote cache operations, even if the repo has a valid token. If true, remote caching is enabled, but still requires the user to login and link their repo to a remote cache. Documentation: https://turborepo.com/docs/core-concepts/remote-caching",
+          "description": "Indicates if the remote cache is enabled. When `false`, Turborepo will disable all remote cache operations, even if the repo has a valid token. If true, remote caching is enabled, but still requires the user to login and link their repo to a remote cache. Documentation: https://turborepo.dev/docs/core-concepts/remote-caching",
           "default": true
         }
       },

package/schemas/schema.v2.json

@@ -17,7 +17,7 @@
       "properties": {
         "$schema": {
           "type": "string",
-          "default": "https://turborepo.com/schema.v2.json"
+          "default": "https://turborepo.dev/schema.v2.json"
         },
         "tasks": {
           "type": "object",
@@ -25,7 +25,7 @@
             "$ref": "#/definitions/Pipeline",
             "description": "The name of a task that can be executed by turbo. If turbo finds a workspace package with a package.json scripts object with a matching key, it will apply the pipeline task configuration to that npm script during execution."
           },
-          "description": "An object representing the task dependency graph of your project. turbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#tasks",
+          "description": "An object representing the task dependency graph of your project. turbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#tasks",
           "default": {}
         },
         "globalDependencies": {
@@ -33,7 +33,7 @@
           "items": {
             "type": "string"
           },
-          "description": "A list of globs to include in the set of implicit global hash dependencies.\n\nThe contents of these files will be included in the global hashing algorithm and affect the hashes of all tasks.\n\nThis is useful for busting the cache based on:\n\n- .env files (not in Git)\n\n- any root level file that impacts package tasks that are not represented in the traditional dependency graph (e.g. a root tsconfig.json, jest.config.ts, .eslintrc, etc.)\n\nDocumentation: https://turborepo.com/docs/reference/configuration#globaldependencies",
+          "description": "A list of globs to include in the set of implicit global hash dependencies.\n\nThe contents of these files will be included in the global hashing algorithm and affect the hashes of all tasks.\n\nThis is useful for busting the cache based on:\n\n- .env files (not in Git)\n\n- any root level file that impacts package tasks that are not represented in the traditional dependency graph (e.g. a root tsconfig.json, jest.config.ts, .eslintrc, etc.)\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#globaldependencies",
           "default": []
         },
         "globalEnv": {
@@ -41,7 +41,7 @@
           "items": {
             "$ref": "#/definitions/EnvWildcard"
           },
-          "description": "A list of environment variables for implicit global hash dependencies.\n\nThe variables included in this list will affect all task hashes.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#globalenv",
+          "description": "A list of environment variables for implicit global hash dependencies.\n\nThe variables included in this list will affect all task hashes.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#globalenv",
           "default": []
         },
         "globalPassThroughEnv": {
@@ -56,22 +56,22 @@
               }
             }
           ],
-          "description": "An allowlist of environment variables that should be made to all tasks, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#globalpassthroughenv",
+          "description": "An allowlist of environment variables that should be made to all tasks, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#globalpassthroughenv",
           "default": null
         },
         "remoteCache": {
           "$ref": "#/definitions/RemoteCache",
-          "description": "Configuration options that control how turbo interfaces with the remote cache.\n\nDocumentation: https://turborepo.com/docs/core-concepts/remote-caching",
+          "description": "Configuration options that control how turbo interfaces with the remote cache.\n\nDocumentation: https://turborepo.dev/docs/core-concepts/remote-caching",
           "default": {}
         },
         "ui": {
           "$ref": "#/definitions/UI",
-          "description": "Enable use of the UI for `turbo`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#ui",
+          "description": "Enable use of the UI for `turbo`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#ui",
           "default": "stream"
         },
         "concurrency": {
           "type": "string",
-          "description": "Set/limit the maximum concurrency for task execution. Must be an integer greater than or equal to `1` or a percentage value like `50%`.\n\n - Use `1` to force serial execution (one task at a time).  - Use `100%` to use all available logical processors.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#concurrency",
+          "description": "Set/limit the maximum concurrency for task execution. Must be an integer greater than or equal to `1` or a percentage value like `50%`.\n\n - Use `1` to force serial execution (one task at a time).  - Use `100%` to use all available logical processors.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#concurrency",
           "default": "10"
         },
         "dangerouslyDisablePackageManagerCheck": {
@@ -81,17 +81,17 @@
         },
         "cacheDir": {
           "$ref": "#/definitions/RelativeUnixPath",
-          "description": "Specify the filesystem cache directory.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#cachedir",
+          "description": "Specify the filesystem cache directory.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#cachedir",
           "default": ".turbo/cache"
         },
         "daemon": {
           "type": "boolean",
-          "description": "Turborepo runs a background process to pre-calculate some expensive operations. This standalone process (daemon) is a performance optimization, and not required for proper functioning of `turbo`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#daemon",
+          "description": "Turborepo runs a background process to pre-calculate some expensive operations. This standalone process (daemon) is a performance optimization, and not required for proper functioning of `turbo`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#daemon",
           "default": false
         },
         "envMode": {
           "$ref": "#/definitions/EnvMode",
-          "description": "Turborepo's Environment Modes allow you to control which environment variables are available to a task at runtime:\n\n- `\"strict\"`: Filter environment variables to only those that are specified in the `env` and `globalEnv` keys in `turbo.json`.\n- `\"loose\"`: Allow all environment variables for the process to be available.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#envmode",
+          "description": "Turborepo's Environment Modes allow you to control which environment variables are available to a task at runtime:\n\n- `\"strict\"`: Filter environment variables to only those that are specified in the `env` and `globalEnv` keys in `turbo.json`.\n- `\"loose\"`: Allow all environment variables for the process to be available.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#envmode",
           "default": "strict"
         },
         "boundaries": {
@@ -100,7 +100,7 @@
         },
         "noUpdateNotifier": {
           "type": "boolean",
-          "description": "When set to `true`, disables the update notification that appears when a new version of `turbo` is available.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#noupdatenotifier",
+          "description": "When set to `true`, disables the update notification that appears when a new version of `turbo` is available.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#noupdatenotifier",
           "default": false
         },
         "futureFlags": {
@@ -116,12 +116,16 @@
     "Pipeline": {
       "type": "object",
       "properties": {
+        "description": {
+          "type": "string",
+          "description": "A human-readable description of what this task does.\n\nThis field is for documentation purposes only and does not affect task execution or caching behavior."
+        },
         "dependsOn": {
           "type": "array",
           "items": {
             "type": "string"
           },
-          "description": "The list of tasks that this task depends on.\n\nPrefixing an item in dependsOn with a ^ prefix tells turbo that this task depends on the package's topological dependencies completing the task first. (e.g. \"A package's build tasks should only run once all of its workspace dependencies have completed their own build commands.\")\n\nItems in dependsOn without a ^ prefix express the relationships between tasks within the same package (e.g. \"A package's test and lint commands depend on its own build being completed first.\")\n\nDocumentation: https://turborepo.com/docs/reference/configuration#dependson",
+          "description": "The list of tasks that this task depends on.\n\nPrefixing an item in dependsOn with a ^ prefix tells turbo that this task depends on the package's topological dependencies completing the task first. (e.g. \"A package's build tasks should only run once all of its workspace dependencies have completed their own build commands.\")\n\nItems in dependsOn without a ^ prefix express the relationships between tasks within the same package (e.g. \"A package's test and lint commands depend on its own build being completed first.\")\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#dependson",
           "default": []
         },
         "env": {
@@ -129,7 +133,7 @@
           "items": {
             "$ref": "#/definitions/EnvWildcard"
           },
-          "description": "A list of environment variables that this task depends on.\n\nNote: If you are migrating from a turbo version 1.5 or below, you may be used to prefixing your variables with a $. You no longer need to use the $ prefix. (e.g. $GITHUB_TOKEN → GITHUB_TOKEN)\n\nDocumentation: https://turborepo.com/docs/reference/configuration#env",
+          "description": "A list of environment variables that this task depends on.\n\nNote: If you are migrating from a turbo version 1.5 or below, you may be used to prefixing your variables with a $. You no longer need to use the $ prefix. (e.g. $GITHUB_TOKEN → GITHUB_TOKEN)\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#env",
           "default": []
         },
         "passThroughEnv": {
@@ -144,7 +148,7 @@
               }
             }
           ],
-          "description": "An allowlist of environment variables that should be made available in this task's environment, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#passthroughenv",
+          "description": "An allowlist of environment variables that should be made available in this task's environment, but should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#passthroughenv",
           "default": null
         },
         "outputs": {
@@ -152,12 +156,12 @@
           "items": {
             "type": "string"
           },
-          "description": "The set of glob patterns indicating a task's cacheable filesystem outputs.\n\nTurborepo captures task logs for all tasks. This enables us to cache tasks whose runs produce no artifacts other than logs (such as linters). Logs are always treated as a cacheable artifact and never need to be specified.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#outputs",
+          "description": "The set of glob patterns indicating a task's cacheable filesystem outputs.\n\nTurborepo captures task logs for all tasks. This enables us to cache tasks whose runs produce no artifacts other than logs (such as linters). Logs are always treated as a cacheable artifact and never need to be specified.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#outputs",
           "default": []
         },
         "cache": {
           "type": "boolean",
-          "description": "Whether or not to cache the outputs of the task.\n\nSetting cache to false is useful for long-running \"watch\" or development mode tasks.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#cache",
+          "description": "Whether or not to cache the outputs of the task.\n\nSetting cache to false is useful for long-running \"watch\" or development mode tasks.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#cache",
           "default": true
         },
         "inputs": {
@@ -165,27 +169,27 @@
           "items": {
             "type": "string"
           },
-          "description": "The set of glob patterns to consider as inputs to this task.\n\nChanges to files covered by these globs will cause a cache miss and the task will be rerun.\n\nIf a file has been changed that is **not** included in the set of globs, it will not cause a cache miss.\n\nIf omitted or empty, all files in the package are considered as inputs.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#inputs",
+          "description": "The set of glob patterns to consider as inputs to this task.\n\nChanges to files covered by these globs will cause a cache miss and the task will be rerun.\n\nIf a file has been changed that is **not** included in the set of globs, it will not cause a cache miss.\n\nIf omitted or empty, all files in the package are considered as inputs.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#inputs",
           "default": []
         },
         "outputLogs": {
           "$ref": "#/definitions/OutputLogs",
-          "description": "Output mode for the task.\n\n\"full\": Displays all output\n\n\"hash-only\": Show only the hashes of the tasks\n\n\"new-only\": Only show output from cache misses\n\n\"errors-only\": Only show output from task failures\n\n\"none\": Hides all task output\n\nDocumentation: https://turborepo.com/docs/reference/run#--output-logs-option",
+          "description": "Output mode for the task.\n\n\"full\": Displays all output\n\n\"hash-only\": Show only the hashes of the tasks\n\n\"new-only\": Only show output from cache misses\n\n\"errors-only\": Only show output from task failures\n\n\"none\": Hides all task output\n\nDocumentation: https://turborepo.dev/docs/reference/run#--output-logs-option",
           "default": "full"
         },
         "persistent": {
           "type": "boolean",
-          "description": "Indicates whether the task exits or not. Setting `persistent` to `true` tells turbo that this is a long-running task and will ensure that other tasks cannot depend on it.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#persistent",
+          "description": "Indicates whether the task exits or not. Setting `persistent` to `true` tells turbo that this is a long-running task and will ensure that other tasks cannot depend on it.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#persistent",
           "default": false
         },
         "interactive": {
           "type": "boolean",
-          "description": "Mark a task as interactive allowing it to receive input from stdin. Interactive tasks must be marked with \"cache\": false as the input they receive from stdin can change the outcome of the task.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#interactive",
+          "description": "Mark a task as interactive allowing it to receive input from stdin. Interactive tasks must be marked with \"cache\": false as the input they receive from stdin can change the outcome of the task.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#interactive",
           "default": false
         },
         "interruptible": {
           "type": "boolean",
-          "description": "Label a persistent task as interruptible to allow it to be restarted by `turbo watch`. `turbo watch` watches for changes to your packages and automatically restarts tasks that are affected. However, if a task is persistent, it will not be restarted by default. To enable restarting persistent tasks, set `interruptible` to true.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#interruptible",
+          "description": "Label a persistent task as interruptible to allow it to be restarted by `turbo watch`. `turbo watch` watches for changes to your packages and automatically restarts tasks that are affected. However, if a task is persistent, it will not be restarted by default. To enable restarting persistent tasks, set `interruptible` to true.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#interruptible",
           "default": false
         },
         "with": {
@@ -193,7 +197,7 @@
           "items": {
             "type": "string"
           },
-          "description": "A list of tasks that will run alongside this task.\n\nTasks in this list will not be run until completion before this task starts execution.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#with",
+          "description": "A list of tasks that will run alongside this task.\n\nTasks in this list will not be run until completion before this task starts execution.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#with",
           "default": []
         }
       },
@@ -216,7 +220,7 @@
         },
         "enabled": {
           "type": "boolean",
-          "description": "Indicates if the remote cache is enabled. When `false`, Turborepo will disable all remote cache operations, even if the repo has a valid token. If true, remote caching is enabled, but still requires the user to login and link their repo to a remote cache. Documentation: https://turborepo.com/docs/core-concepts/remote-caching",
+          "description": "Indicates if the remote cache is enabled. When `false`, Turborepo will disable all remote cache operations, even if the repo has a valid token. If true, remote caching is enabled, but still requires the user to login and link their repo to a remote cache. Documentation: https://turborepo.dev/docs/core-concepts/remote-caching",
           "default": true
         },
         "preflight": {
@@ -226,12 +230,12 @@
         },
         "apiUrl": {
           "type": "string",
-          "description": "Set endpoint for API calls to the remote cache. Documentation: https://turborepo.com/docs/core-concepts/remote-caching#self-hosting",
+          "description": "Set endpoint for API calls to the remote cache. Documentation: https://turborepo.dev/docs/core-concepts/remote-caching#self-hosting",
           "default": "https://vercel.com/api"
         },
         "loginUrl": {
           "type": "string",
-          "description": "Set endpoint for requesting tokens during `turbo login`. Documentation: https://turborepo.com/docs/core-concepts/remote-caching#self-hosting",
+          "description": "Set endpoint for requesting tokens during `turbo login`. Documentation: https://turborepo.dev/docs/core-concepts/remote-caching#self-hosting",
           "default": "https://vercel.com"
         },
         "timeout": {
@@ -326,7 +330,7 @@
       "properties": {
         "$schema": {
           "type": "string",
-          "default": "https://turborepo.com/schema.v2.json"
+          "default": "https://turborepo.dev/schema.v2.json"
         },
         "tasks": {
           "type": "object",
@@ -334,7 +338,7 @@
             "$ref": "#/definitions/Pipeline",
             "description": "The name of a task that can be executed by turbo. If turbo finds a workspace package with a package.json scripts object with a matching key, it will apply the pipeline task configuration to that npm script during execution."
           },
-          "description": "An object representing the task dependency graph of your project. turbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.com/docs/reference/configuration#tasks",
+          "description": "An object representing the task dependency graph of your project. turbo interprets these conventions to schedule, execute, and cache the outputs of tasks in your project.\n\nDocumentation: https://turborepo.dev/docs/reference/configuration#tasks",
           "default": {}
         },
         "extends": {

package/src/types/config-v1.ts

@@ -25,7 +25,7 @@ export interface PipelineV1 {
    * same package (e.g. "A package's test and lint commands depend on its own build being
    * completed first.")
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#dependson
+   * Documentation: https://turborepo.dev/docs/reference/configuration#dependson
    *
    * @defaultValue `[]`
    */
@@ -39,7 +39,7 @@ export interface PipelineV1 {
    * You no longer need to use the $ prefix.
    * (e.g. $GITHUB_TOKEN → GITHUB_TOKEN)
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#env
+   * Documentation: https://turborepo.dev/docs/reference/configuration#env
    *
    * @defaultValue `[]`
    */
@@ -50,7 +50,7 @@ export interface PipelineV1 {
    * task's environment, but should not contribute to the task's cache key,
    * e.g. `AWS_SECRET_KEY`.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#passthroughenv
+   * Documentation: https://turborepo.dev/docs/reference/configuration#passthroughenv
    *
    * @defaultValue `null`
    */
@@ -71,7 +71,7 @@ export interface PipelineV1 {
    * produce no artifacts other than logs (such as linters). Logs are always treated as a
    * cacheable artifact and never need to be specified.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#outputs
+   * Documentation: https://turborepo.dev/docs/reference/configuration#outputs
    *
    * @defaultValue `[]`
    */
@@ -82,7 +82,7 @@ export interface PipelineV1 {
    *
    * Setting cache to false is useful for long-running "watch" or development mode tasks.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#cache
+   * Documentation: https://turborepo.dev/docs/reference/configuration#cache
    *
    * @defaultValue `true`
    */
@@ -99,7 +99,7 @@ export interface PipelineV1 {
    *
    * If omitted or empty, all files in the package are considered as inputs.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#inputs
+   * Documentation: https://turborepo.dev/docs/reference/configuration#inputs
    *
    * @defaultValue `[]`
    */
@@ -118,7 +118,7 @@ export interface PipelineV1 {
    *
    * "none": Hides all task output
    *
-   * Documentation: https://turborepo.com/docs/reference/run#--output-logs-option
+   * Documentation: https://turborepo.dev/docs/reference/run#--output-logs-option
    *
    * @defaultValue `"full"`
    */
@@ -129,7 +129,7 @@ export interface PipelineV1 {
    * turbo that this is a long-running task and will ensure that other tasks
    * cannot depend on it.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#persistent
+   * Documentation: https://turborepo.dev/docs/reference/configuration#persistent
    *
    * @defaultValue `false`
    */
@@ -140,7 +140,7 @@ export interface PipelineV1 {
    * Interactive tasks must be marked with "cache": false as the input
    * they receive from stdin can change the outcome of the task.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#interactive
+   * Documentation: https://turborepo.dev/docs/reference/configuration#interactive
    *
    * @defaultValue `false`
    */
@@ -148,14 +148,14 @@ export interface PipelineV1 {
 }
 
 export interface BaseSchemaV1 {
-  /** @defaultValue `https://turborepo.com/schema.v1.json` */
+  /** @defaultValue `https://turborepo.dev/schema.v1.json` */
   $schema?: string;
   /**
    * An object representing the task dependency graph of your project. turbo interprets
    * these conventions to schedule, execute, and cache the outputs of tasks in
    * your project.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#tasks
+   * Documentation: https://turborepo.dev/docs/reference/configuration#tasks
    *
    * @defaultValue `{}`
    */
@@ -201,7 +201,7 @@ export interface RemoteCacheV1 {
    * Indicates if the remote cache is enabled. When `false`, Turborepo will disable
    * all remote cache operations, even if the repo has a valid token. If true, remote caching
    * is enabled, but still requires the user to login and link their repo to a remote cache.
-   * Documentation: https://turborepo.com/docs/core-concepts/remote-caching
+   * Documentation: https://turborepo.dev/docs/core-concepts/remote-caching
    *
    * @defaultValue `true`
    */
@@ -223,7 +223,7 @@ export interface RootSchemaV1 extends BaseSchemaV1 {
    * that are not represented in the traditional dependency graph
    * (e.g. a root tsconfig.json, jest.config.ts, .eslintrc, etc.)
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#globaldependencies
+   * Documentation: https://turborepo.dev/docs/reference/configuration#globaldependencies
    *
    * @defaultValue `[]`
    */
@@ -234,7 +234,7 @@ export interface RootSchemaV1 extends BaseSchemaV1 {
    *
    * The variables included in this list will affect all task hashes.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#globalenv
+   * Documentation: https://turborepo.dev/docs/reference/configuration#globalenv
    *
    * @defaultValue `[]`
    */
@@ -244,7 +244,7 @@ export interface RootSchemaV1 extends BaseSchemaV1 {
    * An allowlist of environment variables that should be made to all tasks, but
    * should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#globalpassthroughenv
+   * Documentation: https://turborepo.dev/docs/reference/configuration#globalpassthroughenv
    *
    * @defaultValue `null`
    */
@@ -261,7 +261,7 @@ export interface RootSchemaV1 extends BaseSchemaV1 {
   /**
    * Configuration options that control how turbo interfaces with the remote cache.
    *
-   * Documentation: https://turborepo.com/docs/core-concepts/remote-caching
+   * Documentation: https://turborepo.dev/docs/core-concepts/remote-caching
    *
    * @defaultValue `{}`
    */
@@ -270,7 +270,7 @@ export interface RootSchemaV1 extends BaseSchemaV1 {
   /**
    * Enable use of the new UI for `turbo`
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#ui
+   * Documentation: https://turborepo.dev/docs/reference/configuration#ui
    *
    * @defaultValue `false`
    */

package/src/types/config-v2.ts

@@ -13,14 +13,14 @@ export type RelativeUnixPath = string;
 export type EnvWildcard = string;
 
 export interface BaseSchema {
-  /** @defaultValue `https://turborepo.com/schema.v2.json` */
+  /** @defaultValue `https://turborepo.dev/schema.v2.json` */
   $schema?: string;
   /**
    * An object representing the task dependency graph of your project. turbo interprets
    * these conventions to schedule, execute, and cache the outputs of tasks in
    * your project.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#tasks
+   * Documentation: https://turborepo.dev/docs/reference/configuration#tasks
    *
    * @defaultValue `{}`
    */
@@ -77,7 +77,7 @@ export interface RootSchema extends BaseSchema {
    * that are not represented in the traditional dependency graph
    * (e.g. a root tsconfig.json, jest.config.ts, .eslintrc, etc.)
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#globaldependencies
+   * Documentation: https://turborepo.dev/docs/reference/configuration#globaldependencies
    *
    * @defaultValue `[]`
    */
@@ -88,7 +88,7 @@ export interface RootSchema extends BaseSchema {
    *
    * The variables included in this list will affect all task hashes.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#globalenv
+   * Documentation: https://turborepo.dev/docs/reference/configuration#globalenv
    *
    * @defaultValue `[]`
    */
@@ -98,7 +98,7 @@ export interface RootSchema extends BaseSchema {
    * An allowlist of environment variables that should be made to all tasks, but
    * should not contribute to the task's cache key, e.g. `AWS_SECRET_KEY`.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#globalpassthroughenv
+   * Documentation: https://turborepo.dev/docs/reference/configuration#globalpassthroughenv
    *
    * @defaultValue `null`
    */
@@ -107,7 +107,7 @@ export interface RootSchema extends BaseSchema {
   /**
    * Configuration options that control how turbo interfaces with the remote cache.
    *
-   * Documentation: https://turborepo.com/docs/core-concepts/remote-caching
+   * Documentation: https://turborepo.dev/docs/core-concepts/remote-caching
    *
    * @defaultValue `{}`
    */
@@ -116,7 +116,7 @@ export interface RootSchema extends BaseSchema {
   /**
    * Enable use of the UI for `turbo`.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#ui
+   * Documentation: https://turborepo.dev/docs/reference/configuration#ui
    *
    * @defaultValue `"stream"`
    */
@@ -128,7 +128,7 @@ export interface RootSchema extends BaseSchema {
    *  - Use `1` to force serial execution (one task at a time).
    *  - Use `100%` to use all available logical processors.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#concurrency
+   * Documentation: https://turborepo.dev/docs/reference/configuration#concurrency
    *
    * @defaultValue `"10"`
    */
@@ -149,7 +149,7 @@ export interface RootSchema extends BaseSchema {
   /**
    * Specify the filesystem cache directory.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#cachedir
+   * Documentation: https://turborepo.dev/docs/reference/configuration#cachedir
    *
    * @defaultValue `".turbo/cache"`
    */
@@ -158,7 +158,7 @@ export interface RootSchema extends BaseSchema {
   /**
    * Turborepo runs a background process to pre-calculate some expensive operations. This standalone process (daemon) is a performance optimization, and not required for proper functioning of `turbo`.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#daemon
+   * Documentation: https://turborepo.dev/docs/reference/configuration#daemon
    *
    * @defaultValue `false`
    */
@@ -170,7 +170,7 @@ export interface RootSchema extends BaseSchema {
    * - `"strict"`: Filter environment variables to only those that are specified in the `env` and `globalEnv` keys in `turbo.json`.
    * - `"loose"`: Allow all environment variables for the process to be available.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#envmode
+   * Documentation: https://turborepo.dev/docs/reference/configuration#envmode
    *
    * @defaultValue `"strict"`
    */
@@ -184,7 +184,7 @@ export interface RootSchema extends BaseSchema {
   /**
    * When set to `true`, disables the update notification that appears when a new version of `turbo` is available.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#noupdatenotifier
+   * Documentation: https://turborepo.dev/docs/reference/configuration#noupdatenotifier
    *
    * @defaultValue `false`
    */
@@ -199,6 +199,14 @@ export interface RootSchema extends BaseSchema {
 }
 
 export interface Pipeline {
+  /**
+   * A human-readable description of what this task does.
+   *
+   * This field is for documentation purposes only and does not affect
+   * task execution or caching behavior.
+   */
+  description?: string;
+
   /**
    * The list of tasks that this task depends on.
    *
@@ -211,7 +219,7 @@ export interface Pipeline {
    * same package (e.g. "A package's test and lint commands depend on its own build being
    * completed first.")
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#dependson
+   * Documentation: https://turborepo.dev/docs/reference/configuration#dependson
    *
    * @defaultValue `[]`
    */
@@ -225,7 +233,7 @@ export interface Pipeline {
    * You no longer need to use the $ prefix.
    * (e.g. $GITHUB_TOKEN → GITHUB_TOKEN)
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#env
+   * Documentation: https://turborepo.dev/docs/reference/configuration#env
    *
    * @defaultValue `[]`
    */
@@ -236,7 +244,7 @@ export interface Pipeline {
    * task's environment, but should not contribute to the task's cache key,
    * e.g. `AWS_SECRET_KEY`.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#passthroughenv
+   * Documentation: https://turborepo.dev/docs/reference/configuration#passthroughenv
    *
    * @defaultValue `null`
    */
@@ -249,7 +257,7 @@ export interface Pipeline {
    * produce no artifacts other than logs (such as linters). Logs are always treated as a
    * cacheable artifact and never need to be specified.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#outputs
+   * Documentation: https://turborepo.dev/docs/reference/configuration#outputs
    *
    * @defaultValue `[]`
    */
@@ -260,7 +268,7 @@ export interface Pipeline {
    *
    * Setting cache to false is useful for long-running "watch" or development mode tasks.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#cache
+   * Documentation: https://turborepo.dev/docs/reference/configuration#cache
    *
    * @defaultValue `true`
    */
@@ -277,7 +285,7 @@ export interface Pipeline {
    *
    * If omitted or empty, all files in the package are considered as inputs.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#inputs
+   * Documentation: https://turborepo.dev/docs/reference/configuration#inputs
    *
    * @defaultValue `[]`
    */
@@ -296,7 +304,7 @@ export interface Pipeline {
    *
    * "none": Hides all task output
    *
-   * Documentation: https://turborepo.com/docs/reference/run#--output-logs-option
+   * Documentation: https://turborepo.dev/docs/reference/run#--output-logs-option
    *
    * @defaultValue `"full"`
    */
@@ -307,7 +315,7 @@ export interface Pipeline {
    * turbo that this is a long-running task and will ensure that other tasks
    * cannot depend on it.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#persistent
+   * Documentation: https://turborepo.dev/docs/reference/configuration#persistent
    *
    * @defaultValue `false`
    */
@@ -318,7 +326,7 @@ export interface Pipeline {
    * Interactive tasks must be marked with "cache": false as the input
    * they receive from stdin can change the outcome of the task.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#interactive
+   * Documentation: https://turborepo.dev/docs/reference/configuration#interactive
    *
    * @defaultValue `false`
    */
@@ -331,7 +339,7 @@ export interface Pipeline {
    * not be restarted by default. To enable restarting persistent tasks, set
    * `interruptible` to true.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#interruptible
+   * Documentation: https://turborepo.dev/docs/reference/configuration#interruptible
    *
    * @defaultValue `false`
    */
@@ -342,7 +350,7 @@ export interface Pipeline {
    *
    * Tasks in this list will not be run until completion before this task starts execution.
    *
-   * Documentation: https://turborepo.com/docs/reference/configuration#with
+   * Documentation: https://turborepo.dev/docs/reference/configuration#with
    *
    * @defaultValue `[]`
    */
@@ -364,7 +372,7 @@ export interface RemoteCache {
    * Indicates if the remote cache is enabled. When `false`, Turborepo will disable
    * all remote cache operations, even if the repo has a valid token. If true, remote caching
    * is enabled, but still requires the user to login and link their repo to a remote cache.
-   * Documentation: https://turborepo.com/docs/core-concepts/remote-caching
+   * Documentation: https://turborepo.dev/docs/core-concepts/remote-caching
    *
    * @defaultValue `true`
    */
@@ -381,14 +389,14 @@ export interface RemoteCache {
   preflight?: boolean;
   /**
    * Set endpoint for API calls to the remote cache.
-   * Documentation: https://turborepo.com/docs/core-concepts/remote-caching#self-hosting
+   * Documentation: https://turborepo.dev/docs/core-concepts/remote-caching#self-hosting
    *
    * @defaultValue `"https://vercel.com/api"`
    */
   apiUrl?: string;
   /**
    * Set endpoint for requesting tokens during `turbo login`.
-   * Documentation: https://turborepo.com/docs/core-concepts/remote-caching#self-hosting
+   * Documentation: https://turborepo.dev/docs/core-concepts/remote-caching#self-hosting
    *
    * @defaultValue `"https://vercel.com"`
    */