@deepstorm/cli 0.9.0 → 0.9.2

package/dist/cli.js

@@ -1187,13 +1187,13 @@ var require_ast = __commonJS({
         helperExpression: function helperExpression(node) {
           return node.type === "SubExpression" || (node.type === "MustacheStatement" || node.type === "BlockStatement") && !!(node.params && node.params.length || node.hash);
         },
-        scopedId: function scopedId(path23) {
-          return /^\.|this\b/.test(path23.original);
+        scopedId: function scopedId(path24) {
+          return /^\.|this\b/.test(path24.original);
         },
         // an ID is simple if it only has one part, and that part is not
         // `..` or `this`.
-        simpleId: function simpleId(path23) {
-          return path23.parts.length === 1 && !AST.helpers.scopedId(path23) && !path23.depth;
+        simpleId: function simpleId(path24) {
+          return path24.parts.length === 1 && !AST.helpers.scopedId(path24) && !path24.depth;
         }
       }
     };
@@ -2263,12 +2263,12 @@ var require_helpers2 = __commonJS({
         loc
       };
     }
-    function prepareMustache(path23, params, hash, open, strip, locInfo) {
+    function prepareMustache(path24, params, hash, open, strip, locInfo) {
       var escapeFlag = open.charAt(3) || open.charAt(2), escaped = escapeFlag !== "{" && escapeFlag !== "&";
       var decorator = /\*/.test(open);
       return {
         type: decorator ? "Decorator" : "MustacheStatement",
-        path: path23,
+        path: path24,
         params,
         hash,
         escaped,
@@ -2586,9 +2586,9 @@ var require_compiler = __commonJS({
       },
       DecoratorBlock: function DecoratorBlock(decorator) {
         var program2 = decorator.program && this.compileProgram(decorator.program);
-        var params = this.setupFullMustacheParams(decorator, program2, void 0), path23 = decorator.path;
+        var params = this.setupFullMustacheParams(decorator, program2, void 0), path24 = decorator.path;
         this.useDecorators = true;
-        this.opcode("registerDecorator", params.length, path23.original);
+        this.opcode("registerDecorator", params.length, path24.original);
       },
       PartialStatement: function PartialStatement(partial) {
         this.usePartial = true;
@@ -2652,46 +2652,46 @@ var require_compiler = __commonJS({
         }
       },
       ambiguousSexpr: function ambiguousSexpr(sexpr, program2, inverse) {
-        var path23 = sexpr.path, name = path23.parts[0], isBlock = program2 != null || inverse != null;
-        this.opcode("getContext", path23.depth);
+        var path24 = sexpr.path, name = path24.parts[0], isBlock = program2 != null || inverse != null;
+        this.opcode("getContext", path24.depth);
         this.opcode("pushProgram", program2);
         this.opcode("pushProgram", inverse);
-        path23.strict = true;
-        this.accept(path23);
+        path24.strict = true;
+        this.accept(path24);
         this.opcode("invokeAmbiguous", name, isBlock);
       },
       simpleSexpr: function simpleSexpr(sexpr) {
-        var path23 = sexpr.path;
-        path23.strict = true;
-        this.accept(path23);
+        var path24 = sexpr.path;
+        path24.strict = true;
+        this.accept(path24);
         this.opcode("resolvePossibleLambda");
       },
       helperSexpr: function helperSexpr(sexpr, program2, inverse) {
-        var params = this.setupFullMustacheParams(sexpr, program2, inverse), path23 = sexpr.path, name = path23.parts[0];
+        var params = this.setupFullMustacheParams(sexpr, program2, inverse), path24 = sexpr.path, name = path24.parts[0];
         if (this.options.knownHelpers[name]) {
           this.opcode("invokeKnownHelper", params.length, name);
         } else if (this.options.knownHelpersOnly) {
           throw new _exception2["default"]("You specified knownHelpersOnly, but used the unknown helper " + name, sexpr);
         } else {
-          path23.strict = true;
-          path23.falsy = true;
-          this.accept(path23);
-          this.opcode("invokeHelper", params.length, path23.original, _ast2["default"].helpers.simpleId(path23));
+          path24.strict = true;
+          path24.falsy = true;
+          this.accept(path24);
+          this.opcode("invokeHelper", params.length, path24.original, _ast2["default"].helpers.simpleId(path24));
         }
       },
-      PathExpression: function PathExpression(path23) {
-        this.addDepth(path23.depth);
-        this.opcode("getContext", path23.depth);
-        var name = path23.parts[0], scoped = _ast2["default"].helpers.scopedId(path23), blockParamId = !path23.depth && !scoped && this.blockParamIndex(name);
+      PathExpression: function PathExpression(path24) {
+        this.addDepth(path24.depth);
+        this.opcode("getContext", path24.depth);
+        var name = path24.parts[0], scoped = _ast2["default"].helpers.scopedId(path24), blockParamId = !path24.depth && !scoped && this.blockParamIndex(name);
         if (blockParamId) {
-          this.opcode("lookupBlockParam", blockParamId, path23.parts);
+          this.opcode("lookupBlockParam", blockParamId, path24.parts);
         } else if (!name) {
           this.opcode("pushContext");
-        } else if (path23.data) {
+        } else if (path24.data) {
           this.options.data = true;
-          this.opcode("lookupData", path23.depth, path23.parts, path23.strict);
+          this.opcode("lookupData", path24.depth, path24.parts, path24.strict);
         } else {
-          this.opcode("lookupOnContext", path23.parts, path23.falsy, path23.strict, scoped);
+          this.opcode("lookupOnContext", path24.parts, path24.falsy, path24.strict, scoped);
         }
       },
       StringLiteral: function StringLiteral(string) {
@@ -3041,16 +3041,16 @@ var require_util = __commonJS({
     }
     exports2.urlGenerate = urlGenerate;
     function normalize(aPath) {
-      var path23 = aPath;
+      var path24 = aPath;
       var url = urlParse(aPath);
       if (url) {
         if (!url.path) {
           return aPath;
         }
-        path23 = url.path;
+        path24 = url.path;
       }
-      var isAbsolute = exports2.isAbsolute(path23);
-      var parts = path23.split(/\/+/);
+      var isAbsolute = exports2.isAbsolute(path24);
+      var parts = path24.split(/\/+/);
       for (var part, up = 0, i = parts.length - 1; i >= 0; i--) {
         part = parts[i];
         if (part === ".") {
@@ -3067,18 +3067,18 @@ var require_util = __commonJS({
           }
         }
       }
-      path23 = parts.join("/");
-      if (path23 === "") {
-        path23 = isAbsolute ? "/" : ".";
+      path24 = parts.join("/");
+      if (path24 === "") {
+        path24 = isAbsolute ? "/" : ".";
       }
       if (url) {
-        url.path = path23;
+        url.path = path24;
         return urlGenerate(url);
       }
-      return path23;
+      return path24;
     }
     exports2.normalize = normalize;
-    function join21(aRoot, aPath) {
+    function join22(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -3110,7 +3110,7 @@ var require_util = __commonJS({
       }
       return joined;
     }
-    exports2.join = join21;
+    exports2.join = join22;
     exports2.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -3283,7 +3283,7 @@ var require_util = __commonJS({
             parsed.path = parsed.path.substring(0, index + 1);
           }
         }
-        sourceURL = join21(urlGenerate(parsed), sourceURL);
+        sourceURL = join22(urlGenerate(parsed), sourceURL);
       }
       return normalize(sourceURL);
     }
@@ -5858,8 +5858,8 @@ var require_printer = __commonJS({
       return this.accept(sexpr.path) + " " + params + hash;
     };
     PrintVisitor.prototype.PathExpression = function(id) {
-      var path23 = id.parts.join("/");
-      return (id.data ? "@" : "") + "PATH:" + path23;
+      var path24 = id.parts.join("/");
+      return (id.data ? "@" : "") + "PATH:" + path24;
     };
     PrintVisitor.prototype.StringLiteral = function(string) {
       return '"' + string.value + '"';
@@ -5912,7 +5912,7 @@ var require_lib = __commonJS({
 // src/index.ts
 var import_commander = require("commander");
 var fs27 = __toESM(require("node:fs"));
-var path22 = __toESM(require("node:path"));
+var path23 = __toESM(require("node:path"));
 
 // src/commands/setup.ts
 var path9 = __toESM(require("node:path"));
@@ -6351,10 +6351,11 @@ async function promptContinueSetup(targetDir, projectName, registry2) {
 }
 function buildContext(opts) {
   const projectName = opts.projectName || "project";
+  const packageName = projectName.replace(/[_-]/g, "").toLowerCase();
   return {
     projectName,
-    packageName: projectName.replace(/[_-]/g, "").toLowerCase(),
-    groupId: "com.example",
+    packageName,
+    groupId: `com.${packageName}`,
     frontend: opts.frontend || false,
     backend: opts.backend || false,
     uiLib: opts.uiLib || false,
@@ -6822,7 +6823,7 @@ tasks.withType<Test> {
   useJUnitPlatform()
 }
 `);
-  const appPackage = `${ctx.groupId}.${ctx.packageName}`.replace(/[.-]/g, ".");
+  const appPackage = ctx.groupId.replace(/[.-]/g, ".");
   const appDir = `src/main/java/${appPackage.replace(/\./g, "/")}`;
   ensureDir2(path2.join(projectDir, appDir));
   writeTemplate(projectDir, `${appDir}/Application.java`, `package ${appPackage};
@@ -6917,6 +6918,8 @@ logging:
     ${ctx.packageName}: DEBUG
 `);
   if (hasLiquibase) {
+    const now = /* @__PURE__ */ new Date();
+    const ts = now.toISOString().replace(/\D/g, "").slice(0, 12);
     ensureDir2(path2.join(projectDir, "src/main/resources/db/changelog"));
     writeTemplate(projectDir, "src/main/resources/db/changelog/db.changelog-master.xml", `<?xml version="1.0" encoding="UTF-8"?>
 <databaseChangeLog
@@ -6925,7 +6928,7 @@ logging:
   xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
     http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd">
 
-  <changeSet id="001" author="deepstorm">
+  <changeSet id="${ts}-001" author="deepstorm">
     <createTable tableName="flyway_schema_history">
       <column name="version" type="VARCHAR(50)"/>
     </createTable>
@@ -9383,6 +9386,7 @@ function registerTemplateCommand(program2, registry2) {
 
 // src/commands/update.ts
 var fs24 = __toESM(require("node:fs"));
+var path20 = __toESM(require("node:path"));
 var import_node_child_process2 = require("node:child_process");
 
 // src/utils/version.ts
@@ -9814,23 +9818,139 @@ async function updateCLI(fetchFn) {
   return result;
 }
 function getInstalledSkillIds(targetDir) {
-  const settingsPath = getDeepStormConfigPath(targetDir);
+  const config = readDeepStormConfig(targetDir);
+  if (!config) return [];
+  const ids = config.installedSkills;
+  return Array.isArray(ids) ? ids : [];
+}
+function migrateOldDataSources(targetDir) {
+  const migrated = [];
   try {
-    const raw = fs24.readFileSync(settingsPath, "utf-8");
-    const config = JSON.parse(raw);
-    return config.installedSkills ?? [];
-  } catch {
-    return [];
+    const claudeSettingsPath = path20.join(targetDir, ".claude", "settings.json");
+    if (fs24.existsSync(claudeSettingsPath)) {
+      const raw = fs24.readFileSync(claudeSettingsPath, "utf-8");
+      const claudeConfig = JSON.parse(raw);
+      if (claudeConfig.deepstorm && typeof claudeConfig.deepstorm === "object" && Object.keys(claudeConfig.deepstorm).length > 0) {
+        writeDeepStormConfig(targetDir, claudeConfig.deepstorm);
+        delete claudeConfig.deepstorm;
+        fs24.writeFileSync(claudeSettingsPath, JSON.stringify(claudeConfig, null, 2) + "\n", "utf-8");
+        migrated.push(".claude/settings.json \u2192 .deepstorm/settings.json");
+        console.log("  \u2714 \u5DF2\u8FC1\u79FB .claude/settings.json \u4E2D\u7684 DeepStorm \u914D\u7F6E");
+      }
+    }
+  } catch (err) {
+    console.log(`  \u26A0 deepstorm \u914D\u7F6E\u8FC1\u79FB\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  try {
+    const sweepInitPath = path20.join(targetDir, ".sweep-init");
+    if (fs24.existsSync(sweepInitPath)) {
+      const existing = readDeepStormConfig(targetDir);
+      const hasE2ePath = existing && existing.sweep?.e2eProjectPath;
+      if (!hasE2ePath) {
+        writeDeepStormConfig(targetDir, { sweep: { e2eProjectPath: "." } });
+        migrated.push(".sweep-init \u2192 sweep.e2eProjectPath");
+        console.log('  \u2714 \u5DF2\u8FC1\u79FB .sweep-init \u2192 sweep.e2eProjectPath = "."');
+      }
+      fs24.rmSync(sweepInitPath, { force: true });
+      if (hasE2ePath) {
+        console.log("  \u2139  .sweep-init \u5DF2\u5220\u9664\uFF08sweep.e2eProjectPath \u5DF2\u5B58\u5728\uFF0C\u672A\u8986\u76D6\uFF09");
+      }
+    }
+  } catch (err) {
+    console.log(`  \u26A0 .sweep-init \u8FC1\u79FB\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  try {
+    const envPath = path20.join(targetDir, ".env");
+    if (fs24.existsSync(envPath)) {
+      const raw = fs24.readFileSync(envPath, "utf-8");
+      const lines = raw.split("\n");
+      const baseUrlVars = {};
+      let defaultEnv = "test";
+      let hasDefaultEnv = false;
+      const remainingLines = [];
+      for (const line of lines) {
+        const trimmed = line.trim();
+        const baseMatch = trimmed.match(/^BASE_URL_(\w+)=(.+)$/);
+        if (baseMatch) {
+          const envName = baseMatch[1].toLowerCase();
+          let url = baseMatch[2].trim();
+          if (url.startsWith('"') && url.endsWith('"') || url.startsWith("'") && url.endsWith("'")) {
+            url = url.slice(1, -1);
+          }
+          baseUrlVars[envName] = url;
+          continue;
+        }
+        const defaultMatch = trimmed.match(/^DEFAULT_ENV=(.+)$/);
+        if (defaultMatch) {
+          hasDefaultEnv = true;
+          defaultEnv = defaultMatch[1].trim();
+          continue;
+        }
+        remainingLines.push(line);
+      }
+      if (Object.keys(baseUrlVars).length > 0) {
+        const environments = {};
+        for (const [envName, url] of Object.entries(baseUrlVars)) {
+          environments[envName] = { baseUrl: url };
+        }
+        environments.default = defaultEnv;
+        const existing = readDeepStormConfig(targetDir);
+        const hasEnvs = existing && existing.sweep?.environments;
+        if (!hasEnvs) {
+          writeDeepStormConfig(targetDir, { sweep: { environments } });
+          migrated.push(".env BASE_URL \u2192 sweep.environments");
+          console.log(`  \u2714 \u5DF2\u8FC1\u79FB .env \u4E2D ${Object.keys(baseUrlVars).length} \u4E2A\u73AF\u5883\u914D\u7F6E`);
+        }
+        const cleaned = remainingLines.join("\n").trimEnd();
+        if (cleaned === "") {
+          fs24.writeFileSync(envPath, "# \u73AF\u5883 baseURL \u914D\u7F6E\u5DF2\u8FC1\u79FB\u81F3 .deepstorm/settings.json\n# \u8BF7\u52FF\u5728\u6B64\u5904\u91CD\u590D\u5B9A\u4E49 BASE_URL_* \u914D\u7F6E\n", "utf-8");
+        } else if (hasDefaultEnv || Object.keys(baseUrlVars).length > 0) {
+          fs24.writeFileSync(envPath, cleaned + "\n", "utf-8");
+        }
+      }
+    }
+  } catch (err) {
+    console.log(`  \u26A0 .env baseURL \u8FC1\u79FB\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
   }
+  try {
+    const scopeConfigPath = path20.join(targetDir, ".deepstorm", "scope-config.json");
+    if (fs24.existsSync(scopeConfigPath)) {
+      const raw = fs24.readFileSync(scopeConfigPath, "utf-8");
+      const scopeData = JSON.parse(raw);
+      const scope = {};
+      if ("enabled" in scopeData) scope.enabled = scopeData.enabled;
+      if ("ciEnabled" in scopeData) scope.ciEnabled = scopeData.ciEnabled;
+      if ("domains" in scopeData) scope.domains = scopeData.domains;
+      const existing = readDeepStormConfig(targetDir);
+      const hasReefScope = existing && existing.reef?.scope;
+      if (!hasReefScope) {
+        writeDeepStormConfig(targetDir, { reef: { scope } });
+        migrated.push("scope-config.json \u2192 reef.scope");
+        console.log("  \u2714 \u5DF2\u8FC1\u79FB .deepstorm/scope-config.json \u2192 reef.scope");
+      }
+      fs24.rmSync(scopeConfigPath, { force: true });
+      if (hasReefScope) {
+        console.log("  \u2139  scope-config.json \u5DF2\u5220\u9664\uFF08reef.scope \u5DF2\u5B58\u5728\uFF0C\u672A\u8986\u76D6\uFF09");
+      }
+    }
+  } catch (err) {
+    console.log(`  \u26A0 scope-config.json \u8FC1\u79FB\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  return { migrated };
 }
 function registerUpdateCommand(program2) {
   const cliDir2 = __dirname;
   program2.command("update").description("\u68C0\u67E5 CLI \u66F4\u65B0\u5E76\u540C\u6B65\u5DF2\u5B89\u88C5 skill \u7684\u5B98\u65B9\u6700\u65B0\u6A21\u677F").action(async () => {
-    const installedIds = getInstalledSkillIds(process.cwd());
+    const targetDir = process.cwd();
+    const { migrated } = migrateOldDataSources(targetDir);
+    if (migrated.length > 0) {
+      console.log(`\u2714 \u5DF2\u5B8C\u6210 ${migrated.length} \u9879\u65E7\u6570\u636E\u6E90\u8FC1\u79FB`);
+    }
+    const installedIds = getInstalledSkillIds(targetDir);
     if (installedIds.length === 0) {
       console.log("\u672A\u68C0\u6D4B\u5230\u5DF2\u5B89\u88C5\u7684 skill\uFF0C\u8DF3\u8FC7\u540C\u6B65");
     } else {
-      upgradeTemplates(cliDir2, process.cwd(), installedIds);
+      upgradeTemplates(cliDir2, targetDir, installedIds);
     }
     await updateCLI();
   });
@@ -9844,7 +9964,7 @@ function registerPilotCommands(program2) {
 
 // src/commands/doctor.ts
 var fs25 = __toESM(require("node:fs"));
-var path20 = __toESM(require("node:path"));
+var path21 = __toESM(require("node:path"));
 function getInstalledSkills(targetDir) {
   const settingsPath = getDeepStormConfigPath(targetDir);
   try {
@@ -9862,7 +9982,7 @@ function runDoctor(targetDir) {
   checks.push({
     name: "CLI \u7248\u672C",
     status: "pass",
-    message: `v${version}\uFF08\u8FD0\u884C deepstorm update --check \u68C0\u67E5\u6700\u65B0\u7248\u672C\uFF09`
+    message: `v${version}\uFF08\u8FD0\u884C deepstorm update \u68C0\u67E5\u6700\u65B0\u7248\u672C\uFF09`
   });
   let hasDeepStorm = false;
   if (!fs25.existsSync(settingsPath)) {
@@ -9896,15 +10016,15 @@ function runDoctor(targetDir) {
       });
     }
   }
-  const skillsDir = path20.join(targetDir, ".claude", "skills");
+  const skillsDir = path21.join(targetDir, ".claude", "skills");
   if (fs25.existsSync(skillsDir)) {
     const skillDirs = fs25.readdirSync(skillsDir).filter(
-      (n) => fs25.statSync(path20.join(skillsDir, n)).isDirectory()
+      (n) => fs25.statSync(path21.join(skillsDir, n)).isDirectory()
     );
     let validCount = 0;
     let invalidCount = 0;
     for (const skillName of skillDirs) {
-      const skillMd = path20.join(skillsDir, skillName, "SKILL.md");
+      const skillMd = path21.join(skillsDir, skillName, "SKILL.md");
       if (!fs25.existsSync(skillMd)) {
         invalidCount++;
         continue;
@@ -9939,7 +10059,7 @@ function runDoctor(targetDir) {
     const installedSkills = getInstalledSkills(targetDir);
     const missingSkills = [];
     for (const skillId of installedSkills) {
-      if (!fs25.existsSync(path20.join(skillsDir, skillId))) {
+      if (!fs25.existsSync(path21.join(skillsDir, skillId))) {
         missingSkills.push(skillId);
       }
     }
@@ -9963,7 +10083,7 @@ function runDoctor(targetDir) {
       message: ".claude/skills/ \u4E0D\u5B58\u5728"
     });
   }
-  const mcpPath = path20.join(targetDir, ".mcp.json");
+  const mcpPath = path21.join(targetDir, ".mcp.json");
   if (fs25.existsSync(mcpPath)) {
     try {
       const mcp = JSON.parse(fs25.readFileSync(mcpPath, "utf-8"));
@@ -10085,7 +10205,7 @@ function printDoctorReport(report) {
 
 // src/commands/uninstall.ts
 var fs26 = __toESM(require("node:fs"));
-var path21 = __toESM(require("node:path"));
+var path22 = __toESM(require("node:path"));
 var import_prompts4 = require("@clack/prompts");
 async function uninstallDeepStorm(targetDir) {
   const settingsPath = getDeepStormConfigPath(targetDir);
@@ -10105,7 +10225,7 @@ async function uninstallDeepStorm(targetDir) {
   }
   cleanInstalled(targetDir);
   resetConfig(targetDir);
-  const templatesDir = path21.join(targetDir, ".deepstorm", "templates");
+  const templatesDir = path22.join(targetDir, ".deepstorm", "templates");
   if (fs26.existsSync(templatesDir)) {
     const shouldDelete = await (0, import_prompts4.confirm)({
       message: "\u662F\u5426\u5220\u9664 .deepstorm/templates/ \u76EE\u5F55\uFF1F",
@@ -10125,7 +10245,7 @@ async function uninstallDeepStorm(targetDir) {
 var program = new import_commander.Command();
 program.name("deepstorm").description("DeepStorm CLI \u2014 \u4E00\u952E\u914D\u7F6E\u9879\u76EE\u5F00\u53D1\u73AF\u5883").version(getCliVersion(), "-v, --version", "\u8F93\u51FA\u7248\u672C\u53F7");
 function loadRegistry() {
-  const registryPath = path22.join(__dirname, "registry.json");
+  const registryPath = path23.join(__dirname, "registry.json");
   try {
     const raw = fs27.readFileSync(registryPath, "utf-8");
     return JSON.parse(raw);

package/dist/skills/reef-commit/SKILL.md

@@ -137,7 +137,7 @@ if [ -f "$SCOPE_HOOK" ]; then
   bash "$SCOPE_HOOK" || {
     echo ""
     echo "提示：如需继续提交，请使用 'reef-scope-split.sh' 拆分分支"
-    echo "或临时禁用 scope 检查（不推荐）：deepstorm/scope-config.json → enabled: false"
+    echo "或临时禁用 scope 检查（不推荐）：settings.json → reef.scope.enabled: false"
     exit 1
   }
 fi

package/dist/skills/reef-gen-backend/SKILL.md.tmpl

@@ -30,9 +30,15 @@ git diff "$FORK_POINT"..HEAD --diff-filter=M --name-only
 
 **规则**：不凭空写新文件。先读一个真实存在的同类文件，理解模式后再动手。写新模块时参考已有模块的完整实现。
 
-### 2. 查阅规范
+### 2. 🔴 加载编码规范（硬性门禁）
 
-加载 `reef:reef-style-backend` 技能，阅读 `quick-reference.md` 和必要示例。
+> **必须先通过 Skill tool 加载 `reef:reef-style-backend`，阅读 `quick-reference.md` 了解核心编码规范，并根据当前变更类型阅读对应的维度规范文件（如 `spring-boot.md`、`hibernate.md`、`fastapi-quick-reference.md`、`pytest-testing.md` 等）。完成后方可进入后续代码编写步骤。未加载 code-style 技能不得编写代码，否则视为违反工作流纪律。**
+
+加载完成后，AI MUST 输出以下声明：
+
+```
+✅ [CODE-STYLE] 已加载后端编码规范（quick-reference + 必要维度规范），所有新增/修改代码将遵循项目编码规范。
+```
 
 涉及库/框架 API 用法时，使用 context7 获取最新文档：`resolve-library-id` → `query-docs`。
 
@@ -83,6 +89,6 @@ ruff check . && mypy . && python -m pytest
 ```
 {{/if}}
 
-### {{#if reef.backend.java.dbMigration.styleRef}}6{{else}}{{#if reef.backend.python.dbMigration.styleRef}}6{{else}}5{{/if}}{{/if}}. 提交前自检
+### {{#if reef.backend.java.dbMigration.styleRef}}6{{else}}{{#if reef.backend.python.dbMigration.styleRef}}6{{else}}5{{/if}}{{/if}}. 🔴 提交前自检（后置检查）
 
-加载 `reef:reef-style-backend` 技能，逐项检查所有规范要求。**未通过不得提交。**
+重新加载 `reef:reef-style-backend` 技能，逐项对照所有规范要求检查本变更中的每处代码修改。**检查未通过不得提交。**

package/dist/skills/reef-gen-frontend/SKILL.md.tmpl

@@ -31,9 +31,15 @@ git diff "$FORK_POINT"..HEAD --diff-filter=M --name-only
 
 **规则**：不凭空写新文件。先读一个真实存在的同类文件，理解模式后再动手。
 
-### 2. 查阅规范
+### 2. 🔴 加载编码规范（硬性门禁）
 
-加载 `reef:reef-style-frontend` 技能，阅读 `quick-reference.md` 和必要示例。
+> **必须先通过 Skill tool 加载 `reef:reef-style-frontend`，阅读 `quick-reference.md` 了解核心编码规范，并根据当前变更类型阅读对应的维度规范文件（框架规范、UI 组件库规范、CSS 方案、TypeScript 配置、测试框架等）。完成后方可进入后续代码编写步骤。未加载 code-style 技能不得编写代码，否则视为违反工作流纪律。**
+
+加载完成后，AI MUST 输出以下声明：
+
+```
+✅ [CODE-STYLE] 已加载前端编码规范（quick-reference + 必要维度规范），所有新增/修改代码将遵循项目编码规范。
+```
 
 涉及库/框架 API 用法时，使用 context7 获取最新文档：`resolve-library-id` → `query-docs`。
 
@@ -79,6 +85,6 @@ git diff "$FORK_POINT"..HEAD --diff-filter=M --name-only
 {{reef.frontend.framework.formatCmd}} lint && {{reef.frontend.framework.formatCmd}} typecheck && {{reef.frontend.framework.formatCmd}} test
 ```
 
-### {{#if reef.frontend.framework.sourcePath}}6{{else}}5{{/if}}. 提交前自检
+### {{#if reef.frontend.framework.sourcePath}}6{{else}}5{{/if}}. 🔴 提交前自检（后置检查）
 
-加载 `reef:reef-style-frontend` 技能，逐项检查所有规范要求。**未通过不得提交。**
+重新加载 `reef:reef-style-frontend` 技能，逐项对照所有规范要求检查本变更中的每处代码修改。**检查未通过不得提交。**

package/dist/skills/reef-scope/SKILL.md

@@ -89,8 +89,6 @@ bash packages/reef/hooks/reef-scope-split.sh
 - `ciEnabled`: CI 门禁开关（独立控制）
 - `domains`: 项目业务领域列表（空 = AI 自由分类，非空 = AI 对齐到这些领域）
 
-> **注意：** 旧版 `.deepstorm/scope-config.json` 已不再使用。如果存在该文件，运行 `deepstorm scope setup` 会自动迁移到 `settings.json`。
-
 ## 使用流程
 
 1. **安装**: 运行一次 `reef-scope-setup.sh install`
@@ -128,7 +126,7 @@ scope-check:
 ## 常见问题
 
 **Q: 我不想在所有项目上都启用这个检查？**
-A: 每个项目独立安装和配置，`scope-config.json` 中的 `enabled: false` 可关闭。
+A: 每个项目独立安装和配置，settings.json 中 `reef.scope.enabled: false` 可关闭。
 
 **Q: 我改了文档也要被阻断吗？**
 A: 不会。文档（markdown、README 等）变更会被归类为 `documentation` 领域，不计入多领域阻断判断。

package/dist/skills/reef-start/SKILL.md.tmpl

@@ -377,6 +377,7 @@ openspec instructions tasks --change "$CHANGE" --json
 ### 流程
 
 1. **调用 Skill 工具** — 根据 tasks.md 的任务范围，加载可能适用的 superpowers：
+   - `reef:reef-style-backend` 或 `reef:reef-style-frontend`（如果 tasks 涉及后端/前端**代码改动**，**必须**加载对应 code-style 技能，未加载不得进入阶段四）
    - `superpowers:test-driven-development`（如果 tasks 涉及 TypeScript/Java/Python 等代码改动）
    - `superpowers:verification-before-completion`
    - 根据 tasks.md 内容判断是否适用其他 superpowers

package/dist/skills/reef-start/references/stage-4-implementation.md

@@ -36,11 +36,14 @@ PLAN_FILE="docs/superpowers/plans/$(date +%Y-%m-%d)-$CHANGE.md"
 适用于：文档修改、配置文件调整、SKILL.md 流程修改、测试框架搭建、简单重构（测试覆盖充分）
 
 ```
-1. 直接实现代码变更
-2. 执行后置验证：build → lint → test
-3. 如果验证失败 → 修复 → 重新验证 → 通过后才标完成
-4. 如果发现复杂度超预期 → 暂停并向用户建议升级为 tdd mode
-5. ✅ 标记 task 为完成
+1. 🔴 确认 code-style 已加载 — 检查 `reef:reef-style-backend` 或 `reef:reef-style-frontend` 是否已通过 Skill tool 加载
+   - 已加载 → 进入步骤 2
+   - 未加载 → 暂停并先通过 Skill tool 加载对应技能，阅读 quick-reference.md 后再继续
+2. 直接实现代码变更
+3. 执行后置验证：build → lint → test
+4. 如果验证失败 → 修复 → 重新验证 → 通过后才标完成
+5. 如果发现复杂度超预期 → 暂停并向用户建议升级为 tdd mode
+6. ✅ 标记 task 为完成
 ```
 
 > **⚠️ Plan mode 风险预警：** plan mode 不要求前置测试，但**后置验证不可跳过**。如果 build/lint/test 任何一步失败，该 task **不得**被标记为完成。
@@ -50,6 +53,7 @@ PLAN_FILE="docs/superpowers/plans/$(date +%Y-%m-%d)-$CHANGE.md"
 适用于：新增业务逻辑、Bug 修复、权限/安全变更、资金/幂等性变更、状态机/并发逻辑
 
 **🔴 RED — 先写测试**
+- 先确认 code-style 已加载：检查 `reef:reef-style-backend` 或 `reef:reef-style-frontend` 是否已通过 Skill tool 加载，未加载则先加载
 - 根据 spec 的 Scenario 编写单元测试
 - 运行测试，确认失败（红）
 - 如果测试意外通过了，说明测试写的太弱，需改进

package/dist/skills/reef-start/references/superpowers-gate.md

@@ -16,6 +16,7 @@
 | 技能 | 类型 | 对本变更的要求 |
 |------|------|---------------|
 | {skill-name} | {类型} | {要求描述} |
+| `reef:reef-style-backend` / `reef:reef-style-frontend` | 🟢 **Code Style** | 所有新增/修改的代码必须遵循项目编码规范，加载后阅读 `quick-reference.md` 和必要维度规范 |
 
 ### Plan Mode 纪律确认
 
@@ -39,6 +40,7 @@
 | 技能 | 类型 | 对本变更的要求 |
 |------|------|---------------|
 | test-driven-development | 🔴 **Rigid** | 每个代码行为改动必须先写测试、看失败、再写实现 |
+| `reef:reef-style-backend` / `reef:reef-style-frontend` | 🟢 **Code Style** | 所有新增/修改的代码必须遵循项目编码规范，加载后阅读 `quick-reference.md` 和必要维度规范 |
 
 ### TDD 纪律确认
 
@@ -57,6 +59,7 @@
 - [ ] 📝 **实现计划已生成**（superpowers:writing-plans 完成，存于 `docs/superpowers/plans/`）
 - [ ] 用户已审阅并批准所有 SDD 文档及实现计划
 - [ ] 🔍 **Superpowers 技能已加载**（Skill 工具已调用）
+- [ ] 🎨 **Code-Style 技能已加载**（`reef:reef-style-backend`/`reef:reef-style-frontend` 已通过 Skill 工具加载并阅读规范）
 - [ ] 🚨 **Rigid 纪律已向用户声明并获得确认**
 - [ ] Path A 检查项：Git 分支已从 main 岔出
 - [ ] Path B 检查项：OpenSpec change 已创建，brainstorming 文件已产出

package/dist/skills/sweep-init/SKILL.md

@@ -93,18 +93,12 @@ E2E_PATH=$(cat .deepstorm/settings.json 2>/dev/null | grep -o '"e2eProjectPath"[
 
 #### 1.2 已初始化 → 退出
 
-- **WHEN** `sweep.e2eProjectPath` 已设置（或旧 `.sweep-init` 文件存在）
-- **THEN** 提示"当前项目已初始化为 Sweep 测试项目。如需重新初始化，请删除 `sweep.e2eProjectPath` 配置或 `.sweep-init` 文件后重试。"并退出
+- **WHEN** `sweep.e2eProjectPath` 已设置
+- **THEN** 提示"当前项目已初始化为 Sweep 测试项目。如需重新初始化，请删除 `sweep.e2eProjectPath` 配置后重试。"并退出
 
-#### 1.3 向后兼容：旧 .sweep-init 文件检测
+#### 1.3 未初始化 → 继续
 
-- **WHEN** `settings.json` 中 `sweep.e2eProjectPath` 未设置，但 `.sweep-init` 文件存在
-- **THEN** 提示"ℹ️ 检测到旧版 .sweep-init 标记。建议删除该文件后重新运行 /sweep-init 以使用新版配置。"
-- **THEN** 提示已初始化，退出
-
-#### 1.4 未初始化 → 继续
-
-- **WHEN** 以上均不满足
+- **WHEN** `sweep.e2eProjectPath` 未设置
 - **THEN** 继续执行初始化流程
 
 ---
@@ -375,7 +369,7 @@ fi
 
 - [ ] 已读取框架配置（`deepstorm.sweep.e2eFramework`）
 - [ ] 步骤 0A：已选择目标目录（`TARGET_DIR` 已确定）
-- [ ] 步骤 1：检查通过（`e2eProjectPath` 未设置，且 `.sweep-init` 不存在）
+- [ ] 步骤 1：检查通过（`e2eProjectPath` 未设置）
 - [ ] 项目目录结构已创建（`{TARGET_DIR}/flows/`、`{TARGET_DIR}/flows/reports/`、`{TARGET_DIR}/scripts/`）
 - [ ] package.json 已写入（含对应框架的依赖）
 - [ ] 框架配置文件已生成（如 playwright.config.ts）

package/dist/skills/sweep-plan/SKILL.md.tmpl

@@ -90,21 +90,10 @@ fi
   fi
   ```
 
-#### 1.3 配置不存在 → 向后兼容检查
+#### 1.3 配置不存在 → 报错退出
 
 - **WHEN** `E2E_PATH` 为空
-- **THEN** 检查旧 `.sweep-init` 文件是否存在（从当前目录和 DEEPSTORM_DIR 向上查找）：
-  ```bash
-  if [ -f ".sweep-init" ]; then
-    echo "ℹ️ 检测到旧版 .sweep-init 标记。建议运行 /sweep-init 刷新配置。"
-    # 继续执行（兼容旧项目）
-  elif [ -n "$DEEPSTORM_DIR" ] && [ -f "$DEEPSTORM_DIR/.sweep-init" ]; then
-    echo "ℹ️ 检测到旧版 .sweep-init 标记（项目根: $DEEPSTORM_DIR）。建议运行 /sweep-init 刷新配置。"
-  else
-    echo "❌ 未检测到 E2E 项目。请先运行 /sweep-init 初始化。"
-    exit 1
-  fi
-  ```
+- **THEN** 提示"❌ 未检测到 E2E 项目。请先运行 /sweep-init 初始化。"并退出
 
 ### 步骤 2：获取测试需求上下文（MCP 动态适配）
 

package/dist/skills/sweep-run/SKILL.md

@@ -24,8 +24,6 @@ deepstorm:
 /sweep-run flows/login.flow.md           # 单文件
 /sweep-run flows/login.flow.md --flow L02  # 单 Flow
 /sweep-run --env staging                 # 指定测试环境
-/sweep-run --text                        # 强制使用文本输入模式选择（不启动 TTY checkbox）
-/sweep-run --all --text                  # 全量 + 文本模式
 ```
 
 ### 执行模式说明
@@ -102,21 +100,10 @@ fi
   fi
   ```
 
-#### 1.2 配置不存在 → 向后兼容检查
+#### 1.2 配置不存在 → 报错退出
 
 - **WHEN** `E2E_PATH` 为空
-- **THEN** 检查旧 `.sweep-init` 文件是否存在（从当前目录和 DEEPSTORM_DIR 向上查找）：
-  ```bash
-  if [ -f ".sweep-init" ]; then
-    echo "ℹ️ 检测到旧版 .sweep-init 标记。建议运行 /sweep-init 刷新配置。"
-    # 继续执行（兼容旧项目）
-  elif [ -n "$DEEPSTORM_DIR" ] && [ -f "$DEEPSTORM_DIR/.sweep-init" ]; then
-    echo "ℹ️ 检测到旧版 .sweep-init 标记（项目根: $DEEPSTORM_DIR）。建议运行 /sweep-init 刷新配置。"
-  else
-    echo "❌ 未检测到 E2E 项目。请先运行 /sweep-init 初始化。"
-    exit 1
-  fi
-  ```
+- **THEN** 提示"❌ 未检测到 E2E 项目。请先运行 /sweep-init 初始化。"并退出
 
 ---
 
@@ -124,18 +111,30 @@ fi
 
 根据用户输入参数或交互选择，确定要执行的 .flow.md 文件列表。
 
-#### 2.1 交互模式（无参数）
+#### 2.1 交互模式（无参数） — 对话式选择
+
+不使用 `@inquirer/checkbox` 交互选择器（在 Claude Code 环境中 TTY/TUI 不可靠），改为**对话式选择**：
+
+1. 运行 `node scripts/flow-selector.mjs --list` 获取可用 .flow.md 文件列表
+2. 检查输出是否为有效 JSON（含 `files[]`），若脚本报错则提示用户后退出
+3. 在消息中直接列出可用文件供用户选择，参考格式：
+
+   ```markdown
+   📋 可用测试模块：
+
+     1. user-system/register（3 个用例：L01-L03）
+     2. user-system/login（2 个用例：L01-L02）
+     3. tasks/crud（4 个用例：T01-T04）
 
-**必须运行** `node scripts/flow-selector.mjs` 进行选择。
+   请选择：全部执行 / 输入序号（如 1,3） / 输入模块名
+   ```
 
-1. 先检查 `scripts/flow-selector.mjs` 是否存在
-2. 运行 `node scripts/flow-selector.mjs`
-3. 脚本自动检测 TTY 可用性：
-   - **TTY 可用** → 展示 `@inquirer/checkbox` 勾选列表（空格勾选、回车确认、a=全选）
-   - **TTY 不可用** → 自动回退到 **readline 文本输入模式**（序号选择、逗号分隔、输入 a 全选）
-   - 也可通过 `--text` 强制文本模式、`--tui` 强制 checkbox 模式
-4. 读取 `.sweep-selection.json` 获取选中结果
-5. 列出将要执行的文件，让用户确认后开始执行（**以下为示例格式，实际内容根据项目动态生成**）
+4. 等待用户在聊天中回复选择
+5. 根据用户选择，直接写入 `.sweep-selection.json`：
+   - **全部执行** → `{"type":"all"}`
+   - **指定文件全部 Flow** → `{"type":"selection","files":[{"file":"/abs/path/to/file.flow.md","flows":[],"all":true}]}`
+   - **指定文件的特定 Flow** → `{"type":"selection","files":[{"file":"/abs/path/to/file.flow.md","flows":["L01"],"all":false}]}`
+6. 输出选中文件的总览，确认后继续执行（**以下为示例格式，实际内容根据项目动态生成**）：
 
 ```
 选中的模块：user-system, tasks
@@ -158,8 +157,6 @@ fi
 | `--env {env}` | 切换目标环境 | `/sweep-run --all --env staging` |
 | `--browser` | 打开浏览器窗口逐步骤调试 | `/sweep-run --all --browser` |
 | `--no-parallel` | 使用批量但不并行 | `/sweep-run --all --no-parallel` |
-| `--text` | 强制文本输入模式选择（跳过 TTY checkbox） | `/sweep-run --text` |
-| `--tui` | 强制 TUI checkbox 模式 | `/sweep-run --tui` |
 
 #### 2.3 文件不存在处理
 
@@ -217,9 +214,9 @@ node scripts/env-manager.mjs --env staging
 ]}
 ```
 
-- `--env staging` → 从 `settings.json` 的 `sweep.environments.staging` 读取（回退到 `.env`）
-- `--env test` → 从 `settings.json` 的 `sweep.environments.test` 读取（回退到 `.env`）
-- 不传参 → 使用 `settings.json` 的 `sweep.environments.default`（回退到 `.env` 的 `DEFAULT_ENV`），未设置则默认 `test`
+- `--env staging` → 从 `settings.json` 的 `sweep.environments.staging` 读取
+- `--env test` → 从 `settings.json` 的 `sweep.environments.test` 读取
+- 不传参 → 使用 `settings.json` 的 `sweep.environments.default`，未设置则默认 `test`
 
 #### 4.2 设置环境变量
 
@@ -234,7 +231,7 @@ BASE_URL=$(node scripts/env-manager.mjs --env test | node -pe "JSON.parse(requir
 
 #### 4.3 环境不存在处理
 
-如果 `baseUrl` 为 `null`（指定的环境在 `.env` 中找不到对应配置）：
+如果 `baseUrl` 为 `null`（指定的环境在 settings.json 中找不到对应配置）：
 
 - 提示"未找到 [{env}] 环境的 baseURL 配置"
 - 列出 `availableEnvs` 中已有的环境

package/dist/skills/sweep-run/scripts/env-manager.mjs

@@ -3,9 +3,13 @@
 /**
  * Env Manager — 测试环境配置管理
  *
- * 读取 .env 文件，解析目标环境的 BASE_URL，输出结构化结果。
+ * 从 .deepstorm/settings.json 读取目标环境配置，输出结构化结果。
  * 支持检查 E2E 框架配置和 MCP 可用性。
  *
+ * 所有旧数据源（.env BASE_URL、.sweep-init、scope-config.json 等）
+ * 已由 `deepstorm update` 统一迁移到 .deepstorm/settings.json，
+ * 本文件无需再做兼容处理。
+ *
  * Usage:
  *   node env-manager.mjs --env test                   # 解析指定环境
  *   node env-manager.mjs --env test --print            # 输出 export 语句
@@ -126,49 +130,35 @@ export function readDotEnv() {
 }
 
 /**
- * Get the default environment name.
- * Priority: settings.json > .env
+ * Get the default environment name from .deepstorm/settings.json.
  * Falls back to 'test' if not configured.
  */
-export function getDefaultEnv(envMap) {
+export function getDefaultEnv() {
   const dsEnvs = readDeepstormEnvironments();
   if (dsEnvs && dsEnvs.default) {
     return dsEnvs.default;
   }
-  return envMap.DEFAULT_ENV || 'test';
+  return 'test';
 }
 
 /**
- * List all available environments.
- * Priority: settings.json > .env
- * Detects BASE_URL_{ENV} patterns and returns their names.
+ * List all available environments from .deepstorm/settings.json.
+ *
+ * Reads sweep.environments and returns environment name + URL pairs.
+ * Returns empty array if not configured.
  */
-export function listEnvs(envMap) {
+export function listEnvs() {
   const dsEnvs = readDeepstormEnvironments();
-  if (dsEnvs) {
-    const envs = [];
-    for (const [name, config] of Object.entries(dsEnvs)) {
-      if (name === 'default') continue;
-      if (config && config.baseUrl) {
-        envs.push({
-          name: name.toLowerCase(),
-          key: `BASE_URL_${name.toUpperCase()}`,
-          url: config.baseUrl,
-        });
-      }
-    }
-    return envs;
-  }
+  if (!dsEnvs) return [];
 
-  // Fallback to .env-based envMap
   const envs = [];
-  for (const key of Object.keys(envMap)) {
-    const match = key.match(/^BASE_URL_(.+)$/);
-    if (match) {
+  for (const [name, config] of Object.entries(dsEnvs)) {
+    if (name === 'default') continue;
+    if (config && config.baseUrl) {
       envs.push({
-        name: match[1].toLowerCase(),
-        key: key,
-        url: envMap[key],
+        name: name.toLowerCase(),
+        key: `BASE_URL_${name.toUpperCase()}`,
+        url: config.baseUrl,
       });
     }
   }
@@ -176,36 +166,27 @@ export function listEnvs(envMap) {
 }
 
 /**
- * Resolve target environment config.
- *
- * Priority: settings.json > .env
+ * Resolve target environment config from .deepstorm/settings.json.
  *
  * @param {string} [envName] - Target environment name (e.g. 'staging', 'test')
  * @returns {{ env: string, baseUrl: string|null, availableEnvs: Array<{name:string,url:string}> }}
  *
  * If envName is omitted, uses DEFAULT_ENV (or 'test').
+ * If settings.json has no environments config, baseUrl is null and availableEnvs is empty.
  * If the environment is not found, baseUrl is null and availableEnvs lists alternatives.
  */
 export function resolveEnv(envName) {
-  // Try settings.json first
   const dsEnvs = readDeepstormEnvironments();
-  if (dsEnvs) {
-    const { envMap, defaultEnv } = deepstormEnvsToEnvMap(dsEnvs);
-    const name = envName || defaultEnv;
-    const availableEnvs = listEnvs(envMap);
-    const baseUrlKey = `BASE_URL_${name.toUpperCase()}`;
-    const baseUrl = envMap[baseUrlKey] || null;
-    return { env: name, baseUrl, availableEnvs };
+  if (!dsEnvs) {
+    const name = envName || 'test';
+    return { env: name, baseUrl: null, availableEnvs: [] };
   }
 
-  // Fallback to .env
-  const envMap = readDotEnv();
-  const name = envName || getDefaultEnv(envMap);
-  const availableEnvs = listEnvs(envMap);
-
+  const { envMap, defaultEnv } = deepstormEnvsToEnvMap(dsEnvs);
+  const name = envName || defaultEnv;
+  const availableEnvs = listEnvs();
   const baseUrlKey = `BASE_URL_${name.toUpperCase()}`;
   const baseUrl = envMap[baseUrlKey] || null;
-
   return { env: name, baseUrl, availableEnvs };
 }
 
@@ -263,9 +244,8 @@ if (process.argv[1] === import.meta.filename) {
   const args = process.argv.slice(2);
 
   if (args.includes('--list')) {
-    const envMap = readDotEnv();
-    const envs = listEnvs(envMap);
-    const defaultEnv = getDefaultEnv(envMap);
+    const envs = listEnvs();
+    const defaultEnv = getDefaultEnv();
     console.log(JSON.stringify({ default: defaultEnv, environments: envs }));
     process.exit(0);
   }

package/dist/skills/sweep-run/scripts/flow-selector.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * Sweep Flow Selector — 基于 @inquirer/checkbox 的层级选择工具
+ * Sweep Flow Selector — 交互/非交互式选择工具
  *
  * 支持选择粒度：
  *   1. 模块级别（eg. user-system）
@@ -13,6 +13,7 @@
  * 将选中结果写入 .sweep-selection.json 并输出到 stdout。
  *
  * 使用方式：
+ *   node scripts/flow-selector.mjs --list       # 非交互：列出可用文件（JSON）
  *   node scripts/flow-selector.mjs              # 自动检测 TTY（checkbox 或文本回退）
  *   node scripts/flow-selector.mjs --tui        # 强制 TUI checkbox 模式
  *   node scripts/flow-selector.mjs --text       # 强制文本输入模式
@@ -142,6 +143,45 @@ function scanFlowFiles(dir) {
   return result;
 }
 
+// ── 非交互模式：构建文件列表 JSON ─────────────────────────
+
+function buildFileList(baseFlowsDir) {
+  const topologyPath = join(baseFlowsDir, 'topology.yaml');
+  const files = [];
+
+  if (existsSync(topologyPath)) {
+    const yaml = readFileSync(topologyPath, 'utf-8');
+    const modules = parseTopology(yaml);
+
+    function walkModules(mods, prefix = '') {
+      for (const mod of mods) {
+        const path = prefix ? `${prefix}/${mod.name}` : mod.name;
+        if (mod.children && mod.children.length > 0) {
+          walkModules(mod.children, path);
+        } else {
+          const flowFile = resolveFlowFile(path, baseFlowsDir);
+          if (flowFile) {
+            const content = readFileSync(flowFile, 'utf-8');
+            const flows = parseFlows(content);
+            files.push({ file: flowFile, relative: path, flows });
+          }
+        }
+      }
+    }
+    walkModules(modules);
+  } else {
+    const scanned = scanFlowFiles(baseFlowsDir);
+    for (const file of scanned) {
+      const content = readFileSync(file, 'utf-8');
+      const flows = parseFlows(content);
+      const rel = relative(baseFlowsDir, file);
+      files.push({ file, relative: rel, flows });
+    }
+  }
+
+  return { files, totalFiles: files.length, totalFlows: files.reduce((s, f) => s + f.flows.length, 0) };
+}
+
 // ── 构建 Choice 树 ──────────────────────────────────────────
 
 function buildChoicesWithFlows(modules, baseFlowsDir, prefix = '') {
@@ -341,6 +381,22 @@ async function main() {
   const cliArgs = process.argv.slice(2);
   const forceText = cliArgs.includes('--text');
   const forceTui = cliArgs.includes('--tui');
+  const listMode = cliArgs.includes('--list');
+
+  // ── 非交互模式：直接输出可用文件列表 JSON ──────────────
+  if (listMode) {
+    if (!existsSync(BASE_FLOWS_DIR)) {
+      console.error(JSON.stringify({ error: 'flows/ 目录不存在' }));
+      process.exit(1);
+    }
+    const list = buildFileList(BASE_FLOWS_DIR);
+    if (list.files.length === 0) {
+      console.error(JSON.stringify({ error: '没有找到任何 .flow.md 文件' }));
+      process.exit(1);
+    }
+    console.log(JSON.stringify(list, null, 2));
+    return;
+  }
 
   try {
     let modules = [];
@@ -471,6 +527,7 @@ export {
   buildChoicesWithFlows,
   normalizeSelection,
   buildFlatFileChoices,
+  buildFileList,
   askTextSelection,
   isTtyAvailable,
   getCheckbox,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstorm/cli",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "DeepStorm CLI — 一键配置项目开发环境",
   "license": "MIT",
   "author": "billkang",
@@ -16,7 +16,7 @@
     "dotenv": "^17.4.2",
     "handlebars": "^4.7.8",
     "js-yaml": "^4.1.0",
-    "@deepstorm/pilot": "^0.9.0"
+    "@deepstorm/pilot": "^0.9.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",