sdd-flow-kit 1.0.25 → 1.1.0

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/openspecGate.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkOpenspecApplyReady = checkOpenspecApplyReady;
+exports.checkTasksAllDone = checkTasksAllDone;
+exports.changeDirExists = changeDirExists;
+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");
+/**
+ * 解析 openspec status --json，判断 change 是否 apply-ready。
+ */
+function checkOpenspecApplyReady(projectRoot, changeName) {
+    const ret = (0, child_process_1.spawnSync)("openspec", ["status", "--change", changeName, "--json"], {
+        cwd: projectRoot,
+        encoding: "utf8",
+    });
+    if (ret.status !== 0) {
+        return {
+            ok: false,
+            changeName,
+            applyReady: false,
+            detail: ret.stderr || ret.stdout || "openspec status 失败",
+        };
+    }
+    try {
+        const json = JSON.parse(ret.stdout || "{}");
+        const requires = json.applyRequires || [];
+        const artifacts = json.artifacts || [];
+        const pending = requires.filter((id) => {
+            const art = artifacts.find((a) => a.id === id);
+            return !art || art.status !== "done";
+        });
+        const applyReady = pending.length === 0 && requires.length > 0;
+        return {
+            ok: true,
+            changeName,
+            applyReady,
+            detail: applyReady
+                ? "apply-ready"
+                : `待完成 artifacts: ${pending.join(", ") || requires.join(", ")}`,
+        };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            changeName,
+            applyReady: false,
+            detail: `无法解析 openspec status JSON: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+/**
+ * 检查 tasks.md 是否全部勾选完成。
+ */
+async function checkTasksAllDone(projectRoot, changeName) {
+    const tasksPath = path_1.default.join(projectRoot, "openspec", "changes", changeName, "tasks.md");
+    const content = await (0, fs_1.readFileIfExists)(tasksPath);
+    if (!content) {
+        return { ok: false, detail: `缺少 tasks.md: ${tasksPath}` };
+    }
+    const open = content.match(/^- \[ \]/gm);
+    if (open && open.length > 0) {
+        return { ok: false, detail: `tasks.md 仍有 ${open.length} 项未完成` };
+    }
+    const hasTask = /- \[[xX]\]/.test(content);
+    if (!hasTask) {
+        return { ok: false, detail: "tasks.md 无已勾选任务" };
+    }
+    return { ok: true, detail: "tasks.md 已全部勾选" };
+}
+async function changeDirExists(projectRoot, changeName) {
+    try {
+        await promises_1.default.access(path_1.default.join(projectRoot, "openspec", "changes", changeName));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

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/prdArtifacts.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPrdFetched = isPrdFetched;
+exports.isQuestionsClosed = isQuestionsClosed;
+exports.areAnalysisDocsReady = areAnalysisDocsReady;
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("./fs");
+const PRD_PLACEHOLDER_MARKERS = [
+    "请把《PRD》",
+    "占位",
+    "placeholder",
+];
+async function isPrdFetched(outputRoot) {
+    const prdPath = path_1.default.join(outputRoot, "source", "PRD.md");
+    const content = await (0, fs_1.readFileIfExists)(prdPath);
+    if (!content || content.trim().length < 80) {
+        return { ok: false, detail: "source/PRD.md 缺失或过短" };
+    }
+    if (PRD_PLACEHOLDER_MARKERS.some((m) => content.includes(m))) {
+        return { ok: false, detail: "source/PRD.md 仍为占位内容，请先执行 Step1 拉取 PRD" };
+    }
+    return { ok: true, detail: "PRD 已回填" };
+}
+async function isQuestionsClosed(outputRoot) {
+    const p = path_1.default.join(outputRoot, "03-待确认问题清单.md");
+    const content = await (0, fs_1.readFileIfExists)(p);
+    if (!content) {
+        return { ok: false, detail: "缺少 03-待确认问题清单.md" };
+    }
+    if (/矛盾点池状态[：:]\s*[`「]*未闭合/.test(content)) {
+        return { ok: false, detail: "矛盾点池状态：未闭合" };
+    }
+    if (!/矛盾点池状态[：:]\s*[`「]*已闭合/.test(content)) {
+        return { ok: false, detail: "03 未标注「矛盾点池状态：已闭合」" };
+    }
+    return { ok: true, detail: "矛盾点池已闭合" };
+}
+async function areAnalysisDocsReady(outputRoot) {
+    const files = ["01-需求分析报告.md", "02-改动点清单.md", "04-技术文档草稿.md"];
+    for (const name of files) {
+        const content = await (0, fs_1.readFileIfExists)(path_1.default.join(outputRoot, name));
+        if (!content || content.trim().length < 120) {
+            return { ok: false, detail: `${name} 缺失或过短（阶段 B 未就绪）` };
+        }
+        if (name === "01-需求分析报告.md" && content.includes("（由 AI 工具生成")) {
+            return { ok: false, detail: `${name} 仍为模板占位` };
+        }
+    }
+    return { ok: true, detail: "01/02/04 文档齐全" };
+}

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/sessionState.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSession = readSession;
+exports.writeSession = writeSession;
+exports.defaultSession = defaultSession;
+exports.normalizeSession = normalizeSession;
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("./fs");
+const SESSION_FILE = ".session-state.json";
+async function readSession(outputRoot) {
+    const raw = await (0, fs_1.readFileIfExists)(path_1.default.join(outputRoot, SESSION_FILE));
+    if (!raw)
+        return null;
+    return JSON.parse(raw);
+}
+async function writeSession(outputRoot, state) {
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, SESSION_FILE), `${JSON.stringify(state, null, 2)}\n`);
+}
+function defaultSession(args) {
+    return {
+        product: args.product,
+        version: args.version,
+        runId: args.runId,
+        outputRoot: args.outputRoot,
+        phase: "A",
+        status: "awaiting_user_confirmation",
+        docModeOnly: true,
+        autoChainOpsx: true,
+        activeChange: null,
+        createdAtISO: new Date().toISOString(),
+        implGitBaseline: null,
+    };
+}
+/** 将旧版 session（无 phase 字段）迁移为当前结构 */
+function normalizeSession(raw, outputRoot) {
+    var _a, _b, _c, _d, _e;
+    const phase = raw.phase || "A";
+    const status = raw.status || "awaiting_user_confirmation";
+    return {
+        product: String((_a = raw.product) !== null && _a !== void 0 ? _a : ""),
+        version: String((_b = raw.version) !== null && _b !== void 0 ? _b : ""),
+        runId: String((_c = raw.runId) !== null && _c !== void 0 ? _c : ""),
+        outputRoot: String((_d = raw.outputRoot) !== null && _d !== void 0 ? _d : outputRoot),
+        phase,
+        status,
+        docModeOnly: raw.docModeOnly !== false,
+        autoChainOpsx: raw.autoChainOpsx !== false,
+        activeChange: raw.activeChange ? String(raw.activeChange) : null,
+        createdAtISO: String((_e = raw.createdAtISO) !== null && _e !== void 0 ? _e : new Date().toISOString()),
+        implGitBaseline: raw.implGitBaseline ? String(raw.implGitBaseline) : null,
+    };
+}

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/core/writeNext.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeInitialNext = writeInitialNext;
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("./fs");
+/**
+ * run 初始化后写入 NEXT.md，强制 AI 按脚本推进而非自然语言跳步。
+ */
+async function writeInitialNext(outputRoot, projectRoot, runId) {
+    const pr = projectRoot.replace(/\\/g, "/");
+    const lines = [
+        "# NEXT（脚本门禁 — 必须按顺序执行）",
+        "",
+        "> **禁止**跳过下列命令。失败 (exit≠0) 时不得进入下一阶段或修改 `src/`。",
+        "",
+        "## 1. Step1 — 拉取 PRD",
+        "按 `01-获取需求文档指引.md` 执行 confluence 脚本，然后：",
+        "```bash",
+        `npx sdd-flow-kit gate --project-root "${pr}" --run-id ${runId} --expect prd-fetched`,
+        `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to after-prd`,
+        "```",
+        "",
+        "## 2. Step2 — 需求分析（提问模式）",
+        "执行 `02-需求分析提示词.md`。未闭合时仅改 `03`，并确认：",
+        "```bash",
+        `npx sdd-flow-kit gate --project-root "${pr}" --run-id ${runId} --expect questions-open`,
+        "```",
+        "",
+        "## 3. 用户确认后 — 阶段 B（仅文档）",
+        "生成 01/02/04 后：",
+        "```bash",
+        `npx sdd-flow-kit gate --project-root "${pr}" --run-id ${runId} --expect docs-closed`,
+        `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to docs-done`,
+        "```",
+        "",
+        "## 4. 阶段 C — propose",
+        "```bash",
+        `npx sdd-flow-kit propose --project-root "${pr}" --run-id ${runId} --change <kebab-name>`,
+        `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to propose-done --change <kebab-name>`,
+        "```",
+        "",
+        "## 5. 阶段 D — 实现 + 交付",
+        "```bash",
+        `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to impl --change <kebab-name>`,
+        `npx sdd-flow-kit deliver --project-root "${pr}" --run-id ${runId} --change <kebab-name>`,
+        `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to shipped --change <kebab-name>`,
+        "```",
+        "",
+    ];
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "NEXT.md"), lines.join("\n"));
+}