chore(deno): migrate toolchain from Node 24 + pnpm to Deno 2.9.7 + TypeScript 7.0.2 (W1.5)

- root deno.json workspace (nodeModulesDir auto), npm versions registered once in imports, deno.lock;
  remove pnpm-lock/pnpm-workspace/root package.json; members keep minimal package.json (name/type/exports)
- tasks: dev, typecheck (tsc 7.0.2 per member + deno check), lint/fmt (biome, useImportExtensions),
  test (vitest via deno), check:tokens, build (web + deno compile), ci, db:migrate/reset, gen:types
- tsconfig base moved to config/ (no root tsconfig.json); deno types -> types/deno.d.ts; web drops baseUrl
- server: Deno.serve entry with graceful shutdown, --role migrate|preflight|probe, WEB_ROOT static SPA hosting;
  drop @hono/node-server, tsx, esbuild build.mjs
- logger: redact child() bindings and serialize err by message/stack; sync stdout destination; tests
- relative imports get explicit extensions (sites/mp-sync paths left for follow-up)
- crash-recovery tests spawn `deno run -A`; tasks tests use unique per-file schemas
- single-container Dockerfile + entrypoint (migrate -> preflight -> api+worker watchdog), docker-compose.yml
- docs: README, runbook, ADR-001 superseded, plan §1 validation row

Co-Authored-By: Claude Fable 5.1 <[email protected]>

packages/tasks/README.md

@@ -54,4 +54,4 @@
 
 ## 测试
 
-`pnpm test` 会连接开发库(`DATABASE_URL`,默认 `postgres://umt:umt@localhost:55433/umt`)。每个测试文件使用独立的 `tasks_test_*` schema,测试前后都会清理;库不可达时跳过集成测试。覆盖范围:kill -9 后续跑(子进程 worker)、取消、幂等 enqueue、两个 relay 并发、事实先到达、fencing。
+`deno task test`(或本包 `deno task test`)会连接开发库(`DATABASE_URL`,默认 `postgres://umt:umt@localhost:55433/umt`)。每个测试文件使用独立的 `tasks_test_<名>_<pid+随机>` schema(并发跑多份也不冲突),测试前后都会清理;库不可达时跳过集成测试。覆盖范围:kill -9 后续跑(子进程 worker)、取消、幂等 enqueue、两个 relay 并发、事实先到达、fencing。

packages/tasks/deno.json

@@ -0,0 +1,9 @@
+{
+  "name": "@umt/tasks",
+  "version": "0.0.0",
+  "exports": { ".": "./src/index.ts" },
+  "tasks": {
+    "test": "deno run -A npm:vitest run",
+    "typecheck": "deno run -A npm:typescript/tsc --noEmit -p tsconfig.json"
+  }
+}

packages/tasks/package.json

@@ -1,24 +1,8 @@
 {
   "name": "@umt/tasks",
-  "version": "0.0.0",
   "private": true,
   "type": "module",
   "exports": {
     ".": "./src/index.ts"
-  },
-  "scripts": {
-    "typecheck": "tsc -p tsconfig.json",
-    "test": "vitest run"
-  },
-  "dependencies": {
-    "@umt/db": "workspace:*",
-    "kysely": "^0.29.6",
-    "openworkflow": "0.10.1",
-    "pg": "^8.23.0",
-    "postgres": "^3.4.9",
-    "zod": "^4.6.5"
-  },
-  "devDependencies": {
-    "@types/pg": "^8.23.1"
   }
 }

packages/tasks/src/definitions.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { defineTask, TaskRegistry } from "./registry";
+import { defineTask, TaskRegistry } from "./registry.ts";
 
 // 任务书 §3.1-8 的九类任务。W1 只落空壳:输入 schema + 回显 handler,W2 填充处理器。
 // 填充规则见 README「新增/填充任务」:副作用走 withAttemptToken,外部条件用 step.waitForFact,

packages/tasks/src/index.ts

@@ -14,8 +14,8 @@ export {
   TASK_NAMES,
   type TaskName,
   verifyAndImport,
-} from "./definitions";
-export { FencingError, TaskCanceledError, UnknownTaskError } from "./errors";
+} from "./definitions.ts";
+export { FencingError, TaskCanceledError, UnknownTaskError } from "./errors.ts";
 export {
   consoleSink,
   createLogger,
@@ -25,8 +25,8 @@ export {
   redact,
   silentSink,
   type TaskLogger,
-} from "./logger";
-export { migrateTasksTables, TASKS_MIGRATIONS_DIR } from "./migrate";
+} from "./logger.ts";
+export { migrateTasksTables, TASKS_MIGRATIONS_DIR } from "./migrate.ts";
 export {
   type AttemptInfo,
   assertAttemptToken,
@@ -34,14 +34,19 @@ export {
   type OpLedgerRow,
   type WithAttemptTokenOptions,
   withAttemptToken,
-} from "./op-ledger";
-export { ENGINE_SCHEMA, OpenWorkflowEngine, type OpenWorkflowEngineOptions, signalName } from "./openworkflow-engine";
+} from "./op-ledger.ts";
+export {
+  ENGINE_SCHEMA,
+  OpenWorkflowEngine,
+  type OpenWorkflowEngineOptions,
+  signalName,
+} from "./openworkflow-engine.ts";
 export {
   type OutboxEvent,
   OutboxRelay,
   type OutboxRelayOptions,
   type OutboxRoute,
   type OutboxRouteFn,
-} from "./outbox-relay";
-export { defineTask, type TaskDefinition, TaskRegistry } from "./registry";
-export type * from "./types";
+} from "./outbox-relay.ts";
+export { defineTask, type TaskDefinition, TaskRegistry } from "./registry.ts";
+export type * from "./types.ts";

packages/tasks/src/op-ledger.ts

@@ -1,7 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { type Kysely, sql, type Transaction } from "kysely";
-import { FencingError } from "./errors";
-import type { JsonValue } from "./types";
+import { FencingError } from "./errors.ts";
+import type { JsonValue } from "./types.ts";
 
 // biome-ignore lint/suspicious/noExplicitAny: 本包只用原生 SQL 访问自有表,不依赖业务库类型
 type AnyDb = Kysely<any>;

packages/tasks/src/openworkflow-engine.ts

@@ -2,9 +2,9 @@ import { randomUUID } from "node:crypto";
 import { type Kysely, sql } from "kysely";
 import { defineWorkflow, OpenWorkflow, Worker, type Workflow } from "openworkflow";
 import { BackendPostgres } from "openworkflow/postgres";
-import { TaskCanceledError } from "./errors";
-import { createLogger, type LogSink } from "./logger";
-import { engineVersion, parseEngineVersion, type TaskDefinition, type TaskRegistry } from "./registry";
+import { TaskCanceledError } from "./errors.ts";
+import { createLogger, type LogSink } from "./logger.ts";
+import { engineVersion, parseEngineVersion, type TaskDefinition, type TaskRegistry } from "./registry.ts";
 import type {
   EnqueueOptions,
   JsonValue,
@@ -16,7 +16,7 @@ import type {
   TaskRunView,
   TaskStepApi,
   WaitForFactOptions,
-} from "./types";
+} from "./types.ts";
 
 // biome-ignore lint/suspicious/noExplicitAny: 本包只用原生 SQL 访问自有表
 type AnyDb = Kysely<any>;

packages/tasks/src/outbox-relay.ts

@@ -1,7 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { type Kysely, sql } from "kysely";
-import { createLogger, type LogSink } from "./logger";
-import type { TaskEngine } from "./types";
+import { createLogger, type LogSink } from "./logger.ts";
+import type { TaskEngine } from "./types.ts";
 
 // biome-ignore lint/suspicious/noExplicitAny: 只用原生 SQL 读写 outbox_event
 type AnyDb = Kysely<any>;

packages/tasks/src/registry.ts

@@ -1,6 +1,6 @@
 import type { z } from "zod";
-import { UnknownTaskError } from "./errors";
-import type { RetryPolicy, TaskContext } from "./types";
+import { UnknownTaskError } from "./errors.ts";
+import type { RetryPolicy, TaskContext } from "./types.ts";
 
 export interface TaskDefinition<S extends z.ZodType = z.ZodType, O = unknown> {
   name: string;

packages/tasks/src/types.ts

@@ -1,4 +1,4 @@
-import type { TaskLogger } from "./logger";
+import type { TaskLogger } from "./logger.ts";
 
 export type JsonValue = string | number | boolean | null | JsonValue[] | { [key: string]: JsonValue };
 

packages/tasks/test/crash-recovery.test.ts

@@ -1,7 +1,7 @@
 import { type ChildProcess, spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
-import { createTestRegistry } from "./fixtures/tasks";
+import { createTestRegistry } from "./fixtures/tasks.ts";
 import {
   connectDb,
   createSideEffectTable,
@@ -13,7 +13,7 @@ import {
   type TestDb,
   testSchemas,
   waitFor,
-} from "./helpers";
+} from "./helpers.ts";
 
 const schemas = testSchemas("crash");
 const hasPg = await pgAvailable();
@@ -21,7 +21,7 @@ const WORKER = fileURLToPath(new URL("./fixtures/worker.ts", import.meta.url));
 const PKG_DIR = fileURLToPath(new URL("..", import.meta.url));
 
 function startWorker(env: Record<string, string>): Promise<ChildProcess> {
-  const child = spawn(process.execPath, ["--import", "tsx", WORKER], {
+  const child = spawn(process.execPath, ["run", "-A", WORKER], {
     cwd: PKG_DIR,
     env: { ...process.env, SCHEMA: schemas.biz, OW_SCHEMA: schemas.ow, ...env },
     stdio: ["ignore", "pipe", "pipe"],

packages/tasks/test/engine.test.ts

@@ -1,7 +1,7 @@
 import { sql } from "kysely";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
-import type { OpenWorkflowEngine } from "../src";
-import { createTestRegistry } from "./fixtures/tasks";
+import type { OpenWorkflowEngine } from "../src/index.ts";
+import { createTestRegistry } from "./fixtures/tasks.ts";
 import {
   connectDb,
   createSideEffectTable,
@@ -13,7 +13,7 @@ import {
   type TestDb,
   testSchemas,
   waitFor,
-} from "./helpers";
+} from "./helpers.ts";
 
 const schemas = testSchemas("engine");
 const hasPg = await pgAvailable();

packages/tasks/test/fixtures/tasks.ts

@@ -1,7 +1,7 @@
 import { sql } from "kysely";
 import { z } from "zod";
-import { defineTask, TaskRegistry } from "../../src";
-import type { TestDb } from "../helpers";
+import { defineTask, TaskRegistry } from "../../src/index.ts";
+import type { TestDb } from "../helpers.ts";
 
 const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
 

packages/tasks/test/fixtures/worker.ts

@@ -1,6 +1,6 @@
 // 崩溃恢复测试用的 worker 子进程:SCHEMA / OW_SCHEMA 指定测试 schema,HANG_STEP3=1 让第 3 步卡住
-import { connectDb, setupEngine } from "../helpers";
-import { createTestRegistry } from "./tasks";
+import { connectDb, setupEngine } from "../helpers.ts";
+import { createTestRegistry } from "./tasks.ts";
 
 const db = connectDb(process.env.SCHEMA!);
 const engine = await setupEngine(db, { ow: process.env.OW_SCHEMA! }, createTestRegistry(db));

packages/tasks/test/helpers.ts

@@ -1,6 +1,6 @@
 import { Kysely, PostgresDialect, sql } from "kysely";
 import pg from "pg";
-import { migrateTasksTables, OpenWorkflowEngine, silentSink, type TaskRegistry } from "../src";
+import { migrateTasksTables, OpenWorkflowEngine, silentSink, type TaskRegistry } from "../src/index.ts";
 
 export const PG_URL =
   process.env.TASKS_TEST_DATABASE_URL ?? process.env.DATABASE_URL ?? "postgres://umt:umt@localhost:55433/umt";
@@ -21,9 +21,14 @@ export async function pgAvailable(): Promise<boolean> {
 // biome-ignore lint/suspicious/noExplicitAny: 测试直接用原生 SQL
 export type TestDb = Kysely<any>;
 
-/** 每个测试文件用独立 schema:业务表 <name>,引擎表 <name>_ow */
+/**
+ * 每个测试文件用独立 schema:业务表 <name>,引擎表 <name>_ow。
+ * 名字带 pid + 随机后缀:同一个 PG 上并发跑的多份测试(多个终端/CI 任务/多个 agent)互不踩踏;
+ * 调用方在 afterAll 里 dropSchemas 清理。
+ */
 export function testSchemas(suffix: string) {
-  const biz = `tasks_test_${suffix}`;
+  const uniq = `${process.pid.toString(36)}${Math.random().toString(36).slice(2, 8)}`;
+  const biz = `tasks_test_${suffix}_${uniq}`;
   return { biz, ow: `${biz}_ow` };
 }
 

packages/tasks/test/op-ledger.test.ts

@@ -1,7 +1,7 @@
 import { sql } from "kysely";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
-import { FencingError, getOperation, migrateTasksTables, withAttemptToken } from "../src";
-import { connectDb, dropSchemas, pgAvailable, resetSchemas, type TestDb, testSchemas } from "./helpers";
+import { FencingError, getOperation, migrateTasksTables, withAttemptToken } from "../src/index.ts";
+import { connectDb, dropSchemas, pgAvailable, resetSchemas, type TestDb, testSchemas } from "./helpers.ts";
 
 const schemas = testSchemas("ledger");
 const hasPg = await pgAvailable();

packages/tasks/test/outbox.test.ts

@@ -1,7 +1,7 @@
 import { sql } from "kysely";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
-import { type EnqueueOptions, OutboxRelay, type TaskEngine } from "../src";
-import { createTestRegistry } from "./fixtures/tasks";
+import { type EnqueueOptions, OutboxRelay, type TaskEngine } from "../src/index.ts";
+import { createTestRegistry } from "./fixtures/tasks.ts";
 import {
   connectDb,
   createOutboxTable,
@@ -12,7 +12,7 @@ import {
   setupEngine,
   type TestDb,
   testSchemas,
-} from "./helpers";
+} from "./helpers.ts";
 
 const schemas = testSchemas("outbox");
 const hasPg = await pgAvailable();

packages/tasks/test/registry.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
 import { z } from "zod";
-import { createDefaultRegistry, defineTask, redact, TASK_NAMES, TaskRegistry, UnknownTaskError } from "../src";
+import { createDefaultRegistry, defineTask, redact, TASK_NAMES, TaskRegistry, UnknownTaskError } from "../src/index.ts";
 
 describe("TaskRegistry", () => {
   it("注册任务书 §3.1-8 的九个空壳任务", () => {

packages/tasks/tsconfig.json

@@ -1,4 +1,4 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "../../config/tsconfig.base.json",
   "include": ["src", "test"]
 }