feat(server): ServerModule skeleton with shared ServerContext, worker runs engine + outbox relay (B6)

modules/{auth-settings,sources-identity,acquisition-organize,agent} placeholders listed in
SERVER_MODULES; ServerModule registers routes (under /api/v1, authenticated), tasks,
outbox routes, capabilities and background loops. bootstrap() builds ServerContext (db,
config, logger, events, engine, outbox writer, secrets placeholder, settings reader,
capability registry), fills unregistered tasks with stubs and rejects duplicate task or
outbox ownership. worker starts the OpenWorkflow worker, OutboxRelay and module start().
--role migrate also migrates the engine schema; api/worker connect without migrating.
tasks: TaskRegistry.has, migrateEngineSchema.

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

packages/tasks/src/openworkflow-engine.ts

@@ -41,7 +41,7 @@ export interface OpenWorkflowEngineOptions {
   registry: TaskRegistry;
   /** 固定 "openworkflow";只允许测试覆盖 */
   schema?: string;
-  /** 默认 true(幂等)。W2 并入统一迁移后启动时传 false */
+  /** 默认 true(幂等)。部署时由 migrateEngineSchema 预先迁移,多进程启动传 false */
   runMigrations?: boolean;
   logSink?: LogSink;
   /** handler 执行期间轮询取消标志的间隔,默认 1000ms */
@@ -50,6 +50,15 @@ export interface OpenWorkflowEngineOptions {
 
 export const signalName = (runId: string, name: string) => `umt:${runId}:${name}`;
 
+/**
+ * 只跑引擎自己的迁移(openworkflow schema)后断开。部署时由 `--role migrate` 调用,
+ * 之后 api / worker 进程以 runMigrations:false 连接,避免多进程同时迁移。
+ */
+export async function migrateEngineSchema(databaseUrl: string, schema = ENGINE_SCHEMA): Promise<void> {
+  const backend = await BackendPostgres.connect(databaseUrl, { schema, runMigrations: true });
+  await backend.stop();
+}
+
 export class OpenWorkflowEngine implements TaskEngine {
   private readonly ow: OpenWorkflow;
   private readonly workers: Worker[] = [];