carlos-flow 2.14.0 → 2.14.1
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/AGENTS.md +12 -1
- package/CHANGELOG.md +9 -0
- package/README.en.md +13 -0
- package/README.md +13 -0
- package/README.zh.md +13 -0
- package/TRIGGER_GUIDE.md +2 -2
- package/client/carlos.js +30 -1
- package/ghost.json +19 -559
- package/main.js +267 -0
- package/package.json +6 -5
- package/scripts/check-templates.mjs +42 -3
- package/scripts/full-audit.mjs +63 -5
- package/src/index.js +27 -27
- package/src/mcp-stdio.mjs +139 -0
package/AGENTS.md
CHANGED
|
@@ -21,6 +21,8 @@
|
|
|
21
21
|
| `src/trigger.js` 触发引擎 | `TRIGGER_GUIDE.md` + `test/trigger-e2e.mjs` | 触发器配置模板 |
|
|
22
22
|
| 对外工具描述 / README | `scripts/check-claims.mjs`(承诺兑现度门禁) | `npm run check:claims` |
|
|
23
23
|
| `bridge/` 或 `client/` | `test/bridge-identity.mjs`(身份隔离) | `npm run test:bridge` |
|
|
24
|
+
| `ghost.json` 的工具清单 / `main.js` | `docs/TOOL_CONTRACTS.md` §1.3(两段式目录) | `test/cindy-dispatch.mjs`、`npm run check:full` |
|
|
25
|
+
| `src/mcp-stdio.mjs`(协议层) | `docs/TOOL_CONTRACTS.md` §1.3 + MCP stdio 规范 | `npm run test:mcp` |
|
|
24
26
|
| CI / 发布流程 | `.github/workflows/` | `npm run check:full` |
|
|
25
27
|
|
|
26
28
|
---
|
|
@@ -56,7 +58,14 @@
|
|
|
56
58
|
- 旧格式记录(无 hash)只计入 `legacy` 计数,**保持 `prev` 不变**。
|
|
57
59
|
- 重置会让 v2.5 升级上来的用户审计链长期报红 —— 误报比漏报更伤信任。
|
|
58
60
|
|
|
59
|
-
6.
|
|
61
|
+
6.1 **插件清单只能是 chip,且工具面 ≤16 项(v2.14.1)**
|
|
62
|
+
- Cindy 已移除 `kind:"mcp"`;`tools` 超过 16 项直接拒装。
|
|
63
|
+
- 20 个操作走两段式:`ghost.json` 只声明 `list_tools` / `call_tool`,
|
|
64
|
+
`main.js` 的类目表必须**恰好覆盖**服务端全部操作(`check:full` 守着)。
|
|
65
|
+
- 随包 Node 程序不能依赖 node_modules(Forge 打包会跳过),
|
|
66
|
+
所以协议层是自研的 `src/mcp-stdio.mjs`,不是 SDK。
|
|
67
|
+
|
|
68
|
+
7. **不得引入硬编码密钥 / Token / 路径**
|
|
60
69
|
- 密钥走环境变量;状态目录走 `CARLOS_FLOW_HOME`;路径用 `__ROOT__` 占位符 + `init` 渲染。
|
|
61
70
|
|
|
62
71
|
7. **工具描述与实现必须一致**
|
|
@@ -76,6 +85,8 @@ npm run test:bridge # Bridge 身份隔离(端口上是别人的 bridge
|
|
|
76
85
|
npm run test:sensitive # 项目级敏感规则:只能追加、否定式无效、坏配置退回基线
|
|
77
86
|
npm run test:lock # 状态锁:退避 / 死锁回收 / fail-closed
|
|
78
87
|
npm run test:falsify # 负对照:还原核对 + 崩溃恢复
|
|
88
|
+
npm run test:mcp # 零依赖 MCP stdio 服务端(握手 / stdout 纯净 / 未知方法)
|
|
89
|
+
npm run test:dispatch # chip 两段式目录(真实服务端 + main.js 端到端)
|
|
79
90
|
npm run test:lang # 产物语言体检的自检
|
|
80
91
|
npm run test:package # 包级端到端(真实 tarball + 干净安装 + 真实 MCP 握手)
|
|
81
92
|
npm run check:full # 对外产物全面体检
|
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,12 @@
|
|
|
1
|
+
## [2.14.1] - 2026-11-17
|
|
2
|
+
- 装机修复:Cindy 已移除 `kind:"mcp"` 声明,且 chip 的 tools 上限为 16 项 —— 2.14.0 的清单(20 个工具 + mcp)在当前宿主**直接拒装**。本版改为宿主手册 §3.5 的两段式目录:只声明 `list_tools` / `call_tool`,分发表放进新增的 `main.js`(20 个操作全部可达)
|
|
3
|
+
- 零依赖 stdio 服务端:新增 `src/mcp-stdio.mjs` 取代 `@modelcontextprotocol/sdk`(Forge 打包跳过 node_modules、运行期禁止联网装依赖),`node.protocol` 改为 `mcp-stdio`;package.json 运行时依赖清空
|
|
4
|
+
- 目录即自纠:`list_tools` 概览/下钻(5 个类目 gate/verify/audit/infra/trigger),下钻时**同一份结果**下发该类目 RULES;`call_tool` 对未知操作附全部可用操作名、对缺参/非法参数附参数 schema 与 RULES
|
|
5
|
+
- 长任务续命:verify / falsify / dispatch 走 call_tool 时按 45s 发心跳,避免 330s 工具窗口把慢验证判超时
|
|
6
|
+
- 开发路径同步:`carlos init --target cindy` 把包内相对入口(entry / node.entry)渲染成绝对路径,仓库直连安装继续可用
|
|
7
|
+
- 门禁同步:`check-full` / `check-templates` 认识两段式清单(校验 main.js 类目表恰好覆盖服务端全部操作、node.entry 真实存在、不得用 __ROOT__),并新增「直接声明超过 16 项即红」
|
|
8
|
+
- 回归新增:`test:mcp`(18 条,协议握手 / stdout 纯净 / 通知不回包 / 未知方法 -32601)、`test:dispatch`(23 条,真实起服务端 + vm 跑 main.js 的端到端分发)
|
|
9
|
+
|
|
1
10
|
## [2.14.0] - 2026-11-17
|
|
2
11
|
- 项目级敏感路径扩展:仓库根 `.carlos.json` 可追加 `sensitive.names/segments/extensions/prefixes`(只能追加,否定式 `!` `-` 一律忽略;配置损坏自动退回内置基线)
|
|
3
12
|
- 负对照安全性:`flow_falsify` 进入前写还原日志、还原后逐文件核对摘要;被强杀留下的 pending 日志会在下一次调用时先把工作区救回来(返回值如实报告 `restore` / `recovered`)
|
package/README.en.md
CHANGED
|
@@ -100,6 +100,19 @@ A red-team run reproduced 4 state losses in 40 concurrent rounds; now it reports
|
|
|
100
100
|
|
|
101
101
|
---
|
|
102
102
|
|
|
103
|
+
## 🧩 Calling it from Cindy
|
|
104
|
+
|
|
105
|
+
The plugin exposes a **two-level catalogue** (Cindy caps a plugin at 16 declared tools; this one has 20 operations):
|
|
106
|
+
|
|
107
|
+
- `list_tools` — browse first: omit `category` for an overview of the 5 categories
|
|
108
|
+
(gate / verify / audit / infra / trigger); pass it for that category's operations **plus the RULES** you must read first.
|
|
109
|
+
- `call_tool` — then execute: `name` from `list_tools`, `args` per its parameter help.
|
|
110
|
+
An unknown name returns every available operation; missing or invalid args return the schema and rules.
|
|
111
|
+
|
|
112
|
+
On other platforms (OpenCode / Cursor / Cline / VS Code / Claude Desktop) the 20 tools are exposed directly — no extra hop.
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
103
116
|
## 🏗️ Technical Architecture
|
|
104
117
|
|
|
105
118
|
### Overview
|
package/README.md
CHANGED
|
@@ -29,6 +29,19 @@
|
|
|
29
29
|
|
|
30
30
|
---
|
|
31
31
|
|
|
32
|
+
## 🧩 在 Cindy 里怎么调用
|
|
33
|
+
|
|
34
|
+
插件的工具面是**两段式目录**(Cindy 对单个插件的工具声明有 16 项上限,本插件有 20 个操作):
|
|
35
|
+
|
|
36
|
+
- `list_tools` —— 先看目录:不传 `category` 给 5 个类目概览(gate / verify / audit / infra / trigger),
|
|
37
|
+
传了给该类目的操作明细 + **调用前必读的 RULES**。
|
|
38
|
+
- `call_tool` —— 再执行:`name` 用 `list_tools` 返回的操作名,`args` 照它的参数说明填。
|
|
39
|
+
传错名字会附全部可用操作名;少填参数会附参数 schema 与规则,照着改就能过。
|
|
40
|
+
|
|
41
|
+
其它平台(OpenCode / Cursor / Cline / VS Code / Claude Desktop)仍然直接暴露 20 个工具,不需要这一步。
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
32
45
|
## ⚙️ 工作原理
|
|
33
46
|
|
|
34
47
|
Carlos 工作流的核心逻辑是“闭环质检”:
|
package/README.zh.md
CHANGED
|
@@ -29,6 +29,19 @@
|
|
|
29
29
|
|
|
30
30
|
---
|
|
31
31
|
|
|
32
|
+
## 🧩 在 Cindy 里怎么调用
|
|
33
|
+
|
|
34
|
+
插件的工具面是**两段式目录**(Cindy 对单个插件的工具声明有 16 项上限,本插件有 20 个操作):
|
|
35
|
+
|
|
36
|
+
- `list_tools` —— 先看目录:不传 `category` 给 5 个类目概览(gate / verify / audit / infra / trigger),
|
|
37
|
+
传了给该类目的操作明细 + **调用前必读的 RULES**。
|
|
38
|
+
- `call_tool` —— 再执行:`name` 用 `list_tools` 返回的操作名,`args` 照它的参数说明填。
|
|
39
|
+
传错名字会附全部可用操作名;少填参数会附参数 schema 与规则,照着改就能过。
|
|
40
|
+
|
|
41
|
+
其它平台(OpenCode / Cursor / Cline / VS Code / Claude Desktop)仍然直接暴露 20 个工具,不需要这一步。
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
32
45
|
## ⚙️ 工作原理
|
|
33
46
|
|
|
34
47
|
Carlos 工作流的核心逻辑是“闭环质检”:
|
package/TRIGGER_GUIDE.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Carlos Flow 智能触发引擎使用指南
|
|
2
2
|
|
|
3
|
-
> **版本**: v2.14.
|
|
3
|
+
> **版本**: v2.14.1
|
|
4
4
|
> **适用**:`carlos-flow` 单包架构(2.6.0+)
|
|
5
5
|
> **代码位置**:`src/trigger.js`(零外部依赖的纯 JavaScript 实现)
|
|
6
6
|
|
|
@@ -779,5 +779,5 @@ MIT License
|
|
|
779
779
|
|
|
780
780
|
---
|
|
781
781
|
|
|
782
|
-
**版本**: v2.14.
|
|
782
|
+
**版本**: v2.14.1
|
|
783
783
|
**更新日期**: 2026-11-12
|
package/client/carlos.js
CHANGED
|
@@ -545,6 +545,35 @@ async function runInit(target) {
|
|
|
545
545
|
// 两种目标格式要分别处理:
|
|
546
546
|
// - JSON(ghost.json / mcp.json / opencode.json):必须 JSON 转义(反斜杠 → \\)
|
|
547
547
|
// - YAML(.mcprc):Windows 路径一律用正斜杠(反斜杠在 YAML 双引号标量里同样非法)
|
|
548
|
+
// 把包内相对入口(entry / node.entry / node.entries[] / settingsHtml / icon)渲染成绝对路径。
|
|
549
|
+
//
|
|
550
|
+
// 为什么需要:ghost.json 现在是**包清单**(chip 形态,包里全是相对路径),而
|
|
551
|
+
// `init --target cindy` 只复制清单文件、不复制目录结构 —— 相对路径在
|
|
552
|
+
// ~/.cindy/ghosts/ 下没有包根可参照,插件会起不来。这里渲染成绝对路径,
|
|
553
|
+
// 保证「开发直连仓库」这条路继续可用。
|
|
554
|
+
function renderRelativeEntries(text, rootAbs) {
|
|
555
|
+
let obj;
|
|
556
|
+
try {
|
|
557
|
+
obj = JSON.parse(text);
|
|
558
|
+
} catch {
|
|
559
|
+
return text; // 已经是非法 JSON 就别再动它,交给门禁去报
|
|
560
|
+
}
|
|
561
|
+
const toAbs = (rel) => {
|
|
562
|
+
if (typeof rel !== "string" || rel === "") return rel;
|
|
563
|
+
const normalized = rel.replace(/\\/g, "/");
|
|
564
|
+
if (/^([A-Za-z]:[\\/]|[\\/]|https?:)/.test(normalized)) return normalized;
|
|
565
|
+
return join(rootAbs, normalized);
|
|
566
|
+
};
|
|
567
|
+
obj.entry = toAbs(obj.entry);
|
|
568
|
+
if (obj.settingsHtml) obj.settingsHtml = toAbs(obj.settingsHtml);
|
|
569
|
+
if (obj.icon) obj.icon = toAbs(obj.icon);
|
|
570
|
+
if (obj.node && typeof obj.node === "object") {
|
|
571
|
+
obj.node.entry = toAbs(obj.node.entry);
|
|
572
|
+
if (Array.isArray(obj.node.entries)) obj.node.entries = obj.node.entries.map(toAbs);
|
|
573
|
+
}
|
|
574
|
+
return JSON.stringify(obj, null, 2) + "\n";
|
|
575
|
+
}
|
|
576
|
+
|
|
548
577
|
const rootJson = JSON.stringify(ROOT_ABS).slice(1, -1);
|
|
549
578
|
const rootYaml = ROOT_ABS.replace(/\\/g, "/");
|
|
550
579
|
|
|
@@ -555,7 +584,7 @@ async function runInit(target) {
|
|
|
555
584
|
const ghostPath = join(ghostsDir, "carlos-flow.json");
|
|
556
585
|
|
|
557
586
|
const ghostTemplate = readFileSync(resolve(ROOT_ABS, "ghost.json"), "utf8");
|
|
558
|
-
const ghostContent = ghostTemplate.replace(/__ROOT__/g, rootJson);
|
|
587
|
+
const ghostContent = renderRelativeEntries(ghostTemplate.replace(/__ROOT__/g, rootJson), ROOT_ABS);
|
|
559
588
|
writeFileSync(ghostPath, ghostContent, "utf8");
|
|
560
589
|
console.log(`✅ Cindy ghost 已写入: ${ghostPath}`);
|
|
561
590
|
console.log(` 重启 Cindy 后即可在侧栏看到 "Carlos 工作流" 插件`);
|