@kvell007/embed-labs-cli 0.1.0-alpha.6 → 0.1.0-alpha.61

package/dist/install-progress.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/install-progress.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import { writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { arch, platform } from "node:os";
+const phase = process.argv[2] === "preinstall" ? "preinstall" : "postinstall";
+const require = createRequire(import.meta.url);
+const target = `${platform()}-${arch()}`;
+const nativePackages = {
+    "darwin-arm64": "@embed-labs/local-bridge-darwin-arm64",
+    "linux-x64": "@embed-labs/local-bridge-linux-x64",
+    "linux-arm64": "@embed-labs/local-bridge-linux-arm64",
+    "win32-x64": "@embed-labs/local-bridge-win32-x64",
+    "win32-arm64": "@embed-labs/local-bridge-win32-arm64"
+};
+async function main() {
+    if (phase === "preinstall") {
+        await progress([
+            [5, `install: initializing (${target})`],
+            [12, "install: preparing npm package graph"],
+            [20, "install: resolving CLI dependencies"]
+        ]);
+        return;
+    }
+    const nativeName = nativePackages[target];
+    const nativeStatus = nativeName
+        ? packageAvailable(nativeName)
+            ? `native bridge package ready (${nativeName})`
+            : `native bridge package missing (${nativeName})`
+        : `native bridge package unavailable for ${target}`;
+    await progress([
+        [65, "install: verifying CLI files"],
+        [78, nativeStatus],
+        [92, "install: checking command shims"],
+        [100, "install: complete"]
+    ]);
+}
+async function progress(steps) {
+    for (const [percent, message] of steps) {
+        writeProgress(percent, message);
+        await sleep(1000);
+    }
+}
+function writeProgress(percent, message) {
+    const line = `[Embed Labs] ${String(percent).padStart(3, " ")}% ${message}\n`;
+    process.stdout.write(line);
+    writeDirectConsole(line);
+}
+function writeDirectConsole(line) {
+    if (process.stdout.isTTY || process.env.EMBEDLABS_INSTALL_NO_TTY === "1") {
+        return;
+    }
+    try {
+        writeFileSync(platform() === "win32" ? "\\\\.\\CONOUT$" : "/dev/tty", line, { flag: "a" });
+    }
+    catch {
+        // CI and some package managers run without a controlling TTY. In that case
+        // stdout is still available when lifecycle output is not suppressed.
+    }
+}
+function packageAvailable(name) {
+    try {
+        require.resolve(`${name}/package.json`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+main().catch((error) => {
+    writeProgress(100, `install: warning (${error instanceof Error ? error.message : String(error)})`);
+});
+//# sourceMappingURL=install-progress.js.map

package/dist/install-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-progress.js","sourceRoot":"","sources":["../src/install-progress.ts"],"names":[],"mappings":"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"}

package/dist/local-toolchain.d.ts

@@ -3,9 +3,12 @@ export interface LocalToolchainAuthContext {
     profile: string;
     source?: string;
     account_id?: string;
+    api_key_id?: string;
+    device_id?: string;
 }
 export interface LocalToolchainValidationResult {
     ok: boolean;
+    mode: string;
     host: {
         platform: string;
         arch: string;
@@ -14,6 +17,10 @@ export interface LocalToolchainValidationResult {
     release_root: string;
     checked_paths: LocalToolchainPathCheck[];
     missing_paths: string[];
+    path_leaks: LocalToolchainPathLeak[];
+    missing_groups: string[];
+    repair_command?: string;
+    summary_for_user: string;
     notes: string[];
 }
 export interface LocalToolchainPathCheck {
@@ -21,6 +28,11 @@ export interface LocalToolchainPathCheck {
     path: string;
     exists: boolean;
 }
+export interface LocalToolchainPathLeak {
+    label: string;
+    path: string;
+    forbidden: string;
+}
 export interface LocalCompileOptions {
     boardId: string;
     sourcePath: string;
@@ -80,6 +92,7 @@ export interface LocalToolchainPackageManifest {
     family?: string;
     board?: string;
     variant?: string;
+    board_id?: string;
     requires?: Array<{
         id: string;
         version: string;
@@ -103,10 +116,66 @@ export interface LocalToolchainLatestResult {
     download?: LocalToolchainDownloadPlan;
     download_error?: string;
 }
+export interface WindowsWslStatusResult {
+    host: string;
+    platform: string;
+    arch: string;
+    checked_at: string;
+    applicable: boolean;
+    wsl_available: boolean;
+    usable: boolean;
+    distributions: Array<{
+        name: string;
+        state?: string;
+        version?: string;
+        default?: boolean;
+    }>;
+    online_distributions: Array<{
+        name: string;
+        friendly_name?: string;
+        default?: boolean;
+    }>;
+    taishanpi_execution: WindowsWslTaishanPiExecution;
+    commands: {
+        status: string;
+        list: string;
+        list_online: string;
+        install_ubuntu: string;
+    };
+    notes: string[];
+}
+export interface WindowsWslTaishanPiExecution {
+    supported: boolean;
+    required_host: "linux-x86_64";
+    actual_host?: string;
+    windows_host: string;
+    route: "wsl2";
+    status: "ready" | "wsl_not_applicable" | "wsl_missing" | "wsl_not_configured" | "architecture_mismatch" | "package_missing";
+    install_command: string;
+    reason: string;
+}
+export interface WindowsWslInstallOptions {
+    distribution?: string;
+    noLaunch?: boolean;
+    webDownload?: boolean;
+    timeoutMs?: number;
+}
+export interface WindowsWslInstallResult {
+    host: string;
+    platform: string;
+    arch: string;
+    command: string[];
+    exit_code: number;
+    stdout_tail: string[];
+    stderr_tail: string[];
+    status_after: WindowsWslStatusResult;
+    notes: string[];
+}
 export interface LocalToolchainInstallOptions extends LocalToolchainLatestOptions {
     sourceReleaseRoot?: string;
     sourceUrl?: string;
     installRoot?: string;
+    mode?: string;
     force?: boolean;
 }
 export interface LocalToolchainInstallResult {
@@ -114,16 +183,18 @@ export interface LocalToolchainInstallResult {
     version: string;
     channel: string;
     host: string;
+    mode: string;
     install_root: string;
     release_root: string;
     registry_path: string;
     source: {
-        kind: "directory" | "url";
+        kind: "directory" | "url" | "components";
         value: string;
         downloaded_path?: string;
         mirror_kind?: string;
         sha256?: string;
         size_bytes?: number;
+        components?: LocalToolchainInstalledComponent[];
     };
     installed_paths: string[];
     packages: LocalToolchainPackageRef[];
@@ -133,12 +204,91 @@ export interface LocalToolchainCurrentResult {
     installed: boolean;
     board_id: string;
     version?: string;
+    mode?: string;
     release_root?: string;
     registry_path: string;
     install_root: string;
     channel?: string;
     packages?: LocalToolchainPackageRef[];
 }
+export interface LocalToolchainListOptions extends LocalToolchainLatestOptions {
+    installRoot?: string;
+    installedOnly?: boolean;
+}
+export interface LocalToolchainUninstallOptions {
+    boardId?: string;
+    installRoot?: string;
+}
+export interface LocalToolchainEnvironmentRecord {
+    board_id: string;
+    package_id: string;
+    display_name: string;
+    family?: string;
+    variant?: string;
+    channel: string;
+    host: string;
+    status: "installed" | "available" | "update_available" | "unsupported_host";
+    supported_host: boolean;
+    unsupported_packages: string[];
+    install_modes: string[];
+    installed?: {
+        version?: string;
+        channel?: string;
+        mode?: string;
+        release_root?: string;
+    };
+    latest: {
+        version: string;
+        default_mode?: string;
+        source_url?: string;
+        manifest_url?: string;
+        component_count?: number;
+        download_error?: string;
+    };
+    packages: LocalToolchainPackageRef[];
+    components?: LocalToolchainEnvironmentComponent[];
+    execution?: LocalToolchainExecutionRoute;
+    install_command: string;
+    update_command: string;
+    notes: string[];
+}
+export interface LocalToolchainExecutionRoute {
+    kind: "native" | "wsl2";
+    supported: boolean;
+    required_host?: string;
+    actual_host?: string;
+    status_command?: string;
+    install_command?: string;
+    reason?: string;
+}
+export interface LocalToolchainEnvironmentComponent {
+    id: string;
+    version: string;
+    role?: string;
+    install_modes?: string[];
+    file: string;
+    size_bytes: number;
+    source_url?: string;
+}
+export interface LocalToolchainListResult {
+    host: string;
+    channel: string;
+    metadata_source: "built_in" | "local_override";
+    metadata_root?: string;
+    install_root: string;
+    registry_path: string;
+    environments: LocalToolchainEnvironmentRecord[];
+}
+export interface LocalToolchainUninstallResult {
+    board_id: string;
+    install_root: string;
+    registry_path: string;
+    removed: boolean;
+    removed_paths: string[];
+    removed_registry_entry: boolean;
+    remaining_installed_boards: string[];
+    observed_at: string;
+}
 export interface LocalToolchainDownloadPlan {
     channel_url: string;
     manifest_url: string;
@@ -147,15 +297,17 @@ export interface LocalToolchainDownloadPlan {
     board_id: string;
     host: string;
     toolchain: string;
-    source_url: string;
-    mirror_kind: string;
-    archive: {
+    source_url?: string;
+    mirror_kind?: string;
+    archive?: {
         file: string;
         size_bytes: number;
         sha256: string;
         content_type?: string;
     };
     mirrors: LocalToolchainDownloadMirror[];
+    components?: LocalToolchainDownloadComponent[];
+    default_mode?: string;
 }
 export interface LocalToolchainDownloadMirror {
     kind: string;
@@ -164,10 +316,43 @@ export interface LocalToolchainDownloadMirror {
     sha256?: string;
     size_bytes?: number;
 }
+export interface LocalToolchainDownloadComponent {
+    id: string;
+    version: string;
+    role?: string;
+    install_modes?: string[];
+    archive: {
+        file: string;
+        size_bytes: number;
+        sha256: string;
+        content_type?: string;
+    };
+    source_url?: string;
+    mirror_kind?: string;
+    mirrors: LocalToolchainDownloadMirror[];
+}
+export interface LocalToolchainInstalledComponent {
+    id: string;
+    version: string;
+    role?: string;
+    archive_file: string;
+    mirror_kind?: string;
+    downloaded_path: string;
+    size_bytes: number;
+    sha256: string;
+}
 export declare function defaultLocalReleaseRoot(): string;
 export declare function latestLocalToolchain(options?: LocalToolchainLatestOptions): Promise<LocalToolchainLatestResult>;
 export declare function currentLocalToolchain(installRoot?: string, boardId?: string): Promise<LocalToolchainCurrentResult>;
+export declare function listLocalToolchainEnvironments(options?: LocalToolchainListOptions): Promise<LocalToolchainListResult>;
 export declare function installLocalToolchain(options?: LocalToolchainInstallOptions): Promise<LocalToolchainInstallResult>;
-export declare function validateLocalToolchain(releaseRoot?: string): Promise<LocalToolchainValidationResult>;
+export declare function windowsWslStatus(): Promise<WindowsWslStatusResult>;
+export declare function windowsWslInstall(options?: WindowsWslInstallOptions): Promise<WindowsWslInstallResult>;
+export declare function uninstallLocalToolchain(options?: LocalToolchainUninstallOptions): Promise<LocalToolchainUninstallResult>;
+export declare function validateLocalToolchain(input?: string | {
+    releaseRoot?: string;
+    mode?: string;
+    boardId?: string;
+}): Promise<LocalToolchainValidationResult>;
 export declare function compileTaishanPiSingleFile(options: LocalCompileOptions): Promise<LocalCompileResult>;
 export declare function buildTaishanPiQtSmoke(options: LocalQtSmokeBuildOptions): Promise<LocalCompileResult>;