@lark-apaas/fullstack-cli 1.1.22-alpha.5 → 1.1.22-alpha.7

package/README.md

@@ -1,6 +1,6 @@
 # @lark-apaas/fullstack-cli
 
-> Fullstack 开发工具集 - 文件派生、数据库 Schema 生成、OpenAPI 生成、能力管理
+> Fullstack 开发工具集 - 文件派生、数据库 Schema 生成、OpenAPI 生成、能力管理、构建工具
 
 ## 功能
 
@@ -9,6 +9,7 @@
 3. **OpenAPI 生成** - 自动生成 API 文档和客户端 SDK
 4. **Action 插件管理** - 安装、更新、删除 action 插件
 5. **能力配置管理** - 查看、充血、迁移能力配置
+6. **构建工具** - 获取 STI 制品上传凭证等构建相关操作
 
 ## 安装
 
@@ -201,7 +202,40 @@ fullstack-cli capability migration --skip-code
 }
 ```
 
-### 7. CLI 命令
+### 7. 构建工具
+
+获取构建流程所需的 STI 制品上传凭证：
+
+```bash
+# Pipeline 发布场景 - 需要 commit-id
+fullstack-cli build get-token --app-id app_xxx --scene pipeline --commit-id abc123
+
+# 静态资源部署场景
+fullstack-cli build get-token --app-id app_xxx --scene static
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--app-id <id>` | 是 | 应用 ID |
+| `--scene <scene>` | 是 | 构建场景（`pipeline`、`static`） |
+| `--commit-id <id>` | scene=pipeline 时必填 | Git Commit ID |
+
+**输出：** stdout 输出 API 返回的完整 JSON，日志/错误输出到 stderr，便于脚本解析：
+
+```bash
+token_response=$(fullstack-cli build get-token --app-id "$APP_ID" --scene pipeline --commit-id "$COMMIT_ID")
+credential=$(echo "$token_response" | jq -r '.data.accessKeyID')
+```
+
+**环境变量：**
+- `FORCE_AUTHN_INNERAPI_DOMAIN` — API 域名
+- `FORCE_AUTHN_ACCESS_KEY` — Access Key
+- `FORCE_AUTHN_ACCESS_SECRET` — Secret Key
+- `FORCE_FRAMEWORK_CLI_CANARY_ENV` — Canary 环境（可选）
+
+### 8. CLI 命令
 
 ```bash
 # 查看帮助
@@ -223,11 +257,15 @@ fullstack-cli capability --help
 fullstack-cli capability list
 fullstack-cli capability migration --dry-run
 
+# 构建工具
+fullstack-cli build --help
+fullstack-cli build get-token --app-id <id> --scene <scene> [--commit-id <id>]
+
 # 查看版本
 fullstack-cli --version
 ```
 
-### 8. 全局选项
+### 9. 全局选项
 
 #### Canary 环境
 

package/dist/index.js

@@ -2475,7 +2475,25 @@ function getChangedFiles(cwd = process.cwd()) {
   }
 }
 function gitAddUpgradeFiles(cwd = process.cwd(), filesToStage) {
-  const result = spawnSync2("git", ["add", "--ignore-missing", "--", ...filesToStage], {
+  const filteredFiles = [];
+  for (const filePath of filesToStage) {
+    if (fs7.existsSync(path5.join(cwd, filePath))) {
+      filteredFiles.push(filePath);
+      continue;
+    }
+    const tracked = spawnSync2("git", ["ls-files", "--error-unmatch", "--", filePath], {
+      cwd,
+      stdio: "pipe",
+      encoding: "utf-8"
+    });
+    if (tracked.status === 0) {
+      filteredFiles.push(filePath);
+    }
+  }
+  if (filteredFiles.length === 0) {
+    return;
+  }
+  const result = spawnSync2("git", ["add", "--", ...filteredFiles], {
     cwd,
     stdio: "pipe",
     encoding: "utf-8"
@@ -3768,6 +3786,9 @@ var capabilityCommandGroup = {
   commands: [listCommand2]
 };
 
+// src/commands/component/add.handler.ts
+import { execFile } from "child_process";
+
 // src/commands/component/registry-preparer.ts
 import fs13 from "fs";
 import path11 from "path";
@@ -3997,6 +4018,16 @@ async function executeShadcnAdd(registryItemPath) {
 }
 
 // src/commands/component/add.handler.ts
+function runActionPluginInit() {
+  return new Promise((resolve) => {
+    execFile("fullstack-cli", ["action-plugin", "init"], { cwd: process.cwd(), stdio: "ignore" }, (error) => {
+      if (error) {
+        debug("action-plugin init \u5931\u8D25: %s", error.message);
+      }
+      resolve();
+    });
+  });
+}
 function printResult(result) {
   console.log(JSON.stringify(result, null, 2));
 }
@@ -4033,6 +4064,7 @@ async function add(key) {
       errors: [{ message: errorMessage }]
     });
   } finally {
+    await runActionPluginInit();
     cleanupTempDir();
   }
 }
@@ -6807,6 +6839,81 @@ var readLogsCommand = {
   }
 };
 
+// src/commands/build/types.ts
+var SCENE_CONFIGS = {
+  pipeline: {
+    name: "pipeline",
+    requiredOptions: ["commitId"],
+    buildRequestBody: (opts) => ({ commitID: opts.commitId })
+  },
+  static: {
+    name: "static",
+    requiredOptions: [],
+    buildRequestBody: () => ({ commitID: "" })
+  }
+};
+
+// src/commands/build/api-client.ts
+async function genArtifactUploadCredential(appId, body) {
+  const client = getHttpClient();
+  const url = `/v1/app/${appId}/pipeline/gen_artifact_upload_credential`;
+  const response = await client.post(url, body);
+  if (!response.ok || response.status !== 200) {
+    throw new Error(
+      `API request failed: ${response.status} ${response.statusText}`
+    );
+  }
+  return response.json();
+}
+
+// src/commands/build/get-token.handler.ts
+async function getToken(options) {
+  try {
+    const sceneConfig = SCENE_CONFIGS[options.scene];
+    if (!sceneConfig) {
+      const available = Object.keys(SCENE_CONFIGS).join(", ");
+      console.error(
+        `[build] Error: invalid scene "${options.scene}". Available scenes: ${available}`
+      );
+      process.exit(1);
+    }
+    for (const key of sceneConfig.requiredOptions) {
+      if (!options[key]) {
+        console.error(
+          `[build] Error: --${camelToKebab(key)} is required for scene "${options.scene}"`
+        );
+        process.exit(1);
+      }
+    }
+    const body = sceneConfig.buildRequestBody(options);
+    const response = await genArtifactUploadCredential(options.appId, body);
+    console.log(JSON.stringify(response));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`[build] Error: ${message}`);
+    process.exit(1);
+  }
+}
+function camelToKebab(str) {
+  return str.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+
+// src/commands/build/index.ts
+var getTokenCommand = {
+  name: "get-token",
+  description: "Get artifact upload credential (STI token)",
+  register(program) {
+    program.command(this.name).description(this.description).requiredOption("--app-id <id>", "Application ID").requiredOption("--scene <scene>", "Build scene (pipeline, static)").option("--commit-id <id>", "Git commit ID (required for pipeline scene)").action(async (options) => {
+      await getToken(options);
+    });
+  }
+};
+var buildCommandGroup = {
+  name: "build",
+  description: "Build related commands",
+  commands: [getTokenCommand]
+};
+
 // src/commands/index.ts
 var commands = [
   genDbSchemaCommand,
@@ -6816,7 +6923,8 @@ var commands = [
   capabilityCommandGroup,
   componentCommandGroup,
   migrationCommand,
-  readLogsCommand
+  readLogsCommand,
+  buildCommandGroup
 ];
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-cli",
-  "version": "1.1.22-alpha.5",
+  "version": "1.1.22-alpha.7",
   "description": "CLI tool for fullstack template management",
   "type": "module",
   "main": "dist/index.js",