A6 三个去向改选择组,「恰选一口」全链打通 —— 整条流第一次真正跑完

G4 是整条流最后的断点:三个去向写成了必交口里的 outcome 字段 + selective: [],
而引擎只在选择组恰发一口时才注入 outcome —— 结构上永远没有判据。

## 四层贯通

① 契约:验收工单加 `portChoice`(组名 + 可选出口)。draft 是 Omit 透传,human-tool 零改动。
② A6 声明:outcome 移出必交口,三个去向成选择组(won/revise/lost 各一口带人读说明)。
   契约 0.2.0、包版 0.7.0。G4 三条边一行没改 —— outcome 由放行选口注入落地事实。
③ 引擎:验收发卡时从活动契约现读选择组上卡(组是契约的事实,不在步的卡面里声明)。
④ 前端 AcceptForm:选择组渲染为必选单选,不选「通过」不亮;选中的口随放行回传。

## 「恰选一口」拦在收单,不拦在落地 —— 拦错位置实测翻过车

第一版把 validateSelection 放进 release.land:回传是**同步收单**(200 = 收到裁决),
落地在推进器里**异步**跑 —— 拦晚了就是「工单已答完、任务卡死、推进器循环报错」(实测)。
改到 checkWorkOrderReply(与「驳回必附意见」同族的收单规矩):工单投影自带 portChoice,
放行回传缺口/口不在组内 → 400 同步拒收,工单还活着,人补选就是。
land 里的 validateSelection 留作兜底 —— 这条从 contracts 导出以来从未被执行的不变量,
现在两个岗位都有了。

## 实测四连

  不选口通过 → 400「放行前先选『议价结果』」,工单未被吃掉
  选 won    → end_won released,流 completed —— **整条流第一次真正跑完**
  选 revise → A4#2 重开新实例(A4#1 留痕不动)
  选 lost   → A7 情报归档 → end_arch released,流 completed
  全程 route-dead-end 事件 0 条

typecheck ✓ lint ✓ depcruise ✓ 498 测试 ✓

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
This commit is contained in:
2026-07-28 16:37:59 +08:00
co-authored by Claude Opus 5
parent 894769e2ca
commit 545103af1b
11 changed files with 169 additions and 12 deletions
@@ -5,7 +5,7 @@
* → 落地收敛输出口才发射 → 终态方成「放行完成」。
*/
import type { ActionIntent, TaskId } from '@contracts';
import { emissionPortNames } from '@contracts';
import { emissionPortNames, validateSelection } from '@contracts';
import type {
LandInput,
LandOutcome,
@@ -201,6 +201,26 @@ export function createReleaseService(deps: ReleaseServiceDeps): ReleaseService {
{},
);
const ports = await deps.tasks.outputPortsOf(input.taskId);
/*
* **恰选一口是硬约束**,不是前端的善意:选择组未选(或选了组外的口)就不落地。
* 前端已强制必选;这里兜底拦 API 直调 —— `validateSelection` 这条不变量
* 从 contracts 导出以来一直没人执行过,现在它有了岗位。
*/
const selectionErrors = validateSelection(
{
mandatory: ports.mandatory.map((name) => ({ name, payload: {} })),
selective: ports.selective.map((g) => ({
group: g.group,
ports: g.ports.map((name) => ({ name, payload: {} })),
})),
},
input.selectedPorts,
);
if (selectionErrors.length > 0) {
throw new Error(`放行未确认分支结论:${selectionErrors.join('; ')} —— 验收单上恰选一口再通过`);
}
const emitted = emissionPortNames(
{
mandatory: ports.mandatory.map((name) => ({ name, payload: {} })),