@svton/cli 1.2.4 → 1.3.0

package/dist/index.js

@@ -729,21 +729,53 @@ function collectEnvVars(features, config) {
 }
 async function generateEnvExample(features, config, targetPath) {
   const envVars = collectEnvVars(features, config);
+  if (envVars.length === 0) {
+    return;
+  }
   const content = [
+    "# ========================================",
     "# Environment Variables",
+    "# ========================================",
     "# Copy this file to .env and fill in the values",
+    "#",
+    "# IMPORTANT: Never commit .env file to version control!",
+    "# Add .env to your .gitignore file",
+    "#",
     "",
-    ...envVars.map((envVar) => {
-      const lines = [];
+    "# ========================================",
+    "# Application Configuration",
+    "# ========================================",
+    "NODE_ENV=development",
+    "PORT=3000",
+    "",
+    "# ========================================",
+    "# Database Configuration",
+    "# ========================================",
+    "DATABASE_URL=mysql://root:root123456@localhost:3306/{{PROJECT_NAME}}",
+    ""
+  ];
+  const featureGroups = {};
+  for (const featureKey of features) {
+    const feature = config.features[featureKey];
+    if (feature && feature.envVars.length > 0) {
+      featureGroups[feature.name] = feature.envVars;
+    }
+  }
+  for (const [featureName, vars] of Object.entries(featureGroups)) {
+    content.push("# ========================================");
+    content.push(`# ${featureName} Configuration`);
+    content.push("# ========================================");
+    for (const envVar of vars) {
       if (envVar.description) {
-        lines.push(`# ${envVar.description}`);
+        content.push(`# ${envVar.description}`);
       }
-      lines.push(`${envVar.key}=${envVar.default}`);
-      lines.push("");
-      return lines.join("\n");
-    })
-  ].join("\n");
-  await import_fs_extra4.default.writeFile(import_path3.default.join(targetPath, ".env.example"), content);
+      content.push(`${envVar.key}=${envVar.default}`);
+      content.push("");
+    }
+  }
+  const envPath = import_path3.default.join(targetPath, "apps/backend/.env.example");
+  await import_fs_extra4.default.ensureDir(import_path3.default.dirname(envPath));
+  await import_fs_extra4.default.writeFile(envPath, content.join("\n"));
   logger.info("Generated .env.example");
 }
 async function copyConfigFiles(features, config, templateDir, targetPath) {
@@ -834,7 +866,7 @@ ${featuresList}
 \u5F53\u4F60\u9700\u8981\u4F7F\u7528\u67D0\u4E2A\u529F\u80FD\u65F6\uFF0C\u53EF\u4EE5\uFF1A
 
 1. \u67E5\u770B\u5BF9\u5E94\u7684 skill \u6587\u6863\u4E86\u89E3 API \u548C\u6700\u4F73\u5B9E\u8DF5
-2. \u53C2\u8003 \`src/examples/\` \u76EE\u5F55\u4E0B\u7684\u793A\u4F8B\u4EE3\u7801
+2. \u53C2\u8003 \`apps/backend/src/examples/\` \u76EE\u5F55\u4E0B\u7684\u793A\u4F8B\u4EE3\u7801
 3. \u67E5\u770B\u5B98\u65B9\u6587\u6863\u83B7\u53D6\u66F4\u591A\u4FE1\u606F
 
 ## \u6587\u6863\u8D44\u6E90
@@ -847,7 +879,7 @@ ${featuresList}
   logger.info("Generated capabilities index");
 }
 async function updatePackageJson(features, config, targetPath) {
-  const packageJsonPath = import_path3.default.join(targetPath, "package.json");
+  const packageJsonPath = import_path3.default.join(targetPath, "apps/backend/package.json");
   const packageJson = await import_fs_extra4.default.readJSON(packageJsonPath);
   const dependencies = collectDependencies(features, config);
   packageJson.dependencies = {
@@ -884,30 +916,62 @@ function generateModuleRegistrations(features, config) {
   return registrations.join("\n");
 }
 async function updateAppModule(features, config, targetPath) {
-  const appModulePath = import_path3.default.join(targetPath, "src/app.module.ts");
-  if (!await import_fs_extra4.default.pathExists(appModulePath)) {
-    logger.warn("app.module.ts not found, skipping module injection");
+  if (features.length === 0) {
     return;
   }
-  let content = await import_fs_extra4.default.readFile(appModulePath, "utf-8");
   const imports = generateModuleImports(features, config);
   const registrations = generateModuleRegistrations(features, config);
-  const importsMatch = content.match(/imports:\s*\[([\s\S]*?)\]/);
-  if (importsMatch) {
-    const existingImports = importsMatch[1];
-    const newImports = `${existingImports}
-${registrations}`;
-    content = content.replace(
-      /imports:\s*\[([\s\S]*?)\]/,
-      `imports: [${newImports}
-  ]`
-    );
-  }
-  const lastImportIndex = content.lastIndexOf("import ");
-  const lastImportEnd = content.indexOf("\n", lastImportIndex);
-  content = content.slice(0, lastImportEnd + 1) + imports + "\n" + content.slice(lastImportEnd + 1);
-  await import_fs_extra4.default.writeFile(appModulePath, content);
-  logger.info("Updated app.module.ts with feature modules");
+  const content = `# \u529F\u80FD\u6A21\u5757\u96C6\u6210\u8BF4\u660E
+
+\u672C\u6587\u6863\u8BF4\u660E\u5982\u4F55\u5C06\u9009\u4E2D\u7684\u529F\u80FD\u6A21\u5757\u96C6\u6210\u5230 app.module.ts \u4E2D\u3002
+
+## 1. \u6DFB\u52A0\u5BFC\u5165\u8BED\u53E5
+
+\u5728 \`apps/backend/src/app.module.ts\` \u6587\u4EF6\u9876\u90E8\u6DFB\u52A0\u4EE5\u4E0B\u5BFC\u5165\uFF1A
+
+\`\`\`typescript
+${imports}
+\`\`\`
+
+## 2. \u6CE8\u518C\u6A21\u5757
+
+\u5728 \`@Module\` \u88C5\u9970\u5668\u7684 \`imports\` \u6570\u7EC4\u4E2D\u6DFB\u52A0\u4EE5\u4E0B\u6A21\u5757\uFF1A
+
+\`\`\`typescript
+@Module({
+  imports: [
+    // ... \u5176\u4ED6\u6A21\u5757
+${registrations}
+  ],
+  // ...
+})
+export class AppModule {}
+\`\`\`
+
+## 3. \u914D\u7F6E\u6587\u4EF6
+
+\u6BCF\u4E2A\u529F\u80FD\u7684\u914D\u7F6E\u6587\u4EF6\u5DF2\u751F\u6210\u5728 \`apps/backend/src/config/\` \u76EE\u5F55\u4E0B\uFF1A
+
+${features.map((key) => {
+    const feature = config.features[key];
+    return `- **${feature.name}**: \`src/config/${key}.config.ts\``;
+  }).join("\n")}
+
+## 4. \u793A\u4F8B\u4EE3\u7801
+
+\u793A\u4F8B\u4EE3\u7801\u5DF2\u751F\u6210\u5728 \`apps/backend/src/examples/\` \u76EE\u5F55\u4E0B\uFF0C\u53EF\u4EE5\u53C2\u8003\u4F7F\u7528\u3002
+
+## 5. \u73AF\u5883\u53D8\u91CF
+
+\u8BF7\u590D\u5236 \`.env.example\` \u4E3A \`.env\` \u5E76\u586B\u5199\u76F8\u5E94\u7684\u914D\u7F6E\u503C\u3002
+
+## 6. \u66F4\u591A\u6587\u6863
+
+\u67E5\u770B \`.kiro/skills/\` \u76EE\u5F55\u4E0B\u7684\u8BE6\u7EC6\u6587\u6863\u4E86\u89E3\u6BCF\u4E2A\u529F\u80FD\u7684\u4F7F\u7528\u65B9\u6CD5\u3002
+`;
+  const docPath = import_path3.default.join(targetPath, "apps/backend/FEATURE_INTEGRATION.md");
+  await import_fs_extra4.default.writeFile(docPath, content);
+  logger.info("Generated feature integration guide: apps/backend/FEATURE_INTEGRATION.md");
 }
 
 // src/commands/create.ts
@@ -1115,7 +1179,7 @@ async function createProjectFromTemplate(config) {
 }
 
 // package.json
-var version = "1.2.4";
+var version = "1.3.0";
 
 // src/index.ts
 async function cli() {

package/dist/index.mjs

@@ -702,21 +702,53 @@ function collectEnvVars(features, config) {
 }
 async function generateEnvExample(features, config, targetPath) {
   const envVars = collectEnvVars(features, config);
+  if (envVars.length === 0) {
+    return;
+  }
   const content = [
+    "# ========================================",
     "# Environment Variables",
+    "# ========================================",
     "# Copy this file to .env and fill in the values",
+    "#",
+    "# IMPORTANT: Never commit .env file to version control!",
+    "# Add .env to your .gitignore file",
+    "#",
     "",
-    ...envVars.map((envVar) => {
-      const lines = [];
+    "# ========================================",
+    "# Application Configuration",
+    "# ========================================",
+    "NODE_ENV=development",
+    "PORT=3000",
+    "",
+    "# ========================================",
+    "# Database Configuration",
+    "# ========================================",
+    "DATABASE_URL=mysql://root:root123456@localhost:3306/{{PROJECT_NAME}}",
+    ""
+  ];
+  const featureGroups = {};
+  for (const featureKey of features) {
+    const feature = config.features[featureKey];
+    if (feature && feature.envVars.length > 0) {
+      featureGroups[feature.name] = feature.envVars;
+    }
+  }
+  for (const [featureName, vars] of Object.entries(featureGroups)) {
+    content.push("# ========================================");
+    content.push(`# ${featureName} Configuration`);
+    content.push("# ========================================");
+    for (const envVar of vars) {
       if (envVar.description) {
-        lines.push(`# ${envVar.description}`);
+        content.push(`# ${envVar.description}`);
       }
-      lines.push(`${envVar.key}=${envVar.default}`);
-      lines.push("");
-      return lines.join("\n");
-    })
-  ].join("\n");
-  await fs4.writeFile(path3.join(targetPath, ".env.example"), content);
+      content.push(`${envVar.key}=${envVar.default}`);
+      content.push("");
+    }
+  }
+  const envPath = path3.join(targetPath, "apps/backend/.env.example");
+  await fs4.ensureDir(path3.dirname(envPath));
+  await fs4.writeFile(envPath, content.join("\n"));
   logger.info("Generated .env.example");
 }
 async function copyConfigFiles(features, config, templateDir, targetPath) {
@@ -807,7 +839,7 @@ ${featuresList}
 \u5F53\u4F60\u9700\u8981\u4F7F\u7528\u67D0\u4E2A\u529F\u80FD\u65F6\uFF0C\u53EF\u4EE5\uFF1A
 
 1. \u67E5\u770B\u5BF9\u5E94\u7684 skill \u6587\u6863\u4E86\u89E3 API \u548C\u6700\u4F73\u5B9E\u8DF5
-2. \u53C2\u8003 \`src/examples/\` \u76EE\u5F55\u4E0B\u7684\u793A\u4F8B\u4EE3\u7801
+2. \u53C2\u8003 \`apps/backend/src/examples/\` \u76EE\u5F55\u4E0B\u7684\u793A\u4F8B\u4EE3\u7801
 3. \u67E5\u770B\u5B98\u65B9\u6587\u6863\u83B7\u53D6\u66F4\u591A\u4FE1\u606F
 
 ## \u6587\u6863\u8D44\u6E90
@@ -820,7 +852,7 @@ ${featuresList}
   logger.info("Generated capabilities index");
 }
 async function updatePackageJson(features, config, targetPath) {
-  const packageJsonPath = path3.join(targetPath, "package.json");
+  const packageJsonPath = path3.join(targetPath, "apps/backend/package.json");
   const packageJson = await fs4.readJSON(packageJsonPath);
   const dependencies = collectDependencies(features, config);
   packageJson.dependencies = {
@@ -857,30 +889,62 @@ function generateModuleRegistrations(features, config) {
   return registrations.join("\n");
 }
 async function updateAppModule(features, config, targetPath) {
-  const appModulePath = path3.join(targetPath, "src/app.module.ts");
-  if (!await fs4.pathExists(appModulePath)) {
-    logger.warn("app.module.ts not found, skipping module injection");
+  if (features.length === 0) {
     return;
   }
-  let content = await fs4.readFile(appModulePath, "utf-8");
   const imports = generateModuleImports(features, config);
   const registrations = generateModuleRegistrations(features, config);
-  const importsMatch = content.match(/imports:\s*\[([\s\S]*?)\]/);
-  if (importsMatch) {
-    const existingImports = importsMatch[1];
-    const newImports = `${existingImports}
-${registrations}`;
-    content = content.replace(
-      /imports:\s*\[([\s\S]*?)\]/,
-      `imports: [${newImports}
-  ]`
-    );
-  }
-  const lastImportIndex = content.lastIndexOf("import ");
-  const lastImportEnd = content.indexOf("\n", lastImportIndex);
-  content = content.slice(0, lastImportEnd + 1) + imports + "\n" + content.slice(lastImportEnd + 1);
-  await fs4.writeFile(appModulePath, content);
-  logger.info("Updated app.module.ts with feature modules");
+  const content = `# \u529F\u80FD\u6A21\u5757\u96C6\u6210\u8BF4\u660E
+
+\u672C\u6587\u6863\u8BF4\u660E\u5982\u4F55\u5C06\u9009\u4E2D\u7684\u529F\u80FD\u6A21\u5757\u96C6\u6210\u5230 app.module.ts \u4E2D\u3002
+
+## 1. \u6DFB\u52A0\u5BFC\u5165\u8BED\u53E5
+
+\u5728 \`apps/backend/src/app.module.ts\` \u6587\u4EF6\u9876\u90E8\u6DFB\u52A0\u4EE5\u4E0B\u5BFC\u5165\uFF1A
+
+\`\`\`typescript
+${imports}
+\`\`\`
+
+## 2. \u6CE8\u518C\u6A21\u5757
+
+\u5728 \`@Module\` \u88C5\u9970\u5668\u7684 \`imports\` \u6570\u7EC4\u4E2D\u6DFB\u52A0\u4EE5\u4E0B\u6A21\u5757\uFF1A
+
+\`\`\`typescript
+@Module({
+  imports: [
+    // ... \u5176\u4ED6\u6A21\u5757
+${registrations}
+  ],
+  // ...
+})
+export class AppModule {}
+\`\`\`
+
+## 3. \u914D\u7F6E\u6587\u4EF6
+
+\u6BCF\u4E2A\u529F\u80FD\u7684\u914D\u7F6E\u6587\u4EF6\u5DF2\u751F\u6210\u5728 \`apps/backend/src/config/\` \u76EE\u5F55\u4E0B\uFF1A
+
+${features.map((key) => {
+    const feature = config.features[key];
+    return `- **${feature.name}**: \`src/config/${key}.config.ts\``;
+  }).join("\n")}
+
+## 4. \u793A\u4F8B\u4EE3\u7801
+
+\u793A\u4F8B\u4EE3\u7801\u5DF2\u751F\u6210\u5728 \`apps/backend/src/examples/\` \u76EE\u5F55\u4E0B\uFF0C\u53EF\u4EE5\u53C2\u8003\u4F7F\u7528\u3002
+
+## 5. \u73AF\u5883\u53D8\u91CF
+
+\u8BF7\u590D\u5236 \`.env.example\` \u4E3A \`.env\` \u5E76\u586B\u5199\u76F8\u5E94\u7684\u914D\u7F6E\u503C\u3002
+
+## 6. \u66F4\u591A\u6587\u6863
+
+\u67E5\u770B \`.kiro/skills/\` \u76EE\u5F55\u4E0B\u7684\u8BE6\u7EC6\u6587\u6863\u4E86\u89E3\u6BCF\u4E2A\u529F\u80FD\u7684\u4F7F\u7528\u65B9\u6CD5\u3002
+`;
+  const docPath = path3.join(targetPath, "apps/backend/FEATURE_INTEGRATION.md");
+  await fs4.writeFile(docPath, content);
+  logger.info("Generated feature integration guide: apps/backend/FEATURE_INTEGRATION.md");
 }
 
 // src/commands/create.ts
@@ -1088,7 +1152,7 @@ async function createProjectFromTemplate(config) {
 }
 
 // package.json
-var version = "1.2.4";
+var version = "1.3.0";
 
 // src/index.ts
 async function cli() {

package/features.json

@@ -17,7 +17,7 @@
       ],
       "configFiles": [
         {
-          "path": "src/config/cache.config.ts",
+          "path": "apps/backend/src/config/cache.config.ts",
           "template": "configs/cache.config.ts"
         }
       ],
@@ -34,7 +34,7 @@
       },
       "exampleFiles": {
         "source": "examples/cache",
-        "target": "src/examples/cache",
+        "target": "apps/backend/src/examples/cache",
         "description": "缓存装饰器使用示例"
       },
       "skillFile": {
@@ -58,7 +58,7 @@
       ],
       "configFiles": [
         {
-          "path": "src/config/queue.config.ts",
+          "path": "apps/backend/src/config/queue.config.ts",
           "template": "configs/queue.config.ts"
         }
       ],
@@ -75,7 +75,7 @@
       },
       "exampleFiles": {
         "source": "examples/queue",
-        "target": "src/examples/queue",
+        "target": "apps/backend/src/examples/queue",
         "description": "队列任务处理示例"
       },
       "skillFile": {
@@ -104,7 +104,7 @@
       ],
       "configFiles": [
         {
-          "path": "src/config/payment.config.ts",
+          "path": "apps/backend/src/config/payment.config.ts",
           "template": "configs/payment.config.ts"
         }
       ],
@@ -121,7 +121,7 @@
       },
       "exampleFiles": {
         "source": "examples/payment",
-        "target": "src/examples/payment",
+        "target": "apps/backend/src/examples/payment",
         "description": "支付功能示例（微信/支付宝）"
       },
       "skillFile": {
@@ -146,7 +146,7 @@
       ],
       "configFiles": [
         {
-          "path": "src/config/oauth.config.ts",
+          "path": "apps/backend/src/config/oauth.config.ts",
           "template": "configs/oauth.config.ts"
         }
       ],
@@ -163,7 +163,7 @@
       },
       "exampleFiles": {
         "source": "examples/oauth",
-        "target": "src/examples/oauth",
+        "target": "apps/backend/src/examples/oauth",
         "description": "OAuth 登录示例"
       },
       "skillFile": {
@@ -188,7 +188,7 @@
       ],
       "configFiles": [
         {
-          "path": "src/config/sms.config.ts",
+          "path": "apps/backend/src/config/sms.config.ts",
           "template": "configs/sms.config.ts"
         }
       ],
@@ -205,7 +205,7 @@
       },
       "exampleFiles": {
         "source": "examples/sms",
-        "target": "src/examples/sms",
+        "target": "apps/backend/src/examples/sms",
         "description": "短信发送示例"
       },
       "skillFile": {
@@ -232,7 +232,7 @@
       ],
       "configFiles": [
         {
-          "path": "src/config/storage.config.ts",
+          "path": "apps/backend/src/config/storage.config.ts",
           "template": "configs/storage.config.ts"
         }
       ],
@@ -249,7 +249,7 @@
       },
       "exampleFiles": {
         "source": "examples/storage",
-        "target": "src/examples/storage",
+        "target": "apps/backend/src/examples/storage",
         "description": "文件上传示例"
       },
       "skillFile": {
@@ -273,7 +273,7 @@
       ],
       "configFiles": [
         {
-          "path": "src/config/rate-limit.config.ts",
+          "path": "apps/backend/src/config/rate-limit.config.ts",
           "template": "configs/rate-limit.config.ts"
         }
       ],
@@ -290,7 +290,7 @@
       },
       "exampleFiles": {
         "source": "examples/rate-limit",
-        "target": "src/examples/rate-limit",
+        "target": "apps/backend/src/examples/rate-limit",
         "description": "限流使用示例"
       },
       "skillFile": {
@@ -310,7 +310,7 @@
       "envVars": [],
       "configFiles": [
         {
-          "path": "src/config/authz.config.ts",
+          "path": "apps/backend/src/config/authz.config.ts",
           "template": "configs/authz.config.ts"
         }
       ],
@@ -327,7 +327,7 @@
       },
       "exampleFiles": {
         "source": "examples/authz",
-        "target": "src/examples/authz",
+        "target": "apps/backend/src/examples/authz",
         "description": "权限控制示例"
       },
       "skillFile": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svton/cli",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "description": "Svton CLI - Create full-stack applications with NestJS, Next.js, and Taro",
   "keywords": [
     "cli",