Files
JX-BPOS/apps/api/src/modules/task/CONTRACT.md
T
ChaiHaoandClaude Opus 5 259192f736 人手改的那一手真正落得下去;界面不撒谎那几处补齐
手改是**兜 AI 的错**的那一手 —— 这一轮把它从「摆在那儿但落不了地」做成真的:

件上就地改
· 保存**按地址收**,不看当下那张卡:载荷从前借道工单的 `blocks[i]` 取列名,
  于是熔断卡(没有 blocks)在屏上时,人补的那一格一个字都送不出去 ——
  而他要补的恰恰是把这一单卡住的那个必填格。授权面改由活动清单的台账声明把关。
· **能增删行**:错不止「这一格填错了」,还有「这一行不该在」与「漏了一行」。
  删挂记号不当场抹掉(看得见、可后悔),且**删要说出来**(`drops`)——
  「没回传就是删了」会把一次不完整的回传变成一次删表。
· **必填没填按不下提交**:与放行门 L1 同一个数同一套算法;闸上摆出差在哪一行哪一格。
· 只写真改了的那几行 —— 改一格却留「修订 4 行」的痕,那句话是假的。

判据与门
· 裁量判据带谓词时**谓词说了算**:「选填缺口已补齐」基座数得出来,
  人填好的目标价它照样判「客户未提供」的毛病由此消掉。
· 验收卡判据**读时现算** —— 人在成果件上补一格,判据跟着变。
· 放行门认「**办完了没有**」不认「有人写过」:从前写个 `false` 就把门推开,
  于是一单没打标就进了放行门。三个数全由基座现数。
· 拒回把「活没干完」说成「数或行对不上」的毛病:判据点名的表一行都没写时直说那一步没办。
  **指向两扇打不开的门,比不指还糟。**

界面不撒谎
· 日志只有三色:负责人绿 · 智能体蓝 · 系统灰(归侧五种是度量的分法,不是给人看的)。
· 验收收口答两件事:落了什么(按**交付物**点名,一份成果的几张表并成一行)、
  往哪儿去(转出哪一口、带过去哪些字段);一个口都没发就直说到此为止。
· 签完到收尾之间那一段有自己的话「字已签下,正在落地」—— 中间态本来就该说出来,只是要说对。
· 消息不再被内部事件刷屏:只有从通道进来的件才谈得上「无人认领」。
· 建客户公司与联系人**一次确认落两行**;联系人编码自增不问人;卡面摆表的人读名。

A1 三案例端到端全 released:全 A 类直通 12 拍 / 客户点名跳一条 10 拍 / 新客户缺必填 14 拍。
五道门禁全绿(971 passed)。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JsTDjoHovERXyy6Wmw1ALp
2026-08-02 13:41:44 +08:00

3.2 KiB

module: task

职责: 任务运行时:生命周期与终态五名裁定、Harness 预算执行器 / 停滞熔断、 控制三语义、改派、断点续跑的就绪判定、封卷与蒸馏钩子的触发 不负责: 范式的推进逻辑(见 loop-engine / flow-engine,经 ParadigmEngine 端口)、 放行与落地(见 release)、工作流的编排与聚合(见 process)

公开出口: index.ts

  • 类型:TaskService Task StartTaskInput TickOutcome Consumption HarnessVerdict ControlOutcome TerminalCause ResumeReadiness
  • 错误:TaskNotFoundError TaskAlreadyTerminalError
  • 端口类型:TaskStore ActivityLoader SchemaValidator ParadigmEngine MemoryRecorder ListenerProbe PersistenceProbe TaskEventPublisher ReassignNotifier InteractionPhaseSetter
  • 用例工厂:createTaskService(deps): TaskService
  • 纯函数:judge budgetBreaches isStalled terminalOf durationMs applyControl decideTerminal isSuccess triggersFailureDisposition resumeReadiness isPassiveOpen landingBlocked rejectionKeepsRunning
  • adapter:createTaskStore;Drizzle 表:taskTable

层级: L6(编码规范 §4) 依赖: @contracts;@shared/db;loop-engine / flow-engine / activity-registry(L5/L4); port 注入:memory / event / message / interaction / ledger 被依赖: process, org(停用前置检查的在途任务), report, app

近变(2026-07-30):Task / StartTaskInput 加 origin?(testbed = 设计台试跑)+ sys.task.origin 列。认得出试跑单才拔得掉 —— 工作流那侧靠 source->>'ref'='testbed' 认,任务这侧从前没有对应记号: 「试跑一个活动」起出来的单(不挂工作流)与登记直起单长得一模一样。

不变量(OS 04 / 4.3,AM 10 / 12.1):

  • 受理归一(2026-07-30 宽进,替代旧 AM 12.1「缺项不得启动」):输入可以不定或为空 —— 缺必填不拒单,任务落成 awaiting-human,缺的字段做成补全卡(IntakeDesk 端口)发给 负责人并武装 human 监听;答复只收契约声明过的键,合并进 data,齐了(或答「没法填」) 才转 running 开跑。等人期间谱一步不走、不扣步数;补全不占活动的人卡预算
  • 恰一负责人:任务必绑定恰一个 ownerId;改派留痕并通知双方
  • 输入必过 schema:data 缺项不得启动;message 计入初始观察但不得扩大授权
  • 预算环外强制:每一拍先 judge 再交引擎 —— 活动代码无从自查自守; 任一项触顶即 exhausted,空转即 stalled
  • 监听中是健康态:有监听在等或等人回传一律不算停滞
  • 终态五名封闭:decideTerminal 是唯一命名口;released 是唯一成功终态
  • 已终结不得再推进:tick / deliver 对终态任务抛 TaskAlreadyTerminalError —— 流级重做一律重开新实例,不复活旧任务
  • 叫停不是终态:转挂起待纠偏,并记最重档纠正信号
  • 封卷触发蒸馏:终态后 seal + distill,产出活动记忆候选条目
  • 断点续跑靠三份持久状态:任务记忆 / 草稿层 / 运行时实例状态,缺一即不可续