sdd-flow-kit 1.0.27 → 1.1.1

package/dist/steps/runGate.js

@@ -0,0 +1,280 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGate = runGate;
+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");
+function fail(checks, expect, runId) {
+    return { ok: false, expect, runId, checks };
+}
+function pass(checks, expect, runId) {
+    return { ok: checks.every((c) => c.ok), expect, runId, checks };
+}
+async function readActiveChange(projectRoot, session, override) {
+    if (override)
+        return override;
+    if (session === null || session === void 0 ? void 0 : session.activeChange)
+        return session.activeChange;
+    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")
+                .map((l) => l.trim())
+                .find(Boolean);
+            if (line)
+                return line;
+        }
+    }
+    return null;
+}
+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;
+}
+/**
+ * 脚本门禁：失败时 process.exitCode=1，成功 exit 0。
+ */
+async function runGate(options) {
+    const loaded = await (0, resolveRun_1.loadRunSession)(options.projectRoot, options.runId);
+    const checks = [];
+    if (!loaded || !loaded.resolved) {
+        checks.push({ name: "run-resolved", ok: false, detail: "未找到 openspec/PRD/<runId> 目录" });
+        return fail(checks, options.expect, null);
+    }
+    const { resolved, session } = loaded;
+    const outputRoot = resolved.outputRoot;
+    const runId = resolved.runId;
+    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 });
+        return pass(checks, options.expect, runId);
+    }
+    if (options.expect === "questions-open") {
+        const closed = await (0, prdArtifacts_1.isQuestionsClosed)(outputRoot);
+        checks.push({
+            name: "questions-open",
+            ok: !closed.ok,
+            detail: closed.ok ? "矛盾点已闭合，不应处于提问模式" : "提问模式有效（未闭合）",
+        });
+        return pass(checks, options.expect, runId);
+    }
+    if (options.expect === "docs-closed") {
+        const prd = await (0, prdArtifacts_1.isPrdFetched)(outputRoot);
+        checks.push({ name: "prd-fetched", ...prd });
+        const closed = await (0, prdArtifacts_1.isQuestionsClosed)(outputRoot);
+        checks.push({ name: "questions-closed", ...closed });
+        const docs = await (0, prdArtifacts_1.areAnalysisDocsReady)(outputRoot);
+        checks.push({ name: "analysis-docs", ...docs });
+        if (session && session.docModeOnly === false) {
+            checks.push({
+                name: "doc-mode",
+                ok: false,
+                detail: "session.docModeOnly=false，请先处于文档阶段（勿提前 phase advance --to impl）",
+            });
+        }
+        else if (session) {
+            checks.push({ name: "doc-mode", ok: true, detail: "docModeOnly=true" });
+        }
+        else {
+            checks.push({ name: "doc-mode", ok: true, detail: "无 session，跳过 docModeOnly 校验" });
+        }
+        for (const root of implRoots) {
+            const gitRoot = (0, gitDiffGuard_1.resolveGitRoot)(root);
+            const diff = (0, gitDiffGuard_1.gitDiffNameOnly)(gitRoot);
+            if (!diff.isRepo) {
+                checks.push({ name: "git-impl-diff", ok: true, detail: "非 git 仓库，跳过 src 改动检测" });
+                continue;
+            }
+            const impl = (0, gitDiffGuard_1.findImplChanges)(diff.changedFiles);
+            checks.push({
+                name: "git-impl-diff",
+                ok: impl.length === 0,
+                detail: impl.length === 0
+                    ? "工作区无业务实现路径改动"
+                    : `禁止在文档阶段修改实现代码: ${impl.slice(0, 8).join(", ")}${impl.length > 8 ? "..." : ""}`,
+            });
+        }
+        return pass(checks, options.expect, runId);
+    }
+    if (options.expect === "propose-ready") {
+        const changeName = await readActiveChange(options.projectRoot, session, options.change);
+        if (!changeName) {
+            checks.push({ name: "active-change", ok: false, detail: "未指定 change（--change 或 .opsx-active-change）" });
+            return fail(checks, options.expect, runId);
+        }
+        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)(root, 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 === "impl-allowed") {
+        if (!session) {
+            checks.push({ name: "session", ok: false, detail: "缺少 .session-state.json" });
+            return fail(checks, options.expect, runId);
+        }
+        checks.push({
+            name: "doc-mode-off",
+            ok: session.docModeOnly === false,
+            detail: session.docModeOnly === false
+                ? "已进入实现模式 docModeOnly=false"
+                : "仍处文档模式，请执行: sdd-flow-kit phase advance --to impl",
+        });
+        checks.push({
+            name: "phase-d",
+            ok: session.phase === "D" || session.status === "apply_in_progress",
+            detail: `当前 phase=${session.phase}, status=${session.status}`,
+        });
+        const changeName = await readActiveChange(options.projectRoot, session, options.change);
+        if (!changeName) {
+            checks.push({ name: "active-change", ok: false, detail: "未绑定 activeChange" });
+            return fail(checks, options.expect, runId);
+        }
+        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") {
+        const changeName = await readActiveChange(options.projectRoot, session, options.change);
+        if (!changeName) {
+            checks.push({ name: "active-change", ok: false, detail: "未指定 change" });
+            return fail(checks, options.expect, runId);
+        }
+        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) {
+                    try {
+                        const j = JSON.parse(marker);
+                        const ok = j.exitCode === 0 && (!j.change || j.change === changeName);
+                        checks.push({
+                            name: "delivery-pass",
+                            ok,
+                            detail: ok ? "delivery-pass.json 有效" : "delivery-pass.json 与 change 不匹配或失败",
+                        });
+                    }
+                    catch {
+                        checks.push({ name: "delivery-pass", ok: false, detail: "delivery-pass.json 解析失败" });
+                    }
+                }
+                else {
+                    checks.push({
+                        name: "delivery-pass",
+                        ok: false,
+                        detail: "缺少 .delivery-pass.json，请先执行: sdd-flow-kit deliver --change <name>",
+                    });
+                }
+                break;
+            }
+        }
+        return pass(checks, options.expect, runId);
+    }
+    checks.push({ name: "expect", ok: false, detail: `未知 --expect: ${options.expect}` });
+    return fail(checks, options.expect, runId);
+}
+function printGateResult(result) {
+    var _a;
+    // eslint-disable-next-line no-console
+    console.log(`\n[sdd-flow-kit gate] expect=${result.expect} runId=${(_a = result.runId) !== null && _a !== void 0 ? _a : "?"}`);
+    for (const c of result.checks) {
+        // eslint-disable-next-line no-console
+        console.log(`  [${c.ok ? "OK" : "FAIL"}] ${c.name}: ${c.detail}`);
+    }
+    // eslint-disable-next-line no-console
+    console.log(result.ok ? "\n✅ GATE PASS\n" : "\n❌ GATE FAIL\n");
+}

package/dist/steps/runPhaseAdvance.js

@@ -0,0 +1,194 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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");
+async function writeNextMd(outputRoot, lines) {
+    const body = ["# NEXT（脚本门禁 — 请按顺序执行）", "", ...lines, ""].join("\n");
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "NEXT.md"), body);
+}
+/**
+ * 阶段推进：先跑 gate，通过后更新 .session-state.json 与 NEXT.md。
+ */
+async function runPhaseAdvance(options) {
+    const loaded = await (0, resolveRun_1.loadRunSession)(options.projectRoot, options.runId);
+    if (!loaded || !loaded.resolved || !loaded.session) {
+        return { ok: false, runId: null, message: "未找到 run 或 .session-state.json" };
+    }
+    const { resolved, session } = loaded;
+    const outputRoot = resolved.outputRoot;
+    const runId = resolved.runId;
+    let gate = await (0, runGate_1.runGate)({
+        projectRoot: options.projectRoot,
+        runId,
+        expect: "prd-fetched",
+        change: options.change,
+    });
+    if (options.to === "after-prd") {
+        gate = await (0, runGate_1.runGate)({ projectRoot: options.projectRoot, runId, expect: "prd-fetched" });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "gate prd-fetched 未通过" };
+        }
+        const next = {
+            ...session,
+            phase: "A",
+            status: "awaiting_user_confirmation",
+            docModeOnly: true,
+        };
+        if (!options.dryRun) {
+            await (0, sessionState_1.writeSession)(outputRoot, next);
+            await writeNextMd(outputRoot, [
+                "## 当前：阶段 A（需求分析）",
+                "1. 执行 `02-需求分析提示词.md`",
+                "2. 若未闭合：仅更新 `03-待确认问题清单.md`，然后执行：",
+                "```bash",
+                `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${runId} --expect questions-open`,
+                "```",
+                "3. 用户确认后生成 01/02/04，再执行：",
+                "```bash",
+                `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${runId} --to docs-done`,
+                "```",
+            ]);
+        }
+        return { ok: true, runId, message: "已进入阶段 A（PRD 已就绪）" };
+    }
+    if (options.to === "docs-done") {
+        gate = await (0, runGate_1.runGate)({ projectRoot: options.projectRoot, runId, expect: "docs-closed" });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "gate docs-closed 未通过（禁止带 src 改动）" };
+        }
+        const next = {
+            ...session,
+            phase: "B",
+            status: "ready_for_propose",
+            docModeOnly: true,
+        };
+        if (!options.dryRun) {
+            await (0, sessionState_1.writeSession)(outputRoot, next);
+            await writeNextMd(outputRoot, [
+                "## 当前：阶段 B 完成 → 进入 C（提案）",
+                "1. 执行 openspec propose（或）：",
+                "```bash",
+                `npx sdd-flow-kit propose --project-root ${options.projectRoot} --run-id ${runId} --change <kebab-name>`,
+                "```",
+                "2. 提案 apply-ready 后：",
+                "```bash",
+                `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${runId} --to propose-done --change <name>`,
+                "```",
+            ]);
+        }
+        return { ok: true, runId, message: "阶段 B 完成，可进入 propose" };
+    }
+    if (options.to === "propose-done") {
+        const changeName = options.change || session.activeChange;
+        if (!changeName) {
+            return { ok: false, runId, message: "需要 --change <name>" };
+        }
+        gate = await (0, runGate_1.runGate)({
+            projectRoot: options.projectRoot,
+            runId,
+            expect: "propose-ready",
+            change: changeName,
+        });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "gate propose-ready 未通过" };
+        }
+        const next = {
+            ...session,
+            phase: "C",
+            status: "propose_done",
+            docModeOnly: true,
+            activeChange: changeName,
+        };
+        if (!options.dryRun) {
+            await (0, sessionState_1.writeSession)(outputRoot, next);
+            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",
+                `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${runId} --to impl --change ${changeName}`,
+                "```",
+            ]);
+        }
+        return { ok: true, runId, message: `提案就绪: ${changeName}` };
+    }
+    if (options.to === "impl") {
+        const changeName = options.change || session.activeChange;
+        if (!changeName) {
+            return { ok: false, runId, message: "需要 --change <name>" };
+        }
+        gate = await (0, runGate_1.runGate)({
+            projectRoot: options.projectRoot,
+            runId,
+            expect: "propose-ready",
+            change: changeName,
+        });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "propose 未就绪，禁止进入实现" };
+        }
+        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,
+            phase: "D",
+            status: "apply_in_progress",
+            docModeOnly: false,
+            activeChange: changeName,
+            implGitBaseline: head,
+        };
+        if (!options.dryRun) {
+            await (0, sessionState_1.writeSession)(outputRoot, next);
+            await writeNextMd(outputRoot, [
+                "## 当前：阶段 D（允许修改 src/）",
+                "实现前门禁：",
+                "```bash",
+                `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${runId} --expect impl-allowed --change ${changeName}`,
+                "```",
+                "完成后交付：",
+                "```bash",
+                `npx sdd-flow-kit deliver --project-root ${options.projectRoot} --run-id ${runId} --change ${changeName}`,
+                "```",
+            ]);
+        }
+        return { ok: true, runId, message: "已进入实现阶段（docModeOnly=false）" };
+    }
+    if (options.to === "shipped") {
+        const changeName = options.change || session.activeChange;
+        gate = await (0, runGate_1.runGate)({
+            projectRoot: options.projectRoot,
+            runId,
+            expect: "shipped",
+            change: changeName,
+        });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "gate shipped 未通过" };
+        }
+        const next = {
+            ...session,
+            phase: "done",
+            status: "complete",
+            docModeOnly: false,
+        };
+        if (!options.dryRun) {
+            await (0, sessionState_1.writeSession)(outputRoot, next);
+            await writeNextMd(outputRoot, ["## ✅ SDD 流程已完成（delivery-pass）"]);
+        }
+        return { ok: true, runId, message: "流程完成" };
+    }
+    return { ok: false, runId, message: `未知 --to: ${options.to}` };
+}

package/dist/steps/runPropose.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPropose = runPropose;
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const resolveRun_1 = require("./resolveRun");
+const runGate_1 = require("./runGate");
+const fs_1 = require("../core/fs");
+const projectRoots_1 = require("../core/projectRoots");
+/**
+ * 创建/校验 openspec change，并检查 apply-ready（不代替 AI 写 proposal 正文，但强制 gate）。
+ */
+async function runPropose(options) {
+    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 docsGate = await (0, runGate_1.runGate)({
+        projectRoot: options.projectRoot,
+        runId: loaded.resolved.runId,
+        expect: "docs-closed",
+    });
+    if (!docsGate.ok) {
+        (0, runGate_1.printGateResult)(docsGate);
+        return { ok: false, detail: "docs-closed gate 未通过，禁止 propose" };
+    }
+    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}` };
+    }
+    const exists = (0, child_process_1.spawnSync)("openspec", ["status", "--change", options.change, "--json"], {
+        cwd,
+        encoding: "utf8",
+    });
+    if (exists.status !== 0) {
+        const created = (0, child_process_1.spawnSync)("openspec", ["new", "change", options.change], {
+            cwd,
+            stdio: "inherit",
+        });
+        if (created.status !== 0) {
+            return { ok: false, detail: `openspec new change 失败: ${options.change}` };
+        }
+    }
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(cwd, ".opsx-active-change"), `${options.change}\n`);
+    const proposeNote = [
+        "# Propose 脚本检查点",
+        "",
+        `change: \`${options.change}\``,
+        "",
+        "AI 须按 openspec-propose skill 生成 proposal/design/specs/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}`,
+        "```",
+        "",
+    ].join("\n");
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(loaded.resolved.outputRoot, "05-openspec-提案草稿.md"), proposeNote);
+    const ready = await (0, runGate_1.runGate)({
+        projectRoot: options.projectRoot,
+        runId: loaded.resolved.runId,
+        expect: "propose-ready",
+        change: options.change,
+    });
+    (0, runGate_1.printGateResult)(ready);
+    if (!ready.ok) {
+        return {
+            ok: false,
+            detail: "change 已创建，但尚未 apply-ready；请生成 artifacts 后重跑 gate propose-ready",
+        };
+    }
+    return { ok: true, detail: `change ${options.change} apply-ready` };
+}

package/dist/steps/setupProject.js

@@ -11,6 +11,7 @@ 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 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"];
@@ -219,14 +220,15 @@ 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) {
@@ -240,9 +242,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 +257,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 +269,24 @@ 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);
+        await installAgentSkill(installRoot);
+        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 pkgRoot = await (0, projectRoots_1.resolvePackageRoot)(installRoot);
+        const repaired = await (0, opsxDelivery_1.repairOpsxDeliveryScripts)(pkgRoot);
         if (repaired) {
             plannedActions.push("repaired package.json opsx:delivery-pipeline scripts (poquan → opsx)");
         }
@@ -307,7 +310,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,