@dazitech/cli 3.0.1 → 3.0.3

package/dist/clis/dazi-flow.js

@@ -6,9 +6,16 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
 var __commonJS = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -25,6 +32,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // node_modules/.pnpm/commander@12.1.0/node_modules/commander/lib/error.js
 var require_error = __commonJS({
@@ -959,8 +967,8 @@ var require_command = __commonJS({
   "node_modules/.pnpm/commander@12.1.0/node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter = require("node:events").EventEmitter;
     var childProcess = require("node:child_process");
-    var path21 = require("node:path");
-    var fs17 = require("node:fs");
+    var path19 = require("node:path");
+    var fs16 = require("node:fs");
     var process2 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1892,11 +1900,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path21.resolve(baseDir, baseName);
-          if (fs17.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path21.extname(baseName))) return void 0;
+          const localBin = path19.resolve(baseDir, baseName);
+          if (fs16.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path19.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs17.existsSync(`${localBin}${ext}`)
+            (ext) => fs16.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -1908,21 +1916,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs17.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs16.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path21.resolve(
-            path21.dirname(resolvedScriptPath),
+          executableDir = path19.resolve(
+            path19.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path21.basename(
+            const legacyName = path19.basename(
               this._scriptPath,
-              path21.extname(this._scriptPath)
+              path19.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -1933,7 +1941,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path21.extname(executableFile));
+        launchWithNode = sourceExt.includes(path19.extname(executableFile));
         let proc;
         if (process2.platform !== "win32") {
           if (launchWithNode) {
@@ -2773,7 +2781,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path21.basename(filename, path21.extname(filename));
+        this._name = path19.basename(filename, path19.extname(filename));
         return this;
       }
       /**
@@ -2787,9 +2795,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path22) {
-        if (path22 === void 0) return this._executableDir;
-        this._executableDir = path22;
+      executableDir(path20) {
+        if (path20 === void 0) return this._executableDir;
+        this._executableDir = path20;
         return this;
       }
       /**
@@ -3019,1482 +3027,2371 @@ var require_commander = __commonJS({
   }
 });
 
-// node_modules/.pnpm/commander@12.1.0/node_modules/commander/esm.mjs
-var import_index = __toESM(require_commander(), 1);
-var {
-  program,
-  createCommand,
-  createArgument,
-  createOption,
-  CommanderError,
-  InvalidArgumentError,
-  InvalidOptionArgumentError,
-  // deprecated old name
-  Command,
-  Argument,
-  Option,
-  Help
-} = import_index.default;
-
-// cli/dazi-flow/src/commands/flows.ts
-var import_path3 = __toESM(require("path"), 1);
-var import_fs2 = __toESM(require("fs"), 1);
+// src/shared/flowNodeCatalog.ts
+var flowNodeCatalog_exports = {};
+__export(flowNodeCatalog_exports, {
+  FLOW_NODE_CATALOG: () => FLOW_NODE_CATALOG,
+  FLOW_NODE_CATALOG_DESIGNER: () => FLOW_NODE_CATALOG_DESIGNER,
+  allFlowNodeTypes: () => allFlowNodeTypes,
+  buildFlowNodeCatalogQuickStartSection: () => buildFlowNodeCatalogQuickStartSection,
+  flowNodeByType: () => flowNodeByType
+});
+function allFlowNodeTypes() {
+  return FLOW_NODE_CATALOG.flatMap((g) => g.items);
+}
+function flowNodeByType(type) {
+  return allFlowNodeTypes().find((n) => n.type === type);
+}
+function buildFlowNodeCatalogQuickStartSection(detailLink) {
+  const lines = [
+    "## \u53EF\u7528\u6D41\u7A0B\u8282\u70B9\uFF08`data.type`\uFF09",
+    "",
+    "> \u753B\u5E03\u8282\u70B9 **`type` \u6052\u4E3A `custom`**\uFF0C\u4E1A\u52A1\u7C7B\u578B\u5728 **`data.type`**\u3002\u65B0\u5EFA\uFF1A`flow node new --type <\u4E0B\u8868 type>`\u3002",
+    "> **\u7981\u6B62**\u7F16\u9020\u672A\u5728\u4E0B\u8868\u4E2D\u7684 type\u3002",
+    ""
+  ];
+  for (const { group, items } of FLOW_NODE_CATALOG) {
+    lines.push(`### ${group}`, "");
+    lines.push("| type | \u540D\u79F0 | \u4EE3\u7801 | \u7528\u9014 | \u53D8\u91CF |");
+    lines.push("|------|------|:----:|------|------|");
+    for (const n of items) {
+      const code = n.hasCode ? n.codeFile ?? "code.*" : "\u2014";
+      const vars = [n.consumes ? `\u5165:${shortVar(n.consumes)}` : "", n.produces ? `\u51FA:${shortVar(n.produces)}` : ""].filter(Boolean).join(" \xB7 ") || "\u2014";
+      lines.push(`| \`${n.type}\` | ${n.label} | ${code} | ${n.summary} | ${vars} |`);
+    }
+    lines.push("");
+  }
+  lines.push(
+    "**\u9009\u578B\u63D0\u793A**",
+    "",
+    "- **Excel\uFF08\u6709 `managed_file_id` / `file_id`\uFF09\u2192 \u4F18\u5148 `excel-python`**\uFF0C\u52FF\u7528 `file-source`\uFF08\u4E0D\u89E3\u6790 Excel\uFF09",
+    "- \u4EC5\u6781\u7B80\u5355\u5355 Sheet\u3001\u96F6\u4EE3\u7801\u65F6\u624D\u7528 `excel-import`\uFF1B\u591A Sheet / \u590D\u6742\u8868\u5934 / \u4E0D\u786E\u5B9A\u7ED3\u6784 \u2192 `excel-python`",
+    "- **`excel-python`**\uFF1A\u753B\u5E03\u914D **`managed_file_id`\uFF08UUID\uFF09**\uFF1B`code.py` \u7528 **`excel_source_path`**\uFF0C\u7981\u6B62\u5199\u6587\u4EF6\u540D/\u672C\u5730\u8DEF\u5F84",
+    "- \u975E Excel \u539F\u59CB\u6587\u4EF6 \u2192 `file-source`\uFF1B\u8BFB\u5916\u90E8\u5E93 \u2192 `database-source`\uFF1B\u8BFB\u6570\u636E\u7A7A\u95F4 \u2192 `dataspace-source`",
+    "- \u5185\u5B58\u52A0\u5DE5 \u2192 `sql-query` / `python-script`\uFF1B\u5206\u652F \u2192 `condition`\uFF08\u51FA\u8FB9 `true`/`false`\uFF09",
+    "- \u5199\u5916\u90E8\u5E93 \u2192 `database-sink`\uFF1B\u5199\u6570\u636E\u7A7A\u95F4 \u2192 `dataspace-sink`",
+    ""
+  );
+  if (detailLink) {
+    lines.push(`\u5404\u8282\u70B9\u914D\u7F6E\u4E0E\u793A\u4F8B \u2192 [flows-guide \xA7\u6D41\u7A0B\u8282\u70B9\u7EC4\u4EF6](${detailLink}#\u6D41\u7A0B\u8282\u70B9\u7EC4\u4EF6)\u3002`, "");
+  } else {
+    lines.push("\u5404\u8282\u70B9\u914D\u7F6E\u4E0E\u793A\u4F8B \u2192 \u5E2E\u52A9\u6587\u6863 **flow/flows-guide** \xA7\u6D41\u7A0B\u8282\u70B9\u7EC4\u4EF6\u3002", "");
+  }
+  return lines;
+}
+function shortVar(s) {
+  return s.replace(/`/g, "").slice(0, 40);
+}
+var FLOW_NODE_CATALOG, FLOW_NODE_CATALOG_DESIGNER;
+var init_flowNodeCatalog = __esm({
+  "src/shared/flowNodeCatalog.ts"() {
+    "use strict";
+    FLOW_NODE_CATALOG = [
+      {
+        group: "\u6D41\u7A0B\u63A7\u5236",
+        items: [
+          {
+            type: "condition",
+            label: "\u6761\u4EF6\u5224\u65AD",
+            hasCode: true,
+            codeFile: "code.py",
+            summary: "\u5BF9\u4E0A\u6E38\u8868\u6C42\u5E03\u5C14\u8868\u8FBE\u5F0F\uFF0C\u8D70 True/False \u5206\u652F",
+            consumes: "\u5165\u8FB9\u4E0A\u6E38\u8868 \u2192 \u8FD0\u884C\u65F6\u6CE8\u5165 `df`",
+            produces: "\u65E0\u65B0\u8868\u53D8\u91CF\uFF08\u4EC5\u8DEF\u7531\uFF09",
+            keyConfig: ["label", "pythonCode\uFF08\u4EE3\u7801\u5728 code.py\uFF09"]
+          },
+          {
+            type: "delay",
+            label: "\u5EF6\u65F6\u7B49\u5F85",
+            hasCode: false,
+            summary: "\u6682\u505C\u6307\u5B9A\u79D2\u6570\u540E\u7EE7\u7EED\u4E0B\u6E38",
+            keyConfig: ["delaySeconds \u6216 delay\uFF08\u79D2\uFF09"]
+          }
+        ]
+      },
+      {
+        group: "\u6570\u636E\u5904\u7406",
+        items: [
+          {
+            type: "file-source",
+            label: "\u6587\u4EF6\u8F93\u5165",
+            hasCode: false,
+            summary: "\u975E Excel \u539F\u59CB\u6587\u4EF6\u900F\u4F20\uFF08.xlsx/.xls \u52FF\u7528\uFF0C\u6539 excel-python\uFF09",
+            produces: "`output_variable_name`",
+            keyConfig: ["file_id / managed_file_id", "output_variable_name"]
+          },
+          {
+            type: "excel-import",
+            label: "Excel \u5BFC\u5165",
+            hasCode: false,
+            summary: "\u4EC5\u6781\u7B80\u5355\u5355 Sheet \u96F6\u4EE3\u7801\uFF1B\u6709 file_id \u7684 Excel \u9ED8\u8BA4\u4ECD\u7528 excel-python",
+            produces: "`output_variable_name`",
+            keyConfig: ["file_id / source_excel_id", "sheetName\uFF08\u53EF\u9009\uFF09", "output_variable_name"]
+          },
+          {
+            type: "excel-python",
+            label: "Excel \u5F00\u53D1",
+            hasCode: true,
+            codeFile: "code.py",
+            summary: "\u591A Sheet / \u590D\u6742\u8868\u5934\uFF1APython \u89E3\u6790 Excel\uFF08\u753B\u5E03\u914D managed_file_id\uFF0C\u4EE3\u7801\u7528 excel_source_path\uFF09",
+            produces: "`set_table_output(\u4E0E output_variable_name \u540C\u540D, df)`",
+            keyConfig: ["managed_file_id\uFF08UUID\uFF0C\u975E\u6587\u4EF6\u540D\uFF09", "output_variable_name"]
+          },
+          {
+            type: "sql-query",
+            label: "SQL \u67E5\u8BE2",
+            hasCode: true,
+            codeFile: "code.sql",
+            summary: "DuckDB \u5185\u5B58 SQL\uFF0C\u4E0A\u6E38\u53D8\u91CF\u540D\u4F5C\u8868\u540D",
+            consumes: "\u4E0A\u6E38 `output_variable_name` \u4F5C SQL \u8868\u540D",
+            produces: "`output_variable_name`",
+            keyConfig: ["output_variable_name"]
+          },
+          {
+            type: "python-script",
+            label: "Python \u811A\u672C",
+            hasCode: true,
+            codeFile: "code.py",
+            summary: "pandas \u8F6C\u6362\uFF1B\u6700\u5E38\u7528\u52A0\u5DE5\u8282\u70B9",
+            consumes: '`get_variable("\u4E0A\u6E38\u53D8\u91CF\u540D")` \u6216\u5165\u8FB9 `df`',
+            produces: "`result_df` \u2192 `output_variable_name`",
+            keyConfig: ["output_variable_name"]
+          },
+          {
+            type: "database-source",
+            label: "\u6570\u636E\u5E93\u8BFB\u53D6",
+            hasCode: true,
+            codeFile: "code.sql",
+            summary: "\u4ECE\u5916\u90E8\u6570\u636E\u5E93\uFF08connectionId\uFF09\u53EA\u8BFB\u67E5\u8BE2",
+            produces: "`output_variable_name`",
+            keyConfig: ["connectionId", "output_variable_name"]
+          },
+          {
+            type: "database-sink",
+            label: "\u6570\u636E\u5E93\u5199\u5165",
+            hasCode: false,
+            summary: "\u5C06\u8868\u53D8\u91CF\u5199\u5165\u5916\u90E8\u6570\u636E\u5E93\u8868",
+            consumes: "`input_variable_name` \u6216\u5165\u8FB9 Parquet",
+            keyConfig: ["connectionId", "tableName", "mode", "input_variable_name"]
+          },
+          {
+            type: "dataspace-source",
+            label: "\u6570\u636E\u7A7A\u95F4\u8BFB\u53D6",
+            hasCode: true,
+            codeFile: "code.sql",
+            summary: "\u4ECE\u642D\u5B50\u6570\u636E\u7A7A\u95F4\uFF08spaceId\uFF09\u53EA\u8BFB SQL",
+            produces: "`output_variable_name`",
+            keyConfig: ["spaceId", "output_variable_name", "limit\uFF08\u53EF\u9009\uFF09"]
+          },
+          {
+            type: "dataspace-sink",
+            label: "\u6570\u636E\u7A7A\u95F4\u5199\u5165",
+            hasCode: false,
+            summary: "\u5C06\u8868\u53D8\u91CF\u5199\u5165\u6570\u636E\u7A7A\u95F4\u8868",
+            consumes: "`input_variable_name` \u6216\u5165\u8FB9 Parquet",
+            keyConfig: ["spaceId", "tableName", "input_variable_name", "syncMetadata\uFF08\u53EF\u9009\uFF09"]
+          },
+          {
+            type: "data-quality-check",
+            label: "\u6570\u636E\u8D28\u91CF\u68C0\u67E5",
+            hasCode: true,
+            codeFile: "code.py",
+            summary: "\u8D28\u68C0\u89C4\u5219\u6216\u81EA\u5B9A\u4E49 Python\uFF08dqPythonCode\uFF09",
+            consumes: "\u4E0A\u6E38\u8868 / `get_variable`",
+            produces: "\u8D28\u68C0\u62A5\u544A\u53D8\u91CF\uFF08\u4F9D\u914D\u7F6E\uFF09",
+            keyConfig: ["output_variable_name", "qualityConfig", "dqPythonCode\uFF08\u4F18\u5148\u4E8E\u89C4\u5219\uFF09"]
+          },
+          {
+            type: "folder-resource-import",
+            label: "\u6587\u4EF6\u5939\u8D44\u6E90\u5BFC\u5165",
+            hasCode: false,
+            summary: "\u4ECE\u6587\u4EF6\u5939\u8D44\u6E90\u6279\u91CF\u5BFC\u5165\u6587\u4EF6",
+            produces: "`output_variable_name`",
+            keyConfig: ["folderId", "resourceId", "pageSize", "output_variable_name"]
+          },
+          {
+            type: "folder-resource-register",
+            label: "\u8D44\u6E90\u6CE8\u518C",
+            hasCode: false,
+            summary: "\u5C06\u5BFC\u5165\u7ED3\u679C\u6CE8\u518C\u5230\u8FDE\u63A5/\u8D44\u6E90\u76EE\u5F55",
+            keyConfig: ["connectionName", "targetFolderId"]
+          }
+        ]
+      }
+    ];
+    FLOW_NODE_CATALOG_DESIGNER = FLOW_NODE_CATALOG.map((g) => ({
+      group: g.group,
+      items: g.items.map(({ type, label, hasCode }) => ({
+        type,
+        label,
+        ...hasCode ? { code: true } : {}
+      }))
+    }));
+  }
+});
 
-// cli/shared/src/auth.js
-var import_os = __toESM(require("os"), 1);
-var import_path = __toESM(require("path"), 1);
-var import_fs = __toESM(require("fs"), 1);
+// src/shared/flowCliText.ts
+var flowCliText_exports = {};
+__export(flowCliText_exports, {
+  DAZI_CLI: () => DAZI_CLI,
+  DAZI_PS1: () => DAZI_PS1,
+  mdDaziCmd: () => mdDaziCmd,
+  mdFlowCmd: () => mdFlowCmd,
+  normalizeCliExampleLine: () => normalizeCliExampleLine,
+  psDaziLine: () => psDaziLine,
+  psFlowBlock: () => psFlowBlock,
+  psFlowLine: () => psFlowLine
+});
+function psFlowLine(subcommand) {
+  return `${DAZI_CLI} flow ${subcommand}`;
+}
+function psDaziLine(args) {
+  return `${DAZI_CLI} ${args}`;
+}
+function mdFlowCmd(subcommand) {
+  return `\`${DAZI_CLI} flow ${subcommand}\``;
+}
+function mdDaziCmd(args) {
+  return `\`${DAZI_CLI} ${args}\``;
+}
+function normalizeCliExampleLine(line) {
+  return line.replace(/\.\\+scripts\\+dazi\.ps1\s+/g, `${DAZI_CLI} `).replace(/\.\/scripts\/dazi\.ps1\s+/g, `${DAZI_CLI} `);
+}
+function psFlowBlock(lines) {
+  return ["```powershell", ...lines.map(normalizeCliExampleLine), "```"].join("\n");
+}
+var DAZI_CLI, DAZI_PS1;
+var init_flowCliText = __esm({
+  "src/shared/flowCliText.ts"() {
+    "use strict";
+    DAZI_CLI = "dazi";
+    DAZI_PS1 = DAZI_CLI;
+  }
+});
 
-// cli/shared/src/errors.js
-var DaziError = class extends Error {
-  constructor(message, code = "ERR_DAZI", exitCode = 1) {
-    super(message);
-    this.code = code;
-    this.exitCode = exitCode;
-    this.name = "DaziError";
+// src/shared/flowWorkspaceAudit.ts
+var flowWorkspaceAudit_exports = {};
+__export(flowWorkspaceAudit_exports, {
+  auditFlowWorkspace: () => auditFlowWorkspace,
+  buildFlowConsistencyMarkdown: () => buildFlowConsistencyMarkdown,
+  repairFlowMeta: () => repairFlowMeta
+});
+function sha12(text) {
+  return import_crypto2.default.createHash("sha1").update(text, "utf8").digest("hex");
+}
+function resolveNodeType2(node) {
+  if (node.type === "custom") {
+    return String(node.data?.type ?? "custom");
   }
-};
-var AuthError = class extends DaziError {
-  constructor(message = "\u672A\u767B\u5F55\uFF0C\u8BF7\u5148\u8FD0\u884C: dazi auth login") {
-    super(message, "ERR_AUTH", 2);
-    this.name = "AuthError";
+  return String(node.type ?? "custom");
+}
+function codeLanguageForNodeType2(nodeType) {
+  if (["python-script", "excel-python", "condition", "data-quality-check"].includes(nodeType)) {
+    return "python";
   }
-};
-var NetworkError = class extends DaziError {
-  constructor(message, status) {
-    super(message, "ERR_NETWORK", 3);
-    this.status = status;
-    this.name = "NetworkError";
+  if (["database-source", "dataspace-source", "sql-query"].includes(nodeType)) {
+    return "sql";
   }
-};
-
-// cli/shared/src/auth.js
-function authFilePath() {
-  return import_path.default.join(import_os.default.homedir(), ".dazi", "auth.json");
+  return void 0;
 }
-function loadAuth() {
-  const p = authFilePath();
-  if (!import_fs.default.existsSync(p))
-    throw new AuthError();
+function codeFileExt2(language) {
+  if (language === "python") return "py";
+  if (language === "sql") return "sql";
+  return "txt";
+}
+function sanitizeName2(name) {
+  const cleaned = (name || "").replace(/[<>:"/\\|?*\x00-\x1f]/g, "_").trim().replace(/\s+/g, "_");
+  return cleaned || "node";
+}
+function readFlowJson2(flowDir) {
+  const raw = JSON.parse(import_fs6.default.readFileSync(import_path7.default.join(flowDir, FLOW_JSON2), "utf8"));
+  return {
+    nodes: Array.isArray(raw.nodes) ? raw.nodes : [],
+    edges: Array.isArray(raw.edges) ? raw.edges : []
+  };
+}
+function readMeta2(flowDir) {
+  const p = import_path7.default.join(flowDir, FLOW_META_JSON2);
+  if (!import_fs6.default.existsSync(p)) return void 0;
   try {
-    return JSON.parse(import_fs.default.readFileSync(p, "utf-8"));
+    return JSON.parse(import_fs6.default.readFileSync(p, "utf8"));
   } catch {
-    throw new AuthError("auth.json \u683C\u5F0F\u635F\u574F\uFF0C\u8BF7\u91CD\u65B0\u767B\u5F55");
+    return void 0;
   }
 }
-
-// cli/shared/src/httpClient.js
-async function apiRequest(path21, opts = {}) {
-  const auth = opts.token || opts.serverUrl ? { token: opts.token ?? "", serverUrl: opts.serverUrl ?? "" } : loadAuth();
-  const url = `${auth.serverUrl.replace(/\/$/, "")}${path21}`;
-  const headers = {
-    "Content-Type": "application/json",
-    Authorization: `Bearer ${auth.token}`,
-    ...opts.headers
-  };
-  const res = await fetch(url, {
-    method: opts.method ?? "GET",
-    headers,
-    body: opts.body != null ? JSON.stringify(opts.body) : void 0
-  });
-  if (!res.ok) {
-    let msg = `HTTP ${res.status} ${res.statusText}`;
+function isCodeNodeType(nodeType) {
+  return Boolean(NODE_TYPE_CODE_DATA_KEY2[nodeType]);
+}
+function listNodeDirs(flowDir) {
+  const nodesRoot = import_path7.default.join(flowDir, NODES_DIR2);
+  if (!import_fs6.default.existsSync(nodesRoot)) return [];
+  return import_fs6.default.readdirSync(nodesRoot).filter((n) => {
     try {
-      const j = await res.json();
-      if (j.message)
-        msg = j.message;
+      return import_fs6.default.statSync(import_path7.default.join(nodesRoot, n)).isDirectory();
     } catch {
+      return false;
     }
-    throw new NetworkError(msg, res.status);
-  }
-  return res.json();
-}
-
-// cli/shared/src/output.js
-function printJsonSummary(summary) {
-  console.log(`__JSON_SUMMARY__${JSON.stringify(summary)}`);
-}
-function ok(data) {
-  printJsonSummary({ ok: true, data });
+  });
 }
-function fail(code, message) {
-  printJsonSummary({ ok: false, error: { code, message } });
+function findCodeFileInDir(dirAbs) {
+  if (!import_fs6.default.existsSync(dirAbs)) return void 0;
+  for (const f of import_fs6.default.readdirSync(dirAbs)) {
+    if (/^code\.(py|sql|txt)$/i.test(f)) return f;
+  }
+  return void 0;
 }
-function handleError(err) {
-  if (err instanceof Error) {
-    const code = err.code ?? "ERR_UNKNOWN";
-    console.error(`\u9519\u8BEF: ${err.message}`);
-    fail(code, err.message);
-  } else {
-    console.error(`\u672A\u77E5\u9519\u8BEF`, err);
-    fail("ERR_UNKNOWN", String(err));
+function findDirForUuid(flowDir, uuid) {
+  const nodesRoot = import_path7.default.join(flowDir, NODES_DIR2);
+  for (const dirName of listNodeDirs(flowDir)) {
+    const infoPath = import_path7.default.join(nodesRoot, dirName, NODE_INFO_JSON2);
+    if (import_fs6.default.existsSync(infoPath)) {
+      try {
+        const info = JSON.parse(import_fs6.default.readFileSync(infoPath, "utf8"));
+        if (String(info.node_uuid ?? "") === uuid) return import_path7.default.posix.join(NODES_DIR2, dirName);
+      } catch {
+      }
+    }
   }
-  process.exit(1);
+  return void 0;
 }
-
-// cli/shared/src/workspaceLayout.js
-var import_path2 = __toESM(require("path"), 1);
-var WORKSPACE_RESOURCE_DIR = "\u8D44\u6E90";
-function resolveWorkspace(cwd = process.cwd()) {
-  const resources = import_path2.default.join(cwd, WORKSPACE_RESOURCE_DIR);
-  return {
-    root: cwd,
-    resources,
-    dazi: import_path2.default.join(cwd, ".dazi"),
-    onto: import_path2.default.join(cwd, "onto"),
-    flows: import_path2.default.join(cwd, "flows"),
-    apps: import_path2.default.join(cwd, "apps"),
-    data: import_path2.default.join(cwd, "data"),
-    docs: import_path2.default.join(resources, "docs"),
-    prompts: import_path2.default.join(resources, "prompts"),
-    examples: import_path2.default.join(resources, "examples"),
-    dataspaces: import_path2.default.join(resources, "dataspaces"),
-    datasources: import_path2.default.join(resources, "datasources"),
-    files: import_path2.default.join(resources, "files")
+function auditFlowWorkspace(flowDir) {
+  const warnings = [];
+  const doc = readFlowJson2(flowDir);
+  const meta = readMeta2(flowDir) ?? { nodes: {} };
+  const canvasNodeCount = doc.nodes.length;
+  let canvasCodeNodeCount = 0;
+  const missingInMeta = [];
+  const missingCodeFiles = [];
+  const flowUuids = /* @__PURE__ */ new Set();
+  for (const node of doc.nodes) {
+    const uuid = String(node.node_uuid ?? "").trim();
+    if (!uuid) continue;
+    flowUuids.add(uuid);
+    const nodeType = resolveNodeType2(node);
+    if (!isCodeNodeType(nodeType)) continue;
+    canvasCodeNodeCount++;
+    const label = String(node.data?.label ?? node.id ?? "");
+    const m = meta.nodes[uuid];
+    if (!m?.dir || !m.codeFile) {
+      missingInMeta.push({ uuid, nodeId: String(node.id ?? ""), nodeType, label });
+      continue;
+    }
+    const codePath = import_path7.default.join(flowDir, m.dir, m.codeFile);
+    if (!import_fs6.default.existsSync(codePath)) {
+      missingCodeFiles.push({ uuid, dir: m.dir, codeFile: m.codeFile });
+    }
+  }
+  const orphanInMeta = Object.keys(meta.nodes).filter((u) => !flowUuids.has(u));
+  let metaCodeIndexedCount = 0;
+  for (const m of Object.values(meta.nodes)) {
+    if (m.dir && m.codeFile) metaCodeIndexedCount++;
+  }
+  const unindexedDirs = [];
+  for (const dirName of listNodeDirs(flowDir)) {
+    const dirAbs = import_path7.default.join(flowDir, NODES_DIR2, dirName);
+    if (!findCodeFileInDir(dirAbs)) continue;
+    const rel = import_path7.default.posix.join(NODES_DIR2, dirName);
+    const indexed = Object.values(meta.nodes).some((m) => m.dir?.replace(/\\/g, "/") === rel);
+    if (!indexed) unindexedDirs.push(rel);
+  }
+  if (canvasCodeNodeCount !== metaCodeIndexedCount) {
+    warnings.push(
+      `\u753B\u5E03\u4EE3\u7801\u8282\u70B9 ${canvasCodeNodeCount} \u4E2A\uFF0Cmeta \u5DF2\u7D22\u5F15 ${metaCodeIndexedCount} \u4E2A\uFF08\u4E0D\u4E00\u81F4\u4F1A\u5BFC\u81F4 node push / \u8BBE\u8BA1\u5668\u6253\u5F00\u4EE3\u7801\u5931\u8D25\uFF09`
+    );
+  }
+  if (missingInMeta.length) {
+    warnings.push("\u90E8\u5206 flow.json \u4EE3\u7801\u8282\u70B9\u672A\u5199\u5165 flow.meta.json\uFF0C\u8BF7\u6267\u884C project repair-meta");
+  }
+  if (unindexedDirs.length) {
+    warnings.push(`\u5B58\u5728\u672A\u7D22\u5F15\u7684\u8282\u70B9\u76EE\u5F55\uFF1A${unindexedDirs.join(", ")}`);
+  }
+  const ok3 = missingInMeta.length === 0 && orphanInMeta.length === 0 && missingCodeFiles.length === 0 && unindexedDirs.length === 0 && canvasCodeNodeCount === metaCodeIndexedCount;
+  return {
+    ok: ok3,
+    canvasNodeCount,
+    canvasCodeNodeCount,
+    metaIndexedCount: Object.keys(meta.nodes).length,
+    metaCodeIndexedCount,
+    missingInMeta,
+    orphanInMeta,
+    missingCodeFiles,
+    unindexedDirs,
+    warnings
   };
 }
+function writeNodeInfo(flowDir, node, uuid, nodeType, relDir, codeFile, language, strippedData) {
+  const abs = import_path7.default.join(flowDir, relDir);
+  import_fs6.default.writeFileSync(
+    import_path7.default.join(abs, NODE_INFO_JSON2),
+    JSON.stringify(
+      {
+        _readonly: `\u6B64\u6587\u4EF6\u7531 dazi-flow \u751F\u6210\uFF0C\u4EC5\u4F9B\u67E5\u770B\uFF1B\u7F16\u8F91\u4EE3\u7801\u8BF7\u6539 ${codeFile}\uFF0C\u914D\u7F6E\u6539 flow.json`,
+        node_uuid: uuid,
+        nodeId: String(node.id ?? ""),
+        nodeType,
+        label: String(node.data?.label ?? ""),
+        codeFile,
+        codeLanguage: language,
+        position: node.position,
+        data: strippedData
+      },
+      null,
+      2
+    ),
+    "utf8"
+  );
+}
+function repairFlowMeta(flowDir) {
+  const warnings = [];
+  const repairedUuids = [];
+  const wroteNodeInfo = [];
+  const doc = readFlowJson2(flowDir);
+  const meta = readMeta2(flowDir) ?? { flowId: null, flowName: import_path7.default.basename(flowDir), nodes: {} };
+  if (!meta.nodes) meta.nodes = {};
+  const usedDirNames = new Set(
+    Object.values(meta.nodes).map((m) => m.dir?.split("/").pop()).filter(Boolean)
+  );
+  for (const node of doc.nodes) {
+    const uuid = String(node.node_uuid ?? "").trim();
+    if (!uuid) continue;
+    const nodeType = resolveNodeType2(node);
+    const codeKey = NODE_TYPE_CODE_DATA_KEY2[nodeType];
+    const semanticId = String(node.id ?? "");
+    const label = String(node.data?.label ?? semanticId ?? nodeType);
+    let entry = meta.nodes[uuid];
+    if (!entry) {
+      entry = { nodeId: semanticId, nodeType };
+      meta.nodes[uuid] = entry;
+      repairedUuids.push(uuid);
+    } else {
+      entry.nodeId = semanticId || entry.nodeId;
+      entry.nodeType = nodeType;
+    }
+    if (!codeKey) continue;
+    let relDir = entry.dir?.replace(/\\/g, "/");
+    if (relDir && findCodeFileInDir(import_path7.default.join(flowDir, relDir))) {
+    } else {
+      relDir = findDirForUuid(flowDir, uuid);
+    }
+    if (!relDir) {
+      const byLabel = import_path7.default.posix.join(NODES_DIR2, sanitizeName2(label));
+      if (import_fs6.default.existsSync(import_path7.default.join(flowDir, byLabel)) && findCodeFileInDir(import_path7.default.join(flowDir, byLabel))) {
+        relDir = byLabel;
+      }
+    }
+    if (!relDir) {
+      let dirName = sanitizeName2(label);
+      if (usedDirNames.has(dirName)) dirName = `${dirName}_${uuid.slice(0, 6)}`;
+      usedDirNames.add(dirName);
+      relDir = import_path7.default.posix.join(NODES_DIR2, dirName);
+      import_fs6.default.mkdirSync(import_path7.default.join(flowDir, relDir), { recursive: true });
+      const lang = codeLanguageForNodeType2(nodeType);
+      const codeFile2 = `code.${codeFileExt2(lang)}`;
+      const template = nodeType === "excel-python" ? "# -*- coding: utf-8 -*-\n# Excel \u8282\u70B9\uFF1A\u753B\u5E03\u914D\u7F6E managed_file_id\uFF1B\u4EE3\u7801\u4F7F\u7528 excel_source_path\n" : lang === "sql" ? "-- \u8282\u70B9 SQL\nSELECT 1;\n" : "# -*- coding: utf-8 -*-\n";
+      if (!findCodeFileInDir(import_path7.default.join(flowDir, relDir))) {
+        import_fs6.default.writeFileSync(import_path7.default.join(flowDir, relDir, codeFile2), template, "utf8");
+        warnings.push(`\u5DF2\u4E3A ${uuid} \u521B\u5EFA\u7A7A\u4EE3\u7801\u6A21\u677F ${relDir}/${codeFile2}`);
+      }
+    }
+    const dirAbs = import_path7.default.join(flowDir, relDir);
+    const codeFile = findCodeFileInDir(dirAbs);
+    if (!codeFile) {
+      warnings.push(`\u8282\u70B9 ${uuid} \u76EE\u5F55 ${relDir} \u65E0 code.*\uFF0C\u8DF3\u8FC7\u4EE3\u7801\u7D22\u5F15`);
+      continue;
+    }
+    const language = codeLanguageForNodeType2(nodeType);
+    const code = import_fs6.default.readFileSync(import_path7.default.join(dirAbs, codeFile), "utf8");
+    entry.dir = relDir;
+    entry.codeFile = codeFile;
+    entry.codeLanguage = language;
+    entry.codeHash = sha12(code);
+    const strippedData = { ...node.data ?? {} };
+    delete strippedData[codeKey];
+    const infoPath = import_path7.default.join(dirAbs, NODE_INFO_JSON2);
+    if (!import_fs6.default.existsSync(infoPath)) {
+      writeNodeInfo(flowDir, node, uuid, nodeType, relDir, codeFile, language, strippedData);
+      wroteNodeInfo.push(relDir);
+    }
+    if (!repairedUuids.includes(uuid)) repairedUuids.push(uuid);
+  }
+  meta.graphFingerprint = "sha1:" + sha12(JSON.stringify({ nodes: doc.nodes, edges: doc.edges }));
+  import_fs6.default.writeFileSync(import_path7.default.join(flowDir, FLOW_META_JSON2), JSON.stringify(meta, null, 2), "utf8");
+  const okAfter = auditFlowWorkspace(flowDir).ok;
+  return {
+    ok: okAfter,
+    repairedUuids: [...new Set(repairedUuids)],
+    wroteNodeInfo,
+    warnings
+  };
+}
+function buildFlowConsistencyMarkdown(audit, localFilesSpecLink = "../../\u8D44\u6E90/docs/flow/local-files-spec.md") {
+  const lines = [
+    "## \u672C\u5730\u6587\u4EF6\u4E00\u81F4\u6027",
+    "",
+    "| \u6307\u6807 | \u6570\u91CF |",
+    "|------|------|",
+    `| \u753B\u5E03\u8282\u70B9\uFF08flow.json\uFF09 | ${audit.canvasNodeCount} |`,
+    `| \u753B\u5E03\u4EE3\u7801\u8282\u70B9\uFF08flow.json\uFF09 | ${audit.canvasCodeNodeCount} |`,
+    `| meta \u5DF2\u767B\u8BB0\u8282\u70B9 | ${audit.metaIndexedCount} |`,
+    `| meta \u5DF2\u7D22\u5F15\u4EE3\u7801\uFF08dir+codeFile\uFF09 | ${audit.metaCodeIndexedCount} |`,
+    ""
+  ];
+  if (audit.ok) {
+    lines.push("\u2705 **flow.json / flow.meta.json / \u8282\u70B9/ \u4E00\u81F4**\u3002\u8BBE\u8BA1\u5668\u53EF\u6B63\u5E38\u300C\u6253\u5F00\u4EE3\u7801\u300D\uFF0C`node push` \u53EF\u8BC6\u522B\u810F\u8282\u70B9\u3002", "");
+  } else {
+    lines.push("\u26A0\uFE0F **\u76EE\u5F55\u4E0D\u4E00\u81F4**\uFF08\u4F1A\u5BFC\u81F4\u8BBE\u8BA1\u5668\u627E\u4E0D\u5230\u4EE3\u7801\u3001\u6216 `node push` \u8DF3\u8FC7\uFF09\uFF1A", "");
+    if (audit.missingInMeta.length) {
+      lines.push("| uuid | \u8282\u70B9 | \u7C7B\u578B |");
+      lines.push("|------|------|------|");
+      for (const m of audit.missingInMeta) {
+        lines.push(`| \`${m.uuid.slice(0, 8)}\u2026\` | ${m.label || m.nodeId} | ${m.nodeType} |`);
+      }
+      lines.push("");
+    }
+    if (audit.unindexedDirs.length) {
+      lines.push(`- \u672A\u7D22\u5F15\u76EE\u5F55\uFF1A${audit.unindexedDirs.map((d) => `\`${d}\``).join(" ")}`);
+    }
+    if (audit.orphanInMeta.length) {
+      lines.push(`- meta \u591A\u4F59 uuid\uFF1A${audit.orphanInMeta.length} \u4E2A\uFF08flow.json \u4E2D\u5DF2\u4E0D\u5B58\u5728\uFF09`);
+    }
+    for (const w of audit.warnings) lines.push(`- ${w}`);
+    lines.push(
+      "",
+      "\u4FEE\u590D\uFF08\u5728\u6D41\u7A0B\u76EE\u5F55\uFF09\uFF1A",
+      "",
+      "```powershell",
+      "dazi flow project repair-meta --dir .",
+      "dazi flow project doctor --dir .",
+      "```",
+      "",
+      `\u8BE6\u89C1 [\u6D41\u7A0B\u672C\u5730\u6587\u4EF6\u89C4\u8303](${localFilesSpecLink})\u3002`,
+      ""
+    );
+  }
+  lines.push(
+    "## \u53D8\u66F4\u63D0\u4EA4\u547D\u4EE4\u77E9\u9635",
+    "",
+    "| \u6539\u4E86\u4EC0\u4E48 | \u547D\u4EE4 |",
+    "|----------|------|",
+    "| `managed_file_id`\u3001`output_variable_name`\u3001\u8FDE\u7EBF\u3001\u589E\u5220\u8282\u70B9 | `dazi flow project push --dir . --canvas` |",
+    "| `\u8282\u70B9/<\u540D>/code.py` \u6216 `code.sql` | `dazi flow node push --node <uuid> --dir .` |",
+    '| **\u65B0\u589E\u4EE3\u7801\u8282\u70B9** | `dazi flow node new --type <type> --dir . --label "<\u540D>"` \u2192 \u6539\u914D\u7F6E \u2192 `push --canvas` \u2192 \u5199 code \u2192 `node push` |',
+    "",
+    "> \u7981\u6B62\u53EA\u6539 `flow.json` \u800C\u4E0D\u66F4\u65B0 `flow.meta.json`\uFF08\u987B `node new` / `pull` / `repair-meta`\uFF09\u3002",
+    ""
+  );
+  return lines;
+}
+var import_crypto2, import_fs6, import_path7, NODES_DIR2, FLOW_JSON2, FLOW_META_JSON2, NODE_INFO_JSON2, NODE_TYPE_CODE_DATA_KEY2;
+var init_flowWorkspaceAudit = __esm({
+  "src/shared/flowWorkspaceAudit.ts"() {
+    "use strict";
+    import_crypto2 = __toESM(require("crypto"));
+    import_fs6 = __toESM(require("fs"));
+    import_path7 = __toESM(require("path"));
+    NODES_DIR2 = "\u8282\u70B9";
+    FLOW_JSON2 = "flow.json";
+    FLOW_META_JSON2 = "flow.meta.json";
+    NODE_INFO_JSON2 = "node.info.json";
+    NODE_TYPE_CODE_DATA_KEY2 = {
+      "database-source": "sql",
+      "dataspace-source": "sql",
+      "python-script": "pythonCode",
+      "excel-python": "pythonCode",
+      "sql-query": "sql",
+      condition: "pythonCode",
+      "data-quality-check": "dqPythonCode"
+    };
+  }
+});
 
-// cli/dazi-flow/src/commands/flows.ts
-function makeFlowsCommand() {
-  const cmd = new Command("flows").description("Flow \u7BA1\u7406");
-  cmd.command("list").description("\u5217\u51FA\u6240\u6709 Flow").option("--space <spaceId>", "\u8FC7\u6EE4\u7A7A\u95F4").option("--status <status>", "\u8FC7\u6EE4\u72B6\u6001\uFF08active/draft/archived\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
-    try {
-      const qs = new URLSearchParams();
-      if (opts.space) qs.set("spaceId", opts.space);
-      if (opts.status) qs.set("status", opts.status);
-      const qsStr = qs.toString() ? `?${qs}` : "";
-      const endpoint = `/api/data-pipelines/v1/flows${qsStr}`;
-      const flows = await apiRequest(endpoint);
-      if (opts.json) {
-        console.log(JSON.stringify(flows, null, 2));
-        ok({ flows });
-        return;
+// src/shared/flowScaffoldDocs.js
+var require_flowScaffoldDocs = __commonJS({
+  "src/shared/flowScaffoldDocs.js"(exports2) {
+    "use strict";
+    var __importDefault = exports2 && exports2.__importDefault || function(mod) {
+      return mod && mod.__esModule ? mod : { "default": mod };
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.writeScaffoldIfAllowed = exports2.buildFlowProjectReadmeHelpSection = exports2.removeLegacyFlowDirScaffoldReadme = exports2.resolveFlowRootFromFlowDir = exports2.removeLegacyFlowRootQuickStart = exports2.resolveFlowDirQuickStartPath = exports2.writeFlowDirQuickStartScaffold = exports2.removeLegacyFlowDirQuickStartFiles = exports2.buildFlowDirReadmeMarkdown = exports2.buildFlowDirQuickStartMarkdown = exports2.buildFlowsDirReadmeMarkdown = exports2.buildFlowQuickStartMarkdown = exports2.buildFlowRootReadmeMarkdown = exports2.isLegacyFlowScaffoldFile = exports2.isFlowScaffoldFile = exports2.flowDirQuickStartFilename = exports2.sanitizeFlowNameForFilename = exports2.FLOW_DIR_QUICKSTART_FILENAME = exports2.LEGACY_FLOW_DIR_QUICKSTART_FILENAME = exports2.LEGACY_FLOW_ROOT_QUICKSTART_FILENAME = exports2.FLOW_ROOT_README_FILENAME = exports2.flowDocsRel = void 0;
+    var path_1 = __importDefault(require("path"));
+    var flowNodeCatalog_1 = (init_flowNodeCatalog(), __toCommonJS(flowNodeCatalog_exports));
+    var flowCliText_1 = (init_flowCliText(), __toCommonJS(flowCliText_exports));
+    var flowWorkspaceAudit_1 = (init_flowWorkspaceAudit(), __toCommonJS(flowWorkspaceAudit_exports));
+    var DEPTH = {
+      "project-root": 2,
+      "flows-dir": 3,
+      "flow-dir": 4
+    };
+    function flowDocsRel(anchor, docPath) {
+      const prefix = "../".repeat(DEPTH[anchor]);
+      return `${prefix}\u8D44\u6E90/docs/${docPath}`;
+    }
+    exports2.flowDocsRel = flowDocsRel;
+    var SCAFFOLD_MARKER = "<!-- dazi-flow-scaffold -->";
+    exports2.FLOW_ROOT_README_FILENAME = "README.md";
+    exports2.LEGACY_FLOW_ROOT_QUICKSTART_FILENAME = "\u5FEB\u901F\u542F\u52A8.md";
+    exports2.LEGACY_FLOW_DIR_QUICKSTART_FILENAME = "\u5FEB\u901F\u542F\u52A8.md";
+    exports2.FLOW_DIR_QUICKSTART_FILENAME = exports2.LEGACY_FLOW_DIR_QUICKSTART_FILENAME;
+    function sanitizeFlowNameForFilename(flowName) {
+      const safe = flowName.trim().replace(/[\\/:*?"<>|]/g, "_").replace(/\s+/g, "_").replace(/_+/g, "_").replace(/^\.+/, "").slice(0, 80);
+      return safe || "flow";
+    }
+    exports2.sanitizeFlowNameForFilename = sanitizeFlowNameForFilename;
+    function flowDirQuickStartFilename(flowName) {
+      return `\u5FEB\u901F\u542F\u52A8_${sanitizeFlowNameForFilename(flowName)}.md`;
+    }
+    exports2.flowDirQuickStartFilename = flowDirQuickStartFilename;
+    function isFlowScaffoldFile(content) {
+      return content.includes(SCAFFOLD_MARKER);
+    }
+    exports2.isFlowScaffoldFile = isFlowScaffoldFile;
+    function isLegacyFlowScaffoldFile(content) {
+      if (isFlowScaffoldFile(content))
+        return false;
+      return content.includes("dazi-flow project pull") || content.includes("dazi-flow node push") || content.includes("\u89C1 \xA7335") || content.includes("# \u6D41\u7A0B") && content.includes("dazi-flow project pull");
+    }
+    exports2.isLegacyFlowScaffoldFile = isLegacyFlowScaffoldFile;
+    function buildDocsTable(anchor) {
+      const rows = [
+        ["Flow \u6587\u6863\u7D22\u5F15\uFF08\u4ECE\u8FD9\u91CC\u5F00\u59CB\uFF09", "flow/flows-guide.md"],
+        ["\u6570\u636E\u6D41\u7A0B\u9879\u76EE\u5F00\u53D1\u6307\u5357", "flow/flow-project-guide.md"],
+        ["\u6D41\u7A0B\u53D8\u91CF\u7CFB\u7EDF\u6307\u5357", "flow/variables-guide.md"],
+        ["\u8282\u70B9\u4EE3\u7801\u7F16\u5199\u6307\u5357\uFF08\u542B SQL/Python \u793A\u4F8B\uFF09", "flow/node-code-guide.md"],
+        ["Flow \u8FD0\u884C\u4E0E\u6D4B\u8BD5", "flow/run-guide.md"],
+        ["\u6570\u636E\u6E90\u4E0E connectionId", "flow/source-guide.md"],
+        ["**\u6D41\u7A0B\u672C\u5730\u6587\u4EF6\u89C4\u8303\uFF08AI \u5FC5\u8BFB\uFF09**", "flow/local-files-spec.md"],
+        ["\u6D41\u7A0B AI \u5DE5\u4F5C\u624B\u518C", "flow/ai-workflow-playbook.md"],
+        ["CLI \u8C03\u7528\u7EA6\u5B9A\uFF08`dazi` / `dazi.ps1`\uFF09", "guides/cli-invocation.md"]
+      ];
+      return [
+        "## \u5E2E\u52A9\u6587\u6863",
+        "",
+        "\u5DE5\u4F5C\u533A\u6587\u6863\u4F4D\u4E8E **`\u8D44\u6E90/docs/`**\uFF08\u6269\u5C55\u4FA7\u680F **\u5E2E\u52A9 \u2192 \u4E0B\u8F7D\u6240\u6709\u6587\u6863**\uFF0C\u6216\u5728\u5DE5\u4F5C\u533A\u6839\u6267\u884C `dazi docs sync`\uFF09\uFF1A",
+        "",
+        "| \u6587\u6863 | \u94FE\u63A5 |",
+        "|------|------|",
+        ...rows.map(([title, p]) => `| ${title} | [${p.split("/").pop()}](${flowDocsRel(anchor, p)}) |`),
+        "",
+        "\u7EC8\u7AEF\u6253\u5F00\u6587\u6863\uFF08**dazi-work \u6839**\u6216\u5DF2 `cd` \u5230\u6D41\u7A0B\u76EE\u5F55\uFF09\uFF1A",
+        "",
+        "```powershell",
+        (0, flowCliText_1.psDaziLine)("docs open flow/flow-project-guide"),
+        (0, flowCliText_1.psDaziLine)("docs open flow/variables-guide"),
+        (0, flowCliText_1.psDaziLine)("docs open flow/node-code-guide"),
+        (0, flowCliText_1.psDaziLine)("docs open flow/flows-guide"),
+        "```",
+        "",
+        "**\u4EE3\u7801\u793A\u4F8B**\uFF1A\u53D8\u91CF\u8BFB\u5199\u3001`python-script` / `sql-query` \u6A21\u677F\u89C1 [\u8282\u70B9\u4EE3\u7801\u7F16\u5199\u6307\u5357](" + flowDocsRel(anchor, "flow/node-code-guide.md") + ") \u4E0E [\u6D41\u7A0B\u53D8\u91CF\u7CFB\u7EDF\u6307\u5357](" + flowDocsRel(anchor, "flow/variables-guide.md") + ")\u3002",
+        ""
+      ];
+    }
+    function psPath(p) {
+      return p.replace(/\//g, "\\");
+    }
+    function buildFlowDirRelPath(projectFolder, flowName) {
+      const folder = projectFolder ?? "<\u4E1A\u52A1\u9879\u76EE\u540D>";
+      return `\u9879\u76EE/${folder}/\u6D41\u7A0B/flows/${flowName}`;
+    }
+    function buildFlowCliDirSection(opts) {
+      const relPs = psPath(buildFlowDirRelPath(opts.projectFolder, opts.flowName));
+      const absDir = opts.flowDir ? psPath(path_1.default.resolve(opts.flowDir)) : `D:\\path\\to\\dazi-work\\${relPs}`;
+      return [
+        "## CLI \u8C03\u7528\u7EA6\u5B9A\uFF08\u5FC5\u8BFB\uFF09",
+        "",
+        "> **`--dir` \u5FC5\u987B\u6307\u5411\u542B `flow.json` \u7684\u6D41\u7A0B\u76EE\u5F55**\uFF08\u5373\u672C\u76EE\u5F55\uFF09\u3002",
+        "> **\u7981\u6B62**\u5728 `dazi-work` **\u5DE5\u4F5C\u533A\u6839**\u6267\u884C `dazi flow project status/push/pull ... --dir .`",
+        "> \uFF08\u6839\u76EE\u5F55\u53EF\u80FD\u6B8B\u7559\u9519\u8BEF\u7684 `flow.meta.json`\uFF0C\u6216 Agent \u8BEF\u8BFB\u5176\u4ED6\u6D41\u7A0B\u7684 meta\uFF0C\u5BFC\u81F4 **flowId \u4E0E\u6D41\u7A0B\u540D\u4E0D\u4E00\u81F4**\uFF09\u3002",
+        "",
+        "### \u63A8\u8350\uFF1A\u7EDD\u5BF9\u8DEF\u5F84\uFF08Trae / Agent \u9996\u9009\uFF09",
+        "",
+        "\u4E0D\u4F9D\u8D56\u7EC8\u7AEF\u5F53\u524D\u76EE\u5F55\uFF0C\u907F\u514D `cd` \u5230\u9519\u8BEF\u6D41\u7A0B\uFF1A",
+        "",
+        "```powershell",
+        (0, flowCliText_1.psFlowLine)(`project status --dir "${absDir}"`),
+        (0, flowCliText_1.psFlowLine)(`project pull --flow ${opts.flowId} --dir "${absDir}"`),
+        (0, flowCliText_1.psFlowLine)(`project push --dir "${absDir}" --canvas`),
+        (0, flowCliText_1.psFlowLine)(`run node-exec --node <node_uuid> --dir "${absDir}"`),
+        (0, flowCliText_1.psFlowLine)(`run flow-exec --dir "${absDir}" --type debug`),
+        (0, flowCliText_1.psFlowLine)(`variable sync --dir "${absDir}"`),
+        "```",
+        "",
+        "### \u53EF\u9009\uFF1A\u5148 cd \u518D `--dir .`",
+        "",
+        "\u4EC5\u5F53\u7EC8\u7AEF **\u5DF2\u786E\u8BA4** \u5728\u5F53\u524D\u6D41\u7A0B\u76EE\u5F55\u65F6\uFF1A",
+        "",
+        "```powershell",
+        `cd "${absDir}"`,
+        (0, flowCliText_1.psFlowLine)("project status --dir ."),
+        (0, flowCliText_1.psFlowLine)(`project pull --flow ${opts.flowId} --dir .`),
+        "```",
+        "",
+        "**\u81EA\u68C0**\uFF1A`status` \u8F93\u51FA\u987B\u540C\u65F6\u5339\u914D\u672C\u9875 **flowId** \u4E0E **\u6D41\u7A0B\u540D**\uFF1B\u82E5\u51FA\u73B0\u5176\u4ED6\u6D41\u7A0B\u540D\uFF0C\u8BF4\u660E `--dir` \u6216 `cd` \u9519\u8BEF\u3002",
+        ""
+      ];
+    }
+    function cliPrefix() {
+      return `\`${flowCliText_1.DAZI_CLI} flow\`\uFF08\u5168\u5C40 CLI\uFF1B\`--dir\` \u6307\u5411 **\u6D41\u7A0B\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84**\uFF1B\u672A\u88C5\u5168\u5C40\u65F6\u53EF\u7528 \`.scriptsdazi.ps1 flow\`\uFF09`;
+    }
+    function buildFlowRootReadmeMarkdown2(opts) {
+      const folder = opts.projectFolder;
+      return [
+        SCAFFOLD_MARKER,
+        "# \u6D41\u7A0B",
+        "",
+        `\u672C\u76EE\u5F55\u4E3A\u4E1A\u52A1\u9879\u76EE **\`${folder}\`** \u7684\u6570\u636E\u6D41\u7A0B\u5DE5\u4F5C\u533A\u3002`,
+        "",
+        "## 1. \u76EE\u5F55\u7ED3\u6784",
+        "",
+        "| \u8DEF\u5F84 | \u8BF4\u660E |",
+        "|------|------|",
+        "| `\u89C4\u5212/` | \u6D41\u7A0B\u8BBE\u8BA1\u6587\u6863\uFF08\u6570\u636E\u6E90\u3001\u62D3\u6251\u8349\u6848\u7B49\uFF09 |",
+        "| `flows/` | \u5404\u6D41\u7A0B\u5B9E\u4F8B\u76EE\u5F55\uFF08`flow.json`\u3001`\u8282\u70B9/`\u3001`\u53D8\u91CF/`\uFF09 |",
+        "",
+        "\u5355\u4E2A\u6D41\u7A0B\u4F4D\u4E8E `flows/<\u6D41\u7A0B\u540D>/`\uFF1A",
+        "",
+        "| \u8DEF\u5F84 | \u8BF4\u660E |",
+        "|------|------|",
+        "| `flow.json` | \u753B\u5E03\u771F\u7406\u6E90\uFF08\u8282\u70B9\u914D\u7F6E + \u8FDE\u7EBF\uFF0C\u4EE3\u7801\u5DF2\u5265\u79BB\uFF09 |",
+        "| `flow.meta.json` | flowId\u3001node_uuid \u6620\u5C04\uFF08CLI \u7EF4\u62A4\uFF0C\u52FF\u624B\u6539\uFF09 |",
+        "| `\u8282\u70B9/<\u540D>/code.*` | SQL / Python \u8282\u70B9\u4EE3\u7801 |",
+        "| `\u53D8\u91CF/<\u540D>.json` | \u8C03\u8BD5 Run \u53D8\u91CF\u9884\u89C8\uFF08\u53EA\u8BFB\uFF0Cpull/sync \u751F\u6210\uFF09 |",
+        "| `_run/` | \u6D4B\u8BD5/\u8FD0\u884C\u4EA7\u7269\uFF08`*.last-error.md` \u7B49\uFF09 |",
+        "",
+        "> \u6D41\u7A0B**\u4E0D\u7ED1\u5B9A\u6570\u636E\u7A7A\u95F4**\uFF1B`connectionId` \u4EC5\u4E3A\u6570\u636E\u5E93\u8282\u70B9\u7684\u914D\u7F6E\u5B57\u6BB5\u3002",
+        "",
+        "## 2. \u65B0\u5EFA / \u62C9\u53D6\u6D41\u7A0B",
+        "",
+        "\u8D44\u6E90\u7BA1\u7406\u5668\uFF08\u63A8\u8350 **\u8868\u5355**\uFF09\uFF1A",
+        "",
+        "| \u64CD\u4F5C | \u83DC\u5355 |",
+        "|------|------|",
+        "| \u65B0\u5EFA\u6D41\u7A0B | \u53F3\u952E **`\u6D41\u7A0B/flows/`**\uFF08\u6216\u5176\u5B50\u76EE\u5F55\uFF09\u2192 **\u65B0\u5EFA\u6D41\u7A0B** |",
+        "| \u62C9\u53D6\u5E73\u53F0\u6D41\u7A0B | \u53F3\u952E **`\u6D41\u7A0B/flows/`**\uFF08\u6216\u5176\u5B50\u76EE\u5F55\uFF09\u2192 **\u62C9\u53D6\u5E73\u53F0\u6D41\u7A0B** |",
+        "",
+        "\u62C9\u53D6\u8868\u5355\u53EF\u4ECE\u5E73\u53F0 Flow \u5217\u8868\u9009\u62E9\uFF0C\u6216\u624B\u52A8\u586B\u5199 Flow ID\uFF1B\u65B0\u5EFA\u8868\u5355\u586B\u5199\u540D\u79F0\u4E0E\u8BF4\u660E\u540E\u81EA\u52A8\u521B\u5EFA\u5E76\u62C9\u53D6\u3002",
+        "",
+        "> **\u7981\u6B62**\u5728 `dazi-work` \u5DE5\u4F5C\u533A\u6839\u5BF9\u6D41\u7A0B\u547D\u4EE4\u4F7F\u7528 `--dir .`\uFF1B`--dir` \u987B\u6307\u5411 `flows/<\u6D41\u7A0B\u540D>/`\uFF08\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09\u3002",
+        "",
+        "\u547D\u4EE4\u884C\uFF08`--dir` \u4F7F\u7528\u7EDD\u5BF9\u8DEF\u5F84\u6216\u76F8\u5BF9 `dazi-work` \u6839\uFF09\uFF1A",
+        "",
+        "```powershell",
+        (0, flowCliText_1.psFlowLine)('project pull --flow <flowId> --dir "D:\\path\\to\\dazi-work\\\u9879\u76EE\\' + folder + '\\\u6D41\u7A0B\\flows\\<\u6D41\u7A0B\u540D>"'),
+        "```",
+        "",
+        "\u62C9\u53D6\u540E\u6BCF\u4E2A\u6D41\u7A0B\u76EE\u5F55\u4F1A\u751F\u6210 **`\u5FEB\u901F\u542F\u52A8_<\u6D41\u7A0B\u540D>.md`**\uFF08\u542B flowId \u4E0E\u672C\u6D41\u7A0B\u5E38\u7528\u547D\u4EE4\uFF0C\u4FBF\u4E8E @ \u9644\u52A0\u7ED9 AI\uFF09\u3002",
+        "",
+        "## 3. \u5F00\u53D1\u4E0E\u63D0\u4EA4",
+        "",
+        "1. \u7F16\u8F91 `\u8282\u70B9/<\u540D>/code.sql` \u6216 `code.py`",
+        "2. \u53F3\u952E **\u6D4B\u8BD5\u8FD0\u884C\u8282\u70B9** \u6216 `flow run node-exec --node <uuid>`",
+        "3. \u53F3\u952E **\u63D0\u4EA4\u8282\u70B9** / **\u63D0\u4EA4\u6D41\u7A0B** \u6216 `flow node push` / `flow project push --canvas`",
+        "4. \u67E5\u770B\u8868\u53D8\u91CF\uFF1A\u8BBE\u8BA1\u5668 **output_variable_name** \u65C1 \u{1F4CA}\uFF0C\u6216 `flow variable pull --name <\u540D>`",
+        "",
+        "\u547D\u4EE4\u524D\u7F00\uFF1A" + cliPrefix(),
+        "",
+        "## 4. \u63A8\u8350\u5F00\u53D1\u5FAA\u73AF",
+        "",
+        "\u8BE6\u89C1 [\u6570\u636E\u6D41\u7A0B\u9879\u76EE\u5F00\u53D1\u6307\u5357](" + flowDocsRel("project-root", "flow/flow-project-guide.md") + ") \xA74\u3002",
+        "",
+        "## 5. AI \u63D0\u793A\u8BCD\u63A8\u8350",
+        "",
+        "| \u573A\u666F | \u63D0\u793A\u8BCD ID |",
+        "|------|-----------|",
+        "| \u8BBE\u8BA1/\u65B0\u589E\u6D41\u7A0B | `flow/flow-design` |",
+        "| **\u8FD0\u884C\u5931\u8D25\u3001\u81EA\u4E3B\u6539\u9519** | **`flow/run-fix-loop`**\uFF08\u2B50 \u9996\u9009\uFF09 |",
+        "| \u5206\u6790\u7528\u6237\u7C98\u8D34\u7684\u9519\u8BEF | `flow/run-debug` |",
+        "",
+        "\u4FA7\u680F **\u5E2E\u52A9 \u2192 \u{1F916} \u63D0\u793A\u8BCD** \u4E2D \u2B50 \u4E3A\u6D41\u7A0B\u63A8\u8350\u3002\u53F3\u952E **`flow.json`** \u2192 **\u6253\u5F00 AI \u6539\u9519\u63D0\u793A\u8BCD**\u3002",
+        "\u7ED9 AI \u7684\u4EFB\u52A1\u793A\u4F8B\uFF1A\u300C\u6539 XX \u8282\u70B9\uFF0C\u81EA\u5DF1\u8DD1\u6D4B\u8BD5\uFF0C\u5931\u8D25\u6309 last-error \u6539\u5230\u901A\u8FC7\u518D push\u300D\u3002",
+        "",
+        ...buildDocsTable("project-root")
+      ].join("\n");
+    }
+    exports2.buildFlowRootReadmeMarkdown = buildFlowRootReadmeMarkdown2;
+    function buildFlowQuickStartMarkdown(opts) {
+      return buildFlowRootReadmeMarkdown2(opts);
+    }
+    exports2.buildFlowQuickStartMarkdown = buildFlowQuickStartMarkdown;
+    function buildFlowsDirReadmeMarkdown2(opts) {
+      return [
+        SCAFFOLD_MARKER,
+        "# flows",
+        "",
+        "\u6BCF\u4E2A\u5B50\u76EE\u5F55\u662F\u4E00\u4E2A\u6D41\u7A0B\u5B9E\u4F8B\uFF08\u542B `flow.json`\u3001`flow.meta.json`\uFF09\u3002",
+        "",
+        "## \u64CD\u4F5C",
+        "",
+        "| \u64CD\u4F5C | \u65B9\u5F0F |",
+        "|------|------|",
+        "| \u65B0\u5EFA\u6D41\u7A0B | \u53F3\u952E\u672C\u76EE\u5F55 \u2192 **\u65B0\u5EFA\u6D41\u7A0B**\uFF08\u8868\u5355\uFF1A\u540D\u79F0\u3001\u8BF4\u660E\u3001\u8DEF\u5F84\u9884\u89C8\uFF09 |",
+        "| \u62C9\u53D6\u5E73\u53F0\u6D41\u7A0B | \u53F3\u952E \u2192 **\u62C9\u53D6\u5E73\u53F0\u6D41\u7A0B**\uFF08\u8868\u5355\uFF1A\u5E73\u53F0\u5217\u8868 / Flow ID\u3001\u672C\u5730\u76EE\u5F55\u540D\uFF09 |",
+        "| \u6253\u5F00\u8BBE\u8BA1\u5668 | \u53F3\u952E `flow.json` \u2192 **\u6253\u5F00\u6D41\u7A0B\u8BBE\u8BA1\u5668** |",
+        "",
+        "> **\u7981\u6B62**\u5728 `dazi-work` \u6839\u6267\u884C `project status/push/pull --dir .`\u3002",
+        "",
+        "```powershell",
+        "# \u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84",
+        (0, flowCliText_1.psFlowLine)(`project pull --flow <id> --dir "D:\\path\\to\\dazi-work\\\u9879\u76EE\\${opts.projectFolder}\\\u6D41\u7A0B\\flows\\<\u6D41\u7A0B\u540D>"`),
+        "```",
+        "",
+        "\u62C9\u53D6\u5B8C\u6210\u540E\u8BF7\u9605\u8BFB\u5404\u6D41\u7A0B\u5B50\u76EE\u5F55\u4E0B\u7684 **`\u5FEB\u901F\u542F\u52A8_<\u6D41\u7A0B\u540D>.md`**\u3002",
+        "",
+        ...buildDocsTable("flows-dir")
+      ].join("\n");
+    }
+    exports2.buildFlowsDirReadmeMarkdown = buildFlowsDirReadmeMarkdown2;
+    function buildFlowDirQuickStartMarkdown2(opts) {
+      const name = opts.flowName;
+      const relDir = buildFlowDirRelPath(opts.projectFolder, name);
+      let audit;
+      if (opts.flowDir) {
+        try {
+          audit = (0, flowWorkspaceAudit_1.auditFlowWorkspace)(opts.flowDir);
+        } catch {
+        }
       }
-      if (!flows.length) {
-        console.log("\uFF08\u6682\u65E0 Flow\uFF09");
-        ok({ flows: [] });
+      const canvasN = audit?.canvasNodeCount ?? opts.nodeCount;
+      const codeN = audit?.canvasCodeNodeCount ?? opts.codeNodeCount;
+      const metaCodeN = audit?.metaCodeIndexedCount;
+      const statsParts = [];
+      if (canvasN != null) {
+        let line = `
+| \u753B\u5E03\u8282\u70B9\uFF08flow.json\uFF09 | ${canvasN}`;
+        if (codeN != null)
+          line += `\uFF0C\u5176\u4E2D\u4EE3\u7801\u8282\u70B9 ${codeN}`;
+        line += " |";
+        statsParts.push(line);
+      }
+      if (metaCodeN != null && codeN != null && metaCodeN !== codeN) {
+        statsParts.push(`
+| meta \u5DF2\u7D22\u5F15\u4EE3\u7801 | ${metaCodeN} \u26A0\uFE0F \u4E0E\u753B\u5E03\u4E0D\u4E00\u81F4 |`);
+      } else if (metaCodeN != null) {
+        statsParts.push(`
+| meta \u5DF2\u7D22\u5F15\u4EE3\u7801 | ${metaCodeN} |`);
+      }
+      const pulled = opts.pulledAt ? `
+| \u4E0A\u6B21\u62C9\u53D6 | ${opts.pulledAt} |` : "";
+      const consistencySection = audit ? (0, flowWorkspaceAudit_1.buildFlowConsistencyMarkdown)(audit, flowDocsRel("flow-dir", "flow/local-files-spec.md")) : [];
+      return [
+        SCAFFOLD_MARKER,
+        "# \u5FEB\u901F\u542F\u52A8",
+        "",
+        `**\u6D41\u7A0B**\uFF1A${name} \xB7 \u5E73\u53F0 flowId \`${opts.flowId}\``,
+        "",
+        "## \u6D41\u7A0B\u4FE1\u606F",
+        "",
+        "| \u5B57\u6BB5 | \u503C |",
+        "|------|-----|",
+        `| flowId | \`${opts.flowId}\` |`,
+        `| \u672C\u5730\u76EE\u5F55 | \`${relDir}/\` |${statsParts.join("")}${pulled}`,
+        "",
+        ...consistencySection,
+        ...buildFlowCliDirSection({
+          flowDir: opts.flowDir,
+          projectFolder: opts.projectFolder,
+          flowName: name,
+          flowId: opts.flowId
+        }),
+        "## \u5E38\u7528\u547D\u4EE4\u901F\u67E5",
+        "",
+        "\u9700\u5DF2\u5B89\u88C5\u5168\u5C40 CLI\uFF08`pnpm add -g @dazitech/cli`\uFF09\u6216\u672A\u88C5\u65F6\u7528 `.scriptsdazi.ps1 flow`\uFF1A",
+        "",
+        "```powershell",
+        "# \u5C06 <FLOW_DIR> \u66FF\u6362\u4E3A\u4E0A\u4E00\u8282\u7EDD\u5BF9\u8DEF\u5F84",
+        (0, flowCliText_1.psFlowLine)('project status --dir "<FLOW_DIR>"'),
+        (0, flowCliText_1.psFlowLine)(`project pull --flow ${opts.flowId} --dir "<FLOW_DIR>"`),
+        (0, flowCliText_1.psFlowLine)('project push --dir "<FLOW_DIR>" --canvas'),
+        (0, flowCliText_1.psFlowLine)('run node-exec --node <node_uuid> --dir "<FLOW_DIR>"'),
+        (0, flowCliText_1.psFlowLine)('run flow-exec --dir "<FLOW_DIR>" --type debug'),
+        (0, flowCliText_1.psFlowLine)('variable sync --dir "<FLOW_DIR>"'),
+        "```",
+        "",
+        ...(0, flowNodeCatalog_1.buildFlowNodeCatalogQuickStartSection)(flowDocsRel("flow-dir", "flow/flows-guide.md")),
+        "## AI \u4FEE\u6539\u73B0\u6709\u6D41\u7A0B\uFF08\u5355\u6587\u4EF6\u5165\u53E3\uFF09",
+        "",
+        "> \u63A8\u8350\u53EA\u628A\u672C\u6587\u4EF6\u9644\u52A0\u7ED9 AI\uFF1B\u82E5\u4FE1\u606F\u4E0D\u8DB3\uFF0C\u518D\u6309\u9700\u6253\u5F00\u300C\u5E2E\u52A9\u6587\u6863\u300D\u4E2D\u7684\u4E13\u9898\u3002",
+        "",
+        "### \u573A\u666F A\uFF1A\u65B0\u589E\u8282\u70B9\uFF08\u5DF2\u6709\u6D41\u7A0B\u7EE7\u7EED\u6539\uFF09",
+        "",
+        "1. \u5148\u8BFB `flow.json` \u4E0E `flow.meta.json`\uFF0C\u6267\u884C `dazi flow project doctor --dir .`",
+        `2. **\u5FC5\u987B**\u7528 CLI \u65B0\u5EFA\u8282\u70B9\uFF08\u7981\u6B62\u624B\u6413 uuid\uFF09\uFF1A${(0, flowCliText_1.mdFlowCmd)('node new --type <node_type> --dir . --label "<\u8282\u70B9\u540D>"')}`,
+        "3. \u5728 `flow.json` \u91CC\u8865 `nodes/edges`\uFF08\u9075\u5B88\u951A\u70B9\uFF1A`sourceHandle` \u4EC5 `r/b/true/false`\uFF0C`targetHandle` \u4EC5 `l/t`\uFF09",
+        "4. \u7F16\u8F91 `\u8282\u70B9/<\u540D>/code.sql|py`\uFF08`node new` \u4F1A\u521B\u5EFA\u76EE\u5F55\u4E0E meta \u7D22\u5F15\uFF09",
+        `5. \u5355\u8282\u70B9\u6D4B\u8BD5\uFF1A${(0, flowCliText_1.mdFlowCmd)("run node-exec --node <node_uuid> --dir .")}`,
+        `6. \u63D0\u4EA4\u753B\u5E03\uFF08\u542B\u8FDE\u7EBF/\u914D\u7F6E\uFF09\uFF1A${(0, flowCliText_1.mdFlowCmd)("project push --dir . --canvas")}`,
+        "",
+        "### \u573A\u666F B\uFF1A\u4EC5\u6539\u8282\u70B9\u4EE3\u7801",
+        "",
+        "1. \u7F16\u8F91 `\u8282\u70B9/<\u540D>/code.sql|py`\uFF08\u4E0D\u8981\u628A\u6B63\u6587\u5199\u56DE `flow.json`\uFF09",
+        `2. \u8FD0\u884C\u8282\u70B9\uFF1A${(0, flowCliText_1.mdFlowCmd)("run node-exec --node <node_uuid> --dir .")}`,
+        `3. \u63D0\u4EA4\u4EE3\u7801\uFF1A${(0, flowCliText_1.mdFlowCmd)("node push --node <node_uuid> --dir .")}`,
+        "",
+        "### \u573A\u666F C\uFF1A\u753B\u5E03\u548C\u4EE3\u7801\u4E0D\u540C\u6B65",
+        "",
+        `1. \u5148 ${(0, flowCliText_1.mdFlowCmd)("project status --dir .")} \u770B\u672C\u5730\u810F\u6539\u52A8`,
+        `2. \u82E5\u6539\u4E86\u62D3\u6251/\u8FDE\u7EBF/\u914D\u7F6E\uFF1A\u6267\u884C ${(0, flowCliText_1.mdFlowCmd)("project push --dir . --canvas")}`,
+        `3. \u82E5\u53EA\u6539\u4E86\u4EE3\u7801\uFF1A\u6267\u884C ${(0, flowCliText_1.mdFlowCmd)("node push --node <node_uuid> --dir .")}`,
+        `4. \u5FC5\u8981\u65F6\u91CD\u65B0\u62C9\u53D6\u6821\u5BF9\uFF1A${(0, flowCliText_1.mdFlowCmd)(`project pull --flow ${opts.flowId} --dir .`)}`,
+        "",
+        "## AI \u81EA\u68C0\u6E05\u5355\uFF08\u63D0\u4EA4\u524D\uFF09",
+        "",
+        `- \u547D\u4EE4\u524D\u7F00\u662F\u5426\u7EDF\u4E00\u4E3A ${(0, flowCliText_1.mdFlowCmd)("...")}\uFF08\u800C\u4E0D\u662F\u88F8 \`dazi-flow\`\uFF09`,
+        "- `flow.json` \u662F\u5426\u53EA\u627F\u8F7D\u753B\u5E03\u62D3\u6251\u4E0E\u8282\u70B9\u914D\u7F6E\uFF08\u4E0D\u5D4C\u5165\u5927\u6BB5 SQL/Python\uFF09",
+        "- `code.*` \u662F\u5426\u4E0E\u8282\u70B9\u4E1A\u52A1\u7C7B\u578B\u4E00\u81F4\uFF08SQL \u8282\u70B9 `code.sql`\uFF0CPython \u8282\u70B9 `code.py`\uFF09",
+        "- \u6761\u4EF6\u8282\u70B9\u51FA\u8FB9\u662F\u5426\u4EC5\u4F7F\u7528 `true/false`\uFF0C\u672A\u8BEF\u7528 `r/b`",
+        "- \u82E5\u6539\u52A8\u753B\u5E03\uFF0C\u662F\u5426\u6267\u884C\u4E86 `flow project push --canvas`",
+        "",
+        "## \u5E38\u89C1\u9519\u8BEF\u4E0E\u4FEE\u590D",
+        "",
+        "| \u73B0\u8C61 | \u5E38\u89C1\u539F\u56E0 | \u4FEE\u590D |",
+        "|------|----------|------|",
+        `| \u547D\u4EE4\u627E\u4E0D\u5230 | \u672A\u88C5\u5168\u5C40 CLI \u6216\u4E0D\u5728 dazi-work | \`pnpm add -g @dazitech/cli\` \u6216 ${(0, flowCliText_1.mdFlowCmd)("...")} / \`.scriptsdazi.ps1 flow ...\` |`,
+        "| \u8282\u70B9\u6D4B\u8BD5\u62A5\u4E0A\u6E38\u53D8\u91CF\u4E0D\u5B58\u5728 | \u672A\u5148\u8FD0\u884C\u4E0A\u6E38\u8282\u70B9\u4EA7\u51FA\u53D8\u91CF | \u5148\u8DD1\u4E0A\u6E38\uFF0C\u6216\u6574\u6D41\u7A0B `flow run flow-exec --type debug` \u540E\u518D\u6D4B |",
+        "| excel-python \u627E\u4E0D\u5230\u6587\u4EF6 | code.py \u5199\u4E86\u6587\u4EF6\u540D/\u672C\u5730\u8DEF\u5F84 | \u753B\u5E03\u914D `managed_file_id`\uFF08UUID\uFF09\uFF1B\u4EE3\u7801\u7528 `excel_source_path` |",
+        "| Excel \u7528\u4E86 file-source | file-source \u4E0D\u89E3\u6790 xlsx | \u6539\u4E3A **`excel-python`** + `managed_file_id` |",
+        "| excel-python \u65E0\u4E3B\u8F93\u51FA | \u672A `set_table_output` \u6216\u540D\u79F0\u4E0E `output_variable_name` \u4E0D\u4E00\u81F4 | \u89C1 node-code-guide \xA75 |",
+        "| \u753B\u5E03\u663E\u793A\u5BF9\u4F46\u5E73\u53F0\u4E0D\u751F\u6548 | \u53EA push \u4E86\u4EE3\u7801\uFF0C\u672A push \u753B\u5E03 | \u6267\u884C `flow project push --dir . --canvas` |",
+        "| \u4EE3\u7801\u6539\u4E86\u4F46\u5E73\u53F0\u8FD8\u662F\u65E7\u4EE3\u7801 | \u6539\u4E86\u672C\u5730 `code.*` \u4F46\u672A node push | \u6267\u884C `flow node push --node <node_uuid> --dir .` |",
+        "| **flowId \u4E0E\u5FEB\u901F\u542F\u52A8\u4E0D\u4E00\u81F4** | \u5728 **dazi-work \u6839**\u6216**\u9519\u8BEF\u6D41\u7A0B\u76EE\u5F55**\u6267\u884C `--dir .` | \u6539\u7528\u4E0A\u6587 **\u7EDD\u5BF9\u8DEF\u5F84**\uFF1B`status` \u987B\u5339\u914D\u672C\u9875 flowId/\u6D41\u7A0B\u540D |",
+        "",
+        "## AI \u81EA\u4E3B\u8FD0\u884C\u4E0E\u6539\u9519\u95ED\u73AF\uFF08Agent \u5FC5\u8BFB\uFF09",
+        "",
+        "> **\u6269\u5C55/\u83DC\u5355\u4E0D\u4F1A\u81EA\u52A8\u6539\u4EE3\u7801**\uFF08\u5E73\u53F0 D6\uFF09\uFF1B\u7528\u6237\u59D4\u6258\u4F60\u6539\u6D41\u7A0B\u65F6\uFF0C\u4F60**\u5FC5\u987B\u4E3B\u52A8**\u6267\u884C\u300C\u6539 \u2192 \u8DD1 \u2192 \u8BFB\u9519 \u2192 \u518D\u6539 \u2192 \u518D\u8DD1\u300D\uFF0C\u76F4\u5230\u901A\u8FC7\u6216\u8FBE\u5230\u91CD\u8BD5\u4E0A\u9650\u3002",
+        "",
+        "### \u9519\u8BEF\u843D\u5728\u54EA\u91CC\uFF08\u8DD1\u5B8C\u5FC5\u67E5\uFF09",
+        "",
+        "| \u8FD0\u884C\u65B9\u5F0F | \u5931\u8D25\u65F6\u8BFB | \u6210\u529F/\u6B65\u9AA4\u6458\u8981 |",
+        "|----------|----------|---------------|",
+        "| \u5355\u8282\u70B9 `run node-exec` | `_run/<\u8282\u70B9\u540D>.last-error.md` | \u65E0 error \u6587\u4EF6\u5373\u901A\u8FC7 |",
+        "| \u6574\u6D41\u7A0B `run flow-exec` | `_run/flow.last-error.md` | `_run/flow.last-run.md`\uFF08\u6B65\u9AA4+\u65E5\u5FD7\uFF09 |",
+        "",
+        "CLI \u5E26 `--json` \u65F6\uFF1A\u770B\u8FD4\u56DE `success: false` \u6216 `errorFile` \u5B57\u6BB5\uFF0C**\u518D\u6253\u5F00\u5BF9\u5E94 md \u6587\u4EF6**\uFF0C\u4E0D\u8981\u53EA\u770B\u7EC8\u7AEF\u4E00\u884C\u62A5\u9519\u3002",
+        "",
+        "### \u6807\u51C6\u6539\u9519\u5FAA\u73AF\uFF08\u9ED8\u8BA4\u6700\u591A 3 \u8F6E\uFF09",
+        "",
+        "1. **\u5B9A\u4F4D**\uFF1A\u8BFB `flow.json` + \u76EE\u6807 `\u8282\u70B9/<\u540D>/code.*` + `flow.meta.json`\uFF08\u53D6 `node_uuid`\uFF09",
+        "2. **\u4FEE\u6539**\uFF1A\u53EA\u6539\u5FC5\u8981\u6587\u4EF6\uFF08\u4EE3\u7801 \u2192 `code.*`\uFF1B\u8FDE\u7EBF/\u914D\u7F6E \u2192 `flow.json`\uFF09",
+        "3. **\u9A8C\u8BC1**\uFF08\u5148\u5C0F\u540E\u5927\uFF09\uFF1A",
+        `   - \u5355\u8282\u70B9\uFF1A${(0, flowCliText_1.mdFlowCmd)("run node-exec --node <node_uuid> --dir .")}`,
+        `   - \u6574\u6D41\u7A0B\uFF1A${(0, flowCliText_1.mdFlowCmd)("run flow-exec --dir . --type debug")}`,
+        "4. **\u5224\u9519**\uFF1A\u9000\u51FA\u7801\u975E 0 / JSON `success:false` \u2192 \u6253\u5F00 `_run/*.last-error.md`\uFF0C\u6309\u5176\u4E2D**\u9519\u8BEF\u5206\u7C7B**\u4E0E traceback \u4FEE\u590D",
+        "5. **\u91CD\u8BD5**\uFF1A\u56DE\u5230\u6B65\u9AA4 2\uFF1B\u82E5 3 \u8F6E\u4ECD\u5931\u8D25\uFF0C\u6C47\u603B\u5DF2\u5C1D\u8BD5\u4FEE\u590D\u70B9\u5E76\u8BF7\u6C42\u7528\u6237\u4ECB\u5165",
+        "6. **\u63D0\u4EA4**\uFF08\u4EC5\u901A\u8FC7\u540E\uFF09\uFF1A\u4EE3\u7801 `node push`\uFF1B\u753B\u5E03 `project push --canvas`",
+        "",
+        "### \u5E38\u89C1\u5931\u8D25 \u2192 \u4F18\u5148\u52A8\u4F5C",
+        "",
+        "| last-error \u5206\u7C7B | \u4F18\u5148\u68C0\u67E5 |",
+        "|-----------------|----------|",
+        "| \u7F3A\u4E0A\u6E38\u53D8\u91CF | \u5148\u8DD1\u4E0A\u6E38\u8282\u70B9\u6216\u6574\u6D41\u7A0B debug\uFF0C\u518D `variable pull` \u770B schema |",
+        "| \u914D\u7F6E\u7F3A\u5931 | `flow.json` \u8BE5\u8282\u70B9 `data`\uFF08connectionId / output_variable_name \u7B49\uFF09 |",
+        "| \u4EE3\u7801\u9519\u8BEF | `code.*` \u4E0E traceback\uFF1B\u6539\u540E\u53EA `node push` |",
+        "| \u8FDE\u63A5/\u6570\u636E\u6E90 | connectionId / spaceId \u662F\u5426\u6709\u6548 |",
+        "",
+        "### Agent \u7981\u6B62\u9879",
+        "",
+        "- **\u7981\u6B62**\u672A\u5B9E\u9645\u8FD0\u884C\u5C31\u58F0\u79F0\u300C\u5DF2\u4FEE\u590D/\u5DF2\u901A\u8FC7\u300D",
+        "- **\u7981\u6B62**\u4E0D\u8BFB `_run/*.last-error.md` \u5C31\u731C\u6D4B\u539F\u56E0",
+        "- **\u7981\u6B62**\u4FEE\u590D\u540E\u8DF3\u8FC7\u9A8C\u8BC1\u76F4\u63A5 `push`",
+        "- **\u7981\u6B62**\u628A SQL/Python \u6B63\u6587\u5199\u56DE `flow.json`",
+        "",
+        "\u4FA7\u680F\u63D0\u793A\u8BCD\u53EF\u9009\u7528 **`flow/run-fix-loop`**\uFF08\u81EA\u4E3B\u6539\u9519\u4E13\u7528\uFF09\u3002",
+        "",
+        "\u6269\u5C55\uFF1A\u53F3\u952E **`flow.json`** / **\u8282\u70B9/** / **`code.*`** \u53EF\u6D4B\u8BD5\u3001\u63D0\u4EA4\u3001\u6253\u5F00\u8BBE\u8BA1\u5668\u3002",
+        "",
+        "## \u7F16\u5199\u8282\u70B9\u4EE3\u7801",
+        "",
+        "- **SQL \u8282\u70B9**\uFF08`sql-query` / `database-source`\uFF09\uFF1A\u7F16\u8F91 `\u8282\u70B9/<\u540D>/code.sql`\uFF1B`sql-query` \u4E2D\u7528 **\u4E0A\u6E38\u53D8\u91CF\u540D\u4F5C\u8868\u540D**\uFF08`FROM \u4E0A\u6E38\u53D8\u91CF\u540D`\uFF09",
+        '- **Python \u8282\u70B9**\uFF08`python-script`\uFF09\uFF1A\u7F16\u8F91 `code.py`\uFF1B\u5355\u8282\u70B9\u6D4B\u8BD5\u7528 **`get_variable("\u4E0A\u6E38\u53D8\u91CF\u540D")`**\uFF0C\u8F93\u51FA\u8D4B\u503C **`result_df`**',
+        "- **`excel-python`\uFF08Excel \u9ED8\u8BA4\u9996\u9009\uFF09**\uFF1A",
+        "  - \u6709 **`managed_file_id` \u7684 Excel \u2192 \u4F18\u5148 `excel-python`**\uFF0C**\u52FF\u7528 `file-source`**\uFF08file-source \u4E0D\u89E3\u6790 Excel\uFF09",
+        "  - **\u753B\u5E03**\u914D **`managed_file_id`**\uFF08UUID\uFF09\uFF1B**`code.py` \u53EA\u7528 `excel_source_path`**",
+        '  - \u4E3B\u8F93\u51FA **`set_table_output("<\u4E0E output_variable_name \u540C\u540D>", df)`**',
+        "  - \u5B8C\u6574\u793A\u4F8B \u2192 [node-code-guide \xA75](" + flowDocsRel("flow-dir", "flow/node-code-guide.md") + "#5-excel-pythonexcel-\u5F00\u53D1--\u9ED8\u8BA4\u9996\u9009)",
+        "- \u53D8\u91CF\u7EA6\u5B9A\u4E0E\u5B8C\u6574\u793A\u4F8B \u2192 [\u6D41\u7A0B\u53D8\u91CF\u7CFB\u7EDF\u6307\u5357](" + flowDocsRel("flow-dir", "flow/variables-guide.md") + ") \xB7 [\u8282\u70B9\u4EE3\u7801\u7F16\u5199\u6307\u5357](" + flowDocsRel("flow-dir", "flow/node-code-guide.md") + ")",
+        "",
+        ...buildDocsTable("flow-dir")
+      ].join("\n");
+    }
+    exports2.buildFlowDirQuickStartMarkdown = buildFlowDirQuickStartMarkdown2;
+    function buildFlowDirReadmeMarkdown(opts) {
+      return buildFlowDirQuickStartMarkdown2(opts);
+    }
+    exports2.buildFlowDirReadmeMarkdown = buildFlowDirReadmeMarkdown;
+    function removeLegacyFlowDirQuickStartFiles(flowDir, currentFilename, fsImpl) {
+      const legacy = path_1.default.join(flowDir, exports2.LEGACY_FLOW_DIR_QUICKSTART_FILENAME);
+      if (fsImpl.existsSync(legacy)) {
+        try {
+          if (isFlowScaffoldFile(fsImpl.readFileSync(legacy, "utf8"))) {
+            fsImpl.unlinkSync(legacy);
+          }
+        } catch {
+        }
+      }
+      for (const entry of fsImpl.readdirSync(flowDir)) {
+        if (entry === currentFilename)
+          continue;
+        if (!/^快速启动_.+\.md$/.test(entry))
+          continue;
+        const full = path_1.default.join(flowDir, entry);
+        try {
+          if (isFlowScaffoldFile(fsImpl.readFileSync(full, "utf8"))) {
+            fsImpl.unlinkSync(full);
+          }
+        } catch {
+        }
+      }
+    }
+    exports2.removeLegacyFlowDirQuickStartFiles = removeLegacyFlowDirQuickStartFiles;
+    function writeFlowDirQuickStartScaffold2(flowDir, flowName, content, fsImpl) {
+      const filename = flowDirQuickStartFilename(flowName);
+      writeScaffoldIfAllowed2(path_1.default.join(flowDir, filename), content, fsImpl);
+      removeLegacyFlowDirQuickStartFiles(flowDir, filename, fsImpl);
+      return filename;
+    }
+    exports2.writeFlowDirQuickStartScaffold = writeFlowDirQuickStartScaffold2;
+    function resolveFlowDirQuickStartPath(flowDir, fsImpl) {
+      let flowName;
+      const metaPath = path_1.default.join(flowDir, "flow.meta.json");
+      if (fsImpl.existsSync(metaPath)) {
+        try {
+          const meta = JSON.parse(fsImpl.readFileSync(metaPath, "utf8"));
+          flowName = meta.flowName?.trim() || void 0;
+        } catch {
+        }
+      }
+      if (!flowName)
+        flowName = path_1.default.basename(flowDir);
+      const preferred = path_1.default.join(flowDir, flowDirQuickStartFilename(flowName));
+      if (fsImpl.existsSync(preferred))
+        return preferred;
+      const legacy = path_1.default.join(flowDir, exports2.LEGACY_FLOW_DIR_QUICKSTART_FILENAME);
+      if (fsImpl.existsSync(legacy))
+        return legacy;
+      const candidates = fsImpl.readdirSync(flowDir).filter((f) => /^快速启动_.+\.md$/.test(f));
+      if (!candidates.length)
+        return null;
+      if (candidates.length === 1)
+        return path_1.default.join(flowDir, candidates[0]);
+      if (fsImpl.statSync) {
+        candidates.sort((a, b) => fsImpl.statSync(path_1.default.join(flowDir, b)).mtimeMs - fsImpl.statSync(path_1.default.join(flowDir, a)).mtimeMs);
+      }
+      return path_1.default.join(flowDir, candidates[0]);
+    }
+    exports2.resolveFlowDirQuickStartPath = resolveFlowDirQuickStartPath;
+    function removeLegacyFlowRootQuickStart2(flowRoot, fsImpl) {
+      const legacy = path_1.default.join(flowRoot, exports2.LEGACY_FLOW_ROOT_QUICKSTART_FILENAME);
+      if (!fsImpl.existsSync(legacy))
         return;
+      try {
+        if (isFlowScaffoldFile(fsImpl.readFileSync(legacy, "utf8"))) {
+          fsImpl.unlinkSync(legacy);
+        }
+      } catch {
       }
-      for (const f of flows) {
-        console.log(`  ${String(f.id).padEnd(8)} ${(f.name ?? "").padEnd(40)} [${f.status ?? "\u2014"}]`);
+    }
+    exports2.removeLegacyFlowRootQuickStart = removeLegacyFlowRootQuickStart2;
+    function resolveFlowRootFromFlowDir2(flowDir) {
+      const flowsDir = path_1.default.dirname(flowDir);
+      if (path_1.default.basename(flowsDir) === "flows") {
+        return path_1.default.dirname(flowsDir);
       }
-      ok({ flows });
-    } catch (err) {
-      handleError(err);
+      if (path_1.default.basename(flowsDir) === "\u6D41\u7A0B") {
+        return flowsDir;
+      }
+      return void 0;
     }
-  });
-  cmd.command("get <flowId>").alias("show").description("\u67E5\u770B Flow \u8BE6\u60C5").option("--json", "\u8F93\u51FA JSON").action(async (flowId, opts) => {
-    try {
-      const flow = await apiRequest(`/api/data-pipelines/v1/flows/${flowId}`);
-      if (opts.json || true) console.log(JSON.stringify(flow, null, 2));
-      ok({ flow });
-    } catch (err) {
-      handleError(err);
+    exports2.resolveFlowRootFromFlowDir = resolveFlowRootFromFlowDir2;
+    function removeLegacyFlowDirScaffoldReadme2(flowDir, fsImpl) {
+      const legacy = path_1.default.join(flowDir, "README.md");
+      if (!fsImpl.existsSync(legacy))
+        return;
+      try {
+        if (isFlowScaffoldFile(fsImpl.readFileSync(legacy, "utf8"))) {
+          fsImpl.unlinkSync(legacy);
+        }
+      } catch {
+      }
     }
-  });
-  cmd.command("create").alias("new").description("\u65B0\u5EFA Flow").requiredOption("--name <name>", "Flow \u540D\u79F0").option("--space <spaceId>", "\u7A7A\u95F4 ID").option("--description <desc>", "\u63CF\u8FF0").option("--file <path>", "\u4ECE\u672C\u5730 JSON \u6587\u4EF6\u8BFB\u53D6\u5B9A\u4E49").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
-    try {
-      let body;
-      if (opts.file) {
-        body = JSON.parse(import_fs2.default.readFileSync(import_path3.default.resolve(opts.file), "utf-8"));
-      } else {
-        body = { name: opts.name, spaceId: opts.space, description: opts.description };
+    exports2.removeLegacyFlowDirScaffoldReadme = removeLegacyFlowDirScaffoldReadme2;
+    function buildFlowProjectReadmeHelpSection() {
+      return [
+        "",
+        "## \u5FEB\u901F\u5165\u95E8",
+        "",
+        "- \u9605\u8BFB\u672C\u76EE\u5F55 [README.md](./README.md)",
+        "- \u6D41\u7A0B\u4E13\u9898\u6587\u6863\uFF1A[\u8D44\u6E90/docs/flow/flows-guide.md](" + flowDocsRel("project-root", "flow/flows-guide.md") + ")",
+        ""
+      ];
+    }
+    exports2.buildFlowProjectReadmeHelpSection = buildFlowProjectReadmeHelpSection;
+    function writeScaffoldIfAllowed2(filePath, content, fsImpl, opts) {
+      if (fsImpl.existsSync(filePath)) {
+        const existing = fsImpl.readFileSync(filePath, "utf8");
+        if (!isFlowScaffoldFile(existing)) {
+          if (!(opts?.upgradeLegacy && isLegacyFlowScaffoldFile(existing)))
+            return false;
+        }
       }
-      const flow = await apiRequest("/api/data-pipelines/v1/flows", { method: "POST", body });
-      if (opts.json) {
-        console.log(JSON.stringify(flow, null, 2));
-      } else {
-        console.log(`\u2705 \u5DF2\u521B\u5EFA Flow: ${flow.id}  ${flow.name}`);
+      fsImpl.writeFileSync(filePath, content, "utf8");
+      return true;
+    }
+    exports2.writeScaffoldIfAllowed = writeScaffoldIfAllowed2;
+  }
+});
+
+// src/shared/flowWorkspaceAudit.js
+var require_flowWorkspaceAudit = __commonJS({
+  "src/shared/flowWorkspaceAudit.js"(exports2) {
+    "use strict";
+    var __importDefault = exports2 && exports2.__importDefault || function(mod) {
+      return mod && mod.__esModule ? mod : { "default": mod };
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.buildFlowConsistencyMarkdown = exports2.repairFlowMeta = exports2.auditFlowWorkspace = void 0;
+    var crypto_1 = __importDefault(require("crypto"));
+    var fs_1 = __importDefault(require("fs"));
+    var path_1 = __importDefault(require("path"));
+    var NODES_DIR3 = "\u8282\u70B9";
+    var FLOW_JSON3 = "flow.json";
+    var FLOW_META_JSON3 = "flow.meta.json";
+    var NODE_INFO_JSON3 = "node.info.json";
+    var NODE_TYPE_CODE_DATA_KEY3 = {
+      "database-source": "sql",
+      "dataspace-source": "sql",
+      "python-script": "pythonCode",
+      "excel-python": "pythonCode",
+      "sql-query": "sql",
+      condition: "pythonCode",
+      "data-quality-check": "dqPythonCode"
+    };
+    function sha13(text) {
+      return crypto_1.default.createHash("sha1").update(text, "utf8").digest("hex");
+    }
+    function resolveNodeType3(node) {
+      if (node.type === "custom") {
+        return String(node.data?.type ?? "custom");
       }
-      ok({ flow });
-    } catch (err) {
-      handleError(err);
+      return String(node.type ?? "custom");
     }
-  });
-  cmd.command("validate <flowId>").description("\u9A8C\u8BC1 Flow \u5B9A\u4E49").option("--file <path>", "\u4ECE\u672C\u5730\u5FEB\u7167\u6587\u4EF6\u9A8C\u8BC1\uFF08\u79BB\u7EBF\uFF09").action(async (flowId, opts) => {
-    try {
-      let result;
-      if (opts.file) {
-        const body = JSON.parse(import_fs2.default.readFileSync(import_path3.default.resolve(opts.file), "utf-8"));
-        result = await apiRequest(`/api/data-pipelines/v1/flows/compile-plan`, { method: "POST", body });
-      } else {
-        result = await apiRequest(`/api/data-pipelines/v1/flows/${flowId}/validate`, { method: "POST" });
+    function codeLanguageForNodeType3(nodeType) {
+      if (["python-script", "excel-python", "condition", "data-quality-check"].includes(nodeType)) {
+        return "python";
       }
-      console.log("\u2705 \u9A8C\u8BC1\u901A\u8FC7");
-      ok({ flowId, result });
-    } catch (err) {
-      handleError(err);
+      if (["database-source", "dataspace-source", "sql-query"].includes(nodeType)) {
+        return "sql";
+      }
+      return void 0;
     }
-  });
-  cmd.command("patch <flowId>").description("\u90E8\u5206\u66F4\u65B0 Flow \u5C5E\u6027").option("--name <name>", "\u65B0\u540D\u79F0").option("--description <desc>", "\u65B0\u63CF\u8FF0").option("--status <status>", "\u65B0\u72B6\u6001").option("--file <path>", "\u4ECE JSON \u6587\u4EF6\u8BFB\u53D6 patch body").action(async (flowId, opts) => {
-    try {
-      let patch;
-      if (opts.file) {
-        patch = JSON.parse(import_fs2.default.readFileSync(import_path3.default.resolve(opts.file), "utf-8"));
-      } else {
-        patch = {};
-        if (opts.name) patch.name = opts.name;
-        if (opts.description) patch.description = opts.description;
-        if (opts.status) patch.status = opts.status;
+    function codeFileExt3(language) {
+      if (language === "python")
+        return "py";
+      if (language === "sql")
+        return "sql";
+      return "txt";
+    }
+    function sanitizeName3(name) {
+      const cleaned = (name || "").replace(/[<>:"/\\|?*\x00-\x1f]/g, "_").trim().replace(/\s+/g, "_");
+      return cleaned || "node";
+    }
+    function readFlowJson3(flowDir) {
+      const raw = JSON.parse(fs_1.default.readFileSync(path_1.default.join(flowDir, FLOW_JSON3), "utf8"));
+      return {
+        nodes: Array.isArray(raw.nodes) ? raw.nodes : [],
+        edges: Array.isArray(raw.edges) ? raw.edges : []
+      };
+    }
+    function readMeta3(flowDir) {
+      const p = path_1.default.join(flowDir, FLOW_META_JSON3);
+      if (!fs_1.default.existsSync(p))
+        return void 0;
+      try {
+        return JSON.parse(fs_1.default.readFileSync(p, "utf8"));
+      } catch {
+        return void 0;
       }
-      const flow = await apiRequest(`/api/data-pipelines/v1/flows/${flowId}`, { method: "PUT", body: patch });
-      console.log(`\u2705 Flow ${flowId} \u5DF2\u66F4\u65B0`);
-      ok({ flow });
-    } catch (err) {
-      handleError(err);
     }
-  });
-  const nodeCmd = new Command("flow-node").description("Flow \u8282\u70B9\u7BA1\u7406");
-  nodeCmd.command("get <flowId> <nodeId>").description("\u67E5\u770B Flow \u8282\u70B9\u8BE6\u60C5").option("--json", "\u8F93\u51FA JSON").action(async (flowId, nodeId, opts) => {
-    try {
-      const node = await apiRequest(`/api/data-pipelines/v1/flows/${flowId}/flow-nodes/${nodeId}`);
-      console.log(JSON.stringify(node, null, 2));
-      ok({ node });
-    } catch (err) {
-      handleError(err);
+    function isCodeNodeType2(nodeType) {
+      return Boolean(NODE_TYPE_CODE_DATA_KEY3[nodeType]);
     }
-  });
-  nodeCmd.command("patch <flowId> <nodeId>").description("\u90E8\u5206\u66F4\u65B0 Flow \u8282\u70B9\u914D\u7F6E").option("--file <path>", "\u4ECE JSON \u6587\u4EF6\u8BFB\u53D6 patch body").option("--config <json>", "config patch JSON \u5B57\u7B26\u4E32").action(async (flowId, nodeId, opts) => {
-    try {
-      let patch;
-      if (opts.file) {
-        patch = JSON.parse(import_fs2.default.readFileSync(import_path3.default.resolve(opts.file), "utf-8"));
-      } else if (opts.config) {
-        patch = { config: JSON.parse(opts.config) };
-      } else {
-        console.error("--file \u6216 --config \u5FC5\u987B\u63D0\u4F9B");
-        process.exit(1);
+    function listNodeDirs2(flowDir) {
+      const nodesRoot = path_1.default.join(flowDir, NODES_DIR3);
+      if (!fs_1.default.existsSync(nodesRoot))
+        return [];
+      return fs_1.default.readdirSync(nodesRoot).filter((n) => {
+        try {
+          return fs_1.default.statSync(path_1.default.join(nodesRoot, n)).isDirectory();
+        } catch {
+          return false;
+        }
+      });
+    }
+    function findCodeFileInDir2(dirAbs) {
+      if (!fs_1.default.existsSync(dirAbs))
+        return void 0;
+      for (const f of fs_1.default.readdirSync(dirAbs)) {
+        if (/^code\.(py|sql|txt)$/i.test(f))
+          return f;
+      }
+      return void 0;
+    }
+    function findDirForUuid2(flowDir, uuid) {
+      const nodesRoot = path_1.default.join(flowDir, NODES_DIR3);
+      for (const dirName of listNodeDirs2(flowDir)) {
+        const infoPath = path_1.default.join(nodesRoot, dirName, NODE_INFO_JSON3);
+        if (fs_1.default.existsSync(infoPath)) {
+          try {
+            const info = JSON.parse(fs_1.default.readFileSync(infoPath, "utf8"));
+            if (String(info.node_uuid ?? "") === uuid)
+              return path_1.default.posix.join(NODES_DIR3, dirName);
+          } catch {
+          }
+        }
       }
-      const node = await apiRequest(
-        `/api/data-pipelines/v1/flows/${flowId}/flow-nodes/${nodeId}`,
-        { method: "PATCH", body: patch }
-      );
-      console.log(`\u2705 \u8282\u70B9 ${nodeId} \u5DF2\u66F4\u65B0`);
-      ok({ node });
-    } catch (err) {
-      handleError(err);
+      return void 0;
     }
-  });
-  cmd.addCommand(nodeCmd);
-  cmd.command("workspace-init <flowId>").description("\u521D\u59CB\u5316 Flow \u672C\u5730\u5DE5\u4F5C\u76EE\u5F55 flows/<flowId>/").action(async (flowId) => {
-    try {
-      const ws = resolveWorkspace();
-      const flowDir = import_path3.default.join(ws.flows, flowId);
-      const dirs = [flowDir, import_path3.default.join(flowDir, "plans"), import_path3.default.join(flowDir, "data")];
-      for (const d of dirs) {
-        if (!import_fs2.default.existsSync(d)) import_fs2.default.mkdirSync(d, { recursive: true });
+    function auditFlowWorkspace3(flowDir) {
+      const warnings = [];
+      const doc = readFlowJson3(flowDir);
+      const meta = readMeta3(flowDir) ?? { nodes: {} };
+      const canvasNodeCount = doc.nodes.length;
+      let canvasCodeNodeCount = 0;
+      const missingInMeta = [];
+      const missingCodeFiles = [];
+      const flowUuids = /* @__PURE__ */ new Set();
+      for (const node of doc.nodes) {
+        const uuid = String(node.node_uuid ?? "").trim();
+        if (!uuid)
+          continue;
+        flowUuids.add(uuid);
+        const nodeType = resolveNodeType3(node);
+        if (!isCodeNodeType2(nodeType))
+          continue;
+        canvasCodeNodeCount++;
+        const label = String(node.data?.label ?? node.id ?? "");
+        const m = meta.nodes[uuid];
+        if (!m?.dir || !m.codeFile) {
+          missingInMeta.push({ uuid, nodeId: String(node.id ?? ""), nodeType, label });
+          continue;
+        }
+        const codePath = path_1.default.join(flowDir, m.dir, m.codeFile);
+        if (!fs_1.default.existsSync(codePath)) {
+          missingCodeFiles.push({ uuid, dir: m.dir, codeFile: m.codeFile });
+        }
       }
-      const metaPath = import_path3.default.join(flowDir, ".dazi-flow.json");
-      if (!import_fs2.default.existsSync(metaPath)) {
-        import_fs2.default.writeFileSync(metaPath, JSON.stringify({ flowId, initializedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2), "utf-8");
+      const orphanInMeta = Object.keys(meta.nodes).filter((u) => !flowUuids.has(u));
+      let metaCodeIndexedCount = 0;
+      for (const m of Object.values(meta.nodes)) {
+        if (m.dir && m.codeFile)
+          metaCodeIndexedCount++;
       }
-      console.log(`\u2705 Flow \u5DE5\u4F5C\u76EE\u5F55\u5DF2\u521D\u59CB\u5316: ${flowDir}`);
-      ok({ flowId, dir: flowDir });
-    } catch (err) {
-      handleError(err);
+      const unindexedDirs = [];
+      for (const dirName of listNodeDirs2(flowDir)) {
+        const dirAbs = path_1.default.join(flowDir, NODES_DIR3, dirName);
+        if (!findCodeFileInDir2(dirAbs))
+          continue;
+        const rel = path_1.default.posix.join(NODES_DIR3, dirName);
+        const indexed = Object.values(meta.nodes).some((m) => m.dir?.replace(/\\/g, "/") === rel);
+        if (!indexed)
+          unindexedDirs.push(rel);
+      }
+      if (canvasCodeNodeCount !== metaCodeIndexedCount) {
+        warnings.push(`\u753B\u5E03\u4EE3\u7801\u8282\u70B9 ${canvasCodeNodeCount} \u4E2A\uFF0Cmeta \u5DF2\u7D22\u5F15 ${metaCodeIndexedCount} \u4E2A\uFF08\u4E0D\u4E00\u81F4\u4F1A\u5BFC\u81F4 node push / \u8BBE\u8BA1\u5668\u6253\u5F00\u4EE3\u7801\u5931\u8D25\uFF09`);
+      }
+      if (missingInMeta.length) {
+        warnings.push("\u90E8\u5206 flow.json \u4EE3\u7801\u8282\u70B9\u672A\u5199\u5165 flow.meta.json\uFF0C\u8BF7\u6267\u884C project repair-meta");
+      }
+      if (unindexedDirs.length) {
+        warnings.push(`\u5B58\u5728\u672A\u7D22\u5F15\u7684\u8282\u70B9\u76EE\u5F55\uFF1A${unindexedDirs.join(", ")}`);
+      }
+      const ok3 = missingInMeta.length === 0 && orphanInMeta.length === 0 && missingCodeFiles.length === 0 && unindexedDirs.length === 0 && canvasCodeNodeCount === metaCodeIndexedCount;
+      return {
+        ok: ok3,
+        canvasNodeCount,
+        canvasCodeNodeCount,
+        metaIndexedCount: Object.keys(meta.nodes).length,
+        metaCodeIndexedCount,
+        missingInMeta,
+        orphanInMeta,
+        missingCodeFiles,
+        unindexedDirs,
+        warnings
+      };
     }
-  });
-  return cmd;
-}
-
-// cli/dazi-flow/src/commands/snapshot.ts
-var import_path6 = __toESM(require("path"), 1);
-var import_fs5 = __toESM(require("fs"), 1);
-
-// cli/dazi-flow/src/lib/flowLocal.ts
-var import_crypto = __toESM(require("crypto"), 1);
-var import_fs3 = __toESM(require("fs"), 1);
-var import_path4 = __toESM(require("path"), 1);
-var NODE_TYPE_CODE_DATA_KEY = {
-  "database-source": "sql",
-  "dataspace-source": "sql",
-  "python-script": "pythonCode",
-  "excel-python": "pythonCode",
-  "sql-query": "sql",
-  condition: "pythonCode",
-  "data-quality-check": "dqPythonCode"
-};
-function codeLanguageForNodeType(nodeType) {
-  if (["python-script", "excel-python", "condition", "data-quality-check"].includes(nodeType)) {
-    return "python";
-  }
-  if (["database-source", "dataspace-source", "sql-query"].includes(nodeType)) {
-    return "sql";
-  }
-  return void 0;
-}
-function codeFileExt(language) {
-  if (language === "python") return "py";
-  if (language === "sql") return "sql";
-  return "txt";
-}
-var NODES_DIR = "\u8282\u70B9";
-var VARIABLES_DIR = "\u53D8\u91CF";
-var RUN_DIR = "_run";
-var FLOW_JSON = "flow.json";
-var FLOW_META_JSON = "flow.meta.json";
-var NODE_INFO_JSON = "node.info.json";
-function resolveNodeType(node) {
-  const nt = node.type;
-  if (nt === "custom") {
-    const data = node.data ?? {};
-    return String(data.type ?? "custom");
-  }
-  return String(nt ?? "custom");
-}
-function sha1(text) {
-  return import_crypto.default.createHash("sha1").update(text, "utf8").digest("hex");
-}
-function sanitizeName(name) {
-  const cleaned = (name || "").replace(/[<>:"/\\|?*\x00-\x1f]/g, "_").trim().replace(/\s+/g, "_");
-  return cleaned || "node";
-}
-function readMeta(flowDir) {
-  const p = import_path4.default.join(flowDir, FLOW_META_JSON);
-  if (!import_fs3.default.existsSync(p)) return void 0;
-  try {
-    return JSON.parse(import_fs3.default.readFileSync(p, "utf8"));
-  } catch {
-    return void 0;
-  }
-}
-function writeMeta(flowDir, meta) {
-  import_fs3.default.writeFileSync(import_path4.default.join(flowDir, FLOW_META_JSON), JSON.stringify(meta, null, 2), "utf8");
-}
-function extractDocument(snapshot) {
-  const doc = snapshot.document ?? snapshot;
-  const nodes = Array.isArray(doc.nodes) ? doc.nodes : [];
-  const edges = Array.isArray(doc.edges) ? doc.edges : [];
-  return { nodes, edges };
-}
-function splitDocumentToFiles(flowDir, doc) {
-  const nodesDir = import_path4.default.join(flowDir, NODES_DIR);
-  const strippedNodes = [];
-  const nodeMetas = {};
-  const usedDirNames = /* @__PURE__ */ new Set();
-  for (const node of doc.nodes) {
-    if (!node || typeof node !== "object") continue;
-    const nodeUuid = String(node.node_uuid ?? "").trim();
-    const nodeType = resolveNodeType(node);
-    const semanticId = String(node.id ?? "");
-    const codeKey = NODE_TYPE_CODE_DATA_KEY[nodeType];
-    const stripped = JSON.parse(JSON.stringify(node));
-    const meta = { nodeId: semanticId, nodeType };
-    if (codeKey && nodeUuid) {
-      const data = stripped.data ?? {};
-      const rawCode = data[codeKey];
-      const codeBody = typeof rawCode === "string" ? rawCode : rawCode != null ? JSON.stringify(rawCode) : "";
-      delete data[codeKey];
-      stripped.data = data;
-      const language = codeLanguageForNodeType(nodeType);
-      const ext = codeFileExt(language);
-      const label = String(node.data?.label ?? "") || semanticId || nodeType;
-      let dirName = sanitizeName(label);
-      if (usedDirNames.has(dirName)) {
-        dirName = `${dirName}_${nodeUuid.slice(0, 6)}`;
-      }
-      usedDirNames.add(dirName);
-      const nodeDirAbs = import_path4.default.join(nodesDir, dirName);
-      import_fs3.default.mkdirSync(nodeDirAbs, { recursive: true });
-      const codeFile = `code.${ext}`;
-      import_fs3.default.writeFileSync(import_path4.default.join(nodeDirAbs, codeFile), codeBody, "utf8");
-      import_fs3.default.writeFileSync(
-        import_path4.default.join(nodeDirAbs, NODE_INFO_JSON),
-        JSON.stringify(
-          {
-            _readonly: "\u6B64\u6587\u4EF6\u7531 dazi-flow \u751F\u6210\uFF0C\u4EC5\u4F9B\u67E5\u770B\uFF1B\u7F16\u8F91\u4EE3\u7801\u8BF7\u6539 " + codeFile + "\uFF0C\u914D\u7F6E\u6539 flow.json",
-            node_uuid: nodeUuid,
-            nodeId: semanticId,
-            nodeType,
-            label,
-            codeFile,
-            codeLanguage: language,
-            position: node.position,
-            data: stripped.data
-          },
-          null,
-          2
-        ),
-        "utf8"
-      );
-      meta.dir = import_path4.default.posix.join(NODES_DIR, dirName);
-      meta.codeFile = codeFile;
-      meta.codeLanguage = language;
-      meta.codeHash = sha1(codeBody);
+    exports2.auditFlowWorkspace = auditFlowWorkspace3;
+    function writeNodeInfo2(flowDir, node, uuid, nodeType, relDir, codeFile, language, strippedData) {
+      const abs = path_1.default.join(flowDir, relDir);
+      fs_1.default.writeFileSync(path_1.default.join(abs, NODE_INFO_JSON3), JSON.stringify({
+        _readonly: `\u6B64\u6587\u4EF6\u7531 dazi-flow \u751F\u6210\uFF0C\u4EC5\u4F9B\u67E5\u770B\uFF1B\u7F16\u8F91\u4EE3\u7801\u8BF7\u6539 ${codeFile}\uFF0C\u914D\u7F6E\u6539 flow.json`,
+        node_uuid: uuid,
+        nodeId: String(node.id ?? ""),
+        nodeType,
+        label: String(node.data?.label ?? ""),
+        codeFile,
+        codeLanguage: language,
+        position: node.position,
+        data: strippedData
+      }, null, 2), "utf8");
+    }
+    function repairFlowMeta3(flowDir) {
+      const warnings = [];
+      const repairedUuids = [];
+      const wroteNodeInfo = [];
+      const doc = readFlowJson3(flowDir);
+      const meta = readMeta3(flowDir) ?? { flowId: null, flowName: path_1.default.basename(flowDir), nodes: {} };
+      if (!meta.nodes)
+        meta.nodes = {};
+      const usedDirNames = new Set(Object.values(meta.nodes).map((m) => m.dir?.split("/").pop()).filter(Boolean));
+      for (const node of doc.nodes) {
+        const uuid = String(node.node_uuid ?? "").trim();
+        if (!uuid)
+          continue;
+        const nodeType = resolveNodeType3(node);
+        const codeKey = NODE_TYPE_CODE_DATA_KEY3[nodeType];
+        const semanticId = String(node.id ?? "");
+        const label = String(node.data?.label ?? semanticId ?? nodeType);
+        let entry = meta.nodes[uuid];
+        if (!entry) {
+          entry = { nodeId: semanticId, nodeType };
+          meta.nodes[uuid] = entry;
+          repairedUuids.push(uuid);
+        } else {
+          entry.nodeId = semanticId || entry.nodeId;
+          entry.nodeType = nodeType;
+        }
+        if (!codeKey)
+          continue;
+        let relDir = entry.dir?.replace(/\\/g, "/");
+        if (relDir && findCodeFileInDir2(path_1.default.join(flowDir, relDir))) {
+        } else {
+          relDir = findDirForUuid2(flowDir, uuid);
+        }
+        if (!relDir) {
+          const byLabel = path_1.default.posix.join(NODES_DIR3, sanitizeName3(label));
+          if (fs_1.default.existsSync(path_1.default.join(flowDir, byLabel)) && findCodeFileInDir2(path_1.default.join(flowDir, byLabel))) {
+            relDir = byLabel;
+          }
+        }
+        if (!relDir) {
+          let dirName = sanitizeName3(label);
+          if (usedDirNames.has(dirName))
+            dirName = `${dirName}_${uuid.slice(0, 6)}`;
+          usedDirNames.add(dirName);
+          relDir = path_1.default.posix.join(NODES_DIR3, dirName);
+          fs_1.default.mkdirSync(path_1.default.join(flowDir, relDir), { recursive: true });
+          const lang = codeLanguageForNodeType3(nodeType);
+          const codeFile2 = `code.${codeFileExt3(lang)}`;
+          const template = nodeType === "excel-python" ? "# -*- coding: utf-8 -*-\n# Excel \u8282\u70B9\uFF1A\u753B\u5E03\u914D\u7F6E managed_file_id\uFF1B\u4EE3\u7801\u4F7F\u7528 excel_source_path\n" : lang === "sql" ? "-- \u8282\u70B9 SQL\nSELECT 1;\n" : "# -*- coding: utf-8 -*-\n";
+          if (!findCodeFileInDir2(path_1.default.join(flowDir, relDir))) {
+            fs_1.default.writeFileSync(path_1.default.join(flowDir, relDir, codeFile2), template, "utf8");
+            warnings.push(`\u5DF2\u4E3A ${uuid} \u521B\u5EFA\u7A7A\u4EE3\u7801\u6A21\u677F ${relDir}/${codeFile2}`);
+          }
+        }
+        const dirAbs = path_1.default.join(flowDir, relDir);
+        const codeFile = findCodeFileInDir2(dirAbs);
+        if (!codeFile) {
+          warnings.push(`\u8282\u70B9 ${uuid} \u76EE\u5F55 ${relDir} \u65E0 code.*\uFF0C\u8DF3\u8FC7\u4EE3\u7801\u7D22\u5F15`);
+          continue;
+        }
+        const language = codeLanguageForNodeType3(nodeType);
+        const code = fs_1.default.readFileSync(path_1.default.join(dirAbs, codeFile), "utf8");
+        entry.dir = relDir;
+        entry.codeFile = codeFile;
+        entry.codeLanguage = language;
+        entry.codeHash = sha13(code);
+        const strippedData = { ...node.data ?? {} };
+        delete strippedData[codeKey];
+        const infoPath = path_1.default.join(dirAbs, NODE_INFO_JSON3);
+        if (!fs_1.default.existsSync(infoPath)) {
+          writeNodeInfo2(flowDir, node, uuid, nodeType, relDir, codeFile, language, strippedData);
+          wroteNodeInfo.push(relDir);
+        }
+        if (!repairedUuids.includes(uuid))
+          repairedUuids.push(uuid);
+      }
+      meta.graphFingerprint = "sha1:" + sha13(JSON.stringify({ nodes: doc.nodes, edges: doc.edges }));
+      fs_1.default.writeFileSync(path_1.default.join(flowDir, FLOW_META_JSON3), JSON.stringify(meta, null, 2), "utf8");
+      const okAfter = auditFlowWorkspace3(flowDir).ok;
+      return {
+        ok: okAfter,
+        repairedUuids: [...new Set(repairedUuids)],
+        wroteNodeInfo,
+        warnings
+      };
     }
-    if (nodeUuid) {
-      nodeMetas[nodeUuid] = meta;
+    exports2.repairFlowMeta = repairFlowMeta3;
+    function buildFlowConsistencyMarkdown2(audit, localFilesSpecLink = "../../\u8D44\u6E90/docs/flow/local-files-spec.md") {
+      const lines = [
+        "## \u672C\u5730\u6587\u4EF6\u4E00\u81F4\u6027",
+        "",
+        "| \u6307\u6807 | \u6570\u91CF |",
+        "|------|------|",
+        `| \u753B\u5E03\u8282\u70B9\uFF08flow.json\uFF09 | ${audit.canvasNodeCount} |`,
+        `| \u753B\u5E03\u4EE3\u7801\u8282\u70B9\uFF08flow.json\uFF09 | ${audit.canvasCodeNodeCount} |`,
+        `| meta \u5DF2\u767B\u8BB0\u8282\u70B9 | ${audit.metaIndexedCount} |`,
+        `| meta \u5DF2\u7D22\u5F15\u4EE3\u7801\uFF08dir+codeFile\uFF09 | ${audit.metaCodeIndexedCount} |`,
+        ""
+      ];
+      if (audit.ok) {
+        lines.push("\u2705 **flow.json / flow.meta.json / \u8282\u70B9/ \u4E00\u81F4**\u3002\u8BBE\u8BA1\u5668\u53EF\u6B63\u5E38\u300C\u6253\u5F00\u4EE3\u7801\u300D\uFF0C`node push` \u53EF\u8BC6\u522B\u810F\u8282\u70B9\u3002", "");
+      } else {
+        lines.push("\u26A0\uFE0F **\u76EE\u5F55\u4E0D\u4E00\u81F4**\uFF08\u4F1A\u5BFC\u81F4\u8BBE\u8BA1\u5668\u627E\u4E0D\u5230\u4EE3\u7801\u3001\u6216 `node push` \u8DF3\u8FC7\uFF09\uFF1A", "");
+        if (audit.missingInMeta.length) {
+          lines.push("| uuid | \u8282\u70B9 | \u7C7B\u578B |");
+          lines.push("|------|------|------|");
+          for (const m of audit.missingInMeta) {
+            lines.push(`| \`${m.uuid.slice(0, 8)}\u2026\` | ${m.label || m.nodeId} | ${m.nodeType} |`);
+          }
+          lines.push("");
+        }
+        if (audit.unindexedDirs.length) {
+          lines.push(`- \u672A\u7D22\u5F15\u76EE\u5F55\uFF1A${audit.unindexedDirs.map((d) => `\`${d}\``).join(" ")}`);
+        }
+        if (audit.orphanInMeta.length) {
+          lines.push(`- meta \u591A\u4F59 uuid\uFF1A${audit.orphanInMeta.length} \u4E2A\uFF08flow.json \u4E2D\u5DF2\u4E0D\u5B58\u5728\uFF09`);
+        }
+        for (const w of audit.warnings)
+          lines.push(`- ${w}`);
+        lines.push("", "\u4FEE\u590D\uFF08\u5728\u6D41\u7A0B\u76EE\u5F55\uFF09\uFF1A", "", "```powershell", "dazi flow project repair-meta --dir .", "dazi flow project doctor --dir .", "```", "", `\u8BE6\u89C1 [\u6D41\u7A0B\u672C\u5730\u6587\u4EF6\u89C4\u8303](${localFilesSpecLink})\u3002`, "");
+      }
+      lines.push("## \u53D8\u66F4\u63D0\u4EA4\u547D\u4EE4\u77E9\u9635", "", "| \u6539\u4E86\u4EC0\u4E48 | \u547D\u4EE4 |", "|----------|------|", "| `managed_file_id`\u3001`output_variable_name`\u3001\u8FDE\u7EBF\u3001\u589E\u5220\u8282\u70B9 | `dazi flow project push --dir . --canvas` |", "| `\u8282\u70B9/<\u540D>/code.py` \u6216 `code.sql` | `dazi flow node push --node <uuid> --dir .` |", '| **\u65B0\u589E\u4EE3\u7801\u8282\u70B9** | `dazi flow node new --type <type> --dir . --label "<\u540D>"` \u2192 \u6539\u914D\u7F6E \u2192 `push --canvas` \u2192 \u5199 code \u2192 `node push` |', "", "> \u7981\u6B62\u53EA\u6539 `flow.json` \u800C\u4E0D\u66F4\u65B0 `flow.meta.json`\uFF08\u987B `node new` / `pull` / `repair-meta`\uFF09\u3002", "");
+      return lines;
     }
-    strippedNodes.push(stripped);
+    exports2.buildFlowConsistencyMarkdown = buildFlowConsistencyMarkdown2;
   }
-  const strippedDoc = { nodes: strippedNodes, edges: doc.edges };
-  import_fs3.default.writeFileSync(import_path4.default.join(flowDir, FLOW_JSON), JSON.stringify(strippedDoc, null, 2), "utf8");
-  return { strippedDoc, nodeMetas };
-}
-function fingerprintDoc(doc) {
-  return "sha1:" + sha1(JSON.stringify({ nodes: doc.nodes, edges: doc.edges }));
-}
-function readFlowJson(flowDir) {
-  const p = import_path4.default.join(flowDir, FLOW_JSON);
-  const raw = JSON.parse(import_fs3.default.readFileSync(p, "utf8"));
-  return {
-    nodes: Array.isArray(raw.nodes) ? raw.nodes : [],
-    edges: Array.isArray(raw.edges) ? raw.edges : []
-  };
-}
-function readNodeCode(flowDir, meta) {
-  if (!meta.dir || !meta.codeFile) return void 0;
-  const p = import_path4.default.join(flowDir, meta.dir, meta.codeFile);
-  if (!import_fs3.default.existsSync(p)) return void 0;
-  return import_fs3.default.readFileSync(p, "utf8");
-}
-function assembleFullDocument(flowDir, meta) {
-  const doc = readFlowJson(flowDir);
-  for (const node of doc.nodes) {
-    const uuid = String(node.node_uuid ?? "");
-    const nodeMeta = meta.nodes[uuid];
-    if (!nodeMeta) continue;
-    const codeKey = NODE_TYPE_CODE_DATA_KEY[nodeMeta.nodeType];
-    if (!codeKey) continue;
-    const code = readNodeCode(flowDir, nodeMeta);
-    if (code != null) {
-      node.data = { ...node.data ?? {}, [codeKey]: code };
+});
+
+// src/shared/flowDirResolve.js
+var require_flowDirResolve = __commonJS({
+  "src/shared/flowDirResolve.js"(exports2) {
+    "use strict";
+    var __importDefault = exports2 && exports2.__importDefault || function(mod) {
+      return mod && mod.__esModule ? mod : { "default": mod };
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.resolveFlowDir = exports2.resolveFlowDirForCli = exports2.findFlowDirForPath = exports2.inferBusinessProjectFolder = exports2.FLOW_META_JSON = exports2.FLOW_JSON = void 0;
+    var fs_1 = __importDefault(require("fs"));
+    var path_1 = __importDefault(require("path"));
+    exports2.FLOW_JSON = "flow.json";
+    exports2.FLOW_META_JSON = "flow.meta.json";
+    function inferBusinessProjectFolder2(flowDir) {
+      const norm = path_1.default.resolve(flowDir).replace(/\\/g, "/");
+      let m = norm.match(/(?:^|\/)项目\/([^/]+)\/流程\/flows\/[^/]+(?:\/|$)/);
+      if (m)
+        return m[1];
+      m = norm.match(/(?:^|\/)项目\/([^/]+)\/流程\/([^/]+)(?:\/|$)/);
+      if (m && m[2] !== "flows" && m[2] !== "\u89C4\u5212")
+        return m[1];
+      m = norm.match(/(?:^|\/)项目\/(flow_[^/]+)\/流程(?:\/|$)/);
+      if (m)
+        return m[1];
+      return void 0;
     }
-  }
-  return doc;
-}
-function listDirtyCodeNodes(flowDir, meta) {
-  const dirty = [];
-  for (const [uuid, nodeMeta] of Object.entries(meta.nodes)) {
-    if (!nodeMeta.codeFile) continue;
-    const code = readNodeCode(flowDir, nodeMeta);
-    if (code == null) continue;
-    if (sha1(code) !== (nodeMeta.codeHash ?? "")) {
-      dirty.push(uuid);
+    exports2.inferBusinessProjectFolder = inferBusinessProjectFolder2;
+    function findFlowDirForPath(target) {
+      let cur = path_1.default.resolve(target);
+      if (fs_1.default.existsSync(cur)) {
+        try {
+          if (fs_1.default.statSync(cur).isFile())
+            cur = path_1.default.dirname(cur);
+        } catch {
+          return void 0;
+        }
+      }
+      for (let i = 0; i < 8 && cur; i++) {
+        if (fs_1.default.existsSync(path_1.default.join(cur, exports2.FLOW_JSON)))
+          return cur;
+        const parent = path_1.default.dirname(cur);
+        if (parent === cur)
+          break;
+        cur = parent;
+      }
+      return void 0;
+    }
+    exports2.findFlowDirForPath = findFlowDirForPath;
+    function isWorkspaceRootCandidate(dir) {
+      return fs_1.default.existsSync(path_1.default.join(dir, "\u9879\u76EE")) || fs_1.default.existsSync(path_1.default.join(dir, "scripts", "dazi.ps1"));
     }
+    function resolveFlowDirForCli(dir) {
+      const requested = path_1.default.resolve(dir ?? process.cwd());
+      const warnings = [];
+      if (fs_1.default.existsSync(path_1.default.join(requested, exports2.FLOW_JSON))) {
+        return { flowDir: requested, resolvedFromParent: false, warnings };
+      }
+      const found = findFlowDirForPath(requested);
+      if (found) {
+        if (found !== requested) {
+          warnings.push(`--dir \u672A\u76F4\u63A5\u6307\u5411\u6D41\u7A0B\u76EE\u5F55\uFF0C\u5DF2\u5411\u4E0A\u89E3\u6790\u4E3A: ${found}`);
+        }
+        return { flowDir: found, resolvedFromParent: found !== requested, warnings };
+      }
+      const hasMetaOnly = fs_1.default.existsSync(path_1.default.join(requested, exports2.FLOW_META_JSON)) && !fs_1.default.existsSync(path_1.default.join(requested, exports2.FLOW_JSON));
+      if (hasMetaOnly || isWorkspaceRootCandidate(requested) && !fs_1.default.existsSync(path_1.default.join(requested, exports2.FLOW_JSON))) {
+        return {
+          flowDir: requested,
+          resolvedFromParent: false,
+          warnings,
+          error: "\u5F53\u524D\u76EE\u5F55\u4E0D\u662F\u6D41\u7A0B\u76EE\u5F55\uFF08\u7F3A\u5C11 flow.json\uFF09\u3002\u8BF7\u4F7F\u7528 --dir \u6307\u5411 \u9879\u76EE/<\u4E1A\u52A1\u540D>/\u6D41\u7A0B/flows/<\u6D41\u7A0B\u540D> \u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF1B\u7981\u6B62\u5728 dazi-work \u5DE5\u4F5C\u533A\u6839\u6267\u884C project status/push/pull --dir ."
+        };
+      }
+      return {
+        flowDir: requested,
+        resolvedFromParent: false,
+        warnings,
+        error: `\u76EE\u5F55\u7F3A\u5C11 flow.json: ${requested}\u3002\u8BF7 --dir \u6307\u5411\u542B flow.json \u7684\u6D41\u7A0B\u76EE\u5F55\uFF08\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09\u3002`
+      };
+    }
+    exports2.resolveFlowDirForCli = resolveFlowDirForCli;
+    function resolveFlowDir5(dir, opts) {
+      const result = resolveFlowDirForCli(dir);
+      if (!opts?.json) {
+        for (const w of result.warnings)
+          console.warn(`\u26A0\uFE0F  ${w}`);
+      }
+      if (result.error) {
+        console.error(`\u9519\u8BEF: ${result.error}`);
+        process.exit(1);
+      }
+      return result.flowDir;
+    }
+    exports2.resolveFlowDir = resolveFlowDir5;
   }
-  return dirty;
-}
+});
 
-// cli/dazi-flow/src/lib/flowApi.ts
-var import_path5 = __toESM(require("path"), 1);
-var import_fs4 = __toESM(require("fs"), 1);
-var FLOW_API = "/api/data-pipelines/v1/flows";
-async function pushCodeNode(flowId, flowDir, meta, uuid, opts = {}) {
-  const nodeMeta = meta.nodes[uuid];
-  if (!nodeMeta) return { uuid, status: "skipped" };
-  const localCode = readNodeCode(flowDir, nodeMeta);
-  if (localCode == null) return { uuid, status: "skipped" };
-  const nodeLabel = nodeMeta.nodeId || uuid;
-  const remote = await apiRequest(`${FLOW_API}/${flowId}/flow-nodes/${uuid}`, {
-    label: `\u8BFB\u53D6\u8FDC\u7AEF\u8282\u70B9\u4EE3\u7801 (nodeId=${nodeLabel}, uuid=${uuid})`
-  });
-  const remoteHash = sha1(remote.code_body ?? "");
-  const baseHash = nodeMeta.codeHash ?? "";
-  if (!opts.force && baseHash && remoteHash !== baseHash) {
-    return { uuid, status: "conflict", version: remote.version };
-  }
-  if (opts.dryRun) return { uuid, status: "dry-run", version: remote.version };
-  const updated = await apiRequest(`${FLOW_API}/${flowId}/flow-nodes/${uuid}`, {
-    method: "PATCH",
-    body: { code_body: localCode, expected_version: opts.force ? void 0 : remote.version },
-    label: `\u63D0\u4EA4\u8282\u70B9\u4EE3\u7801 (nodeId=${nodeLabel}, uuid=${uuid})`
-  });
-  nodeMeta.codeHash = sha1(localCode);
-  nodeMeta.codeVersion = updated.version;
-  return { uuid, status: "pushed", version: updated.version };
-}
-async function pullCodeNode(flowId, flowDir, meta, uuid) {
-  const nodeMeta = meta.nodes[uuid];
-  if (!nodeMeta?.dir || !nodeMeta.codeFile) {
-    throw new Error(`\u8282\u70B9 ${uuid} \u4E0D\u662F\u4EE3\u7801\u8282\u70B9\u6216\u7F3A\u5C11\u672C\u5730\u6620\u5C04`);
+// src/shared/managedFilesTypes.js
+var require_managedFilesTypes = __commonJS({
+  "src/shared/managedFilesTypes.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.MANAGED_BUNDLE_FILES = exports2.MANAGED_FS_API = exports2.MANAGED_FILES_API = void 0;
+    exports2.MANAGED_FILES_API = "/api/data-pipelines/v1/managed-files";
+    exports2.MANAGED_FS_API = "/api/data-pipelines/v1/managed-fs";
+    exports2.MANAGED_BUNDLE_FILES = {
+      manifest: "\u6587\u4EF6\u4FE1\u606F.json",
+      originalPrefix: "\u539F\u6587\u4EF6",
+      nativeDigest: "\u539F\u751F\u89E3\u6790.md",
+      aiStructure: "\u8868\u7ED3\u6784.json",
+      reportLayout: "\u62A5\u8868\u5E03\u5C40.json"
+    };
   }
-  const remote = await apiRequest(`${FLOW_API}/${flowId}/flow-nodes/${uuid}`, {
-    label: `\u62C9\u53D6\u8282\u70B9\u4EE3\u7801 (uuid=${uuid})`
-  });
-  const code = remote.code_body ?? "";
-  const target = import_path5.default.join(flowDir, nodeMeta.dir, nodeMeta.codeFile);
-  import_fs4.default.mkdirSync(import_path5.default.dirname(target), { recursive: true });
-  import_fs4.default.writeFileSync(target, code, "utf8");
-  nodeMeta.codeHash = sha1(code);
-  nodeMeta.codeVersion = remote.version;
-  return { uuid, version: remote.version };
-}
-async function pushCanvasDocument(flowId, document) {
-  const nodeCount = document.nodes?.length ?? 0;
-  const edgeCount = document.edges?.length ?? 0;
-  await apiRequest(`${FLOW_API}/${flowId}`, {
-    method: "PUT",
-    body: { data: document },
-    label: `\u63D0\u4EA4\u753B\u5E03 flow.json (flowId=${flowId}, nodes=${nodeCount}, edges=${edgeCount})`
-  });
-}
+});
 
-// cli/dazi-flow/src/commands/snapshot.ts
-function makeSnapshotCommand() {
-  const cmd = new Command("snapshot").description("Flow \u5FEB\u7167\u7BA1\u7406");
-  cmd.command("pull").description("\u4ECE\u5E73\u53F0\u62C9\u53D6 Flow \u5FEB\u7167\u5230\u672C\u5730 flows/<flowId>/").requiredOption("--flow <flowId>", "Flow ID\uFF08\u77ED\u9009\u9879 -f\uFF09").alias("-f").option("--out <dir>", "\u8F93\u51FA\u76EE\u5F55\uFF08\u9ED8\u8BA4 flows/<flowId>/\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
-    try {
-      console.log(`\u6B63\u5728\u62C9\u53D6\u5FEB\u7167: ${opts.flow} ...`);
-      const snapshot = await apiRequest(
-        `/api/data-pipelines/v1/flows/${opts.flow}/snapshot`
-      );
-      const ws = resolveWorkspace();
-      const outDir = opts.out ?? import_path6.default.join(ws.flows, opts.flow);
-      if (!import_fs5.default.existsSync(outDir)) import_fs5.default.mkdirSync(outDir, { recursive: true });
-      const outFile = import_path6.default.join(outDir, "snapshot.json");
-      import_fs5.default.writeFileSync(outFile, JSON.stringify(snapshot, null, 2), "utf-8");
-      if (opts.json) {
-        console.log(JSON.stringify(snapshot, null, 2));
-      } else {
-        console.log(`\u2705 \u5FEB\u7167\u5DF2\u4FDD\u5B58: ${outFile}`);
+// src/shared/managedFilesBundle.js
+var require_managedFilesBundle = __commonJS({
+  "src/shared/managedFilesBundle.js"(exports2) {
+    "use strict";
+    var __importDefault = exports2 && exports2.__importDefault || function(mod) {
+      return mod && mod.__esModule ? mod : { "default": mod };
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.findManagedFileInBrowse = exports2.pullManagedFileBundle = exports2.isExcelManagedFile = exports2.describeManagedFileLocalState = exports2.isManagedFilePulledLocally = exports2.managedFileLocalDir = exports2.managedFileLocalFolderName = void 0;
+    var fs_1 = __importDefault(require("fs"));
+    var path_1 = __importDefault(require("path"));
+    var managedFilesTypes_js_1 = require_managedFilesTypes();
+    function apiBase(auth) {
+      return auth.serverUrl.replace(/\/$/, "");
+    }
+    function sanitizeDirPart(raw) {
+      return raw.trim().replace(/\s+/g, "_").replace(/[<>:"|?*/\\]/g, "_").slice(0, 80) || "file";
+    }
+    function managedFileLocalFolderName(meta) {
+      const base = sanitizeDirPart(meta.display_name ?? meta.file_id);
+      const shortId = meta.file_id.slice(0, 8);
+      return `${base}_${shortId}`;
+    }
+    exports2.managedFileLocalFolderName = managedFileLocalFolderName;
+    function managedFileLocalDir(filesRoot, meta) {
+      return path_1.default.join(filesRoot, managedFileLocalFolderName(meta));
+    }
+    exports2.managedFileLocalDir = managedFileLocalDir;
+    function isManagedFilePulledLocally(filesRoot, meta) {
+      return fs_1.default.existsSync(path_1.default.join(managedFileLocalDir(filesRoot, meta), managedFilesTypes_js_1.MANAGED_BUNDLE_FILES.manifest));
+    }
+    exports2.isManagedFilePulledLocally = isManagedFilePulledLocally;
+    function describeManagedFileLocalState(wsRoot, meta, filesSubdir = "files") {
+      if (!wsRoot || !meta.file_id)
+        return void 0;
+      const filesRoot = path_1.default.join(wsRoot, "\u8D44\u6E90", filesSubdir);
+      if (isManagedFilePulledLocally(filesRoot, meta))
+        return "\u5DF2\u62C9\u53D6";
+      return void 0;
+    }
+    exports2.describeManagedFileLocalState = describeManagedFileLocalState;
+    function isExcelManagedFile(meta) {
+      const ext = (meta.file_ext ?? path_1.default.extname(meta.display_name ?? "")).toLowerCase();
+      if (ext === ".xlsx" || ext === ".xls")
+        return true;
+      const mime = (meta.mime_type ?? "").toLowerCase();
+      return mime.includes("spreadsheet") || mime.endsWith(".sheet");
+    }
+    exports2.isExcelManagedFile = isExcelManagedFile;
+    async function fetchJson(auth, urlPath, method = "GET") {
+      const res = await fetch(`${apiBase(auth)}${urlPath}`, {
+        method,
+        headers: {
+          Authorization: `Bearer ${auth.token}`,
+          Accept: "application/json",
+          ...method === "POST" ? { "Content-Type": "application/json" } : {}
+        }
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`HTTP ${res.status}: ${text || res.statusText}`);
       }
-      ok({ flowId: opts.flow, file: outFile });
-    } catch (err) {
-      handleError(err);
+      return res.json();
     }
-  });
-  cmd.command("push-graph").description("\u5C06\u672C\u5730 flows/<flowId>/snapshot.json \u56FE\u7ED3\u6784\u63A8\u9001\u5230\u5E73\u53F0").requiredOption("--flow <flowId>", "Flow ID").option("--dir <dir>", "\u5FEB\u7167\u76EE\u5F55\uFF08\u9ED8\u8BA4 flows/<flowId>/\uFF09").option("--dry-run", "\u4EC5\u9A8C\u8BC1\uFF0C\u4E0D\u63A8\u9001").action(async (opts) => {
-    try {
-      const ws = resolveWorkspace();
-      const dir = opts.dir ?? import_path6.default.join(ws.flows, opts.flow);
-      const file = import_path6.default.join(dir, "snapshot.json");
-      if (!import_fs5.default.existsSync(file)) {
-        console.error(`\u9519\u8BEF: \u627E\u4E0D\u5230 ${file}\uFF0C\u8BF7\u5148\u8FD0\u884C snapshot pull`);
-        process.exit(1);
+    async function downloadBinary(auth, urlPath, destPath) {
+      const res = await fetch(`${apiBase(auth)}${urlPath}`, {
+        headers: { Authorization: `Bearer ${auth.token}` }
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`\u4E0B\u8F7D\u5931\u8D25 HTTP ${res.status}: ${text || res.statusText}`);
       }
-      const snapshot = JSON.parse(import_fs5.default.readFileSync(file, "utf-8"));
-      if (opts.dryRun) {
-        console.log("[dry-run] \u5C06\u63A8\u9001\u56FE\u5FEB\u7167:");
-        console.log(`  \u8282\u70B9\u6570: ${snapshot.nodes?.length ?? "?"}`);
-        console.log(`  \u8FB9\u6570:   ${snapshot.edges?.length ?? "?"}`);
-        ok({ flowId: opts.flow, dryRun: true });
-        return;
+      const buf = Buffer.from(await res.arrayBuffer());
+      fs_1.default.mkdirSync(path_1.default.dirname(destPath), { recursive: true });
+      fs_1.default.writeFileSync(destPath, buf);
+    }
+    async function resolveNativeDigest(auth, fileId, parseIfMissing) {
+      if (!parseIfMissing) {
+        try {
+          return await fetchJson(auth, `${managedFilesTypes_js_1.MANAGED_FILES_API}/${encodeURIComponent(fileId)}/excel-native-digest`);
+        } catch {
+          return null;
+        }
+      }
+      try {
+        let resp = await fetchJson(auth, `${managedFilesTypes_js_1.MANAGED_FILES_API}/${encodeURIComponent(fileId)}/excel-native-digest`);
+        if (resp.markdown)
+          return resp;
+      } catch {
+      }
+      try {
+        return await fetchJson(auth, `${managedFilesTypes_js_1.MANAGED_FILES_API}/${encodeURIComponent(fileId)}/excel-native-parse`, "POST");
+      } catch {
+        return null;
       }
-      const doc = extractDocument(snapshot);
-      await pushCanvasDocument(opts.flow, doc);
-      console.log(`\u2705 \u56FE\u5FEB\u7167\u5DF2\u63A8\u9001`);
-      ok({ flowId: opts.flow, nodeCount: doc.nodes.length, edgeCount: doc.edges.length });
-    } catch (err) {
-      handleError(err);
     }
-  });
-  return cmd;
-}
-
-// cli/dazi-flow/src/commands/project.ts
-var import_path10 = __toESM(require("path"), 1);
-var import_fs8 = __toESM(require("fs"), 1);
-
-// src/shared/flowScaffoldDocs.ts
-var import_path8 = __toESM(require("path"));
-
-// src/shared/flowNodeCatalog.ts
-var FLOW_NODE_CATALOG = [
-  {
-    group: "\u6D41\u7A0B\u63A7\u5236",
-    items: [
-      {
-        type: "condition",
-        label: "\u6761\u4EF6\u5224\u65AD",
-        hasCode: true,
-        codeFile: "code.py",
-        summary: "\u5BF9\u4E0A\u6E38\u8868\u6C42\u5E03\u5C14\u8868\u8FBE\u5F0F\uFF0C\u8D70 True/False \u5206\u652F",
-        consumes: "\u5165\u8FB9\u4E0A\u6E38\u8868 \u2192 \u8FD0\u884C\u65F6\u6CE8\u5165 `df`",
-        produces: "\u65E0\u65B0\u8868\u53D8\u91CF\uFF08\u4EC5\u8DEF\u7531\uFF09",
-        keyConfig: ["label", "pythonCode\uFF08\u4EE3\u7801\u5728 code.py\uFF09"]
-      },
-      {
-        type: "delay",
-        label: "\u5EF6\u65F6\u7B49\u5F85",
-        hasCode: false,
-        summary: "\u6682\u505C\u6307\u5B9A\u79D2\u6570\u540E\u7EE7\u7EED\u4E0B\u6E38",
-        keyConfig: ["delaySeconds \u6216 delay\uFF08\u79D2\uFF09"]
-      }
-    ]
-  },
-  {
-    group: "\u6570\u636E\u5904\u7406",
-    items: [
-      {
-        type: "file-source",
-        label: "\u6587\u4EF6\u8F93\u5165",
-        hasCode: false,
-        summary: "\u975E Excel \u539F\u59CB\u6587\u4EF6\u900F\u4F20\uFF08.xlsx/.xls \u52FF\u7528\uFF0C\u6539 excel-python\uFF09",
-        produces: "`output_variable_name`",
-        keyConfig: ["file_id / managed_file_id", "output_variable_name"]
-      },
-      {
-        type: "excel-import",
-        label: "Excel \u5BFC\u5165",
-        hasCode: false,
-        summary: "\u4EC5\u6781\u7B80\u5355\u5355 Sheet \u96F6\u4EE3\u7801\uFF1B\u6709 file_id \u7684 Excel \u9ED8\u8BA4\u4ECD\u7528 excel-python",
-        produces: "`output_variable_name`",
-        keyConfig: ["file_id / source_excel_id", "sheetName\uFF08\u53EF\u9009\uFF09", "output_variable_name"]
-      },
-      {
-        type: "excel-python",
-        label: "Excel \u5F00\u53D1",
-        hasCode: true,
-        codeFile: "code.py",
-        summary: "\u591A Sheet / \u590D\u6742\u8868\u5934\uFF1APython \u89E3\u6790 Excel\uFF08\u753B\u5E03\u914D managed_file_id\uFF0C\u4EE3\u7801\u7528 excel_source_path\uFF09",
-        produces: "`set_table_output(\u4E0E output_variable_name \u540C\u540D, df)`",
-        keyConfig: ["managed_file_id\uFF08UUID\uFF0C\u975E\u6587\u4EF6\u540D\uFF09", "output_variable_name"]
-      },
-      {
-        type: "sql-query",
-        label: "SQL \u67E5\u8BE2",
-        hasCode: true,
-        codeFile: "code.sql",
-        summary: "DuckDB \u5185\u5B58 SQL\uFF0C\u4E0A\u6E38\u53D8\u91CF\u540D\u4F5C\u8868\u540D",
-        consumes: "\u4E0A\u6E38 `output_variable_name` \u4F5C SQL \u8868\u540D",
-        produces: "`output_variable_name`",
-        keyConfig: ["output_variable_name"]
-      },
-      {
-        type: "python-script",
-        label: "Python \u811A\u672C",
-        hasCode: true,
-        codeFile: "code.py",
-        summary: "pandas \u8F6C\u6362\uFF1B\u6700\u5E38\u7528\u52A0\u5DE5\u8282\u70B9",
-        consumes: '`get_variable("\u4E0A\u6E38\u53D8\u91CF\u540D")` \u6216\u5165\u8FB9 `df`',
-        produces: "`result_df` \u2192 `output_variable_name`",
-        keyConfig: ["output_variable_name"]
-      },
-      {
-        type: "database-source",
-        label: "\u6570\u636E\u5E93\u8BFB\u53D6",
-        hasCode: true,
-        codeFile: "code.sql",
-        summary: "\u4ECE\u5916\u90E8\u6570\u636E\u5E93\uFF08connectionId\uFF09\u53EA\u8BFB\u67E5\u8BE2",
-        produces: "`output_variable_name`",
-        keyConfig: ["connectionId", "output_variable_name"]
-      },
-      {
-        type: "database-sink",
-        label: "\u6570\u636E\u5E93\u5199\u5165",
-        hasCode: false,
-        summary: "\u5C06\u8868\u53D8\u91CF\u5199\u5165\u5916\u90E8\u6570\u636E\u5E93\u8868",
-        consumes: "`input_variable_name` \u6216\u5165\u8FB9 Parquet",
-        keyConfig: ["connectionId", "tableName", "mode", "input_variable_name"]
-      },
-      {
-        type: "dataspace-source",
-        label: "\u6570\u636E\u7A7A\u95F4\u8BFB\u53D6",
-        hasCode: true,
-        codeFile: "code.sql",
-        summary: "\u4ECE\u642D\u5B50\u6570\u636E\u7A7A\u95F4\uFF08spaceId\uFF09\u53EA\u8BFB SQL",
-        produces: "`output_variable_name`",
-        keyConfig: ["spaceId", "output_variable_name", "limit\uFF08\u53EF\u9009\uFF09"]
-      },
-      {
-        type: "dataspace-sink",
-        label: "\u6570\u636E\u7A7A\u95F4\u5199\u5165",
-        hasCode: false,
-        summary: "\u5C06\u8868\u53D8\u91CF\u5199\u5165\u6570\u636E\u7A7A\u95F4\u8868",
-        consumes: "`input_variable_name` \u6216\u5165\u8FB9 Parquet",
-        keyConfig: ["spaceId", "tableName", "input_variable_name", "syncMetadata\uFF08\u53EF\u9009\uFF09"]
-      },
-      {
-        type: "data-quality-check",
-        label: "\u6570\u636E\u8D28\u91CF\u68C0\u67E5",
-        hasCode: true,
-        codeFile: "code.py",
-        summary: "\u8D28\u68C0\u89C4\u5219\u6216\u81EA\u5B9A\u4E49 Python\uFF08dqPythonCode\uFF09",
-        consumes: "\u4E0A\u6E38\u8868 / `get_variable`",
-        produces: "\u8D28\u68C0\u62A5\u544A\u53D8\u91CF\uFF08\u4F9D\u914D\u7F6E\uFF09",
-        keyConfig: ["output_variable_name", "qualityConfig", "dqPythonCode\uFF08\u4F18\u5148\u4E8E\u89C4\u5219\uFF09"]
-      },
-      {
-        type: "folder-resource-import",
-        label: "\u6587\u4EF6\u5939\u8D44\u6E90\u5BFC\u5165",
-        hasCode: false,
-        summary: "\u4ECE\u6587\u4EF6\u5939\u8D44\u6E90\u6279\u91CF\u5BFC\u5165\u6587\u4EF6",
-        produces: "`output_variable_name`",
-        keyConfig: ["folderId", "resourceId", "pageSize", "output_variable_name"]
-      },
-      {
-        type: "folder-resource-register",
-        label: "\u8D44\u6E90\u6CE8\u518C",
-        hasCode: false,
-        summary: "\u5C06\u5BFC\u5165\u7ED3\u679C\u6CE8\u518C\u5230\u8FDE\u63A5/\u8D44\u6E90\u76EE\u5F55",
-        keyConfig: ["connectionName", "targetFolderId"]
+    async function resolveAiStructure(auth, fileId) {
+      try {
+        return await fetchJson(auth, `${managedFilesTypes_js_1.MANAGED_FILES_API}/${encodeURIComponent(fileId)}/excel-ai-structure`);
+      } catch {
+        return null;
       }
-    ]
-  }
-];
-var FLOW_NODE_CATALOG_DESIGNER = FLOW_NODE_CATALOG.map((g) => ({
-  group: g.group,
-  items: g.items.map(({ type, label, hasCode }) => ({
-    type,
-    label,
-    ...hasCode ? { code: true } : {}
-  }))
-}));
-function buildFlowNodeCatalogQuickStartSection(detailLink) {
-  const lines = [
-    "## \u53EF\u7528\u6D41\u7A0B\u8282\u70B9\uFF08`data.type`\uFF09",
-    "",
-    "> \u753B\u5E03\u8282\u70B9 **`type` \u6052\u4E3A `custom`**\uFF0C\u4E1A\u52A1\u7C7B\u578B\u5728 **`data.type`**\u3002\u65B0\u5EFA\uFF1A`flow node new --type <\u4E0B\u8868 type>`\u3002",
-    "> **\u7981\u6B62**\u7F16\u9020\u672A\u5728\u4E0B\u8868\u4E2D\u7684 type\u3002",
-    ""
-  ];
-  for (const { group, items } of FLOW_NODE_CATALOG) {
-    lines.push(`### ${group}`, "");
-    lines.push("| type | \u540D\u79F0 | \u4EE3\u7801 | \u7528\u9014 | \u53D8\u91CF |");
-    lines.push("|------|------|:----:|------|------|");
-    for (const n of items) {
-      const code = n.hasCode ? n.codeFile ?? "code.*" : "\u2014";
-      const vars = [n.consumes ? `\u5165:${shortVar(n.consumes)}` : "", n.produces ? `\u51FA:${shortVar(n.produces)}` : ""].filter(Boolean).join(" \xB7 ") || "\u2014";
-      lines.push(`| \`${n.type}\` | ${n.label} | ${code} | ${n.summary} | ${vars} |`);
     }
-    lines.push("");
-  }
-  lines.push(
-    "**\u9009\u578B\u63D0\u793A**",
-    "",
-    "- **Excel\uFF08\u6709 `managed_file_id` / `file_id`\uFF09\u2192 \u4F18\u5148 `excel-python`**\uFF0C\u52FF\u7528 `file-source`\uFF08\u4E0D\u89E3\u6790 Excel\uFF09",
-    "- \u4EC5\u6781\u7B80\u5355\u5355 Sheet\u3001\u96F6\u4EE3\u7801\u65F6\u624D\u7528 `excel-import`\uFF1B\u591A Sheet / \u590D\u6742\u8868\u5934 / \u4E0D\u786E\u5B9A\u7ED3\u6784 \u2192 `excel-python`",
-    "- **`excel-python`**\uFF1A\u753B\u5E03\u914D **`managed_file_id`\uFF08UUID\uFF09**\uFF1B`code.py` \u7528 **`excel_source_path`**\uFF0C\u7981\u6B62\u5199\u6587\u4EF6\u540D/\u672C\u5730\u8DEF\u5F84",
-    "- \u975E Excel \u539F\u59CB\u6587\u4EF6 \u2192 `file-source`\uFF1B\u8BFB\u5916\u90E8\u5E93 \u2192 `database-source`\uFF1B\u8BFB\u6570\u636E\u7A7A\u95F4 \u2192 `dataspace-source`",
-    "- \u5185\u5B58\u52A0\u5DE5 \u2192 `sql-query` / `python-script`\uFF1B\u5206\u652F \u2192 `condition`\uFF08\u51FA\u8FB9 `true`/`false`\uFF09",
-    "- \u5199\u5916\u90E8\u5E93 \u2192 `database-sink`\uFF1B\u5199\u6570\u636E\u7A7A\u95F4 \u2192 `dataspace-sink`",
-    ""
-  );
-  if (detailLink) {
-    lines.push(`\u5404\u8282\u70B9\u914D\u7F6E\u4E0E\u793A\u4F8B \u2192 [flows-guide \xA7\u6D41\u7A0B\u8282\u70B9\u7EC4\u4EF6](${detailLink}#\u6D41\u7A0B\u8282\u70B9\u7EC4\u4EF6)\u3002`, "");
-  } else {
-    lines.push("\u5404\u8282\u70B9\u914D\u7F6E\u4E0E\u793A\u4F8B \u2192 \u5E2E\u52A9\u6587\u6863 **flow/flows-guide** \xA7\u6D41\u7A0B\u8282\u70B9\u7EC4\u4EF6\u3002", "");
+    async function resolveReportLayout(auth, fileId) {
+      try {
+        return await fetchJson(auth, `${managedFilesTypes_js_1.MANAGED_FILES_API}/${encodeURIComponent(fileId)}/excel-report-layout`);
+      } catch {
+        return null;
+      }
+    }
+    async function pullManagedFileBundle2(opts) {
+      const { auth, meta } = opts;
+      const fileId = meta.file_id?.trim();
+      if (!fileId)
+        throw new Error("\u7F3A\u5C11 file_id\uFF0C\u4EC5\u652F\u6301\u5DF2\u767B\u8BB0\u6587\u4EF6");
+      const dir = managedFileLocalDir(opts.filesRootDir, meta);
+      fs_1.default.mkdirSync(dir, { recursive: true });
+      const written = [];
+      const notes = [];
+      const pulledAt = (/* @__PURE__ */ new Date()).toISOString();
+      const ext = (meta.file_ext && meta.file_ext.startsWith(".") ? meta.file_ext : meta.file_ext ? `.${meta.file_ext}` : "") || path_1.default.extname(meta.display_name ?? meta.stored_filename ?? "") || "";
+      const originalName = `${managedFilesTypes_js_1.MANAGED_BUNDLE_FILES.originalPrefix}${ext || ""}`;
+      const originalPath = path_1.default.join(dir, originalName);
+      await downloadBinary(auth, `${managedFilesTypes_js_1.MANAGED_FILES_API}/${encodeURIComponent(fileId)}/content`, originalPath);
+      written.push(originalName);
+      if (isExcelManagedFile(meta)) {
+        const digest = await resolveNativeDigest(auth, fileId, opts.parseNativeIfMissing !== false);
+        if (digest?.markdown) {
+          fs_1.default.writeFileSync(path_1.default.join(dir, managedFilesTypes_js_1.MANAGED_BUNDLE_FILES.nativeDigest), digest.markdown, "utf8");
+          written.push(managedFilesTypes_js_1.MANAGED_BUNDLE_FILES.nativeDigest);
+        } else {
+          notes.push("\u539F\u751F\u89E3\u6790\u672A\u751F\u6210\uFF1A\u8BF7\u5728\u5E73\u53F0\u300C\u6587\u4EF6\u4E0A\u4F20\u7BA1\u7406\u300D\u4E2D\u5BF9 Excel \u6267\u884C\u300C\u539F\u751F\u89E3\u6790\u300D\u540E\u91CD\u8BD5\u62C9\u53D6");
+        }
+        const structureResp = await resolveAiStructure(auth, fileId);
+        if (structureResp?.structure) {
+          fs_1.default.writeFileSync(path_1.default.join(dir, managedFilesTypes_js_1.MANAGED_BUNDLE_FILES.aiStructure), JSON.stringify(structureResp.structure, null, 2), "utf8");
+          written.push(managedFilesTypes_js_1.MANAGED_BUNDLE_FILES.aiStructure);
+        } else {
+          notes.push("\u8868\u7ED3\u6784\u672A\u751F\u6210\uFF1A\u8BF7\u5148\u5728\u5E73\u53F0\u5B8C\u6210\u300C\u539F\u751F\u89E3\u6790\u300D\u4E0E\u300CAI \u8868\u7ED3\u6784\u300D\u540E\u518D\u62C9\u53D6\uFF0C\u6216\u4EC5\u4F7F\u7528\u539F\u751F\u89E3\u6790.md \u4EA4\u7ED9 AI");
+        }
+        const layoutResp = await resolveReportLayout(auth, fileId);
+        if (layoutResp?.layout) {
+          fs_1.default.writeFileSync(path_1.default.join(dir, managedFilesTypes_js_1.MANAGED_BUNDLE_FILES.reportLayout), JSON.stringify(layoutResp.layout, null, 2), "utf8");
+          written.push(managedFilesTypes_js_1.MANAGED_BUNDLE_FILES.reportLayout);
+        } else {
+          notes.push("\u62A5\u8868\u5E03\u5C40\u672A\u751F\u6210\uFF1A\u8BF7\u5728\u5E73\u53F0\u300C\u62A5\u8868\u5E03\u5C40\u300D\u9875\u7B7E\u6267\u884C\u89C4\u5219\u89E3\u6790\u6216 AI \u62A5\u8868\u5E03\u5C40\u540E\u518D\u62C9\u53D6");
+        }
+      } else {
+        notes.push("\u975E Excel \u6587\u4EF6\uFF1A\u4EC5\u62C9\u53D6\u539F\u6587\u4EF6\u4E0E\u6587\u4EF6\u4FE1\u606F\uFF08\u65E0\u539F\u751F\u89E3\u6790/\u8868\u7ED3\u6784\uFF09");
+      }
+      const manifest = {
+        pulledAt,
+        file_id: fileId,
+        display_name: meta.display_name,
+        relative_dir: meta.relative_dir,
+        localDir: dir,
+        files: written,
+        notes: notes.length ? notes : void 0
+      };
+      manifest.files = [...written, managedFilesTypes_js_1.MANAGED_BUNDLE_FILES.manifest];
+      fs_1.default.writeFileSync(path_1.default.join(dir, managedFilesTypes_js_1.MANAGED_BUNDLE_FILES.manifest), JSON.stringify({ ...meta, ...manifest }, null, 2), "utf8");
+      return { dir, manifest };
+    }
+    exports2.pullManagedFileBundle = pullManagedFileBundle2;
+    function findManagedFileInBrowse2(items, fileId) {
+      return items.find((i) => i.file_id === fileId);
+    }
+    exports2.findManagedFileInBrowse = findManagedFileInBrowse2;
   }
-  return lines;
-}
-function shortVar(s) {
-  return s.replace(/`/g, "").slice(0, 40);
-}
+});
 
-// src/shared/flowCliText.ts
-var DAZI_CLI = "dazi";
-function psFlowLine(subcommand) {
-  return `${DAZI_CLI} flow ${subcommand}`;
-}
-function psDaziLine(args) {
-  return `${DAZI_CLI} ${args}`;
-}
-function mdFlowCmd(subcommand) {
-  return `\`${DAZI_CLI} flow ${subcommand}\``;
-}
+// node_modules/.pnpm/commander@12.1.0/node_modules/commander/esm.mjs
+var import_index = __toESM(require_commander(), 1);
+var {
+  program,
+  createCommand,
+  createArgument,
+  createOption,
+  CommanderError,
+  InvalidArgumentError,
+  InvalidOptionArgumentError,
+  // deprecated old name
+  Command,
+  Argument,
+  Option,
+  Help
+} = import_index.default;
 
-// src/shared/flowWorkspaceAudit.ts
-var import_crypto2 = __toESM(require("crypto"));
-var import_fs6 = __toESM(require("fs"));
-var import_path7 = __toESM(require("path"));
-var NODES_DIR2 = "\u8282\u70B9";
-var FLOW_JSON2 = "flow.json";
-var FLOW_META_JSON2 = "flow.meta.json";
-var NODE_INFO_JSON2 = "node.info.json";
-var NODE_TYPE_CODE_DATA_KEY2 = {
-  "database-source": "sql",
-  "dataspace-source": "sql",
-  "python-script": "pythonCode",
-  "excel-python": "pythonCode",
-  "sql-query": "sql",
-  condition: "pythonCode",
-  "data-quality-check": "dqPythonCode"
+// cli/dazi-flow/src/commands/flows.ts
+var import_path3 = __toESM(require("path"), 1);
+var import_fs2 = __toESM(require("fs"), 1);
+
+// cli/shared/src/auth.js
+var import_os = __toESM(require("os"), 1);
+var import_path = __toESM(require("path"), 1);
+var import_fs = __toESM(require("fs"), 1);
+
+// cli/shared/src/errors.js
+var DaziError = class extends Error {
+  constructor(message, code = "ERR_DAZI", exitCode = 1) {
+    super(message);
+    this.code = code;
+    this.exitCode = exitCode;
+    this.name = "DaziError";
+  }
 };
-function sha12(text) {
-  return import_crypto2.default.createHash("sha1").update(text, "utf8").digest("hex");
-}
-function resolveNodeType2(node) {
-  if (node.type === "custom") {
-    return String(node.data?.type ?? "custom");
+var AuthError = class extends DaziError {
+  constructor(message = "\u672A\u767B\u5F55\uFF0C\u8BF7\u5148\u8FD0\u884C: dazi auth login") {
+    super(message, "ERR_AUTH", 2);
+    this.name = "AuthError";
   }
-  return String(node.type ?? "custom");
-}
-function codeLanguageForNodeType2(nodeType) {
-  if (["python-script", "excel-python", "condition", "data-quality-check"].includes(nodeType)) {
-    return "python";
+};
+var NetworkError = class extends DaziError {
+  constructor(message, status, request) {
+    super(message, "ERR_NETWORK", 3);
+    this.status = status;
+    this.request = request;
+    this.name = "NetworkError";
   }
-  if (["database-source", "dataspace-source", "sql-query"].includes(nodeType)) {
-    return "sql";
+  /** 多行人类可读详情，写入 stderr / OutputChannel */
+  formatDetailLines() {
+    const lines = [`\u9519\u8BEF: ${this.message}`];
+    const r = this.request;
+    if (!r)
+      return lines;
+    if (r.label)
+      lines.push(`\u6B65\u9AA4: ${r.label}`);
+    lines.push(`\u8BF7\u6C42: ${r.method} ${r.path}`);
+    lines.push(`\u5B8C\u6574 URL: ${r.url}`);
+    lines.push(`HTTP \u72B6\u6001: ${r.status}`);
+    if (r.responseSnippet)
+      lines.push(`\u54CD\u5E94\u6458\u8981: ${r.responseSnippet}`);
+    return lines;
   }
-  return void 0;
-}
-function codeFileExt2(language) {
-  if (language === "python") return "py";
-  if (language === "sql") return "sql";
-  return "txt";
-}
-function sanitizeName2(name) {
-  const cleaned = (name || "").replace(/[<>:"/\\|?*\x00-\x1f]/g, "_").trim().replace(/\s+/g, "_");
-  return cleaned || "node";
-}
-function readFlowJson2(flowDir) {
-  const raw = JSON.parse(import_fs6.default.readFileSync(import_path7.default.join(flowDir, FLOW_JSON2), "utf8"));
-  return {
-    nodes: Array.isArray(raw.nodes) ? raw.nodes : [],
-    edges: Array.isArray(raw.edges) ? raw.edges : []
-  };
+};
+
+// cli/shared/src/auth.js
+function authFilePath() {
+  return import_path.default.join(import_os.default.homedir(), ".dazi", "auth.json");
 }
-function readMeta2(flowDir) {
-  const p = import_path7.default.join(flowDir, FLOW_META_JSON2);
-  if (!import_fs6.default.existsSync(p)) return void 0;
+function loadAuth() {
+  const p = authFilePath();
+  if (!import_fs.default.existsSync(p))
+    throw new AuthError();
   try {
-    return JSON.parse(import_fs6.default.readFileSync(p, "utf8"));
+    return JSON.parse(import_fs.default.readFileSync(p, "utf-8"));
   } catch {
-    return void 0;
+    throw new AuthError("auth.json \u683C\u5F0F\u635F\u574F\uFF0C\u8BF7\u91CD\u65B0\u767B\u5F55");
   }
 }
-function isCodeNodeType(nodeType) {
-  return Boolean(NODE_TYPE_CODE_DATA_KEY2[nodeType]);
-}
-function listNodeDirs(flowDir) {
-  const nodesRoot = import_path7.default.join(flowDir, NODES_DIR2);
-  if (!import_fs6.default.existsSync(nodesRoot)) return [];
-  return import_fs6.default.readdirSync(nodesRoot).filter((n) => {
-    try {
-      return import_fs6.default.statSync(import_path7.default.join(nodesRoot, n)).isDirectory();
-    } catch {
-      return false;
-    }
-  });
+
+// cli/shared/src/httpClient.js
+var SNIPPET_MAX = 280;
+function truncateSnippet(text) {
+  const oneLine = text.replace(/\s+/g, " ").trim();
+  if (oneLine.length <= SNIPPET_MAX)
+    return oneLine;
+  return `${oneLine.slice(0, SNIPPET_MAX)}\u2026`;
 }
-function findCodeFileInDir(dirAbs) {
-  if (!import_fs6.default.existsSync(dirAbs)) return void 0;
-  for (const f of import_fs6.default.readdirSync(dirAbs)) {
-    if (/^code\.(py|sql|txt)$/i.test(f)) return f;
-  }
-  return void 0;
+function buildHttpErrorMessage(ctx, detail) {
+  const parts = [
+    ctx.label ? `${ctx.label}\u5931\u8D25` : "HTTP \u8BF7\u6C42\u5931\u8D25",
+    `[${ctx.status} ${ctx.method} ${ctx.path}]`,
+    detail
+  ].filter(Boolean);
+  return parts.join(" \u2014 ");
 }
-function findDirForUuid(flowDir, uuid) {
-  const nodesRoot = import_path7.default.join(flowDir, NODES_DIR2);
-  for (const dirName of listNodeDirs(flowDir)) {
-    const infoPath = import_path7.default.join(nodesRoot, dirName, NODE_INFO_JSON2);
-    if (import_fs6.default.existsSync(infoPath)) {
+async function apiRequest(path19, opts = {}) {
+  const auth = opts.token || opts.serverUrl ? { token: opts.token ?? "", serverUrl: opts.serverUrl ?? "" } : loadAuth();
+  const method = (opts.method ?? "GET").toUpperCase();
+  const serverBase = auth.serverUrl.replace(/\/$/, "");
+  const url = `${serverBase}${path19}`;
+  const headers = {
+    "Content-Type": "application/json",
+    Authorization: `Bearer ${auth.token}`,
+    ...opts.headers
+  };
+  const res = await fetch(url, {
+    method,
+    headers,
+    body: opts.body != null ? JSON.stringify(opts.body) : void 0
+  });
+  if (!res.ok) {
+    let detail = `HTTP ${res.status} ${res.statusText}`;
+    let responseSnippet;
+    const rawText = await res.text();
+    if (rawText) {
+      responseSnippet = truncateSnippet(rawText);
       try {
-        const info = JSON.parse(import_fs6.default.readFileSync(infoPath, "utf8"));
-        if (String(info.node_uuid ?? "") === uuid) return import_path7.default.posix.join(NODES_DIR2, dirName);
+        const j = JSON.parse(rawText);
+        if (typeof j.detail === "string" && j.detail.trim()) {
+          detail = j.detail;
+        } else if (Array.isArray(j.detail) && j.detail.length) {
+          detail = j.detail.map((d) => d.msg ?? JSON.stringify(d)).join("; ");
+        } else if (j.message) {
+          detail = j.message;
+        }
       } catch {
+        if (rawText.trim() && detail.startsWith("HTTP ")) {
+          detail = `\u975E JSON \u54CD\u5E94\uFF08\u53EF\u80FD\u662F\u7F51\u5173/\u524D\u7AEF 404\uFF09`;
+        }
       }
     }
+    const ctx = {
+      method,
+      path: path19,
+      url,
+      status: res.status,
+      label: opts.label,
+      responseSnippet
+    };
+    throw new NetworkError(buildHttpErrorMessage(ctx, detail), res.status, ctx);
   }
-  return void 0;
+  if (res.status === 204 || res.headers.get("content-length") === "0") {
+    return void 0;
+  }
+  const text = await res.text();
+  if (!text.trim())
+    return void 0;
+  return JSON.parse(text);
 }
-function auditFlowWorkspace(flowDir) {
-  const warnings = [];
-  const doc = readFlowJson2(flowDir);
-  const meta = readMeta2(flowDir) ?? { nodes: {} };
-  const canvasNodeCount = doc.nodes.length;
-  let canvasCodeNodeCount = 0;
-  const missingInMeta = [];
-  const missingCodeFiles = [];
-  const flowUuids = /* @__PURE__ */ new Set();
-  for (const node of doc.nodes) {
-    const uuid = String(node.node_uuid ?? "").trim();
-    if (!uuid) continue;
-    flowUuids.add(uuid);
-    const nodeType = resolveNodeType2(node);
-    if (!isCodeNodeType(nodeType)) continue;
-    canvasCodeNodeCount++;
-    const label = String(node.data?.label ?? node.id ?? "");
-    const m = meta.nodes[uuid];
-    if (!m?.dir || !m.codeFile) {
-      missingInMeta.push({ uuid, nodeId: String(node.id ?? ""), nodeType, label });
-      continue;
-    }
-    const codePath = import_path7.default.join(flowDir, m.dir, m.codeFile);
-    if (!import_fs6.default.existsSync(codePath)) {
-      missingCodeFiles.push({ uuid, dir: m.dir, codeFile: m.codeFile });
+
+// cli/shared/src/output.js
+function printJsonSummary(summary) {
+  console.log(`__JSON_SUMMARY__${JSON.stringify(summary)}`);
+}
+function ok(data) {
+  printJsonSummary({ ok: true, data });
+}
+function fail(code, message) {
+  printJsonSummary({ ok: false, error: { code, message } });
+}
+function handleError(err) {
+  if (err instanceof NetworkError) {
+    for (const line of err.formatDetailLines()) {
+      console.error(line);
     }
+    fail(err.code, err.message);
+  } else if (err instanceof Error) {
+    const code = err.code ?? "ERR_UNKNOWN";
+    console.error(`\u9519\u8BEF: ${err.message}`);
+    fail(code, err.message);
+  } else {
+    console.error(`\u672A\u77E5\u9519\u8BEF`, err);
+    fail("ERR_UNKNOWN", String(err));
   }
-  const orphanInMeta = Object.keys(meta.nodes).filter((u) => !flowUuids.has(u));
-  let metaCodeIndexedCount = 0;
-  for (const m of Object.values(meta.nodes)) {
-    if (m.dir && m.codeFile) metaCodeIndexedCount++;
-  }
-  const unindexedDirs = [];
-  for (const dirName of listNodeDirs(flowDir)) {
-    const dirAbs = import_path7.default.join(flowDir, NODES_DIR2, dirName);
-    if (!findCodeFileInDir(dirAbs)) continue;
-    const rel = import_path7.default.posix.join(NODES_DIR2, dirName);
-    const indexed = Object.values(meta.nodes).some((m) => m.dir?.replace(/\\/g, "/") === rel);
-    if (!indexed) unindexedDirs.push(rel);
-  }
-  if (canvasCodeNodeCount !== metaCodeIndexedCount) {
-    warnings.push(
-      `\u753B\u5E03\u4EE3\u7801\u8282\u70B9 ${canvasCodeNodeCount} \u4E2A\uFF0Cmeta \u5DF2\u7D22\u5F15 ${metaCodeIndexedCount} \u4E2A\uFF08\u4E0D\u4E00\u81F4\u4F1A\u5BFC\u81F4 node push / \u8BBE\u8BA1\u5668\u6253\u5F00\u4EE3\u7801\u5931\u8D25\uFF09`
-    );
-  }
-  if (missingInMeta.length) {
-    warnings.push("\u90E8\u5206 flow.json \u4EE3\u7801\u8282\u70B9\u672A\u5199\u5165 flow.meta.json\uFF0C\u8BF7\u6267\u884C project repair-meta");
-  }
-  if (unindexedDirs.length) {
-    warnings.push(`\u5B58\u5728\u672A\u7D22\u5F15\u7684\u8282\u70B9\u76EE\u5F55\uFF1A${unindexedDirs.join(", ")}`);
-  }
-  const ok3 = missingInMeta.length === 0 && orphanInMeta.length === 0 && missingCodeFiles.length === 0 && unindexedDirs.length === 0 && canvasCodeNodeCount === metaCodeIndexedCount;
+  process.exit(1);
+}
+
+// cli/shared/src/workspaceLayout.js
+var import_path2 = __toESM(require("path"), 1);
+var WORKSPACE_RESOURCE_DIR = "\u8D44\u6E90";
+function resolveWorkspace(cwd = process.cwd()) {
+  const resources = import_path2.default.join(cwd, WORKSPACE_RESOURCE_DIR);
   return {
-    ok: ok3,
-    canvasNodeCount,
-    canvasCodeNodeCount,
-    metaIndexedCount: Object.keys(meta.nodes).length,
-    metaCodeIndexedCount,
-    missingInMeta,
-    orphanInMeta,
-    missingCodeFiles,
-    unindexedDirs,
-    warnings
+    root: cwd,
+    resources,
+    dazi: import_path2.default.join(cwd, ".dazi"),
+    onto: import_path2.default.join(cwd, "onto"),
+    flows: import_path2.default.join(cwd, "flows"),
+    apps: import_path2.default.join(cwd, "apps"),
+    data: import_path2.default.join(cwd, "data"),
+    docs: import_path2.default.join(resources, "docs"),
+    prompts: import_path2.default.join(resources, "prompts"),
+    examples: import_path2.default.join(resources, "examples"),
+    dataspaces: import_path2.default.join(resources, "dataspaces"),
+    datasources: import_path2.default.join(resources, "datasources"),
+    files: import_path2.default.join(resources, "files")
   };
 }
-function writeNodeInfo(flowDir, node, uuid, nodeType, relDir, codeFile, language, strippedData) {
-  const abs = import_path7.default.join(flowDir, relDir);
-  import_fs6.default.writeFileSync(
-    import_path7.default.join(abs, NODE_INFO_JSON2),
-    JSON.stringify(
-      {
-        _readonly: `\u6B64\u6587\u4EF6\u7531 dazi-flow \u751F\u6210\uFF0C\u4EC5\u4F9B\u67E5\u770B\uFF1B\u7F16\u8F91\u4EE3\u7801\u8BF7\u6539 ${codeFile}\uFF0C\u914D\u7F6E\u6539 flow.json`,
-        node_uuid: uuid,
-        nodeId: String(node.id ?? ""),
-        nodeType,
-        label: String(node.data?.label ?? ""),
-        codeFile,
-        codeLanguage: language,
-        position: node.position,
-        data: strippedData
-      },
-      null,
-      2
-    ),
-    "utf8"
-  );
-}
-function repairFlowMeta(flowDir) {
-  const warnings = [];
-  const repairedUuids = [];
-  const wroteNodeInfo = [];
-  const doc = readFlowJson2(flowDir);
-  const meta = readMeta2(flowDir) ?? { flowId: null, flowName: import_path7.default.basename(flowDir), nodes: {} };
-  if (!meta.nodes) meta.nodes = {};
-  const usedDirNames = new Set(
-    Object.values(meta.nodes).map((m) => m.dir?.split("/").pop()).filter(Boolean)
-  );
-  for (const node of doc.nodes) {
-    const uuid = String(node.node_uuid ?? "").trim();
-    if (!uuid) continue;
-    const nodeType = resolveNodeType2(node);
-    const codeKey = NODE_TYPE_CODE_DATA_KEY2[nodeType];
-    const semanticId = String(node.id ?? "");
-    const label = String(node.data?.label ?? semanticId ?? nodeType);
-    let entry = meta.nodes[uuid];
-    if (!entry) {
-      entry = { nodeId: semanticId, nodeType };
-      meta.nodes[uuid] = entry;
-      repairedUuids.push(uuid);
-    } else {
-      entry.nodeId = semanticId || entry.nodeId;
-      entry.nodeType = nodeType;
+
+// cli/dazi-flow/src/commands/flows.ts
+function makeFlowsCommand() {
+  const cmd = new Command("flows").description("Flow \u7BA1\u7406");
+  cmd.command("list").description("\u5217\u51FA\u6240\u6709 Flow").option("--space <spaceId>", "\u8FC7\u6EE4\u7A7A\u95F4").option("--status <status>", "\u8FC7\u6EE4\u72B6\u6001\uFF08active/draft/archived\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
+    try {
+      const qs = new URLSearchParams();
+      if (opts.space) qs.set("spaceId", opts.space);
+      if (opts.status) qs.set("status", opts.status);
+      const qsStr = qs.toString() ? `?${qs}` : "";
+      const endpoint = `/api/data-pipelines/v1/flows${qsStr}`;
+      const flows = await apiRequest(endpoint);
+      if (opts.json) {
+        console.log(JSON.stringify(flows, null, 2));
+        ok({ flows });
+        return;
+      }
+      if (!flows.length) {
+        console.log("\uFF08\u6682\u65E0 Flow\uFF09");
+        ok({ flows: [] });
+        return;
+      }
+      for (const f of flows) {
+        console.log(`  ${String(f.id).padEnd(8)} ${(f.name ?? "").padEnd(40)} [${f.status ?? "\u2014"}]`);
+      }
+      ok({ flows });
+    } catch (err) {
+      handleError(err);
     }
-    if (!codeKey) continue;
-    let relDir = entry.dir?.replace(/\\/g, "/");
-    if (relDir && findCodeFileInDir(import_path7.default.join(flowDir, relDir))) {
-    } else {
-      relDir = findDirForUuid(flowDir, uuid);
+  });
+  cmd.command("get <flowId>").alias("show").description("\u67E5\u770B Flow \u8BE6\u60C5").option("--json", "\u8F93\u51FA JSON").action(async (flowId, opts) => {
+    try {
+      const flow = await apiRequest(`/api/data-pipelines/v1/flows/${flowId}`);
+      if (opts.json || true) console.log(JSON.stringify(flow, null, 2));
+      ok({ flow });
+    } catch (err) {
+      handleError(err);
     }
-    if (!relDir) {
-      const byLabel = import_path7.default.posix.join(NODES_DIR2, sanitizeName2(label));
-      if (import_fs6.default.existsSync(import_path7.default.join(flowDir, byLabel)) && findCodeFileInDir(import_path7.default.join(flowDir, byLabel))) {
-        relDir = byLabel;
+  });
+  cmd.command("create").alias("new").description("\u65B0\u5EFA Flow").requiredOption("--name <name>", "Flow \u540D\u79F0").option("--space <spaceId>", "\u7A7A\u95F4 ID").option("--description <desc>", "\u63CF\u8FF0").option("--file <path>", "\u4ECE\u672C\u5730 JSON \u6587\u4EF6\u8BFB\u53D6\u5B9A\u4E49").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
+    try {
+      let body;
+      if (opts.file) {
+        body = JSON.parse(import_fs2.default.readFileSync(import_path3.default.resolve(opts.file), "utf-8"));
+      } else {
+        body = { name: opts.name, spaceId: opts.space, description: opts.description };
       }
+      const flow = await apiRequest("/api/data-pipelines/v1/flows", { method: "POST", body });
+      if (opts.json) {
+        console.log(JSON.stringify(flow, null, 2));
+      } else {
+        console.log(`\u2705 \u5DF2\u521B\u5EFA Flow: ${flow.id}  ${flow.name}`);
+      }
+      ok({ flow });
+    } catch (err) {
+      handleError(err);
     }
-    if (!relDir) {
-      let dirName = sanitizeName2(label);
-      if (usedDirNames.has(dirName)) dirName = `${dirName}_${uuid.slice(0, 6)}`;
-      usedDirNames.add(dirName);
-      relDir = import_path7.default.posix.join(NODES_DIR2, dirName);
-      import_fs6.default.mkdirSync(import_path7.default.join(flowDir, relDir), { recursive: true });
-      const lang = codeLanguageForNodeType2(nodeType);
-      const codeFile2 = `code.${codeFileExt2(lang)}`;
-      const template = nodeType === "excel-python" ? "# -*- coding: utf-8 -*-\n# Excel \u8282\u70B9\uFF1A\u753B\u5E03\u914D\u7F6E managed_file_id\uFF1B\u4EE3\u7801\u4F7F\u7528 excel_source_path\n" : lang === "sql" ? "-- \u8282\u70B9 SQL\nSELECT 1;\n" : "# -*- coding: utf-8 -*-\n";
-      if (!findCodeFileInDir(import_path7.default.join(flowDir, relDir))) {
-        import_fs6.default.writeFileSync(import_path7.default.join(flowDir, relDir, codeFile2), template, "utf8");
-        warnings.push(`\u5DF2\u4E3A ${uuid} \u521B\u5EFA\u7A7A\u4EE3\u7801\u6A21\u677F ${relDir}/${codeFile2}`);
+  });
+  cmd.command("validate <flowId>").description("\u9A8C\u8BC1 Flow \u5B9A\u4E49").option("--file <path>", "\u4ECE\u672C\u5730\u5FEB\u7167\u6587\u4EF6\u9A8C\u8BC1\uFF08\u79BB\u7EBF\uFF09").action(async (flowId, opts) => {
+    try {
+      let result;
+      if (opts.file) {
+        const body = JSON.parse(import_fs2.default.readFileSync(import_path3.default.resolve(opts.file), "utf-8"));
+        result = await apiRequest(`/api/data-pipelines/v1/flows/compile-plan`, { method: "POST", body });
+      } else {
+        result = await apiRequest(`/api/data-pipelines/v1/flows/${flowId}/validate`, { method: "POST" });
       }
+      console.log("\u2705 \u9A8C\u8BC1\u901A\u8FC7");
+      ok({ flowId, result });
+    } catch (err) {
+      handleError(err);
     }
-    const dirAbs = import_path7.default.join(flowDir, relDir);
-    const codeFile = findCodeFileInDir(dirAbs);
-    if (!codeFile) {
-      warnings.push(`\u8282\u70B9 ${uuid} \u76EE\u5F55 ${relDir} \u65E0 code.*\uFF0C\u8DF3\u8FC7\u4EE3\u7801\u7D22\u5F15`);
-      continue;
+  });
+  cmd.command("patch <flowId>").description("\u90E8\u5206\u66F4\u65B0 Flow \u5C5E\u6027").option("--name <name>", "\u65B0\u540D\u79F0").option("--description <desc>", "\u65B0\u63CF\u8FF0").option("--status <status>", "\u65B0\u72B6\u6001").option("--file <path>", "\u4ECE JSON \u6587\u4EF6\u8BFB\u53D6 patch body").action(async (flowId, opts) => {
+    try {
+      let patch;
+      if (opts.file) {
+        patch = JSON.parse(import_fs2.default.readFileSync(import_path3.default.resolve(opts.file), "utf-8"));
+      } else {
+        patch = {};
+        if (opts.name) patch.name = opts.name;
+        if (opts.description) patch.description = opts.description;
+        if (opts.status) patch.status = opts.status;
+      }
+      const flow = await apiRequest(`/api/data-pipelines/v1/flows/${flowId}`, { method: "PUT", body: patch });
+      console.log(`\u2705 Flow ${flowId} \u5DF2\u66F4\u65B0`);
+      ok({ flow });
+    } catch (err) {
+      handleError(err);
     }
-    const language = codeLanguageForNodeType2(nodeType);
-    const code = import_fs6.default.readFileSync(import_path7.default.join(dirAbs, codeFile), "utf8");
-    entry.dir = relDir;
-    entry.codeFile = codeFile;
-    entry.codeLanguage = language;
-    entry.codeHash = sha12(code);
-    const strippedData = { ...node.data ?? {} };
-    delete strippedData[codeKey];
-    const infoPath = import_path7.default.join(dirAbs, NODE_INFO_JSON2);
-    if (!import_fs6.default.existsSync(infoPath)) {
-      writeNodeInfo(flowDir, node, uuid, nodeType, relDir, codeFile, language, strippedData);
-      wroteNodeInfo.push(relDir);
+  });
+  const nodeCmd = new Command("flow-node").description("Flow \u8282\u70B9\u7BA1\u7406");
+  nodeCmd.command("get <flowId> <nodeId>").description("\u67E5\u770B Flow \u8282\u70B9\u8BE6\u60C5").option("--json", "\u8F93\u51FA JSON").action(async (flowId, nodeId, opts) => {
+    try {
+      const node = await apiRequest(`/api/data-pipelines/v1/flows/${flowId}/flow-nodes/${nodeId}`);
+      console.log(JSON.stringify(node, null, 2));
+      ok({ node });
+    } catch (err) {
+      handleError(err);
     }
-    if (!repairedUuids.includes(uuid)) repairedUuids.push(uuid);
-  }
-  meta.graphFingerprint = "sha1:" + sha12(JSON.stringify({ nodes: doc.nodes, edges: doc.edges }));
-  import_fs6.default.writeFileSync(import_path7.default.join(flowDir, FLOW_META_JSON2), JSON.stringify(meta, null, 2), "utf8");
-  const okAfter = auditFlowWorkspace(flowDir).ok;
-  return {
-    ok: okAfter,
-    repairedUuids: [...new Set(repairedUuids)],
-    wroteNodeInfo,
-    warnings
-  };
-}
-function buildFlowConsistencyMarkdown(audit, localFilesSpecLink = "../../\u8D44\u6E90/docs/flow/local-files-spec.md") {
-  const lines = [
-    "## \u672C\u5730\u6587\u4EF6\u4E00\u81F4\u6027",
-    "",
-    "| \u6307\u6807 | \u6570\u91CF |",
-    "|------|------|",
-    `| \u753B\u5E03\u8282\u70B9\uFF08flow.json\uFF09 | ${audit.canvasNodeCount} |`,
-    `| \u753B\u5E03\u4EE3\u7801\u8282\u70B9\uFF08flow.json\uFF09 | ${audit.canvasCodeNodeCount} |`,
-    `| meta \u5DF2\u767B\u8BB0\u8282\u70B9 | ${audit.metaIndexedCount} |`,
-    `| meta \u5DF2\u7D22\u5F15\u4EE3\u7801\uFF08dir+codeFile\uFF09 | ${audit.metaCodeIndexedCount} |`,
-    ""
-  ];
-  if (audit.ok) {
-    lines.push("\u2705 **flow.json / flow.meta.json / \u8282\u70B9/ \u4E00\u81F4**\u3002\u8BBE\u8BA1\u5668\u53EF\u6B63\u5E38\u300C\u6253\u5F00\u4EE3\u7801\u300D\uFF0C`node push` \u53EF\u8BC6\u522B\u810F\u8282\u70B9\u3002", "");
-  } else {
-    lines.push("\u26A0\uFE0F **\u76EE\u5F55\u4E0D\u4E00\u81F4**\uFF08\u4F1A\u5BFC\u81F4\u8BBE\u8BA1\u5668\u627E\u4E0D\u5230\u4EE3\u7801\u3001\u6216 `node push` \u8DF3\u8FC7\uFF09\uFF1A", "");
-    if (audit.missingInMeta.length) {
-      lines.push("| uuid | \u8282\u70B9 | \u7C7B\u578B |");
-      lines.push("|------|------|------|");
-      for (const m of audit.missingInMeta) {
-        lines.push(`| \`${m.uuid.slice(0, 8)}\u2026\` | ${m.label || m.nodeId} | ${m.nodeType} |`);
+  });
+  nodeCmd.command("patch <flowId> <nodeId>").description("\u90E8\u5206\u66F4\u65B0 Flow \u8282\u70B9\u914D\u7F6E").option("--file <path>", "\u4ECE JSON \u6587\u4EF6\u8BFB\u53D6 patch body").option("--config <json>", "config patch JSON \u5B57\u7B26\u4E32").action(async (flowId, nodeId, opts) => {
+    try {
+      let patch;
+      if (opts.file) {
+        patch = JSON.parse(import_fs2.default.readFileSync(import_path3.default.resolve(opts.file), "utf-8"));
+      } else if (opts.config) {
+        patch = { config: JSON.parse(opts.config) };
+      } else {
+        console.error("--file \u6216 --config \u5FC5\u987B\u63D0\u4F9B");
+        process.exit(1);
       }
-      lines.push("");
-    }
-    if (audit.unindexedDirs.length) {
-      lines.push(`- \u672A\u7D22\u5F15\u76EE\u5F55\uFF1A${audit.unindexedDirs.map((d) => `\`${d}\``).join(" ")}`);
+      const node = await apiRequest(
+        `/api/data-pipelines/v1/flows/${flowId}/flow-nodes/${nodeId}`,
+        { method: "PATCH", body: patch }
+      );
+      console.log(`\u2705 \u8282\u70B9 ${nodeId} \u5DF2\u66F4\u65B0`);
+      ok({ node });
+    } catch (err) {
+      handleError(err);
     }
-    if (audit.orphanInMeta.length) {
-      lines.push(`- meta \u591A\u4F59 uuid\uFF1A${audit.orphanInMeta.length} \u4E2A\uFF08flow.json \u4E2D\u5DF2\u4E0D\u5B58\u5728\uFF09`);
+  });
+  cmd.addCommand(nodeCmd);
+  cmd.command("workspace-init <flowId>").description("\u521D\u59CB\u5316 Flow \u672C\u5730\u5DE5\u4F5C\u76EE\u5F55 flows/<flowId>/").action(async (flowId) => {
+    try {
+      const ws = resolveWorkspace();
+      const flowDir = import_path3.default.join(ws.flows, flowId);
+      const dirs = [flowDir, import_path3.default.join(flowDir, "plans"), import_path3.default.join(flowDir, "data")];
+      for (const d of dirs) {
+        if (!import_fs2.default.existsSync(d)) import_fs2.default.mkdirSync(d, { recursive: true });
+      }
+      const metaPath = import_path3.default.join(flowDir, ".dazi-flow.json");
+      if (!import_fs2.default.existsSync(metaPath)) {
+        import_fs2.default.writeFileSync(metaPath, JSON.stringify({ flowId, initializedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2), "utf-8");
+      }
+      console.log(`\u2705 Flow \u5DE5\u4F5C\u76EE\u5F55\u5DF2\u521D\u59CB\u5316: ${flowDir}`);
+      ok({ flowId, dir: flowDir });
+    } catch (err) {
+      handleError(err);
     }
-    for (const w of audit.warnings) lines.push(`- ${w}`);
-    lines.push(
-      "",
-      "\u4FEE\u590D\uFF08\u5728\u6D41\u7A0B\u76EE\u5F55\uFF09\uFF1A",
-      "",
-      "```powershell",
-      "dazi flow project repair-meta --dir .",
-      "dazi flow project doctor --dir .",
-      "```",
-      "",
-      `\u8BE6\u89C1 [\u6D41\u7A0B\u672C\u5730\u6587\u4EF6\u89C4\u8303](${localFilesSpecLink})\u3002`,
-      ""
-    );
-  }
-  lines.push(
-    "## \u53D8\u66F4\u63D0\u4EA4\u547D\u4EE4\u77E9\u9635",
-    "",
-    "| \u6539\u4E86\u4EC0\u4E48 | \u547D\u4EE4 |",
-    "|----------|------|",
-    "| `managed_file_id`\u3001`output_variable_name`\u3001\u8FDE\u7EBF\u3001\u589E\u5220\u8282\u70B9 | `dazi flow project push --dir . --canvas` |",
-    "| `\u8282\u70B9/<\u540D>/code.py` \u6216 `code.sql` | `dazi flow node push --node <uuid> --dir .` |",
-    '| **\u65B0\u589E\u4EE3\u7801\u8282\u70B9** | `dazi flow node new --type <type> --dir . --label "<\u540D>"` \u2192 \u6539\u914D\u7F6E \u2192 `push --canvas` \u2192 \u5199 code \u2192 `node push` |',
-    "",
-    "> \u7981\u6B62\u53EA\u6539 `flow.json` \u800C\u4E0D\u66F4\u65B0 `flow.meta.json`\uFF08\u987B `node new` / `pull` / `repair-meta`\uFF09\u3002",
-    ""
-  );
-  return lines;
+  });
+  return cmd;
 }
 
-// src/shared/flowScaffoldDocs.ts
-var DEPTH = {
-  "project-root": 2,
-  "flows-dir": 3,
-  "flow-dir": 4
+// cli/dazi-flow/src/commands/snapshot.ts
+var import_path6 = __toESM(require("path"), 1);
+var import_fs5 = __toESM(require("fs"), 1);
+
+// cli/dazi-flow/src/lib/flowLocal.ts
+var import_crypto = __toESM(require("crypto"), 1);
+var import_fs3 = __toESM(require("fs"), 1);
+var import_path4 = __toESM(require("path"), 1);
+var NODE_TYPE_CODE_DATA_KEY = {
+  "database-source": "sql",
+  "dataspace-source": "sql",
+  "python-script": "pythonCode",
+  "excel-python": "pythonCode",
+  "sql-query": "sql",
+  condition: "pythonCode",
+  "data-quality-check": "dqPythonCode"
 };
-function flowDocsRel(anchor, docPath) {
-  const prefix = "../".repeat(DEPTH[anchor]);
-  return `${prefix}\u8D44\u6E90/docs/${docPath}`;
+function codeLanguageForNodeType(nodeType) {
+  if (["python-script", "excel-python", "condition", "data-quality-check"].includes(nodeType)) {
+    return "python";
+  }
+  if (["database-source", "dataspace-source", "sql-query"].includes(nodeType)) {
+    return "sql";
+  }
+  return void 0;
 }
-var SCAFFOLD_MARKER = "<!-- dazi-flow-scaffold -->";
-var LEGACY_FLOW_DIR_QUICKSTART_FILENAME = "\u5FEB\u901F\u542F\u52A8.md";
-function sanitizeFlowNameForFilename(flowName) {
-  const safe = flowName.trim().replace(/[\\/:*?"<>|]/g, "_").replace(/\s+/g, "_").replace(/_+/g, "_").replace(/^\.+/, "").slice(0, 80);
-  return safe || "flow";
+function codeFileExt(language) {
+  if (language === "python") return "py";
+  if (language === "sql") return "sql";
+  return "txt";
 }
-function flowDirQuickStartFilename(flowName) {
-  return `\u5FEB\u901F\u542F\u52A8_${sanitizeFlowNameForFilename(flowName)}.md`;
+var NODES_DIR = "\u8282\u70B9";
+var VARIABLES_DIR = "\u53D8\u91CF";
+var RUN_DIR = "_run";
+var FLOW_JSON = "flow.json";
+var FLOW_META_JSON = "flow.meta.json";
+var NODE_INFO_JSON = "node.info.json";
+function resolveNodeType(node) {
+  const nt = node.type;
+  if (nt === "custom") {
+    const data = node.data ?? {};
+    return String(data.type ?? "custom");
+  }
+  return String(nt ?? "custom");
 }
-function isFlowScaffoldFile(content) {
-  return content.includes(SCAFFOLD_MARKER);
+function sha1(text) {
+  return import_crypto.default.createHash("sha1").update(text, "utf8").digest("hex");
 }
-function isLegacyFlowScaffoldFile(content) {
-  if (isFlowScaffoldFile(content)) return false;
-  return content.includes("dazi-flow project pull") || content.includes("dazi-flow node push") || content.includes("\u89C1 \xA7335") || content.includes("# \u6D41\u7A0B") && content.includes("dazi-flow project pull");
+function sanitizeName(name) {
+  const cleaned = (name || "").replace(/[<>:"/\\|?*\x00-\x1f]/g, "_").trim().replace(/\s+/g, "_");
+  return cleaned || "node";
 }
-function buildDocsTable(anchor) {
-  const rows = [
-    ["Flow \u6587\u6863\u7D22\u5F15\uFF08\u4ECE\u8FD9\u91CC\u5F00\u59CB\uFF09", "flow/flows-guide.md"],
-    ["\u6570\u636E\u6D41\u7A0B\u9879\u76EE\u5F00\u53D1\u6307\u5357", "flow/flow-project-guide.md"],
-    ["\u6D41\u7A0B\u53D8\u91CF\u7CFB\u7EDF\u6307\u5357", "flow/variables-guide.md"],
-    ["\u8282\u70B9\u4EE3\u7801\u7F16\u5199\u6307\u5357\uFF08\u542B SQL/Python \u793A\u4F8B\uFF09", "flow/node-code-guide.md"],
-    ["Flow \u8FD0\u884C\u4E0E\u6D4B\u8BD5", "flow/run-guide.md"],
-    ["\u6570\u636E\u6E90\u4E0E connectionId", "flow/source-guide.md"],
-    ["**\u6D41\u7A0B\u672C\u5730\u6587\u4EF6\u89C4\u8303\uFF08AI \u5FC5\u8BFB\uFF09**", "flow/local-files-spec.md"],
-    ["\u6D41\u7A0B AI \u5DE5\u4F5C\u624B\u518C", "flow/ai-workflow-playbook.md"],
-    ["CLI \u8C03\u7528\u7EA6\u5B9A\uFF08`dazi` / `dazi.ps1`\uFF09", "guides/cli-invocation.md"]
-  ];
-  return [
-    "## \u5E2E\u52A9\u6587\u6863",
-    "",
-    "\u5DE5\u4F5C\u533A\u6587\u6863\u4F4D\u4E8E **`\u8D44\u6E90/docs/`**\uFF08\u6269\u5C55\u4FA7\u680F **\u5E2E\u52A9 \u2192 \u4E0B\u8F7D\u6240\u6709\u6587\u6863**\uFF0C\u6216\u5728\u5DE5\u4F5C\u533A\u6839\u6267\u884C `dazi docs sync`\uFF09\uFF1A",
-    "",
-    "| \u6587\u6863 | \u94FE\u63A5 |",
-    "|------|------|",
-    ...rows.map(([title, p]) => `| ${title} | [${p.split("/").pop()}](${flowDocsRel(anchor, p)}) |`),
-    "",
-    "\u7EC8\u7AEF\u6253\u5F00\u6587\u6863\uFF08**dazi-work \u6839**\u6216\u5DF2 `cd` \u5230\u6D41\u7A0B\u76EE\u5F55\uFF09\uFF1A",
-    "",
-    "```powershell",
-    psDaziLine("docs open flow/flow-project-guide"),
-    psDaziLine("docs open flow/variables-guide"),
-    psDaziLine("docs open flow/node-code-guide"),
-    psDaziLine("docs open flow/flows-guide"),
-    "```",
-    "",
-    "**\u4EE3\u7801\u793A\u4F8B**\uFF1A\u53D8\u91CF\u8BFB\u5199\u3001`python-script` / `sql-query` \u6A21\u677F\u89C1 [\u8282\u70B9\u4EE3\u7801\u7F16\u5199\u6307\u5357](" + flowDocsRel(anchor, "flow/node-code-guide.md") + ") \u4E0E [\u6D41\u7A0B\u53D8\u91CF\u7CFB\u7EDF\u6307\u5357](" + flowDocsRel(anchor, "flow/variables-guide.md") + ")\u3002",
-    ""
-  ];
+function readMeta(flowDir) {
+  const p = import_path4.default.join(flowDir, FLOW_META_JSON);
+  if (!import_fs3.default.existsSync(p)) return void 0;
+  try {
+    return JSON.parse(import_fs3.default.readFileSync(p, "utf8"));
+  } catch {
+    return void 0;
+  }
 }
-function cliPrefix() {
-  return `\`${DAZI_CLI} flow\`\uFF08\u5168\u5C40 CLI\uFF1B\u5728 **dazi-work \u6839** \u6216\u6D41\u7A0B\u76EE\u5F55\u52A0 \`--dir .\`\uFF1B\u672A\u88C5\u5168\u5C40\u65F6\u53EF\u7528 \`.scriptsdazi.ps1 flow\`\uFF09`;
+function writeMeta(flowDir, meta) {
+  import_fs3.default.writeFileSync(import_path4.default.join(flowDir, FLOW_META_JSON), JSON.stringify(meta, null, 2), "utf8");
 }
-function buildFlowQuickStartMarkdown(opts) {
-  const folder = opts.projectFolder;
-  return [
-    SCAFFOLD_MARKER,
-    "# \u5FEB\u901F\u542F\u52A8",
-    "",
-    `\u6B22\u8FCE\u5F00\u59CB **\u6570\u636E\u6D41\u7A0B\u9879\u76EE** \u5F00\u53D1\uFF08\`${folder}\`\uFF09\u3002`,
-    "",
-    "## 1. \u6D41\u7A0B\u76EE\u5F55\u7ED3\u6784",
-    "",
-    "\u6BCF\u4E2A\u6D41\u7A0B\u662F `\u6D41\u7A0B/<\u6D41\u7A0B\u540D>/` \u76EE\u5F55\uFF1A",
-    "",
-    "| \u8DEF\u5F84 | \u8BF4\u660E |",
-    "|------|------|",
-    "| `flow.json` | \u753B\u5E03\u771F\u7406\u6E90\uFF08\u8282\u70B9\u914D\u7F6E + \u8FDE\u7EBF\uFF0C\u4EE3\u7801\u5DF2\u5265\u79BB\uFF09 |",
-    "| `flow.meta.json` | flowId\u3001node_uuid \u6620\u5C04\uFF08CLI \u7EF4\u62A4\uFF0C\u52FF\u624B\u6539\uFF09 |",
-    "| `\u8282\u70B9/<\u540D>/code.*` | SQL / Python \u8282\u70B9\u4EE3\u7801 |",
-    "| `\u53D8\u91CF/<\u540D>.json` | \u8C03\u8BD5 Run \u53D8\u91CF\u9884\u89C8\uFF08\u53EA\u8BFB\uFF0Cpull/sync \u751F\u6210\uFF09 |",
-    "| `_run/` | \u6D4B\u8BD5/\u8FD0\u884C\u4EA7\u7269\uFF08`*.last-error.md` \u7B49\uFF09 |",
-    "",
-    "> \u6D41\u7A0B**\u4E0D\u7ED1\u5B9A\u6570\u636E\u7A7A\u95F4**\uFF1B`connectionId` \u4EC5\u4E3A\u6570\u636E\u5E93\u8282\u70B9\u7684\u914D\u7F6E\u5B57\u6BB5\u3002",
-    "",
-    "## 2. \u65B0\u5EFA / \u62C9\u53D6\u6D41\u7A0B",
-    "",
-    "\u8D44\u6E90\u7BA1\u7406\u5668\uFF08\u63A8\u8350 **\u8868\u5355**\uFF09\uFF1A",
-    "",
-    "| \u64CD\u4F5C | \u83DC\u5355 |",
-    "|------|------|",
-    "| \u65B0\u5EFA\u6D41\u7A0B | \u53F3\u952E **`\u6D41\u7A0B/`** \u2192 **\u65B0\u5EFA\u6D41\u7A0B** |",
-    "| \u62C9\u53D6\u5E73\u53F0\u6D41\u7A0B | \u53F3\u952E **`\u6D41\u7A0B/`** \u6216\u9879\u76EE\u6839 \u2192 **\u62C9\u53D6\u5E73\u53F0\u6D41\u7A0B** |",
-    "",
-    "\u62C9\u53D6\u8868\u5355\u53EF\u4ECE\u5E73\u53F0 Flow \u5217\u8868\u9009\u62E9\uFF0C\u6216\u624B\u52A8\u586B\u5199 Flow ID\uFF1B\u65B0\u5EFA\u8868\u5355\u586B\u5199\u540D\u79F0\u4E0E\u8BF4\u660E\u540E\u81EA\u52A8\u521B\u5EFA\u5E76\u62C9\u53D6\u3002",
-    "",
-    "\u547D\u4EE4\u884C\uFF08`dazi-work` \u6839\uFF09\uFF1A",
-    "",
-    "```powershell",
-    psFlowLine(`project pull --flow <flowId> --dir "\u9879\u76EE\\${folder}\\\u6D41\u7A0B\\<\u6D41\u7A0B\u540D>"`),
-    "```",
-    "",
-    "\u62C9\u53D6\u540E\u6BCF\u4E2A\u6D41\u7A0B\u76EE\u5F55\u4F1A\u751F\u6210 **`\u5FEB\u901F\u542F\u52A8_<\u6D41\u7A0B\u540D>.md`**\uFF08\u542B flowId \u4E0E\u672C\u6D41\u7A0B\u5E38\u7528\u547D\u4EE4\uFF0C\u4FBF\u4E8E @ \u9644\u52A0\u7ED9 AI\uFF09\u3002",
-    "",
-    "## 3. \u5F00\u53D1\u4E0E\u63D0\u4EA4",
-    "",
-    "1. \u7F16\u8F91 `\u8282\u70B9/<\u540D>/code.sql` \u6216 `code.py`",
-    "2. \u53F3\u952E **\u6D4B\u8BD5\u8FD0\u884C\u8282\u70B9** \u6216 `flow run node-exec --node <uuid>`",
-    "3. \u53F3\u952E **\u63D0\u4EA4\u8282\u70B9** / **\u63D0\u4EA4\u6D41\u7A0B** \u6216 `flow node push` / `flow project push --canvas`",
-    "4. \u67E5\u770B\u8868\u53D8\u91CF\uFF1A\u8BBE\u8BA1\u5668 **output_variable_name** \u65C1 \u{1F4CA}\uFF0C\u6216 `flow variable pull --name <\u540D>`",
-    "",
-    "\u547D\u4EE4\u524D\u7F00\uFF1A" + cliPrefix(),
-    "",
-    "## 4. \u63A8\u8350\u5F00\u53D1\u5FAA\u73AF",
-    "",
-    "\u8BE6\u89C1 [\u6570\u636E\u6D41\u7A0B\u9879\u76EE\u5F00\u53D1\u6307\u5357](" + flowDocsRel("project-root", "flow/flow-project-guide.md") + ") \xA74\u3002",
-    "",
-    "## 5. AI \u63D0\u793A\u8BCD\u63A8\u8350",
-    "",
-    "| \u573A\u666F | \u63D0\u793A\u8BCD ID |",
-    "|------|-----------|",
-    "| \u8BBE\u8BA1/\u65B0\u589E\u6D41\u7A0B | `flow/flow-design` |",
-    "| **\u8FD0\u884C\u5931\u8D25\u3001\u81EA\u4E3B\u6539\u9519** | **`flow/run-fix-loop`**\uFF08\u2B50 \u9996\u9009\uFF09 |",
-    "| \u5206\u6790\u7528\u6237\u7C98\u8D34\u7684\u9519\u8BEF | `flow/run-debug` |",
-    "",
-    "\u4FA7\u680F **\u5E2E\u52A9 \u2192 \u{1F916} \u63D0\u793A\u8BCD** \u4E2D \u2B50 \u4E3A\u6D41\u7A0B\u63A8\u8350\u3002\u53F3\u952E **`flow.json`** \u2192 **\u6253\u5F00 AI \u6539\u9519\u63D0\u793A\u8BCD**\u3002",
-    "\u7ED9 AI \u7684\u4EFB\u52A1\u793A\u4F8B\uFF1A\u300C\u6539 XX \u8282\u70B9\uFF0C\u81EA\u5DF1\u8DD1\u6D4B\u8BD5\uFF0C\u5931\u8D25\u6309 last-error \u6539\u5230\u901A\u8FC7\u518D push\u300D\u3002",
-    "",
-    ...buildDocsTable("project-root")
-  ].join("\n");
+function extractDocument(snapshot) {
+  const doc = snapshot.document ?? snapshot;
+  const nodes = Array.isArray(doc.nodes) ? doc.nodes : [];
+  const edges = Array.isArray(doc.edges) ? doc.edges : [];
+  return { nodes, edges };
 }
-function buildFlowsDirReadmeMarkdown(opts) {
-  return [
-    SCAFFOLD_MARKER,
-    "# \u6D41\u7A0B",
-    "",
-    "\u6BCF\u4E2A\u5B50\u76EE\u5F55\u662F\u4E00\u4E2A\u6D41\u7A0B\uFF08\u542B `flow.json`\u3001`flow.meta.json`\uFF09\u3002",
-    "",
-    "## \u64CD\u4F5C",
-    "",
-    "| \u64CD\u4F5C | \u65B9\u5F0F |",
-    "|------|------|",
-    "| \u65B0\u5EFA\u6D41\u7A0B | \u53F3\u952E\u672C\u76EE\u5F55 \u2192 **\u65B0\u5EFA\u6D41\u7A0B**\uFF08\u8868\u5355\uFF1A\u540D\u79F0\u3001\u8BF4\u660E\u3001\u8DEF\u5F84\u9884\u89C8\uFF09 |",
-    "| \u62C9\u53D6\u5E73\u53F0\u6D41\u7A0B | \u53F3\u952E \u2192 **\u62C9\u53D6\u5E73\u53F0\u6D41\u7A0B**\uFF08\u8868\u5355\uFF1A\u5E73\u53F0\u5217\u8868 / Flow ID\u3001\u672C\u5730\u76EE\u5F55\u540D\uFF09 |",
-    "| \u6253\u5F00\u8BBE\u8BA1\u5668 | \u53F3\u952E `flow.json` \u2192 **\u6253\u5F00\u6D41\u7A0B\u8BBE\u8BA1\u5668** |",
-    "",
-    "```powershell",
-    "# \u547D\u4EE4\u884C\u62C9\u53D6\uFF08dazi-work \u6839\uFF09",
-    psFlowLine(`project pull --flow <id> --dir "\u9879\u76EE\\${opts.projectFolder}\\\u6D41\u7A0B\\<\u6D41\u7A0B\u540D>"`),
-    "```",
-    "",
-    "\u62C9\u53D6\u5B8C\u6210\u540E\u8BF7\u9605\u8BFB\u5404\u6D41\u7A0B\u5B50\u76EE\u5F55\u4E0B\u7684 **`\u5FEB\u901F\u542F\u52A8_<\u6D41\u7A0B\u540D>.md`**\u3002",
-    "",
-    ...buildDocsTable("flows-dir")
-  ].join("\n");
+function splitDocumentToFiles(flowDir, doc) {
+  const nodesDir = import_path4.default.join(flowDir, NODES_DIR);
+  const strippedNodes = [];
+  const nodeMetas = {};
+  const usedDirNames = /* @__PURE__ */ new Set();
+  for (const node of doc.nodes) {
+    if (!node || typeof node !== "object") continue;
+    const nodeUuid = String(node.node_uuid ?? "").trim();
+    const nodeType = resolveNodeType(node);
+    const semanticId = String(node.id ?? "");
+    const codeKey = NODE_TYPE_CODE_DATA_KEY[nodeType];
+    const stripped = JSON.parse(JSON.stringify(node));
+    const meta = { nodeId: semanticId, nodeType };
+    if (codeKey && nodeUuid) {
+      const data = stripped.data ?? {};
+      const rawCode = data[codeKey];
+      const codeBody = typeof rawCode === "string" ? rawCode : rawCode != null ? JSON.stringify(rawCode) : "";
+      delete data[codeKey];
+      stripped.data = data;
+      const language = codeLanguageForNodeType(nodeType);
+      const ext = codeFileExt(language);
+      const label = String(node.data?.label ?? "") || semanticId || nodeType;
+      let dirName = sanitizeName(label);
+      if (usedDirNames.has(dirName)) {
+        dirName = `${dirName}_${nodeUuid.slice(0, 6)}`;
+      }
+      usedDirNames.add(dirName);
+      const nodeDirAbs = import_path4.default.join(nodesDir, dirName);
+      import_fs3.default.mkdirSync(nodeDirAbs, { recursive: true });
+      const codeFile = `code.${ext}`;
+      import_fs3.default.writeFileSync(import_path4.default.join(nodeDirAbs, codeFile), codeBody, "utf8");
+      import_fs3.default.writeFileSync(
+        import_path4.default.join(nodeDirAbs, NODE_INFO_JSON),
+        JSON.stringify(
+          {
+            _readonly: "\u6B64\u6587\u4EF6\u7531 dazi-flow \u751F\u6210\uFF0C\u4EC5\u4F9B\u67E5\u770B\uFF1B\u7F16\u8F91\u4EE3\u7801\u8BF7\u6539 " + codeFile + "\uFF0C\u914D\u7F6E\u6539 flow.json",
+            node_uuid: nodeUuid,
+            nodeId: semanticId,
+            nodeType,
+            label,
+            codeFile,
+            codeLanguage: language,
+            position: node.position,
+            data: stripped.data
+          },
+          null,
+          2
+        ),
+        "utf8"
+      );
+      meta.dir = import_path4.default.posix.join(NODES_DIR, dirName);
+      meta.codeFile = codeFile;
+      meta.codeLanguage = language;
+      meta.codeHash = sha1(codeBody);
+    }
+    if (nodeUuid) {
+      nodeMetas[nodeUuid] = meta;
+    }
+    strippedNodes.push(stripped);
+  }
+  const strippedDoc = { nodes: strippedNodes, edges: doc.edges };
+  import_fs3.default.writeFileSync(import_path4.default.join(flowDir, FLOW_JSON), JSON.stringify(strippedDoc, null, 2), "utf8");
+  return { strippedDoc, nodeMetas };
 }
-function buildFlowDirQuickStartMarkdown(opts) {
-  const name = opts.flowName;
-  let audit;
-  if (opts.flowDir) {
-    try {
-      audit = auditFlowWorkspace(opts.flowDir);
-    } catch {
+function fingerprintDoc(doc) {
+  return "sha1:" + sha1(JSON.stringify({ nodes: doc.nodes, edges: doc.edges }));
+}
+function readFlowJson(flowDir) {
+  const p = import_path4.default.join(flowDir, FLOW_JSON);
+  const raw = JSON.parse(import_fs3.default.readFileSync(p, "utf8"));
+  return {
+    nodes: Array.isArray(raw.nodes) ? raw.nodes : [],
+    edges: Array.isArray(raw.edges) ? raw.edges : []
+  };
+}
+function readNodeCode(flowDir, meta) {
+  if (!meta.dir || !meta.codeFile) return void 0;
+  const p = import_path4.default.join(flowDir, meta.dir, meta.codeFile);
+  if (!import_fs3.default.existsSync(p)) return void 0;
+  return import_fs3.default.readFileSync(p, "utf8");
+}
+function assembleFullDocument(flowDir, meta) {
+  const doc = readFlowJson(flowDir);
+  for (const node of doc.nodes) {
+    const uuid = String(node.node_uuid ?? "");
+    const nodeMeta = meta.nodes[uuid];
+    if (!nodeMeta) continue;
+    const codeKey = NODE_TYPE_CODE_DATA_KEY[nodeMeta.nodeType];
+    if (!codeKey) continue;
+    const code = readNodeCode(flowDir, nodeMeta);
+    if (code != null) {
+      node.data = { ...node.data ?? {}, [codeKey]: code };
+    }
+  }
+  return doc;
+}
+function listDirtyCodeNodes(flowDir, meta) {
+  const dirty = [];
+  for (const [uuid, nodeMeta] of Object.entries(meta.nodes)) {
+    if (!nodeMeta.codeFile) continue;
+    const code = readNodeCode(flowDir, nodeMeta);
+    if (code == null) continue;
+    if (sha1(code) !== (nodeMeta.codeHash ?? "")) {
+      dirty.push(uuid);
     }
   }
-  const canvasN = audit?.canvasNodeCount ?? opts.nodeCount;
-  const codeN = audit?.canvasCodeNodeCount ?? opts.codeNodeCount;
-  const metaCodeN = audit?.metaCodeIndexedCount;
-  const statsParts = [];
-  if (canvasN != null) {
-    let line = `
-| \u753B\u5E03\u8282\u70B9\uFF08flow.json\uFF09 | ${canvasN}`;
-    if (codeN != null) line += `\uFF0C\u5176\u4E2D\u4EE3\u7801\u8282\u70B9 ${codeN}`;
-    line += " |";
-    statsParts.push(line);
+  return dirty;
+}
+
+// cli/dazi-flow/src/lib/flowApi.ts
+var import_path5 = __toESM(require("path"), 1);
+var import_fs4 = __toESM(require("fs"), 1);
+var FLOW_API = "/api/data-pipelines/v1/flows";
+async function pushCodeNode(flowId, flowDir, meta, uuid, opts = {}) {
+  const nodeMeta = meta.nodes[uuid];
+  if (!nodeMeta) return { uuid, status: "skipped" };
+  const localCode = readNodeCode(flowDir, nodeMeta);
+  if (localCode == null) return { uuid, status: "skipped" };
+  const nodeLabel = nodeMeta.nodeId || uuid;
+  const remote = await apiRequest(`${FLOW_API}/${flowId}/flow-nodes/${uuid}`, {
+    label: `\u8BFB\u53D6\u8FDC\u7AEF\u8282\u70B9\u4EE3\u7801 (nodeId=${nodeLabel}, uuid=${uuid})`
+  });
+  const remoteHash = sha1(remote.code_body ?? "");
+  const baseHash = nodeMeta.codeHash ?? "";
+  if (!opts.force && baseHash && remoteHash !== baseHash) {
+    return { uuid, status: "conflict", version: remote.version };
   }
-  if (metaCodeN != null && codeN != null && metaCodeN !== codeN) {
-    statsParts.push(`
-| meta \u5DF2\u7D22\u5F15\u4EE3\u7801 | ${metaCodeN} \u26A0\uFE0F \u4E0E\u753B\u5E03\u4E0D\u4E00\u81F4 |`);
-  } else if (metaCodeN != null) {
-    statsParts.push(`
-| meta \u5DF2\u7D22\u5F15\u4EE3\u7801 | ${metaCodeN} |`);
+  if (opts.dryRun) return { uuid, status: "dry-run", version: remote.version };
+  const updated = await apiRequest(`${FLOW_API}/${flowId}/flow-nodes/${uuid}`, {
+    method: "PATCH",
+    body: { code_body: localCode, expected_version: opts.force ? void 0 : remote.version },
+    label: `\u63D0\u4EA4\u8282\u70B9\u4EE3\u7801 (nodeId=${nodeLabel}, uuid=${uuid})`
+  });
+  nodeMeta.codeHash = sha1(localCode);
+  nodeMeta.codeVersion = updated.version;
+  return { uuid, status: "pushed", version: updated.version };
+}
+async function pullCodeNode(flowId, flowDir, meta, uuid) {
+  const nodeMeta = meta.nodes[uuid];
+  if (!nodeMeta?.dir || !nodeMeta.codeFile) {
+    throw new Error(`\u8282\u70B9 ${uuid} \u4E0D\u662F\u4EE3\u7801\u8282\u70B9\u6216\u7F3A\u5C11\u672C\u5730\u6620\u5C04`);
   }
-  const pulled = opts.pulledAt ? `
-| \u4E0A\u6B21\u62C9\u53D6 | ${opts.pulledAt} |` : "";
-  const consistencySection = audit ? buildFlowConsistencyMarkdown(audit, flowDocsRel("flow-dir", "flow/local-files-spec.md")) : [];
-  return [
-    SCAFFOLD_MARKER,
-    "# \u5FEB\u901F\u542F\u52A8",
-    "",
-    `**\u6D41\u7A0B**\uFF1A${name} \xB7 \u5E73\u53F0 flowId \`${opts.flowId}\``,
-    "",
-    "## \u6D41\u7A0B\u4FE1\u606F",
-    "",
-    "| \u5B57\u6BB5 | \u503C |",
-    "|------|-----|",
-    `| flowId | \`${opts.flowId}\` |`,
-    `| \u672C\u5730\u76EE\u5F55 | \`\u6D41\u7A0B/${name}/\` |${statsParts.join("")}${pulled}`,
-    "",
-    ...consistencySection,
-    "## \u5E38\u7528\u547D\u4EE4",
-    "",
-    "\u5728 **dazi-work \u6839**\uFF08\u6216\u5C06 `--dir` \u6307\u5411\u672C\u76EE\u5F55\uFF09\uFF1B\u9700\u5DF2\u5B89\u88C5\u5168\u5C40 CLI\uFF08`pnpm add -g @dazitech/cli`\uFF09\uFF1A",
-    "",
-    "```powershell",
-    `cd "\u9879\u76EE\\${opts.projectFolder ?? "flow_<\u9879\u76EE\u540D>"}\\\u6D41\u7A0B\\${name}"`,
-    "",
-    "# \u72B6\u6001 / \u62C9\u53D6 / \u63D0\u4EA4",
-    psFlowLine("project status --dir ."),
-    psFlowLine(`project pull --flow ${opts.flowId} --dir .`),
-    psFlowLine("project push --dir . --canvas"),
-    "",
-    "# \u5355\u8282\u70B9\u6D4B\u8BD5\uFF08uuid \u89C1 flow.meta.json \u6216 node.info.json\uFF09",
-    psFlowLine("run node-exec --node <node_uuid> --dir ."),
-    "",
-    "# \u6574\u6D41\u7A0B\u8C03\u8BD5 + \u53D8\u91CF",
-    psFlowLine("run flow-exec --dir . --type debug"),
-    psFlowLine("variable sync --dir ."),
-    psFlowLine("variable pull --name <output_variable_name> --dir ."),
-    "```",
-    "",
-    ...buildFlowNodeCatalogQuickStartSection(flowDocsRel("flow-dir", "flow/flows-guide.md")),
-    "## AI \u4FEE\u6539\u73B0\u6709\u6D41\u7A0B\uFF08\u5355\u6587\u4EF6\u5165\u53E3\uFF09",
-    "",
-    "> \u63A8\u8350\u53EA\u628A\u672C\u6587\u4EF6\u9644\u52A0\u7ED9 AI\uFF1B\u82E5\u4FE1\u606F\u4E0D\u8DB3\uFF0C\u518D\u6309\u9700\u6253\u5F00\u300C\u5E2E\u52A9\u6587\u6863\u300D\u4E2D\u7684\u4E13\u9898\u3002",
-    "",
-    "### \u573A\u666F A\uFF1A\u65B0\u589E\u8282\u70B9\uFF08\u5DF2\u6709\u6D41\u7A0B\u7EE7\u7EED\u6539\uFF09",
-    "",
-    "1. \u5148\u8BFB `flow.json` \u4E0E `flow.meta.json`\uFF0C\u6267\u884C `dazi flow project doctor --dir .`",
-    `2. **\u5FC5\u987B**\u7528 CLI \u65B0\u5EFA\u8282\u70B9\uFF08\u7981\u6B62\u624B\u6413 uuid\uFF09\uFF1A${mdFlowCmd('node new --type <node_type> --dir . --label "<\u8282\u70B9\u540D>"')}`,
-    "3. \u5728 `flow.json` \u91CC\u8865 `nodes/edges`\uFF08\u9075\u5B88\u951A\u70B9\uFF1A`sourceHandle` \u4EC5 `r/b/true/false`\uFF0C`targetHandle` \u4EC5 `l/t`\uFF09",
-    "4. \u7F16\u8F91 `\u8282\u70B9/<\u540D>/code.sql|py`\uFF08`node new` \u4F1A\u521B\u5EFA\u76EE\u5F55\u4E0E meta \u7D22\u5F15\uFF09",
-    `5. \u5355\u8282\u70B9\u6D4B\u8BD5\uFF1A${mdFlowCmd("run node-exec --node <node_uuid> --dir .")}`,
-    `6. \u63D0\u4EA4\u753B\u5E03\uFF08\u542B\u8FDE\u7EBF/\u914D\u7F6E\uFF09\uFF1A${mdFlowCmd("project push --dir . --canvas")}`,
-    "",
-    "### \u573A\u666F B\uFF1A\u4EC5\u6539\u8282\u70B9\u4EE3\u7801",
-    "",
-    "1. \u7F16\u8F91 `\u8282\u70B9/<\u540D>/code.sql|py`\uFF08\u4E0D\u8981\u628A\u6B63\u6587\u5199\u56DE `flow.json`\uFF09",
-    `2. \u8FD0\u884C\u8282\u70B9\uFF1A${mdFlowCmd("run node-exec --node <node_uuid> --dir .")}`,
-    `3. \u63D0\u4EA4\u4EE3\u7801\uFF1A${mdFlowCmd("node push --node <node_uuid> --dir .")}`,
-    "",
-    "### \u573A\u666F C\uFF1A\u753B\u5E03\u548C\u4EE3\u7801\u4E0D\u540C\u6B65",
-    "",
-    `1. \u5148 ${mdFlowCmd("project status --dir .")} \u770B\u672C\u5730\u810F\u6539\u52A8`,
-    `2. \u82E5\u6539\u4E86\u62D3\u6251/\u8FDE\u7EBF/\u914D\u7F6E\uFF1A\u6267\u884C ${mdFlowCmd("project push --dir . --canvas")}`,
-    `3. \u82E5\u53EA\u6539\u4E86\u4EE3\u7801\uFF1A\u6267\u884C ${mdFlowCmd("node push --node <node_uuid> --dir .")}`,
-    `4. \u5FC5\u8981\u65F6\u91CD\u65B0\u62C9\u53D6\u6821\u5BF9\uFF1A${mdFlowCmd(`project pull --flow ${opts.flowId} --dir .`)}`,
-    "",
-    "## AI \u81EA\u68C0\u6E05\u5355\uFF08\u63D0\u4EA4\u524D\uFF09",
-    "",
-    `- \u547D\u4EE4\u524D\u7F00\u662F\u5426\u7EDF\u4E00\u4E3A ${mdFlowCmd("...")}\uFF08\u800C\u4E0D\u662F\u88F8 \`dazi-flow\`\uFF09`,
-    "- `flow.json` \u662F\u5426\u53EA\u627F\u8F7D\u753B\u5E03\u62D3\u6251\u4E0E\u8282\u70B9\u914D\u7F6E\uFF08\u4E0D\u5D4C\u5165\u5927\u6BB5 SQL/Python\uFF09",
-    "- `code.*` \u662F\u5426\u4E0E\u8282\u70B9\u4E1A\u52A1\u7C7B\u578B\u4E00\u81F4\uFF08SQL \u8282\u70B9 `code.sql`\uFF0CPython \u8282\u70B9 `code.py`\uFF09",
-    "- \u6761\u4EF6\u8282\u70B9\u51FA\u8FB9\u662F\u5426\u4EC5\u4F7F\u7528 `true/false`\uFF0C\u672A\u8BEF\u7528 `r/b`",
-    "- \u82E5\u6539\u52A8\u753B\u5E03\uFF0C\u662F\u5426\u6267\u884C\u4E86 `flow project push --canvas`",
-    "",
-    "## \u5E38\u89C1\u9519\u8BEF\u4E0E\u4FEE\u590D",
-    "",
-    "| \u73B0\u8C61 | \u5E38\u89C1\u539F\u56E0 | \u4FEE\u590D |",
-    "|------|----------|------|",
-    `| \u547D\u4EE4\u627E\u4E0D\u5230 | \u672A\u88C5\u5168\u5C40 CLI \u6216\u4E0D\u5728 dazi-work | \`pnpm add -g @dazitech/cli\` \u6216 ${mdFlowCmd("...")} / \`.scriptsdazi.ps1 flow ...\` |`,
-    "| \u8282\u70B9\u6D4B\u8BD5\u62A5\u4E0A\u6E38\u53D8\u91CF\u4E0D\u5B58\u5728 | \u672A\u5148\u8FD0\u884C\u4E0A\u6E38\u8282\u70B9\u4EA7\u51FA\u53D8\u91CF | \u5148\u8DD1\u4E0A\u6E38\uFF0C\u6216\u6574\u6D41\u7A0B `flow run flow-exec --type debug` \u540E\u518D\u6D4B |",
-    "| excel-python \u627E\u4E0D\u5230\u6587\u4EF6 | code.py \u5199\u4E86\u6587\u4EF6\u540D/\u672C\u5730\u8DEF\u5F84 | \u753B\u5E03\u914D `managed_file_id`\uFF08UUID\uFF09\uFF1B\u4EE3\u7801\u7528 `excel_source_path` |",
-    "| Excel \u7528\u4E86 file-source | file-source \u4E0D\u89E3\u6790 xlsx | \u6539\u4E3A **`excel-python`** + `managed_file_id` |",
-    "| excel-python \u65E0\u4E3B\u8F93\u51FA | \u672A `set_table_output` \u6216\u540D\u79F0\u4E0E `output_variable_name` \u4E0D\u4E00\u81F4 | \u89C1 node-code-guide \xA75 |",
-    "| \u753B\u5E03\u663E\u793A\u5BF9\u4F46\u5E73\u53F0\u4E0D\u751F\u6548 | \u53EA push \u4E86\u4EE3\u7801\uFF0C\u672A push \u753B\u5E03 | \u6267\u884C `flow project push --dir . --canvas` |",
-    "| \u4EE3\u7801\u6539\u4E86\u4F46\u5E73\u53F0\u8FD8\u662F\u65E7\u4EE3\u7801 | \u6539\u4E86\u672C\u5730 `code.*` \u4F46\u672A node push | \u6267\u884C `flow node push --node <node_uuid> --dir .` |",
-    "",
-    "## AI \u81EA\u4E3B\u8FD0\u884C\u4E0E\u6539\u9519\u95ED\u73AF\uFF08Agent \u5FC5\u8BFB\uFF09",
-    "",
-    "> **\u6269\u5C55/\u83DC\u5355\u4E0D\u4F1A\u81EA\u52A8\u6539\u4EE3\u7801**\uFF08\u5E73\u53F0 D6\uFF09\uFF1B\u7528\u6237\u59D4\u6258\u4F60\u6539\u6D41\u7A0B\u65F6\uFF0C\u4F60**\u5FC5\u987B\u4E3B\u52A8**\u6267\u884C\u300C\u6539 \u2192 \u8DD1 \u2192 \u8BFB\u9519 \u2192 \u518D\u6539 \u2192 \u518D\u8DD1\u300D\uFF0C\u76F4\u5230\u901A\u8FC7\u6216\u8FBE\u5230\u91CD\u8BD5\u4E0A\u9650\u3002",
-    "",
-    "### \u9519\u8BEF\u843D\u5728\u54EA\u91CC\uFF08\u8DD1\u5B8C\u5FC5\u67E5\uFF09",
-    "",
-    "| \u8FD0\u884C\u65B9\u5F0F | \u5931\u8D25\u65F6\u8BFB | \u6210\u529F/\u6B65\u9AA4\u6458\u8981 |",
-    "|----------|----------|---------------|",
-    "| \u5355\u8282\u70B9 `run node-exec` | `_run/<\u8282\u70B9\u540D>.last-error.md` | \u65E0 error \u6587\u4EF6\u5373\u901A\u8FC7 |",
-    "| \u6574\u6D41\u7A0B `run flow-exec` | `_run/flow.last-error.md` | `_run/flow.last-run.md`\uFF08\u6B65\u9AA4+\u65E5\u5FD7\uFF09 |",
-    "",
-    "CLI \u5E26 `--json` \u65F6\uFF1A\u770B\u8FD4\u56DE `success: false` \u6216 `errorFile` \u5B57\u6BB5\uFF0C**\u518D\u6253\u5F00\u5BF9\u5E94 md \u6587\u4EF6**\uFF0C\u4E0D\u8981\u53EA\u770B\u7EC8\u7AEF\u4E00\u884C\u62A5\u9519\u3002",
-    "",
-    "### \u6807\u51C6\u6539\u9519\u5FAA\u73AF\uFF08\u9ED8\u8BA4\u6700\u591A 3 \u8F6E\uFF09",
-    "",
-    "1. **\u5B9A\u4F4D**\uFF1A\u8BFB `flow.json` + \u76EE\u6807 `\u8282\u70B9/<\u540D>/code.*` + `flow.meta.json`\uFF08\u53D6 `node_uuid`\uFF09",
-    "2. **\u4FEE\u6539**\uFF1A\u53EA\u6539\u5FC5\u8981\u6587\u4EF6\uFF08\u4EE3\u7801 \u2192 `code.*`\uFF1B\u8FDE\u7EBF/\u914D\u7F6E \u2192 `flow.json`\uFF09",
-    "3. **\u9A8C\u8BC1**\uFF08\u5148\u5C0F\u540E\u5927\uFF09\uFF1A",
-    `   - \u5355\u8282\u70B9\uFF1A${mdFlowCmd("run node-exec --node <node_uuid> --dir .")}`,
-    `   - \u6574\u6D41\u7A0B\uFF1A${mdFlowCmd("run flow-exec --dir . --type debug")}`,
-    "4. **\u5224\u9519**\uFF1A\u9000\u51FA\u7801\u975E 0 / JSON `success:false` \u2192 \u6253\u5F00 `_run/*.last-error.md`\uFF0C\u6309\u5176\u4E2D**\u9519\u8BEF\u5206\u7C7B**\u4E0E traceback \u4FEE\u590D",
-    "5. **\u91CD\u8BD5**\uFF1A\u56DE\u5230\u6B65\u9AA4 2\uFF1B\u82E5 3 \u8F6E\u4ECD\u5931\u8D25\uFF0C\u6C47\u603B\u5DF2\u5C1D\u8BD5\u4FEE\u590D\u70B9\u5E76\u8BF7\u6C42\u7528\u6237\u4ECB\u5165",
-    "6. **\u63D0\u4EA4**\uFF08\u4EC5\u901A\u8FC7\u540E\uFF09\uFF1A\u4EE3\u7801 `node push`\uFF1B\u753B\u5E03 `project push --canvas`",
-    "",
-    "### \u5E38\u89C1\u5931\u8D25 \u2192 \u4F18\u5148\u52A8\u4F5C",
-    "",
-    "| last-error \u5206\u7C7B | \u4F18\u5148\u68C0\u67E5 |",
-    "|-----------------|----------|",
-    "| \u7F3A\u4E0A\u6E38\u53D8\u91CF | \u5148\u8DD1\u4E0A\u6E38\u8282\u70B9\u6216\u6574\u6D41\u7A0B debug\uFF0C\u518D `variable pull` \u770B schema |",
-    "| \u914D\u7F6E\u7F3A\u5931 | `flow.json` \u8BE5\u8282\u70B9 `data`\uFF08connectionId / output_variable_name \u7B49\uFF09 |",
-    "| \u4EE3\u7801\u9519\u8BEF | `code.*` \u4E0E traceback\uFF1B\u6539\u540E\u53EA `node push` |",
-    "| \u8FDE\u63A5/\u6570\u636E\u6E90 | connectionId / spaceId \u662F\u5426\u6709\u6548 |",
-    "",
-    "### Agent \u7981\u6B62\u9879",
-    "",
-    "- **\u7981\u6B62**\u672A\u5B9E\u9645\u8FD0\u884C\u5C31\u58F0\u79F0\u300C\u5DF2\u4FEE\u590D/\u5DF2\u901A\u8FC7\u300D",
-    "- **\u7981\u6B62**\u4E0D\u8BFB `_run/*.last-error.md` \u5C31\u731C\u6D4B\u539F\u56E0",
-    "- **\u7981\u6B62**\u4FEE\u590D\u540E\u8DF3\u8FC7\u9A8C\u8BC1\u76F4\u63A5 `push`",
-    "- **\u7981\u6B62**\u628A SQL/Python \u6B63\u6587\u5199\u56DE `flow.json`",
-    "",
-    "\u4FA7\u680F\u63D0\u793A\u8BCD\u53EF\u9009\u7528 **`flow/run-fix-loop`**\uFF08\u81EA\u4E3B\u6539\u9519\u4E13\u7528\uFF09\u3002",
-    "",
-    "\u6269\u5C55\uFF1A\u53F3\u952E **`flow.json`** / **\u8282\u70B9/** / **`code.*`** \u53EF\u6D4B\u8BD5\u3001\u63D0\u4EA4\u3001\u6253\u5F00\u8BBE\u8BA1\u5668\u3002",
-    "",
-    "## \u7F16\u5199\u8282\u70B9\u4EE3\u7801",
-    "",
-    "- **SQL \u8282\u70B9**\uFF08`sql-query` / `database-source`\uFF09\uFF1A\u7F16\u8F91 `\u8282\u70B9/<\u540D>/code.sql`\uFF1B`sql-query` \u4E2D\u7528 **\u4E0A\u6E38\u53D8\u91CF\u540D\u4F5C\u8868\u540D**\uFF08`FROM \u4E0A\u6E38\u53D8\u91CF\u540D`\uFF09",
-    '- **Python \u8282\u70B9**\uFF08`python-script`\uFF09\uFF1A\u7F16\u8F91 `code.py`\uFF1B\u5355\u8282\u70B9\u6D4B\u8BD5\u7528 **`get_variable("\u4E0A\u6E38\u53D8\u91CF\u540D")`**\uFF0C\u8F93\u51FA\u8D4B\u503C **`result_df`**',
-    "- **`excel-python`\uFF08Excel \u9ED8\u8BA4\u9996\u9009\uFF09**\uFF1A",
-    "  - \u6709 **`managed_file_id` \u7684 Excel \u2192 \u4F18\u5148 `excel-python`**\uFF0C**\u52FF\u7528 `file-source`**\uFF08file-source \u4E0D\u89E3\u6790 Excel\uFF09",
-    "  - **\u753B\u5E03**\u914D **`managed_file_id`**\uFF08UUID\uFF09\uFF1B**`code.py` \u53EA\u7528 `excel_source_path`**",
-    '  - \u4E3B\u8F93\u51FA **`set_table_output("<\u4E0E output_variable_name \u540C\u540D>", df)`**',
-    "  - \u5B8C\u6574\u793A\u4F8B \u2192 [node-code-guide \xA75](" + flowDocsRel("flow-dir", "flow/node-code-guide.md") + "#5-excel-pythonexcel-\u5F00\u53D1--\u9ED8\u8BA4\u9996\u9009)",
-    "- \u53D8\u91CF\u7EA6\u5B9A\u4E0E\u5B8C\u6574\u793A\u4F8B \u2192 [\u6D41\u7A0B\u53D8\u91CF\u7CFB\u7EDF\u6307\u5357](" + flowDocsRel("flow-dir", "flow/variables-guide.md") + ") \xB7 [\u8282\u70B9\u4EE3\u7801\u7F16\u5199\u6307\u5357](" + flowDocsRel("flow-dir", "flow/node-code-guide.md") + ")",
-    "",
-    ...buildDocsTable("flow-dir")
-  ].join("\n");
+  const remote = await apiRequest(`${FLOW_API}/${flowId}/flow-nodes/${uuid}`, {
+    label: `\u62C9\u53D6\u8282\u70B9\u4EE3\u7801 (uuid=${uuid})`
+  });
+  const code = remote.code_body ?? "";
+  const target = import_path5.default.join(flowDir, nodeMeta.dir, nodeMeta.codeFile);
+  import_fs4.default.mkdirSync(import_path5.default.dirname(target), { recursive: true });
+  import_fs4.default.writeFileSync(target, code, "utf8");
+  nodeMeta.codeHash = sha1(code);
+  nodeMeta.codeVersion = remote.version;
+  return { uuid, version: remote.version };
+}
+async function pushCanvasDocument(flowId, document) {
+  const nodeCount = document.nodes?.length ?? 0;
+  const edgeCount = document.edges?.length ?? 0;
+  await apiRequest(`${FLOW_API}/${flowId}`, {
+    method: "PUT",
+    body: { data: document },
+    label: `\u63D0\u4EA4\u753B\u5E03 flow.json (flowId=${flowId}, nodes=${nodeCount}, edges=${edgeCount})`
+  });
 }
-function removeLegacyFlowDirQuickStartFiles(flowDir, currentFilename, fsImpl) {
-  const legacy = import_path8.default.join(flowDir, LEGACY_FLOW_DIR_QUICKSTART_FILENAME);
-  if (fsImpl.existsSync(legacy)) {
+
+// cli/dazi-flow/src/commands/snapshot.ts
+function makeSnapshotCommand() {
+  const cmd = new Command("snapshot").description("Flow \u5FEB\u7167\u7BA1\u7406");
+  cmd.command("pull").description("\u4ECE\u5E73\u53F0\u62C9\u53D6 Flow \u5FEB\u7167\u5230\u672C\u5730 flows/<flowId>/").requiredOption("--flow <flowId>", "Flow ID\uFF08\u77ED\u9009\u9879 -f\uFF09").alias("-f").option("--out <dir>", "\u8F93\u51FA\u76EE\u5F55\uFF08\u9ED8\u8BA4 flows/<flowId>/\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
     try {
-      if (isFlowScaffoldFile(fsImpl.readFileSync(legacy, "utf8"))) {
-        fsImpl.unlinkSync(legacy);
+      console.log(`\u6B63\u5728\u62C9\u53D6\u5FEB\u7167: ${opts.flow} ...`);
+      const snapshot = await apiRequest(
+        `/api/data-pipelines/v1/flows/${opts.flow}/snapshot`
+      );
+      const ws = resolveWorkspace();
+      const outDir = opts.out ?? import_path6.default.join(ws.flows, opts.flow);
+      if (!import_fs5.default.existsSync(outDir)) import_fs5.default.mkdirSync(outDir, { recursive: true });
+      const outFile = import_path6.default.join(outDir, "snapshot.json");
+      import_fs5.default.writeFileSync(outFile, JSON.stringify(snapshot, null, 2), "utf-8");
+      if (opts.json) {
+        console.log(JSON.stringify(snapshot, null, 2));
+      } else {
+        console.log(`\u2705 \u5FEB\u7167\u5DF2\u4FDD\u5B58: ${outFile}`);
       }
-    } catch {
+      ok({ flowId: opts.flow, file: outFile });
+    } catch (err) {
+      handleError(err);
     }
-  }
-  for (const entry of fsImpl.readdirSync(flowDir)) {
-    if (entry === currentFilename) continue;
-    if (!/^快速启动_.+\.md$/.test(entry)) continue;
-    const full = import_path8.default.join(flowDir, entry);
+  });
+  cmd.command("push-graph").description("\u5C06\u672C\u5730 flows/<flowId>/snapshot.json \u56FE\u7ED3\u6784\u63A8\u9001\u5230\u5E73\u53F0").requiredOption("--flow <flowId>", "Flow ID").option("--dir <dir>", "\u5FEB\u7167\u76EE\u5F55\uFF08\u9ED8\u8BA4 flows/<flowId>/\uFF09").option("--dry-run", "\u4EC5\u9A8C\u8BC1\uFF0C\u4E0D\u63A8\u9001").action(async (opts) => {
     try {
-      if (isFlowScaffoldFile(fsImpl.readFileSync(full, "utf8"))) {
-        fsImpl.unlinkSync(full);
+      const ws = resolveWorkspace();
+      const dir = opts.dir ?? import_path6.default.join(ws.flows, opts.flow);
+      const file = import_path6.default.join(dir, "snapshot.json");
+      if (!import_fs5.default.existsSync(file)) {
+        console.error(`\u9519\u8BEF: \u627E\u4E0D\u5230 ${file}\uFF0C\u8BF7\u5148\u8FD0\u884C snapshot pull`);
+        process.exit(1);
       }
-    } catch {
-    }
-  }
-}
-function writeFlowDirQuickStartScaffold(flowDir, flowName, content, fsImpl) {
-  const filename = flowDirQuickStartFilename(flowName);
-  writeScaffoldIfAllowed(import_path8.default.join(flowDir, filename), content, fsImpl);
-  removeLegacyFlowDirQuickStartFiles(flowDir, filename, fsImpl);
-  return filename;
-}
-function removeLegacyFlowDirScaffoldReadme(flowDir, fsImpl) {
-  const legacy = import_path8.default.join(flowDir, "README.md");
-  if (!fsImpl.existsSync(legacy)) return;
-  try {
-    if (isFlowScaffoldFile(fsImpl.readFileSync(legacy, "utf8"))) {
-      fsImpl.unlinkSync(legacy);
-    }
-  } catch {
-  }
-}
-function writeScaffoldIfAllowed(filePath, content, fsImpl, opts) {
-  if (fsImpl.existsSync(filePath)) {
-    const existing = fsImpl.readFileSync(filePath, "utf8");
-    if (!isFlowScaffoldFile(existing)) {
-      if (!(opts?.upgradeLegacy && isLegacyFlowScaffoldFile(existing))) return false;
+      const snapshot = JSON.parse(import_fs5.default.readFileSync(file, "utf-8"));
+      if (opts.dryRun) {
+        console.log("[dry-run] \u5C06\u63A8\u9001\u56FE\u5FEB\u7167:");
+        console.log(`  \u8282\u70B9\u6570: ${snapshot.nodes?.length ?? "?"}`);
+        console.log(`  \u8FB9\u6570:   ${snapshot.edges?.length ?? "?"}`);
+        ok({ flowId: opts.flow, dryRun: true });
+        return;
+      }
+      const doc = extractDocument(snapshot);
+      await pushCanvasDocument(opts.flow, doc);
+      console.log(`\u2705 \u56FE\u5FEB\u7167\u5DF2\u63A8\u9001`);
+      ok({ flowId: opts.flow, nodeCount: doc.nodes.length, edgeCount: doc.edges.length });
+    } catch (err) {
+      handleError(err);
     }
-  }
-  fsImpl.writeFileSync(filePath, content, "utf8");
-  return true;
+  });
+  return cmd;
 }
 
+// cli/dazi-flow/src/commands/project.ts
+var import_path9 = __toESM(require("path"), 1);
+var import_fs8 = __toESM(require("fs"), 1);
+var import_flowScaffoldDocs = __toESM(require_flowScaffoldDocs(), 1);
+
 // cli/dazi-flow/src/lib/flowVariables.ts
 var import_fs7 = __toESM(require("fs"), 1);
-var import_path9 = __toESM(require("path"), 1);
+var import_path8 = __toESM(require("path"), 1);
 async function ensureFlowDebugRun(flowId) {
   return apiRequest(`${FLOW_API}/${flowId}/debug-run`);
 }
 function variablesDir(flowDir) {
-  return import_path9.default.join(flowDir, VARIABLES_DIR);
+  return import_path8.default.join(flowDir, VARIABLES_DIR);
 }
 function variableFilePath(flowDir, varName) {
   const safe = sanitizeName(varName) || "variable";
-  return import_path9.default.join(variablesDir(flowDir), `${safe}.json`);
+  return import_path8.default.join(variablesDir(flowDir), `${safe}.json`);
 }
 function collectDesignTimeVariableNames(flowDir) {
   const doc = readFlowJson(flowDir);
@@ -4633,11 +5530,10 @@ async function syncAllVariables(flowId, flowDir, previewLimit = 10) {
 }
 
 // cli/dazi-flow/src/commands/project.ts
-function resolveFlowDir(dir) {
-  return import_path10.default.resolve(dir ?? process.cwd());
-}
+var import_flowWorkspaceAudit = __toESM(require_flowWorkspaceAudit(), 1);
+var import_flowDirResolve = __toESM(require_flowDirResolve(), 1);
 function readLocalCanvasNodeCount(flowDir) {
-  const p = import_path10.default.join(flowDir, "flow.json");
+  const p = import_path9.default.join(flowDir, "flow.json");
   if (!import_fs8.default.existsSync(p)) return 0;
   try {
     const doc = JSON.parse(import_fs8.default.readFileSync(p, "utf8"));
@@ -4646,15 +5542,10 @@ function readLocalCanvasNodeCount(flowDir) {
     return 0;
   }
 }
-function inferProjectFolder(flowDir) {
-  const norm = flowDir.replace(/\\/g, "/");
-  const m = norm.match(/(?:^|\/)项目\/(flow_[^/]+)\/流程(?:\/|$)/);
-  return m?.[1];
-}
 function writeFlowPullScaffold(flowDir, meta) {
-  const projectFolder = inferProjectFolder(flowDir) ?? "flow_<\u9879\u76EE\u540D>";
-  const flowName = meta.flowName || import_path10.default.basename(flowDir);
-  const quickStart = buildFlowDirQuickStartMarkdown({
+  const projectFolder = (0, import_flowDirResolve.inferBusinessProjectFolder)(flowDir) ?? "<\u4E1A\u52A1\u9879\u76EE\u540D>";
+  const flowName = meta.flowName || import_path9.default.basename(flowDir);
+  const quickStart = (0, import_flowScaffoldDocs.buildFlowDirQuickStartMarkdown)({
     flowName,
     flowId: meta.flowId,
     projectFolder,
@@ -4663,62 +5554,76 @@ function writeFlowPullScaffold(flowDir, meta) {
     pulledAt: (/* @__PURE__ */ new Date()).toISOString(),
     flowDir
   });
-  writeFlowDirQuickStartScaffold(flowDir, flowName, quickStart, import_fs8.default);
-  removeLegacyFlowDirScaffoldReadme(flowDir, import_fs8.default);
-  const flowsDir = import_path10.default.dirname(flowDir);
-  if (import_path10.default.basename(flowsDir) === "\u6D41\u7A0B") {
-    const flowsReadme = buildFlowsDirReadmeMarkdown({ projectFolder });
-    writeScaffoldIfAllowed(import_path10.default.join(flowsDir, "README.md"), flowsReadme, import_fs8.default, { upgradeLegacy: true });
-    const projectRoot = import_path10.default.dirname(flowsDir);
-    const quickStart2 = buildFlowQuickStartMarkdown({ projectFolder });
-    writeScaffoldIfAllowed(import_path10.default.join(projectRoot, "\u5FEB\u901F\u542F\u52A8.md"), quickStart2, import_fs8.default, { upgradeLegacy: true });
+  (0, import_flowScaffoldDocs.writeFlowDirQuickStartScaffold)(flowDir, flowName, quickStart, import_fs8.default);
+  (0, import_flowScaffoldDocs.removeLegacyFlowDirScaffoldReadme)(flowDir, import_fs8.default);
+  const flowRoot = (0, import_flowScaffoldDocs.resolveFlowRootFromFlowDir)(flowDir);
+  if (flowRoot) {
+    const flowsContainer = import_path9.default.join(flowRoot, "flows");
+    const flowsReadme = (0, import_flowScaffoldDocs.buildFlowsDirReadmeMarkdown)({ projectFolder });
+    if (import_fs8.default.existsSync(flowsContainer)) {
+      (0, import_flowScaffoldDocs.writeScaffoldIfAllowed)(import_path9.default.join(flowsContainer, "README.md"), flowsReadme, import_fs8.default, {
+        upgradeLegacy: true
+      });
+    } else if (import_path9.default.basename(import_path9.default.dirname(flowDir)) === "\u6D41\u7A0B") {
+      (0, import_flowScaffoldDocs.writeScaffoldIfAllowed)(import_path9.default.join(flowRoot, "README.md"), flowsReadme, import_fs8.default, { upgradeLegacy: true });
+    }
+    const rootReadme = (0, import_flowScaffoldDocs.buildFlowRootReadmeMarkdown)({ projectFolder });
+    (0, import_flowScaffoldDocs.writeScaffoldIfAllowed)(import_path9.default.join(flowRoot, "README.md"), rootReadme, import_fs8.default, { upgradeLegacy: true });
+    (0, import_flowScaffoldDocs.removeLegacyFlowRootQuickStart)(flowRoot, import_fs8.default);
   }
 }
 function makeProjectCommand() {
   const cmd = new Command("project").description("\u6D41\u7A0B\u9879\u76EE\u672C\u5730\u6587\u4EF6\u5316\uFF08\u62C9\u53D6/\u63D0\u4EA4/\u72B6\u6001\uFF09");
-  cmd.command("init <name>").description("\u5728 \u9879\u76EE/flow_<name>/ \u521D\u59CB\u5316\u6D41\u7A0B\u9879\u76EE\u9AA8\u67B6").option("--root <dir>", "\u5DE5\u4F5C\u533A\u6839\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--json", "\u8F93\u51FA JSON").action((name, opts) => {
+  cmd.command("init <name>").description("\u5728 \u9879\u76EE/<\u4E1A\u52A1\u540D>/ \u521D\u59CB\u5316\u4E1A\u52A1\u9879\u76EE\u6D41\u7A0B\u9AA8\u67B6\uFF08\u542B \u6D41\u7A0B/flows/\uFF09").option("--root <dir>", "\u5DE5\u4F5C\u533A\u6839\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--json", "\u8F93\u51FA JSON").action((name, opts) => {
     try {
-      const root = import_path10.default.resolve(opts.root ?? process.cwd());
-      const folder = name.startsWith("flow_") ? name : `flow_${name}`;
-      const projectRoot = import_path10.default.join(root, "\u9879\u76EE", folder);
+      const root = import_path9.default.resolve(opts.root ?? process.cwd());
+      const folder = name.trim();
+      if (!folder) {
+        console.error("\u9519\u8BEF: \u4E1A\u52A1\u9879\u76EE\u540D\u4E0D\u80FD\u4E3A\u7A7A");
+        process.exit(1);
+      }
+      const projectRoot = import_path9.default.join(root, "\u9879\u76EE", folder);
       if (import_fs8.default.existsSync(projectRoot)) {
         console.error(`\u9519\u8BEF: \u9879\u76EE\u76EE\u5F55\u5DF2\u5B58\u5728: ${projectRoot}`);
         process.exit(1);
       }
-      import_fs8.default.mkdirSync(import_path10.default.join(projectRoot, "\u6D41\u7A0B"), { recursive: true });
-      import_fs8.default.mkdirSync(import_path10.default.join(projectRoot, "\u89C4\u5212"), { recursive: true });
+      import_fs8.default.mkdirSync(import_path9.default.join(projectRoot, "\u6D41\u7A0B", "flows"), { recursive: true });
+      import_fs8.default.mkdirSync(import_path9.default.join(projectRoot, "\u6D41\u7A0B", "\u89C4\u5212"), { recursive: true });
       import_fs8.default.writeFileSync(
-        import_path10.default.join(projectRoot, "README.md"),
-        `# ${name}
+        import_path9.default.join(projectRoot, "README.md"),
+        `# ${folder}
 
-\u6570\u636E\u6D41\u7A0B\u9879\u76EE\uFF08\u4E0D\u7ED1\u5B9A\u6570\u636E\u7A7A\u95F4/\u8FDE\u63A5\uFF09\u3002\u6D41\u7A0B\u4F4D\u4E8E \`\u6D41\u7A0B/\` \u76EE\u5F55\u3002
+\u4E1A\u52A1\u9879\u76EE\uFF08\u672C\u4F53 / \u6D41\u7A0B / \u5E94\u7528\uFF09\u3002\u6D41\u7A0B\u4F4D\u4E8E \`\u6D41\u7A0B/flows/\`\u3002
 
-\u8BE6\u89C1 \`\u5FEB\u901F\u542F\u52A8.md\` \u4E0E \`\u8D44\u6E90/docs/flow/\`\u3002
+\u8BE6\u89C1 \`\u6D41\u7A0B/README.md\` \u4E0E \`\u8D44\u6E90/docs/flow/\`\u3002
 `,
         "utf8"
       );
-      writeScaffoldIfAllowed(
-        import_path10.default.join(projectRoot, "\u5FEB\u901F\u542F\u52A8.md"),
-        buildFlowQuickStartMarkdown({ projectFolder: folder }),
+      const flowRoot = import_path9.default.join(projectRoot, "\u6D41\u7A0B");
+      import_fs8.default.mkdirSync(import_path9.default.join(flowRoot, "flows"), { recursive: true });
+      (0, import_flowScaffoldDocs.writeScaffoldIfAllowed)(
+        import_path9.default.join(flowRoot, "README.md"),
+        (0, import_flowScaffoldDocs.buildFlowRootReadmeMarkdown)({ projectFolder: folder }),
         import_fs8.default
       );
-      writeScaffoldIfAllowed(
-        import_path10.default.join(projectRoot, "\u6D41\u7A0B", "README.md"),
-        buildFlowsDirReadmeMarkdown({ projectFolder: folder }),
+      (0, import_flowScaffoldDocs.writeScaffoldIfAllowed)(
+        import_path9.default.join(flowRoot, "flows", "README.md"),
+        (0, import_flowScaffoldDocs.buildFlowsDirReadmeMarkdown)({ projectFolder: folder }),
         import_fs8.default
       );
+      (0, import_flowScaffoldDocs.removeLegacyFlowRootQuickStart)(flowRoot, import_fs8.default);
       console.log(`\u2705 \u6D41\u7A0B\u9879\u76EE\u5DF2\u521D\u59CB\u5316: ${projectRoot}`);
       ok({ projectRoot, folder });
     } catch (err) {
       handleError(err);
     }
   });
-  cmd.command("pull").description("\u4ECE\u5E73\u53F0\u62C9\u53D6\u6D41\u7A0B\u5FEB\u7167\u5E76\u62C6\u5206\u4E3A\u672C\u5730\u6587\u4EF6\uFF08flow.json + \u8282\u70B9/<\u540D>/code.*\uFF09").requiredOption("--flow <flowId>", "Flow ID").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
+  cmd.command("pull").description("\u4ECE\u5E73\u53F0\u62C9\u53D6\u6D41\u7A0B\u5FEB\u7167\u5E76\u62C6\u5206\u4E3A\u672C\u5730\u6587\u4EF6\uFF08flow.json + \u8282\u70B9/<\u540D>/code.*\uFF09").requiredOption("--flow <flowId>", "Flow ID").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
     try {
-      const flowDir = resolveFlowDir(opts.dir);
+      const flowDir = (0, import_flowDirResolve.resolveFlowDir)(opts.dir, { json: opts.json });
       import_fs8.default.mkdirSync(flowDir, { recursive: true });
       const localCount = readLocalCanvasNodeCount(flowDir);
-      const preAudit = localCount > 0 ? auditFlowWorkspace(flowDir) : null;
+      const preAudit = localCount > 0 ? (0, import_flowWorkspaceAudit.auditFlowWorkspace)(flowDir) : null;
       if (preAudit && !preAudit.ok) {
         console.warn("\u26A0\uFE0F  flow.json \u4E0E flow.meta.json \u4E0D\u4E00\u81F4\uFF1Bpull \u5C06\u7528\u5E73\u53F0\u5FEB\u7167\u8986\u76D6 flow.json\u3002\u624B\u6539\u753B\u5E03\u672A push \u65F6\u53EF\u80FD\u4E22\u5931\uFF0C\u53EF\u5148 repair-meta \u6216 push --canvas\u3002");
       }
@@ -4743,7 +5648,7 @@ function makeProjectCommand() {
       const codeNodes = Object.values(nodeMetas).filter((m) => m.codeFile).length;
       writeFlowPullScaffold(flowDir, {
         flowId: opts.flow,
-        flowName: String(flowMeta.name ?? import_path10.default.basename(flowDir)),
+        flowName: String(flowMeta.name ?? import_path9.default.basename(flowDir)),
         nodeCount: strippedDoc.nodes.length,
         codeNodeCount: codeNodes
       });
@@ -4762,9 +5667,9 @@ function makeProjectCommand() {
       handleError(err);
     }
   });
-  cmd.command("push").description("\u63D0\u4EA4\u672C\u5730\u6539\u52A8\u5230\u5E73\u53F0\uFF08\u9ED8\u8BA4\u4EC5\u589E\u91CF\u63A8\u9001\u5DF2\u6539\u4EE3\u7801\u8282\u70B9\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--canvas", "\u540C\u65F6\u5168\u91CF\u63A8\u9001\u753B\u5E03\uFF08flow.json\uFF0CPUT /flows/{id} \u6574\u56FE replace\uFF09").option("--force", "\u5FFD\u7565\u8FDC\u7AEF\u7248\u672C\u51B2\u7A81\uFF08\u8986\u76D6\uFF09").option("--dry-run", "\u4EC5\u663E\u793A\u5C06\u63A8\u9001\u7684\u5185\u5BB9").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
+  cmd.command("push").description("\u63D0\u4EA4\u672C\u5730\u6539\u52A8\u5230\u5E73\u53F0\uFF08\u9ED8\u8BA4\u4EC5\u589E\u91CF\u63A8\u9001\u5DF2\u6539\u4EE3\u7801\u8282\u70B9\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--canvas", "\u540C\u65F6\u5168\u91CF\u63A8\u9001\u753B\u5E03\uFF08flow.json\uFF0CPUT /flows/{id} \u6574\u56FE replace\uFF09").option("--force", "\u5FFD\u7565\u8FDC\u7AEF\u7248\u672C\u51B2\u7A81\uFF08\u8986\u76D6\uFF09").option("--dry-run", "\u4EC5\u663E\u793A\u5C06\u63A8\u9001\u7684\u5185\u5BB9").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
     try {
-      const flowDir = resolveFlowDir(opts.dir);
+      const flowDir = (0, import_flowDirResolve.resolveFlowDir)(opts.dir, { json: opts.json });
       const meta = readMeta(flowDir);
       if (!meta?.flowId) {
         console.error("\u9519\u8BEF: \u7F3A\u5C11 flow.meta.json \u6216\u672A\u5173\u8054 flowId\uFF0C\u8BF7\u5148 project pull");
@@ -4812,9 +5717,9 @@ function makeProjectCommand() {
       handleError(err);
     }
   });
-  cmd.command("status").description("\u663E\u793A\u672C\u5730\u76F8\u5BF9\u4E0A\u6B21\u62C9\u53D6\u7684\u6539\u52A8\uFF08\u4EE3\u7801\u8282\u70B9\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--json", "\u8F93\u51FA JSON").action((opts) => {
+  cmd.command("status").description("\u663E\u793A\u672C\u5730\u76F8\u5BF9\u4E0A\u6B21\u62C9\u53D6\u7684\u6539\u52A8\uFF08\u4EE3\u7801\u8282\u70B9\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--json", "\u8F93\u51FA JSON").action((opts) => {
     try {
-      const flowDir = resolveFlowDir(opts.dir);
+      const flowDir = (0, import_flowDirResolve.resolveFlowDir)(opts.dir, { json: opts.json });
       const meta = readMeta(flowDir);
       if (!meta) {
         console.error("\u9519\u8BEF: \u7F3A\u5C11 flow.meta.json\uFF0C\u8BF7\u5148 project pull");
@@ -4839,10 +5744,10 @@ function makeProjectCommand() {
       handleError(err);
     }
   });
-  cmd.command("doctor").description("\u68C0\u67E5 flow.json / flow.meta.json / \u8282\u70B9/ \u4E00\u81F4\u6027").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--json", "\u8F93\u51FA JSON").action((opts) => {
+  cmd.command("doctor").description("\u68C0\u67E5 flow.json / flow.meta.json / \u8282\u70B9/ \u4E00\u81F4\u6027").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--json", "\u8F93\u51FA JSON").action((opts) => {
     try {
-      const flowDir = resolveFlowDir(opts.dir);
-      const audit = auditFlowWorkspace(flowDir);
+      const flowDir = (0, import_flowDirResolve.resolveFlowDir)(opts.dir, { json: opts.json });
+      const audit = (0, import_flowWorkspaceAudit.auditFlowWorkspace)(flowDir);
       if (!opts.json) {
         console.log(`\u6D41\u7A0B\u76EE\u5F55: ${flowDir}`);
         console.log(audit.ok ? "\u2705 \u672C\u5730\u6587\u4EF6\u4E00\u81F4" : "\u26A0\uFE0F  \u5B58\u5728\u4E0D\u4E00\u81F4\u9879");
@@ -4857,16 +5762,16 @@ function makeProjectCommand() {
       handleError(err);
     }
   });
-  cmd.command("repair-meta").description("\u6839\u636E flow.json \u4E0E \u8282\u70B9/ \u76EE\u5F55\u4FEE\u590D flow.meta.json\uFF08\u53CA node.info.json\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--json", "\u8F93\u51FA JSON").action((opts) => {
+  cmd.command("repair-meta").description("\u6839\u636E flow.json \u4E0E \u8282\u70B9/ \u76EE\u5F55\u4FEE\u590D flow.meta.json\uFF08\u53CA node.info.json\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--json", "\u8F93\u51FA JSON").action((opts) => {
     try {
-      const flowDir = resolveFlowDir(opts.dir);
-      const result = repairFlowMeta(flowDir);
+      const flowDir = (0, import_flowDirResolve.resolveFlowDir)(opts.dir, { json: opts.json });
+      const result = (0, import_flowWorkspaceAudit.repairFlowMeta)(flowDir);
       const meta = readMeta(flowDir);
       if (meta?.flowId) {
-        const audit = auditFlowWorkspace(flowDir);
+        const audit = (0, import_flowWorkspaceAudit.auditFlowWorkspace)(flowDir);
         writeFlowPullScaffold(flowDir, {
           flowId: String(meta.flowId),
-          flowName: meta.flowName || import_path10.default.basename(flowDir),
+          flowName: meta.flowName || import_path9.default.basename(flowDir),
           nodeCount: audit.canvasNodeCount,
           codeNodeCount: audit.canvasCodeNodeCount,
           pulledAt: meta.lastPulledAt,
@@ -4883,7 +5788,7 @@ function makeProjectCommand() {
         }
         for (const p of result.wroteNodeInfo) console.log(`  + node.info.json \u2192 ${p}`);
         for (const w of result.warnings) console.log(`  \u26A0 ${w}`);
-        const audit = auditFlowWorkspace(flowDir);
+        const audit = (0, import_flowWorkspaceAudit.auditFlowWorkspace)(flowDir);
         console.log(audit.ok ? "\u2705 doctor \u68C0\u67E5\u901A\u8FC7" : "\u26A0\uFE0F  \u4ECD\u6709\u4E0D\u4E00\u81F4\uFF0C\u8BF7\u67E5\u770B doctor \u8F93\u51FA");
       }
       ok(result);
@@ -4895,8 +5800,9 @@ function makeProjectCommand() {
 }
 
 // cli/dazi-flow/src/commands/node.ts
-var import_path11 = __toESM(require("path"), 1);
+var import_path10 = __toESM(require("path"), 1);
 var import_fs9 = __toESM(require("fs"), 1);
+var import_flowDirResolve2 = __toESM(require_flowDirResolve(), 1);
 var NODE_TYPE_REQUIRED = {
   "database-source": ["connectionId", "sql"],
   "database-sink": ["connectionId", "tableName"],
@@ -4927,9 +5833,6 @@ var NODE_TYPE_LABELS = {
   "folder-resource-import": "\u6587\u4EF6\u5939\u8D44\u6E90\u5BFC\u5165",
   "folder-resource-register": "\u8D44\u6E90\u6CE8\u518C"
 };
-function resolveFlowDir2(dir) {
-  return import_path11.default.resolve(dir ?? process.cwd());
-}
 function requireMeta(flowDir) {
   const meta = readMeta(flowDir);
   if (!meta?.flowId) {
@@ -4963,9 +5866,9 @@ function makeNodeCommand() {
     }
     ok({ types });
   });
-  cmd.command("pull").description("\u62C9\u53D6\u5355\u4E2A\u4EE3\u7801\u8282\u70B9\uFF08\u8986\u76D6\u672C\u5730 code.*\uFF09").requiredOption("--node <uuid>", "\u8282\u70B9 node_uuid").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
+  cmd.command("pull").description("\u62C9\u53D6\u5355\u4E2A\u4EE3\u7801\u8282\u70B9\uFF08\u8986\u76D6\u672C\u5730 code.*\uFF09").requiredOption("--node <uuid>", "\u8282\u70B9 node_uuid").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
     try {
-      const flowDir = resolveFlowDir2(opts.dir);
+      const flowDir = (0, import_flowDirResolve2.resolveFlowDir)(opts.dir, { json: opts.json });
       const { meta, flowId } = requireMeta(flowDir);
       const r = await pullCodeNode(flowId, flowDir, meta, opts.node);
       writeMeta(flowDir, meta);
@@ -4975,9 +5878,9 @@ function makeNodeCommand() {
       handleError(err);
     }
   });
-  cmd.command("push").description("\u63D0\u4EA4\u5355\u4E2A\u4EE3\u7801\u8282\u70B9\uFF08\u4E50\u89C2\u9501\uFF1B\u8FDC\u7AEF\u51B2\u7A81\u9700 --force\uFF09").requiredOption("--node <uuid>", "\u8282\u70B9 node_uuid").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--force", "\u5FFD\u7565\u8FDC\u7AEF\u7248\u672C\u51B2\u7A81\uFF08\u8986\u76D6\uFF09").option("--dry-run", "\u4EC5\u68C0\u6D4B\uFF0C\u4E0D\u63D0\u4EA4").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
+  cmd.command("push").description("\u63D0\u4EA4\u5355\u4E2A\u4EE3\u7801\u8282\u70B9\uFF08\u4E50\u89C2\u9501\uFF1B\u8FDC\u7AEF\u51B2\u7A81\u9700 --force\uFF09").requiredOption("--node <uuid>", "\u8282\u70B9 node_uuid").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--force", "\u5FFD\u7565\u8FDC\u7AEF\u7248\u672C\u51B2\u7A81\uFF08\u8986\u76D6\uFF09").option("--dry-run", "\u4EC5\u68C0\u6D4B\uFF0C\u4E0D\u63D0\u4EA4").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
     try {
-      const flowDir = resolveFlowDir2(opts.dir);
+      const flowDir = (0, import_flowDirResolve2.resolveFlowDir)(opts.dir, { json: opts.json });
       const { meta, flowId } = requireMeta(flowDir);
       const r = await pushCodeNode(flowId, flowDir, meta, opts.node, opts);
       writeMeta(flowDir, meta);
@@ -4991,9 +5894,9 @@ function makeNodeCommand() {
       handleError(err);
     }
   });
-  cmd.command("new").description("\u65B0\u5EFA\u8282\u70B9\uFF08POST \u5E73\u53F0\uFF0C\u5E76\u5199\u5165\u672C\u5730 flow.json \u4E0E\u4EE3\u7801\u6A21\u677F\uFF09").requiredOption("--type <nodeType>", "\u8282\u70B9\u7C7B\u578B\uFF08\u89C1 node types\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--label <label>", "\u8282\u70B9\u663E\u793A\u540D").option("--id <nodeId>", "\u8BED\u4E49 id\uFF08\u7F3A\u7701\u7531\u5E73\u53F0\u751F\u6210\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
+  cmd.command("new").description("\u65B0\u5EFA\u8282\u70B9\uFF08POST \u5E73\u53F0\uFF0C\u5E76\u5199\u5165\u672C\u5730 flow.json \u4E0E\u4EE3\u7801\u6A21\u677F\uFF09").requiredOption("--type <nodeType>", "\u8282\u70B9\u7C7B\u578B\uFF08\u89C1 node types\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--label <label>", "\u8282\u70B9\u663E\u793A\u540D").option("--id <nodeId>", "\u8BED\u4E49 id\uFF08\u7F3A\u7701\u7531\u5E73\u53F0\u751F\u6210\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
     try {
-      const flowDir = resolveFlowDir2(opts.dir);
+      const flowDir = (0, import_flowDirResolve2.resolveFlowDir)(opts.dir, { json: opts.json });
       const { meta, flowId } = requireMeta(flowDir);
       const created = await apiRequest(`${FLOW_API}/${flowId}/nodes`, {
         method: "POST",
@@ -5014,19 +5917,19 @@ function makeNodeCommand() {
         data: created.data ?? {}
       };
       doc.nodes.push(stripped);
-      import_fs9.default.writeFileSync(import_path11.default.join(flowDir, FLOW_JSON), JSON.stringify(doc, null, 2), "utf8");
+      import_fs9.default.writeFileSync(import_path10.default.join(flowDir, FLOW_JSON), JSON.stringify(doc, null, 2), "utf8");
       const nodeMeta = { nodeId: String(created.id ?? ""), nodeType: opts.type };
       const codeKey = NODE_TYPE_CODE_DATA_KEY[opts.type];
       if (codeKey) {
         const language = codeLanguageForNodeType(opts.type);
         const ext = codeFileExt(language);
         const dirName = sanitizeName(opts.label || String(created.id ?? "") || opts.type);
-        const nodeDirAbs = import_path11.default.join(flowDir, NODES_DIR, dirName);
+        const nodeDirAbs = import_path10.default.join(flowDir, NODES_DIR, dirName);
         import_fs9.default.mkdirSync(nodeDirAbs, { recursive: true });
         const codeFile = `code.${ext}`;
         const template = CODE_TEMPLATES[language ?? ""] ?? "";
-        import_fs9.default.writeFileSync(import_path11.default.join(nodeDirAbs, codeFile), template, "utf8");
-        nodeMeta.dir = import_path11.default.posix.join(NODES_DIR, dirName);
+        import_fs9.default.writeFileSync(import_path10.default.join(nodeDirAbs, codeFile), template, "utf8");
+        nodeMeta.dir = import_path10.default.posix.join(NODES_DIR, dirName);
         nodeMeta.codeFile = codeFile;
         nodeMeta.codeLanguage = language;
         nodeMeta.codeHash = sha1(template);
@@ -5046,11 +5949,12 @@ function makeNodeCommand() {
 }
 
 // cli/dazi-flow/src/commands/run.ts
-var import_path13 = __toESM(require("path"), 1);
+var import_path12 = __toESM(require("path"), 1);
+var import_flowDirResolve3 = __toESM(require_flowDirResolve(), 1);
 
 // cli/dazi-flow/src/lib/flowRun.ts
 var import_fs10 = __toESM(require("fs"), 1);
-var import_path12 = __toESM(require("path"), 1);
+var import_path11 = __toESM(require("path"), 1);
 function classifyError(text) {
   const t = (text || "").toLowerCase();
   if (/(变量|variable).*(不存在|未找到|missing|not found|undefined)|缺少.*输入|no.*input|上游/.test(t)) {
@@ -5080,7 +5984,7 @@ function classifyError(text) {
   return { category: "\u672A\u77E5", hint: "\u8BF7\u67E5\u770B\u5B8C\u6574 traceback \u4E0E\u65E5\u5FD7\u3002" };
 }
 function runDir(flowDir) {
-  const d = import_path12.default.join(flowDir, RUN_DIR);
+  const d = import_path11.default.join(flowDir, RUN_DIR);
   import_fs10.default.mkdirSync(d, { recursive: true });
   return d;
 }
@@ -5088,7 +5992,7 @@ function safeBase(name) {
   return (name || "run").replace(/[<>:"/\\|?*\x00-\x1f]/g, "_").trim() || "run";
 }
 function writeLastRun(flowDir, base, payload) {
-  const p = import_path12.default.join(runDir(flowDir), `${safeBase(base)}.last-run.json`);
+  const p = import_path11.default.join(runDir(flowDir), `${safeBase(base)}.last-run.json`);
   import_fs10.default.writeFileSync(p, JSON.stringify(payload, null, 2), "utf8");
   return p;
 }
@@ -5126,7 +6030,7 @@ function writeErrorMarkdown(flowDir, base, input) {
   if (input.failureBundle != null) {
     lines.push("## FailureBundle", "", "```json", JSON.stringify(input.failureBundle, null, 2), "```", "");
   }
-  const p = import_path12.default.join(runDir(flowDir), `${safeBase(base)}.last-error.md`);
+  const p = import_path11.default.join(runDir(flowDir), `${safeBase(base)}.last-error.md`);
   import_fs10.default.writeFileSync(p, lines.join("\n"), "utf8");
   return p;
 }
@@ -5260,16 +6164,13 @@ function writeRunProgressMarkdown(flowDir, base, snap, runId) {
       }
     }
   }
-  const p = import_path12.default.join(runDir(flowDir), `${safeBase(base)}.last-run.md`);
+  const p = import_path11.default.join(runDir(flowDir), `${safeBase(base)}.last-run.md`);
   import_fs10.default.writeFileSync(p, lines.join("\n"), "utf8");
   return p;
 }
 
 // cli/dazi-flow/src/commands/run.ts
 var FLOW_API2 = "/api/data-pipelines/v1/flows";
-function resolveFlowDir3(dir) {
-  return import_path13.default.resolve(dir ?? process.cwd());
-}
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
@@ -5428,9 +6329,9 @@ function makeRunCommand() {
       handleError(err);
     }
   });
-  cmd.command("node-exec").description("\u6D4B\u8BD5\u8FD0\u884C\u5355\u4E2A\u8282\u70B9\uFF08\u6309 node_uuid\uFF0C\u7ED3\u679C\u843D\u76D8 _run/\uFF09").requiredOption("--node <uuid>", "\u8282\u70B9 node_uuid").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
+  cmd.command("node-exec").description("\u6D4B\u8BD5\u8FD0\u884C\u5355\u4E2A\u8282\u70B9\uFF08\u6309 node_uuid\uFF0C\u7ED3\u679C\u843D\u76D8 _run/\uFF09").requiredOption("--node <uuid>", "\u8282\u70B9 node_uuid").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
     try {
-      const flowDir = resolveFlowDir3(opts.dir);
+      const flowDir = (0, import_flowDirResolve3.resolveFlowDir)(opts.dir, { json: opts.json });
       const meta = readMeta(flowDir);
       if (!meta?.flowId) {
         console.error("\u9519\u8BEF: \u7F3A\u5C11 flow.meta.json\uFF0C\u8BF7\u5148 project pull");
@@ -5443,7 +6344,7 @@ function makeRunCommand() {
         console.error(`\u9519\u8BEF: \u672A\u627E\u5230\u8282\u70B9 ${opts.node} \u7684\u8BED\u4E49 id\uFF08meta.nodeId\uFF09`);
         process.exit(1);
       }
-      const base = nodeMeta?.dir ? import_path13.default.basename(nodeMeta.dir) : nodeId;
+      const base = nodeMeta?.dir ? import_path12.default.basename(nodeMeta.dir) : nodeId;
       await apiRequest(`${FLOW_API2}/${flowId}/debug-run`);
       const result = await apiRequest(
         `${FLOW_API2}/${flowId}/nodes/${encodeURIComponent(nodeId)}/run`,
@@ -5483,9 +6384,9 @@ function makeRunCommand() {
       handleError(err);
     }
   });
-  cmd.command("flow-exec").description("\u8FD0\u884C\u6574\u6D41\u7A0B\u5E76\u7B49\u5F85\u7ED3\u679C\uFF08\u5931\u8D25\u65F6\u843D\u76D8 _run/flow.last-error.md\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--flow <flowId>", "Flow ID\uFF08\u7F3A\u7701\u8BFB meta\uFF09").option("--type <type>", "debug | preview", "debug").option("--timeout <sec>", "\u7B49\u5F85\u8D85\u65F6\u79D2\u6570", "120").option("--json", "\u8F93\u51FA JSON").option("--designer-progress", "\u8F93\u51FA NDJSON \u8FDB\u5EA6\u4E8B\u4EF6\uFF08\u4F9B VS Code \u8BBE\u8BA1\u5668\u89E3\u6790\uFF09").action(async (opts) => {
+  cmd.command("flow-exec").description("\u8FD0\u884C\u6574\u6D41\u7A0B\u5E76\u7B49\u5F85\u7ED3\u679C\uFF08\u5931\u8D25\u65F6\u843D\u76D8 _run/flow.last-error.md\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--flow <flowId>", "Flow ID\uFF08\u7F3A\u7701\u8BFB meta\uFF09").option("--type <type>", "debug | preview", "debug").option("--timeout <sec>", "\u7B49\u5F85\u8D85\u65F6\u79D2\u6570", "120").option("--json", "\u8F93\u51FA JSON").option("--designer-progress", "\u8F93\u51FA NDJSON \u8FDB\u5EA6\u4E8B\u4EF6\uFF08\u4F9B VS Code \u8BBE\u8BA1\u5668\u89E3\u6790\uFF09").action(async (opts) => {
     try {
-      const flowDir = resolveFlowDir3(opts.dir);
+      const flowDir = (0, import_flowDirResolve3.resolveFlowDir)(opts.dir, { json: opts.json });
       const meta = readMeta(flowDir);
       const flowId = opts.flow ?? (meta?.flowId != null ? String(meta.flowId) : "");
       if (!flowId) {
@@ -5589,9 +6490,9 @@ function makeRunCommand() {
       handleError(err);
     }
   });
-  cmd.command("failure").description("\u62C9\u53D6\u67D0\u6B21 Run \u7684 failure-bundle \u5E76\u843D\u76D8 _run/flow.last-error.md").requiredOption("--run <runId>", "Run ID").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
+  cmd.command("failure").description("\u62C9\u53D6\u67D0\u6B21 Run \u7684 failure-bundle \u5E76\u843D\u76D8 _run/flow.last-error.md").requiredOption("--run <runId>", "Run ID").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
     try {
-      const flowDir = resolveFlowDir3(opts.dir);
+      const flowDir = (0, import_flowDirResolve3.resolveFlowDir)(opts.dir, { json: opts.json });
       const bundle = await apiRequest(`${FLOW_API2}/runs/${opts.run}/failure-bundle`);
       const errorFile = writeErrorMarkdown(flowDir, "flow", {
         title: `\u5931\u8D25\u5206\u6790\uFF08Run ${opts.run}\uFF09`,
@@ -5608,7 +6509,7 @@ function makeRunCommand() {
 }
 
 // cli/dazi-flow/src/commands/source.ts
-var import_path14 = __toESM(require("path"), 1);
+var import_path13 = __toESM(require("path"), 1);
 var import_fs11 = __toESM(require("fs"), 1);
 function makeSourceCommand() {
   const cmd = new Command("source").description("\u6570\u636E\u6E90\u7BA1\u7406");
@@ -5683,9 +6584,9 @@ function makeSourceCommand() {
         `/api/connections/${sourceId}/tables${qs}`
       );
       const ws = resolveWorkspace();
-      const dataDir = import_path14.default.join(ws.flows, opts.flow, "data");
+      const dataDir = import_path13.default.join(ws.flows, opts.flow, "data");
       if (!import_fs11.default.existsSync(dataDir)) import_fs11.default.mkdirSync(dataDir, { recursive: true });
-      const outFile = import_path14.default.join(dataDir, `${tableName}.schema.json`);
+      const outFile = import_path13.default.join(dataDir, `${tableName}.schema.json`);
       import_fs11.default.writeFileSync(outFile, JSON.stringify({
         sourceId,
         tableName,
@@ -5760,7 +6661,7 @@ function makeDataspaceCommand() {
 }
 
 // cli/dazi-flow/src/commands/plan.ts
-var import_path15 = __toESM(require("path"), 1);
+var import_path14 = __toESM(require("path"), 1);
 var import_fs12 = __toESM(require("fs"), 1);
 function makePlanCommand() {
   const cmd = new Command("plan").description("Flow \u6267\u884C\u8BA1\u5212");
@@ -5772,8 +6673,8 @@ function makePlanCommand() {
         { method: "POST", body: { input } }
       );
       const ws = resolveWorkspace();
-      const outFile = opts.out ?? import_path15.default.join(ws.flows, flowId, "plans", "plan.json");
-      const outDir = import_path15.default.dirname(outFile);
+      const outFile = opts.out ?? import_path14.default.join(ws.flows, flowId, "plans", "plan.json");
+      const outDir = import_path14.default.dirname(outFile);
       if (!import_fs12.default.existsSync(outDir)) import_fs12.default.mkdirSync(outDir, { recursive: true });
       import_fs12.default.writeFileSync(outFile, JSON.stringify(plan, null, 2), "utf-8");
       if (opts.json) {
@@ -5789,7 +6690,7 @@ function makePlanCommand() {
   cmd.command("apply <flowId>").description("\u5C06\u672C\u5730\u8BA1\u5212\u6587\u4EF6\u63A8\u9001\u5230\u5E73\u53F0\u5E76\u5E94\u7528").option("--file <path>", "\u8BA1\u5212\u6587\u4EF6\uFF08\u9ED8\u8BA4 flows/<flowId>/plans/plan.json\uFF09").option("--dry-run", "\u4EC5\u9A8C\u8BC1\uFF0C\u4E0D\u5B9E\u9645\u5E94\u7528").action(async (flowId, opts) => {
     try {
       const ws = resolveWorkspace();
-      const planFile = opts.file ?? import_path15.default.join(ws.flows, flowId, "plans", "plan.json");
+      const planFile = opts.file ?? import_path14.default.join(ws.flows, flowId, "plans", "plan.json");
       if (!import_fs12.default.existsSync(planFile)) {
         console.error(`\u8BA1\u5212\u6587\u4EF6\u4E0D\u5B58\u5728: ${planFile}\uFF0C\u8BF7\u5148\u6267\u884C plan compile`);
         process.exit(1);
@@ -5809,8 +6710,8 @@ function makePlanCommand() {
         `/api/data-pipelines/v1/flows/${flowId}/snapshot`
       );
       const ws = resolveWorkspace();
-      const outFile = opts.out ?? import_path15.default.join(ws.flows, flowId, "plans", `plan-${opts.type}.md`);
-      const outDir = import_path15.default.dirname(outFile);
+      const outFile = opts.out ?? import_path14.default.join(ws.flows, flowId, "plans", `plan-${opts.type}.md`);
+      const outDir = import_path14.default.dirname(outFile);
       if (!import_fs12.default.existsSync(outDir)) import_fs12.default.mkdirSync(outDir, { recursive: true });
       import_fs12.default.writeFileSync(outFile, doc.content, "utf-8");
       console.log(`\u2705 Markdown \u6587\u6863\u5DF2\u4FDD\u5B58: ${outFile}`);
@@ -5825,8 +6726,8 @@ function makePlanCommand() {
         `/api/data-pipelines/v1/dq-ai-code-prompt`
       );
       const ws = resolveWorkspace();
-      const outFile = opts.out ?? import_path15.default.join(ws.flows, flowId, "plans", "llm-guide.md");
-      const outDir = import_path15.default.dirname(outFile);
+      const outFile = opts.out ?? import_path14.default.join(ws.flows, flowId, "plans", "llm-guide.md");
+      const outDir = import_path14.default.dirname(outFile);
       if (!import_fs12.default.existsSync(outDir)) import_fs12.default.mkdirSync(outDir, { recursive: true });
       import_fs12.default.writeFileSync(outFile, guide.content, "utf-8");
       console.log(`\u2705 LLM \u5F15\u5BFC\u6587\u6863\u5DF2\u4FDD\u5B58: ${outFile}`);
@@ -5841,10 +6742,10 @@ function makePlanCommand() {
         `/api/data-pipelines/v1/compile-plan`
       );
       const ws = resolveWorkspace();
-      const outDir = opts.out ?? import_path15.default.join(ws.flows, flowId, "plans", "db");
+      const outDir = opts.out ?? import_path14.default.join(ws.flows, flowId, "plans", "db");
       if (!import_fs12.default.existsSync(outDir)) import_fs12.default.mkdirSync(outDir, { recursive: true });
       for (const f of scaffold.files ?? []) {
-        const outFile = import_path15.default.join(outDir, f.name);
+        const outFile = import_path14.default.join(outDir, f.name);
         import_fs12.default.writeFileSync(outFile, f.content, "utf-8");
         console.log(`  \u2192 ${outFile}`);
       }
@@ -5858,7 +6759,7 @@ function makePlanCommand() {
 }
 
 // cli/dazi-flow/src/commands/file.ts
-var import_path16 = __toESM(require("path"), 1);
+var import_path15 = __toESM(require("path"), 1);
 var import_fs13 = __toESM(require("fs"), 1);
 function makeFileCommand() {
   const cmd = new Command("file").description("\u5E73\u53F0\u6258\u7BA1\u6587\u4EF6\u7BA1\u7406");
@@ -5904,13 +6805,13 @@ function makeFileCommand() {
   });
   cmd.command("upload <localFile>").description("\u4E0A\u4F20\u672C\u5730\u6587\u4EF6\u5230\u5E73\u53F0").option("--space <spaceId>", "\u7A7A\u95F4 ID").option("--remote-path <path>", "\u8FDC\u7AEF\u8DEF\u5F84\uFF08\u9ED8\u8BA4\u4E0E\u6587\u4EF6\u540D\u76F8\u540C\uFF09").option("--overwrite", "\u8986\u76D6\u5DF2\u5B58\u5728\u6587\u4EF6").action(async (localFile, opts) => {
     try {
-      const filePath = import_path16.default.resolve(localFile);
+      const filePath = import_path15.default.resolve(localFile);
       if (!import_fs13.default.existsSync(filePath)) {
         console.error(`\u6587\u4EF6\u4E0D\u5B58\u5728: ${filePath}`);
         process.exit(1);
       }
       const content = import_fs13.default.readFileSync(filePath);
-      const remotePath = opts.remotePath ?? import_path16.default.basename(filePath);
+      const remotePath = opts.remotePath ?? import_path15.default.basename(filePath);
       const endpoint = opts.space ? `/api/v1/spaces/${opts.space}/files/upload` : "/api/v1/files/upload";
       const result = await apiRequest(endpoint, {
         method: "POST",
@@ -5936,14 +6837,14 @@ function makeFileCommand() {
       const content = data.encoding === "base64" ? Buffer.from(data.content, "base64") : Buffer.from(data.content, "utf-8");
       let outFile;
       if (opts.out) {
-        outFile = import_path16.default.resolve(opts.out);
+        outFile = import_path15.default.resolve(opts.out);
       } else if (opts.flow) {
         const ws = resolveWorkspace();
-        const dataDir = import_path16.default.join(ws.flows, opts.flow, "data");
+        const dataDir = import_path15.default.join(ws.flows, opts.flow, "data");
         if (!import_fs13.default.existsSync(dataDir)) import_fs13.default.mkdirSync(dataDir, { recursive: true });
-        outFile = import_path16.default.join(dataDir, import_path16.default.basename(remotePath));
+        outFile = import_path15.default.join(dataDir, import_path15.default.basename(remotePath));
       } else {
-        outFile = import_path16.default.join(process.cwd(), import_path16.default.basename(remotePath));
+        outFile = import_path15.default.join(process.cwd(), import_path15.default.basename(remotePath));
       }
       import_fs13.default.writeFileSync(outFile, content);
       console.log(`\u2705 \u5DF2\u4E0B\u8F7D: ${outFile}`);
@@ -5956,18 +6857,18 @@ function makeFileCommand() {
 }
 
 // cli/dazi-flow/src/commands/data.ts
-var import_path17 = __toESM(require("path"), 1);
+var import_path16 = __toESM(require("path"), 1);
 var import_fs14 = __toESM(require("fs"), 1);
 function makeDataCommand() {
   const cmd = new Command("data").description("Flow \u6570\u636E\u4E0A\u4F20");
   cmd.command("upload <localFile>").description("\u5C06\u672C\u5730\u6570\u636E\u6587\u4EF6\u4E0A\u4F20\u5230\u5E73\u53F0\uFF08CSV / JSON / Parquet\uFF09").option("--space <spaceId>", "\u76EE\u6807\u7A7A\u95F4 ID").option("--flow <flowId>", "\u5173\u8054 Flow ID\uFF08\u5199\u5165 flows/<flowId> \u5143\u6570\u636E\uFF09").option("--table <name>", "\u76EE\u6807\u8868\u540D\uFF08\u82E5\u5E73\u53F0\u652F\u6301\u76F4\u63A5\u5199\u8868\uFF09").option("--overwrite", "\u8986\u76D6\u5DF2\u6709\u6570\u636E").option("--json", "\u8F93\u51FA JSON").action(async (localFile, opts) => {
     try {
-      const filePath = import_path17.default.resolve(localFile);
+      const filePath = import_path16.default.resolve(localFile);
       if (!import_fs14.default.existsSync(filePath)) {
         console.error(`\u6587\u4EF6\u4E0D\u5B58\u5728: ${filePath}`);
         process.exit(1);
       }
-      const ext = import_path17.default.extname(filePath).toLowerCase();
+      const ext = import_path16.default.extname(filePath).toLowerCase();
       const supportedExts = [".csv", ".json", ".jsonl", ".parquet", ".tsv"];
       if (!supportedExts.includes(ext)) {
         console.error(`\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u683C\u5F0F: ${ext}\uFF08\u652F\u6301: ${supportedExts.join(", ")}\uFF09`);
@@ -5977,7 +6878,7 @@ function makeDataCommand() {
       const body = {
         content: content.toString("base64"),
         encoding: "base64",
-        fileName: import_path17.default.basename(filePath),
+        fileName: import_path16.default.basename(filePath),
         format: ext.slice(1),
         overwrite: opts.overwrite ?? false
       };
@@ -6005,10 +6906,8 @@ function makeDataCommand() {
 }
 
 // cli/dazi-flow/src/commands/variable.ts
-var import_path18 = __toESM(require("path"), 1);
-function resolveFlowDir4(dir) {
-  return import_path18.default.resolve(dir ?? process.cwd());
-}
+var import_path17 = __toESM(require("path"), 1);
+var import_flowDirResolve4 = __toESM(require_flowDirResolve(), 1);
 function requireFlowId(flowDir) {
   const meta = readMeta(flowDir);
   if (!meta?.flowId) {
@@ -6019,22 +6918,22 @@ function requireFlowId(flowDir) {
 }
 function makeVariableCommand() {
   const cmd = new Command("variable").description("\u6D41\u7A0B\u8FD0\u884C\u671F\u53D8\u91CF\uFF08\u540C\u6B65\u5230\u672C\u5730 \u53D8\u91CF/ \u76EE\u5F55\uFF09");
-  cmd.command("sync").description("\u4ECE\u8C03\u8BD5 Run \u540C\u6B65\u5168\u90E8\u53D8\u91CF\u5230 \u53D8\u91CF/<name>.json\uFF08\u542B schema \u4E0E\u524D N \u884C\u9884\u89C8\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--limit <n>", "\u8868\u53D8\u91CF\u9884\u89C8\u884C\u6570", "10").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
+  cmd.command("sync").description("\u4ECE\u8C03\u8BD5 Run \u540C\u6B65\u5168\u90E8\u53D8\u91CF\u5230 \u53D8\u91CF/<name>.json\uFF08\u542B schema \u4E0E\u524D N \u884C\u9884\u89C8\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--limit <n>", "\u8868\u53D8\u91CF\u9884\u89C8\u884C\u6570", "10").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
     try {
-      const flowDir = resolveFlowDir4(opts.dir);
+      const flowDir = (0, import_flowDirResolve4.resolveFlowDir)(opts.dir, { json: opts.json });
       const flowId = requireFlowId(flowDir);
       const previewLimit = Math.max(1, Math.min(100, parseInt(opts.limit, 10) || 10));
       if (!opts.json) console.log(`\u6B63\u5728\u540C\u6B65\u53D8\u91CF\uFF08flowId=${flowId}\uFF09\u2026`);
       const result = await syncAllVariables(flowId, flowDir, previewLimit);
-      if (!opts.json) console.log(`\u2705 \u5DF2\u540C\u6B65 ${result.count} \u4E2A\u53D8\u91CF \u2192 ${import_path18.default.join(flowDir, "\u53D8\u91CF")}`);
+      if (!opts.json) console.log(`\u2705 \u5DF2\u540C\u6B65 ${result.count} \u4E2A\u53D8\u91CF \u2192 ${import_path17.default.join(flowDir, "\u53D8\u91CF")}`);
       ok({ flowId, flowDir, ...result });
     } catch (err) {
       handleError(err);
     }
   });
-  cmd.command("pull").description("\u62C9\u53D6\u5355\u4E2A\u53D8\u91CF\u5230 \u53D8\u91CF/<name>.json").requiredOption("--name <varName>", "\u53D8\u91CF\u540D\uFF08output_variable_name\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u9ED8\u8BA4 cwd\uFF09").option("--limit <n>", "\u8868\u53D8\u91CF\u9884\u89C8\u884C\u6570", "10").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
+  cmd.command("pull").description("\u62C9\u53D6\u5355\u4E2A\u53D8\u91CF\u5230 \u53D8\u91CF/<name>.json").requiredOption("--name <varName>", "\u53D8\u91CF\u540D\uFF08output_variable_name\uFF09").option("--dir <dir>", "\u6D41\u7A0B\u76EE\u5F55\uFF08\u987B\u542B flow.json\uFF1B\u63A8\u8350\u7EDD\u5BF9\u8DEF\u5F84\uFF09").option("--limit <n>", "\u8868\u53D8\u91CF\u9884\u89C8\u884C\u6570", "10").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
     try {
-      const flowDir = resolveFlowDir4(opts.dir);
+      const flowDir = (0, import_flowDirResolve4.resolveFlowDir)(opts.dir, { json: opts.json });
       const flowId = requireFlowId(flowDir);
       const previewLimit = Math.max(1, Math.min(100, parseInt(opts.limit, 10) || 10));
       const result = await syncVariableByName(flowId, flowDir, opts.name, previewLimit);
@@ -6241,201 +7140,17 @@ function makeMcpCommand() {
 }
 
 // cli/dazi-flow/src/commands/managedFiles.ts
-var import_path20 = __toESM(require("path"), 1);
-var import_fs16 = __toESM(require("fs"), 1);
-
-// src/shared/managedFilesBundle.ts
-var import_fs15 = __toESM(require("fs"));
-var import_path19 = __toESM(require("path"));
-
-// src/shared/managedFilesTypes.ts
-var MANAGED_FILES_API = "/api/data-pipelines/v1/managed-files";
-var MANAGED_FS_API = "/api/data-pipelines/v1/managed-fs";
-var MANAGED_BUNDLE_FILES = {
-  manifest: "\u6587\u4EF6\u4FE1\u606F.json",
-  originalPrefix: "\u539F\u6587\u4EF6",
-  nativeDigest: "\u539F\u751F\u89E3\u6790.md",
-  aiStructure: "\u8868\u7ED3\u6784.json",
-  reportLayout: "\u62A5\u8868\u5E03\u5C40.json"
-};
-
-// src/shared/managedFilesBundle.ts
-function apiBase(auth) {
-  return auth.serverUrl.replace(/\/$/, "");
-}
-function sanitizeDirPart(raw) {
-  return raw.trim().replace(/\s+/g, "_").replace(/[<>:"|?*/\\]/g, "_").slice(0, 80) || "file";
-}
-function managedFileLocalFolderName(meta) {
-  const base = sanitizeDirPart(meta.display_name ?? meta.file_id);
-  const shortId = meta.file_id.slice(0, 8);
-  return `${base}_${shortId}`;
-}
-function managedFileLocalDir(filesRoot, meta) {
-  return import_path19.default.join(filesRoot, managedFileLocalFolderName(meta));
-}
-function isExcelManagedFile(meta) {
-  const ext = (meta.file_ext ?? import_path19.default.extname(meta.display_name ?? "")).toLowerCase();
-  if (ext === ".xlsx" || ext === ".xls") return true;
-  const mime = (meta.mime_type ?? "").toLowerCase();
-  return mime.includes("spreadsheet") || mime.endsWith(".sheet");
-}
-async function fetchJson(auth, urlPath, method = "GET") {
-  const res = await fetch(`${apiBase(auth)}${urlPath}`, {
-    method,
-    headers: {
-      Authorization: `Bearer ${auth.token}`,
-      Accept: "application/json",
-      ...method === "POST" ? { "Content-Type": "application/json" } : {}
-    }
-  });
-  if (!res.ok) {
-    const text = await res.text().catch(() => "");
-    throw new Error(`HTTP ${res.status}: ${text || res.statusText}`);
-  }
-  return res.json();
-}
-async function downloadBinary(auth, urlPath, destPath) {
-  const res = await fetch(`${apiBase(auth)}${urlPath}`, {
-    headers: { Authorization: `Bearer ${auth.token}` }
-  });
-  if (!res.ok) {
-    const text = await res.text().catch(() => "");
-    throw new Error(`\u4E0B\u8F7D\u5931\u8D25 HTTP ${res.status}: ${text || res.statusText}`);
-  }
-  const buf = Buffer.from(await res.arrayBuffer());
-  import_fs15.default.mkdirSync(import_path19.default.dirname(destPath), { recursive: true });
-  import_fs15.default.writeFileSync(destPath, buf);
-}
-async function resolveNativeDigest(auth, fileId, parseIfMissing) {
-  if (!parseIfMissing) {
-    try {
-      return await fetchJson(
-        auth,
-        `${MANAGED_FILES_API}/${encodeURIComponent(fileId)}/excel-native-digest`
-      );
-    } catch {
-      return null;
-    }
-  }
-  try {
-    let resp = await fetchJson(
-      auth,
-      `${MANAGED_FILES_API}/${encodeURIComponent(fileId)}/excel-native-digest`
-    );
-    if (resp.markdown) return resp;
-  } catch {
-  }
-  try {
-    return await fetchJson(
-      auth,
-      `${MANAGED_FILES_API}/${encodeURIComponent(fileId)}/excel-native-parse`,
-      "POST"
-    );
-  } catch {
-    return null;
-  }
-}
-async function resolveAiStructure(auth, fileId) {
-  try {
-    return await fetchJson(
-      auth,
-      `${MANAGED_FILES_API}/${encodeURIComponent(fileId)}/excel-ai-structure`
-    );
-  } catch {
-    return null;
-  }
-}
-async function resolveReportLayout(auth, fileId) {
-  try {
-    return await fetchJson(
-      auth,
-      `${MANAGED_FILES_API}/${encodeURIComponent(fileId)}/excel-report-layout`
-    );
-  } catch {
-    return null;
-  }
-}
-async function pullManagedFileBundle(opts) {
-  const { auth, meta } = opts;
-  const fileId = meta.file_id?.trim();
-  if (!fileId) throw new Error("\u7F3A\u5C11 file_id\uFF0C\u4EC5\u652F\u6301\u5DF2\u767B\u8BB0\u6587\u4EF6");
-  const dir = managedFileLocalDir(opts.filesRootDir, meta);
-  import_fs15.default.mkdirSync(dir, { recursive: true });
-  const written = [];
-  const notes = [];
-  const pulledAt = (/* @__PURE__ */ new Date()).toISOString();
-  const ext = (meta.file_ext && meta.file_ext.startsWith(".") ? meta.file_ext : meta.file_ext ? `.${meta.file_ext}` : "") || import_path19.default.extname(meta.display_name ?? meta.stored_filename ?? "") || "";
-  const originalName = `${MANAGED_BUNDLE_FILES.originalPrefix}${ext || ""}`;
-  const originalPath = import_path19.default.join(dir, originalName);
-  await downloadBinary(
-    auth,
-    `${MANAGED_FILES_API}/${encodeURIComponent(fileId)}/content`,
-    originalPath
-  );
-  written.push(originalName);
-  if (isExcelManagedFile(meta)) {
-    const digest = await resolveNativeDigest(auth, fileId, opts.parseNativeIfMissing !== false);
-    if (digest?.markdown) {
-      import_fs15.default.writeFileSync(import_path19.default.join(dir, MANAGED_BUNDLE_FILES.nativeDigest), digest.markdown, "utf8");
-      written.push(MANAGED_BUNDLE_FILES.nativeDigest);
-    } else {
-      notes.push("\u539F\u751F\u89E3\u6790\u672A\u751F\u6210\uFF1A\u8BF7\u5728\u5E73\u53F0\u300C\u6587\u4EF6\u4E0A\u4F20\u7BA1\u7406\u300D\u4E2D\u5BF9 Excel \u6267\u884C\u300C\u539F\u751F\u89E3\u6790\u300D\u540E\u91CD\u8BD5\u62C9\u53D6");
-    }
-    const structureResp = await resolveAiStructure(auth, fileId);
-    if (structureResp?.structure) {
-      import_fs15.default.writeFileSync(
-        import_path19.default.join(dir, MANAGED_BUNDLE_FILES.aiStructure),
-        JSON.stringify(structureResp.structure, null, 2),
-        "utf8"
-      );
-      written.push(MANAGED_BUNDLE_FILES.aiStructure);
-    } else {
-      notes.push("\u8868\u7ED3\u6784\u672A\u751F\u6210\uFF1A\u8BF7\u5148\u5728\u5E73\u53F0\u5B8C\u6210\u300C\u539F\u751F\u89E3\u6790\u300D\u4E0E\u300CAI \u8868\u7ED3\u6784\u300D\u540E\u518D\u62C9\u53D6\uFF0C\u6216\u4EC5\u4F7F\u7528\u539F\u751F\u89E3\u6790.md \u4EA4\u7ED9 AI");
-    }
-    const layoutResp = await resolveReportLayout(auth, fileId);
-    if (layoutResp?.layout) {
-      import_fs15.default.writeFileSync(
-        import_path19.default.join(dir, MANAGED_BUNDLE_FILES.reportLayout),
-        JSON.stringify(layoutResp.layout, null, 2),
-        "utf8"
-      );
-      written.push(MANAGED_BUNDLE_FILES.reportLayout);
-    } else {
-      notes.push("\u62A5\u8868\u5E03\u5C40\u672A\u751F\u6210\uFF1A\u8BF7\u5728\u5E73\u53F0\u300C\u62A5\u8868\u5E03\u5C40\u300D\u9875\u7B7E\u6267\u884C\u89C4\u5219\u89E3\u6790\u6216 AI \u62A5\u8868\u5E03\u5C40\u540E\u518D\u62C9\u53D6");
-    }
-  } else {
-    notes.push("\u975E Excel \u6587\u4EF6\uFF1A\u4EC5\u62C9\u53D6\u539F\u6587\u4EF6\u4E0E\u6587\u4EF6\u4FE1\u606F\uFF08\u65E0\u539F\u751F\u89E3\u6790/\u8868\u7ED3\u6784\uFF09");
-  }
-  const manifest = {
-    pulledAt,
-    file_id: fileId,
-    display_name: meta.display_name,
-    relative_dir: meta.relative_dir,
-    localDir: dir,
-    files: written,
-    notes: notes.length ? notes : void 0
-  };
-  manifest.files = [...written, MANAGED_BUNDLE_FILES.manifest];
-  import_fs15.default.writeFileSync(
-    import_path19.default.join(dir, MANAGED_BUNDLE_FILES.manifest),
-    JSON.stringify({ ...meta, ...manifest }, null, 2),
-    "utf8"
-  );
-  return { dir, manifest };
-}
-function findManagedFileInBrowse(items, fileId) {
-  return items.find((i) => i.file_id === fileId);
-}
-
-// cli/dazi-flow/src/commands/managedFiles.ts
+var import_path18 = __toESM(require("path"), 1);
+var import_fs15 = __toESM(require("fs"), 1);
+var import_managedFilesBundle = __toESM(require_managedFilesBundle(), 1);
+var import_managedFilesTypes = __toESM(require_managedFilesTypes(), 1);
 function makeManagedFilesCommand() {
   const cmd = new Command("managed-files").description("\u6587\u4EF6\u4E0A\u4F20\u7BA1\u7406\uFF08managed_files\uFF09");
   cmd.command("dirs").description("\u5217\u51FA\u7BA1\u7406\u76EE\u5F55\u5B50\u6587\u4EF6\u5939").option("--path <relativePath>", "\u76F8\u5BF9\u8DEF\u5F84\uFF08\u9ED8\u8BA4\u6839\uFF09", "").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
     try {
       const qs = new URLSearchParams();
       qs.set("path", opts.path ?? "");
-      const data = await apiRequest(`${MANAGED_FS_API}/children?${qs}`);
+      const data = await apiRequest(`${import_managedFilesTypes.MANAGED_FS_API}/children?${qs}`);
       if (!opts.json) {
         for (const c of data.children ?? []) {
           console.log(`  ${c.path || "/"}  ${c.name}`);
@@ -6451,7 +7166,7 @@ function makeManagedFilesCommand() {
       const qs = new URLSearchParams();
       qs.set("relative_dir", opts.relativeDir ?? "");
       qs.set("include_unregistered", "false");
-      const data = await apiRequest(`${MANAGED_FILES_API}/browse?${qs}`);
+      const data = await apiRequest(`${import_managedFilesTypes.MANAGED_FILES_API}/browse?${qs}`);
       if (!opts.json) {
         for (const it of data.items ?? []) {
           if (!it.file_id) continue;
@@ -6470,17 +7185,17 @@ function makeManagedFilesCommand() {
       const qs = new URLSearchParams();
       qs.set("relative_dir", opts.relativeDir ?? "");
       qs.set("include_unregistered", "false");
-      const browse = await apiRequest(`${MANAGED_FILES_API}/browse?${qs}`);
-      let meta = findManagedFileInBrowse(browse.items ?? [], opts.fileId);
+      const browse = await apiRequest(`${import_managedFilesTypes.MANAGED_FILES_API}/browse?${qs}`);
+      let meta = (0, import_managedFilesBundle.findManagedFileInBrowse)(browse.items ?? [], opts.fileId);
       if (!meta) {
         console.error(`\u9519\u8BEF: \u5728 relative_dir="${opts.relativeDir ?? ""}" \u672A\u627E\u5230 file_id=${opts.fileId}`);
         console.error("\u63D0\u793A: \u6307\u5B9A\u6B63\u786E\u7684 --relative-dir\uFF0C\u6216\u4ECE\u4FA7\u680F\u6811\u53F3\u952E\u62C9\u53D6");
         process.exit(1);
       }
       const ws = resolveWorkspace();
-      const filesRoot = import_path20.default.resolve(opts.filesRoot ?? ws.files);
-      import_fs16.default.mkdirSync(filesRoot, { recursive: true });
-      const result = await pullManagedFileBundle({
+      const filesRoot = import_path18.default.resolve(opts.filesRoot ?? ws.files);
+      import_fs15.default.mkdirSync(filesRoot, { recursive: true });
+      const result = await (0, import_managedFilesBundle.pullManagedFileBundle)({
         auth: { serverUrl: auth.serverUrl, token: auth.token },
         meta,
         filesRootDir: filesRoot,
@@ -6503,7 +7218,7 @@ function makeManagedFilesCommand() {
 
 // cli/dazi-flow/src/index.ts
 var program2 = new Command();
-program2.name("dazi-flow").description("\u642D\u5B50 Flow CLI \u2014 \u5DE5\u4F5C\u6D41\u7BA1\u7406").version("3.0.0", "-v, --version");
+program2.name("dazi-flow").description("\u642D\u5B50 Flow CLI \u2014 \u5DE5\u4F5C\u6D41\u7BA1\u7406").version("3.0.3", "-v, --version");
 program2.addCommand(makeFlowsCommand());
 program2.addCommand(makeSnapshotCommand());
 program2.addCommand(makeProjectCommand());