@geek-fun/serverlessinsight 0.4.0 → 0.5.0

package/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

package/README.md

@@ -47,14 +47,14 @@ Whether you're building on AWS, Alibaba Cloud, Huawei Cloud, or other providers,
 
 ServerlessInsight supports the following cloud providers:
 
-| Provider | Functions | API Gateway | Storage | Databases | Status |
-|----------|-----------|-------------|---------|-----------|--------|
-| **Alibaba Cloud** | ✅ FC3 | ✅ API Gateway | ✅ OSS | ✅ RDS, OTS, ESS | Stable |
-| **Huawei Cloud** | ✅ FunctionGraph | 🚧 Coming Soon | 🚧 Coming Soon | 🚧 Coming Soon | Beta |
-| **AWS** | 🔜 Planned | 🔜 Planned | 🔜 Planned | 🔜 Planned | Planned |
-| **Azure** | 🔜 Planned | 🔜 Planned | 🔜 Planned | 🔜 Planned | Planned |
-| **Google Cloud** | 🔜 Planned | 🔜 Planned | 🔜 Planned | 🔜 Planned | Planned |
-| **Tencent Cloud** | 🔜 Planned | 🔜 Planned | 🔜 Planned | 🔜 Planned | Planned |
+| Provider          | Functions        | API Gateway    | Storage        | Databases        | Status  |
+| ----------------- | ---------------- | -------------- | -------------- | ---------------- | ------- |
+| **Alibaba Cloud** | ✅ FC3           | ✅ API Gateway | ✅ OSS         | ✅ RDS, OTS, ESS | Stable  |
+| **Huawei Cloud**  | ✅ FunctionGraph | 🚧 Coming Soon | 🚧 Coming Soon | 🚧 Coming Soon   | Beta    |
+| **AWS**           | 🔜 Planned       | 🔜 Planned     | 🔜 Planned     | 🔜 Planned       | Planned |
+| **Azure**         | 🔜 Planned       | 🔜 Planned     | 🔜 Planned     | 🔜 Planned       | Planned |
+| **Google Cloud**  | 🔜 Planned       | 🔜 Planned     | 🔜 Planned     | 🔜 Planned       | Planned |
+| **Tencent Cloud** | 🔜 Planned       | 🔜 Planned     | 🔜 Planned     | 🔜 Planned       | Planned |
 
 ---
 
@@ -188,6 +188,105 @@ curl http://localhost:4567/si_buckets/<bucket_key>/subdir/
 
 The bucket handler serves files from the directory specified in your bucket's `website.code` configuration.
 
+### Architecture
+
+ServerlessInsight follows a **functional client architecture** that cleanly separates cloud provider SDKs from business logic:
+
+#### Layered Design
+
+```
+┌─────────────────────────────────────────┐
+│   Resource / Planner / Executor Layer   │  ← Provider-agnostic business logic
+│   (Pure functions, no SDK imports)       │
+└─────────────────────────────────────────┘
+                    ↓
+┌─────────────────────────────────────────┐
+│         Functional Client Layer          │  ← Encapsulated SDK operations
+│   (aliyunClient.ts, tencentClient.ts)   │
+└─────────────────────────────────────────┘
+                    ↓
+┌─────────────────────────────────────────┐
+│      Cloud Provider SDKs                 │  ← @alicloud/*, tencentcloud-*
+└─────────────────────────────────────────┘
+```
+
+#### Key Principles
+
+- **Functional & Pure**: All business logic uses pure functions with immutable data
+- **SDK Encapsulation**: Provider SDKs are accessed ONLY through client modules
+- **Operation Functions**: Clients expose high-level operation functions (e.g., `createFunction`, `getFunction`)
+- **No Classes**: Prefer `type` over `interface`, and functional patterns over classes
+- **Minimal Side Effects**: File I/O and other side effects are isolated at boundaries
+
+#### Client Pattern Example
+
+```typescript
+// ✅ Client exposes operation functions, not raw SDKs
+export type AliyunClient = {
+  fc3: {
+    createFunction: (config: Fc3FunctionConfig, codeBase64: string) => Promise<void>;
+    getFunction: (functionName: string) => Promise<Fc3FunctionInfo | null>;
+    // ... other operations
+  };
+  // ... other services
+};
+
+// ✅ Resource layer uses clean client API
+const client = createAliyunClient(context);
+const codeBase64 = readFileAsBase64(codePath);
+await client.fc3.createFunction(config, codeBase64);
+```
+
+This architecture enables:
+
+- **Better Testing**: Mock client operations instead of SDKs
+- **Maintainability**: Provider changes isolated to client layer
+- **Type Safety**: Strong typing throughout the stack
+- **Code Reuse**: Shared client operations across resources
+
+---
+
+## 🗄️ State Management
+
+ServerlessInsight uses a state-based deployment model that tracks all deployed resources in a local state file (`.serverlessinsight/state.json`). This enables:
+
+- **Incremental deployments** - Only changed resources are updated
+- **Drift detection** - Identifies differences between local state and cloud resources
+- **Safe destruction** - Knows which resources to clean up
+
+### Partial Failure Recovery
+
+When deploying multiple resources, if one fails, ServerlessInsight ensures that:
+
+1. **Successfully deployed resources are always saved to state** - Even if subsequent resources fail, your state file will contain all resources that were successfully created/updated/deleted
+2. **Clear error reporting** - You'll see which resources succeeded and which failed
+3. **Easy retry** - Simply run `deploy` again to continue from where you left off
+
+Example partial failure output:
+
+```
+⚠️  PARTIAL DEPLOYMENT FAILURE: 2 resource(s) succeeded, but functions.api_handler failed.
+State has been saved for successfully deployed resources. Run deploy again to retry failed resources.
+Next steps: 1) Review the error above, 2) Fix any configuration issues, 3) Run deploy again to continue.
+```
+
+### State File Location
+
+The state file is stored in `.serverlessinsight/state.json` in your project directory. This file:
+
+- Should be committed to version control for team collaboration
+- Contains resource metadata and identifiers
+- Is automatically updated after each successful operation
+
+### State Recovery
+
+If you encounter state drift (cloud resources exist that aren't in your state file):
+
+1. **Manual import** - Currently, resources must be manually added to the state file
+2. **Clean start** - Delete the state file and resources in the cloud, then redeploy
+
+> 💡 **Tip**: Always backup your state file before making manual modifications.
+
 ---
 
 ## 📘 Documentation
@@ -195,6 +294,7 @@ The bucket handler serves files from the directory specified in your bucket's `w
 For comprehensive documentation, visit [serverlessinsight.geekfun.club](https://serverlessinsight.geekfun.club)
 
 Additional resources:
+
 - [Quick Start Guide](https://serverlessinsight.geekfun.club)
 - [Configuration Reference](https://serverlessinsight.geekfun.club)
 - [API Documentation](https://serverlessinsight.geekfun.club)

package/README.zh-CN.md

@@ -47,14 +47,14 @@ ServerlessInsight 是一个强大的 Serverless 框架，用于跨多个云服
 
 ServerlessInsight 支持以下云服务商：
 
-| 云服务商 | 函数 | API 网关 | 存储 | 数据库 | 状态 |
-|----------|------|----------|------|--------|------|
-| **阿里云** | ✅ FC3 | ✅ API 网关 | ✅ OSS | ✅ RDS, OTS, ESS | 稳定 |
-| **华为云** | ✅ FunctionGraph | 🚧 即将推出 | 🚧 即将推出 | 🚧 即将推出 | 测试版 |
-| **AWS** | 🔜 计划中 | 🔜 计划中 | 🔜 计划中 | 🔜 计划中 | 计划中 |
-| **Azure** | 🔜 计划中 | 🔜 计划中 | 🔜 计划中 | 🔜 计划中 | 计划中 |
-| **Google Cloud** | 🔜 计划中 | 🔜 计划中 | 🔜 计划中 | 🔜 计划中 | 计划中 |
-| **腾讯云** | 🔜 计划中 | 🔜 计划中 | 🔜 计划中 | 🔜 计划中 | 计划中 |
+| 云服务商         | 函数             | API 网关    | 存储        | 数据库           | 状态   |
+| ---------------- | ---------------- | ----------- | ----------- | ---------------- | ------ |
+| **阿里云**       | ✅ FC3           | ✅ API 网关 | ✅ OSS      | ✅ RDS, OTS, ESS | 稳定   |
+| **华为云**       | ✅ FunctionGraph | 🚧 即将推出 | 🚧 即将推出 | 🚧 即将推出      | 测试版 |
+| **AWS**          | 🔜 计划中        | 🔜 计划中   | 🔜 计划中   | 🔜 计划中        | 计划中 |
+| **Azure**        | 🔜 计划中        | 🔜 计划中   | 🔜 计划中   | 🔜 计划中        | 计划中 |
+| **Google Cloud** | 🔜 计划中        | 🔜 计划中   | 🔜 计划中   | 🔜 计划中        | 计划中 |
+| **腾讯云**       | 🔜 计划中        | 🔜 计划中   | 🔜 计划中   | 🔜 计划中        | 计划中 |
 
 ---
 
@@ -178,6 +178,7 @@ npm run lint:check
 完整文档请访问 [serverlessinsight.geekfun.club](https://serverlessinsight.geekfun.club)
 
 其他资源：
+
 - [快速开始指南](https://serverlessinsight.geekfun.club)
 - [配置参考](https://serverlessinsight.geekfun.club)
 - [API 文档](https://serverlessinsight.geekfun.club)
@@ -185,6 +186,49 @@ npm run lint:check
 
 ---
 
+## 🗄️ 状态管理
+
+ServerlessInsight 使用基于状态的部署模型，在本地状态文件 (`.serverlessinsight/state.json`) 中跟踪所有已部署的资源。这使得：
+
+- **增量部署** - 只有更改的资源才会被更新
+- **漂移检测** - 识别本地状态与云资源之间的差异
+- **安全销毁** - 知道要清理哪些资源
+
+### 部分失败恢复
+
+当部署多个资源时，如果其中一个失败，ServerlessInsight 确保：
+
+1. **成功部署的资源始终保存到状态** - 即使后续资源失败，您的状态文件也将包含所有成功创建/更新/删除的资源
+2. **清晰的错误报告** - 您将看到哪些资源成功，哪些资源失败
+3. **轻松重试** - 只需再次运行 `deploy` 即可从中断的地方继续
+
+部分失败输出示例：
+
+```
+⚠️  部署部分失败: 2 个资源成功，但 functions.api_handler 失败。
+已成功部署的资源状态已保存。再次运行 deploy 以重试失败的资源。
+后续步骤: 1) 查看上面的错误, 2) 修复配置问题, 3) 再次运行 deploy 继续。
+```
+
+### 状态文件位置
+
+状态文件存储在项目目录的 `.serverlessinsight/state.json` 中。此文件：
+
+- 应提交到版本控制以便团队协作
+- 包含资源元数据和标识符
+- 在每次成功操作后自动更新
+
+### 状态恢复
+
+如果遇到状态漂移（云资源存在但不在状态文件中）：
+
+1. **手动导入** - 目前，资源必须手动添加到状态文件
+2. **重新开始** - 删除状态文件和云中的资源，然后重新部署
+
+> 💡 **提示**：在进行手动修改之前，请始终备份您的状态文件。
+
+---
+
 ## 🤝 贡献
 
 我们欢迎社区的贡献！以下是您可以帮助的方式：

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@geek-fun/serverlessinsight",
-    "version": "0.4.0",
+    "version": "0.5.0",
     "description": "Full life cycle cross providers serverless application management for your fast-growing business.",
     "homepage": "https://serverlessinsight.geekfun.club",
     "main": "dist/src/index.js",
@@ -9,7 +9,7 @@
         "si": "dist/src/commands/index.js"
     },
     "scripts": {
-        "test": "DEBUG=ServerlessInsight jest --runInBand --detectOpenHandles --coverage --coverageReporters json-summary text html lcov",
+        "test": "cross-env DEBUG=ServerlessInsight jest --runInBand --detectOpenHandles --coverage --coverageReporters json-summary text html lcov",
         "test:ci": "jest --runInBand --ci --coverage --coverageReporters json-summary text html lcov",
         "build": "tsc --build",
         "lint:fix": "eslint --fix ./",
@@ -49,54 +49,56 @@
         "function"
     ],
     "dependencies": {
-        "@alicloud/ims20190815": "^2.3.2",
+        "@alicloud/alidns20150109": "^4.3.1",
+        "@alicloud/cloudapi20160714": "^4.7.9",
+        "@alicloud/ecs20140526": "^7.6.0",
+        "@alicloud/es-serverless20230627": "^2.3.0",
+        "@alicloud/fc20230330": "^4.6.8",
+        "@alicloud/ims20190815": "^2.3.3",
+        "@alicloud/nas20170626": "^3.3.1",
         "@alicloud/openapi-client": "^0.4.15",
-        "@alicloud/ros-cdk-apigateway": "^1.11.0",
-        "@alicloud/ros-cdk-core": "^1.11.0",
-        "@alicloud/ros-cdk-dns": "^1.11.0",
-        "@alicloud/ros-cdk-ecs": "^1.11.0",
-        "@alicloud/ros-cdk-elasticsearchserverless": "^1.11.0",
-        "@alicloud/ros-cdk-fc3": "^1.11.0",
-        "@alicloud/ros-cdk-nas": "^1.11.0",
-        "@alicloud/ros-cdk-oss": "^1.11.0",
-        "@alicloud/ros-cdk-ossdeployment": "^1.11.0",
-        "@alicloud/ros-cdk-ots": "^1.11.0",
-        "@alicloud/ros-cdk-ram": "^1.11.0",
-        "@alicloud/ros-cdk-rds": "^1.11.0",
-        "@alicloud/ros-cdk-ros": "^1.11.0",
-        "@alicloud/ros-cdk-sls": "^1.11.0",
-        "@alicloud/ros-cdk-vpc": "^1.11.0",
-        "@alicloud/ros20190910": "^3.6.0",
-        "ajv": "^8.17.1",
+        "@alicloud/ram20150501": "^1.2.0",
+        "@alicloud/rds20140815": "^15.5.1",
+        "@alicloud/sls20201230": "^5.9.0",
+        "ajv": "^8.18.0",
         "ali-oss": "^6.23.0",
-        "chalk": "^5.6.2",
-        "commander": "^14.0.2",
-        "i": "^0.3.7",
+        "commander": "^14.0.3",
+        "cos-nodejs-sdk-v5": "^2.16.0-beta.8",
         "i18n": "^0.15.3",
+        "iconv-lite": "^0.7.2",
         "jszip": "^3.10.1",
-        "lodash": "^4.17.21",
-        "npm": "^11.7.0",
-        "pino": "^10.1.0",
+        "lodash": "^4.17.23",
+        "pino": "^10.3.1",
         "pino-pretty": "^13.1.3",
+        "tablestore": "^5.6.3",
+        "tencentcloud-sdk-nodejs-cynosdb": "^4.1.188",
+        "tencentcloud-sdk-nodejs-es": "^4.1.183",
+        "tencentcloud-sdk-nodejs-scf": "^4.1.168",
         "yaml": "^2.8.2"
     },
     "devDependencies": {
-        "@types/ali-oss": "^6.16.13",
+        "@eslint/eslintrc": "^3.3.4",
+        "@eslint/js": "^10.0.1",
+        "@types/ali-oss": "^6.23.3",
         "@types/i18n": "^0.13.12",
         "@types/jest": "^30.0.0",
-        "@types/lodash": "^4.17.21",
-        "@types/node": "^25.0.3",
-        "@typescript-eslint/eslint-plugin": "^8.50.0",
-        "@typescript-eslint/parser": "^8.50.0",
-        "eslint": "^9.39.2",
+        "@types/lodash": "^4.17.24",
+        "@types/node": "^25.3.2",
+        "@typescript-eslint/eslint-plugin": "^8.56.1",
+        "@typescript-eslint/parser": "^8.56.1",
+        "cross-env": "^10.1.0",
+        "eslint": "^10.0.2",
         "eslint-config-prettier": "^10.1.8",
-        "eslint-plugin-prettier": "^5.5.4",
-        "globals": "^16.5.0",
+        "eslint-plugin-prettier": "^5.5.5",
+        "globals": "^17.3.0",
         "husky": "^9.1.7",
         "jest": "^30.2.0",
-        "prettier": "^3.7.4",
+        "prettier": "^3.8.1",
         "ts-jest": "^29.4.6",
         "ts-node": "^10.9.2",
         "typescript": "^5.9.3"
+    },
+    "overrides": {
+        "fast-xml-parser": ">=5.3.8"
     }
 }

package/dist/src/commands/deploy.js

@@ -4,13 +4,23 @@ exports.deploy = void 0;
 const stack_1 = require("../stack");
 const common_1 = require("../common");
 const parser_1 = require("../parser");
+const lang_1 = require("../lang");
 const deploy = async (stackName, options) => {
-    common_1.logger.info('Validating yaml...');
-    const iac = (0, parser_1.parseYaml)((0, common_1.getIacLocation)(options.location));
-    common_1.logger.info('Yaml is valid! 🎉');
-    await (0, common_1.setContext)({ ...options, stackName, iacProvider: iac.provider }, true);
-    common_1.logger.info('Deploying stack...');
-    await (0, stack_1.deployStack)(stackName, iac);
-    common_1.logger.info('Stack deployed! 🎉');
+    common_1.logger.info(lang_1.lang.__('VALIDATING_YAML'));
+    const iacLocation = (0, common_1.getIacLocation)(options.location);
+    const rawIac = (0, parser_1.parseYaml)(iacLocation);
+    common_1.logger.info(lang_1.lang.__('YAML_VALID'));
+    await (0, common_1.setContext)({ ...options, stackName, iacProvider: rawIac.provider, stages: rawIac.stages }, true);
+    const context = (0, common_1.getContext)();
+    const iac = (0, parser_1.revalYaml)(iacLocation, context);
+    // Store IAC in context for access by all functions
+    (0, common_1.setIac)(iac);
+    common_1.logger.info(lang_1.lang.__('DEPLOYING_STACK'));
+    // Acquire lock for the deployment operation
+    const statePath = (0, common_1.getStatePath)();
+    await (0, common_1.withLock)(statePath, 'deploy', async () => {
+        await (0, stack_1.deployStack)(stackName, iac);
+    });
+    common_1.logger.info(lang_1.lang.__('STACK_DEPLOYED'));
 };
 exports.deploy = deploy;

package/dist/src/commands/destroy.js

@@ -3,11 +3,34 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.destroyStack = void 0;
 const common_1 = require("../common");
 const parser_1 = require("../parser");
+const lang_1 = require("../lang");
+const scfStack_1 = require("../stack/scfStack");
+const aliyunStack_1 = require("../stack/aliyunStack");
 const destroyStack = async (stackName, options) => {
-    const iac = (0, parser_1.parseYaml)((0, common_1.getIacLocation)(options.location));
-    await (0, common_1.setContext)({ stackName, ...options, iacProvider: iac.provider }, true);
+    const iacLocation = (0, common_1.getIacLocation)(options.location);
+    const rawIac = (0, parser_1.parseYaml)(iacLocation);
+    await (0, common_1.setContext)({ stackName, ...options, iacProvider: rawIac.provider, stages: rawIac.stages }, true);
     const context = (0, common_1.getContext)();
-    common_1.logger.info(`Destroying stack: ${stackName}, provider: ${context.provider}, region: ${context.region}...`);
-    await (0, common_1.rosStackDelete)(context);
+    const iac = (0, parser_1.revalYaml)(iacLocation, context);
+    // Store IAC in context for access by all functions
+    (0, common_1.setIac)(iac);
+    common_1.logger.info(lang_1.lang.__('DESTROYING_STACK', {
+        stackName,
+        provider: context.provider,
+        region: context.region,
+    }));
+    // Acquire lock for the destroy operation
+    const statePath = (0, common_1.getStatePath)();
+    await (0, common_1.withLock)(statePath, 'destroy', async () => {
+        if (iac.provider.name === common_1.ProviderEnum.TENCENT) {
+            await (0, scfStack_1.destroyTencentStack)();
+        }
+        else if (iac.provider.name === common_1.ProviderEnum.ALIYUN) {
+            await (0, aliyunStack_1.destroyAliyunStack)();
+        }
+        else {
+            throw new Error(`Unsupported provider: ${iac.provider.name}`);
+        }
+    });
 };
 exports.destroyStack = destroyStack;

package/dist/src/commands/forceUnlock.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forceUnlockCommand = void 0;
+const node_readline_1 = __importDefault(require("node:readline"));
+const common_1 = require("../common");
+const lang_1 = require("../lang");
+const askConfirmation = (question) => {
+    const rl = node_readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase().trim() === 'yes');
+        });
+    });
+};
+const forceUnlockCommand = async (lockId) => {
+    const statePath = (0, common_1.getStatePath)();
+    // Check if lock exists
+    const existingLock = (0, common_1.readLockFileForCommand)(statePath);
+    if (!existingLock) {
+        common_1.logger.error(lang_1.lang.__('NO_LOCK_FOUND'));
+        throw new Error(lang_1.lang.__('NO_LOCK_FOUND'));
+    }
+    // Verify lock ID matches
+    if (existingLock.id !== lockId) {
+        common_1.logger.error(lang_1.lang.__('LOCK_ID_MISMATCH', {
+            providedId: lockId,
+            actualId: existingLock.id,
+        }));
+        throw new Error(lang_1.lang.__('LOCK_ID_MISMATCH', {
+            providedId: lockId,
+            actualId: existingLock.id,
+        }));
+    }
+    // Show lock info
+    common_1.logger.info(lang_1.lang.__('CURRENT_LOCK_INFO'));
+    common_1.logger.info((0, common_1.formatLockInfo)(existingLock));
+    // Ask for confirmation
+    common_1.logger.warn(lang_1.lang.__('FORCE_UNLOCK_WARNING'));
+    const confirmed = await askConfirmation(lang_1.lang.__('FORCE_UNLOCK_CONFIRM'));
+    if (!confirmed) {
+        common_1.logger.info(lang_1.lang.__('FORCE_UNLOCK_CANCELLED'));
+        return;
+    }
+    // Force unlock
+    const success = (0, common_1.forceUnlock)(statePath, lockId);
+    if (success) {
+        common_1.logger.info(lang_1.lang.__('LOCK_RELEASED'));
+    }
+    else {
+        common_1.logger.error(lang_1.lang.__('FAILED_TO_RELEASE_LOCK'));
+        throw new Error(lang_1.lang.__('FAILED_TO_RELEASE_LOCK'));
+    }
+};
+exports.forceUnlockCommand = forceUnlockCommand;

package/dist/src/commands/index.js

@@ -8,26 +8,92 @@ const deploy_1 = require("./deploy");
 const template_1 = require("./template");
 const destroy_1 = require("./destroy");
 const local_1 = require("./local");
+const plan_1 = require("./plan");
+const forceUnlock_1 = require("./forceUnlock");
+const lang_1 = require("../lang");
+// Global error handler
+const handleCommandError = (error, commandName) => {
+    // Skip logging if already logged by handlePartialFailure
+    if (!error?.isPartialFailure) {
+        // Log error message as string to preserve newlines
+        common_1.logger.error(lang_1.lang.__('COMMAND_FAILED', {
+            commandName,
+            error: error?.message || 'Unknown error occurred',
+        }));
+    }
+    if (error?.stack && process.env.DEBUG) {
+        common_1.logger.debug(lang_1.lang.__('STACK_TRACE', { stack: error.stack }));
+    }
+    let exitCode = 1;
+    if (error?.code) {
+        if (typeof error.code === 'number') {
+            exitCode = error.code;
+        }
+        else if (typeof error.code === 'string') {
+            const errorCodeMap = {
+                ENOENT: 2,
+                EACCES: 3,
+                VALIDATION: 4,
+                NETWORK: 5,
+            };
+            exitCode = errorCodeMap[error.code] || 1;
+        }
+    }
+    process.exit(exitCode);
+};
+const actionWrapper = (commandName, handler) => {
+    // Reset context before each command execution
+    (0, common_1.clearContext)();
+    return async (...args) => {
+        try {
+            await handler(...args);
+        }
+        catch (error) {
+            handleCommandError(error, commandName);
+        }
+    };
+};
 const program = new commander_1.Command();
 program.name('si').description('CLI for ServerlessInsight').version((0, common_1.getVersion)());
 program
     .command('show')
     .description('show string')
-    .action(async (options) => {
+    .action(actionWrapper('show', async (options) => {
     await (0, common_1.setContext)({ ...options });
     const context = (0, common_1.getContext)();
     const result = await (0, common_1.getIamInfo)(context);
-    console.log('result:', JSON.stringify(result));
-});
+    console.log(lang_1.lang.__('RESULT', { result: JSON.stringify(result) }));
+}));
 program
     .command('validate [stackName]')
     .description('validate serverless Iac yaml')
     .option('-f, --file <path>', 'specify the yaml file')
     .option('-s, --stage <stage>', 'specify the stage')
-    .action(async (stackName, { file, stage }) => {
-    common_1.logger.debug('log command info');
+    .action(actionWrapper('validate', async (stackName, { file, stage }) => {
+    common_1.logger.debug(lang_1.lang.__('LOG_COMMAND_INFO'));
     await (0, validate_1.validate)(stackName, { stage, location: file });
-});
+}));
+program
+    .command('plan <stackName>')
+    .description('generate and show deployment plan (Tencent provider only)')
+    .option('-f, --file <path>', 'specify the yaml file')
+    .option('-s, --stage <stage>', 'specify the stage')
+    .option('-r, --region <region>', 'specify the region')
+    .option('-v, --provider <provider>', 'specify the provider')
+    .option('-k, --accessKeyId <accessKeyId>', 'specify the AccessKeyId')
+    .option('-x, --accessKeySecret <accessKeySecret>', 'specify the AccessKeySecret')
+    .option('-n, --securityToken <securityToken>', 'specify the SecurityToken')
+    .action(actionWrapper('plan', async (stackName, { stage, file, region, provider, accessKeyId, accessKeySecret, securityToken }) => {
+    await (0, plan_1.plan)(stackName, {
+        stage,
+        location: file,
+        region,
+        provider,
+        accessKeyId,
+        accessKeySecret,
+        securityToken,
+    });
+}));
 program
     .command('deploy <stackName>')
     .description('deploy serverless Iac yaml')
@@ -43,7 +109,7 @@ program
     previous[key] = val;
     return previous;
 }, {})
-    .action(async (stackName, { stage, parameter, file, region, provider, accessKeyId, accessKeySecret, securityToken }) => {
+    .action(actionWrapper('deploy', async (stackName, { stage, parameter, file, region, provider, accessKeyId, accessKeySecret, securityToken }) => {
     await (0, deploy_1.deploy)(stackName, {
         stage,
         parameters: parameter,
@@ -54,16 +120,16 @@ program
         accessKeySecret,
         securityToken,
     });
-});
+}));
 program
     .command('template <stackName>')
     .description('print platform specific infrastructure as code template')
     .option('-f, --file <path>', 'specify the yaml file')
     .option('-s, --stage <stage>', 'specify the stage')
     .option('-t, --format <type>', 'output content type (JSON or YAML)', 'JSON')
-    .action(async (stackName, { format, file, stage }) => {
+    .action(actionWrapper('template', async (stackName, { format, file, stage }) => {
     await (0, template_1.template)(stackName, { format, location: file, stage });
-});
+}));
 program
     .command('destroy <stackName>')
     .option('-f, --file <path>', 'specify the yaml file')
@@ -73,7 +139,7 @@ program
     .option('-x, --accessKeySecret <accessKeySecret>', 'specify the AccessKeySecret')
     .option('-n, --securityToken <securityToken>', 'specify the SecurityToken')
     .description('destroy serverless stack')
-    .action(async (stackName, { file, region, provider, accessKeyId, accessKeySecret, securityToken }) => {
+    .action(actionWrapper('destroy', async (stackName, { file, region, provider, accessKeyId, accessKeySecret, securityToken }) => {
     await (0, destroy_1.destroyStack)(stackName, {
         location: file,
         region,
@@ -82,7 +148,7 @@ program
         accessKeySecret,
         securityToken,
     });
-});
+}));
 program
     .command('local <stackName>')
     .description('run Serverless application locally for debugging')
@@ -91,7 +157,7 @@ program
     .option('-p, --port <port>', 'specify the port', '3000')
     .option('-d, --debug', 'enable debug mode')
     .option('-w, --watch', 'enable file watch', true)
-    .action(async (stackName, { stage, port, debug, watch, file }) => {
+    .action(actionWrapper('local', async (stackName, { stage, port, debug, watch, file }) => {
     await (0, local_1.runLocal)(stackName, {
         stage,
         port: Number(port) || 3000,
@@ -99,5 +165,11 @@ program
         watch: typeof watch === 'boolean' ? watch : true,
         location: file,
     });
-});
+}));
+program
+    .command('force-unlock <lockId>')
+    .description('manually remove a stuck lock (use with caution)')
+    .action(actionWrapper('force-unlock', async (lockId) => {
+    await (0, forceUnlock_1.forceUnlockCommand)(lockId);
+}));
 program.parse();

package/dist/src/commands/local.js

@@ -4,12 +4,21 @@ exports.runLocal = void 0;
 const common_1 = require("../common");
 const localStack_1 = require("../stack/localStack");
 const parser_1 = require("../parser");
+const lang_1 = require("../lang");
 const runLocal = async (stackName, opts) => {
     const { stage, port, debug, watch, location } = opts;
     await (0, common_1.setContext)({ stage, location });
     const ctx = (0, common_1.getContext)();
     const iac = (0, parser_1.revalYaml)((0, common_1.getIacLocation)(location), ctx);
-    common_1.logger.info(`run-local starting: stack=${stackName} stage=${stage} port=${port} debug=${debug} watch=${watch}`);
+    // Store IAC in context for access by all functions
+    (0, common_1.setIac)(iac);
+    common_1.logger.info(lang_1.lang.__('RUN_LOCAL_STARTING', {
+        stackName,
+        stage,
+        port: String(port),
+        debug: String(debug),
+        watch: String(watch),
+    }));
     await (0, localStack_1.startLocalStack)(iac);
     // if (watch) {
     //   const cwd = process.cwd();