sdd-flow-kit 1.2.1 → 1.2.3

package/dist/adapters/index.js

@@ -19,7 +19,7 @@ function createManualAdapter(name, displayName, bins) {
         async checkAvailable() {
             return bins.some((bin) => hasCommand(bin));
         },
-        async runFlow() {
+        async runFlow(_args) {
             return false;
         },
     };
@@ -71,10 +71,88 @@ async function runClaudeFlow(args) {
         return false;
     return /SDD flow completed/i.test(commandResult.stdout || "");
 }
+async function runCursorFlow(args) {
+    var _a;
+    /**
+     * Cursor Agent 自动执行开关：
+     * - 默认开启（符合“除澄清外全自动”的产品预期）
+     * - 如需关闭：SDD_FLOW_KIT_ENABLE_CURSOR_AUTORUN=0
+     */
+    if (process_1.default.env.SDD_FLOW_KIT_ENABLE_CURSOR_AUTORUN === "0") {
+        return false;
+    }
+    if (!hasCommand("cursor"))
+        return false;
+    const sddPrompt = await (0, fs_1.readFileIfExists)(path_1.default.join(args.outputRoot, "02-需求分析提示词.md"));
+    if (!sddPrompt)
+        return false;
+    const prompt = [
+        `你在项目目录内执行 SDD 流程（runId=${args.runId}）。目标：除“需求澄清”外全自动推进。`,
+        "",
+        "强约束：",
+        "1) 在 docs 阶段（docModeOnly=true）只允许改 openspec/PRD/**，禁止改 src/。",
+        "2) 若矛盾点池未闭合：仅更新 03-待确认问题清单.md 并停止，等待用户确认点。",
+        "3) 若矛盾点池已闭合：同一回合生成 01/02/04，并自动衔接 openspec+superpowers（autoChainOpsx=true 时）。",
+        "",
+        "执行顺序：",
+        "A) 先按 01-获取需求文档指引.md 执行 confluence-doc.py，把 PRD 回填到 source/PRD.md。",
+        "B) 再执行 02-需求分析提示词.md（如下）生成/更新 03（必要时）或生成 01/02/04。",
+        "C) 若满足自动串联条件（autoChainOpsx!==false 且用户未说只提案）：继续按 06-opsx-自动串联指引.md 走 propose→apply→delivery-pipeline。",
+        "",
+        "完成判定：",
+        "- 若停在澄清：输出一句 `SDD_STATUS=AWAIT_CONFIRMATION`。",
+        "- 若全链路完成：输出一句 `SDD_STATUS=COMPLETE`。",
+        "",
+        "以下是第 B 步提示词：",
+        sddPrompt,
+    ].join("\n");
+    const commandResult = (0, child_process_1.spawnSync)("cursor", [
+        "agent",
+        "--print",
+        "--trust",
+        "--workspace",
+        args.projectRoot,
+        prompt,
+    ], {
+        cwd: args.outputRoot,
+        encoding: "utf8",
+        env: process_1.default.env,
+    });
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(args.outputRoot, "AUTO-RUN-LOG.md"), [
+        "# AUTO-RUN-LOG",
+        "",
+        "agent: cursor-agent",
+        `status: ${(_a = commandResult.status) !== null && _a !== void 0 ? _a : "unknown"}`,
+        "",
+        "## stdout",
+        commandResult.stdout || "",
+        "",
+        "## stderr",
+        commandResult.stderr || "",
+    ].join("\n"));
+    if (commandResult.status !== 0)
+        return false;
+    return /SDD_STATUS=COMPLETE/i.test(commandResult.stdout || "");
+}
 function getAdapter(name) {
     switch (name) {
         case "cursor":
-            return createManualAdapter("cursor", "Cursor", ["cursor"]);
+            return {
+                name: "cursor",
+                displayName: "Cursor",
+                async checkAvailable() {
+                    return hasCommand("cursor");
+                },
+                async runFlow(args) {
+                    return runCursorFlow({
+                        projectRoot: args.projectRoot,
+                        outputRoot: args.outputRoot,
+                        runId: args.runId,
+                        product: args.product,
+                        version: args.version,
+                    });
+                },
+            };
         case "claude-code":
             return {
                 name: "claude-code",

package/dist/cli.js

@@ -62,8 +62,10 @@ function printHelp() {
         "8) 阶段推进（更新 session + NEXT.md）：",
         "   npx sdd-flow-kit phase advance --project-root . --run-id <runId> --to after-prd|docs-done|propose-done|impl|shipped",
         "",
-        "9) 提案 / 交付：",
+        "9) 提案 / 实现 / 交付：",
         "   npx sdd-flow-kit propose --project-root . --run-id <runId> --change <name>",
+        "   npx sdd-flow-kit phase advance --project-root . --run-id <runId> --to impl --change <name>",
+        "   # 在 AI 工具执行 /opsx-apply，按 tasks.md 逐条实现并勾选 [x]",
         "   npx sdd-flow-kit deliver --project-root . --run-id <runId> --change <name>",
         "",
         "可选参数：",
@@ -363,7 +365,7 @@ async function main() {
     // eslint-disable-next-line no-console
     console.log(`流程已初始化：openspec/PRD/${result.runId}/`);
     // eslint-disable-next-line no-console
-    console.log(`请打开 openspec/PRD/${result.runId}/NEXT.md，严格按 gate→phase→propose→deliver 执行；确认点前禁止改 src/。`);
+    console.log(`请打开 openspec/PRD/${result.runId}/NEXT.md，严格按 gate→phase→propose→impl(/opsx-apply)→deliver 执行；确认点前禁止改 src/。`);
     // eslint-disable-next-line no-console
     console.log(`agent=${result.adapterName}, cli=${result.adapterAvailable ? "detected" : "missing"}, autoExecute=${result.executed ? "yes" : "manual"}`);
     // eslint-disable-next-line no-console

package/dist/core/gitDiffGuard.js

@@ -40,9 +40,7 @@ function gitDiffNameOnly(projectRoot) {
 /** 业务实现路径：命中则视为「实现层改动」 */
 const IMPL_PATH_PATTERNS = [
     /^src\//,
-    /^e2e\//,
     /^frontend\/src\//,
-    /^frontend\/e2e\//,
     /^app\//,
     /^pages\//,
     /^components\//,

package/dist/core/writeNext.js

@@ -42,9 +42,14 @@ async function writeInitialNext(outputRoot, projectRoot, runId) {
         `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to propose-done --change <kebab-name>`,
         "```",
         "",
-        "## 5. 阶段 D — 实现 + 交付",
+        "## 5. 阶段 D — /opsx-apply 实现 tasks（必做）",
         "```bash",
         `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to impl --change <kebab-name>`,
+        "# 然后在 AI 工具中执行 /opsx-apply，按 tasks.md 逐条实现并勾选为 [x]",
+        "```",
+        "",
+        "## 6. 阶段 E — 交付与收尾",
+        "```bash",
         `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>`,
         "```",

package/dist/steps/runFlow.js

@@ -53,6 +53,7 @@ async function runFlow(options) {
         : await adapter.runFlow({
             runId: scaffold.runId,
             outputRoot: scaffold.outputRoot,
+            projectRoot: options.projectRoot,
             product: options.product,
             version: options.version,
         });

package/dist/steps/runPhaseAdvance.js

@@ -117,6 +117,7 @@ async function runPhaseAdvance(options) {
             await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(installRoot, ".opsx-active-change"), `${changeName}\n`);
             await writeNextMd(outputRoot, [
                 "## 当前：阶段 C 完成 → 进入 D（实现）",
+                "说明：先进入 impl，再在 AI 工具执行 `/opsx-apply` 按 tasks.md 实现；完成后才可 deliver。",
                 "```bash",
                 `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${runId} --to impl --change ${changeName}`,
                 "```",
@@ -158,6 +159,7 @@ async function runPhaseAdvance(options) {
                 "```bash",
                 `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${runId} --expect impl-allowed --change ${changeName}`,
                 "```",
+                "在 AI 工具中执行：`/opsx-apply`（必须先完成 tasks.md 全部 [x]）",
                 "完成后交付：",
                 "```bash",
                 `npx sdd-flow-kit deliver --project-root ${options.projectRoot} --run-id ${runId} --change ${changeName}`,

package/dist/steps/runPropose.js

@@ -51,7 +51,9 @@ async function runPropose(options) {
         "",
         `change: \`${options.change}\``,
         "",
-        "AI 须按 openspec-propose skill 生成 proposal/design/specs/tasks，完成后执行：",
+        "AI 须按 openspec-propose skill 生成 proposal/design/specs/tasks。",
+        "注意：propose 结束后不能直接 deliver，必须先 `/opsx-apply` 执行 tasks。",
+        "完成提案后执行：",
         "```bash",
         `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${loaded.resolved.runId} --expect propose-ready --change ${options.change}`,
         `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${loaded.resolved.runId} --to propose-done --change ${options.change}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-flow-kit",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "private": false,
   "description": "Cross-agent SDD automated development workflow kit (ADI/ADI-like).",
   "license": "MIT",