@uofx/cli 1.0.0

package/dist/di/modules/infrastructure.module.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInfrastructureModule = registerInfrastructureModule;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../tokens");
+const platform_detector_1 = require("../../infrastructure/platform-detector");
+// ===== Adapters (Domain Ports 實作) =====
+const wsl_instance_manager_adapter_1 = require("../../infrastructure/platforms/windows/wsl-instance-manager.adapter");
+const wsl_base_image_adapter_1 = require("../../infrastructure/platforms/windows/wsl-base-image.adapter");
+const deployment_adapter_1 = require("../../infrastructure/deployment/deployment.adapter");
+const user_settings_adapter_1 = require("../../infrastructure/persistence/user-settings.adapter");
+const instance_storage_adapter_1 = require("../../infrastructure/persistence/instance-storage.adapter");
+const logger_adapter_1 = require("../../infrastructure/logger/logger.adapter");
+const windows_environment_adapter_1 = require("../../infrastructure/environment/windows-environment.adapter");
+// ===== Internal Services - Windows/WSL =====
+const wsl_info_service_1 = require("../../infrastructure/platforms/windows/services/wsl-info.service");
+const wsl_config_service_1 = require("../../infrastructure/platforms/windows/services/wsl-config.service");
+const wsl_updater_service_1 = require("../../infrastructure/platforms/windows/services/wsl-updater.service");
+const rootfs_manager_service_1 = require("../../infrastructure/platforms/windows/services/rootfs-manager.service");
+const microk8s_service_1 = require("../../infrastructure/platforms/windows/services/microk8s.service");
+// ===== WSL 子服務 (取代 WslManagerService) =====
+const wsl_instance_naming_service_1 = require("../../infrastructure/platforms/windows/services/wsl-instance-naming.service");
+const wsl_instance_lifecycle_service_1 = require("../../infrastructure/platforms/windows/services/wsl-instance-lifecycle.service");
+const wsl_instance_inspection_service_1 = require("../../infrastructure/platforms/windows/services/wsl-instance-inspection.service");
+// ===== Internal Services - Persistence =====
+const instance_metadata_adapter_1 = require("../../infrastructure/persistence/instance-metadata.adapter");
+// ===== Internal Services - Environment (平台無關) =====
+const network_checker_service_1 = require("../../infrastructure/environment/services/network-checker.service");
+const hardware_info_service_1 = require("../../infrastructure/environment/services/hardware-info.service");
+// ===== Internal Services - Windows Platform =====
+const windows_info_service_1 = require("../../infrastructure/platforms/windows/services/windows-info.service");
+const windows_features_service_1 = require("../../infrastructure/platforms/windows/services/windows-features.service");
+const wslconfig_parser_service_1 = require("../../infrastructure/platforms/windows/services/wslconfig-parser.service");
+// ===== Internal Services - Deployment =====
+const helm_registry_service_1 = require("../../infrastructure/deployment/services/helm-registry.service");
+const secret_manager_service_1 = require("../../infrastructure/deployment/services/secret-manager.service");
+const version_compatibility_service_1 = require("../../infrastructure/deployment/services/version-compatibility.service");
+const oci_artifact_service_1 = require("../../infrastructure/deployment/services/oci-artifact.service");
+const infra_manager_service_1 = require("../../infrastructure/deployment/services/infra-manager.service");
+const service_manager_service_1 = require("../../infrastructure/deployment/services/service-manager.service");
+const app_manager_service_1 = require("../../infrastructure/deployment/services/app-manager.service");
+// ===== MSSQL 子服務 (取代 MssqlManagerService) =====
+const mssql_helm_deployment_service_1 = require("../../infrastructure/deployment/services/mssql-helm-deployment.service");
+const mssql_storage_service_1 = require("../../infrastructure/deployment/services/mssql-storage.service");
+const mssql_database_init_service_1 = require("../../infrastructure/deployment/services/mssql-database-init.service");
+const mssql_user_manager_service_1 = require("../../infrastructure/deployment/services/mssql-user-manager.service");
+const k8s_job_runner_service_1 = require("../../infrastructure/deployment/services/k8s-job-runner.service");
+// ===== Internal Services - Persistence =====
+const file_system_instance_repository_1 = require("../../infrastructure/persistence/services/file-system-instance.repository");
+const file_system_config_repository_1 = require("../../infrastructure/persistence/services/file-system-config.repository");
+// ===== Internal Services - Logger =====
+const file_log_writer_repository_1 = require("../../infrastructure/logger/services/file-log-writer.repository");
+const file_log_reader_repository_1 = require("../../infrastructure/logger/services/file-log-reader.repository");
+const correlation_id_adapter_1 = require("../../infrastructure/logger/correlation-id.adapter");
+// ===== Internal Services - Execution =====
+const command_executor_service_1 = require("../../infrastructure/execution/command-executor.service");
+const script_executor_service_1 = require("../../infrastructure/execution/script-executor.service");
+const execution_environment_factory_1 = require("../../infrastructure/execution/execution-environment.factory");
+const host_command_builder_1 = require("../../infrastructure/execution/builders/host-command.builder");
+const windows_host_command_builder_1 = require("../../infrastructure/execution/builders/windows-host-command.builder");
+const environments_1 = require("../../constants/environments");
+// ===== Internal Services - HTTP =====
+const http_client_service_1 = require("../../infrastructure/http/http-client.service");
+// ===== Internal Services - Config =====
+const app_config_service_1 = require("../../infrastructure/config/app-config.service");
+// ===== Internal Services - Error Handling =====
+const error_handler_1 = require("../../infrastructure/errors/error-handler");
+// ===== Internal Services - ACR Credentials (merged into Deployment) =====
+const acr_credential_manager_service_1 = require("../../infrastructure/deployment/services/acr-credential-manager.service");
+/**
+ * 註冊 Infrastructure 模組
+ *
+ * 根據平台動態註冊對應的 Adapter
+ *
+ * 重要：註冊順序需遵循依賴關係
+ * - 被依賴的服務必須在依賴它的服務之前註冊
+ * - 特別是 VersionCompatibilityService 依賴 HttpClient, AppConfig, AcrCredentialManager
+ */
+function registerInfrastructureModule() {
+    const platform = (0, platform_detector_1.detectPlatform)();
+    // =========================================================================
+    // 第 1 層：基礎服務（無外部依賴或僅依賴 Node.js 內建模組）
+    // =========================================================================
+    // Node.js Process（用於信號處理）
+    tsyringe_1.container.registerInstance(tokens_1.TOKENS.Internal.Process, process);
+    // Logger 底層服務（無依賴）
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.FileLogWriter, file_log_writer_repository_1.FileLogWriterRepository);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.FileLogReader, file_log_reader_repository_1.FileLogReaderRepository);
+    // HTTP 客戶端（無依賴）
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.HttpClientService, http_client_service_1.HttpClientService);
+    // 執行器服務（無依賴）
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.CommandExecutorService, command_executor_service_1.CommandExecutorService);
+    // 主機命令建構器（根據平台註冊對應實作）
+    if (process.platform === environments_1.PLATFORM_TYPES.WINDOWS) {
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IHostCommandBuilder, windows_host_command_builder_1.WindowsHostCommandBuilder);
+    }
+    else {
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IHostCommandBuilder, host_command_builder_1.HostCommandBuilder);
+    }
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.ExecutionEnvironmentFactory, execution_environment_factory_1.ExecutionEnvironmentFactory);
+    // =========================================================================
+    // 第 2 層：Logger Port（依賴 FileLogWriter, FileLogReader）
+    // =========================================================================
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.ILoggerPort, logger_adapter_1.LoggerAdapter);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.ICorrelationIdPort, correlation_id_adapter_1.CorrelationIdAdapter);
+    // =========================================================================
+    // 第 3 層：Config 服務（依賴 Logger）
+    // =========================================================================
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.AppConfig, app_config_service_1.AppConfig);
+    // 公開 token 映射
+    tsyringe_1.container.register(tokens_1.TOKENS.IAppConfig, { useToken: tokens_1.TOKENS.Internal.AppConfig });
+    // Domain Port 映射（AppConfig 同時實作 IAppConfig 和 IAppConfigPort）
+    tsyringe_1.container.register(tokens_1.TOKENS.IAppConfigPort, { useToken: tokens_1.TOKENS.Internal.AppConfig });
+    // =========================================================================
+    // 第 4 層：錯誤處理（依賴 Logger, Config）
+    // =========================================================================
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.ErrorHandler, error_handler_1.ErrorHandler);
+    // Domain Port 映射
+    tsyringe_1.container.register(tokens_1.TOKENS.IErrorHandlerPort, { useToken: tokens_1.TOKENS.Internal.ErrorHandler });
+    // =========================================================================
+    // 第 5 層：ACR 憑證管理（依賴 AppConfig）
+    // =========================================================================
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.AcrCredentialManager, acr_credential_manager_service_1.AcrCredentialManagerService);
+    // =========================================================================
+    // 第 6 層：版本相容性服務（依賴 HttpClient, AppConfig, AcrCredentialManager, Logger）
+    // =========================================================================
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.VersionCompatibilityService, version_compatibility_service_1.VersionCompatibilityService);
+    // =========================================================================
+    // 第 6.5 層：OCI Artifact 服務（依賴 HttpClient, AppConfig, ExecutionEnvironmentFactory, Logger）
+    // =========================================================================
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IOciArtifactService, oci_artifact_service_1.OciArtifactService);
+    // =========================================================================
+    // 第 7 層：其他部署相關服務
+    // =========================================================================
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.HelmRegistryService, helm_registry_service_1.HelmRegistryService);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.SecretManagerService, secret_manager_service_1.SecretManagerService);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.InfraManagerService, infra_manager_service_1.InfraManagerService);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.ServiceManagerService, service_manager_service_1.ServiceManagerService);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.AppManagerService, app_manager_service_1.AppManagerService);
+    // MSSQL 子服務（取代 MssqlManagerService）
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IMssqlStorage, mssql_storage_service_1.MssqlStorageService);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IMssqlDatabaseInit, mssql_database_init_service_1.MssqlDatabaseInitService);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IMssqlUserManager, mssql_user_manager_service_1.MssqlUserManagerService);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IK8sJobRunner, k8s_job_runner_service_1.K8sJobRunnerService);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IMssqlHelmDeployment, mssql_helm_deployment_service_1.MssqlHelmDeploymentService);
+    // =========================================================================
+    // 第 8 層：Script 執行器（依賴 CommandExecutor）
+    // =========================================================================
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.ScriptExecutorService, script_executor_service_1.ScriptExecutorService);
+    // =========================================================================
+    // 第 9 層：Persistence 服務
+    // =========================================================================
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.FileInstanceRepository, file_system_instance_repository_1.FileSystemInstanceRepository);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.FileConfigRepository, file_system_config_repository_1.FileSystemConfigRepository);
+    // =========================================================================
+    // 第 10 層：System 服務（平台無關）
+    // =========================================================================
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.NetworkCheckerService, network_checker_service_1.NetworkCheckerService);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IHardwareInfo, hardware_info_service_1.HardwareInfoService);
+    // =========================================================================
+    // 第 11 層：Platform-Specific 服務（Windows/WSL）
+    // =========================================================================
+    if (platform === 'windows') {
+        // Windows 系統資源服務
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.WindowsInfoService, windows_info_service_1.WindowsInfoService);
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.WindowsFeaturesService, windows_features_service_1.WindowsFeaturesService);
+        // WSL 相關服務
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.WslInfoService, wsl_info_service_1.WslInfoService);
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IWslConfigParser, wslconfig_parser_service_1.WslConfigParserService);
+        // WSL 子服務（取代 WslManagerService）
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IWslInstanceNaming, wsl_instance_naming_service_1.WslInstanceNamingService);
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IWslInstanceInspection, wsl_instance_inspection_service_1.WslInstanceInspectionService);
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.IWslInstanceLifecycle, wsl_instance_lifecycle_service_1.WslInstanceLifecycleService);
+        // 其他 WSL 相關服務
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.WslConfigService, wsl_config_service_1.WslConfigService);
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.WslUpdaterService, wsl_updater_service_1.WslUpdaterService);
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.RootfsManagerService, rootfs_manager_service_1.RootfsManagerService);
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.Internal.MicroK8sService, microk8s_service_1.MicroK8sService);
+    }
+    // =========================================================================
+    // 第 12 層：Domain Ports - Adapters（依賴上述所有服務）
+    // =========================================================================
+    if (platform === 'windows') {
+        // Windows/WSL 平台
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.IInstanceManagerPort, wsl_instance_manager_adapter_1.WslInstanceManagerAdapter);
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.IBaseImagePort, wsl_base_image_adapter_1.WslBaseImageAdapter);
+        tsyringe_1.container.registerSingleton(tokens_1.TOKENS.IRuntimeEnvironmentPort, windows_environment_adapter_1.WindowsEnvironmentAdapter);
+    }
+    else if (platform === 'linux') {
+        // Linux/Docker 平台（未來實作）
+        throw new Error('Linux platform not yet implemented');
+    }
+    else {
+        throw new Error(`Unsupported platform: ${platform}`);
+    }
+    // 共用 Ports（跨平台）
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.IDeploymentPort, deployment_adapter_1.DeploymentAdapter);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.IUserSettingsPort, user_settings_adapter_1.UserSettingsAdapter);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.IInstanceStoragePort, instance_storage_adapter_1.InstanceStorageAdapter);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.IInstanceMetadataPort, instance_metadata_adapter_1.InstanceMetadataAdapter);
+    // 子介面映射（使用相同的 DeploymentAdapter 實作）
+    tsyringe_1.container.register(tokens_1.TOKENS.IK8sDeployerPort, { useToken: tokens_1.TOKENS.IDeploymentPort });
+    tsyringe_1.container.register(tokens_1.TOKENS.IChartVersionPort, { useToken: tokens_1.TOKENS.IDeploymentPort });
+    tsyringe_1.container.register(tokens_1.TOKENS.ICredentialsPort, { useToken: tokens_1.TOKENS.IDeploymentPort });
+}
+//# sourceMappingURL=infrastructure.module.js.map

package/dist/di/modules/interceptor.module.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInterceptorModule = registerInterceptorModule;
+exports.applyInterceptors = applyInterceptors;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../tokens");
+const interceptors_1 = require("../../infrastructure/interceptors");
+/**
+ * 註冊攔截器模組
+ *
+ * 註冊 LoggingInterceptor 和 InterceptorFactory 為 Singleton
+ */
+function registerInterceptorModule() {
+    tsyringe_1.container.registerSingleton(interceptors_1.LoggingInterceptor);
+    tsyringe_1.container.registerSingleton(interceptors_1.InterceptorFactory);
+}
+/**
+ * 需要攔截的服務清單
+ *
+ * token: DI 容器中的 Token
+ * name: 服務名稱（用於 log 標識）
+ */
+const INTERCEPTED_SERVICES = [
+    // === 核心服務 ===
+    { token: tokens_1.TOKENS.IDeploymentPort, name: 'DeploymentAdapter' },
+    { token: tokens_1.TOKENS.Internal.VersionCompatibilityService, name: 'VersionCompatibility' },
+    { token: tokens_1.TOKENS.Internal.IHelmRegistry, name: 'HelmRegistry' },
+    { token: tokens_1.TOKENS.Internal.IWslInstanceLifecycle, name: 'WslInstanceLifecycle' },
+    // === K8s/Helm 服務 ===
+    { token: tokens_1.TOKENS.Internal.IOciArtifactService, name: 'OciArtifact' },
+    { token: tokens_1.TOKENS.Internal.ISecretManager, name: 'SecretManager' },
+    { token: tokens_1.TOKENS.Internal.IK8sJobRunner, name: 'K8sJobRunner' },
+    { token: tokens_1.TOKENS.Internal.IMicroK8s, name: 'MicroK8s' },
+    // === 部署管理服務 ===
+    { token: tokens_1.TOKENS.Internal.IInfraManager, name: 'InfraManager' },
+    { token: tokens_1.TOKENS.Internal.IServiceManager, name: 'ServiceManager' },
+    { token: tokens_1.TOKENS.Internal.IAppManager, name: 'AppManager' },
+    // === MSSQL 服務 ===
+    { token: tokens_1.TOKENS.Internal.IMssqlHelmDeployment, name: 'MssqlHelmDeployment' },
+    { token: tokens_1.TOKENS.Internal.IMssqlStorage, name: 'MssqlStorage' },
+    { token: tokens_1.TOKENS.Internal.IMssqlDatabaseInit, name: 'MssqlDatabaseInit' },
+    // === WSL 服務 ===
+    { token: tokens_1.TOKENS.Internal.IWslInstanceInspection, name: 'WslInstanceInspection' },
+    { token: tokens_1.TOKENS.Internal.RootfsManagerService, name: 'RootfsManager' },
+    // === 執行/網路服務 ===
+    { token: tokens_1.TOKENS.Internal.ICommandExecutor, name: 'CommandExecutor' },
+    { token: tokens_1.TOKENS.Internal.IHttpClient, name: 'HttpClient' },
+    { token: tokens_1.TOKENS.Internal.IAcrCredentialManager, name: 'AcrCredentialManager' },
+];
+/**
+ * 套用攔截器到已註冊的服務
+ *
+ * 注意：此函數必須在所有服務註冊完成後調用
+ */
+function applyInterceptors() {
+    const factory = tsyringe_1.container.resolve(interceptors_1.InterceptorFactory);
+    for (const { token, name } of INTERCEPTED_SERVICES) {
+        try {
+            const original = tsyringe_1.container.resolve(token);
+            const intercepted = factory.wrapWithInterceptors(original, name);
+            tsyringe_1.container.registerInstance(token, intercepted);
+        }
+        catch {
+            // 服務可能未註冊，跳過
+        }
+    }
+}
+//# sourceMappingURL=interceptor.module.js.map

package/dist/di/modules/presentation.module.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPresentationModule = registerPresentationModule;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../tokens");
+// UI Services
+const output_builder_service_1 = require("../../presentation/ui/output-builder.service");
+const output_formatter_service_1 = require("../../presentation/ui/output-formatter.service");
+const interaction_service_1 = require("../../presentation/ui/interaction.service");
+const cli_progress_service_1 = require("../../presentation/ui/cli-progress.service");
+// Prompts
+const acr_credentials_prompt_1 = require("../../presentation/prompts/acr-credentials.prompt");
+// Controllers
+const instance_controller_1 = require("../../presentation/controllers/instance.controller");
+const setup_controller_1 = require("../../presentation/controllers/setup.controller");
+const config_controller_1 = require("../../presentation/controllers/config.controller");
+const logs_controller_1 = require("../../presentation/controllers/logs.controller");
+const credentials_controller_1 = require("../../presentation/controllers/credentials.controller");
+function registerPresentationModule() {
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.IOutputPort, output_builder_service_1.OutputBuilder);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.IProgress, cli_progress_service_1.CliProgress);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.IOutputFormatter, output_formatter_service_1.OutputFormatter);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.IUserInteractionPort, interaction_service_1.UserInteraction);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.AcrCredentialsPrompt, acr_credentials_prompt_1.AcrCredentialsPrompt);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.InstanceController, instance_controller_1.InstanceController);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.SetupController, setup_controller_1.SetupController);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.ConfigController, config_controller_1.ConfigController);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.LogsController, logs_controller_1.LogsController);
+    tsyringe_1.container.registerSingleton(tokens_1.TOKENS.CredentialsController, credentials_controller_1.CredentialsController);
+}
+//# sourceMappingURL=presentation.module.js.map

package/dist/di/tokens.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * DI Container Token 定義
+ *
+ * 根據 Clean Architecture 分層組織所有依賴注入的 Token
+ * 使用字串常數而非 Symbol，以便於除錯和序列化
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOKENS = void 0;
+exports.TOKENS = {
+    // ===========================================================================
+    // Domain Ports (12 個核心業務能力 Port)
+    // ===========================================================================
+    IInstanceManagerPort: 'IInstanceManagerPort',
+    IDeploymentPort: 'IDeploymentPort',
+    IK8sDeployerPort: 'IK8sDeployerPort',
+    IChartVersionPort: 'IChartVersionPort',
+    ICredentialsPort: 'ICredentialsPort',
+    ILoggerPort: 'ILoggerPort',
+    IRuntimeEnvironmentPort: 'IRuntimeEnvironmentPort',
+    IBaseImagePort: 'IBaseImagePort',
+    IAppConfigPort: 'IAppConfigPort',
+    IUserSettingsPort: 'IUserSettingsPort',
+    IInstanceStoragePort: 'IInstanceStoragePort',
+    IErrorHandlerPort: 'IErrorHandlerPort',
+    ICorrelationIdPort: 'ICorrelationIdPort',
+    IInstanceMetadataPort: 'IInstanceMetadataPort',
+    IUserInteractionPort: 'IUserInteractionPort',
+    // ===========================================================================
+    // Application Layer - Use Cases
+    // ===========================================================================
+    // --- Instance Use Cases ---
+    InstallInstanceUseCase: 'InstallInstanceUseCase',
+    StartInstanceUseCase: 'StartInstanceUseCase',
+    StopInstanceUseCase: 'StopInstanceUseCase',
+    DeleteInstanceUseCase: 'DeleteInstanceUseCase',
+    ListInstancesUseCase: 'ListInstancesUseCase',
+    ListChartsUseCase: 'ListChartsUseCase',
+    // --- Setup Use Cases ---
+    SetupEnvironmentUseCase: 'SetupEnvironmentUseCase',
+    // --- Config Use Cases ---
+    GetConfigUseCase: 'GetConfigUseCase',
+    SetConfigUseCase: 'SetConfigUseCase',
+    // --- Credentials Use Cases ---
+    GetCredentialsUseCase: 'GetCredentialsUseCase',
+    // --- Logs Use Cases ---
+    ShowLogsUseCase: 'ShowLogsUseCase',
+    // ===========================================================================
+    // Presentation Layer - Controllers & UI Services
+    // ===========================================================================
+    // --- Controllers ---
+    InstanceController: 'InstanceController',
+    SetupController: 'SetupController',
+    ConfigController: 'ConfigController',
+    LogsController: 'LogsController',
+    CredentialsController: 'CredentialsController',
+    // --- UI Services ---
+    ISystemOutput: 'ISystemOutput',
+    IOutputPort: 'IOutputPort',
+    IProgress: 'IProgress',
+    IOutputFormatter: 'IOutputFormatter',
+    // --- Infrastructure Common Services (CLI 啟動時需要) ---
+    IAppConfig: 'IAppConfig',
+    // --- Prompts ---
+    AcrCredentialsPrompt: 'AcrCredentialsPrompt',
+    // ===========================================================================
+    // Internal Services (不公開給其他層，僅供 Infrastructure 內部使用)
+    // ===========================================================================
+    Internal: {
+        // --- Windows/WSL Services ---
+        WslInfoService: 'Internal.WslInfoService',
+        WslConfigService: 'Internal.WslConfigService',
+        IWslConfig: 'Internal.WslConfigService', // Alias for injection
+        WslUpdaterService: 'Internal.WslUpdaterService',
+        RootfsManagerService: 'Internal.RootfsManagerService',
+        WindowsInfoService: 'Internal.WindowsInfoService',
+        WindowsFeaturesService: 'Internal.WindowsFeaturesService',
+        MicroK8sService: 'Internal.MicroK8sService',
+        IMicroK8s: 'Internal.MicroK8sService', // Alias for injection
+        // --- WSL 子服務 (取代 WslManagerService) ---
+        WslInstanceNamingService: 'Internal.WslInstanceNamingService',
+        IWslInstanceNaming: 'Internal.WslInstanceNamingService',
+        WslInstanceLifecycleService: 'Internal.WslInstanceLifecycleService',
+        IWslInstanceLifecycle: 'Internal.WslInstanceLifecycleService',
+        WslInstanceInspectionService: 'Internal.WslInstanceInspectionService',
+        IWslInstanceInspection: 'Internal.WslInstanceInspectionService',
+        // --- K8s/Helm Services ---
+        HelmService: 'Internal.HelmService',
+        HelmRegistryService: 'Internal.HelmRegistryService',
+        IHelmRegistry: 'Internal.HelmRegistryService', // Alias for injection
+        SecretManagerService: 'Internal.SecretManagerService',
+        ISecretManager: 'Internal.SecretManagerService', // Alias for injection
+        VersionCompatibilityService: 'Internal.VersionCompatibilityService',
+        // --- OCI Artifact Services ---
+        OciArtifactService: 'Internal.OciArtifactService',
+        IOciArtifactService: 'Internal.OciArtifactService', // Alias for injection
+        // --- MSSQL Services ---
+        MssqlHelmDeploymentService: 'Internal.MssqlHelmDeploymentService',
+        IMssqlHelmDeployment: 'Internal.MssqlHelmDeploymentService',
+        MssqlStorageService: 'Internal.MssqlStorageService',
+        IMssqlStorage: 'Internal.MssqlStorageService',
+        MssqlDatabaseInitService: 'Internal.MssqlDatabaseInitService',
+        IMssqlDatabaseInit: 'Internal.MssqlDatabaseInitService',
+        MssqlUserManagerService: 'Internal.MssqlUserManagerService',
+        IMssqlUserManager: 'Internal.MssqlUserManagerService',
+        K8sJobRunnerService: 'Internal.K8sJobRunnerService',
+        IK8sJobRunner: 'Internal.K8sJobRunnerService',
+        InfraManagerService: 'Internal.InfraManagerService',
+        IInfraManager: 'Internal.InfraManagerService', // Alias for injection
+        ServiceManagerService: 'Internal.ServiceManagerService',
+        IServiceManager: 'Internal.ServiceManagerService', // Alias for injection
+        AppManagerService: 'Internal.AppManagerService',
+        IAppManager: 'Internal.AppManagerService', // Alias for injection
+        // --- Persistence Services ---
+        FileInstanceRepository: 'Internal.FileInstanceRepository',
+        FileConfigRepository: 'Internal.FileConfigRepository',
+        // --- Logger Services ---
+        FileLogWriter: 'Internal.FileLogWriter',
+        FileLogReader: 'Internal.FileLogReader',
+        // --- Execution Services ---
+        CommandExecutorService: 'Internal.CommandExecutorService',
+        ICommandExecutor: 'Internal.CommandExecutorService', // Alias for injection
+        ScriptExecutorService: 'Internal.ScriptExecutorService',
+        HttpClientService: 'Internal.HttpClientService',
+        IHttpClient: 'Internal.HttpClientService', // Alias for injection
+        ExecutionEnvironmentFactory: 'Internal.ExecutionEnvironmentFactory',
+        IExecutionEnvironmentFactory: 'Internal.ExecutionEnvironmentFactory', // Alias for injection
+        HostCommandBuilder: 'Internal.HostCommandBuilder',
+        IHostCommandBuilder: 'Internal.HostCommandBuilder', // Alias for injection
+        // --- System Services ---
+        NetworkCheckerService: 'Internal.NetworkCheckerService',
+        // --- System Resources Services ---
+        HardwareInfoService: 'Internal.HardwareInfoService',
+        IHardwareInfo: 'Internal.HardwareInfoService',
+        WslConfigParserService: 'Internal.WslConfigParserService',
+        IWslConfigParser: 'Internal.WslConfigParserService',
+        // --- Security ---
+        AcrCredentialManager: 'Internal.AcrCredentialManager',
+        IAcrCredentialManager: 'Internal.AcrCredentialManager', // Alias for injection
+        // --- Error Handling ---
+        ErrorHandler: 'Internal.ErrorHandler',
+        IErrorHandler: 'Internal.ErrorHandler', // Alias for injection
+        // --- Config ---
+        AppConfig: 'Internal.AppConfig',
+        // --- Node.js Process ---
+        Process: 'Internal.Process',
+    },
+};
+//# sourceMappingURL=tokens.js.map

package/dist/domain/decorators/sensitive.decorator.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SENSITIVE_RETURN_KEY = exports.NO_LOG_ARGS_KEY = exports.SENSITIVE_PARAMS_KEY = void 0;
+exports.Sensitive = Sensitive;
+exports.NoLogArgs = NoLogArgs;
+exports.SensitiveReturn = SensitiveReturn;
+require("reflect-metadata");
+exports.SENSITIVE_PARAMS_KEY = 'sensitive:params';
+exports.NO_LOG_ARGS_KEY = 'nolog:args';
+exports.SENSITIVE_RETURN_KEY = 'sensitive:return';
+/**
+ * 參數裝飾器 - 標記參數為敏感資料
+ */
+function Sensitive(strategy = 'full') {
+    return function (target, propertyKey, parameterIndex) {
+        const existingParams = Reflect.getMetadata(exports.SENSITIVE_PARAMS_KEY, target, propertyKey) || [];
+        existingParams.push({ index: parameterIndex, strategy });
+        Reflect.defineMetadata(exports.SENSITIVE_PARAMS_KEY, existingParams, target, propertyKey);
+    };
+}
+/**
+ * 方法裝飾器 - 標記整個方法的參數為敏感資料
+ */
+function NoLogArgs() {
+    return function (target, propertyKey, descriptor) {
+        Reflect.defineMetadata(exports.NO_LOG_ARGS_KEY, true, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * 方法裝飾器 - 標記方法的返回值為敏感資料
+ */
+function SensitiveReturn() {
+    return function (target, propertyKey, descriptor) {
+        Reflect.defineMetadata(exports.SENSITIVE_RETURN_KEY, true, target, propertyKey);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=sensitive.decorator.js.map

package/dist/domain/entities/credentials-resolver.entity.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CredentialsResolver = void 0;
+/**
+ * 憑證解析策略 Entity
+ *
+ * 封裝 ACR 憑證的解析優先級邏輯：
+ * 1. 優先使用檔案路徑提供的憑證
+ * 2. 其次使用配置中的預設憑證
+ * 3. 都沒有則回報錯誤
+ */
+class CredentialsResolver {
+    constructor(fileCredentials, configCredentials, pullSecretPath) {
+        this.fileCredentials = fileCredentials;
+        this.configCredentials = configCredentials;
+        this.pullSecretPath = pullSecretPath;
+    }
+    /**
+     * 建立憑證解析器
+     * @param fileCredentials - 從檔案載入的憑證（可選）
+     * @param configCredentials - 從配置載入的憑證（可選）
+     * @param pullSecretPath - Pull secret 檔案路徑（可選）
+     * @returns 憑證解析器
+     */
+    static create(fileCredentials, configCredentials, pullSecretPath) {
+        return new CredentialsResolver(fileCredentials, configCredentials, pullSecretPath);
+    }
+    /**
+     * 建立只有檔案憑證的解析器
+     * @param credentials - 檔案憑證
+     * @param path - 檔案路徑
+     * @returns 憑證解析器
+     */
+    static fromFile(credentials, path) {
+        return new CredentialsResolver(credentials, null, path);
+    }
+    /**
+     * 建立只有配置憑證的解析器
+     * @param credentials - 配置憑證
+     * @returns 憑證解析器
+     */
+    static fromConfig(credentials) {
+        return new CredentialsResolver(null, credentials, undefined);
+    }
+    /**
+     * 建立無憑證的解析器
+     * @returns 憑證解析器
+     */
+    static empty() {
+        return new CredentialsResolver(null, null, undefined);
+    }
+    /**
+     * 解析憑證（套用優先級邏輯）
+     * @returns 解析結果
+     */
+    resolve() {
+        // 優先使用檔案憑證
+        if (this.fileCredentials) {
+            return {
+                credentials: this.fileCredentials,
+                source: 'file',
+                resolved: true,
+            };
+        }
+        // 其次使用配置憑證
+        if (this.configCredentials) {
+            return {
+                credentials: this.configCredentials,
+                source: 'config',
+                resolved: true,
+            };
+        }
+        // 都沒有則回報錯誤
+        return {
+            source: 'none',
+            resolved: false,
+            errorMessage: 'No ACR credentials found. Please provide pull secret or configure default credentials.',
+        };
+    }
+    /**
+     * 是否有可用憑證
+     */
+    get hasCredentials() {
+        return this.resolve().resolved;
+    }
+    /**
+     * 取得解析後的憑證
+     * @returns 憑證（如果有）
+     */
+    get credentials() {
+        return this.resolve().credentials;
+    }
+    /**
+     * 取得憑證來源
+     */
+    get source() {
+        return this.resolve().source;
+    }
+    /**
+     * 取得憑證來源描述
+     */
+    get sourceDescription() {
+        const result = this.resolve();
+        switch (result.source) {
+            case 'file':
+                return `from file: ${this.pullSecretPath}`;
+            case 'config':
+                return 'from config';
+            case 'none':
+                return 'not found';
+        }
+    }
+    /**
+     * 解析憑證，若無則拋出錯誤
+     * @returns 憑證
+     * @throws Error 如果無可用憑證
+     */
+    resolveOrThrow() {
+        const result = this.resolve();
+        if (!result.resolved) {
+            throw new Error(result.errorMessage);
+        }
+        return result.credentials;
+    }
+}
+exports.CredentialsResolver = CredentialsResolver;
+//# sourceMappingURL=credentials-resolver.entity.js.map