sdd-flow-kit 1.0.27 → 1.1.1

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

@@ -0,0 +1,94 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveInstallRoot = resolveInstallRoot;
+exports.isLegacyMonorepoMode = isLegacyMonorepoMode;
+exports.resolveOpenspecRoot = resolveOpenspecRoot;
+exports.resolvePackageRoot = resolvePackageRoot;
+exports.listOpenspecPrdRoots = listOpenspecPrdRoots;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+async function pathExists(filePath) {
+    try {
+        await promises_1.default.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 安装根：严格等于 CLI 的 projectRoot（默认 process.cwd()）。
+ * 可通过 SDD_FLOW_KIT_INSTALL_ROOT 覆盖（绝对路径）。
+ * 原则：cd 到哪，package.json / .cursor/skills / opsx-workflow 就装到哪。
+ */
+function resolveInstallRoot(projectRoot) {
+    var _a;
+    const fromEnv = (_a = process.env.SDD_FLOW_KIT_INSTALL_ROOT) === null || _a === void 0 ? void 0 : _a.trim();
+    if (fromEnv)
+        return path_1.default.resolve(fromEnv);
+    return path_1.default.resolve(projectRoot);
+}
+/** 是否启用旧版 monorepo 行为（在仓库根执行时自动落到 frontend/） */
+function isLegacyMonorepoMode() {
+    return process.env.SDD_FLOW_KIT_LEGACY_MONOREPO === "1" || process.env.SDD_FLOW_KIT_LEGACY_MONOREPO === "true";
+}
+/**
+ * 从 installRoot 向上查找含 openspec/ 的目录（用于解析 PRD run、openspec CLI）。
+ * 找不到则退回 installRoot（将在其下新建 openspec/PRD）。
+ */
+async function resolveOpenspecRoot(installRoot) {
+    let cur = path_1.default.resolve(installRoot);
+    for (let i = 0; i < 12; i += 1) {
+        if (await pathExists(path_1.default.join(cur, "openspec"))) {
+            return cur;
+        }
+        const parent = path_1.default.dirname(cur);
+        if (parent === cur)
+            break;
+        cur = parent;
+    }
+    return path_1.default.resolve(installRoot);
+}
+/**
+ * 交付/门禁用的包根：默认与 installRoot 相同。
+ * 仅当 SDD_FLOW_KIT_LEGACY_MONOREPO=1 且 installRoot 无 package.json 但存在 frontend/package.json 时回落到 frontend/。
+ */
+async function resolvePackageRoot(installRoot) {
+    const root = resolveInstallRoot(installRoot);
+    if (!isLegacyMonorepoMode()) {
+        return root;
+    }
+    const pkgAtRoot = path_1.default.join(root, "package.json");
+    if (await pathExists(pkgAtRoot)) {
+        return root;
+    }
+    const fePkg = path_1.default.join(root, "frontend", "package.json");
+    if (await pathExists(fePkg)) {
+        return path_1.default.join(root, "frontend");
+    }
+    return root;
+}
+/**
+ * 收集自 installRoot 向上所有存在的 openspec/PRD 目录（用于 resolveRun）。
+ */
+async function listOpenspecPrdRoots(startDir) {
+    const seen = new Set();
+    const out = [];
+    let cur = path_1.default.resolve(startDir);
+    for (let i = 0; i < 12; i += 1) {
+        const prdRoot = path_1.default.join(cur, "openspec", "PRD");
+        const key = prdRoot.toLowerCase();
+        if (!seen.has(key) && (await pathExists(prdRoot))) {
+            seen.add(key);
+            out.push(prdRoot);
+        }
+        const parent = path_1.default.dirname(cur);
+        if (parent === cur)
+            break;
+        cur = parent;
+    }
+    return out;
+}

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/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"));
+}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toRunOptions = exports.parseInvokeText = exports.runDoctor = exports.setupProject = exports.runFlow = exports.startFlowScaffold = void 0;
+exports.loadRunSession = exports.resolveRunDir = exports.runDeliver = exports.runPropose = exports.runPhaseAdvance = exports.printGateResult = exports.runGate = exports.toRunOptions = exports.parseInvokeText = exports.runDoctor = exports.setupProject = exports.runFlow = exports.startFlowScaffold = void 0;
 var startFlow_1 = require("./steps/startFlow");
 Object.defineProperty(exports, "startFlowScaffold", { enumerable: true, get: function () { return startFlow_1.startFlowScaffold; } });
 var runFlow_1 = require("./steps/runFlow");
@@ -12,3 +12,15 @@ Object.defineProperty(exports, "runDoctor", { enumerable: true, get: function ()
 var invokeFlow_1 = require("./steps/invokeFlow");
 Object.defineProperty(exports, "parseInvokeText", { enumerable: true, get: function () { return invokeFlow_1.parseInvokeText; } });
 Object.defineProperty(exports, "toRunOptions", { enumerable: true, get: function () { return invokeFlow_1.toRunOptions; } });
+var runGate_1 = require("./steps/runGate");
+Object.defineProperty(exports, "runGate", { enumerable: true, get: function () { return runGate_1.runGate; } });
+Object.defineProperty(exports, "printGateResult", { enumerable: true, get: function () { return runGate_1.printGateResult; } });
+var runPhaseAdvance_1 = require("./steps/runPhaseAdvance");
+Object.defineProperty(exports, "runPhaseAdvance", { enumerable: true, get: function () { return runPhaseAdvance_1.runPhaseAdvance; } });
+var runPropose_1 = require("./steps/runPropose");
+Object.defineProperty(exports, "runPropose", { enumerable: true, get: function () { return runPropose_1.runPropose; } });
+var runDeliver_1 = require("./steps/runDeliver");
+Object.defineProperty(exports, "runDeliver", { enumerable: true, get: function () { return runDeliver_1.runDeliver; } });
+var resolveRun_1 = require("./steps/resolveRun");
+Object.defineProperty(exports, "resolveRunDir", { enumerable: true, get: function () { return resolveRun_1.resolveRunDir; } });
+Object.defineProperty(exports, "loadRunSession", { enumerable: true, get: function () { return resolveRun_1.loadRunSession; } });

package/dist/steps/resolveRun.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRunDir = resolveRunDir;
+exports.loadRunSession = loadRunSession;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const projectRoots_1 = require("../core/projectRoots");
+const sessionState_1 = require("../core/sessionState");
+const fs_1 = require("../core/fs");
+/**
+ * 解析 openspec/PRD 目录：从 installRoot（cwd）向上查找；优先 --run-id，否则取最近修改的 run 目录。
+ */
+async function resolveRunDir(projectRoot, runId) {
+    const installRoot = (0, projectRoots_1.resolveInstallRoot)(projectRoot);
+    const candidates = await (0, projectRoots_1.listOpenspecPrdRoots)(installRoot);
+    for (const prdRoot of candidates) {
+        try {
+            const entries = await promises_1.default.readdir(prdRoot, { withFileTypes: true });
+            const dirs = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+            if (dirs.length === 0)
+                continue;
+            if (runId) {
+                if (!dirs.includes(runId))
+                    continue;
+                const outputRoot = path_1.default.join(prdRoot, runId);
+                return { runId, outputRoot, prdRoot };
+            }
+            let latest = null;
+            for (const name of dirs) {
+                const full = path_1.default.join(prdRoot, name);
+                const st = await promises_1.default.stat(full);
+                if (!latest || st.mtimeMs > latest.mtime) {
+                    latest = { name, mtime: st.mtimeMs };
+                }
+            }
+            if (!latest)
+                continue;
+            const outputRoot = path_1.default.join(prdRoot, latest.name);
+            return { runId: latest.name, outputRoot, prdRoot };
+        }
+        catch {
+            // 目录不存在，尝试下一个候选
+        }
+    }
+    return null;
+}
+async function loadRunSession(projectRoot, runId) {
+    const resolved = await resolveRunDir(projectRoot, runId);
+    if (!resolved)
+        return null;
+    const raw = await (0, fs_1.readFileIfExists)(path_1.default.join(resolved.outputRoot, ".session-state.json"));
+    if (!raw)
+        return { resolved, session: null };
+    const parsed = JSON.parse(raw);
+    const session = (0, sessionState_1.normalizeSession)(parsed, resolved.outputRoot);
+    return { resolved, session };
+}

package/dist/steps/runDeliver.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDeliver = runDeliver;
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const resolveRun_1 = require("./resolveRun");
+const runGate_1 = require("./runGate");
+const opsxDelivery_1 = require("../core/opsxDelivery");
+const projectRoots_1 = require("../core/projectRoots");
+const fs_1 = require("../core/fs");
+/**
+ * 实现阶段交付：先 gate impl-allowed，再 ensure-opsx，再跑 opsx:delivery-pipeline，写入 .delivery-pass.json。
+ */
+async function runDeliver(options) {
+    var _a;
+    const loaded = await (0, resolveRun_1.loadRunSession)(options.projectRoot, options.runId);
+    if (!(loaded === null || loaded === void 0 ? void 0 : loaded.resolved)) {
+        return { ok: false, detail: "未找到 PRD run" };
+    }
+    const implGate = await (0, runGate_1.runGate)({
+        projectRoot: options.projectRoot,
+        runId: loaded.resolved.runId,
+        expect: "impl-allowed",
+        change: options.change,
+    });
+    if (!implGate.ok) {
+        (0, runGate_1.printGateResult)(implGate);
+        return { ok: false, detail: "impl-allowed gate 未通过" };
+    }
+    const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
+    const pkgRoot = await (0, projectRoots_1.resolvePackageRoot)(installRoot);
+    const agent = options.agent || "cursor";
+    if (options.dryRun) {
+        return { ok: true, detail: `dry-run: would deliver in ${pkgRoot} (installRoot=${installRoot})` };
+    }
+    const ensured = await (0, opsxDelivery_1.ensureOpsxWorkflow)({
+        projectRoot: pkgRoot,
+        agent,
+        dryRun: false,
+    });
+    if (!ensured.ready) {
+        return { ok: false, detail: "ensure-opsx 未就绪" };
+    }
+    let exitCode = 0;
+    if (!options.skipPipeline) {
+        const ret = (0, child_process_1.spawnSync)("pnpm", ["run", "opsx:delivery-pipeline", "--", options.change], {
+            cwd: pkgRoot,
+            stdio: "inherit",
+            shell: process.platform === "win32",
+        });
+        exitCode = (_a = ret.status) !== null && _a !== void 0 ? _a : 1;
+    }
+    const passPayload = {
+        change: options.change,
+        exitCode,
+        at: new Date().toISOString(),
+        projectRoot: pkgRoot,
+    };
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(loaded.resolved.outputRoot, ".delivery-pass.json"), `${JSON.stringify(passPayload, null, 2)}\n`);
+    if (exitCode !== 0) {
+        return { ok: false, detail: `delivery-pipeline 退出码 ${exitCode}` };
+    }
+    const shipped = await (0, runGate_1.runGate)({
+        projectRoot: options.projectRoot,
+        runId: loaded.resolved.runId,
+        expect: "shipped",
+        change: options.change,
+    });
+    (0, runGate_1.printGateResult)(shipped);
+    if (!shipped.ok) {
+        return { ok: false, detail: "pipeline 已跑但 shipped gate 未通过（检查 tasks.md）" };
+    }
+    return { ok: true, detail: "交付完成" };
+}