moyan-mfw-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moyan MFW
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,198 @@
+# moyan-mfw-cli
+
+MFW (墨焱管理框架) 脚手架 CLI 工具，提供扩展插件和业务项目的快速生成功能。
+
+## 安装
+
+```bash
+# 全局安装
+npm install -g moyan-mfw-cli
+
+# 或通过 pnpm
+pnpm add -g moyan-mfw-cli
+```
+
+**环境要求**：Node.js >= 20.0.0
+
+## 命令速查
+
+| 命令 | 说明 |
+|------|------|
+| `mfw create extension <name>` | 创建扩展插件项目 |
+| `mfw create business <name>` | 创建业务项目（后端+前端+共享层） |
+| `mfw generate` | 生成代码（开发中） |
+| `mfw validate` | 验证扩展包（开发中） |
+| `mfw version` | 版本管理（开发中） |
+
+## 使用指南
+
+### 创建扩展插件
+
+扩展插件是可插拔的模块，拥有独立的 backend/frontend/shared 三层架构。
+
+```bash
+mfw create extension my-ext
+```
+
+**交互式提示**：
+
+| 选项 | 默认值 | 说明 |
+|------|--------|------|
+| 显示名称 | PascalCase 转换名 | 中文/展示名称 |
+| 描述 | 空 | 项目描述 |
+| 路由前缀 | `/ext/{name}` | 必须以 `/ext/` 开头 |
+| 需要后端模块? | 是 | 是否生成 NestJS 后端 |
+| 需要前端页面? | 是 | 是否生成 Vue3 前端 |
+| 需要共享层? | 是 | 是否生成 TypeScript 类型层 |
+
+**生成目录结构**：
+
+```
+extension-my-ext/
+├── src/
+│   ├── backend/     → NestJS 应用
+│   ├── frontend/    → Vue3 + Vite 应用
+│   └── shared/      → 纯 TypeScript 类型
+├── database/migrations/
+└── package.json
+```
+
+**后续步骤**：
+
+```bash
+cd extension-my-ext && pnpm install
+pnpm dev:backend   # 启动后端
+pnpm dev:frontend  # 启动前端
+```
+
+### 创建业务项目
+
+业务项目是独立完整的应用，包含后端 API、前端界面和共享类型。
+
+```bash
+mfw create business my-shop
+```
+
+**交互式提示**：
+
+| 选项 | 默认值 | 说明 |
+|------|--------|------|
+| 显示名称 | PascalCase 转换名 | 中文/展示名称 |
+| 描述 | `{Name} 业务项目` | 项目描述 |
+| 后端端口 | `3000` | NestJS 服务端口 |
+| 前端端口 | `5173` | Vite 开发服务器端口 |
+
+**生成目录结构**：
+
+```
+my-shop/
+├── backend/         → NestJS 后端
+│   ├── src/
+│   │   ├── app-types.config.ts
+│   │   ├── app.modules.ts
+│   │   ├── main.ts
+│   │   └── permissions.ts
+│   ├── .env
+│   └── package.json
+├── frontend/        → Vue3 前端
+│   ├── src/
+│   │   ├── views/dashboard/
+│   │   ├── main.ts
+│   │   ├── permissions.ts
+│   │   └── router.ts
+│   ├── index.html
+│   └── package.json
+├── shared/          → 共享类型
+│   ├── src/
+│   │   ├── index.ts
+│   │   └── permissions.ts
+│   └── package.json
+└── package.json
+```
+
+**后续步骤**：
+
+```bash
+cd my-shop
+# 编辑 backend/.env 配置数据库连接
+pnpm install && pnpm build
+pnpm --filter my-shop-backend dev    # 启动后端
+pnpm --filter my-shop-frontend dev   # 启动前端
+```
+
+## 模板说明
+
+### Handlebars 模板变量
+
+| 变量 | 示例值 | 说明 |
+|------|--------|------|
+| `{{name}}` | `my-ext` | kebab-case 项目名 |
+| `{{displayName}}` | `MyExt` | 显示名称 |
+| `{{description}}` | 用户输入 | 项目描述 |
+| `{{className}}` | `MyExt` | PascalCase 类名 |
+| `{{version}}` | `0.1.0` | 初始版本 |
+| `{{year}}` | `2026` | 当前年份 |
+
+### 自定义 Helpers
+
+| Helper | 输入 | 输出 | 说明 |
+|--------|------|------|------|
+| `pascalCase` | `my-ext` | `MyExt` | 转 PascalCase |
+| `pascalCaseUpper` | `my-ext` | `MYEXT` | 转大写 PascalCase |
+| `camelCase` | `my-ext` | `myExt` | 转 camelCase |
+| `snakeCase` | `my-ext` | `my_ext` | 转 snake_case |
+
+### 模板变量示例
+
+```hbs
+<!-- 权限常量声明 -->
+export const {{pascalCaseUpper name}}_PERMISSION_VALUES = [...]
+
+<!-- 数据库名 -->
+DB_NAME={{snakeCase name}}
+
+<!-- 包名引用 -->
+"moyan-mfw-extension-{{name}}": "workspace:*"
+```
+
+## 开发
+
+```bash
+# 克隆仓库后进入 CLI 目录
+cd packages/cli
+
+# 安装依赖
+pnpm install
+
+# 开发模式（watch）
+pnpm dev
+
+# 构建
+pnpm build
+
+# 类型检查
+pnpm typecheck
+```
+
+### 添加新模板
+
+1. 在 `src/templates/` 下创建新目录
+2. 编写 `.hbs` 模板文件
+3. 在 `src/commands/` 添加对应命令
+4. 在 `src/utils/template.ts` 注册 helpers（如需）
+
+## 已知修复
+
+| 版本 | 修复内容 |
+|------|----------|
+| 0.1.0 | Vue 插值与 Handlebars 冲突修复（`v-text` 替代 `{{ }}`） |
+| 0.1.0 | 权限常量命名统一（`pascalCaseUpper` helper） |
+| 0.1.0 | tsconfig references 路径修正（`./*/tsconfig.json`） |
+| 0.1.0 | Vite alias 前缀补全（`moyan-mfw-extension-`） |
+| 0.1.0 | workspace 协议补全（`workspace:*`） |
+
+## 相关资源
+
+- [MFW 架构文档](../../AGENTS.md)
+- [扩展开发指南](../../docs/extensions/README.md)
+- [本地运行指南](../../docs/本地运行指南.md)

package/bin/mfw.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const distPath = join(__dirname, '..', 'dist', 'index.js').replace(/\\/g, '/')
+await import(`file://${distPath}`)

package/dist/index.cjs

@@ -0,0 +1,326 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_commander3 = require("commander");
+var import_chalk3 = __toESM(require("chalk"), 1);
+
+// src/commands/create.ts
+var import_commander = require("commander");
+var import_inquirer = __toESM(require("inquirer"), 1);
+var import_chalk = __toESM(require("chalk"), 1);
+var path3 = __toESM(require("path"), 1);
+var import_node_path = require("path");
+var import_node_url = require("url");
+var fs3 = __toESM(require("fs/promises"), 1);
+
+// src/utils/fs.ts
+var fs = __toESM(require("fs/promises"), 1);
+var path = __toESM(require("path"), 1);
+async function ensureDir(dirPath) {
+  await fs.mkdir(dirPath, { recursive: true });
+}
+async function writeFile2(filePath, content) {
+  await ensureDir(path.dirname(filePath));
+  await fs.writeFile(filePath, content, "utf-8");
+}
+async function exists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/utils/template.ts
+var import_handlebars = __toESM(require("handlebars"), 1);
+var fs2 = __toESM(require("fs/promises"), 1);
+var path2 = __toESM(require("path"), 1);
+import_handlebars.default.registerHelper(
+  "pascalCase",
+  (str) => str.replace(/(^\w|-\w)/g, (c) => c.slice(-1).toUpperCase())
+);
+import_handlebars.default.registerHelper(
+  "camelCase",
+  (str) => str.replace(/-(\w)/g, (_, c) => c.toUpperCase())
+);
+import_handlebars.default.registerHelper("pascalCaseUpper", (str) => {
+  const pascal = str.replace(/(^\w|-\w)/g, (c) => c.slice(-1).toUpperCase());
+  return pascal.toUpperCase();
+});
+import_handlebars.default.registerHelper("snakeCase", (str) => str.replace(/-/g, "_"));
+function getParser(filePath) {
+  const ext = path2.extname(filePath);
+  const map = {
+    ".ts": "typescript",
+    ".tsx": "typescript",
+    ".js": "babel",
+    ".jsx": "babel",
+    ".mjs": "babel",
+    ".cjs": "babel",
+    ".vue": "vue",
+    ".json": "json",
+    ".md": "markdown",
+    ".html": "html",
+    ".css": "css",
+    ".scss": "scss",
+    ".less": "less",
+    ".yaml": "yaml",
+    ".yml": "yaml"
+  };
+  return map[ext] ?? null;
+}
+async function formatContent(content, filePath) {
+  const parser = getParser(filePath);
+  if (!parser) return content;
+  try {
+    const mod = await import("prettier");
+    const fmt = mod.default ?? mod;
+    if (typeof fmt.format !== "function") return content;
+    const formatted = await fmt.format(content, {
+      parser,
+      semi: true,
+      singleQuote: true,
+      trailingComma: "all",
+      printWidth: 100,
+      tabWidth: 2,
+      useTabs: false,
+      endOfLine: "lf"
+    });
+    return formatted;
+  } catch {
+    return content;
+  }
+}
+async function renderTemplate(templatePath, vars) {
+  const source = await fs2.readFile(templatePath, "utf-8");
+  const compiled = import_handlebars.default.compile(source);
+  return compiled(vars);
+}
+async function renderTemplateToDir(templateDir, outputDir, vars) {
+  const files = await getAllFiles(templateDir);
+  for (const file of files) {
+    const relative4 = path2.relative(templateDir, file);
+    if (!relative4.endsWith(".hbs")) continue;
+    const outputNameRaw = relative4.replace(/\.hbs$/, "").replace(/\\/g, "/");
+    const outputName = import_handlebars.default.compile(outputNameRaw)(vars);
+    const outputPath = path2.join(outputDir, outputName);
+    const raw = await renderTemplate(file, vars);
+    const content = await formatContent(raw, outputPath);
+    await writeFile2(outputPath, content);
+  }
+}
+async function getAllFiles(dir) {
+  const results = [];
+  const entries = await fs2.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path2.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...await getAllFiles(fullPath));
+    } else {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+// src/commands/create.ts
+var import_meta = {};
+var __filename = (0, import_node_url.fileURLToPath)(import_meta.url);
+var __dirname = (0, import_node_path.dirname)(__filename);
+var createCommand = new import_commander.Command("extension").description("Create a new MFW extension package").argument("<name>", 'Extension name in kebab-case (e.g., "ad", "blog")').option("-t, --template <name>", "Template to use", "default").option("-d, --dir <path>", "Output directory", "packages/extensions").option("-f, --force", "Force overwrite existing directory", false).action(async (name, opts) => {
+  if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+    console.error(import_chalk.default.red(`Invalid name "${name}". Must be kebab-case.`));
+    process.exit(1);
+  }
+  const className = name.replace(/(^\w|-\w)/g, (c) => c.slice(-1).toUpperCase());
+  const targetDir = path3.resolve(opts.dir, `extension-${name}`);
+  if (await exists(targetDir)) {
+    if (!opts.force) {
+      console.error(import_chalk.default.red(`Directory already exists: ${targetDir}
+Use --force to overwrite.`));
+      process.exit(1);
+    }
+  }
+  const answers = await import_inquirer.default.prompt([
+    { name: "displayName", message: "\u663E\u793A\u540D\u79F0:", default: className },
+    { name: "description", message: "\u63CF\u8FF0:", default: "" },
+    { name: "routePrefix", message: "\u8DEF\u7531\u524D\u7F00:", default: `/ext/${name}` },
+    { name: "hasBackend", message: "\u9700\u8981\u540E\u7AEF\u6A21\u5757?", type: "confirm", default: true },
+    { name: "hasFrontend", message: "\u9700\u8981\u524D\u7AEF\u9875\u9762?", type: "confirm", default: true },
+    { name: "hasShared", message: "\u9700\u8981\u5171\u4EAB\u5C42?", type: "confirm", default: true }
+  ]);
+  if (!answers.routePrefix.startsWith("/ext/")) {
+    console.error(import_chalk.default.red(`routePrefix must start with "/ext/", got: "${answers.routePrefix}"`));
+    process.exit(1);
+  }
+  const vars = {
+    name,
+    displayName: answers.displayName,
+    description: answers.description,
+    routePrefix: answers.routePrefix,
+    permPrefix: name,
+    className,
+    packageName: `moyan-mfw-extension-${name}`,
+    hasBackend: answers.hasBackend,
+    hasFrontend: answers.hasFrontend,
+    hasShared: answers.hasShared,
+    version: "0.1.0",
+    year: (/* @__PURE__ */ new Date()).getFullYear()
+  };
+  const templateDir = path3.resolve(__dirname, "../templates/extension");
+  console.log(import_chalk.default.blue(`
+\u{1F528} Generating extension "${name}" at ${targetDir}...`));
+  await renderTemplateToDir(templateDir, targetDir, vars);
+  if (!vars.hasBackend) {
+    await fs3.rm(path3.join(targetDir, "src/backend"), { recursive: true, force: true });
+  }
+  if (!vars.hasFrontend) {
+    await fs3.rm(path3.join(targetDir, "src/frontend"), { recursive: true, force: true });
+  }
+  if (!vars.hasShared) {
+    await fs3.rm(path3.join(targetDir, "src/shared"), { recursive: true, force: true });
+  }
+  await ensureDir(path3.join(targetDir, "database/migrations"));
+  await writeFile2(path3.join(targetDir, "database/migrations", ".gitkeep"), "");
+  console.log(import_chalk.default.green("\n\u2705 Done!"));
+  console.log(`
+${import_chalk.default.bold("\u{1F4CB} \u540E\u7EED\u96C6\u6210\u6B65\u9AA4:")}`);
+  console.log(`   1. cd ${path3.relative(process.cwd(), targetDir)} && pnpm install`);
+  console.log("   2. \u6839 package.json \u2192 scripts.build \u4E2D\u6DFB\u52A0\u6784\u5EFA\u547D\u4EE4");
+  console.log("   3. \u6839 package.json \u2192 scripts.typecheck \u4E2D\u6DFB\u52A0\u5B50\u5305\u5F15\u7528");
+  console.log("   4. \uFF08\u5982\u9700\u540E\u7AEF\uFF09\u6CE8\u518C\u6269\u5C55 Module \u5230\u5E94\u7528\u5165\u53E3");
+  console.log(import_chalk.default.gray("\n\u{1F4A1} P2 \u9636\u6BB5\u5C06\u63D0\u4F9B mfw integrate <name> \u81EA\u52A8\u5B8C\u6210\u6B65\u9AA4 2-4"));
+});
+
+// src/commands/create-business.ts
+var import_commander2 = require("commander");
+var import_inquirer2 = __toESM(require("inquirer"), 1);
+var import_chalk2 = __toESM(require("chalk"), 1);
+var path4 = __toESM(require("path"), 1);
+var import_node_path2 = require("path");
+var import_node_url2 = require("url");
+var import_meta2 = {};
+var __filename2 = (0, import_node_url2.fileURLToPath)(import_meta2.url);
+var __dirname2 = (0, import_node_path2.dirname)(__filename2);
+var createBusinessCommand = new import_commander2.Command("business").description("Create a new business project (backend + frontend + shared)").argument("<name>", 'Project name in kebab-case (e.g., "my-shop")').option("-d, --dir <path>", "Output directory", ".").option("-f, --force", "Force overwrite existing directory", false).action(async (name, opts) => {
+  if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+    console.error(import_chalk2.default.red(`Invalid name "${name}". Must be kebab-case (e.g., "my-shop").`));
+    process.exit(1);
+  }
+  const targetDir = path4.resolve(opts.dir, name);
+  const className = name.replace(/(^\w|-\w)/g, (c) => c.slice(-1).toUpperCase());
+  if (await exists(targetDir)) {
+    if (!opts.force) {
+      console.error(import_chalk2.default.red(`Directory already exists: ${targetDir}
+Use --force to overwrite.`));
+      process.exit(1);
+    }
+  }
+  const answers = await import_inquirer2.default.prompt([
+    {
+      name: "displayName",
+      message: "\u663E\u793A\u540D\u79F0:",
+      default: className
+    },
+    {
+      name: "description",
+      message: "\u63CF\u8FF0:",
+      default: `${className} \u4E1A\u52A1\u9879\u76EE`
+    },
+    {
+      name: "port",
+      message: "\u540E\u7AEF\u7AEF\u53E3:",
+      default: "3000",
+      validate: (v) => {
+        const n = Number(v);
+        return n > 0 && n < 65536 ? true : "\u7AEF\u53E3\u53F7\u5FC5\u987B\u5728 1-65535 \u4E4B\u95F4";
+      }
+    },
+    {
+      name: "frontendPort",
+      message: "\u524D\u7AEF\u7AEF\u53E3:",
+      default: "5173",
+      validate: (v) => {
+        const n = Number(v);
+        return n > 0 && n < 65536 ? true : "\u7AEF\u53E3\u53F7\u5FC5\u987B\u5728 1-65535 \u4E4B\u95F4";
+      }
+    }
+  ]);
+  const vars = {
+    name,
+    displayName: answers.displayName,
+    description: answers.description,
+    port: Number(answers.port),
+    frontendPort: Number(answers.frontendPort),
+    className,
+    version: "0.1.0",
+    year: (/* @__PURE__ */ new Date()).getFullYear()
+  };
+  const templateDir = path4.resolve(__dirname2, "../templates/business");
+  console.log(import_chalk2.default.blue(`
+\u{1F528} Generating business project "${name}" at ${targetDir}...`));
+  await renderTemplateToDir(templateDir, targetDir, vars);
+  const keepDirs = [
+    "backend/src/modules",
+    "backend/src/entities",
+    "backend/src/database",
+    "frontend/src/components/Layout"
+  ];
+  for (const dir of keepDirs) {
+    await ensureDir(path4.join(targetDir, dir));
+    await writeFile2(path4.join(targetDir, dir, ".gitkeep"), "");
+  }
+  console.log(import_chalk2.default.green("\n\u2705 Done!"));
+  console.log(`
+${import_chalk2.default.bold("\u{1F4CB} \u540E\u7EED\u6B65\u9AA4:")}`);
+  console.log(`   1. cd ${path4.relative(process.cwd(), targetDir)}`);
+  console.log(`   2. \u7F16\u8F91 backend/.env \u914D\u7F6E\u6570\u636E\u5E93\u8FDE\u63A5`);
+  console.log(`   3. pnpm install && pnpm build`);
+  console.log(`   4. pnpm --filter ${name}-backend dev   # \u542F\u52A8\u540E\u7AEF`);
+  console.log(`   5. pnpm --filter ${name}-frontend dev  # \u542F\u52A8\u524D\u7AEF`);
+  console.log(`
+${import_chalk2.default.gray("\u{1F4A1} \u6DFB\u52A0\u6269\u5C55\u6A21\u5757: \u5728 backend/src/app.modules.ts \u4E2D\u5F15\u5165\u6269\u5C55 Module")}`);
+  console.log(`${import_chalk2.default.gray("\u{1F4A1} \u6DFB\u52A0\u4E1A\u52A1\u6A21\u5757: \u5728 backend/src/modules/ \u4E0B\u521B\u5EFA\u65B0\u7684 NestJS \u6A21\u5757")}`);
+});
+
+// src/index.ts
+var program = new import_commander3.Command();
+program.name("mfw").description("Moyan MFW Framework CLI").version("0.1.0");
+var createCmd = new import_commander3.Command("create").description("Create a new extension or resource");
+createCmd.addCommand(createCommand);
+createCmd.addCommand(createBusinessCommand);
+program.addCommand(createCmd);
+program.command("generate").description("Generate code within an extension").action(() => {
+  console.log(import_chalk3.default.yellow("generate command coming soon"));
+});
+program.command("validate").description("Validate an extension package").action(() => {
+  console.log(import_chalk3.default.yellow("validate command coming soon"));
+});
+program.command("version").description("Version management utilities").action(() => {
+  console.log(import_chalk3.default.yellow("version command coming soon"));
+});
+program.parse();

package/dist/index.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,301 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command as Command3 } from "commander";
+import chalk3 from "chalk";
+
+// src/commands/create.ts
+import { Command } from "commander";
+import inquirer from "inquirer";
+import chalk from "chalk";
+import * as path3 from "path";
+import { dirname as dirname2 } from "path";
+import { fileURLToPath } from "url";
+import * as fs3 from "fs/promises";
+
+// src/utils/fs.ts
+import * as fs from "fs/promises";
+import * as path from "path";
+async function ensureDir(dirPath) {
+  await fs.mkdir(dirPath, { recursive: true });
+}
+async function writeFile2(filePath, content) {
+  await ensureDir(path.dirname(filePath));
+  await fs.writeFile(filePath, content, "utf-8");
+}
+async function exists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/utils/template.ts
+import Handlebars from "handlebars";
+import * as fs2 from "fs/promises";
+import * as path2 from "path";
+Handlebars.registerHelper(
+  "pascalCase",
+  (str) => str.replace(/(^\w|-\w)/g, (c) => c.slice(-1).toUpperCase())
+);
+Handlebars.registerHelper(
+  "camelCase",
+  (str) => str.replace(/-(\w)/g, (_, c) => c.toUpperCase())
+);
+Handlebars.registerHelper("pascalCaseUpper", (str) => {
+  const pascal = str.replace(/(^\w|-\w)/g, (c) => c.slice(-1).toUpperCase());
+  return pascal.toUpperCase();
+});
+Handlebars.registerHelper("snakeCase", (str) => str.replace(/-/g, "_"));
+function getParser(filePath) {
+  const ext = path2.extname(filePath);
+  const map = {
+    ".ts": "typescript",
+    ".tsx": "typescript",
+    ".js": "babel",
+    ".jsx": "babel",
+    ".mjs": "babel",
+    ".cjs": "babel",
+    ".vue": "vue",
+    ".json": "json",
+    ".md": "markdown",
+    ".html": "html",
+    ".css": "css",
+    ".scss": "scss",
+    ".less": "less",
+    ".yaml": "yaml",
+    ".yml": "yaml"
+  };
+  return map[ext] ?? null;
+}
+async function formatContent(content, filePath) {
+  const parser = getParser(filePath);
+  if (!parser) return content;
+  try {
+    const mod = await import("prettier");
+    const fmt = mod.default ?? mod;
+    if (typeof fmt.format !== "function") return content;
+    const formatted = await fmt.format(content, {
+      parser,
+      semi: true,
+      singleQuote: true,
+      trailingComma: "all",
+      printWidth: 100,
+      tabWidth: 2,
+      useTabs: false,
+      endOfLine: "lf"
+    });
+    return formatted;
+  } catch {
+    return content;
+  }
+}
+async function renderTemplate(templatePath, vars) {
+  const source = await fs2.readFile(templatePath, "utf-8");
+  const compiled = Handlebars.compile(source);
+  return compiled(vars);
+}
+async function renderTemplateToDir(templateDir, outputDir, vars) {
+  const files = await getAllFiles(templateDir);
+  for (const file of files) {
+    const relative4 = path2.relative(templateDir, file);
+    if (!relative4.endsWith(".hbs")) continue;
+    const outputNameRaw = relative4.replace(/\.hbs$/, "").replace(/\\/g, "/");
+    const outputName = Handlebars.compile(outputNameRaw)(vars);
+    const outputPath = path2.join(outputDir, outputName);
+    const raw = await renderTemplate(file, vars);
+    const content = await formatContent(raw, outputPath);
+    await writeFile2(outputPath, content);
+  }
+}
+async function getAllFiles(dir) {
+  const results = [];
+  const entries = await fs2.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path2.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...await getAllFiles(fullPath));
+    } else {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+// src/commands/create.ts
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname2(__filename);
+var createCommand = new Command("extension").description("Create a new MFW extension package").argument("<name>", 'Extension name in kebab-case (e.g., "ad", "blog")').option("-t, --template <name>", "Template to use", "default").option("-d, --dir <path>", "Output directory", "packages/extensions").option("-f, --force", "Force overwrite existing directory", false).action(async (name, opts) => {
+  if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+    console.error(chalk.red(`Invalid name "${name}". Must be kebab-case.`));
+    process.exit(1);
+  }
+  const className = name.replace(/(^\w|-\w)/g, (c) => c.slice(-1).toUpperCase());
+  const targetDir = path3.resolve(opts.dir, `extension-${name}`);
+  if (await exists(targetDir)) {
+    if (!opts.force) {
+      console.error(chalk.red(`Directory already exists: ${targetDir}
+Use --force to overwrite.`));
+      process.exit(1);
+    }
+  }
+  const answers = await inquirer.prompt([
+    { name: "displayName", message: "\u663E\u793A\u540D\u79F0:", default: className },
+    { name: "description", message: "\u63CF\u8FF0:", default: "" },
+    { name: "routePrefix", message: "\u8DEF\u7531\u524D\u7F00:", default: `/ext/${name}` },
+    { name: "hasBackend", message: "\u9700\u8981\u540E\u7AEF\u6A21\u5757?", type: "confirm", default: true },
+    { name: "hasFrontend", message: "\u9700\u8981\u524D\u7AEF\u9875\u9762?", type: "confirm", default: true },
+    { name: "hasShared", message: "\u9700\u8981\u5171\u4EAB\u5C42?", type: "confirm", default: true }
+  ]);
+  if (!answers.routePrefix.startsWith("/ext/")) {
+    console.error(chalk.red(`routePrefix must start with "/ext/", got: "${answers.routePrefix}"`));
+    process.exit(1);
+  }
+  const vars = {
+    name,
+    displayName: answers.displayName,
+    description: answers.description,
+    routePrefix: answers.routePrefix,
+    permPrefix: name,
+    className,
+    packageName: `moyan-mfw-extension-${name}`,
+    hasBackend: answers.hasBackend,
+    hasFrontend: answers.hasFrontend,
+    hasShared: answers.hasShared,
+    version: "0.1.0",
+    year: (/* @__PURE__ */ new Date()).getFullYear()
+  };
+  const templateDir = path3.resolve(__dirname, "../templates/extension");
+  console.log(chalk.blue(`
+\u{1F528} Generating extension "${name}" at ${targetDir}...`));
+  await renderTemplateToDir(templateDir, targetDir, vars);
+  if (!vars.hasBackend) {
+    await fs3.rm(path3.join(targetDir, "src/backend"), { recursive: true, force: true });
+  }
+  if (!vars.hasFrontend) {
+    await fs3.rm(path3.join(targetDir, "src/frontend"), { recursive: true, force: true });
+  }
+  if (!vars.hasShared) {
+    await fs3.rm(path3.join(targetDir, "src/shared"), { recursive: true, force: true });
+  }
+  await ensureDir(path3.join(targetDir, "database/migrations"));
+  await writeFile2(path3.join(targetDir, "database/migrations", ".gitkeep"), "");
+  console.log(chalk.green("\n\u2705 Done!"));
+  console.log(`
+${chalk.bold("\u{1F4CB} \u540E\u7EED\u96C6\u6210\u6B65\u9AA4:")}`);
+  console.log(`   1. cd ${path3.relative(process.cwd(), targetDir)} && pnpm install`);
+  console.log("   2. \u6839 package.json \u2192 scripts.build \u4E2D\u6DFB\u52A0\u6784\u5EFA\u547D\u4EE4");
+  console.log("   3. \u6839 package.json \u2192 scripts.typecheck \u4E2D\u6DFB\u52A0\u5B50\u5305\u5F15\u7528");
+  console.log("   4. \uFF08\u5982\u9700\u540E\u7AEF\uFF09\u6CE8\u518C\u6269\u5C55 Module \u5230\u5E94\u7528\u5165\u53E3");
+  console.log(chalk.gray("\n\u{1F4A1} P2 \u9636\u6BB5\u5C06\u63D0\u4F9B mfw integrate <name> \u81EA\u52A8\u5B8C\u6210\u6B65\u9AA4 2-4"));
+});
+
+// src/commands/create-business.ts
+import { Command as Command2 } from "commander";
+import inquirer2 from "inquirer";
+import chalk2 from "chalk";
+import * as path4 from "path";
+import { dirname as dirname3 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var __filename2 = fileURLToPath2(import.meta.url);
+var __dirname2 = dirname3(__filename2);
+var createBusinessCommand = new Command2("business").description("Create a new business project (backend + frontend + shared)").argument("<name>", 'Project name in kebab-case (e.g., "my-shop")').option("-d, --dir <path>", "Output directory", ".").option("-f, --force", "Force overwrite existing directory", false).action(async (name, opts) => {
+  if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+    console.error(chalk2.red(`Invalid name "${name}". Must be kebab-case (e.g., "my-shop").`));
+    process.exit(1);
+  }
+  const targetDir = path4.resolve(opts.dir, name);
+  const className = name.replace(/(^\w|-\w)/g, (c) => c.slice(-1).toUpperCase());
+  if (await exists(targetDir)) {
+    if (!opts.force) {
+      console.error(chalk2.red(`Directory already exists: ${targetDir}
+Use --force to overwrite.`));
+      process.exit(1);
+    }
+  }
+  const answers = await inquirer2.prompt([
+    {
+      name: "displayName",
+      message: "\u663E\u793A\u540D\u79F0:",
+      default: className
+    },
+    {
+      name: "description",
+      message: "\u63CF\u8FF0:",
+      default: `${className} \u4E1A\u52A1\u9879\u76EE`
+    },
+    {
+      name: "port",
+      message: "\u540E\u7AEF\u7AEF\u53E3:",
+      default: "3000",
+      validate: (v) => {
+        const n = Number(v);
+        return n > 0 && n < 65536 ? true : "\u7AEF\u53E3\u53F7\u5FC5\u987B\u5728 1-65535 \u4E4B\u95F4";
+      }
+    },
+    {
+      name: "frontendPort",
+      message: "\u524D\u7AEF\u7AEF\u53E3:",
+      default: "5173",
+      validate: (v) => {
+        const n = Number(v);
+        return n > 0 && n < 65536 ? true : "\u7AEF\u53E3\u53F7\u5FC5\u987B\u5728 1-65535 \u4E4B\u95F4";
+      }
+    }
+  ]);
+  const vars = {
+    name,
+    displayName: answers.displayName,
+    description: answers.description,
+    port: Number(answers.port),
+    frontendPort: Number(answers.frontendPort),
+    className,
+    version: "0.1.0",
+    year: (/* @__PURE__ */ new Date()).getFullYear()
+  };
+  const templateDir = path4.resolve(__dirname2, "../templates/business");
+  console.log(chalk2.blue(`
+\u{1F528} Generating business project "${name}" at ${targetDir}...`));
+  await renderTemplateToDir(templateDir, targetDir, vars);
+  const keepDirs = [
+    "backend/src/modules",
+    "backend/src/entities",
+    "backend/src/database",
+    "frontend/src/components/Layout"
+  ];
+  for (const dir of keepDirs) {
+    await ensureDir(path4.join(targetDir, dir));
+    await writeFile2(path4.join(targetDir, dir, ".gitkeep"), "");
+  }
+  console.log(chalk2.green("\n\u2705 Done!"));
+  console.log(`
+${chalk2.bold("\u{1F4CB} \u540E\u7EED\u6B65\u9AA4:")}`);
+  console.log(`   1. cd ${path4.relative(process.cwd(), targetDir)}`);
+  console.log(`   2. \u7F16\u8F91 backend/.env \u914D\u7F6E\u6570\u636E\u5E93\u8FDE\u63A5`);
+  console.log(`   3. pnpm install && pnpm build`);
+  console.log(`   4. pnpm --filter ${name}-backend dev   # \u542F\u52A8\u540E\u7AEF`);
+  console.log(`   5. pnpm --filter ${name}-frontend dev  # \u542F\u52A8\u524D\u7AEF`);
+  console.log(`
+${chalk2.gray("\u{1F4A1} \u6DFB\u52A0\u6269\u5C55\u6A21\u5757: \u5728 backend/src/app.modules.ts \u4E2D\u5F15\u5165\u6269\u5C55 Module")}`);
+  console.log(`${chalk2.gray("\u{1F4A1} \u6DFB\u52A0\u4E1A\u52A1\u6A21\u5757: \u5728 backend/src/modules/ \u4E0B\u521B\u5EFA\u65B0\u7684 NestJS \u6A21\u5757")}`);
+});
+
+// src/index.ts
+var program = new Command3();
+program.name("mfw").description("Moyan MFW Framework CLI").version("0.1.0");
+var createCmd = new Command3("create").description("Create a new extension or resource");
+createCmd.addCommand(createCommand);
+createCmd.addCommand(createBusinessCommand);
+program.addCommand(createCmd);
+program.command("generate").description("Generate code within an extension").action(() => {
+  console.log(chalk3.yellow("generate command coming soon"));
+});
+program.command("validate").description("Validate an extension package").action(() => {
+  console.log(chalk3.yellow("validate command coming soon"));
+});
+program.command("version").description("Version management utilities").action(() => {
+  console.log(chalk3.yellow("version command coming soon"));
+});
+program.parse();

package/package.json

@@ -0,0 +1 @@
+{"name": "moyan-mfw-cli", "version": "0.1.0", "description": "MFW framework CLI — extension scaffolding, validation, and publishing tools", "type": "module", "bin": {"mfw": "./bin/mfw.js"}, "exports": {".": {"types": "./dist/index.d.ts", "import": "./dist/index.js", "require": "./dist/index.cjs"}}, "files": ["bin/", "dist/", "README.md", "LICENSE"], "private": false, "scripts": {"dev": "tsx watch src/index.ts", "build": "tsup src/index.ts --format esm,cjs --dts --clean", "typecheck": "tsc --noEmit"}, "dependencies": {"commander": "^12.0.0", "inquirer": "^9.2.0", "chalk": "^5.3.0", "handlebars": "^4.7.8", "semver": "^7.6.0", "glob": "^10.3.0", "execa": "^9.3.0", "prettier": "^3.4.0"}, "devDependencies": {"tsup": "^8.0.0", "tsx": "^4.7.0", "typescript": "^5.7.3", "@types/inquirer": "^9.0.0", "@types/prettier": "^3.0.0"}, "engines": {"node": ">=20.0.0"}}