M3(2/5): human-tool 与 release —— 卡协议与放行门

human-tool(L3):
- 三规矩机检:调用必附上下文(裸调用拒发)/ 回传即留痕 / 完成只出自放行通过
- 工单两模式 + 对话卡族的形态校验与回传校验;驳回必附意见;补全卡「没法填」旁路;
  决策卡自定义收尾项必附理由;已答不得再答(只增不改)
- 到达面两路(负责人 → 任务对话流;他人 → 系统消息);驳回重答 = 新卡实例、原卡闭合
- 调人预算由基座在环外强制;落地失败卡 = 执行工单的 preset

release(L4):
- 落地预检五项(入参 schema / 工具可用与授权 / 连接可达 / 目标预校验 / 数据冲突)
- 预检全过才发验收工单,卡面即已验证的动作清单;不过即打回环内,不发卡
- 放行写合并 + 幂等落地(任务 × 意向);落地收敛才发射输出口;
  受阻走落地失败卡且 emittedPorts 恒空;已成动作留存不回滚

215 个测试通过,门禁五道全绿

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
This commit is contained in:
JCAI Main Agent
2026-07-27 01:28:49 +08:00
co-authored by Claude Opus 5
parent 146e9bbfad
commit 561a2474ae
31 changed files with 4194 additions and 0 deletions
+65
View File
@@ -0,0 +1,65 @@
/**
* module: human-tool —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
*/
import type { ChatCard, StaffId, TaskId, WorkOrder } from '@contracts';
export type Clock = {
now(): Date;
};
export type IdGenerator = {
next(): string;
};
export type CardStore = {
saveWorkOrder(taskId: TaskId, order: WorkOrder, recipientId: StaffId): Promise<void>;
getWorkOrder(id: string): Promise<{
taskId: TaskId;
order: WorkOrder;
recipientId: StaffId;
} | undefined>;
listWorkOrders(taskId: TaskId, openOnly: boolean): Promise<WorkOrder[]>;
markWorkOrderDone(id: string, done: NonNullable<WorkOrder['done']>): Promise<void>;
saveChatCard(taskId: TaskId, card: ChatCard, recipientId: StaffId): Promise<void>;
getChatCard(id: string): Promise<{
taskId: TaskId;
card: ChatCard;
recipientId: StaffId;
} | undefined>;
listChatCards(taskId: TaskId): Promise<ChatCard[]>;
updateChatCard(card: ChatCard): Promise<void>;
closeChatCard(id: string, supersededBy: string, reason: string): Promise<void>;
/** 调人次数 —— 打扰率与预算的计数面 */
humanCallCount(taskId: TaskId): Promise<number>;
openCardsOf(staffId: StaffId): Promise<Array<{
cardId: string;
title: string;
}>>;
};
/** 跨人卡的到达面 —— app 注入 `message`(L2) */
export type MessageOutbox = {
sendElicitation(input: {
staffId: StaffId;
title: string;
body: string;
cardId: string;
sourceTaskId: string;
payload: Record<string, unknown>;
}): Promise<{
id: string;
}>;
};
/** 回传即留痕 —— app 注入 `memory`(L2) */
export type MemoryRecorder = {
append(input: {
taskId: TaskId;
kind: 'card-sent' | 'card-reply' | 'release-verdict';
title: string;
detail?: Record<string, unknown>;
}): Promise<void>;
};
/** 人事件 —— app 注入 `event`(L1):回传经统一入口写回任务 */
export type HumanEventPublisher = {
publishHumanEvent(input: {
taskId: TaskId;
cardId: string;
payload: Record<string, unknown>;
}): Promise<void>;
};