sdd-flow-kit 1.0.25 → 1.0.27

package/README.md

@@ -11,6 +11,23 @@
 软件架构说明
 
 
+#### Node 版本（14.16 / 18 / 20 均可）
+
+| 组件 | 要求 |
+|------|------|
+| **sdd-flow-kit** CLI（`install` / `run` / `doctor` / `postinstall`） | **Node >= 14.16.0**（`engines` 已声明；兼容老 CI/内网机） |
+| **openspec** CLI、`opsx-workflow` | 以各自包文档为准；建议 **18+** |
+| 目标业务仓（如 adInsight `frontend`） | 按该仓 `package.json` engines，与 kit 独立 |
+
+安装后建议执行：
+
+```bash
+node -v   # 应 >= v14.16.0
+npx sdd-flow-kit doctor --agent cursor
+```
+
+若 `doctor` 报 `node-version` 失败，请升级到 14.16+，或在该仓使用 `.nvmrc` 锁定版本。
+
 #### 安装教程
 
 1.  进入你要开发的项目目录

package/dist/adapters/index.js

@@ -4,12 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAdapter = getAdapter;
-const node_child_process_1 = require("node:child_process");
-const node_path_1 = __importDefault(require("node:path"));
-const node_process_1 = __importDefault(require("node:process"));
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const process_1 = __importDefault(require("process"));
 const fs_1 = require("../core/fs");
 function hasCommand(cmd) {
-    const result = (0, node_child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" });
+    const result = (0, child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" });
     return result.status === 0;
 }
 function createManualAdapter(name, displayName, bins) {
@@ -25,15 +25,16 @@ function createManualAdapter(name, displayName, bins) {
     };
 }
 async function runClaudeFlow(args) {
+    var _a;
     // 默认关闭“二次调用 claude”自动执行，避免在 AI 会话内递归触发导致静默挂起。
     // 仅在显式开启时执行：SDD_FLOW_KIT_ENABLE_CLAUDE_AUTORUN=1
-    if (node_process_1.default.env.SDD_FLOW_KIT_ENABLE_CLAUDE_AUTORUN !== "1") {
+    if (process_1.default.env.SDD_FLOW_KIT_ENABLE_CLAUDE_AUTORUN !== "1") {
         return false;
     }
     const hasClaude = hasCommand("claude");
     if (!hasClaude)
         return false;
-    const sddPrompt = await (0, fs_1.readFileIfExists)(node_path_1.default.join(args.outputRoot, "02-需求分析提示词.md"));
+    const sddPrompt = await (0, fs_1.readFileIfExists)(path_1.default.join(args.outputRoot, "02-需求分析提示词.md"));
     if (!sddPrompt)
         return false;
     const prompt = [
@@ -49,16 +50,16 @@ async function runClaudeFlow(args) {
         "以下是第2步提示词：",
         sddPrompt,
     ].join("\n");
-    const commandResult = (0, node_child_process_1.spawnSync)("claude", ["-p", prompt], {
+    const commandResult = (0, child_process_1.spawnSync)("claude", ["-p", prompt], {
         cwd: args.outputRoot,
         encoding: "utf8",
-        env: node_process_1.default.env,
+        env: process_1.default.env,
     });
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(args.outputRoot, "AUTO-RUN-LOG.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(args.outputRoot, "AUTO-RUN-LOG.md"), [
         "# AUTO-RUN-LOG",
         "",
         `agent: claude-code`,
-        `status: ${commandResult.status ?? "unknown"}`,
+        `status: ${(_a = commandResult.status) !== null && _a !== void 0 ? _a : "unknown"}`,
         "",
         "## stdout",
         commandResult.stdout || "",

package/dist/cli.js

@@ -4,8 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const node_path_1 = __importDefault(require("node:path"));
-const node_process_1 = __importDefault(require("node:process"));
+const path_1 = __importDefault(require("path"));
+const process_1 = __importDefault(require("process"));
 const startFlow_1 = require("./steps/startFlow");
 const runFlow_1 = require("./steps/runFlow");
 const utils_1 = require("./core/utils");
@@ -14,10 +14,10 @@ const doctor_1 = require("./steps/doctor");
 const invokeFlow_1 = require("./steps/invokeFlow");
 const ALLOWED_AGENTS = ["cursor", "claude-code", "codex", "openclaw", "custom"];
 function getArgValue(flag) {
-    const idx = node_process_1.default.argv.indexOf(flag);
+    const idx = process_1.default.argv.indexOf(flag);
     if (idx === -1)
         return null;
-    const v = node_process_1.default.argv[idx + 1];
+    const v = process_1.default.argv[idx + 1];
     if (!v)
         return null;
     return v;
@@ -61,7 +61,8 @@ function printHelp() {
     ].join("\n"));
 }
 async function main() {
-    const cmd = node_process_1.default.argv[2];
+    var _a, _b, _c, _d;
+    const cmd = process_1.default.argv[2];
     if (!cmd || cmd === "--help" || cmd === "-h") {
         printHelp();
         return;
@@ -74,23 +75,23 @@ async function main() {
         cmd !== "ensure-opsx" &&
         cmd !== "invoke") {
         printHelp();
-        node_process_1.default.exitCode = 1;
+        process_1.default.exitCode = 1;
         return;
     }
     const product = getArgValue("--product");
     const version = getArgValue("--version");
-    const projectRoot = getArgValue("--projectRoot") ?? node_process_1.default.cwd();
-    const branch = getArgValue("--branch") ?? undefined;
-    const yes = node_process_1.default.argv.includes("-y");
-    const dryRun = node_process_1.default.argv.includes("--dry-run");
-    const planJson = node_process_1.default.argv.includes("--plan-json");
-    const agentValue = getArgValue("--agent") ?? "claude-code";
-    const projectKind = (getArgValue("--project") ?? "OMS");
+    const projectRoot = (_a = getArgValue("--projectRoot")) !== null && _a !== void 0 ? _a : process_1.default.cwd();
+    const branch = (_b = getArgValue("--branch")) !== null && _b !== void 0 ? _b : undefined;
+    const yes = process_1.default.argv.includes("-y");
+    const dryRun = process_1.default.argv.includes("--dry-run");
+    const planJson = process_1.default.argv.includes("--plan-json");
+    const agentValue = (_c = getArgValue("--agent")) !== null && _c !== void 0 ? _c : "claude-code";
+    const projectKind = ((_d = getArgValue("--project")) !== null && _d !== void 0 ? _d : "OMS");
     if (!ALLOWED_AGENTS.includes(agentValue)) {
         // eslint-disable-next-line no-console
         console.error(`不支持的 --agent: ${agentValue}`);
         printHelp();
-        node_process_1.default.exitCode = 1;
+        process_1.default.exitCode = 1;
         return;
     }
     const agent = agentValue;
@@ -98,13 +99,13 @@ async function main() {
     if (!allowedProjects.includes(projectKind)) {
         // eslint-disable-next-line no-console
         console.error(`不支持的 --project: ${projectKind}（可选：${allowedProjects.join(" / ")}）`);
-        node_process_1.default.exitCode = 1;
+        process_1.default.exitCode = 1;
         return;
     }
     if (cmd === "doctor" || cmd === "ensure-opsx") {
-        const fix = cmd === "ensure-opsx" || node_process_1.default.argv.includes("--fix");
+        const fix = cmd === "ensure-opsx" || process_1.default.argv.includes("--fix");
         const doctor = await (0, doctor_1.runDoctor)({
-            projectRoot: node_path_1.default.resolve(projectRoot),
+            projectRoot: path_1.default.resolve(projectRoot),
             agent,
             fix,
             dryRun,
@@ -117,11 +118,11 @@ async function main() {
         }
         if (planJson) {
             // eslint-disable-next-line no-console
-            console.log(JSON.stringify({ command: "doctor", projectRoot: node_path_1.default.resolve(projectRoot), result: doctor }, null, 2));
+            console.log(JSON.stringify({ command: "doctor", projectRoot: path_1.default.resolve(projectRoot), result: doctor }, null, 2));
         }
         if (cmd === "ensure-opsx" && !dryRun) {
             await (0, setupProject_1.setupProject)({
-                projectRoot: node_path_1.default.resolve(projectRoot),
+                projectRoot: path_1.default.resolve(projectRoot),
                 agent,
                 yes: true,
                 light: true,
@@ -129,12 +130,12 @@ async function main() {
             });
         }
         if (!doctor.ok)
-            node_process_1.default.exitCode = 1;
+            process_1.default.exitCode = 1;
         return;
     }
     if (cmd === "setup" || cmd === "install") {
         const result = await (0, setupProject_1.setupProject)({
-            projectRoot: node_path_1.default.resolve(projectRoot),
+            projectRoot: path_1.default.resolve(projectRoot),
             agent,
             branch,
             yes,
@@ -151,7 +152,7 @@ async function main() {
             // eslint-disable-next-line no-console
             console.log(JSON.stringify({
                 command: cmd,
-                projectRoot: node_path_1.default.resolve(projectRoot),
+                projectRoot: path_1.default.resolve(projectRoot),
                 dryRun,
                 result,
             }, null, 2));
@@ -160,18 +161,18 @@ async function main() {
     }
     if (!product || !version) {
         if (cmd === "invoke") {
-            const raw = node_process_1.default.argv
+            const raw = process_1.default.argv
                 .slice(3)
                 .filter((token) => !token.startsWith("--") && token !== "-y")
                 .join(" ")
                 .trim();
             const fromFlag = getArgValue("--text");
-            const text = (fromFlag ?? raw).trim();
+            const text = (fromFlag !== null && fromFlag !== void 0 ? fromFlag : raw).trim();
             const parsed = (0, invokeFlow_1.parseInvokeText)(text);
             if (!parsed) {
                 throw new Error("invoke 解析失败，请使用：开发 ADI 2.3.2 需求");
             }
-            const resolvedRoot = node_path_1.default.resolve(projectRoot);
+            const resolvedRoot = path_1.default.resolve(projectRoot);
             const options = (0, invokeFlow_1.toRunOptions)({
                 parsed,
                 projectRoot: resolvedRoot,
@@ -190,10 +191,10 @@ async function main() {
             return;
         }
         printHelp();
-        node_process_1.default.exitCode = 1;
+        process_1.default.exitCode = 1;
         return;
     }
-    const resolvedRoot = node_path_1.default.resolve(projectRoot);
+    const resolvedRoot = path_1.default.resolve(projectRoot);
     const runId = `${(0, utils_1.formatYYYYMMDD)(new Date())}-${product}-${version}`;
     if (cmd === "start") {
         await (0, startFlow_1.startFlowScaffold)({
@@ -243,5 +244,5 @@ async function main() {
 main().catch((e) => {
     // eslint-disable-next-line no-console
     console.error(e);
-    node_process_1.default.exitCode = 1;
+    process_1.default.exitCode = 1;
 });

package/dist/core/fs.js

@@ -5,8 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readFileIfExists = readFileIfExists;
 exports.writeTextFileEnsuredDir = writeTextFileEnsuredDir;
-const promises_1 = __importDefault(require("node:fs/promises"));
-const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
 async function readFileIfExists(filePath) {
     try {
         return await promises_1.default.readFile(filePath, "utf8");
@@ -22,6 +22,6 @@ async function readFileIfExists(filePath) {
     }
 }
 async function writeTextFileEnsuredDir(filePath, content) {
-    await promises_1.default.mkdir(node_path_1.default.dirname(filePath), { recursive: true });
+    await promises_1.default.mkdir(path_1.default.dirname(filePath), { recursive: true });
     await promises_1.default.writeFile(filePath, content, "utf8");
 }

package/dist/core/inferProject.js

@@ -7,8 +7,8 @@ exports.PRODUCT_PREFIX_BY_KIND = exports.DOC_SKILL_BY_KIND = exports.ALLOWED_PRO
 exports.productToKind = productToKind;
 exports.resolveDocSkillDir = resolveDocSkillDir;
 exports.inferProjectKind = inferProjectKind;
-const promises_1 = __importDefault(require("node:fs/promises"));
-const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
 exports.ALLOWED_PROJECTS = ["OMS", "ADI", "欢盟", "AD Tools"];
 exports.DOC_SKILL_BY_KIND = {
     ADI: "adi-doc-skill",
@@ -37,24 +37,24 @@ function productToKind(product) {
 /** 从 projectRoot 向上查找 docs/*-doc-skill（适配 frontend 子目录 + 根目录 docs） */
 async function resolveDocSkillDir(projectRoot, kind) {
     const dirName = exports.DOC_SKILL_BY_KIND[kind];
-    let cur = node_path_1.default.resolve(projectRoot);
+    let cur = path_1.default.resolve(projectRoot);
     for (let i = 0; i < 8; i += 1) {
-        const candidate = node_path_1.default.join(cur, "docs", dirName);
-        if (await pathExists(node_path_1.default.join(candidate, "confluence-doc.py"))) {
-            const rel = node_path_1.default.relative(projectRoot, candidate);
+        const candidate = path_1.default.join(cur, "docs", dirName);
+        if (await pathExists(path_1.default.join(candidate, "confluence-doc.py"))) {
+            const rel = path_1.default.relative(projectRoot, candidate);
             return {
                 absPath: candidate,
-                relFromRoot: rel.startsWith("..") ? rel : node_path_1.default.join("docs", dirName),
+                relFromRoot: rel.startsWith("..") ? rel : path_1.default.join("docs", dirName),
             };
         }
-        const parent = node_path_1.default.dirname(cur);
+        const parent = path_1.default.dirname(cur);
         if (parent === cur)
             break;
         cur = parent;
     }
     return {
-        absPath: node_path_1.default.join(projectRoot, "docs", dirName),
-        relFromRoot: node_path_1.default.join("docs", dirName),
+        absPath: path_1.default.join(projectRoot, "docs", dirName),
+        relFromRoot: path_1.default.join("docs", dirName),
     };
 }
 async function pathExists(filePath) {
@@ -87,12 +87,12 @@ async function inferFromExistingDocSkill(projectRoot) {
     let dir = projectRoot;
     for (let i = 0; i < 8; i += 1) {
         for (const kind of exports.ALLOWED_PROJECTS) {
-            const rel = node_path_1.default.join(dir, "docs", exports.DOC_SKILL_BY_KIND[kind]);
-            if (await pathExists(node_path_1.default.join(rel, "SKILL.md"))) {
+            const rel = path_1.default.join(dir, "docs", exports.DOC_SKILL_BY_KIND[kind]);
+            if (await pathExists(path_1.default.join(rel, "SKILL.md"))) {
                 return kind;
             }
         }
-        const parent = node_path_1.default.dirname(dir);
+        const parent = path_1.default.dirname(dir);
         if (parent === dir)
             break;
         dir = parent;
@@ -101,10 +101,10 @@ async function inferFromExistingDocSkill(projectRoot) {
 }
 /** 从目录路径（含父级）推断产品类型 */
 function inferFromPathSegments(projectRoot) {
-    const resolved = node_path_1.default.resolve(projectRoot);
-    const parts = resolved.split(node_path_1.default.sep);
+    const resolved = path_1.default.resolve(projectRoot);
+    const parts = resolved.split(path_1.default.sep);
     for (let i = parts.length; i > 0; i -= 1) {
-        const segment = parts.slice(0, i).join(node_path_1.default.sep);
+        const segment = parts.slice(0, i).join(path_1.default.sep);
         const hit = matchKindInText(segment);
         if (hit)
             return hit;
@@ -112,10 +112,11 @@ function inferFromPathSegments(projectRoot) {
     return null;
 }
 async function inferFromPackageJson(dir) {
+    var _a, _b;
     try {
-        const pkgText = await promises_1.default.readFile(node_path_1.default.join(dir, "package.json"), "utf8");
+        const pkgText = await promises_1.default.readFile(path_1.default.join(dir, "package.json"), "utf8");
         const pkg = JSON.parse(pkgText);
-        const blob = `${pkg.name ?? ""} ${pkg.description ?? ""}`;
+        const blob = `${(_a = pkg.name) !== null && _a !== void 0 ? _a : ""} ${(_b = pkg.description) !== null && _b !== void 0 ? _b : ""}`;
         return matchKindInText(blob);
     }
     catch {
@@ -127,7 +128,8 @@ async function inferFromPackageJson(dir) {
  *  monorepo 子目录（如 adInsight-web/frontend）会向上扫描路径，避免误判为 OMS。
  */
 async function inferProjectKind(projectRoot) {
-    const fromEnv = (process.env.SDD_FLOW_KIT_PROJECT ?? "").trim();
+    var _a;
+    const fromEnv = ((_a = process.env.SDD_FLOW_KIT_PROJECT) !== null && _a !== void 0 ? _a : "").trim();
     if (exports.ALLOWED_PROJECTS.includes(fromEnv)) {
         return fromEnv;
     }
@@ -140,7 +142,7 @@ async function inferProjectKind(projectRoot) {
         const fromPkg = await inferFromPackageJson(dir);
         if (fromPkg)
             return fromPkg;
-        const parent = node_path_1.default.dirname(dir);
+        const parent = path_1.default.dirname(dir);
         if (parent === dir)
             break;
         dir = parent;

package/dist/core/nodeCompat.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIN_NODE_PATCH = exports.MIN_NODE_MINOR = exports.MIN_NODE_MAJOR = void 0;
+exports.parseNodeSemver = parseNodeSemver;
+exports.isNodeVersionSupported = isNodeVersionSupported;
+exports.nodeVersionRequirementLabel = nodeVersionRequirementLabel;
+const process_1 = __importDefault(require("process"));
+/** 与 package.json engines.node 对齐 */
+exports.MIN_NODE_MAJOR = 14;
+exports.MIN_NODE_MINOR = 16;
+exports.MIN_NODE_PATCH = 0;
+function parseNodeSemver() {
+    const m = process_1.default.version.match(/^v(\d+)\.(\d+)\.(\d+)/);
+    if (!m)
+        return { major: 0, minor: 0, patch: 0 };
+    return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) };
+}
+function isNodeVersionSupported() {
+    const v = parseNodeSemver();
+    if (v.major > exports.MIN_NODE_MAJOR)
+        return true;
+    if (v.major < exports.MIN_NODE_MAJOR)
+        return false;
+    if (v.minor > exports.MIN_NODE_MINOR)
+        return true;
+    if (v.minor < exports.MIN_NODE_MINOR)
+        return false;
+    return v.patch >= exports.MIN_NODE_PATCH;
+}
+function nodeVersionRequirementLabel() {
+    return `>= ${exports.MIN_NODE_MAJOR}.${exports.MIN_NODE_MINOR}.${exports.MIN_NODE_PATCH}`;
+}

package/dist/core/opsxDelivery.js

@@ -11,9 +11,9 @@ exports.buildOpsxWorkflowSetupCommand = buildOpsxWorkflowSetupCommand;
 exports.isOpsxApplyReady = isOpsxApplyReady;
 exports.ensureOpsxWorkflow = ensureOpsxWorkflow;
 exports.collectDeliverySetupChecks = collectDeliverySetupChecks;
-const node_child_process_1 = require("node:child_process");
-const promises_1 = __importDefault(require("node:fs/promises"));
-const node_path_1 = __importDefault(require("node:path"));
+const child_process_1 = require("child_process");
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
 const fs_1 = require("./fs");
 const DELIVERY_SCRIPT_REL = ".cursor/skills/opsx-dev-delivery-pipeline/scripts/opsx-delivery-pipeline.sh";
 function deliveryPipelineNpmScripts() {
@@ -32,24 +32,24 @@ async function pathExists(filePath) {
 }
 /** 优先使用已安装 OPSX skills 的 editor 目录 */
 async function resolveOpsxAgent(projectRoot, preferred) {
-    const deliverySkill = node_path_1.default.join(projectRoot, ".cursor", "skills", "opsx-dev-delivery-pipeline", "SKILL.md");
+    const deliverySkill = path_1.default.join(projectRoot, ".cursor", "skills", "opsx-dev-delivery-pipeline", "SKILL.md");
     if (await pathExists(deliverySkill))
         return "cursor";
-    const claudeDelivery = node_path_1.default.join(projectRoot, ".claude", "skills", "opsx-dev-delivery-pipeline", "SKILL.md");
+    const claudeDelivery = path_1.default.join(projectRoot, ".claude", "skills", "opsx-dev-delivery-pipeline", "SKILL.md");
     if (await pathExists(claudeDelivery))
         return "claude-code";
-    if (await pathExists(node_path_1.default.join(projectRoot, ".cursor")))
+    if (await pathExists(path_1.default.join(projectRoot, ".cursor")))
         return "cursor";
-    if (await pathExists(node_path_1.default.join(projectRoot, ".claude")))
+    if (await pathExists(path_1.default.join(projectRoot, ".claude")))
         return "claude-code";
     return preferred;
 }
 /** 将 package.json 中过期的 poquan-delivery-pipeline 脚本修正为 opsx-dev-delivery-pipeline */
 async function repairOpsxDeliveryScripts(projectRoot) {
-    const pkgPath = node_path_1.default.join(projectRoot, "package.json");
+    const pkgPath = path_1.default.join(projectRoot, "package.json");
     if (!(await pathExists(pkgPath)))
         return false;
-    const scriptOnDisk = node_path_1.default.join(projectRoot, DELIVERY_SCRIPT_REL);
+    const scriptOnDisk = path_1.default.join(projectRoot, DELIVERY_SCRIPT_REL);
     if (!(await pathExists(scriptOnDisk)))
         return false;
     const { full, short } = deliveryPipelineNpmScripts();
@@ -73,7 +73,7 @@ async function repairOpsxDeliveryScripts(projectRoot) {
     return true;
 }
 function hasCommand(cmd) {
-    return (0, node_child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" }).status === 0;
+    return (0, child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" }).status === 0;
 }
 function buildOpsxWorkflowSetupCommand(projectRoot, agent) {
     const baseArgs = ["@lixin5257xxx/opsx-workflow", "setup"];
@@ -120,7 +120,7 @@ async function ensureOpsxWorkflow(options) {
             plannedActions,
         };
     }
-    const ret = (0, node_child_process_1.spawnSync)(cmd, args, {
+    const ret = (0, child_process_1.spawnSync)(cmd, args, {
         cwd: options.projectRoot,
         stdio: "inherit",
         env: process.env,
@@ -142,10 +142,11 @@ async function ensureOpsxWorkflow(options) {
     };
 }
 async function collectDeliverySetupChecks(projectRoot) {
+    var _a, _b, _c, _d, _e, _f;
     const checks = [];
     checks.push({
         name: "openspec-dir",
-        ok: await pathExists(node_path_1.default.join(projectRoot, "openspec")),
+        ok: await pathExists(path_1.default.join(projectRoot, "openspec")),
         detail: "openspec/ 目录",
     });
     checks.push({
@@ -153,34 +154,34 @@ async function collectDeliverySetupChecks(projectRoot) {
         ok: hasCommand("openspec"),
         detail: "openspec CLI（npx openspec 或全局安装）",
     });
-    const skillPath = node_path_1.default.join(projectRoot, ".cursor", "skills", "opsx-dev-delivery-pipeline", "SKILL.md");
+    const skillPath = path_1.default.join(projectRoot, ".cursor", "skills", "opsx-dev-delivery-pipeline", "SKILL.md");
     checks.push({
         name: "opsx-dev-delivery-pipeline-skill",
         ok: await pathExists(skillPath),
         detail: skillPath,
     });
-    const tddPath = node_path_1.default.join(projectRoot, ".cursor", "skills", "tdd-script", "SKILL.md");
+    const tddPath = path_1.default.join(projectRoot, ".cursor", "skills", "tdd-script", "SKILL.md");
     checks.push({
         name: "tdd-script-skill",
         ok: await pathExists(tddPath),
         detail: tddPath,
     });
-    const applyPath = node_path_1.default.join(projectRoot, ".cursor", "skills", "openspec-apply-change", "SKILL.md");
+    const applyPath = path_1.default.join(projectRoot, ".cursor", "skills", "openspec-apply-change", "SKILL.md");
     checks.push({
         name: "openspec-apply-change-skill",
         ok: await pathExists(applyPath),
         detail: applyPath,
     });
-    const pipelineScript = node_path_1.default.join(projectRoot, DELIVERY_SCRIPT_REL);
+    const pipelineScript = path_1.default.join(projectRoot, DELIVERY_SCRIPT_REL);
     checks.push({
         name: "delivery-pipeline-script",
         ok: await pathExists(pipelineScript),
         detail: pipelineScript,
     });
     try {
-        const pkgText = await promises_1.default.readFile(node_path_1.default.join(projectRoot, "package.json"), "utf8");
+        const pkgText = await promises_1.default.readFile(path_1.default.join(projectRoot, "package.json"), "utf8");
         const pkg = JSON.parse(pkgText);
-        const cmd = pkg.scripts?.["opsx:delivery-pipeline"] ?? "";
+        const cmd = (_b = (_a = pkg.scripts) === null || _a === void 0 ? void 0 : _a["opsx:delivery-pipeline"]) !== null && _b !== void 0 ? _b : "";
         const ok = cmd.includes("opsx-dev-delivery-pipeline") &&
             cmd.includes("opsx-delivery-pipeline.sh") &&
             !cmd.includes("poquan");
@@ -198,11 +199,11 @@ async function collectDeliverySetupChecks(projectRoot) {
         });
     }
     try {
-        const cfgText = await promises_1.default.readFile(node_path_1.default.join(projectRoot, ".opsx", "config.json"), "utf8");
+        const cfgText = await promises_1.default.readFile(path_1.default.join(projectRoot, ".opsx", "config.json"), "utf8");
         const cfg = JSON.parse(cfgText);
-        const skillsDir = cfg.skillsDir ?? "";
-        const hasCursorDelivery = await pathExists(node_path_1.default.join(projectRoot, ".cursor", "skills", "opsx-dev-delivery-pipeline", "SKILL.md"));
-        const nameOk = cfg.deliveryPipeline?.skillName === "opsx-dev-delivery-pipeline";
+        const skillsDir = (_c = cfg.skillsDir) !== null && _c !== void 0 ? _c : "";
+        const hasCursorDelivery = await pathExists(path_1.default.join(projectRoot, ".cursor", "skills", "opsx-dev-delivery-pipeline", "SKILL.md"));
+        const nameOk = ((_d = cfg.deliveryPipeline) === null || _d === void 0 ? void 0 : _d.skillName) === "opsx-dev-delivery-pipeline";
         const dirOk = (hasCursorDelivery && skillsDir.includes(".cursor")) ||
             (!hasCursorDelivery && (skillsDir.includes(".cursor") || skillsDir.includes(".claude")));
         checks.push({
@@ -210,7 +211,7 @@ async function collectDeliverySetupChecks(projectRoot) {
             ok: nameOk && dirOk,
             detail: hasCursorDelivery && !skillsDir.includes(".cursor")
                 ? `skills 在 .cursor 但 config 指向 ${skillsDir}，请 npx sdd-flow-kit install -y`
-                : `skillsDir=${skillsDir}, skillName=${cfg.deliveryPipeline?.skillName ?? ""}`,
+                : `skillsDir=${skillsDir}, skillName=${(_f = (_e = cfg.deliveryPipeline) === null || _e === void 0 ? void 0 : _e.skillName) !== null && _f !== void 0 ? _f : ""}`,
         });
     }
     catch {
@@ -221,7 +222,7 @@ async function collectDeliverySetupChecks(projectRoot) {
         });
     }
     try {
-        const pkgText = await promises_1.default.readFile(node_path_1.default.join(projectRoot, "package.json"), "utf8");
+        const pkgText = await promises_1.default.readFile(path_1.default.join(projectRoot, "package.json"), "utf8");
         const pkg = JSON.parse(pkgText);
         const deps = { ...pkg.dependencies, ...pkg.devDependencies };
         const hasPw = Boolean(deps["@playwright/test"] || deps.playwright);
@@ -238,7 +239,7 @@ async function collectDeliverySetupChecks(projectRoot) {
             detail: "无法读取 package.json 检查 Playwright",
         });
     }
-    const agentsMd = node_path_1.default.join(projectRoot, "AGENTS.md");
+    const agentsMd = path_1.default.join(projectRoot, "AGENTS.md");
     checks.push({
         name: "agents-md",
         ok: await pathExists(agentsMd),

package/dist/core/readlinePrompt.js

@@ -0,0 +1,51 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPromptInterface = createPromptInterface;
+exports.promptLine = promptLine;
+const readline = __importStar(require("readline"));
+const process_1 = __importDefault(require("process"));
+/** Node 14 兼容：不使用 node:readline/promises（需 Node 17+） */
+function createPromptInterface() {
+    return readline.createInterface({ input: process_1.default.stdin, output: process_1.default.stdout });
+}
+function promptLine(rl, query) {
+    return new Promise((resolve) => {
+        rl.question(query, (answer) => resolve(answer));
+    });
+}

package/dist/core/templates.js

@@ -4,16 +4,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadTemplateText = loadTemplateText;
-const node_path_1 = __importDefault(require("node:path"));
+const path_1 = __importDefault(require("path"));
 const fs_1 = require("./fs");
 function resolveCandidatePaths(relPathFromPackageRoot) {
     // 在 TS 开发态：<pkg>/src/templates/xxx
     // 在编译态：<pkg>/dist/cli.js -> __dirname=<pkg>/dist，所以 src/templates 要向上找两级
     const here = __dirname; // src/core/* 或 dist/*
-    const pkgRoot = node_path_1.default.resolve(here, "../.."); // 兼容 src/ 与 dist/
+    const pkgRoot = path_1.default.resolve(here, "../.."); // 兼容 src/ 与 dist/
     return [
-        node_path_1.default.join(pkgRoot, "src", "templates", relPathFromPackageRoot),
-        node_path_1.default.join(pkgRoot, "dist", "templates", relPathFromPackageRoot),
+        path_1.default.join(pkgRoot, "src", "templates", relPathFromPackageRoot),
+        path_1.default.join(pkgRoot, "dist", "templates", relPathFromPackageRoot),
     ];
 }
 async function loadTemplateText(relPathFromPackageRoot) {

package/dist/core/utils.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatYYYYMMDD = formatYYYYMMDD;
+exports.replaceAllStr = replaceAllStr;
 exports.ensurePosixRelativePath = ensurePosixRelativePath;
 /**
  * 生成 YYYYMMDD 字符串，用于 openspec/PRD 目录命名。
@@ -11,7 +12,13 @@ function formatYYYYMMDD(d) {
     const dd = String(d.getDate()).padStart(2, "0");
     return `${yyyy}${mm}${dd}`;
 }
+/** Node 14 无 String.prototype.replaceAll（需 Node 15+） */
+function replaceAllStr(text, search, replacement) {
+    if (!search)
+        return text;
+    return text.split(search).join(replacement);
+}
 function ensurePosixRelativePath(p) {
     // 用于模板占位符中展示，避免反斜杠导致工具误解析。
-    return p.replaceAll("\\", "/");
+    return replaceAllStr(p, "\\", "/");
 }

package/dist/postinstall.js

@@ -36,20 +36,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const node_path_1 = __importDefault(require("node:path"));
-const node_process_1 = __importDefault(require("node:process"));
+const path_1 = __importDefault(require("path"));
+const process_1 = __importDefault(require("process"));
 const inferProject_1 = require("./core/inferProject");
 const opsxDelivery_1 = require("./core/opsxDelivery");
 const setupProject_1 = require("./steps/setupProject");
 async function inferAgent(projectRoot) {
-    const fromEnv = (node_process_1.default.env.SDD_FLOW_KIT_AGENT ?? "").trim();
+    var _a;
+    const fromEnv = ((_a = process_1.default.env.SDD_FLOW_KIT_AGENT) !== null && _a !== void 0 ? _a : "").trim();
     const allowed = ["cursor", "claude-code", "codex", "openclaw"];
     if (allowed.includes(fromEnv))
         return fromEnv;
-    const fs = await Promise.resolve().then(() => __importStar(require("node:fs/promises")));
+    const fs = await Promise.resolve().then(() => __importStar(require("fs/promises")));
     const exists = async (rel) => {
         try {
-            await fs.access(node_path_1.default.join(projectRoot, rel));
+            await fs.access(path_1.default.join(projectRoot, rel));
             return true;
         }
         catch {
@@ -67,12 +68,12 @@ async function inferAgent(projectRoot) {
     return "cursor";
 }
 async function main() {
-    if (node_process_1.default.env.SDD_FLOW_KIT_SKIP_POSTINSTALL === "1") {
+    if (process_1.default.env.SDD_FLOW_KIT_SKIP_POSTINSTALL === "1") {
         return;
     }
-    const initCwd = node_process_1.default.env.INIT_CWD ? node_path_1.default.resolve(node_process_1.default.env.INIT_CWD) : null;
-    const pkgDir = node_path_1.default.resolve(__dirname, "..");
-    const projectRoot = initCwd ?? node_process_1.default.cwd();
+    const initCwd = process_1.default.env.INIT_CWD ? path_1.default.resolve(process_1.default.env.INIT_CWD) : null;
+    const pkgDir = path_1.default.resolve(__dirname, "..");
+    const projectRoot = initCwd !== null && initCwd !== void 0 ? initCwd : process_1.default.cwd();
     if (projectRoot === pkgDir)
         return;
     const projectKind = await (0, inferProject_1.inferProjectKind)(projectRoot);

package/dist/steps/doctor.js

@@ -4,12 +4,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runDoctor = runDoctor;
-const node_child_process_1 = require("node:child_process");
-const promises_1 = __importDefault(require("node:fs/promises"));
-const node_path_1 = __importDefault(require("node:path"));
+const child_process_1 = require("child_process");
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const process_1 = __importDefault(require("process"));
+const nodeCompat_1 = require("../core/nodeCompat");
 const opsxDelivery_1 = require("../core/opsxDelivery");
 function hasCommand(cmd) {
-    const out = (0, node_child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" });
+    const out = (0, child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" });
     return out.status === 0;
 }
 async function hasPath(filePath) {
@@ -34,6 +36,11 @@ function agentBin(agent) {
 }
 async function runDoctor(options) {
     const checks = [];
+    checks.push({
+        name: "node-version",
+        ok: (0, nodeCompat_1.isNodeVersionSupported)(),
+        detail: `Node ${process_1.default.version}（要求 ${(0, nodeCompat_1.nodeVersionRequirementLabel)()}，推荐 18/20 LTS）`,
+    });
     checks.push({
         name: "git",
         ok: hasCommand("git"),
@@ -54,7 +61,7 @@ async function runDoctor(options) {
     }
     checks.push({
         name: "openspec-dir",
-        ok: await hasPath(node_path_1.default.join(options.projectRoot, "openspec")),
+        ok: await hasPath(path_1.default.join(options.projectRoot, "openspec")),
         detail: "openspec 目录存在性",
     });
     const toolDirMap = {
@@ -68,7 +75,7 @@ async function runDoctor(options) {
     if (expectedDir) {
         checks.push({
             name: `${options.agent}-dir`,
-            ok: await hasPath(node_path_1.default.join(options.projectRoot, expectedDir)),
+            ok: await hasPath(path_1.default.join(options.projectRoot, expectedDir)),
             detail: `${expectedDir} 目录存在性`,
         });
     }

package/dist/steps/invokeFlow.js

@@ -17,6 +17,7 @@ function parseInvokeText(text) {
     return { product, version };
 }
 function toRunOptions(args) {
+    var _a, _b;
     return {
         product: args.parsed.product,
         version: args.parsed.version,
@@ -24,6 +25,6 @@ function toRunOptions(args) {
         branch: args.branch,
         yes: args.yes,
         dryRun: args.dryRun,
-        agent: args.agent ?? args.parsed.agent ?? "claude-code",
+        agent: (_b = (_a = args.agent) !== null && _a !== void 0 ? _a : args.parsed.agent) !== null && _b !== void 0 ? _b : "claude-code",
     };
 }

package/dist/steps/runFlow.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runFlow = runFlow;
-const node_path_1 = __importDefault(require("node:path"));
+const path_1 = __importDefault(require("path"));
 const adapters_1 = require("../adapters");
 const fs_1 = require("../core/fs");
 const startFlow_1 = require("./startFlow");
@@ -41,7 +41,7 @@ async function runFlow(options) {
     const scaffold = options.dryRun
         ? {
             runId: "dry-run-no-files-generated",
-            outputRoot: node_path_1.default.join(options.projectRoot, "openspec", "PRD"),
+            outputRoot: path_1.default.join(options.projectRoot, "openspec", "PRD"),
         }
         : await (0, startFlow_1.startFlowScaffold)(options);
     const adapter = (0, adapters_1.getAdapter)(setup.agent);
@@ -63,7 +63,7 @@ async function runFlow(options) {
         version: options.version,
     });
     if (!options.dryRun) {
-        await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(scaffold.outputRoot, "AUTO-RUN-CHECKLIST.md"), checklist);
+        await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(scaffold.outputRoot, "AUTO-RUN-CHECKLIST.md"), checklist);
     }
     return {
         ...scaffold,

package/dist/steps/setupProject.js

@@ -4,19 +4,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupProject = setupProject;
-const node_child_process_1 = require("node:child_process");
-const node_path_1 = __importDefault(require("node:path"));
-const promises_1 = require("node:readline/promises");
-const node_process_1 = __importDefault(require("node:process"));
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const process_1 = __importDefault(require("process"));
 const fs_1 = require("../core/fs");
+const readlinePrompt_1 = require("../core/readlinePrompt");
+const utils_1 = require("../core/utils");
 const opsxDelivery_1 = require("../core/opsxDelivery");
 const templates_1 = require("../core/templates");
 const EDITOR_CHOICES = ["claude-code", "cursor", "codex", "openclaw"];
 const PROJECT_CHOICES = ["OMS", "ADI", "欢盟", "AD Tools"];
 function runGit(args, cwd) {
-    const out = (0, node_child_process_1.spawnSync)("git", args, { cwd, encoding: "utf8" });
+    var _a, _b;
+    const out = (0, child_process_1.spawnSync)("git", args, { cwd, encoding: "utf8" });
     if (out.status !== 0) {
-        const err = out.stderr?.trim() || out.stdout?.trim() || `git ${args.join(" ")} failed`;
+        const err = ((_a = out.stderr) === null || _a === void 0 ? void 0 : _a.trim()) || ((_b = out.stdout) === null || _b === void 0 ? void 0 : _b.trim()) || `git ${args.join(" ")} failed`;
         throw new Error(err);
     }
     return out.stdout.trim();
@@ -45,9 +47,9 @@ function listLocalBranches(projectRoot) {
     }
 }
 async function askAgent(defaultAgent) {
-    if (!node_process_1.default.stdin.isTTY)
+    if (!process_1.default.stdin.isTTY)
         return defaultAgent;
-    const rl = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
+    const rl = (0, readlinePrompt_1.createPromptInterface)();
     const prompt = [
         "请选择开发环境：",
         "1) claude-code (default)",
@@ -56,7 +58,7 @@ async function askAgent(defaultAgent) {
         "4) openclaw",
         "输入编号（回车默认 1）：",
     ].join("\n");
-    const answer = (await rl.question(`${prompt}\n`)).trim();
+    const answer = (await (0, readlinePrompt_1.promptLine)(rl, `${prompt}\n`)).trim();
     rl.close();
     if (!answer)
         return defaultAgent;
@@ -66,17 +68,17 @@ async function askAgent(defaultAgent) {
     return EDITOR_CHOICES[idx - 1];
 }
 async function askBranch(defaultBranch) {
-    if (!node_process_1.default.stdin.isTTY)
+    if (!process_1.default.stdin.isTTY)
         return defaultBranch;
-    const rl = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
-    const answer = (await rl.question(`请输入开发分支（默认 ${defaultBranch}）：\n`)).trim();
+    const rl = (0, readlinePrompt_1.createPromptInterface)();
+    const answer = (await (0, readlinePrompt_1.promptLine)(rl, `请输入开发分支（默认 ${defaultBranch}）：\n`)).trim();
     rl.close();
     return answer || defaultBranch;
 }
 async function askProjectKind(defaultKind) {
-    if (!node_process_1.default.stdin.isTTY)
+    if (!process_1.default.stdin.isTTY)
         return defaultKind;
-    const rl = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
+    const rl = (0, readlinePrompt_1.createPromptInterface)();
     const prompt = [
         "请选择当前项目类型（用于生成 PRD 下载 skill）：",
         "1) OMS (default)",
@@ -85,7 +87,7 @@ async function askProjectKind(defaultKind) {
         "4) AD Tools",
         "输入编号（回车默认 1）：",
     ].join("\n");
-    const answer = (await rl.question(`${prompt}\n`)).trim();
+    const answer = (await (0, readlinePrompt_1.promptLine)(rl, `${prompt}\n`)).trim();
     rl.close();
     if (!answer)
         return defaultKind;
@@ -114,7 +116,7 @@ function skillInstallPath(projectRoot, agent) {
     const rel = relMap[agent];
     if (!rel)
         return null;
-    return node_path_1.default.join(projectRoot, rel);
+    return path_1.default.join(projectRoot, rel);
 }
 function allSkillInstallPaths(projectRoot) {
     const agents = ["cursor", "claude-code", "codex", "openclaw"];
@@ -135,19 +137,19 @@ async function installAgentSkill(projectRoot) {
                 : target.includes("/.codex/")
                     ? "codex"
                     : "openclaw";
-        const content = template.replaceAll("{{AGENT_NAME}}", agentName);
+        const content = (0, utils_1.replaceAllStr)(template, "{{AGENT_NAME}}", agentName);
         await (0, fs_1.writeTextFileEnsuredDir)(target, content);
     }
 }
 async function installSddCursorRule(projectRoot) {
-    const rulePath = node_path_1.default.join(projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc");
+    const rulePath = path_1.default.join(projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc");
     const template = await (0, templates_1.loadTemplateText)("rules/sdd-no-implement-until-apply.mdc.template");
     await (0, fs_1.writeTextFileEnsuredDir)(rulePath, template);
 }
 function renderVars(template, vars) {
     let out = template;
     for (const [k, v] of Object.entries(vars)) {
-        out = out.replaceAll(`{{${k}}}`, v);
+        out = (0, utils_1.replaceAllStr)(out, `{{${k}}}`, v);
     }
     return out;
 }
@@ -166,7 +168,7 @@ function docSkillDirName(kind) {
 }
 async function installDocsSkill(projectRoot, kind) {
     const { dir, prefix } = docSkillDirName(kind);
-    const docsDir = node_path_1.default.join(projectRoot, "docs", dir);
+    const docsDir = path_1.default.join(projectRoot, "docs", dir);
     const pyTemplate = await (0, templates_1.loadTemplateText)("skills/confluence-doc.py.template");
     const mdTemplate = await (0, templates_1.loadTemplateText)("skills/doc-skill.SKILL.md.template");
     const md = renderVars(mdTemplate, {
@@ -176,9 +178,9 @@ async function installDocsSkill(projectRoot, kind) {
         PRODUCT_PREFIX_LOWER: prefix.toLowerCase(),
         SKILL_DIR: dir,
     });
-    const py = pyTemplate.replaceAll("{{DOC_PRODUCT_PREFIX}}", prefix);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(docsDir, "SKILL.md"), md);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(docsDir, "confluence-doc.py"), py);
+    const py = (0, utils_1.replaceAllStr)(pyTemplate, "{{DOC_PRODUCT_PREFIX}}", prefix);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(docsDir, "SKILL.md"), md);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(docsDir, "confluence-doc.py"), py);
     return { dirPath: docsDir };
 }
 function getOpsxPathsByAgent(agent) {
@@ -196,7 +198,7 @@ function getOpsxPathsByAgent(agent) {
     }
 }
 async function installOpsxConfig(projectRoot, agent) {
-    const target = node_path_1.default.join(projectRoot, ".opsx", "config.json");
+    const target = path_1.default.join(projectRoot, ".opsx", "config.json");
     const resolvedAgent = await (0, opsxDelivery_1.resolveOpsxAgent)(projectRoot, agent);
     const paths = getOpsxPathsByAgent(resolvedAgent);
     const config = {
@@ -216,11 +218,12 @@ async function installOpsxConfig(projectRoot, agent) {
     await (0, fs_1.writeTextFileEnsuredDir)(target, JSON.stringify(config, null, 2));
 }
 async function setupProject(options) {
-    const defaultAgent = options.agent ?? "claude-code";
+    var _a, _b, _c;
+    const defaultAgent = (_a = options.agent) !== null && _a !== void 0 ? _a : "claude-code";
     const selectedAgent = options.yes ? defaultAgent : await askAgent(defaultAgent);
-    const defaultKind = options.projectKind ?? "OMS";
+    const defaultKind = (_b = options.projectKind) !== null && _b !== void 0 ? _b : "OMS";
     const selectedKind = options.yes ? defaultKind : await askProjectKind(defaultKind);
-    const defaultBranch = options.branch ?? pickDefaultBranch(options.projectRoot);
+    const defaultBranch = (_c = options.branch) !== null && _c !== void 0 ? _c : pickDefaultBranch(options.projectRoot);
     const selectedBranch = options.yes ? defaultBranch : await askBranch(defaultBranch);
     const plannedActions = [];
     const branches = listLocalBranches(options.projectRoot);
@@ -268,9 +271,9 @@ async function setupProject(options) {
             plannedActions.push(`would install skill: ${skillPath}`);
         }
         const { dir } = docSkillDirName(selectedKind);
-        plannedActions.push(`would install docs skill: ${node_path_1.default.join(options.projectRoot, "docs", dir)}`);
-        plannedActions.push(`would install opsx config: ${node_path_1.default.join(options.projectRoot, ".opsx", "config.json")}`);
-        plannedActions.push(`would install cursor rule: ${node_path_1.default.join(options.projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc")}`);
+        plannedActions.push(`would install docs skill: ${path_1.default.join(options.projectRoot, "docs", dir)}`);
+        plannedActions.push(`would install opsx config: ${path_1.default.join(options.projectRoot, ".opsx", "config.json")}`);
+        plannedActions.push(`would install cursor rule: ${path_1.default.join(options.projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc")}`);
     }
     else {
         await installAgentSkill(options.projectRoot);
@@ -304,7 +307,7 @@ async function setupProject(options) {
         ...plannedActions.map((x) => `- ${x}`),
         "",
     ].join("\n");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(options.projectRoot, ".sdd-flow-kit", "setup-summary.md"), summary);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(options.projectRoot, ".sdd-flow-kit", "setup-summary.md"), summary);
     return {
         agent: selectedAgent,
         projectKind: selectedKind,

package/dist/steps/startFlow.js

@@ -4,8 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startFlowScaffold = startFlowScaffold;
-const node_path_1 = __importDefault(require("node:path"));
-const promises_1 = __importDefault(require("node:fs/promises"));
+const path_1 = __importDefault(require("path"));
+const promises_1 = __importDefault(require("fs/promises"));
 const utils_1 = require("../core/utils");
 const fs_1 = require("../core/fs");
 const templates_1 = require("../core/templates");
@@ -13,15 +13,15 @@ const inferProject_1 = require("../core/inferProject");
 function renderTemplate(template, vars) {
     let out = template;
     for (const [k, v] of Object.entries(vars)) {
-        out = out.replaceAll(`{{${k}}}`, v);
+        out = (0, utils_1.replaceAllStr)(out, `{{${k}}}`, v);
     }
     return out;
 }
 async function startFlowScaffold(options) {
     const now = new Date();
     const runId = `${(0, utils_1.formatYYYYMMDD)(now)}-${options.product}-${options.version}`;
-    const outputRoot = node_path_1.default.join(options.projectRoot, "openspec", "PRD", runId);
-    const sourceDir = node_path_1.default.join(outputRoot, "source");
+    const outputRoot = path_1.default.join(options.projectRoot, "openspec", "PRD", runId);
+    const sourceDir = path_1.default.join(outputRoot, "source");
     await promises_1.default.mkdir(sourceDir, { recursive: true });
     // 1) Step1: doc-skill 指引（按产品解析脚本路径，支持 monorepo frontend）
     const kind = (0, inferProject_1.productToKind)(options.product);
@@ -33,23 +33,23 @@ async function startFlowScaffold(options) {
         DOC_SKILL_REL: docSkill.relFromRoot.replace(/\\/g, "/"),
         VERSION_EXAMPLE: options.version,
     });
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "01-获取需求文档指引.md"), step1);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "01-获取需求文档指引.md"), step1);
     // source 占位：让第 2 步提示词在任何工具里都能直接读
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(sourceDir, "PRD.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(sourceDir, "PRD.md"), [
         "# source/PRD.md",
         "",
         "请把《PRD》markdown 内容粘贴到这里（由 `adi-doc-skill` 下载并回填）。",
         "",
         "- 建议：保持原有标题层级与编号。",
     ].join("\n"));
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(sourceDir, "接口文档.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(sourceDir, "接口文档.md"), [
         "# source/接口文档.md",
         "",
         "（可选）如果你已经有接口文档，请粘贴到这里；没有也不影响后续 SDD 循环。",
         "",
         "- 注意：接口文档中的字段/示例越完整，分析报告越贴近落地。",
     ].join("\n"));
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(sourceDir, "openspec-knowledge-base-summary.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(sourceDir, "openspec-knowledge-base-summary.md"), [
         "# source/openspec-knowledge-base-summary.md",
         "",
         "（可选）现有知识库摘要/快速索引，建议由你在执行第 2 步前手动整理。",
@@ -60,23 +60,23 @@ async function startFlowScaffold(options) {
     const sddLoopPrompt = await (0, templates_1.loadTemplateText)("prompts/02-sdd-loop-prompt.md");
     const step2PromptTemplate = await (0, templates_1.loadTemplateText)("artifacts/02-需求分析提示词.template.md");
     const step2Prompt = renderTemplate(step2PromptTemplate, { SDD_LOOP_PROMPT: sddLoopPrompt });
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "02-需求分析提示词.md"), step2Prompt);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "02-需求分析提示词.md"), step2Prompt);
     // 3) Step2 输出文件占位（由 AI 工具生成并覆盖）
     const file01Template = await (0, templates_1.loadTemplateText)("artifacts/01-需求分析报告.template.md");
     const file02Template = await (0, templates_1.loadTemplateText)("artifacts/02-改动点清单.template.md");
     const file03Template = await (0, templates_1.loadTemplateText)("artifacts/03-待确认问题清单.template.md");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "01-需求分析报告.md"), file01Template);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "02-改动点清单.md"), file02Template);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "03-待确认问题清单.md"), file03Template);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "01-需求分析报告.md"), file01Template);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "02-改动点清单.md"), file02Template);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "03-待确认问题清单.md"), file03Template);
     // 4) Step4 技术文档入口（草稿）
     const techDocTemplate = await (0, templates_1.loadTemplateText)("artifacts/04-技术文档.template.md");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "04-技术文档草稿.md"), techDocTemplate);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "04-技术文档草稿.md"), techDocTemplate);
     // 5) Step5 openspec 提案入口（草稿）
     const openspecEntryTemplate = await (0, templates_1.loadTemplateText)("artifacts/05-openspec-提案草稿.template.md");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "05-openspec-提案草稿.md"), openspecEntryTemplate);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "05-openspec-提案草稿.md"), openspecEntryTemplate);
     const opsxAutoChainTemplate = await (0, templates_1.loadTemplateText)("artifacts/06-opsx-auto-chain.template.md");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "06-opsx-自动串联指引.md"), opsxAutoChainTemplate);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, ".session-state.json"), JSON.stringify({
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "06-opsx-自动串联指引.md"), opsxAutoChainTemplate);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, ".session-state.json"), JSON.stringify({
         product: options.product,
         version: options.version,
         runId,
@@ -88,7 +88,7 @@ async function startFlowScaffold(options) {
         createdAtISO: new Date().toISOString(),
     }, null, 2));
     // runDir 自述
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "RUNME.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "RUNME.md"), [
         "# RUNME（SDD 流程执行说明）",
         "",
         `本次 runId: \`${runId}\``,

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "sdd-flow-kit",
-  "version": "1.0.25",
+  "version": "1.0.27",
   "private": false,
   "description": "Cross-agent SDD automated development workflow kit (ADI/ADI-like).",
   "license": "MIT",
+  "engines": {
+    "node": ">=14.16.0"
+  },
   "type": "commonjs",
   "main": "dist/index.js",
   "files": [