@wneng/create-keel 0.2.0 → 0.3.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/version.ts
-var SCAFFOLDER_VERSION = "0.2.0";
+var SCAFFOLDER_VERSION = "0.3.0";
 
 // src/schema/options.ts
 import Ajv from "ajv";
@@ -34,7 +34,8 @@ var OPTIONS_FIELD_ORDER = [
   "gitLfs",
   "integrations",
   "ci",
-  "roles"
+  "roles",
+  "multiApp"
 ];
 var OPTIONS_SCHEMA = {
   $schema: "http://json-schema.org/draft-07/schema#",
@@ -56,7 +57,8 @@ var OPTIONS_SCHEMA = {
     "gitLfs",
     "integrations",
     "ci",
-    "roles"
+    "roles",
+    "multiApp"
   ],
   properties: {
     projectName: {
@@ -79,7 +81,8 @@ var OPTIONS_SCHEMA = {
       type: "array",
       items: { type: "string", enum: [...ROLE_KINDS] },
       uniqueItems: true
-    }
+    },
+    multiApp: { type: "boolean" }
   }
 };
 var ajv = new Ajv({ allErrors: true, strict: true });
@@ -334,6 +337,27 @@ function parseLayerArg(raw) {
   return out;
 }
 
+// src/standards/tier.ts
+var ADOPTION_TIERS = ["lite", "standard", "full"];
+function isAdoptionTier(value) {
+  return ADOPTION_TIERS.includes(value);
+}
+function parseTier(input) {
+  if (typeof input !== "string" || input.length === 0) {
+    throw new UserInputError(
+      `invalid --engineering-standards value: ${JSON.stringify(input)}`,
+      `\u53EF\u9009\u503C\uFF1A${ADOPTION_TIERS.join(" | ")}`
+    );
+  }
+  if (!isAdoptionTier(input)) {
+    throw new UserInputError(
+      `invalid --engineering-standards value: ${JSON.stringify(input)}`,
+      `\u53EF\u9009\u503C\uFF1A${ADOPTION_TIERS.join(" | ")}`
+    );
+  }
+  return input;
+}
+
 // src/cli.ts
 async function run(io) {
   const args = io.argv.slice(2);
@@ -387,6 +411,9 @@ function parseCreateArgs(args) {
   let ci;
   let roles;
   let sampleFeature = false;
+  let engineeringStandards;
+  let engineeringStandardsExplicit = false;
+  let multiApp = false;
   for (let i = 0; i < args.length; i += 1) {
     const a = args[i];
     switch (a) {
@@ -408,6 +435,22 @@ function parseCreateArgs(args) {
       case "--sample-feature":
         sampleFeature = true;
         break;
+      case "--multi-app":
+        multiApp = true;
+        break;
+      case "--engineering-standards": {
+        const next = args[i + 1];
+        if (next === void 0 || next.startsWith("--")) {
+          throw new UserInputError(
+            "--engineering-standards requires a tier argument",
+            `\u53EF\u9009\u503C\uFF1A${ADOPTION_TIERS.join(" | ")}`
+          );
+        }
+        engineeringStandards = parseTier(next);
+        engineeringStandardsExplicit = true;
+        i += 1;
+        break;
+      }
       case "--config": {
         const next = args[i + 1];
         if (next === void 0 || next.startsWith("--")) {
@@ -500,7 +543,9 @@ function parseCreateArgs(args) {
     ...config !== void 0 ? { config } : {},
     ...ci !== void 0 ? { ci } : {},
     ...roles !== void 0 ? { roles } : {},
-    ...sampleFeature ? { sampleFeature: true } : {}
+    ...sampleFeature ? { sampleFeature: true } : {},
+    ...engineeringStandards !== void 0 ? { engineeringStandards } : {},
+    ...multiApp ? { multiApp: true } : {}
   };
   if (sampleFeature && dryRun) {
     throw new UserInputError(
@@ -508,6 +553,12 @@ function parseCreateArgs(args) {
       "\u8BF7\u53BB\u6389\u4E00\u9879\u540E\u91CD\u8BD5"
     );
   }
+  if (!engineeringStandardsExplicit && yes) {
+    return {
+      projectName,
+      flags: { ...flags, engineeringStandards: "standard" }
+    };
+  }
   return { projectName, flags };
 }
 async function dispatchFeature(io, args) {
@@ -569,6 +620,10 @@ function helpText() {
     "  --roles <list>     Comma-separated role directories to scaffold",
     "                     (" + ROLE_KINDS.join("|") + "; default: none)",
     "  --sample-feature   After create, scaffold the user-signup sample feature",
+    "  --engineering-standards <tier>",
+    "                     Adoption tier for engineering standards: " + ADOPTION_TIERS.join("|"),
+    "                     (default in --yes mode: standard; omitted in interactive mode)",
+    "  --multi-app        Initialise the project in multi-app mode (<env>/apps/<name>/)",
     "  -h, --help         Show this help",
     "  -v, --version      Show the scaffolder version",
     "",
@@ -603,7 +658,7 @@ function featureHelpText() {
 }
 
 // src/orchestrator.ts
-import * as path6 from "node:path";
+import * as path7 from "node:path";
 
 // src/input/defaults.ts
 var OPTION_DEFAULTS = {
@@ -619,7 +674,8 @@ var OPTION_DEFAULTS = {
   gitLfs: false,
   integrations: false,
   ci: "gitee",
-  roles: []
+  roles: [],
+  multiApp: false
 };
 function buildDefaultOptions(projectName) {
   return { projectName, ...OPTION_DEFAULTS };
@@ -664,8 +720,8 @@ var validate = ajv2.compile(
 function formatIssues() {
   const errs = validate.errors ?? [];
   return errs.map((e) => {
-    const path10 = e.instancePath || (e.params && "missingProperty" in e.params ? `/${String(e.params.missingProperty)}` : "<root>");
-    return `${path10}: ${e.message ?? "validation error"}`;
+    const path11 = e.instancePath || (e.params && "missingProperty" in e.params ? `/${String(e.params.missingProperty)}` : "<root>");
+    return `${path11}: ${e.message ?? "validation error"}`;
   }).join("; ");
 }
 async function loadConfigFile(filePath) {
@@ -901,7 +957,8 @@ async function promptForOptions(input) {
     gitLfs,
     integrations,
     ci,
-    roles
+    roles,
+    multiApp: OPTION_DEFAULTS.multiApp
   };
 }
 async function chooseAxis(prompter, prefilled, question, domain, def, report, axisName) {
@@ -1163,7 +1220,8 @@ function buildRenderContext(input) {
     year: String(now.getUTCFullYear()),
     generatedAt: now.toISOString(),
     scaffolderVersion: input.scaffolderVersion,
-    ...input.feature !== void 0 ? { feature: input.feature } : {}
+    ...input.feature !== void 0 ? { feature: input.feature } : {},
+    ...input.standards !== void 0 ? { standards: input.standards } : {}
   };
 }
 function buildFeatureContext(slug, nextAdrNumber) {
@@ -1204,7 +1262,10 @@ function toStrictContext(ctx) {
     // `feature` is intentionally only attached when the orchestrator
     // populated it; non-feature templates that try to read it will hit
     // the proxy's "undefined template variable" branch.
-    ...ctx.feature !== void 0 ? { feature: ctx.feature } : {}
+    ...ctx.feature !== void 0 ? { feature: ctx.feature } : {},
+    // `standards` follows the same pattern; only the engineering-standards
+    // plan populates it.
+    ...ctx.standards !== void 0 ? { standards: ctx.standards } : {}
   };
   return new Proxy(base, {
     get(target, prop, receiver) {
@@ -1386,6 +1447,10 @@ var METADATA_SCHEMA = {
       type: "array",
       items: { type: "string", pattern: FEATURE_SLUG_PATTERN2 },
       uniqueItems: true
+    },
+    engineeringStandards: {
+      type: "string",
+      enum: [...ADOPTION_TIERS]
     }
   }
 };
@@ -1422,7 +1487,8 @@ var METADATA_TOP_ORDER = [
   "generatedAt",
   "options",
   "templateFragments",
-  "features"
+  "features",
+  "engineeringStandards"
 ];
 function canonicalOptions(options) {
   const out = {};
@@ -1446,6 +1512,11 @@ function canonicalMetadata(metadata) {
       if (features !== void 0 && features.length > 0) {
         out[key] = [...features];
       }
+    } else if (key === "engineeringStandards") {
+      const tier = metadata.engineeringStandards;
+      if (tier !== void 0) {
+        out[key] = tier;
+      }
     } else {
       out[key] = metadata[key];
     }
@@ -1483,7 +1554,8 @@ function buildMetadata(params) {
     generatedAt: now.toISOString(),
     options: params.options,
     templateFragments: [...params.templateFragments],
-    ...params.features !== void 0 ? { features: [...params.features] } : {}
+    ...params.features !== void 0 ? { features: [...params.features] } : {},
+    ...params.engineeringStandards !== void 0 ? { engineeringStandards: params.engineeringStandards } : {}
   };
 }
 
@@ -1493,6 +1565,7 @@ function appendScaffolderMetadata(input) {
     scaffolderVersion: input.scaffolderVersion,
     options: input.options,
     templateFragments: input.templateFragments,
+    ...input.engineeringStandards !== void 0 ? { engineeringStandards: input.engineeringStandards } : {},
     ...input.now !== void 0 ? { now: input.now } : {}
   });
   const file = {
@@ -1695,6 +1768,375 @@ function verbosityFromFlags(flags) {
   return "default";
 }
 
+// src/standards/plan.ts
+import { accessSync as accessSync2 } from "node:fs";
+import * as path6 from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+
+// src/standards/stack-detector.ts
+function backendManifest(opt) {
+  switch (opt) {
+    case "node":
+      return { env: "server", language: "typescript", manifestPath: "server/package.json", packageManager: "npm" };
+    case "java":
+      return { env: "server", language: "java", manifestPath: "server/pom.xml", packageManager: "maven" };
+    case "go":
+      return { env: "server", language: "go", manifestPath: "server/go.mod", packageManager: "gomod" };
+    case "python":
+      return { env: "server", language: "python", manifestPath: "server/pyproject.toml", packageManager: "pip" };
+    case "none":
+      return null;
+  }
+}
+function frontendManifest(opt) {
+  switch (opt) {
+    case "react":
+    case "vue":
+      return { env: "web", language: "typescript", manifestPath: "web/package.json", packageManager: "npm" };
+    case "none":
+      return null;
+  }
+}
+function mobileManifest(opt) {
+  switch (opt) {
+    case "flutter":
+      return { env: "mobile", language: "dart", manifestPath: "mobile/pubspec.yaml", packageManager: "pub" };
+    case "react-native":
+      return { env: "mobile", language: "typescript", manifestPath: "mobile/package.json", packageManager: "npm" };
+    case "none":
+      return null;
+  }
+}
+function miniappManifest(opt) {
+  switch (opt) {
+    case "wechat":
+      return { env: "miniapp", language: "typescript", manifestPath: "miniapp/package.json", packageManager: "npm" };
+    case "none":
+      return null;
+  }
+}
+function agentManifest(opt) {
+  switch (opt) {
+    case "rust-desktop":
+      return { env: "agent", language: "rust", manifestPath: "agent/Cargo.toml", packageManager: "cargo" };
+    case "none":
+      return null;
+  }
+}
+var SEED_DEPS_NODE_SERVER = [
+  { name: "typescript", version: "5.5.4", policy: "minor" },
+  { name: "@types/node", version: "20.14.10", policy: "minor" }
+];
+var SEED_DEPS_JAVA_SERVER = [
+  { name: "spring-boot-starter-web", version: "3.3.2", policy: "minor" },
+  { name: "spring-boot-starter-validation", version: "3.3.2", policy: "minor" }
+];
+var SEED_DEPS_GO_SERVER = [
+  { name: "github.com/gin-gonic/gin", version: "1.10.0", policy: "minor" }
+];
+var SEED_DEPS_PYTHON_SERVER = [
+  { name: "fastapi", version: "0.111.1", policy: "minor" },
+  { name: "pydantic", version: "2.8.2", policy: "minor" }
+];
+var SEED_DEPS_REACT_WEB = [
+  { name: "react", version: "18.3.1", policy: "minor" },
+  { name: "react-dom", version: "18.3.1", policy: "minor" },
+  { name: "typescript", version: "5.5.4", policy: "minor" }
+];
+var SEED_DEPS_VUE_WEB = [
+  { name: "vue", version: "3.4.34", policy: "minor" },
+  { name: "typescript", version: "5.5.4", policy: "minor" }
+];
+var SEED_DEPS_FLUTTER_MOBILE = [
+  { name: "flutter", version: "3.22.0", policy: "minor" }
+];
+var SEED_DEPS_REACT_NATIVE_MOBILE = [
+  { name: "react-native", version: "0.74.3", policy: "minor" },
+  { name: "react", version: "18.3.1", policy: "minor" }
+];
+var SEED_DEPS_WECHAT_MINIAPP = [
+  { name: "typescript", version: "5.5.4", policy: "minor" }
+];
+var SEED_DEPS_RUST_AGENT = [
+  { name: "tokio", version: "1.39.2", policy: "minor" },
+  { name: "serde", version: "1.0.204", policy: "minor" }
+];
+function seedDeps(options, env) {
+  switch (env) {
+    case "server":
+      switch (options.backend) {
+        case "node":
+          return SEED_DEPS_NODE_SERVER;
+        case "java":
+          return SEED_DEPS_JAVA_SERVER;
+        case "go":
+          return SEED_DEPS_GO_SERVER;
+        case "python":
+          return SEED_DEPS_PYTHON_SERVER;
+        case "none":
+          return [];
+      }
+      break;
+    case "web":
+      switch (options.frontend) {
+        case "react":
+          return SEED_DEPS_REACT_WEB;
+        case "vue":
+          return SEED_DEPS_VUE_WEB;
+        case "none":
+          return [];
+      }
+      break;
+    case "mobile":
+      switch (options.mobile) {
+        case "flutter":
+          return SEED_DEPS_FLUTTER_MOBILE;
+        case "react-native":
+          return SEED_DEPS_REACT_NATIVE_MOBILE;
+        case "none":
+          return [];
+      }
+      break;
+    case "miniapp":
+      switch (options.miniapp) {
+        case "wechat":
+          return SEED_DEPS_WECHAT_MINIAPP;
+        case "none":
+          return [];
+      }
+      break;
+    case "agent":
+      switch (options.agent) {
+        case "rust-desktop":
+          return SEED_DEPS_RUST_AGENT;
+        case "none":
+          return [];
+      }
+      break;
+  }
+  return [];
+}
+function detectRuntimeManifests(options) {
+  const detectors = [
+    backendManifest(options.backend),
+    frontendManifest(options.frontend),
+    mobileManifest(options.mobile),
+    miniappManifest(options.miniapp),
+    agentManifest(options.agent)
+  ];
+  return detectors.filter((m) => m !== null).map((m) => ({ ...m, dependencies: seedDeps(options, m.env) }));
+}
+
+// src/standards/plan.ts
+async function buildStandardsPlan(input) {
+  const templatesRoot = input.templatesRoot ?? defaultStandardsTemplatesRoot();
+  const now = input.now ?? /* @__PURE__ */ new Date();
+  const lastReviewed = formatDate(now);
+  const manifests = detectRuntimeManifests(input.options);
+  const files = [];
+  const languages = uniqueLanguages(manifests);
+  for (const language of languages) {
+    files.push(
+      await renderStandardsTemplate({
+        templatesRoot,
+        templateRelPath: `coding-style-${language}.md.eta`,
+        targetPath: `docs/03-\u5DE5\u7A0B\u89C4\u8303\u4E0E\u7814\u53D1\u57FA\u7840\u8BBE\u65BD/coding-style-${language}.md`,
+        contributedBy: `standards:coding-style-${language}`,
+        options: input.options,
+        scaffolderVersion: input.scaffolderVersion,
+        now,
+        standards: { tier: input.tier, language, lastReviewed }
+      })
+    );
+  }
+  if (input.tier === "standard" || input.tier === "full") {
+    for (const m of manifests) {
+      const fileBaseName = `tech-stack-${m.env}.md`;
+      files.push(
+        await renderStandardsTemplate({
+          templatesRoot,
+          templateRelPath: `tech-stack-${m.env}.md.eta`,
+          targetPath: `docs/03-\u5DE5\u7A0B\u89C4\u8303\u4E0E\u7814\u53D1\u57FA\u7840\u8BBE\u65BD/${fileBaseName}`,
+          contributedBy: `standards:tech-stack-${m.env}`,
+          options: input.options,
+          scaffolderVersion: input.scaffolderVersion,
+          now,
+          standards: {
+            tier: input.tier,
+            env: m.env,
+            language: m.language,
+            packageManager: m.packageManager,
+            manifestPath: m.manifestPath,
+            lastReviewed,
+            multiApp: input.options.multiApp
+            // Smuggle dependencies through standards context so the
+            // template can iterate. We attach via Object.assign-style
+            // cast because StandardsRenderContext does not declare it
+            // (deps are only read by the tech-stack templates and the
+            // shape varies per env, so keeping it untyped here is
+            // acceptable).
+          },
+          extraStandardsFields: { dependencies: m.dependencies }
+        })
+      );
+    }
+    files.push(
+      await renderStandardsTemplate({
+        templatesRoot,
+        templateRelPath: "module-boundaries.md.eta",
+        targetPath: "docs/03-\u5DE5\u7A0B\u89C4\u8303\u4E0E\u7814\u53D1\u57FA\u7840\u8BBE\u65BD/module-boundaries.md",
+        contributedBy: "standards:module-boundaries",
+        options: input.options,
+        scaffolderVersion: input.scaffolderVersion,
+        now,
+        standards: {
+          tier: input.tier,
+          multiApp: input.options.multiApp,
+          lastReviewed
+        }
+      })
+    );
+    if (input.options.multiApp && hasJsTsEnvironment(manifests)) {
+      files.push(
+        await renderStandardsTemplate({
+          templatesRoot,
+          templateRelPath: "dependency-cruiser.config.cjs.eta",
+          targetPath: "dependency-cruiser.config.cjs",
+          contributedBy: "standards:dep-cruiser",
+          options: input.options,
+          scaffolderVersion: input.scaffolderVersion,
+          now,
+          standards: {
+            tier: input.tier,
+            multiApp: true,
+            lastReviewed
+          }
+        })
+      );
+    }
+  }
+  if (input.tier === "full" && hasFrontendSurface(input.options)) {
+    files.push(
+      await renderStandardsTemplate({
+        templatesRoot,
+        templateRelPath: "ui-design-system.md.eta",
+        targetPath: "docs/05-\u524D\u7AEF\u5BA2\u6237\u7AEF\u8BE6\u7EC6\u8BBE\u8BA1/ui-design-system.md",
+        contributedBy: "standards:ui-design-system",
+        options: input.options,
+        scaffolderVersion: input.scaffolderVersion,
+        now,
+        standards: { tier: "full", lastReviewed }
+      })
+    );
+    if (input.options.frontend !== "none") {
+      files.push(
+        await renderStandardsTemplate({
+          templatesRoot,
+          templateRelPath: "design-tokens.ts.eta",
+          targetPath: "web/src/design-tokens.ts",
+          contributedBy: "standards:design-tokens",
+          options: input.options,
+          scaffolderVersion: input.scaffolderVersion,
+          now,
+          standards: { tier: "full", lastReviewed }
+        })
+      );
+    }
+  }
+  const sortedFiles = [...files].sort(
+    (a, b) => a.targetPath < b.targetPath ? -1 : a.targetPath > b.targetPath ? 1 : 0
+  );
+  const directories = collectDirectories(sortedFiles);
+  return { files: sortedFiles, directories };
+}
+async function renderStandardsTemplate(input) {
+  const templatePath = path6.join(input.templatesRoot, input.templateRelPath);
+  const standards = {
+    ...input.standards,
+    ...input.extraStandardsFields ?? {}
+  };
+  const ctx = buildRenderContext({
+    options: input.options,
+    scaffolderVersion: input.scaffolderVersion,
+    now: input.now,
+    standards
+  });
+  let content;
+  try {
+    content = await renderFile(templatePath, ctx);
+  } catch (e) {
+    throw new TemplateError(
+      `engineering-standards template render failed: ${input.templateRelPath}: ${e.message}`,
+      "\u8BF7\u786E\u8BA4 src/standards/templates/ \u4E0B\u5B58\u5728 " + input.templateRelPath
+    );
+  }
+  return {
+    targetPath: input.targetPath,
+    content,
+    contributedBy: input.contributedBy
+  };
+}
+function uniqueLanguages(manifests) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const m of manifests) {
+    if (!seen.has(m.language)) {
+      seen.add(m.language);
+      out.push(m.language);
+    }
+  }
+  return out;
+}
+function hasJsTsEnvironment(manifests) {
+  return manifests.some((m) => m.language === "typescript");
+}
+function hasFrontendSurface(options) {
+  if (options.frontend !== "none") return true;
+  if (options.mobile === "react-native" || options.mobile === "flutter") return true;
+  if (options.miniapp !== "none") return true;
+  return false;
+}
+function formatDate(d) {
+  const y = d.getUTCFullYear();
+  const m = String(d.getUTCMonth() + 1).padStart(2, "0");
+  const day = String(d.getUTCDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
+function collectDirectories(files) {
+  const set = /* @__PURE__ */ new Set();
+  for (const f of files) {
+    let cur = path6.posix.dirname(f.targetPath);
+    while (cur && cur !== "." && cur !== "/") {
+      set.add(cur);
+      cur = path6.posix.dirname(cur);
+    }
+  }
+  return [...set].sort();
+}
+function defaultStandardsTemplatesRoot() {
+  const here = path6.dirname(fileURLToPath2(import.meta.url));
+  const pkgRoot = findPackageRoot2(here);
+  return path6.join(pkgRoot, "src", "standards", "templates");
+}
+function findPackageRoot2(start) {
+  let dir = start;
+  for (let i = 0; i < 10; i += 1) {
+    const candidate = path6.join(dir, "package.json");
+    try {
+      accessSync2(candidate);
+      return dir;
+    } catch {
+    }
+    const parent = path6.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  throw new TemplateError(
+    `unable to locate package.json above ${start}`,
+    "\u8BF7\u786E\u8BA4 scaffolder \u5B89\u88C5\u5B8C\u6574\uFF0Csrc/standards/templates/ \u4E0E package.json \u4F4D\u4E8E\u540C\u4E00\u5C42\u7EA7"
+  );
+}
+
 // src/orchestrator.ts
 async function runCreate(input) {
   const reporter = new Reporter(
@@ -1722,17 +2164,34 @@ async function runCreate(input) {
     name: f.manifest.name,
     version: f.manifest.version
   }));
+  if (input.flags.engineeringStandards !== void 0) {
+    const standardsPlan = await buildStandardsPlan({
+      options,
+      tier: input.flags.engineeringStandards,
+      scaffolderVersion: SCAFFOLDER_VERSION,
+      ...input.io.now !== void 0 ? { now: input.io.now } : {}
+    });
+    plan = {
+      files: [...plan.files, ...standardsPlan.files].sort(
+        (a, b) => a.targetPath < b.targetPath ? -1 : a.targetPath > b.targetPath ? 1 : 0
+      ),
+      directories: [
+        .../* @__PURE__ */ new Set([...plan.directories, ...standardsPlan.directories])
+      ].sort()
+    };
+  }
   plan = appendScaffolderMetadata({
     plan,
     scaffolderVersion: SCAFFOLDER_VERSION,
     options,
     templateFragments: fragmentRefs,
+    ...input.flags.engineeringStandards !== void 0 ? { engineeringStandards: input.flags.engineeringStandards } : {},
     ...input.io.now !== void 0 ? { now: input.io.now } : {}
   });
   validatePlanSyntax(plan);
   reporter.info(`planned ${plan.files.length} file(s) across ${plan.directories.length} directory`);
   const cwd = input.io.cwd ?? process.cwd();
-  const targetDirectory = path6.resolve(cwd, options.projectName);
+  const targetDirectory = path7.resolve(cwd, options.projectName);
   if (input.flags.dryRun) {
     reporter.stage("dry-run");
     reporter.dryRunReport(plan);
@@ -1793,12 +2252,12 @@ async function resolveOptions(input) {
 
 // src/feature/orchestrator.ts
 import { promises as fs8 } from "node:fs";
-import * as path9 from "node:path";
+import * as path10 from "node:path";
 
 // src/feature/plan.ts
-import { promises as fs7, accessSync as accessSync2 } from "node:fs";
-import * as path7 from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { promises as fs7, accessSync as accessSync3 } from "node:fs";
+import * as path8 from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // src/feature/openapi-edit.ts
 import { isMap, isScalar, parseDocument, YAMLMap } from "yaml";
@@ -1892,7 +2351,7 @@ function slugToOperationId(slug) {
 // src/feature/plan.ts
 async function buildFeaturePlan(input) {
   const templatesRoot = input.templatesRoot ?? defaultFeatureTemplatesRoot();
-  const sourceRoot = input.source === "sample" ? path7.join(templatesRoot, "sample", input.slug) : templatesRoot;
+  const sourceRoot = input.source === "sample" ? path8.join(templatesRoot, "sample", input.slug) : templatesRoot;
   const nextAdrNumber = await computeAdrNumberForSlug(input.cwd, input.slug);
   const renderContext = buildRenderContext({
     options: input.options,
@@ -1906,7 +2365,7 @@ async function buildFeaturePlan(input) {
     const artifact = LAYER_ARTIFACTS[layer];
     const targetPath = computeTargetPath(layer, input.slug, nextAdrNumber);
     outputs.set(layer, targetPath);
-    const templatePath = path7.join(sourceRoot, artifact.placeholderTemplate);
+    const templatePath = path8.join(sourceRoot, artifact.placeholderTemplate);
     const content = await renderFeatureTemplate(templatePath, renderContext, layer, input.source);
     files.push({
       targetPath,
@@ -1918,7 +2377,7 @@ async function buildFeaturePlan(input) {
   let openapiAlreadyExisted;
   if (input.layers.includes("backend") && input.options.contract !== "none") {
     const apiPath = "contracts/openapi/api.yaml";
-    const apiAbs = path7.join(input.cwd, apiPath);
+    const apiAbs = path8.join(input.cwd, apiPath);
     let currentText;
     try {
       currentText = await fs7.readFile(apiAbs, "utf8");
@@ -1990,7 +2449,7 @@ async function buildFeaturePlan(input) {
   const sortedFiles = [...files].sort(
     (a, b) => a.targetPath < b.targetPath ? -1 : a.targetPath > b.targetPath ? 1 : 0
   );
-  const directories = collectDirectories(sortedFiles);
+  const directories = collectDirectories2(sortedFiles);
   return {
     files: sortedFiles,
     directories,
@@ -2017,7 +2476,7 @@ async function renderFeatureTemplate(templatePath, context, layer, source) {
 }
 var ADR_FILE_RE = /^adr-(\d{4,})-/;
 async function computeAdrNumberForSlug(cwd, slug) {
-  const dir = path7.join(cwd, "docs", "02-\u7CFB\u7EDF\u65B9\u6848\u4E0E\u67B6\u6784");
+  const dir = path8.join(cwd, "docs", "02-\u7CFB\u7EDF\u65B9\u6848\u4E0E\u67B6\u6784");
   let entries;
   try {
     entries = await fs7.readdir(dir);
@@ -2042,32 +2501,32 @@ async function computeAdrNumberForSlug(cwd, slug) {
 function escapeRegex(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function collectDirectories(files) {
+function collectDirectories2(files) {
   const set = /* @__PURE__ */ new Set();
   for (const f of files) {
-    let cur = path7.posix.dirname(f.targetPath);
+    let cur = path8.posix.dirname(f.targetPath);
     while (cur && cur !== "." && cur !== "/") {
       set.add(cur);
-      cur = path7.posix.dirname(cur);
+      cur = path8.posix.dirname(cur);
     }
   }
   return [...set].sort();
 }
 function defaultFeatureTemplatesRoot() {
-  const here = path7.dirname(fileURLToPath2(import.meta.url));
-  const pkgRoot = findPackageRoot2(here);
-  return path7.join(pkgRoot, "src", "feature", "templates");
+  const here = path8.dirname(fileURLToPath3(import.meta.url));
+  const pkgRoot = findPackageRoot3(here);
+  return path8.join(pkgRoot, "src", "feature", "templates");
 }
-function findPackageRoot2(start) {
+function findPackageRoot3(start) {
   let dir = start;
   for (let i = 0; i < 10; i += 1) {
-    const candidate = path7.join(dir, "package.json");
+    const candidate = path8.join(dir, "package.json");
     try {
-      accessSync2(candidate);
+      accessSync3(candidate);
       return dir;
     } catch {
     }
-    const parent = path7.dirname(dir);
+    const parent = path8.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
@@ -2078,11 +2537,11 @@ function findPackageRoot2(start) {
 }
 
 // src/feature/manifest-update.ts
-import * as path8 from "node:path";
+import * as path9 from "node:path";
 async function appendFeatureSlug(projectDirectory, slug) {
   const manifest = await loadMetadataFile(projectDirectory);
   const next = withFeatureSlug(manifest, slug);
-  const metadataPath = path8.join(projectDirectory, METADATA_FILENAME);
+  const metadataPath = path9.join(projectDirectory, METADATA_FILENAME);
   if (next === manifest) {
     return { updated: false, metadataPath };
   }
@@ -2115,7 +2574,7 @@ async function runFeatureAdd(input) {
     const code = e.code;
     if (code === "ENOENT") {
       throw new UserInputError(
-        `no .scaffolder.json found at ${path9.join(input.cwd, METADATA_FILENAME)}`,
+        `no .scaffolder.json found at ${path10.join(input.cwd, METADATA_FILENAME)}`,
         "\u8BF7\u5728 keel \u9879\u76EE\u6839\u76EE\u5F55\u8FD0\u884C\uFF1B\u6216\u5148\u7528 create-keel create \u521B\u5EFA\u9879\u76EE"
       );
     }
@@ -2170,7 +2629,7 @@ async function splitPlanByExistence(plan, cwd, force) {
   const toWrite = [];
   const skipped = [];
   for (const file of plan.files) {
-    const exists = await fileExists(path9.join(cwd, file.targetPath));
+    const exists = await fileExists(path10.join(cwd, file.targetPath));
     if (exists) {
       skipped.push(file.targetPath);
     } else {