@ynight/cli 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 diaogroup
+
+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

@@ -1,3 +1,252 @@
-# Temporary Holding Version
+# @ynight/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> Elpis 业务工程 CLI —— 把框架装成可运行的业务项目入口
+
+## 概述
+
+`@ynight/cli` 是 Elpis 框架**业务工程**的入口工具，对外暴露 `elpis` 命令。通过 `elpis dev`、`elpis build`、`elpis type-check` 等命令，业务开发者可以一键启动前后端开发服务器、生产构建和类型检查。
+
+CLI 在内部负责：
+
+- 加载并合并 `elpis.config.ts` 与命令行覆盖项
+- 用 Webpack 5 构建前端（Vue 3 + Element Plus + Pinia）
+- 用 ts-node / tsc 编译并运行后端
+- 通过 Express + webpack-dev-middleware 把前端 HMR 与 Koa 挂到同一 HTTP 端口
+- 把构建产物（前端资源 + 后端编译产物）组装到 `server/dist`，供 `@ynight/server` 启动
+- 扫描业务模块生成 application 类型供编辑器使用
+- 在写入任何文件前做路径安全校验（output-safety），避免覆盖源码目录
+
+`@ynight/cli` 不发布业务源码，只发布 `dist`、`config`、`tsconfig` 三个目录以及 README 与 LICENSE。
+
+## 子导出与发布产物
+
+包内 `package.json` 仅声明两个子路径导出：
+
+| 子路径                             | 指向                 |
+| ---------------------------------- | -------------------- |
+| `@ynight/cli/tsconfig/server.json` | `config/server.json` |
+| `@ynight/cli/tsconfig/client.json` | `config/client.json` |
+
+**重要：** 包内同时保留 `tsconfig/` 目录作为转接文件，**业务工程不要删除或重命名 `tsconfig/`**，因为 `ts-node` 10 对 TypeScript `extends` 的解析依赖这些文件直接落在发布产物中——仅保留 `exports` 映射是不够的。
+
+## 安装
+
+在 Elpis 业务工程中：
+
+```bash
+pnpm add -D @ynight/cli
+```
+
+`bin` 字段会注册 `elpis` 可执行命令。
+
+## 命令
+
+### `elpis dev`
+
+启动开发服务器。
+
+- 解析 `elpis.config.ts` 与 CLI 覆盖项
+- 启动 Webpack dev server（HMR）并把它挂到与 Koa 同一 HTTP 端口
+- 用 ts-node 即时编译并运行 `server/app.ts`
+- 监听业务模块变更：增量切换 `app/` 目录、保留失败产物供诊断、自动清理旧实例
+
+```bash
+elpis dev
+elpis dev --port 4000
+elpis dev --elpis-config ./elpis.config.ts
+```
+
+### `elpis build`
+
+生产构建。
+
+- 前端走 Webpack 5，产物输出到 `server/dist/public`
+- 后端编译为 JavaScript 并组装到 `server/dist`
+- 生成最小生产启动器（`server/dist/index.js`），写入 `manifest.json` 描述内置页面与资源映射
+- 在写入前调用 `output-safety` 检查目标路径，不在 `node_modules / server / model / .git` 等敏感目录下
+
+```bash
+elpis build
+elpis build --out ./build
+```
+
+### `elpis type-check`
+
+运行前后端 TypeScript 类型检查（同步执行应用类型生成）。
+
+- 生成 `types/application.ts` 后再用 `tsc --noEmit` 校验服务端
+- 用 `vue-tsc --noEmit` 校验前端（包含 Vue SFC）
+
+```bash
+elpis type-check
+```
+
+### `elpis generate-types`（被 type-check 调用，也可单独运行）
+
+扫描 `server/controller`、`server/service`、`server/middleware`、`server/router-schema`，按目录命名生成 `types/application.ts`。
+
+```bash
+elpis generate-types
+elpis generate:types:check    # 仅校验已生成的文件是否最新
+```
+
+## 配置文件
+
+### `elpis.config.ts`
+
+工程根目录的 Elpis 配置入口，由 `project-config.ts` 加载并合并 CLI 参数覆盖项。
+
+```ts
+import { defineConfig } from '@ynight/framework';
+
+export default defineConfig({
+  name: 'my-app',
+  server: { host: '127.0.0.1', port: 3000 },
+  model: { dir: 'model' },
+  client: { dashboardBase: '/' },
+});
+```
+
+CLI 参数会合并到最终配置：
+
+| CLI 参数                | 覆盖字段           |
+| ----------------------- | ------------------ |
+| `--port`                | `server.port`      |
+| `--host`                | `server.host`      |
+| `--out`                 | 构建输出目录       |
+| `--elpis-config <path>` | 自定义配置文件路径 |
+
+### TypeScript 配置预设
+
+业务工程在自己的 `tsconfig.json` 中继承 CLI 提供的预设：
+
+```json
+{
+  "extends": "@ynight/cli/tsconfig/server.json"
+}
+```
+
+```json
+{
+  "extends": "@ynight/cli/tsconfig/client.json"
+}
+```
+
+这两份预设包含了构建/运行所需的路径映射、JSX、装饰器、严格模式等选项。
+
+### 目录约定（CLI 视角）
+
+| 路径                                          | 角色                                           |
+| --------------------------------------------- | ---------------------------------------------- |
+| `elpis.config.ts`                             | 工程配置入口                                   |
+| `server/app.ts`                               | `defineServer` 入口，被 `elpis dev` 编译并运行 |
+| `server/controller/<name>.ts`                 | 业务 Controller                                |
+| `server/service/<name>.ts`                    | 业务 Service                                   |
+| `server/router/<name>.ts`                     | 业务路由定义                                   |
+| `server/middleware/<name>.ts`                 | 业务 Koa 中间件                                |
+| `server/router-schema/<name>.ts`              | 路由请求参数 AJV schema                        |
+| `model/<modelKey>/model.<ext>`                | 基础模型                                       |
+| `model/<modelKey>/project/<projectKey>.<ext>` | 项目配置                                       |
+| `client/`                                     | 自定义 Vue 组件 / 页面 / 扩展（可选）          |
+| `types/empty-client.ts`                       | 前端无自定义控件/页面时的占位                  |
+| `public/`                                     | 静态资源（含 help.html）                       |
+
+## 前端构建
+
+CLI 在 `webpack-build.ts` 中基于 Webpack 5 + `vue-loader` + `esbuild-loader` + `less-loader` 装配前端：
+
+- `HtmlWebpackPlugin` 注入入口，`publicPath` 默认为 `/`
+- `PAGE_NAMES` 与 `@ynight/framework/assets` 协同，把框架内置页面（project-list、dashboard、error）注入构建
+- 生产构建通过 `mini-css-extract-plugin` 抽取样式，开发模式用 `style-loader` 注入 HMR
+- 入口文件生成后会写入 `manifest.json`，运行时按页面名解析入口 HTML
+
+`createFrontendOptions` 暴露前端构建选项；`pageOutputPaths` 提供构建产物的最终路径映射，便于服务端在 History 兜底时定位页面。
+
+## 开发代理
+
+`dev-proxy.ts` 把 Express + `webpack-dev-middleware` + `webpack-hot-middleware` 装到 Koa 同一 HTTP 实例：
+
+- API 请求由 Koa 处理
+- `/__webpack_dev_server__/*` 与热更新 socket 由 Webpack 中间件处理
+- 静态资源命中后由 Koa 静态文件中间件兜底
+- 业务资源（`*.js` / `*.css` / `*.png` 等）需经 Koa 的 `public:read` 授权（由 `@ynight/framework` 的 AuthAdapter 决定）
+
+生产构建完成后，`server/dist/public` 被 Koa 直接托管，不再需要 dev proxy。
+
+## 开发文件监听
+
+`dev-entry.ts` 使用 `chokidar` 订阅操作系统文件事件，不通过固定时间间隔递归扫描项目目录：
+
+- 启动时先生成一次业务类型并完成后端编译；
+- 业务目录、模型目录、共享目录和关键配置文件发生 `add`、`change`、`unlink` 时触发更新；
+- 连续保存会合并为一次更新，默认防抖 200ms；
+- 更新过程串行执行，新的文件事件不会被丢弃；
+- 配置改变后会刷新监听范围，退出时关闭 watcher 并释放文件句柄；
+- `.elpis`、`dist`、`node_modules` 和日志目录会被排除，避免生成文件触发自循环。
+
+## 类型生成
+
+`generate-types.ts` 扫描业务模块目录，按嵌套命名空间生成 `types/application.ts`：
+
+- 叶子节点（class / handler）的导出名映射到 `<model>.<service|controller|middleware>` 等路径
+- 中间节点（目录）形成命名空间，路径冲突会抛错
+- 生成结果参与 `type-check` 流水线，确保编辑器与 CI 看到的类型一致
+
+## 路径安全
+
+`output-safety.ts` 在所有写入操作前做路径校验：
+
+- `within(root, candidate)`：确认目标路径在允许根目录之内
+- `safeGeneratedPath`：校验生成文件（如 `types/application.ts`）不会被写入源码目录
+- `safeOutputRoot`：禁止 `outDir` 落在 `node_modules / server / model / .git` 等敏感目录
+- `replaceDirectoryAtomically`：原子替换目录，先写入临时目录再 rename，避免半成品
+
+构建、类型生成、应用启动前都会调用这些守卫。
+
+## 工具与类型
+
+`utils.ts` 提供：
+
+- `findFiles(root, predicate)`、`hasSourceFiles(root)`：业务目录扫描
+- `camelCase`：路径片段命名转换（kebab-case / snake_case → camelCase）
+- `runNodeScript(scriptPath, args)`：派生 Node 子进程并转发 stdout/stderr
+- `resolveTsc` / `resolveVueTsc` / `runTsc` / `runVueTsc`：定位并运行类型检查器
+- `copyDirectory(src, dest)`：安全拷贝目录（保留权限）
+
+`types.ts` 暴露：
+
+- `CliOptions`：CLI 接受的覆盖项结构
+- `ParsedArgs`：参数解析后的结果
+
+## 集成测试
+
+- `pnpm test`：构建后用 `node --test` 运行单元测试（`test/*.test.mjs`）
+- `pnpm test:integration`：使用 Playwright 启动 `elpis dev` 并端到端校验页面与 API
+
+## 相关包
+
+- [@ynight/framework](../framework) — 框架运行时，被本 CLI 组装
+- [@ynight/create-app](../create-app) — 用本 CLI 初始化新的业务工程
+- [@ynight/core](../core) — 底层引擎
+- [@ynight/contracts](../contracts) — DSL 与协议类型
+- [@ynight/model-runtime](../model-runtime) — 模型加载与校验
+
+## 脚本
+
+| 命令                    | 说明                      |
+| ----------------------- | ------------------------- |
+| `pnpm clean`            | 清理 `dist`               |
+| `pnpm build`            | 编译 TypeScript 到 `dist` |
+| `pnpm type-check`       | 类型检查（不产出）        |
+| `pnpm test`             | 单元测试（需先 build）    |
+| `pnpm test:integration` | Playwright 集成测试       |
+| `pnpm lint`             | ESLint                    |
+
+## 引擎要求
+
+- Node.js `>=22.0.0`
+- pnpm `10.16.0`
+
+## 许可证
+
+MIT

package/config/client.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "allowJs": false,
+    "skipLibCheck": false,
+    "types": ["node"]
+  }
+}

package/config/server.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "strict": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "declaration": false,
+    "sourceMap": true,
+    "skipLibCheck": false,
+    "types": ["node"]
+  }
+}

package/dist/bin.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import type { ParsedArgs } from './types';
+/**
+ * 把 `process.argv.slice(2)` 解析为结构化的 `{ command, options }`。
+ *
+ * 支持的子命令：
+ * - `dev` / `build` / `type-check` / `generate:types`：实际工作命令；
+ * - `--help` / `-h`：等价于 `help`，只打印帮助；
+ * - `--version` / `-v`：等价于 `version`，只打印版本号。
+ *
+ * 支持的参数：
+ * - `--root <path>`：业务工程根目录，默认 `process.cwd()`；
+ * - `--port <n>`：后端 Koa 端口（仅 `dev`）；
+ * - `--web-port <n>`：前端 dev server 端口（仅 `dev`）；
+ * - `--check`：仅 `generate:types` 支持，启用新鲜度校验模式。
+ *
+ * @throws 当首个参数不是已知子命令或后续参数不识别时抛出。
+ */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/**
+ * CLI 主入口：解析参数 → 分发到对应命令函数。
+ *
+ * @param argv 默认取 `process.argv.slice(2)`，便于测试时显式注入。
+ */
+export declare function main(argv?: string[]): Promise<void>;
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAkB1C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAgCpD;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBtE"}

package/dist/bin.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+exports.main = main;
+const tslib_1 = require("tslib");
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const commands_1 = require("./commands");
+const generate_types_1 = require("./generate-types");
+/**
+ * 解析并校验 CLI 中的端口号参数。
+ *
+ * @param value 原始字符串（来自 `argv`）。
+ * @param name 参数名（如 `--port`），仅用于错误提示。
+ * @returns 合法端口号（整数）。
+ * @throws 当 value 不是合法整数或不在 1-65535 范围内时抛出。
+ */
+function parsePort(value, name) {
+    const port = Number(value);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`${name} 必须是 1-65535 的整数`);
+    }
+    return port;
+}
+/**
+ * 把 `process.argv.slice(2)` 解析为结构化的 `{ command, options }`。
+ *
+ * 支持的子命令：
+ * - `dev` / `build` / `type-check` / `generate:types`：实际工作命令；
+ * - `--help` / `-h`：等价于 `help`，只打印帮助；
+ * - `--version` / `-v`：等价于 `version`，只打印版本号。
+ *
+ * 支持的参数：
+ * - `--root <path>`：业务工程根目录，默认 `process.cwd()`；
+ * - `--port <n>`：后端 Koa 端口（仅 `dev`）；
+ * - `--web-port <n>`：前端 dev server 端口（仅 `dev`）；
+ * - `--check`：仅 `generate:types` 支持，启用新鲜度校验模式。
+ *
+ * @throws 当首个参数不是已知子命令或后续参数不识别时抛出。
+ */
+function parseArgs(argv) {
+    const first = argv[0];
+    // 没有任何参数或显式 --help / -h：进入帮助分支。
+    if (!first || first === '--help' || first === '-h') {
+        return { command: 'help', options: { root: process.cwd() } };
+    }
+    if (first === '--version' || first === '-v') {
+        return { command: 'version', options: { root: process.cwd() } };
+    }
+    // 仅识别白名单内的子命令，避免误把业务参数当成命令执行。
+    const known = new Set(['dev', 'build', 'type-check', 'generate:types']);
+    if (!known.has(first)) {
+        throw new Error(`未知命令: ${first}`);
+    }
+    // 默认根目录 = 当前工作目录，子命令可以再通过 --root 覆盖。
+    const options = { root: process.cwd() };
+    for (let index = 1; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === '--root') {
+            // path.resolve 支持绝对路径与相对路径（含 `..`）。
+            options.root = node_path_1.default.resolve(argv[++index] ?? '');
+        }
+        else if (arg === '--port') {
+            options.port = parsePort(argv[++index] ?? '', '--port');
+        }
+        else if (arg === '--web-port') {
+            options.webPort = parsePort(argv[++index] ?? '', '--web-port');
+        }
+        else if (arg === '--check' && first === 'generate:types') {
+            options.check = true;
+        }
+        else {
+            throw new Error(`未知参数: ${arg}`);
+        }
+    }
+    return { command: first, options };
+}
+/**
+ * CLI 主入口：解析参数 → 分发到对应命令函数。
+ *
+ * @param argv 默认取 `process.argv.slice(2)`，便于测试时显式注入。
+ */
+async function main(argv = process.argv.slice(2)) {
+    const parsed = parseArgs(argv);
+    if (parsed.command === 'help') {
+        console.log(commands_1.HELP);
+        return;
+    }
+    if (parsed.command === 'version') {
+        console.log(commands_1.CLI_VERSION);
+        return;
+    }
+    if (parsed.command === 'generate:types') {
+        (0, generate_types_1.generateTypes)(parsed.options.root, parsed.options.check);
+        console.log(parsed.options.check ? '生成类型检查通过' : '生成类型已更新');
+        return;
+    }
+    if (parsed.command === 'type-check') {
+        (0, commands_1.typeCheck)(parsed.options);
+        return;
+    }
+    if (parsed.command === 'build') {
+        await (0, commands_1.build)(parsed.options);
+        return;
+    }
+    // 兜底：唯一剩下的命令就是 dev。
+    await (0, commands_1.dev)(parsed.options);
+}
+// 顶层错误捕获：所有命令最终统一收敛到这里，便于给出统一的退出码。
+main().catch(error => {
+    console.error(`Elpis 执行失败: ${error instanceof Error ? error.message : error}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"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"}

package/dist/commands.d.ts

@@ -0,0 +1,38 @@
+import type { CliOptions } from './types';
+export declare const CLI_VERSION: string;
+/**
+ * CLI 帮助文本：列出所有子命令与参数；保持简洁，便于直接打印。
+ *
+ * 注意：每个子命令的实际解析在 `bin.ts::parseArgs` 中。
+ */
+export declare const HELP: string;
+/**
+ * 同步执行完整类型检查：
+ * 1. 校验配置文件；
+ * 2. 重新生成业务模块声明文件；
+ * 3. 使用 `tsc --noEmit` 检查服务端代码；
+ * 4. 调用 `vue-tsc` 检查客户端代码。
+ */
+export declare function typeCheck(options: CliOptions): void;
+/**
+ * 生产构建主流程：
+ * 1. 校验配置与输出目录安全；
+ * 2. 重新生成类型声明；
+ * 3. 在 `.elpis/build/{buildId}` 下构建 staging 产物；
+ * 4. 校验页面模板齐全；
+ * 5. 写入 manifest；
+ * 6. 原子替换到正式输出目录。
+ *
+ * 任何步骤失败都会在 catch 中打印消息并向上抛出，调用方决定是否回滚。
+ */
+export declare function build(options: CliOptions): Promise<void>;
+/**
+ * 开发模式入口（spawn 当前 CLI 重新跑 dev-entry.ts）。
+ *
+ * 这里采用子进程模式的原因：
+ * - dev-entry 维护大量长生命周期资源（koa server / webpack-dev-server / tsc 子进程 / 定时器），
+ *   用独立子进程可借助 OS 进程隔离避免污染父进程；
+ * - 父进程仅负责把 SIGINT / SIGTERM 透传给子进程，简化资源回收。
+ */
+export declare function dev(options: CliOptions): Promise<void>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAM1C,eAAO,MAAM,WAAW,QAA0B,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,IAAI,QAOU,CAAC;AAkD5B;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAMnD;AA2CD;;;;;;;;;;GAUG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD9D;AAED;;;;;;;GAOG;AACH,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C5D"}