test: server 测试共用建库与假引擎,sse-pg 归入串行组

- 新增 apps/server/test/support/{pg,engine}.ts:测试库地址、可用性探测、schema 咨询锁、
  建 schema + 加锁迁移 + 删除、可选去重的假引擎;6 份 harness 改用它(acquisition-organize 与
  file-manager 原先迁移不加锁,并行下有冲突隐患,一并修正)
- sse-pg 起子进程,并行下子进程启动超时,归入 serial
- 修正 b61335e 挪动 / 改名测试后遗留的 import 排序与格式(当时 lint 检查经管道被吞掉退出码)

Co-Authored-By: Claude Opus 5.5 <[email protected]>

apps/server/test/file-manager/harness.ts

@@ -10,26 +10,27 @@ import {
   SESSION_COOKIE,
   type SettingsKey,
 } from "@umt/contracts";
-import { type DB, migrateToLatest } from "@umt/db";
+import type { DB } from "@umt/db";
 import { normalizeTitle } from "@umt/domain";
-import { Kysely, PostgresDialect, sql } from "kysely";
-import pg from "pg";
+import { type Kysely, sql } from "kysely";
 import { ConfigSchema } from "../../src/config.ts";
 import { createOutboxPort } from "../../src/context.ts";
 import { createApp } from "../../src/http/app.ts";
 import { deriveCsrfToken, hashApiKey, hashSessionToken } from "../../src/http/auth.ts";
 import { EventBus } from "../../src/http/sse.ts";
 import { createLogger } from "../../src/logger.ts";
-import { fakeEngine } from "../acquisition-organize/harness.ts";
 import { executeRecord, type FrozenPlan } from "../../src/modules/acquisition-organize/services/organize.ts";
 import { runScrapeRecord } from "../../src/modules/acquisition-organize/services/scrape.ts";
 import { createCapabilityRegistry } from "../../src/modules/agent/capability-registry.ts";
 import { createFileManagerModule, type FmOverrides } from "../../src/modules/file-manager/index.ts";
 import type { ServerContext } from "../../src/modules/types.ts";
+import { fakeEngine } from "../support/engine.ts";
+import { createTestSchema, PG_URL as DB_URL, uniqueSchema } from "../support/pg.ts";
 
 // 文件管理测试装配:真实 PG(独立 schema)+ 临时目录(库根 / 下载根 / 根外目录)+ 记录入队的假引擎。
 
-export const DB_URL = process.env.DATABASE_URL ?? "postgres://umt:umt@localhost:55433/umt";
+export { pgAvailable } from "../support/pg.ts";
+export { DB_URL };
 export const DEV_KEY = "dev-admin-fm-test-key";
 export const READ_KEY = "fm-organize-read-key";
 export const EXEC_KEY = "fm-organize-exec-key";
@@ -43,18 +44,6 @@ const KEYS = [
   { key: ADMIN_KEY, scopes: ["admin"] },
 ];
 
-export async function pgAvailable() {
-  if (process.env.UMT_SKIP_DB_TESTS === "1") return false;
-  const c = new pg.Client({ connectionString: DB_URL, connectionTimeoutMillis: 2000 });
-  try {
-    await c.connect();
-    await c.end();
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 // biome-ignore lint/suspicious/noExplicitAny: 测试断言直接读响应 JSON
 type Loose = any;
 
@@ -98,17 +87,8 @@ export async function createFmHarness(
     runTransfers?: boolean;
   } = {},
 ): Promise<FmHarness> {
-  const schema = `fm_test_${name}_${process.pid.toString(36)}${Math.random().toString(36).slice(2, 7)}`;
-  const admin = new pg.Client({ connectionString: DB_URL });
-  await admin.connect();
-  await admin.query(`create schema ${schema}`);
-  await admin.end();
-  const db = new Kysely<DB>({
-    dialect: new PostgresDialect({
-      pool: new pg.Pool({ connectionString: DB_URL, max: 6, options: `-c search_path=${schema},public` }),
-    }),
-  });
-  await migrateToLatest(db, { migrationTableSchema: schema });
+  const ts = await createTestSchema(uniqueSchema(`fm_test_${name}`));
+  const { db } = ts;
 
   const base = await mkdtemp(join(tmpdir(), `fm-${name}-`));
   const lib = join(base, "lib");
@@ -285,11 +265,7 @@ export async function createFmHarness(
       return Promise.resolve(app.request(`/api/v1${path}`, { method, headers: authHeaders(key) }));
     },
     async close() {
-      await db.destroy();
-      const c = new pg.Client({ connectionString: DB_URL });
-      await c.connect();
-      await c.query(`drop schema if exists ${schema} cascade`);
-      await c.end();
+      await ts.drop();
       await rm(base, { recursive: true, force: true });
     },
   };