carlos-flow 2.6.2 → 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 CHANGED
@@ -5,6 +5,34 @@
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
+
8
36
  ## [2.6.2] - 2026-11-07 — 对外产物全面排查:修掉 2 个严重 bug 与 5 类遗留
9
37
 
10
38
  ### 🐛 修复 | Fixed
package/TRIGGER_GUIDE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Carlos Flow 智能触发引擎使用指南
2
2
 
3
- > **版本**:v2.6.2
3
+ > **版本**: v2.6.3
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.6.2
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.2",
8
+ "version": "2.6.3",
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.6.2",
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",
@@ -41,7 +41,8 @@
41
41
  "init:claude": "node client/carlos.js init --target claude",
42
42
  "check:lang": "node scripts/lang-audit.mjs",
43
43
  "test:lang": "node test/lang-audit.test.mjs",
44
- "check:full": "node scripts/full-audit.mjs"
44
+ "check:full": "node scripts/full-audit.mjs",
45
+ "test:package": "node test/package-e2e.mjs"
45
46
  },
46
47
  "keywords": [
47
48
  "carlos",
@@ -86,8 +86,11 @@ if (!existsSync(TRIGGER_GUIDE)) {
86
86
  return null;
87
87
  }
88
88
  })();
89
- // 尝试从末尾的 '**版本**:' 字段提取版本号,去掉可能的 'v' 前缀
90
- const versionMatch = guide.match(/\*\*版本\*\*\s*:\s *(v?\d+\.\d+\.\d+)/);
89
+ // 尝试从末尾的 '**版本**:' 字段提取版本号,去掉可能的 'v' 前缀。
90
+ // 冒号可能是半角 `:` 或全角 `:`(Markdown 里两种都常见)—— 早先只认半角,
91
+ // 结果升版本时把 TRIGGER_GUIDE.md 里写成全角的那一处漏改,本检查直接报
92
+ // 「提取不到版本号」而看不出真实原因。
93
+ const versionMatch = guide.match(/\*\*版本\*\*\s*[::]\s*(v?\d+\.\d+\.\d+)/);
91
94
  const versionInGuide = versionMatch ? versionMatch[1].replace(/^v/, '') : null;
92
95
  if (pkgVersion && versionInGuide) {
93
96
  log(versionInGuide === pkgVersion, `TRIGGER_GUIDE.md version is ${versionInGuide} vs package.json ${pkgVersion}`);
package/src/index.js CHANGED
@@ -21,7 +21,19 @@ const log = (msg) => {
21
21
 
22
22
  // ---- 通用工具函数 ----------------------------------------------------------
23
23
 
24
- const ok = (obj) => ({ content: [{ type: "text", text: JSON.stringify(obj, null, 2) }] });
24
+ // 成功响应:统一注入 ok:true。
25
+ //
26
+ // 之前各工具的 payload 有的显式写 \`ok: true\`、有的没写(如 flow_audit),
27
+ // 于是调用方拿到手的心智模型不一致 —— 想判断成败只能逐个工具记「这个有没有 ok」。
28
+ // 现在由 ok() 统一注入:
29
+ // · payload 里没有 ok 字段 → 补上 ok:true
30
+ // · payload 里已有 ok 字段 → 保留原值(不改 ok:false 的语义)
31
+ // 这是**增量兼容**:现有调用方读取 total / events / by_type 等字段不受影响。
32
+ const ok = (obj) => {
33
+ const payload = obj && typeof obj === "object" && !Array.isArray(obj) ? obj : { value: obj };
34
+ const withOk = "ok" in payload ? payload : { ok: true, ...payload };
35
+ return { content: [{ type: "text", text: JSON.stringify(withOk, null, 2) }] };
36
+ };
25
37
  const fail = (message) => ({ content: [{ type: "text", text: "ERROR: " + String(message) }], isError: true });
26
38
 
27
39
  const asStringArray = (v) => (Array.isArray(v) ? v.map((x) => String(x)) : []);