M2: 基座能力 —— memory / toolbox / channel / message

- memory   任务记忆四性质(只追加·信封盖戳·治理先行·归侧)、活动记忆四层与条目三件套、
           任务日志两级投影(结构化零 LLM / 叙述性小结不入事实库)、度量八指标只读投影
- toolbox  注册两审(静态审 + 试运行审)、效应等级决定运行时待遇、契约演进只增不破坏、
           白名单与纯工具私有作用域、ToolInvoker(两缝之二,live/record/replay)
- channel  通道实例配置、入站归一(解析 → 系统写 → 数据事件)、出站发送与关联记录登记
- message  通知 / 跨任务征答(就地作答 · 驳回重答只增不改)/ 死信 / 无主兜底

app:message 接上 event 的 MessageFallback;派发器按目标 ID 取 advisory lock 串行消费 +
消费幂等表;/api/ingest 模拟邮件通道(mock 只在外界)

已验证:无主 RFQ 邮件入站 → 归属解析 no-match → 事件落库 → 兜底落 OP 岗位的消息要素
门禁五道全绿;150 个单元测试 + 1 个 PG 集成测试

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m

apps/api/src/modules/memory/contract.ts

@@ -0,0 +1,76 @@
+/**
+ * module: memory —— 对外类型(编码规范 §10.1)。
+ */
+import type { AttributionSide, TaskId } from '@contracts';
+import type {
+  ActivityMemoryEntry,
+  CandidateIncrement,
+  Evidence,
+  MemoryLayer,
+} from './internal/domain/activity-memory.ts';
+import type { EntryKind, GovernanceMark, MemoryEntry, VersionStamp } from './internal/domain/task-memory.ts';
+import type { LogLine, Metrics, MetricsInput } from './internal/domain/task-log.ts';
+
+export type {
+  ActivityMemoryEntry,
+  AttributionSide,
+  CandidateIncrement,
+  EntryKind,
+  Evidence,
+  GovernanceMark,
+  LogLine,
+  MemoryEntry,
+  MemoryLayer,
+  Metrics,
+  MetricsInput,
+  VersionStamp,
+};
+
+export { NoEvidenceError } from './internal/domain/activity-memory.ts';
+
+/** 追加一条任务记忆 —— 归侧由 kind 自动推导,调用方不得指定(零埋点) */
+export type AppendEntry = {
+  readonly taskId: TaskId;
+  readonly kind: EntryKind;
+  readonly title: string;
+  readonly detail?: Record<string, unknown>;
+  readonly stamp: VersionStamp;
+  readonly governance?: Partial<GovernanceMark>;
+  readonly linksTo?: string;
+  readonly eventRef?: string;
+};
+
+export type DistillInput = {
+  readonly taskId: TaskId;
+  readonly activityId: string;
+  readonly trigger: 'terminal' | 'milestone';
+  readonly milestone?: string;
+  readonly prompt: string;
+};
+
+export type MemoryService = {
+  /* 任务记忆:框架自动记录、只追加 */
+  append(entry: AppendEntry): Promise<MemoryEntry>;
+  history(taskId: TaskId): Promise<MemoryEntry[]>;
+  /** 活动侧唯一可配置项:窗口大小 —— 每次 LLM 调用加载多少轮 */
+  window(taskId: TaskId, size: number): Promise<MemoryEntry[]>;
+  seal(taskId: TaskId): Promise<void>;
+
+  /* 任务日志:任务记忆的两级投影 */
+  taskLog(taskId: TaskId, options?: { canSeeMasked?: boolean }): Promise<LogLine[]>;
+  /** 叙述性小结(LLM,可选)—— 叙述是视图不是事实,不入事实库 */
+  narrate(taskId: TaskId): Promise<string | undefined>;
+
+  /* 活动记忆:四层存取;写入唯蒸馏 */
+  loadActivityMemory(
+    activityId: string,
+    options?: { layers?: readonly MemoryLayer[]; limit?: number },
+  ): Promise<ActivityMemoryEntry[]>;
+  /** **不设直写旁路**:唯一写入口是蒸馏钩子 */
+  distill(input: DistillInput): Promise<ActivityMemoryEntry[]>;
+  /** 人可修剪 —— 治理台 · 记忆管理 */
+  prune(entryId: string): Promise<void>;
+  setIncrementState(entryId: string, state: CandidateIncrement['state']): Promise<void>;
+
+  metrics(input: Omit<MetricsInput, 'entries'> & { taskIds: readonly TaskId[] }): Promise<Metrics>;
+};