@uofx/cli 1.0.0

package/dist/application/use-cases/instance/start-instance.use-case.js

@@ -0,0 +1,154 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StartInstanceUseCase = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../../di/tokens");
+const instance_name_value_object_1 = require("../../../domain/value-objects/instance-name.value-object");
+const connection_info_value_object_1 = require("../../../domain/value-objects/connection-info.value-object");
+const instance_lifecycle_state_entity_1 = require("../../../domain/entities/instance-lifecycle-state.entity");
+const app_error_1 = require("../../../infrastructure/errors/app-error");
+const exit_codes_1 = require("../../../infrastructure/errors/exit-codes");
+/**
+ * 啟動實例 Use Case
+ */
+let StartInstanceUseCase = class StartInstanceUseCase {
+    constructor(instanceManager) {
+        this.instanceManager = instanceManager;
+    }
+    /**
+     * 啟動實例
+     * @param request - 啟動請求
+     * @param output - 輸出介面
+     * @returns 啟動結果與連線資訊
+     */
+    async execute(request, output) {
+        const { name, waitForReady = true } = request;
+        const instanceName = instance_name_value_object_1.InstanceName.create(name);
+        // 驗證實例存在
+        await this.instanceManager.requireExists(instanceName);
+        // 檢查是否有其他實例正在運行
+        await this.ensureNoOtherRunningInstances(instanceName);
+        // 取得生命週期狀態
+        // 重要：必須先檢查 WSL 狀態，再檢查 MicroK8s 狀態
+        // 因為 isMicroK8sRunning 會執行 wsl -d xxx -- ... 命令，這會觸發 WSL 自動啟動
+        const lifecycleState = await this.getLifecycleState(instanceName);
+        // 若已完全運行，直接返回連線資訊
+        if (lifecycleState.isFullyRunning) {
+            const connectionInfo = await this.getConnectionInfo(instanceName);
+            return {
+                success: true,
+                instanceName: instanceName.fullName,
+                alreadyRunning: true,
+                podsReady: true,
+                connectionInfo,
+            };
+        }
+        // 啟動實例 (WSL + MicroK8s)
+        await this.instanceManager.start(instanceName, output);
+        // 等待 Pod 就緒
+        let podsReady = false;
+        if (waitForReady) {
+            output?.item('arrow', 'Waiting for all pods to be ready...').flush();
+            podsReady = await this.instanceManager.waitForPodsReady(instanceName, 5 * 60 * 1000);
+            if (podsReady) {
+                output?.success('All pods are ready').flush();
+            }
+            else {
+                output?.warning('Some pods may not be ready yet').flush();
+            }
+        }
+        // 取得連線資訊
+        const connectionInfo = await this.getConnectionInfo(instanceName);
+        return {
+            success: true,
+            instanceName: instanceName.fullName,
+            alreadyRunning: false,
+            podsReady,
+            connectionInfo,
+        };
+    }
+    /**
+     * 取得實例生命週期狀態
+     */
+    async getLifecycleState(instanceName) {
+        const status = await this.instanceManager.getStatus(instanceName);
+        // 若 WSL 未運行，直接返回停止狀態
+        if (!status.isRunning) {
+            return instance_lifecycle_state_entity_1.InstanceLifecycleState.stopped();
+        }
+        // WSL 運行中，檢查 K8s 狀態
+        const k8sRunning = await this.instanceManager.isMicroK8sRunning(instanceName);
+        return instance_lifecycle_state_entity_1.InstanceLifecycleState.fromStatus(status, k8sRunning);
+    }
+    /**
+     * 列出其他運行中的 UOFX 實例
+     * @param excludeName - 要排除的實例名稱
+     * @returns 其他運行中實例的名稱陣列
+     */
+    async listOtherRunningInstances(excludeName) {
+        const instanceName = instance_name_value_object_1.InstanceName.create(excludeName);
+        const runningInstances = await this.instanceManager.listRunningInstances();
+        return runningInstances.filter(name => name !== instanceName.fullName);
+    }
+    /**
+     * 停止指定實例
+     * @param name - 要停止的實例名稱（完整名稱）
+     * @param output - 輸出介面
+     */
+    async stopInstance(fullName, output) {
+        // 直接使用完整名稱建立 InstanceName
+        const instanceName = instance_name_value_object_1.InstanceName.createFromFullName(fullName);
+        await this.instanceManager.stop(instanceName, true, output);
+    }
+    /**
+     * 取得連線資訊
+     */
+    async getConnectionInfo(instanceName) {
+        const instanceIp = await this.instanceManager.getInstanceIP(instanceName);
+        const connectionInfo = connection_info_value_object_1.ConnectionInfo.create(instanceIp);
+        return connectionInfo.toDto();
+    }
+    /**
+     * 確保沒有其他實例正在運行
+     * 同時只能有一個實例運行
+     * @param currentInstance - 當前要啟動的實例
+     * @throws AppError 若有其他運行中的實例
+     */
+    async ensureNoOtherRunningInstances(currentInstance) {
+        const otherRunning = await this.listOtherRunningInstances(currentInstance.toString());
+        if (otherRunning.length > 0) {
+            // 將全名轉換為顯示名稱（移除 uofx- 前綴）
+            const displayNames = otherRunning.map(name => name.replace('uofx-', ''));
+            const instanceList = displayNames
+                .map(name => `  - ${name}`)
+                .join('\n');
+            const stopCommand = displayNames.length === 1
+                ? `uofx env stop --name ${displayNames[0]}`
+                : 'uofx env stop --name <instance-name>';
+            throw new app_error_1.AppError(`Cannot start: another instance is already running:\n${instanceList}`, {
+                exitCode: exit_codes_1.EXIT_CODES.BUSINESS_ERROR,
+                solution: `Only one instance can run at a time.\nRun: ${stopCommand}`,
+                context: { otherRunning }
+            });
+        }
+    }
+};
+exports.StartInstanceUseCase = StartInstanceUseCase;
+exports.StartInstanceUseCase = StartInstanceUseCase = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.IInstanceManagerPort)),
+    __metadata("design:paramtypes", [Object])
+], StartInstanceUseCase);
+//# sourceMappingURL=start-instance.use-case.js.map

package/dist/application/use-cases/instance/stop-instance.use-case.js

@@ -0,0 +1,55 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StopInstanceUseCase = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../../di/tokens");
+const instance_name_value_object_1 = require("../../../domain/value-objects/instance-name.value-object");
+/**
+ * 停止實例 Use Case
+ */
+let StopInstanceUseCase = class StopInstanceUseCase {
+    constructor(instanceManager) {
+        this.instanceManager = instanceManager;
+    }
+    async execute(request, output) {
+        const { name, force = false } = request;
+        const instanceName = instance_name_value_object_1.InstanceName.create(name);
+        // 驗證實例存在
+        await this.instanceManager.requireExists(instanceName);
+        // 檢查實例是否已停止
+        const status = await this.instanceManager.getStatus(instanceName);
+        if (!status.isRunning) {
+            return {
+                success: true,
+                alreadyStopped: true,
+                instanceName: instanceName.fullName,
+            };
+        }
+        // 停止實例
+        await this.instanceManager.stop(instanceName, force, output);
+        return {
+            success: true,
+            alreadyStopped: false,
+            instanceName: instanceName.fullName,
+        };
+    }
+};
+exports.StopInstanceUseCase = StopInstanceUseCase;
+exports.StopInstanceUseCase = StopInstanceUseCase = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.IInstanceManagerPort)),
+    __metadata("design:paramtypes", [Object])
+], StopInstanceUseCase);
+//# sourceMappingURL=stop-instance.use-case.js.map

package/dist/application/use-cases/logs/show-logs.use-case.js

@@ -0,0 +1,66 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShowLogsUseCase = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../../di/tokens");
+const log_filter_entity_1 = require("../../../domain/entities/log-filter.entity");
+/**
+ * 顯示日誌 Use Case
+ *
+ * 讀取並過濾應用程式日誌
+ */
+let ShowLogsUseCase = class ShowLogsUseCase {
+    constructor(loggerPort) {
+        this.loggerPort = loggerPort;
+    }
+    /**
+     * 執行顯示日誌
+     * @param request - 請求參數
+     */
+    async execute(request) {
+        // 讀取日誌
+        const entries = await this.loggerPort.readLogs(request.lines || 50);
+        // 建立過濾器並過濾日誌
+        const filter = log_filter_entity_1.LogFilter.create({
+            level: request.level,
+            correlation: request.correlation,
+            command: request.command,
+            commandGroup: request.commandGroup,
+            since: request.since,
+        });
+        const filtered = filter.filter(entries);
+        // 轉換為 DTO
+        const logEntries = filtered.map(entry => ({
+            timestamp: new Date(entry.timestamp).toISOString(),
+            level: entry.levelName,
+            message: entry.message,
+            correlationId: entry.correlationId,
+            command: entry.context?.command,
+            errorStack: entry.error?.stack,
+        }));
+        return {
+            entries: logEntries,
+            total: logEntries.length,
+            isFollowing: request.follow || false,
+        };
+    }
+};
+exports.ShowLogsUseCase = ShowLogsUseCase;
+exports.ShowLogsUseCase = ShowLogsUseCase = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.ILoggerPort)),
+    __metadata("design:paramtypes", [Object])
+], ShowLogsUseCase);
+//# sourceMappingURL=show-logs.use-case.js.map

package/dist/application/use-cases/setup/setup-environment.use-case.js

@@ -0,0 +1,53 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SetupEnvironmentUseCase = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../../di/tokens");
+const environment_validation_entity_1 = require("../../../domain/entities/environment-validation.entity");
+/**
+ * 設置環境 Use Case
+ *
+ * 檢查系統環境是否符合 UOFX 運行需求
+ */
+let SetupEnvironmentUseCase = class SetupEnvironmentUseCase {
+    constructor(runtimeEnv) {
+        this.runtimeEnv = runtimeEnv;
+    }
+    async execute() {
+        // 並行執行所有檢查
+        const [osInfo, runtimeInfo, systemResources, networkStatus] = await Promise.all([
+            this.runtimeEnv.getOsInfo(),
+            this.runtimeEnv.getRuntimeInfo(),
+            this.runtimeEnv.getSystemResources(),
+            this.runtimeEnv.checkNetworkConnectivity(),
+        ]);
+        // 使用 Entity 進行驗證
+        const validation = environment_validation_entity_1.EnvironmentValidation.create(osInfo, runtimeInfo, systemResources, networkStatus);
+        return {
+            osInfo,
+            runtimeInfo,
+            systemResources,
+            networkStatus,
+            allChecksPassed: validation.allChecksPassed,
+        };
+    }
+};
+exports.SetupEnvironmentUseCase = SetupEnvironmentUseCase;
+exports.SetupEnvironmentUseCase = SetupEnvironmentUseCase = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.IRuntimeEnvironmentPort)),
+    __metadata("design:paramtypes", [Object])
+], SetupEnvironmentUseCase);
+//# sourceMappingURL=setup-environment.use-case.js.map

package/dist/cli.js

@@ -0,0 +1,286 @@
+"use strict";
+/**
+ * UOFX CLI - Commander.js 主程式
+ * 註冊所有指令並處理 CLI 路由
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProgram = createProgram;
+exports.run = run;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const di_1 = require("./di");
+const tokens_1 = require("./di/tokens");
+const output_builder_service_1 = require("./presentation/ui/output-builder.service");
+const log_level_enum_1 = require("./presentation/ui/log-level.enum");
+const logger_types_1 = require("./domain/types/logger.types");
+// 載入 package.json 以獲取版本資訊
+const packageJsonPath = path.join(__dirname, '..', 'package.json');
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+function createProgram() {
+    // 設定全域錯誤處理器以處理未被捕獲的錯誤
+    // 注意：必須在 DI 容器完全初始化後才能解析
+    di_1.container.resolve(tokens_1.TOKENS.IErrorHandlerPort).setupGlobalHandlers();
+    // 確保 CLI 啟動時使用者設定目錄存在
+    di_1.container.resolve(tokens_1.TOKENS.IAppConfigPort).ensureUserConfigDir();
+    const program = new commander_1.Command();
+    // 從 DI 容器獲取 Controllers
+    const instanceController = di_1.container.resolve(tokens_1.TOKENS.InstanceController);
+    const setupController = di_1.container.resolve(tokens_1.TOKENS.SetupController);
+    const configController = di_1.container.resolve(tokens_1.TOKENS.ConfigController);
+    const logsController = di_1.container.resolve(tokens_1.TOKENS.LogsController);
+    const credentialsController = di_1.container.resolve(tokens_1.TOKENS.CredentialsController);
+    program
+        .name('uofx')
+        .description('CLI tool for installing and managing the UOFX development environment on WSL2')
+        .version(packageJson.version, '-v, --version', 'display the current version')
+        .helpCommand(false);
+    // 在指令執行前配置 OutputBuilder 和 AppLogger 的 Hook
+    program.hook('preAction', (thisCommand) => {
+        const outputBuilder = di_1.container.resolve(output_builder_service_1.OutputBuilder);
+        const appConfig = di_1.container.resolve(tokens_1.TOKENS.IAppConfigPort);
+        const appLogger = di_1.container.resolve(tokens_1.TOKENS.ILoggerPort);
+        const correlationIdService = di_1.container.resolve(tokens_1.TOKENS.ICorrelationIdPort);
+        // 只在第一次執行 (根命令) 時設定日誌等級
+        if (thisCommand.name() === 'uofx') {
+            // 從設定檔載入日誌等級
+            const config = appConfig.getConfig();
+            // 設定 OutputBuilder 日誌等級
+            const outputLevel = (0, log_level_enum_1.parseOutputLogLevel)(config.logLevel);
+            if (outputLevel !== undefined) {
+                outputBuilder.setLogLevel(outputLevel);
+            }
+            // 設定 AppLogger 日誌等級
+            let loggerLevel;
+            switch (config.logLevel) {
+                case 'debug':
+                    loggerLevel = logger_types_1.LogLevel.DEBUG;
+                    break;
+                case 'info':
+                    loggerLevel = logger_types_1.LogLevel.INFO;
+                    break;
+                case 'error':
+                    loggerLevel = logger_types_1.LogLevel.ERROR;
+                    break;
+                default:
+                    loggerLevel = logger_types_1.LogLevel.ERROR;
+            }
+            appLogger.setLogLevel(loggerLevel);
+        }
+        // 設定日誌執行上下文（命令追蹤）
+        // 注意：program.hook('preAction') 只會執行一次（在根命令），所以無法直接獲取子命令
+        // 我們需要從 process.argv 解析實際執行的命令
+        const argv = process.argv;
+        // 解析命令路徑（例如：['node', 'uofx', 'env', 'list'] -> 'env.list'）
+        const commandParts = [];
+        for (let i = 2; i < argv.length; i++) {
+            const arg = argv[i];
+            // 跳過選項參數
+            if (arg.startsWith('-'))
+                break;
+            // 跳過 uofx 自身
+            if (arg === 'uofx' || arg.endsWith('uofx'))
+                continue;
+            commandParts.push(arg);
+        }
+        const commandPath = commandParts.join('.');
+        if (commandPath) {
+            const commandGroup = commandPath.split('.')[0];
+            const correlationId = correlationIdService.generate();
+            appLogger.setExecutionContext({
+                command: commandPath,
+                commandGroup: commandGroup,
+                correlationId: correlationId,
+            });
+        }
+    });
+    // 註冊指令群組
+    // ============================================================================
+    // CONFIG 指令群組 - 設定管理
+    // ============================================================================
+    const configCommand = program
+        .command('config')
+        .description('Manage CLI configuration');
+    // config list
+    configCommand
+        .command('list')
+        .description('List all configuration values')
+        .option('--format <format>', 'Output format: json or table', 'table')
+        .action(async (options) => {
+        await configController.list(options.format);
+    });
+    // config set
+    configCommand
+        .command('set')
+        .description('Set configuration values using option flags')
+        .option('--log-level <level>', 'Set log level (debug or info or error)')
+        .option('--acr.name <name>', 'Set ACR name')
+        .option('--acr.account <account>', 'Set ACR account')
+        .option('--acr.password <password>', 'Set ACR password')
+        .action(async (options) => {
+        await configController.set(options);
+    });
+    // ============================================================================
+    // ENV 指令群組 - 環境管理
+    // ============================================================================
+    const envCommand = program
+        .command('env')
+        .description('Manage UOFX development environments');
+    // env delete
+    envCommand
+        .command('delete')
+        .description('Delete a UOFX instance')
+        .requiredOption('--name <name>', 'Instance name to delete')
+        .option('-f, --force', 'Skip confirmation prompt')
+        .action(async (options) => {
+        await instanceController.delete(options.name, options.force || false);
+    });
+    // env install
+    envCommand
+        .command('install')
+        .description('Install and deploy all services')
+        .option('--name <name>', 'Instance name to install', 'dev')
+        .option('--chart-version <version>', 'Helm chart version')
+        // .option('--pull-secret <file>', 'ACR pull secret file path')
+        .action(async (options) => {
+        await instanceController.install(options);
+    });
+    // env list - 統一的查詢入口
+    envCommand
+        .command('list [type]')
+        .description('Display information about instances, credentials, or compatibility')
+        .option('--name <name>', 'Instance name (required for credentials type)')
+        .option('--reveal', 'Show full credentials (use with credentials type)')
+        .addHelpText('after', `
+Types:
+  instances      List all UOFX instances (default)
+  charts         List compatible chart versions
+  credentials    Display instance credentials (requires --name)
+
+Examples:
+  $ uofx env list
+  $ uofx env list instances
+  $ uofx env list charts
+  $ uofx env list credentials --name dev
+  $ uofx env list credentials --name dev --reveal
+  `)
+        .action(async (type = 'instances', options) => {
+        if (type === 'credentials') {
+            if (!options.name) {
+                console.error('Error: --name is required for credentials type');
+                process.exit(1);
+            }
+            await credentialsController.get(options.name, options.reveal || false);
+        }
+        else if (type === 'charts') {
+            await instanceController.listCharts();
+        }
+        else {
+            await instanceController.list();
+        }
+    });
+    // env setup
+    envCommand
+        .command('setup')
+        .description('Check and validate system environment')
+        .action(async (options) => {
+        await setupController.setup(options);
+    });
+    // env start
+    envCommand
+        .command('start')
+        .description('Start a UOFX instance')
+        .requiredOption('--name <name>', 'Instance name to start')
+        .action(async (options) => {
+        await instanceController.start(options.name);
+    });
+    // env stop
+    envCommand
+        .command('stop')
+        .description('Stop a UOFX instance')
+        .requiredOption('--name <name>', 'Instance name to stop')
+        .action(async (options) => {
+        await instanceController.stop(options.name, { force: options.force || false });
+    });
+    // ============================================================================
+    // LOGS 指令 - 日誌檢視與過濾
+    // ============================================================================
+    program
+        .command('logs')
+        .description('View and filter logs')
+        .option('--lines <number>', 'Number of lines to show', '50')
+        .option('--level <level>', 'Filter by log level (DEBUG, INFO, ERROR)')
+        .option('--since <range>', 'Show logs since time range (e.g., 1h, 2d, 30m)')
+        .option('--correlation <id>', 'Filter by correlation ID')
+        .option('--command <command>', 'Filter by command (e.g., env.install)')
+        .option('--command-group <group>', 'Filter by command group (e.g., env)')
+        .addHelpText('after', `
+Examples:
+  $ uofx logs
+  $ uofx logs --level error
+  $ uofx logs --since 1h
+  $ uofx logs --command env.install
+  `)
+        .action(async (options) => {
+        const parsedOptions = {
+            lines: options.lines ? parseInt(options.lines, 10) : 50,
+            follow: options.follow,
+            level: options.level,
+            since: options.since,
+            correlation: options.correlation,
+            command: options.command,
+            commandGroup: options.commandGroup,
+        };
+        await logsController.show(parsedOptions);
+    });
+    // 處理未知指令
+    program.on('command:*', (operands) => {
+        const unknownCommand = operands[0];
+        console.error(`\n✗ Error: Unknown command '${unknownCommand}'`);
+        console.log('\nAvailable command groups:');
+        console.log('  env         Manage UOFX development environments');
+        console.log('  config      Manage CLI configuration');
+        console.log('  logs        View and filter logs');
+        console.log('\nUse "uofx --help" for more information.\n');
+        process.exit(1);
+    });
+    return program;
+}
+function run(argv) {
+    const program = createProgram();
+    program.parse(argv);
+}
+//# sourceMappingURL=cli.js.map

package/dist/constants/config-defaults.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_TIMEOUTS = exports.DEFAULT_CONFIG_VALUES = void 0;
+exports.DEFAULT_CONFIG_VALUES = {
+    INSTANCE_NAME: 'dev',
+    NTP_SERVERS: [
+        'time.stdtime.gov.tw',
+        'clock.stdtime.gov.tw',
+        'time.google.com',
+        'time.cloudflare.com',
+    ],
+    TIMEOUTS: {
+        NETWORK: 30000,
+        MICROK8S: 600000,
+        PODS: 300000,
+    },
+};
+exports.MAX_TIMEOUTS = {
+    NETWORK: 300000,
+    MICROK8S: 1800000,
+    PODS: 1800000,
+};
+//# sourceMappingURL=config-defaults.js.map