@lynxship/cli 0.1.19 → 0.1.21

package/dist/commands/help.js

@@ -0,0 +1,118 @@
+export function helpText() {
+    return `lynxship <command> [options]
+
+Commands:
+  init                    Initialize or link a LynxShip project
+  doctor                  Check the local toolchain and project
+  dev                     Run Rspeedy dev with Lynx Explorer QR/HMR
+  preview                 Preview the production Lynx bundle locally
+  inspect                 Inspect Rspeedy/Rspack configuration
+  profile                 Build with Rspack profiling enabled
+  devtool doctor          Check Lynx DevTool integration and dev runtime
+  trace doctor            Check Lynx Trace prerequisites
+  recorder doctor         Check Lynx Recorder prerequisites
+  plugin list             List project plugins and their capabilities
+  plugin doctor            Validate plugin packages without modifying native files
+  plugin apply             Apply project plugin native changes for a platform
+  plugin apply --dry-run   Preview plugin native changes without writing files
+  ecosystem               Show first-party LynxShip package capabilities
+  i18n setup               Install and wire i18next, Intl polyfills and locale persistence
+  autolink check          Check Lynx native-library Autolink wiring
+  autolink codegen        Run the project's Native Module codegen script
+  ota doctor              Check native OTA host integration
+  run                     Install an artifact on an Android/iOS/HarmonyOS target
+  logs                    Stream Android/iOS/HarmonyOS native logs
+  build create            Create a local/cloud build job
+  build list              List build jobs
+  build status <id>       Show one build job (add --remote for hosted builds)
+  build cancel <id>       Cancel a build job (add --remote for hosted builds)
+  build retry <id>        Retry a failed build job (add --remote for hosted builds)
+  build all               Build Android, iOS, HarmonyOS, Web and Desktop
+  submit                  Submit the latest successful build
+  update                  Upload and publish a signed OTA update
+  update rollback         Roll back an OTA channel to a previous release
+  rollback                Alias for update rollback
+  self-host init          Generate local self-host credentials
+  storage configure       Configure Cloudflare R2 and encrypted R2 credentials
+  android host init       Create a minimal official Lynx Android host
+  ios host init           Create a minimal official Lynx iOS/Xcode host
+  android configure       Configure or generate encrypted Android signing credentials
+  store configure         Configure Google Play or App Store Connect submission
+
+Build options:
+  --platform <p>          Target android, ios, harmony, web, desktop or all (default: android)
+  --profile <name>        Build profile (default: production; simulator uses simulator)
+  --no-wait               Queue the build without executing it locally
+  --remote                Upload a verified source snapshot and queue a hosted build
+  --no-upload              Keep the artifact local and skip R2 (CI verification)
+  --simulator             Build and install an iOS Simulator .app locally
+  --device <id>           Select the iOS Simulator device for a simulator build
+  --autostart              Open and launch the iOS Simulator app after install
+  --no-autostart           Install the Simulator app without launching it
+  --allow-unsigned         Allow an unsigned Desktop artifact only with --no-upload (local tests)
+  --local                 Use the contract-only build path for tests
+
+Submit options:
+  --platform <p>          Target android or ios (default: android)
+  --latest                Submit the latest successful build
+  --local                 Use the mock submission provider for tests
+
+Update options:
+  --platform <p>          Target android or ios (default: android)
+  --bundle <path[,path]>  Lynx bundle/assets (default: discover dist/*.lynx.bundle)
+  --message <text>        Release message
+  --local                 Create a local contract-only update for tests
+  --policy-approval-id    Required for an iOS OTA release
+
+Rollback options:
+  --platform <p>          Target android or ios (default: android)
+  --release-id <id>       Previously published compatible release
+  --reason <text>         Required audit reason for the rollback
+  --local                 Roll back local contract state for tests
+
+Device and diagnostics options:
+  doctor --platform <p>   Check the local toolchain (default: android)
+  doctor --fix            Install missing Android SDK packages after confirmation
+  autolink check --platform <p>
+                          Check native-library wiring (default: android)
+  ota doctor --platform <p>
+                          Check OTA host integration (default: android)
+  run --artifact <path>   Install a specific APK, IPA, app or signed HAP
+  run --device <id>       Select an Android, iOS or HarmonyOS device
+  run --simulator         Install an iOS .app with simctl
+  run --launch             Launch the installed iOS Simulator app after install
+  logs --device <id>      Select the device or simulator for native logs
+
+i18n setup options:
+  --dry-run               Show planned dependencies/files without changing the project
+  --entry <path>          Explicit Lynx entry file when it cannot be detected
+  --intl auto|all|<list>  Detect Intl use, install only required polyfills, or choose explicitly
+  --locales <list>        Comma-separated locale codes for static FormatJS locale data
+  --no-persistence        Do not install the LynxShip device-storage bridge
+
+Global options:
+  --json                  Emit one stable JSON result/error object
+  --quiet                 Print only the final machine-relevant result
+  --verbose               Include extra operational context
+  --no-color              Disable ANSI colors
+  --non-interactive       Never prompt; fail on missing inputs
+  --banner                Show the Braille LynxShip logo in a TTY
+  --project-dir <path>    Use a LynxShip project from any working directory
+  --project-id <id>       Project ID used by init
+  --application-id <id>   Android package/application ID for host init
+  --bundle-identifier <id> iOS bundle identifier for host init
+  --icon <path>            1024x1024 PNG app icon for iOS host init
+  --library-dir <path>    Native library directory for autolink codegen
+  --simulator             Build/install an iOS .app or install one with simctl
+  --help                  Show this complete command reference
+
+Miso compiler profiles:
+  ghcjs (default)        Use the official Miso GHC/Nix workflow
+  microhs                 Use a pinned MicroHs binary and a real adapter command
+
+MicroHs is opt-in. Configure build.<profile>.miso.microhs with either a
+binary path or a pinned manifest, plus an adapter command that writes the
+configured main.lynx.bundle. It is not a drop-in GHCJS replacement.
+
+Node support: Node 22/24 LTS or Node 26 Current. Use Node 24 LTS for production.`;
+}

package/dist/commands/i18n.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/commands/i18n.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,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;QACL,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,KACE,IAAI,CAAC;CACX;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoDf"}

package/dist/commands/i18n.js

@@ -0,0 +1,88 @@
+import { assert } from "@lynxship/contracts";
+import { setupI18n } from "../i18n/setup.js";
+export async function runI18nCommand(context) {
+    const subcommand = context.args.shift() ?? "setup";
+    assert(subcommand === "setup", "CLI_I18N_COMMAND", "Use `lynxship i18n setup`.");
+    const capabilities = parseCapabilities(context.flag("--intl"));
+    const locales = parseList(context.flag("--locales"));
+    const result = await setupI18n({
+        root: context.root,
+        entry: context.flag("--entry") ?? undefined,
+        capabilities,
+        locales,
+        persistence: !context.args.includes("--no-persistence"),
+        dryRun: context.args.includes("--dry-run"),
+        onOutput: (line) => context.ui.debug(line),
+    });
+    context.printValue(result, {
+        title: `LynxShip i18n · ${result.status}`,
+        rows: [
+            { label: "Entry", value: result.entryFile, valueColor: "muted" },
+            {
+                label: "Locales",
+                value: result.locales.join(", "),
+                valueColor: "blue",
+            },
+            {
+                label: "Intl",
+                value: result.capabilities.join(", "),
+                valueColor: "purple",
+            },
+            {
+                label: "Dependencies",
+                value: result.packages.length
+                    ? result.packages.join(", ")
+                    : "already installed",
+                valueColor: result.packages.length ? "yellow" : "green",
+            },
+            {
+                label: "Persistence",
+                value: result.persistence
+                    ? "automatic when host storage is linked"
+                    : "disabled",
+                valueColor: result.persistence ? "green" : "muted",
+            },
+        ],
+        done: result.status === "planned"
+            ? "Dry run complete; no dependency or source file was changed."
+            : "i18n setup is idempotent; rebuild the Lynx bundle after dependency installation.",
+    });
+}
+function parseList(value) {
+    if (!value || value === "auto")
+        return undefined;
+    if (value === "all")
+        return [
+            "PluralRules",
+            "NumberFormat",
+            "DateTimeFormat",
+            "RelativeTimeFormat",
+            "ListFormat",
+            "DisplayNames",
+            "Segmenter",
+            "DurationFormat",
+        ];
+    return value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+function parseCapabilities(value) {
+    const values = parseList(value);
+    if (!values)
+        return undefined;
+    const allowed = new Set([
+        "PluralRules",
+        "NumberFormat",
+        "DateTimeFormat",
+        "RelativeTimeFormat",
+        "ListFormat",
+        "DisplayNames",
+        "Locale",
+        "getCanonicalLocales",
+        "Segmenter",
+        "DurationFormat",
+    ]);
+    assert(values.every((item) => allowed.has(item)), "CLI_I18N_CAPABILITY", `Unknown Intl capability. Use one of: ${[...allowed].join(", ")}`);
+    return values;
+}

package/dist/commands/logs.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/commands/logs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAElE,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CA2Ef"}

package/dist/commands/logs.js

@@ -0,0 +1,51 @@
+import { assert } from "@lynxship/contracts";
+import { commandExists, runProcess } from "../process-runner.js";
+import { platformValue } from "../config.js";
+export async function streamNativeLogs(context) {
+    const platform = platformValue(context.flag("--platform", "android"));
+    const device = context.flag("--device", platform === "ios" ? "booted" : undefined);
+    if (platform === "android") {
+        assert(commandExists("adb"), "ANDROID_ADB_REQUIRED", "adb was not found in PATH");
+        await runProcess("adb", device ? ["-s", device, "logcat"] : ["logcat"], {
+            cwd: context.root,
+            quiet: context.json,
+            onOutput: (line) => context.ui.info(`│ ${line}`),
+        });
+    }
+    else if (platform === "ios") {
+        assert(process.platform === "darwin", "IOS_MACOS_REQUIRED", "iOS logs require macOS");
+        assert(commandExists("xcrun"), "IOS_XCRUN_REQUIRED", "xcrun was not found in PATH");
+        assert(device !== "booted", "IOS_DEVICE_LOGS_UNSUPPORTED", "Use --device <simulator-identifier> for iOS simulator logs.");
+        await runProcess("xcrun", [
+            "simctl",
+            "spawn",
+            device ?? "booted",
+            "log",
+            "stream",
+            "--style",
+            "compact",
+            "--level",
+            "debug",
+        ], {
+            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 streaming logs.");
+        const argsForHdc = device
+            ? ["-t", device, "shell", "hilog"]
+            : ["shell", "hilog"];
+        await runProcess("hdc", argsForHdc, {
+            cwd: context.root,
+            quiet: context.json,
+            onOutput: (line) => context.ui.info(`│ ${line}`),
+        });
+    }
+    else {
+        assert(false, "TARGET_LOGS_UNSUPPORTED", platform === "web"
+            ? "Web logs are emitted by the browser/runtime console; use lynxship dev or the project's Web DevTools."
+            : "Desktop logs are emitted by the packaged runtime; use the target OS logging tools.");
+    }
+}

package/dist/commands/metadata.d.ts

@@ -0,0 +1,3 @@
+export declare function commandTitle(command: string): string;
+export declare function exitCode(error: unknown): number;
+//# sourceMappingURL=metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/commands/metadata.ts"],"names":[],"mappings":"AAyBA,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU/C"}

package/dist/commands/metadata.js

@@ -0,0 +1,45 @@
+const COMMAND_TITLES = {
+    init: "Initialize project",
+    doctor: "Environment doctor",
+    dev: "Rspeedy development",
+    preview: "Rspeedy preview",
+    inspect: "Rspeedy inspection",
+    profile: "Rspeedy profiling",
+    autolink: "Lynx Autolink",
+    run: "Run on device",
+    logs: "Native logs",
+    ota: "OTA diagnostics",
+    build: "Cloud Build",
+    submit: "Store Submission",
+    update: "OTA Update",
+    rollback: "OTA Rollback",
+    "self-host": "Self-host setup",
+    storage: "Cloudflare R2 setup",
+    android: "Android signing setup",
+    store: "App store submission setup",
+    devtool: "Lynx DevTool diagnostics",
+    trace: "Lynx Trace diagnostics",
+    recorder: "Lynx Recorder diagnostics",
+    plugin: "LynxShip plugins",
+};
+export function commandTitle(command) {
+    return COMMAND_TITLES[command] ?? command;
+}
+export function exitCode(error) {
+    const code = error.code;
+    if (code?.startsWith("CLI_") || code?.startsWith("CONFIG_"))
+        return 2;
+    if (code === "BUILD_SIGNING_REQUIRED")
+        return 2;
+    if (code === "DESKTOP_SIGNING_REQUIRED")
+        return 2;
+    if (code?.startsWith("AUTH_"))
+        return 4;
+    if (code?.startsWith("BUILD_"))
+        return 5;
+    if (code?.startsWith("SUBMISSION_"))
+        return 6;
+    if (code?.startsWith("OTA_"))
+        return 7;
+    return 1;
+}

package/dist/commands/ota.d.ts

@@ -0,0 +1,28 @@
+import { type Platform } from "@lynxship/contracts";
+import { type CliState } from "../runtime/state.js";
+import type { BuildOrchestrator } from "@lynxship/build-orchestrator";
+import type { JsonRepository } from "@lynxship/db";
+import type { SubmissionService } from "@lynxship/submit";
+import { type LynxShipConfig } from "../config.js";
+import type { BoxRow, CliUi } from "../ui/index.js";
+export interface OtaCommandContext {
+    root: string;
+    args: string[];
+    ui: CliUi;
+    flag: (name: string, fallback?: string | null) => string | null;
+    printValue: (value: unknown, view?: {
+        title: string;
+        rows: BoxRow[];
+        done: string;
+    }) => void;
+    requireOperationalConfiguration: (platform: Platform) => Promise<void>;
+    requireR2Configuration: () => Promise<void>;
+    configuredProjectId: (config: LynxShipConfig) => string;
+    mobilePlatformValue: (value: string) => "android" | "ios";
+    state: CliState;
+    repository: JsonRepository<CliState>;
+    builds: BuildOrchestrator;
+    submissions: SubmissionService;
+}
+export declare function runOtaCommand(context: OtaCommandContext, command: string): Promise<void>;
+//# sourceMappingURL=ota.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ota.d.ts","sourceRoot":"","sources":["../../src/commands/ota.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAc9E,OAAO,EAA8B,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,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,+BAA+B,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,sBAAsB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,mBAAmB,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IACxD,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,GAAG,KAAK,CAAC;IAC1D,KAAK,EAAE,QAAQ,CAAC;IAChB,UAAU,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA+Pf"}

package/dist/commands/ota.js

@@ -0,0 +1,203 @@
+import { assert, createId, sha256 } from "@lynxship/contracts";
+import { createSigningKey, signManifest } from "@lynxship/signing";
+import { fetchOtaPublicKey, publishOtaRelease, rollbackOtaRelease, } from "../remote.js";
+import { uploadR2Artifact } from "../r2.js";
+import { assertCompatibleBinaryBuild, inspectRuntimeFingerprint, } from "../runtime-fingerprint.js";
+import { otaAssetName, otaAssetPaths } from "../ota-assets.js";
+import { exists } from "../runtime/project.js";
+import { saveState } from "../runtime/state.js";
+import { loadConfig } from "../config.js";
+export async function runOtaCommand(context, command) {
+    const { root, args, ui, flag, printValue, requireOperationalConfiguration, requireR2Configuration, configuredProjectId, mobilePlatformValue, state, repository, builds, submissions, } = context;
+    if (command === "update" && args[0] !== "rollback") {
+        const config = await loadConfig(root);
+        const platform = mobilePlatformValue(flag("--platform", "android"));
+        await requireOperationalConfiguration(platform);
+        const projectId = configuredProjectId(config);
+        const localMode = args.includes("--local") || process.env.LYNXSHIP_SUBMIT_MODE === "mock";
+        const explicitBundles = flag("--bundle");
+        const runtime = await inspectRuntimeFingerprint(root, platform, config);
+        const progress = ui.progress("Sign manifest");
+        try {
+            if (localMode) {
+                const key = state.signingKey ?? createSigningKey();
+                const data = flag("--bundle", "local-bundle");
+                const manifest = {
+                    protocolVersion: 1,
+                    projectId,
+                    channel: config.update?.channel ?? "production",
+                    platform,
+                    runtimeVersion: runtime.value,
+                    sequence: state.releases.length + 1,
+                    keyId: key.keyId,
+                    assets: [
+                        {
+                            path: "main.js",
+                            hash: sha256(data),
+                            size: Buffer.byteLength(data),
+                        },
+                    ],
+                };
+                const release = {
+                    id: createId("rel"),
+                    manifest,
+                    signature: signManifest(manifest, key.privateKey),
+                    message: flag("--message", "local update"),
+                    createdAt: new Date().toISOString(),
+                };
+                state.releases.push(release);
+                await saveState(state, repository, builds, submissions);
+                progress.update(100);
+                printValue(release, {
+                    title: "OTA update published locally",
+                    rows: [
+                        { label: "Release ID", value: release.id, valueColor: "purple" },
+                        {
+                            label: "Platform",
+                            value: release.manifest.platform,
+                            valueColor: "blue",
+                        },
+                        {
+                            label: "Signature",
+                            value: "Ed25519 signed",
+                            valueColor: "muted",
+                        },
+                    ],
+                    done: "Local update created. Use a real API and bundle for devices.",
+                });
+                return;
+            }
+            const bundlePaths = await otaAssetPaths(root, explicitBundles);
+            for (const bundlePath of bundlePaths)
+                assert(await exists(bundlePath), "OTA_BUNDLE_REQUIRED", `Bundle not found: ${bundlePath}. Build the Lynx bundle first or pass --bundle.`);
+            assertCompatibleBinaryBuild(builds, platform, runtime.value);
+            const releaseId = createId("ota");
+            progress.update(25, `Uploading ${bundlePaths.length} Lynx asset(s) to Cloudflare R2…`);
+            const uploadedAssets = [];
+            for (const [index, bundlePath] of bundlePaths.entries()) {
+                const uploaded = await uploadR2Artifact(root, projectId, releaseId, bundlePath, "application/octet-stream", otaAssetName(root, bundlePath));
+                uploadedAssets.push({
+                    path: otaAssetName(root, bundlePath),
+                    hash: uploaded.hash,
+                    size: uploaded.size,
+                    url: uploaded.url,
+                });
+                progress.update(25 + Math.round(((index + 1) / bundlePaths.length) * 35), `Uploaded ${index + 1}/${bundlePaths.length} Lynx asset(s)…`);
+            }
+            progress.update(65, "Publishing signed OTA release through LynxShip API…");
+            const remoteRelease = (await publishOtaRelease(config, state, {
+                projectId,
+                organizationId: "local_org",
+                channel: config.update?.channel ?? "production",
+                platform,
+                runtimeVersion: runtime.value,
+                assets: uploadedAssets,
+                message: flag("--message", "OTA update"),
+                rollout: config.update?.rollout?.defaultPercentage ?? 100,
+                policyApprovalId: flag("--policy-approval-id"),
+            }));
+            const publicKey = await fetchOtaPublicKey(config);
+            state.releases.push(remoteRelease);
+            await saveState(state, repository, builds, submissions);
+            progress.update(100, "OTA release signed and published");
+            printValue({ ...remoteRelease, signingKey: publicKey }, {
+                title: "OTA update published",
+                rows: [
+                    {
+                        label: "Release ID",
+                        value: remoteRelease.id,
+                        valueColor: "purple",
+                    },
+                    {
+                        label: "Platform",
+                        value: remoteRelease.manifest.platform,
+                        valueColor: "blue",
+                    },
+                    { label: "Bundle", value: "Cloudflare R2", valueColor: "orange" },
+                    {
+                        label: "Signature",
+                        value: "Ed25519 signed by API",
+                        valueColor: "green",
+                    },
+                ],
+                done: "Devices can check and install this compatible OTA release.",
+            });
+        }
+        finally {
+            progress.stop();
+        }
+        return;
+    }
+    if (command === "rollback" ||
+        (command === "update" && args[0] === "rollback")) {
+        if (command === "update")
+            args.shift();
+        const config = await loadConfig(root);
+        const platform = mobilePlatformValue(flag("--platform", "android"));
+        const releaseId = flag("--release-id");
+        const reason = flag("--reason");
+        const channel = config.update?.channel ?? "production";
+        const localMode = args.includes("--local");
+        assert(Boolean(releaseId && releaseId !== "true"), "ROLLBACK_RELEASE_REQUIRED", "Pass the release to restore with `--release-id <id>`.");
+        assert(Boolean(reason?.trim()) && reason !== "true", "ROLLBACK_REASON_REQUIRED", 'Pass an audit reason with `--reason "..."`.');
+        await requireR2Configuration();
+        const progress = ui.progress("OTA rollback");
+        try {
+            progress.update(10, `Selecting ${releaseId} for ${channel}…`);
+            if (localMode) {
+                const release = state.releases.find((candidate) => candidate.id === releaseId &&
+                    candidate.manifest.channel === channel &&
+                    candidate.manifest.platform === platform);
+                assert(release, "RELEASE_NOT_FOUND", `Local release ${releaseId} was not found in channel ${channel} for ${platform}.`);
+                state.lastRollback = {
+                    releaseId: release.id,
+                    reason: reason,
+                    at: new Date().toISOString(),
+                };
+                await saveState(state, repository, builds, submissions);
+                progress.update(100, "Local OTA channel rolled back");
+                printValue({ status: "rolled_back", release, rollback: state.lastRollback }, {
+                    title: "OTA rollback",
+                    rows: [
+                        { label: "Release ID", value: release.id, valueColor: "purple" },
+                        { label: "Platform", value: platform, valueColor: "blue" },
+                        { label: "Channel", value: channel, valueColor: "orange" },
+                        { label: "Reason", value: reason, valueColor: "muted" },
+                    ],
+                    done: "Local OTA channel now points to the selected release.",
+                });
+                return;
+            }
+            progress.update(45, "Requesting rollback through LynxShip API…");
+            const release = (await rollbackOtaRelease(config, state, {
+                projectId: configuredProjectId(config),
+                channel,
+                platform,
+                releaseId: releaseId,
+                reason: reason,
+            }));
+            state.lastRollback = {
+                releaseId: release.id,
+                reason: reason,
+                at: new Date().toISOString(),
+            };
+            await saveState(state, repository, builds, submissions);
+            progress.update(100, "OTA channel rolled back");
+            printValue({ status: "rolled_back", release, rollback: state.lastRollback }, {
+                title: "OTA rollback",
+                rows: [
+                    { label: "Release ID", value: release.id, valueColor: "purple" },
+                    { label: "Platform", value: platform, valueColor: "blue" },
+                    { label: "Channel", value: channel, valueColor: "orange" },
+                    { label: "Reason", value: reason, valueColor: "muted" },
+                ],
+                done: "Devices will receive the selected compatible release on their next OTA check.",
+            });
+        }
+        finally {
+            progress.stop();
+        }
+        return;
+    }
+    assert(command === "build", "CLI_COMMAND", `Unknown command: ${command}`);
+}

package/dist/commands/project.d.ts

@@ -0,0 +1,14 @@
+import { type Platform } from "@lynxship/contracts";
+import { type LynxShipConfig } from "../config.js";
+import type { CliUi } from "../ui/index.js";
+export interface ProjectCommandContext {
+    root: string;
+    ui: CliUi;
+    flag: (name: string, fallback?: string | null) => string | null;
+    prompt: (label: string, fallback: string) => Promise<string>;
+}
+export declare function looksLikeLynxProject(context: ProjectCommandContext): Promise<boolean>;
+export declare function initializeProject(context: ProjectCommandContext): Promise<string>;
+export declare function initializeBuildProject(context: ProjectCommandContext): Promise<void>;
+export declare function ensureNativeHostForBuild(context: ProjectCommandContext, platform: Platform, profile: string, config: LynxShipConfig): Promise<void>;
+//# sourceMappingURL=project.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/commands/project.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAe5D,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAG5C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;IAChE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9D;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC,CA2ClB;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CA0Gf"}