carlos-flow 2.11.3 → 2.12.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.
@@ -17,6 +17,11 @@
17
17
  // node scripts/publish-gate.mjs --count 12
18
18
  //
19
19
  // 输出:向 $GITHUB_OUTPUT 写 publish=true/false(若有该环境变量),并打印人话结论。
20
+ //
21
+ // ===== 发布暂停开关 =====
22
+ // RELEASE_PAUSED=1 → 停止所有 npm publish(仅建 GitHub Release)
23
+ // RELEASE_PAUSED=0 → 恢复正常发布(由 deploy 方决定是否启用)
24
+ // 本机操作时默认开闸,仅 CI 触发推送时带开关才生效
20
25
 
21
26
  import { execFileSync } from "node:child_process";
22
27
  import { readFileSync, appendFileSync } from "node:fs";
@@ -25,7 +30,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
25
30
 
26
31
  const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
27
32
 
28
- // 语义化版本比较:a > b 返回正数,a < b 返回负数,相等返回 0
33
+ /** 语义化版本比较:a > b 返回正数,a < b 返回负数,相等返回 0 */
29
34
  export function semverCompare(a, b) {
30
35
  const pa = String(a).split(/[.-]/).map((x) => Number(x) || 0);
31
36
  const pb = String(b).split(/[.-]/).map((x) => Number(x) || 0);
@@ -37,7 +42,7 @@ export function semverCompare(a, b) {
37
42
  return 0;
38
43
  }
39
44
 
40
- // 纯函数:给定版本与 registry 现状,返回是否允许发布
45
+ /** 纯函数:给定版本与 registry 现状,返回是否允许发布 */
41
46
  export function decidePublish({ version, latest, count }) {
42
47
  if (!latest || !count || count <= 1) {
43
48
  return { publish: true, reason: "registry 暂无已发布版本 —— 允许发布" };
@@ -60,6 +65,13 @@ export function decidePublish({ version, latest, count }) {
60
65
  };
61
66
  }
62
67
 
68
+ /** 发布暂停指令:RELEASE_PAUSED 为非空非 0 时禁止 npm publish */
69
+ export function releasePaused() {
70
+ const v = String(process.env.RELEASE_PAUSED || "").trim().toLowerCase();
71
+ if (!v || v === "0" || v === "false") return false;
72
+ return true;
73
+ }
74
+
63
75
  function argOf(name) {
64
76
  const i = process.argv.indexOf(name);
65
77
  return i === -1 ? null : process.argv[i + 1];
@@ -100,13 +112,22 @@ function main() {
100
112
  }
101
113
  }
102
114
 
115
+ if (releasePaused()) {
116
+ const reason = "RELEASE_PAUSED 已设置 → 停止所有 npm publish(仅建 Release)";
117
+ console.log(`本次版本:${version} | registry latest:${latest || "(无)"} | 已发布版本数:${count}`);
118
+ console.log(reason);
119
+ if (process.env.GITHUB_OUTPUT) appendFileSync(process.env.GITHUB_OUTPUT, "publish=false\n");
120
+ console.log("publish=false");
121
+ return;
122
+ }
123
+
103
124
  const { publish, reason } = decidePublish({
104
125
  version,
105
126
  latest: latest || "",
106
127
  count,
107
128
  });
108
129
 
109
- console.log(`▶ 本次版本:${version}|registry latest:${latest || "(无)"}|已发布版本数:${count}`);
130
+ console.log(`本次版本:${version} | registry latest:${latest || "(无)"} | 已发布版本数:${count}`);
110
131
  console.log(`${publish ? "✓" : "✗"} ${reason}`);
111
132
 
112
133
  if (process.env.GITHUB_OUTPUT) {
@@ -1,102 +1,102 @@
1
- #!/usr/bin/env node
2
- // sync-readme.mjs — 保持多语言 README 集合一致
3
- //
4
- // 文件布局(方案 A —— 三份独立文件):
5
- // README.md ← 中文主文档(GitHub 首页 / npm 渲染页默认展示)
6
- // README.zh.md ← 中文副本(保证 /README.zh.md 直链可用,与主文档一致)
7
- // README.en.md ← 英文完整版(顶部语言栏切换目标)
8
- //
9
- // 用法:
10
- // node scripts/sync-readme.mjs # 同步并校验(发现漂移时退出码 1)
11
- // node scripts/sync-readme.mjs --check # 只校验,绝不写文件
12
- import { readFileSync, writeFileSync, existsSync } from "node:fs";
13
- import { fileURLToPath } from "node:url";
14
- import path from "node:path";
15
-
16
- const here = path.dirname(fileURLToPath(import.meta.url));
17
- const root = path.resolve(here, "..");
18
-
19
- const ZH_MASTER = path.join(root, "README.md"); // 中文主文档(首页默认)
20
- const ZH_MIRROR = path.join(root, "README.zh.md"); // 中文副本
21
- const EN = path.join(root, "README.en.md"); // 英文完整版
22
- const checkOnly = process.argv.includes("--check");
23
- const NAV_EN = "(README.en.md)";
24
- const NAV_ZH = "(README.zh.md)";
25
-
26
- let failed = false;
27
- const log = (ok, msg) => {
28
- console.log(`${ok ? "PASS" : "FAIL"} ${msg}`);
29
- if (!ok) failed = true;
30
- };
31
-
32
- const hasNav = (text) => text.includes(NAV_EN) && text.includes(NAV_ZH);
33
-
34
- // ---- 1. 中文主文档(首页默认)----
35
- if (!existsSync(ZH_MASTER)) {
36
- log(false, "README.md (中文主文档) is missing");
37
- } else {
38
- const master = readFileSync(ZH_MASTER, "utf8");
39
- log(hasNav(master), "README.md has the language-switch nav bar");
40
-
41
- // 中文主文档 → README.zh.md 副本
42
- if (existsSync(ZH_MIRROR)) {
43
- if (readFileSync(ZH_MIRROR, "utf8") === master) {
44
- log(true, "README.zh.md is in sync with README.md");
45
- } else if (checkOnly) {
46
- log(false, "README.zh.md differs from README.md — run `npm run sync:readme`");
47
- } else {
48
- writeFileSync(ZH_MIRROR, master, "utf8");
49
- log(true, "README.zh.md synced from README.md");
50
- }
51
- } else if (checkOnly) {
52
- log(false, "README.zh.md is missing — run `npm run sync:readme`");
53
- } else {
54
- writeFileSync(ZH_MIRROR, master, "utf8");
55
- log(true, "README.zh.md created from README.md");
56
- }
57
- }
58
-
59
- // ---- 2. 英文完整版 ----
60
- if (!existsSync(EN)) {
61
- log(false, "README.en.md (English version) is missing");
62
- } else {
63
- const en = readFileSync(EN, "utf8");
64
- log(hasNav(en), "README.en.md has the language-switch nav bar");
65
- if (/^#\s+.*(中文)/m.test(en.split("\n").slice(0, 12).join("\n"))) {
66
- log(false, "README.en.md looks like the Chinese version — check the copy");
67
- } else {
68
- log(true, "README.en.md is the English version");
69
- }
70
- }
71
-
72
- // ---- 3. TRIGGER_GUIDE.md ----
73
- const TRIGGER_GUIDE = path.join(root, "TRIGGER_GUIDE.md");
74
- if (!existsSync(TRIGGER_GUIDE)) {
75
- log(false, "TRIGGER_GUIDE.md is missing");
76
- } else {
77
- const guide = readFileSync(TRIGGER_GUIDE, "utf8");
78
- log(true, "TRIGGER_GUIDE.md exists");
79
-
80
- // 3.1 检查版本号与 package.json 一致
81
- const pkgVersion = (() => {
82
- try {
83
- const pkg = JSON.parse(readFileSync(path.join(root, "package.json"), "utf8"));
84
- return pkg.version;
85
- } catch (e) {
86
- return null;
87
- }
88
- })();
89
- // 尝试从末尾的 '**版本**:' 字段提取版本号,去掉可能的 'v' 前缀。
90
- // 冒号可能是半角 `:` 或全角 `:`(Markdown 里两种都常见)—— 早先只认半角,
91
- // 结果升版本时把 TRIGGER_GUIDE.md 里写成全角的那一处漏改,本检查直接报
92
- // 「提取不到版本号」而看不出真实原因。
93
- const versionMatch = guide.match(/\*\*版本\*\*\s*[::]\s*(v?\d+\.\d+\.\d+)/);
94
- const versionInGuide = versionMatch ? versionMatch[1].replace(/^v/, '') : null;
95
- if (pkgVersion && versionInGuide) {
96
- log(versionInGuide === pkgVersion, `TRIGGER_GUIDE.md version is ${versionInGuide} vs package.json ${pkgVersion}`);
97
- } else if (!pkgVersion || !versionInGuide) {
98
- log(false, "Could not extract version for comparison in TRIGGER_GUIDE.md or package.json");
99
- }
100
- }
101
-
102
- process.exit(failed ? 1 : 0);
1
+ #!/usr/bin/env node
2
+ // sync-readme.mjs — 保持多语言 README 集合一致
3
+ //
4
+ // 文件布局(方案 A —— 三份独立文件):
5
+ // README.md ← 中文主文档(GitHub 首页 / npm 渲染页默认展示)
6
+ // README.zh.md ← 中文副本(保证 /README.zh.md 直链可用,与主文档一致)
7
+ // README.en.md ← 英文完整版(顶部语言栏切换目标)
8
+ //
9
+ // 用法:
10
+ // node scripts/sync-readme.mjs # 同步并校验(发现漂移时退出码 1)
11
+ // node scripts/sync-readme.mjs --check # 只校验,绝不写文件
12
+ import { readFileSync, writeFileSync, existsSync } from "node:fs";
13
+ import { fileURLToPath } from "node:url";
14
+ import path from "node:path";
15
+
16
+ const here = path.dirname(fileURLToPath(import.meta.url));
17
+ const root = path.resolve(here, "..");
18
+
19
+ const ZH_MASTER = path.join(root, "README.md"); // 中文主文档(首页默认)
20
+ const ZH_MIRROR = path.join(root, "README.zh.md"); // 中文副本
21
+ const EN = path.join(root, "README.en.md"); // 英文完整版
22
+ const checkOnly = process.argv.includes("--check");
23
+ const NAV_EN = "(README.en.md)";
24
+ const NAV_ZH = "(README.zh.md)";
25
+
26
+ let failed = false;
27
+ const log = (ok, msg) => {
28
+ console.log(`${ok ? "PASS" : "FAIL"} ${msg}`);
29
+ if (!ok) failed = true;
30
+ };
31
+
32
+ const hasNav = (text) => text.includes(NAV_EN) && text.includes(NAV_ZH);
33
+
34
+ // ---- 1. 中文主文档(首页默认)----
35
+ if (!existsSync(ZH_MASTER)) {
36
+ log(false, "README.md (中文主文档) is missing");
37
+ } else {
38
+ const master = readFileSync(ZH_MASTER, "utf8");
39
+ log(hasNav(master), "README.md has the language-switch nav bar");
40
+
41
+ // 中文主文档 → README.zh.md 副本
42
+ if (existsSync(ZH_MIRROR)) {
43
+ if (readFileSync(ZH_MIRROR, "utf8") === master) {
44
+ log(true, "README.zh.md is in sync with README.md");
45
+ } else if (checkOnly) {
46
+ log(false, "README.zh.md differs from README.md — run `npm run sync:readme`");
47
+ } else {
48
+ writeFileSync(ZH_MIRROR, master, "utf8");
49
+ log(true, "README.zh.md synced from README.md");
50
+ }
51
+ } else if (checkOnly) {
52
+ log(false, "README.zh.md is missing — run `npm run sync:readme`");
53
+ } else {
54
+ writeFileSync(ZH_MIRROR, master, "utf8");
55
+ log(true, "README.zh.md created from README.md");
56
+ }
57
+ }
58
+
59
+ // ---- 2. 英文完整版 ----
60
+ if (!existsSync(EN)) {
61
+ log(false, "README.en.md (English version) is missing");
62
+ } else {
63
+ const en = readFileSync(EN, "utf8");
64
+ log(hasNav(en), "README.en.md has the language-switch nav bar");
65
+ if (/^#\s+.*(中文)/m.test(en.split("\n").slice(0, 12).join("\n"))) {
66
+ log(false, "README.en.md looks like the Chinese version — check the copy");
67
+ } else {
68
+ log(true, "README.en.md is the English version");
69
+ }
70
+ }
71
+
72
+ // ---- 3. TRIGGER_GUIDE.md ----
73
+ const TRIGGER_GUIDE = path.join(root, "TRIGGER_GUIDE.md");
74
+ if (!existsSync(TRIGGER_GUIDE)) {
75
+ log(false, "TRIGGER_GUIDE.md is missing");
76
+ } else {
77
+ const guide = readFileSync(TRIGGER_GUIDE, "utf8");
78
+ log(true, "TRIGGER_GUIDE.md exists");
79
+
80
+ // 3.1 检查版本号与 package.json 一致
81
+ const pkgVersion = (() => {
82
+ try {
83
+ const pkg = JSON.parse(readFileSync(path.join(root, "package.json"), "utf8"));
84
+ return pkg.version;
85
+ } catch (e) {
86
+ return null;
87
+ }
88
+ })();
89
+ // 尝试从末尾的 '**版本**:' 字段提取版本号,去掉可能的 'v' 前缀。
90
+ // 冒号可能是半角 `:` 或全角 `:`(Markdown 里两种都常见)—— 早先只认半角,
91
+ // 结果升版本时把 TRIGGER_GUIDE.md 里写成全角的那一处漏改,本检查直接报
92
+ // 「提取不到版本号」而看不出真实原因。
93
+ const versionMatch = guide.match(/\*\*版本\*\*\s*[::]\s*(v?\d+\.\d+\.\d+)/);
94
+ const versionInGuide = versionMatch ? versionMatch[1].replace(/^v/, '') : null;
95
+ if (pkgVersion && versionInGuide) {
96
+ log(versionInGuide === pkgVersion, `TRIGGER_GUIDE.md version is ${versionInGuide} vs package.json ${pkgVersion}`);
97
+ } else if (!pkgVersion || !versionInGuide) {
98
+ log(false, "Could not extract version for comparison in TRIGGER_GUIDE.md or package.json");
99
+ }
100
+ }
101
+
102
+ process.exit(failed ? 1 : 0);
@@ -1,55 +1,55 @@
1
- #!/usr/bin/env bash
2
- # 端到端实测:激活 → 闸门 → 放行 → 不触发 → 审计链
3
- # 用法: bash scripts/verify-activation-e2e.sh [repo-root]
4
- #
5
- # 根目录默认从**脚本自身位置**推导(scripts/ → 仓库根),
6
- # 不写死任何开发者的本机路径 —— 旧实现写死了某台开发机的本机路径,
7
- # 在别人机器上会 cd 到不存在的路径;且在 opencode 包里还指向 cindy 仓(跨仓串味)。
8
- set -u
9
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
- ROOT="${1:-$(cd "$SCRIPT_DIR/.." && pwd)}"
11
- cd "$ROOT" || { echo "✗ 无法进入仓库根目录: $ROOT"; exit 1; }
12
-
13
- export CARLOS_FLOW_HOME="$(mktemp -d)"
14
- export CARLOS_FLOW_MCP_ROOT="$ROOT"
15
- export BRIDGE_PORT="${BRIDGE_PORT:-19655}"
16
-
17
- C="node client/carlos.js"
18
-
19
- echo "══ ① 激活(真实客户端进程)══"
20
- $C flow_status '{"sessionId":"final-1","triggerMessage":"run dispatch workflow"}' 2>&1 | grep -E "判定触发|已执行激活步骤"
21
-
22
- echo ""
23
- echo "══ ② 服务端状态真的变了 ══"
24
- $C flow_status '{"sessionId":"final-1"}' 2>/dev/null | grep -E '"has_card"|"tier"|"activation_pending"' -A3 | head -8
25
-
26
- echo ""
27
- echo "══ ③ 闸门真实拦截(claim)══"
28
- $C flow_claim '{"sessionId":"final-1","role":"executor"}' 2>&1 | tail -1
29
-
30
- echo ""
31
- echo "══ ④ 闸门真实拦截(verdict / 未派发就记 PASS)══"
32
- $C flow_verdict '{"sessionId":"final-1","verdict":"PASS"}' 2>&1 | tail -1
33
-
34
- echo ""
35
- echo "══ ⑤ 三项补齐 → 闸门解除 → 真实放行 ══"
36
- $C flow_submit_requirement '{"sessionId":"final-1","goal":"给 README 补说明","quote":"run dispatch workflow","scope":["README.md"],"acceptance":["含新增段落"],"verify":{"cmd":"node -e \"process.exit(0)\""},"confirmed":true}' 2>/dev/null | grep -E '"ok":|"tier"' | head -2
37
- $C flow_claim '{"sessionId":"final-1","role":"executor"}' 2>/dev/null | grep -E '"ok":|"objective"' | head -2
38
-
39
- echo ""
40
- echo "══ ⑥ 不传 triggerMessage → 完全不触发(防自伤)══"
41
- $C flow_status '{"sessionId":"final-2","message":"run the dispatch workflow"}' 2>&1 | grep -cE "已执行激活步骤" | sed 's/^/ 激活步骤出现次数: /'
42
- $C flow_status '{"sessionId":"final-2"}' 2>/dev/null | grep -E '"has_card"' | head -1
43
-
44
- echo ""
45
- echo "══ ⑦ 审计链可追溯 ══"
46
- $C flow_audit '{"sessionId":"final-1","limit":50}' 2>/dev/null | grep -E '"activation|"activation_gate_held|"activation_released|"verdict_denied' | head -6
47
-
48
- echo ""
49
- echo "══ ⑧ 状态落点(隔离目录,不污染真实状态)══"
50
- echo " CARLOS_FLOW_HOME=$CARLOS_FLOW_HOME"
51
- ls "$CARLOS_FLOW_HOME/gate-state/runs/" 2>/dev/null | sed 's/^/ run: /'
52
-
53
- rm -rf "$CARLOS_FLOW_HOME"
54
- echo ""
55
- echo "══ 完成 ══"
1
+ #!/usr/bin/env bash
2
+ # 端到端实测:激活 → 闸门 → 放行 → 不触发 → 审计链
3
+ # 用法: bash scripts/verify-activation-e2e.sh [repo-root]
4
+ #
5
+ # 根目录默认从**脚本自身位置**推导(scripts/ → 仓库根),
6
+ # 不写死任何开发者的本机路径 —— 旧实现写死了某台开发机的本机路径,
7
+ # 在别人机器上会 cd 到不存在的路径;且在 opencode 包里还指向 cindy 仓(跨仓串味)。
8
+ set -u
9
+ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
+ ROOT="${1:-$(cd "$SCRIPT_DIR/.." && pwd)}"
11
+ cd "$ROOT" || { echo "✗ 无法进入仓库根目录: $ROOT"; exit 1; }
12
+
13
+ export CARLOS_FLOW_HOME="$(mktemp -d)"
14
+ export CARLOS_FLOW_MCP_ROOT="$ROOT"
15
+ export BRIDGE_PORT="${BRIDGE_PORT:-19655}"
16
+
17
+ C="node client/carlos.js"
18
+
19
+ echo "══ ① 激活(真实客户端进程)══"
20
+ $C flow_status '{"sessionId":"final-1","triggerMessage":"run dispatch workflow"}' 2>&1 | grep -E "判定触发|已执行激活步骤"
21
+
22
+ echo ""
23
+ echo "══ ② 服务端状态真的变了 ══"
24
+ $C flow_status '{"sessionId":"final-1"}' 2>/dev/null | grep -E '"has_card"|"tier"|"activation_pending"' -A3 | head -8
25
+
26
+ echo ""
27
+ echo "══ ③ 闸门真实拦截(claim)══"
28
+ $C flow_claim '{"sessionId":"final-1","role":"executor"}' 2>&1 | tail -1
29
+
30
+ echo ""
31
+ echo "══ ④ 闸门真实拦截(verdict / 未派发就记 PASS)══"
32
+ $C flow_verdict '{"sessionId":"final-1","verdict":"PASS"}' 2>&1 | tail -1
33
+
34
+ echo ""
35
+ echo "══ ⑤ 三项补齐 → 闸门解除 → 真实放行 ══"
36
+ $C flow_submit_requirement '{"sessionId":"final-1","goal":"给 README 补说明","quote":"run dispatch workflow","scope":["README.md"],"acceptance":["含新增段落"],"verify":{"cmd":"node -e \"process.exit(0)\""},"confirmed":true}' 2>/dev/null | grep -E '"ok":|"tier"' | head -2
37
+ $C flow_claim '{"sessionId":"final-1","role":"executor"}' 2>/dev/null | grep -E '"ok":|"objective"' | head -2
38
+
39
+ echo ""
40
+ echo "══ ⑥ 不传 triggerMessage → 完全不触发(防自伤)══"
41
+ $C flow_status '{"sessionId":"final-2","message":"run the dispatch workflow"}' 2>&1 | grep -cE "已执行激活步骤" | sed 's/^/ 激活步骤出现次数: /'
42
+ $C flow_status '{"sessionId":"final-2"}' 2>/dev/null | grep -E '"has_card"' | head -1
43
+
44
+ echo ""
45
+ echo "══ ⑦ 审计链可追溯 ══"
46
+ $C flow_audit '{"sessionId":"final-1","limit":50}' 2>/dev/null | grep -E '"activation|"activation_gate_held|"activation_released|"verdict_denied' | head -6
47
+
48
+ echo ""
49
+ echo "══ ⑧ 状态落点(隔离目录,不污染真实状态)══"
50
+ echo " CARLOS_FLOW_HOME=$CARLOS_FLOW_HOME"
51
+ ls "$CARLOS_FLOW_HOME/gate-state/runs/" 2>/dev/null | sed 's/^/ run: /'
52
+
53
+ rm -rf "$CARLOS_FLOW_HOME"
54
+ echo ""
55
+ echo "══ 完成 ══"
package/smoke-test.js CHANGED
@@ -8,9 +8,9 @@ import { spawn } from "node:child_process";
8
8
  import net from "node:net";
9
9
  import { performance } from "node:perf_hooks";
10
10
 
11
- const PORT = Number(process.env.BRIDGE_PORT || 19099);
11
+ const PORT = Number(process.env.BRIDGE_PORT || 20099);
12
12
  const TOKEN = process.env.CARLOS_BRIDGE_TOKEN || "";
13
- const EXPECTED_TOOLS_COUNT = 19;
13
+ const EXPECTED_TOOLS_COUNT = 20;
14
14
 
15
15
  // 单次 RPC:一条连接发一个请求,收满响应就返回
16
16
  function rpcOnce(request) {