@uofx/cli 1.0.2 → 1.1.0

package/dist/application/use-cases/{instance → env}/install-instance.use-case.js

@@ -15,12 +15,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.InstallInstanceUseCase = void 0;
 const tsyringe_1 = require("tsyringe");
 const value_objects_1 = require("../../../domain/value-objects");
-const app_error_1 = require("../../../infrastructure/errors/app-error");
-const exit_codes_1 = require("../../../infrastructure/errors/exit-codes");
+const errors_1 = require("../../../domain/errors");
 const entities_1 = require("../../../domain/entities");
-const error_formatter_util_1 = require("../../../infrastructure/utils/error-formatter.util");
+const env_1 = require("../../services/env");
 const tokens_1 = require("../../../di/tokens");
-const runtime_environment_port_1 = require("../../../domain/ports/runtime-environment.port");
 const timeouts_1 = require("../../../constants/timeouts");
 /**
  * 安裝實例 Use Case
@@ -29,15 +27,15 @@ const timeouts_1 = require("../../../constants/timeouts");
  * 特點：完全無 UI 依賴，透過 Progress 介面回調通知進度
  */
 let InstallInstanceUseCase = class InstallInstanceUseCase {
-    constructor(instanceManager, instanceStorage, deploymentPort, baseImagePort, appConfigPort, errorHandler, runtimeEnvironment, userInteraction, httpClient) {
+    constructor(instanceManager, instanceStorage, deploymentPort, baseImagePort, appConfigPort, errorHandler, envValidator, cleanupService, httpClient) {
         this.instanceManager = instanceManager;
         this.instanceStorage = instanceStorage;
         this.deploymentPort = deploymentPort;
         this.baseImagePort = baseImagePort;
         this.appConfigPort = appConfigPort;
         this.errorHandler = errorHandler;
-        this.runtimeEnvironment = runtimeEnvironment;
-        this.userInteraction = userInteraction;
+        this.envValidator = envValidator;
+        this.cleanupService = cleanupService;
         this.httpClient = httpClient;
     }
     /**
@@ -49,28 +47,30 @@ let InstallInstanceUseCase = class InstallInstanceUseCase {
     async execute(request, output) {
         output?.info('Installing UOFX development environment...').newline().flush();
         // [1/14] 檢查 WSL 是否已安裝
-        await this.checkWslInstalled(output);
+        await this.envValidator.checkWslInstalled(output);
         output?.newline().flush();
         // [2/14] 檢查記憶體
-        await this.checkMemoryAvailability(output);
+        await this.envValidator.checkMemoryAvailability(output);
         output?.newline().flush();
         // [3/14] 解析 Chart 版本
         const instanceName = value_objects_1.InstanceName.create(request.name);
         const chartVersion = await this.resolveChartVersion(request.chartVersion, output);
         output?.newline().flush();
         // [4/14] 檢查是否有其他實例正在運行
-        await this.ensureNoRunningInstances(output);
+        await this.envValidator.ensureNoRunningInstances(output);
         output?.newline().flush();
         // 檢查實例是否已存在
         const exists = await this.instanceManager.exists(instanceName);
         if (exists) {
-            throw new Error(`Instance "${request.name}" already exists`);
+            throw new errors_1.AppError(`Instance "${request.name}" already exists`, {
+                exitCode: errors_1.EXIT_CODES.BUSINESS_ERROR,
+            });
         }
         // [5/14] 準備憑證
         const acrCredentials = await this.getAcrCredentials(request.pullSecretPath, output);
         output?.newline().flush();
         // [6/14] 準備部署參數
-        const deploymentParams = this.prepareDeploymentParameters(instanceName, acrCredentials, output);
+        const deploymentParams = this.prepareDeploymentParameters(instanceName, acrCredentials, request.skipNorthwind ?? false, output);
         // [7/14] 下載 Rootfs
         output?.section('[7/14] Checking Ubuntu rootfs').flush();
         output?.item('arrow', 'Checking rootfs image...').flush();
@@ -88,7 +88,7 @@ let InstallInstanceUseCase = class InstallInstanceUseCase {
         output?.success('Instance created').flush();
         // 註冊中斷清理 handler（傳入 output 用於輸出清理訊息）
         this.errorHandler.registerCleanupHandler(async () => {
-            await this.cleanupInstance(instanceName, output);
+            await this.cleanupService.cleanupFailedInstallation(instanceName, output);
         }, output);
         output?.newline().flush();
         // 6. 儲存 metadata
@@ -129,7 +129,9 @@ let InstallInstanceUseCase = class InstallInstanceUseCase {
             const version = value_objects_1.ChartVersion.create(versionInput);
             const isValid = await this.deploymentPort.validateChartVersion('uofx', version);
             if (!isValid) {
-                throw new Error(`Chart version "${versionInput}" does not exist`);
+                throw new errors_1.AppError(`Chart version "${versionInput}" does not exist`, {
+                    exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR,
+                });
             }
             output?.success(`Using version: ${version.toString()}`).flush();
             return version;
@@ -177,13 +179,14 @@ let InstallInstanceUseCase = class InstallInstanceUseCase {
      * 準備部署參數
      * @param instanceName - 實例名稱
      * @param acrCredentials - ACR 憑證
+     * @param skipNorthwind - 是否跳過北風資料庫安裝
      * @param output - 輸出介面
      * @returns 部署參數
      */
-    prepareDeploymentParameters(instanceName, acrCredentials, output) {
+    prepareDeploymentParameters(instanceName, acrCredentials, skipNorthwind, output) {
         output?.section('[6/14] Preparing deployment parameters').flush();
         output?.item('arrow', 'Generating security credentials...').flush();
-        const params = entities_1.DeploymentParameters.createWithGeneratedCredentials(instanceName, acrCredentials);
+        const params = entities_1.DeploymentParameters.createWithGeneratedCredentials(instanceName, acrCredentials, skipNorthwind);
         output?.success('Deployment parameters ready').newline().flush();
         return params;
     }
@@ -200,7 +203,7 @@ let InstallInstanceUseCase = class InstallInstanceUseCase {
         // [10/14] 建立全域設定 Secret
         output?.section('[10/14] Configuring Kubernetes secrets').flush();
         output?.item('arrow', 'Creating global config secret...').flush();
-        await this.deploymentPort.createGlobalConfigSecret(fullName, params);
+        await this.deploymentPort.createGlobalConfigSecret(fullName, params, output);
         output?.success('Secrets configured').newline().flush();
         // [11/14] 部署 MSSQL
         output?.section('[11/14] Deploying MSSQL').flush();
@@ -252,121 +255,6 @@ let InstallInstanceUseCase = class InstallInstanceUseCase {
             throw error;
         }
     }
-    /**
-     * 確保沒有其他實例正在運行
-     * 安裝新實例前必須停止所有現有實例
-     * @param output - 輸出介面
-     * @throws AppError 若有運行中的實例
-     */
-    async ensureNoRunningInstances(output) {
-        output?.section('[4/14] Checking for running instances').flush();
-        output?.item('arrow', 'Scanning running instances...').flush();
-        const runningInstances = await this.instanceManager.listRunningInstances();
-        if (runningInstances.length > 0) {
-            // 將全名轉換為顯示名稱（移除 uofx- 前綴）
-            const displayNames = runningInstances.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 install: ${runningInstances.length} instance(s) currently running:\n${instanceList}`, {
-                exitCode: exit_codes_1.EXIT_CODES.BUSINESS_ERROR,
-                solution: `Stop all running instances before installing a new one.\nRun: ${stopCommand}`,
-                context: { runningInstances }
-            });
-        }
-        output?.success('No running instances detected').flush();
-    }
-    /**
-     * 清理未完成安裝的實體
-     * 用於安裝中斷時的清理
-     * @param instanceName - 實例名稱
-     * @param output - 輸出介面
-     */
-    async cleanupInstance(instanceName, output) {
-        output?.item('arrow', `Removing incomplete instance: ${instanceName.toString()}`).flush();
-        try {
-            // 嘗試停止實體（如果正在運行）
-            const status = await this.instanceManager.getStatus(instanceName);
-            if (status.isRunning) {
-                output?.indent().item('arrow', 'Stopping instance...').outdent().flush();
-                await this.instanceManager.stop(instanceName, true);
-                output?.indent().success('Instance stopped').outdent().flush();
-            }
-        }
-        catch (error) {
-            output?.indent().warning(`Failed to stop instance: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`).outdent().flush();
-        }
-        try {
-            // 刪除實體
-            output?.indent().item('arrow', 'Deleting instance...').outdent().flush();
-            await this.instanceManager.delete(instanceName);
-            output?.indent().success('Instance deleted').outdent().flush();
-        }
-        catch (error) {
-            output?.indent().warning(`Failed to delete instance: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`).outdent().flush();
-        }
-        try {
-            // 刪除 metadata
-            output?.indent().item('arrow', 'Deleting metadata...').outdent().flush();
-            await this.instanceStorage.deleteInstance(instanceName);
-            output?.indent().success('Metadata deleted').outdent().flush();
-        }
-        catch (error) {
-            output?.indent().warning(`Failed to delete metadata: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`).outdent().flush();
-        }
-    }
-    /**
-     * 檢查 WSL 是否已安裝
-     * @param output - 輸出介面
-     * @throws AppError 若 WSL 未安裝
-     */
-    async checkWslInstalled(output) {
-        output?.section('[1/14] Checking WSL installation').flush();
-        output?.item('arrow', 'Verifying runtime environment...').flush();
-        const runtimeInfo = await this.runtimeEnvironment.getRuntimeInfo();
-        if (!runtimeInfo.isInstalled) {
-            throw new app_error_1.AppError(`${runtimeInfo.type} is not installed on this system`, {
-                exitCode: exit_codes_1.EXIT_CODES.ENVIRONMENT_ERROR,
-                solution: 'Please install WSL first. Run: uofx env setup',
-            });
-        }
-        output?.success(`${runtimeInfo.type} is installed (${runtimeInfo.version})`).flush();
-    }
-    /**
-     * 檢查記憶體可用性
-     * 綜合考量系統剩餘記憶體、WSL 限制、WSL 目前使用量
-     * @param output - 輸出介面
-     */
-    async checkMemoryAvailability(output) {
-        output?.section('[2/14] Checking remaining memory').flush();
-        const memoryInfo = await this.runtimeEnvironment.getMemoryAvailability();
-        // 顯示詳細資訊
-        for (const detail of memoryInfo.details) {
-            const suffix = detail.suffix ? ` (${detail.suffix})` : '';
-            output?.item('bullet', `${detail.label}: ${detail.valueGB.toFixed(2)} GB${suffix}`).flush();
-        }
-        if (memoryInfo.availableGB < runtime_environment_port_1.UOFX_REQUIRED_MEMORY_GB) {
-            output?.newline().flush();
-            output?.warning(`Available memory (${memoryInfo.availableGB.toFixed(2)} GB) is below recommended ${runtime_environment_port_1.UOFX_REQUIRED_MEMORY_GB} GB`).flush();
-            output?.info('Insufficient memory may cause:').flush();
-            output?.item('bullet', 'Kubernetes pods failing to start').flush();
-            output?.item('bullet', 'Services becoming unresponsive or crashing').flush();
-            output?.newline().flush();
-            const shouldContinue = await this.userInteraction.confirm('Do you want to continue installation anyway?', false);
-            if (!shouldContinue) {
-                throw new app_error_1.AppError('Installation cancelled due to insufficient memory', {
-                    exitCode: exit_codes_1.EXIT_CODES.BUSINESS_ERROR,
-                    solution: 'Close other applications or increase memory available for the runtime environment'
-                });
-            }
-        }
-        else {
-            output?.success('Memory check passed').flush();
-        }
-    }
     /**
      * 執行後台健康檢查（含重試機制）
      * 超時後顯示警告但不中斷安裝
@@ -416,9 +304,10 @@ exports.InstallInstanceUseCase = InstallInstanceUseCase = __decorate([
     __param(3, (0, tsyringe_1.inject)(tokens_1.TOKENS.IBaseImagePort)),
     __param(4, (0, tsyringe_1.inject)(tokens_1.TOKENS.IAppConfigPort)),
     __param(5, (0, tsyringe_1.inject)(tokens_1.TOKENS.IErrorHandlerPort)),
-    __param(6, (0, tsyringe_1.inject)(tokens_1.TOKENS.IRuntimeEnvironmentPort)),
-    __param(7, (0, tsyringe_1.inject)(tokens_1.TOKENS.IUserInteractionPort)),
-    __param(8, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.IHttpClient)),
-    __metadata("design:paramtypes", [Object, Object, Object, Object, Object, Object, Object, Object, Object])
+    __param(6, (0, tsyringe_1.inject)(tokens_1.TOKENS.EnvironmentValidator)),
+    __param(7, (0, tsyringe_1.inject)(tokens_1.TOKENS.InstanceCleanupService)),
+    __param(8, (0, tsyringe_1.inject)(tokens_1.TOKENS.IHttpClientPort)),
+    __metadata("design:paramtypes", [Object, Object, Object, Object, Object, Object, env_1.EnvironmentValidator,
+        env_1.InstanceCleanupService, Object])
 ], InstallInstanceUseCase);
 //# sourceMappingURL=install-instance.use-case.js.map

package/dist/application/use-cases/env/list-running-instances.use-case.js

@@ -0,0 +1,47 @@
+"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.ListRunningInstancesUseCase = 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
+ *
+ * 查詢目前所有運行中的 UOFX 實例，可選擇排除特定實例
+ */
+let ListRunningInstancesUseCase = class ListRunningInstancesUseCase {
+    constructor(instanceManager) {
+        this.instanceManager = instanceManager;
+    }
+    /**
+     * 列出運行中實例
+     * @param request - 查詢請求（可指定排除的實例名稱）
+     * @returns 運行中實例清單
+     */
+    async execute(request) {
+        const runningInstances = await this.instanceManager.listRunningInstances();
+        const filtered = request.excludeName
+            ? runningInstances.filter(name => name !== instance_name_value_object_1.InstanceName.create(request.excludeName).fullName)
+            : runningInstances;
+        return { instances: filtered };
+    }
+};
+exports.ListRunningInstancesUseCase = ListRunningInstancesUseCase;
+exports.ListRunningInstancesUseCase = ListRunningInstancesUseCase = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.IInstanceManagerPort)),
+    __metadata("design:paramtypes", [Object])
+], ListRunningInstancesUseCase);
+//# sourceMappingURL=list-running-instances.use-case.js.map

package/dist/application/use-cases/{setup → env}/setup-environment.use-case.js

@@ -15,32 +15,62 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SetupEnvironmentUseCase = void 0;
 const tsyringe_1 = require("tsyringe");
 const tokens_1 = require("../../../di/tokens");
+const runtime_environment_port_1 = require("../../../domain/ports/runtime-environment.port");
 const environment_validation_entity_1 = require("../../../domain/entities/environment-validation.entity");
 /**
  * 設置環境 Use Case
  *
  * 檢查系統環境是否符合 UOFX 運行需求
+ * 包含 OS、Runtime、記憶體、系統資源、網路檢查，以及 WSL 狀態檢查與互動式設定
  */
 let SetupEnvironmentUseCase = class SetupEnvironmentUseCase {
-    constructor(runtimeEnv) {
+    constructor(runtimeEnv, wslSetupPort) {
         this.runtimeEnv = runtimeEnv;
+        this.wslSetupPort = wslSetupPort;
     }
-    async execute() {
+    /**
+     * 執行環境檢查
+     * @param output - 可選的輸出介面，用於 WSL 設定流程的互動輸出
+     * @returns 環境檢查結果
+     */
+    async execute(output) {
         // 並行執行所有檢查
-        const [osInfo, runtimeInfo, systemResources, networkStatus] = await Promise.all([
+        const [osInfo, runtimeInfo, systemResources, networkStatus, memoryAvailability] = await Promise.all([
             this.runtimeEnv.getOsInfo(),
             this.runtimeEnv.getRuntimeInfo(),
             this.runtimeEnv.getSystemResources(),
             this.runtimeEnv.checkNetworkConnectivity(),
+            this.runtimeEnv.getMemoryAvailability(),
         ]);
+        // WSL 狀態檢查與條件式設定
+        let wslSetup;
+        const wslStatus = await this.wslSetupPort.getWslStatus();
+        if (!wslStatus.isInstalled) {
+            // WSL 未安裝 → 透過 Port 進行互動式安裝
+            const result = await this.wslSetupPort.promptAndSetupWsl(wslStatus, output);
+            wslSetup = result;
+        }
+        else if (wslStatus.needsUpdate || wslStatus.needsDefaultVersion) {
+            // WSL 已安裝但需要更新或設定 → 透過 Port 進行互動式設定
+            const result = await this.wslSetupPort.promptAndSetupWsl(wslStatus, output);
+            wslSetup = result;
+        }
         // 使用 Entity 進行驗證
         const validation = environment_validation_entity_1.EnvironmentValidation.create(osInfo, runtimeInfo, systemResources, networkStatus);
+        // 記憶體可用性
+        const isSufficient = memoryAvailability.availableGB >= runtime_environment_port_1.UOFX_REQUIRED_MEMORY_GB;
         return {
             osInfo,
             runtimeInfo,
             systemResources,
             networkStatus,
             allChecksPassed: validation.allChecksPassed,
+            memoryInfo: {
+                availableGB: memoryAvailability.availableGB,
+                details: memoryAvailability.details,
+                isSufficient,
+            },
+            wslSetup,
         };
     }
 };
@@ -48,6 +78,7 @@ 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])
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.IWslSetupPort)),
+    __metadata("design:paramtypes", [Object, Object])
 ], SetupEnvironmentUseCase);
 //# sourceMappingURL=setup-environment.use-case.js.map

package/dist/application/use-cases/{instance → env}/start-instance.use-case.js

@@ -18,14 +18,14 @@ 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");
+const errors_1 = require("../../../domain/errors");
 /**
  * 啟動實例 Use Case
  */
 let StartInstanceUseCase = class StartInstanceUseCase {
-    constructor(instanceManager) {
+    constructor(instanceManager, interaction) {
         this.instanceManager = instanceManager;
+        this.interaction = interaction;
     }
     /**
      * 啟動實例
@@ -34,12 +34,21 @@ let StartInstanceUseCase = class StartInstanceUseCase {
      * @returns 啟動結果與連線資訊
      */
     async execute(request, output) {
-        const { name, waitForReady = true } = request;
+        const { name, waitForReady = true, resolveConflicts = false } = request;
         const instanceName = instance_name_value_object_1.InstanceName.create(name);
         // 驗證實例存在
         await this.instanceManager.requireExists(instanceName);
-        // 檢查是否有其他實例正在運行
-        await this.ensureNoOtherRunningInstances(instanceName);
+        // 檢查是否有其他實例正在運行，並處理衝突
+        const cancelled = await this.handleRunningInstanceConflicts(instanceName, resolveConflicts, output);
+        if (cancelled) {
+            return {
+                success: false,
+                instanceName: instanceName.fullName,
+                alreadyRunning: false,
+                podsReady: false,
+                connectionInfo: { instanceIp: null, adminUrl: null, sqlServer: null },
+            };
+        }
         // 取得生命週期狀態
         // 重要：必須先檢查 WSL 狀態，再檢查 MicroK8s 狀態
         // 因為 isMicroK8sRunning 會執行 wsl -d xxx -- ... 命令，這會觸發 WSL 自動啟動
@@ -61,7 +70,7 @@ let StartInstanceUseCase = class StartInstanceUseCase {
         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);
+            podsReady = await this.instanceManager.waitForPodsReady(instanceName);
             if (podsReady) {
                 output?.success('All pods are ready').flush();
             }
@@ -92,26 +101,6 @@ let StartInstanceUseCase = class StartInstanceUseCase {
         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);
-    }
     /**
      * 取得連線資訊
      */
@@ -121,34 +110,57 @@ let StartInstanceUseCase = class StartInstanceUseCase {
         return connectionInfo.toDto();
     }
     /**
-     * 確保沒有其他實例正在運行
-     * 同時只能有一個實例運行
+     * 處理運行中實例衝突
+     *
+     * 若有其他實例正在運行：
+     * - resolveConflicts=true：互動式詢問使用者是否停止衝突實例
+     * - resolveConflicts=false：直接拋出錯誤
+     *
      * @param currentInstance - 當前要啟動的實例
-     * @throws AppError 若有其他運行中的實例
+     * @param resolveConflicts - 是否互動式解決衝突
+     * @param output - 輸出介面
+     * @returns true 表示使用者取消操作，false 表示可繼續
      */
-    async ensureNoOtherRunningInstances(currentInstance) {
-        const otherRunning = await this.listOtherRunningInstances(currentInstance.toString());
-        if (otherRunning.length > 0) {
-            // 將全名轉換為顯示名稱（移除 uofx- 前綴）
+    async handleRunningInstanceConflicts(currentInstance, resolveConflicts, output) {
+        const runningInstances = await this.instanceManager.listRunningInstances();
+        const otherRunning = runningInstances.filter(name => name !== currentInstance.fullName);
+        if (otherRunning.length === 0) {
+            return false;
+        }
+        if (!resolveConflicts) {
+            // 非互動模式：直接拋出錯誤
             const displayNames = otherRunning.map(name => name.replace('uofx-', ''));
-            const instanceList = displayNames
-                .map(name => `  - ${name}`)
-                .join('\n');
+            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,
+            throw new errors_1.AppError(`Cannot start: another instance is already running:\n${instanceList}`, {
+                exitCode: errors_1.EXIT_CODES.BUSINESS_ERROR,
                 solution: `Only one instance can run at a time.\nRun: ${stopCommand}`,
-                context: { otherRunning }
+                context: { otherRunning },
             });
         }
+        // 互動模式：詢問使用者是否停止衝突實例
+        const otherName = otherRunning[0];
+        output?.newline().warning(`Another instance is already running: ${otherName}`).flush();
+        const shouldStop = await this.interaction.confirm(`Do you want to stop "${otherName}" and start "${currentInstance.fullName}"?`, false);
+        if (!shouldStop) {
+            output?.info('Start cancelled').render();
+            return true;
+        }
+        // 停止衝突實例
+        const stopInstanceName = instance_name_value_object_1.InstanceName.createFromFullName(otherName);
+        output?.info(`Stopping ${otherName}...`).flush();
+        await this.instanceManager.stop(stopInstanceName, true, output);
+        output?.success(`${otherName} stopped`).flush();
+        return false;
     }
 };
 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])
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.IUserInteractionPort)),
+    __metadata("design:paramtypes", [Object, Object])
 ], StartInstanceUseCase);
 //# sourceMappingURL=start-instance.use-case.js.map

package/dist/application/use-cases/index.js

@@ -3,6 +3,7 @@
  * Application Use Cases
  *
  * 業務流程編排層，協調 Domain 層與 Infrastructure 層
+ * 按指令群組組織
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -19,10 +20,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./instance"), exports);
-__exportStar(require("./config/get-config.use-case"), exports);
-__exportStar(require("./config/set-config.use-case"), exports);
-__exportStar(require("./credentials/get-credentials.use-case"), exports);
-__exportStar(require("./logs/show-logs.use-case"), exports);
-__exportStar(require("./setup/setup-environment.use-case"), exports);
+// Env 指令群組 (instance, setup, credentials)
+__exportStar(require("./env"), exports);
+// Config 指令群組
+__exportStar(require("./config"), exports);
+// Logs 指令群組
+__exportStar(require("./logs"), exports);
+// Dev 指令群組
+__exportStar(require("./dev"), exports);
 //# sourceMappingURL=index.js.map

package/dist/application/use-cases/logs/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Logs 指令群組 Use Cases
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./show-logs.use-case"), exports);
+//# sourceMappingURL=index.js.map