@wneng/create-keel 0.4.2 → 0.5.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/version.ts
-var SCAFFOLDER_VERSION = "0.4.2";
+var SCAFFOLDER_VERSION = "0.5.0";
 
 // src/schema/options.ts
 import Ajv from "ajv";
@@ -29,6 +29,7 @@ var AI_TOOLS = ["kiro", "cursor", "claude-code", "codex", "none"];
 var LICENSE_KINDS = ["mit", "apache-2.0", "proprietary"];
 var CI_PLATFORMS = ["gitee", "github"];
 var ROLE_KINDS = ["design", "qa", "field", "data", "legal-security", "marketing"];
+var OPENAPI_LAYOUTS = ["single", "by-audience"];
 var PROJECT_NAME_PATTERN = /^[a-z0-9][a-z0-9-]{0,62}$/;
 var PROJECT_NAME_PATTERN_SOURCE = "^[a-z0-9][a-z0-9-]{0,62}$";
 var OPTIONS_FIELD_ORDER = [
@@ -47,7 +48,8 @@ var OPTIONS_FIELD_ORDER = [
   "ci",
   "roles",
   "multiApp",
-  "database"
+  "database",
+  "openapiLayout"
 ];
 var OPTIONS_SCHEMA = {
   $schema: "http://json-schema.org/draft-07/schema#",
@@ -71,7 +73,8 @@ var OPTIONS_SCHEMA = {
     "ci",
     "roles",
     "multiApp",
-    "database"
+    "database",
+    "openapiLayout"
   ],
   properties: {
     projectName: {
@@ -96,7 +99,8 @@ var OPTIONS_SCHEMA = {
       uniqueItems: true
     },
     multiApp: { type: "boolean" },
-    database: { type: "string", enum: [...DATABASE_KINDS] }
+    database: { type: "string", enum: [...DATABASE_KINDS] },
+    openapiLayout: { type: "string", enum: [...OPENAPI_LAYOUTS] }
   },
   // Cross-axis constraint: `backend === 'none'` requires `database === 'none'`.
   // A non-'none' database without a backend would be a contradiction (no
@@ -452,6 +456,7 @@ function parseCreateArgs(args) {
   let gitLfs;
   let integrations;
   let database;
+  let openapiLayout;
   function takeEnum(flag, next, enumValues) {
     if (next === void 0 || next.startsWith("--")) {
       throw new UserInputError(
@@ -548,6 +553,11 @@ function parseCreateArgs(args) {
         i += 1;
         break;
       }
+      case "--openapi-layout": {
+        openapiLayout = takeEnum("--openapi-layout", args[i + 1], OPENAPI_LAYOUTS);
+        i += 1;
+        break;
+      }
       case "--engineering-standards": {
         const next = args[i + 1];
         if (next === void 0 || next.startsWith("--")) {
@@ -673,7 +683,8 @@ function parseCreateArgs(args) {
     ...license !== void 0 ? { license } : {},
     ...gitLfs !== void 0 ? { gitLfs } : {},
     ...integrations !== void 0 ? { integrations } : {},
-    ...database !== void 0 ? { database } : {}
+    ...database !== void 0 ? { database } : {},
+    ...openapiLayout !== void 0 ? { openapiLayout } : {}
   };
   if (sampleFeature && dryRun) {
     throw new UserInputError(
@@ -762,6 +773,7 @@ function helpText() {
     "  --ai <kind>        " + AI_TOOLS.join("|"),
     "  --license <kind>   " + LICENSE_KINDS.join("|"),
     "  --database <kind>  " + DATABASE_KINDS.join("|") + " (requires backend != none)",
+    "  --openapi-layout <kind>  " + OPENAPI_LAYOUTS.join("|") + " (default: single; ignored when contract has no OpenAPI)",
     "  --gitLfs           Enable Git LFS in the generated project",
     "  --integrations     Enable docs/06-\u96C6\u6210\u5BF9\u63A5/ at create time",
     "  -h, --help         Show this help",
@@ -816,7 +828,8 @@ var OPTION_DEFAULTS = {
   ci: "gitee",
   roles: [],
   multiApp: false,
-  database: "none"
+  database: "none",
+  openapiLayout: "single"
 };
 function buildDefaultOptions(projectName) {
   return { projectName, ...OPTION_DEFAULTS };
@@ -853,7 +866,8 @@ var PARTIAL_OPTIONS_SCHEMA = {
       uniqueItems: true
     },
     multiApp: { type: "boolean" },
-    database: { type: "string", enum: [...DATABASE_KINDS] }
+    database: { type: "string", enum: [...DATABASE_KINDS] },
+    openapiLayout: { type: "string", enum: [...OPENAPI_LAYOUTS] }
   }
 };
 var ajv2 = new Ajv2({ allErrors: true, strict: true });
@@ -1051,6 +1065,25 @@ async function promptForOptions(input) {
     report,
     "contract"
   );
+  let openapiLayout;
+  const contractHasOpenapi = contract === "rest" || contract === "rest+events";
+  if (!contractHasOpenapi) {
+    openapiLayout = "single";
+    report("openapiLayout", openapiLayout, true);
+  } else if (pre.openapiLayout !== void 0) {
+    openapiLayout = pre.openapiLayout;
+    report("openapiLayout", openapiLayout, false);
+  } else {
+    openapiLayout = await p.select(
+      "OpenAPI \u6587\u4EF6\u5E03\u5C40",
+      [
+        { value: "single", name: "single        \u5355\u6587\u4EF6 contracts/openapi/api.yaml\uFF08\u5C0F\u9879\u76EE\uFF0C\u9ED8\u8BA4\uFF09" },
+        { value: "by-audience", name: "by-audience   \u6309\u53D7\u4F17\u62C6 admin / user / agent + _components/schemas.yaml\uFF08\u591A\u56E2\u961F\u573A\u666F\uFF09" }
+      ],
+      OPTION_DEFAULTS.openapiLayout
+    );
+    report("openapiLayout", openapiLayout, false);
+  }
   const ai = await chooseAxis(
     p,
     pre.ai,
@@ -1121,7 +1154,8 @@ async function promptForOptions(input) {
     ci,
     roles,
     multiApp: OPTION_DEFAULTS.multiApp,
-    database
+    database,
+    openapiLayout
   };
 }
 async function chooseAxis(prompter, prefilled, question, domain, def, report, axisName) {
@@ -1173,7 +1207,8 @@ var APPLIES_WHEN_SCHEMA = {
     integrations: { type: "boolean" },
     ci: { type: "string", enum: [...CI_PLATFORMS] },
     role: { type: "string", enum: [...ROLE_KINDS] },
-    database: { type: "string", enum: [...DATABASE_KINDS] }
+    database: { type: "string", enum: [...DATABASE_KINDS] },
+    openapiLayout: { type: "string", enum: [...OPENAPI_LAYOUTS] }
   }
 };
 var MANIFEST_SCHEMA = {
@@ -1645,6 +1680,9 @@ function assertMetadata(value) {
     if (!("database" in opts)) {
       opts.database = "none";
     }
+    if (!("openapiLayout" in opts)) {
+      opts.openapiLayout = "single";
+    }
   }
   if (!validateFn3(value)) {
     throw new MetadataValidationError(collectIssues3());
@@ -2224,6 +2262,20 @@ function detectRuntimeManifests(options) {
 }
 
 // src/standards/plan.ts
+function defaultOrmConvention(options) {
+  if (options.backend === "none" || options.database === "none") return "none";
+  if (options.database === "elasticsearch") return "none";
+  switch (options.backend) {
+    case "java":
+      return "mybatis-plus-only";
+    case "node":
+      return "knex-only";
+    case "python":
+      return "sqlalchemy-orm-only";
+    case "go":
+      return "none";
+  }
+}
 async function buildStandardsPlan(input) {
   const templatesRoot = input.templatesRoot ?? defaultStandardsTemplatesRoot();
   const now = input.now ?? /* @__PURE__ */ new Date();
@@ -2248,6 +2300,16 @@ async function buildStandardsPlan(input) {
   if (input.tier === "standard" || input.tier === "full") {
     for (const m of manifests) {
       const fileBaseName = `tech-stack-${m.env}.md`;
+      const standardsBase = {
+        tier: input.tier,
+        env: m.env,
+        language: m.language,
+        packageManager: m.packageManager,
+        manifestPath: m.manifestPath,
+        lastReviewed,
+        multiApp: input.options.multiApp
+      };
+      const standards = m.env === "server" ? { ...standardsBase, ormConvention: defaultOrmConvention(input.options) } : standardsBase;
       files.push(
         await renderStandardsTemplate({
           templatesRoot,
@@ -2257,21 +2319,7 @@ async function buildStandardsPlan(input) {
           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).
-          },
+          standards,
           extraStandardsFields: { dependencies: m.dependencies }
         })
       );
@@ -2531,7 +2579,8 @@ async function resolveOptions(input) {
     ...flags.gitLfs !== void 0 ? { gitLfs: flags.gitLfs } : {},
     ...flags.integrations !== void 0 ? { integrations: flags.integrations } : {},
     ...flags.multiApp !== void 0 ? { multiApp: flags.multiApp } : {},
-    ...flags.database !== void 0 ? { database: flags.database } : {}
+    ...flags.database !== void 0 ? { database: flags.database } : {},
+    ...flags.openapiLayout !== void 0 ? { openapiLayout: flags.openapiLayout } : {}
   };
   if (flags.yes) {
     const full = { ...buildDefaultOptions(projectName), ...merged };