Refactor cache configuration from cacheScripts to flexible cache option

crates/vite_task_bin/tests/e2e_snapshots/fixtures/associate-existing-cache/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/builtin-different-cwd/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/builtin-non-zero-exit/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/cache-disabled/vite-task.json

@@ -1,5 +1,5 @@
 {
-  "cacheScripts": true,
+  "cache": true,
   "tasks": {
     "no-cache-task": {
       "command": "print-file test.txt",

crates/vite_task_bin/tests/e2e_snapshots/fixtures/cache-miss-command-change/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/cache-miss-reasons/vite-task.json

@@ -1,5 +1,5 @@
 {
-  "cacheScripts": true,
+  "cache": true,
   "tasks": {
     "test": {
       "command": "print-file test.txt",

crates/vite_task_bin/tests/e2e_snapshots/fixtures/cache-subcommand/vite-task.json

@@ -1,5 +1,5 @@
 {
-  "cacheScripts": true,
+  "cache": true,
   "tasks": {
     "cached-task": {
       "command": "print-file test.txt",

crates/vite_task_bin/tests/e2e_snapshots/fixtures/colon-in-name/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/e2e-env-test/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/e2e-lint-cache/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/error_cycle_dependency/vite-task.json

@@ -1,5 +1,5 @@
 {
-  "cacheScripts": true,
+  "cache": true,
   "tasks": {
     "task-a": {
       "command": "echo a",

crates/vite_task_bin/tests/e2e_snapshots/fixtures/exec-api/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/exit-codes/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/filter-unmatched/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/individual-cache-for-adt-args/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/individual-cache-for-envs/vite-task.json

@@ -1,5 +1,5 @@
 {
-  "cacheScripts": true,
+  "cache": true,
   "tasks": {
     "hello": {
       "command": "print-env FOO",

crates/vite_task_bin/tests/e2e_snapshots/fixtures/lint-dot-git/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/replay-logs-chronological-order/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/shared-caching-inputs/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/signal-exit/vite-task.json

@@ -1,5 +1,5 @@
 {
-  "cacheScripts": true,
+  "cache": true,
   "tasks": {
     "abort": {
       "command": "node -e \"process.kill(process.pid, 6)\""

crates/vite_task_bin/tests/e2e_snapshots/fixtures/stdin-inheritance/vite-task.json

@@ -1,5 +1,5 @@
 {
-  "cacheScripts": true,
+  "cache": true,
   "tasks": {
     "read-stdin": {
       "command": "read-stdin",

crates/vite_task_bin/tests/e2e_snapshots/fixtures/stdio-detection/vite-task.json

@@ -1,5 +1,5 @@
 {
-  "cacheScripts": true,
+  "cache": true,
   "tasks": {
     "check-tty": {
       "command": "check-tty",

crates/vite_task_bin/tests/e2e_snapshots/fixtures/stdio-graph-criteria/vite-task.json

@@ -1,5 +1,5 @@
 {
-  "cacheScripts": true,
+  "cache": true,
   "tasks": {
     "check-tty": {
       "command": "check-tty",

crates/vite_task_bin/tests/e2e_snapshots/fixtures/summary-output/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/task-no-trailing-newline/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/topological-execution-order/vite-task.json

@@ -1,3 +1,3 @@
 {
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_bin/tests/e2e_snapshots/fixtures/vite-task-smoke/vite-task.json

@@ -1,4 +1,4 @@
 {
   // Smoke test: enables caching for all package.json scripts.
-  "cacheScripts": true
+  "cache": true
 }

crates/vite_task_graph/run-config.ts

@@ -1,3 +1,27 @@
+export type UserGlobalCacheConfig =
+  | boolean
+  | {
+      /**
+       * Enable caching for package.json scripts not defined in the `tasks` map.
+       *
+       * When `false`, package.json scripts will not be cached.
+       * When `true`, package.json scripts will be cached with default settings.
+       *
+       * Default: `false`
+       */
+      scripts?: boolean;
+      /**
+       * Global cache kill switch for task entries.
+       *
+       * When `false`, overrides all tasks to disable caching, even tasks with `cache: true`.
+       * When `true`, respects each task's individual `cache` setting
+       * (each task's `cache` defaults to `true` if omitted).
+       *
+       * Default: `true`
+       */
+      tasks?: boolean;
+    };
+
 export type Task = {
   /**
    * The command to run for the task.
@@ -38,12 +62,12 @@ export type Task = {
 
 export type RunConfig = {
   /**
-   * Enable cache for all scripts from package.json.
+   * Root-level cache configuration.
    *
    * This option can only be set in the workspace root's config file.
    * Setting it in a package's config will result in an error.
    */
-  cacheScripts?: boolean;
+  cache?: UserGlobalCacheConfig;
   /**
    * Task definitions
    */

crates/vite_task_graph/src/config/mod.rs

@@ -5,7 +5,10 @@ use std::sync::Arc;
 use monostate::MustBe;
 use rustc_hash::FxHashSet;
 use serde::Serialize;
-pub use user::{EnabledCacheConfig, UserCacheConfig, UserRunConfig, UserTaskConfig};
+pub use user::{
+    EnabledCacheConfig, ResolvedGlobalCacheConfig, UserCacheConfig, UserGlobalCacheConfig,
+    UserRunConfig, UserTaskConfig,
+};
 use vite_path::AbsolutePath;
 use vite_str::Str;
 

crates/vite_task_graph/src/config/user.rs

@@ -111,17 +111,78 @@ pub struct UserTaskConfig {
     pub options: UserTaskOptions,
 }
 
+/// Root-level cache configuration.
+///
+/// Controls caching behavior for the entire workspace.
+///
+/// - `true` is equivalent to `{ scripts: true, tasks: true }` — enables caching for both
+///   package.json scripts and task entries.
+/// - `false` is equivalent to `{ scripts: false, tasks: false }` — disables all caching.
+/// - When omitted, defaults to `{ scripts: false, tasks: true }`.
+///
+/// This option can only be set in the workspace root's config file.
+/// Setting it in a package's config will result in an error.
+#[derive(Debug, Clone, Copy, Deserialize, PartialEq, Eq)]
+// TS derive macro generates code using std types that clippy disallows; skip derive during linting
+#[cfg_attr(all(test, not(clippy)), derive(TS), ts(optional_fields))]
+#[serde(untagged, deny_unknown_fields)]
+pub enum UserGlobalCacheConfig {
+    Bool(bool),
+    /// Detailed cache configuration with separate control for scripts and tasks.
+    Detailed {
+        /// Enable caching for package.json scripts not defined in the `tasks` map.
+        ///
+        /// When `false`, package.json scripts will not be cached.
+        /// When `true`, package.json scripts will be cached with default settings.
+        ///
+        /// Default: `false`
+        scripts: Option<bool>,
+
+        /// Global cache kill switch for task entries.
+        ///
+        /// When `false`, overrides all tasks to disable caching, even tasks with `cache: true`.
+        /// When `true`, respects each task's individual `cache` setting
+        /// (each task's `cache` defaults to `true` if omitted).
+        ///
+        /// Default: `true`
+        tasks: Option<bool>,
+    },
+}
+
+/// Resolved global cache configuration with concrete boolean values.
+pub struct ResolvedGlobalCacheConfig {
+    pub scripts: bool,
+    pub tasks: bool,
+}
+
+impl ResolvedGlobalCacheConfig {
+    /// Resolve from an optional user config, using defaults when `None`.
+    ///
+    /// Default: `{ scripts: false, tasks: true }`
+    #[must_use]
+    pub fn resolve_from(config: Option<&UserGlobalCacheConfig>) -> Self {
+        match config {
+            None => Self { scripts: false, tasks: true },
+            Some(UserGlobalCacheConfig::Bool(true)) => Self { scripts: true, tasks: true },
+            Some(UserGlobalCacheConfig::Bool(false)) => Self { scripts: false, tasks: false },
+            Some(UserGlobalCacheConfig::Detailed { scripts, tasks }) => {
+                Self { scripts: scripts.unwrap_or(false), tasks: tasks.unwrap_or(true) }
+            }
+        }
+    }
+}
+
 /// User configuration structure for `run` field in `vite.config.*`
 #[derive(Debug, Default, Deserialize)]
 // TS derive macro generates code using std types that clippy disallows; skip derive during linting
 #[cfg_attr(all(test, not(clippy)), derive(TS), ts(optional_fields, rename = "RunConfig"))]
 #[serde(rename_all = "camelCase")]
 pub struct UserRunConfig {
-    /// Enable cache for all scripts from package.json.
+    /// Root-level cache configuration.
     ///
     /// This option can only be set in the workspace root's config file.
     /// Setting it in a package's config will result in an error.
-    pub cache_scripts: Option<bool>,
+    pub cache: Option<UserGlobalCacheConfig>,
 
     /// Task definitions
     pub tasks: Option<FxHashMap<Str, UserTaskConfig>>,
@@ -315,4 +376,63 @@ mod tests {
         });
         assert!(serde_json::from_value::<UserCacheConfig>(user_config_json).is_err());
     }
+
+    #[test]
+    fn test_global_cache_bool_true() {
+        let config: UserGlobalCacheConfig = serde_json::from_value(json!(true)).unwrap();
+        assert_eq!(config, UserGlobalCacheConfig::Bool(true));
+        let resolved = ResolvedGlobalCacheConfig::resolve_from(Some(&config));
+        assert!(resolved.scripts);
+        assert!(resolved.tasks);
+    }
+
+    #[test]
+    fn test_global_cache_bool_false() {
+        let config: UserGlobalCacheConfig = serde_json::from_value(json!(false)).unwrap();
+        assert_eq!(config, UserGlobalCacheConfig::Bool(false));
+        let resolved = ResolvedGlobalCacheConfig::resolve_from(Some(&config));
+        assert!(!resolved.scripts);
+        assert!(!resolved.tasks);
+    }
+
+    #[test]
+    fn test_global_cache_detailed_scripts_only() {
+        let config: UserGlobalCacheConfig =
+            serde_json::from_value(json!({ "scripts": true })).unwrap();
+        let resolved = ResolvedGlobalCacheConfig::resolve_from(Some(&config));
+        assert!(resolved.scripts);
+        assert!(resolved.tasks); // defaults to true
+    }
+
+    #[test]
+    fn test_global_cache_detailed_tasks_false() {
+        let config: UserGlobalCacheConfig =
+            serde_json::from_value(json!({ "tasks": false })).unwrap();
+        let resolved = ResolvedGlobalCacheConfig::resolve_from(Some(&config));
+        assert!(!resolved.scripts); // defaults to false
+        assert!(!resolved.tasks);
+    }
+
+    #[test]
+    fn test_global_cache_detailed_both() {
+        let config: UserGlobalCacheConfig =
+            serde_json::from_value(json!({ "scripts": true, "tasks": false })).unwrap();
+        let resolved = ResolvedGlobalCacheConfig::resolve_from(Some(&config));
+        assert!(resolved.scripts);
+        assert!(!resolved.tasks);
+    }
+
+    #[test]
+    fn test_global_cache_none_defaults() {
+        let resolved = ResolvedGlobalCacheConfig::resolve_from(None);
+        assert!(!resolved.scripts); // defaults to false
+        assert!(resolved.tasks); // defaults to true
+    }
+
+    #[test]
+    fn test_global_cache_detailed_unknown_field() {
+        assert!(
+            serde_json::from_value::<UserGlobalCacheConfig>(json!({ "unknown": true })).is_err()
+        );
+    }
 }