@lynxship/cli 0.1.15 → 0.1.18

package/README.md

@@ -14,17 +14,37 @@ expiring download URL with a compact terminal QR code.
 ## Install
 
 ```bash
-npm install --global @lynxship/cli
+npm install --global @lynxship/cli@latest
 ```
 
 Or run it without a global install:
 
 ```bash
-npx @lynxship/cli doctor --project-dir ./my-lynx-app
+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
@@ -52,6 +72,34 @@ The CLI generator itself creates ReactLynx templates by default. Use the
 official `create-vue-lynx` scaffold when Vue is required, then add LynxShip to
 that existing project with `init`.
 
+## Octane and Miso
+
+LynxShip detects Octane and Miso projects without replacing their
+project-owned configuration.
+
+Octane uses the official `@octanejs/rspeedy-plugin`. The Lynx integration is
+still early access and its Lynx packages are not currently published on npm,
+so development validation must use the official Octane repository and its
+pnpm workspace:
+
+```bash
+git clone https://github.com/octanejs/octane.git
+cd octane
+pnpm install --filter @octanejs/rspeedy-plugin... --frozen-lockfile
+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.
+
+See the source-verified fixture notes in the repository's
+`examples/lynx-octane-fixture` and `examples/miso-lynx-fixture` directories,
+plus `docs/compatibility.md`.
+
 ## Requirements
 
 - Node.js 22 or 24 LTS, or Node.js 26 Current; Node.js 24 LTS is the
@@ -486,9 +534,11 @@ actual recording and analysis.
 
 ## Package layout
 
-The CLI is backed by the public `@lynxship/*` runtime packages in this
-workspace. They are published with the same version and must be available in
-the configured npm scope before installing the CLI package.
+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.
 
 ## License
 

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

@@ -1 +1 @@
-{"version":3,"file":"android-build.d.ts","sourceRoot":"","sources":["../src/android-build.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAWhD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AA8KD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa7D;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsCpE;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CA+JnB"}
+{"version":3,"file":"android-build.d.ts","sourceRoot":"","sources":["../src/android-build.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAWhD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AA8KD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa7D;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsCpE;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAgKnB"}

package/dist/android-build.js

@@ -218,6 +218,7 @@ export async function runRealAndroidBuild(job, options) {
             await buildLynxBundle(options.root, {
                 env: environment,
                 ...processOptions,
+                miso: options.profile.miso,
             });
         }
         step("Rspeedy bundle ready", 20);

package/dist/bundle-build.d.ts

@@ -4,6 +4,11 @@ export interface BundleBuildOptions {
     onOutput?: (line: string) => void;
     script?: string;
     rspeedyArgs?: string[];
+    miso?: {
+        attribute?: string;
+        artifact?: string;
+    };
 }
+export declare function resolveMisoBuildTarget(flake: string, configuredAttribute?: string): string | undefined;
 export declare function buildLynxBundle(root: string, options?: BundleBuildOptions): Promise<void>;
 //# sourceMappingURL=bundle-build.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"bundle-build.d.ts","sourceRoot":"","sources":["../src/bundle-build.ts"],"names":[],"mappings":"AAYA,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;CACxB;AAcD,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAqBf"}
+{"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"}

package/dist/bundle-build.js

@@ -1,6 +1,23 @@
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { packageManagerScriptCommand, runProcess, runRspeedy, } from "./process-runner.js";
+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 { commandExists, packageManagerScriptCommand, runProcess, runRspeedy, } from "./process-runner.js";
+import { detectLynxFramework } from "./frameworks.js";
+export function resolveMisoBuildTarget(flake, configuredAttribute) {
+    const explicitAttribute = configuredAttribute?.trim();
+    if (explicitAttribute)
+        return ".#" + explicitAttribute;
+    if (flake.includes("counter-bundle"))
+        return ".#counter-bundle";
+    if (/\binherit\s+bundle\b|\bdefault\s*=\s*bundle\b/.test(flake)) {
+        return ".#bundle";
+    }
+    if (/\bdefault\s*=/.test(flake) && flake.includes("mkLynxBundle")) {
+        return ".";
+    }
+    return undefined;
+}
 async function resolveBundleScript(root) {
     try {
         const manifest = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
@@ -13,6 +30,28 @@ async function resolveBundleScript(root) {
     return "build";
 }
 export async function buildLynxBundle(root, options = {}) {
+    const framework = await detectLynxFramework(root);
+    if (framework.buildSystem === "miso-nix" &&
+        !options.script &&
+        !options.rspeedyArgs) {
+        assert(commandExists("nix"), "BUILD_MISO_NIX_REQUIRED", "Miso requires Nix. Install Nix, then rerun lynxship doctor or provide a project build script.");
+        const flake = await readFile(join(root, "flake.nix"), "utf8").catch(() => "");
+        const target = resolveMisoBuildTarget(flake, options.miso?.attribute);
+        assert(target, "BUILD_MISO_ATTRIBUTE_REQUIRED", "Miso bundle output is not discoverable. Set build.<profile>.miso.attribute in lynxship.json, or expose a default/mkLynxBundle output in flake.nix.");
+        await runProcess("nix", ["build", target], {
+            cwd: root,
+            env: options.env,
+            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);
+        return;
+    }
     if (!options.script && options.rspeedyArgs) {
         await runRspeedy(root, "build", options.rspeedyArgs, {
             env: options.env,

package/dist/config.d.ts

@@ -1,8 +1,13 @@
 import { type Platform } from "@lynxship/contracts";
+import type { PluginReference } from "@lynxship/plugin-api";
 export interface BuildProfile {
     distribution?: string;
     channel?: string;
     environment?: string;
+    miso?: {
+        attribute?: string;
+        artifact?: string;
+    };
     android?: {
         artifact?: string;
     };
@@ -39,6 +44,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":"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"}
+{"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,20 @@ 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]");
+        }
+    }
     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/desktop-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"desktop-build.d.ts","sourceRoot":"","sources":["../src/desktop-build.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAahD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,UAAU,WAAW;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM,GAAG,SAAS,CAMpB;AAYD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,OAAO,CAAC,CAmBlB;AA+DD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CA0GnB"}
+{"version":3,"file":"desktop-build.d.ts","sourceRoot":"","sources":["../src/desktop-build.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAahD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,UAAU,WAAW;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM,GAAG,SAAS,CAMpB;AAYD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,OAAO,CAAC,CAmBlB;AA+DD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CA2GnB"}

package/dist/desktop-build.js

@@ -99,6 +99,7 @@ export async function runRealDesktopBuild(job, options) {
             await buildLynxBundle(options.root, {
                 quiet: options.quiet,
                 onOutput: options.onEvent,
+                miso: options.profile.miso,
             });
         }
         transitionBuild(job, "queued", "Desktop build queued locally");

package/dist/frameworks.d.ts

@@ -0,0 +1,10 @@
+export type LynxFramework = "react" | "vue" | "octane" | "miso" | "vanilla" | "unknown";
+export interface FrameworkDetection {
+    framework: LynxFramework;
+    label: string;
+    evidence: string;
+    buildSystem: "rspeedy" | "miso-nix" | "unknown";
+    experimental: boolean;
+}
+export declare function detectLynxFramework(root: string): Promise<FrameworkDetection>;
+//# sourceMappingURL=frameworks.d.ts.map

package/dist/frameworks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworks.d.ts","sourceRoot":"","sources":["../src/frameworks.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,KAAK,GACL,QAAQ,GACR,MAAM,GACN,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAChD,YAAY,EAAE,OAAO,CAAC;CACvB;AAiCD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,CAAC,CA+F7B"}

package/dist/frameworks.js

@@ -0,0 +1,104 @@
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+async function readText(file) {
+    return readFile(file, "utf8").catch(() => "");
+}
+async function readManifest(root) {
+    try {
+        return JSON.parse(await readText(join(root, "package.json")));
+    }
+    catch {
+        return {};
+    }
+}
+function dependencyNames(manifest) {
+    return new Set([
+        ...Object.keys(manifest.dependencies ?? {}),
+        ...Object.keys(manifest.devDependencies ?? {}),
+    ]);
+}
+function hasAny(names, candidates) {
+    return candidates.find((name) => names.has(name));
+}
+export async function detectLynxFramework(root) {
+    const manifest = await readManifest(root);
+    const names = dependencyNames(manifest);
+    const scripts = Object.values(manifest.scripts ?? {}).join(" ");
+    const configFiles = [
+        "lynx.config.ts",
+        "lynx.config.js",
+        "lynx.config.mjs",
+        "lynx.config.cjs",
+        "octane.config.ts",
+        "octane.config.js",
+    ];
+    const config = (await Promise.all(configFiles
+        .filter((file) => existsSync(join(root, file)))
+        .map((file) => readText(join(root, file))))).join("\n");
+    const flake = await readText(join(root, "flake.nix"));
+    const cabal = await readText(join(root, "cabal.project"));
+    const hasCabalFile = existsSync(join(root, "cabal.project"));
+    const hasMiso = hasAny(names, ["miso", "miso-lynx"]) ||
+        (existsSync(join(root, "flake.nix")) &&
+            /miso|mkLynxBundle|Miso\\.Native|lynx/i.test(flake + "\n" + cabal)) ||
+        (hasCabalFile && /miso|lynx/i.test(cabal));
+    if (hasMiso) {
+        return {
+            framework: "miso",
+            label: "Miso (Haskell)",
+            evidence: "Miso.Native/Haskell project detected",
+            buildSystem: "miso-nix",
+            experimental: true,
+        };
+    }
+    const hasOctane = hasAny(names, ["octane", "@octanejs/lynx", "@octanejs/rspeedy-plugin"]) ||
+        existsSync(join(root, "octane.config.ts")) ||
+        existsSync(join(root, "octane.config.js")) ||
+        /pluginOctane|@jsxImportSource\\s+octane|\\.tsrx\\b/.test(config + scripts);
+    if (hasOctane) {
+        return {
+            framework: "octane",
+            label: "Octane",
+            evidence: "Octane compiler/Rspeedy integration detected",
+            buildSystem: "rspeedy",
+            experimental: true,
+        };
+    }
+    const vueDependency = hasAny(names, ["vue-lynx", "@lynx-js/vue"]);
+    if (vueDependency || /pluginVueLynx|vue-lynx/i.test(config)) {
+        return {
+            framework: "vue",
+            label: "Vue Lynx",
+            evidence: "Vue Lynx integration detected",
+            buildSystem: "rspeedy",
+            experimental: false,
+        };
+    }
+    if (hasAny(names, ["@lynx-js/react", "@lynx-js/react-rsbuild-plugin"])) {
+        return {
+            framework: "react",
+            label: "ReactLynx",
+            evidence: "official ReactLynx package detected",
+            buildSystem: "rspeedy",
+            experimental: false,
+        };
+    }
+    if (names.has("@lynx-js/rspeedy") ||
+        /rspeedy|environments\\s*:/i.test(config + scripts)) {
+        return {
+            framework: "vanilla",
+            label: "Vanilla Lynx",
+            evidence: "Rspeedy/Lynx project detected",
+            buildSystem: "rspeedy",
+            experimental: false,
+        };
+    }
+    return {
+        framework: "unknown",
+        label: "Unknown",
+        evidence: "No supported Lynx framework marker found",
+        buildSystem: "unknown",
+        experimental: false,
+    };
+}

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;AA6mBD,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;AAmoBD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,eAAoB,GAC5B,WAAW,CAEb"}

package/dist/guidance.js

@@ -105,6 +105,28 @@ const guidance = {
         ],
         note: "Configure environments.web in lynx.config.* or provide the project's build:web script.",
     },
+    BUILD_MISO_NIX_REQUIRED: {
+        commands: [
+            "lynxship doctor --platform android",
+            "nix --version",
+            "lynxship build --platform android --profile production",
+        ],
+        note: "Install Nix and use the project's flake to build the Miso Lynx bundle.",
+    },
+    BUILD_MISO_ATTRIBUTE_REQUIRED: {
+        commands: [
+            "lynxship init",
+            "lynxship build --platform android --profile production",
+        ],
+        note: "Expose a default/mkLynxBundle output or set build.production.miso.attribute to the Nix flake output that creates main.lynx.bundle.",
+    },
+    BUILD_MISO_BUNDLE_MISSING: {
+        commands: [
+            "nix build",
+            "lynxship build --platform android --profile production",
+        ],
+        note: "Check build.production.miso.artifact and the output produced by the Miso flake.",
+    },
     WEB_BUNDLE_MISSING: {
         commands: [
             "lynxship doctor --platform web",

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

@@ -1 +1 @@
-{"version":3,"file":"harmony-build.d.ts","sourceRoot":"","sources":["../src/harmony-build.ts"],"names":[],"mappings":"AAIA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAeD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAcA;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BnB;AA2GD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAoGnB"}
+{"version":3,"file":"harmony-build.d.ts","sourceRoot":"","sources":["../src/harmony-build.ts"],"names":[],"mappings":"AAIA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAeD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAcA;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BnB;AA2GD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAqGnB"}

package/dist/harmony-build.js

@@ -141,6 +141,7 @@ export async function runRealHarmonyBuild(job, options) {
             await buildLynxBundle(options.root, {
                 quiet: options.quiet,
                 onOutput: options.onEvent,
+                miso: options.profile.miso,
             });
         }
         step("Syncing bundle into the HarmonyOS HAP resources…", 20);