@lynxship/cli 0.1.18 → 0.1.20

package/README.md

@@ -90,11 +90,50 @@ pnpm --filter @octanejs/rspeedy-plugin exec rspeedy dev \
   --root examples/gallery --environment lynx
 ```
 
-Miso uses the official Haskell/Nix flake rather than an npm build script.
-Install Nix and the project's Haskell toolchain, then let LynxShip use the
-flake's `default`/`bundle` output or configure a project-specific output in
-`lynxship.json`. Miso remains experimental; a successful bundle does not
-prove a signed Android or iOS production build.
+Miso uses the official Haskell/Nix flake rather than an npm build script by
+default. Install Nix and the project's Haskell toolchain, then let LynxShip
+use the flake's `default`/`bundle` output or configure a project-specific
+output in `lynxship.json`. Miso remains experimental; a successful bundle
+does not prove a signed Android or iOS production build.
+
+MicroHs is an explicit, experimental toolchain path. It is not silently
+selected and it is not a drop-in GHCJS replacement: the project must provide
+a real adapter command that understands the Miso/MicroHs compatibility layer
+and writes the configured Lynx bundle. The acquisition layer accepts either a
+local binary or a project-owned HTTPS manifest with a SHA-256 digest and,
+optionally, an Ed25519 signature:
+
+```json
+{
+  "build": {
+    "development": {
+      "miso": {
+        "compiler": "microhs",
+        "artifact": "result/main.lynx.bundle",
+        "microhs": {
+          "version": "0.16.6.0",
+          "manifest": "toolchains/microhs-manifest.json",
+          "publicKey": "-----BEGIN PUBLIC KEY-----\\n...\\n-----END PUBLIC KEY-----",
+          "adapter": {
+            "command": "node",
+            "args": ["tools/miso-microhs-adapter.mjs"]
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+The manifest must contain an artifact for the current host (`darwin-arm64`,
+`darwin-x64`, `linux-arm64`, `linux-x64` or `win32-x64`). LynxShip downloads
+it to a user cache, verifies the digest before making it executable, and
+never treats the host architecture as the Android/iOS packaging target. A
+local binary can be used for development with
+`build.<profile>.miso.microhs.binary`. The official MicroHs repository does
+not currently publish a verified release fleet, so LynxShip does not invent
+download URLs; teams must own and pin the manifest or keep using the official
+GHCJS/Nix path.
 
 See the source-verified fixture notes in the repository's
 `examples/lynx-octane-fixture` and `examples/miso-lynx-fixture` directories,

package/dist/bundle-build.d.ts

@@ -5,8 +5,21 @@ export interface BundleBuildOptions {
     script?: string;
     rspeedyArgs?: string[];
     miso?: {
+        compiler?: "ghcjs" | "microhs";
         attribute?: string;
         artifact?: string;
+        microhs?: {
+            version?: string;
+            binary?: string;
+            manifest?: string;
+            manifestUrl?: string;
+            cacheDir?: string;
+            publicKey?: string;
+            adapter?: {
+                command: string;
+                args?: string[];
+            };
+        };
     };
 }
 export declare function resolveMisoBuildTarget(flake: string, configuredAttribute?: string): string | undefined;

package/dist/bundle-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle-build.d.ts","sourceRoot":"","sources":["../src/bundle-build.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,mBAAmB,CAAC,EAAE,MAAM,GAC3B,MAAM,GAAG,SAAS,CAWpB;AAcD,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA8Df"}
+{"version":3,"file":"bundle-build.d.ts","sourceRoot":"","sources":["../src/bundle-build.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE;YACR,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,CAAC,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;SAChD,CAAC;KACH,CAAC;CACH;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,mBAAmB,CAAC,EAAE,MAAM,GAC3B,MAAM,GAAG,SAAS,CAWpB;AAuGD,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA+Df"}

package/dist/bundle-build.js

@@ -1,7 +1,7 @@
-import { copyFile, mkdir, readFile } from "node:fs/promises";
-import { existsSync } from "node:fs";
-import { basename, join, resolve } from "node:path";
-import { assert } from "@lynxship/contracts";
+import { copyFile, mkdir, readFile, stat } from "node:fs/promises";
+import { basename, isAbsolute, join, relative, resolve } from "node:path";
+import { assert, LynxShipError } from "@lynxship/contracts";
+import { acquireMicroHs } from "@lynxship/microhs";
 import { commandExists, packageManagerScriptCommand, runProcess, runRspeedy, } from "./process-runner.js";
 import { detectLynxFramework } from "./frameworks.js";
 export function resolveMisoBuildTarget(flake, configuredAttribute) {
@@ -29,8 +29,72 @@ async function resolveBundleScript(root) {
     }
     return "build";
 }
+async function copyMisoBundle(root, artifactPath, onOutput) {
+    const artifact = resolve(root, artifactPath);
+    const relativeArtifact = relative(resolve(root), artifact);
+    assert(relativeArtifact !== "" &&
+        !relativeArtifact.startsWith("..") &&
+        !isAbsolute(relativeArtifact), "BUILD_MISO_ARTIFACT_OUTSIDE_PROJECT", "The Miso bundle artifact must remain inside the project directory: " +
+        artifactPath);
+    let artifactInfo;
+    try {
+        artifactInfo = await stat(artifact);
+    }
+    catch {
+        assert(false, "BUILD_MISO_BUNDLE_MISSING", "The Miso adapter did not produce the configured Lynx bundle: " +
+            artifact);
+    }
+    assert(artifactInfo?.isFile() && artifactInfo.size > 0, "BUILD_MISO_BUNDLE_INVALID", "The Miso adapter produced an empty or non-file Lynx bundle: " + artifact);
+    const output = join(root, "dist", basename(artifact));
+    await mkdir(join(root, "dist"), { recursive: true });
+    await copyFile(artifact, output);
+    onOutput?.("Miso bundle ready: " + output);
+}
+async function buildMisoWithMicroHs(root, options) {
+    const microhs = options.miso?.microhs;
+    assert(microhs?.adapter?.command, "BUILD_MISO_MICROHS_ADAPTER_REQUIRED", "MicroHs is not a drop-in GHCJS replacement. Configure build.<profile>.miso.microhs.adapter with the real Miso/MicroHs adapter command, or use compiler=ghcjs.");
+    const resolveProjectPath = (value) => value ? resolve(root, value) : undefined;
+    const configuredBinary = microhs.binary ?? process.env.LYNXSHIP_MICROHS_BINARY;
+    const configuredManifest = microhs.manifest ?? process.env.LYNXSHIP_MICROHS_MANIFEST;
+    const configuredCache = microhs.cacheDir ?? process.env.LYNXSHIP_MICROHS_CACHE;
+    const toolchain = await acquireMicroHs({
+        version: microhs.version ?? process.env.LYNXSHIP_MICROHS_VERSION,
+        binaryPath: resolveProjectPath(configuredBinary),
+        manifestPath: resolveProjectPath(configuredManifest),
+        manifestUrl: microhs.manifestUrl ?? process.env.LYNXSHIP_MICROHS_MANIFEST_URL,
+        cacheDir: resolveProjectPath(configuredCache),
+        publicKey: microhs.publicKey ?? process.env.LYNXSHIP_MICROHS_PUBLIC_KEY,
+    });
+    const artifact = options.miso?.artifact ?? "result/main.lynx.bundle";
+    try {
+        await runProcess(microhs.adapter.command, microhs.adapter.args ?? [], {
+            cwd: root,
+            env: {
+                ...options.env,
+                LYNXSHIP_MICROHS_BINARY: toolchain.binaryPath,
+                LYNXSHIP_MICROHS_VERSION: toolchain.version,
+                LYNXSHIP_MISO_COMPILER: "microhs",
+                LYNXSHIP_MISO_OUTPUT: resolve(root, artifact),
+            },
+            quiet: options.quiet,
+            onOutput: options.onOutput,
+        });
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new LynxShipError("BUILD_MISO_MICROHS_ADAPTER_FAILED", `The configured Miso/MicroHs adapter failed: ${detail}`, { cause: detail });
+    }
+    await copyMisoBundle(root, artifact, options.onOutput);
+}
 export async function buildLynxBundle(root, options = {}) {
     const framework = await detectLynxFramework(root);
+    if (framework.framework === "miso" &&
+        options.miso?.compiler === "microhs" &&
+        !options.script &&
+        !options.rspeedyArgs) {
+        await buildMisoWithMicroHs(root, options);
+        return;
+    }
     if (framework.buildSystem === "miso-nix" &&
         !options.script &&
         !options.rspeedyArgs) {
@@ -44,12 +108,7 @@ export async function buildLynxBundle(root, options = {}) {
             quiet: options.quiet,
             onOutput: options.onOutput,
         });
-        const artifact = resolve(root, options.miso?.artifact ?? "result/main.lynx.bundle");
-        assert(existsSync(artifact), "BUILD_MISO_BUNDLE_MISSING", "Miso did not produce the configured Lynx bundle: " + artifact);
-        const output = join(root, "dist", basename(artifact));
-        await mkdir(join(root, "dist"), { recursive: true });
-        await copyFile(artifact, output);
-        options.onOutput?.("Miso bundle ready: " + output);
+        await copyMisoBundle(root, options.miso?.artifact ?? "result/main.lynx.bundle", options.onOutput);
         return;
     }
     if (!options.script && options.rspeedyArgs) {

package/dist/config.d.ts

@@ -5,8 +5,21 @@ export interface BuildProfile {
     channel?: string;
     environment?: string;
     miso?: {
+        compiler?: "ghcjs" | "microhs";
         attribute?: string;
         artifact?: string;
+        microhs?: {
+            version?: string;
+            binary?: string;
+            manifest?: string;
+            manifestUrl?: string;
+            cacheDir?: string;
+            publicKey?: string;
+            adapter?: {
+                command: string;
+                args?: string[];
+            };
+        };
     };
     android?: {
         artifact?: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,GAAG,CAAC,EAAE;QACJ,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAChC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,GAAG,CAAC,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,cAAc,CAAC,EAAE;QAAE,MAAM,EAAE,aAAa,GAAG,QAAQ,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE;QACP,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE;YAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1C,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,cAAc,EAAE,cAsB5B,CAAC;AAcF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,EACf,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,cAAc,CAgEhB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,OAAO,CAAC,cAAc,CAAC,CAazB;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,IAAI,SAAe,GAClB,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAejC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAOrD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -56,6 +56,51 @@ export function validateConfig(config, options = {}) {
             assert(validString || validTuple, "CONFIG_PLUGINS", "Each plugin must be a package name or [package name, JSON options]");
         }
     }
+    if (value.build !== undefined) {
+        assert(typeof value.build === "object" &&
+            value.build !== null &&
+            !Array.isArray(value.build), "CONFIG_BUILD", "build must be an object keyed by profile name");
+    }
+    for (const [profileName, profile] of Object.entries(value.build ?? {})) {
+        assert(profile !== null &&
+            typeof profile === "object" &&
+            !Array.isArray(profile), "CONFIG_PROFILE", `build.${profileName} must be an object`);
+        const miso = profile.miso;
+        if (!miso)
+            continue;
+        assert(typeof miso === "object" && !Array.isArray(miso), "CONFIG_MISO", `build.${profileName}.miso must be an object`);
+        assert(miso.compiler === undefined ||
+            miso.compiler === "ghcjs" ||
+            miso.compiler === "microhs", "CONFIG_MISO_COMPILER", `build.${profileName}.miso.compiler must be ghcjs or microhs`);
+        if (!miso.microhs)
+            continue;
+        const microhs = miso.microhs;
+        assert(typeof microhs === "object" && !Array.isArray(microhs), "CONFIG_MISO_MICROHS", `build.${profileName}.miso.microhs must be an object`);
+        assert(microhs.adapter === undefined ||
+            (typeof microhs.adapter.command === "string" &&
+                microhs.adapter.command.trim().length > 0 &&
+                (microhs.adapter.args === undefined ||
+                    (Array.isArray(microhs.adapter.args) &&
+                        microhs.adapter.args.every((arg) => typeof arg === "string")))), "CONFIG_MISO_MICROHS_ADAPTER", `build.${profileName}.miso.microhs.adapter must contain a command and string args`);
+        assert(microhs.version === undefined || typeof microhs.version === "string", "CONFIG_MISO_MICROHS_VERSION", `build.${profileName}.miso.microhs.version must be a string`);
+        assert(microhs.binary === undefined || typeof microhs.binary === "string", "CONFIG_MISO_MICROHS_BINARY", `build.${profileName}.miso.microhs.binary must be a file path`);
+        assert(microhs.manifest === undefined || typeof microhs.manifest === "string", "CONFIG_MISO_MICROHS_MANIFEST", `build.${profileName}.miso.microhs.manifest must be a file path`);
+        assert(microhs.manifestUrl === undefined ||
+            typeof microhs.manifestUrl === "string", "CONFIG_MISO_MICROHS_MANIFEST", `build.${profileName}.miso.microhs.manifestUrl must be a URL`);
+        if (microhs.manifestUrl) {
+            let parsedManifestUrl;
+            try {
+                parsedManifestUrl = new URL(microhs.manifestUrl);
+            }
+            catch {
+                // The assertion below emits the stable configuration error.
+            }
+            assert(parsedManifestUrl?.protocol === "https:", "CONFIG_MISO_MICROHS_MANIFEST", `build.${profileName}.miso.microhs.manifestUrl must be a valid HTTPS URL`);
+        }
+        assert(microhs.cacheDir === undefined || typeof microhs.cacheDir === "string", "CONFIG_MISO_MICROHS_CACHE", `build.${profileName}.miso.microhs.cacheDir must be a directory path`);
+        assert(microhs.publicKey === undefined || typeof microhs.publicKey === "string", "CONFIG_MISO_MICROHS_KEY", `build.${profileName}.miso.microhs.publicKey must be a PEM string`);
+        assert(!(microhs.manifest && microhs.manifestUrl), "CONFIG_MISO_MICROHS_MANIFEST", `build.${profileName}.miso.microhs must use either manifest or manifestUrl, not both`);
+    }
     assert(value.runtimeVersion?.policy === undefined ||
         ["fingerprint", "manual"].includes(value.runtimeVersion.policy), "CONFIG_RUNTIME_POLICY", "runtimeVersion.policy must be fingerprint or manual");
     if (value.runtimeVersion?.policy === "manual")

package/dist/guidance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../src/guidance.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAChC;AAmoBD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,eAAoB,GAC5B,WAAW,CAEb"}
+{"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../src/guidance.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAChC;AA8sBD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,eAAoB,GAC5B,WAAW,CAEb"}

package/dist/guidance.js

@@ -127,6 +127,81 @@ const guidance = {
         ],
         note: "Check build.production.miso.artifact and the output produced by the Miso flake.",
     },
+    BUILD_MISO_MICROHS_ADAPTER_REQUIRED: {
+        commands: [
+            "lynxship doctor --platform android",
+            "lynxship inspect",
+            "lynxship build --platform android --profile production",
+        ],
+        note: "MicroHs is opt-in and is not a drop-in GHCJS replacement. Configure build.<profile>.miso.microhs with a pinned binary or manifest and a real adapter command, or set build.<profile>.miso.compiler to ghcjs.",
+    },
+    BUILD_MISO_MICROHS_ADAPTER_FAILED: {
+        commands: [
+            "lynxship doctor --platform android --profile production",
+            "lynxship inspect",
+            "lynxship build --platform android --profile production",
+        ],
+        note: "The real adapter or MicroHs compiler rejected the Miso source or failed to write the Lynx bundle. This does not prove Miso/MicroHs compatibility; use the official GHC/Nix workflow until the adapter supports the project's language extensions, packages, FFI and bundle output.",
+    },
+    BUILD_MISO_ARTIFACT_OUTSIDE_PROJECT: {
+        commands: ["lynxship inspect", "lynxship doctor --platform android"],
+        note: "Set build.<profile>.miso.artifact to a file inside the project, such as result/main.lynx.bundle.",
+    },
+    BUILD_MISO_BUNDLE_INVALID: {
+        commands: [
+            "lynxship inspect",
+            "lynxship build --platform android --profile production",
+        ],
+        note: "The configured Miso artifact must be a non-empty file produced by the adapter.",
+    },
+    MICROHS_MANIFEST_REQUIRED: {
+        commands: [
+            "lynxship doctor --platform android",
+            "lynxship inspect",
+            "lynxship build --platform android --profile production",
+        ],
+        note: "Provide build.<profile>.miso.microhs.binary for an existing verified mhs binary, or provide a pinned manifest/manifestUrl. LynxShip never downloads an unpinned compiler.",
+    },
+    MICROHS_HOST_UNSUPPORTED: {
+        commands: ["lynxship doctor --platform android", "lynxship inspect"],
+        note: "Use a verified MicroHs host binary for darwin-arm64, darwin-x64, linux-arm64, linux-x64 or win32-x64, or select the official ghcjs workflow.",
+    },
+    MICROHS_ARTIFACT_UNAVAILABLE: {
+        commands: ["lynxship doctor --platform android", "lynxship inspect"],
+        note: "Publish or select a manifest artifact for the current host architecture. The compiler host architecture is independent from the Android/iOS packaging target.",
+    },
+    MICROHS_BINARY_MISSING: {
+        commands: ["lynxship doctor --platform android", "lynxship inspect"],
+        note: "The configured MicroHs binary does not exist. Fix build.<profile>.miso.microhs.binary or use a pinned manifest.",
+    },
+    MICROHS_VERSION_MISMATCH: {
+        commands: ["lynxship inspect", "lynxship doctor --platform android"],
+        note: "The requested MicroHs version does not match the pinned manifest. Keep compiler and adapter versions aligned.",
+    },
+    MICROHS_MANIFEST_INVALID: {
+        commands: ["lynxship inspect", "lynxship doctor --platform android"],
+        note: "The MicroHs manifest is invalid. It must declare schemaVersion 1, a source commit and SHA-256-pinned artifacts.",
+    },
+    MICROHS_MANIFEST_READ_FAILED: {
+        commands: ["lynxship inspect", "lynxship doctor --platform android"],
+        note: "Check the configured local MicroHs manifest path and permissions.",
+    },
+    MICROHS_MANIFEST_FETCH_FAILED: {
+        commands: ["lynxship inspect", "lynxship doctor --platform android"],
+        note: "Check the pinned MicroHs manifest URL and network access. LynxShip does not silently fall back to an unverified download.",
+    },
+    MICROHS_HASH_MISMATCH: {
+        commands: ["lynxship inspect", "lynxship doctor --platform android"],
+        note: "The downloaded compiler did not match its pinned SHA-256. Do not reuse the cache; verify the release manifest and artifact source.",
+    },
+    MICROHS_SIGNATURE_INVALID: {
+        commands: ["lynxship inspect", "lynxship doctor --platform android"],
+        note: "The MicroHs artifact signature did not verify. Check the pinned release public key and manifest; the binary was rejected.",
+    },
+    MICROHS_SIGNATURE_KEY_REQUIRED: {
+        commands: ["lynxship inspect", "lynxship doctor --platform android"],
+        note: "The manifest declares a signed MicroHs artifact. Configure the pinned public key before using it.",
+    },
     WEB_BUNDLE_MISSING: {
         commands: [
             "lynxship doctor --platform web",

package/dist/index.js

@@ -10,6 +10,7 @@ import { assert, createId, sha256, } from "@lynxship/contracts";
 import { createSigningKey, signManifest, } from "@lynxship/signing";
 import { AppStoreConnectApiProvider, GooglePlayApiProvider, SubmissionService, } from "@lynxship/submit";
 import { DEFAULT_CONFIG, loadConfig, platformValue, resolveProfile, } from "./config.js";
+import { microHsHostTriple } from "@lynxship/microhs";
 import { hasAndroidHost, isSupportedAndroidPlatform, runRealAndroidBuild, } from "./android-build.js";
 import { initializeAndroidHost, suggestedAndroidApplicationId, } from "./android-host.js";
 import { initializeIosHost, suggestedIosBundleIdentifier } from "./ios-host.js";
@@ -533,6 +534,14 @@ Global options:
   --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.`;
 }
 async function looksLikeLynxProject() {
@@ -1008,7 +1017,13 @@ async function main() {
         const autolinkForPlatform = autolink && (doctorPlatform === "android" || doctorPlatform === "ios")
             ? autolink[doctorPlatform]
             : undefined;
-        const lockfile = await findLockfile(root);
+        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;
@@ -1038,7 +1053,23 @@ async function main() {
         const nodeMajor = Number(process.versions.node.split(".")[0]);
         const nodeSupported = nodeMajor >= 22;
         const nodeRecommended = nodeMajor % 2 === 0;
-        const framework = await detectLynxFramework(root);
+        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 = [
@@ -1057,7 +1088,7 @@ async function main() {
                         framework.evidence +
                         (framework.experimental ? " · early access" : ""),
             },
-            ...(framework.framework === "miso"
+            ...(framework.framework === "miso" && misoCompiler !== "microhs"
                 ? [
                     {
                         name: "miso-nix",
@@ -1070,7 +1101,45 @@ async function main() {
                             : "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,
@@ -1086,7 +1155,7 @@ async function main() {
                         : `${process.version} · recommended: Node 24 LTS`,
             },
             {
-                name: "package-manager-lockfile",
+                name: "dependency-lockfile",
                 ok: Boolean(lockfile),
                 status: lockfile ? "pass" : "fail",
                 value: lockfile ?? "missing · fix: pnpm install (or npm install)",

package/dist/ui/components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/ui/components.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7C,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,eAAO,MAAM,GAAG;qBACG,MAAM,GAAG,IAAI;kBAGhB,MAAM,GAAG,IAAI;mBAGZ,MAAM,GAAG,IAAI;kBAGd,MAAM,GAAG,IAAI;mBAGZ,MAAM,GAAG,IAAI;CAG7B,CAAC;AAgBF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA6C9D;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,IAAI,IAAI,IAAI,CAAC;CACd;AA6CD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoBnD;AA6BD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,cAAc,CAuEhB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CA2BlE;AAYD,eAAO,MAAM,IAAI;oBACC,MAAM;iBACT,MAAM;iBACN,MAAM;kBACL,MAAM;CACrB,CAAC;AAEF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI,CAE/D;AAED,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAQN;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,UAAO,GACb,IAAI,CAQN;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5E"}
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/ui/components.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7C,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,eAAO,MAAM,GAAG;qBACG,MAAM,GAAG,IAAI;kBAGhB,MAAM,GAAG,IAAI;mBAGZ,MAAM,GAAG,IAAI;kBAGd,MAAM,GAAG,IAAI;mBAGZ,MAAM,GAAG,IAAI;CAG7B,CAAC;AAgBF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA6C9D;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,IAAI,IAAI,IAAI,CAAC;CACd;AA6CD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoBnD;AA6BD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,cAAc,CAwEhB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CA2BlE;AAYD,eAAO,MAAM,IAAI;oBACC,MAAM;iBACT,MAAM;iBACN,MAAM;kBACL,MAAM;CACrB,CAAC;AAEF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI,CAE/D;AAED,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAQN;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,UAAO,GACb,IAAI,CAQN;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5E"}

package/dist/ui/components.js

@@ -187,7 +187,8 @@ export function createProgress(label, enabled) {
         spinnerIndex = (spinnerIndex + 1) % spinnerFrames.length;
         bar.update(currentValue, payload(currentLabel));
     }, 120);
-    timer.unref?.();
+    const nodeTimer = timer;
+    nodeTimer.unref?.();
     const untrack = trackAnimation(() => {
         clearInterval(timer);
         bar.stop();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynxship/cli",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Build, sign, store, submit and update LynxJS applications from the terminal.",
   "type": "module",
   "license": "MIT",
@@ -71,21 +71,22 @@
     "@aws-sdk/client-s3": "3.1116.0",
     "@aws-sdk/lib-storage": "3.1116.0",
     "@aws-sdk/s3-request-presigner": "3.1116.0",
+    "@resvg/resvg-js": "2.6.2",
     "boxen": "8.0.1",
     "chalk": "5.4.1",
     "cli-progress": "3.12.0",
-    "ora": "8.2.0",
-    "qrcode-terminal": "0.12.0",
-    "qr-code-styling": "1.9.2",
-    "@resvg/resvg-js": "2.6.2",
     "jsdom": "29.1.1",
+    "ora": "8.2.0",
     "pngjs": "7.0.0",
+    "qr-code-styling": "1.9.2",
+    "qrcode-terminal": "0.12.0",
     "@lynxship/build-orchestrator": "0.1.0",
     "@lynxship/contracts": "0.1.0",
-    "@lynxship/submit": "0.1.0",
     "@lynxship/plugin-api": "0.1.0",
+    "@lynxship/db": "0.1.0",
+    "@lynxship/submit": "0.1.0",
     "@lynxship/signing": "0.1.0",
-    "@lynxship/db": "0.1.0"
+    "@lynxship/microhs": "0.1.0"
   },
   "devDependencies": {
     "@types/cli-progress": "3.11.6",