@lynxship/cli 0.1.16 → 0.1.19

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";
@@ -35,6 +36,7 @@ import { hasHarmonyHost, runRealHarmonyBuild } from "./harmony-build.js";
 import { hasWebConfiguration, runRealWebBuild } from "./web-build.js";
 import { hasDesktopHost, runRealDesktopBuild } from "./desktop-build.js";
 import { extractDevServerUrl, shouldPrintDevServerQr } from "./dev-qr.js";
+import { applyProjectPlugins, inspectProjectPlugins } from "./plugins.js";
 import { inspectDesktopTarget, inspectHarmonyTarget, inspectWebTarget, } from "./target-toolchain.js";
 const rawArgs = process.argv.slice(2);
 const args = [...rawArgs];
@@ -216,7 +218,20 @@ async function executeBuild(options, showResult = true) {
     // Host initialization can write lynxship.json (for example, the generated
     // iOS scheme). Always read it again before resolving the build profile so a
     // first build uses the host that was just created in the same invocation.
-    const effectiveConfig = wait && !local ? await loadConfig(root) : config;
+    const loadedConfig = wait && !local ? await loadConfig(root) : config;
+    const pluginApplication = wait && !local
+        ? await applyProjectPlugins(root, loadedConfig, { platform, profile })
+        : {
+            config: loadedConfig,
+            report: { configured: 0, plugins: [] },
+            applied: [],
+            templates: [],
+            cloud: [],
+            build: [],
+            changes: [],
+            autolink: [],
+        };
+    const effectiveConfig = pluginApplication.config;
     if (platform === "android" || platform === "ios")
         await requireAutolinkReady(root, platform);
     const runtime = await inspectRuntimeFingerprint(root, platform, effectiveConfig);
@@ -418,6 +433,7 @@ function commandTitle(command) {
         devtool: "Lynx DevTool diagnostics",
         trace: "Lynx Trace diagnostics",
         recorder: "Lynx Recorder diagnostics",
+        plugin: "LynxShip plugins",
     }[command] ?? command);
 }
 function helpText() {
@@ -433,6 +449,10 @@ Commands:
   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
   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
@@ -514,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() {
@@ -905,6 +933,80 @@ async function main() {
         });
         return;
     }
+    if (command === "plugin") {
+        const subcommand = args.shift() ?? "list";
+        assert(["list", "doctor", "apply"].includes(subcommand), "CLI_PLUGIN_COMMAND", "Use \`lynxship plugin list\`, \`lynxship plugin doctor\` or \`lynxship plugin apply\`.");
+        await requireProjectRoot();
+        const config = await loadConfig(root);
+        const report = await inspectProjectPlugins(root, config);
+        if (subcommand === "apply") {
+            const platform = platformValue(flag("--platform", "android"));
+            const profile = flag("--profile", "production");
+            const dryRun = args.includes("--dry-run");
+            const result = await applyProjectPlugins(root, config, {
+                platform,
+                profile,
+                mode: dryRun ? "plan" : "apply",
+            });
+            printValue({
+                status: dryRun ? "planned" : "applied",
+                platform,
+                profile,
+                plugins: result.applied,
+                nativeChanges: result.changes.filter((change) => change.changed)
+                    .length,
+                changes: result.changes,
+                templates: result.templates,
+                cloud: result.cloud,
+                build: result.build,
+            }, {
+                title: `LynxShip plugins · ${platform}`,
+                rows: [
+                    {
+                        label: "Applied",
+                        value: result.applied.length ? result.applied.join(", ") : "none",
+                        valueColor: "green",
+                    },
+                    {
+                        label: "Native changes",
+                        value: String(result.changes.filter((change) => change.changed).length),
+                        valueColor: "blue",
+                    },
+                ],
+                done: dryRun
+                    ? "No native files were modified; review the planned changes."
+                    : "Project plugin changes are applied atomically and idempotently.",
+            });
+            return;
+        }
+        const invalid = report.plugins.filter((plugin) => plugin.status !== "ready");
+        printValue(report, {
+            title: `LynxShip plugins · ${subcommand}`,
+            rows: report.plugins.length > 0
+                ? report.plugins.map((plugin) => ({
+                    label: plugin.name,
+                    value: `${plugin.status} · ${plugin.capabilities.join(", ") || "no capabilities"} · ${plugin.reason}`,
+                    valueColor: plugin.status === "ready"
+                        ? "green"
+                        : plugin.status === "missing"
+                            ? "red"
+                            : "yellow",
+                }))
+                : [
+                    {
+                        label: "Plugins",
+                        value: "none configured",
+                        valueColor: "muted",
+                    },
+                ],
+            done: invalid.length === 0
+                ? "All project plugin manifests are valid."
+                : "Fix the invalid plugin package before building.",
+        });
+        if (subcommand === "doctor" && invalid.length > 0)
+            process.exitCode = 1;
+        return;
+    }
     if (command === "doctor") {
         const config = await loadConfig(root);
         const configuration = await readConfigurationStatus();
@@ -915,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;
@@ -945,7 +1053,25 @@ 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 = [
             {
                 name: "lynx-framework",
@@ -962,7 +1088,7 @@ async function main() {
                         framework.evidence +
                         (framework.experimental ? " · early access" : ""),
             },
-            ...(framework.framework === "miso"
+            ...(framework.framework === "miso" && misoCompiler !== "microhs"
                 ? [
                     {
                         name: "miso-nix",
@@ -975,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,
@@ -991,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)",
@@ -1002,6 +1166,16 @@ async function main() {
                 status: config.projectId ? "pass" : "fail",
                 value: config.projectId ? "found" : "missing · fix: lynxship init",
             },
+            {
+                name: "lynxship-plugins",
+                ok: invalidPlugins.length === 0,
+                status: invalidPlugins.length === 0 ? "pass" : "fail",
+                value: invalidPlugins.length === 0
+                    ? pluginReport.configured === 0
+                        ? "none configured"
+                        : `${pluginReport.configured} plugin(s) ready`
+                    : `${invalidPlugins.map((plugin) => plugin.name).join(", ")} · fix: lynxship plugin doctor`,
+            },
             {
                 name: "credential-store",
                 ok: true,

package/dist/plugin-api.d.ts

@@ -0,0 +1,2 @@
+export * from "@lynxship/plugin-api";
+//# sourceMappingURL=plugin-api.d.ts.map

package/dist/plugin-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-api.d.ts","sourceRoot":"","sources":["../src/plugin-api.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/plugin-api.js

@@ -0,0 +1 @@
+export * from "@lynxship/plugin-api";

package/dist/plugins.d.ts

@@ -0,0 +1,35 @@
+import type { Platform } from "@lynxship/contracts";
+import { type BuildContribution, type CloudIntegrationContribution, type PluginCapability, type AutolinkContribution, type PluginPermission, type PluginPlanChange, type TemplateContribution } from "@lynxship/plugin-api";
+import type { LynxShipConfig } from "./config.js";
+export interface ProjectPluginInfo {
+    name: string;
+    version?: string;
+    packagePath?: string;
+    entry?: string;
+    apiVersion?: number;
+    capabilities: PluginCapability[];
+    permissions: PluginPermission[];
+    status: "ready" | "missing" | "invalid";
+    reason: string;
+}
+export interface PluginReport {
+    configured: number;
+    plugins: ProjectPluginInfo[];
+}
+export interface PluginApplication {
+    config: LynxShipConfig;
+    report: PluginReport;
+    applied: string[];
+    templates: TemplateContribution[];
+    cloud: CloudIntegrationContribution[];
+    build: BuildContribution[];
+    changes: PluginPlanChange[];
+    autolink: AutolinkContribution[];
+}
+export declare function inspectProjectPlugins(root: string, config: LynxShipConfig): Promise<PluginReport>;
+export declare function applyProjectPlugins(root: string, config: LynxShipConfig, target: {
+    platform: Platform;
+    profile: string;
+    mode?: "plan" | "apply";
+}): Promise<PluginApplication>;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EAKjC,KAAK,gBAAgB,EAErB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAGrB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAclD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,KAAK,EAAE,4BAA4B,EAAE,CAAC;IACtC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAqUD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,YAAY,CAAC,CAQvB;AA+XD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACvE,OAAO,CAAC,iBAAiB,CAAC,CAqF5B"}