sdd-flow-kit 1.0.14 → 1.0.16

package/README.md

@@ -18,8 +18,9 @@
     检查是否安装  - `ls .cursor/skills/sdd-flow-kit/SKILL.md`
     - `ls .claude/skills/sdd-flow-kit/SKILL.md`
     - `ls docs/*-doc-skill/SKILL.md`
-3.  若仍未生成，执行手动兜底（100%触发初始化）：
-    - `node ./node_modules/sdd-flow-kit/dist/postinstall.js`
+3.  若 skill 未生成，执行手动兜底：
+    - `node ./node_modules/sdd-flow-kit/dist/postinstall.js`（轻量，秒级）
+    - 或 `npx sdd-flow-kit install -y`（完整环境）
     
 4.  （可选）预演安装：`npx sdd-flow-kit install --dry-run --plan-json`
 5.  （可选）环境健检：`npx sdd-flow-kit doctor --agent claude-code`
@@ -44,7 +45,11 @@
 
 团队推荐安装命令（稳妥）：
 
-`pnpm add -D sdd-flow-kit && pnpm rebuild sdd-flow-kit`
+`pnpm add -D sdd-flow-kit`
+
+> `postinstall` 仅做**轻量**初始化（写入 skill / Cursor 规则 / docs-skill / `.opsx/config.json`），**不会**交互提问，也**不会**跑 `npx opsx-workflow`（避免 `pnpm i` 卡住）。  
+> 完整环境（分支切换 + opsx-workflow）请另执行：`npx sdd-flow-kit install -y`  
+> 跳过 postinstall：`SDD_FLOW_KIT_SKIP_POSTINSTALL=1 pnpm add -D sdd-flow-kit`
 
 #### 使用说明
 

package/dist/postinstall.js

@@ -8,13 +8,6 @@ const promises_1 = __importDefault(require("node:fs/promises"));
 const node_process_1 = __importDefault(require("node:process"));
 const setupProject_1 = require("./steps/setupProject");
 const ALLOWED_PROJECTS = ["OMS", "ADI", "欢盟", "AD Tools"];
-function resolveProjectKindFromEnv() {
-    const raw = (node_process_1.default.env.SDD_FLOW_KIT_PROJECT ?? "").trim();
-    if (ALLOWED_PROJECTS.includes(raw)) {
-        return raw;
-    }
-    return "OMS";
-}
 async function inferProjectKind(projectRoot) {
     const fromEnv = (node_process_1.default.env.SDD_FLOW_KIT_PROJECT ?? "").trim();
     if (ALLOWED_PROJECTS.includes(fromEnv)) {
@@ -30,7 +23,6 @@ async function inferProjectKind(projectRoot) {
         return "欢盟";
     if (hit("ad-tools") || hit("adtools") || hit("tools"))
         return "AD Tools";
-    // 尝试读取项目 package.json 的 name 做二次推断
     try {
         const pkgText = await promises_1.default.readFile(node_path_1.default.join(projectRoot, "package.json"), "utf8");
         const pkg = JSON.parse(pkgText);
@@ -50,33 +42,57 @@ async function inferProjectKind(projectRoot) {
     }
     return "OMS";
 }
+async function inferAgent(projectRoot) {
+    const fromEnv = (node_process_1.default.env.SDD_FLOW_KIT_AGENT ?? "").trim();
+    const allowed = ["cursor", "claude-code", "codex", "openclaw"];
+    if (allowed.includes(fromEnv))
+        return fromEnv;
+    const exists = async (rel) => {
+        try {
+            await promises_1.default.access(node_path_1.default.join(projectRoot, rel));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    if (await exists(".cursor"))
+        return "cursor";
+    if (await exists(".claude"))
+        return "claude-code";
+    if (await exists(".codex"))
+        return "codex";
+    if (await exists(".openclaw"))
+        return "openclaw";
+    return "cursor";
+}
 async function main() {
-    // npm/pnpm 安装依赖时，INIT_CWD 指向用户项目根目录。
+    if (node_process_1.default.env.SDD_FLOW_KIT_SKIP_POSTINSTALL === "1") {
+        return;
+    }
     const initCwd = node_process_1.default.env.INIT_CWD ? node_path_1.default.resolve(node_process_1.default.env.INIT_CWD) : null;
     const pkgDir = node_path_1.default.resolve(__dirname, "..");
     const projectRoot = initCwd ?? node_process_1.default.cwd();
-    // 避免在本包自身仓库开发安装依赖时重复触发自动初始化。
     if (projectRoot === pkgDir)
         return;
-    const isInteractive = Boolean(node_process_1.default.stdin.isTTY && node_process_1.default.stdout.isTTY);
     const projectKind = await inferProjectKind(projectRoot);
+    const agent = await inferAgent(projectRoot);
     // eslint-disable-next-line no-console
-    console.log(`[sdd-flow-kit] postinstall bootstrap at: ${projectRoot}`);
+    console.log(`[sdd-flow-kit] postinstall (light) at: ${projectRoot}`);
     // eslint-disable-next-line no-console
-    console.log(`[sdd-flow-kit] interactive=${isInteractive}, inferredProject=${projectKind}`);
+    console.log(`[sdd-flow-kit] agent=${agent}, project=${projectKind}`);
     await (0, setupProject_1.setupProject)({
         projectRoot,
-        agent: "claude-code",
-        // 交互安装允许用户在 setupProject 内选择 agent/project/branch
-        yes: !isInteractive,
+        agent,
+        yes: true,
+        light: true,
         dryRun: false,
         projectKind,
     });
     // eslint-disable-next-line no-console
-    console.log("[sdd-flow-kit] setup completed");
+    console.log("[sdd-flow-kit] light setup done (skills/rules only). Full env: npx sdd-flow-kit install -y");
 }
 main().catch((err) => {
-    // 不阻断依赖安装，仅告警
     // eslint-disable-next-line no-console
     console.warn("[sdd-flow-kit] postinstall setup skipped:", err instanceof Error ? err.message : err);
 });

package/dist/steps/setupProject.js

@@ -268,20 +268,29 @@ async function setupProject(options) {
     const plannedActions = [];
     const branches = listLocalBranches(options.projectRoot);
     const branchExists = branches.includes(selectedBranch);
-    const branchResult = options.dryRun
-        ? { branch: selectedBranch, created: !branchExists }
-        : ensureBranch(options.projectRoot, selectedBranch);
-    if (options.dryRun) {
+    let branchResult;
+    if (options.light) {
+        branchResult = { branch: selectedBranch, created: false };
+        plannedActions.push("light mode: skipped git branch checkout");
+    }
+    else if (options.dryRun) {
+        branchResult = { branch: selectedBranch, created: !branchExists };
         plannedActions.push(branchExists
             ? `would checkout existing branch: ${selectedBranch}`
             : `would create and checkout branch: ${selectedBranch}`);
     }
+    else {
+        branchResult = ensureBranch(options.projectRoot, selectedBranch);
+    }
     let environmentReady = await isEditorEnvironmentReady(options.projectRoot, selectedAgent);
     let setupExecuted = false;
     let skillInstalled = false;
     let docsSkillInstalled = false;
     let opsxConfigInstalled = false;
-    if (!environmentReady) {
+    if (options.light) {
+        plannedActions.push("light mode: skipped npx @lixin5257xxx/opsx-workflow setup");
+    }
+    else if (!environmentReady) {
         const { cmd, args } = buildSetupCommand(options.projectRoot, selectedAgent);
         if (options.dryRun) {
             plannedActions.push(`would run: ${cmd} ${args.join(" ")}`);
@@ -332,6 +341,7 @@ async function setupProject(options) {
         `skillInstalled: ${skillInstalled}`,
         `docsSkillInstalled: ${docsSkillInstalled}`,
         `opsxConfigInstalled: ${opsxConfigInstalled}`,
+        `light: ${Boolean(options.light)}`,
         `dryRun: ${Boolean(options.dryRun)}`,
         "",
         "plannedActions:",

package/package.json

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