carlos-flow 2.7.0 → 2.8.0

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.
@@ -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 "══ 完成 ══"