@uofx/cli 1.0.0

package/dist/infrastructure/environment/services/hardware-info.service.js

@@ -0,0 +1,135 @@
+"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.HardwareInfoService = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../../di/tokens");
+const command_builder_1 = require("../../execution/command-builder");
+const errors_1 = require("../../errors");
+/**
+ * 硬體資訊服務
+ *
+ * 負責取得系統硬體資訊（記憶體、磁碟）
+ */
+let HardwareInfoService = class HardwareInfoService {
+    constructor(commandExecutor) {
+        this.commandExecutor = commandExecutor;
+    }
+    /**
+     * 取得總實體記憶體 (GB)
+     * @returns 記憶體大小 (GB)
+     */
+    async getTotalMemoryGB() {
+        try {
+            const builder = command_builder_1.CommandBuilder.create('powershell')
+                .powershell('(Get-CimInstance Win32_ComputerSystem).TotalPhysicalMemory / 1GB');
+            const result = await builder.exec(this.commandExecutor);
+            const output = result.stdout.trim();
+            const memoryGB = Math.round(parseFloat(output));
+            if (isNaN(memoryGB) || memoryGB <= 0) {
+                throw new errors_1.AppError('Failed to parse total memory', {
+                    exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                    solution: 'Unable to parse memory information from system. Check if PowerShell is available.',
+                    context: { operation: 'getTotalMemoryGB', resource: 'System Memory' }
+                });
+            }
+            return memoryGB;
+        }
+        catch (error) {
+            if (error instanceof errors_1.AppError) {
+                throw error;
+            }
+            throw new errors_1.AppError('Failed to query total memory', {
+                exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                solution: 'Check if PowerShell is available and system memory can be queried',
+                cause: error instanceof Error ? error : undefined,
+                context: { operation: 'getTotalMemoryGB', resource: 'System Memory' }
+            });
+        }
+    }
+    /**
+     * 取得可用實體記憶體 (GB)
+     * @returns 可用記憶體大小 (GB)
+     */
+    async getAvailableMemoryGB() {
+        try {
+            // FreePhysicalMemory 單位是 KB
+            // PowerShell 的 1MB = 1024 * 1024 = 1048576
+            // KB / 1048576 = GB（因為 1GB = 1048576 KB）
+            const builder = command_builder_1.CommandBuilder.create('powershell')
+                .powershell('(Get-CimInstance Win32_OperatingSystem).FreePhysicalMemory / 1MB');
+            const result = await builder.exec(this.commandExecutor);
+            const output = result.stdout.trim();
+            const memoryGB = Math.round(parseFloat(output) * 100) / 100;
+            if (isNaN(memoryGB) || memoryGB < 0) {
+                throw new errors_1.AppError('Failed to parse available memory', {
+                    exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                    solution: 'Unable to parse available memory information from system. Check if PowerShell is available.',
+                    context: { operation: 'getAvailableMemoryGB', resource: 'System Memory' }
+                });
+            }
+            return memoryGB;
+        }
+        catch (error) {
+            if (error instanceof errors_1.AppError) {
+                throw error;
+            }
+            throw new errors_1.AppError('Failed to query available memory', {
+                exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                solution: 'Check if PowerShell is available and system memory can be queried',
+                cause: error instanceof Error ? error : undefined,
+                context: { operation: 'getAvailableMemoryGB', resource: 'System Memory' }
+            });
+        }
+    }
+    /**
+     * 取得可用磁碟空間 (GB)
+     * @returns 可用空間 (GB)
+     */
+    async getAvailableDiskGB() {
+        try {
+            const builder = command_builder_1.CommandBuilder.create('powershell')
+                .powershell('(Get-PSDrive C).Free / 1GB');
+            const result = await builder.exec(this.commandExecutor);
+            const output = result.stdout.trim();
+            const diskGB = Math.round(parseFloat(output));
+            if (isNaN(diskGB) || diskGB < 0) {
+                throw new errors_1.AppError('Failed to parse disk space', {
+                    exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                    solution: 'Unable to parse disk space information from system. Check if PowerShell is available.',
+                    context: { operation: 'getAvailableDiskGB', resource: 'Disk Space' }
+                });
+            }
+            return diskGB;
+        }
+        catch (error) {
+            if (error instanceof errors_1.AppError) {
+                throw error;
+            }
+            throw new errors_1.AppError('Failed to query disk space', {
+                exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                solution: 'Check if PowerShell is available and disk space can be queried',
+                cause: error instanceof Error ? error : undefined,
+                context: { operation: 'getAvailableDiskGB', resource: 'Disk Space' }
+            });
+        }
+    }
+};
+exports.HardwareInfoService = HardwareInfoService;
+exports.HardwareInfoService = HardwareInfoService = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.ICommandExecutor)),
+    __metadata("design:paramtypes", [Object])
+], HardwareInfoService);
+//# sourceMappingURL=hardware-info.service.js.map

package/dist/infrastructure/environment/services/network-checker.service.js

@@ -0,0 +1,142 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkCheckerService = void 0;
+const tsyringe_1 = require("tsyringe");
+const https_1 = __importDefault(require("https"));
+/**
+ * 網路連線檢查服務
+ *
+ * 負責檢查必要的網路連線，包含：
+ * - 單一 URL 連線檢查
+ * - 多個網址批量檢查
+ * - 連線狀態摘要統計
+ */
+let NetworkCheckerService = class NetworkCheckerService {
+    async checkUrlConnectivity(url, timeoutMs = 30000) {
+        return new Promise((resolve) => {
+            const parsedUrl = new URL(url);
+            const options = {
+                hostname: parsedUrl.hostname,
+                port: parsedUrl.port || 443,
+                path: parsedUrl.pathname || '/',
+                method: 'HEAD',
+                timeout: timeoutMs,
+                agent: false, // 停用連線池，請求完成後立即關閉連線
+                headers: {
+                    'User-Agent': 'uofx-cli/1.0'
+                }
+            };
+            const req = https_1.default.request(options, (res) => {
+                resolve({
+                    url: parsedUrl.hostname,
+                    reachable: true,
+                    statusCode: res.statusCode
+                });
+            });
+            req.on('error', (error) => {
+                let errorMessage = 'Connection failed';
+                if (error.code === 'ENOTFOUND') {
+                    errorMessage = 'Host not found (DNS resolution failed)';
+                }
+                else if (error.code === 'ETIMEDOUT' || error.code === 'ESOCKETTIMEDOUT') {
+                    errorMessage = 'Connection timed out';
+                }
+                else if (error.code === 'ECONNREFUSED') {
+                    errorMessage = 'Connection refused';
+                }
+                else if (error.code === 'ECONNRESET') {
+                    errorMessage = 'Connection reset';
+                }
+                else if (error.message) {
+                    errorMessage = error.message;
+                }
+                resolve({
+                    url: parsedUrl.hostname,
+                    reachable: false,
+                    errorMessage
+                });
+            });
+            req.on('timeout', () => {
+                req.destroy();
+                resolve({
+                    url: parsedUrl.hostname,
+                    reachable: false,
+                    errorMessage: 'Request timed out after 30 seconds'
+                });
+            });
+            req.end();
+        });
+    }
+    async checkUbuntuImages() {
+        return await this.checkUrlConnectivity('https://cloud-images.ubuntu.com');
+    }
+    async checkAzureContainerRegistry(acrName) {
+        const url = `https://${acrName}.azurecr.io`;
+        return await this.checkUrlConnectivity(url);
+    }
+    async performNetworkChecks(acrName) {
+        const results = [];
+        // Check Ubuntu Cloud Images
+        const ubuntuResult = await this.checkUbuntuImages();
+        results.push(ubuntuResult);
+        // Check ACR if provided
+        if (acrName) {
+            const acrResult = await this.checkAzureContainerRegistry(acrName);
+            results.push(acrResult);
+        }
+        const allPassed = results.every(r => r.reachable);
+        return {
+            allPassed,
+            results
+        };
+    }
+    formatNetworkSuccess(result) {
+        return `✓ ${result.url} - Reachable`;
+    }
+    formatNetworkError(result) {
+        const lines = [
+            `✗ Error: Unable to connect to ${result.url}`,
+            '',
+            'Possible causes:',
+            '  • No internet connection',
+            '  • Firewall blocking HTTPS traffic',
+            '  • DNS resolution issues',
+            '',
+            'Troubleshooting:',
+            '  1. Check your internet connection',
+            '  2. Try accessing the URL in a browser',
+            '  3. Check firewall settings',
+            '  4. Verify DNS settings'
+        ];
+        if (result.errorMessage) {
+            lines.splice(3, 0, `  • ${result.errorMessage}`);
+        }
+        return lines.join('\n');
+    }
+    formatNetworkCheckSummary(summary) {
+        const lines = [];
+        for (const result of summary.results) {
+            if (result.reachable) {
+                lines.push(this.formatNetworkSuccess(result));
+            }
+            else {
+                lines.push(this.formatNetworkError(result));
+            }
+        }
+        return lines.join('\n');
+    }
+};
+exports.NetworkCheckerService = NetworkCheckerService;
+exports.NetworkCheckerService = NetworkCheckerService = __decorate([
+    (0, tsyringe_1.injectable)()
+], NetworkCheckerService);
+//# sourceMappingURL=network-checker.service.js.map

package/dist/infrastructure/environment/windows-environment.adapter.js

@@ -0,0 +1,162 @@
+"use strict";
+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 __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 __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;
+    };
+})();
+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.WindowsEnvironmentAdapter = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../di/tokens");
+/**
+ * Windows Environment Adapter
+ *
+ * implements IRuntimeEnvironmentPort for Windows platform
+ * 整合 Windows 資訊、WSL 資訊、系統資源、網路檢查
+ */
+let WindowsEnvironmentAdapter = class WindowsEnvironmentAdapter {
+    constructor(windowsInfo, wslInfo, hardware, networkChecker, appConfig, wslConfigParser) {
+        this.windowsInfo = windowsInfo;
+        this.wslInfo = wslInfo;
+        this.hardware = hardware;
+        this.networkChecker = networkChecker;
+        this.appConfig = appConfig;
+        this.wslConfigParser = wslConfigParser;
+    }
+    async getOsInfo() {
+        const windowsVersion = await this.windowsInfo.getWindowsVersion();
+        return {
+            platform: 'win32',
+            version: windowsVersion.version,
+            arch: process.arch,
+        };
+    }
+    async getRuntimeInfo() {
+        const versionInfo = await this.wslInfo.getWslVersionInfo();
+        const isInstalled = await this.wslInfo.isWslInstalled();
+        // 若版本無法取得，視為未正確安裝
+        const hasValidVersion = !!versionInfo.wslVersion;
+        return {
+            type: 'WSL',
+            version: versionInfo.wslVersion || 'unknown',
+            isInstalled: isInstalled && hasValidVersion,
+        };
+    }
+    async isRuntimeInstalled() {
+        return await this.wslInfo.isWslInstalled();
+    }
+    async checkRuntimeUpdate() {
+        const versionInfo = await this.wslInfo.getWslVersionInfo();
+        if (!versionInfo.installed) {
+            return {
+                required: true,
+                reason: 'WSL is not installed',
+            };
+        }
+        const updateReq = this.wslInfo.checkWslUpdateRequirement(versionInfo);
+        return {
+            required: updateReq.needsUpdate || updateReq.needsDefaultVersion,
+            currentVersion: updateReq.currentVersion,
+            reason: updateReq.steps.join('; '),
+        };
+    }
+    async getSystemResources() {
+        const totalMemoryGB = await this.hardware.getTotalMemoryGB();
+        const availableMemoryGB = await this.hardware.getAvailableMemoryGB();
+        const availableDiskGB = await this.hardware.getAvailableDiskGB();
+        // 讀取 WSL 記憶體配置
+        const wslConfig = await this.wslConfigParser.readWslConfig();
+        return {
+            totalMemory: totalMemoryGB * 1024 * 1024 * 1024,
+            freeMemory: availableMemoryGB * 1024 * 1024 * 1024,
+            cpuCount: (await Promise.resolve().then(() => __importStar(require('os')))).cpus().length,
+            diskSpace: {
+                total: 0, // 服務不提供此資訊
+                free: availableDiskGB * 1024 * 1024 * 1024,
+            },
+            wslMemory: {
+                limitGB: wslConfig.memoryGB,
+                isConfigured: wslConfig.configured,
+                source: wslConfig.configured ? 'wslconfig' : 'default',
+            },
+        };
+    }
+    async checkNetworkConnectivity() {
+        const config = this.appConfig.getConfig();
+        // 從設定讀取 ACR 名稱；若未設定，則不檢查 registry 連線
+        const acrName = config.acr?.name;
+        const summary = await this.networkChecker.performNetworkChecks(acrName);
+        return {
+            isOnline: summary.allPassed,
+            // 當 acrName 為 undefined 時，不會有 ACR 檢查結果，canReachRegistry 會是 false
+            canReachRegistry: summary.results.some(r => r.reachable && r.url.includes('azurecr.io')),
+        };
+    }
+    async getMemoryAvailability() {
+        const info = await this.wslConfigParser.getMemoryAvailability();
+        const sourceText = info.wslLimitSource === 'wslconfig'
+            ? 'from .wslconfig'
+            : 'WSL2 default';
+        return {
+            availableGB: info.availableForUofxGB,
+            details: [
+                { label: 'System available memory', valueGB: info.systemAvailableGB },
+                { label: 'WSL memory limit', valueGB: info.wslLimitGB, suffix: sourceText },
+                { label: 'WSL current usage', valueGB: info.wslCurrentUsageGB },
+                { label: 'Available for UOFX', valueGB: info.availableForUofxGB },
+            ],
+        };
+    }
+};
+exports.WindowsEnvironmentAdapter = WindowsEnvironmentAdapter;
+exports.WindowsEnvironmentAdapter = WindowsEnvironmentAdapter = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.WindowsInfoService)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.WslInfoService)),
+    __param(2, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.IHardwareInfo)),
+    __param(3, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.NetworkCheckerService)),
+    __param(4, (0, tsyringe_1.inject)(tokens_1.TOKENS.IAppConfigPort)),
+    __param(5, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.IWslConfigParser)),
+    __metadata("design:paramtypes", [Object, Object, Object, Object, Object, Object])
+], WindowsEnvironmentAdapter);
+//# sourceMappingURL=windows-environment.adapter.js.map

package/dist/infrastructure/errors/app-error.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * 統一應用程式錯誤類別
+ *
+ * 使用範例:
+ * ```typescript
+ * throw new AppError('WSL is not installed', {
+ *   exitCode: EXIT_CODES.SYSTEM_ERROR,
+ *   solution: 'Install WSL 2 by running: wsl --install',
+ *   cause: originalError,
+ *   context: { version: '2.0' }
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppError = void 0;
+/**
+ * 應用程式錯誤類別
+ *
+ * 這是整個應用程式唯一的錯誤類別，簡化錯誤處理邏輯。
+ */
+class AppError extends Error {
+    /**
+     * 建立 AppError 實例
+     *
+     * @param message - 錯誤訊息（必填）
+     * @param options - 選項設定
+     */
+    constructor(message, options) {
+        super(message);
+        this.name = 'AppError';
+        this.exitCode = options?.exitCode ?? 1;
+        this.solution = options?.solution;
+        this.cause = options?.cause;
+        this.context = options?.context;
+        this.timestamp = new Date();
+        // 保持 stack trace 的正確性
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * 取得完整的錯誤資訊（包含 cause chain）
+     */
+    getFullMessage() {
+        const messages = [this.message];
+        if (this.cause) {
+            messages.push(`Caused by: ${this.cause.message}`);
+        }
+        return messages.join('\n');
+    }
+    /**
+     * 將錯誤轉換為 JSON 格式（用於日誌記錄）
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            exitCode: this.exitCode,
+            solution: this.solution,
+            timestamp: this.timestamp.toISOString(),
+            context: this.context,
+            stack: this.stack,
+            cause: this.cause ? {
+                name: this.cause.name,
+                message: this.cause.message,
+                stack: this.cause.stack,
+            } : undefined,
+        };
+    }
+}
+exports.AppError = AppError;
+//# sourceMappingURL=app-error.js.map

package/dist/infrastructure/errors/error-handler.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=error-handler.interface.js.map