@kvell007/embed-labs-cli 0.1.0-alpha.3 → 0.1.0-alpha.4

package/dist/index.js

@@ -9,7 +9,7 @@ import { basename, delimiter, dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { startServer } from "@embed-labs/local-bridge";
 import { composeBootLogoPackage } from "./image-compose.js";
-import { buildTaishanPiQtSmoke, compileTaishanPiSingleFile, validateLocalToolchain } from "./local-toolchain.js";
+import { buildTaishanPiQtSmoke, compileTaishanPiSingleFile, currentLocalToolchain, installLocalToolchain, latestLocalToolchain, validateLocalToolchain } 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));
@@ -81,6 +81,9 @@ const BUILD_IMAGE_BOOT_LOGO_USAGE = "Usage: embed build image boot-logo --logo <
 const IMAGE_BOOT_LOGO_COMPOSE_USAGE = "Usage: embed image boot-logo compose --package <boot-logo-package.json> --base-image <boot.img|image.img> --output <image> [--manifest <manifest.json>] [--force] [--json]";
 const BUILD_IMAGE_DTB_USAGE = "Usage: embed build image dtb --dtb <local.dtb|local.dts> [--input-format auto|dtb|dts] [--account <account_id>] [--project <project_id>] [--board taishanpi] [--variant 1M-RK3566] [--output <package.json>] [--json]";
 const IMAGE_DTB_COMPOSE_USAGE = "Usage: embed image dtb compose --package <dtb-package.json> --base-image <boot.img|image.img> --output <image> [--manifest <manifest.json>] [--force] [--json]";
+const LOCAL_TOOLCHAIN_LATEST_USAGE = "Usage: embed local toolchain latest [--board taishanpi-1m-rk3566] [--channel stable] [--metadata-root <path>] [--json]";
+const LOCAL_TOOLCHAIN_CURRENT_USAGE = "Usage: embed local toolchain current [--install-root <path>] [--json]";
+const LOCAL_TOOLCHAIN_INSTALL_USAGE = "Usage: embed local toolchain install [--board taishanpi-1m-rk3566] [--channel stable] [--metadata-root <path>] [--source-url <tar.gz-url>|--source-release-root <path>] [--install-root <path>] [--force] [--json]";
 const LOCAL_TOOLCHAIN_VALIDATE_USAGE = "Usage: embed local toolchain validate [--release-root <path>] [--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-smoke-dir>] [--release-root <path>] [--account <account_id>] [--json]";
@@ -503,6 +506,27 @@ async function main(argv) {
             return output(parsed, fail("invalid_args", [IMAGE_BOOT_LOGO_COMPOSE_USAGE, IMAGE_DTB_COMPOSE_USAGE].join("\n")), undefined, 2);
         }
         if (area === "local") {
+            if (action === "toolchain" && parsed.command[2] === "latest") {
+                const request = localToolchainLatestRequest(parsed);
+                if (typeof request === "string") {
+                    return output(parsed, fail("invalid_args", request), undefined, 2);
+                }
+                return output(parsed, ok(await latestLocalToolchain(request)), renderLocalToolchainLatest);
+            }
+            if (action === "toolchain" && parsed.command[2] === "current") {
+                const request = localToolchainCurrentRequest(parsed);
+                if (typeof request === "string") {
+                    return output(parsed, fail("invalid_args", request), undefined, 2);
+                }
+                return output(parsed, ok(await currentLocalToolchain(request.installRoot)), renderLocalToolchainCurrent);
+            }
+            if (action === "toolchain" && parsed.command[2] === "install") {
+                const request = localToolchainInstallRequest(parsed);
+                if (typeof request === "string") {
+                    return output(parsed, fail("invalid_args", request), undefined, 2);
+                }
+                return output(parsed, ok(await installLocalToolchain(request)), renderLocalToolchainInstall);
+            }
             if (action === "toolchain" && parsed.command[2] === "validate") {
                 const request = localToolchainValidateRequest(parsed);
                 if (typeof request === "string") {
@@ -525,6 +549,9 @@ async function main(argv) {
                 return output(parsed, ok(await buildTaishanPiQtSmoke(request)), renderLocalCompileResult);
             }
             return output(parsed, fail("invalid_args", [
+                LOCAL_TOOLCHAIN_LATEST_USAGE,
+                LOCAL_TOOLCHAIN_CURRENT_USAGE,
+                LOCAL_TOOLCHAIN_INSTALL_USAGE,
                 LOCAL_TOOLCHAIN_VALIDATE_USAGE,
                 LOCAL_COMPILE_TAISHANPI_USAGE,
                 LOCAL_BUILD_QT_SMOKE_USAGE
@@ -4024,6 +4051,80 @@ function billingSnapshotListRequest(parsed) {
     }
     return { path: `/v1/accounts/${encodeURIComponent(accountResult.value)}/billing/snapshots` };
 }
+function localToolchainLatestRequest(parsed) {
+    const unknownFlag = firstUnknownFlag(parsed, ["json", "board", "board-id", "channel", "metadata-root"]);
+    if (unknownFlag) {
+        return `Unknown flag --${unknownFlag}. ${LOCAL_TOOLCHAIN_LATEST_USAGE}`;
+    }
+    const extra = parsed.command.slice(3);
+    if (extra.length > 0) {
+        return `Unexpected argument: ${extra[0]}. ${LOCAL_TOOLCHAIN_LATEST_USAGE}`;
+    }
+    const board = optionalTrimmedStringAliasFlag(parsed, ["board", "board-id"], "board or board-id");
+    if (board.error)
+        return board.error;
+    const channel = optionalTrimmedStringFlag(parsed, "channel");
+    if (channel.error)
+        return channel.error;
+    const metadataRoot = optionalTrimmedStringFlag(parsed, "metadata-root");
+    if (metadataRoot.error)
+        return metadataRoot.error;
+    return { boardId: board.value, channel: channel.value, metadataRoot: metadataRoot.value };
+}
+function localToolchainCurrentRequest(parsed) {
+    const unknownFlag = firstUnknownFlag(parsed, ["json", "install-root"]);
+    if (unknownFlag) {
+        return `Unknown flag --${unknownFlag}. ${LOCAL_TOOLCHAIN_CURRENT_USAGE}`;
+    }
+    const extra = parsed.command.slice(3);
+    if (extra.length > 0) {
+        return `Unexpected argument: ${extra[0]}. ${LOCAL_TOOLCHAIN_CURRENT_USAGE}`;
+    }
+    const installRoot = optionalTrimmedStringFlag(parsed, "install-root");
+    if (installRoot.error)
+        return installRoot.error;
+    return { installRoot: installRoot.value };
+}
+function localToolchainInstallRequest(parsed) {
+    const unknownFlag = firstUnknownFlag(parsed, ["json", "board", "board-id", "channel", "metadata-root", "source-url", "source-release-root", "install-root", "force"]);
+    if (unknownFlag) {
+        return `Unknown flag --${unknownFlag}. ${LOCAL_TOOLCHAIN_INSTALL_USAGE}`;
+    }
+    const extra = parsed.command.slice(3);
+    if (extra.length > 0) {
+        return `Unexpected argument: ${extra[0]}. ${LOCAL_TOOLCHAIN_INSTALL_USAGE}`;
+    }
+    const board = optionalTrimmedStringAliasFlag(parsed, ["board", "board-id"], "board or board-id");
+    if (board.error)
+        return board.error;
+    const channel = optionalTrimmedStringFlag(parsed, "channel");
+    if (channel.error)
+        return channel.error;
+    const metadataRoot = optionalTrimmedStringFlag(parsed, "metadata-root");
+    if (metadataRoot.error)
+        return metadataRoot.error;
+    const sourceUrl = optionalTrimmedStringFlag(parsed, "source-url");
+    if (sourceUrl.error)
+        return sourceUrl.error;
+    const sourceReleaseRoot = optionalTrimmedStringFlag(parsed, "source-release-root");
+    if (sourceReleaseRoot.error)
+        return sourceReleaseRoot.error;
+    if (sourceUrl.value && sourceReleaseRoot.value) {
+        return "Use only one of --source-url or --source-release-root.";
+    }
+    const installRoot = optionalTrimmedStringFlag(parsed, "install-root");
+    if (installRoot.error)
+        return installRoot.error;
+    return {
+        boardId: board.value,
+        channel: channel.value,
+        metadataRoot: metadataRoot.value,
+        sourceUrl: sourceUrl.value,
+        sourceReleaseRoot: sourceReleaseRoot.value,
+        installRoot: installRoot.value,
+        force: booleanFlag(parsed, "force")
+    };
+}
 function localToolchainValidateRequest(parsed) {
     const unknownFlag = firstUnknownFlag(parsed, ["json", "release-root"]);
     if (unknownFlag) {
@@ -5159,6 +5260,69 @@ function renderBuildWorkspaceSourcePatch(result) {
     }
     return lines.join("\n");
 }
+function renderLocalToolchainLatest(result) {
+    const lines = [
+        `board=${result.board_id}`,
+        `channel=${result.channel}`,
+        `version=${result.version}`,
+        `host=${result.host}`,
+        result.metadata_root ? `metadata_root=${result.metadata_root}` : "metadata=built-in"
+    ];
+    if (result.packages.length > 0) {
+        lines.push("packages:");
+        for (const pkg of result.packages) {
+            lines.push(`  ${pkg.id}@${pkg.version}`);
+        }
+    }
+    return lines.join("\n");
+}
+function renderLocalToolchainCurrent(result) {
+    if (!result.installed) {
+        return [
+            "No local toolchain installed.",
+            `board=${result.board_id}`,
+            `install_root=${result.install_root}`,
+            `registry=${result.registry_path}`
+        ].join("\n");
+    }
+    return [
+        "Local toolchain installed.",
+        `board=${result.board_id}`,
+        result.version ? `version=${result.version}` : "",
+        result.channel ? `channel=${result.channel}` : "",
+        result.release_root ? `release_root=${result.release_root}` : "",
+        `install_root=${result.install_root}`,
+        `registry=${result.registry_path}`
+    ].filter(Boolean).join("\n");
+}
+function renderLocalToolchainInstall(result) {
+    const lines = [
+        "Local toolchain installed.",
+        `board=${result.board_id}`,
+        `version=${result.version}`,
+        `channel=${result.channel}`,
+        `host=${result.host}`,
+        `install_root=${result.install_root}`,
+        `release_root=${result.release_root}`,
+        `registry=${result.registry_path}`,
+        `source=${result.source.kind}:${result.source.value}`,
+        result.source.downloaded_path ? `downloaded=${result.source.downloaded_path}` : "",
+        `validation=${result.validation.ok ? "ok" : "failed"}`
+    ].filter(Boolean);
+    if (result.installed_paths.length > 0) {
+        lines.push("installed_paths:");
+        for (const installedPath of result.installed_paths) {
+            lines.push(`  ${installedPath}`);
+        }
+    }
+    if (result.packages.length > 0) {
+        lines.push("packages:");
+        for (const pkg of result.packages) {
+            lines.push(`  ${pkg.id}@${pkg.version}`);
+        }
+    }
+    return lines.join("\n");
+}
 function renderLocalToolchainValidation(result) {
     const lines = [
         result.ok ? "Local toolchain ready." : "Local toolchain not ready.",
@@ -5921,6 +6085,8 @@ Main workflow:
   4. Run a natural-language local tool loop:
      embed agent run --prompt "验证开发板状态"
   5. Validate or use the local TaishanPi toolchain:
+     embed local toolchain latest
+     embed local toolchain install --source-url <toolchain.tar.gz>
      embed local toolchain validate
      embed local compile taishanpi --source ./main.c --output ./.embed-labs/build/main
      embed local build qt-smoke --build-dir ./.embed-labs/build/qt-smoke
@@ -5966,6 +6132,9 @@ Local hardware:
   embed tool call chip.temperature --input-json '{"host":"198.19.77.2","user":"root"}'
   embed tool call qml.runtime.status --input-json '{"host":"198.19.77.2","user":"root","port":18130}'
   embed device list
+  embed local toolchain latest
+  embed local toolchain current
+  embed local toolchain install --source-url <toolchain.tar.gz>
   embed local toolchain validate
   embed local compile taishanpi --source ./main.c --output ./.embed-labs/build/main
   embed local build qt-smoke --build-dir ./.embed-labs/build/qt-smoke
@@ -6167,6 +6336,9 @@ Usage:
   embed build image generate --workspace <workspace_id> --prompt <request> [--account <account_id>] [--image-profile <profile_id>] [--provider stub|openai|bai|cc|claude-code] [--model <model>] [--execution-mode cloud_worker|dry_run] [--worker-pool <pool>] [--json]
   embed build image boot-logo --logo <local_image> [--account <account_id>] [--project <project_id>] [--board taishanpi] [--variant 1M-RK3566] [--kernel-logo <local_image>] [--rotate -90] [--scale 100] [--output <package.json>] [--json]
   embed image boot-logo compose --package <boot-logo-package.json> --base-image <boot.img|image.img> --output <image> [--manifest <manifest.json>] [--force] [--json]
+  embed local toolchain latest [--board taishanpi-1m-rk3566] [--channel stable] [--metadata-root <path>] [--json]
+  embed local toolchain current [--install-root <path>] [--json]
+  embed local toolchain install [--board taishanpi-1m-rk3566] [--channel stable] [--metadata-root <path>] [--source-url <tar.gz-url>|--source-release-root <path>] [--install-root <path>] [--force] [--json]
   embed local toolchain validate [--release-root <path>] [--json]
   embed local compile taishanpi --source <main.c|main.cpp> --output <artifact> [--release-root <path>] [--account <account_id>] [--json]
   embed local build qt-smoke --build-dir <dir> [--source <qt-smoke-dir>] [--release-root <path>] [--account <account_id>] [--json]