@lark-apaas/miaoda-cli 0.1.4-alpha.abaa17f → 0.1.4-alpha.dbe45ea

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.
Files changed (37) hide show
  1. package/README.md +1 -1
  2. package/dist/api/deploy/index.js +2 -1
  3. package/dist/api/deploy/modern.js +8 -0
  4. package/dist/api/deploy/plugin-instances-types.js +2 -2
  5. package/dist/api/deploy/plugin-instances.js +9 -17
  6. package/dist/cli/commands/app/index.js +32 -4
  7. package/dist/cli/commands/deploy/modern.js +3 -1
  8. package/dist/cli/commands/index.js +33 -0
  9. package/dist/cli/commands/skills/index.js +63 -0
  10. package/dist/cli/handlers/app/index.js +3 -1
  11. package/dist/cli/handlers/app/init.js +14 -12
  12. package/dist/cli/handlers/app/sync.js +45 -0
  13. package/dist/cli/handlers/deploy/modern.js +1 -0
  14. package/dist/cli/handlers/skills/index.js +7 -0
  15. package/dist/cli/handlers/skills/status.js +31 -0
  16. package/dist/cli/handlers/skills/sync.js +38 -0
  17. package/dist/services/app/init/index.js +1 -3
  18. package/dist/services/app/init/template.js +8 -6
  19. package/dist/services/deploy/modern/atoms/build.js +8 -3
  20. package/dist/services/deploy/modern/atoms/context.js +8 -11
  21. package/dist/services/deploy/modern/atoms/upload.js +103 -49
  22. package/dist/services/deploy/modern/check.js +2 -7
  23. package/dist/services/deploy/modern/pipelines/local.js +5 -5
  24. package/dist/services/deploy/modern/protocol.js +83 -4
  25. package/dist/services/deploy/modern/template-key-map.js +8 -15
  26. package/dist/services/skills/index.js +5 -0
  27. package/dist/services/skills/status.js +37 -0
  28. package/dist/{services/app/init/steering.js → utils/coding-steering.js} +24 -9
  29. package/dist/utils/http.js +14 -10
  30. package/dist/utils/platform-sync.js +114 -0
  31. package/dist/utils/spark-meta.js +2 -8
  32. package/package.json +4 -3
  33. package/platform-controlled/README.md +33 -0
  34. package/platform-controlled/design-stack/files/scripts/dev-local.sh +38 -0
  35. package/platform-controlled/design-stack/patches/package.json +5 -0
  36. package/platform-controlled/nestjs-react-fullstack/files/scripts/dev-local.sh +40 -0
  37. package/platform-controlled/nestjs-react-fullstack/patches/package.json +5 -0
@@ -0,0 +1,114 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.syncPlatformControlled = syncPlatformControlled;
7
+ const node_fs_1 = __importDefault(require("node:fs"));
8
+ const node_path_1 = __importDefault(require("node:path"));
9
+ const logger_1 = require("../utils/logger");
10
+ function syncPlatformControlled(opts) {
11
+ const logPrefix = opts.logPrefix ?? 'app-sync';
12
+ const cliRoot = opts.cliRoot ?? resolveCliRoot();
13
+ const stackDir = node_path_1.default.join(cliRoot, 'platform-controlled', opts.stack);
14
+ if (!node_fs_1.default.existsSync(stackDir)) {
15
+ return { stackFound: false, syncedFiles: [], mergedJsonFiles: [] };
16
+ }
17
+ (0, logger_1.log)(logPrefix, `Syncing platform-controlled/${opts.stack}/ → ${opts.targetDir}`);
18
+ const syncedFiles = syncFilesDir(node_path_1.default.join(stackDir, 'files'), opts.targetDir, logPrefix);
19
+ const mergedJsonFiles = applyJsonPatches(node_path_1.default.join(stackDir, 'patches'), opts.targetDir, logPrefix);
20
+ return {
21
+ stackFound: true,
22
+ syncedFiles,
23
+ mergedJsonFiles,
24
+ };
25
+ }
26
+ /** 推断 cli 安装根:dist/utils/platform-sync.js 上溯两级即仓根 */
27
+ function resolveCliRoot() {
28
+ return node_path_1.default.resolve(__dirname, '..', '..');
29
+ }
30
+ /** 递归同步 srcDir 下所有文件到 destDir,保持相对路径;.sh 文件 +x。返回 dest 相对路径列表 */
31
+ function syncFilesDir(srcDir, destDir, logPrefix) {
32
+ if (!node_fs_1.default.existsSync(srcDir))
33
+ return [];
34
+ const synced = [];
35
+ walk(srcDir, srcDir, destDir, (rel, srcPath, destPath) => {
36
+ node_fs_1.default.mkdirSync(node_path_1.default.dirname(destPath), { recursive: true });
37
+ node_fs_1.default.copyFileSync(srcPath, destPath);
38
+ if (rel.endsWith('.sh')) {
39
+ node_fs_1.default.chmodSync(destPath, 0o755);
40
+ }
41
+ synced.push(rel);
42
+ (0, logger_1.log)(logPrefix, ` + ${rel}`);
43
+ });
44
+ return synced;
45
+ }
46
+ /** 递归遍历 patchesDir 下每个 JSON 文件,deep merge 到 destDir 对应路径 */
47
+ function applyJsonPatches(patchesDir, destDir, logPrefix) {
48
+ if (!node_fs_1.default.existsSync(patchesDir))
49
+ return [];
50
+ const merged = [];
51
+ walk(patchesDir, patchesDir, destDir, (rel, patchPath, destPath) => {
52
+ if (!rel.endsWith('.json')) {
53
+ (0, logger_1.log)(logPrefix, ` (skip non-json patch: ${rel})`);
54
+ return;
55
+ }
56
+ if (!node_fs_1.default.existsSync(destPath)) {
57
+ throw new Error(`[${logPrefix}] target JSON not found: ${destPath} ` +
58
+ `(patches/${rel} 要求项目根含同路径文件;app init 应该先创建它)`);
59
+ }
60
+ const patch = readJson(patchPath);
61
+ const target = readJson(destPath);
62
+ if (!isPlainObject(patch) || !isPlainObject(target)) {
63
+ throw new Error(`[${logPrefix}] patch 与 target 必须都是 JSON object: ${rel}`);
64
+ }
65
+ const changed = [];
66
+ for (const key of Object.keys(patch)) {
67
+ const before = JSON.stringify(target[key]);
68
+ target[key] = deepMerge(target[key], patch[key]);
69
+ const after = JSON.stringify(target[key]);
70
+ if (before !== after)
71
+ changed.push(key);
72
+ }
73
+ if (changed.length > 0) {
74
+ node_fs_1.default.writeFileSync(destPath, JSON.stringify(target, null, 2) + '\n', 'utf-8');
75
+ merged.push({ path: rel, keys: changed });
76
+ (0, logger_1.log)(logPrefix, ` ~ ${rel} (keys: ${changed.join(', ')})`);
77
+ }
78
+ else {
79
+ (0, logger_1.log)(logPrefix, ` = ${rel} (unchanged)`);
80
+ }
81
+ });
82
+ return merged;
83
+ }
84
+ /** 通用递归遍历:对 rootSrc 下每个文件调 visit(rel, srcAbsPath, destAbsPath) */
85
+ function walk(rootSrc, curSrc, destDir, visit) {
86
+ for (const name of node_fs_1.default.readdirSync(curSrc)) {
87
+ const srcPath = node_path_1.default.join(curSrc, name);
88
+ const stat = node_fs_1.default.statSync(srcPath);
89
+ if (stat.isDirectory()) {
90
+ walk(rootSrc, srcPath, destDir, visit);
91
+ continue;
92
+ }
93
+ const rel = node_path_1.default.relative(rootSrc, srcPath);
94
+ const destPath = node_path_1.default.join(destDir, rel);
95
+ visit(rel, srcPath, destPath);
96
+ }
97
+ }
98
+ function readJson(filePath) {
99
+ return JSON.parse(node_fs_1.default.readFileSync(filePath, 'utf-8'));
100
+ }
101
+ function isPlainObject(v) {
102
+ return typeof v === 'object' && v !== null && !Array.isArray(v);
103
+ }
104
+ /** value 是 object 时递归 merge,其它(包括数组)直接以 patch 覆盖 */
105
+ function deepMerge(target, patch) {
106
+ if (isPlainObject(patch) && isPlainObject(target)) {
107
+ const merged = { ...target };
108
+ for (const k of Object.keys(patch)) {
109
+ merged[k] = deepMerge(target[k], patch[k]);
110
+ }
111
+ return merged;
112
+ }
113
+ return patch;
114
+ }
@@ -21,7 +21,7 @@ function readSparkMeta(appDir) {
21
21
  }
22
22
  }
23
23
  /**
24
- * merge 写入:保留已有 createdAt,刷新 updatedAt;undefined 字段不覆盖已有值。
24
+ * merge 写入:已有字段保留,undefined 不覆盖;不再维护时间戳。
25
25
  */
26
26
  function writeSparkMeta(appDir, meta) {
27
27
  const sparkDir = node_path_1.default.join(appDir, SPARK_DIR);
@@ -37,12 +37,6 @@ function writeSparkMeta(appDir, meta) {
37
37
  }
38
38
  }
39
39
  const defined = Object.fromEntries(Object.entries(meta).filter(([, v]) => v !== undefined));
40
- const now = new Date().toISOString();
41
- const merged = {
42
- ...existing,
43
- ...defined,
44
- createdAt: existing.createdAt ?? now,
45
- updatedAt: now,
46
- };
40
+ const merged = { ...existing, ...defined };
47
41
  node_fs_1.default.writeFileSync(metaPath, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
48
42
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lark-apaas/miaoda-cli",
3
- "version": "0.1.4-alpha.abaa17f",
3
+ "version": "0.1.4-alpha.dbe45ea",
4
4
  "description": "Miaoda 平台命令行工具,面向 Agent 调用",
5
5
  "type": "commonjs",
6
6
  "bin": {
@@ -10,10 +10,11 @@
10
10
  "access": "public"
11
11
  },
12
12
  "files": [
13
+ "LICENSE",
14
+ "README.md",
13
15
  "bin",
14
16
  "dist",
15
- "README.md",
16
- "LICENSE"
17
+ "platform-controlled"
17
18
  ],
18
19
  "keywords": [
19
20
  "miaoda",
@@ -0,0 +1,33 @@
1
+ # platform-controlled/
2
+
3
+ 平台管控的脚手架增量内容,按 stack 分目录,由 `miaoda app sync` 同步到用户项目。
4
+
5
+ ## 目录约定
6
+
7
+ ```
8
+ platform-controlled/
9
+ └── <stack>/
10
+ ├── files/ ← 文件模式:按相对路径整文件覆盖
11
+ │ └── <rel-path> ← 例如 scripts/dev-local.sh → <app>/scripts/dev-local.sh
12
+ └── patches/ ← JSON merge 模式:按相对路径 deep merge(任意 JSON 文件)
13
+ └── <rel-path>.json ← 例如 package.json / tsconfig.json / nest-cli.json
14
+ ```
15
+
16
+ ## 同步行为
17
+
18
+ - **files/**:递归遍历,按相对路径全量覆盖 targetDir。`.sh` 后缀文件同步后自动 `chmod +x`。
19
+ - **patches/**:递归遍历,**每个 `.json` 文件** 都跟 targetDir 同路径文件做 deep merge:
20
+ - 两边都必须是 JSON object(否则报错)
21
+ - value 是 object → 递归 merge;value 是数组 / 标量 → 整体替换
22
+ - 目标文件不存在则报错(patches 是补丁性质,不负责创建文件;app init 应该先创建)
23
+ - patches 下非 `.json` 文件会被跳过(预留给将来其它 patch 类型)
24
+ - 不做用户改动保护(本期约定:`platform-controlled/` 下的文件路径由平台拥有,用户不应手改)。
25
+
26
+ ## 跟 `miaoda skills sync` 的区别
27
+
28
+ | 链路 | 源 | 内容 | 目标 |
29
+ |---|---|---|---|
30
+ | `miaoda skills sync` | NPM 包 `@lark-apaas/coding-steering` | agent skills(`.md`) | `<app>/.agent/skills/steering/<stack>/` |
31
+ | `miaoda app sync` | 本仓 `platform-controlled/<stack>/` | 启动脚本、package.json 字段等 | `<app>/` 项目根 |
32
+
33
+ 两者独立调用,互不依赖。
@@ -0,0 +1,38 @@
1
+ #!/usr/bin/env bash
2
+ # ============================================================================
3
+ # 本地 dev 启动脚本(平台控制,通过 `miaoda app sync` 同步,请勿手改)
4
+ # Stack: design-stack(SSR-only,无 server 业务逻辑,无数据库)
5
+ # 流程:env pull → skills sync → 起 dev server
6
+ # ============================================================================
7
+ set -euo pipefail
8
+ ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
9
+ cd "$ROOT_DIR"
10
+
11
+ # Stack 是 design-stack,对应 miaoda CLI 的 design scene
12
+ # 沙箱里这个 env 由平台注入,本地 dev 由本脚本兜底,确保 miaoda 子命令(skills/sync)能看见
13
+ export MIAODA_APP_TYPE="${MIAODA_APP_TYPE:-4}"
14
+
15
+ # 临时:绕 npmmirror/bnpm 内网到 npmjs 的同步延迟,等 coding-steering 正式版去掉
16
+ export MIAODA_NPM_REGISTRY="${MIAODA_NPM_REGISTRY:-https://registry.npmjs.org/}"
17
+
18
+ # 1. 拉本地 dev 所需 ENV(jwt / cookie 等,写入 .env.local)
19
+ echo "[dev-local] (1/3) env pull..."
20
+ if command -v lark-cli >/dev/null 2>&1; then
21
+ lark-cli apps env pull || echo " (env pull 失败,后续按 .env.local 现状继续)"
22
+ else
23
+ echo " (lark-cli 未装,跳过 env pull;请确保 .env.local 已就绪)"
24
+ fi
25
+
26
+ # 2. 同步 stack 对应 skills(coding-steering)
27
+ echo "[dev-local] (2/3) miaoda skills sync..."
28
+ if command -v miaoda >/dev/null 2>&1; then
29
+ miaoda skills sync || echo " (skills sync 失败,继续启动)"
30
+ else
31
+ echo " (miaoda 未装,跳过 skills sync)"
32
+ fi
33
+
34
+ # 3. 起 dev server(design-stack 只有 SSR 渲染,单进程即可;不走 scripts/dev.js 的保活)
35
+ # 如果模板的 npm run dev 本身就是裸进程(无保活)则直接调即可;
36
+ # 如果 design-stack 模板的 dev 也是 dev.js 包装,后续需要新增 dev:raw 之类的直通命令
37
+ echo "[dev-local] (3/3) npm run dev"
38
+ exec npm run dev
@@ -0,0 +1,5 @@
1
+ {
2
+ "scripts": {
3
+ "dev:local": "./scripts/dev-local.sh"
4
+ }
5
+ }
@@ -0,0 +1,40 @@
1
+ #!/usr/bin/env bash
2
+ # ============================================================================
3
+ # 本地 dev 启动脚本(平台控制,通过 `miaoda app sync` 同步,请勿手改)
4
+ # Stack: nestjs-react-fullstack
5
+ # 流程:env pull → skills sync → 起 server + client(用户访问 http://localhost:8001)
6
+ # ============================================================================
7
+ set -euo pipefail
8
+ ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
9
+ cd "$ROOT_DIR"
10
+
11
+ # Stack 是 nestjs-react-fullstack(全栈应用),对应 miaoda CLI 的 application scene
12
+ # 沙箱里这个 env 由平台注入,本地 dev 由本脚本兜底,确保 miaoda 子命令(skills/sync)能看见
13
+ export MIAODA_APP_TYPE="${MIAODA_APP_TYPE:-3}"
14
+
15
+ # 临时:绕 npmmirror/bnpm 内网到 npmjs 的同步延迟,等 coding-steering 正式版去掉
16
+ export MIAODA_NPM_REGISTRY="${MIAODA_NPM_REGISTRY:-https://registry.npmjs.org/}"
17
+
18
+ # 1. 拉本地 dev 所需 ENV(jwt / cookie / sandbox URL 等,写入 .env.local)
19
+ echo "[dev-local] (1/3) env pull..."
20
+ if command -v lark-cli >/dev/null 2>&1; then
21
+ lark-cli apps env pull || echo " (env pull 失败,后续按 .env.local 现状继续)"
22
+ else
23
+ echo " (lark-cli 未装,跳过 env pull;请确保 .env.local 已就绪)"
24
+ fi
25
+
26
+ # 2. 同步 stack 对应 skills(coding-steering)
27
+ echo "[dev-local] (2/3) miaoda skills sync..."
28
+ if command -v miaoda >/dev/null 2>&1; then
29
+ miaoda skills sync || echo " (skills sync 失败,继续启动)"
30
+ else
31
+ echo " (miaoda 未装,跳过 skills sync)"
32
+ fi
33
+
34
+ # 3. 并发起 dev:server(NestJS 3000) + dev:client(rspack 8001),用户访问 8001
35
+ # 不走 scripts/dev.js(那有保活 / restart 循环 / 日志写文件,本地 dev 不需要 ——
36
+ # 进程崩了就让它崩,失败立即可见;日志直接 stdout 让 Agent 抓得到)
37
+ echo "[dev-local] (3/3) 并发起 dev:server + dev:client → http://localhost:${CLIENT_DEV_PORT:-8001}/"
38
+ exec npx --no-install concurrently \
39
+ --names "server,client" --prefix-colors "blue,green" --kill-others-on-fail \
40
+ "npm run dev:server" "npm run dev:client"
@@ -0,0 +1,5 @@
1
+ {
2
+ "scripts": {
3
+ "dev:local": "./scripts/dev-local.sh"
4
+ }
5
+ }