@lynxship/cli 0.1.20 → 0.1.21

package/dist/commands/development.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"development.d.ts","sourceRoot":"","sources":["../../src/commands/development.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQlE,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;IAChE,OAAO,EAAE,qBAAqB,CAAC;IAC/B,UAAU,EAAE,CACV,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KACnD,IAAI,CAAC;IACV,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,cAAc,CAAC;CACxD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CA8BrE;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,yBAAyB,EAClC,UAAU,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,EACnD,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,GAC9B,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,yBAAyB,EAClC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,GACrC,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/commands/development.js

@@ -0,0 +1,132 @@
+import { readFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { assert } from "@lynxship/contracts";
+import { packageManagerCommand, runProcess, runRspeedy, } from "../process-runner.js";
+import { extractDevServerUrl, shouldPrintDevServerQr } from "../dev-qr.js";
+import { formatDevToolFailure, inspectLynxDevTool } from "../lynx-devtool.js";
+import { initializeBuildProject, } from "./project.js";
+export function forwardedToolArgs(values) {
+    const result = [];
+    const valueFlags = new Set([
+        "--project-dir",
+        "--platform",
+        "--profile",
+        "--context.json",
+    ]);
+    for (let index = 0; index < values.length; index += 1) {
+        const value = values[index];
+        if (!value)
+            continue;
+        if (valueFlags.has(value)) {
+            index += 1;
+            continue;
+        }
+        if ([
+            "--quiet",
+            "--verbose",
+            "--no-color",
+            "--non-interactive",
+            "--banner",
+            "--local",
+        ].includes(value))
+            continue;
+        if (value.startsWith("--project-dir="))
+            continue;
+        result.push(value);
+    }
+    return result;
+}
+export async function runRspeedyCommand(context, subcommand, environment) {
+    await initializeBuildProject(context.project);
+    const forwarded = forwardedToolArgs(context.args);
+    context.ui.info(`Running local Rspeedy ${subcommand}…`);
+    if (subcommand === "dev") {
+        context.ui.info("Lynx Explorer mode: no Android or iOS native host is required. Scan the QR code printed by Rspeedy; source changes reload automatically.");
+    }
+    let devUrl;
+    let devQrPrinted = false;
+    let devQrTimer;
+    const printDevQr = async () => {
+        if (!devUrl || devQrPrinted || context.json || context.ui.options.quiet)
+            return;
+        devQrPrinted = true;
+        if (devQrTimer)
+            clearTimeout(devQrTimer);
+        await context.ui.devServerQr(devUrl);
+    };
+    await runRspeedy(context.root, subcommand, forwarded, {
+        env: environment,
+        quiet: context.json,
+        onOutput: (line) => {
+            context.ui.info(`│ ${line}`);
+            if (subcommand !== "dev")
+                return;
+            const url = extractDevServerUrl(line);
+            if (url && (!devUrl || url.includes("fullscreen=true"))) {
+                devUrl = url;
+                if (devQrTimer)
+                    clearTimeout(devQrTimer);
+                devQrTimer = setTimeout(() => {
+                    void printDevQr();
+                }, 500);
+            }
+            if (devUrl && shouldPrintDevServerQr(line))
+                void printDevQr();
+        },
+    });
+    context.printValue({ status: "success", command: `rspeedy ${subcommand}` }, {
+        title: `Rspeedy ${subcommand}`,
+        rows: [
+            {
+                label: "Command",
+                value: `rspeedy ${subcommand}`,
+                valueColor: "blue",
+            },
+        ],
+        done: `Rspeedy ${subcommand} completed successfully.`,
+    });
+}
+export async function runAutolinkCodegen(context) {
+    const libraryDirectory = resolve(context.root, context.flag("--library-dir", "."));
+    const packageJson = JSON.parse(await readFile(join(libraryDirectory, "package.context.json"), "utf8"));
+    assert(packageJson.scripts?.codegen, "LYNX_CODEGEN_SCRIPT_REQUIRED", "No codegen script was found. Add the official lynx-autolink-codegen script to the native library package.");
+    const manager = packageManagerCommand(libraryDirectory);
+    context.ui.info("Running the project's official Native Module codegen script…");
+    await runProcess(manager.command, ["run", "codegen"], {
+        cwd: libraryDirectory,
+        quiet: context.json,
+        onOutput: (line) => context.ui.info(`│ ${line}`),
+    });
+    context.printValue({ status: "success", directory: libraryDirectory }, {
+        title: "Lynx Autolink codegen",
+        rows: [{ label: "Library", value: libraryDirectory, valueColor: "blue" }],
+        done: "Native Module specifications were generated successfully.",
+    });
+}
+export async function runDevToolDoctor(context, kind) {
+    await initializeBuildProject(context.project);
+    const platform = context.mobilePlatformValue(context.flag("--platform", "android"));
+    const status = await inspectLynxDevTool(context.root, platform);
+    const ready = kind === "devtool"
+        ? status.ok
+        : kind === "trace"
+            ? status.traceReady
+            : status.recorderReady;
+    if (!ready)
+        process.exitCode = 1;
+    context.printValue({ ...status, requested: kind, ready }, {
+        title: `Lynx ${kind === "devtool" ? "DevTool" : kind[0].toUpperCase() + kind.slice(1)} · ${platform}`,
+        rows: status.checks.map((item) => ({
+            label: item.name,
+            value: `${item.status} · ${item.value}${item.fix && item.status !== "pass" ? ` · fix: ${item.fix}` : ""}`,
+            valueColor: item.status === "pass"
+                ? "green"
+                : item.status === "warn"
+                    ? "yellow"
+                    : "red",
+        })),
+        done: ready
+            ? `${kind} prerequisites are ready. Open Lynx DevTool Desktop and connect the target device by USB.`
+            : `Lynx ${kind} prerequisites are incomplete: ${formatDevToolFailure(status) || "review the failed checks"}`,
+    });
+}

package/dist/commands/device.d.ts

@@ -0,0 +1,3 @@
+import type { DevelopmentCommandContext } from "./development.js";
+export declare function runDevice(context: DevelopmentCommandContext): Promise<void>;
+//# sourceMappingURL=device.d.ts.map

package/dist/commands/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/commands/device.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAElE,wBAAsB,SAAS,CAC7B,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAsHf"}

package/dist/commands/device.js

@@ -0,0 +1,86 @@
+import { resolve } from "node:path";
+import { assert } from "@lynxship/contracts";
+import { commandExists, runProcess } from "../process-runner.js";
+import { loadState } from "../runtime/state.js";
+import { launchIosSimulatorApp } from "../ios-build.js";
+import { platformValue } from "../config.js";
+export async function runDevice(context) {
+    const platform = platformValue(context.flag("--platform", "android"));
+    const artifact = context.flag("--artifact");
+    const artifactPath = artifact
+        ? resolve(context.root, artifact)
+        : (await loadState(context.root)).builds
+            .list()
+            .filter((job) => job.platform === platform && job.state === "success")
+            .at(-1)?.artifact?.path;
+    assert(artifactPath, "DEVICE_ARTIFACT_REQUIRED", "Pass --artifact or create a successful build first");
+    if (platform === "android") {
+        assert(commandExists("adb"), "ANDROID_ADB_REQUIRED", "adb was not found in PATH");
+        const device = context.flag("--device");
+        const argsForAdb = device
+            ? ["-s", device, "install", "-r", artifactPath]
+            : ["install", "-r", artifactPath];
+        await runProcess("adb", argsForAdb, {
+            cwd: context.root,
+            quiet: context.json,
+            onOutput: (line) => context.ui.info(`│ ${line}`),
+        });
+    }
+    else if (platform === "ios") {
+        assert(process.platform === "darwin", "IOS_MACOS_REQUIRED", "iOS device/simulator commands require macOS");
+        assert(commandExists("xcrun"), "IOS_XCRUN_REQUIRED", "xcrun was not found in PATH");
+        const device = context.flag("--device", "booted");
+        const simulator = context.args.includes("--simulator");
+        if (simulator || artifactPath.endsWith(".app")) {
+            await runProcess("xcrun", ["simctl", "install", device, artifactPath], {
+                cwd: context.root,
+                quiet: context.json,
+                onOutput: (line) => context.ui.info(`│ ${line}`),
+            });
+            if (context.args.includes("--launch")) {
+                await launchIosSimulatorApp(context.root, device, artifactPath, {
+                    quiet: context.json,
+                    onEvent: (line) => context.ui.info(`│ ${line}`),
+                });
+            }
+        }
+        else {
+            assert(device !== "booted", "IOS_DEVICE_REQUIRED", "A physical iOS install requires --device <device-identifier>; use --simulator for a booted simulator.");
+            await runProcess("xcrun", [
+                "devicectl",
+                "device",
+                "install",
+                "app",
+                "--device",
+                device,
+                artifactPath,
+            ], {
+                cwd: context.root,
+                quiet: context.json,
+                onOutput: (line) => context.ui.info(`│ ${line}`),
+            });
+        }
+    }
+    else if (platform === "harmony") {
+        assert(commandExists("hdc"), "HARMONY_HDC_REQUIRED", "hdc was not found in PATH. Install the OpenHarmony SDK platform tools before installing a HAP.");
+        assert(artifactPath.endsWith(".hap"), "DEVICE_ARTIFACT_INVALID", "HarmonyOS run requires a signed .hap artifact.");
+        const device = context.flag("--device");
+        await runProcess("hdc", device
+            ? ["-t", device, "install", "-r", artifactPath]
+            : ["install", "-r", artifactPath], {
+            cwd: context.root,
+            quiet: context.json,
+            onOutput: (line) => context.ui.info(`│ ${line}`),
+        });
+    }
+    else {
+        assert(false, "TARGET_RUN_UNSUPPORTED", platform === "web"
+            ? "Web artifacts are previewed with `lynxship preview` or served by the project; they are not installed on a device."
+            : "Desktop installers are launched by the operating system after packaging; LynxShip does not claim a cross-platform install command.");
+    }
+    context.printValue({ status: "installed", platform, artifact: artifactPath }, {
+        title: "Device install",
+        rows: [{ label: "Artifact", value: artifactPath, valueColor: "green" }],
+        done: "Artifact installed on the selected target.",
+    });
+}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,18 @@
+import type { BoxRow, CliUi } from "../ui/index.js";
+export interface DoctorCommandContext {
+    root: string;
+    args: readonly string[];
+    ui: CliUi;
+    flag: (name: string, fallback?: string | null) => string | null;
+    printValue: (value: unknown, view?: {
+        title: string;
+        rows: BoxRow[];
+        done: string;
+    }) => void;
+    readConfigurationStatus: () => Promise<{
+        r2: boolean;
+        android: boolean;
+    }>;
+}
+export declare function runDoctor(context: DoctorCommandContext): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;IAChE,UAAU,EAAE,CACV,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KACnD,IAAI,CAAC;IACV,uBAAuB,EAAE,MAAM,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2V5E"}

package/dist/commands/doctor.js

@@ -0,0 +1,320 @@
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { microHsHostTriple } from "@lynxship/microhs";
+import { assert } from "@lynxship/contracts";
+import { detectLynxFramework } from "../frameworks.js";
+import { loadConfig, platformValue, resolveProfile } from "../config.js";
+import { hasAndroidHost } from "../android-build.js";
+import { hasIosHost } from "../ios-build.js";
+import { credentialStorageDescription } from "../secure-store.js";
+import { inspectAutolink } from "../autolink.js";
+import { commandExists } from "../process-runner.js";
+import { confirm } from "../prompt.js";
+import { fixAndroidToolchain, inspectAndroidToolchain, } from "../android-toolchain.js";
+import { inspectIosToolchain } from "../ios-toolchain.js";
+import { inspectProjectPlugins } from "../plugins.js";
+import { inspectDesktopTarget, inspectHarmonyTarget, inspectWebTarget, } from "../target-toolchain.js";
+import { findLockfile, exists } from "../runtime/project.js";
+export async function runDoctor(context) {
+    const { root, args, ui, flag, printValue, readConfigurationStatus } = context;
+    const config = await loadConfig(root);
+    const configuration = await readConfigurationStatus();
+    const doctorPlatform = platformValue(flag("--platform", "android"));
+    const autolink = doctorPlatform === "android" || doctorPlatform === "ios"
+        ? await inspectAutolink(root)
+        : undefined;
+    const autolinkForPlatform = autolink && (doctorPlatform === "android" || doctorPlatform === "ios")
+        ? autolink[doctorPlatform]
+        : undefined;
+    const framework = await detectLynxFramework(root);
+    const packageLockfile = await findLockfile(root);
+    const lockfile = packageLockfile ??
+        (framework.framework === "miso" && (await exists(join(root, "flake.lock")))
+            ? join(root, "flake.lock")
+            : null);
+    const credentialStore = credentialStorageDescription();
+    const nativeCredentialStore = !credentialStore.includes("owner-only");
+    const androidHost = doctorPlatform === "android" ? await hasAndroidHost(root) : false;
+    const doctorProfileName = flag("--profile", "production");
+    const doctorProfile = resolveProfile(config, doctorProfileName);
+    const targetToolchain = doctorPlatform === "web"
+        ? await inspectWebTarget(root, doctorProfile)
+        : doctorPlatform === "harmony"
+            ? await inspectHarmonyTarget(root, doctorProfile)
+            : doctorPlatform === "desktop"
+                ? await inspectDesktopTarget(root, doctorProfile)
+                : undefined;
+    assert(!args.includes("--fix") || doctorPlatform === "android", "CLI_DOCTOR_FIX_PLATFORM", "`doctor --fix` currently repairs Android SDK packages; run it with `--platform android`.");
+    assert(!args.includes("--fix") || ui.interactive, "CLI_INTERACTIVE_REQUIRED", "Run `lynxship doctor --platform android --fix` in an interactive terminal.");
+    let androidToolchain = doctorPlatform === "android"
+        ? await inspectAndroidToolchain(root)
+        : undefined;
+    const iosToolchain = doctorPlatform === "ios"
+        ? await inspectIosToolchain(root, doctorProfile, doctorProfile.ios?.simulator || doctorProfileName === "simulator"
+            ? "simulator"
+            : "device")
+        : undefined;
+    if (androidToolchain && args.includes("--fix")) {
+        await fixAndroidToolchain(root, androidToolchain, (message) => confirm(message), (line) => ui.info(line));
+        androidToolchain = await inspectAndroidToolchain(root);
+    }
+    const nodeMajor = Number(process.versions.node.split(".")[0]);
+    const nodeSupported = nodeMajor >= 22;
+    const nodeRecommended = nodeMajor % 2 === 0;
+    const misoCompiler = framework.framework === "miso"
+        ? (doctorProfile.miso?.compiler ?? "ghcjs")
+        : undefined;
+    const microhsConfig = doctorProfile.miso?.microhs;
+    const microhsBinary = microhsConfig?.binary ?? process.env.LYNXSHIP_MICROHS_BINARY;
+    const microhsBinaryReady = Boolean(microhsBinary && existsSync(resolve(root, microhsBinary)));
+    const microhsManifestPath = microhsConfig?.manifest ?? process.env.LYNXSHIP_MICROHS_MANIFEST;
+    const microhsManifestReady = Boolean((microhsManifestPath && existsSync(resolve(root, microhsManifestPath))) ||
+        microhsConfig?.manifestUrl ||
+        process.env.LYNXSHIP_MICROHS_MANIFEST_URL);
+    let microhsHost;
+    try {
+        microhsHost = microHsHostTriple();
+    }
+    catch {
+        microhsHost = undefined;
+    }
+    const pluginReport = await inspectProjectPlugins(root, config);
+    const invalidPlugins = pluginReport.plugins.filter((plugin) => plugin.status !== "ready");
+    const checks = [
+        {
+            name: "lynx-framework",
+            ok: framework.framework !== "unknown",
+            status: framework.framework === "unknown"
+                ? "warn"
+                : framework.experimental
+                    ? "warn"
+                    : "pass",
+            value: framework.framework === "unknown"
+                ? "unknown · verify the official Lynx/Rspeedy integration"
+                : framework.label +
+                    " · " +
+                    framework.evidence +
+                    (framework.experimental ? " · early access" : ""),
+        },
+        ...(framework.framework === "miso" && misoCompiler !== "microhs"
+            ? [
+                {
+                    name: "miso-nix",
+                    ok: commandExists("nix"),
+                    status: commandExists("nix")
+                        ? "pass"
+                        : "fail",
+                    value: commandExists("nix")
+                        ? "Nix detected"
+                        : "missing · fix: install Nix and rerun doctor",
+                },
+            ]
+            : framework.framework === "miso"
+                ? [
+                    {
+                        name: "miso-compiler",
+                        ok: true,
+                        status: "pass",
+                        value: "MicroHs selected explicitly",
+                    },
+                    {
+                        name: "miso-microhs-host",
+                        ok: Boolean(microhsHost),
+                        status: microhsHost ? "pass" : "fail",
+                        value: microhsHost ??
+                            "unsupported host architecture · fix: use a supported MicroHs host or compiler=ghcjs",
+                    },
+                    {
+                        name: "miso-microhs-toolchain",
+                        ok: microhsBinaryReady || microhsManifestReady,
+                        status: microhsBinaryReady || microhsManifestReady
+                            ? "pass"
+                            : "fail",
+                        value: microhsBinaryReady
+                            ? "external MicroHs binary found"
+                            : microhsManifestReady
+                                ? "pinned release manifest configured · downloaded on build"
+                                : "missing · fix: configure build.<profile>.miso.microhs.binary or manifestUrl",
+                    },
+                    {
+                        name: "miso-microhs-adapter",
+                        ok: Boolean(microhsConfig?.adapter?.command),
+                        status: microhsConfig?.adapter?.command
+                            ? "pass"
+                            : "fail",
+                        value: microhsConfig?.adapter?.command
+                            ? "adapter command configured"
+                            : "missing · fix: configure build.<profile>.miso.microhs.adapter",
+                    },
+                ]
+                : []),
+        {
+            name: "node",
+            ok: nodeSupported,
+            status: !nodeSupported
+                ? "fail"
+                : nodeRecommended
+                    ? "pass"
+                    : "warn",
+            value: !nodeSupported
+                ? `${process.version} · fix: use Node 24 LTS`
+                : nodeRecommended
+                    ? process.version
+                    : `${process.version} · recommended: Node 24 LTS`,
+        },
+        {
+            name: "dependency-lockfile",
+            ok: Boolean(lockfile),
+            status: lockfile ? "pass" : "fail",
+            value: lockfile ?? "missing · fix: pnpm install (or npm install)",
+        },
+        {
+            name: "lynxship.json",
+            ok: config.projectId !== undefined,
+            status: config.projectId ? "pass" : "fail",
+            value: config.projectId ? "found" : "missing · fix: lynxship init",
+        },
+        {
+            name: "lynxship-plugins",
+            ok: invalidPlugins.length === 0,
+            status: invalidPlugins.length === 0 ? "pass" : "fail",
+            value: invalidPlugins.length === 0
+                ? pluginReport.configured === 0
+                    ? "none configured"
+                    : `${pluginReport.configured} plugin(s) ready`
+                : `${invalidPlugins.map((plugin) => plugin.name).join(", ")} · fix: lynxship plugin doctor`,
+        },
+        {
+            name: "credential-store",
+            ok: true,
+            status: nativeCredentialStore ? "pass" : "warn",
+            value: nativeCredentialStore
+                ? credentialStore
+                : `${credentialStore} · use CI secret variables or install Linux Secret Service`,
+        },
+        ...(doctorPlatform === "android"
+            ? [
+                {
+                    name: "android-host",
+                    ok: androidHost,
+                    status: androidHost ? "pass" : "fail",
+                    value: androidHost
+                        ? "Gradle host found"
+                        : "missing · fix: lynxship android host init --application-id com.example.myapp",
+                },
+                ...(androidToolchain?.checks ?? []).map((toolchainCheck) => ({
+                    name: toolchainCheck.name,
+                    ok: toolchainCheck.ok,
+                    status: toolchainCheck.status,
+                    value: toolchainCheck.fix && toolchainCheck.status !== "pass"
+                        ? `${toolchainCheck.value} · fix: ${toolchainCheck.fix}`
+                        : toolchainCheck.value,
+                })),
+            ]
+            : doctorPlatform === "ios"
+                ? (iosToolchain?.checks ?? [])
+                    .filter((toolchainCheck) => toolchainCheck.name !== "ios-host")
+                    .map((toolchainCheck) => ({
+                    name: toolchainCheck.name,
+                    ok: toolchainCheck.ok,
+                    status: toolchainCheck.status,
+                    value: toolchainCheck.fix && toolchainCheck.status !== "pass"
+                        ? `${toolchainCheck.value} · fix: ${toolchainCheck.fix}`
+                        : toolchainCheck.value,
+                }))
+                : (targetToolchain?.checks ?? []).map((toolchainCheck) => ({
+                    name: toolchainCheck.name,
+                    ok: toolchainCheck.ok,
+                    status: toolchainCheck.status,
+                    value: toolchainCheck.fix && toolchainCheck.status !== "pass"
+                        ? `${toolchainCheck.value} · fix: ${toolchainCheck.fix}`
+                        : toolchainCheck.value,
+                }))),
+        {
+            name: "cloudflare-r2",
+            ok: doctorPlatform === "ios" && doctorProfile.ios?.simulator
+                ? true
+                : configuration.r2,
+            status: doctorPlatform === "ios" && doctorProfile.ios?.simulator
+                ? "pass"
+                : configuration.r2
+                    ? "pass"
+                    : "fail",
+            value: doctorPlatform === "ios" && doctorProfile.ios?.simulator
+                ? "not required for iOS Simulator"
+                : configuration.r2
+                    ? "configured"
+                    : "missing · fix: lynxship storage configure",
+        },
+        ...(doctorPlatform === "android"
+            ? [
+                {
+                    name: "android-signing",
+                    ok: configuration.android,
+                    status: configuration.android
+                        ? "pass"
+                        : "fail",
+                    value: configuration.android
+                        ? "configured"
+                        : "missing · fix: lynxship android configure",
+                },
+            ]
+            : doctorPlatform === "ios"
+                ? [
+                    {
+                        name: "ios-host",
+                        ok: process.platform === "darwin" && hasIosHost(root),
+                        status: process.platform === "darwin" && hasIosHost(root)
+                            ? "pass"
+                            : "fail",
+                        value: process.platform === "darwin" && hasIosHost(root)
+                            ? "Xcode host found"
+                            : "missing · fix: use macOS, then lynxship ios host init --bundle-identifier com.example.myapp",
+                    },
+                ]
+                : []),
+        ...(autolinkForPlatform
+            ? [
+                {
+                    name: `lynx-autolink-${doctorPlatform}`,
+                    ok: autolinkForPlatform.ready,
+                    status: autolinkForPlatform.ready
+                        ? "pass"
+                        : "fail",
+                    value: autolinkForPlatform.ready
+                        ? autolinkForPlatform.reason
+                        : `${autolinkForPlatform.reason} · fix: install the native plugin, then run autolink codegen`,
+                },
+            ]
+            : []),
+    ];
+    const result = {
+        ok: checks.every((check) => check.status !== "fail"),
+        checks,
+    };
+    const hasWarnings = checks.some((check) => check.status === "warn");
+    if (!result.ok)
+        ui.warn("One or more environment checks failed");
+    else if (hasWarnings)
+        ui.warn("Environment is usable, but one recommendation needs attention");
+    if (!result.ok)
+        process.exitCode = 1;
+    printValue(result, {
+        title: "Doctor result",
+        rows: checks.map((check) => ({
+            label: check.name,
+            value: `${check.status} · ${check.value}`,
+            valueColor: check.status === "pass"
+                ? "green"
+                : check.status === "warn"
+                    ? "yellow"
+                    : "red",
+        })),
+        done: result.ok
+            ? hasWarnings
+                ? "Environment is usable; review the recommendation when convenient."
+                : "Environment looks ready."
+            : "Fix the failed checks before building.",
+    });
+    return;
+}

package/dist/commands/help.d.ts

@@ -0,0 +1,2 @@
+export declare function helpText(): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,IAAI,MAAM,CAqHjC"}