sdd-flow-kit 1.1.0 → 1.2.1

package/dist/postinstall.js

@@ -40,6 +40,7 @@ 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 projectRoots_1 = require("./core/projectRoots");
 const setupProject_1 = require("./steps/setupProject");
 async function inferAgent(projectRoot) {
     var _a;
@@ -68,50 +69,53 @@ async function inferAgent(projectRoot) {
     return "cursor";
 }
 async function main() {
+    var _a;
     if (process_1.default.env.SDD_FLOW_KIT_SKIP_POSTINSTALL === "1") {
         return;
     }
-    const initCwd = process_1.default.env.INIT_CWD ? path_1.default.resolve(process_1.default.env.INIT_CWD) : null;
+    const initCwd = (_a = process_1.default.env.INIT_CWD) === null || _a === void 0 ? void 0 : _a.trim();
     const pkgDir = path_1.default.resolve(__dirname, "..");
-    const projectRoot = initCwd !== null && initCwd !== void 0 ? initCwd : process_1.default.cwd();
+    if (!initCwd) {
+        // eslint-disable-next-line no-console
+        console.warn("[sdd-flow-kit] postinstall: 缺少 INIT_CWD，已跳过。请执行: npx sdd-flow-kit install --project ADI -y");
+        return;
+    }
+    const projectRoot = (0, projectRoots_1.resolveInstallRoot)(initCwd);
     if (projectRoot === pkgDir)
         return;
     const projectKind = await (0, inferProject_1.inferProjectKind)(projectRoot);
     const agent = await inferAgent(projectRoot);
+    const light = process_1.default.env.SDD_FLOW_KIT_POSTINSTALL_LIGHT === "1";
     // eslint-disable-next-line no-console
-    console.log(`[sdd-flow-kit] postinstall (light) at: ${projectRoot}`);
+    console.log(`[sdd-flow-kit] postinstall (${light ? "light" : "full"}) at: ${projectRoot}`);
     // eslint-disable-next-line no-console
     console.log(`[sdd-flow-kit] agent=${agent}, project=${projectKind}`);
-    await (0, setupProject_1.setupProject)({
+    const result = await (0, setupProject_1.setupProject)({
         projectRoot,
         agent,
         yes: true,
-        light: true,
+        light,
+        skipGit: true,
         dryRun: false,
         projectKind,
     });
-    const repaired = await (0, opsxDelivery_1.repairOpsxDeliveryScripts)(projectRoot);
-    if (repaired) {
-        // eslint-disable-next-line no-console
-        console.log("[sdd-flow-kit] repaired package.json opsx:delivery-pipeline scripts");
-    }
     const ready = await (0, opsxDelivery_1.isOpsxApplyReady)(projectRoot);
     if (!ready) {
         // eslint-disable-next-line no-console
-        console.warn("[sdd-flow-kit] OPSX/TDD/Playwright 工作流未就绪。/opsx-apply 前请执行: npx sdd-flow-kit ensure-opsx -y");
+        console.warn("[sdd-flow-kit] OPSX 未完全就绪。请执行: npx sdd-flow-kit install --project " +
+            `${projectKind} -y` +
+            (process_1.default.env.SDD_OPSX_WORKFLOW_PACKAGE ? "" : "（或设 SDD_OPSX_WORKFLOW_PACKAGE 指向本地 opsx-workflow）"));
     }
     else {
         // eslint-disable-next-line no-console
-        console.log("[sdd-flow-kit] opsx apply stack ready");
+        console.log("[sdd-flow-kit] 安装完成：SDD + OPSX + Superpowers 已就绪");
     }
     // eslint-disable-next-line no-console
-    console.log("[sdd-flow-kit] light setup done (skills/rules). Full install: npx sdd-flow-kit install --project ADI -y");
-    if (agent === "cursor") {
-        // eslint-disable-next-line no-console
-        console.log("[sdd-flow-kit] Cursor skill: .cursor/skills/sdd-flow-kit/SKILL.md");
-    }
+    console.log(`[sdd-flow-kit] 开发需求: npx sdd-flow-kit invoke "开发 ${projectKind} x.x.x 需求" -y`);
+    // eslint-disable-next-line no-console
+    console.log(`[sdd-flow-kit] environmentReady=${result.environmentReady}, setupExecuted=${result.setupExecuted}`);
 }
 main().catch((err) => {
     // eslint-disable-next-line no-console
-    console.warn("[sdd-flow-kit] postinstall setup skipped:", err instanceof Error ? err.message : err);
+    console.warn("[sdd-flow-kit] postinstall skipped:", err instanceof Error ? err.message : err);
 });

package/dist/steps/doctor.js

@@ -9,6 +9,7 @@ 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 bootstrap_1 = require("../core/bootstrap");
 const opsxDelivery_1 = require("../core/opsxDelivery");
 function hasCommand(cmd) {
     const out = (0, child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" });
@@ -83,6 +84,24 @@ async function runDoctor(options) {
         checks.push(c);
     }
     let ok = checks.every((c) => c.ok);
+    const opsxStackFailed = checks.some((c) => !c.ok &&
+        [
+            "opsx-dev-delivery-pipeline-skill",
+            "opsx-config",
+            "delivery-pipeline-script",
+            "package-json-delivery-script",
+        ].includes(c.name));
+    if (!ok && opsxStackFailed && !options.fix && !options.dryRun) {
+        await (0, bootstrap_1.bootstrapProjectIfNeeded)({
+            projectRoot: options.projectRoot,
+            agent: options.agent,
+        });
+        checks.length = 0;
+        for (const c of await (0, opsxDelivery_1.collectDeliverySetupChecks)(options.projectRoot)) {
+            checks.push(c);
+        }
+        ok = checks.every((c) => c.ok);
+    }
     if (!ok && options.fix) {
         const ensured = await (0, opsxDelivery_1.ensureOpsxWorkflow)({
             projectRoot: options.projectRoot,

package/dist/steps/invokeFlow.js

@@ -4,17 +4,24 @@ exports.parseInvokeText = parseInvokeText;
 exports.toRunOptions = toRunOptions;
 function parseInvokeText(text) {
     const normalized = text.trim();
-    // 兼容以下常见表达：
-    // - 开发 OMS 1.24.4 需求
-    // - 开发 OMS-V1.24.4 版本
-    // - 开发OMS-V1.24.4版本
-    // - 开发 AD Tools V1.2.3 PRD
-    const match = normalized.match(/开发\s*(.+?)(?:[-_\s]*)V?([0-9]+(?:\.[0-9]+){1,3})\s*(?:需求|版本|PRD)?/i);
-    if (!match)
-        return null;
-    const product = match[1].replace(/[-_\s]+$/g, "").toUpperCase();
-    const version = match[2];
-    return { product, version };
+    const patterns = [
+        /(?:开发|进行)\s*(.+?)(?:[-_\s]*)V?([0-9]+(?:\.[0-9]+){1,3})\s*(?:版本)?\s*(?:需求|PRD)?/i,
+        /([A-Za-z\u4e00-\u9fa5]+)[_\s-]?V?([0-9]+(?:\.[0-9]+){1,3})\s*版本/i,
+        /([A-Za-z]+)[_\s-]([0-9]+(?:\.[0-9]+){2,3})(?:\s|$)/i,
+    ];
+    for (const re of patterns) {
+        const match = normalized.match(re);
+        if (!match)
+            continue;
+        let product = match[1].replace(/[-_\s]+$/g, "").trim();
+        product = product.replace(/^进行/, "").trim();
+        if (/^adi$/i.test(product) || product.toUpperCase() === "ADI")
+            product = "ADI";
+        if (/^oms$/i.test(product))
+            product = "OMS";
+        return { product: product.toUpperCase(), version: match[2] };
+    }
+    return null;
 }
 function toRunOptions(args) {
     var _a, _b;

package/dist/steps/resolveRun.js

@@ -7,16 +7,15 @@ 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 目录：优先 --run-id，否则取最近修改的 run 目录。
+ * 解析 openspec/PRD 目录：从 installRoot（cwd）向上查找；优先 --run-id，否则取最近修改的 run 目录。
  */
 async function resolveRunDir(projectRoot, runId) {
-    const candidates = [
-        path_1.default.join(projectRoot, "openspec", "PRD"),
-        path_1.default.join(projectRoot, "frontend", "openspec", "PRD"),
-    ];
+    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 });

package/dist/steps/runDeliver.js

@@ -9,14 +9,8 @@ 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");
-async function resolvePackageRoot(projectRoot) {
-    const fe = path_1.default.join(projectRoot, "frontend", "package.json");
-    if (await (0, opsxDelivery_1.pathExists)(fe)) {
-        return path_1.default.join(projectRoot, "frontend");
-    }
-    return projectRoot;
-}
 /**
  * 实现阶段交付：先 gate impl-allowed，再 ensure-opsx，再跑 opsx:delivery-pipeline，写入 .delivery-pass.json。
  */
@@ -36,10 +30,11 @@ async function runDeliver(options) {
         (0, runGate_1.printGateResult)(implGate);
         return { ok: false, detail: "impl-allowed gate 未通过" };
     }
-    const pkgRoot = await resolvePackageRoot(options.projectRoot);
+    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}` };
+        return { ok: true, detail: `dry-run: would deliver in ${pkgRoot} (installRoot=${installRoot})` };
     }
     const ensured = await (0, opsxDelivery_1.ensureOpsxWorkflow)({
         projectRoot: pkgRoot,

package/dist/steps/runFlow.js

@@ -7,6 +7,7 @@ exports.runFlow = runFlow;
 const path_1 = __importDefault(require("path"));
 const adapters_1 = require("../adapters");
 const fs_1 = require("../core/fs");
+const inferProject_1 = require("../core/inferProject");
 const startFlow_1 = require("./startFlow");
 const setupProject_1 = require("./setupProject");
 function buildChecklist(args) {
@@ -37,6 +38,7 @@ async function runFlow(options) {
         branch: options.branch,
         yes: options.yes,
         dryRun: options.dryRun,
+        projectKind: (0, inferProject_1.productToKind)(options.product),
     });
     const scaffold = options.dryRun
         ? {

package/dist/steps/runGate.js

@@ -8,6 +8,7 @@ exports.printGateResult = printGateResult;
 const path_1 = __importDefault(require("path"));
 const prdArtifacts_1 = require("../core/prdArtifacts");
 const gitDiffGuard_1 = require("../core/gitDiffGuard");
+const projectRoots_1 = require("../core/projectRoots");
 const openspecGate_1 = require("../core/openspecGate");
 const resolveRun_1 = require("./resolveRun");
 const fs_1 = require("../core/fs");
@@ -22,9 +23,28 @@ async function readActiveChange(projectRoot, session, override) {
         return override;
     if (session === null || session === void 0 ? void 0 : session.activeChange)
         return session.activeChange;
-    const rootCandidates = [projectRoot, path_1.default.join(projectRoot, "frontend")];
-    for (const root of rootCandidates) {
-        const text = await (0, fs_1.readFileIfExists)(path_1.default.join(root, ".opsx-active-change"));
+    const installRoot = (0, projectRoots_1.resolveInstallRoot)(projectRoot);
+    const prdRoots = await (0, projectRoots_1.listOpenspecPrdRoots)(installRoot);
+    const dirs = [installRoot, ...prdRoots.map((p) => path_1.default.dirname(path_1.default.dirname(p)))];
+    const seen = new Set();
+    for (const root of dirs) {
+        const key = path_1.default.resolve(root);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const text = await (0, fs_1.readFileIfExists)(path_1.default.join(key, ".opsx-active-change"));
+        if (text) {
+            const line = text
+                .split("\n")
+                .map((l) => l.trim())
+                .find(Boolean);
+            if (line)
+                return line;
+        }
+    }
+    if ((0, projectRoots_1.isLegacyMonorepoMode)()) {
+        const fe = path_1.default.join(installRoot, "frontend", ".opsx-active-change");
+        const text = await (0, fs_1.readFileIfExists)(fe);
         if (text) {
             const line = text
                 .split("\n")
@@ -36,11 +56,15 @@ async function readActiveChange(projectRoot, session, override) {
     }
     return null;
 }
-function resolveImplRoots(projectRoot) {
-    const roots = [path_1.default.resolve(projectRoot)];
-    const fe = path_1.default.join(projectRoot, "frontend");
-    if (fe !== roots[0])
-        roots.push(path_1.default.resolve(fe));
+async function resolveImplRoots(projectRoot) {
+    const installRoot = (0, projectRoots_1.resolveInstallRoot)(projectRoot);
+    const roots = [installRoot];
+    if ((0, projectRoots_1.isLegacyMonorepoMode)()) {
+        const pkgRoot = await (0, projectRoots_1.resolvePackageRoot)(installRoot);
+        if (pkgRoot !== installRoot && !roots.includes(pkgRoot)) {
+            roots.push(pkgRoot);
+        }
+    }
     return roots;
 }
 /**
@@ -56,7 +80,7 @@ async function runGate(options) {
     const { resolved, session } = loaded;
     const outputRoot = resolved.outputRoot;
     const runId = resolved.runId;
-    const implRoots = resolveImplRoots(options.projectRoot);
+    const implRoots = await resolveImplRoots(options.projectRoot);
     if (options.expect === "prd-fetched") {
         const prd = await (0, prdArtifacts_1.isPrdFetched)(outputRoot);
         checks.push({ name: "prd-fetched", ...prd });
@@ -115,10 +139,19 @@ async function runGate(options) {
             checks.push({ name: "active-change", ok: false, detail: "未指定 change（--change 或 .opsx-active-change）" });
             return fail(checks, options.expect, runId);
         }
-        const roots = [options.projectRoot, path_1.default.join(options.projectRoot, "frontend")];
+        const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
+        const openspecRoots = [
+            installRoot,
+            ...(await (0, projectRoots_1.listOpenspecPrdRoots)(installRoot)).map((p) => path_1.default.dirname(path_1.default.dirname(p))),
+        ];
+        const seen = new Set();
         let found = false;
-        for (const root of roots) {
-            if (await (0, openspecGate_1.changeDirExists)(root, changeName)) {
+        for (const root of openspecRoots) {
+            const key = path_1.default.resolve(root);
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            if (await (0, openspecGate_1.changeDirExists)(key, changeName)) {
                 found = true;
                 const st = (0, openspecGate_1.checkOpenspecApplyReady)(root, changeName);
                 checks.push({ name: "openspec-apply-ready", ok: st.applyReady, detail: st.detail });
@@ -156,14 +189,32 @@ async function runGate(options) {
             checks.push({ name: "active-change", ok: false, detail: "未绑定 activeChange" });
             return fail(checks, options.expect, runId);
         }
-        const roots = [options.projectRoot, path_1.default.join(options.projectRoot, "frontend")];
-        for (const root of roots) {
-            if (await (0, openspecGate_1.changeDirExists)(root, changeName)) {
-                const st = (0, openspecGate_1.checkOpenspecApplyReady)(root, changeName);
+        const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
+        const openspecRoots = [
+            installRoot,
+            ...(await (0, projectRoots_1.listOpenspecPrdRoots)(installRoot)).map((p) => path_1.default.dirname(path_1.default.dirname(p))),
+        ];
+        const seen = new Set();
+        let found = false;
+        for (const root of openspecRoots) {
+            const key = path_1.default.resolve(root);
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            if (await (0, openspecGate_1.changeDirExists)(key, changeName)) {
+                found = true;
+                const st = (0, openspecGate_1.checkOpenspecApplyReady)(key, changeName);
                 checks.push({ name: "openspec-apply-ready", ok: st.applyReady, detail: st.detail });
                 break;
             }
         }
+        if (!found) {
+            checks.push({
+                name: "change-dir",
+                ok: false,
+                detail: `openspec/changes/${changeName} 不存在`,
+            });
+        }
         return pass(checks, options.expect, runId);
     }
     if (options.expect === "shipped") {
@@ -172,10 +223,19 @@ async function runGate(options) {
             checks.push({ name: "active-change", ok: false, detail: "未指定 change" });
             return fail(checks, options.expect, runId);
         }
-        const roots = [options.projectRoot, path_1.default.join(options.projectRoot, "frontend")];
-        for (const root of roots) {
-            if (await (0, openspecGate_1.changeDirExists)(root, changeName)) {
-                const tasks = await (0, openspecGate_1.checkTasksAllDone)(root, changeName);
+        const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
+        const openspecRoots = [
+            installRoot,
+            ...(await (0, projectRoots_1.listOpenspecPrdRoots)(installRoot)).map((p) => path_1.default.dirname(path_1.default.dirname(p))),
+        ];
+        const seen = new Set();
+        for (const root of openspecRoots) {
+            const key = path_1.default.resolve(root);
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            if (await (0, openspecGate_1.changeDirExists)(key, changeName)) {
+                const tasks = await (0, openspecGate_1.checkTasksAllDone)(key, changeName);
                 checks.push({ name: "tasks-done", ...tasks });
                 const marker = await (0, fs_1.readFileIfExists)(path_1.default.join(outputRoot, ".delivery-pass.json"));
                 if (marker) {

package/dist/steps/runPhaseAdvance.js

@@ -7,6 +7,7 @@ exports.runPhaseAdvance = runPhaseAdvance;
 const path_1 = __importDefault(require("path"));
 const runGate_1 = require("./runGate");
 const resolveRun_1 = require("./resolveRun");
+const projectRoots_1 = require("../core/projectRoots");
 const sessionState_1 = require("../core/sessionState");
 const fs_1 = require("../core/fs");
 const gitDiffGuard_1 = require("../core/gitDiffGuard");
@@ -112,9 +113,8 @@ async function runPhaseAdvance(options) {
         };
         if (!options.dryRun) {
             await (0, sessionState_1.writeSession)(outputRoot, next);
-            await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(options.projectRoot, ".opsx-active-change"), `${changeName}\n`);
-            const fe = path_1.default.join(options.projectRoot, "frontend", ".opsx-active-change");
-            await (0, fs_1.writeTextFileEnsuredDir)(fe, `${changeName}\n`).catch(() => undefined);
+            const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
+            await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(installRoot, ".opsx-active-change"), `${changeName}\n`);
             await writeNextMd(outputRoot, [
                 "## 当前：阶段 C 完成 → 进入 D（实现）",
                 "```bash",
@@ -139,9 +139,8 @@ async function runPhaseAdvance(options) {
             (0, runGate_1.printGateResult)(gate);
             return { ok: false, runId, message: "propose 未就绪，禁止进入实现" };
         }
-        const gitRoot = (0, gitDiffGuard_1.resolveGitRoot)(path_1.default.join(options.projectRoot, "frontend") === path_1.default.join(options.projectRoot)
-            ? options.projectRoot
-            : path_1.default.join(options.projectRoot, "frontend"));
+        const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
+        const gitRoot = (0, gitDiffGuard_1.resolveGitRoot)(installRoot);
         const head = (0, gitDiffGuard_1.gitDiffNameOnly)(gitRoot).head;
         const next = {
             ...session,

package/dist/steps/runPropose.js

@@ -9,7 +9,7 @@ const child_process_1 = require("child_process");
 const resolveRun_1 = require("./resolveRun");
 const runGate_1 = require("./runGate");
 const fs_1 = require("../core/fs");
-const opsxDelivery_1 = require("../core/opsxDelivery");
+const projectRoots_1 = require("../core/projectRoots");
 /**
  * 创建/校验 openspec change，并检查 apply-ready（不代替 AI 写 proposal 正文，但强制 gate）。
  */
@@ -27,14 +27,8 @@ async function runPropose(options) {
         (0, runGate_1.printGateResult)(docsGate);
         return { ok: false, detail: "docs-closed gate 未通过，禁止 propose" };
     }
-    const roots = [options.projectRoot, path_1.default.join(options.projectRoot, "frontend")];
-    let cwd = options.projectRoot;
-    for (const r of roots) {
-        if (await (0, opsxDelivery_1.pathExists)(path_1.default.join(r, "openspec"))) {
-            cwd = r;
-            break;
-        }
-    }
+    const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
+    const cwd = await (0, projectRoots_1.resolveOpenspecRoot)(installRoot);
     if (options.dryRun) {
         return { ok: true, detail: `dry-run: would openspec new change ${options.change}` };
     }

package/dist/steps/setupProject.js

@@ -11,6 +11,8 @@ 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 packageJsonPatch_1 = require("../core/packageJsonPatch");
+const projectRoots_1 = require("../core/projectRoots");
 const templates_1 = require("../core/templates");
 const EDITOR_CHOICES = ["claude-code", "cursor", "codex", "openclaw"];
 const PROJECT_CHOICES = ["OMS", "ADI", "欢盟", "AD Tools"];
@@ -124,7 +126,7 @@ function allSkillInstallPaths(projectRoot) {
         .map((agent) => skillInstallPath(projectRoot, agent))
         .filter((p) => Boolean(p));
 }
-async function installAgentSkill(projectRoot) {
+async function installAgentSkill(projectRoot, projectKind) {
     const targets = allSkillInstallPaths(projectRoot);
     if (targets.length === 0)
         return;
@@ -137,7 +139,11 @@ async function installAgentSkill(projectRoot) {
                 : target.includes("/.codex/")
                     ? "codex"
                     : "openclaw";
-        const content = (0, utils_1.replaceAllStr)(template, "{{AGENT_NAME}}", agentName);
+        const content = renderVars(template, {
+            AGENT_NAME: agentName,
+            PROJECT_KIND: projectKind,
+            DEFAULT_PRODUCT: projectKind === "AD Tools" ? "AD Tools" : projectKind,
+        });
         await (0, fs_1.writeTextFileEnsuredDir)(target, content);
     }
 }
@@ -219,19 +225,20 @@ async function installOpsxConfig(projectRoot, agent) {
 }
 async function setupProject(options) {
     var _a, _b, _c;
+    const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
     const defaultAgent = (_a = options.agent) !== null && _a !== void 0 ? _a : "claude-code";
     const selectedAgent = options.yes ? defaultAgent : await askAgent(defaultAgent);
     const defaultKind = (_b = options.projectKind) !== null && _b !== void 0 ? _b : "OMS";
     const selectedKind = options.yes ? defaultKind : await askProjectKind(defaultKind);
-    const defaultBranch = (_c = options.branch) !== null && _c !== void 0 ? _c : pickDefaultBranch(options.projectRoot);
+    const defaultBranch = (_c = options.branch) !== null && _c !== void 0 ? _c : pickDefaultBranch(installRoot);
     const selectedBranch = options.yes ? defaultBranch : await askBranch(defaultBranch);
-    const plannedActions = [];
-    const branches = listLocalBranches(options.projectRoot);
+    const plannedActions = [`installRoot=${installRoot}`];
+    const branches = listLocalBranches(installRoot);
     const branchExists = branches.includes(selectedBranch);
     let branchResult;
-    if (options.light) {
+    if (options.light || options.skipGit) {
         branchResult = { branch: selectedBranch, created: false };
-        plannedActions.push("light mode: skipped git branch checkout");
+        plannedActions.push(options.skipGit ? "skipGit: skipped git branch checkout" : "light mode: skipped git branch checkout");
     }
     else if (options.dryRun) {
         branchResult = { branch: selectedBranch, created: !branchExists };
@@ -240,9 +247,9 @@ async function setupProject(options) {
             : `would create and checkout branch: ${selectedBranch}`);
     }
     else {
-        branchResult = ensureBranch(options.projectRoot, selectedBranch);
+        branchResult = ensureBranch(installRoot, selectedBranch);
     }
-    let environmentReady = await (0, opsxDelivery_1.isOpsxApplyReady)(options.projectRoot);
+    let environmentReady = await (0, opsxDelivery_1.isOpsxApplyReady)(installRoot);
     let setupExecuted = false;
     let skillInstalled = false;
     let docsSkillInstalled = false;
@@ -255,7 +262,7 @@ async function setupProject(options) {
     }
     else if (!environmentReady) {
         const ensured = await (0, opsxDelivery_1.ensureOpsxWorkflow)({
-            projectRoot: options.projectRoot,
+            projectRoot: installRoot,
             agent: selectedAgent,
             dryRun: options.dryRun,
         });
@@ -267,23 +274,28 @@ async function setupProject(options) {
         plannedActions.push("opsx apply stack already ready");
     }
     if (options.dryRun) {
-        for (const skillPath of allSkillInstallPaths(options.projectRoot)) {
+        for (const skillPath of allSkillInstallPaths(installRoot)) {
             plannedActions.push(`would install skill: ${skillPath}`);
         }
         const { dir } = docSkillDirName(selectedKind);
-        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")}`);
+        plannedActions.push(`would install docs skill: ${path_1.default.join(installRoot, "docs", dir)}`);
+        plannedActions.push(`would install opsx config: ${path_1.default.join(installRoot, ".opsx", "config.json")}`);
+        plannedActions.push(`would install cursor rule: ${path_1.default.join(installRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc")}`);
     }
     else {
-        await installAgentSkill(options.projectRoot);
-        await installSddCursorRule(options.projectRoot);
+        const pkgRoot = await (0, projectRoots_1.resolvePackageRoot)(installRoot);
+        const pnpmPatched = await (0, packageJsonPatch_1.ensurePnpmAllowSddFlowKitBuild)(path_1.default.join(pkgRoot, "package.json"));
+        if (pnpmPatched) {
+            plannedActions.push("added pnpm.onlyBuiltDependencies: sdd-flow-kit");
+        }
+        await installAgentSkill(installRoot, selectedKind);
+        await installSddCursorRule(installRoot);
         skillInstalled = true;
-        await installDocsSkill(options.projectRoot, selectedKind);
+        await installDocsSkill(installRoot, selectedKind);
         docsSkillInstalled = true;
-        await installOpsxConfig(options.projectRoot, selectedAgent);
+        await installOpsxConfig(installRoot, selectedAgent);
         opsxConfigInstalled = true;
-        const repaired = await (0, opsxDelivery_1.repairOpsxDeliveryScripts)(options.projectRoot);
+        const repaired = await (0, opsxDelivery_1.repairOpsxDeliveryScripts)(pkgRoot);
         if (repaired) {
             plannedActions.push("repaired package.json opsx:delivery-pipeline scripts (poquan → opsx)");
         }
@@ -307,7 +319,7 @@ async function setupProject(options) {
         ...plannedActions.map((x) => `- ${x}`),
         "",
     ].join("\n");
-    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(options.projectRoot, ".sdd-flow-kit", "setup-summary.md"), summary);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(installRoot, ".sdd-flow-kit", "setup-summary.md"), summary);
     return {
         agent: selectedAgent,
         projectKind: selectedKind,

package/dist/steps/startFlow.js

@@ -11,6 +11,7 @@ const fs_1 = require("../core/fs");
 const templates_1 = require("../core/templates");
 const inferProject_1 = require("../core/inferProject");
 const sessionState_1 = require("../core/sessionState");
+const projectRoots_1 = require("../core/projectRoots");
 const writeNext_1 = require("../core/writeNext");
 function renderTemplate(template, vars) {
     let out = template;
@@ -22,7 +23,8 @@ function renderTemplate(template, vars) {
 async function startFlowScaffold(options) {
     const now = new Date();
     const runId = `${(0, utils_1.formatYYYYMMDD)(now)}-${options.product}-${options.version}`;
-    const outputRoot = path_1.default.join(options.projectRoot, "openspec", "PRD", runId);
+    const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
+    const outputRoot = path_1.default.join(installRoot, "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）

package/package.json

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