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
@@ -0,0 +1,95 @@
/**
* 落地预检 —— 纯判定,零 IO(编码规范 §5.3;语义出处 OS 7.3,AM 06)。
*
* 「**检查可落地,才允许放行**:发放行卡前,系统对全部动作意向执行预检 ——
* ①入参 schema 校验 ②工具可用(未停用)与授权有效 ③连接可达
* ④目标预校验(工具契约含 validate 能力时)⑤数据冲突检查。
* 预检全过才发放行卡,卡面呈现的即已验证的动作清单;预检不过的意向打回环内修正,**不发卡**。」
*/
import type { AcceptanceLevel } from '@contracts';
export const PRECHECK_ITEMS = [
'input-schema',
'tool-available',
'connection-reachable',
'target-validate',
'data-conflict',
] as const;
export type PrecheckItem = (typeof PRECHECK_ITEMS)[number];
export const PRECHECK_ITEM_LABEL: Readonly<Record<PrecheckItem, string>> = {
'input-schema': '入参 schema 校验',
'tool-available': '工具可用与授权有效',
'connection-reachable': '连接可达',
'target-validate': '目标预校验',
'data-conflict': '数据冲突检查',
};
export type PrecheckFinding = {
readonly item: PrecheckItem;
/** 关联的动作意向;数据冲突项无意向,留空 */
readonly intentId?: string;
readonly message: string;
};
export type PrecheckReport = {
/** 全过才可发卡 */
readonly passed: boolean;
readonly findings: readonly PrecheckFinding[];
/** 已验证的动作清单 —— 通过时即验收工单卡面呈现的那份 */
readonly verified: ReadonlyArray<{ id: string; label: string; effect: 'read' | 'write'; detail: string }>;
};
export function summarize(
findings: readonly PrecheckFinding[],
verified: PrecheckReport['verified'],
): PrecheckReport {
return { passed: findings.length === 0, findings, verified };
}
/* ── 必交付物与判据 ─────────────────────────────────────────────────── */
export type DeliverableCheck = { readonly key: string; readonly label: string; readonly present: boolean };
export type CriterionCheck = { readonly key: string; readonly label: string; readonly level: AcceptanceLevel; readonly pass: boolean };
/** 必交付物**缺一不得提交放行**(AM 01) */
export function missingDeliverables(checks: readonly DeliverableCheck[]): DeliverableCheck[] {
return checks.filter((c) => !c.present);
}
/**
* 判据全绿只是**可提交**,完成只出自放行通过(AM 10.2)。
* L1/L2 由引擎预检;L3–L5 按分级执行 —— L5 是责任关,不参与「可提交」判定。
*/
export function submittable(checks: readonly CriterionCheck[]): boolean {
return checks.filter((c) => c.level !== 'L5').every((c) => c.pass);
}
/* ── 落地收敛 ───────────────────────────────────────────────────────── */
export type LandingOutcome = {
readonly id: string;
readonly ok: boolean;
readonly error?: string;
readonly retryable: boolean;
};
export type LandingVerdict =
/** 落地收敛 —— 输出口可发射,终态方成「放行完成」 */
| { readonly kind: 'converged' }
/** 落地受阻 —— **运行态**不是终态;走落地失败卡,处置后仍收敛于终态名录 */
| { readonly kind: 'blocked'; readonly failures: readonly LandingOutcome[] };
/**
* 「放行通过即刻执行(附幂等键);落地收敛,输出口才发射 —— 下游只见落地完成的任务。
* 已成动作留存**不回滚**。」
*/
export function landingVerdict(outcomes: readonly LandingOutcome[]): LandingVerdict {
const failures = outcomes.filter((o) => !o.ok);
return failures.length === 0 ? { kind: 'converged' } : { kind: 'blocked', failures };
}
/** 幂等键:任务 × 意向 —— 重放不重复触达世界(OS 7.3) */
export function idempotencyKey(taskId: string, intentId: string): string {
return `${taskId}:${intentId}`;
}