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.
- package/CHANGELOG.md +47 -0
- package/TRIGGER_GUIDE.md +783 -783
- package/bridge/mcp-bridge.js +203 -203
- package/check-all.sh +0 -0
- package/ghost.json +26 -1
- package/package.json +113 -113
- package/plugins/carlos-flow-trigger.js +215 -215
- package/scripts/check-no-dead-handler.mjs +2 -2
- package/scripts/check-templates.mjs +126 -126
- package/scripts/clean-readme-noise.mjs +53 -53
- package/scripts/install-hooks.mjs +166 -153
- package/scripts/lang-audit.mjs +172 -172
- package/scripts/mutation-check.mjs +483 -483
- package/scripts/publish-gate.mjs +24 -3
- package/scripts/sync-readme.mjs +102 -102
- package/scripts/verify-activation-e2e.sh +55 -55
- package/smoke-test.js +2 -2
- package/src/card.js +296 -288
- package/src/dispatch.js +557 -548
- package/src/index.js +1713 -1686
- package/src/profiles.js +17 -0
- package/src/protocol.js +95 -85
- package/src/state.js +930 -898
package/src/profiles.js
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
export const PROMPT_PROFILES = {
|
|
2
|
+
developer: {
|
|
3
|
+
objective: "审计:任务卡执行与代码修改",
|
|
4
|
+
format: "判定(PASS / WARN / FAIL) / 改动证据(file:line)",
|
|
5
|
+
guidance: "只改 scope 内文件;验证命令由主 Agent 指定,不得自选。"
|
|
6
|
+
},
|
|
7
|
+
tester: {
|
|
8
|
+
objective: "审计:验证命令执行与负对照",
|
|
9
|
+
format: "验证记录(命令 → exit code → 输出摘要)+ 失败复现步骤",
|
|
10
|
+
guidance: "跑验证命令与负对照;零文件改动;不轻信开发自述。"
|
|
11
|
+
},
|
|
12
|
+
reviewer: {
|
|
13
|
+
objective: "审计:任务卡验收标准忠实度",
|
|
14
|
+
format: "裁定(通过/不通过) / 失败类型 / scope 标注 / 证据 / 附注",
|
|
15
|
+
guidance: "只读取证,逐条给 file:line 证据;PASS 须由 reviewer 身份落下。"
|
|
16
|
+
}
|
|
17
|
+
};
|
package/src/protocol.js
CHANGED
|
@@ -1,86 +1,96 @@
|
|
|
1
|
-
// Carlos Flow 协议 — 路由档位 / 四段合同 / 报告规格 / 错误分层 / 状态字段的唯一真源。
|
|
2
|
-
// 被协调器(coordinator)与各角色 Agent 共同引用。
|
|
3
|
-
|
|
4
|
-
// 状态字段从 defaultState() 生成,而不是手写常量 ——
|
|
5
|
-
// 手写副本会漂移(历史上就漏过 claimed / claimed_role / activation_* 等 9 个字段),
|
|
6
|
-
// 而协议是 Agent 运行时读取的权威依据,漂移会让 Agent 按错误的字段名做决策。
|
|
7
|
-
// 代价:protocol.js 依赖 state.js(纯数据模块,无副作用,无循环依赖)。
|
|
8
|
-
import { defaultState } from "./state.js";
|
|
9
|
-
|
|
10
|
-
export const
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
|
33
|
-
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
"
|
|
51
|
-
"
|
|
52
|
-
"
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
"
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
1
|
+
// Carlos Flow 协议 — 路由档位 / 四段合同 / 报告规格 / 错误分层 / 状态字段的唯一真源。
|
|
2
|
+
// 被协调器(coordinator)与各角色 Agent 共同引用。
|
|
3
|
+
|
|
4
|
+
// 状态字段从 defaultState() 生成,而不是手写常量 ——
|
|
5
|
+
// 手写副本会漂移(历史上就漏过 claimed / claimed_role / activation_* 等 9 个字段),
|
|
6
|
+
// 而协议是 Agent 运行时读取的权威依据,漂移会让 Agent 按错误的字段名做决策。
|
|
7
|
+
// 代价:protocol.js 依赖 state.js(纯数据模块,无副作用,无循环依赖)。
|
|
8
|
+
import { defaultState } from "./state.js";
|
|
9
|
+
|
|
10
|
+
export const GUIDE_MODE = { ROSTER: "主agent(Orchestrator),开发(executor+developer),测试(executor+tester),审核(auditor+reviewer)", TALKING_POINTS: ["一次只说一件事", "术语给类比", "给选择题不抛开放式问题", "复述意图", "明示能力边界"], REPORT_TEMPLATE: "【在做什么】/【已经完成】/【要你选】/【还有什么风险】" };
|
|
11
|
+
|
|
12
|
+
export const PROTOCOL = {
|
|
13
|
+
ROUTE_TABLE: `| 档 | 场景 | 动作 |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| T0 | 讨论 / 解释 / 概念澄清 | 直接答,不派发、不填卡,0 个子 Agent,无门禁 |
|
|
16
|
+
| T1 | 只读调研(摸清代码现状) | 派 explore,1 个子 Agent,免门禁 |
|
|
17
|
+
| T2 | 修改代码 / 配置 / 文档 | 留痕 → 派 executor → 派 auditor,2 个子 Agent,机械门禁 + 独立复核 |
|
|
18
|
+
|
|
19
|
+
判定口径:要写文件 = T2;要读文件但不写 = T1;两者都不需要 = T0`,
|
|
20
|
+
|
|
21
|
+
FOUR_CONTRACT: `四段合同(每段一行,主 Agent 必须在任务卡里写全):
|
|
22
|
+
1. objective:一句话目标。
|
|
23
|
+
2. output format:executor 报告 ≤300 字,四段式 —— 结论 / 改动(file:line 逐条)/ 验证结果 / 遗留风险。
|
|
24
|
+
3. tool guidance:验证命令由主 Agent 指定,executor 不得自选测试项。
|
|
25
|
+
4. task boundaries:只准改清单里的文件,一个不多;要改别的 → 停下来在报告里说明,不要自己扩大范围。`,
|
|
26
|
+
|
|
27
|
+
REPORT_SPEC: `executor 报告 ≤300 字,四段式:结论 / 改动 / 验证 / 遗留风险。
|
|
28
|
+
auditor 报告 ≤200 字,五段式:裁定 / 失败类型 / scope 标注 / 证据 / 附注。`,
|
|
29
|
+
|
|
30
|
+
ERROR_LAYERS: `| 层 | 触发 | 处置 |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| 基础设施故障 | 网络抖动、模型不可用、配额耗尽 | 静默降级或改用 Explore / 自读只读验证,不把原始错误喂回 |
|
|
33
|
+
| Agent 故障 | 工具名错、参数错 | 把错误喂回并附恢复指引 |
|
|
34
|
+
| 接管 | 同一子 Agent 连续 2 次失败 | 接管 = 只读验证,不写文件 |
|
|
35
|
+
| 门禁拒绝(非错误) | 闸门拦下当前动作(如 PASS 裁定角色不对、验证未跑通、验证已过期、scope 越界、双轴未齐) | **这不是工具坏了**,是门禁在正常工作。按错误信息里的下一步修正后重试:补齐缺失动作(如先 flow_claim role=auditor)再重试。**不要重试同一调用** |`,
|
|
36
|
+
|
|
37
|
+
// 从 defaultState() 生成,保证与状态结构永远一致(漂移防护)。
|
|
38
|
+
// 测试 test/protocol-consistency.mjs 会逐字段比对,手工改回常量会红。
|
|
39
|
+
STATE_FIELDS: JSON.stringify(defaultState()),
|
|
40
|
+
|
|
41
|
+
AUDIT_EVENTS: `["run","finding","decision","resolution"]`,
|
|
42
|
+
|
|
43
|
+
BYPASS_WORDS: `["直接干","跳过门禁","免检","别管流程","不用走流程"]`,
|
|
44
|
+
|
|
45
|
+
CARD_TEMPLATE: `FLOW_CARD:{"goal":"一句话目标","quote":"用户原话摘录","scope":["只准改的文件"],"acceptance":["可判定的验收标准"],"unknowns":[],"assumptions":[],"files":[{"path":"a/b.py","line":1}],"verify":{"cmd":"pytest -q tests/x.py"},"confirmed":false}`,
|
|
46
|
+
};
|
|
47
|
+
|
|
48
|
+
// 敏感文件名单(三种匹配方式:文件名命中 / 路径段命中 / 扩展名命中)
|
|
49
|
+
const SENSITIVE_NAMES = new Set([
|
|
50
|
+
".env", ".env.local", ".env.development", ".env.production", ".env.test",
|
|
51
|
+
"settings.json", "settings.local.json",
|
|
52
|
+
"package.json", "package-lock.json", "yarn.lock", "pnpm-lock.yaml",
|
|
53
|
+
"poetry.lock", "requirements.txt",
|
|
54
|
+
"dockerfile", "docker-compose.yml", "docker-compose.yaml", "makefile",
|
|
55
|
+
// 凭证与私钥(2026-11-14 补):此前 .ssh/id_rsa、.npmrc、.aws/credentials
|
|
56
|
+
// 这类高价值目标一律放行,executor 改它们不会触发 confirmed 确认。
|
|
57
|
+
"id_rsa", "id_dsa", "id_ecdsa", "id_ed25519", "id_ed448",
|
|
58
|
+
".npmrc", ".netrc", ".pgpass", "credentials", "known_hosts", "authorized_keys",
|
|
59
|
+
]);
|
|
60
|
+
|
|
61
|
+
const SENSITIVE_SEGMENTS = new Set([
|
|
62
|
+
"migrations", "deploy", "deployment", "k8s", "kube",
|
|
63
|
+
".github", ".gitlab", "secrets", "certs", "terraform",
|
|
64
|
+
// 凭证目录(2026-11-14 补):只检查目录段,所以 ".ssh" 能拦住 .ssh/id_rsa。
|
|
65
|
+
".ssh", ".aws", ".gnupg", ".docker", ".azure", ".gcloud",
|
|
66
|
+
]);
|
|
67
|
+
|
|
68
|
+
const SENSITIVE_EXTENSIONS = new Set([
|
|
69
|
+
".pem", ".key", ".p12", ".pfx", ".env",
|
|
70
|
+
// 密码库与签名材料(2026-11-14 补)
|
|
71
|
+
".kdbx", ".kdb", ".gpg", ".asc", ".crt", ".cer", ".der",
|
|
72
|
+
]);
|
|
73
|
+
|
|
74
|
+
export function isSensitive(rel) {
|
|
75
|
+
if (typeof rel !== "string" || rel.length === 0) return false;
|
|
76
|
+
const normalized = rel.replace(/\\/g, "/").toLowerCase();
|
|
77
|
+
const segments = normalized.split("/").filter((s) => s.length > 0);
|
|
78
|
+
const base = segments.length ? segments[segments.length - 1] : normalized;
|
|
79
|
+
|
|
80
|
+
if (SENSITIVE_NAMES.has(base)) return true;
|
|
81
|
+
// 只检查目录段(不含最后一段文件名):与 card.js 保持一致
|
|
82
|
+
for (const seg of segments.slice(0, -1)) {
|
|
83
|
+
if (SENSITIVE_SEGMENTS.has(seg)) return true;
|
|
84
|
+
}
|
|
85
|
+
for (const ext of SENSITIVE_EXTENSIONS) {
|
|
86
|
+
if (base.endsWith(ext)) return true;
|
|
87
|
+
}
|
|
88
|
+
return false;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
export function riskTier(scope) {
|
|
92
|
+
if (!Array.isArray(scope) || scope.length === 0) return "read_only";
|
|
93
|
+
if (scope.some((p) => isSensitive(p))) return "sensitive";
|
|
94
|
+
if (scope.length === 1) return "single_file";
|
|
95
|
+
return "cross_module";
|
|
86
96
|
}
|