@kvell007/embed-labs-cli 0.1.0-alpha.28 → 0.1.0-alpha.29

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, validateLocalToolchain } from "./local-toolchain.js";
+import { buildTaishanPiQtSmoke, compileTaishanPiSingleFile, currentLocalToolchain, installLocalToolchain, latestLocalToolchain, listLocalToolchainEnvironments, 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));
@@ -42,6 +42,8 @@ const LEGACY_CODEX_PLUGIN_NAMES = [
 ];
 const LEGACY_CODEX_MARKETPLACE_NAMES = new Set(["embed-labs-plugins", "plugins", "Plugins", "deve"]);
 const PLUGIN_INSTALL_USAGE = "Usage: embed plugin install <codex|opencode|all> [--release-dir <dir>] [--release-url <url>] [--target <dir>] [--codex-target <dir>] [--opencode-target <dir>] [--force] [--json]";
+const PLUGIN_UPDATE_CHECK_USAGE = "Usage: embed plugin update check [--release-url <url>] [--target <dir>] [--codex-target <dir>] [--opencode-target <dir>] [--json]";
+const PLUGIN_UPDATE_USAGE = "Usage: embed plugin update <codex|opencode|all> [--release-url <url>] [--target <dir>] [--codex-target <dir>] [--opencode-target <dir>] [--json]";
 const CLOUD_TASK_ARTIFACTS_USAGE = "Usage: embed cloud task artifacts <task_id> [--json]";
 const CLOUD_TASK_EVIDENCE_USAGE = "Usage: embed cloud task evidence <task_id> [--json]";
 const ARTIFACT_STATUS_USAGE = "Usage: embed artifact status <artifact_id> [--json]";
@@ -95,6 +97,7 @@ 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_LIST_USAGE = "Usage: embed local toolchain list [--board taishanpi-1m-rk3566] [--channel stable] [--metadata-root <path>] [--install-root <path>] [--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>] [--mode minimal|compile|qt|full|images] [--force] [--json]\nDefault source: the production download channel at download.embedboard.com.";
@@ -295,7 +298,18 @@ async function main(argv) {
                 const result = await pluginInstall(parsed);
                 return output(parsed, result, renderPluginInstall, result.ok ? 0 : 2);
             }
-            return output(parsed, fail("invalid_args", [PLUGIN_LIST_USAGE, PLUGIN_INSTALL_USAGE].join("\n")), undefined, 2);
+            if (action === "update") {
+                if (parsed.command[2] === "check") {
+                    const result = await pluginUpdateCheck(parsed);
+                    return output(parsed, result, renderPluginUpdateCheck, result.ok ? 0 : 2);
+                }
+                if (["codex", "opencode", "all"].includes(parsed.command[2] ?? "")) {
+                    const result = await pluginUpdate(parsed);
+                    return output(parsed, result, renderPluginInstall, result.ok ? 0 : 2);
+                }
+                return output(parsed, fail("invalid_args", [PLUGIN_UPDATE_CHECK_USAGE, PLUGIN_UPDATE_USAGE].join("\n")), undefined, 2);
+            }
+            return output(parsed, fail("invalid_args", [PLUGIN_LIST_USAGE, PLUGIN_INSTALL_USAGE, PLUGIN_UPDATE_CHECK_USAGE, PLUGIN_UPDATE_USAGE].join("\n")), undefined, 2);
         }
         if (area === "auth" && action === "login") {
             const result = await authLogin(parsed);
@@ -557,6 +571,13 @@ 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] === "list") {
+                const request = localToolchainListRequest(parsed);
+                if (typeof request === "string") {
+                    return output(parsed, fail("invalid_args", request), undefined, 2);
+                }
+                return output(parsed, ok(await listLocalToolchainEnvironments(request)), renderLocalToolchainList);
+            }
             if (action === "toolchain" && parsed.command[2] === "latest") {
                 const request = localToolchainLatestRequest(parsed);
                 if (typeof request === "string") {
@@ -600,6 +621,7 @@ async function main(argv) {
                 return output(parsed, ok(await buildTaishanPiQtSmoke(request)), renderLocalCompileResult);
             }
             return output(parsed, fail("invalid_args", [
+                LOCAL_TOOLCHAIN_LIST_USAGE,
                 LOCAL_TOOLCHAIN_LATEST_USAGE,
                 LOCAL_TOOLCHAIN_CURRENT_USAGE,
                 LOCAL_TOOLCHAIN_INSTALL_USAGE,
@@ -1834,6 +1856,96 @@ async function pluginInstall(parsed) {
         await rm(tempDir, { recursive: true, force: true });
     }
 }
+async function pluginUpdateCheck(parsed) {
+    const unknownFlag = firstUnknownFlag(parsed, ["release-url", "target", "codex-target", "opencode-target", "json"]);
+    if (unknownFlag) {
+        return fail("invalid_args", `Unknown flag --${unknownFlag}. ${PLUGIN_UPDATE_CHECK_USAGE}`);
+    }
+    const unexpected = parsed.command.slice(3);
+    if (unexpected.length > 0) {
+        return fail("invalid_args", `Unexpected argument: ${unexpected[0]}. ${PLUGIN_UPDATE_CHECK_USAGE}`);
+    }
+    const remoteManifest = await fetchRemotePluginManifest(parsed);
+    if (!remoteManifest.ok) {
+        return remoteManifest;
+    }
+    const manifest = remoteManifest.data;
+    const codexPackage = manifest.packages?.find((item) => item.id === "codex-embed-labs");
+    const opencodePackage = manifest.packages?.find((item) => item.id === "opencode-embed-labs");
+    const codexTarget = join(codexPluginTargetRoot(parsed, true), CODEX_PLUGIN_NAME);
+    const openCodeTarget = openCodePluginTargetRoot(parsed, true);
+    return ok({
+        release_url: pluginReleaseBaseUrl(parsed),
+        latest_version: manifest.version,
+        plugins: [
+            await pluginUpdateItem({
+                id: "codex",
+                displayName: "Embed Labs Codex plugin",
+                targetPath: codexTarget,
+                installedVersion: await installedCodexPluginVersion(codexTarget),
+                latestVersion: codexPackage?.version ?? manifest.version,
+                releaseFile: codexPackage?.file,
+                updateCommand: "embedlabs plugin update codex"
+            }),
+            await pluginUpdateItem({
+                id: "opencode",
+                displayName: "Embed Labs OpenCode plugin",
+                targetPath: openCodeTarget,
+                installedVersion: await installedOpenCodePluginVersion(openCodeTarget),
+                latestVersion: opencodePackage?.version ?? manifest.version,
+                releaseFile: opencodePackage?.file,
+                updateCommand: "embedlabs plugin update opencode"
+            })
+        ]
+    });
+}
+async function pluginUpdate(parsed) {
+    const unknownFlag = firstUnknownFlag(parsed, ["release-url", "target", "codex-target", "opencode-target", "json"]);
+    if (unknownFlag) {
+        return fail("invalid_args", `Unknown flag --${unknownFlag}. ${PLUGIN_UPDATE_USAGE}`);
+    }
+    const target = parsed.command[2];
+    if (!target || !["codex", "opencode", "all"].includes(target)) {
+        return fail("invalid_args", PLUGIN_UPDATE_USAGE);
+    }
+    const unexpected = parsed.command.slice(3);
+    if (unexpected.length > 0) {
+        return fail("invalid_args", `Unexpected argument: ${unexpected[0]}. ${PLUGIN_UPDATE_USAGE}`);
+    }
+    const installParsed = {
+        ...parsed,
+        command: ["plugin", "install", target],
+        flags: { ...parsed.flags, force: true }
+    };
+    return await pluginInstall(installParsed);
+}
+async function pluginUpdateItem(input) {
+    const installed = !!input.installedVersion;
+    const updateAvailable = !!input.latestVersion && input.installedVersion !== input.latestVersion;
+    const notes = [];
+    if (!installed) {
+        notes.push("Plugin is not installed in the selected target.");
+    }
+    else if (updateAvailable) {
+        notes.push("A newer plugin release is available. Run the update command, then restart Codex/OpenCode.");
+    }
+    else {
+        notes.push("Plugin is up to date for the selected release channel.");
+    }
+    notes.push("Release manifest does not yet carry detailed changelog entries; use the release version and package files as the update summary.");
+    return {
+        id: input.id,
+        display_name: input.displayName,
+        installed,
+        installed_version: input.installedVersion,
+        latest_version: input.latestVersion,
+        update_available: updateAvailable,
+        target_path: input.targetPath,
+        release_file: input.releaseFile,
+        update_command: input.updateCommand,
+        notes
+    };
+}
 async function installCodexPlugin(parsed, context) {
     const source = await resolveCodexPluginSource(context);
     if (!source.ok) {
@@ -3055,6 +3167,21 @@ async function localPluginVersion(kind) {
         return undefined;
     }
 }
+async function installedCodexPluginVersion(pluginPath) {
+    return await readPackageVersion(join(pluginPath, ".codex-plugin", "plugin.json"));
+}
+async function installedOpenCodePluginVersion(targetRoot) {
+    return await readPackageVersion(join(targetRoot, "node_modules", "embed-labs", "package.json"));
+}
+async function readPackageVersion(filePath) {
+    try {
+        const parsed = JSON.parse(await readFile(filePath, "utf8"));
+        return typeof parsed.version === "string" && parsed.version.trim() ? parsed.version.trim() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 async function localPluginSourcesAvailable() {
     return await pathExists(sourceCheckoutPath("platform_plugins", "codex_plugin", "plugins", "embed-labs", ".codex-plugin", "plugin.json"))
         && await pathExists(sourceCheckoutPath("platform_plugins", "opencode_plugin", "package.json"));
@@ -5460,6 +5587,29 @@ function billingSnapshotListRequest(parsed) {
     }
     return { path: `/v1/accounts/${encodeURIComponent(accountResult.value)}/billing/snapshots` };
 }
+function localToolchainListRequest(parsed) {
+    const unknownFlag = firstUnknownFlag(parsed, ["json", "board", "board-id", "channel", "metadata-root", "install-root"]);
+    if (unknownFlag) {
+        return `Unknown flag --${unknownFlag}. ${LOCAL_TOOLCHAIN_LIST_USAGE}`;
+    }
+    const extra = parsed.command.slice(3);
+    if (extra.length > 0) {
+        return `Unexpected argument: ${extra[0]}. ${LOCAL_TOOLCHAIN_LIST_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 installRoot = optionalTrimmedStringFlag(parsed, "install-root");
+    if (installRoot.error)
+        return installRoot.error;
+    return { boardId: board.value, channel: channel.value, metadataRoot: metadataRoot.value, installRoot: installRoot.value };
+}
 function localToolchainLatestRequest(parsed) {
     const unknownFlag = firstUnknownFlag(parsed, ["json", "board", "board-id", "channel", "metadata-root"]);
     if (unknownFlag) {
@@ -6052,6 +6202,29 @@ function renderPluginList(result) {
         `install="${plugin.install_command}"`
     ].filter(Boolean).join(" ")).join("\n");
 }
+function renderPluginUpdateCheck(result) {
+    const lines = [
+        `release_url=${result.release_url}`,
+        result.latest_version ? `latest_version=${result.latest_version}` : ""
+    ].filter(Boolean);
+    for (const plugin of result.plugins) {
+        lines.push("");
+        lines.push(`${plugin.display_name} (${plugin.id})`);
+        lines.push(`  installed=${plugin.installed}`);
+        lines.push(`  installed_version=${plugin.installed_version ?? "none"}`);
+        lines.push(`  latest_version=${plugin.latest_version ?? "unknown"}`);
+        lines.push(`  update_available=${plugin.update_available}`);
+        lines.push(`  target=${plugin.target_path}`);
+        lines.push(`  update_command=${plugin.update_command}`);
+        if (plugin.release_file) {
+            lines.push(`  release_file=${plugin.release_file}`);
+        }
+        for (const note of plugin.notes) {
+            lines.push(`  note=${note}`);
+        }
+    }
+    return lines.join("\n");
+}
 function renderPluginInstall(result) {
     const lines = ["Installed plugins:"];
     for (const item of result.installed) {
@@ -6746,6 +6919,42 @@ function renderBuildWorkspaceSourcePatch(result) {
     }
     return lines.join("\n");
 }
+function renderLocalToolchainList(result) {
+    const lines = [
+        `Local development environments: ${result.environments.length}`,
+        `host=${result.host}`,
+        `channel=${result.channel}`,
+        result.metadata_root ? `metadata_root=${result.metadata_root}` : "metadata=built-in",
+        `install_root=${result.install_root}`,
+        `registry=${result.registry_path}`
+    ];
+    for (const environment of result.environments) {
+        lines.push("");
+        lines.push(`${environment.display_name} (${environment.board_id})`);
+        lines.push(`  status=${environment.status}`);
+        lines.push(`  latest=${environment.latest.version}`);
+        if (environment.installed) {
+            lines.push(`  installed=${environment.installed.version ?? "unknown"} mode=${environment.installed.mode ?? "unknown"}`);
+            if (environment.installed.release_root) {
+                lines.push(`  release_root=${environment.installed.release_root}`);
+            }
+        }
+        lines.push(`  install_modes=${environment.install_modes.join(",")}`);
+        lines.push(`  install_command=${environment.install_command}`);
+        if (environment.status === "update_available") {
+            lines.push(`  update_command=${environment.update_command}`);
+        }
+        if (environment.components?.length) {
+            lines.push(`  components=${environment.components.map((component) => `${component.id}@${component.version}`).join(", ")}`);
+        }
+        if (environment.notes.length > 0) {
+            for (const note of environment.notes) {
+                lines.push(`  note=${note}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
 function renderLocalToolchainLatest(result) {
     const lines = [
         `board=${result.board_id}`,
@@ -7603,12 +7812,14 @@ Main workflow:
   3. Inspect server model routing:
      embed plugin install codex
      embed plugin install opencode
+     embed plugin update check
      embed service modes
      embed model list
      embed model default
   4. Run a natural-language local tool loop:
      embed agent run --prompt "验证开发板状态"
   5. Validate or use the local TaishanPi toolchain:
+     embed local toolchain list
      embed local toolchain latest
      embed local toolchain install
      embed local toolchain validate
@@ -7657,6 +7868,7 @@ 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 list
   embed local toolchain latest
   embed local toolchain current
   embed local toolchain install
@@ -7728,6 +7940,8 @@ Install local AI client plugins explicitly:
   embed plugin list
   embed plugin install codex
   embed plugin install opencode
+  embed plugin update check
+  embed plugin update all
 
 Cloud build path:
 
@@ -7806,6 +8020,8 @@ Usage:
   embed auth logout [--json]
   embed plugin list [--release-dir <dir>] [--release-url <url>] [--json]
   embed plugin install <codex|opencode|all> [--release-dir <dir>] [--release-url <url>] [--target <dir>] [--codex-target <dir>] [--opencode-target <dir>] [--force] [--json]
+  embed plugin update check [--release-url <url>] [--target <dir>] [--codex-target <dir>] [--opencode-target <dir>] [--json]
+  embed plugin update <codex|opencode|all> [--release-url <url>] [--target <dir>] [--codex-target <dir>] [--opencode-target <dir>] [--json]
   embed service modes [--json]
   embed model list [--json]
   embed model default [--json]
@@ -7861,6 +8077,7 @@ 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 list [--board taishanpi-1m-rk3566] [--channel stable] [--metadata-root <path>] [--install-root <path>] [--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>] [--mode minimal|compile|qt|full|images] [--force] [--json]