@ynight/cli 0.0.0-stage → 0.0.1

package/dist/output-safety.d.ts

@@ -0,0 +1,47 @@
+import type { ElpisConfig } from '@ynight/framework/server';
+/**
+ * 在项目根目录下解析一个"生成路径"并校验其安全性。
+ *
+ * 防止以下风险：
+ * 1. 路径逃逸项目根目录（例如相对路径中含 `..`）。
+ * 2. 经过悬空或指向源码目录外的符号链接（避免覆盖源码、注入替换等）。
+ *
+ * 注意：必须逐级检查路径上的每一段，不能只检查最终目标，否则攻击者可通过
+ * 中间符号链接绕过 `realpathSync` 校验。
+ *
+ * @param root 业务工程根目录。
+ * @param relativePath 相对于根目录的子路径（生成类目录通常以 `.elpis/` 开头）。
+ * @returns 经 `realpathSync` 处理过的目标绝对路径。
+ * @throws 当路径等于根目录、逃逸根目录或经过符号链接时抛出。
+ */
+export declare function safeGeneratedPath(root: string, relativePath: string): string;
+/**
+ * 计算并校验生产产物的输出根目录。
+ *
+ * 保护目标：
+ * - 不允许 `build.outDir` 落在源码、依赖、`git`、`.elpis` 等关键目录内；
+ * - 也不允许覆盖关键目录的子目录或反过来包含关键目录。
+ * - 默认输出目录为 `dist`，可通过 `config.build.outDir` 覆盖。
+ *
+ * @throws 当输出目录命中受保护路径时抛出，避免误删源码。
+ */
+export declare function safeOutputRoot(root: string, config: ElpisConfig): string;
+/**
+ * 原子地将暂存目录替换为正式输出目录。
+ *
+ * 实现策略：
+ * 1. 先把已有的输出目录改名为 `backup`（用于回滚）；
+ * 2. 再把暂存目录改名为正式输出（POSIX `rename` 是原子的）；
+ * 3. 写事务记录文件，状态包含 `prepared` / `complete` / `rolled-back`。
+ *
+ * 失败兜底：
+ * - 若 `rename(staging → output)` 失败且 backup 存在，立即把 backup 改回 output；
+ * - 永远不删除 backup，便于事后诊断与回滚。
+ *
+ * @param root 业务工程根目录。
+ * @param staging 暂存目录（一般位于 `.elpis/build/{buildId}/dist`）。
+ * @param output 最终输出目录（已通过 `safeOutputRoot` 校验）。
+ * @param buildId 本次构建的唯一标识，用于命名 backup / 事务记录。
+ */
+export declare function replaceDirectoryAtomically(root: string, staging: string, output: string, buildId: string): void;
+//# sourceMappingURL=output-safety.d.ts.map

package/dist/output-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-safety.d.ts","sourceRoot":"","sources":["../src/output-safety.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAgB5D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAkB5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAkCxE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,IAAI,CA6BN"}

package/dist/output-safety.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeGeneratedPath = safeGeneratedPath;
+exports.safeOutputRoot = safeOutputRoot;
+exports.replaceDirectoryAtomically = replaceDirectoryAtomically;
+const tslib_1 = require("tslib");
+const node_fs_1 = tslib_1.__importDefault(require("node:fs"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+/**
+ * 判断 `target` 是否位于 `root` 内（不解析符号链接）。
+ *
+ * 等价于 `target` 解析后路径不以 `..` 起始，也不是绝对路径。
+ * 同时兼容 `target === root` 的情况（视为"在内部"）。
+ */
+function within(root, target) {
+    const relative = node_path_1.default.relative(root, target);
+    return (relative === '' ||
+        (relative !== '..' && !relative.startsWith(`..${node_path_1.default.sep}`) && !node_path_1.default.isAbsolute(relative)));
+}
+/**
+ * 在项目根目录下解析一个"生成路径"并校验其安全性。
+ *
+ * 防止以下风险：
+ * 1. 路径逃逸项目根目录（例如相对路径中含 `..`）。
+ * 2. 经过悬空或指向源码目录外的符号链接（避免覆盖源码、注入替换等）。
+ *
+ * 注意：必须逐级检查路径上的每一段，不能只检查最终目标，否则攻击者可通过
+ * 中间符号链接绕过 `realpathSync` 校验。
+ *
+ * @param root 业务工程根目录。
+ * @param relativePath 相对于根目录的子路径（生成类目录通常以 `.elpis/` 开头）。
+ * @returns 经 `realpathSync` 处理过的目标绝对路径。
+ * @throws 当路径等于根目录、逃逸根目录或经过符号链接时抛出。
+ */
+function safeGeneratedPath(root, relativePath) {
+    // 解析真实路径，处理源码工程本身就是符号链接的情况。
+    const rootReal = node_fs_1.default.realpathSync(root);
+    const target = node_path_1.default.resolve(rootReal, relativePath);
+    if (target === rootReal || !within(rootReal, target)) {
+        throw new Error(`生成路径必须位于项目根目录内: ${target}`);
+    }
+    let current = rootReal;
+    // 逐段检查：哪怕最终路径合法，中途遇到符号链接也要拒绝。
+    for (const part of node_path_1.default.relative(rootReal, target).split(node_path_1.default.sep)) {
+        current = node_path_1.default.join(current, part);
+        // `throwIfNoEntry: false` 让路径不存在时也不抛错（首次创建场景正常）。
+        const stat = node_fs_1.default.lstatSync(current, { throwIfNoEntry: false });
+        if (stat?.isSymbolicLink()) {
+            throw new Error(`生成路径不能经过符号链接: ${current}`);
+        }
+    }
+    return target;
+}
+/**
+ * 计算并校验生产产物的输出根目录。
+ *
+ * 保护目标：
+ * - 不允许 `build.outDir` 落在源码、依赖、`git`、`.elpis` 等关键目录内；
+ * - 也不允许覆盖关键目录的子目录或反过来包含关键目录。
+ * - 默认输出目录为 `dist`，可通过 `config.build.outDir` 覆盖。
+ *
+ * @throws 当输出目录命中受保护路径时抛出，避免误删源码。
+ */
+function safeOutputRoot(root, config) {
+    root = node_fs_1.default.realpathSync(root);
+    const output = safeGeneratedPath(root, config.build?.outDir ?? 'dist');
+    // 受保护的目录集合：覆盖源码、依赖、构建产物目录都视作不安全。
+    const protectedPaths = [
+        'node_modules',
+        '.git',
+        '.elpis',
+        'server',
+        'model',
+        'client',
+        'shared',
+        'public',
+        'types',
+        'src',
+        'config',
+        config.server?.businessDir ?? 'server',
+        config.model?.dir ?? 'model',
+        config.server?.entry ?? 'server/app.ts',
+        // 客户端扩展入口若声明了，也要纳入保护。
+        ...(config.client?.extensions ? [config.client.extensions] : []),
+    ].map(folder => node_path_1.default.resolve(root, folder));
+    if (
+    // 输出路径中含 `node_modules` 或 `.git` 段必然不安全。
+    node_path_1.default
+        .relative(node_fs_1.default.realpathSync(root), output)
+        .split(node_path_1.default.sep)
+        .some(part => ['node_modules', '.git'].includes(part)) ||
+        // 互为父子关系都禁止：避免输出目录污染源码，也避免源码目录吞掉构建产物。
+        protectedPaths.some(folder => within(folder, output) || within(output, folder))) {
+        throw new Error(`build.outDir 不能覆盖源码、依赖或生成目录: ${output}`);
+    }
+    return output;
+}
+/**
+ * 原子地将暂存目录替换为正式输出目录。
+ *
+ * 实现策略：
+ * 1. 先把已有的输出目录改名为 `backup`（用于回滚）；
+ * 2. 再把暂存目录改名为正式输出（POSIX `rename` 是原子的）；
+ * 3. 写事务记录文件，状态包含 `prepared` / `complete` / `rolled-back`。
+ *
+ * 失败兜底：
+ * - 若 `rename(staging → output)` 失败且 backup 存在，立即把 backup 改回 output；
+ * - 永远不删除 backup，便于事后诊断与回滚。
+ *
+ * @param root 业务工程根目录。
+ * @param staging 暂存目录（一般位于 `.elpis/build/{buildId}/dist`）。
+ * @param output 最终输出目录（已通过 `safeOutputRoot` 校验）。
+ * @param buildId 本次构建的唯一标识，用于命名 backup / 事务记录。
+ */
+function replaceDirectoryAtomically(root, staging, output, buildId) {
+    // 路径校验：确保 staging / output / backup 都位于项目内。
+    safeGeneratedPath(root, node_path_1.default.relative(root, staging));
+    safeGeneratedPath(root, node_path_1.default.relative(root, output));
+    // backup 目录用于回滚；事务记录 JSON 用于审计与排障。
+    const backup = safeGeneratedPath(root, `.elpis/backup/${buildId}`);
+    const record = safeGeneratedPath(root, `.elpis/transactions/${buildId}.json`);
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(backup), { recursive: true });
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(record), { recursive: true });
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(output), { recursive: true });
+    // 事务记录写入函数：始终带 `status` 字段，便于后续脚本识别状态。
+    const writeRecord = (status) => node_fs_1.default.writeFileSync(record, `${JSON.stringify({ staging, output, backup, status }, null, 2)}\n`);
+    writeRecord('prepared');
+    // 仅在目标已存在时才需要 backup；首次构建无需多一次 rename。
+    if (node_fs_1.default.existsSync(output)) {
+        node_fs_1.default.renameSync(output, backup);
+    }
+    try {
+        node_fs_1.default.renameSync(staging, output);
+    }
+    catch (error) {
+        // 关键失败：把 backup 还原回 output，绝不删除 backup。
+        if (node_fs_1.default.existsSync(backup) && !node_fs_1.default.existsSync(output)) {
+            node_fs_1.default.renameSync(backup, output);
+        }
+        writeRecord('rolled-back');
+        throw error;
+    }
+    writeRecord('complete');
+}
+//# sourceMappingURL=output-safety.js.map

package/dist/output-safety.js.map

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

package/dist/project-config.d.ts

@@ -0,0 +1,72 @@
+import type { ElpisConfig, ElpisMode } from '@ynight/framework/server';
+/**
+ * 在项目根目录下解析并返回配置文件绝对路径。
+ *
+ * 优先匹配 `elpis.config.ts` / `.js` / `.cjs`；调用 `resolveProjectPath` 校验
+ * 路径安全性（不允许符号链接逃出根目录）。
+ *
+ * @throws 找不到任一候选文件或路径不安全时抛出。
+ */
+export declare function configFile(root: string): string;
+/**
+ * 加载并返回业务工程的 `ElpisConfig`。
+ *
+ * 处理流程：
+ * 1. 解析配置文件路径；若为 `.ts` 则注册 ts-node。
+ * 2. 清缓存（关键：配置变更后下次执行能拿到最新值）。
+ * 3. `require` 加载并解开 `default`。
+ * 4. 支持配置是函数：`function ({ mode }) => config`，便于按 dev/prod 区分配置。
+ *
+ * @throws 配置文件类型不是对象/工厂函数时抛出。
+ */
+export declare function loadProjectConfig(root: string, mode: ElpisMode): ElpisConfig;
+/**
+ * 将 CLI 命令行覆盖项合并到配置上。
+ *
+ * 仅当 `overrides.port` / `overrides.webPort` 实际传入时才覆盖，
+ * 这样配置文件本身的缺省值不会被 CLI 的 `undefined` 错误覆盖。
+ */
+export declare function mergeCliOverrides(config: ElpisConfig, overrides: {
+    port?: number;
+    webPort?: number;
+}): ElpisConfig;
+/**
+ * 加载"完整生效"的配置：依次合并 CLI 参数、配置文件、`resolveConfig` 默认值。
+ *
+ * 同时校验端口号范围（1-65535），避免无效端口拖到运行时才报错。
+ *
+ * @throws 端口不在合法范围内时抛出。
+ */
+export declare function loadEffectiveConfig(root: string, mode: ElpisMode, overrides?: {
+    port?: number;
+    webPort?: number;
+}): ElpisConfig;
+/**
+ * 解析并校验一个相对项目根目录的文件路径。
+ *
+ * 安全约束：
+ * - 必须落在项目根目录内（拒绝 `..` 逃逸）；
+ * - 路径上每一段都不能是符号链接（防止链接到根目录外）；
+ * - 最终目标必须是文件而非目录。
+ *
+ * @throws 不在根目录内、经过符号链接、目标不存在或不是文件时抛出。
+ */
+export declare function resolveProjectPath(root: string, configuredPath: string, label: string): string;
+/**
+ * 解析并校验服务端入口文件路径。
+ *
+ * 默认入口为 `./server/app.ts`（兼容 TypeScript 写法）。
+ */
+export declare function resolveServerEntry(root: string, config: ElpisConfig): string;
+/**
+ * 解析并校验客户端扩展入口路径；若未配置则返回 `undefined`。
+ */
+export declare function resolveClientExtensions(root: string, config: ElpisConfig): string | undefined;
+/**
+ * 把配置中指向 TypeScript 源文件的路径切换为编译后的 JavaScript 路径。
+ *
+ * 应用场景：CLI 编译后将 `.ts` / `.mts` / `.cts` 重命名为 `.js`，但运行时配置仍然
+ * 引用源文件路径——这里在运行时统一替换，避免每个业务模块自己处理扩展名。
+ */
+export declare function configForCompiledModules(config: ElpisConfig): ElpisConfig;
+//# sourceMappingURL=project-config.d.ts.map

package/dist/project-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../src/project-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAmCvE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU/C;AAgBD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,CAiB5E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,WAAW,CAWb;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,EACf,SAAS,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,WAAW,CAgBb;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAqB9F;AAcD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAG5E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAK7F;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAezE"}

package/dist/project-config.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configFile = configFile;
+exports.loadProjectConfig = loadProjectConfig;
+exports.mergeCliOverrides = mergeCliOverrides;
+exports.loadEffectiveConfig = loadEffectiveConfig;
+exports.resolveProjectPath = resolveProjectPath;
+exports.resolveServerEntry = resolveServerEntry;
+exports.resolveClientExtensions = resolveClientExtensions;
+exports.configForCompiledModules = configForCompiledModules;
+const tslib_1 = require("tslib");
+const node_fs_1 = tslib_1.__importDefault(require("node:fs"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const server_1 = require("@ynight/framework/server");
+/**
+ * 按优先级排列的配置文件名。
+ *
+ * 业务工程应使用 `.ts` 以享受类型提示；CLI 同时兼容 `.js` / `.cjs` 以便发布到 npm 的
+ * 预编译产物（如 `dist` 形式分发时）继续工作。
+ */
+const CONFIG_FILES = ['elpis.config.ts', 'elpis.config.js', 'elpis.config.cjs'];
+/**
+ * 注册 ts-node 以加载 TypeScript 形式的配置文件。
+ *
+ * `transpileOnly: true` 跳过类型检查——CLI 入口需要的是"读取配置"而非"完整类型校验"，
+ * 真正的类型校验在 `type-check` 子命令里通过 `tsc` 完成。
+ *
+ * @throws 当 `@ynight/cli` 没有把 ts-node 打包进来时给出可读的安装提示。
+ */
+function ensureTypeScriptRuntime(root) {
+    try {
+        // 优先使用业务工程独立的 `tsconfig.server.json`，否则回退到 `tsconfig.json`。
+        const projectConfig = node_fs_1.default.existsSync(node_path_1.default.resolve(root, 'tsconfig.server.json'))
+            ? node_path_1.default.resolve(root, 'tsconfig.server.json')
+            : node_path_1.default.resolve(root, 'tsconfig.json');
+        require('ts-node').register({ transpileOnly: true, project: projectConfig });
+    }
+    catch (error) {
+        throw new Error(`无法加载 TypeScript 配置，请确认 @ynight/cli 的 ts-node 依赖可用: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * 在项目根目录下解析并返回配置文件绝对路径。
+ *
+ * 优先匹配 `elpis.config.ts` / `.js` / `.cjs`；调用 `resolveProjectPath` 校验
+ * 路径安全性（不允许符号链接逃出根目录）。
+ *
+ * @throws 找不到任一候选文件或路径不安全时抛出。
+ */
+function configFile(root) {
+    const projectRoot = node_fs_1.default.realpathSync(root);
+    const file = CONFIG_FILES.map(name => node_path_1.default.resolve(projectRoot, name)).find(candidate => node_fs_1.default.existsSync(candidate));
+    if (!file) {
+        throw new Error(`未找到 elpis.config.ts、elpis.config.js 或 elpis.config.cjs: ${root}`);
+    }
+    resolveProjectPath(projectRoot, node_path_1.default.relative(projectRoot, file), '配置文件');
+    return file;
+}
+/**
+ * 提取 ES Module / CommonJS 混用场景下 `default` 导出。
+ *
+ * 业务工程可能写 `module.exports = { ... }`（CJS，无 default），
+ * 也可能写 `export default { ... }`（ESM，Node 看到 `{ default: ... }`）。
+ * 此函数统一暴露给上层的总是"实际配置对象"。
+ */
+function unwrapDefault(value) {
+    if (value && typeof value === 'object' && 'default' in value) {
+        return value.default;
+    }
+    return value;
+}
+/**
+ * 加载并返回业务工程的 `ElpisConfig`。
+ *
+ * 处理流程：
+ * 1. 解析配置文件路径；若为 `.ts` 则注册 ts-node。
+ * 2. 清缓存（关键：配置变更后下次执行能拿到最新值）。
+ * 3. `require` 加载并解开 `default`。
+ * 4. 支持配置是函数：`function ({ mode }) => config`，便于按 dev/prod 区分配置。
+ *
+ * @throws 配置文件类型不是对象/工厂函数时抛出。
+ */
+function loadProjectConfig(root, mode) {
+    const file = configFile(root);
+    if (file.endsWith('.ts')) {
+        ensureTypeScriptRuntime(root);
+    }
+    // 清缓存确保每次调用都读到磁盘最新版本。
+    delete require.cache[require.resolve(file)];
+    const loaded = unwrapDefault(require(file));
+    // 支持配置工厂：传入当前运行模式，便于做差异化配置。
+    const value = typeof loaded === 'function'
+        ? loaded({ mode })
+        : loaded;
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`配置文件必须导出对象或配置工厂: ${file}`);
+    }
+    return value;
+}
+/**
+ * 将 CLI 命令行覆盖项合并到配置上。
+ *
+ * 仅当 `overrides.port` / `overrides.webPort` 实际传入时才覆盖，
+ * 这样配置文件本身的缺省值不会被 CLI 的 `undefined` 错误覆盖。
+ */
+function mergeCliOverrides(config, overrides) {
+    return {
+        ...config,
+        // 注意：只在端口显式传入时才追加，避免把 `server` 整个替换为空对象。
+        ...(overrides.port === undefined
+            ? {}
+            : { server: { ...(config.server ?? {}), port: overrides.port } }),
+        ...(overrides.webPort === undefined
+            ? {}
+            : { dev: { ...(config.dev ?? {}), webPort: overrides.webPort } }),
+    };
+}
+/**
+ * 加载"完整生效"的配置：依次合并 CLI 参数、配置文件、`resolveConfig` 默认值。
+ *
+ * 同时校验端口号范围（1-65535），避免无效端口拖到运行时才报错。
+ *
+ * @throws 端口不在合法范围内时抛出。
+ */
+function loadEffectiveConfig(root, mode, overrides = {}) {
+    const config = mergeCliOverrides(
+    // resolveConfig 负责把 ElpisConfig 协议下的默认值补齐（例如 dev.webPort 默认 8000）。
+    (0, server_1.resolveConfig)(root, mode, loadProjectConfig(root, mode)).config, overrides);
+    // 端口号范围统一校验：CLI 入口已经校验一次，这里再校验配置文件中的端口。
+    for (const [label, port] of [
+        ['server.port', config.server?.port],
+        ['dev.webPort', config.dev?.webPort],
+    ]) {
+        if (port !== undefined && (!Number.isInteger(port) || port < 1 || port > 65535)) {
+            throw new Error(`${label} 必须是 1-65535 的整数`);
+        }
+    }
+    return config;
+}
+/**
+ * 解析并校验一个相对项目根目录的文件路径。
+ *
+ * 安全约束：
+ * - 必须落在项目根目录内（拒绝 `..` 逃逸）；
+ * - 路径上每一段都不能是符号链接（防止链接到根目录外）；
+ * - 最终目标必须是文件而非目录。
+ *
+ * @throws 不在根目录内、经过符号链接、目标不存在或不是文件时抛出。
+ */
+function resolveProjectPath(root, configuredPath, label) {
+    const projectRoot = node_fs_1.default.realpathSync(root);
+    const resolved = node_path_1.default.resolve(projectRoot, configuredPath);
+    if (!within(projectRoot, resolved)) {
+        throw new Error(`${label} 必须位于项目根目录内: ${resolved}`);
+    }
+    if (!node_fs_1.default.existsSync(resolved)) {
+        throw new Error(`${label} 不存在: ${resolved}`);
+    }
+    // 逐段检测符号链接：哪怕最终目标在根目录内，中途被替换到外部也是不安全的。
+    let current = projectRoot;
+    for (const part of node_path_1.default.relative(projectRoot, resolved).split(node_path_1.default.sep)) {
+        current = node_path_1.default.join(current, part);
+        if (node_fs_1.default.lstatSync(current).isSymbolicLink()) {
+            throw new Error(`${label} 不能通过符号链接: ${current}`);
+        }
+    }
+    if (!node_fs_1.default.statSync(resolved).isFile()) {
+        throw new Error(`${label} 必须是文件: ${resolved}`);
+    }
+    return resolved;
+}
+/**
+ * 局部 `within` 实现，与 `output-safety.ts` 同名函数逻辑一致。
+ * 这里重复一份是为了让 `resolveProjectPath` 单文件自包含，便于单元测试。
+ */
+function within(root, target) {
+    const relative = node_path_1.default.relative(root, target);
+    return (relative === '' ||
+        (relative !== '..' && !relative.startsWith(`..${node_path_1.default.sep}`) && !node_path_1.default.isAbsolute(relative)));
+}
+/**
+ * 解析并校验服务端入口文件路径。
+ *
+ * 默认入口为 `./server/app.ts`（兼容 TypeScript 写法）。
+ */
+function resolveServerEntry(root, config) {
+    const configured = config.server?.entry ?? './server/app.ts';
+    return resolveProjectPath(root, configured, 'server.entry');
+}
+/**
+ * 解析并校验客户端扩展入口路径；若未配置则返回 `undefined`。
+ */
+function resolveClientExtensions(root, config) {
+    const configured = config.client?.extensions;
+    return configured === undefined
+        ? undefined
+        : resolveProjectPath(root, configured, 'client.extensions');
+}
+/**
+ * 把配置中指向 TypeScript 源文件的路径切换为编译后的 JavaScript 路径。
+ *
+ * 应用场景：CLI 编译后将 `.ts` / `.mts` / `.cts` 重命名为 `.js`，但运行时配置仍然
+ * 引用源文件路径——这里在运行时统一替换，避免每个业务模块自己处理扩展名。
+ */
+function configForCompiledModules(config) {
+    const server = config.server ? { ...config.server } : undefined;
+    const model = config.model ? { ...config.model } : undefined;
+    if (server?.entry !== undefined) {
+        server.entry = server.entry.replace(/\.(?:tsx?|mts|cts)$/, '.js');
+    }
+    if (model?.controlContracts !== undefined) {
+        model.controlContracts = model.controlContracts.replace(/\.(?:tsx?|mts|cts)$/, '.js');
+    }
+    return {
+        ...config,
+        // 注意：仅在原本存在 server / model 时才覆盖，避免把整个对象设为 undefined。
+        ...(server ? { server } : {}),
+        ...(model ? { model } : {}),
+    };
+}
+//# sourceMappingURL=project-config.js.map

package/dist/project-config.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CLI 命令的通用选项。
+ *
+ * - `root`：业务工程根目录，所有相对路径都会基于此目录解析；未显式传入时取 `process.cwd()`。
+ * - `port`：后端 Koa 服务监听端口，仅 `dev` 命令使用，会被注入到 `ELPIS_PORT` 环境变量并覆盖配置。
+ * - `webPort`：前端 Webpack 开发服务（带 HMR）的端口，仅 `dev` 命令使用，注入 `ELPIS_WEB_DEV_PORT`。
+ * - `check`：仅用于 `generate:types` 子命令，表示只做"类型新鲜度校验"——若生成的 `.d.ts` 与当前扫描结果不一致则报错，但不写回文件。常用于 CI 阻断过期产物。
+ */
+export interface CliOptions {
+    /** 业务工程根目录（绝对路径或相对于当前工作目录）。 */
+    root: string;
+    /** 后端 HTTP 服务端口，覆盖配置文件中的 `server.port`。 */
+    port?: number;
+    /** 前端开发服务（HMR）端口，覆盖 `dev.webPort`。 */
+    webPort?: number;
+    /** `generate:types` 子命令专用开关，开启后仅校验、不写文件。 */
+    check?: boolean;
+}
+/**
+ * 解析后的命令行参数。
+ *
+ * `command` 为已识别的子命令名（dev / build / type-check / generate:types / help / version）；
+ * `options` 携带该命令对应的具体选项。
+ */
+export interface ParsedArgs {
+    command: string;
+    options: CliOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 递归遍历目录，收集所有 `.ts` / `.js` / `.cjs` 后缀的源文件（自动跳过 `.d.ts`）。
+ *
+ * 设计要点：
+ * - 不跟随符号链接（依赖 `fs.readdirSync` 的默认行为）。
+ * - 跳过 `.d.ts` 以免类型声明文件被当作业务模块纳入生成逻辑。
+ * - 字典序排序保证跨平台稳定的输出顺序，方便 `generate:types` 做差分校验。
+ *
+ * @param root 起始目录；若不存在则直接返回空数组。
+ * @returns 收集到的所有源文件的绝对路径。
+ */
+export declare function findFiles(root: string): string[];
+/**
+ * 判断指定目录下是否存在匹配给定扩展名的源文件。
+ *
+ * 用于在执行 vue-tsc 等耗时工具前快速判断是否有必要调用：
+ * 零扩展项目的空目录是合法的，应当跳过校验。
+ *
+ * 跳过 `node_modules` 与 `dist`，避免扫描外部依赖或历史构建产物。
+ *
+ * @param root 待扫描目录；不存在时返回 `false`。
+ * @param extensions 需要匹配的扩展名列表（如 `['.vue']`）。
+ */
+export declare function hasSourceFiles(root: string, extensions: string[]): boolean;
+/**
+ * 将 kebab-case / snake_case 命名转换为 camelCase。
+ *
+ * 例：`user-profile` → `userProfile`、`api_client` → `apiClient`。
+ *
+ * 用于把文件名映射为生成类型对象的属性名（参见 `generate-types.ts`）。
+ */
+export declare function camelCase(value: string): string;
+/**
+ * 同步执行一个 Node 脚本，失败时抛出错误（用于把控制权交回调用方）。
+ *
+ * 与 `runTsc` 的区别：此函数面向任意 Node 脚本；后者针对 `tsc` 提供了更友好的报错文案。
+ *
+ * @param script 脚本绝对路径（通常是 `require.resolve` 的产物）。
+ * @param args 透传给脚本的命令行参数。
+ * @param cwd 子进程工作目录。
+ */
+export declare function runNodeScript(script: string, args: string[], cwd: string): void;
+/**
+ * 解析当前 `node_modules/typescript` 中的 `tsc` 入口绝对路径。
+ *
+ * 不直接硬编码路径，使得业务工程即便使用了不同版本的 TypeScript 也能正确执行。
+ */
+export declare function resolveTsc(): string;
+/**
+ * 解析 `vue-tsc` 入口绝对路径，与 `resolveTsc` 同一思路。
+ */
+export declare function resolveVueTsc(): string;
+/**
+ * 调用 `tsc` 同步执行 TypeScript 编译/检查。
+ *
+ * 失败时抛出包含退出码的错误，便于上层统一报告；不接管 stdin/stdout，
+ * 让 `tsc` 直接打印到父进程终端，保留原始诊断信息。
+ *
+ * @param root 工作目录。
+ * @param config tsconfig 路径（绝对路径）。
+ * @param extraArgs 透传给 `tsc` 的额外参数，例如 `['--noEmit']` 或 `['--outDir', dir]`。
+ */
+export declare function runTsc(root: string, config: string, extraArgs?: string[]): void;
+/**
+ * 调用 `vue-tsc` 同步执行 Vue SFC 的 TypeScript 检查。
+ *
+ * 通过 `--noEmit` 避免产出 `.d.ts`，仅做类型检查。
+ * 与 `runTsc` 错误处理逻辑保持一致。
+ *
+ * @param root 工作目录。
+ * @param config tsconfig 路径（通常是 `tsconfig.client.json`）。
+ */
+export declare function runVueTsc(root: string, config: string): void;
+/**
+ * 递归复制整个目录到目标位置。
+ *
+ * 使用 `fs.cpSync` 的 `recursive` 选项，等价于 `cp -r` 语义。
+ * 若源目录不存在则视为无操作（避免业务工程未提供 `public/` 时报错）。
+ *
+ * @param source 源目录绝对路径。
+ * @param destination 目标目录绝对路径。
+ */
+export declare function copyDirectory(source: string, destination: string): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAe1E;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAQ/E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,IAAI,CAWnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAW5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAKvE"}