docs(e2e): move output_cache_test comments into toml fields

Follows the convention introduced in main (#347): per-`[[e2e]]` and per-
step descriptions use the TOML `comment` field instead of bare `#` lines,
so they render under the snapshot headings and inside each step's block.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: branchseer

crates/vite_task_bin/tests/e2e_snapshots/fixtures/output_cache_test/snapshots.toml

@@ -1,157 +1,98 @@
-# Test output restoration when cached tasks are replayed
-
-# 1. Auto output detection (default): output files written by the task are restored on cache hit
 [[e2e]]
 name = "auto_output___files_restored_on_cache_hit"
+comment = """
+Auto output detection (default): output files written by the task are
+restored on a cache hit.
+"""
 steps = [
-  # First run - writes dist/out.txt
-  ["vt", "run", "auto-output"],
-  # Verify output exists
-  ["vtt", "print-file", "dist/out.txt"],
-  # Delete the output file (keep directory to avoid fspy inferred-input miss on Windows)
-  ["vtt", "rm", "dist/out.txt"],
-  # Second run - cache hit, should restore dist/out.txt
-  ["vt", "run", "auto-output"],
-  # Verify output was restored
-  ["vtt", "print-file", "dist/out.txt"],
+  { argv = ["vt", "run", "auto-output"], comment = "first run writes dist/out.txt" },
+  { argv = ["vtt", "print-file", "dist/out.txt"], comment = "output exists after the build" },
+  { argv = ["vtt", "rm", "dist/out.txt"], comment = "delete only the file (keep dir to avoid an fspy inferred-input miss on Windows)" },
+  { argv = ["vt", "run", "auto-output"], comment = "cache hit, should restore dist/out.txt" },
+  { argv = ["vtt", "print-file", "dist/out.txt"], comment = "output was restored from the archive" },
 ]
 
-# 2. Glob output: only files matching output globs are restored
 [[e2e]]
 name = "glob_output___only_matched_files_restored"
+comment = """
+Glob output: only files matching the configured output globs are restored
+on a cache hit; files produced outside those globs are left alone.
+"""
 steps = [
-  [
-    "vt",
-    "run",
-    "glob-output",
-  ],
-  [
-    "vtt",
-    "rm",
-    "dist/out.txt",
-  ],
-  [
-    "vtt",
-    "rm",
-    "tmp/temp.txt",
-  ],
-  # Second run - cache hit, should restore dist/out.txt but not tmp/temp.txt
-  [
-    "vt",
-    "run",
-    "glob-output",
-  ],
-  [
-    "vtt",
-    "print-file",
-    "dist/out.txt",
-  ],
-  # tmp/temp.txt should NOT exist (not in output globs)
-  { argv = [
-    "vtt",
-    "print-file",
-    "tmp/temp.txt",
-  ], comment = "should fail - tmp not in output globs" },
+  { argv = ["vt", "run", "glob-output"], comment = "first run writes dist/out.txt and tmp/temp.txt" },
+  { argv = ["vtt", "rm", "dist/out.txt"], comment = "delete the glob-matched output" },
+  { argv = ["vtt", "rm", "tmp/temp.txt"], comment = "delete the non-matched output" },
+  { argv = ["vt", "run", "glob-output"], comment = "cache hit: should restore dist/out.txt but not tmp/temp.txt" },
+  { argv = ["vtt", "print-file", "dist/out.txt"], comment = "dist/out.txt was restored" },
+  { argv = ["vtt", "print-file", "tmp/temp.txt"], comment = "should fail - tmp not in output globs" },
 ]
 
-# 3. Auto output works independently of input auto
 [[e2e]]
 name = "auto_output_with_non_auto_input"
+comment = """
+Auto output works even when input tracking is explicit
+(`input: [\"src/**\"]`). Output auto-detection and input auto-detection
+are independent.
+"""
 steps = [
-  # First run - input: ["src/**"] (no auto), output: default (auto)
-  ["vt", "run", "auto-output-no-auto-input"],
-  ["vtt", "rm", "dist/out.txt"],
-  # Cache hit - output files should still be restored
-  ["vt", "run", "auto-output-no-auto-input"],
-  ["vtt", "print-file", "dist/out.txt"],
+  { argv = ["vt", "run", "auto-output-no-auto-input"], comment = "first run: input src/** (no auto), output default (auto)" },
+  { argv = ["vtt", "rm", "dist/out.txt"], comment = "delete the output" },
+  { argv = ["vt", "run", "auto-output-no-auto-input"], comment = "cache hit - output files should still be restored" },
+  { argv = ["vtt", "print-file", "dist/out.txt"], comment = "output was restored" },
 ]
 
-# 4. Negative output globs exclude files from restoration
 [[e2e]]
 name = "negative_output___excluded_files_not_restored"
+comment = """
+Negative output globs exclude matching files from the cache archive, so
+they are not restored on a cache hit even though the task produced them.
+"""
 steps = [
-  [
-    "vt",
-    "run",
-    "negative-output",
-  ],
-  [
-    "vtt",
-    "rm",
-    "dist/out.txt",
-  ],
-  [
-    "vtt",
-    "rm",
-    "dist/cache/tmp.txt",
-  ],
-  # Cache hit - should restore dist/out.txt but NOT dist/cache/tmp.txt
-  [
-    "vt",
-    "run",
-    "negative-output",
-  ],
-  [
-    "vtt",
-    "print-file",
-    "dist/out.txt",
-  ],
-  # dist/cache/tmp.txt should NOT exist (excluded by !dist/cache/**)
-  { argv = [
-    "vtt",
-    "print-file",
-    "dist/cache/tmp.txt",
-  ], comment = "should fail - excluded by negative glob" },
+  { argv = ["vt", "run", "negative-output"], comment = "first run writes dist/out.txt and dist/cache/tmp.txt" },
+  { argv = ["vtt", "rm", "dist/out.txt"], comment = "delete the archived output" },
+  { argv = ["vtt", "rm", "dist/cache/tmp.txt"], comment = "delete the excluded output" },
+  { argv = ["vt", "run", "negative-output"], comment = "cache hit: should restore dist/out.txt but NOT dist/cache/tmp.txt" },
+  { argv = ["vtt", "print-file", "dist/out.txt"], comment = "dist/out.txt was restored" },
+  { argv = ["vtt", "print-file", "dist/cache/tmp.txt"], comment = "should fail - excluded by !dist/cache/**" },
 ]
 
-# 5. Changing output config invalidates cache
 [[e2e]]
 name = "output_config_change_invalidates_cache"
+comment = """
+Changing a task's output configuration invalidates the cache entry —
+the next run is a miss, not a hit of the stale archive.
+"""
 steps = [
-  ["vt", "run", "output-config-change"],
-  # Change output config
-  ["vtt", "replace-file-content", "vite-task.json", 'REPLACE_ME', 'dist/**'],
-  # Should be a cache miss due to output config change
+  { argv = ["vt", "run", "output-config-change"], comment = "first run populates the cache" },
+  { argv = ["vtt", "replace-file-content", "vite-task.json", "REPLACE_ME", "dist/**"], comment = "change the output globs in the task config" },
   { argv = ["vt", "run", "output-config-change"], comment = "cache miss: output config changed" },
 ]
 
-# 6. Input negative globs must not drop matching writes from the output archive.
-# Here the user excludes `dist/**` from inferred inputs (so rewriting dist/ won't
-# mark inputs as modified), but default auto output should still capture dist
-# writes and restore them on a cache hit.
 [[e2e]]
 name = "input_negative_does_not_drop_output_writes"
+comment = """
+Input negative globs must not drop matching writes from the output
+archive. Here the user excludes `dist/**` from inferred inputs (so
+rewriting dist/ won't mark inputs as modified), but default auto output
+should still capture dist writes and restore them on a cache hit.
+"""
 steps = [
-  ["vt", "run", "input-neg-dist-auto-output"],
-  ["vtt", "rm", "dist/out.txt"],
-  # Cache hit should restore dist/out.txt
-  ["vt", "run", "input-neg-dist-auto-output"],
-  ["vtt", "print-file", "dist/out.txt"],
+  { argv = ["vt", "run", "input-neg-dist-auto-output"], comment = "first run writes dist/out.txt" },
+  { argv = ["vtt", "rm", "dist/out.txt"], comment = "delete the output" },
+  { argv = ["vt", "run", "input-neg-dist-auto-output"], comment = "cache hit should restore dist/out.txt" },
+  { argv = ["vtt", "print-file", "dist/out.txt"], comment = "output was restored despite dist/** being a negative input glob" },
 ]
 
-# 7. When input auto is disabled (explicit globs only), unrelated reads tracked
-# by fspy must NOT become inferred inputs. Default auto output still needs fspy
-# for write tracking, but reads outside `input: ["src/**"]` should be ignored.
 [[e2e]]
 name = "explicit_input_ignores_fspy_reads"
+comment = """
+When input auto is disabled (explicit globs only), unrelated reads
+tracked by fspy must NOT become inferred inputs. Default auto output
+still needs fspy for write tracking, but reads outside `input: [\"src/**\"]`
+should be ignored.
+"""
 steps = [
-  [
-    "vt",
-    "run",
-    "explicit-input-auto-output",
-  ],
-  # Modify README.md (read by the task, NOT in input globs)
-  [
-    "vtt",
-    "replace-file-content",
-    "README.md",
-    "v1",
-    "v2",
-  ],
-  # Should be a cache hit: README.md is not an input
-  { argv = [
-    "vt",
-    "run",
-    "explicit-input-auto-output",
-  ], comment = "cache hit: README.md not in input globs" },
+  { argv = ["vt", "run", "explicit-input-auto-output"], comment = "first run reads README.md (not in input globs) and captures the output" },
+  { argv = ["vtt", "replace-file-content", "README.md", "v1", "v2"], comment = "modify README.md — not an input, so it must not invalidate the cache" },
+  { argv = ["vt", "run", "explicit-input-auto-output"], comment = "cache hit: README.md not in input globs" },
 ]

crates/vite_task_bin/tests/e2e_snapshots/fixtures/output_cache_test/snapshots/auto_output___files_restored_on_cache_hit.md

@@ -1,24 +1,35 @@
 # auto_output___files_restored_on_cache_hit
 
+Auto output detection (default): output files written by the task are
+restored on a cache hit.
+
 ## `vt run auto-output`
 
+first run writes dist/out.txt
+
 ```
 $ vtt write-file dist/out.txt built
 ```
 
 ## `vtt print-file dist/out.txt`
 
+output exists after the build
+
 ```
 built
 ```
 
 ## `vtt rm dist/out.txt`
 
+delete only the file (keep dir to avoid an fspy inferred-input miss on Windows)
+
 ```
 ```
 
 ## `vt run auto-output`
 
+cache hit, should restore dist/out.txt
+
 ```
 $ vtt write-file dist/out.txt built ◉ cache hit, replaying
 
@@ -28,6 +39,8 @@ vt run: cache hit.
 
 ## `vtt print-file dist/out.txt`
 
+output was restored from the archive
+
 ```
 built
 ```

crates/vite_task_bin/tests/e2e_snapshots/fixtures/output_cache_test/snapshots/auto_output_with_non_auto_input.md

@@ -1,18 +1,28 @@
 # auto_output_with_non_auto_input
 
+Auto output works even when input tracking is explicit
+(`input: ["src/**"]`). Output auto-detection and input auto-detection
+are independent.
+
 ## `vt run auto-output-no-auto-input`
 
+first run: input src/** (no auto), output default (auto)
+
 ```
 $ vtt write-file dist/out.txt built
 ```
 
 ## `vtt rm dist/out.txt`
 
+delete the output
+
 ```
 ```
 
 ## `vt run auto-output-no-auto-input`
 
+cache hit - output files should still be restored
+
 ```
 $ vtt write-file dist/out.txt built ◉ cache hit, replaying
 
@@ -22,6 +32,8 @@ vt run: cache hit.
 
 ## `vtt print-file dist/out.txt`
 
+output was restored
+
 ```
 built
 ```

crates/vite_task_bin/tests/e2e_snapshots/fixtures/output_cache_test/snapshots/explicit_input_ignores_fspy_reads.md

@@ -1,14 +1,23 @@
 # explicit_input_ignores_fspy_reads
 
+When input auto is disabled (explicit globs only), unrelated reads
+tracked by fspy must NOT become inferred inputs. Default auto output
+still needs fspy for write tracking, but reads outside `input: ["src/**"]`
+should be ignored.
+
 ## `vt run explicit-input-auto-output`
 
+first run reads README.md (not in input globs) and captures the output
+
 ```
 $ vtt print-file README.md
 v1
 ```
 
 ## `vtt replace-file-content README.md v1 v2`
 
+modify README.md — not an input, so it must not invalidate the cache
+
 ```
 ```
 

crates/vite_task_bin/tests/e2e_snapshots/fixtures/output_cache_test/snapshots/glob_output___only_matched_files_restored.md

@@ -1,7 +1,12 @@
 # glob_output___only_matched_files_restored
 
+Glob output: only files matching the configured output globs are restored
+on a cache hit; files produced outside those globs are left alone.
+
 ## `vt run glob-output`
 
+first run writes dist/out.txt and tmp/temp.txt
+
 ```
 $ vtt write-file dist/out.txt built
 
@@ -13,16 +18,22 @@ vt run: 0/2 cache hit (0%). (Run `vt run --last-details` for full details)
 
 ## `vtt rm dist/out.txt`
 
+delete the glob-matched output
+
 ```
 ```
 
 ## `vtt rm tmp/temp.txt`
 
+delete the non-matched output
+
 ```
 ```
 
 ## `vt run glob-output`
 
+cache hit: should restore dist/out.txt but not tmp/temp.txt
+
 ```
 $ vtt write-file dist/out.txt built ◉ cache hit, replaying
 
@@ -34,6 +45,8 @@ vt run: 2/2 cache hit (100%). (Run `vt run --last-details` for full details)
 
 ## `vtt print-file dist/out.txt`
 
+dist/out.txt was restored
+
 ```
 built
 ```