Archived
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:
co-authored by
Claude Opus 5
parent
146e9bbfad
commit
561a2474ae
@@ -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}`;
|
||||
}
|
||||
Reference in New Issue
Block a user