taskboard-workbench 0.3.0 → 0.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +106 -0
- package/README.md +6 -0
- package/index.js +39 -6
- package/package.json +8 -3
- package/scripts/tb-flow.mjs +109 -8
- package/skills/taskboard-flow/SKILL.md +1 -1
- package/skills/taskboard-flow/references/injection.md +77 -24
- package/spec/docs/01-/351/241/271/347/233/256/345/274/200/345/261/200.md +63 -0
- package/spec/docs/02-/346/265/201/347/250/213/346/211/247/350/241/214/344/270/216/346/235/241/347/233/256.md +110 -0
- package/spec/docs/README.md +36 -0
- package/spec/docs/assets//346/235/241/347/233/256/350/257/246/346/203/205/346/250/241/346/235/277.md +105 -0
- package/spec/norms/item-detail.md +73 -0
- package/spec/norms/manifest.json +7 -0
- package/src/core/contract.mjs +17 -7
- package/src/core/docs-assets.mjs +135 -0
- package/src/core/errors.mjs +2 -0
- package/src/core/flow-inject.mjs +190 -0
- package/src/core/kickoff.mjs +289 -0
- package/src/core/norms.mjs +177 -0
- package/src/core/requirements.mjs +38 -0
- package/src/core/store.mjs +196 -35
- package/src/core/ticket-stage.mjs +13 -1
- package/src/core/verify.mjs +12 -4
- package/src/mcp/flow-block.mjs +30 -0
- package/src/mcp/server.mjs +26 -7
- package/src/mcp/tools.mjs +9 -3
- package/src/server/api.mjs +234 -6
- package/web/app.js +656 -78
- package/web/tokens.css +137 -28
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,112 @@
|
|
|
6
6
|
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
|
|
7
7
|
每个版本对应一个 annotated tag(`vX.Y.Z`)与一条 GitHub Release;npm dist-tag 与 dsh 兼容区间随版本记录。
|
|
8
8
|
|
|
9
|
+
## [0.3.2] - 2026-11-06
|
|
10
|
+
|
|
11
|
+
> 主题:**把三轮「卡上已收口、包里还没有」的改动一次补齐** —— `0.3.1` 之后又攒了开局长注入(P5 档 C)、
|
|
12
|
+
> 开局对齐(R170)、真机批注批(六条)与规范随包(`4c8f8a9`)四项进包变更,按 D7 攒批一次发。
|
|
13
|
+
> 版号 `0.3.2` 为 2026-11-06 拍板结果(`0.3.x` 期内 patch 号承载「修复 + 可选能力」,不另起 `0.4.0` 线;
|
|
14
|
+
> `0.4.0` 留给计划文档里预留的「确认层 `acceptance_state`」,那批尚未开工)。
|
|
15
|
+
> 读数:`npm test` **1143 / 0** · `release-precheck` **EXIT=0** · tarball **83** 文件 · `schemaVersion` **13 → 14**。
|
|
16
|
+
|
|
17
|
+
### 新增
|
|
18
|
+
|
|
19
|
+
- **开局注入 · P5 档 C(卡 `-210` / 需求 `R128`,`ede1d01`)** —— 新模块 `src/core/flow-inject.mjs`;
|
|
20
|
+
项目设置增 `flow_inject_policy`(`off` / `main-only` / `main+exec` / `all`),
|
|
21
|
+
宿主 `createSession` 出口按 **policy × role** 分流:主会话拿完整流程块(逐字节等于 `tb-flow start`),
|
|
22
|
+
执行会话拿摘要版,子代理不注入。**默认 `off` ⇒ 升级后行为零变化**,必须显式开。
|
|
23
|
+
注入异常只回 `injection.reason`、**不阻断会话创建**(建会话失败比少注入一句严重得多)。
|
|
24
|
+
- **项目开局对齐 · 可直接进主对话(卡 `-229`/`-230`/`-231` / 需求 `R170`,`ede1d01`)** —— 新模块 `src/core/kickoff.mjs`:
|
|
25
|
+
把「项目开局还缺什么」生成成**分步 todolist 正文**并投递进项目主会话;项目未绑主会话时抛新错误码
|
|
26
|
+
**`NO_MAIN_SESSION`**(冲突类,不是数据错误 —— 与「这件事做不到」区分开)。
|
|
27
|
+
- **需求条目简写 `R170`(卡 `-234` / 需求 `R171`,`ede1d01`)** —— 带项目上下文时可直接写简写;
|
|
28
|
+
**不带项目时不跨项目猜**,而是把各项目同序号的全标识列成候选。
|
|
29
|
+
`REQUIREMENT_NOT_FOUND` 收敛到唯一构造点,`details.hint` + `details.examples` 给**可直接照抄**的写法(报错即文档)。
|
|
30
|
+
- **兼容层与配置分离(卡 `-216`/`-218`/`-219`/`-220` / 需求 `R159`–`R161`,`4c8f8a9`)** ——
|
|
31
|
+
① 需求条目 `detailState` 派生三态(`mirror` / `truncated` / `full`),列表胶囊 + 详情「完整性」字段(真实库 87/9/60);
|
|
32
|
+
② `spec/norms/item-detail.md` 入册(`NORM_IDS` 5 → 6)+ 项目副本 `<工作区>/.taskboard/norms/` + 配置页「规范来源」卡片;
|
|
33
|
+
③ `spec/docs/` 四份通用人读文档入包,配只读守卫 `tools/check-docs.mjs`;
|
|
34
|
+
④ `GET|POST|PUT /api/projects/:id/docs` + 配置页「文档与规范位置」卡片:**包内默认 / 项目存放(可改)/ 生效来源**三栏都可见可改。
|
|
35
|
+
- **任务抽屉按钮分层(卡 `-224` / 需求 `R164`)** —— 标题栏拆 `.tb-drawer-actions`(卡片级动作)与
|
|
36
|
+
`.tb-drawer-utils`(全部收起 / 全屏 / 关闭)两段,中间画发丝线,位置不再由 `append` 顺序决定;
|
|
37
|
+
并保证**全抽屉至多一个 primary**(此前一屏 5–7 个同权重蓝块,人看不出该点哪个)。只做呈现,不删按钮、不改回调。
|
|
38
|
+
- **真机批注四条(`-225`–`-228` / 需求 `R166`–`R169`)** —— 需求工具栏回归一栏;「引入的文件」按文件夹树呈现
|
|
39
|
+
(对齐 dsh 侧栏样式);配置页会话关联可直接跳转主会话 / 相关会话;配置页八步引导按**真实代码**重排
|
|
40
|
+
(此前「开局提示词」排在第八步,与实际流程不符)。
|
|
41
|
+
- **启动分步容错 + 常驻降级条(卡 `-222` / 需求 `R163`)** —— 启动改 `runBootStep` 分步执行:可降级步骤失败时**面板照常可用**,
|
|
42
|
+
并在顶部留一条**不会自动消失**的说明条(带「重试」+ 失败原因)。与一次性 banner 分开 —— banner 到时会消失,用户就再也看不到"为什么少了一半数据"。
|
|
43
|
+
|
|
44
|
+
### 修复
|
|
45
|
+
|
|
46
|
+
- **复核命令超限被静默截断(卡 `-232`,`ede1d01`)** —— 真机事故:`verifyCommand` 超过 300 字符时被 `slice(0,300)` **静默切开**,
|
|
47
|
+
命令变成语法错误 ⇒ 自动复核**恒 exit 2**,人只会看到「自动复核失败」。改为**抛 `USAGE_ERROR` 并带上实际长度与上限**,
|
|
48
|
+
不再截断(截断比报错危险得多:它把"存不进去"伪装成"跑不过")。全库 33 张带复核命令的卡里只有一张中招。
|
|
49
|
+
- **三台既有验证台 PASS 却不退出(卡 `-223`)** —— 只置 `process.exitCode` 而不 `process.exit()` 的台必须自己清句柄;
|
|
50
|
+
实测漏的是 **CDP WebSocket** 与 server 的 keep-alive 连接 ⇒ 11/11 PASS 却被 `timeout` 杀成退出码 124。
|
|
51
|
+
|
|
52
|
+
### 变更
|
|
53
|
+
|
|
54
|
+
- **`CHANGELOG [0.3.1]` 段事实修正(卡 `-213`,`34db1b4`)** —— 修正对 `0.3.0` 发布事实的描述,只改文案、不改已发布内容。
|
|
55
|
+
|
|
56
|
+
### 兼容性与升级注意
|
|
57
|
+
|
|
58
|
+
- **`schemaVersion` 13 → 14**:新增 `project_settings.flow_inject_policy`。**老库打开即幂等补列**(默认 `off`),无需迁移脚本。
|
|
59
|
+
- **零新增运行期依赖**:`node --test` 仍是唯一门禁。`eslint` / `prettier` 是**可选**开发工具,**不随包发布**,
|
|
60
|
+
未安装时 `npm run lint` 会报 command not found —— 属预期。
|
|
61
|
+
- **新错误码 `NO_MAIN_SESSION`**:调用方若按错误码分支,需认识这个新值(属冲突类,`EXIT.CONFLICT`)。
|
|
62
|
+
- **`engines.dsh` 仍为 `>=0.2.1-rc.3`**:本机已在 `0.2.1-rc.5` 上复跑宿主能力门 **9/9 PASS**;下限不动(floor 不是 pin)。
|
|
63
|
+
- **tarball 82 → 83 文件**:只增 `spec/norms/item-detail.md`。`tools/` 与 `.github/` 不在 `files` 白名单,开发工具不计入包内容。
|
|
64
|
+
|
|
65
|
+
## [0.3.1] - 2026-11-04
|
|
66
|
+
|
|
67
|
+
> 主题:**7 笔攒批一次发**(`v0.3.0` 后连续攒到 6 项进包变更 + 1 项打包声明),把「卡上收口了、包里还没到」这段补齐。
|
|
68
|
+
> 发布轨:`0.2.0` → `0.3.0` → **`0.3.1`** **连续发布**(三个版本都在 registry 上);D7「攒批」体现在 **`0.3.0` 之后又攒了 7 笔才发 `0.3.1`** —— 攒的是**变更**,不是跳过版本。
|
|
69
|
+
> `npm test` **986 / 0**、`release-precheck` **EXIT=0**、tarball **75** 文件。
|
|
70
|
+
|
|
71
|
+
### 新增
|
|
72
|
+
|
|
73
|
+
- **`--read-only` 回滚开关(卡 `-208` / 需求 `R153`,`260bdf6`)** —— P3 设计稿承诺的逃生口此前从未实现:
|
|
74
|
+
`--read-only` 下 MCP 工具面 **9 → 5**(只留只读工具),写入类工具不注册而非「注册后报错」——
|
|
75
|
+
注册了就等于告诉调用方「有这条路」,而它注定失败。反向对照:不带开关时 9 个工具全在。
|
|
76
|
+
- **`engines.dsh` 打包声明(卡 `-212` / 需求 `R156`,`2385e11`)** —— `package.json` 增 `engines.dsh: ">=0.2.1-rc.3"`
|
|
77
|
+
(下限=首个实际验证过的宿主版本)。插件市场卡片的 `DSH <range>` 标签读的就是它,此前 `engines` 只有 `node`
|
|
78
|
+
⇒ 卡片只能显示「未声明宿主要求」。**生效时序**:本版发布后,还要等上游 `probe-npm` 与一轮 nightly 重建索引才会显形。
|
|
79
|
+
|
|
80
|
+
### 修复
|
|
81
|
+
|
|
82
|
+
- **「下一步」把半残回包当成「无待办动作」(卡 `-211` / 需求 `R155`,`e8c226b`)** —— 真机事故:宿主未重载时服务端仍回旧形状
|
|
83
|
+
`ticketStage.next = {code,title}`,而前端兜底只判 `next` 是否为 `null` ⇒ 半残回包绕过「旧版服务端」提示,
|
|
84
|
+
落到 else 分支输出**错误结论**「本卡无待办动作。」(那张卡其实只差人点「完成」,且没有「完成」按钮)。
|
|
85
|
+
修:判据改为**按形状**——缺 `steps/focus/actions/hint/blocker` 任一即提示「引导不完整(旧版服务端)」;
|
|
86
|
+
`actions: []` 仍是已收口卡的**合法**形态(空数组是真值,齐全必须回 `null`,首版自测即抓到)。
|
|
87
|
+
**守卫**:新增第 15 台 `tools/bench-next-step-shape.mjs`(真 headless Chrome + CDP;前置代理把详情回包降级成旧形状,
|
|
88
|
+
不必真退回旧进程),A/B/C/D 四组 **11/11 PASS**;反向对照(判据退回 `if (!step)`)**9/11**、A1/A2 双红。
|
|
89
|
+
- **任务抽屉三处判断收敛到单一口径(卡 `-199` / 需求 `R151`,`1c83059`)** —— 「下一步 / 看护 / 诊断」不再各自打
|
|
90
|
+
`/next-step` 与 `/execution`(一次请求算一次、还会落库),统一消费详情里那一份 `ticketStage`;
|
|
91
|
+
诊断在详情 GET 里**真实求值但零写**(`persist:false`),计数字段从已落库行补回,保住「详情 GET 无写副作用」这条不变量。
|
|
92
|
+
|
|
93
|
+
### 变更
|
|
94
|
+
|
|
95
|
+
- **契约门切 `reject`(R-A,卡 `-209`,`9bb5fcf`)** —— 调用方带 `contract` 且版本/摘要不符时,由「照常写入 + 一条 `contract-warn` 审计」
|
|
96
|
+
改为**拒绝写入**;校验整体前移到事务之前(拒绝即零副作用)。不带 `contract` 仍按 `skipped` 向后兼容。
|
|
97
|
+
⚠ **这是一处行为口径变更**:靠「带错契约也能写」跑通的脚本会开始报错——请先核对调用方是否带对了 `contract`。
|
|
98
|
+
- **`flow_inject_policy` 明标未实现(卡 `-186` / 需求 `R141`,`ad98227`)** —— 技能文档三处(标题 / 顶部警示 / 预埋项表格)
|
|
99
|
+
写明「未实现(全仓无 reader)」,并加缺口守卫 `tests/flow-inject-policy-gap.test.mjs`:扫 `src/scripts/web/cli/tools/spec`
|
|
100
|
+
断言该键命中 **0**,将来接线却没更新文档即转红(反向对照:临时探针 ⇒ 2/3 转红)。
|
|
101
|
+
|
|
102
|
+
### 移出
|
|
103
|
+
|
|
104
|
+
- **`dsh --import` shim 死代码下线(卡 `-207` / 需求 `R152`,`f1e4216`)** —— **13 文件 / +13 −538**:
|
|
105
|
+
三个 shim 早已被宿主能力位取代,留着只会让人以为还有那条路;残留引用一并清理。
|
|
106
|
+
|
|
107
|
+
### 兼容性与升级注意
|
|
108
|
+
|
|
109
|
+
- **npm `latest` = `0.3.1`**(`0.2.0` → `0.3.0` → `0.3.1` 连续发布,registry 三个版本都在)。若你从 `0.2.0` 直接升上来:`0.3.0` 的条目**同样适用**(`v0.3.0` tag 与源码快照仍在),`0.3.1` 是在它之上追加的 7 笔变更。
|
|
110
|
+
- **`engines.dsh = ">=0.2.1-rc.3"`**:宿主低于此版本不再满足声明(此前未声明,等于默认可装)。本版是本机验证过的形态。
|
|
111
|
+
- **契约门是行为变更**(上条 `-209`):升级后请重新核对 CI/脚本里的 `contract` 版本与摘要。
|
|
112
|
+
- **`schemaVersion` 仍为 13**(本版无表结构变更,`-197` 引入的两表已在 `0.3.0` 就位)。
|
|
113
|
+
- 插件市场卡片出现 `DSH >=0.2.1-rc.3` 标签**不等于**发布当天可见:需上游 `probe-npm` + 一轮 nightly 重建索引。
|
|
114
|
+
|
|
9
115
|
## [0.3.0] - 2026-11-03
|
|
10
116
|
|
|
11
117
|
> 主题:让「待验收 → 确认」这段**先变得可信** —— 有度量、有事件、有单一口径、有结构化证据。
|
package/README.md
CHANGED
|
@@ -96,9 +96,15 @@ CLI 约定:成功 `stdout` 输出 JSON(含 `schemaVersion`),退出码 `0
|
|
|
96
96
|
```bash
|
|
97
97
|
node src/mcp/server.mjs --data-dir "$TB_DATA_DIR" # MCP 客户端作为子进程拉起(stdio)
|
|
98
98
|
node src/mcp/server.mjs --print-tools # 只打印工具清单(调试用)
|
|
99
|
+
node src/mcp/server.mjs --read-only # **只读模式**:只暴露五件只读工具,写四件调用即 READ_ONLY_MODE
|
|
99
100
|
npm run mcp -- --data-dir "$TB_DATA_DIR" # 同上,走 npm script
|
|
100
101
|
```
|
|
101
102
|
|
|
103
|
+
`--read-only` 是写工具的**回滚开关**(写路径出问题时的逃生口):`tools/list` 里不再出现
|
|
104
|
+
`card_create` / `card_progress` / `requirement_upsert` / `requirement_change`,直接调用返回
|
|
105
|
+
`isError:true` + `code=READ_ONLY_MODE`(**不是**「未知工具」,便于区分「开关生效」与「名字拼错」)。
|
|
106
|
+
不带该参数时行为不变(9 个工具)。
|
|
107
|
+
|
|
102
108
|
传输是 **stdio + newline-delimited JSON-RPC 2.0**(MCP stdio transport):
|
|
103
109
|
**不占端口、不碰 `:3080`、不写 `~/.dsh/**`、不需要重载宿主**,每个 agent 会话一个进程。
|
|
104
110
|
|
package/index.js
CHANGED
|
@@ -23,6 +23,8 @@ import { createEventHub } from "./src/server/events.mjs";
|
|
|
23
23
|
import { runExecutionLoop, listLoopProjects } from "./src/core/loop.mjs";
|
|
24
24
|
import { createLlmElaborator } from "./src/host/ai-elaborator.mjs";
|
|
25
25
|
import { createTeamEnginePort } from "./src/host/team-engine.mjs";
|
|
26
|
+
// P5 档 C(卡 `-210`):开局注入的唯一实现 —— 宿主建会话出口与 `tb-flow inject` 共用同一段判定。
|
|
27
|
+
import { injectFlow } from "./src/core/flow-inject.mjs";
|
|
26
28
|
|
|
27
29
|
export const name = "taskboard-workbench";
|
|
28
30
|
export const inject = ["webServer"];
|
|
@@ -34,19 +36,25 @@ export const PREFIX = "/integrations/taskboard-workbench";
|
|
|
34
36
|
*
|
|
35
37
|
* 对齐 agent-teams 的**懒取**模式:不在 apply 时 eager 取服务,而是每次调用时经 `getService(name)` 现取,
|
|
36
38
|
* 因此服务在插件之后出现/被替换时自然生效(无需 eager 注入)。
|
|
37
|
-
* - createSession({preset,cwd,title}):`sessionController.create()`(退回 `sessions.create`);`cwd` 透传工作区;
|
|
39
|
+
* - createSession({preset,cwd,title,role,projectId}):`sessionController.create()`(退回 `sessions.create`);`cwd` 透传工作区;
|
|
38
40
|
* 宿主 `create()` **不收 title** ⇒ `title` 走**建完再 `rename()`**(改名失败如实回 `titleApplied:false` + 原因,不谎报);
|
|
39
41
|
* **尝试**预置内容,失败不抛错。
|
|
42
|
+
* **P5 档 C(卡 `-210`)**:建完按项目 `flow_inject_policy` 做**开局注入**(`main`=完整版 / `exec`+`related`=摘要版 /
|
|
43
|
+
* `subagent`=不注入);注入异常**只回 `injection.reason`,不阻断会话创建**(见 `src/core/flow-inject.mjs`)。
|
|
40
44
|
* - renameSession(id, title):会话改名(2026-10-23 命名约束的宿主出口)。
|
|
41
45
|
* - sendPrompt(id, text):**任务下发**。经 `sessionController.prompt({mode:"queue"})` 把指令投递给该会话的 Agent。
|
|
42
46
|
* - openSession(id):宿主侧无此能力(返回 ui-workspace-unavailable);会话切换由**客户端** uiWorkspace 完成(见 lib/client.js)。
|
|
43
47
|
* - getCurrentSessionId():宿主工具面才有 `exec.agent?.id`,此处恒返回 null(接口占位)。
|
|
44
48
|
*/
|
|
45
|
-
export function createHostSessionPort({ getService, getCtx } = {}) {
|
|
49
|
+
export function createHostSessionPort({ getService, getCtx, getStore } = {}) {
|
|
46
50
|
const sessions = () => getService?.("sessions");
|
|
47
51
|
const sessionController = () => getService?.("sessionController");
|
|
48
52
|
const agents = () => getService?.("agents");
|
|
49
53
|
const uiWorkspace = () => getService?.("uiWorkspace");
|
|
54
|
+
/** 注入用 store(懒取):宿主未给 store(单测 / 纯 adapter 用法)⇒ 一律不注入,行为与接线前完全一致。 */
|
|
55
|
+
const store = () => {
|
|
56
|
+
try { return getStore?.() ?? null; } catch { return null; }
|
|
57
|
+
};
|
|
50
58
|
const mkRequestId = () =>
|
|
51
59
|
(globalThis.crypto?.randomUUID?.() ?? `tb-${Date.now()}-${Math.random().toString(36).slice(2)}`);
|
|
52
60
|
// ---- 作用域取服务(FR-71 投递修复)------------------------------------------
|
|
@@ -227,12 +235,33 @@ export function createHostSessionPort({ getService, getCtx } = {}) {
|
|
|
227
235
|
const r = await renameSession(sessionId, title);
|
|
228
236
|
return { titleApplied: Boolean(r.renamed), titleReason: r.renamed ? null : (r.reason ?? "rename-failed") };
|
|
229
237
|
}
|
|
238
|
+
/**
|
|
239
|
+
* P5 档 C(卡 `-210`):建会话后的**开局注入**出口。
|
|
240
|
+
*
|
|
241
|
+
* 三条纪律:
|
|
242
|
+
* ① **绝不抛错**:`injectFlow()` 自身不抛,这里再兜一层 —— 注入失败只回 `injection.reason`,
|
|
243
|
+
* **会话创建照旧成功**(验收 ⑤:失败不改行为);
|
|
244
|
+
* ② **按 policy × role 分流**:判定在 `src/core/flow-inject.mjs`(唯一实现),这里只负责「把 store 和
|
|
245
|
+
* 投递通道递过去」;`role` 由调用方声明(主会话 `main` / 任务执行会话 `exec`)——
|
|
246
|
+
* **没声明就不注入**(宁可少注,不可错注;`role-unknown`);
|
|
247
|
+
* ③ **内容只有一处生成**:`injectFlow()` 内部调 `buildFlowBlock()`(完整版逐字节等于 `tb-flow start`)。
|
|
248
|
+
*/
|
|
249
|
+
async function injectOpeningFlow({ sessionId, role, projectId, cwd }) {
|
|
250
|
+
const st = store();
|
|
251
|
+
if (!sessionId || !st) return { injected: false, reason: st ? "no-session" : "no-store" };
|
|
252
|
+
try {
|
|
253
|
+
return await injectFlow({ store: st, deliver, sessionId, role: role ?? null, projectId: projectId ?? null, cwd: cwd ?? null, policy: null, source: "createSession" });
|
|
254
|
+
} catch (error) {
|
|
255
|
+
console.error(`[taskboard-workbench] flow inject failed: ${error?.message ?? error}`);
|
|
256
|
+
return { injected: false, reason: error?.code ?? String(error?.message ?? error ?? "inject-error") };
|
|
257
|
+
}
|
|
258
|
+
}
|
|
230
259
|
return {
|
|
231
260
|
/** 动态可用性:能否建会话 / 投递指令。 */
|
|
232
261
|
get available() {
|
|
233
262
|
return typeof sessionController()?.create === "function" || typeof sessions()?.create === "function";
|
|
234
263
|
},
|
|
235
|
-
async createSession({ preset, cwd, title } = {}) {
|
|
264
|
+
async createSession({ preset, cwd, title, role = null, projectId = null } = {}) {
|
|
236
265
|
const sc = (await scopedSessionController("tb-session:new")) ?? sessionController();
|
|
237
266
|
if (typeof sc?.create === "function") {
|
|
238
267
|
try {
|
|
@@ -244,7 +273,9 @@ export function createHostSessionPort({ getService, getCtx } = {}) {
|
|
|
244
273
|
const sessionId = typeof created === "string" ? created : (created?.sessionId ?? created?.id ?? null);
|
|
245
274
|
const named = await applyTitle(sessionId, title);
|
|
246
275
|
const presetApplied = sessionId && preset ? (await deliver(sessionId, preset)).sent : false;
|
|
247
|
-
|
|
276
|
+
// 开局注入排在「预置指令」之后:先给人/agent 看这一轮的任务,再补流程护栏(顺序可观测、可测)。
|
|
277
|
+
const injection = await injectOpeningFlow({ sessionId, role, projectId, cwd });
|
|
278
|
+
return { sessionId, presetApplied, titleApplied: named.titleApplied, titleReason: named.titleReason, injection };
|
|
248
279
|
} catch (error) {
|
|
249
280
|
console.error(`[taskboard-workbench] sessionController.create failed: ${error?.message ?? error}`);
|
|
250
281
|
}
|
|
@@ -263,7 +294,8 @@ export function createHostSessionPort({ getService, getCtx } = {}) {
|
|
|
263
294
|
}
|
|
264
295
|
const namedFallback = await applyTitle(sessionId, title);
|
|
265
296
|
const presetApplied = sessionId && preset ? (await deliver(sessionId, preset)).sent : false;
|
|
266
|
-
|
|
297
|
+
const injection = await injectOpeningFlow({ sessionId, role, projectId, cwd });
|
|
298
|
+
return { sessionId, presetApplied, titleApplied: namedFallback.titleApplied, titleReason: namedFallback.titleReason, injection };
|
|
267
299
|
},
|
|
268
300
|
/**
|
|
269
301
|
* 会话改名(2026-10-23 用户命名约束「【任务】/【项目】+ 时间/备注」的宿主出口)。
|
|
@@ -513,7 +545,8 @@ export function apply(ctx, config) {
|
|
|
513
545
|
})();
|
|
514
546
|
const runtime = createPluginRuntime({ dataDir: config?.dataDir ?? hostDataDir, aiElaborator });
|
|
515
547
|
// 挂载宿主会话能力(懒取服务);api 层经 store.hostSessionPort 使用。
|
|
516
|
-
|
|
548
|
+
// `getStore`:P5 档 C(卡 `-210`)注入用 —— 只读项目设置 + 写 `flow_injections` 审计;不给 store 则一律不注入。
|
|
549
|
+
runtime.store.hostSessionPort = createHostSessionPort({ getService: (name) => ctx?.get?.(name), getCtx: () => ctx, getStore: () => runtime.store });
|
|
517
550
|
// 团队引擎端口(默认 P2 指令降级;TEAM_ENGINE=agent-teams 切 P1)。
|
|
518
551
|
const teamEngineMode = config?.teamEngine ?? process.env.TEAM_ENGINE ?? "instruction";
|
|
519
552
|
runtime.store.teamEnginePort = createTeamEnginePort({ getService: (name) => ctx?.get?.(name), mode: teamEngineMode });
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "taskboard-workbench",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.2",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "agent team 任务工作台:零依赖核心(node:sqlite)+ CLI + 本地 Web 看板 + DSH 内嵌插件",
|
|
6
6
|
"license": "MIT",
|
|
@@ -29,7 +29,8 @@
|
|
|
29
29
|
"access": "public"
|
|
30
30
|
},
|
|
31
31
|
"engines": {
|
|
32
|
-
"node": ">=22.5.0"
|
|
32
|
+
"node": ">=22.5.0",
|
|
33
|
+
"dsh": ">=0.2.1-rc.3"
|
|
33
34
|
},
|
|
34
35
|
"main": "./index.js",
|
|
35
36
|
"exports": {
|
|
@@ -49,6 +50,7 @@
|
|
|
49
50
|
"cli",
|
|
50
51
|
"spec/团队agent.md",
|
|
51
52
|
"spec/norms",
|
|
53
|
+
"spec/docs",
|
|
52
54
|
"scripts/tb-flow.mjs",
|
|
53
55
|
"tools/seed.mjs",
|
|
54
56
|
"tools/env-check.mjs"
|
|
@@ -64,7 +66,10 @@
|
|
|
64
66
|
"flow": "node scripts/tb-flow.mjs",
|
|
65
67
|
"seed": "node tools/seed.mjs",
|
|
66
68
|
"test": "node --test",
|
|
67
|
-
"env-check": "node tools/env-check.mjs"
|
|
69
|
+
"env-check": "node tools/env-check.mjs",
|
|
70
|
+
"lint": "eslint .",
|
|
71
|
+
"format": "prettier --write .",
|
|
72
|
+
"format:check": "prettier --check ."
|
|
68
73
|
},
|
|
69
74
|
"peerDependencies": {
|
|
70
75
|
"@deepseek-ai/dsh-client-ui-layout": "*",
|
package/scripts/tb-flow.mjs
CHANGED
|
@@ -1,23 +1,33 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
/**
|
|
3
|
-
* tb-flow.mjs —— 开局装载块(P4
|
|
3
|
+
* tb-flow.mjs —— 开局装载块(P4 档 A / 档 B 的同一个入口 + P5 档 C 的人工出口)
|
|
4
4
|
*
|
|
5
5
|
* 用法:
|
|
6
|
-
* node scripts/tb-flow.mjs start
|
|
6
|
+
* node scripts/tb-flow.mjs start [--project <id>] [--cwd <dir>] [--json]
|
|
7
7
|
* node scripts/tb-flow.mjs snippet [--project <id>] # 打给项目 AGENTS.md 用的片段
|
|
8
8
|
* node scripts/tb-flow.mjs check # 只自检(不读写库)
|
|
9
|
+
* node scripts/tb-flow.mjs inject --session <id> [--role main|exec|related] [--project <id>]
|
|
10
|
+
* [--host <url>] [--verify-bytes] [--json]
|
|
9
11
|
*
|
|
10
12
|
* 数据源:`--data-dir` > `$TB_DATA_DIR` > 默认(与 Web / CLI / MCP 同一份 `taskboard.sqlite`)。
|
|
11
13
|
*
|
|
12
|
-
*
|
|
14
|
+
* `start` / `snippet` / `check` **只读**:不建卡、不改状态、不写评论。
|
|
13
15
|
* 与 MCP prompt `taskboard.flow` 共用 `src/mcp/flow-block.mjs`,输出**逐字节相同**。
|
|
16
|
+
*
|
|
17
|
+
* `inject`(P5 档 C · 卡 `-210`):把**同一份**装载块投进指定会话,并落 `flow_injections` 审计行。
|
|
18
|
+
* · 它是**人工一次性**投递(审计 `policy=manual`)—— 自动注入由宿主 `createSession()` 按项目
|
|
19
|
+
* `flow_inject_policy` 决定,两者共用 `src/core/flow-inject.mjs`,所以内容不会出现第二真源;
|
|
20
|
+
* · 必须有一个**带宿主会话通道**的实例在跑(默认 `http://127.0.0.1:3080`,可用 `--host` 指到隔离实例);
|
|
21
|
+
* · `--verify-bytes`:本地复算同一份正文的 sha256 与宿主回报的 `digest` 对拍(验收 ③ 的自检口)。
|
|
14
22
|
*/
|
|
15
23
|
import path from "node:path";
|
|
16
24
|
import { fileURLToPath } from "node:url";
|
|
17
25
|
|
|
18
|
-
import { buildAgentsSnippet, buildFlowBlock, readSkill, SKILL_PATH } from "../src/mcp/flow-block.mjs";
|
|
26
|
+
import { buildAgentsSnippet, buildFlowBlock, buildFlowSummary, readSkill, SKILL_PATH } from "../src/mcp/flow-block.mjs";
|
|
19
27
|
import { openStore } from "../src/core/store.mjs";
|
|
20
28
|
import { resolveDataDir } from "../src/core/config.mjs";
|
|
29
|
+
import { resolveProject } from "../src/mcp/tools.mjs";
|
|
30
|
+
import { sha256 } from "../src/core/contract.mjs";
|
|
21
31
|
|
|
22
32
|
const argv = process.argv.slice(2);
|
|
23
33
|
const has = (name) => argv.includes(name);
|
|
@@ -25,7 +35,10 @@ const argOf = (name) => {
|
|
|
25
35
|
const i = argv.indexOf(name);
|
|
26
36
|
return i >= 0 && i + 1 < argv.length ? argv[i + 1] : null;
|
|
27
37
|
};
|
|
28
|
-
|
|
38
|
+
/** 只跳过**带值**的选项,别把 `--session` 后面的会话 id 当成子命令。 */
|
|
39
|
+
const VALUE_FLAGS = new Set(["--project", "--cwd", "--data-dir", "--session", "--host", "--role"]);
|
|
40
|
+
const command = argv.find((a, i) => !a.startsWith("-") && !VALUE_FLAGS.has(argv[i - 1] ?? "")) ?? "start";
|
|
41
|
+
const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
|
|
29
42
|
|
|
30
43
|
if (has("--help") || has("-h")) {
|
|
31
44
|
process.stdout.write(`tb-flow · 任务看板开局装载块
|
|
@@ -33,7 +46,11 @@ if (has("--help") || has("-h")) {
|
|
|
33
46
|
node scripts/tb-flow.mjs start [--project <id>] [--cwd <dir>] [--json] [--data-dir <dir>]
|
|
34
47
|
node scripts/tb-flow.mjs snippet [--project <id>]
|
|
35
48
|
node scripts/tb-flow.mjs check
|
|
36
|
-
|
|
49
|
+
node scripts/tb-flow.mjs inject --session <id> [--role main|exec|related] [--project <id>]
|
|
50
|
+
[--host <url>] [--verify-bytes] [--json]
|
|
51
|
+
只读脚本:start / snippet / check 不建卡 / 不改状态 / 不写评论。
|
|
52
|
+
inject 是人工一次性投递(落 flow_injections 审计行,policy=manual),需要带宿主会话通道的实例在跑。
|
|
53
|
+
数据源同 Web/CLI(--data-dir > $TB_DATA_DIR > 默认);--host 默认 $TB_HOST_URL 或 http://127.0.0.1:3080。
|
|
37
54
|
`);
|
|
38
55
|
process.exit(0);
|
|
39
56
|
}
|
|
@@ -46,12 +63,96 @@ if (command === "check") {
|
|
|
46
63
|
}
|
|
47
64
|
|
|
48
65
|
if (command === "snippet") {
|
|
49
|
-
process.stdout.write(`${buildAgentsSnippet({ project: argOf("--project"), pkgPath:
|
|
66
|
+
process.stdout.write(`${buildAgentsSnippet({ project: argOf("--project"), pkgPath: PKG_ROOT })}\n`);
|
|
50
67
|
process.exit(0);
|
|
51
68
|
}
|
|
52
69
|
|
|
70
|
+
if (command === "inject") {
|
|
71
|
+
const sessionId = argOf("--session");
|
|
72
|
+
if (!sessionId) {
|
|
73
|
+
process.stderr.write("缺 --session <id>:要投进哪个会话\n");
|
|
74
|
+
process.exit(2);
|
|
75
|
+
}
|
|
76
|
+
const role = argOf("--role");
|
|
77
|
+
if (role && !["main", "exec", "related", "subagent"].includes(role)) {
|
|
78
|
+
process.stderr.write(`--role 只能是 main / exec / related / subagent(收到 ${role})\n`);
|
|
79
|
+
process.exit(2);
|
|
80
|
+
}
|
|
81
|
+
const host = (argOf("--host") ?? process.env.TB_HOST_URL ?? "http://127.0.0.1:3080").replace(/\/+$/, "");
|
|
82
|
+
let store = null;
|
|
83
|
+
try {
|
|
84
|
+
// 只传 `--project` 且不要求逐字节复算时,**不打开本地库**(投递本身在宿主侧完成)。
|
|
85
|
+
let projectId = argOf("--project");
|
|
86
|
+
if (!projectId || has("--verify-bytes")) {
|
|
87
|
+
store = openStore({ dataDir: argOf("--data-dir") ?? resolveDataDir({ env: process.env }), env: process.env });
|
|
88
|
+
}
|
|
89
|
+
if (!projectId) {
|
|
90
|
+
projectId = resolveProject(store, { cwd: argOf("--cwd") ?? process.cwd() }).project.id;
|
|
91
|
+
}
|
|
92
|
+
const url = `${host}/integrations/taskboard-workbench/api/projects/${encodeURIComponent(projectId)}/flow/inject`;
|
|
93
|
+
let res;
|
|
94
|
+
try {
|
|
95
|
+
res = await fetch(url, {
|
|
96
|
+
method: "POST",
|
|
97
|
+
headers: { "content-type": "application/json", accept: "application/json" },
|
|
98
|
+
body: JSON.stringify({ sessionId, ...(role ? { role } : {}), source: "tb-flow-cli" }),
|
|
99
|
+
});
|
|
100
|
+
} catch (error) {
|
|
101
|
+
process.stderr.write(`HOST_UNREACHABLE: 连不上 ${url}(${error?.cause?.code ?? error?.message ?? error})\n`);
|
|
102
|
+
process.stderr.write("提示:inject 需要 DSH 内的任务工作台实例(或任意带宿主会话通道的实例);可用 --host 指到隔离验证实例。\n");
|
|
103
|
+
process.exit(4);
|
|
104
|
+
}
|
|
105
|
+
const payload = await res.json().catch(() => null);
|
|
106
|
+
if (!res.ok || !payload) {
|
|
107
|
+
process.stderr.write(`HTTP ${res.status}: ${payload?.error ?? payload?.message ?? "宿主未回可解析的 JSON"}\n`);
|
|
108
|
+
process.exit(1);
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
// 验收 ③ 的自检口:本地复算同一份正文,与宿主回报的 digest 对拍。
|
|
112
|
+
let verify = null;
|
|
113
|
+
if (has("--verify-bytes") && payload.digest) {
|
|
114
|
+
try {
|
|
115
|
+
const block = buildFlowBlock({ store, project: projectId });
|
|
116
|
+
const localText = payload.version === "summary" ? buildFlowSummary(block) : block.text;
|
|
117
|
+
const localDigest = sha256(localText);
|
|
118
|
+
verify = { localDigest, match: localDigest === payload.digest, version: payload.version ?? null };
|
|
119
|
+
} catch (error) {
|
|
120
|
+
verify = { localDigest: null, match: null, reason: error?.code ?? String(error?.message ?? error) };
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
if (has("--json")) {
|
|
125
|
+
process.stdout.write(`${JSON.stringify({ projectId, sessionId, host, ...payload, verify }, null, 2)}\n`);
|
|
126
|
+
} else if (payload.delivered) {
|
|
127
|
+
process.stdout.write(`已注入 ${sessionId}(policy=${payload.policy} · version=${payload.version} · ${payload.chars} 字符)\n`);
|
|
128
|
+
process.stdout.write(`project=${projectId} · contract=${payload.contractVersion} · digest=${payload.digest}\n`);
|
|
129
|
+
process.stdout.write(`审计行:flow_injections#${payload.injection?.id ?? "?"} · injected_at=${payload.injection?.injectedAt ?? "?"}\n`);
|
|
130
|
+
if (verify) process.stdout.write(`逐字节复算:${verify.match === true ? "一致" : verify.match === false ? "**不一致**" : `无法复算(${verify.reason})`}\n`);
|
|
131
|
+
} else {
|
|
132
|
+
process.stderr.write(`未投递:${payload.reason}${payload.nextAction ? ` —— ${payload.nextAction}` : ""}\n`);
|
|
133
|
+
if (payload.prompt) {
|
|
134
|
+
// 投不进去的最坏情况:至少把正文原样交给人(粘贴即可),不让人空手。
|
|
135
|
+
process.stderr.write("—— 以下是同一份正文,可直接粘贴到会话 ——\n");
|
|
136
|
+
process.stdout.write(payload.prompt);
|
|
137
|
+
if (!payload.prompt.endsWith("\n")) process.stdout.write("\n");
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
if (verify && verify.match === false) process.exit(6);
|
|
141
|
+
process.exit(payload.delivered ? 0 : 5);
|
|
142
|
+
} catch (error) {
|
|
143
|
+
process.stderr.write(`${error?.code ?? "ERROR"}: ${error?.message ?? String(error)}\n`);
|
|
144
|
+
if (error?.code === "PROJECT_NOT_FOUND") {
|
|
145
|
+
process.stderr.write(`提示:当前数据目录不含该项目;显式带 --project <id>,或用 --data-dir 指到真库。\n`);
|
|
146
|
+
process.exit(3);
|
|
147
|
+
}
|
|
148
|
+
process.exit(1);
|
|
149
|
+
} finally {
|
|
150
|
+
try { store?.close(); } catch { /* ignore */ }
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
|
|
53
154
|
if (command !== "start") {
|
|
54
|
-
process.stderr.write(`未知子命令:${command}(可用:start / snippet / check)\n`);
|
|
155
|
+
process.stderr.write(`未知子命令:${command}(可用:start / snippet / check / inject)\n`);
|
|
55
156
|
process.exit(2);
|
|
56
157
|
}
|
|
57
158
|
|
|
@@ -84,6 +84,6 @@ requires_contract: v1
|
|
|
84
84
|
| --- | --- |
|
|
85
85
|
| [`references/steps/S0.md`](./references/steps/S0.md) … [`S7.md`](./references/steps/S7.md) | 每步的详细做法、命令示例、判据读数长什么样 |
|
|
86
86
|
| [`references/errors.md`](./references/errors.md) | 错误码 → 该做什么(含"别重试同一请求"的那些) |
|
|
87
|
-
| [`references/injection.md`](./references/injection.md) | 三档装载的细节 + 分层注入策略(档 C
|
|
87
|
+
| [`references/injection.md`](./references/injection.md) | 三档装载的细节 + 分层注入策略(档 C 已实现·默认 `off`) |
|
|
88
88
|
| `spec/norms/flow.md` | 机器版主流程(运行时唯一真源,随包;`norm_get { norm:"flow" }`) |
|
|
89
89
|
| `spec/norms/card-update.md` | 卡片更新规范(`card_progress` 的 `norm_digest` 就取它) |
|
|
@@ -1,4 +1,11 @@
|
|
|
1
|
-
# 三档装载 + 分层注入策略(档 C
|
|
1
|
+
# 三档装载 + 分层注入策略(档 C **已实现** · 默认 `off`)
|
|
2
|
+
|
|
3
|
+
> ✅ **已实现(卡 `-210` / 需求 `R128`)** —— `flow_inject_policy` 现在**真有 reader**了:
|
|
4
|
+
> 判定与投递在 `src/core/flow-inject.mjs`,宿主出口在 `index.js` 的 `createSession()`,
|
|
5
|
+
> 人工出口是 `node scripts/tb-flow.mjs inject --session <id>`。
|
|
6
|
+
> **默认 `off` ⇒ 不打开开关时行为与接线前完全一致**(不构建、不投递、不写审计行)。
|
|
7
|
+
> **自证**:`node --test tests/flow-inject-policy-gap.test.mjs`(结构 + 文档口径)
|
|
8
|
+
> 与 `node --test tests/flow-inject.test.mjs` / `tests/flow-inject-wiring.test.mjs`(四档分流与三处接线)。
|
|
2
9
|
|
|
3
10
|
## 一、三档从侵入性低到高
|
|
4
11
|
|
|
@@ -6,7 +13,7 @@
|
|
|
6
13
|
| --- | --- | --- | --- |
|
|
7
14
|
| **A 开局提示词** | 人在 dsh 主会话新开一轮 | 贴 `node scripts/tb-flow.mjs start` 的输出(或 MCP prompt `taskboard.flow`,同一生成器) | ✅ 已可用 |
|
|
8
15
|
| **B 外部 agent 约定开局** | Claude Code / Codex 在**项目仓库**里开工 | 项目 `AGENTS.md` 一段「开工先跑 `<taskboard>/scripts/tb-flow.mjs start`」;片段用 `tb-flow snippet` 打印 | ✅ 已可用 |
|
|
9
|
-
| **C 宿主自动注入** | dsh 会话一创建就注入流程 | 宿主插件在 `
|
|
16
|
+
| **C 宿主自动注入** | dsh 会话一创建就注入流程 | 宿主插件在 `createSession()` 建完会话后按项目 `flow_inject_policy` 注入(`main`=完整版 / 执行·关联=摘要版 / 子 agent=不注入) | ✅ **已实现·默认 `off`**(打开方式见 §二;生效需一次宿主重载窗口) |
|
|
10
17
|
|
|
11
18
|
### 档 B 的 `AGENTS.md` 片段(`tb-flow snippet` 的输出)
|
|
12
19
|
|
|
@@ -25,46 +32,92 @@
|
|
|
25
32
|
> 三条边界:① 片段**只指路**,不复制八步正文(避免第二真源);② 路径写成占位符 —— 每个项目装在哪不一样;
|
|
26
33
|
> ③ 这段**不覆盖**项目自己的 `AGENTS.md` 规矩,只是「开工第一步」。
|
|
27
34
|
|
|
28
|
-
## 二、档 C
|
|
35
|
+
## 二、档 C 的接线形状(已生效)
|
|
29
36
|
|
|
30
|
-
|
|
|
37
|
+
| 项 | 内容 | 现在生效吗 |
|
|
31
38
|
| --- | --- | --- |
|
|
32
|
-
| `flow_inject_policy` | `off` / `main-only` / `main+exec` / `all`(**默认 `off`**) | ✅
|
|
33
|
-
| 审计表 | `flow_injections(session_id, project_id, policy, contract_version, digest, injected_at)` | ✅
|
|
34
|
-
|
|
|
39
|
+
| `flow_inject_policy` | `off` / `main-only` / `main+exec` / `all`(**默认 `off`**) | ✅ 生效。落在 `project_settings.flow_inject_policy`(API 字段 `flowInjectPolicy`),读点=`src/core/flow-inject.mjs` |
|
|
40
|
+
| 审计表 | `flow_injections(session_id, project_id, policy, contract_version, digest, injected_at)` | ✅ 每次**投递成功**落一行;`digest = sha256(实际投出的正文)`,可事后核「投的是哪一版」 |
|
|
41
|
+
| 宿主接入位 | `index.js` 的 `createSession()` 出口(建会话 → 预置任务指令 → **注入装载块**) | ✅ 已接;`role` 由调用方声明(主会话 `main` / 任务执行会话 `exec`),**没声明就不注入** |
|
|
42
|
+
| 人工出口 | `node scripts/tb-flow.mjs inject --session <id> [--role …] [--host <url>]` | ✅ 已接(`POST /api/projects/:id/flow/inject`);审计记 `policy=manual` |
|
|
43
|
+
|
|
44
|
+
### 怎么打开 / 怎么关掉(不需要改代码)
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
# 打开(只给项目主会话注入)
|
|
48
|
+
curl -X PUT http://127.0.0.1:3080/integrations/taskboard-workbench/api/projects/<项目id>/settings \
|
|
49
|
+
-H 'content-type: application/json' -d '{"flowInjectPolicy":"main-only"}'
|
|
50
|
+
# 关掉(回滚:写回 off,或删掉该字段)
|
|
51
|
+
curl -X PUT ... -d '{"flowInjectPolicy":"off"}'
|
|
52
|
+
```
|
|
35
53
|
|
|
36
|
-
|
|
54
|
+
> 非法值在**写库之前**被拒(`flow_inject_policy 只能是 …`);`flowInjectPolicy` 未传 ⇒ 保持不变。
|
|
55
|
+
> Web 配置页暂无该控件(配置页只管 `envConfig` / `teamTemplate`)—— 当前入口是上面的 API。
|
|
56
|
+
|
|
57
|
+
### 接入位长什么样(真实代码路径)
|
|
37
58
|
|
|
38
59
|
```
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
├─
|
|
43
|
-
└─
|
|
60
|
+
api.mjs POST /api/requirement…/sessions/rebind (mode=create) → port.createSession({role:"main"})
|
|
61
|
+
api.mjs POST /api/tasks/:ref/execute → port.createSession({role:"exec"})
|
|
62
|
+
└─ index.js createSession()
|
|
63
|
+
├─ sc.create({cwd}) → rename({sessionId,title}) → deliver(preset) // 原有行为,未改
|
|
64
|
+
└─ injectOpeningFlow() → src/core/flow-inject.mjs
|
|
65
|
+
├─ 读 project_settings.flow_inject_policy(缺省 off ⇒ 直接返回 policy-off)
|
|
66
|
+
├─ decideFlowInjection({policy, role}) // 纯函数:策略 × 角色矩阵
|
|
67
|
+
├─ 完整版 = buildFlowBlock().text // ★ 与 tb-flow start / MCP prompts/get 同一生成器
|
|
68
|
+
│ 摘要版 = buildFlowSummary(block) // 由同一个 block 剪裁,不另写规则
|
|
69
|
+
├─ deliver(sessionId, text) // sessionController.prompt(mode:"queue")
|
|
70
|
+
└─ store.recordFlowInjection({…六字段})
|
|
44
71
|
```
|
|
45
72
|
|
|
46
73
|
**关键:注入内容必须由同一个生成器产出** —— 否则宿主注入的、人贴的、agent 自己拉的会是三份不同的说明书。
|
|
74
|
+
守卫:`tests/flow-inject-wiring.test.mjs` 的 C1 用**独立进程**跑 `tb-flow inject`,
|
|
75
|
+
把 `tb-flow start` 的 stdout 与宿主实际投出的正文**逐字节对拍**(并核 `sha256`)。
|
|
47
76
|
|
|
48
77
|
## 三、分层注入策略(按会话角色给不同长度)
|
|
49
78
|
|
|
50
|
-
|
|
|
79
|
+
| 会话类型(`role`) | 注入什么 | 为什么 |
|
|
51
80
|
| --- | --- | --- |
|
|
52
|
-
|
|
|
53
|
-
|
|
|
54
|
-
|
|
|
81
|
+
| **项目主会话**(`main`) | 完整版:八步全文 + 五条硬规则 + 错误码索引 | 它要做判断、要拆卡、要回填 |
|
|
82
|
+
| **执行会话**(`exec`) | **摘要版(≤ 300 tokens)**:当前步 + 两道门 + 常见错误码处置 | 它只需要"别把 done 写了"这类护栏 |
|
|
83
|
+
| **关联会话**(`related`) | 摘要版(同 `exec`) | 同上;只在 `all` / `manual` 下注入 |
|
|
84
|
+
| **子 agent 会话**(`subagent`) | **不注入**(**硬规则**,`manual` 也不放开) | 子 agent 由父会话派活,注入只会稀释它自己的任务上下文 |
|
|
85
|
+
|
|
86
|
+
策略 × 角色(✓=注入):
|
|
55
87
|
|
|
56
|
-
|
|
88
|
+
| 角色 \ 策略 | `off` | `main-only` | `main+exec` | `all` | `manual` |
|
|
89
|
+
| --- | --- | --- | --- | --- | --- |
|
|
90
|
+
| `main` | — | ✓ 完整版 | ✓ 完整版 | ✓ 完整版 | ✓ 完整版 |
|
|
91
|
+
| `exec` | — | — | ✓ 摘要版 | ✓ 摘要版 | ✓ 摘要版 |
|
|
92
|
+
| `related` | — | — | — | ✓ 摘要版 | ✓ 摘要版 |
|
|
93
|
+
| `subagent` | — | — | — | — | — |
|
|
94
|
+
|
|
95
|
+
`manual` 只给人工一次性投递用(显式绕过 `off`,所以审计必须能把它与自动注入区分开)。
|
|
96
|
+
角色未知(调用方没声明)⇒ **不注入**(`role-unknown`):宁可少注,不可把完整版塞进执行会话。
|
|
97
|
+
|
|
98
|
+
摘要版的真实形状(由 `buildFlowSummary(block)` 生成,长度实测 ≈164 tokens / 374 字符):
|
|
57
99
|
|
|
58
100
|
```
|
|
59
101
|
任务看板主流程(摘要)
|
|
60
|
-
当前步:<S?,来自
|
|
61
|
-
|
|
102
|
+
当前步:<S?,来自 buildFlowBlock().nextStep>
|
|
103
|
+
两道门:done 只能人点(GOVERNANCE_AGENT_DONE)· backlog→todo 是人工授权(EXECUTION_NOT_AUTHORIZED)
|
|
62
104
|
回填要带:evidence[](file/command/url/reading)+ norm_digest(norm_get "card-update")
|
|
63
105
|
契约:<contract_version>(用旧版本会落 contract-warn)
|
|
106
|
+
常见错误码:EXECUTION_NOT_ATTRIBUTED(先补归因)· CONTRACT_STALE / NORM_STALE(重取规范)· REVIEW_NOT_APPROVED(等人复核)
|
|
107
|
+
全文:`node scripts/tb-flow.mjs start`(与宿主注入同源)
|
|
64
108
|
```
|
|
65
109
|
|
|
66
|
-
|
|
110
|
+
> ⚠ 上一版本文里写的是 `AUTHORIZATION_REQUIRED` —— **本仓没有这个错误码**(真码是 `EXECUTION_NOT_AUTHORIZED`)。
|
|
111
|
+
> 摘要版要塞给人/agent 直接照做的错误码,写错等于指路指到墙上;`tests/flow-inject.test.mjs` 的 C 条把它钉住。
|
|
112
|
+
|
|
113
|
+
## 四、失败与运维边界
|
|
67
114
|
|
|
68
|
-
-
|
|
69
|
-
|
|
70
|
-
-
|
|
115
|
+
- **注入异常不阻断会话创建**(验收 ⑤):`injectFlow()` **从不抛错**,一律回 `{injected:false, reason}`;
|
|
116
|
+
宿主 `createSession()` 把结果塞进 `injection` 字段如实回包,会话照旧建出来。
|
|
117
|
+
- **投递成功但审计写失败** ⇒ 回 `injected:true` + `reason:"injected-audit-failed"`(**不谎报没投**,否则调用方会重复注入)。
|
|
118
|
+
- **无宿主通道**(独立进程实例):`POST /flow/inject` 回 `{delivered:false, reason:"host-unavailable", prompt:"<正文>"}`
|
|
119
|
+
—— 正文原样回带,人可以直接粘贴;CLI 同理(退出码 5,正文打到 stdout)。
|
|
120
|
+
- **生产生效仍需一次宿主重载窗口**:本轮的代码改动在仓库内(`index.js` / `api.mjs` / `store.mjs`),
|
|
121
|
+
要让**当前运行中的** `:3080` 实例用上,必须重载宿主 —— 属 AGENTS.md §3 须先报批的动作,本轮未做。
|
|
122
|
+
- **不做的事**:不碰 `~/.dsh/**`、不改任何会话创建路径(只在本插件自己的 `createSession()` 出口加一层)、
|
|
123
|
+
不把注入做成「第二真源」(正文只能来自 `buildFlowBlock()` / `buildFlowSummary(block)`)。
|