@lynxship/cli 0.1.16 → 0.1.19

package/README.md

@@ -25,6 +25,26 @@ npx @lynxship/cli@latest doctor --project-dir ./my-lynx-app
 
 The package exposes the `lynxship` executable.
 
+## Plugin ecosystem
+
+Install a community plugin as a normal project dependency, list it in
+`lynxship.json`, then validate it before building:
+
+```bash
+npm install --save-dev @example/lynx-plugin
+npx lynxship plugin doctor
+npx lynxship plugin list
+npx lynxship plugin apply --platform android --profile production
+```
+
+The public contract is exported by `@lynxship/plugin-api`. Plugins can make
+JSON configuration contributions and bounded, idempotent Android/iOS/native
+file changes. Autolink remains the official Lynx `lynx.lib.json` and codegen
+workflow. Template and cloud contributions are discoverable metadata until a
+reviewed provider or template service consumes them.
+
+See the full contract in the repository `docs/plugin-ecosystem.md`.
+
 ## Vue Lynx projects
 
 LynxShip supports projects created with the official Vue Lynx scaffold. Vue
@@ -70,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,
@@ -514,7 +573,8 @@ actual recording and analysis.
 
 ## Package layout
 
-The CLI is backed by public `@lynxship/*` runtime packages in this workspace.
+The CLI is backed by public `@lynxship/*` runtime packages in this workspace,
+including the public `@lynxship/plugin-api` contract.
 Their published versions may differ from the CLI version; workspace ranges are
 rewritten to released versions when the package is packed. Publish a changed
 runtime package before publishing the CLI when its source or version changed.

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

@@ -1,11 +1,25 @@
 import { type Platform } from "@lynxship/contracts";
+import type { PluginReference } from "@lynxship/plugin-api";
 export interface BuildProfile {
     distribution?: string;
     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;
@@ -43,6 +57,7 @@ export interface BuildProfile {
 }
 export interface LynxShipConfig {
     projectId?: string;
+    plugins?: PluginReference[];
     cli?: {
         apiUrl?: string;
         organizationId?: 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;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,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;AAaF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,EACf,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,cAAc,CAyChB;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

@@ -33,6 +33,7 @@ const allowedRootKeys = new Set([
     "submit",
     "update",
     "artifacts",
+    "plugins",
 ]);
 export function validateConfig(config, options = {}) {
     assert(config && typeof config === "object" && !Array.isArray(config), "CONFIG_INVALID", "lynxship.json must contain an object");
@@ -41,6 +42,65 @@ export function validateConfig(config, options = {}) {
     assert(!options.ci || unknown.length === 0, "CONFIG_UNKNOWN_KEY", `Unknown configuration key(s): ${unknown.join(", ")}`, { unknown });
     if (value.projectId !== undefined)
         assert(typeof value.projectId === "string" && value.projectId.length > 0, "CONFIG_PROJECT_ID", "projectId must be a non-empty string");
+    if (value.plugins !== undefined) {
+        assert(Array.isArray(value.plugins), "CONFIG_PLUGINS", "plugins must be an array of package names or [package, options] tuples");
+        for (const plugin of value.plugins) {
+            const validString = typeof plugin === "string" && plugin.length > 0;
+            const validTuple = Array.isArray(plugin) &&
+                plugin.length === 2 &&
+                typeof plugin[0] === "string" &&
+                plugin[0].length > 0 &&
+                plugin[1] !== null &&
+                typeof plugin[1] === "object" &&
+                !Array.isArray(plugin[1]);
+            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",