@lark-apaas/miaoda-cli 0.1.39-alpha.7cb46f9 → 0.1.39-alpha.8b4b278
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -0
- package/dist/api/deploy/api.js +3 -1
- package/dist/api/deploy/approval.js +1 -1
- package/dist/cli/commands/app/index.js +59 -14
- package/dist/cli/commands/deploy/index.js +1 -0
- package/dist/cli/handlers/app/init.js +67 -2
- package/dist/cli/handlers/app/migrate.js +105 -216
- package/dist/cli/handlers/app/sync.js +37 -3
- package/dist/cli/handlers/deploy/deploy.js +22 -11
- package/dist/cli/handlers/deploy/get.js +41 -1
- package/dist/cli/handlers/deploy/helpers.js +9 -16
- package/dist/cli/handlers/deploy/polling.js +1 -0
- package/dist/config/fullstack-managed-files.js +66 -0
- package/dist/config/migrate-configs/index.js +9 -0
- package/dist/config/migrate-configs/vite-react-to-nestjs-react-fullstack.js +176 -197
- package/dist/config/sync-configs/design-stack.js +3 -4
- package/dist/config/sync-configs/nestjs-react-fullstack.js +11 -23
- package/dist/services/app/init/async-install.js +21 -0
- package/dist/services/app/init/index.js +3 -1
- package/dist/services/app/init/workspace-check.js +105 -0
- package/dist/services/app/migrate/detect.js +34 -0
- package/dist/services/app/migrate/index.js +8 -0
- package/dist/services/app/migrate/run.js +502 -0
- package/dist/services/app/migrate/symlinks.js +146 -0
- package/dist/utils/engineering-state.js +52 -0
- package/dist/utils/migrate-adapters.js +513 -0
- package/dist/utils/migrate-rule.js +508 -26
- package/dist/utils/project-snapshot.js +99 -0
- package/dist/utils/spark-meta.js +31 -10
- package/dist/utils/sync-rule.js +80 -11
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -52,6 +52,20 @@ miaoda file ls --output json
|
|
|
52
52
|
|
|
53
53
|
完整命令通过 `miaoda --help` 或 `miaoda <domain> --help` 查看。
|
|
54
54
|
|
|
55
|
+
## 工程初始化、同步与转换
|
|
56
|
+
|
|
57
|
+
`miaoda app init / sync / migrate` 管理本地应用工程(平台调用方与本地开发共用):
|
|
58
|
+
|
|
59
|
+
- `init`:按 `--template` 或 `--app-type` 渲染模板(`full_stack → nestjs-react-fullstack`,`frontend / jspage → vite-react`)。工程已存在时不重新渲染、不覆盖业务代码,只输出就绪核验结果 `ready / problems`;`--strict` 下未就绪(meta 损坏、stack 不符、必要文件缺失、依赖未安装、上次操作失败)退出码 1。同步安装失败输出 `status=failed` 并退出码 1。
|
|
60
|
+
- `sync`:按 stack 的同步规则更新平台托管内容。全栈工程的托管文件是明确清单(`scripts/dev.sh`、`dev.js`、`dev-local.js`、`build.sh`、`run.sh`、`lint.js`、`prune-smart.js`、`hooks/run-precommit.js` 与 `.githooks/pre-commit`),`scripts/` 下其他用户文件保留;连续执行无漂移。依赖安装失败输出 `status=failed` 并退出码 1。
|
|
61
|
+
- `migrate`(不在 help 列表中展示):工程转换原语,在原工程目录内执行。目标模板先渲染到临时模板目录(不复制用户工程),再只读预检冲突:同路径不同内容、重复插件 ID、无法确定的 package.json / tsconfig / vite.config / index.html 形态等返回 `status=conflict` 与具体路径,工程不写入。预检通过后在原目录定向转换(`src/ public/ → client/`、插件迁 `server/capabilities`、配置定向适配),执行中出现的冲突即停、不覆盖用户不同内容;随后在原目录安装依赖并完整构建(`npm run build`)。任一阶段失败退出码 1,`failure.stage` 给出 `install` / `verify` 等阶段,现场保留、不自动回滚;`originalIntact=true` 仅表示失败发生在任何工程写入之前,写入后一律为 false(已写入文件见 `changes`)。磁盘已是目标布局时走 repair(补齐适配 / 安装 / 构建,保留已有 `node_modules` 接续安装),不返回 NOOP;meta 已是目标 stack 不代表上次成功,以 `.spark/local/engineering-state.json` 的终态为准。放弃转换由调用方按代码版本恢复。输出包含源 / 目标 stack、模板与 CLI 版本、真实阶段结果与冲突路径;运行 readiness 由调用方核验(`readiness.status=pending_caller_verification`),`restartSignalSent` 只表示发出了重启信号。执行期间的并发编辑由调用方现有互斥与调度保证。
|
|
62
|
+
|
|
63
|
+
`migrate` 不自动解引用工程外文件。迁移涉及的文件或父目录存在符号链接时,在规则执行前返回 `MIGRATE_UNSAFE_SYMLINK` 和具体 `conflicts[].path`;请改为工程拥有的普通文件或目录后重试。`html → design-html` 的 `src → .` 涉及整个工程根目录。原目录 install/build 前拒绝绝对链接、工程外链接、无法解析的链接及指向排除目录的链接;未触及且在工程内解析的相对业务链接保留,安装生成的普通 `node_modules/.bin` 相对链接允许。规则执行后、安装后及构建前再次检查链接边界。扫描失败返回 `MIGRATE_SYMLINK_CHECK_FAILED`;失败或链接冲突在安全的 `.spark/local` 写入终态,状态写路径不安全时不写入并给出 warning。该检查不是 npm 脚本的安全沙箱,不限制脚本主动访问其他绝对路径。
|
|
64
|
+
|
|
65
|
+
临时模板目录清理失败只加入 `warnings`(`path`、系统错误 `code`、`message`),不影响 `status`。
|
|
66
|
+
|
|
67
|
+
全栈 / design-stack 的 `postinstall` 只升级完整历史平台值(`fullstack-cli action-plugin init` 或 `npx -y @lark-apaas/fullstack-cli action-plugin init`),目标为 `npx -y @lark-apaas/fullstack-cli@latest action-plugin init`;`latest` 是渠道,不是固定版本。带追加命令、参数或用户指定版本的值保留。`migrate` 在原目录执行正常 npm 安装生命周期,包括用户脚本及依赖补丁;生命周期失败即 `install` 阶段失败,保留现场。
|
|
68
|
+
|
|
55
69
|
## 全栈应用的 MCP UI 检查
|
|
56
70
|
|
|
57
71
|
创建 MCP UI 时,Agent 在 `server/mcp/ui` 中同时生成 `tsconfig.json` 和 `eslint.config.cjs`,修改 UI 或其 shared 依赖后主动运行独立检查。模板和 CLI 不生成 UI 配置,也不将 UI 检查接入主工程 lint/type:check。
|
|
@@ -122,6 +136,7 @@ miaoda registry add deck-slide --overwrite # 目标已存在时覆盖(
|
|
|
122
136
|
## 环境变量
|
|
123
137
|
|
|
124
138
|
- `MIAODA_APP_ID`:默认应用 ID,等价于 `--app-id`。
|
|
139
|
+
- `MIAODA_MIGRATE_STEP_TIMEOUT_MS`:`app migrate` 单个依赖安装 / 构建步骤的超时(毫秒),默认 20 分钟。
|
|
125
140
|
- `MIAODA_CANARY_HEADER`:HTTP 请求的 `x-tt-env` 小流量头取值。未设置时默认 `boe_miaoda_ccm`;设为空字符串则不带该头(例:`export MIAODA_CANARY_HEADER=boe_xxx`)。值形如 `ppe_xxx` 时额外带上 `x-use-ppe: 1`。
|
|
126
141
|
|
|
127
142
|
## 输出契约
|
package/dist/api/deploy/api.js
CHANGED
|
@@ -50,9 +50,11 @@ async function getErrorLog(req) {
|
|
|
50
50
|
* GET /v1/pipeline/app/:appID/instance/:instanceID/detail — 轮询发布状态
|
|
51
51
|
*
|
|
52
52
|
* 走 lark.apaas.devops_platform PSM;URL 前缀不同但共用同一管理端 gateway。
|
|
53
|
+
* 显式带 withTransformApprovalData=true 取审批展示视图(job 上挂 approval);IDL 默认 false,
|
|
54
|
+
* 不带时拿不到审批链接与拒绝原因。该参数只改返回投影,无副作用。
|
|
53
55
|
*/
|
|
54
56
|
async function queryPipelineInstance(req) {
|
|
55
|
-
const url = `/v1/pipeline/app/${encodeURIComponent(req.appID)}/instance/${encodeURIComponent(req.instanceID)}/detail`;
|
|
57
|
+
const url = `/v1/pipeline/app/${encodeURIComponent(req.appID)}/instance/${encodeURIComponent(req.instanceID)}/detail?withTransformApprovalData=true`;
|
|
56
58
|
return (0, http_1.getInnerApi)(url, {
|
|
57
59
|
errPrefix: 'Failed to query pipeline',
|
|
58
60
|
defaultErrCode: DEFAULT_ERR_CODE,
|
|
@@ -49,7 +49,7 @@ function* jobsOf(stages) {
|
|
|
49
49
|
}
|
|
50
50
|
}
|
|
51
51
|
/**
|
|
52
|
-
* 从 CliQueryPipelineInstance 的 PipelineInstance
|
|
52
|
+
* 从 CliQueryPipelineInstance 的 PipelineInstance(请求带 withTransformApprovalData=true,返回审批展示视图)中摘出需要输出的卡点:
|
|
53
53
|
* 第一个 status 为 PENDING / REJECTED / FAILED 的 Job.approval。一次发布可以被拦多次
|
|
54
54
|
* (build / db_check / deploy),已通过的卡点可能排在前面,不能取它;流水线串行,需要输出的至多一个。
|
|
55
55
|
* 与妙搭发布面板 findApprovalJob 同一口径。
|
|
@@ -40,24 +40,51 @@ function registerAppMigrate(parent) {
|
|
|
40
40
|
// 用 addCommand(cmd, { hidden: true }) 而非 parent.command(...),因为 commander 13
|
|
41
41
|
// 的 fluent `.command()` 不支持设置 hidden。
|
|
42
42
|
const cmd = new commander_1.Command('migrate')
|
|
43
|
-
.description('
|
|
43
|
+
.description('工程转换原语:原目录内按 MigrateConfig 预检冲突 → 定向转换 → 安装 → 严格验证;冲突不覆盖用户内容,失败保留现场')
|
|
44
44
|
.requiredOption('--to <stack>', '目标 stack 短名')
|
|
45
|
-
.option('--from <stack>', '源 stack
|
|
46
|
-
.option('--dir <path>', '项目目录,默认 cwd
|
|
45
|
+
.option('--from <stack>', '源 stack;默认按磁盘实际布局识别(识别不了再读 .spark/meta.json)')
|
|
46
|
+
.option('--dir <path>', '项目目录,默认 cwd')
|
|
47
|
+
.option('--purpose <purpose>', '调用目的:manual / upgrade / copy_adapt / history_restore(只用于记录与关联)', 'manual')
|
|
48
|
+
.option('--operation-ref <id>', '调用方已有的操作 / 任务关联标识,原样回显')
|
|
49
|
+
.addOption((0, shared_1.appIdOption)())
|
|
47
50
|
.addHelpText('after', `
|
|
48
51
|
已支持的迁移路径
|
|
49
52
|
${supportedDesc || '(none)'}
|
|
53
|
+
磁盘已是目标布局(同目标)时走 repair:补齐适配 / 安装 / 构建,不返回 NOOP。
|
|
54
|
+
|
|
55
|
+
文件规则
|
|
56
|
+
明确托管的平台脚本(scripts 清单 + .githooks/pre-commit)按模板更新,scripts/ 下用户文件保留;
|
|
57
|
+
src/ public/ 搬入 client/、插件迁 server/capabilities,同路径不同内容或重复插件 ID → 冲突;
|
|
58
|
+
server / shared 只补平台缺失文件,app.module.ts 定向注册平台模块;package.json scripts、
|
|
59
|
+
tsconfig、vite.config、index.html 定向适配,无法确定的形态 → 冲突,不整文件覆盖。
|
|
60
|
+
|
|
61
|
+
结果语义
|
|
62
|
+
status=converted 原目录内文件适配、依赖安装、严格验证(全栈为完整构建)全部完成;
|
|
63
|
+
运行 readiness 由调用方核验(readiness.status=pending_caller_verification),
|
|
64
|
+
restartSignalSent / devRestarted 只表示发出了重启信号
|
|
65
|
+
status=conflict conflicts 给出具体路径 / ID,冲突文件不覆盖
|
|
66
|
+
status=failed failure.stage / failure.code 给出失败阶段与原因,现场保留、不自动回滚
|
|
67
|
+
originalIntact=true 仅表示失败发生在任何工程写入之前;写入后为 false(部分改动见 changes)。
|
|
68
|
+
失败后对同一工程重跑同目标 migrate 即按真实布局 repair(可接续安装 / 构建)。
|
|
69
|
+
非 converted 退出码为 1。
|
|
50
70
|
|
|
51
71
|
JSON 输出
|
|
52
|
-
{"data": {"
|
|
53
|
-
"
|
|
54
|
-
"
|
|
55
|
-
"
|
|
56
|
-
"
|
|
72
|
+
{"data": {"status": "converted|conflict|failed", "mode": "migrate|repair", "runId": "...",
|
|
73
|
+
"purpose": "...", "operationRef": "...",
|
|
74
|
+
"source": {"metaStack": "...", "detectedStack": "...", "stack": "..."},
|
|
75
|
+
"target": {"stack": "...", "templatePackage": "...", "templateVersion": "...", "cliVersion": "..."},
|
|
76
|
+
"stages": [{"name": "preflight|render|precheck|apply|install|verify|restart", "status": "...", "durationMs": 0}],
|
|
77
|
+
"failure": {"stage": "...", "code": "...", "message": "...", "retryable": true},
|
|
78
|
+
"conflicts": [{"path": "...", "reason": "...", "with": "...", "id": "..."}],
|
|
79
|
+
"changes": {"added": [...], "modified": [...], "deleted": [...]},
|
|
80
|
+
"install": {"status": "ok|failed|not_run"}, "verify": {"status": "...", "steps": [...]},
|
|
81
|
+
"originalIntact": true,
|
|
82
|
+
"restartSignalSent": false, "readiness": {"status": "...", "detail": "..."},
|
|
83
|
+
"appliedRules": [...], "nextActions": [...]}}
|
|
57
84
|
|
|
58
85
|
示例
|
|
59
86
|
$ miaoda app migrate --to nestjs-react-fullstack
|
|
60
|
-
$ miaoda app migrate --
|
|
87
|
+
$ miaoda app migrate --to nestjs-react-fullstack --purpose upgrade --operation-ref op_demo_xxx
|
|
61
88
|
$ miaoda app migrate --to nestjs-react-fullstack --dir /path/to/app
|
|
62
89
|
`);
|
|
63
90
|
cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
|
|
@@ -65,6 +92,9 @@ JSON 输出
|
|
|
65
92
|
dir: rawOpts.dir,
|
|
66
93
|
from: rawOpts.from,
|
|
67
94
|
to: rawOpts.to,
|
|
95
|
+
appId: rawOpts.appId,
|
|
96
|
+
purpose: rawOpts.purpose,
|
|
97
|
+
operationRef: rawOpts.operationRef,
|
|
68
98
|
});
|
|
69
99
|
}));
|
|
70
100
|
parent.addCommand(cmd, { hidden: true });
|
|
@@ -97,12 +127,18 @@ function registerAppSync(parent) {
|
|
|
97
127
|
4. npm install --no-audit --no-fund --ignore-scripts。--ignore-scripts 是为绕开
|
|
98
128
|
action-plugin postinstall 在 npm install 时缺平台 env 的卡点(需要时再
|
|
99
129
|
FORCE_AUTHN_INNERAPI_DOMAIN=... npm install 手动跑一次)。
|
|
130
|
+
安装是必要步骤:失败时输出 status=failed、failedStage=install 与 installError,退出码 1
|
|
131
|
+
(已应用的文件规则保留,重跑 sync 幂等补齐)。
|
|
132
|
+
|
|
133
|
+
nestjs-react-fullstack 的平台托管文件是明确清单(scripts/dev.sh、dev.js、dev-local.js、
|
|
134
|
+
build.sh、run.sh、lint.js、prune-smart.js、hooks/run-precommit.js 与 .githooks/pre-commit),
|
|
135
|
+
同名更新;scripts/ 下其他用户文件保留。内容未变化的规则报 noop,连续 sync 不产生漂移。
|
|
100
136
|
|
|
101
137
|
stack 未纳入 sync 范围(无 SyncConfig 且无 upgrade/templates/<stack>/,如 design-html
|
|
102
138
|
buildless 静态 HTML)→ 跳过同步(no-op, skipped=true),退出码 0,不阻断 dev/启动链路。
|
|
103
139
|
|
|
104
140
|
JSON 输出
|
|
105
|
-
{"data": {"stack": "...",
|
|
141
|
+
{"data": {"stack": "...", "status": "succeeded|failed", "failedStage": "install",
|
|
106
142
|
"appliedRules": [{"type": "...", "action": "...", "path": "...", "detail": "..."}],
|
|
107
143
|
"syncedFiles": [...],
|
|
108
144
|
"mergedJsonFiles": [{"path": "...", "keys": [...]}],
|
|
@@ -308,14 +344,21 @@ function registerAppInit(parent) {
|
|
|
308
344
|
.option('--conf [json]', 'init 配置 JSON。支持 {"version": "<template 版本>"},默认 latest')
|
|
309
345
|
.option('--skip-install', '跳过依赖安装', false)
|
|
310
346
|
.option('--async-install', '派发后台进程装依赖并立即返回(与 --skip-install 互斥)', false)
|
|
347
|
+
.option('--strict', '平台严格调用:工程已存在时核验是否真正就绪(meta 可解析、stack 匹配、必要文件、依赖安装、上次操作结果),未就绪退出码 1', false)
|
|
311
348
|
.addOption((0, shared_1.appIdOption)())
|
|
312
349
|
.addHelpText('after', `
|
|
313
350
|
幂等
|
|
314
|
-
.spark/meta.json
|
|
315
|
-
|
|
316
|
-
meta
|
|
351
|
+
.spark/meta.json 已存在时不再渲染 / 安装(initialized=false, reason=already_initialized),
|
|
352
|
+
不覆盖已有业务代码;同时输出 ready 与 problems(工程就绪核验结果)。
|
|
353
|
+
meta 存在不等于就绪:--strict 时 problems 非空(meta 损坏、stack 与请求不符、必要文件缺失、
|
|
354
|
+
依赖未安装、上次 init/sync/migrate 失败)退出码 1,供平台严格调用判断。
|
|
317
355
|
上一次失败留下半渲染状态时(package.json 在但 meta.json 没在)允许重跑。
|
|
318
356
|
|
|
357
|
+
依赖安装失败
|
|
358
|
+
同步安装失败时 init 输出 status=failed、failedStage=install 并以退出码 1 结束;
|
|
359
|
+
已渲染的脚手架与 meta 保留(避免重跑时覆盖已开始编辑的文件),本地执行记录标为 install_failed,
|
|
360
|
+
后续 'miaoda app sync' 会补装依赖,--strict 在补装前报告未就绪。
|
|
361
|
+
|
|
319
362
|
应用身份(app_id)
|
|
320
363
|
--app-id <id>(或 MIAODA_APP_ID env)提供时写入 .spark/meta.json 的 app_id 字段;
|
|
321
364
|
未提供则不写。运行端命令(deploy / file / plugin 等)仍优先读 MIAODA_APP_ID env,
|
|
@@ -358,7 +401,8 @@ function registerAppInit(parent) {
|
|
|
358
401
|
与 --skip-install 互斥。
|
|
359
402
|
|
|
360
403
|
JSON 输出
|
|
361
|
-
已初始化:{"data": {"initialized": false, "reason": "already_initialized", "targetDir": "..."
|
|
404
|
+
已初始化:{"data": {"initialized": false, "reason": "already_initialized", "targetDir": "...",
|
|
405
|
+
"ready": true|false, "problems": [{"code": "...", "message": "..."}]}}
|
|
362
406
|
新初始化:{"data": {"initialized": true, "template": "...", "templateVersion": "...", "steeringVersion": "...",
|
|
363
407
|
"appId": "...", "appType": "modern_html", "sourceImported": true, "importedFileCount": 7,
|
|
364
408
|
"platformStackFound": true, "platformSyncedFiles": [...],
|
|
@@ -387,6 +431,7 @@ JSON 输出
|
|
|
387
431
|
skipInstall: rawOpts.skipInstall,
|
|
388
432
|
appId: rawOpts.appId,
|
|
389
433
|
asyncInstall: rawOpts.asyncInstall,
|
|
434
|
+
strict: rawOpts.strict,
|
|
390
435
|
});
|
|
391
436
|
}));
|
|
392
437
|
}
|
|
@@ -95,6 +95,7 @@ JSON 输出
|
|
|
95
95
|
{"data": {"ID": ..., "status": ..., "creator": "...", "createdAt": ..., "updatedAt": ..., ...}, "next_cursor": null, "has_more": false}
|
|
96
96
|
ID 即 deploy-id(== pipelineTaskID)
|
|
97
97
|
data.status 为可读字符串;data.status_code 为 BAM 原始数字枚举。
|
|
98
|
+
status 为 pending / rejected / failed 且存在审批单时,额外包含 approval(如 status、approvalURL、被拒时的 message)。
|
|
98
99
|
|
|
99
100
|
示例
|
|
100
101
|
$ miaoda deploy get 12345
|
|
@@ -15,6 +15,7 @@ const logs_dir_1 = require("../../../utils/logs-dir");
|
|
|
15
15
|
const env_1 = require("../../../utils/env");
|
|
16
16
|
const error_1 = require("../../../utils/error");
|
|
17
17
|
const output_1 = require("../../../utils/output");
|
|
18
|
+
const engineering_state_1 = require("../../../utils/engineering-state");
|
|
18
19
|
/**
|
|
19
20
|
* miaoda app init
|
|
20
21
|
*
|
|
@@ -32,24 +33,54 @@ const output_1 = require("../../../utils/output");
|
|
|
32
33
|
* 的版本(没经 sync 覆盖);首次 install 装的也是 template 钉的版本(没升 latest),
|
|
33
34
|
* package.json 跟 template 完全一致。dev.sh 入口的 sync 会修正这些 drift。
|
|
34
35
|
*
|
|
35
|
-
* 幂等:.spark/meta.json
|
|
36
|
+
* 幂等:.spark/meta.json 存在时不重跑渲染 / 安装(不覆盖业务代码),但会做只读就绪核验并输出
|
|
37
|
+
* ready / problems —— meta 存在不等于就绪;--strict 时未就绪退出码 1。
|
|
36
38
|
* 半渲染状态(package.json 在但 meta.json 不在)会重新跑完整流程。
|
|
39
|
+
*
|
|
40
|
+
* 同步安装失败是失败:meta 仍写出(脚手架已渲染,避免重跑覆盖已开始编辑的文件),本地执行
|
|
41
|
+
* 记录标为失败,输出 status=failed / failedStage=install 并退出码 1。
|
|
37
42
|
*/
|
|
38
43
|
async function handleAppInit(opts) {
|
|
39
44
|
await Promise.resolve();
|
|
40
45
|
const targetDir = opts.targetDir ?? process.cwd();
|
|
41
46
|
const metaPath = node_path_1.default.join(targetDir, '.spark', 'meta.json');
|
|
42
47
|
if (node_fs_1.default.existsSync(metaPath)) {
|
|
48
|
+
let expectedStack;
|
|
49
|
+
if (opts.template || opts.appType) {
|
|
50
|
+
try {
|
|
51
|
+
expectedStack = (0, index_1.resolveStack)({ template: opts.template, appType: opts.appType });
|
|
52
|
+
}
|
|
53
|
+
catch (err) {
|
|
54
|
+
// 非严格调用保持历史行为:已初始化时不因参数校验失败而报错
|
|
55
|
+
if (opts.strict)
|
|
56
|
+
throw err;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
const check = (0, index_1.checkWorkspaceReady)({ targetDir, expectedStack });
|
|
43
60
|
if (!(0, output_1.isJsonMode)()) {
|
|
44
61
|
process.stdout.write(`Already initialized: ${metaPath}\n`);
|
|
62
|
+
for (const p of check.problems) {
|
|
63
|
+
process.stdout.write(` ✗ ${p.code}: ${p.message}\n`);
|
|
64
|
+
}
|
|
45
65
|
}
|
|
46
66
|
(0, output_1.emit)({
|
|
47
67
|
data: {
|
|
48
68
|
initialized: false,
|
|
49
69
|
reason: 'already_initialized',
|
|
50
70
|
targetDir,
|
|
71
|
+
stack: check.stack,
|
|
72
|
+
ready: check.ready,
|
|
73
|
+
problems: check.problems,
|
|
51
74
|
},
|
|
52
75
|
});
|
|
76
|
+
if (opts.strict && !check.ready) {
|
|
77
|
+
(0, output_1.emitError)(new error_1.AppError('WORKSPACE_NOT_READY', check.problems.map((p) => `${p.code}: ${p.message}`).join('; '), {
|
|
78
|
+
next_actions: [
|
|
79
|
+
'按 problems 修复:依赖 / 文件问题执行 miaoda app sync,布局不符执行 miaoda app migrate',
|
|
80
|
+
],
|
|
81
|
+
}));
|
|
82
|
+
process.exitCode = 1;
|
|
83
|
+
}
|
|
53
84
|
return;
|
|
54
85
|
}
|
|
55
86
|
const stack = (0, index_1.resolveStack)({ template: opts.template, appType: opts.appType });
|
|
@@ -130,21 +161,29 @@ async function handleAppInit(opts) {
|
|
|
130
161
|
app_id: opts.appId,
|
|
131
162
|
});
|
|
132
163
|
// async 模式:meta 已落盘(= 脚手架就绪),再派发后台安装并立即返回(不等装完)。
|
|
164
|
+
// 执行记录先标 running,后台 worker 结束时改写为 succeeded / failed;中断则停留在 running。
|
|
133
165
|
let asyncDispatch;
|
|
134
166
|
if (opts.asyncInstall) {
|
|
167
|
+
recordInitState(targetDir, 'running', 'install');
|
|
135
168
|
asyncDispatch = (0, index_1.dispatchAsyncInstall)({ targetDir });
|
|
136
169
|
}
|
|
170
|
+
const installFailed = installResult?.source === 'failed';
|
|
171
|
+
if (installResult !== undefined) {
|
|
172
|
+
recordInitState(targetDir, installFailed ? 'failed' : 'succeeded', installResult.source === 'skipped' ? 'install-skipped' : 'install', installResult.error);
|
|
173
|
+
}
|
|
137
174
|
if (!(0, output_1.isJsonMode)()) {
|
|
138
175
|
if (opts.asyncInstall && asyncDispatch) {
|
|
139
176
|
process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install dispatched in background pid ${String(asyncDispatch.pid)}) in ${targetDir}\n`);
|
|
140
177
|
}
|
|
141
178
|
else if (installResult) {
|
|
142
|
-
process.stdout.write(
|
|
179
|
+
process.stdout.write(`${installFailed ? '✗' : '✓'} Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install ${installResult.source}) in ${targetDir}\n`);
|
|
143
180
|
}
|
|
144
181
|
}
|
|
145
182
|
(0, output_1.emit)({
|
|
146
183
|
data: {
|
|
147
184
|
initialized: true,
|
|
185
|
+
status: installFailed ? 'failed' : 'succeeded',
|
|
186
|
+
failedStage: installFailed ? 'install' : undefined,
|
|
148
187
|
template: stack,
|
|
149
188
|
templatePackage: tplResult.packageName,
|
|
150
189
|
templateVersion: tplResult.version,
|
|
@@ -177,8 +216,34 @@ async function handleAppInit(opts) {
|
|
|
177
216
|
cacheZip: installResult?.cacheZip,
|
|
178
217
|
installError: installResult?.error,
|
|
179
218
|
}),
|
|
219
|
+
nextActions: installFailed
|
|
220
|
+
? [
|
|
221
|
+
'检查 npm 输出定位安装错误(网络 / registry / 依赖冲突),修复后执行 miaoda app sync 补装依赖',
|
|
222
|
+
]
|
|
223
|
+
: undefined,
|
|
180
224
|
},
|
|
181
225
|
});
|
|
226
|
+
if (installFailed) {
|
|
227
|
+
(0, output_1.emitError)(new error_1.AppError('INIT_INSTALL_FAILED', `npm install failed: ${installResult?.error ?? ''}`, {
|
|
228
|
+
retryable: true,
|
|
229
|
+
next_actions: ['修复安装错误后执行 miaoda app sync 补装依赖'],
|
|
230
|
+
}));
|
|
231
|
+
process.exitCode = 1;
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
function recordInitState(targetDir, status, stage, error) {
|
|
235
|
+
try {
|
|
236
|
+
(0, engineering_state_1.writeEngineeringState)(targetDir, {
|
|
237
|
+
operation: 'init',
|
|
238
|
+
status,
|
|
239
|
+
stage,
|
|
240
|
+
code: status === 'failed' ? 'INIT_INSTALL_FAILED' : undefined,
|
|
241
|
+
message: error?.slice(0, 500),
|
|
242
|
+
});
|
|
243
|
+
}
|
|
244
|
+
catch (err) {
|
|
245
|
+
(0, logger_1.log)('init', `⚠ failed to record engineering state: ${err instanceof Error ? err.message : String(err)}`);
|
|
246
|
+
}
|
|
182
247
|
}
|
|
183
248
|
/**
|
|
184
249
|
* 处理 --source-path 导入:当前仅 app_type=modern_html 生效。
|