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-MVP/packages/activity-sdk/src/define.ts
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

38 lines
1.7 KiB
TypeScript

/**
* `defineActivity()` —— 活动包的 ABI 入口(ADR-004)。
*
* 「单文件 ESM,**默认导出** `defineActivity()` 的返回值;能力全部注入(基座六件句柄),
* **零环境能力**;静态审扫描产物 import 与全局引用。」
*/
import type { ActivityBase } from './base.ts';
/** 活动的运行结论 —— 提交放行是唯一的成功出路 */
export type ActivityOutcome =
/** 判定成果已齐,提交放行(必交付物齐备、判据全绿只是可提交) */
| { readonly kind: 'submit'; readonly deliverable: string; readonly rationale: string }
/** 等外界:已立监听,回合到此为止 */
| { readonly kind: 'await'; readonly reason: string }
/** 无法推进,申报受阻待人 */
| { readonly kind: 'blocked'; readonly reason: string };
export type ActivityDefinition = {
readonly name: string;
/**
* 一个回合的推进 —— **可选**。
*
* 2026-07-29 范式退役后,活动一律案例模型:推进由 Loop 驱动(定位 → 择向 → 决断 →
* 行动),行动落在基座上,不经活动代码。所以绝大多数活动**不需要 run** ——
* 它的行为写在清单里(案例模型 + 说明书 + DMN + 技能 + 台账声明),
* 「系统不执行代码即知包为何物」。
*
* 留着它是为确定性子序列(结晶片段)将来有个落点;不写就是不写,不是缺件。
* 活动不自转、不自设 maxSteps;预算与熔断由基座在环外强制。
*/
run?(base: ActivityBase): Promise<ActivityOutcome>;
};
export function defineActivity(definition: ActivityDefinition): ActivityDefinition {
if (definition.name.trim() === '') throw new Error('活动必须有名字');
return Object.freeze(definition);
}