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/toolbox/internal/adapter/toolbox-schema.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

86 lines
3.6 KiB
TypeScript

/**
* toolbox 的 sys schema 表(编码规范 §7 / ADR-002 / ADR-009)。
*/
import { boolean, index, integer, jsonb, primaryKey, text, timestamp, uniqueIndex } from 'drizzle-orm/pg-core';
import { sys } from '@shared/db.ts';
export const toolTable = sys.table(
'tool',
{
/** 中文名 —— 人读的主名(治理台主显示);存量行以逻辑名兜底 */
displayName: text('display_name'),
name: text('name').primaryKey(),
version: text('version').notNull(),
description: text('description').notNull(),
input: jsonb('input').notNull(),
output: jsonb('output').notNull(),
effect: text('effect').notNull(),
errors: jsonb('errors').notNull().default([]),
idempotent: boolean('idempotent').notNull().default(false),
timeoutMs: integer('timeout_ms').notNull().default(30_000),
retries: integer('retries').notNull().default(1),
connectionKeys: jsonb('connection_keys').notNull().default([]),
capabilities: jsonb('capabilities'),
/** 面向人的作业指导段 —— 转人时照抄上卡,不临场让模型编步骤(§6.2) */
guide: jsonb('guide'),
pure: boolean('pure').notNull().default(false),
ownerActivityId: text('owner_activity_id'),
/** 凭证隔离:值加密落库,不入包、不入活动、不入留痕明文(ADR-009) */
connectionCipher: jsonb('connection_cipher'),
enabled: boolean('enabled').notNull().default(true),
registeredAt: timestamp('registered_at', { withTimezone: true }).notNull().defaultNow(),
},
(t) => [index('tool_effect_idx').on(t.effect), index('tool_owner_idx').on(t.ownerActivityId)],
);
/** 白名单:授权在白名单与契约,不在活动代码(OS 04) */
export const toolAllowlistTable = sys.table(
'tool_allowlist',
{
activityId: text('activity_id').notNull(),
tool: text('tool').notNull(),
},
(t) => [primaryKey({ columns: [t.activityId, t.tool] })],
);
/** 工具录制回放 —— 与 llm 的 replay_model 同构(§7.3 两缝) */
export const replayToolTable = sys.table('replay_tool', {
key: text('key').primaryKey(),
call: jsonb('call').notNull(),
result: jsonb('result').notNull(),
recordedAt: timestamp('recorded_at', { withTimezone: true }).notNull().defaultNow(),
});
/**
* 工具转人台(§6.2 未命中转人)—— **人是工具的一种实现**。
*
* 系统里没有这件工具(无契约或有契约无实现)时,不报错、不空转:开一张执行卡请人来做,
* 人填回的表单值**就是这次工具调用的出参**。这张表记的就是「这次调用交给谁、答没答、答了什么」。
*
* `callKey` 是内容地址(工具 + 入参指纹):同一个调用重问一次拿的是同一份答案 ——
* 没有它,Loop 每拍都会为同一件事再发一张卡。
*/
export const toolHandoffTable = sys.table(
'tool_handoff',
{
id: text('id').primaryKey(),
taskId: text('task_id').notNull(),
tool: text('tool').notNull(),
/** 内容地址:工具 + 入参指纹 —— 同调用同答案 */
callKey: text('call_key').notNull(),
input: jsonb('input').notNull(),
/** 请人做的那张执行卡 */
workOrderId: text('work_order_id').notNull(),
/** pending = 已发卡等答;answered = 人已填,出参可取 */
state: text('state').notNull().default('pending'),
/** 人填回的值 = 工具出参 */
output: jsonb('output'),
createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
answeredAt: timestamp('answered_at', { withTimezone: true }),
},
(t) => [
uniqueIndex('tool_handoff_call_key').on(t.taskId, t.callKey),
index('tool_handoff_order_idx').on(t.workOrderId),
],
);