@fieldwangai/agentflow 0.1.25

package/bin/pipeline/extract-thinking.mjs

@@ -0,0 +1,308 @@
+#!/usr/bin/env node
+/**
+ * 从 agentflow 某次运行的 logs/log.txt 中：
+ * 1. 提取 [cursor-stdout-raw] 里 type=thinking、subtype=delta 的 text，按 session_id 聚合
+ * 2. 每个 session 下附带 node-id（instanceId）以及传给该节点的 prompt（路径 + 完整内容或前 800 字）
+ * 3. 保留节点执行情况（node-start / node-done / result status）
+ * 输出写入该次 run 的 logs/thinking_by_session_and_nodes.md
+ *
+ * 用法（apply -ai 步骤）：
+ *   agentflow apply -ai extract-thinking <workspaceRoot> <flowName> <uuid>
+ * 用法（顶层命令由 CLI 调用）：
+ *   agentflow extract-thinking <flowName> <uuid>
+ * 等价于在工作区根目录执行上述 -ai 步骤。
+ *
+ * 输入：<runDir>/logs/log.txt
+ * 输出：<runDir>/logs/thinking_by_session_and_nodes.md
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+import { getRunDir } from "../lib/paths.mjs";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const LOG_REL = "logs/log.txt";
+const OUT_REL = "logs/thinking_by_session_and_nodes.md";
+
+/** 从 log 行提取 [tag] 后的 message 部分（用于 cli-raw 等非 JSON 行） */
+function getMessageAfterTag(line, tag) {
+  const marker = `[${tag}]`;
+  const idx = line.indexOf(marker);
+  if (idx === -1) return null;
+  const after = line.slice(idx + marker.length).replace(/^\s+/, "");
+  return after || null;
+}
+
+/** 判断是否为新的一条 log 行（以 [ISO 时间] 开头） */
+function isNewLogLine(line) {
+  return /^\[\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(line.trim());
+}
+
+function extractThinking(logContent) {
+  const lines = logContent.split(/\r?\n/);
+  /** session_id -> { texts: string[], instanceId?, label?, promptPath?, promptPreview? } */
+  const thinkingBySession = Object.create(null);
+  const nodeRuns = [];
+  const resultStatus = Object.create(null);
+  let cursorRawLines = 0;
+  let thinkingDeltaCount = 0;
+
+  let currentInstanceId = null;
+  let currentLabel = null;
+  let currentPromptPath = null;
+  let currentPromptPreview = null;
+  let currentPromptFull = null;
+
+  const jsonMatch = (line) => {
+    const i = line.indexOf("{");
+    if (i === -1) return null;
+    return line.slice(i);
+  };
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+
+    const tag = line.includes("[cursor-stdout-raw]")
+      ? "cursor-stdout-raw"
+      : line.includes("[claude-code-stdout-raw]")
+        ? "claude-code-stdout-raw"
+        : line.includes("[cli]")
+          ? "cli"
+          : line.includes("[result]")
+            ? "result"
+            : line.includes("[cli-raw]")
+              ? "cli-raw"
+              : null;
+
+    if (tag === "cli-raw") {
+      const msg = getMessageAfterTag(line, "cli-raw");
+      if (msg && msg.startsWith("Prompt: ")) {
+        currentPromptPath = msg.slice(8).trim();
+      } else {
+        const fullPrefixes = ["Cursor CLI prompt 完整", "Claude Code CLI prompt 完整"];
+        const previewPrefixes = ["Cursor CLI prompt 前 800 字", "Claude Code CLI prompt 前 800 字"];
+        const fullHit = msg ? fullPrefixes.find((p) => msg.startsWith(p)) : null;
+        const previewHit = msg && !fullHit ? previewPrefixes.find((p) => msg.startsWith(p)) : null;
+        if (fullHit || previewHit) {
+          const prefix = fullHit || previewHit;
+          const afterPrefix = msg.slice(prefix.length).replace(/^[:\s]*\n?/, "");
+          const rest = [afterPrefix];
+          for (let j = i + 1; j < lines.length; j++) {
+            const next = lines[j];
+            if (isNewLogLine(next)) break;
+            rest.push(next);
+          }
+          const content = rest.join("\n").trim();
+          if (fullHit) currentPromptFull = content;
+          else currentPromptPreview = content;
+        }
+      }
+      continue;
+    }
+
+    const raw = jsonMatch(line);
+    if (!raw) continue;
+
+    try {
+      if (tag === "cursor-stdout-raw") {
+        cursorRawLines += 1;
+        const obj = JSON.parse(raw);
+        const isThinkingDelta = obj.type === "thinking" && obj.subtype === "delta" && obj.text != null && obj.session_id;
+        const isThinkingOther = obj.type === "thinking" && obj.session_id && (obj.text != null || (obj.content && typeof obj.content === "string"));
+        if (isThinkingDelta || isThinkingOther) {
+          thinkingDeltaCount += 1;
+          const sid = obj.session_id;
+          const text = obj.text != null ? obj.text : (obj.content || "");
+          if (!text && isThinkingOther) continue;
+          if (!thinkingBySession[sid]) {
+            thinkingBySession[sid] = {
+              texts: [],
+              instanceId: currentInstanceId ?? undefined,
+              label: currentLabel ?? undefined,
+              promptPath: currentPromptPath ?? undefined,
+              promptPreview: currentPromptPreview ?? undefined,
+              promptFull: currentPromptFull ?? undefined,
+            };
+            if (currentInstanceId) {
+              for (let r = nodeRuns.length - 1; r >= 0; r--) {
+                if (nodeRuns[r].instanceId === currentInstanceId && nodeRuns[r].session_id == null) {
+                  nodeRuns[r].session_id = sid;
+                  break;
+                }
+              }
+            }
+          }
+          thinkingBySession[sid].texts.push(text);
+        }
+        continue;
+      }
+
+      if (tag === "claude-code-stdout-raw") {
+        cursorRawLines += 1;
+        const obj = JSON.parse(raw);
+        if (obj.type === "assistant" && obj.session_id && obj.message && Array.isArray(obj.message.content)) {
+          const sid = obj.session_id;
+          const thinkingBlocks = obj.message.content.filter(
+            (b) => b && b.type === "thinking" && typeof b.thinking === "string" && b.thinking.length > 0,
+          );
+          if (thinkingBlocks.length === 0) continue;
+          if (!thinkingBySession[sid]) {
+            thinkingBySession[sid] = {
+              texts: [],
+              instanceId: currentInstanceId ?? undefined,
+              label: currentLabel ?? undefined,
+              promptPath: currentPromptPath ?? undefined,
+              promptPreview: currentPromptPreview ?? undefined,
+              promptFull: currentPromptFull ?? undefined,
+            };
+            if (currentInstanceId) {
+              for (let r = nodeRuns.length - 1; r >= 0; r--) {
+                if (nodeRuns[r].instanceId === currentInstanceId && nodeRuns[r].session_id == null) {
+                  nodeRuns[r].session_id = sid;
+                  break;
+                }
+              }
+            }
+          }
+          for (const block of thinkingBlocks) {
+            thinkingDeltaCount += 1;
+            thinkingBySession[sid].texts.push(block.thinking);
+          }
+        }
+        continue;
+      }
+
+      if (tag === "cli") {
+        const obj = JSON.parse(raw);
+        if (obj.event === "node-start" && obj.instanceId) {
+          currentInstanceId = obj.instanceId;
+          currentLabel = obj.label || obj.instanceId;
+          currentPromptPath = null;
+          currentPromptPreview = null;
+          currentPromptFull = null;
+          const start = {
+            instanceId: obj.instanceId,
+            label: obj.label || obj.instanceId,
+            startTime: line.slice(0, 30),
+            elapsed: null,
+            total: null,
+            status: null,
+            message: null,
+            session_id: null,
+          };
+          nodeRuns.push(start);
+        } else if (obj.event === "node-done" && obj.instanceId) {
+          const last = nodeRuns[nodeRuns.length - 1];
+          if (last && last.instanceId === obj.instanceId) {
+            last.elapsed = obj.elapsed ?? null;
+            last.total = obj.total ?? null;
+          }
+          const res = resultStatus[obj.instanceId];
+          if (res && last && last.instanceId === obj.instanceId) {
+            last.status = res.status;
+            last.message = res.message;
+          }
+        }
+        continue;
+      }
+
+      if (tag === "result") {
+        const obj = JSON.parse(raw);
+        if (obj.instanceId) {
+          resultStatus[obj.instanceId] = { status: obj.status, message: obj.message || "" };
+        }
+      }
+    } catch (_) {
+      // 非 JSON 或解析失败忽略
+    }
+  }
+
+  for (const run of nodeRuns) {
+    if (run.status == null && resultStatus[run.instanceId]) {
+      run.status = resultStatus[run.instanceId].status;
+      run.message = resultStatus[run.instanceId].message;
+    }
+  }
+
+  return { thinkingBySession, nodeRuns, stats: { totalLogLines: lines.length, cursorRawLines, thinkingDeltaCount } };
+}
+
+function toMarkdown(thinkingBySession, nodeRuns, stats = {}) {
+  const parts = [];
+
+  if (stats.totalLogLines != null || stats.cursorRawLines != null || stats.thinkingDeltaCount != null) {
+    parts.push("本文件由 extract-thinking 从 log.txt 提取。\n");
+    parts.push(`Log 总行数: ${stats.totalLogLines ?? "-"}，[cursor-stdout-raw] 行数: ${stats.cursorRawLines ?? "-"}，thinking delta 数: ${stats.thinkingDeltaCount ?? "-"}，session 数: ${Object.keys(thinkingBySession).length}。\n`);
+    parts.push("（log 中大量为 check-cache / get-ready-nodes / cli 等；Cursor 与 Claude Code 流式输出的 thinking 会按 session 聚合。）\n\n");
+  }
+
+  parts.push("# 节点执行情况\n");
+  parts.push("| instanceId | label | session_id | elapsed | total | status | message |\n");
+  parts.push("|------------|-------|------------|---------|-------|--------|--------|\n");
+  for (const r of nodeRuns) {
+    const msg = (r.message || "").replace(/\|/g, "\\|").slice(0, 60);
+    const sid = (r.session_id ?? "-").replace(/\|/g, "\\|");
+    parts.push(`| ${r.instanceId} | ${r.label || ""} | ${sid} | ${r.elapsed ?? "-"} | ${r.total ?? "-"} | ${r.status ?? "-"} | ${msg} |\n`);
+  }
+
+  parts.push("\n---\n# Thinking 按 session_id 聚合\n");
+  const sessionIds = Object.keys(thinkingBySession).sort();
+  for (const sid of sessionIds) {
+    const entry = thinkingBySession[sid];
+    const texts = entry.texts || [];
+    const full = texts.join("");
+    parts.push(`## session_id: ${sid}\n`);
+    if (entry.instanceId != null) {
+      parts.push(`- **node-id**: ${entry.instanceId}${entry.label != null && entry.label !== entry.instanceId ? ` (${entry.label})` : ""}\n`);
+    }
+    if (entry.promptPath != null) {
+      parts.push(`- **prompt 路径**: ${entry.promptPath}\n`);
+    }
+    if (entry.promptFull != null && entry.promptFull.length > 0) {
+      parts.push(`- **prompt 完整内容**:\n\`\`\`\n${entry.promptFull}\n\`\`\`\n`);
+    } else if (entry.promptPreview != null && entry.promptPreview.length > 0) {
+      parts.push(`- **prompt 前 800 字**:\n\`\`\`\n${entry.promptPreview}\n\`\`\`\n`);
+    }
+    parts.push(full.trim() || "(无文本)");
+    parts.push("\n\n");
+  }
+
+  return parts.join("");
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const workspaceRoot = args[0] ? path.resolve(args[0]) : process.cwd();
+  const flowName = args[1];
+  const uuid = args[2];
+
+  if (!flowName || !uuid) {
+    process.stderr.write("Usage: agentflow apply -ai extract-thinking <workspaceRoot> <flowName> <uuid>\n");
+    process.exit(1);
+  }
+
+  const runDir = getRunDir(workspaceRoot, flowName, uuid);
+  const logPath = path.join(runDir, LOG_REL);
+  const outPath = path.join(runDir, OUT_REL);
+
+  if (!existsSync(logPath)) {
+    process.stderr.write(`Log file not found: ${logPath}\n`);
+    process.exit(1);
+  }
+
+  const logContent = readFileSync(logPath, "utf8");
+  const { thinkingBySession, nodeRuns, stats } = extractThinking(logContent);
+  const md = toMarkdown(thinkingBySession, nodeRuns, stats);
+
+  const outDir = path.dirname(outPath);
+  if (!existsSync(outDir)) mkdirSync(outDir, { recursive: true });
+  writeFileSync(outPath, md, "utf8");
+
+  process.stdout.write(`Written: ${outPath}\n`);
+  process.stdout.write(`Nodes: ${nodeRuns.length} Sessions: ${Object.keys(thinkingBySession).length}\n`);
+}
+
+main();

package/bin/pipeline/gc.mjs

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/**
+ * 清理 <workspaceRoot>/.workspace/agentflow/runBuild/ 下各 flowName 的 uuid 临时 run 目录。
+ * 用法：
+ *   agentflow apply -ai gc <workspaceRoot> [--list]                   仅列出 flowName/uuid 目录
+ *   agentflow apply -ai gc <workspaceRoot> --dry-run [--keep N] [--older-than N]  预览将删除的
+ *   agentflow apply -ai gc <workspaceRoot> --delete [--keep N] [--older-than N]   执行删除
+ * 输出（stdout 一行 JSON）：{ "err_code": 0|1, "message": { "result": "<文本>" } }
+ */
+
+import fs from "fs";
+import path from "path";
+
+import { listAllRunDirs } from "../lib/workspace.mjs";
+
+const UUID_DIR_PATTERN = /^\d{14}$/;
+
+function parseArgs(args) {
+  const workspaceRoot = args[0] ? path.resolve(args[0]) : "";
+  const rest = args.slice(1);
+  const opts = { list: false, delete: false, dryRun: false, keep: null, olderThan: null };
+  for (let i = 0; i < rest.length; i++) {
+    if (rest[i] === "--list") opts.list = true;
+    else if (rest[i] === "--delete") opts.delete = true;
+    else if (rest[i] === "--dry-run") opts.dryRun = true;
+    else if (rest[i] === "--keep" && rest[i + 1] != null) {
+      opts.keep = Math.max(0, parseInt(rest[++i], 10));
+      if (Number.isNaN(opts.keep)) opts.keep = null;
+    } else if (rest[i] === "--older-than" && rest[i + 1] != null) {
+      opts.olderThan = Math.max(0, parseInt(rest[++i], 10));
+      if (Number.isNaN(opts.olderThan)) opts.olderThan = null;
+    }
+  }
+  return { workspaceRoot, opts };
+}
+
+/** 收集所有 run 目录（新 per-flow + legacy 两种位置），按 mtime 倒序 */
+function getAllRunDirs(workspaceRoot) {
+  const dirs = [];
+  for (const { flowName, uuid, runDir } of listAllRunDirs(workspaceRoot)) {
+    if (!UUID_DIR_PATTERN.test(uuid)) continue;
+    try {
+      const stat = fs.statSync(runDir);
+      dirs.push({ flowName, uuid, path: runDir, mtime: stat.mtimeMs });
+    } catch (_) {}
+  }
+  dirs.sort((a, b) => b.mtime - a.mtime);
+  return dirs;
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  if (argv.length < 1) {
+    const payload = {
+      err_code: 1,
+      message: {
+        result:
+          "Usage: agentflow apply -ai gc <workspaceRoot> [--list] | ... --dry-run [--keep N] [--older-than N] | ... --delete [--keep N] [--older-than N]",
+      },
+    };
+    console.log(JSON.stringify(payload));
+    process.exit(1);
+  }
+
+  const { workspaceRoot, opts } = parseArgs(argv);
+  const allDirs = getAllRunDirs(workspaceRoot);
+
+  // 默认仅列出
+  if (!opts.delete && !opts.dryRun) {
+    opts.list = true;
+  }
+
+  if (opts.list) {
+    const lines = [`共 ${allDirs.length} 个 run 目录：`, ""];
+    for (const d of allDirs) {
+      const mtime = new Date(d.mtime).toISOString();
+      lines.push(`  ${d.flowName}/${d.uuid}  (mtime: ${mtime})`);
+    }
+    const payload = { err_code: 0, message: { result: lines.join("\n") } };
+    console.log(JSON.stringify(payload));
+    process.exit(0);
+  }
+
+  // 计算待删除列表
+  let toDelete = [...allDirs];
+  if (opts.keep != null && opts.keep > 0) {
+    toDelete = allDirs.slice(opts.keep);
+  }
+  if (opts.olderThan != null && opts.olderThan > 0) {
+    const cutoff = Date.now() - opts.olderThan * 24 * 60 * 60 * 1000;
+    toDelete = toDelete.filter((d) => d.mtime < cutoff);
+  }
+
+  if (opts.dryRun) {
+    const msg =
+      toDelete.length === 0
+        ? "无符合条件的目录需要删除。"
+        : `以下 ${toDelete.length} 个目录将被删除（dry-run）：\n${toDelete.map((d) => `  ${d.flowName}/${d.uuid}`).join("\n")}`;
+    const payload = { err_code: 0, message: { result: msg } };
+    console.log(JSON.stringify(payload));
+    process.exit(0);
+  }
+
+  // --delete：实际删除
+  const deleted = [];
+  const failed = [];
+  for (const d of toDelete) {
+    try {
+      fs.rmSync(d.path, { recursive: true });
+      deleted.push(`${d.flowName}/${d.uuid}`);
+    } catch (e) {
+      failed.push({ label: `${d.flowName}/${d.uuid}`, error: e.message || String(e) });
+    }
+  }
+
+  const parts = [`已删除 ${deleted.length} 个 run 目录：${deleted.join(", ") || "无"}`];
+  if (failed.length > 0) {
+    parts.push(`删除失败 ${failed.length} 个：`);
+    failed.forEach((f) => parts.push(`  ${f.label}: ${f.error}`));
+  }
+  const payload = {
+    err_code: failed.length > 0 ? 1 : 0,
+    message: { result: parts.join("\n") },
+  };
+  console.log(JSON.stringify(payload));
+  process.exit(failed.length > 0 ? 1 : 0);
+}
+
+main();

package/bin/pipeline/get-env.mjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * apply -ai get-env：按 key 从系统环境变量与 ~/.cursor/config.json 读取 value。
+ * 优先级：先查 process.env[key]，若无则查 ~/.cursor/config.json（支持点号路径如 openai.apiKey）。
+ *
+ * 用法（apply 步骤，由 CLI 调用）：
+ *   agentflow apply -ai get-env <workspaceRoot> <flowName> <uuid> <instanceId> <execId> <key>
+ * 将 value 写入当前 run 的 output 并写 result。
+ *
+ * 用法（仅 key，兼容/测试）：
+ *   agentflow apply -ai get-env <key>
+ * 或 node get-env.mjs <key>
+ * 仅向 stdout 输出 JSON，不写文件。
+ */
+
+import fs from "fs";
+import path from "path";
+import os from "os";
+
+import { getRunDir } from "../lib/paths.mjs";
+import { writeResult } from "./write-result.mjs";
+import { outputDirForNode, outputNodeBasename } from "./get-exec-id.mjs";
+
+function getFromConfig(config, keyStr) {
+  if (!config || typeof config !== "object" || !keyStr) return undefined;
+  const parts = String(keyStr).trim().split(".");
+  let cur = config;
+  for (const p of parts) {
+    if (cur == null || typeof cur !== "object") return undefined;
+    cur = cur[p];
+  }
+  return cur != null ? String(cur) : undefined;
+}
+
+function resolveValue(keyStr) {
+  let value = "";
+  if (!keyStr) return value;
+  value = process.env[keyStr] ?? "";
+  if (value === "") {
+    const configPath = path.join(os.homedir(), ".cursor", "config.json");
+    if (fs.existsSync(configPath)) {
+      try {
+        const raw = fs.readFileSync(configPath, "utf-8");
+        const config = JSON.parse(raw);
+        const fromConfig = getFromConfig(config, keyStr);
+        if (fromConfig !== undefined) value = fromConfig;
+      } catch (_) {}
+    }
+  }
+  return value;
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  const keyStr = (argv[argv.length - 1] != null ? String(argv[argv.length - 1]).trim() : "") || "";
+  const value = resolveValue(keyStr);
+
+  if (argv.length >= 6) {
+    const [workspaceRoot, flowName, uuid, instanceId, execIdStr] = argv;
+    const execId = parseInt(String(execIdStr), 10) || 1;
+    const runDir = getRunDir(workspaceRoot, flowName, uuid);
+    const outputDir = path.join(runDir, outputDirForNode(instanceId));
+    fs.mkdirSync(outputDir, { recursive: true });
+    // 备份由 snapshotPriorRoundIfNeeded 在 pre-process 入口统一处理。
+    const valueFile = path.join(outputDir, outputNodeBasename(instanceId, execId, "value"));
+    const resultFile = path.join(outputDir, outputNodeBasename(instanceId, execId, "result"));
+    fs.writeFileSync(valueFile, value, "utf-8");
+    fs.writeFileSync(resultFile, value, "utf-8");
+    writeResult(workspaceRoot, flowName, uuid, instanceId, {
+      status: "success",
+      message: "执行完成",
+    }, { preserveBody: true, execId });
+  } else {
+    console.log(
+      JSON.stringify({
+        err_code: 0,
+        message: { result: value, value },
+      }),
+    );
+  }
+}
+
+main();

package/bin/pipeline/get-exec-id.mjs

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+/**
+ * 从 run 目录 memory 读取各节点的 execId（供其它逻辑使用）。result/中间文件使用固定文件名，不再带 _execId。
+ * 用法（CLI）：node get-exec-id.mjs <workspaceRoot> <uuid> [instanceId]
+ *   - 仅 instanceId：输出该节点 execId（默认 1）
+ *   - 无 instanceId：需从 flow.json 读 order，输出 JSON { "execIds": { "<id>": number } }
+ * 用法（模块）：
+ *   loadExecId(workspaceRoot, flowName, uuid, instanceId) -> number
+ *   loadAllExecIds(workspaceRoot, flowName, uuid, order) -> { instanceId: number }
+ *   latestResultExecId(execId) -> number
+ *   intermediateResultBasename(instanceId, execId?) -> "<instanceId>.result.md"（固定，execId 忽略）
+ *   intermediatePromptBasename(instanceId, execId?) -> "<instanceId>.prompt.md"（固定）
+ *   intermediateCacheBasename(instanceId, execId?) -> "<instanceId>.cache.json"（固定）
+ *   outputNodeBasename(instanceId, execId?, slot) -> "node_<instanceId>_<slot>.md"（固定，无 execId）
+ *   intermediateDirForNode(instanceId) -> "intermediate/<instanceId>"（相对 run 目录）
+ *   outputDirForNode(instanceId) -> "output/<instanceId>"
+ */
+
+import fs from "fs";
+import path from "path";
+
+import { getRunDir } from "../lib/paths.mjs";
+
+const MEMORY_FILENAME = "memory.md";
+const EXEC_ID_KEY_PREFIX = "execId_";
+
+function parseMemory(content) {
+  const map = new Map();
+  for (const line of (content || "").split(/\r?\n/)) {
+    const idx = line.indexOf(": ");
+    if (idx <= 0) continue;
+    const k = line.slice(0, idx).trim();
+    const v = line.slice(idx + 2).trim();
+    if (k) map.set(k, v);
+  }
+  return map;
+}
+
+/**
+ * 从 memory 读取单个节点的 execId，默认 1。
+ */
+export function loadExecId(workspaceRoot, flowName, uuid, instanceId) {
+  const runDir = getRunDir(workspaceRoot, flowName, uuid);
+  const memoryPath = path.join(runDir, MEMORY_FILENAME);
+  if (!fs.existsSync(memoryPath)) return 1;
+  const map = parseMemory(fs.readFileSync(memoryPath, "utf-8"));
+  const v = map.get(EXEC_ID_KEY_PREFIX + instanceId);
+  if (v === undefined || v === "") return 1;
+  const n = parseInt(String(v), 10);
+  return Number.isFinite(n) && n >= 1 ? n : 1;
+}
+
+/**
+ * 从 memory 读取所有 order 中节点的 execId。
+ */
+export function loadAllExecIds(workspaceRoot, flowName, uuid, order) {
+  const runDir = getRunDir(workspaceRoot, flowName, uuid);
+  const memoryPath = path.join(runDir, MEMORY_FILENAME);
+  const map = fs.existsSync(memoryPath)
+    ? parseMemory(fs.readFileSync(memoryPath, "utf-8"))
+    : new Map();
+  const out = {};
+  for (const instanceId of order) {
+    const v = map.get(EXEC_ID_KEY_PREFIX + instanceId);
+    const n = v !== undefined && v !== "" ? parseInt(String(v), 10) : 1;
+    out[instanceId] = Number.isFinite(n) && n >= 1 ? n : 1;
+  }
+  return out;
+}
+
+/**
+ * 用于读取「当前最新」result 文件对应的 execId。
+ * 约定：memory 存的是「上一轮已完成的 execId」，节点以 execId E 执行时写入 <id>_E.result.md。
+ * 故最新 result 即为 _<memory 中的 execId>.result.md，直接返回该值；缺省或非法时为 1。
+ */
+export function latestResultExecId(execId) {
+  const e = execId != null ? Number(execId) : 1;
+  return Number.isFinite(e) && e >= 1 ? e : 1;
+}
+
+/** 固定文件名，不含 _execId，第二参数保留兼容调用方但不参与结果 */
+export function intermediateResultBasename(instanceId, execId) {
+  return `${instanceId}.result.md`;
+}
+
+/** 固定文件名，不含 _execId */
+export function intermediatePromptBasename(instanceId, execId) {
+  return `${instanceId}.prompt.md`;
+}
+
+/** 固定文件名，不含 _execId */
+export function intermediateCacheBasename(instanceId, execId) {
+  return `${instanceId}.cache.json`;
+}
+
+/** 固定文件名：node_<instanceId>_<base>.md，不含 execId */
+export function outputNodeBasename(instanceId, execId, slot) {
+  const base = (slot || "result").replace(/\.(md|txt|json|html?)$/i, "") || "result";
+  return `node_${instanceId}_${base}.md`;
+}
+
+/** 节点在 intermediate 下的一级目录（相对 run 目录），flow.json 仍在 intermediate/ 根下 */
+export function intermediateDirForNode(instanceId) {
+  return `intermediate/${instanceId}`;
+}
+
+/** 节点在 output 下的一级目录（相对 run 目录） */
+export function outputDirForNode(instanceId) {
+  return `output/${instanceId}`;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  if (args.length < 3) {
+    console.error("Usage: node get-exec-id.mjs <workspaceRoot> <flowName> <uuid> [instanceId]");
+    process.exit(1);
+  }
+  const [root, flowName, uuid, instanceId] = args;
+  const workspaceRoot = path.resolve(root);
+
+  if (instanceId) {
+    const execId = loadExecId(workspaceRoot, flowName, uuid, instanceId);
+    console.log(JSON.stringify({ execId }));
+    return;
+  }
+
+  const flowJsonPath = path.join(getRunDir(workspaceRoot, flowName, uuid), "intermediate", "flow.json");
+  if (!fs.existsSync(flowJsonPath)) {
+    console.log(JSON.stringify({ execIds: {} }));
+    return;
+  }
+  let order = [];
+  try {
+    const flow = JSON.parse(fs.readFileSync(flowJsonPath, "utf-8"));
+    if (flow.ok && Array.isArray(flow.order)) order = flow.order;
+  } catch (_) {}
+  const execIds = loadAllExecIds(workspaceRoot, flowName, uuid, order);
+  console.log(JSON.stringify({ execIds }));
+}
+
+const isMain =
+  typeof process !== "undefined" &&
+  process.argv[1] &&
+  (process.argv[1].endsWith("get-exec-id.mjs") || process.argv[1].endsWith("get-exec-id.js"));
+if (isMain) main();