From b3caabb05dc89c0d1ae0610bac910c1f630e5d86 Mon Sep 17 00:00:00 2001
From: Tianyi Cui <53024+tianyicui@users.noreply.github.com>
Date: Fri, 19 Jun 2026 09:20:26 +0800
Subject: [PATCH] docs: fix snapshot-filter syntax (no `--`, which vitest reads
 as a file filter)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`pnpm run test:snapshot -- -t <name>` silently runs ALL scenarios: pnpm
forwards `--` literally and vitest treats everything after it as positional
filename filters, so `-t` is ignored. The working form drops the separator —
`pnpm run test:snapshot -t <name>` (and `-u` likewise).
---
 AGENTS.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 96861b93ec..8e5fb22a29 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -68,10 +68,12 @@ pnpm run test:snapshot  # ACP snapshot tests (examples/*/tests/**/*.snapshot.ts)
                     # boot the real acp-agent subprocess, replay a recorded
                     # session JSONL, diff the normalized stdout + re-persisted
                     # log against committed goldens. KEYLESS — runs in the
-                    # default gate. Filter one: `pnpm run test:snapshot -- -t <name>`.
+                    # default gate. Filter one by scenario name (no `--`, which
+                    # vitest treats as a positional file filter): `pnpm run
+                    # test:snapshot -t <name>`.
 pnpm run test:snapshot:record  # re-record fixtures + goldens against the real
                     # API (needs DEEPSEEK_API_KEY); accept-the-diff = re-record
-                    # (or `pnpm run test:snapshot -- -u` to refresh goldens only)
+                    # (or `pnpm run test:snapshot -u` to refresh goldens only)
 pnpm run typecheck      # tsc -b tsconfig.build.json (declarations) + tsc -p
                     # tsconfig.typecheck.json (tests/examples typecheck too)
 pnpm run lint           # eslint .