@lark-apaas/miaoda-cli 0.1.45 → 0.1.47

package/dist/cli/handlers/deploy/get.js

@@ -41,16 +41,28 @@ const error_1 = require("../../../utils/error");
 const index_1 = require("../../../api/deploy/index");
 const helpers_1 = require("./helpers");
 const format_1 = require("./format");
+const polling_1 = require("./polling");
+const deploy_1 = require("./deploy");
 /**
  * 单页拉取上限：BAM listPipelineInstances 限制 1~500，取 500 让 deploy get
  * 在最近 500 条记录里按 ID 命中。
  */
 const DEPLOY_GET_LOOKUP_LIMIT = 500;
+/**
+ * 可能挂着审批单的状态：审批中、审批被拒，以及卡点异常（平台没能发起审批，顶层表现为 FAILED）。
+ * 只有这些状态才额外查详情取审批单，其余状态保持单次列表请求。
+ */
+const APPROVAL_LOOKUP_STATUSES = [
+    index_1.NodeStatus.PENDING,
+    index_1.NodeStatus.REJECTED,
+    index_1.NodeStatus.FAILED,
+];
 /**
  * miaoda deploy get <deploy-id>
  *
  * BAM 没有 by-ID 的查询接口，复用 listPipelineInstances 在最近窗口里按 ID 筛一条。
  * 命中失败时抛 DEPLOY_NOT_FOUND，提示用户用 history 查窗口。
+ * status 为 pending / rejected / failed 时额外查详情，有审批单则输出 approval（审批链接、拒绝原因等）。
  */
 async function handleDeployGet(opts) {
     if (!opts.deployId)
@@ -67,5 +79,33 @@ async function handleDeployGet(opts) {
             next_actions: ['运行 `miaoda deploy history` 确认 deploy-id 是否在最近窗口内'],
         });
     }
-    (0, output_1.emit)({ data: (0, format_1.formatSimpleInstance)(instance), next_cursor: null, has_more: false }, index_1.deployGetSchema);
+    const approval = APPROVAL_LOOKUP_STATUSES.includes(instance.status)
+        ? await lookupApproval(appID, opts.deployId, instance.status)
+        : undefined;
+    (0, output_1.emit)({
+        data: { ...(0, format_1.formatSimpleInstance)(instance), ...(approval && { approval }) },
+        next_cursor: null,
+        has_more: false,
+    }, index_1.deployGetSchema);
+    if (!(0, output_1.isJsonMode)())
+        (0, deploy_1.writeApprovalNotice)(instance.status, approval, opts.deployId);
+}
+/**
+ * 列表项不含审批信息：按同一个 ID 查详情接口（审批展示视图）取审批单。
+ *
+ * pending / rejected 时详情失败直接抛错：丢掉审批链接 / 拒绝原因却无人察觉，比报错更糟。
+ * failed 时降级为只输出列表数据并在 stderr 提示：普通构建失败远多于卡点异常，不能因为详情接口
+ * 出错就让调用方连 status 都拿不到，卡住失败排查。
+ */
+async function lookupApproval(appID, deployId, status) {
+    try {
+        return (0, index_1.findApproval)((0, polling_1.normalizePipelineInstance)(await api.deploy.queryPipelineInstance({ appID, instanceID: deployId })));
+    }
+    catch (err) {
+        if (status !== index_1.NodeStatus.FAILED)
+            throw err;
+        const reason = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`warning: 查询审批单失败，输出不含 approval：${reason}\n`);
+        return undefined;
+    }
 }

package/dist/cli/handlers/deploy/helpers.js

@@ -3,18 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseStatusFlag = parseStatusFlag;
 exports.validateLimit = validateLimit;
 exports.parseDeployId = parseDeployId;
+exports.validateApplyReason = validateApplyReason;
 const args_1 = require("../../../utils/args");
 const index_1 = require("../../../api/deploy/index");
 /**
  * 把 CLI --status 字符串映射成 BAM NodeStatus 数字；非法值抛 ARGS_INVALID。
  *
  * 历史接口（CliListPipelineInstances）返回 SimpleInstance，状态语义是 pipeline 节点状态，
- * 取值 todo / running / success / failed / canceled / hold_on。
+ * 取值 todo / running / success / failed / canceled / rejected / pending / skipped / hold_on（已废弃）。
  */
 function parseStatusFlag(text) {
     const value = (0, index_1.nodeStatusFromText)(text);
     if (value === undefined) {
-        (0, args_1.failArgs)(`--status 无效：'${text}'。可选值：todo | running | success | failed | canceled | hold_on`);
+        (0, args_1.failArgs)(`--status 无效：'${text}'。可选值：todo | running | success | failed | canceled | rejected | pending | skipped | hold_on`);
     }
     return value;
 }
@@ -39,3 +40,29 @@ function parseDeployId(text) {
     }
     return n;
 }
+/** 发布理由上限，按 Unicode code point 计，对齐 lark-cli `apps +release-create` */
+const MAX_APPLY_REASON_CODE_POINTS = 1000;
+/** C0 / C1 控制字符（含换行、制表符） */
+const CONTROL_CHARS = /\p{Cc}/u;
+/**
+ * 不可见格式字符（零宽、BOM、双向控制、词连接符等）与行/段分隔符：肉眼不可见，却会改变审批单里的展示。
+ * 与 deploy 输出服务端文本时的过滤口径一致。
+ */
+const INVISIBLE_CHARS = /[\p{Cf}\u2028\u2029]/u;
+/**
+ * 校验 --apply-reason 的格式；通过后调用方原样透传，不 trim。
+ * 是否必填由服务端按应用类型判定，这里不管。
+ */
+function validateApplyReason(value) {
+    if (value.trim() === '')
+        (0, args_1.failArgs)('--apply-reason 不能为空');
+    if (CONTROL_CHARS.test(value)) {
+        (0, args_1.failArgs)('--apply-reason 不能包含换行、制表符等控制字符，需为单行文本');
+    }
+    if (INVISIBLE_CHARS.test(value)) {
+        (0, args_1.failArgs)('--apply-reason 不能包含零宽字符、双向控制字符或行/段分隔符');
+    }
+    if (Array.from(value).length > MAX_APPLY_REASON_CODE_POINTS) {
+        (0, args_1.failArgs)(`--apply-reason 最多 ${String(MAX_APPLY_REASON_CODE_POINTS)} 个字符`);
+    }
+}

package/dist/cli/handlers/deploy/polling.js

@@ -38,6 +38,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_POLL_INTERVAL_MS = void 0;
 exports.waitForPipeline = waitForPipeline;
+exports.normalizePipelineInstance = normalizePipelineInstance;
 const ora_1 = __importDefault(require("ora"));
 const api = __importStar(require("../../../api/index"));
 const error_1 = require("../../../utils/error");
@@ -45,16 +46,11 @@ const output_1 = require("../../../utils/output");
 const index_1 = require("../../../api/deploy/index");
 /** 默认轮询间隔（毫秒） */
 exports.DEFAULT_POLL_INTERVAL_MS = 2_000;
-const TERMINAL_STATUSES = [
-    index_1.NodeStatus.SUCCESS,
-    index_1.NodeStatus.FAILED,
-    index_1.NodeStatus.CANCELED,
-];
 function defaultSleep(ms) {
     return new Promise((res) => setTimeout(res, ms));
 }
 /**
- * 轮询 pipeline 状态直到终态或超时。
+ * 轮询 pipeline 状态直到终态、进入人工审批或超时。
  *
  * - JSON 模式：轮询期间静默；终态后由 caller 输出最终信封。
  * - Pretty 非 TTY：同 JSON。
@@ -85,7 +81,11 @@ async function waitForPipeline(opts) {
             const detail = normalizePipelineInstance(resp);
             if (spinner)
                 advanceProgress(detail, printedStages, spinner);
-            if (TERMINAL_STATUSES.includes(detail.status)) {
+            if (index_1.TERMINAL_NODE_STATUSES.includes(detail.status)) {
+                return detail;
+            }
+            // 等待人工审批（顶层 PENDING）：可能持续数小时，立即交还给调用方，不再轮询到超时
+            if (detail.status === index_1.NodeStatus.PENDING) {
                 return detail;
             }
             if (now() - start >= timeoutMs) {
@@ -113,7 +113,7 @@ function advanceProgress(detail, printed, spinner) {
     for (const stage of stages) {
         if (printed.has(stage.id))
             continue;
-        if (!TERMINAL_STATUSES.includes(stage.status))
+        if (!index_1.TERMINAL_NODE_STATUSES.includes(stage.status))
             continue;
         spinner.stopAndPersist({
             symbol: stageSymbol(stage),
@@ -153,7 +153,11 @@ function isPipelineInstance(value) {
     return typeof item.status === 'number';
 }
 function stageSymbol(stage) {
-    return stage.status === index_1.NodeStatus.SUCCESS ? '✓' : stage.status === index_1.NodeStatus.FAILED ? '✗' : '•';
+    if (stage.status === index_1.NodeStatus.SUCCESS)
+        return '✓';
+    if (stage.status === index_1.NodeStatus.FAILED || stage.status === index_1.NodeStatus.REJECTED)
+        return '✗';
+    return '•';
 }
 function formatStageBody(stage) {
     const cost = stage.costTime >= 0 ? `(${(stage.costTime / 1000).toFixed(1)}s)` : '';

package/dist/config/fullstack-managed-files.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * nestjs-react-fullstack 工程里**明确由平台托管**的文件清单 —— sync 与 migrate 共用的 SSOT。
+ *
+ * 所有权用"本次会触及的明确清单"表达（不做通用三方合并、不补全量历史模板基线）：
+ *   - 清单内文件：按兼容模板版本整文件更新（同名覆盖）。
+ *   - 清单外文件：一律视为用户所有。scripts/ 下用户自建的 report.js 等额外文件不删除、不覆盖。
+ *
+ * 清单取自本仓 upgrade/templates/nestjs-react-fullstack/templates 下的 scripts/ 与 .githooks/。
+ * test/config/fullstack-managed-files 会校验 upgrade 模板目录与本清单一一对应 —— 模板新增托管脚本
+ * 必须同步加到这里，否则 CI 失败。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FULLSTACK_MANAGED_BUILD_DEV_DEPENDENCIES = exports.FULLSTACK_MANAGED_FILES = exports.FULLSTACK_MANAGED_HOOK_FILES = exports.FULLSTACK_MANAGED_SCRIPT_FILES = void 0;
+exports.managedFileRules = managedFileRules;
+exports.managedBuildDependencyRules = managedBuildDependencyRules;
+/** 平台托管的脚本（相对项目根） */
+exports.FULLSTACK_MANAGED_SCRIPT_FILES = [
+    'scripts/dev.sh',
+    'scripts/dev.js',
+    'scripts/dev-local.js',
+    'scripts/build.sh',
+    'scripts/run.sh',
+    'scripts/lint.js',
+    'scripts/prune-smart.js',
+    'scripts/hooks/run-precommit.js',
+];
+/** 平台托管的 git hook 入口（相对项目根） */
+exports.FULLSTACK_MANAGED_HOOK_FILES = ['.githooks/pre-commit'];
+/** 全部托管文件 */
+exports.FULLSTACK_MANAGED_FILES = [
+    ...exports.FULLSTACK_MANAGED_SCRIPT_FILES,
+    ...exports.FULLSTACK_MANAGED_HOOK_FILES,
+];
+/**
+ * 把托管清单展开成逐文件的 `file` 规则（overwrite=true）。
+ *
+ * 不用 `directory` 规则：directory 会把模板目录里**任何**文件都当托管文件同步过去，清单边界
+ * 由模板目录内容隐式决定；逐文件展开让"哪些文件归平台"显式可审。源文件缺失时规则返回
+ * skipped（模板与清单漂移由测试兜底）。
+ */
+function managedFileRules() {
+    return exports.FULLSTACK_MANAGED_FILES.map((file) => ({
+        type: 'file',
+        from: file,
+        to: file,
+        overwrite: true,
+    }));
+}
+/**
+ * 托管构建脚本的配套依赖：build.sh 的智能裁剪（prune-smart.js）require('@vercel/nft')，模板与
+ * 沙箱镜像都不提供它。迁移后的工程第一次完整构建（发布或本地 npm run build）会用到，所以
+ * migrate / repair 对未声明的工程补 devDependencies（版本为实测的 0.30.4）；已声明的用户版本
+ * 不降级、不覆盖。
+ */
+exports.FULLSTACK_MANAGED_BUILD_DEV_DEPENDENCIES = {
+    '@vercel/nft': '0.30.4',
+};
+/** 把托管构建依赖展开成 `ensure-dependency` 规则（缺失才补，已声明保持用户版本）。 */
+function managedBuildDependencyRules() {
+    return Object.entries(exports.FULLSTACK_MANAGED_BUILD_DEV_DEPENDENCIES).map(([name, version]) => ({
+        type: 'ensure-dependency',
+        name,
+        version,
+        section: 'devDependencies',
+    }));
+}

package/dist/config/migrate-configs/html-to-design-html.js

@@ -19,7 +19,7 @@
  *   - 不从 design-html template 拷任何文件（模板本身只有 _gitignore + package.json；
  *     用户已有的 .gitignore 是 html 版超集，保留无害）
  *   - 不动 README.md / .npmrc / .env —— 部署时均被 EXCLUDES 过滤
- *   - 不管 dev 进程 / MIAODA_APP_TYPE 切换（平台职责；沙箱 pkill 匹配的
+ *   - 不管 dev 进程 / MIAODA_APP_TYPE 切换（平台职责；沙箱重启信号匹配的
  *     scripts/dev.js 在 html 项目里不存在，自然跳过）
  *
  * handler 收尾的 npm install 照常跑：devserver 依赖删掉后重新生成精简 lockfile，

package/dist/config/migrate-configs/index.js

@@ -16,6 +16,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMigrateConfig = getMigrateConfig;
+exports.getRepairConfig = getRepairConfig;
 exports.listSupportedMigrations = listSupportedMigrations;
 const vite_react_to_nestjs_react_fullstack_1 = __importDefault(require("./vite-react-to-nestjs-react-fullstack"));
 const html_to_design_html_1 = __importDefault(require("./html-to-design-html"));
@@ -28,6 +29,14 @@ const MIGRATE_REGISTRY = {
 function getMigrateConfig(from, to) {
     return MIGRATE_REGISTRY[`${from}:${to}`] ?? null;
 }
+/**
+ * 磁盘已是目标 stack 时（同目标重试、历史恢复后平台已新、旧版 CLI 半完成样本）用于 repair 的
+ * 配置：取第一条以 stack 为目标的迁移配置。规则本身对已转换工程幂等（源目录不存在即跳过、
+ * 定向适配已对齐即 noop），配合 repair 模式跳过 migrateOnly 规则。
+ */
+function getRepairConfig(stack) {
+    return Object.values(MIGRATE_REGISTRY).find((c) => c.to === stack) ?? null;
+}
 /** 列出已支持的迁移路径，给 handler / 命令 help 用 */
 function listSupportedMigrations() {
     return Object.keys(MIGRATE_REGISTRY).map((key) => {