@lynxship/cli 0.1.7 → 0.1.10

package/dist/ios-toolchain.d.ts

@@ -0,0 +1,19 @@
+import type { BuildProfile } from "./config.js";
+export type IosToolchainStatus = "pass" | "warn" | "fail";
+export interface IosToolchainCheck {
+    name: string;
+    status: IosToolchainStatus;
+    ok: boolean;
+    value: string;
+    fix?: string;
+}
+export interface IosToolchainReport {
+    ok: boolean;
+    checks: IosToolchainCheck[];
+    project?: string;
+    scheme?: string;
+    automaticSigning: boolean;
+}
+export declare function inspectIosToolchain(root: string, profile: BuildProfile): Promise<IosToolchainReport>;
+export declare function formatIosToolchainFailure(report: IosToolchainReport): string;
+//# sourceMappingURL=ios-toolchain.d.ts.map

package/dist/ios-toolchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios-toolchain.d.ts","sourceRoot":"","sources":["../src/ios-toolchain.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,CAAC;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAoKD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,kBAAkB,CAAC,CA4T7B;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAQ5E"}

package/dist/ios-toolchain.js

@@ -0,0 +1,303 @@
+import { homedir, platform } from "node:os";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { captureProcess, commandExists, } from "./process-runner.js";
+function check(name, status, value, fix) {
+    return { name, status, ok: status !== "fail", value, fix };
+}
+function findHost(root, profile) {
+    const configured = profile.ios?.workspace ?? profile.ios?.project;
+    if (configured) {
+        const configuredPath = resolve(root, configured);
+        if (configuredPath.endsWith(".xcodeproj")) {
+            const workspace = configuredPath.replace(/\.xcodeproj$/, ".xcworkspace");
+            if (existsSync(workspace))
+                return workspace;
+        }
+        return configuredPath;
+    }
+    for (const directory of ["ios", "macos"]) {
+        try {
+            const candidate = readdirSync(join(root, directory)).find((name) => name.endsWith(".xcworkspace") || name.endsWith(".xcodeproj"));
+            if (candidate)
+                return join(root, directory, candidate);
+        }
+        catch {
+            // A native host is optional until an iOS build is requested.
+        }
+    }
+    return undefined;
+}
+function projectFlag(path) {
+    return path.endsWith(".xcworkspace") ? "-workspace" : "-project";
+}
+function commandOutput(result) {
+    return `${result.stdout}\n${result.stderr}`.trim();
+}
+function setting(output, name) {
+    return output.match(new RegExp(`^${name}\\s*=\\s*(.+)$`, "m"))?.[1]?.trim();
+}
+function provisioningProfilesDirectory() {
+    return join(homedir(), "Library", "MobileDevice", "Provisioning Profiles");
+}
+function provisioningProfileFiles() {
+    try {
+        return readdirSync(provisioningProfilesDirectory())
+            .filter((name) => /\.(?:mobileprovision|provisionprofile)$/.test(name))
+            .map((name) => join(provisioningProfilesDirectory(), name));
+    }
+    catch {
+        return [];
+    }
+}
+function plistValue(content, key) {
+    return content.match(new RegExp(`<key>${key}</key>\\s*<(?:string|date)>([^<]+)</`))?.[1];
+}
+async function validProvisioningProfile(file, root, bundleIdentifier) {
+    if (!commandExists("security"))
+        return false;
+    try {
+        const decoded = await captureProcess("security", ["cms", "-D", "-i", file], { cwd: root });
+        if (decoded.code !== 0)
+            return false;
+        const content = commandOutput(decoded);
+        const expiration = plistValue(content, "ExpirationDate");
+        if (!expiration || Number.isNaN(Date.parse(expiration)))
+            return false;
+        if (Date.parse(expiration) <= Date.now())
+            return false;
+        if (!bundleIdentifier)
+            return true;
+        const applicationIdentifier = plistValue(content, "application-identifier");
+        if (!applicationIdentifier)
+            return false;
+        const profileBundle = applicationIdentifier.split(".").slice(1).join(".");
+        return profileBundle === bundleIdentifier || profileBundle === "*";
+    }
+    catch {
+        return false;
+    }
+}
+async function hasValidProvisioningProfile(root, bundleIdentifier) {
+    const files = provisioningProfileFiles();
+    for (const file of files) {
+        if (await validProvisioningProfile(file, root, bundleIdentifier))
+            return true;
+    }
+    return false;
+}
+async function probeProject(root, context, profile) {
+    if (!context.path || !context.scheme || !commandExists("xcodebuild"))
+        return context;
+    const configuration = profile.ios?.configuration ?? "Release";
+    const settings = await captureProcess("xcodebuild", [
+        context.flag,
+        context.path,
+        "-scheme",
+        context.scheme,
+        "-configuration",
+        configuration,
+        "-showBuildSettings",
+    ], { cwd: root });
+    return { ...context, settings };
+}
+async function probeVersion(command, args, cwd) {
+    if (!commandExists(command))
+        return undefined;
+    try {
+        const result = await captureProcess(command, args, { cwd });
+        if (result.code !== 0)
+            return undefined;
+        return commandOutput(result).split(/\r?\n/)[0]?.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+async function probeCommand(command, args, cwd) {
+    if (!commandExists(command))
+        return false;
+    try {
+        return (await captureProcess(command, args, { cwd })).code === 0;
+    }
+    catch {
+        return false;
+    }
+}
+export async function inspectIosToolchain(root, profile) {
+    const checks = [];
+    const isMac = platform() === "darwin";
+    const host = findHost(root, profile);
+    const hostExists = Boolean(host && existsSync(host));
+    const scheme = profile.ios?.scheme;
+    const exportOptions = profile.ios?.exportOptionsPlist
+        ? resolve(root, profile.ios.exportOptionsPlist)
+        : undefined;
+    checks.push(check("ios-platform", isMac ? "pass" : "fail", isMac ? "macOS" : `${platform()} · macOS is required for an IPA`, isMac
+        ? undefined
+        : "Run the iOS build on a macOS machine or macOS CI runner"));
+    if (!isMac) {
+        checks.push(check("ios-host", "warn", hostExists
+            ? "host found but not inspectable on this OS"
+            : "not inspected"));
+        return {
+            ok: checks.every((item) => item.status !== "fail"),
+            checks,
+            project: host,
+            scheme,
+            automaticSigning: false,
+        };
+    }
+    const developerDirectory = await probeVersion("xcode-select", ["-p"], root);
+    checks.push(check("xcode-select", developerDirectory ? "pass" : "fail", developerDirectory ?? "no active Xcode developer directory", developerDirectory
+        ? undefined
+        : "sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer"));
+    const xcodeVersion = await probeVersion("xcodebuild", ["-version"], root);
+    checks.push(check("xcode", xcodeVersion ? "pass" : "fail", xcodeVersion ?? "xcodebuild unavailable", xcodeVersion
+        ? undefined
+        : "Install Xcode, open it once, accept its license, then run xcode-select --install if needed"));
+    checks.push(check("xcrun", commandExists("xcrun") ? "pass" : "fail", commandExists("xcrun") ? "available" : "missing", commandExists("xcrun")
+        ? undefined
+        : "Install Xcode and select its command-line tools"));
+    checks.push(check("codesign", commandExists("codesign") ? "pass" : "fail", commandExists("codesign") ? "available" : "missing", commandExists("codesign")
+        ? undefined
+        : "Install Xcode command-line tools"));
+    checks.push(check("unzip", commandExists("unzip") ? "pass" : "fail", commandExists("unzip") ? "available" : "missing", commandExists("unzip")
+        ? undefined
+        : "Install the macOS command-line tools"));
+    checks.push(check("ios-host", hostExists ? "pass" : "fail", hostExists ? host : "Xcode project or workspace not found", hostExists
+        ? undefined
+        : "lynxship ios host init --bundle-identifier com.example.myapp"));
+    checks.push(check("ios-scheme", scheme ? "pass" : "fail", scheme ?? "missing from the production build profile", scheme ? undefined : "Set build.production.ios.scheme in lynxship.json"));
+    const context = await probeProject(root, {
+        path: hostExists ? host : undefined,
+        flag: host ? projectFlag(host) : "-project",
+        scheme,
+    }, profile);
+    const settingsOutput = context.settings
+        ? commandOutput(context.settings)
+        : "";
+    checks.push(check("xcode-project-settings", !context.settings
+        ? "warn"
+        : context.settings.code === 0
+            ? "pass"
+            : "fail", !context.settings
+        ? "not inspected until host and scheme are configured"
+        : context.settings.code === 0
+            ? "scheme and configuration load successfully"
+            : "xcodebuild could not load the selected scheme", context.settings?.code === 0 || !context.settings
+        ? undefined
+        : "Open the project in Xcode and verify the scheme is shared and buildable"));
+    const automaticSigning = setting(settingsOutput, "CODE_SIGN_STYLE") === "Automatic";
+    const team = setting(settingsOutput, "DEVELOPMENT_TEAM");
+    checks.push(check("apple-team", context.settings?.code !== 0 || !context.settings
+        ? "warn"
+        : team
+            ? "pass"
+            : "fail", team ?? "team not resolved from Xcode build settings", team
+        ? undefined
+        : "Select the Apple Developer Team in Xcode Signing & Capabilities"));
+    const distribution = profile.distribution ?? profile.ios?.distribution ?? "store";
+    const identityResult = await (commandExists("security")
+        ? captureProcess("security", ["find-identity", "-v", "-p", "codesigning"], {
+            cwd: root,
+        })
+        : undefined);
+    const identityOutput = identityResult ? commandOutput(identityResult) : "";
+    const identityCount = Number(identityOutput.match(/(\d+) valid identities found/)?.[1] ?? 0);
+    const requiredIdentity = distribution === "store" ? "Apple Distribution" : "Apple Development";
+    checks.push(check("apple-signing-identity", identityCount === 0 || !identityOutput.includes(requiredIdentity)
+        ? "fail"
+        : "pass", identityCount === 0
+        ? "no valid code-signing identity found"
+        : identityOutput.includes(requiredIdentity)
+            ? `${requiredIdentity} identity available`
+            : `${requiredIdentity} identity not found`, identityCount > 0 && identityOutput.includes(requiredIdentity)
+        ? undefined
+        : "Install or select the Apple certificate in Xcode Settings > Accounts, then rerun doctor"));
+    const podfile = join(root, "ios", "Podfile");
+    const podRequired = existsSync(podfile);
+    const podVersion = podRequired
+        ? await probeVersion("pod", ["--version"], root)
+        : undefined;
+    checks.push(check("cocoapods", !podRequired || podVersion ? "pass" : "fail", !podRequired
+        ? "not required · no ios/Podfile"
+        : (podVersion ?? "Podfile found but pod is unavailable"), !podRequired || podVersion
+        ? undefined
+        : "gem install cocoapods, then run pod install in the project"));
+    let exportOptionsContent;
+    if (exportOptions && existsSync(exportOptions)) {
+        try {
+            exportOptionsContent = readFileSync(exportOptions, "utf8");
+        }
+        catch {
+            exportOptionsContent = undefined;
+        }
+    }
+    const exportMethod = exportOptionsContent?.match(/<key>method<\/key>\s*<string>([^<]+)<\/string>/)?.[1];
+    const supportedExportMethods = new Set([
+        "app-store",
+        "ad-hoc",
+        "development",
+        "enterprise",
+    ]);
+    checks.push(check("export-options", !exportOptions
+        ? "fail"
+        : !existsSync(exportOptions)
+            ? "fail"
+            : !exportMethod || !supportedExportMethods.has(exportMethod)
+                ? "fail"
+                : "pass", !exportOptions
+        ? "missing from the production build profile"
+        : !existsSync(exportOptions)
+            ? `${exportOptions} not found`
+            : exportMethod && supportedExportMethods.has(exportMethod)
+                ? `method: ${exportMethod}`
+                : "method missing or invalid for an iOS export", exportOptions &&
+        existsSync(exportOptions) &&
+        exportMethod &&
+        supportedExportMethods.has(exportMethod)
+        ? undefined
+        : "Set build.production.ios.exportOptionsPlist to a valid ExportOptions.plist"));
+    const manualProvisioning = setting(settingsOutput, "CODE_SIGN_STYLE") === "Manual" ||
+        exportOptionsContent?.includes("<key>provisioningProfiles</key>") === true;
+    const profilesAvailable = await hasValidProvisioningProfile(root, setting(settingsOutput, "PRODUCT_BUNDLE_IDENTIFIER"));
+    checks.push(check("ios-provisioning", manualProvisioning && !profilesAvailable
+        ? "fail"
+        : automaticSigning && !profilesAvailable
+            ? "warn"
+            : "pass", manualProvisioning && !profilesAvailable
+        ? "manual signing selected but no local provisioning profile was found"
+        : automaticSigning && !profilesAvailable
+            ? "Xcode-managed provisioning will be requested during the build"
+            : profilesAvailable
+                ? "local provisioning profile available"
+                : "not required by the detected signing mode", manualProvisioning && !profilesAvailable
+        ? "Download a matching .mobileprovision/.provisionprofile from Apple Developer and install it in Xcode"
+        : undefined));
+    const simctlAvailable = await probeCommand("xcrun", ["--find", "simctl"], root);
+    const devicectlAvailable = await probeCommand("xcrun", ["--find", "devicectl"], root);
+    checks.push(check("ios-device-tools", simctlAvailable || devicectlAvailable ? "pass" : "warn", simctlAvailable && devicectlAvailable
+        ? "simctl and devicectl available"
+        : simctlAvailable
+            ? "simctl available · devicectl unavailable"
+            : devicectlAvailable
+                ? "devicectl available · simctl unavailable"
+                : "simctl and devicectl unavailable", simctlAvailable || devicectlAvailable
+        ? undefined
+        : "Install the full Xcode toolchain, then rerun lynxship doctor --platform ios"));
+    const failures = checks.filter((item) => item.status === "fail");
+    return {
+        ok: failures.length === 0,
+        checks,
+        project: host,
+        scheme,
+        automaticSigning,
+    };
+}
+export function formatIosToolchainFailure(report) {
+    return report.checks
+        .filter((item) => item.status === "fail")
+        .map((item) => `${item.name}: ${item.value}${item.fix ? ` · fix: ${item.fix}` : ""}`)
+        .join("; ");
+}

package/dist/lynx-devtool.d.ts

@@ -0,0 +1,18 @@
+import type { Platform } from "@lynxship/contracts";
+export type DevToolCheckStatus = "pass" | "warn" | "fail";
+export interface DevToolCheck {
+    name: string;
+    status: DevToolCheckStatus;
+    value: string;
+    fix?: string;
+}
+export interface LynxDevToolStatus {
+    platform: Platform;
+    checks: DevToolCheck[];
+    ok: boolean;
+    traceReady: boolean;
+    recorderReady: boolean;
+}
+export declare function inspectLynxDevTool(root: string, platform: Platform): Promise<LynxDevToolStatus>;
+export declare function formatDevToolFailure(status: LynxDevToolStatus): string;
+//# sourceMappingURL=lynx-devtool.d.ts.map

package/dist/lynx-devtool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lynx-devtool.d.ts","sourceRoot":"","sources":["../src/lynx-devtool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;CACxB;AAoDD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,iBAAiB,CAAC,CA4K5B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAQtE"}

package/dist/lynx-devtool.js

@@ -0,0 +1,125 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { commandExists } from "./process-runner.js";
+async function readPackageJson(root) {
+    try {
+        return JSON.parse(await readFile(join(root, "package.json"), "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+function dependencyVersion(packageJson, packageName) {
+    return (packageJson.dependencies?.[packageName] ??
+        packageJson.devDependencies?.[packageName]);
+}
+function hasDevVersion(text) {
+    return /(?:^|[^\w])(?:["']?\d[^\s"']*-dev|version\s*[=:]\s*["']?\d[^\s"']*-dev)/i.test(text);
+}
+function hasPackageMarker(text, packageName) {
+    return text.includes(packageName);
+}
+async function readIfExists(file) {
+    if (!existsSync(file))
+        return "";
+    return readFile(file, "utf8").catch(() => "");
+}
+function check(name, status, value, fix) {
+    return { name, status, value, ...(fix ? { fix } : {}) };
+}
+export async function inspectLynxDevTool(root, platform) {
+    const packageJson = await readPackageJson(root);
+    const checks = [];
+    const hasDevScript = Boolean(packageJson.scripts?.dev);
+    checks.push(check("rspeedy-dev", hasDevScript ? "pass" : "fail", hasDevScript
+        ? "package.json dev script found"
+        : "missing package.json dev script", hasDevScript
+        ? undefined
+        : "add a project dev script that runs rspeedy dev"));
+    const rspeedy = dependencyVersion(packageJson, "@lynx-js/rspeedy");
+    checks.push(check("rspeedy", rspeedy ? "pass" : "fail", rspeedy ? `configured · ${rspeedy}` : "@lynx-js/rspeedy is not declared", rspeedy
+        ? undefined
+        : "install the project’s pinned @lynx-js/rspeedy version"));
+    const devtoolPath = process.env.LYNXSHIP_DEVTOOL_PATH;
+    const desktopAvailable = Boolean(devtoolPath && existsSync(devtoolPath));
+    checks.push(check("lynx-devtool-desktop", desktopAvailable ? "pass" : "warn", desktopAvailable
+        ? `configured · ${devtoolPath}`
+        : "Desktop application not registered in LYNXSHIP_DEVTOOL_PATH", desktopAvailable
+        ? undefined
+        : "install Lynx DevTool Desktop, then optionally set LYNXSHIP_DEVTOOL_PATH"));
+    if (platform === "android") {
+        const settings = await readIfExists(join(root, "android", "settings.gradle"));
+        const settingsKts = await readIfExists(join(root, "android", "settings.gradle.kts"));
+        const app = await readIfExists(join(root, "android", "app", "build.gradle"));
+        const appKts = await readIfExists(join(root, "android", "app", "build.gradle.kts"));
+        const hostText = `${settings}\n${settingsKts}\n${app}\n${appKts}`;
+        const hostExists = Boolean(settings || settingsKts || app || appKts);
+        const hasTrace = hasPackageMarker(hostText, "lynx-trace");
+        const hasDevTool = hasPackageMarker(hostText, "lynx-devtool");
+        const devRuntime = hasDevVersion(hostText);
+        checks.push(check("android-host", hostExists ? "pass" : "warn", hostExists
+            ? "Gradle host detected"
+            : "no Android host; Lynx Explorer remains available through dev", hostExists
+            ? undefined
+            : "run lynxship android host init --application-id <id> for a native host"));
+        checks.push(check("android-trace-runtime", hasTrace && devRuntime ? "pass" : hasTrace ? "warn" : "fail", hasTrace
+            ? devRuntime
+                ? "lynx-trace and -dev runtime detected"
+                : "lynx-trace is present but no -dev Lynx dependency was detected"
+            : "lynx-trace dependency not detected", hasTrace && devRuntime
+            ? undefined
+            : "use the matching Lynx -dev, lynx-trace -dev and lynx-devtool dependencies"));
+        checks.push(check("android-devtool-runtime", hasDevTool && devRuntime ? "pass" : hasDevTool ? "warn" : "fail", hasDevTool
+            ? devRuntime
+                ? "lynx-devtool and -dev runtime detected"
+                : "lynx-devtool is present but no -dev Lynx dependency was detected"
+            : "lynx-devtool dependency not detected", hasDevTool && devRuntime
+            ? undefined
+            : "integrate the matching Lynx DevTool development dependencies"));
+        if (!commandExists("adb"))
+            checks.push(check("android-debug-transport", "warn", "adb not found; USB device discovery is unavailable", "install Android SDK Platform-Tools and connect a device"));
+    }
+    else {
+        const podfile = await readIfExists(join(root, "ios", "Podfile"));
+        const hostExists = Boolean(podfile);
+        const hasTrace = hasPackageMarker(podfile, "LynxTrace");
+        const hasDevTool = hasPackageMarker(podfile, "LynxDevtool");
+        const devRuntime = hasDevVersion(podfile);
+        checks.push(check("ios-host", hostExists ? "pass" : "warn", hostExists
+            ? "CocoaPods host detected"
+            : "no iOS host; Lynx Explorer remains available through dev", hostExists
+            ? undefined
+            : "run lynxship ios host init --bundle-identifier <id> on macOS"));
+        checks.push(check("ios-trace-runtime", hasTrace && devRuntime ? "pass" : hasTrace ? "warn" : "fail", hasTrace
+            ? devRuntime
+                ? "LynxTrace and -dev runtime detected"
+                : "LynxTrace is present but no -dev Lynx dependency was detected"
+            : "LynxTrace dependency not detected", hasTrace && devRuntime
+            ? undefined
+            : "use the matching Lynx -dev and LynxTrace -dev pods"));
+        checks.push(check("ios-devtool-runtime", hasDevTool && devRuntime ? "pass" : hasDevTool ? "warn" : "fail", hasDevTool
+            ? devRuntime
+                ? "LynxDevtool and -dev runtime detected"
+                : "LynxDevtool is present but no -dev Lynx dependency was detected"
+            : "LynxDevtool dependency not detected", hasDevTool && devRuntime
+            ? undefined
+            : "integrate the matching Lynx DevTool development pods"));
+    }
+    const traceReady = checks.every((item) => !["android-trace-runtime", "ios-trace-runtime"].includes(item.name) ||
+        item.status === "pass");
+    const recorderReady = traceReady;
+    return {
+        platform,
+        checks,
+        ok: checks.every((item) => item.status !== "fail"),
+        traceReady,
+        recorderReady,
+    };
+}
+export function formatDevToolFailure(status) {
+    return status.checks
+        .filter((item) => item.status === "fail")
+        .map((item) => `${item.name}: ${item.value}${item.fix ? ` · fix: ${item.fix}` : ""}`)
+        .join("; ");
+}

package/dist/process-runner.d.ts

@@ -4,6 +4,12 @@ export interface ProcessOptions {
     quiet?: boolean;
     onOutput?: (line: string) => void;
 }
+export interface CapturedProcessResult {
+    code: number;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+}
 export declare function packageManagerCommand(root: string): {
     command: string;
     prefix: string[];
@@ -13,6 +19,11 @@ export declare function packageManagerScriptCommand(root: string, script: string
     args: string[];
 };
 export declare function runProcess(command: string, args: string[], options: ProcessOptions): Promise<void>;
+/**
+ * Run a small probe without printing it as a build event. Non-zero exit codes
+ * are returned to the caller because probes are expected to test availability.
+ */
+export declare function captureProcess(command: string, args: string[], options: Pick<ProcessOptions, "cwd" | "env">): Promise<CapturedProcessResult>;
 export declare function runRspeedy(root: string, subcommand: string, args: string[], options: Omit<ProcessOptions, "cwd">): Promise<void>;
 export declare function commandExists(command: string): boolean;
 export declare function executableExists(file: string): boolean;

package/dist/process-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-runner.d.ts","sourceRoot":"","sources":["../src/process-runner.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAcA;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAGrC;AAsBD,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA4BtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUtD"}
+{"version":3,"file":"process-runner.d.ts","sourceRoot":"","sources":["../src/process-runner.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAcA;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAGrC;AAsBD,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,KAAK,CAAC,GAC3C,OAAO,CAAC,qBAAqB,CAAC,CAkChC;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA4BtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUtD"}

package/dist/process-runner.js

@@ -91,6 +91,35 @@ export function runProcess(command, args, options) {
         });
     });
 }
+/**
+ * Run a small probe without printing it as a build event. Non-zero exit codes
+ * are returned to the caller because probes are expected to test availability.
+ */
+export function captureProcess(command, args, options) {
+    const windowsCommand = process.platform === "win32" && /\.(?:bat|cmd)$/i.test(command);
+    const commandLine = [command, ...args]
+        .map((value) => /[\s"]/.test(value) ? `"${value.replaceAll('"', '\\"')}"` : value)
+        .join(" ");
+    return new Promise((resolve, reject) => {
+        const child = spawn(windowsCommand ? "cmd.exe" : command, windowsCommand ? ["/d", "/s", "/c", commandLine] : args, {
+            cwd: options.cwd,
+            env: options.env ?? process.env,
+            shell: false,
+            stdio: ["ignore", "pipe", "pipe"],
+            windowsHide: true,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.once("error", reject);
+        child.once("close", (code, signal) => resolve({ code: code ?? 1, signal, stdout, stderr }));
+    });
+}
 export async function runRspeedy(root, subcommand, args, options) {
     const manager = packageManagerCommand(root);
     await runProcess(manager.command, [...manager.prefix, "rspeedy", subcommand, ...args], { ...options, cwd: root });

package/dist/prompt.d.ts

@@ -1,3 +1,4 @@
 export declare function prompt(label: string, defaultValue?: string): Promise<string>;
+export declare function confirm(label: string, defaultValue?: boolean): Promise<boolean>;
 export declare function secret(label: string): Promise<string>;
 //# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAGA,wBAAsB,MAAM,CAC1B,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2C3D"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAGA,wBAAsB,MAAM,CAC1B,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,EACb,YAAY,UAAQ,GACnB,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2C3D"}

package/dist/prompt.js

@@ -14,6 +14,12 @@ export async function prompt(label, defaultValue) {
         readline.close();
     }
 }
+export async function confirm(label, defaultValue = false) {
+    const answer = await prompt(`${label} ${defaultValue ? "[Y/n]" : "[y/N]"}`);
+    if (!answer)
+        return defaultValue;
+    return ["y", "yes", "oui", "o"].includes(answer.toLowerCase());
+}
 export async function secret(label) {
     if (!process.stdin.isTTY || !process.stdin.setRawMode)
         throw new Error("Secret input requires an interactive terminal; use environment variables in CI");

package/dist/remote.d.ts

@@ -1,4 +1,4 @@
-import type { BuildJob } from "@lynxship/contracts";
+import type { BuildJob, Platform } from "@lynxship/contracts";
 import type { LynxShipConfig } from "./config.js";
 export interface RemoteCliState {
     remoteOrganizationId?: string;
@@ -8,7 +8,7 @@ export interface OtaPublishRequest {
     projectId: string;
     organizationId: string;
     channel: string;
-    platform: "android" | "ios";
+    platform: Platform;
     runtimeVersion: string;
     assets: Array<{
         path: string;
@@ -23,7 +23,7 @@ export interface OtaPublishRequest {
 export interface OtaRollbackRequest {
     projectId: string;
     channel: string;
-    platform: "android" | "ios";
+    platform: Platform;
     releaseId: string;
     reason: string;
 }

package/dist/remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAsCD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAmDxD;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,OAAO,CAAC,CAoDlB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ/C"}
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAsCD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAmDxD;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,OAAO,CAAC,CAoDlB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ/C"}

package/dist/target-toolchain.d.ts

@@ -0,0 +1,17 @@
+import type { BuildProfile } from "./config.js";
+export type TargetCheckStatus = "pass" | "warn" | "fail";
+export interface TargetCheck {
+    name: string;
+    status: TargetCheckStatus;
+    ok: boolean;
+    value: string;
+    fix?: string;
+}
+export interface TargetToolchainReport {
+    ok: boolean;
+    checks: TargetCheck[];
+}
+export declare function inspectWebTarget(root: string, profile: BuildProfile): Promise<TargetToolchainReport>;
+export declare function inspectHarmonyTarget(root: string, profile: BuildProfile): Promise<TargetToolchainReport>;
+export declare function inspectDesktopTarget(root: string, profile?: BuildProfile): Promise<TargetToolchainReport>;
+//# sourceMappingURL=target-toolchain.d.ts.map

package/dist/target-toolchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-toolchain.d.ts","sourceRoot":"","sources":["../src/target-toolchain.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAoCD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,qBAAqB,CAAC,CAsChC;AA2BD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,qBAAqB,CAAC,CAmDhC;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,qBAAqB,CAAC,CAwDhC"}