@lark-apaas/fullstack-cli 1.1.16-beta.2 → 1.1.16-beta.4

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/index.ts
-import fs21 from "fs";
-import path17 from "path";
-import { fileURLToPath as fileURLToPath4 } from "url";
+import fs25 from "fs";
+import path21 from "path";
+import { fileURLToPath as fileURLToPath5 } from "url";
 import { config as dotenvConfig } from "dotenv";
 
 // src/cli.ts
@@ -481,6 +481,7 @@ var replaceUnknownTransform = {
   transform(ctx) {
     const { sourceFile, stats } = ctx;
     const fullText = sourceFile.getFullText();
+    const replacements = [];
     sourceFile.forEachDescendant((node) => {
       if (!Node5.isCallExpression(node)) {
         return;
@@ -511,13 +512,23 @@ var replaceUnknownTransform = {
           break;
         }
       }
+      replacements.push({
+        expression,
+        factoryName,
+        foundKnownType,
+        isArrayType,
+        node
+      });
+    });
+    for (const { expression, factoryName, foundKnownType, isArrayType, node } of replacements) {
       expression.replaceWithText(factoryName);
       if (isArrayType && foundKnownType) {
         const parent = node.getParent();
         if (Node5.isPropertyAccessExpression(parent) && parent.getName() === "array") {
           const grandParent = parent.getParent();
           if (Node5.isCallExpression(grandParent)) {
-            grandParent.replaceWithText(node.getText());
+            const nodeText = node.getText();
+            grandParent.replaceWithText(nodeText);
           }
         }
       }
@@ -526,7 +537,7 @@ var replaceUnknownTransform = {
       } else {
         stats.fallbackToText++;
       }
-    });
+    }
     const todoCommentRegex = /\/\/ TODO: failed to parse database type '[^']+'\s*\n/g;
     const currentText = sourceFile.getFullText();
     const cleanedText = currentText.replace(todoCommentRegex, "");
@@ -2408,10 +2419,420 @@ var syncCommand = {
   }
 };
 
-// src/commands/action-plugin/utils.ts
+// src/utils/http-client.ts
+import { HttpClient } from "@lark-apaas/http-client";
+var clientInstance = null;
+function getHttpClient() {
+  if (!clientInstance) {
+    clientInstance = new HttpClient({
+      timeout: 3e4,
+      platform: {
+        enabled: true
+      }
+    });
+    const canaryEnv = process.env.FORCE_FRAMEWORK_CLI_CANARY_ENV;
+    if (canaryEnv) {
+      clientInstance.interceptors.request.use((req) => {
+        req.headers["x-tt-env"] = canaryEnv;
+        return req;
+      });
+    }
+  }
+  return clientInstance;
+}
+
+// src/utils/telemetry.ts
+async function reportEvents(events) {
+  if (events.length === 0) {
+    return true;
+  }
+  try {
+    const client = getHttpClient();
+    const response = await client.post("/api/v1/studio/innerapi/resource_events", { events });
+    if (!response.ok) {
+      console.warn(`[telemetry] Failed to report events: ${response.status} ${response.statusText}`);
+      return false;
+    }
+    const result = await response.json();
+    if (result.status_code !== "0") {
+      console.warn(`[telemetry] API error: ${result.message}`);
+      return false;
+    }
+    return true;
+  } catch (error) {
+    console.warn(`[telemetry] Failed to report events: ${error instanceof Error ? error.message : error}`);
+    return false;
+  }
+}
+async function reportInstallEvent(pluginKey, version) {
+  await reportEvents([
+    {
+      resourceType: "plugin",
+      resourceKey: pluginKey,
+      eventType: "install",
+      details: { version }
+    }
+  ]);
+}
+async function reportCreateInstanceEvent(pluginKey, version) {
+  await reportEvents([
+    {
+      resourceType: "plugin",
+      resourceKey: pluginKey,
+      eventType: "create_instance",
+      details: { version }
+    }
+  ]);
+}
+
+// src/utils/git.ts
+import { execSync, spawnSync as spawnSync2 } from "child_process";
 import fs7 from "fs";
 import path5 from "path";
-import { spawnSync as spawnSync2, execSync } from "child_process";
+function isGitRepository(cwd = process.cwd()) {
+  try {
+    const gitDir = path5.join(cwd, ".git");
+    if (fs7.existsSync(gitDir)) {
+      return true;
+    }
+    const result = spawnSync2("git", ["rev-parse", "--git-dir"], {
+      cwd,
+      stdio: "pipe",
+      encoding: "utf-8"
+    });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+function getChangedFiles(cwd = process.cwd()) {
+  try {
+    const output = execSync("git status --porcelain", {
+      cwd,
+      stdio: "pipe",
+      encoding: "utf-8"
+    });
+    return output.split("\n").filter((line) => line.trim()).map((line) => line.substring(3));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to get changed files: ${message}`);
+  }
+}
+function gitAddUpgradeFiles(cwd = process.cwd(), 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"
+  });
+  if (result.error || result.status !== 0) {
+    const errorMsg = result.stderr || result.error?.message || "Unknown error";
+    throw new Error(`git add failed: ${errorMsg}`);
+  }
+}
+function hasStagedChanges(cwd = process.cwd()) {
+  const result = spawnSync2("git", ["diff", "--cached", "--quiet"], {
+    cwd,
+    stdio: "pipe",
+    encoding: "utf-8"
+  });
+  if (result.status === 0) {
+    return false;
+  }
+  if (result.status === 1) {
+    return true;
+  }
+  const errorMsg = result.stderr || result.error?.message || "Unknown error";
+  throw new Error(`Failed to check staged changes: ${errorMsg}`);
+}
+function gitCommit(message, cwd = process.cwd()) {
+  const result = spawnSync2("git", ["commit", "-m", message], {
+    cwd,
+    stdio: "pipe",
+    encoding: "utf-8"
+  });
+  if (result.error || result.status !== 0) {
+    const errorMsg = result.stderr || result.error?.message || "Unknown error";
+    throw new Error(`git commit failed: ${errorMsg}`);
+  }
+}
+function autoCommitUpgradeChanges(version, cwd, filesToStage, commitMessage) {
+  if (!isGitRepository(cwd)) {
+    console.log("[fullstack-cli] \u26A0 Not a git repository, skipping auto-commit");
+    return false;
+  }
+  const changedFiles = getChangedFiles(cwd);
+  if (changedFiles.length === 0) {
+    console.log("[fullstack-cli] No changes to commit");
+    return false;
+  }
+  try {
+    gitAddUpgradeFiles(cwd, filesToStage);
+    if (!hasStagedChanges(cwd)) {
+      console.log("[fullstack-cli] No upgrade changes to commit");
+      return false;
+    }
+    const message = commitMessage || `chore(upgrade): auto-upgrade by fullstack-cli
+
+- Sync template files
+- Cleanup package.json config
+- Upgrade @lark-apaas dependencies (if any)
+
+Auto-committed by fullstack-cli v${version}`;
+    gitCommit(message, cwd);
+    console.log(`[fullstack-cli] \u2713 Auto-committed ${changedFiles.length} changed file(s)`);
+    return true;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to auto-commit changes: ${message}`);
+  }
+}
+
+// src/utils/package-json.ts
+import fs8 from "fs";
+import path6 from "path";
+function readPackageJson(cwd = process.cwd()) {
+  const pkgPath = path6.join(cwd, "package.json");
+  if (!fs8.existsSync(pkgPath)) {
+    throw new Error(`package.json not found at ${pkgPath}`);
+  }
+  const content = fs8.readFileSync(pkgPath, "utf-8");
+  return JSON.parse(content);
+}
+function writePackageJson(pkg2, cwd = process.cwd()) {
+  const pkgPath = path6.join(cwd, "package.json");
+  const content = JSON.stringify(pkg2, null, 2) + "\n";
+  fs8.writeFileSync(pkgPath, content, "utf-8");
+}
+function removeUpgradeScript(pkg2) {
+  if (!pkg2.scripts?.upgrade) {
+    return false;
+  }
+  delete pkg2.scripts.upgrade;
+  return true;
+}
+function cleanDevScript(pkg2) {
+  if (!pkg2.scripts?.dev) {
+    return false;
+  }
+  const originalDev = pkg2.scripts.dev;
+  const cleanedDev = originalDev.replace(/npm\s+run\s+upgrade\s*&&\s*/g, "").replace(/npm\s+run\s+upgrade\s*$/g, "").trim();
+  if (cleanedDev !== originalDev) {
+    pkg2.scripts.dev = cleanedDev;
+    return true;
+  }
+  return false;
+}
+function cleanupPackageJson(cwd = process.cwd()) {
+  try {
+    const pkg2 = readPackageJson(cwd);
+    let changed = false;
+    if (removeUpgradeScript(pkg2)) {
+      console.log("[fullstack-cli] \u2713 Removed scripts.upgrade");
+      changed = true;
+    }
+    if (cleanDevScript(pkg2)) {
+      console.log("[fullstack-cli] \u2713 Cleaned scripts.dev (removed npm run upgrade)");
+      changed = true;
+    }
+    if (changed) {
+      writePackageJson(pkg2, cwd);
+    }
+    return changed;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.log(`[fullstack-cli] \u26A0 Could not cleanup package.json: ${message}`);
+    return false;
+  }
+}
+
+// src/commands/upgrade/shared/utils.ts
+import path7 from "path";
+import fs9 from "fs";
+import { fileURLToPath as fileURLToPath4 } from "url";
+function getCliVersion() {
+  try {
+    const __filename = fileURLToPath4(import.meta.url);
+    const __dirname2 = path7.dirname(__filename);
+    const pkgPath = path7.resolve(__dirname2, "../../../package.json");
+    const pkgContent = fs9.readFileSync(pkgPath, "utf-8");
+    const pkg2 = JSON.parse(pkgContent);
+    return pkg2.version || "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+// src/commands/upgrade/get-upgrade-files.ts
+function getUpgradeFilesToStage(disableGenOpenapi = true) {
+  const syncConfig2 = genSyncConfig({ disableGenOpenapi });
+  const filesToStage = /* @__PURE__ */ new Set();
+  syncConfig2.sync.forEach((rule) => {
+    if (rule.type === "file" || rule.type === "directory") {
+      filesToStage.add(rule.to);
+    } else if (rule.type === "remove-line" || rule.type === "add-line") {
+      filesToStage.add(rule.to);
+    } else if (rule.type === "add-script") {
+      filesToStage.add("package.json");
+    } else if (rule.type === "delete-file" || rule.type === "delete-directory") {
+      filesToStage.add(rule.to);
+    }
+  });
+  filesToStage.add("package.json");
+  filesToStage.add("package-lock.json");
+  return Array.from(filesToStage);
+}
+
+// src/commands/upgrade/run.handler.ts
+async function run3(options = {}) {
+  const userProjectRoot = process.env.INIT_CWD || process.cwd();
+  console.log("[fullstack-cli] Starting upgrade...");
+  try {
+    console.log("[fullstack-cli] Step 1/3: Syncing template files...");
+    await run2({ disableGenOpenapi: options.disableGenOpenapi ?? true });
+    console.log("[fullstack-cli] Step 2/3: Cleaning up package.json...");
+    const cleaned = cleanupPackageJson(userProjectRoot);
+    if (!cleaned) {
+      console.log("[fullstack-cli] \u25CB No cleanup needed");
+    }
+    const shouldCommit = options.commit ?? true;
+    if (shouldCommit) {
+      console.log("[fullstack-cli] Step 3/3: Committing changes...");
+      const version = getCliVersion();
+      const filesToStage = getUpgradeFilesToStage(options.disableGenOpenapi ?? true);
+      autoCommitUpgradeChanges(version, userProjectRoot, filesToStage);
+    } else {
+      console.log("[fullstack-cli] Step 3/3: Skipping commit (--no-commit flag)");
+    }
+    console.log("[fullstack-cli] Upgrade completed successfully \u2705");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error("[fullstack-cli] Failed to upgrade:", message);
+    process.exit(1);
+  }
+}
+
+// src/commands/upgrade/deps/run.handler.ts
+import { spawnSync as spawnSync3 } from "child_process";
+function findLarkAapaasPackages(cwd, filterPackages) {
+  const pkg2 = readPackageJson(cwd);
+  const allPackages = /* @__PURE__ */ new Set();
+  if (pkg2.dependencies) {
+    Object.keys(pkg2.dependencies).forEach((name) => {
+      if (name.startsWith("@lark-apaas/")) {
+        allPackages.add(name);
+      }
+    });
+  }
+  if (pkg2.devDependencies) {
+    Object.keys(pkg2.devDependencies).forEach((name) => {
+      if (name.startsWith("@lark-apaas/")) {
+        allPackages.add(name);
+      }
+    });
+  }
+  const packages = Array.from(allPackages);
+  if (filterPackages) {
+    const filter = new Set(filterPackages.split(",").map((p) => p.trim()));
+    return packages.filter((p) => filter.has(p));
+  }
+  return packages;
+}
+function upgradePackages(packages, version, cwd) {
+  if (version) {
+    console.log(`[fullstack-cli] Upgrading to version ${version}...`);
+    packages.forEach((pkg2) => {
+      const target = `${pkg2}@${version}`;
+      console.log(`[fullstack-cli]   Installing ${target}...`);
+      const result = spawnSync3("npm", ["install", target], {
+        cwd,
+        stdio: "inherit"
+      });
+      if (result.error || result.status !== 0) {
+        throw new Error(`Failed to install ${target}`);
+      }
+    });
+  } else {
+    console.log("[fullstack-cli] Upgrading to latest compatible versions...");
+    packages.forEach((pkg2) => {
+      console.log(`[fullstack-cli]   Updating ${pkg2}...`);
+      const result = spawnSync3("npm", ["update", pkg2], {
+        cwd,
+        stdio: "inherit"
+      });
+      if (result.error || result.status !== 0) {
+        throw new Error(`Failed to update ${pkg2}`);
+      }
+    });
+  }
+}
+async function run4(options = {}) {
+  const cwd = process.env.INIT_CWD || process.cwd();
+  console.log("[fullstack-cli] Starting dependencies upgrade...");
+  try {
+    console.log("[fullstack-cli] Step 1/2: Scanning @lark-apaas dependencies...");
+    const packages = findLarkAapaasPackages(cwd, options.packages);
+    if (packages.length === 0) {
+      console.log("[fullstack-cli] No @lark-apaas packages found");
+      return;
+    }
+    console.log(`[fullstack-cli] Found ${packages.length} @lark-apaas package(s):`);
+    packages.forEach((p) => console.log(`  - ${p}`));
+    console.log("[fullstack-cli] Step 2/2: Upgrading packages...");
+    upgradePackages(packages, options.version, cwd);
+    console.log(`[fullstack-cli] \u2713 Successfully upgraded ${packages.length} package(s)`);
+    console.log("[fullstack-cli] Dependencies upgrade completed successfully \u2705");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error("[fullstack-cli] Failed to upgrade dependencies:", message);
+    process.exit(1);
+  }
+}
+
+// src/commands/upgrade/deps/index.ts
+var depsCommand = {
+  name: "deps",
+  description: "Upgrade @lark-apaas dependencies",
+  register(parentCommand) {
+    parentCommand.command(this.name).description(this.description).option("--version <version>", "Upgrade to specific version").option("--packages <packages>", "Only upgrade specific packages (comma-separated)").action(async (options) => {
+      await run4(options);
+    });
+  }
+};
+
+// src/commands/upgrade/index.ts
+var upgradeCommand = {
+  name: "upgrade",
+  description: "Upgrade template files and auto-commit changes",
+  register(program) {
+    const upgradeCmd = program.command(this.name).description(this.description).option("--disable-gen-openapi", "Disable generating openapi.ts").option("--no-commit", "Skip auto-commit changes").action(async (options) => {
+      await run3(options);
+    });
+    depsCommand.register(upgradeCmd);
+  }
+};
+
+// src/commands/action-plugin/utils.ts
+import fs10 from "fs";
+import path8 from "path";
+import { spawnSync as spawnSync4, execSync as execSync2 } from "child_process";
 function parsePluginName(input) {
   const match = input.match(/^(@[^/]+\/[^@]+)(?:@(.+))?$/);
   if (!match) {
@@ -2428,35 +2849,35 @@ function getProjectRoot() {
   return process.cwd();
 }
 function getPackageJsonPath() {
-  return path5.join(getProjectRoot(), "package.json");
+  return path8.join(getProjectRoot(), "package.json");
 }
 function getPluginPath(pluginName) {
-  return path5.join(getProjectRoot(), "node_modules", pluginName);
+  return path8.join(getProjectRoot(), "node_modules", pluginName);
 }
-function readPackageJson() {
+function readPackageJson2() {
   const pkgPath = getPackageJsonPath();
-  if (!fs7.existsSync(pkgPath)) {
+  if (!fs10.existsSync(pkgPath)) {
     throw new Error("package.json not found in current directory");
   }
   try {
-    const content = fs7.readFileSync(pkgPath, "utf-8");
+    const content = fs10.readFileSync(pkgPath, "utf-8");
     return JSON.parse(content);
   } catch {
     throw new Error("Failed to parse package.json");
   }
 }
-function writePackageJson(pkg2) {
+function writePackageJson2(pkg2) {
   const pkgPath = getPackageJsonPath();
-  fs7.writeFileSync(pkgPath, JSON.stringify(pkg2, null, 2) + "\n", "utf-8");
+  fs10.writeFileSync(pkgPath, JSON.stringify(pkg2, null, 2) + "\n", "utf-8");
 }
 function readActionPlugins() {
-  const pkg2 = readPackageJson();
+  const pkg2 = readPackageJson2();
   return pkg2.actionPlugins || {};
 }
 function writeActionPlugins(plugins) {
-  const pkg2 = readPackageJson();
+  const pkg2 = readPackageJson2();
   pkg2.actionPlugins = plugins;
-  writePackageJson(pkg2);
+  writePackageJson2(pkg2);
 }
 function isPluginInstalled(pluginName) {
   const plugins = readActionPlugins();
@@ -2468,7 +2889,7 @@ function getInstalledPluginVersion(pluginName) {
 }
 function npmInstall(tgzPath) {
   console.log(`[action-plugin] Running npm install ${tgzPath}...`);
-  const result = spawnSync2("npm", ["install", tgzPath, "--no-save", "--no-package-lock", "--ignore-scripts"], {
+  const result = spawnSync4("npm", ["install", tgzPath, "--no-save", "--no-package-lock", "--ignore-scripts"], {
     cwd: getProjectRoot(),
     stdio: "inherit"
   });
@@ -2480,12 +2901,12 @@ function npmInstall(tgzPath) {
   }
 }
 function getPackageVersion(pluginName) {
-  const pkgJsonPath = path5.join(getPluginPath(pluginName), "package.json");
-  if (!fs7.existsSync(pkgJsonPath)) {
+  const pkgJsonPath = path8.join(getPluginPath(pluginName), "package.json");
+  if (!fs10.existsSync(pkgJsonPath)) {
     return null;
   }
   try {
-    const content = fs7.readFileSync(pkgJsonPath, "utf-8");
+    const content = fs10.readFileSync(pkgJsonPath, "utf-8");
     const pkg2 = JSON.parse(content);
     return pkg2.version || null;
   } catch {
@@ -2493,49 +2914,49 @@ function getPackageVersion(pluginName) {
   }
 }
 function readPluginPackageJson(pluginPath) {
-  const pkgJsonPath = path5.join(pluginPath, "package.json");
-  if (!fs7.existsSync(pkgJsonPath)) {
+  const pkgJsonPath = path8.join(pluginPath, "package.json");
+  if (!fs10.existsSync(pkgJsonPath)) {
     return null;
   }
   try {
-    const content = fs7.readFileSync(pkgJsonPath, "utf-8");
+    const content = fs10.readFileSync(pkgJsonPath, "utf-8");
     return JSON.parse(content);
   } catch {
     return null;
   }
 }
 function extractTgzToNodeModules(tgzPath, pluginName) {
-  const nodeModulesPath = path5.join(getProjectRoot(), "node_modules");
-  const targetDir = path5.join(nodeModulesPath, pluginName);
-  const scopeDir = path5.dirname(targetDir);
-  if (!fs7.existsSync(scopeDir)) {
-    fs7.mkdirSync(scopeDir, { recursive: true });
+  const nodeModulesPath = path8.join(getProjectRoot(), "node_modules");
+  const targetDir = path8.join(nodeModulesPath, pluginName);
+  const scopeDir = path8.dirname(targetDir);
+  if (!fs10.existsSync(scopeDir)) {
+    fs10.mkdirSync(scopeDir, { recursive: true });
   }
-  if (fs7.existsSync(targetDir)) {
-    fs7.rmSync(targetDir, { recursive: true });
+  if (fs10.existsSync(targetDir)) {
+    fs10.rmSync(targetDir, { recursive: true });
   }
-  const tempDir = path5.join(nodeModulesPath, ".cache", "fullstack-cli", "extract-temp");
-  if (fs7.existsSync(tempDir)) {
-    fs7.rmSync(tempDir, { recursive: true });
+  const tempDir = path8.join(nodeModulesPath, ".cache", "fullstack-cli", "extract-temp");
+  if (fs10.existsSync(tempDir)) {
+    fs10.rmSync(tempDir, { recursive: true });
   }
-  fs7.mkdirSync(tempDir, { recursive: true });
+  fs10.mkdirSync(tempDir, { recursive: true });
   try {
-    execSync(`tar -xzf "${tgzPath}" -C "${tempDir}"`, { stdio: "pipe" });
-    const extractedDir = path5.join(tempDir, "package");
-    if (fs7.existsSync(extractedDir)) {
-      fs7.renameSync(extractedDir, targetDir);
+    execSync2(`tar -xzf "${tgzPath}" -C "${tempDir}"`, { stdio: "pipe" });
+    const extractedDir = path8.join(tempDir, "package");
+    if (fs10.existsSync(extractedDir)) {
+      fs10.renameSync(extractedDir, targetDir);
     } else {
-      const files = fs7.readdirSync(tempDir);
+      const files = fs10.readdirSync(tempDir);
       if (files.length === 1) {
-        fs7.renameSync(path5.join(tempDir, files[0]), targetDir);
+        fs10.renameSync(path8.join(tempDir, files[0]), targetDir);
       } else {
         throw new Error("Unexpected tgz structure");
       }
     }
     return targetDir;
   } finally {
-    if (fs7.existsSync(tempDir)) {
-      fs7.rmSync(tempDir, { recursive: true });
+    if (fs10.existsSync(tempDir)) {
+      fs10.rmSync(tempDir, { recursive: true });
     }
   }
 }
@@ -2544,10 +2965,10 @@ function checkMissingPeerDeps(peerDeps) {
     return [];
   }
   const missing = [];
-  const nodeModulesPath = path5.join(getProjectRoot(), "node_modules");
+  const nodeModulesPath = path8.join(getProjectRoot(), "node_modules");
   for (const [depName, _version] of Object.entries(peerDeps)) {
-    const depPath = path5.join(nodeModulesPath, depName);
-    if (!fs7.existsSync(depPath)) {
+    const depPath = path8.join(nodeModulesPath, depName);
+    if (!fs10.existsSync(depPath)) {
       missing.push(depName);
     }
   }
@@ -2558,7 +2979,7 @@ function installMissingDeps(deps) {
     return;
   }
   console.log(`[action-plugin] Installing missing dependencies: ${deps.join(", ")}`);
-  const result = spawnSync2("npm", ["install", ...deps, "--no-save", "--no-package-lock"], {
+  const result = spawnSync4("npm", ["install", ...deps, "--no-save", "--no-package-lock"], {
     cwd: getProjectRoot(),
     stdio: "inherit"
   });
@@ -2571,40 +2992,16 @@ function installMissingDeps(deps) {
 }
 function removePluginDirectory(pluginName) {
   const pluginPath = getPluginPath(pluginName);
-  if (fs7.existsSync(pluginPath)) {
-    fs7.rmSync(pluginPath, { recursive: true });
+  if (fs10.existsSync(pluginPath)) {
+    fs10.rmSync(pluginPath, { recursive: true });
     console.log(`[action-plugin] Removed ${pluginName}`);
   }
 }
 
 // src/commands/action-plugin/api-client.ts
 import { HttpClient as HttpClient2 } from "@lark-apaas/http-client";
-import fs8 from "fs";
-import path6 from "path";
-
-// src/utils/http-client.ts
-import { HttpClient } from "@lark-apaas/http-client";
-var clientInstance = null;
-function getHttpClient() {
-  if (!clientInstance) {
-    clientInstance = new HttpClient({
-      timeout: 3e4,
-      platform: {
-        enabled: true
-      }
-    });
-    const canaryEnv = process.env.FORCE_FRAMEWORK_CLI_CANARY_ENV;
-    if (canaryEnv) {
-      clientInstance.interceptors.request.use((req) => {
-        req.headers["x-tt-env"] = canaryEnv;
-        return req;
-      });
-    }
-  }
-  return clientInstance;
-}
-
-// src/commands/action-plugin/api-client.ts
+import fs11 from "fs";
+import path9 from "path";
 var PLUGIN_CACHE_DIR = "node_modules/.cache/fullstack-cli/plugins";
 async function getPluginVersions(keys, latestOnly = true) {
   const client = getHttpClient();
@@ -2668,19 +3065,19 @@ async function downloadFromPublic(downloadURL) {
   return Buffer.from(arrayBuffer);
 }
 function getPluginCacheDir() {
-  return path6.join(process.cwd(), PLUGIN_CACHE_DIR);
+  return path9.join(process.cwd(), PLUGIN_CACHE_DIR);
 }
 function ensureCacheDir() {
   const cacheDir = getPluginCacheDir();
-  if (!fs8.existsSync(cacheDir)) {
-    fs8.mkdirSync(cacheDir, { recursive: true });
+  if (!fs11.existsSync(cacheDir)) {
+    fs11.mkdirSync(cacheDir, { recursive: true });
   }
 }
 function getTempFilePath(pluginKey, version) {
   ensureCacheDir();
   const safeKey = pluginKey.replace(/[/@]/g, "_");
   const filename = `${safeKey}@${version}.tgz`;
-  return path6.join(getPluginCacheDir(), filename);
+  return path9.join(getPluginCacheDir(), filename);
 }
 var MAX_RETRIES = 2;
 async function withRetry(operation, description, maxRetries = MAX_RETRIES) {
@@ -2717,7 +3114,7 @@ async function downloadPlugin(pluginKey, requestedVersion) {
     );
   }
   const tgzPath = getTempFilePath(pluginKey, pluginInfo.version);
-  fs8.writeFileSync(tgzPath, tgzBuffer);
+  fs11.writeFileSync(tgzPath, tgzBuffer);
   console.log(`[action-plugin] Downloaded to ${tgzPath} (${(tgzBuffer.length / 1024).toFixed(2)} KB)`);
   return {
     tgzPath,
@@ -2731,18 +3128,18 @@ function getCachePath(pluginKey, version) {
   ensureCacheDir();
   const safeKey = pluginKey.replace(/[/@]/g, "_");
   const filename = `${safeKey}@${version}.tgz`;
-  return path6.join(getPluginCacheDir(), filename);
+  return path9.join(getPluginCacheDir(), filename);
 }
 function hasCachedPlugin(pluginKey, version) {
   const cachePath = getCachePath(pluginKey, version);
-  return fs8.existsSync(cachePath);
+  return fs11.existsSync(cachePath);
 }
 function listCachedPlugins() {
   const cacheDir = getPluginCacheDir();
-  if (!fs8.existsSync(cacheDir)) {
+  if (!fs11.existsSync(cacheDir)) {
     return [];
   }
-  const files = fs8.readdirSync(cacheDir);
+  const files = fs11.readdirSync(cacheDir);
   const result = [];
   for (const file of files) {
     if (!file.endsWith(".tgz")) continue;
@@ -2750,8 +3147,8 @@ function listCachedPlugins() {
     if (!match) continue;
     const [, rawName, version] = match;
     const name = rawName.replace(/^_/, "@").replace(/_/, "/");
-    const filePath = path6.join(cacheDir, file);
-    const stat = fs8.statSync(filePath);
+    const filePath = path9.join(cacheDir, file);
+    const stat = fs11.statSync(filePath);
     result.push({
       name,
       version,
@@ -2764,14 +3161,14 @@ function listCachedPlugins() {
 }
 function cleanAllCache() {
   const cacheDir = getPluginCacheDir();
-  if (!fs8.existsSync(cacheDir)) {
+  if (!fs11.existsSync(cacheDir)) {
     return 0;
   }
-  const files = fs8.readdirSync(cacheDir);
+  const files = fs11.readdirSync(cacheDir);
   let count = 0;
   for (const file of files) {
     if (file.endsWith(".tgz")) {
-      fs8.unlinkSync(path6.join(cacheDir, file));
+      fs11.unlinkSync(path9.join(cacheDir, file));
       count++;
     }
   }
@@ -2779,21 +3176,21 @@ function cleanAllCache() {
 }
 function cleanPluginCache(pluginKey, version) {
   const cacheDir = getPluginCacheDir();
-  if (!fs8.existsSync(cacheDir)) {
+  if (!fs11.existsSync(cacheDir)) {
     return 0;
   }
   const safeKey = pluginKey.replace(/[/@]/g, "_");
-  const files = fs8.readdirSync(cacheDir);
+  const files = fs11.readdirSync(cacheDir);
   let count = 0;
   for (const file of files) {
     if (version) {
       if (file === `${safeKey}@${version}.tgz`) {
-        fs8.unlinkSync(path6.join(cacheDir, file));
+        fs11.unlinkSync(path9.join(cacheDir, file));
         count++;
       }
     } else {
       if (file.startsWith(`${safeKey}@`) && file.endsWith(".tgz")) {
-        fs8.unlinkSync(path6.join(cacheDir, file));
+        fs11.unlinkSync(path9.join(cacheDir, file));
         count++;
       }
     }
@@ -2887,6 +3284,8 @@ async function installOne(nameWithVersion) {
       if (actualVersion === requestedVersion) {
         console.log(`[action-plugin] Plugin ${name}@${requestedVersion} is already installed`);
         syncActionPluginsRecord(name, actualVersion);
+        reportCreateInstanceEvent(name, actualVersion).catch(() => {
+        });
         return { name, version: actualVersion, success: true, skipped: true };
       }
     }
@@ -2897,6 +3296,8 @@ async function installOne(nameWithVersion) {
       if (actualVersion === targetVersion) {
         console.log(`[action-plugin] Plugin ${name} is already up to date (version: ${actualVersion})`);
         syncActionPluginsRecord(name, actualVersion);
+        reportCreateInstanceEvent(name, actualVersion).catch(() => {
+        });
         return { name, version: actualVersion, success: true, skipped: true };
       }
       console.log(`[action-plugin] Found newer version: ${targetVersion} (installed: ${actualVersion || "none"})`);
@@ -2927,6 +3328,10 @@ async function installOne(nameWithVersion) {
     writeActionPlugins(plugins);
     const source = fromCache ? "from cache" : "downloaded";
     console.log(`[action-plugin] Successfully installed ${name}@${installedVersion} (${source})`);
+    reportInstallEvent(name, installedVersion).catch(() => {
+    });
+    reportCreateInstanceEvent(name, installedVersion).catch(() => {
+    });
     return { name, version: installedVersion, success: true };
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -3212,40 +3617,40 @@ var actionPluginCommandGroup = {
 };
 
 // src/commands/capability/utils.ts
-import fs9 from "fs";
+import fs12 from "fs";
 import { createRequire as createRequire2 } from "module";
-import path7 from "path";
+import path10 from "path";
 var CAPABILITIES_DIR = "server/capabilities";
 function getProjectRoot2() {
   return process.cwd();
 }
 function getCapabilitiesDir() {
-  return path7.join(getProjectRoot2(), CAPABILITIES_DIR);
+  return path10.join(getProjectRoot2(), CAPABILITIES_DIR);
 }
 function getCapabilityPath(id) {
-  return path7.join(getCapabilitiesDir(), `${id}.json`);
+  return path10.join(getCapabilitiesDir(), `${id}.json`);
 }
 function getPluginManifestPath(pluginKey) {
-  return path7.join(getProjectRoot2(), "node_modules", pluginKey, "manifest.json");
+  return path10.join(getProjectRoot2(), "node_modules", pluginKey, "manifest.json");
 }
 function capabilitiesDirExists() {
-  return fs9.existsSync(getCapabilitiesDir());
+  return fs12.existsSync(getCapabilitiesDir());
 }
 function listCapabilityIds() {
   const dir = getCapabilitiesDir();
-  if (!fs9.existsSync(dir)) {
+  if (!fs12.existsSync(dir)) {
     return [];
   }
-  const files = fs9.readdirSync(dir);
+  const files = fs12.readdirSync(dir);
   return files.filter((f) => f.endsWith(".json") && f !== "capabilities.json").map((f) => f.replace(/\.json$/, ""));
 }
 function readCapability(id) {
   const filePath = getCapabilityPath(id);
-  if (!fs9.existsSync(filePath)) {
+  if (!fs12.existsSync(filePath)) {
     throw new Error(`Capability not found: ${id}`);
   }
   try {
-    const content = fs9.readFileSync(filePath, "utf-8");
+    const content = fs12.readFileSync(filePath, "utf-8");
     return JSON.parse(content);
   } catch (error) {
     if (error instanceof SyntaxError) {
@@ -3272,11 +3677,11 @@ function readAllCapabilities() {
 }
 function readPluginManifest(pluginKey) {
   const manifestPath = getPluginManifestPath(pluginKey);
-  if (!fs9.existsSync(manifestPath)) {
+  if (!fs12.existsSync(manifestPath)) {
     throw new Error(`Plugin not installed: ${pluginKey} (manifest.json not found)`);
   }
   try {
-    const content = fs9.readFileSync(manifestPath, "utf-8");
+    const content = fs12.readFileSync(manifestPath, "utf-8");
     return JSON.parse(content);
   } catch (error) {
     if (error instanceof SyntaxError) {
@@ -3293,7 +3698,7 @@ function hasValidParamsSchema(paramsSchema) {
 }
 async function loadPlugin(pluginKey) {
   try {
-    const userRequire = createRequire2(path7.join(getProjectRoot2(), "package.json"));
+    const userRequire = createRequire2(path10.join(getProjectRoot2(), "package.json"));
     const resolvedPath = userRequire.resolve(pluginKey);
     const pluginModule = await import(resolvedPath);
     const pluginPackage = pluginModule.default ?? pluginModule;
@@ -3452,59 +3857,358 @@ 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";
+import os from "os";
+
+// src/commands/component/service.ts
+import { mapValues } from "es-toolkit";
+
+// src/commands/component/utils.ts
+import createDebug from "debug";
+var debug = createDebug("component");
+
+// src/commands/component/service.ts
+async function getComponents(keys) {
+  const client = getHttpClient();
+  debug("\u8C03\u7528 /components/batch_get %o", keys);
+  const response = await client.post(
+    `/api/v1/studio/innerapi/components/batch_get?keys=${keys.join(",")}`
+  );
+  if (response.status !== 200) {
+    throw new Error(
+      `\u83B7\u53D6\u7EC4\u4EF6\u4FE1\u606F\u5931\u8D25\uFF1A${response.status} ${response.statusText}`
+    );
+  }
+  const result = await response.json();
+  if (result.status_code !== "0") {
+    debug("\u63A5\u53E3\u8FD4\u56DE\u9519\u8BEF\uFF1A%o", result);
+    throw new Error(`\u83B7\u53D6\u7EC4\u4EF6\u4FE1\u606F\u5931\u8D25\uFF1A${result.error_msg}`);
+  }
+  return mapValues(result.data.components, ([component]) => component);
+}
+async function getRegistryItem(url) {
+  const client = getHttpClient();
+  debug("\u4E0B\u8F7D registry-item.json\uFF1A%s", url);
+  const response = await client.get(url);
+  if (!response.ok) {
+    throw new Error(
+      `\u4E0B\u8F7D registry-item.json \u5931\u8D25\uFF1A${response.status} ${response.statusText}`
+    );
+  }
+  const item = await response.json();
+  return item;
+}
+async function sendInstallEvent(key) {
+  const client = getHttpClient();
+  await client.post("/api/v1/studio/innerapi/resource_events", {
+    events: [
+      {
+        resourceType: "component",
+        resourceKey: key,
+        eventType: "install",
+        details: {}
+      }
+    ]
+  });
+}
+
+// src/commands/component/registry-preparer.ts
+var REGISTRY_TEMP_DIR = path11.join(os.tmpdir(), "miaoda-registry");
+function parseComponentKey(key) {
+  const match = key.match(/^@([^/]+)\/(.+)$/);
+  if (!match) {
+    throw new Error(
+      `Invalid component key format: ${key}. Expected format: @scope/name`
+    );
+  }
+  return { scope: match[1], name: match[2] };
+}
+function getLocalRegistryPath(key) {
+  const { scope, name } = parseComponentKey(key);
+  return path11.join(REGISTRY_TEMP_DIR, scope, `${name}.json`);
+}
+function ensureDir(dirPath) {
+  if (!fs13.existsSync(dirPath)) {
+    fs13.mkdirSync(dirPath, { recursive: true });
+  }
+}
+async function prepareRecursive(key, visited) {
+  if (visited.has(key)) {
+    debug("\u8DF3\u8FC7\u5DF2\u5904\u7406\u7684\u7EC4\u4EF6: %s", key);
+    return;
+  }
+  visited.add(key);
+  debug("\u5904\u7406\u7EC4\u4EF6: %s", key);
+  debug("\u83B7\u53D6\u7EC4\u4EF6\u4E0B\u8F7D\u4FE1\u606F...");
+  const infoMap = await getComponents([key]);
+  const info = infoMap[key];
+  debug("\u7EC4\u4EF6\u4FE1\u606F: %o", info);
+  if (!info) {
+    throw new Error(`Component not found: ${key}`);
+  }
+  if (info.status !== "active") {
+    throw new Error(`Component is not active: ${key}`);
+  }
+  debug("\u4E0B\u8F7D registry item: %s", info.downloadURL);
+  const registryItem = await getRegistryItem(info.downloadURL);
+  debug("registry item \u5185\u5BB9: %o", registryItem);
+  const deps = registryItem.registryDependencies || [];
+  debug("\u4F9D\u8D56\u5217\u8868: %o", deps);
+  for (const dep of deps) {
+    await prepareRecursive(dep, visited);
+  }
+  const rewrittenItem = {
+    ...registryItem,
+    registryDependencies: deps.map((dep) => getLocalRegistryPath(dep))
+  };
+  const localPath = getLocalRegistryPath(key);
+  ensureDir(path11.dirname(localPath));
+  fs13.writeFileSync(localPath, JSON.stringify(rewrittenItem, null, 2), "utf-8");
+  debug("\u4FDD\u5B58\u5230: %s", localPath);
+}
+async function prepareComponentRegistryItems(id) {
+  const visited = /* @__PURE__ */ new Set();
+  await prepareRecursive(id, visited);
+  return getLocalRegistryPath(id);
+}
+function cleanupTempDir() {
+  try {
+    if (fs13.existsSync(REGISTRY_TEMP_DIR)) {
+      fs13.rmSync(REGISTRY_TEMP_DIR, { recursive: true, force: true });
+    }
+  } catch {
+  }
+}
+function getDownloadedRegistryItem(itemId) {
+  const localPath = getLocalRegistryPath(itemId);
+  if (!fs13.existsSync(localPath)) {
+    return null;
+  }
+  const content = fs13.readFileSync(localPath, "utf-8");
+  return JSON.parse(content);
+}
+
+// src/commands/component/shadcn-executor.ts
+import * as pty from "@lydell/node-pty";
+function parseOutput(output) {
+  const state = {
+    currentSection: null,
+    files: /* @__PURE__ */ new Set()
+  };
+  const lines = output.split("\n");
+  for (const line of lines) {
+    const trimmedLine = line.trim();
+    if (/Created \d+ files?:/.test(trimmedLine)) {
+      state.currentSection = "created";
+      continue;
+    }
+    if (/Updated \d+ files?:/.test(trimmedLine)) {
+      state.currentSection = "updated";
+      continue;
+    }
+    if (/Skipped \d+ files?:/.test(trimmedLine)) {
+      state.currentSection = "skipped";
+      continue;
+    }
+    if (state.currentSection && trimmedLine.startsWith("- ")) {
+      const filePath = trimmedLine.slice(2).trim();
+      if (filePath && filePath.includes("/")) {
+        state.files.add(filePath);
+      }
+    }
+    if (state.currentSection && trimmedLine.length > 1 && !trimmedLine.startsWith("- ")) {
+      state.currentSection = null;
+    }
+  }
+  return Array.from(state.files);
+}
+function toFileInfo(filePath) {
+  const name = filePath.split("/").pop() || filePath;
+  return { name, path: filePath };
+}
+var PROMPT_PATTERNS = [
+  // 文件覆盖确认 - 回答 n（不覆盖）
+  { pattern: /overwrite/i, answer: "n\n" },
+  // 主题/样式选择 - 回答 n（不安装额外主题）
+  { pattern: /theme/i, answer: "n\n" },
+  { pattern: /style/i, answer: "n\n" },
+  // 继续确认 - 回答 y
+  { pattern: /continue\?/i, answer: "y\n" },
+  { pattern: /proceed\?/i, answer: "y\n" }
+];
+async function executeShadcnAdd(registryItemPath) {
+  return new Promise((resolve) => {
+    let output = "";
+    const args = ["--yes", "shadcn@3.8.2", "add", registryItemPath];
+    const ptyProcess = pty.spawn("npx", args, {
+      name: "xterm-color",
+      cols: 120,
+      rows: 30,
+      cwd: process.cwd(),
+      env: {
+        ...process.env,
+        // 禁用颜色输出以便解析
+        NO_COLOR: "1",
+        FORCE_COLOR: "0"
+      }
+    });
+    ptyProcess.onData((data) => {
+      output += data;
+      for (const { pattern, answer } of PROMPT_PATTERNS) {
+        if (pattern.test(data)) {
+          ptyProcess.write(answer);
+          return;
+        }
+      }
+    });
+    const timeoutId = setTimeout(() => {
+      ptyProcess.kill();
+      resolve({
+        success: false,
+        files: [],
+        error: "\u6267\u884C\u8D85\u65F6"
+      });
+    }, 3 * 60 * 1e3);
+    ptyProcess.onExit(({ exitCode }) => {
+      clearTimeout(timeoutId);
+      const success = exitCode === 0;
+      const filePaths = parseOutput(output);
+      const files = filePaths.map(toFileInfo);
+      resolve({
+        success,
+        files,
+        error: success ? void 0 : output || `Process exited with code ${exitCode}`
+      });
+    });
+  });
+}
+
+// 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));
+}
+async function addComponent(key) {
+  debug("\u5F00\u59CB\u5B89\u88C5\u7EC4\u4EF6: %s", key);
+  debug("\u51C6\u5907 registry items...");
+  const registryItemPath = await prepareComponentRegistryItems(key);
+  debug("registry item \u8DEF\u5F84: %s", registryItemPath);
+  const registryItem = getDownloadedRegistryItem(key);
+  debug("\u83B7\u53D6\u5230 registry item: %o", registryItem);
+  debug("\u6267\u884C shadcn add...");
+  const executeResult = await executeShadcnAdd(registryItemPath);
+  debug("shadcn \u6267\u884C\u7ED3\u679C: %o", executeResult);
+  if (!executeResult.success) {
+    throw new Error(executeResult.error || "\u5B89\u88C5\u5931\u8D25\uFF0C\u672A\u77E5\u539F\u56E0");
+  }
+  return {
+    success: true,
+    name: key,
+    description: registryItem?.description || "",
+    files: executeResult.files,
+    docs: registryItem?.docs || ""
+  };
+}
+async function add(key) {
+  try {
+    const result = await addComponent(key);
+    printResult(result);
+    void sendInstallEvent(key);
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : "\u5B89\u88C5\u5931\u8D25\uFF0C\u539F\u56E0\u672A\u77E5";
+    printResult({
+      success: false,
+      errors: [{ message: errorMessage }]
+    });
+  } finally {
+    await runActionPluginInit();
+    cleanupTempDir();
+  }
+}
+
+// src/commands/component/index.ts
+var addCommand = {
+  name: "add",
+  description: "\u5B89\u88C5\u5999\u642D\u7EC4\u4EF6\u5E02\u573A\u4E2D\u7684\u7EC4\u4EF6",
+  register(program) {
+    program.command(this.name).description(this.description).argument("<component>", "\u7EC4\u4EF6 ID (\u4F8B\u5982 @miaoda/button)").action(async (component) => {
+      await add(component);
+    });
+  }
+};
+var componentCommandGroup = {
+  name: "component",
+  description: "\u7EC4\u4EF6\u76F8\u5173\u547D\u4EE4",
+  commands: [addCommand]
+};
+
 // src/commands/migration/version-manager.ts
-import fs10 from "fs";
-import path8 from "path";
+import fs14 from "fs";
+import path12 from "path";
 var PACKAGE_JSON = "package.json";
 var VERSION_FIELD = "migrationVersion";
 function getPackageJsonPath2() {
-  return path8.join(process.cwd(), PACKAGE_JSON);
+  return path12.join(process.cwd(), PACKAGE_JSON);
 }
 function getCurrentVersion() {
   const pkgPath = getPackageJsonPath2();
-  if (!fs10.existsSync(pkgPath)) {
+  if (!fs14.existsSync(pkgPath)) {
     throw new Error("package.json not found");
   }
-  const pkg2 = JSON.parse(fs10.readFileSync(pkgPath, "utf-8"));
+  const pkg2 = JSON.parse(fs14.readFileSync(pkgPath, "utf-8"));
   return pkg2[VERSION_FIELD] ?? 0;
 }
 function setCurrentVersion(version) {
   const pkgPath = getPackageJsonPath2();
-  const pkg2 = JSON.parse(fs10.readFileSync(pkgPath, "utf-8"));
+  const pkg2 = JSON.parse(fs14.readFileSync(pkgPath, "utf-8"));
   pkg2[VERSION_FIELD] = version;
-  fs10.writeFileSync(pkgPath, JSON.stringify(pkg2, null, 2) + "\n", "utf-8");
+  fs14.writeFileSync(pkgPath, JSON.stringify(pkg2, null, 2) + "\n", "utf-8");
 }
 
 // src/commands/migration/versions/v001_capability/json-migrator/detector.ts
-import fs12 from "fs";
-import path10 from "path";
+import fs16 from "fs";
+import path14 from "path";
 
 // src/commands/migration/versions/v001_capability/utils.ts
-import fs11 from "fs";
-import path9 from "path";
+import fs15 from "fs";
+import path13 from "path";
 var CAPABILITIES_DIR2 = "server/capabilities";
 function getProjectRoot3() {
   return process.cwd();
 }
 function getCapabilitiesDir2() {
-  return path9.join(getProjectRoot3(), CAPABILITIES_DIR2);
+  return path13.join(getProjectRoot3(), CAPABILITIES_DIR2);
 }
 function getPluginManifestPath2(pluginKey) {
-  return path9.join(getProjectRoot3(), "node_modules", pluginKey, "manifest.json");
+  return path13.join(getProjectRoot3(), "node_modules", pluginKey, "manifest.json");
 }
 
 // src/commands/migration/versions/v001_capability/json-migrator/detector.ts
 function detectJsonMigration() {
   const capabilitiesDir = getCapabilitiesDir2();
-  const oldFilePath = path10.join(capabilitiesDir, "capabilities.json");
-  if (!fs12.existsSync(oldFilePath)) {
+  const oldFilePath = path14.join(capabilitiesDir, "capabilities.json");
+  if (!fs16.existsSync(oldFilePath)) {
     return {
       needsMigration: false,
       reason: "capabilities.json not found"
     };
   }
   try {
-    const content = fs12.readFileSync(oldFilePath, "utf-8");
+    const content = fs16.readFileSync(oldFilePath, "utf-8");
     const parsed = JSON.parse(content);
     if (!Array.isArray(parsed)) {
       return {
@@ -3555,8 +4259,8 @@ async function check(options) {
 }
 
 // src/commands/migration/versions/v001_capability/json-migrator/index.ts
-import fs13 from "fs";
-import path11 from "path";
+import fs17 from "fs";
+import path15 from "path";
 
 // src/commands/migration/versions/v001_capability/mapping.ts
 var DEFAULT_PLUGIN_VERSION = "1.0.0";
@@ -3786,18 +4490,18 @@ function transformCapabilities(oldCapabilities) {
 // src/commands/migration/versions/v001_capability/json-migrator/index.ts
 function loadExistingCapabilities() {
   const capabilitiesDir = getCapabilitiesDir2();
-  if (!fs13.existsSync(capabilitiesDir)) {
+  if (!fs17.existsSync(capabilitiesDir)) {
     return [];
   }
-  const files = fs13.readdirSync(capabilitiesDir);
+  const files = fs17.readdirSync(capabilitiesDir);
   const capabilities = [];
   for (const file of files) {
     if (file === "capabilities.json" || !file.endsWith(".json")) {
       continue;
     }
     try {
-      const filePath = path11.join(capabilitiesDir, file);
-      const content = fs13.readFileSync(filePath, "utf-8");
+      const filePath = path15.join(capabilitiesDir, file);
+      const content = fs17.readFileSync(filePath, "utf-8");
       const capability = JSON.parse(content);
       if (capability.id && capability.pluginKey) {
         capabilities.push(capability);
@@ -3855,9 +4559,9 @@ async function migrateJsonFiles(options) {
   }
   const capabilitiesDir = getCapabilitiesDir2();
   for (const cap of newCapabilities) {
-    const filePath = path11.join(capabilitiesDir, `${cap.id}.json`);
+    const filePath = path15.join(capabilitiesDir, `${cap.id}.json`);
     const content = JSON.stringify(cap, null, 2);
-    fs13.writeFileSync(filePath, content, "utf-8");
+    fs17.writeFileSync(filePath, content, "utf-8");
     console.log(`   \u2713 Created: ${cap.id}.json`);
   }
   return {
@@ -3869,11 +4573,11 @@ async function migrateJsonFiles(options) {
 }
 
 // src/commands/migration/versions/v001_capability/plugin-installer/detector.ts
-import fs14 from "fs";
+import fs18 from "fs";
 function isPluginInstalled2(pluginKey) {
   const actionPlugins = readActionPlugins();
   const manifestPath = getPluginManifestPath2(pluginKey);
-  return fs14.existsSync(manifestPath) && !!actionPlugins[pluginKey];
+  return fs18.existsSync(manifestPath) && !!actionPlugins[pluginKey];
 }
 function detectPluginsToInstall(capabilities) {
   const pluginKeys = /* @__PURE__ */ new Set();
@@ -3949,12 +4653,12 @@ async function installPlugins(capabilities, options) {
 }
 
 // src/commands/migration/versions/v001_capability/code-migrator/index.ts
-import path13 from "path";
+import path17 from "path";
 import { Project as Project3 } from "ts-morph";
 
 // src/commands/migration/versions/v001_capability/code-migrator/scanner.ts
-import fs15 from "fs";
-import path12 from "path";
+import fs19 from "fs";
+import path16 from "path";
 var EXCLUDED_DIRS = [
   "node_modules",
   "dist",
@@ -3969,9 +4673,9 @@ var EXCLUDED_PATTERNS = [
   /\.d\.ts$/
 ];
 function scanDirectory(dir, files = []) {
-  const entries = fs15.readdirSync(dir, { withFileTypes: true });
+  const entries = fs19.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = path12.join(dir, entry.name);
+    const fullPath = path16.join(dir, entry.name);
     if (entry.isDirectory()) {
       if (EXCLUDED_DIRS.includes(entry.name)) {
         continue;
@@ -3987,14 +4691,14 @@ function scanDirectory(dir, files = []) {
   return files;
 }
 function scanServerFiles() {
-  const serverDir = path12.join(getProjectRoot3(), "server");
-  if (!fs15.existsSync(serverDir)) {
+  const serverDir = path16.join(getProjectRoot3(), "server");
+  if (!fs19.existsSync(serverDir)) {
     return [];
   }
   return scanDirectory(serverDir);
 }
 function hasCapabilityImport(filePath) {
-  const content = fs15.readFileSync(filePath, "utf-8");
+  const content = fs19.readFileSync(filePath, "utf-8");
   return /import\s+.*from\s+['"][^'"]*capabilities[^'"]*['"]/.test(content);
 }
 function scanFilesToMigrate() {
@@ -4371,7 +5075,7 @@ function analyzeFile(project, filePath, actionNameMap) {
   const callSites = analyzeCallSites(sourceFile, imports);
   const classInfo = analyzeClass(sourceFile);
   const { canMigrate, reason } = canAutoMigrate(classInfo);
-  const relativePath = path13.relative(getProjectRoot3(), filePath);
+  const relativePath = path17.relative(getProjectRoot3(), filePath);
   return {
     filePath: relativePath,
     imports,
@@ -4382,7 +5086,7 @@ function analyzeFile(project, filePath, actionNameMap) {
   };
 }
 function migrateFile(project, analysis, dryRun) {
-  const absolutePath = path13.join(getProjectRoot3(), analysis.filePath);
+  const absolutePath = path17.join(getProjectRoot3(), analysis.filePath);
   if (!analysis.canAutoMigrate) {
     return {
       filePath: analysis.filePath,
@@ -4485,17 +5189,17 @@ function getSuggestion(analysis) {
 }
 
 // src/commands/migration/versions/v001_capability/cleanup.ts
-import fs16 from "fs";
-import path14 from "path";
+import fs20 from "fs";
+import path18 from "path";
 function cleanupOldFiles(capabilities, dryRun) {
   const deletedFiles = [];
   const errors = [];
   const capabilitiesDir = getCapabilitiesDir2();
-  const oldJsonPath = path14.join(capabilitiesDir, "capabilities.json");
-  if (fs16.existsSync(oldJsonPath)) {
+  const oldJsonPath = path18.join(capabilitiesDir, "capabilities.json");
+  if (fs20.existsSync(oldJsonPath)) {
     try {
       if (!dryRun) {
-        fs16.unlinkSync(oldJsonPath);
+        fs20.unlinkSync(oldJsonPath);
       }
       deletedFiles.push("capabilities.json");
     } catch (error) {
@@ -4503,11 +5207,11 @@ function cleanupOldFiles(capabilities, dryRun) {
     }
   }
   for (const cap of capabilities) {
-    const tsFilePath = path14.join(capabilitiesDir, `${cap.id}.ts`);
-    if (fs16.existsSync(tsFilePath)) {
+    const tsFilePath = path18.join(capabilitiesDir, `${cap.id}.ts`);
+    if (fs20.existsSync(tsFilePath)) {
       try {
         if (!dryRun) {
-          fs16.unlinkSync(tsFilePath);
+          fs20.unlinkSync(tsFilePath);
         }
         deletedFiles.push(`${cap.id}.ts`);
       } catch (error) {
@@ -4523,8 +5227,8 @@ function cleanupOldFiles(capabilities, dryRun) {
 }
 
 // src/commands/migration/versions/v001_capability/report-generator.ts
-import fs17 from "fs";
-import path15 from "path";
+import fs21 from "fs";
+import path19 from "path";
 var REPORT_FILE = "capability-migration-report.md";
 function printSummary(result) {
   const { jsonMigration, pluginInstallation, codeMigration, cleanup } = result;
@@ -4687,15 +5391,15 @@ async function generateReport(result) {
   }
   lines.push("");
   const logDir = process.env.LOG_DIR || "logs";
-  if (!fs17.existsSync(logDir)) {
+  if (!fs21.existsSync(logDir)) {
     return;
   }
-  const reportDir = path15.join(logDir, "migration");
-  if (!fs17.existsSync(reportDir)) {
-    fs17.mkdirSync(reportDir, { recursive: true });
+  const reportDir = path19.join(logDir, "migration");
+  if (!fs21.existsSync(reportDir)) {
+    fs21.mkdirSync(reportDir, { recursive: true });
   }
-  const reportPath = path15.join(reportDir, REPORT_FILE);
-  fs17.writeFileSync(reportPath, lines.join("\n"), "utf-8");
+  const reportPath = path19.join(reportDir, REPORT_FILE);
+  fs21.writeFileSync(reportPath, lines.join("\n"), "utf-8");
   console.log(`\u{1F4C4} Report generated: ${reportPath}`);
 }
 
@@ -4872,7 +5576,7 @@ function buildResult(jsonMigration, pluginInstallation, codeMigration, cleanup)
 }
 
 // src/commands/migration/versions/v001_capability/run.ts
-async function run3(options) {
+async function run5(options) {
   try {
     const migrationOptions = {
       dryRun: options.dryRun ?? false
@@ -4937,7 +5641,7 @@ var v001CapabilityMigration = {
   name: "capability",
   description: "Migrate capability configurations from old format (capabilities.json array) to new format (individual JSON files)",
   check,
-  run: run3
+  run: run5
 };
 
 // src/commands/migration/versions/index.ts
@@ -5227,10 +5931,10 @@ var migrationCommand = {
 };
 
 // src/commands/read-logs/index.ts
-import path16 from "path";
+import path20 from "path";
 
 // src/commands/read-logs/std-utils.ts
-import fs18 from "fs";
+import fs22 from "fs";
 function formatStdPrefixTime(localTime) {
   const match = localTime.match(/^(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})$/);
   if (!match) return localTime;
@@ -5260,11 +5964,11 @@ function stripPrefixFromStdLine(line) {
   return `[${time}] ${content}`;
 }
 function readStdLinesTailFromLastMarkerPaged(filePath, maxLines, offset, isMarker) {
-  const stat = fs18.statSync(filePath);
+  const stat = fs22.statSync(filePath);
   if (stat.size === 0) {
     return { lines: [], markerFound: false, totalLinesCount: 0 };
   }
-  const fd = fs18.openSync(filePath, "r");
+  const fd = fs22.openSync(filePath, "r");
   const chunkSize = 64 * 1024;
   let position = stat.size;
   let remainder = "";
@@ -5278,7 +5982,7 @@ function readStdLinesTailFromLastMarkerPaged(filePath, maxLines, offset, isMarke
       const length = Math.min(chunkSize, position);
       position -= length;
       const buffer = Buffer.alloc(length);
-      fs18.readSync(fd, buffer, 0, length, position);
+      fs22.readSync(fd, buffer, 0, length, position);
       let chunk = buffer.toString("utf8");
       if (remainder) {
         chunk += remainder;
@@ -5320,7 +6024,7 @@ function readStdLinesTailFromLastMarkerPaged(filePath, maxLines, offset, isMarke
       }
     }
   } finally {
-    fs18.closeSync(fd);
+    fs22.closeSync(fd);
   }
   return { lines: collected.reverse(), markerFound, totalLinesCount };
 }
@@ -5341,21 +6045,21 @@ function readServerStdSegment(filePath, maxLines, offset) {
 }
 
 // src/commands/read-logs/tail.ts
-import fs19 from "fs";
+import fs23 from "fs";
 function fileExists(filePath) {
   try {
-    fs19.accessSync(filePath, fs19.constants.F_OK | fs19.constants.R_OK);
+    fs23.accessSync(filePath, fs23.constants.F_OK | fs23.constants.R_OK);
     return true;
   } catch {
     return false;
   }
 }
 function readFileTailLines(filePath, maxLines) {
-  const stat = fs19.statSync(filePath);
+  const stat = fs23.statSync(filePath);
   if (stat.size === 0) {
     return [];
   }
-  const fd = fs19.openSync(filePath, "r");
+  const fd = fs23.openSync(filePath, "r");
   const chunkSize = 64 * 1024;
   const chunks = [];
   let position = stat.size;
@@ -5365,13 +6069,13 @@ function readFileTailLines(filePath, maxLines) {
       const length = Math.min(chunkSize, position);
       position -= length;
       const buffer = Buffer.alloc(length);
-      fs19.readSync(fd, buffer, 0, length, position);
+      fs23.readSync(fd, buffer, 0, length, position);
       chunks.unshift(buffer.toString("utf8"));
       const chunkLines = buffer.toString("utf8").split("\n").length - 1;
       collectedLines += chunkLines;
     }
   } finally {
-    fs19.closeSync(fd);
+    fs23.closeSync(fd);
   }
   const content = chunks.join("");
   const allLines = content.split("\n");
@@ -5387,11 +6091,11 @@ function readFileTailLines(filePath, maxLines) {
   return allLines.slice(allLines.length - maxLines);
 }
 function readFileTailNonEmptyLinesWithOffset(filePath, maxLines, offset) {
-  const stat = fs19.statSync(filePath);
+  const stat = fs23.statSync(filePath);
   if (stat.size === 0) {
     return { lines: [], totalLinesCount: 0 };
   }
-  const fd = fs19.openSync(filePath, "r");
+  const fd = fs23.openSync(filePath, "r");
   const chunkSize = 64 * 1024;
   let position = stat.size;
   let remainder = "";
@@ -5403,7 +6107,7 @@ function readFileTailNonEmptyLinesWithOffset(filePath, maxLines, offset) {
       const length = Math.min(chunkSize, position);
       position -= length;
       const buffer = Buffer.alloc(length);
-      fs19.readSync(fd, buffer, 0, length, position);
+      fs23.readSync(fd, buffer, 0, length, position);
       let chunk = buffer.toString("utf8");
       if (remainder) {
         chunk += remainder;
@@ -5434,7 +6138,7 @@ function readFileTailNonEmptyLinesWithOffset(filePath, maxLines, offset) {
       }
     }
   } finally {
-    fs19.closeSync(fd);
+    fs23.closeSync(fd);
   }
   return { lines: collected.reverse(), totalLinesCount };
 }
@@ -5447,13 +6151,19 @@ function readClientStdSegment(filePath, maxLines, offset) {
 function extractClientStdSegment(lines, maxLines, offset) {
   const bodyLines = lines.map(stripPrefixFromStdLine);
   const hotStartMarkers = [
+    // Webpack markers
     /file change detected\..*incremental compilation/i,
     /starting incremental compilation/i,
     /starting compilation/i,
     /\bcompiling\b/i,
-    /\brecompil/i
+    /\brecompil/i,
+    // Vite markers - format: "3:11:46 PM [vite] (client) hmr update ..."
+    /VITE v[\d.]+.*ready/i,
+    /\[vite\].*page reload/i,
+    /\[vite\].*hmr update/i
   ];
   const hotEndMarkers = [
+    // Webpack markers
     /file change detected\..*incremental compilation/i,
     /\bwebpack compiled\b/i,
     /compiled successfully/i,
@@ -5464,14 +6174,25 @@ function extractClientStdSegment(lines, maxLines, offset) {
     /\bhmr\b/i,
     /hot update/i,
     /\bhot reload\b/i,
-    /\bhmr update\b/i
+    /\bhmr update\b/i,
+    // Vite markers
+    /VITE v[\d.]+.*ready/i,
+    /\[vite\].*page reload/i,
+    /\[vite\].*hmr update/i,
+    /\[vite\].*hmr invalidate/i,
+    /\[vite\].*internal server error/i,
+    /\[vite\].*pre-transform error/i
   ];
   const compiledMarkers = [
+    // Webpack markers
     /\bwebpack compiled\b/i,
     /compiled successfully/i,
     /compiled with warnings/i,
     /compiled with errors/i,
-    /failed to compile/i
+    /failed to compile/i,
+    // Vite markers
+    /VITE v[\d.]+.*ready/i,
+    /\[vite\].*hmr update/i
   ];
   let startIndex = -1;
   for (let i = bodyLines.length - 1; i >= 0; i -= 1) {
@@ -5524,14 +6245,15 @@ function extractClientStdSegment(lines, maxLines, offset) {
   }
   const segment = startIndex === -1 ? bodyLines : bodyLines.slice(startIndex);
   if (segment.length === 0) {
-    return { lines: [], totalLinesCount: 0 };
+    return { lines: [], totalLinesCount: 0, allLines: [] };
   }
   const totalLinesCount = segment.length;
   const endExclusive = Math.max(0, segment.length - offset);
   const start = Math.max(0, endExclusive - maxLines);
   return {
     lines: segment.slice(start, endExclusive),
-    totalLinesCount
+    totalLinesCount,
+    allLines: segment
   };
 }
 
@@ -5558,7 +6280,7 @@ function readDevStdSegment(filePath, maxLines, offset) {
 }
 
 // src/commands/read-logs/json-lines.ts
-import fs20 from "fs";
+import fs24 from "fs";
 function normalizePid(value) {
   if (typeof value === "number") {
     return String(value);
@@ -5609,11 +6331,11 @@ function buildWantedLevelSet(levels) {
   return set.size > 0 ? set : null;
 }
 function readJsonLinesLastPid(filePath, maxLines, offset, levels) {
-  const stat = fs20.statSync(filePath);
+  const stat = fs24.statSync(filePath);
   if (stat.size === 0) {
     return { lines: [], totalLinesCount: 0 };
   }
-  const fd = fs20.openSync(filePath, "r");
+  const fd = fs24.openSync(filePath, "r");
   const chunkSize = 64 * 1024;
   let position = stat.size;
   let remainder = "";
@@ -5628,7 +6350,7 @@ function readJsonLinesLastPid(filePath, maxLines, offset, levels) {
       const length = Math.min(chunkSize, position);
       position -= length;
       const buffer = Buffer.alloc(length);
-      fs20.readSync(fd, buffer, 0, length, position);
+      fs24.readSync(fd, buffer, 0, length, position);
       let chunk = buffer.toString("utf8");
       if (remainder) {
         chunk += remainder;
@@ -5690,7 +6412,7 @@ function readJsonLinesLastPid(filePath, maxLines, offset, levels) {
       }
     }
   } finally {
-    fs20.closeSync(fd);
+    fs24.closeSync(fd);
   }
   return { lines: collected.reverse(), totalLinesCount };
 }
@@ -5733,11 +6455,11 @@ function extractTraceId(obj) {
 function readJsonLinesByTraceId(filePath, traceId, maxLines, offset, levels) {
   const wanted = traceId.trim();
   if (!wanted) return { lines: [], totalLinesCount: 0 };
-  const stat = fs20.statSync(filePath);
+  const stat = fs24.statSync(filePath);
   if (stat.size === 0) {
     return { lines: [], totalLinesCount: 0 };
   }
-  const fd = fs20.openSync(filePath, "r");
+  const fd = fs24.openSync(filePath, "r");
   const chunkSize = 64 * 1024;
   let position = stat.size;
   let remainder = "";
@@ -5750,7 +6472,7 @@ function readJsonLinesByTraceId(filePath, traceId, maxLines, offset, levels) {
       const length = Math.min(chunkSize, position);
       position -= length;
       const buffer = Buffer.alloc(length);
-      fs20.readSync(fd, buffer, 0, length, position);
+      fs24.readSync(fd, buffer, 0, length, position);
       let chunk = buffer.toString("utf8");
       if (remainder) {
         chunk += remainder;
@@ -5803,7 +6525,7 @@ function readJsonLinesByTraceId(filePath, traceId, maxLines, offset, levels) {
       }
     }
   } finally {
-    fs20.closeSync(fd);
+    fs24.closeSync(fd);
   }
   return { lines: collected.reverse(), totalLinesCount };
 }
@@ -5812,11 +6534,11 @@ function readJsonLinesTailByLevel(filePath, maxLines, offset, levels) {
   if (!wantedLevelSet) {
     return { lines: [], totalLinesCount: 0 };
   }
-  const stat = fs20.statSync(filePath);
+  const stat = fs24.statSync(filePath);
   if (stat.size === 0) {
     return { lines: [], totalLinesCount: 0 };
   }
-  const fd = fs20.openSync(filePath, "r");
+  const fd = fs24.openSync(filePath, "r");
   const chunkSize = 64 * 1024;
   let position = stat.size;
   let remainder = "";
@@ -5828,7 +6550,7 @@ function readJsonLinesTailByLevel(filePath, maxLines, offset, levels) {
       const length = Math.min(chunkSize, position);
       position -= length;
       const buffer = Buffer.alloc(length);
-      fs20.readSync(fd, buffer, 0, length, position);
+      fs24.readSync(fd, buffer, 0, length, position);
       let chunk = buffer.toString("utf8");
       if (remainder) {
         chunk += remainder;
@@ -5875,7 +6597,7 @@ function readJsonLinesTailByLevel(filePath, maxLines, offset, levels) {
       }
     }
   } finally {
-    fs20.closeSync(fd);
+    fs24.closeSync(fd);
   }
   return { lines: collected.reverse(), totalLinesCount };
 }
@@ -6068,12 +6790,21 @@ async function readLatestLogLinesMeta(options) {
   return { lines: [], totalLinesCount: 0 };
 }
 async function readLogsJsonResult(options) {
-  const { lines, totalLinesCount } = await readLatestLogLinesMeta(options);
+  const { lines, totalLinesCount, allLines } = await readLatestLogLinesMeta(options);
   if (options.type === "server-std" || options.type === "client-std" || options.type === "dev" || options.type === "dev-std" || options.type === "install-dep-std") {
+    const linesForErrorCheck = allLines ?? lines;
+    const stackTracePattern = /\bat\s+\S+\s+\([^)]+:\d+:\d+\)/;
+    const linesToFilter = allLines ?? lines;
+    const filteredLines = linesToFilter.filter((line) => !stackTracePattern.test(line));
+    const maxLines = options.maxLines ?? 30;
+    const offset = options.offset ?? 0;
+    const endExclusive = Math.max(0, filteredLines.length - offset);
+    const start = Math.max(0, endExclusive - maxLines);
+    const paginatedLogs = filteredLines.slice(start, endExclusive);
     return {
-      hasError: hasErrorInStdLines(lines),
-      totalLinesCount,
-      logs: lines
+      hasError: hasErrorInStdLines(linesForErrorCheck),
+      totalLinesCount: filteredLines.length,
+      logs: paginatedLogs
     };
   }
   const logs = [];
@@ -6100,34 +6831,34 @@ async function readLogsJsonResult(options) {
   };
 }
 function resolveLogFilePath(logDir, type) {
-  const base = path16.isAbsolute(logDir) ? logDir : path16.join(process.cwd(), logDir);
+  const base = path20.isAbsolute(logDir) ? logDir : path20.join(process.cwd(), logDir);
   if (type === "server") {
-    return path16.join(base, "server.log");
+    return path20.join(base, "server.log");
   }
   if (type === "trace") {
-    return path16.join(base, "trace.log");
+    return path20.join(base, "trace.log");
   }
   if (type === "server-std") {
-    return path16.join(base, "server.std.log");
+    return path20.join(base, "server.std.log");
   }
   if (type === "client-std") {
-    return path16.join(base, "client.std.log");
+    return path20.join(base, "client.std.log");
   }
   if (type === "dev") {
-    return path16.join(base, "dev.log");
+    return path20.join(base, "dev.log");
   }
   if (type === "dev-std") {
-    return path16.join(base, "dev.std.log");
+    return path20.join(base, "dev.std.log");
   }
   if (type === "install-dep-std") {
-    return path16.join(base, "install-dep.std.log");
+    return path20.join(base, "install-dep.std.log");
   }
   if (type === "browser") {
-    return path16.join(base, "browser.log");
+    return path20.join(base, "browser.log");
   }
   throw new Error(`Unsupported log type: ${type}`);
 }
-async function run4(options) {
+async function run6(options) {
   const result = await readLogsJsonResult(options);
   process.stdout.write(JSON.stringify(result) + "\n");
 }
@@ -6169,7 +6900,7 @@ var readLogsCommand = {
         const offset = parseNonNegativeInt(rawOptions.offset, "--offset");
         const traceId = typeof rawOptions.traceId === "string" ? rawOptions.traceId : void 0;
         const levels = parseCommaSeparatedList(rawOptions.level);
-        await run4({ logDir, type, maxLines, offset, traceId, levels });
+        await run6({ logDir, type, maxLines, offset, traceId, levels });
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
         process.stderr.write(message + "\n");
@@ -6179,23 +6910,101 @@ 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,
   syncCommand,
+  upgradeCommand,
   actionPluginCommandGroup,
   capabilityCommandGroup,
+  componentCommandGroup,
   migrationCommand,
-  readLogsCommand
+  readLogsCommand,
+  buildCommandGroup
 ];
 
 // src/index.ts
-var envPath = path17.join(process.cwd(), ".env");
-if (fs21.existsSync(envPath)) {
+var envPath = path21.join(process.cwd(), ".env");
+if (fs25.existsSync(envPath)) {
   dotenvConfig({ path: envPath });
 }
-var __dirname = path17.dirname(fileURLToPath4(import.meta.url));
-var pkg = JSON.parse(fs21.readFileSync(path17.join(__dirname, "../package.json"), "utf-8"));
+var __dirname = path21.dirname(fileURLToPath5(import.meta.url));
+var pkg = JSON.parse(fs25.readFileSync(path21.join(__dirname, "../package.json"), "utf-8"));
 var cli = new FullstackCLI(pkg.version);
 cli.useAll(commands);
 cli.run();