Archived
xcs
d788140548
放行存档(archiveAssetFiles)与在办列单(assetFilesOf)取行都用 taskView(where:{}) ——
那是「正式版全表 + 本单草稿」的合并视图,而资料常落在主数据上,整表里躺着别单放行过的行。
抽 assetRowsOf 两处同用,touched 为必填入参;e2e 补份数断言。
顺手清两笔:wake.test.ts 的 as unknown as(lint 红)、wake 契约的 api-report 快照(api:check 红)。
103 lines
4.9 KiB
TypeScript
103 lines
4.9 KiB
TypeScript
/**
|
|
* module: task —— 对外类型(编码规范 §10.1;语义出处 OS 04,AM 01/10)。
|
|
*
|
|
* 任务运行时:生命周期与**终态五名裁定**、Harness 预算执行器 / 停滞熔断、
|
|
* 控制三语义、改派、断点续跑。范式(loop / flow)在此汇流 —— 对流程层与交互层不可区分。
|
|
*/
|
|
import type { BudgetCaps, ControlSemantic, StaffId, TaskId, TaskRuntimeState, TerminalState } from '@contracts';
|
|
import type { BudgetBreach, Consumption, HarnessVerdict } from './internal/domain/harness.ts';
|
|
import type { ControlOutcome, ResumeReadiness, TaskSnapshot, TerminalCause } from './internal/domain/lifecycle.ts';
|
|
export type { BudgetBreach, BudgetCaps, Consumption, ControlOutcome, ControlSemantic, HarnessVerdict, ResumeReadiness, TaskRuntimeState, TaskSnapshot, TerminalCause, TerminalState, };
|
|
export declare class TaskNotFoundError extends Error {
|
|
readonly taskId: TaskId;
|
|
constructor(taskId: TaskId);
|
|
}
|
|
export declare class TaskAlreadyTerminalError extends Error {
|
|
readonly taskId: TaskId;
|
|
readonly terminal: TerminalState;
|
|
constructor(taskId: TaskId, terminal: TerminalState);
|
|
}
|
|
/** 一单任务 —— 活动的运行时实例;**恰有一名负责人** */
|
|
/** 落地事实的两种读法:铺平(标量取值)与逐行(数组取值)—— 输出口载荷由此装配 */
|
|
export type LandedFacts = {
|
|
readonly flat: Record<string, unknown>;
|
|
readonly rows: ReadonlyArray<{
|
|
key: Record<string, unknown>;
|
|
values: Record<string, unknown>;
|
|
}>;
|
|
};
|
|
export type Task = {
|
|
readonly id: TaskId;
|
|
readonly activityId: string;
|
|
/** 起单来源:工作流节点;登记触发的直起单为 undefined */
|
|
readonly workflowId?: string;
|
|
readonly nodeId?: string;
|
|
/** `testbed` = 设计台试跑 —— 认得出才拔得掉(仿真不该在别人工作台上过夜) */
|
|
readonly origin?: string;
|
|
readonly ownerId: StaffId;
|
|
readonly title: string;
|
|
readonly runtime: TaskRuntimeState;
|
|
readonly terminal?: TerminalState;
|
|
readonly reason?: string;
|
|
/** 装载信封:包版本 + 各资产生效版 —— 行为可归因 */
|
|
readonly envelope: Readonly<Record<string, unknown>>;
|
|
/** 起单入参:契约的 data —— 引擎求值的作用域底料 */
|
|
readonly data: Readonly<Record<string, unknown>>;
|
|
readonly caps: BudgetCaps;
|
|
readonly used: Consumption;
|
|
readonly startedAt: string;
|
|
readonly finishedAt?: string;
|
|
};
|
|
export type StartTaskInput = {
|
|
readonly activityId: string;
|
|
readonly ownerId: StaffId;
|
|
readonly title: string;
|
|
readonly workflowId?: string;
|
|
readonly nodeId?: string;
|
|
readonly origin?: string;
|
|
/** 输入:data(按 schema 校验,缺项不得启动)+ message(委托消息,可为空) */
|
|
readonly data: Record<string, unknown>;
|
|
readonly message?: string;
|
|
};
|
|
export type TickOutcome = {
|
|
readonly task: Task;
|
|
readonly verdict: HarnessVerdict;
|
|
readonly progressed: boolean;
|
|
};
|
|
export type TaskService = {
|
|
/** 起单:装载 → 校验输入 → 建任务记忆 → 首个回合 */
|
|
start(input: StartTaskInput): Promise<Task>;
|
|
get(taskId: TaskId): Promise<Task>;
|
|
listByOwner(ownerId: StaffId, openOnly?: boolean): Promise<Task[]>;
|
|
/** org 停用前置检查要问的「在途任务」 */
|
|
openTasksOf(ownerId: StaffId): Promise<Array<{
|
|
taskId: string;
|
|
title: string;
|
|
}>>;
|
|
/** 推进一拍:**预算在环外先扣先判**,再交范式引擎 */
|
|
tick(taskId: TaskId): Promise<TickOutcome>;
|
|
/** 事件驱动续跑 —— 挂起期间事件不丢,恢复即补投 */
|
|
deliver(taskId: TaskId, event: {
|
|
kind: 'data' | 'time' | 'human' | 'control';
|
|
ref: string;
|
|
payload: Record<string, unknown>;
|
|
}): Promise<TickOutcome>;
|
|
/** 控制三语义:暂停 / 叫停 / 终止 */
|
|
control(taskId: TaskId, semantic: ControlSemantic, by: StaffId, reason?: string): Promise<ControlOutcome>;
|
|
resume(taskId: TaskId, by: StaffId): Promise<Task>;
|
|
/**
|
|
* **人答复落库那一刻就把「在办事」写进投影**(2026-08-25):不等派发器投递、推进器
|
|
* 抢到租约再翻 —— 那几秒里对话区(卡状态已落)与工作区(读 runtime)说两句相反的话。
|
|
* 只在挂起等人 / 等外部时翻;已终结、暂停(suspended)、已在跑的原样不动。
|
|
* 返回翻没翻 —— 调用方据此决定要不要广播。
|
|
*/
|
|
wake(taskId: TaskId): Promise<boolean>;
|
|
/** 改派:在途任务的负责人变更,**留痕并通知双方** */
|
|
reassign(taskId: TaskId, to: StaffId, by: StaffId): Promise<Task>;
|
|
/** 终态裁定 —— 完成由框架裁定,终态由系统命名 */
|
|
/** `facts` = 落地收敛的事实(仅放行路径有);作为输出口载荷上报流程层 */
|
|
finish(taskId: TaskId, cause: TerminalCause, facts?: LandedFacts): Promise<Task>;
|
|
/** 断点续跑的三份持久状态是否齐备 */
|
|
resumeReadiness(taskId: TaskId): Promise<ResumeReadiness>;
|
|
};
|