@ohos-ports/nx 23.3.0-beta.3 → 24.0.2-beta.0

package/dist/src/utils/versions.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.nxVersion = void 0;
-exports.nxVersion = require('@ohos-ports/nx/package.json').version;
+exports.nxVersion = require('nx/package.json').version;

package/migrations.json

@@ -175,11 +175,6 @@
       "implementation": "./dist/src/migrations/update-22-2-0/add-self-healing-to-gitignore",
       "documentation": "./dist/src/migrations/update-22-2-0/add-self-healing-to-gitignore.md"
     },
-    "23-0-0-consolidate-release-tag-config": {
-      "version": "23.0.0-beta.16",
-      "description": "Consolidates any remaining legacy releaseTag* flat properties into the nested releaseTag object. The flat properties were removed in Nx 23.",
-      "implementation": "./dist/src/migrations/update-23-0-0/consolidate-release-tag-config"
-    },
     "23-0-0-add-migrate-runs-to-git-ignore": {
       "version": "23.0.0-beta.18",
       "description": "Adds .nx/migrate-runs to .gitignore",
@@ -187,9 +182,28 @@
     },
     "23-2-0-set-cache-on-executor-target-defaults": {
       "version": "23.2.0-beta.8",
-      "description": "Sets \"cache\" on some executor-based target defaults whose caching was previously enabled by a target name default, maintaining compatibility with how cacheability resolved before Nx 23. Keys the migration cannot decide are left alone and keep working through a deprecated runtime fallback.",
+      "description": "Sets \"cache\" on some executor-based target defaults whose caching was previously enabled by a target name default, maintaining compatibility with how cacheability resolved before Nx 23. Keys the migration cannot decide are left alone, and the targets resolving through them need \"cache\" set by hand.",
       "implementation": "./dist/src/migrations/update-23-2-0/set-cache-on-executor-target-defaults",
       "documentation": "./dist/src/migrations/update-23-2-0/set-cache-on-executor-target-defaults.md"
+    },
+    "24-0-0-move-custom-hashers-to-inputs": {
+      "version": "24.0.0-beta.0",
+      "description": "Finds local executors that declare a custom hasher, which is deprecated and will be removed in Nx 25. Rewriting a hasher as target inputs means reading what its code hashes, so the rewrite is driven by an AI prompt; the generator only reports each hasher.",
+      "implementation": "./dist/src/migrations/update-24-0-0/find-custom-hashers",
+      "prompt": "./dist/src/migrations/update-24-0-0/move-custom-hashers-to-inputs.md",
+      "documentation": "./dist/src/migrations/update-24-0-0/find-custom-hashers.md"
+    },
+    "24-0-0-enable-legacy-affected": {
+      "version": "24.0.0-beta.3",
+      "description": "Sets affected.legacy to true in nx.json so nx affected keeps selecting whole projects. Nx 24 selects individual affected tasks by default.",
+      "implementation": "./dist/src/migrations/update-24-0-0/enable-legacy-affected",
+      "documentation": "./dist/src/migrations/update-24-0-0/enable-legacy-affected.md"
+    },
+    "24-0-0-rename-ultracache-ignore-options": {
+      "version": "24.0.0-beta.3",
+      "description": "Renames the ultracache target options \"ignoredReads\" and \"ignoredWrites\" to \"ignoreReads\" and \"ignoreWrites\", and renames .nx/workflows/sandboxing-config.yaml to ultracache-config.yaml with its \"exclude-reads\" and \"exclude-writes\" keys renamed to \"ignore-reads\" and \"ignore-writes\".",
+      "implementation": "./dist/src/migrations/update-24-0-0/rename-ultracache-ignore-options",
+      "documentation": "./dist/src/migrations/update-24-0-0/rename-ultracache-ignore-options.md"
     }
   }
 }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@ohos-ports/nx",
-  "version": "23.3.0-beta.3",
+  "version": "24.0.2-beta.0",
   "private": false,
   "type": "commonjs",
   "description": "The core Nx plugin contains the core functionality of Nx like the project graph, nx commands and task orchestration.",
   "repository": {
     "type": "git",
     "url": "https://github.com/ohos-ports/ohos-ports.git",
-    "directory": "ports/nx/23.3.0"
+    "directory": "ports/nx/24.0.2"
   },
   "files": [
     "dist/bin",
@@ -46,7 +46,7 @@
   "bugs": {
     "url": "https://github.com/ohos-ports/ohos-ports/issues"
   },
-  "homepage": "https://github.com/ohos-ports/ohos-ports/tree/main/ports/nx/23.3.0",
+  "homepage": "https://github.com/ohos-ports/ohos-ports/tree/main/ports/nx/24.0.2",
   "dependencies": {
     "@clack/core": "1.4.3",
     "@clack/prompts": "1.7.0",
@@ -66,7 +66,6 @@
     "bl": "4.1.0",
     "brace-expansion": "5.0.12",
     "buffer": "5.7.1",
-    "bundle-name": "4.1.0",
     "chalk": "4.1.2",
     "cli-cursor": "3.1.0",
     "cli-spinners": "2.6.1",
@@ -74,10 +73,7 @@
     "clone": "1.0.4",
     "color-convert": "2.0.1",
     "color-name": "1.1.4",
-    "default-browser": "5.2.1",
-    "default-browser-id": "5.0.0",
     "defaults": "1.0.4",
-    "define-lazy-prop": "3.0.0",
     "dotenv": "16.4.7",
     "dotenv-expand": "12.0.3",
     "ejs": "5.0.1",
@@ -93,14 +89,11 @@
     "get-caller-file": "2.0.5",
     "has-flag": "4.0.0",
     "ieee754": "1.2.1",
-    "ignore": "7.0.6",
+    "ignore": "7.0.12",
     "inherits": "2.0.4",
-    "is-docker": "3.0.0",
     "is-fullwidth-code-point": "3.0.0",
-    "is-inside-container": "1.0.0",
     "is-interactive": "1.0.0",
     "is-unicode-supported": "0.1.0",
-    "is-wsl": "3.1.0",
     "isexe": "2.0.0",
     "json5": "2.2.3",
     "jsonc-parser": "3.3.1",
@@ -112,7 +105,6 @@
     "npm-run-path": "4.0.1",
     "once": "1.4.0",
     "onetime": "5.1.2",
-    "open": "10.1.0",
     "ora": "5.4.1",
     "path-key": "3.1.1",
     "picocolors": "1.1.1",
@@ -120,7 +112,6 @@
     "require-directory": "2.1.1",
     "resolve.exports": "2.0.3",
     "restore-cursor": "3.1.0",
-    "run-applescript": "7.0.0",
     "safe-buffer": "5.2.1",
     "semver": "7.8.5",
     "signal-exit": "3.0.7",
@@ -159,17 +150,16 @@
     }
   },
   "optionalDependencies": {
-    "@nx/nx-darwin-arm64": "23.3.0",
-    "@nx/nx-darwin-x64": "23.3.0",
-    "@nx/nx-freebsd-x64": "23.3.0",
-    "@nx/nx-linux-arm-gnueabihf": "23.3.0",
-    "@nx/nx-linux-arm64-gnu": "23.3.0",
-    "@nx/nx-linux-arm64-musl": "23.3.0",
-    "@nx/nx-linux-x64-gnu": "23.3.0",
-    "@nx/nx-linux-x64-musl": "23.3.0",
-    "@nx/nx-win32-arm64-msvc": "23.3.0",
-    "@nx/nx-win32-x64-msvc": "23.3.0",
-    "@ohos-ports/nx-openharmony-arm64": "23.3.0-beta.0"
+    "@nx/nx-darwin-arm64": "24.0.2",
+    "@nx/nx-darwin-x64": "24.0.2",
+    "@nx/nx-freebsd-x64": "24.0.2",
+    "@nx/nx-linux-arm-gnueabihf": "24.0.2",
+    "@nx/nx-linux-arm64-gnu": "24.0.2",
+    "@nx/nx-linux-arm64-musl": "24.0.2",
+    "@nx/nx-linux-x64-gnu": "24.0.2",
+    "@nx/nx-linux-x64-musl": "24.0.2",
+    "@nx/nx-win32-arm64-msvc": "24.0.2",
+    "@nx/nx-win32-x64-msvc": "24.0.2"
   },
   "nx-migrations": {
     "migrations": "./migrations.json",
@@ -202,6 +192,7 @@
       "@nx/plugin",
       "@nx/react",
       "@nx/react-native",
+      "@nx/rolldown",
       "@nx/rollup",
       "@nx/remix",
       "@nx/rspack",

package/schemas/migrations-schema.json

@@ -85,9 +85,20 @@
         "x-repair-skip": {
           "type": "boolean",
           "description": "Exclude this migration when users run `nx repair`."
+        },
+        "optionalUpdate": {
+          "type": "boolean",
+          "description": "Marks a migration that applies an optional dependency update, such as a major version bump that also rewrites code. `nx migrate --include=required` skips it, and `nx migrate --include=optional` runs it whenever `requires` is met. Requires `requires`, set to the versions the migration updates from."
         }
       },
       "required": ["version"],
+      "if": {
+        "properties": { "optionalUpdate": { "const": true } },
+        "required": ["optionalUpdate"]
+      },
+      "then": {
+        "required": ["requires"]
+      },
       "anyOf": [
         {
           "required": ["implementation"]

package/schemas/nx-schema.json

@@ -15,11 +15,16 @@
       "properties": {
         "defaultBase": {
           "type": "string",
-          "description": "Default based branch used by affected commands."
+          "description": "Default based branch used by affected commands.",
+          "deprecated": "Use the top-level `defaultBase` instead. Support for setting `defaultBase` in `affected` will be removed in Nx 25."
+        },
+        "legacy": {
+          "type": "boolean",
+          "default": false,
+          "description": "Select every task of each affected project, instead of only the tasks whose inputs a change reaches."
         }
       },
-      "additionalProperties": false,
-      "deprecated": "Use `defaultBase` instead. Support for setting `defaultBase` in `affected` will be removed in Nx 20."
+      "additionalProperties": false
     },
     "extends": {
       "type": "string",
@@ -150,7 +155,7 @@
     },
     "useInferencePlugins": {
       "type": "boolean",
-      "description": "Specifies whether to add inference plugins when generating new projects."
+      "description": "When `false`, `nx add` does not update package.json scripts by default and `nx init` uses its legacy setup. Generators ignore this setting and always add their inference plugin."
     },
     "analytics": {
       "type": "boolean",
@@ -424,7 +429,7 @@
       "properties": {
         "createCommits": {
           "type": "boolean",
-          "description": "Whether to automatically create a git commit after each migration runs. Equivalent to the `--create-commits` flag. Defaults to `false`."
+          "description": "Whether to automatically create a git commit after each migration runs. Equivalent to the `--create-commits` flag. Defaults to `true` when the agentic flow runs the migrations in a Git repository, and `false` otherwise."
         },
         "commitPrefix": {
           "type": "string",
@@ -442,7 +447,7 @@
         },
         "useRegistryResolution": {
           "type": "boolean",
-          "description": "Whether nx migrate resolves package versions via the npm registry (faster) instead of a package-manager install. The NX_MIGRATE_USE_REGISTRY_RESOLUTION and the deprecated NX_MIGRATE_SKIP_REGISTRY_FETCH (removed in Nx 24) env vars take precedence over this.",
+          "description": "Whether nx migrate resolves package versions via the npm registry (faster) instead of a package-manager install. The NX_MIGRATE_USE_REGISTRY_RESOLUTION env var takes precedence over this.",
           "default": true
         },
         "agentic": {
@@ -459,7 +464,11 @@
         },
         "validate": {
           "type": "boolean",
-          "description": "Whether to run agent-driven validation after generator-only migrations when the agentic flow is enabled. Equivalent to the `--validate` flag. Defaults to `true` when the agentic flow is enabled."
+          "description": "Whether the AI agent driving a migrate run reviews the changes of generator-only migrations. Equivalent to the `--validate` flag. Defaults to `true`."
+        },
+        "finalValidation": {
+          "type": "boolean",
+          "description": "Whether a migrate run an AI agent drives ends with a final check, where the agent makes sure the projects the run touched still lint, build, and pass their unit tests. Equivalent to the `--final-validation` flag. Defaults to `true`."
         }
       },
       "additionalProperties": false
@@ -615,6 +624,76 @@
     }
   },
   "definitions": {
+    "readyWhen": {
+      "description": "How Nx detects that this continuous target is ready. Dependents opt in with \"waitFor\": \"ready\" on their dependsOn entry. Strings may use the {workspaceRoot}, {projectRoot}, {projectName}, {options.*}, and {env.*} placeholders, resolved against the options and environment the task runs with. A placeholder can list fallbacks, as in {options.port ?? env.PORT ?? 4200}. Set it to null to turn off a check inherited from a plugin or targetDefaults.",
+      "type": "object",
+      "properties": {
+        "...": {
+          "type": "boolean",
+          "const": true,
+          "description": "Merges with the inherited readyWhen instead of replacing it, so { \"...\": true, \"timeout\": 1200000 } keeps an inferred check and only gives it more time. Keys before this token defer to the inherited value; keys after it win."
+        },
+        "url": {
+          "type": "string",
+          "description": "Ready when an HTTP or HTTPS GET gets a status from 200 to 403. A redirect counts as ready and is not followed"
+        },
+        "port": {
+          "type": ["integer", "string"],
+          "minimum": 0,
+          "maximum": 65535,
+          "description": "Ready when a TCP connection to this port succeeds. A string can be a port number, auto, or a placeholder such as {options.port}. With 0 or auto the server picks its port, so Nx runs no check and the target counts as ready once it starts"
+        },
+        "host": {
+          "type": "string",
+          "description": "Host to connect to with port. By default 127.0.0.1 and ::1 are both tried"
+        },
+        "command": {
+          "type": "string",
+          "description": "Ready when this command, run through the shell at the workspace root, exits with code 0. It runs with the environment the task runs with, and the task's options as JSON in NX_TASK_OPTIONS"
+        },
+        "logMatches": {
+          "description": "Ready when every one of these substrings has appeared in the task's output",
+          "oneOf": [
+            { "type": "string" },
+            {
+              "type": "array",
+              "items": { "type": "string" },
+              "minItems": 1
+            }
+          ]
+        },
+        "timeout": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 600000,
+          "description": "Milliseconds to wait for readiness before failing dependents that wait for it. Defaults to 10 minutes"
+        },
+        "interval": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 250,
+          "description": "Milliseconds between probe attempts. Unused by logMatches and signal"
+        },
+        "signal": {
+          "const": true,
+          "description": "Ready when the task reports it, through emitReadySignal from @nx/devkit. The webpack, Rspack, Vite and Rsbuild plugins of Nx report it once their dev server listens"
+        }
+      },
+      "oneOf": [
+        { "required": ["..."] },
+        {
+          "not": { "required": ["..."] },
+          "oneOf": [
+            { "required": ["url"] },
+            { "required": ["port"] },
+            { "required": ["command"] },
+            { "required": ["logMatches"] },
+            { "required": ["signal"] }
+          ]
+        }
+      ],
+      "additionalProperties": false
+    },
     "ownersPattern": {
       "type": "object",
       "properties": {
@@ -668,6 +747,10 @@
               "includeIgnored": {
                 "type": "boolean",
                 "description": "Hash the glob straight from disk instead of the workspace file map, so gitignored or generated files can be inputs. A missing exact path still takes part in the hash. A ! negation only filters includeIgnored matches when it also sets includeIgnored: true."
+              },
+              "always": {
+                "type": "boolean",
+                "description": "Keep the files this input resolves to in the hash even when the task is hashed from its ultracache recording."
               }
             },
             "required": ["fileset"],
@@ -693,11 +776,15 @@
               },
               "dependencies": {
                 "type": "boolean",
-                "description": "Include files belonging to the input for all the project dependencies of this target."
+                "description": "Include files belonging to the input for all the project dependencies of this target. With projects, include them for the dependencies of the selected projects instead of the projects themselves."
               },
               "input": {
                 "type": "string",
                 "description": "The name of the input."
+              },
+              "always": {
+                "type": "boolean",
+                "description": "Keep the files this input resolves to in the hash even when the task is hashed from its ultracache recording."
               }
             },
             "oneOf": [
@@ -705,7 +792,10 @@
                 "required": ["projects", "input"]
               },
               {
-                "required": ["dependencies", "input"]
+                "required": ["dependencies", "input"],
+                "not": {
+                  "required": ["projects"]
+                }
               },
               {
                 "required": ["input"],
@@ -791,6 +881,10 @@
                   "type": "string"
                 },
                 "description": "Denylist of fields to exclude from the hash. Supports dot notation for nested paths."
+              },
+              "always": {
+                "type": "boolean",
+                "description": "Keep the file in the hash even when the task is hashed from its ultracache recording."
               }
             },
             "required": ["json"],
@@ -912,6 +1006,9 @@
         "continuous": {
           "$ref": "#/definitions/targetDefaultsConfig/properties/continuous"
         },
+        "readyWhen": {
+          "$ref": "#/definitions/targetDefaultsConfig/properties/readyWhen"
+        },
         "parallelism": {
           "$ref": "#/definitions/targetDefaultsConfig/properties/parallelism"
         },
@@ -975,6 +1072,9 @@
           "default": false,
           "description": "Whether this target runs continuously until stopped"
         },
+        "readyWhen": {
+          "oneOf": [{ "$ref": "#/definitions/readyWhen" }, { "type": "null" }]
+        },
         "parallelism": {
           "type": "boolean",
           "default": true,
@@ -1021,6 +1121,23 @@
                     "description": "Configuration for params handling.",
                     "enum": ["ignore", "forward"],
                     "default": "ignore"
+                  },
+                  "options": {
+                    "type": "string",
+                    "description": "Whether to forward task options to the dependency target.",
+                    "enum": ["ignore", "forward"],
+                    "default": "ignore"
+                  },
+                  "inputs": {
+                    "type": "boolean",
+                    "description": "Set to false to keep a continuous dependency's inputs out of this target's hash and affected calculation. Has no effect on dependencies that are not continuous.",
+                    "default": true
+                  },
+                  "waitFor": {
+                    "type": "string",
+                    "description": "For a continuous dependency, whether to wait until it has started or until it is ready per its readyWhen. Ignored when the dependency is not continuous or has no readyWhen.",
+                    "enum": ["started", "ready"],
+                    "default": "started"
                   }
                 },
                 "oneOf": [
@@ -1067,14 +1184,19 @@
               "default": "on",
               "description": "How this target's tasks participate. 'on' records IO and lets the recording stand in for the declared inputs and outputs. 'warn' records and reports undeclared reads and writes without applying them. 'error' is reserved for failing the task on an undeclared read or write; until per-target enforcement lands it behaves as 'warn'. 'off' records nothing."
             },
-            "ignoredReads": {
+            "collectStats": {
+              "type": "boolean",
+              "default": false,
+              "description": "Collect successful stat metadata accesses as inputs. Missing-path probes are tracked independently of this setting."
+            },
+            "ignoreReads": {
               "type": "array",
               "items": {
                 "type": "string"
               },
               "description": "Workspace-relative glob patterns for reads excluded from ultracache reports. The first path segment cannot contain '*', and '?', '!', '[', ']' and extglobs are not supported; anchor the pattern to a directory instead of leading with '**'."
             },
-            "ignoredWrites": {
+            "ignoreWrites": {
               "type": "array",
               "items": {
                 "type": "string"

package/schemas/project-schema.json

@@ -102,6 +102,23 @@
                       "description": "Configuration for params handling.",
                       "enum": ["ignore", "forward"],
                       "default": "ignore"
+                    },
+                    "options": {
+                      "type": "string",
+                      "description": "Whether to forward task options to the dependency target.",
+                      "enum": ["ignore", "forward"],
+                      "default": "ignore"
+                    },
+                    "inputs": {
+                      "type": "boolean",
+                      "description": "Set to false to keep a continuous dependency's inputs out of this target's hash and affected calculation. Has no effect on dependencies that are not continuous.",
+                      "default": true
+                    },
+                    "waitFor": {
+                      "type": "string",
+                      "description": "For a continuous dependency, whether to wait until it has started or until it is ready per its readyWhen. Ignored when the dependency is not continuous or has no readyWhen.",
+                      "enum": ["started", "ready"],
+                      "default": "started"
                     }
                   },
                   "oneOf": [
@@ -152,14 +169,19 @@
                 "default": "on",
                 "description": "How this target's tasks participate. 'on' records IO and lets the recording stand in for the declared inputs and outputs. 'warn' records and reports undeclared reads and writes without applying them. 'error' is reserved for failing the task on an undeclared read or write; until per-target enforcement lands it behaves as 'warn'. 'off' records nothing."
               },
-              "ignoredReads": {
+              "collectStats": {
+                "type": "boolean",
+                "default": false,
+                "description": "Collect successful stat metadata accesses as inputs. Missing-path probes are tracked independently of this setting."
+              },
+              "ignoreReads": {
                 "type": "array",
                 "items": {
                   "type": "string"
                 },
                 "description": "Workspace-relative glob patterns for reads excluded from ultracache reports. The first path segment cannot contain '*', and '?', '!', '[', ']' and extglobs are not supported; anchor the pattern to a directory instead of leading with '**'."
               },
-              "ignoredWrites": {
+              "ignoreWrites": {
                 "type": "array",
                 "items": {
                   "type": "string"
@@ -174,6 +196,9 @@
             "default": false,
             "description": "Whether this target runs continuously until stopped"
           },
+          "readyWhen": {
+            "oneOf": [{ "$ref": "#/definitions/readyWhen" }, { "type": "null" }]
+          },
           "parallelism": {
             "type": "boolean",
             "default": true,
@@ -234,6 +259,76 @@
     }
   },
   "definitions": {
+    "readyWhen": {
+      "description": "How Nx detects that this continuous target is ready. Dependents opt in with \"waitFor\": \"ready\" on their dependsOn entry. Strings may use the {workspaceRoot}, {projectRoot}, {projectName}, {options.*}, and {env.*} placeholders, resolved against the options and environment the task runs with. A placeholder can list fallbacks, as in {options.port ?? env.PORT ?? 4200}. Set it to null to turn off a check inherited from a plugin or targetDefaults.",
+      "type": "object",
+      "properties": {
+        "...": {
+          "type": "boolean",
+          "const": true,
+          "description": "Merges with the inherited readyWhen instead of replacing it, so { \"...\": true, \"timeout\": 1200000 } keeps an inferred check and only gives it more time. Keys before this token defer to the inherited value; keys after it win."
+        },
+        "url": {
+          "type": "string",
+          "description": "Ready when an HTTP or HTTPS GET gets a status from 200 to 403. A redirect counts as ready and is not followed"
+        },
+        "port": {
+          "type": ["integer", "string"],
+          "minimum": 0,
+          "maximum": 65535,
+          "description": "Ready when a TCP connection to this port succeeds. A string can be a port number, auto, or a placeholder such as {options.port}. With 0 or auto the server picks its port, so Nx runs no check and the target counts as ready once it starts"
+        },
+        "host": {
+          "type": "string",
+          "description": "Host to connect to with port. By default 127.0.0.1 and ::1 are both tried"
+        },
+        "command": {
+          "type": "string",
+          "description": "Ready when this command, run through the shell at the workspace root, exits with code 0. It runs with the environment the task runs with, and the task's options as JSON in NX_TASK_OPTIONS"
+        },
+        "logMatches": {
+          "description": "Ready when every one of these substrings has appeared in the task's output",
+          "oneOf": [
+            { "type": "string" },
+            {
+              "type": "array",
+              "items": { "type": "string" },
+              "minItems": 1
+            }
+          ]
+        },
+        "timeout": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 600000,
+          "description": "Milliseconds to wait for readiness before failing dependents that wait for it. Defaults to 10 minutes"
+        },
+        "interval": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 250,
+          "description": "Milliseconds between probe attempts. Unused by logMatches and signal"
+        },
+        "signal": {
+          "const": true,
+          "description": "Ready when the task reports it, through emitReadySignal from @nx/devkit. The webpack, Rspack, Vite and Rsbuild plugins of Nx report it once their dev server listens"
+        }
+      },
+      "oneOf": [
+        { "required": ["..."] },
+        {
+          "not": { "required": ["..."] },
+          "oneOf": [
+            { "required": ["url"] },
+            { "required": ["port"] },
+            { "required": ["command"] },
+            { "required": ["logMatches"] },
+            { "required": ["signal"] }
+          ]
+        }
+      ],
+      "additionalProperties": false
+    },
     "inputs": {
       "type": "array",
       "items": {
@@ -255,6 +350,10 @@
               "includeIgnored": {
                 "type": "boolean",
                 "description": "Hash the glob straight from disk instead of the workspace file map, so gitignored or generated files can be inputs. A missing exact path still takes part in the hash. A ! negation only filters includeIgnored matches when it also sets includeIgnored: true."
+              },
+              "always": {
+                "type": "boolean",
+                "description": "Keep the files this input resolves to in the hash even when the task is hashed from its ultracache recording."
               }
             },
             "required": ["fileset"],
@@ -280,11 +379,15 @@
               },
               "dependencies": {
                 "type": "boolean",
-                "description": "Include files belonging to the input for all the project dependencies of this target."
+                "description": "Include files belonging to the input for all the project dependencies of this target. With projects, include them for the dependencies of the selected projects instead of the projects themselves."
               },
               "input": {
                 "type": "string",
                 "description": "The name of the input."
+              },
+              "always": {
+                "type": "boolean",
+                "description": "Keep the files this input resolves to in the hash even when the task is hashed from its ultracache recording."
               }
             },
             "oneOf": [
@@ -292,7 +395,10 @@
                 "required": ["projects", "input"]
               },
               {
-                "required": ["dependencies", "input"]
+                "required": ["dependencies", "input"],
+                "not": {
+                  "required": ["projects"]
+                }
               },
               {
                 "required": ["input"],
@@ -378,6 +484,10 @@
                   "type": "string"
                 },
                 "description": "Denylist of fields to exclude from the hash. Supports dot notation for nested paths."
+              },
+              "always": {
+                "type": "boolean",
+                "description": "Keep the file in the hash even when the task is hashed from its ultracache recording."
               }
             },
             "required": ["json"],