AGENTS.md@packages/client/src/test-support git:20261021.ae7647aA

Immutable. This exact content never changes and is served at /api/v1/blob/c1d4141b7b31b029.

# DOX — packages/client/src/test-support

Files in this directory. One row per source file.

| File | Purpose |
|------|---------|
| `attachmentHarness.tsx` | Test harness: `stubArchiveApi`, `withOpenSpecMap`, `archiveEntry`, `knownData`, `absentData`, `makeChange`. See change: resolve-archived-attached-proposal. |
| `history-load-harness.tsx` | `setupHistoryLoad(status)` composes real `useHistoryLoadState` + `useMessageHandler` (real `setSessionStates`); helpers `begin`, `advance`, `dispatch`, `phase`, `setStatus`, `markSpy`; `contentReplay(sid)`. See change: show-session-history-load-state. |
| `eager-lazy-dialogs.ts` | Vitest `setupFiles` shim: `vi.mock`s both `lazy-*-dialogs` modules to the EAGER components so unit tests assert dialogs synchronously; real loaders covered by `lazy-dialogs.test.tsx`. See change: redesign-composer-session-strip. |
| `runConfigHarness.tsx` | `ModelConfigProvider` test harness. Exports `makeModels`, `makeRunConfig`, `RunConfigHarness`. See change: openspec-dialog-model-effort-selector. |
| `subagents-reducer-slice.ts` | Vitest `setupFiles` shim (both client projects): registers the subagents plugin's `sessionEventReducer` slice AND `toolRowFinalizers` (Agent) via `registerSessionEventReducer`/`registerToolRowFinalizer("subagents", …)` so core replay suites keep asserting `SessionState.subagents` after the subagent writers left the reducer. Imports the plugin modules by relative path (not the plugin entry). Exports `registerSubagentsReducerSlice()` (restore after a reset; clears test owners) and `disableSubagentsPlugin()` (reset registries + own `subagent_*` so events fold into the group row). The core→plugin test edge (`integration-keep` row, replay contract). See change: decouple-plugins-from-core (design D5 item 11, tasks 4.6, 4.10). |
| `virtualizer-jsdom.ts` | Vitest `setupFiles` layout shim + scoped 160 ms TanStack callback drain. Enforced call-site invariant and flake triage → see `virtualizer-jsdom.ts.AGENTS.md` |
| `renderWithProviders.tsx` | `renderWithProviders(ui)`: `render` wrapped in a default `ThemeProvider` + `window.matchMedia` shim (jsdom has none). See change: test-trust-audit. |
| `restore-globals.ts` | Vitest `setupFiles` hygiene. `afterEach`: RTL cleanup + real timers. `afterAll`: `restoreGlobals()` puts back storage objects/contents, `getBoundingClientRect`, `matchMedia`. No `vi.resetModules` (second React copy). See change: test-trust-audit. |
| `statusGateStandIn.tsx` | Core-owned stand-in for a status-gating plugin: module store + `StandInBadge` (`session-card-badge`, `shouldRender: hasStandInItems`) + `StandInFeed` (`shell-headless`, `usePluginMessage`), `setStandInStatus` bumps claims version on empty↔non-empty flip; tolerant of malformed frames. Lets core STATUS-gate tests avoid importing browser-plugin. See change: decouple-plugins-from-core. |
| `pointer.ts` | jsdom pointer helpers: `pointerDown/Move/Up/Cancel`, `lostPointerCapture`, `nextFrame`. Typed `MouseEvent`s + defined `pointerId` (no `PointerEvent` in jsdom). See change: fix-split-divider-drag. |