carlos-flow 2.6.1 → 2.6.3
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 +64 -0
- package/TRIGGER_GUIDE.md +5 -5
- package/ghost.json +77 -1
- package/package.json +7 -3
- package/plugins/carlos-flow-trigger.js +215 -204
- package/scripts/full-audit.mjs +242 -0
- package/scripts/lang-audit.mjs +164 -0
- package/scripts/mutation-check.mjs +1 -1
- package/scripts/sync-readme.mjs +10 -7
- package/scripts/verify-activation-e2e.sh +1 -1
- package/scripts/verify-install-e2e.sh +20 -7
- package/src/index.js +13 -1
- package/src/protocol.js +76 -76
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,70 @@
|
|
|
5
5
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
+
## [2.6.3] - 2026-11-07 — 统一工具返回结构 + 新增包级端到端实测
|
|
9
|
+
|
|
10
|
+
### 🐛 修复 | Fixed
|
|
11
|
+
|
|
12
|
+
| # | 问题 | 影响 | 修复 |
|
|
13
|
+
|---|------|------|------|
|
|
14
|
+
| T-78 | `ok()` 只做序列化、不注入 `ok` 字段;各工具有的显式写 `ok: true`、有的没写(如 `flow_audit`) | 调用方拿到手的返回结构不一致 —— 想判断成败只能逐个工具记「这个有没有 ok」 | `ok()` 统一注入 `ok: true`(payload 里已有 `ok` 则保留原值,不改 `ok:false` 语义)。**增量兼容**:读取 `total` / `events` / `by_type` 等既有字段不受影响 |
|
|
15
|
+
|
|
16
|
+
### ✨ 新增 | Added
|
|
17
|
+
|
|
18
|
+
- **`test/package-e2e.mjs`(`npm run test:package`)** —— 「装完就能用」的真实路径实测:
|
|
19
|
+
`npm pack` → 装到**干净临时目录** → 从 `node_modules` 拉起 MCP server → 真实 JSON-RPC
|
|
20
|
+
→ 校验包内 23 个关键文件齐备 / bin 有 shebang / ghost.json 工具清单与服务端逐一对齐 /
|
|
21
|
+
插件候选含单包名 → 跑完整门禁流程 + 负例 + 智能触发。
|
|
22
|
+
|
|
23
|
+
> **为什么必须走真实安装路径**:之前所有测试都跑在源码目录,绕过了
|
|
24
|
+
> `npm pack → tarball → npm install → node_modules 布局 → 全局 bin → 真实握手` 这条链路。
|
|
25
|
+
> v2.6.2 修掉的两个严重 bug(T-69 插件找不到单包、T-70 ghost.json 缺 3 个工具)
|
|
26
|
+
> **都是只有走真实安装路径才会暴露**的 —— 源码目录测试永远发现不了。
|
|
27
|
+
|
|
28
|
+
### 🔬 验证 | Verification
|
|
29
|
+
|
|
30
|
+
- `test:package` **19/0** 通过(真实 tarball + 真实安装 + 真实 MCP 握手)
|
|
31
|
+
- 主测试 **129/0** 通过
|
|
32
|
+
- `check:full` / `check:identity` / `check:lang` / `test:lang`(12/0)全部通过
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## [2.6.2] - 2026-11-07 — 对外产物全面排查:修掉 2 个严重 bug 与 5 类遗留
|
|
37
|
+
|
|
38
|
+
### 🐛 修复 | Fixed
|
|
39
|
+
|
|
40
|
+
> 这一版的每一项**都不会让任何测试变红**,但会直接让用户看到错误信息。
|
|
41
|
+
> 单包合并后仓库里散落着大量双仓时代的遗留,为此新增 `scripts/full-audit.mjs`
|
|
42
|
+
> 做独立的「对外产物体检」,首轮报出 49 项,本次修完归零。
|
|
43
|
+
|
|
44
|
+
| # | 问题 | 影响 | 修复 |
|
|
45
|
+
|---|------|------|------|
|
|
46
|
+
| T-69 | `plugins/carlos-flow-trigger.js` 硬编码找 `node_modules/carlos-flow-opencode` | 单包化后该目录**根本不存在** → 除「插件就在包内」外的所有安装方式都找不到 MCP server → **OpenCode 的自动触发静默失效**(不报错,只是永远不触发) | 改为同时尝试 `carlos-flow` 与两个已弃用旧包名;实测真实 npm 安装下能定位到 `src/index.js` |
|
|
47
|
+
| T-70 | `ghost.json` 只声明 12 个工具,缺 `flow_run_verify` / `flow_check_scope` / `flow_trigger_check` | **Cindy 用户根本看不到这三个工具** —— 服务端有、清单没有 | 补齐到 15 个,与服务端 `src/index.js` 逐一对齐;并新增「ghost.json 工具清单 vs 服务端实际工具」的一致性检查 |
|
|
48
|
+
| T-71 | `scripts/verify-install-e2e.sh` 默认验证已废弃的旧包名 + 写死的旧版本号 | 该脚本验证的是一个**不存在的包** → 装包验收形同虚设 | 默认包名改为 `carlos-flow`,版本改为取自本仓 `package.json` |
|
|
49
|
+
| T-72 | 该脚本的「包内无个人路径」审计,grep 模式里含字面量 | **必然检出自己** → 这项审计从来没通过过 | 模式改为变量拼接;`CHANGELOG.md` 例外(版本历史刻意保留被修复路径的原样描述,便于追溯) |
|
|
50
|
+
| T-73 | `TRIGGER_GUIDE.md` 三处死链(`../README.md` 等,文件本身就在根目录) | 文档里的链接点不开 | 改为 `./` 相对路径 |
|
|
51
|
+
| T-74 | `CONTRIBUTING.md` / `SECURITY.md` / `CODE_OF_CONDUCT.md` 指向已删除的旧仓库、保留双仓表述 | 社区文档与 Security Advisories 入口全部失效 | 全部改为单一仓库 `carlos-flow` |
|
|
52
|
+
| T-75 | `settings.html` 示例路径用旧包名、`settings.js` 注释含开发者机路径 | Cindy 插件设置页给用户错误的安装路径示例 | 清理 |
|
|
53
|
+
| T-76 | `scripts/verify-activation-e2e.sh` 与 `scripts/mutation-check.mjs` 注释含开发者机路径 | 随包分发的文件里出现开发者机路径 | 改为泛化表述 |
|
|
54
|
+
| T-77 | `TRIGGER_GUIDE.md` 的版本号有两种写法(半角 `:` 与全角 `:`),升版本时只改了一半 | 文档里留下旧版本号;体检脚本因只认半角而**漏检** | 版本提取兼容两种冒号;并新增「同一文件出现多个版本号」检查 |
|
|
55
|
+
|
|
56
|
+
### ✨ 新增 | Added
|
|
57
|
+
|
|
58
|
+
- **`scripts/full-audit.mjs`(`npm run check:full`)** —— 「对外产物体检」:
|
|
59
|
+
旧引用 / 个人路径 / 版本一致性 / 文档死链 / npm 发布集合 / 模板占位符 /
|
|
60
|
+
package.json 关键字段 / 脚本与 CI 的双仓残留 / ghost.json 工具清单,9 类检查。
|
|
61
|
+
- **CI 与 Release workflow 接入 `npm run check:full`** —— 上述遗留一旦复发立即红。
|
|
62
|
+
|
|
63
|
+
### 🔬 验证 | Verification
|
|
64
|
+
|
|
65
|
+
- `check:full` 通过(首轮 49 项 → 0)
|
|
66
|
+
- `check:identity` / `check:lang` / `test:lang`(12/0)全部通过
|
|
67
|
+
- 主测试 **129/0** 通过(smoke 4 / e2e 62 / p0 22 / trigger 29 / concurrency 3 / acceptance 13)
|
|
68
|
+
- 插件路径修复用**真实 npm 安装**实测:能定位到 `node_modules/carlos-flow/src/index.js`
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
8
72
|
## [2.6.1] - 2026-11-07 — 修复全局命令不可用(bin 缺 shebang)
|
|
9
73
|
|
|
10
74
|
### 🐛 修复 | Fixed
|
package/TRIGGER_GUIDE.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Carlos Flow 智能触发引擎使用指南
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
> **版本**: v2.6.3
|
|
4
4
|
> **适用**:`carlos-flow` 单包架构(2.6.0+)
|
|
5
5
|
> **代码位置**:`src/trigger.js`(零外部依赖的纯 JavaScript 实现)
|
|
6
6
|
|
|
@@ -769,9 +769,9 @@ node client/carlos.js flow_status '{"sessionId":"my-task"}'
|
|
|
769
769
|
- [变异测试](scripts/mutation-check.mjs) - 注入退化验证测试套件真的能抓住(13 类变异)
|
|
770
770
|
- [核心代码](src/trigger.js) - 触发引擎实现
|
|
771
771
|
- [集成示例](client/carlos.js) - 客户端集成代码
|
|
772
|
-
- [完整 README](
|
|
773
|
-
- [迁移指南](
|
|
774
|
-
- [更新日志](
|
|
772
|
+
- [完整 README](./README.md) - 项目总览与能力矩阵
|
|
773
|
+
- [迁移指南](./MIGRATION.md) - 从旧包升级
|
|
774
|
+
- [更新日志](./CHANGELOG.md) - 版本历史
|
|
775
775
|
|
|
776
776
|
## 📄 许可证
|
|
777
777
|
|
|
@@ -779,5 +779,5 @@ MIT License
|
|
|
779
779
|
|
|
780
780
|
---
|
|
781
781
|
|
|
782
|
-
**版本**: v2.6.
|
|
782
|
+
**版本**: v2.6.3
|
|
783
783
|
**更新日期**: 2026-11-07
|
package/ghost.json
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"name": "Carlos 工作流",
|
|
6
6
|
"description": "机械门禁 MCP:留痕/派发/裁定/审计/快照/免检/还原。自动管理 Bridge 后台常驻,首次调用 ~3-5s,后续 ~1s。",
|
|
7
7
|
"whenToUse": "需要走 Carlos 工作流门禁时使用:留痕/派发/裁定/审计/快照/免检/还原",
|
|
8
|
-
"version": "2.6.
|
|
8
|
+
"version": "2.6.3",
|
|
9
9
|
"kind": "mcp",
|
|
10
10
|
"entry": "client/carlos.js",
|
|
11
11
|
"command": "门禁",
|
|
@@ -400,6 +400,82 @@
|
|
|
400
400
|
"sessionId"
|
|
401
401
|
]
|
|
402
402
|
}
|
|
403
|
+
},
|
|
404
|
+
{
|
|
405
|
+
"name": "flow_run_verify",
|
|
406
|
+
"description": "执行卡片中指定的验证命令,返回执行结果(退出码、stdout、stderr)。用于在派发 executor 后验证其工作成果,或手动触发验证。记 PASS 裁定前必须先跑通本工具。",
|
|
407
|
+
"parameters": {
|
|
408
|
+
"type": "object",
|
|
409
|
+
"properties": {
|
|
410
|
+
"sessionId": {
|
|
411
|
+
"type": "string",
|
|
412
|
+
"description": "会话 ID,默认 unknown"
|
|
413
|
+
},
|
|
414
|
+
"cwd": {
|
|
415
|
+
"type": "string",
|
|
416
|
+
"description": "工作目录,默认 process.cwd()"
|
|
417
|
+
}
|
|
418
|
+
}
|
|
419
|
+
}
|
|
420
|
+
},
|
|
421
|
+
{
|
|
422
|
+
"name": "flow_check_scope",
|
|
423
|
+
"description": "检查指定文件列表是否在卡片 scope 范围内。用于在提交裁定前自查越界改动。空 scope 判定为全部越界(fail-closed)。",
|
|
424
|
+
"parameters": {
|
|
425
|
+
"type": "object",
|
|
426
|
+
"properties": {
|
|
427
|
+
"sessionId": {
|
|
428
|
+
"type": "string",
|
|
429
|
+
"description": "会话 ID,默认 unknown"
|
|
430
|
+
},
|
|
431
|
+
"paths": {
|
|
432
|
+
"type": "array",
|
|
433
|
+
"items": {
|
|
434
|
+
"type": "string"
|
|
435
|
+
},
|
|
436
|
+
"description": "要检查的文件路径列表"
|
|
437
|
+
},
|
|
438
|
+
"cwd": {
|
|
439
|
+
"type": "string",
|
|
440
|
+
"description": "仓库工作目录,默认 process.cwd()"
|
|
441
|
+
}
|
|
442
|
+
},
|
|
443
|
+
"required": [
|
|
444
|
+
"sessionId"
|
|
445
|
+
]
|
|
446
|
+
}
|
|
447
|
+
},
|
|
448
|
+
{
|
|
449
|
+
"name": "flow_trigger_check",
|
|
450
|
+
"description": "智能触发检查:判断当前这条用户消息是否应该启动 Carlos 工作流,并在达标时实际完成激活(写入用户原话 + 开占位卡 → 会话进入门禁态)。宿主在收到用户消息时调用本工具,就能获得与命令行客户端完全一致的自动触发行为。未达阈值时只如实返回评分与决策,不做任何动作;被限流时也如实返回真实评分。中文流程词(工作流/门禁/派发/审计…)已内置,中文需求同样能触发。",
|
|
451
|
+
"parameters": {
|
|
452
|
+
"type": "object",
|
|
453
|
+
"properties": {
|
|
454
|
+
"sessionId": {
|
|
455
|
+
"type": "string",
|
|
456
|
+
"description": "会话 ID,默认 unknown"
|
|
457
|
+
},
|
|
458
|
+
"message": {
|
|
459
|
+
"type": "string",
|
|
460
|
+
"description": "用户本轮消息原文(必须是真实原话,用于 quote 锚点)"
|
|
461
|
+
},
|
|
462
|
+
"complexity": {
|
|
463
|
+
"type": "number",
|
|
464
|
+
"description": "任务复杂度系数,默认 1.0"
|
|
465
|
+
},
|
|
466
|
+
"execute": {
|
|
467
|
+
"type": "boolean",
|
|
468
|
+
"description": "true = 达标时实际执行激活步骤(默认 true);false = 只评分不动作"
|
|
469
|
+
},
|
|
470
|
+
"cwd": {
|
|
471
|
+
"type": "string",
|
|
472
|
+
"description": "工作目录,默认 process.cwd()"
|
|
473
|
+
}
|
|
474
|
+
},
|
|
475
|
+
"required": [
|
|
476
|
+
"message"
|
|
477
|
+
]
|
|
478
|
+
}
|
|
403
479
|
}
|
|
404
480
|
]
|
|
405
481
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "carlos-flow",
|
|
3
|
-
"version": "2.6.
|
|
3
|
+
"version": "2.6.3",
|
|
4
4
|
"description": "Carlos 工作流 — AI 编码 Agent 的机械门禁。留痕/派发/验证/裁定/审计/还原,约束写在代码里而非提示词里。单一包支持 Cindy/OpenCode/Cursor/Cline/VS Code/Claude Desktop。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "src/index.js",
|
|
@@ -38,7 +38,11 @@
|
|
|
38
38
|
"init:cursor": "node client/carlos.js init --target cursor",
|
|
39
39
|
"init:cline": "node client/carlos.js init --target cline",
|
|
40
40
|
"init:vscode": "node client/carlos.js init --target vscode",
|
|
41
|
-
"init:claude": "node client/carlos.js init --target claude"
|
|
41
|
+
"init:claude": "node client/carlos.js init --target claude",
|
|
42
|
+
"check:lang": "node scripts/lang-audit.mjs",
|
|
43
|
+
"test:lang": "node test/lang-audit.test.mjs",
|
|
44
|
+
"check:full": "node scripts/full-audit.mjs",
|
|
45
|
+
"test:package": "node test/package-e2e.mjs"
|
|
42
46
|
},
|
|
43
47
|
"keywords": [
|
|
44
48
|
"carlos",
|
|
@@ -87,4 +91,4 @@
|
|
|
87
91
|
"CHANGELOG.md",
|
|
88
92
|
"LICENSE"
|
|
89
93
|
]
|
|
90
|
-
}
|
|
94
|
+
}
|
|
@@ -1,204 +1,215 @@
|
|
|
1
|
-
// carlos-flow-trigger — OpenCode 插件:把智能触发引擎真正接到消息事件上
|
|
2
|
-
//
|
|
3
|
-
// 为什么需要这个插件:
|
|
4
|
-
// Carlos 工作流的「智能触发引擎」(src/trigger.js)原本只接在**命令行客户端**
|
|
5
|
-
// (client/carlos.js)上 —— MCP server 根本不接触发引擎。
|
|
6
|
-
// 而在 OpenCode 里,Agent 走的是 MCP 工具路径(直接调 flow_* 工具),
|
|
7
|
-
// 于是 README 里那张「工作流会自己认出该上场的时候」的流程图在**实际使用路径上是不成立的**。
|
|
8
|
-
//
|
|
9
|
-
// 本插件做的事:
|
|
10
|
-
// 监听 OpenCode 的 `chat.message` 钩子(用户每发一条消息都会触发),
|
|
11
|
-
// 把消息原文交给 MCP 的 flow_trigger_check 工具 —— 由它做评分与决策,
|
|
12
|
-
// 达标时**实际完成激活**(写入用户原话 + 开占位卡 → 会话进入门禁态)。
|
|
13
|
-
//
|
|
14
|
-
// 评分与决策逻辑与命令行路径**共用同一份实现**(src/trigger.js),
|
|
15
|
-
// 所以两条路径的行为完全一致,不会出现「命令行能触发、MCP 不能」。
|
|
16
|
-
//
|
|
17
|
-
// 安装:
|
|
18
|
-
// 方式 A(本地文件):把本文件放到 OpenCode 的插件目录
|
|
19
|
-
// ~/.config/opencode/plugins/carlos-flow-trigger.js
|
|
20
|
-
//
|
|
21
|
-
// 项目级则放 .opencode/plugins/carlos-flow-trigger.js
|
|
22
|
-
// 方式 B(npm 包):在 opencode.json 里加
|
|
23
|
-
// { "plugin": ["carlos-flow
|
|
24
|
-
// 然后重启 OpenCode。
|
|
25
|
-
//
|
|
26
|
-
// 可选环境变量:
|
|
27
|
-
// CARLOS_FLOW_TRIGGER=off 关闭插件(临时停用自动触发)
|
|
28
|
-
// CARLOS_FLOW_TRIGGER_DEBUG=1 打印触发决策日志
|
|
29
|
-
//
|
|
30
|
-
// 说明:
|
|
31
|
-
// · 插件只做「判断 + 激活」,**不代替 Agent 决定改哪些文件**;
|
|
32
|
-
// 激活后仍需补齐 scope / acceptance / verify.cmd 才能派发(闸门不放松);
|
|
33
|
-
// · 任何异常都只记日志、绝不阻断用户消息(插件出错不应该让 OpenCode 挂掉)。
|
|
34
|
-
|
|
35
|
-
import { spawn } from "node:child_process";
|
|
36
|
-
import { existsSync } from "node:fs";
|
|
37
|
-
import { homedir } from "node:os";
|
|
38
|
-
import { join, resolve } from "node:path";
|
|
39
|
-
|
|
40
|
-
const DEBUG = process.env.CARLOS_FLOW_TRIGGER_DEBUG === "1";
|
|
41
|
-
const ENABLED = process.env.CARLOS_FLOW_TRIGGER !== "off";
|
|
42
|
-
|
|
43
|
-
// 找到 MCP server 的 src/index.js。
|
|
44
|
-
// 插件可能位于:
|
|
45
|
-
// 1) <pkg>/plugins/carlos-flow-trigger.js(npm 包内,方式 B)
|
|
46
|
-
// 2) ~/.config/opencode/plugins/carlos-flow-trigger.js(本地文件,方式 A)
|
|
47
|
-
// 3) <repo>/plugins/carlos-flow-trigger.js(源码 checkout)
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
}
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
}
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
}
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
const
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
if (
|
|
194
|
-
console.error(
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
}
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
1
|
+
// carlos-flow-trigger — OpenCode 插件:把智能触发引擎真正接到消息事件上
|
|
2
|
+
//
|
|
3
|
+
// 为什么需要这个插件:
|
|
4
|
+
// Carlos 工作流的「智能触发引擎」(src/trigger.js)原本只接在**命令行客户端**
|
|
5
|
+
// (client/carlos.js)上 —— MCP server 根本不接触发引擎。
|
|
6
|
+
// 而在 OpenCode 里,Agent 走的是 MCP 工具路径(直接调 flow_* 工具),
|
|
7
|
+
// 于是 README 里那张「工作流会自己认出该上场的时候」的流程图在**实际使用路径上是不成立的**。
|
|
8
|
+
//
|
|
9
|
+
// 本插件做的事:
|
|
10
|
+
// 监听 OpenCode 的 `chat.message` 钩子(用户每发一条消息都会触发),
|
|
11
|
+
// 把消息原文交给 MCP 的 flow_trigger_check 工具 —— 由它做评分与决策,
|
|
12
|
+
// 达标时**实际完成激活**(写入用户原话 + 开占位卡 → 会话进入门禁态)。
|
|
13
|
+
//
|
|
14
|
+
// 评分与决策逻辑与命令行路径**共用同一份实现**(src/trigger.js),
|
|
15
|
+
// 所以两条路径的行为完全一致,不会出现「命令行能触发、MCP 不能」。
|
|
16
|
+
//
|
|
17
|
+
// 安装:
|
|
18
|
+
// 方式 A(本地文件):把本文件放到 OpenCode 的插件目录
|
|
19
|
+
// ~/.config/opencode/plugins/carlos-flow-trigger.js
|
|
20
|
+
// Windows 下则是 %APPDATA%\opencode\plugins\carlos-flow-trigger.js
|
|
21
|
+
// 项目级则放 .opencode/plugins/carlos-flow-trigger.js
|
|
22
|
+
// 方式 B(npm 包):在 opencode.json 里加
|
|
23
|
+
// { "plugin": ["carlos-flow/plugins/carlos-flow-trigger.js"] }
|
|
24
|
+
// 然后重启 OpenCode。
|
|
25
|
+
//
|
|
26
|
+
// 可选环境变量:
|
|
27
|
+
// CARLOS_FLOW_TRIGGER=off 关闭插件(临时停用自动触发)
|
|
28
|
+
// CARLOS_FLOW_TRIGGER_DEBUG=1 打印触发决策日志
|
|
29
|
+
//
|
|
30
|
+
// 说明:
|
|
31
|
+
// · 插件只做「判断 + 激活」,**不代替 Agent 决定改哪些文件**;
|
|
32
|
+
// 激活后仍需补齐 scope / acceptance / verify.cmd 才能派发(闸门不放松);
|
|
33
|
+
// · 任何异常都只记日志、绝不阻断用户消息(插件出错不应该让 OpenCode 挂掉)。
|
|
34
|
+
|
|
35
|
+
import { spawn } from "node:child_process";
|
|
36
|
+
import { existsSync } from "node:fs";
|
|
37
|
+
import { homedir } from "node:os";
|
|
38
|
+
import { join, resolve } from "node:path";
|
|
39
|
+
|
|
40
|
+
const DEBUG = process.env.CARLOS_FLOW_TRIGGER_DEBUG === "1";
|
|
41
|
+
const ENABLED = process.env.CARLOS_FLOW_TRIGGER !== "off";
|
|
42
|
+
|
|
43
|
+
// 找到 MCP server 的 src/index.js。
|
|
44
|
+
// 插件可能位于:
|
|
45
|
+
// 1) <pkg>/plugins/carlos-flow-trigger.js(npm 包内,方式 B)
|
|
46
|
+
// 2) ~/.config/opencode/plugins/carlos-flow-trigger.js(本地文件,方式 A)
|
|
47
|
+
// 3) <repo>/plugins/carlos-flow-trigger.js(源码 checkout)
|
|
48
|
+
//
|
|
49
|
+
// ⚠️ 包名是 **carlos-flow**(v2.6.0 起统一单包)。
|
|
50
|
+
// 旧版这里硬编码的是 carlos-flow-opencode —— 单包化之后那个目录根本不存在,
|
|
51
|
+
// 于是除「方式 B」(插件就在包内)外的所有安装方式都**找不到 MCP server**,
|
|
52
|
+
// 自动触发**静默失效**。
|
|
53
|
+
// 现在同时接受新包名与两个已弃用的旧包名(兼容老用户尚未迁移的 node_modules)。
|
|
54
|
+
const PKG_NAMES = ["carlos-flow", "carlos-flow-opencode", "carlos-flow-cindy"];
|
|
55
|
+
function findMcpServer() {
|
|
56
|
+
const here = new URL(".", import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, "$1");
|
|
57
|
+
const dir = resolve(here);
|
|
58
|
+
const candidates = [
|
|
59
|
+
join(dir, "..", "src", "index.js"), // <pkg>/plugins/ → <pkg>/src/
|
|
60
|
+
];
|
|
61
|
+
for (const name of PKG_NAMES) {
|
|
62
|
+
candidates.push(
|
|
63
|
+
join(dir, "..", "..", "node_modules", name, "src", "index.js"),
|
|
64
|
+
join(dir, "..", "..", "..", "node_modules", name, "src", "index.js"),
|
|
65
|
+
join(homedir(), ".config", "opencode", "node_modules", name, "src", "index.js"),
|
|
66
|
+
join(homedir(), "AppData", "Roaming", "opencode", "node_modules", name, "src", "index.js"),
|
|
67
|
+
);
|
|
68
|
+
}
|
|
69
|
+
for (const p of candidates) {
|
|
70
|
+
try {
|
|
71
|
+
if (existsSync(p)) return p;
|
|
72
|
+
} catch {}
|
|
73
|
+
}
|
|
74
|
+
return null;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
// 以 MCP 的 stdio 协议调一个工具(一次性拉起,用完即退)
|
|
78
|
+
async function callMcpTool(serverPath, toolName, args, timeoutMs = 15000) {
|
|
79
|
+
return new Promise((resolvePromise) => {
|
|
80
|
+
const child = spawn(process.execPath, [serverPath], {
|
|
81
|
+
stdio: ["pipe", "pipe", "pipe"],
|
|
82
|
+
windowsHide: true,
|
|
83
|
+
});
|
|
84
|
+
let buf = "";
|
|
85
|
+
let stderr = "";
|
|
86
|
+
const pending = new Map();
|
|
87
|
+
let id = 1;
|
|
88
|
+
|
|
89
|
+
const timer = setTimeout(() => {
|
|
90
|
+
try { child.kill(); } catch {}
|
|
91
|
+
resolvePromise({ ok: false, error: "timeout" });
|
|
92
|
+
}, timeoutMs);
|
|
93
|
+
|
|
94
|
+
child.stdout.on("data", (d) => {
|
|
95
|
+
buf += d.toString();
|
|
96
|
+
let i;
|
|
97
|
+
while ((i = buf.indexOf("\n")) >= 0) {
|
|
98
|
+
const line = buf.slice(0, i);
|
|
99
|
+
buf = buf.slice(i + 1);
|
|
100
|
+
if (!line.trim()) continue;
|
|
101
|
+
try {
|
|
102
|
+
const msg = JSON.parse(line);
|
|
103
|
+
if (msg.id && pending.has(msg.id)) {
|
|
104
|
+
pending.get(msg.id)(msg);
|
|
105
|
+
pending.delete(msg.id);
|
|
106
|
+
}
|
|
107
|
+
} catch {}
|
|
108
|
+
}
|
|
109
|
+
});
|
|
110
|
+
child.stderr.on("data", (d) => { stderr += d.toString(); });
|
|
111
|
+
|
|
112
|
+
const req = (method, params) => new Promise((r) => {
|
|
113
|
+
const rid = id++;
|
|
114
|
+
pending.set(rid, r);
|
|
115
|
+
child.stdin.write(JSON.stringify({ jsonrpc: "2.0", id: rid, method, params }) + "\n");
|
|
116
|
+
});
|
|
117
|
+
|
|
118
|
+
child.on("error", (e) => {
|
|
119
|
+
clearTimeout(timer);
|
|
120
|
+
try { child.kill(); } catch {}
|
|
121
|
+
resolvePromise({ ok: false, error: String(e && e.message ? e.message : e) });
|
|
122
|
+
});
|
|
123
|
+
child.on("exit", () => {
|
|
124
|
+
clearTimeout(timer);
|
|
125
|
+
resolvePromise({ ok: false, error: stderr.slice(-300) || "server exited" });
|
|
126
|
+
});
|
|
127
|
+
|
|
128
|
+
(async () => {
|
|
129
|
+
try {
|
|
130
|
+
await req("initialize", {
|
|
131
|
+
protocolVersion: "2024-11-05",
|
|
132
|
+
capabilities: {},
|
|
133
|
+
clientInfo: { name: "carlos-flow-trigger", version: "1.0.0" },
|
|
134
|
+
});
|
|
135
|
+
const res = await req("tools/call", { name: toolName, arguments: args });
|
|
136
|
+
const text = res?.result?.content?.[0]?.text || "";
|
|
137
|
+
clearTimeout(timer);
|
|
138
|
+
try { child.kill(); } catch {}
|
|
139
|
+
if (res?.result?.isError) {
|
|
140
|
+
resolvePromise({ ok: false, error: String(text).slice(0, 300) });
|
|
141
|
+
} else {
|
|
142
|
+
try {
|
|
143
|
+
resolvePromise({ ok: true, data: JSON.parse(text) });
|
|
144
|
+
} catch {
|
|
145
|
+
resolvePromise({ ok: false, error: "bad json: " + String(text).slice(0, 200) });
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
} catch (e) {
|
|
149
|
+
clearTimeout(timer);
|
|
150
|
+
try { child.kill(); } catch {}
|
|
151
|
+
resolvePromise({ ok: false, error: String(e && e.message ? e.message : e) });
|
|
152
|
+
}
|
|
153
|
+
})();
|
|
154
|
+
});
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
// 从 parts 里取出用户消息文本(只看 type==="text" 的部分)
|
|
158
|
+
function extractText(parts) {
|
|
159
|
+
if (!Array.isArray(parts)) return "";
|
|
160
|
+
return parts
|
|
161
|
+
.filter((p) => p && p.type === "text" && typeof p.text === "string")
|
|
162
|
+
.map((p) => p.text)
|
|
163
|
+
.join("\n")
|
|
164
|
+
.trim();
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
export const CarlosFlowTriggerPlugin = async ({ client, $, worktree, directory }) => {
|
|
168
|
+
const serverPath = findMcpServer();
|
|
169
|
+
if (!serverPath) {
|
|
170
|
+
console.error("[carlos-flow-trigger] 未找到 MCP server(src/index.js),自动触发未启用");
|
|
171
|
+
console.error("[carlos-flow-trigger] 请确认已全局安装:npm install -g carlos-flow");
|
|
172
|
+
}
|
|
173
|
+
if (DEBUG) {
|
|
174
|
+
console.error("[carlos-flow-trigger] server:", serverPath, "cwd:", worktree || directory);
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
return {
|
|
178
|
+
"chat.message": async (input, output) => {
|
|
179
|
+
if (!ENABLED) return;
|
|
180
|
+
if (!serverPath) return;
|
|
181
|
+
|
|
182
|
+
const message = extractText(output && output.parts);
|
|
183
|
+
if (!message) return;
|
|
184
|
+
|
|
185
|
+
const sessionId = input.sessionID || "default";
|
|
186
|
+
try {
|
|
187
|
+
const res = await callMcpTool(serverPath, "flow_trigger_check", {
|
|
188
|
+
sessionId,
|
|
189
|
+
message,
|
|
190
|
+
cwd: worktree || directory || process.cwd(),
|
|
191
|
+
});
|
|
192
|
+
|
|
193
|
+
if (!res.ok) {
|
|
194
|
+
if (DEBUG) console.error("[carlos-flow-trigger] 调用失败:", res.error);
|
|
195
|
+
return; // 插件出错绝不阻断用户消息
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
const d = res.data || {};
|
|
199
|
+
if (DEBUG) {
|
|
200
|
+
console.error(
|
|
201
|
+
`[carlos-flow-trigger] decision=${d.decision} score=${d.score} activated=${d.activated}`
|
|
202
|
+
);
|
|
203
|
+
}
|
|
204
|
+
if (d.activated) {
|
|
205
|
+
console.error(
|
|
206
|
+
`[carlos-flow-trigger] 已自动激活 Carlos 工作流(评分 ${d.score})—— ` +
|
|
207
|
+
`请补齐 ${(d.pending_fields || []).join(" / ")} 后再派发`
|
|
208
|
+
);
|
|
209
|
+
}
|
|
210
|
+
} catch (e) {
|
|
211
|
+
if (DEBUG) console.error("[carlos-flow-trigger] 异常:", e && e.message ? e.message : e);
|
|
212
|
+
}
|
|
213
|
+
},
|
|
214
|
+
};
|
|
215
|
+
};
|