@uofx/cli 1.0.0

package/dist/infrastructure/platforms/windows/services/wsl-info.service.js

@@ -0,0 +1,226 @@
+"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.WslInfoService = void 0;
+const errors_1 = require("../../../errors");
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../../../di/tokens");
+const command_builder_1 = require("../../../execution/command-builder");
+const wsl_version_parser_1 = require("../parsers/wsl-version.parser");
+/**
+ * 最低建議 WSL 版本
+ */
+const MIN_RECOMMENDED_WSL_VERSION = '2.0.0.0';
+let WslInfoService = class WslInfoService {
+    constructor(commandExecutor) {
+        this.commandExecutor = commandExecutor;
+    }
+    /**
+     * 檢查 WSL 是否已安裝
+     * 使用 where.exe 檢查 wsl.exe 是否存在，避免觸發 WSL 的安裝/更新提示視窗
+     */
+    async isWslInstalled() {
+        try {
+            // 使用 where.exe 檢查 wsl.exe 是否存在，這不會觸發 WSL 的彈窗
+            const builder = command_builder_1.CommandBuilder.create('where.exe')
+                .arg('wsl.exe');
+            const result = await builder.exec(this.commandExecutor);
+            return result.exitCode === 0 && result.stdout.trim().length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 檢查 WSL 是否需要安裝/更新
+     * 透過檢查 LxssManager 服務來判斷 WSL 是否已完全安裝
+     * 這樣可以避免觸發 WSL 的安裝/更新彈窗
+     */
+    async isWslFullyInstalled() {
+        // 優先檢查 Store 版本，如果已安裝 Store 版本則視為已安裝
+        if (await this.isStoreVersionInstalled()) {
+            return true;
+        }
+        try {
+            // 檢查 LxssManager 服務是否存在並正在執行
+            // 這個服務只有在 WSL 完全安裝後才會存在
+            const builder = command_builder_1.CommandBuilder.create('powershell')
+                .arg('-NoProfile')
+                .arg('-Command')
+                .arg('Get-Service LxssManager -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Status');
+            const result = await builder.exec(this.commandExecutor);
+            const status = result.stdout.trim();
+            // 服務狀態應該是 Running 或 Stopped
+            return status === 'Running' || status === 'Stopped';
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 檢查是否安裝了 WSL Store 版本 (Microsoft.WSL)
+     * 只有 Store 版本支援 --version 命令
+     */
+    async isStoreVersionInstalled() {
+        try {
+            const builder = command_builder_1.CommandBuilder.create('powershell')
+                .arg('-NoProfile')
+                .arg('-Command')
+                .arg('Get-AppxPackage -Name MicrosoftCorporationII.WindowsSubsystemForLinux');
+            const result = await builder.exec(this.commandExecutor);
+            return result.stdout.trim().length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 取得 WSL 版本資訊
+     */
+    async getWslVersionInfo() {
+        // 檢查 WSL 是否已安裝
+        if (!await this.isWslInstalled()) {
+            return {
+                installed: false
+            };
+        }
+        // 檢查 WSL 是否完全安裝（避免觸發安裝彈窗）
+        if (!await this.isWslFullyInstalled()) {
+            return {
+                installed: false,
+                needsInstall: true
+            };
+        }
+        try {
+            let wslVersion;
+            let kernelVersion;
+            // 只有 Store 版本才支援 --version 命令
+            // 如果是 Inbox 版本，執行 --version 可能會失敗或觸發安裝提示
+            if (await this.isStoreVersionInstalled()) {
+                try {
+                    // 使用 --version 檢查版本
+                    const versionBuilder = command_builder_1.CommandBuilder.create('wsl')
+                        .arg('--version');
+                    const versionResult = await versionBuilder.exec(this.commandExecutor);
+                    const versionOutput = versionResult.stdout;
+                    // 使用 Parser 解析版本資訊（支援多語系）
+                    wslVersion = wsl_version_parser_1.WslVersionParser.parseWslVersion(versionOutput) ?? undefined;
+                    kernelVersion = wsl_version_parser_1.WslVersionParser.parseKernelVersion(versionOutput) ?? undefined;
+                }
+                catch {
+                    // 忽略錯誤，保持 undefined
+                }
+            }
+            // 執行 wsl --status 取得預設版本
+            let defaultVersion;
+            try {
+                const statusBuilder = command_builder_1.CommandBuilder.create('wsl')
+                    .arg('--status');
+                const statusResult = await statusBuilder.exec(this.commandExecutor);
+                const statusOutput = statusResult.stdout;
+                // 使用 Parser 解析預設版本（支援多語系）
+                defaultVersion = wsl_version_parser_1.WslVersionParser.parseDefaultVersion(statusOutput) ?? undefined;
+            }
+            catch {
+                // wsl --status 可能在某些舊版本中不可用,不影響主要流程
+                defaultVersion = undefined;
+            }
+            return {
+                installed: true,
+                wslVersion,
+                kernelVersion,
+                defaultVersion
+            };
+        }
+        catch (err) {
+            throw new errors_1.AppError('Failed to get WSL version information', {
+                exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                solution: 'Ensure WSL is properly installed and accessible. Try running: wsl --version',
+                cause: err instanceof Error ? err : undefined,
+                context: { operation: 'getWslVersionInfo', resource: 'WSL' }
+            });
+        }
+    }
+    /**
+     * 比較兩個版本號碼
+     */
+    compareVersions(version1, version2) {
+        const parts1 = version1.split('.').map(Number);
+        const parts2 = version2.split('.').map(Number);
+        const maxLength = Math.max(parts1.length, parts2.length);
+        for (let i = 0; i < maxLength; i++) {
+            const part1 = parts1[i] || 0;
+            const part2 = parts2[i] || 0;
+            if (part1 < part2)
+                return -1;
+            if (part1 > part2)
+                return 1;
+        }
+        return 0;
+    }
+    /**
+     * 檢查 WSL 更新需求
+     */
+    checkWslUpdateRequirement(versionInfo) {
+        const steps = [];
+        let needsUpdate = false;
+        let needsDefaultVersion = false;
+        // 檢查是否已安裝
+        if (!versionInfo.installed) {
+            throw new errors_1.AppError('WSL is not installed', {
+                exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                solution: 'Install WSL by running: wsl --install (requires administrator privileges)',
+                context: { operation: 'checkWslUpdateRequirement', resource: 'WSL' }
+            });
+        }
+        // 檢查是否需要更新 WSL 版本
+        if (versionInfo.wslVersion) {
+            if (this.compareVersions(versionInfo.wslVersion, MIN_RECOMMENDED_WSL_VERSION) < 0) {
+                needsUpdate = true;
+                steps.push('Update WSL to the latest version');
+            }
+        }
+        else {
+            // 如果無法取得版本資訊,建議更新
+            needsUpdate = true;
+            steps.push('Update WSL to the latest version');
+        }
+        // 檢查預設版本是否為 WSL 2
+        if (versionInfo.defaultVersion !== undefined) {
+            if (versionInfo.defaultVersion !== 2) {
+                needsDefaultVersion = true;
+                steps.push('Set WSL 2 as default version');
+            }
+        }
+        else {
+            // 如果無法取得預設版本,建議設定
+            needsDefaultVersion = true;
+            steps.push('Set WSL 2 as default version');
+        }
+        return {
+            needsUpdate,
+            needsDefaultVersion,
+            currentVersion: versionInfo.wslVersion,
+            currentDefaultVersion: versionInfo.defaultVersion,
+            steps
+        };
+    }
+};
+exports.WslInfoService = WslInfoService;
+exports.WslInfoService = WslInfoService = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.ICommandExecutor)),
+    __metadata("design:paramtypes", [Object])
+], WslInfoService);
+//# sourceMappingURL=wsl-info.service.js.map

package/dist/infrastructure/platforms/windows/services/wsl-instance-inspection.service.js

@@ -0,0 +1,325 @@
+"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.WslInstanceInspectionService = void 0;
+const tsyringe_1 = require("tsyringe");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const tokens_1 = require("../../../../di/tokens");
+const command_builder_1 = require("../../../execution/command-builder");
+const paths_1 = require("../../../../constants/paths");
+const input_validator_util_1 = require("../../../utils/input-validator.util");
+/**
+ * WSL 實例檢視服務
+ *
+ * 合併了原 WslInstanceScannerService 和 WslInstanceQueryService 的功能
+ * 負責掃描、查詢 WSL 實例的狀態和存在性
+ */
+let WslInstanceInspectionService = class WslInstanceInspectionService {
+    constructor(commandExecutor, envFactory, appLogger) {
+        this.commandExecutor = commandExecutor;
+        this.envFactory = envFactory;
+        this.appLogger = appLogger;
+    }
+    get hostEnv() {
+        return this.envFactory.getHostEnvironment();
+    }
+    // ===========================================================================
+    // Scan Methods (原 WslInstanceScannerService)
+    // ===========================================================================
+    /**
+     * 掃描所有 WSL 實例
+     * @returns 所有實例的列表
+     */
+    async scanAllInstances() {
+        this.appLogger?.debug('[WSL] Scanning all instances', {
+            component: 'WslInstanceInspectionService'
+        });
+        try {
+            const builder = command_builder_1.CommandBuilder.create('wsl')
+                .arg('--list')
+                .arg('--verbose');
+            const result = await builder.exec(this.commandExecutor);
+            const output = result.stdout;
+            const lines = output.split('\n');
+            const instances = [];
+            // 跳過標題行 (NAME STATE VERSION)
+            for (let i = 1; i < lines.length; i++) {
+                const line = lines[i].trim();
+                if (!line)
+                    continue;
+                // 解析實例資訊
+                // 格式: [*] NAME STATE VERSION
+                // 某些版本的 WSL 輸出 "Running" 或 "Stopped" (英文)
+                const match = line.match(/^(\*?)\s*(\S+)\s+(Running|Stopped)\s+(\d+)/);
+                if (match) {
+                    const [, defaultMarker, name, state, version] = match;
+                    instances.push({
+                        name,
+                        state: state,
+                        version: parseInt(version, 10),
+                        isDefault: !!defaultMarker
+                    });
+                }
+            }
+            return instances;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * 掃描 uofx 相關的實例
+     * @returns uofx 實例掃描結果
+     */
+    async scanUofxInstances() {
+        const allInstances = await this.scanAllInstances();
+        const instances = allInstances.filter(instance => instance.name.startsWith('uofx-'));
+        const runningInstances = instances.filter(instance => instance.state === 'Running');
+        return {
+            instances,
+            runningInstances,
+            totalCount: instances.length,
+            runningCount: runningInstances.length
+        };
+    }
+    /**
+     * 掃描其他 WSL 實例（排除 uofx- 開頭的實例）
+     * @returns 其他實例名稱列表
+     */
+    async scanOtherInstances() {
+        const allInstances = await this.scanAllInstances();
+        return allInstances
+            .filter(instance => !instance.name.startsWith('uofx-'))
+            .map(instance => instance.name);
+    }
+    /**
+     * 取得共享資源上下文
+     * 包含容器執行環境和其他 WSL 實例資訊
+     * @returns 共享資源上下文
+     */
+    async getSharedResourceContext() {
+        const containerRuntime = this.detectContainerRuntime();
+        const otherInstances = await this.scanOtherInstances();
+        const hasSharedResources = containerRuntime !== null || otherInstances.length > 0;
+        return {
+            containerRuntime,
+            otherInstances,
+            hasSharedResources
+        };
+    }
+    /**
+     * 格式化掃描結果為可讀字串
+     * @param scanResult - 掃描結果
+     * @returns 格式化後的字串
+     */
+    formatScanResult(scanResult) {
+        const { instances, runningInstances, totalCount, runningCount } = scanResult;
+        if (totalCount === 0) {
+            return '  No existing uofx instances found';
+        }
+        const lines = [];
+        lines.push(`Found ${totalCount} uofx instance${totalCount > 1 ? 's' : ''}:`);
+        instances.forEach(instance => {
+            const status = instance.state === 'Running' ? '✓' : '✗';
+            lines.push(`  ${status} ${instance.name} (${instance.state})`);
+        });
+        if (runningCount > 0) {
+            lines.push('');
+            lines.push(`Warning: ${runningCount} instance${runningCount > 1 ? 's are' : ' is'} currently running`);
+            runningInstances.forEach(instance => {
+                lines.push(`  • ${instance.name}`);
+            });
+            lines.push('Only one instance can run at a time.');
+            if (runningCount === 1) {
+                lines.push(`Use 'uofx env stop --name ${runningInstances[0].name.replace('uofx-', '')}' to stop it.`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 偵測容器執行環境
+     * @returns 偵測到的執行環境 ('docker-desktop' | 'podman-desktop' | null)
+     */
+    detectContainerRuntime() {
+        const programFiles = process.env.PROGRAMFILES || 'C:\\Program Files';
+        const dockerPaths = [
+            path.join('C:\\Program Files', paths_1.WINDOWS_PATHS.DOCKER_DESKTOP),
+            path.join(programFiles, paths_1.WINDOWS_PATHS.DOCKER_DESKTOP)
+        ];
+        for (const dockerPath of dockerPaths) {
+            if (fs.existsSync(dockerPath)) {
+                return 'docker-desktop';
+            }
+        }
+        const podmanPaths = [
+            path.join('C:\\Program Files', paths_1.WINDOWS_PATHS.PODMAN_DESKTOP),
+            path.join(programFiles, paths_1.WINDOWS_PATHS.PODMAN_DESKTOP)
+        ];
+        for (const podmanPath of podmanPaths) {
+            if (fs.existsSync(podmanPath)) {
+                return 'podman-desktop';
+            }
+        }
+        return null;
+    }
+    // ===========================================================================
+    // Query Methods (原 WslInstanceQueryService)
+    // ===========================================================================
+    /**
+     * 檢查 WSL 實例是否存在
+     * @param instanceName 實例名稱
+     * @returns 是否存在
+     */
+    async checkInstanceExists(instanceName) {
+        try {
+            const instances = await this.scanAllInstances();
+            return instances.some(inst => inst.name === instanceName);
+        }
+        catch (error) {
+            this.appLogger?.debug('[WSL] Instance existence check failed (assuming false)', {
+                instanceName,
+                error,
+                component: 'WslInstanceInspectionService'
+            });
+            return false;
+        }
+    }
+    /**
+     * 取得實例狀態
+     * @param instanceName 實例名稱
+     * @returns 實例狀態
+     */
+    async getInstanceStatus(instanceName) {
+        try {
+            const instances = await this.scanAllInstances();
+            const instance = instances.find(inst => inst.name === instanceName);
+            if (!instance) {
+                return { name: instanceName, running: false };
+            }
+            const isRunning = instance.state === 'Running';
+            let uptime;
+            if (isRunning) {
+                try {
+                    const env = this.envFactory.getForInstance(instanceName);
+                    const uptimeBuilder = env.shell('cat')
+                        .arg('/proc/uptime');
+                    const uptimeResult = await uptimeBuilder.exec();
+                    if (uptimeResult.exitCode === 0) {
+                        uptime = parseFloat(uptimeResult.stdout.split(' ')[0]);
+                    }
+                }
+                catch {
+                    // Ignore
+                }
+            }
+            const status = { name: instanceName, running: isRunning, uptime };
+            return status;
+        }
+        catch (error) {
+            this.appLogger?.error(error instanceof Error ? error : new Error(String(error)), {
+                operation: 'getInstanceStatus',
+                instanceName,
+            });
+            return { name: instanceName, running: false };
+        }
+    }
+    /**
+     * 列出所有正在運行的 uofx 實例
+     * @returns 實例名稱陣列
+     */
+    async listRunningInstances() {
+        try {
+            const builder = this.hostEnv.wslCmd('--list')
+                .arg('--verbose');
+            const result = await builder.exec();
+            const lines = result.stdout.split('\n').slice(1);
+            return lines
+                .filter((line) => line.trim())
+                .filter((line) => line.includes('Running') || line.includes('執行'))
+                .map((line) => {
+                const match = line.replace('*', '').trim().match(/^([^\s]+)/);
+                return match ? match[1] : '';
+            })
+                .filter((name) => name.startsWith('uofx-') && name !== '');
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * 驗證實例建立成功 (執行 echo 測試)
+     * @param instanceName 實例名稱
+     * @returns 是否驗證成功
+     */
+    async verifyInstance(instanceName) {
+        (0, input_validator_util_1.requireValidInstanceName)(instanceName);
+        const exists = await this.checkInstanceExists(instanceName);
+        if (!exists) {
+            return false;
+        }
+        try {
+            const env = this.envFactory.getForInstance(instanceName);
+            const builder = env.shell('echo')
+                .arg('test');
+            const result = await builder.exec();
+            return result.exitCode === 0 && result.stdout.includes('test');
+        }
+        catch {
+            return false;
+        }
+    }
+};
+exports.WslInstanceInspectionService = WslInstanceInspectionService;
+exports.WslInstanceInspectionService = WslInstanceInspectionService = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.ICommandExecutor)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.IExecutionEnvironmentFactory)),
+    __param(2, (0, tsyringe_1.inject)(tokens_1.TOKENS.ILoggerPort)),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], WslInstanceInspectionService);
+//# sourceMappingURL=wsl-instance-inspection.service.js.map