carlos-flow 2.11.0 → 2.11.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 +95 -0
- package/INSTALL.md +103 -0
- package/RELEASE_NOTES.md +30 -0
- package/TRIGGER_GUIDE.md +2 -2
- package/bridge/mcp-bridge.js +19 -3
- package/check-all.sh +29 -0
- package/client/carlos.js +20 -6
- package/ghost.json +1 -1
- package/package.json +15 -4
- package/scripts/check-templates.mjs +126 -0
- package/scripts/install-hooks.mjs +153 -0
- package/scripts/publish-gate.mjs +121 -0
- package/scripts/sync-version.mjs +155 -0
- package/smoke-test.js +142 -0
- package/src/index.js +66 -1
- package/src/state.js +117 -6
- package/templates/cursor.mcp.json +11 -0
- package/templates/vscode.settings.json +11 -0
- package/templates/windsurf.mcp.json +11 -0
package/src/state.js
CHANGED
|
@@ -219,14 +219,52 @@ export function defaultState() {
|
|
|
219
219
|
}
|
|
220
220
|
|
|
221
221
|
export function loadState(sid) {
|
|
222
|
+
const file = path.join(RUNS_DIR, sanitizeId(sid), "state.json");
|
|
223
|
+
|
|
224
|
+
// 读失败必须区分「真的没有」与「暂时读不到」。
|
|
225
|
+
//
|
|
226
|
+
// 背景(2026-11-13 实测):旧实现把**任何**读/解析失败都当成「状态不存在」,
|
|
227
|
+
// 返回 defaultState()。而 saveState 用的是 tmp+rename,
|
|
228
|
+
// 在 Windows 上 rename 与其他进程的 readFileSync 存在竞争窗口(EBUSY/EPERM),
|
|
229
|
+
// 读失败 → prev 退化成默认值 → activation_activated 丢成 false →
|
|
230
|
+
// 紧接着的写入把「占位卡的 pending=[三项]」覆盖成「普通卡的 pending=[]」
|
|
231
|
+
// → **激活闸门被绕过**。
|
|
232
|
+
// 这正是并发测试「零泄漏」偶发失败的根因(实测 370 轮里漏 1)。
|
|
233
|
+
//
|
|
234
|
+
// 现在:只有「文件不存在」才返回默认值;
|
|
235
|
+
// 瞬时错误先重试;仍失败则**报错**(fail-closed),
|
|
236
|
+
// 绝不静默把一个有闸门的状态当成无闸门的状态。
|
|
237
|
+
let raw = null;
|
|
238
|
+
let lastErr = null;
|
|
239
|
+
for (let attempt = 0; attempt < 5; attempt++) {
|
|
240
|
+
try {
|
|
241
|
+
raw = fs.readFileSync(file, "utf8");
|
|
242
|
+
lastErr = null;
|
|
243
|
+
break;
|
|
244
|
+
} catch (e) {
|
|
245
|
+
if (e.code === "ENOENT") return defaultState(); // 真的没有
|
|
246
|
+
lastErr = e;
|
|
247
|
+
sleepMs(10 * (attempt + 1)); // 瞬时竞争窗口,退避重试
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
if (lastErr) {
|
|
251
|
+
throw new Error(
|
|
252
|
+
"读取状态失败(" + (lastErr.code || lastErr.message) + "):" + file +
|
|
253
|
+
"。为避免丢掉门禁状态,本次操作已中止,请稍后重试。",
|
|
254
|
+
);
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
let parsed;
|
|
222
258
|
try {
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
259
|
+
parsed = JSON.parse(raw);
|
|
260
|
+
} catch (e) {
|
|
261
|
+
throw new Error(
|
|
262
|
+
"状态文件损坏,无法解析:" + file + "(" + e.message + ")。" +
|
|
263
|
+
"为避免丢掉门禁状态,本次操作已中止;如确认可丢弃该会话状态,可删除该文件后重试。",
|
|
264
|
+
);
|
|
229
265
|
}
|
|
266
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return defaultState();
|
|
267
|
+
return { ...defaultState(), ...migrate(parsed) };
|
|
230
268
|
}
|
|
231
269
|
|
|
232
270
|
export function saveState(sid, state) {
|
|
@@ -785,4 +823,77 @@ export function isBypassed(state) {
|
|
|
785
823
|
if (!state.bypass_ts) return false;
|
|
786
824
|
if (state.card_ts && state.bypass_ts < state.card_ts) return false;
|
|
787
825
|
return true;
|
|
826
|
+
}
|
|
827
|
+
|
|
828
|
+
// ---------------------------------------------------------------------------
|
|
829
|
+
// workspaceFingerprint —— 工作区代码状态指纹
|
|
830
|
+
//
|
|
831
|
+
// 为什么需要(A1):
|
|
832
|
+
// 原来的 PASS 闸门只看 last_verify 的三个字段(存在 / ok===true / cmd 与卡片一致),
|
|
833
|
+
// **不绑定代码状态**。于是存在这条绕过路径:
|
|
834
|
+
// 1. flow_run_verify 跑通 → last_verify = {ok:true, cmd:"npm test"}
|
|
835
|
+
// 2. executor 继续改代码(甚至改坏)
|
|
836
|
+
// 3. flow_verdict(PASS) → 三个条件全满足 → 放行
|
|
837
|
+
// 指纹把「验证通过」绑定到**一次可复现的运行**:验证之后再动过代码,指纹就变了。
|
|
838
|
+
//
|
|
839
|
+
// 指纹构成:HEAD 提交 + `git diff HEAD` 的全文 + 全部未跟踪文件(路径 + 内容)。
|
|
840
|
+
// · 未跟踪文件必须计入:新建文件是最常见的越界/破坏手段。
|
|
841
|
+
// · `.carlos-flow/` 必须排除:跑一次检查会创建状态目录,计入则立即自我失效。
|
|
842
|
+
//
|
|
843
|
+
// 非 git 目录:显式返回 {ok:false, reason:"not_a_git_repo"},**不崩**。
|
|
844
|
+
// Carlos Flow 明确支持非 Git 项目,所以调用方要 fail-open(不阻断 PASS),
|
|
845
|
+
// 但要在 flow_status 里如实标注指纹不可用。
|
|
846
|
+
export function workspaceFingerprint(cwd) {
|
|
847
|
+
const dir = cwd || process.cwd();
|
|
848
|
+
const head = spawnSync("git", ["rev-parse", "HEAD"], { cwd: dir, encoding: "utf8" });
|
|
849
|
+
if (head.error || head.status !== 0) {
|
|
850
|
+
return { ok: false, reason: "not_a_git_repo" };
|
|
851
|
+
}
|
|
852
|
+
const diff = spawnSync("git", ["diff", "HEAD", "--no-color"], { cwd: dir, encoding: "utf8" });
|
|
853
|
+
const untracked = spawnSync("git", ["ls-files", "--others", "--exclude-standard"], {
|
|
854
|
+
cwd: dir,
|
|
855
|
+
encoding: "utf8",
|
|
856
|
+
});
|
|
857
|
+
|
|
858
|
+
const h = createHash("sha256");
|
|
859
|
+
h.update(String(diff.stdout || ""));
|
|
860
|
+
|
|
861
|
+
const files = String(untracked.stdout || "")
|
|
862
|
+
.split("\n")
|
|
863
|
+
.map((s) => s.trim())
|
|
864
|
+
.filter(Boolean)
|
|
865
|
+
.sort();
|
|
866
|
+
|
|
867
|
+
// 状态目录必须排除(R3):跑一次检查就会往里写审计/状态文件,
|
|
868
|
+
// 若计入指纹则「验证 → 落审计 → 记裁定」之间指纹必变 → 每次都误报 STALE。
|
|
869
|
+
//
|
|
870
|
+
// ⚠️ 不能只硬编码 ".carlos-flow/":状态目录由 CARLOS_FLOW_HOME 决定,
|
|
871
|
+
// 用户完全可以把它设在**项目内部**(如 <repo>/.flowhome),那就会自我失效。
|
|
872
|
+
// 所以这里按**解析后的绝对路径**排除真正的 FLOW_HOME,
|
|
873
|
+
// 同时保留 .carlos-flow/ 的字面排除以兼容默认布局。
|
|
874
|
+
const flowHomeAbs = path.resolve(FLOW_HOME);
|
|
875
|
+
for (const f of files) {
|
|
876
|
+
const abs = path.resolve(dir, f);
|
|
877
|
+
const inFlowHome = abs === flowHomeAbs || abs.startsWith(flowHomeAbs + path.sep);
|
|
878
|
+
if (inFlowHome) continue;
|
|
879
|
+
if (f.startsWith(".carlos-flow/") || f.startsWith(".carlos-flow\\")) continue;
|
|
880
|
+
h.update(`\u0000untracked-file:${f}\u0000`);
|
|
881
|
+
try {
|
|
882
|
+
const buf = fs.readFileSync(path.join(dir, f));
|
|
883
|
+
// 大文件只入路径 + 大小,不入内容(避免读上万文件/大文件)
|
|
884
|
+
if (buf.length > 1024 * 1024) {
|
|
885
|
+
h.update(`size:${buf.length}`);
|
|
886
|
+
} else {
|
|
887
|
+
h.update(buf);
|
|
888
|
+
}
|
|
889
|
+
} catch (e) {
|
|
890
|
+
h.update(`<<unreadable: ${e}>>`);
|
|
891
|
+
}
|
|
892
|
+
}
|
|
893
|
+
|
|
894
|
+
return {
|
|
895
|
+
ok: true,
|
|
896
|
+
head: String(head.stdout || "").trim(),
|
|
897
|
+
diff_sha256: h.digest("hex"),
|
|
898
|
+
};
|
|
788
899
|
}
|