feat: 生命周期广播事件与链式钩子设施（ADR-006）

- contracts:补齐生命周期广播事件(订阅、下载、整理结束、刮削、字幕、作品关注 / 元数据 / 季集结构、站点可达性)
  的类型与 payload schema,LIFECYCLE_EVENTS 清单与 lifecycleKey 幂等键;HOOK_POINTS 链式钩子挂点;
  FEATURES 功能清单与 SLOT_POSITIONS 前端插槽位置
- outbox 中继支持一条事件路由给多个订阅方(其余订阅方用 <键>#<任务名>);生命周期事件允许多模块订阅,
  没有订阅方时也被中继认领并镜像到 SSE
- 服务端 HookRegistry:按注册顺序执行、rewrite / intercept 两类、单钩子超时与异常隔离、无注册零开销;
  ServerModule 增加 manifest 与 registerHooks,bootstrap 装配 ctx.hooks
- ADR-006 与 server README「如何写一个功能模块」

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Cxwgnn2pbzQ7rXv3rq7fei

apps/server/src/modules/types.ts

@@ -1,10 +1,18 @@
 import type { OpenAPIHono } from "@hono/zod-openapi";
 import type { CapabilityRegistry } from "@umt/agent";
-import type { EventPayload, EventType, GlobalSettings, SecretPurpose, SettingsKey } from "@umt/contracts";
+import type {
+  EventPayload,
+  EventType,
+  FeatureManifest,
+  GlobalSettings,
+  SecretPurpose,
+  SettingsKey,
+} from "@umt/contracts";
 import type { DB, Kysely, Transaction } from "@umt/db";
 import type { OutboxRelay, OutboxRouteFn, TaskEngine, TaskRegistry } from "@umt/tasks";
 import type { Logger } from "pino";
 import type { Config } from "../config.ts";
+import type { HookRegistrar, HookRegistry } from "../hooks/registry.ts";
 import type { AuthEnv } from "../http/auth.ts";
 import type { EventBusPort } from "../http/sse.ts";
 
@@ -72,6 +80,11 @@ export interface ServerContext {
   settings: SettingsReader;
   /** 能力注册中心(Web/Pi/CLI/MCP 共用一条 invoke 路径) */
   capabilities: CapabilityRegistry;
+  /**
+   * 链式钩子(ADR-006):bootstrap 装配,模块在 registerHooks 里注册;业务节点经 hooks/index.ts 的
+   * rewriteHook / interceptHook 调用。测试里手搭的上下文可以没有(等同于没有注册)。
+   */
+  hooks?: HookRegistry;
 }
 
 export interface ServerModule {
@@ -84,8 +97,15 @@ export interface ServerModule {
    * 同名任务只能由一个模块注册;没人注册的 §3.1-8 任务由 @umt/tasks 的空壳兜底。
    */
   registerTasks(registry: TaskRegistry, ctx: ServerContext): void;
-  /** 所有角色:outbox 事件 type → 任务路由;同一 type 只能由一个模块认领 */
+  /**
+   * 所有角色:outbox 事件 type → 任务路由。生命周期广播事件(ADR-006)可以被多个模块订阅,
+   * 中继按模块顺序把每个订阅方的路由都投递一遍;返回 null 表示这条事件本模块不处理。
+   */
   outboxRoutes?(ctx: ServerContext): Record<string, OutboxRouteFn>;
+  /** 外围功能的说明(功能清单只给智能体看,不做开关);取 contracts 的 featureManifest(id) */
+  manifest?: FeatureManifest;
+  /** 所有角色:注册链式钩子(同步、按注册顺序、可改写或拦截;见 hooks/registry.ts) */
+  registerHooks?(hooks: HookRegistrar, ctx: ServerContext): void;
   /** 所有角色:用 contracts 的 capabilitySpec(id) 注册能力处理器 */
   registerCapabilities?(registry: CapabilityRegistry, ctx: ServerContext): void;
   /** worker / all 角色:启动轮询器、定时器等后台循环(引擎与中继已启动) */