forked from ChaiHao/BPOS-MVP
M1: 底座 —— @contracts 首版 + event / ledger / org / llm
@contracts 首版(§8.1 九个文件): - id 品牌 ID / terminal 终态五名与归侧四标签 / envelope 信封六字段与四类事件 - card 工单两模式 + 对话卡族(形状对齐 2026-07-26 原型定稿) - contract7 契约七件 / ledger 三级寻址与写三分 / process-package 流程包 DSL 与触发器三类 - manifest 活动包清单六区(含 CMMN·DMN·步序声明的资产形状)/ org / api 路由契约 模块(L1): - event 信封存储、归属解析三级短路、投递五诺、监听注册表、三级消费裁定 - ledger schema 自生长(最大化合并/最宽类型/只增不破坏)、任务视图叠加、写三分、冲突检查 - org 岗位授权(客体三类×动作三种)、停用前置检查、会话、种子播种 - llm 四元绑定、ModelGateway 三模式(live/record/replay)—— 两缝之一 app 装配:Hono 服务 + 鉴权中间件 + 治理台/工作台路由;drizzle 迁移;AES-256-GCM 凭证密封 ADR-007 工具链与门禁 · ADR-008 投递队列 · ADR-009 凭证加密 (ADR 编号自 007 续:编码规范 §14 已用到 006,README 写「从 005 续」是笔误) 门禁五道全绿;96 个测试通过,含对真实 PG 的 ledger 集成测试 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
7cd664af3a
commit
14d4fa046a
@@ -0,0 +1,125 @@
|
||||
/**
|
||||
* 终态五名与非终态注记(编码规范 §8.1;语义出处 OS 4.3 / AM 1.3)。
|
||||
*
|
||||
* 终态由**系统**裁定,封闭枚举,活动与模型不得增删。
|
||||
*/
|
||||
import { z } from 'zod';
|
||||
|
||||
/** 终态五名 —— 唯一成功终态是 released(放行通过且落地收敛,输出口已发射) */
|
||||
export const TERMINAL_STATES = ['released', 'blocked', 'stalled', 'exhausted', 'terminated'] as const;
|
||||
export const terminalStateSchema = z.enum(TERMINAL_STATES);
|
||||
export type TerminalState = z.infer<typeof terminalStateSchema>;
|
||||
|
||||
export const TERMINAL_STATE_LABEL: Readonly<Record<TerminalState, string>> = {
|
||||
released: '放行完成',
|
||||
blocked: '受阻待人',
|
||||
stalled: '停滞熔断',
|
||||
exhausted: '预算耗尽',
|
||||
terminated: '被终止',
|
||||
};
|
||||
|
||||
/** 触发者 —— OS 4.3 的第三列 */
|
||||
export const TERMINAL_STATE_TRIGGER: Readonly<Record<TerminalState, string>> = {
|
||||
released: '放行卡 + 落地执行',
|
||||
blocked: 'Agent 机制申报,或治理台判定',
|
||||
stalled: '预算执行器 · 停滞检测',
|
||||
exhausted: '预算执行器 · 预算越限',
|
||||
terminated: '控制事件 · 终止(含工作流级联)',
|
||||
};
|
||||
|
||||
export function isSuccessTerminal(state: TerminalState): boolean {
|
||||
return state === 'released';
|
||||
}
|
||||
|
||||
/* ── 非终态注记(OS 4.3「不是终态」) ─────────────────────────────────── */
|
||||
|
||||
/** 驳回:放行卡的环内回转,任务继续 —— redo 按原要求重做 / revise 带意见迭代 */
|
||||
export const REJECTION_KINDS = ['redo', 'revise'] as const;
|
||||
export const rejectionKindSchema = z.enum(REJECTION_KINDS);
|
||||
export type RejectionKind = z.infer<typeof rejectionKindSchema>;
|
||||
|
||||
export const REJECTION_KIND_LABEL: Readonly<Record<RejectionKind, string>> = {
|
||||
redo: '驳回重做',
|
||||
revise: '驳回迭代',
|
||||
};
|
||||
|
||||
/** 控制三语义(OS 06):暂停 = 可恢复冻结 · 叫停 = 负责人紧急中断 · 终止 = 不可恢复关闭 */
|
||||
export const CONTROL_SEMANTICS = ['pause', 'halt', 'terminate'] as const;
|
||||
export const controlSemanticSchema = z.enum(CONTROL_SEMANTICS);
|
||||
export type ControlSemantic = z.infer<typeof controlSemanticSchema>;
|
||||
|
||||
export const CONTROL_SEMANTIC_LABEL: Readonly<Record<ControlSemantic, string>> = {
|
||||
pause: '暂停',
|
||||
halt: '叫停',
|
||||
terminate: '终止',
|
||||
};
|
||||
|
||||
/**
|
||||
* 任务运行态 —— 与终态分层:终态是收场名,运行态是「此刻在干嘛」。
|
||||
* landing-blocked(落地受阻)是运行态不是终态,处置后仍收敛于终态名录(OS 7.3)。
|
||||
*/
|
||||
export const TASK_RUNTIME_STATES = [
|
||||
'running',
|
||||
'awaiting-human',
|
||||
'awaiting-event',
|
||||
'suspended',
|
||||
'landing-blocked',
|
||||
'terminal',
|
||||
] as const;
|
||||
export const taskRuntimeStateSchema = z.enum(TASK_RUNTIME_STATES);
|
||||
export type TaskRuntimeState = z.infer<typeof taskRuntimeStateSchema>;
|
||||
|
||||
export const TASK_RUNTIME_STATE_LABEL: Readonly<Record<TaskRuntimeState, string>> = {
|
||||
running: '运行中',
|
||||
'awaiting-human': '等人回传',
|
||||
'awaiting-event': '监听中',
|
||||
suspended: '已挂起',
|
||||
'landing-blocked': '落地受阻',
|
||||
terminal: '已终结',
|
||||
};
|
||||
|
||||
/* ── 工作流状态:流内各任务状态的聚合投影(OS 3.2) ──────────────────── */
|
||||
|
||||
export const WORKFLOW_STATES = ['running', 'waiting', 'completed', 'terminated', 'abnormal'] as const;
|
||||
export const workflowStateSchema = z.enum(WORKFLOW_STATES);
|
||||
export type WorkflowState = z.infer<typeof workflowStateSchema>;
|
||||
|
||||
export const WORKFLOW_STATE_LABEL: Readonly<Record<WorkflowState, string>> = {
|
||||
running: '运行中',
|
||||
waiting: '等待中',
|
||||
completed: '已完成',
|
||||
terminated: '已终止',
|
||||
abnormal: '异常',
|
||||
};
|
||||
|
||||
/* ── 归侧四标签(OS 8.1):度量的口径来源,零埋点 ─────────────────────── */
|
||||
|
||||
export const ATTRIBUTION_SIDES = ['machine', 'human', 'human-verdict', 'world-wait'] as const;
|
||||
export const attributionSideSchema = z.enum(ATTRIBUTION_SIDES);
|
||||
export type AttributionSide = z.infer<typeof attributionSideSchema>;
|
||||
|
||||
export const ATTRIBUTION_SIDE_LABEL: Readonly<Record<AttributionSide, string>> = {
|
||||
machine: '机器产出',
|
||||
human: '人产出',
|
||||
'human-verdict': '人裁决',
|
||||
'world-wait': '世界等待',
|
||||
};
|
||||
|
||||
/* ── 验收分级 L1–L5(AM 10.2) ──────────────────────────────────────── */
|
||||
|
||||
export const ACCEPTANCE_LEVELS = ['L1', 'L2', 'L3', 'L4', 'L5'] as const;
|
||||
export const acceptanceLevelSchema = z.enum(ACCEPTANCE_LEVELS);
|
||||
export type AcceptanceLevel = z.infer<typeof acceptanceLevelSchema>;
|
||||
|
||||
export const ACCEPTANCE_LEVEL_LABEL: Readonly<Record<AcceptanceLevel, string>> = {
|
||||
L1: '形式校验 · 引擎自动',
|
||||
L2: '机检 · 引擎自动',
|
||||
L3: '抽验 · 环内实证',
|
||||
L4: '独立评审 · LLM 评审者',
|
||||
L5: '人放行 · 责任关',
|
||||
};
|
||||
|
||||
/** L1–L4 是质量关,L5 是责任关 —— 判据全绿只是可提交,完成只出自放行通过 */
|
||||
export function isResponsibilityGate(level: AcceptanceLevel): boolean {
|
||||
return level === 'L5';
|
||||
}
|
||||
Reference in New Issue
Block a user