@kvell007/embed-labs-cli 0.1.0-alpha.55 → 0.1.0-alpha.57

package/dist/index.js

@@ -8,7 +8,7 @@ import { arch, hostname, homedir, platform, tmpdir } from "node:os";
 import { basename, delimiter, dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { composeBootLogoPackage } from "./image-compose.js";
-import { buildTaishanPiQtSmoke, compileTaishanPiSingleFile, currentLocalToolchain, installLocalToolchain, latestLocalToolchain, listLocalToolchainEnvironments, uninstallLocalToolchain, validateLocalToolchain } from "./local-toolchain.js";
+import { buildTaishanPiQtSmoke, compileTaishanPiSingleFile, currentLocalToolchain, installLocalToolchain, latestLocalToolchain, listLocalToolchainEnvironments, uninstallLocalToolchain, validateLocalToolchain, windowsWslInstall, windowsWslStatus } from "./local-toolchain.js";
 import { fail, ok } from "@embed-labs/protocol";
 const require = createRequire(import.meta.url);
 const CLI_MODULE_DIR = dirname(fileURLToPath(import.meta.url));
@@ -104,6 +104,8 @@ const LOCAL_TOOLCHAIN_CURRENT_USAGE = "Usage: embed local toolchain current [--i
 const LOCAL_TOOLCHAIN_INSTALL_USAGE = "Usage: embed local toolchain install [--board taishanpi-1m-rk3566|pico2w-rp2350-monitor|coloreasypico2-rp2350-monitor] [--channel stable] [--metadata-root <path>] [--source-url <tar.gz-url>|--source-release-root <path>] [--install-root <path>] [--mode minimal|runtime|compile|qt|firmware|full|images] [--force] [--json]\nDefault source: the production download channel at download.embedboard.com.";
 const LOCAL_TOOLCHAIN_UNINSTALL_USAGE = "Usage: embed local toolchain uninstall --board taishanpi-1m-rk3566|pico2w-rp2350-monitor|coloreasypico2-rp2350-monitor [--install-root <path>] [--json]";
 const LOCAL_TOOLCHAIN_VALIDATE_USAGE = "Usage: embed local toolchain validate [--board taishanpi-1m-rk3566|pico2w-rp2350-monitor|coloreasypico2-rp2350-monitor] [--release-root <path>] [--mode minimal|runtime|compile|qt|firmware|full|images] [--json]";
+const LOCAL_WSL_STATUS_USAGE = "Usage: embed local wsl status [--json]";
+const LOCAL_WSL_INSTALL_USAGE = "Usage: embed local wsl install [--distribution Ubuntu] [--no-launch true|false] [--web-download true|false] [--timeout-ms 600000] [--json]";
 const LOCAL_COMPILE_TAISHANPI_USAGE = "Usage: embed local compile taishanpi --source <main.c|main.cpp> --output <artifact> [--release-root <path>] [--account <account_id>] [--json]";
 const LOCAL_BUILD_QT_SMOKE_USAGE = "Usage: embed local build qt-smoke --build-dir <dir> [--source <qt-cmake-dir>] [--target-name <executable>] [--release-root <path>] [--account <account_id>] [--json]";
 const AUTH_DEVICE_STATUS_USAGE = "Usage: embed auth device status [--json]";
@@ -635,6 +637,21 @@ async function main(argv) {
                 }
                 return output(parsed, ok(await validateLocalToolchain(request)), renderLocalToolchainValidation);
             }
+            if (action === "wsl" && parsed.command[2] === "status") {
+                const unknownFlag = firstUnknownFlag(parsed, ["json"]);
+                const extra = parsed.command.slice(3);
+                if (unknownFlag || extra.length > 0) {
+                    return output(parsed, fail("invalid_args", unknownFlag ? `Unknown flag --${unknownFlag}. ${LOCAL_WSL_STATUS_USAGE}` : LOCAL_WSL_STATUS_USAGE), undefined, 2);
+                }
+                return output(parsed, ok(await windowsWslStatus()), renderWindowsWslStatus);
+            }
+            if (action === "wsl" && parsed.command[2] === "install") {
+                const request = localWslInstallRequest(parsed);
+                if (typeof request === "string") {
+                    return output(parsed, fail("invalid_args", request), undefined, 2);
+                }
+                return output(parsed, ok(await windowsWslInstall(request)), renderWindowsWslInstall);
+            }
             if (action === "compile" && parsed.command[2] === "taishanpi") {
                 const request = localCompileTaishanPiRequest(parsed, await authStatus());
                 if (typeof request === "string") {
@@ -657,6 +674,8 @@ async function main(argv) {
                 LOCAL_TOOLCHAIN_INSTALL_USAGE,
                 LOCAL_TOOLCHAIN_UNINSTALL_USAGE,
                 LOCAL_TOOLCHAIN_VALIDATE_USAGE,
+                LOCAL_WSL_STATUS_USAGE,
+                LOCAL_WSL_INSTALL_USAGE,
                 LOCAL_COMPILE_TAISHANPI_USAGE,
                 LOCAL_BUILD_QT_SMOKE_USAGE
             ].join("\n")), undefined, 2);
@@ -1088,11 +1107,18 @@ async function main(argv) {
         return output(parsed, fail("unknown_command", `Unknown command: ${parsed.command.join(" ")}`), undefined, 2);
     }
     catch (error) {
-        return output(parsed, fail("command_failed", error instanceof Error ? error.message : String(error), {
-            remediation: `Check that embed-local-bridge is running at ${DEFAULT_BRIDGE_URL}. Start it with: embed bridge start`
+        const message = error instanceof Error ? error.message : String(error);
+        return output(parsed, fail("command_failed", message, {
+            remediation: commandFailureRemediation(message)
         }), undefined, 1);
     }
 }
+function commandFailureRemediation(message) {
+    if (message.includes("TaishanPi") && message.includes("WSL2")) {
+        return "Run: embedlabs local wsl status";
+    }
+    return `Check that embed-local-bridge is running at ${DEFAULT_BRIDGE_URL}. Start it with: embed bridge start`;
+}
 function parseArgs(argv) {
     const command = [];
     const flags = {};
@@ -5710,6 +5736,32 @@ function localToolchainLatestRequest(parsed) {
         return metadataRoot.error;
     return { boardId: board.value, channel: channel.value, metadataRoot: metadataRoot.value };
 }
+function localWslInstallRequest(parsed) {
+    const unknownFlag = firstUnknownFlag(parsed, ["json", "distribution", "distro", "no-launch", "web-download", "timeout-ms"]);
+    if (unknownFlag) {
+        return `Unknown flag --${unknownFlag}. ${LOCAL_WSL_INSTALL_USAGE}`;
+    }
+    const extra = parsed.command.slice(3);
+    if (extra.length > 0) {
+        return `Unexpected argument: ${extra[0]}. ${LOCAL_WSL_INSTALL_USAGE}`;
+    }
+    const distribution = stringFlag(parsed, "distribution") ?? stringFlag(parsed, "distro");
+    const noLaunch = optionalBooleanFlag(parsed, "no-launch");
+    if (typeof noLaunch === "string")
+        return noLaunch;
+    const webDownload = optionalBooleanFlag(parsed, "web-download");
+    if (typeof webDownload === "string")
+        return webDownload;
+    const timeoutMs = optionalIntegerFlag(parsed, "timeout-ms", 1_000, 3_600_000);
+    if (timeoutMs.error)
+        return timeoutMs.error;
+    return {
+        distribution,
+        noLaunch,
+        webDownload,
+        timeoutMs: timeoutMs.value
+    };
+}
 function localToolchainCurrentRequest(parsed) {
     const unknownFlag = firstUnknownFlag(parsed, ["json", "install-root"]);
     if (unknownFlag) {
@@ -7103,6 +7155,61 @@ function localToolchainStatusLabel(status) {
         return "unsupported_host/当前系统暂不支持";
     return status;
 }
+function renderWindowsWslStatus(result) {
+    const lines = [
+        "Windows WSL2 status",
+        `host=${result.host}`,
+        `applicable=${result.applicable}`,
+        `wsl_available=${result.wsl_available}`,
+        `usable=${result.usable}`,
+        `checked_at=${result.checked_at}`,
+        `status_command=${result.commands.status}`,
+        `list_command=${result.commands.list}`,
+        `list_online_command=${result.commands.list_online}`,
+        `install_command=${result.commands.install_ubuntu}`
+    ];
+    if (result.distributions.length > 0) {
+        lines.push("distributions:");
+        for (const distro of result.distributions) {
+            lines.push(`  ${distro.default ? "*" : "-"} ${distro.name} state=${distro.state ?? "unknown"} version=${distro.version ?? "unknown"}`);
+        }
+    }
+    if (result.online_distributions.length > 0) {
+        lines.push("online_distributions:");
+        for (const distro of result.online_distributions) {
+            lines.push(`  ${distro.default ? "*" : "-"} ${distro.name}${distro.friendly_name ? ` (${distro.friendly_name})` : ""}`);
+        }
+    }
+    for (const note of result.notes) {
+        lines.push(`note=${note}`);
+    }
+    return lines.join("\n");
+}
+function renderWindowsWslInstall(result) {
+    const lines = [
+        "Windows WSL2 install",
+        `host=${result.host}`,
+        `command=${result.command.join(" ")}`,
+        `exit_code=${result.exit_code}`,
+        `usable_after=${result.status_after.usable}`
+    ];
+    if (result.stdout_tail.length > 0) {
+        lines.push("stdout_tail:");
+        for (const line of result.stdout_tail) {
+            lines.push(`  ${line}`);
+        }
+    }
+    if (result.stderr_tail.length > 0) {
+        lines.push("stderr_tail:");
+        for (const line of result.stderr_tail) {
+            lines.push(`  ${line}`);
+        }
+    }
+    for (const note of result.notes) {
+        lines.push(`note=${note}`);
+    }
+    return lines.join("\n");
+}
 function localToolchainComponentSummary(components) {
     const totalBytes = components.reduce((total, component) => total + component.size_bytes, 0);
     return `${components.length} components, ${formatByteSize(totalBytes)}`;
@@ -7927,6 +8034,24 @@ function optionalPositiveIntegerFlag(parsed, name) {
     }
     return { value };
 }
+function optionalIntegerFlag(parsed, name, min, max) {
+    const values = flagValues(parsed, name);
+    if (values.length === 0) {
+        return {};
+    }
+    if (values.some((value) => typeof value !== "string")) {
+        return { error: `--${name} requires a value.` };
+    }
+    const raw = values[values.length - 1].trim();
+    if (!/^-?\d+$/.test(raw)) {
+        return { error: `--${name} must be an integer.` };
+    }
+    const value = Number(raw);
+    if (!Number.isSafeInteger(value) || value < min || value > max) {
+        return { error: `--${name} must be an integer from ${min} through ${max}.` };
+    }
+    return { value };
+}
 function jsonObjectListFlag(parsed, name) {
     const objects = [];
     for (const raw of flagValues(parsed, name)) {