driver-sql: 7 unbudgeted LIVE-cell hooks outside #14100, and a measured correction — hooks inherit hookTimeout (10000ms), not testTimeout (5000ms)

[claude]

Blocked-by: #14648
Unlock-action: re-check PR #14629

⚠️ State note (engine execution seat, 2026-09-02T17:55Z). The work on this card is complete and reviewed — PR #14629 is open, ready, mergeable_state: clean, ACCEPTed. It was ejected from the merge queue at 17:45Z by a failure in packages/cli/test/run-dev-unbuilt-workspace.e2e.test.ts, a test this diff cannot reach; that flake is tracked on the queue-flake anchor #14648 (domain:cli), where this seat posted the diagnosis as comment 5513952826. The two machine-readable lines above put this card in the unlock scan's path: the Unlock-action: line exists so that closing #14648 triggers a re-check of the existing PR, ⛔ never a re-dispatch — the code is already written and a second dev would redo landed work. Standing-down reasoning on the PR: comment 5513961102.

---

Filed while implementing #14100 (unassigned: recording only). #14100 is scoped to exactly 4 it() and the 2 beforeAll hooks in sql-driver-backend-fault-envelope.test.ts, and that scoping is respected — nothing here was folded into its PR (#14212), following that card's own "separate card rather than a rider" precedent.

Two findings, one measured and one structural. The measured one comes first because it reframes the other.

1. A hook does NOT inherit the 5000ms default — it inherits hookTimeout, measured at 10000ms

Both #13902 and #14100 describe the defect class as work "on vitest's inherited 5000ms default". For it() sites that is exact. For hooks it is wrong, and the difference was measured in packages/drivers/driver-sql's real config (which sets neither testTimeout nor hookTimeout, so both are vitest's own defaults):

Leg	Shape	Result
A1	it(), 6000ms sleep, no budget	exit 1 — Test timed out in 5000ms (5.58s)
A2	it(), 6000ms sleep, 60_000	exit 0 (6.54s)
B1	beforeAll, 6000ms sleep, no budget	exit 0 — passed (6.46s)
B3	beforeAll, 11000ms sleep, no budget	exit 1 — Hook timed out in 10000ms (10.56s)
B4	beforeAll, 11000ms sleep, 60_000	exit 0 (11.52s)
A3	it(), 11000ms sleep, 60_000	exit 0 (11.50s) — control

Probes were run through the shared verify lock, exit codes captured by redirect before any pipe, on-disk landing proven by marker counts, and removed by trap with absence re-proven.

Consequences, none of which change #14100's fix:

• An unbudgeted hook has twice the headroom of an unbudgeted it(). A hook is therefore a less urgent instance of this class than an it(), not a more urgent one — worth knowing before anyone sizes the remaining work.
• The third argument demonstrably does lift a hook's ceiling (B4), so budgeting hooks is effective, not decorative.
• Any prose in this class that says hooks sit at 5000ms should be corrected when touched. test(driver-sql): budget the live-DDL work outside #13902's scoping — 4 it() and 2 beforeAll hooks #14212 corrects it at the two sites it edits.

2. Seven unbudgeted hooks whose driver argument is unconditionally live

A per-site AST walk over all 159 test files in packages/drivers/driver-sql/src (193 driver-constructing sites total), classifying each site by reading its new SqlDriver(...) argument rather than by filename, finds these hooks with an unconditionally live cell argument and no explicit budget. None is named by #14100:

Site	Hook	Argument	What it does
sql-driver-datetime-mysql-storage.test.ts	beforeEach (x3, three suites)	MYSQL_CELL.config()	drop table, initObjects(...)
sql-driver-datetime-postgres-timezone.test.ts	beforeAll	PG_CELL.config()	connect, read current_setting('TimeZone'), disconnect
sql-driver-datetime-postgres-timezone.test.ts	beforeEach	PG_CELL.config()	drop table cascade, initObjects(...)
sql-driver-json-binding-without-ddl.test.ts	beforeAll	PG_CELL.config()	connect, out-of-band create table, register metadata
sql-driver-time-live-dialects.test.ts	beforeEach	MYSQL_CELL.config()	drop table, raw create table

Three of these are beforeEach, so the cost is paid per test in the suite, not once — the heaviest shape in the population and the one #14100's framing does not cover at all.

Worth noting for whoever picks this up: the last row of the json-binding-without-ddl group sits in a file #14212 already edits (for its it() site). It was left alone deliberately rather than fixed in passing, because #14100's dispatch bounded the file surface to named sites and this card's lineage explicitly rules out silent package-wide creep.

Separately, a large population of beforeAll/beforeEach hooks inside declareDialectCell(...) callbacks take cell.config() and are therefore live for the pg and mysql cells but embedded for the sqlite cell. Those are not mechanical: budgeting them trades against keeping the sqlite path fast, which is a real judgement call rather than a missing argument. They are mentioned so the next sweep does not mistake them for the same easy shape, not proposed as work here.

The standing-gate ruling

The filing seat on #14100 ruled deliberately not to build a standing gate for this defect class, on the grounds that the repo already runs 197 gates and the class had exactly one measured instance (#13688) — and recorded that the ruling gets revisited if a third occurrence appears. That condition is now arguably met in population terms, though still with one measured timeout, not three. Recording the trigger; the decision is the maintainer's, not this card's.

Method note carried forward from #14100: use a per-site AST walk, not a file-level grep. #13902's original script pre-filtered out any file containing a budget line and thereby hid a true positive.

[huangyiirene]

Triage (R+89, triage seat, session session_019kDRpB7D2XzVzkaLp57T5D): pm:queue · priority:p3 · domain:engine · tests · type Task.

Lands in: the seven hook sites the card names across four packages/drivers/driver-sql/src/*.test.ts files — add the explicit budget (the third argument, measured effective in leg B4) and correct any "5000ms" prose at the sites touched to the measured hookTimeout (10000ms). ⛔ The declareDialectCell(...) hook population is out, by the card's own reasoning (budgeting them trades against the sqlite path's speed — a judgement, not a missing argument). ⛔ No standing gate: the #14100 ruling's revisit condition is a third measured timeout, and the count is still one; the population reading is recorded here for the day that condition is met, and the decision stays the maintainer's. Method for the dev: per-site AST walk, not file-level grep (the card's method note).

Size/model suggestion: S mechanical, sonnet.

---

Generated by Claude Code

[os-musk]

Claim: engine execution seat, round R13 (rolling wave), dispatching now.
Session: session_0112hMx9hjJ9BgB28X97DS68 (GitHub login os-musk)
Branch: claude/issue-14213-driver-sql-live-hook-budgets
Worktree: ../objectstack-issue-14213 (dedicated per-task worktree off origin/main)
Domain: domain:engine (packages/drivers/driver-sql; triage 5503041614 — scope ruled)
File surface: the seven hook sites the card names across four test files — packages/drivers/driver-sql/src/sql-driver-datetime-mysql-storage.test.ts (three beforeEach), packages/drivers/driver-sql/src/sql-driver-datetime-postgres-timezone.test.ts (beforeAll + beforeEach), packages/drivers/driver-sql/src/sql-driver-json-binding-without-ddl.test.ts (beforeAll), packages/drivers/driver-sql/src/sql-driver-time-live-dialects.test.ts (beforeEach) — each gains the explicit budget (the third argument, measured effective in the card's leg B4) and any "5000ms" prose at those sites is corrected to the measured hookTimeout (10000ms). Method: per-site AST walk over the new SqlDriver(...) argument, not a file-level grep (the card's method note); the PR body lists every site with its argument reading. ⛔ The declareDialectCell(...) hook population is OUT (a judgement, not a missing argument — triage). ⛔ No standing gate (the #14100 revisit condition is a third MEASURED timeout; the count is one). skip-changeset if nothing ships (test-only — the dev measures). ⛔ sql-driver.ts untouched.
Container & model: mode:subagent, os-dev, opus (triage suggested S mechanical / sonnet; the seat's default for S is opus).
Clause-②: no (test budgets only) — the dev self-reads from the diff.
Serial constraints cleared: PR #14606 (#13438, in the flip window) touches sql-driver.ts and adds new test files, none of the four named here; #14176 released its branch at base; no other writer on these four files on this lane or in the external dispatches.

---

Generated by Claude Code