docs: replace fspy references with user-friendly language in inputs config

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: branchseer

crates/vite_task_graph/run-config.ts

@@ -30,21 +30,21 @@ export type Task = {
        */
       passThroughEnvs?: Array<string>;
       /**
-       * Input patterns for cache fingerprinting.
+       * Files to include in the cache fingerprint.
        *
-       * - Omitted: defaults to `[{auto: true}]` - infer from file accesses
-       * - Empty array: no inputs, inference disabled
-       * - Glob strings: explicit files to fingerprint
-       * - `{auto: true}`: enable automatic inference via fspy
-       * - Negative globs: exclude files (prefix with `!`)
+       * - Omitted: automatically tracks which files the task reads
+       * - `[]` (empty): disables file tracking entirely
+       * - Glob patterns (e.g. `"src/**"`) select specific files
+       * - `{auto: true}` enables automatic file tracking
+       * - Negative patterns (e.g. `"!dist/**"`) exclude matched files
        *
-       * Globs are relative to the package directory where the task is defined.
+       * Patterns are relative to the package directory.
        */
       inputs?: Array<
         | string
         | {
             /**
-             * Whether automatic file access inference (via fspy) is enabled
+             * Automatically track which files the task reads
              */
             auto: boolean;
           }

crates/vite_task_graph/src/config/mod.rs

@@ -90,12 +90,12 @@ pub struct CacheConfig {
 /// Resolved input configuration for cache fingerprinting.
 ///
 /// This is the normalized form after parsing user config.
-/// - `includes_auto`: Whether automatic inference from fspy is enabled
+/// - `includes_auto`: Whether automatic file tracking is enabled
 /// - `positive_globs`: Glob patterns for files to include (without `!` prefix)
 /// - `negative_globs`: Glob patterns for files to exclude (without `!` prefix)
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Encode, Decode)]
 pub struct ResolvedInputConfig {
-    /// Whether automatic file access inference (via fspy) is enabled
+    /// Whether automatic file tracking is enabled
     pub includes_auto: bool,
 
     /// Positive glob patterns (files to include).

crates/vite_task_graph/src/config/user.rs

@@ -22,7 +22,7 @@ pub enum UserInputEntry {
     Glob(Str),
     /// Auto-inference directive
     Auto {
-        /// Whether automatic file access inference (via fspy) is enabled
+        /// Automatically track which files the task reads
         auto: bool,
     },
 }
@@ -81,15 +81,15 @@ pub struct EnabledCacheConfig {
     /// Environment variable names to be passed to the task without fingerprinting.
     pub pass_through_envs: Option<Vec<Str>>,
 
-    /// Input patterns for cache fingerprinting.
+    /// Files to include in the cache fingerprint.
     ///
-    /// - Omitted: defaults to `[{auto: true}]` - infer from file accesses
-    /// - Empty array: no inputs, inference disabled
-    /// - Glob strings: explicit files to fingerprint
-    /// - `{auto: true}`: enable automatic inference via fspy
-    /// - Negative globs: exclude files (prefix with `!`)
+    /// - Omitted: automatically tracks which files the task reads
+    /// - `[]` (empty): disables file tracking entirely
+    /// - Glob patterns (e.g. `"src/**"`) select specific files
+    /// - `{auto: true}` enables automatic file tracking
+    /// - Negative patterns (e.g. `"!dist/**"`) exclude matched files
     ///
-    /// Globs are relative to the package directory where the task is defined.
+    /// Patterns are relative to the package directory.
     #[serde(default)]
     #[cfg_attr(all(test, not(clippy)), ts(inline))]
     pub inputs: Option<UserInputsConfig>,