@svton/cli 1.2.5 → 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, "apps/backend/.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) {
@@ -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, "apps/backend/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.5";
+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, "apps/backend/.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) {
@@ -857,30 +889,62 @@ function generateModuleRegistrations(features, config) {
   return registrations.join("\n");
 }
 async function updateAppModule(features, config, targetPath) {
-  const appModulePath = path3.join(targetPath, "apps/backend/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.5";
+var version = "1.3.0";
 
 // src/index.ts
 async function cli() {

package/package.json

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