@kvell007/embed-labs-cli 0.1.0-alpha.50 → 0.1.0-alpha.52

package/README.md

@@ -22,8 +22,8 @@ names.
 - Auth token login, logout, and status commands.
 - Account registration, API key issue/list, token usage metering, and billing
   statement preview commands.
-- Server-side application source generation through Cloud API agents, followed by
-  task artifacts and downloads.
+- Board knowledge/method discovery through Cloud API, plus local-first
+  toolchain installation, validation, compile, and hardware handoff.
 - Debug tool, device, serial, SSH, and flash commands routed through the local
   bridge.
 - Project, task, artifact, and cloud status commands routed through the cloud
@@ -117,18 +117,23 @@ message `工具完整性校验失败，请在当前电脑重新执行 embedlabs
 For the current public API plus local TaishanPi verification path, see
 `docs/runbooks/PUBLIC_CLI_USER_VERIFICATION.md`.
 
-For the cloud build path:
+For board knowledge and local toolchain work:
 
 ```bash
-embed build template list
-embed build template show <template_id>
-embed build workspace provision --account <account_id> --project <project_id> --template <template_id>
-embed build workspace source put <workspace_id> --file ./main.c:src/main.c
-embed build application generate --workspace <workspace_id> --prompt "Create a minimal Linux app"
-embed cloud task artifacts <task_id>
-embed artifact download <artifact_id> --output ./artifact.bin
+embed board registry list
+embed board methods taishanpi-1m-rk3566
+embed board knowledge search taishanpi-1m-rk3566 --query "UART pinout"
+embed local toolchain list
+embed local toolchain latest --board taishanpi-1m-rk3566
+embed local toolchain validate --board taishanpi-1m-rk3566 --mode minimal
+embed local compile taishanpi --source ./main.c --output ./.embed-labs/build/main
 ```
 
+Server-side user workspaces and server Docker builds are disabled in the
+local-first product mode. The server remains responsible for accounts, API
+keys, model routing, billing, plugin releases, SDK/download metadata, and small
+image/DTB/logo package generation.
+
 For local hardware access:
 
 ```bash
@@ -199,14 +204,25 @@ embed billing snapshot create --account <account_id> [--from <iso>] [--to <iso>]
 embed billing snapshot list --account <account_id> [--json]
 embed billing snapshot show <billing_snapshot_id> [--json]
 
+embed board registry list [--json]
+embed board methods <template_id> [--json]
+embed board knowledge <template_id> [--json]
+embed board knowledge search <template_id> --query <text> [--json]
 embed build template list [--json]
 embed build template show <template_id> [--json]
-embed build workspace provision --account <account_id> --project <project_id> [--template <template_id>] [--copy-mode auto|copy|symlink|skeleton] [--require-seed] [--dry-run] [--json]
-embed build workspace list --account <account_id> [--json]
-embed build workspace show <workspace_id> [--json]
-embed build workspace source put <workspace_id> [--account <account_id>] --file <local_path>:<source_path> [--file <local_path>:<source_path>] [--json]
-embed build application stub --workspace <workspace_id> [--account <account_id>] [--json]
-embed build application generate --workspace <workspace_id> --prompt <request> [--account <account_id>] [--target <source_path>] [--provider stub|openai|cc|claude-code] [--model <model>] [--json]
+embed local toolchain list [--board <board_id>] [--json]
+embed local toolchain installed [--board <board_id>] [--json]
+embed local toolchain latest [--board <board_id>] [--json]
+embed local toolchain current [--json]
+embed local toolchain install [--board <board_id>] [--mode minimal|runtime|compile|qt|firmware|full|images] [--json]
+embed local toolchain validate [--board <board_id>] [--mode minimal|runtime|compile|qt|firmware|full|images] [--json]
+embed local compile taishanpi --source <main.c|main.cpp> --output <artifact> [--json]
+embed local build qt-smoke --build-dir <build_dir> [--source <qt-cmake-dir>] [--target-name <executable>] [--json]
+
+The `qt-smoke` subcommand name is kept for compatibility. When `--source` and
+`--target-name` are supplied, it builds the supplied TaishanPi Qt/CMake
+application, including official board-pack examples such as
+`board-packs/taishanpi/examples/modbus-loop-demo/taishanpi`.
 
 embed bridge start [--host 127.0.0.1] [--port 18083]
 embed bridge status [--json]

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, validateLocalToolchain } from "./local-toolchain.js";
+import { buildTaishanPiQtSmoke, compileTaishanPiSingleFile, currentLocalToolchain, installLocalToolchain, latestLocalToolchain, listLocalToolchainEnvironments, uninstallLocalToolchain, 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));
@@ -102,9 +102,10 @@ const LOCAL_TOOLCHAIN_INSTALLED_USAGE = "Usage: embed local toolchain installed
 const LOCAL_TOOLCHAIN_LATEST_USAGE = "Usage: embed local toolchain latest [--board taishanpi-1m-rk3566|pico2w-rp2350-monitor|coloreasypico2-rp2350-monitor] [--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|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_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]";
+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]";
 const AUTH_DEVICE_LIST_USAGE = "Usage: embed auth device list [--json]";
 const AUTH_DEVICE_REVOKE_USAGE = "Usage: embed auth device revoke <device_id> [--json]";
@@ -620,6 +621,13 @@ async function main(argv) {
                 }
                 return output(parsed, ok(await installLocalToolchain(request)), renderLocalToolchainInstall);
             }
+            if (action === "toolchain" && (parsed.command[2] === "uninstall" || parsed.command[2] === "remove")) {
+                const request = localToolchainUninstallRequest(parsed);
+                if (typeof request === "string") {
+                    return output(parsed, fail("invalid_args", request), undefined, 2);
+                }
+                return output(parsed, ok(await uninstallLocalToolchain(request)), renderLocalToolchainUninstall);
+            }
             if (action === "toolchain" && parsed.command[2] === "validate") {
                 const request = localToolchainValidateRequest(parsed);
                 if (typeof request === "string") {
@@ -647,6 +655,7 @@ async function main(argv) {
                 LOCAL_TOOLCHAIN_LATEST_USAGE,
                 LOCAL_TOOLCHAIN_CURRENT_USAGE,
                 LOCAL_TOOLCHAIN_INSTALL_USAGE,
+                LOCAL_TOOLCHAIN_UNINSTALL_USAGE,
                 LOCAL_TOOLCHAIN_VALIDATE_USAGE,
                 LOCAL_COMPILE_TAISHANPI_USAGE,
                 LOCAL_BUILD_QT_SMOKE_USAGE
@@ -5759,6 +5768,26 @@ function localToolchainInstallRequest(parsed) {
         force: booleanFlag(parsed, "force")
     };
 }
+function localToolchainUninstallRequest(parsed) {
+    const unknownFlag = firstUnknownFlag(parsed, ["json", "board", "board-id", "install-root"]);
+    if (unknownFlag) {
+        return `Unknown flag --${unknownFlag}. ${LOCAL_TOOLCHAIN_UNINSTALL_USAGE}`;
+    }
+    const extra = parsed.command.slice(3);
+    if (extra.length > 0) {
+        return `Unexpected argument: ${extra[0]}. ${LOCAL_TOOLCHAIN_UNINSTALL_USAGE}`;
+    }
+    const board = optionalTrimmedStringAliasFlag(parsed, ["board", "board-id"], "board or board-id");
+    if (board.error)
+        return board.error;
+    if (!board.value) {
+        return LOCAL_TOOLCHAIN_UNINSTALL_USAGE;
+    }
+    const installRoot = optionalTrimmedStringFlag(parsed, "install-root");
+    if (installRoot.error)
+        return installRoot.error;
+    return { boardId: board.value, installRoot: installRoot.value };
+}
 function localToolchainValidateRequest(parsed) {
     const unknownFlag = firstUnknownFlag(parsed, ["json", "board", "board-id", "release-root", "mode"]);
     if (unknownFlag) {
@@ -7227,6 +7256,26 @@ function renderLocalToolchainInstall(result) {
     }
     return lines.join("\n");
 }
+function renderLocalToolchainUninstall(result) {
+    const lines = [
+        result.removed ? "Local toolchain uninstalled." : "Local toolchain was not installed.",
+        `board=${result.board_id}`,
+        `install_root=${result.install_root}`,
+        `registry=${result.registry_path}`,
+        `removed_registry_entry=${result.removed_registry_entry}`,
+        `observed_at=${result.observed_at}`
+    ];
+    if (result.removed_paths.length > 0) {
+        lines.push("removed_paths:");
+        for (const removedPath of result.removed_paths) {
+            lines.push(`  ${removedPath}`);
+        }
+    }
+    if (result.remaining_installed_boards.length > 0) {
+        lines.push(`remaining_installed_boards=${result.remaining_installed_boards.join(",")}`);
+    }
+    return lines.join("\n");
+}
 function renderLocalToolchainValidation(result) {
     const lines = [
         result.ok ? "Local toolchain ready." : "Local toolchain not ready.",
@@ -8024,34 +8073,24 @@ Main workflow:
      embed local toolchain installed
      embed local toolchain latest
      embed local toolchain install
+     embed local toolchain uninstall --board pico2w-rp2350-monitor
      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
-  6. Pick a cloud build template:
+     embed local build qt-smoke --source ./taishanpi-app --target-name app --build-dir ./.embed-labs/build/app
+  6. Query board knowledge and method metadata:
      embed board registry list
      embed board methods taishanpi-1m-rk3566
      embed board knowledge taishanpi-1m-rk3566
      embed board knowledge search taishanpi-1m-rk3566 --query "UART pinout"
      embed build template list
      embed build template show <template_id>
-  7. Provision and populate a build workspace:
-     embed build workspace provision --account <account_id> --project <project_id> --template <template_id>
-     embed build resource lease create --workspace <workspace_id> --execution-mode cloud_worker
-     embed build workspace source put <workspace_id> --file ./main.c:src/main.c
-     embed build workspace source list <workspace_id>
-     embed build workspace source get <workspace_id> --path src/main.c --output ./main.c
-     embed build workspace source search <workspace_id> --query init --glob "**/*.c"
-     embed build workspace source patch <workspace_id> --patch ./fix.patch
-     embed build workspace release <workspace_id> --dry-run
-  8. Generate application source on the server and follow artifacts:
-     embed build application generate --workspace <workspace_id> --prompt "Create a minimal Linux app" --provider bai --model gpt-5.2
-     embed build application compile --workspace <workspace_id> --source app/generated.c --execution-mode docker_worker
-     embed build image generate --workspace <workspace_id> --prompt "Generate a minimal TaishanPi image"
+  7. Generate small image packages and compose locally:
      embed build image boot-logo --logo ./logo.png --board taishanpi --variant 1M-RK3566 --output ./boot-logo-package.json
      embed image boot-logo compose --package ./boot-logo-package.json --base-image ./boot.img --output ./boot-logo.img
      embed cloud task artifacts <task_id>
      embed artifact download <artifact_id> --output ./artifact.bin
-  9. Check credits or create a recharge QR:
+  8. Check credits or create a recharge QR:
      embed billing balance --account <account_id>
      embed billing tokens --account <account_id>
      embed billing ledger --account <account_id>
@@ -8065,7 +8104,7 @@ Local hardware:
   embed agent run --prompt "部署泰山派应用" --host 198.19.77.2 --artifact ./artifact.bin --remote-path /userdata/embed-labs/apps/app --approve --run
   embed agent run --prompt "部署生成的泰山派应用" --host 198.19.77.2 --artifact-task <task_id> --remote-path /userdata/embed-labs/apps/app --approve --run
   embed tool list
-  embed tool call device.probe --input-json '{"host":"198.19.77.2","ports":[22,15301]}'
+  embed tool call device.probe --input-json '{"host":"198.19.77.2","ports":[22]}'
   embed tool call wifi.scan --input-json '{"host":"198.19.77.2","user":"root"}'
   embed tool call rp2350.monitor.spi.transfer --input-json '{"hex":"a55a3cc3"}' --approve
   embed tool call chip.temperature --input-json '{"host":"198.19.77.2","user":"root"}'
@@ -8076,9 +8115,11 @@ Local hardware:
   embed local toolchain latest
   embed local toolchain current
   embed local toolchain install
+  embed local toolchain uninstall --board pico2w-rp2350-monitor
   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
+  embed local build qt-smoke --source ./taishanpi-app --target-name app --build-dir ./.embed-labs/build/app
   embed image boot-logo compose --package ./boot-logo-package.json --base-image ./boot.img --output ./boot-logo.img
   embed deploy taishanpi --host 198.19.77.2 --artifact ./artifact.bin --approve --run
   embed flash plan --board <rp2350|taishanpi>
@@ -8156,6 +8197,7 @@ Cloud build path:
   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
+  embed local build qt-smoke --source ./taishanpi-app --target-name app --build-dir ./.embed-labs/build/app
   embed board registry list
   embed board registry show taishanpi-1m-rk3566
   embed board methods taishanpi-1m-rk3566
@@ -8171,9 +8213,6 @@ Cloud build path:
   embed build workspace source search <workspace_id> --query init --glob "**/*.c"
   embed build workspace source patch <workspace_id> --patch ./fix.patch
   embed build workspace release <workspace_id> --dry-run
-  embed build application generate --workspace <workspace_id> --prompt "Create a minimal Linux app" --provider bai --model gpt-5.2
-  embed build application compile --workspace <workspace_id> --source app/generated.c --execution-mode docker_worker
-  embed build image generate --workspace <workspace_id> --prompt "Generate a minimal TaishanPi image"
   embed build image boot-logo --logo ./logo.png --board taishanpi --variant 1M-RK3566 --output ./boot-logo-package.json
   embed image boot-logo compose --package ./boot-logo-package.json --base-image ./boot.img --output ./boot-logo.img
   embed cloud task status <task_id>
@@ -8204,7 +8243,7 @@ Local hardware path:
   embed run "验证开发板状态"
   embed tool list
   embed tool call debug.tools.scan
-  embed tool call device.probe --input-json '{"host":"198.19.77.2","ports":[22,15301]}'
+  embed tool call device.probe --input-json '{"host":"198.19.77.2","ports":[22]}'
   embed device list
   embed deploy taishanpi --host 198.19.77.2 --artifact ./artifact.bin --approve --run
   embed flash plan --board <rp2350|taishanpi> --artifact ./artifact.bin
@@ -8289,9 +8328,10 @@ Usage:
   embed local toolchain current [--install-root <path>] [--json]
   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]
       Defaults to the production download channel at download.embedboard.com.
+  embed local toolchain uninstall --board taishanpi-1m-rk3566|pico2w-rp2350-monitor|coloreasypico2-rp2350-monitor [--install-root <path>] [--json]
   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]
   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]
+  embed local build qt-smoke --build-dir <dir> [--source <qt-cmake-dir>] [--target-name <executable>] [--release-root <path>] [--account <account_id>] [--json]
   embed debug tools [--json]
   embed tool list [--json]
   embed tool call wifi.scan --input-json '{"host":"198.19.77.2","user":"root"}' [--json]