This repository has been archived on 2026-09-13. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
BPOS-TMP-REPO/apps/api/src/modules/task/CONTRACT.md
T
xcsandClaude Fable 5 f3397a60ef E04 修到零被拒线,harness 补七刀:跨进程租约与广播桥、原子写、引用墙、对话区按序号排
活动侧(E04 2.1.0 → 2.1.9,I01 1.2.2):
- 覆盖闭合成为机检:基座新增 distinct 读数,「计划盖住的客户数 = 候选行数」钉进
  S3 收步 / S4 哨兵 / 放行 L2;人加的候选客户不再被整单无视
- 「关键人待识别」占位句式全链退役:查无联系人先发数据录入卡收人;契约新增 refersTo,
  计划/回执的 contact_code 只许引用真实存在的联系人(安装期核引用目标)
- 台账更新确认摆全落库面:客户档案/联系人档案两张落库预览(touched: 数据源,
  正式现值 + 草稿叠加),可补改、可加行(自增主键由基座续号);姓名升必填
- 更新明细:update_key 位置键 + 「同一处只留一条」L2;依据写人话不带机器键;
  标题旁不摆单号;判据与文案不夹字段名;行标识去掉单标识那一段
- 回执骨架 = 计划行数钉进 S3 收步与 S4 哨兵;重做分支不许删计划凑数
- 阶段刻度对齐文档 7 步;起单样例预填满

基座侧:
- 两个后端连同一个库:task-claim 跨进程租约(迁移 0030)+ Postgres LISTEN/NOTIFY
  广播桥;对话区按任务内记忆序号排,不按墙上时钟;并卡「刚说过话」按记忆序列判紧邻
- 多行 write 整批先验后写(dryRun),被拒 = 一行都没落
- 决策卡意见与本单草稿字面比对,归属以观察进轨迹(note-anchors)
- 括号栈补「补闭括号」两形(少一个 } / 行对象没关直接跟下一行)
- 件上加行:空着的自增主键直进续号,不从别的行借号;未落下的行点名回给前端
- 人答复落库那一刻就把 runtime 翻 running(task.wake),两块同帧变脸
- 试跑单可落真库(land_master,迁移 0031,默认开);数据域按活动分组;
  JSON 列不再是 [object Object];按钮键感 + 在办进度条 + 防抖
- 报价链 A1–A7 从系统卸载(只卸不删源码),种子只装 E04/I01

契约变更(api-report 已刷新):FieldDeclaration.distinct / refersTo,
objectDeclaration.file,landMaster,unkeyed,assetFiles,ledgerByActivityRoute。
1700 测 / typecheck / lint / depcruise / api:check 绿。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EEJX8Z7CHejvwmDQyPQuBX
2026-08-25 01:23:30 +08:00

3.6 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-08-25):TaskService.wake(taskId) —— 人答复落库那一刻就把 runtime 翻成 running 并 setPhase('active')(顺带广播);只对 awaiting-event / awaiting-human 生效, 已终结 / suspended / 已在跑的原样不动并返回 false。回传路由在返回之前调它, 让对话区(卡状态)与工作区(runtime)读到同一份事实。

近变(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,产出活动记忆候选条目
  • 断点续跑靠三份持久状态:任务记忆 / 草稿层 / 运行时实例状态,缺一即不可续