test(db): 空库一键迁移验收 + globalSetup 临时库 + 公共夹具收敛（阶段1验收）

- vitest globalSetup：每次运行 CREATE sf_test_<ts> 临时库 → drizzle-orm 程序化迁移器
  全量迁移（apps/api/src/db/migrate.ts，drizzle-kit 无法指向运行时建库）→ 设
  DATABASE_URL_TEST 让 getDb() 自动回退到临时库；teardown DROP（WITH FORCE）。
  有 default 导出时 vitest 不捕获具名 teardown，故用双具名导出。
- db.full-migrate.test.ts：21 表齐 + 四张不可变触发器在库 + sf_test_* 护栏断言
  （current_database 不符即红，杜绝静默连开发库）。
- helpers.ts 收敛：rand/rejectionMessage/createSiteFixture/withImmutableCleanup/
  withTestDb，Task 6–12 七文件内联版替换为 import（断言、对照组、清场顺序不变）。
- scripts/migrate-test.sh：docker compose up --wait + pnpm test 一键验收。
- 实证：75 测试全绿（72+3）；开发库 21 表行数总和 0（零写入）；无 sf_test_* 残留。

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

tests/integration/db.jobs.test.ts

@@ -1,13 +1,13 @@
 // 构建/验收/审计域集成测试（0006 迁移）：build_jobs 幂等键唯一 + 状态 enum 八值、
 // build_input_snapshots 不可变触发器 + build_job_id UNIQUE、build_artifacts 三元组唯一、
 // audit_logs 追加式（UPDATE/DELETE 拒绝）、validation_issues.severity 可写。
-// 生命周期纪律：随机后缀插入 + finally 反序清理；两张不可变表（build_input_snapshots /
-// audit_logs）清场走点名 DISABLE TRIGGER → 删本级行 → ENABLE，嵌套 finally 保证触发器必然恢复。
+// Task 13 起夹具走公共 helpers（createSiteFixture/withImmutableCleanup/withTestDb/rejectionMessage）；
+// 生命周期纪律不变：随机后缀插入 + finally 反序清理；两张不可变表（build_input_snapshots /
+// audit_logs）清场走 DISABLE→删→ENABLE 封装。
 // audit_logs 组织级行（site_id NULL，spec §5.8）无 site 可挂——清场按 fixture 唯一 command_id 圈定。
 import { describe, it, expect } from 'vitest'
-import { getDb } from '../../apps/api/src/db/client.js'
+import { createSiteFixture, withImmutableCleanup, withTestDb, rejectionMessage, type Db } from './helpers.js'
 
-type Db = ReturnType<typeof getDb>
 type Fixture = {
   siteId: string
   buildJobId: string
@@ -20,10 +20,9 @@ type Fixture = {
 // 建链（FK 依赖顺序）：site → build_job → build_input_snapshot；validation_run 挂 site+job；
 // audit_logs 挂 site（站点级行；组织级 NULL 行在测试体内插，由 command_id 清场兜底）。
 async function setupJobsFixture(db: Db): Promise<Fixture> {
-  const rand = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
-  const site = (await db.execute(`insert into sites (id, key, name, default_locale, production_origin)
-    values (gen_random_uuid(), 'jobs-${rand}', 'JobsFixture', 'en', 'https://jobs.example') returning id`)) as any
-  const siteId = site[0].id
+  const site = await createSiteFixture(db, 'jobs')
+  const rand = site.rand
+  const siteId = site.siteId
   const job = (await db.execute(`insert into build_jobs (id, site_id, status, idempotency_key, attempt)
     values (gen_random_uuid(), '${siteId}', 'queued', 'build-idem-${rand}', 0) returning id, idempotency_key`)) as any
   const buildJobId = job[0].id
@@ -45,48 +44,27 @@ async function setupJobsFixture(db: Db): Promise<Fixture> {
   }
 }
 
-// 反序清理：子表常规删除；两张不可变表逐一 DISABLE → 删 → ENABLE（嵌套 finally）；
+// 反序清理：子表常规删除；两张不可变表逐一 DISABLE→删→ENABLE（嵌套 finally 保证触发器恢复）；
 // audit_logs 按 fixture 唯一 command_id 删（含组织级 NULL site 行）；最后删 site。
 async function cleanupJobsFixture(db: Db, f: Fixture) {
   await db.execute(`delete from validation_issues where validation_run_id = '${f.validationRunId}'`)
   await db.execute(`delete from validation_runs where site_id = '${f.siteId}'`)
   await db.execute(`delete from build_artifacts where build_job_id = '${f.buildJobId}'`)
-  await db.execute(`alter table build_input_snapshots disable trigger build_input_snapshots_immutable`)
-  try {
-    await db.execute(`delete from build_input_snapshots where site_id = '${f.siteId}'`)
-  } finally {
-    await db.execute(`alter table build_input_snapshots enable trigger build_input_snapshots_immutable`)
-  }
-  await db.execute(`alter table audit_logs disable trigger audit_logs_immutable`)
-  try {
-    await db.execute(`delete from audit_logs where command_id = '${f.auditCommandId}'`)
-  } finally {
-    await db.execute(`alter table audit_logs enable trigger audit_logs_immutable`)
-  }
+  await withImmutableCleanup(db, 'build_input_snapshots', 'build_input_snapshots_immutable', `site_id = '${f.siteId}'`)
+  await withImmutableCleanup(db, 'audit_logs', 'audit_logs_immutable', `command_id = '${f.auditCommandId}'`)
   await db.execute(`delete from build_jobs where site_id = '${f.siteId}'`)
   await db.execute(`delete from sites where id = '${f.siteId}'`)
 }
 
 async function withJobsFixture(fn: (db: Db, f: Fixture) => Promise<void>) {
-  const db = getDb()
-  const f = await setupJobsFixture(db)
-  try {
-    await fn(db, f)
-  } finally {
-    await cleanupJobsFixture(db, f)
-    await (db as any).$client.end()
-  }
-}
-
-// drizzle 会把 PostgresError 包成 DrizzleQueryError（message 只有 "Failed query: ..."），
-// 服务端原始错误文本在 cause 里——断言触发器/约束/枚举身份时必须看 cause。
-async function rejectionMessage(db: Db, query: string): Promise<string> {
-  try {
-    await db.execute(query)
-  } catch (e: any) {
-    return String(e?.cause?.message ?? e?.message ?? e)
-  }
-  throw new Error(`expected query to be rejected: ${query}`)
+  await withTestDb(async (db) => {
+    const f = await setupJobsFixture(db)
+    try {
+      await fn(db, f)
+    } finally {
+      await cleanupJobsFixture(db, f)
+    }
+  })
 }
 
 // 不可变快照探测插入：换新 id 但复用 fixture 的 build_job_id（唯一键探测用）。