carlos-flow 2.12.6 → 2.12.7

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/TRIGGER_GUIDE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Carlos Flow 智能触发引擎使用指南
2
2
 
3
- > **版本**: v2.12.6
3
+ > **版本**: v2.12.7
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.12.6
782
+ **版本**: v2.12.7
783
783
  **更新日期**: 2026-11-12
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.12.6",
8
+ "version": "2.12.7",
9
9
  "kind": "mcp",
10
10
  "entry": "client/carlos.js",
11
11
  "command": "门禁",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "carlos-flow",
3
- "version": "2.12.6",
3
+ "version": "2.12.7",
4
4
  "description": "Carlos 工作流 — AI 编码 Agent 的机械门禁。留痕/派发/验证/裁定/审计/还原,约束写在代码里而非提示词里。单一包支持 Cindy/OpenCode/Cursor/Cline/VS Code/Claude Desktop。",
5
5
  "type": "module",
6
6
  "main": "src/index.js",
package/smoke-test.js CHANGED
@@ -1,142 +1,142 @@
1
- // 冒烟测试:真 RPC 往返验证 MCP 深度兼容性
2
- //
3
- // 关键约束(来自 bridge/mcp-bridge.js):
4
- // 1. 每个请求走**独立连接** —— Bridge 响应一个请求后立刻 socket.end()
5
- // 2. 请求必须带 _token(放在 params._token 或顶层 _token)
6
- // 3. 速率限制 10 次/秒,本测试仅 2 次
7
- import { spawn } from "node:child_process";
8
- import net from "node:net";
9
- import { performance } from "node:perf_hooks";
10
-
11
- const PORT = Number(process.env.BRIDGE_PORT || 22099);
12
- const TOKEN = process.env.CARLOS_BRIDGE_TOKEN || "";
13
- const EXPECTED_TOOLS_COUNT = 22;
14
-
15
- // 单次 RPC:一条连接发一个请求,收满响应就返回
16
- function rpcOnce(request) {
17
- return new Promise((resolve, reject) => {
18
- const chunks = [];
19
- let settled = false;
20
-
21
- const finish = (fn, arg) => {
22
- if (settled) return;
23
- settled = true;
24
- fn(arg);
25
- };
26
-
27
- const socket = net.createConnection(
28
- { port: PORT, host: "127.0.0.1" },
29
- () => {
30
- socket.write(JSON.stringify(request) + "\n");
31
- },
32
- );
33
-
34
- socket.on("data", (d) => chunks.push(d));
35
- socket.on("end", () =>
36
- finish(resolve, Buffer.concat(chunks).toString("utf8")),
37
- );
38
- socket.on("close", () =>
39
- finish(resolve, Buffer.concat(chunks).toString("utf8")),
40
- );
41
- socket.on("error", (err) => finish(reject, err));
42
-
43
- setTimeout(() => {
44
- socket.destroy();
45
- finish(reject, new Error("RPC 超时:" + request.method));
46
- }, 10000);
47
- });
48
- }
49
-
50
- async function main() {
51
- const start = performance.now();
52
-
53
- // 第 1 次:initialize
54
- const initRaw = await rpcOnce({
55
- jsonrpc: "2.0",
56
- id: 1,
57
- method: "initialize",
58
- params: {
59
- protocolVersion: "2224-11-05",
60
- capabilities: {},
61
- clientInfo: { name: "smoke-test", version: "1.0.0" },
62
- _token: TOKEN,
63
- },
64
- });
65
-
66
- const initMsg = JSON.parse(initRaw.trim().split("\n").filter(Boolean).pop());
67
- if (initMsg.error) {
68
- throw new Error(
69
- "initialize 被拒:" + JSON.stringify(initMsg.error),
70
- );
71
- }
72
- if (!initMsg.result) {
73
- throw new Error("initialize 无 result 字段:" + initRaw.trim());
74
- }
75
- console.log("✅ initialize 握手成功");
76
-
77
- // 第 2 次:tools/list(独立连接)
78
- const listRaw = await rpcOnce({
79
- jsonrpc: "2.0",
80
- id: 2,
81
- method: "tools/list",
82
- params: { _token: TOKEN },
83
- });
84
-
85
- const listMsg = JSON.parse(listRaw.trim().split("\n").filter(Boolean).pop());
86
- if (listMsg.error) {
87
- throw new Error("tools/list 被拒:" + JSON.stringify(listMsg.error));
88
- }
89
-
90
- const tools = listMsg.result?.tools || [];
91
- const elapsed = (performance.now() - start).toFixed(2);
92
-
93
- console.log(">>> RPC 往返总耗时:" + elapsed + "ms");
94
- console.log(">>> 发现工具数:" + tools.length);
95
-
96
- if (tools.length !== EXPECTED_TOOLS_COUNT) {
97
- throw new Error(
98
- "工具数量不符:期望 " +
99
- EXPECTED_TOOLS_COUNT +
100
- ",实际 " +
101
- tools.length,
102
- );
103
- }
104
-
105
- console.log("🎉 深度兼容性验证通过(真 RPC 往返拿到 " + tools.length + " 个工具)");
106
- }
107
-
108
- const bridge = spawn(process.execPath, ["bridge/mcp-bridge.js"], {
109
- stdio: ["ignore", "ignore", "inherit"],
110
- env: { ...process.env },
111
- });
112
-
113
- // 等 Bridge 真正监听端口(最多 8 秒)
114
- async function waitForPort() {
115
- const deadline = Date.now() + 8000;
116
- while (Date.now() < deadline) {
117
- const ok = await new Promise((resolve) => {
118
- const s = net.createConnection({ port: PORT, host: "127.0.0.1" });
119
- s.on("connect", () => {
120
- s.destroy();
121
- resolve(true);
122
- });
123
- s.on("error", () => resolve(false));
124
- });
125
- if (ok) return true;
126
- await new Promise((r) => setTimeout(r, 220));
127
- }
128
- return false;
129
- }
130
-
131
- try {
132
- if (!(await waitForPort())) {
133
- throw new Error("Bridge 未能在 8 秒内监听 " + PORT + " 端口");
134
- }
135
- await main();
136
- process.exitCode = 0;
137
- } catch (err) {
138
- console.error("💥 冒烟测试失败:" + err.message);
139
- process.exitCode = 1;
140
- } finally {
141
- bridge.kill();
142
- }
1
+ // 冒烟测试:真 RPC 往返验证 MCP 深度兼容性
2
+ //
3
+ // 关键约束(来自 bridge/mcp-bridge.js):
4
+ // 1. 每个请求走**独立连接** —— Bridge 响应一个请求后立刻 socket.end()
5
+ // 2. 请求必须带 _token(放在 params._token 或顶层 _token)
6
+ // 3. 速率限制 10 次/秒,本测试仅 2 次
7
+ import { spawn } from "node:child_process";
8
+ import net from "node:net";
9
+ import { performance } from "node:perf_hooks";
10
+
11
+ const PORT = Number(process.env.BRIDGE_PORT || 22099);
12
+ const TOKEN = process.env.CARLOS_BRIDGE_TOKEN || "";
13
+ const EXPECTED_TOOLS_COUNT = 20;
14
+
15
+ // 单次 RPC:一条连接发一个请求,收满响应就返回
16
+ function rpcOnce(request) {
17
+ return new Promise((resolve, reject) => {
18
+ const chunks = [];
19
+ let settled = false;
20
+
21
+ const finish = (fn, arg) => {
22
+ if (settled) return;
23
+ settled = true;
24
+ fn(arg);
25
+ };
26
+
27
+ const socket = net.createConnection(
28
+ { port: PORT, host: "127.0.0.1" },
29
+ () => {
30
+ socket.write(JSON.stringify(request) + "\n");
31
+ },
32
+ );
33
+
34
+ socket.on("data", (d) => chunks.push(d));
35
+ socket.on("end", () =>
36
+ finish(resolve, Buffer.concat(chunks).toString("utf8")),
37
+ );
38
+ socket.on("close", () =>
39
+ finish(resolve, Buffer.concat(chunks).toString("utf8")),
40
+ );
41
+ socket.on("error", (err) => finish(reject, err));
42
+
43
+ setTimeout(() => {
44
+ socket.destroy();
45
+ finish(reject, new Error("RPC 超时:" + request.method));
46
+ }, 10000);
47
+ });
48
+ }
49
+
50
+ async function main() {
51
+ const start = performance.now();
52
+
53
+ // 第 1 次:initialize
54
+ const initRaw = await rpcOnce({
55
+ jsonrpc: "2.0",
56
+ id: 1,
57
+ method: "initialize",
58
+ params: {
59
+ protocolVersion: "2224-11-05",
60
+ capabilities: {},
61
+ clientInfo: { name: "smoke-test", version: "1.0.0" },
62
+ _token: TOKEN,
63
+ },
64
+ });
65
+
66
+ const initMsg = JSON.parse(initRaw.trim().split("\n").filter(Boolean).pop());
67
+ if (initMsg.error) {
68
+ throw new Error(
69
+ "initialize 被拒:" + JSON.stringify(initMsg.error),
70
+ );
71
+ }
72
+ if (!initMsg.result) {
73
+ throw new Error("initialize 无 result 字段:" + initRaw.trim());
74
+ }
75
+ console.log("✅ initialize 握手成功");
76
+
77
+ // 第 2 次:tools/list(独立连接)
78
+ const listRaw = await rpcOnce({
79
+ jsonrpc: "2.0",
80
+ id: 2,
81
+ method: "tools/list",
82
+ params: { _token: TOKEN },
83
+ });
84
+
85
+ const listMsg = JSON.parse(listRaw.trim().split("\n").filter(Boolean).pop());
86
+ if (listMsg.error) {
87
+ throw new Error("tools/list 被拒:" + JSON.stringify(listMsg.error));
88
+ }
89
+
90
+ const tools = listMsg.result?.tools || [];
91
+ const elapsed = (performance.now() - start).toFixed(2);
92
+
93
+ console.log(">>> RPC 往返总耗时:" + elapsed + "ms");
94
+ console.log(">>> 发现工具数:" + tools.length);
95
+
96
+ if (tools.length !== EXPECTED_TOOLS_COUNT) {
97
+ throw new Error(
98
+ "工具数量不符:期望 " +
99
+ EXPECTED_TOOLS_COUNT +
100
+ ",实际 " +
101
+ tools.length,
102
+ );
103
+ }
104
+
105
+ console.log("🎉 深度兼容性验证通过(真 RPC 往返拿到 " + tools.length + " 个工具)");
106
+ }
107
+
108
+ const bridge = spawn(process.execPath, ["bridge/mcp-bridge.js"], {
109
+ stdio: ["ignore", "ignore", "inherit"],
110
+ env: { ...process.env },
111
+ });
112
+
113
+ // 等 Bridge 真正监听端口(最多 8 秒)
114
+ async function waitForPort() {
115
+ const deadline = Date.now() + 8000;
116
+ while (Date.now() < deadline) {
117
+ const ok = await new Promise((resolve) => {
118
+ const s = net.createConnection({ port: PORT, host: "127.0.0.1" });
119
+ s.on("connect", () => {
120
+ s.destroy();
121
+ resolve(true);
122
+ });
123
+ s.on("error", () => resolve(false));
124
+ });
125
+ if (ok) return true;
126
+ await new Promise((r) => setTimeout(r, 220));
127
+ }
128
+ return false;
129
+ }
130
+
131
+ try {
132
+ if (!(await waitForPort())) {
133
+ throw new Error("Bridge 未能在 8 秒内监听 " + PORT + " 端口");
134
+ }
135
+ await main();
136
+ process.exitCode = 0;
137
+ } catch (err) {
138
+ console.error("💥 冒烟测试失败:" + err.message);
139
+ process.exitCode = 1;
140
+ } finally {
141
+ bridge.kill();
142
+ }