@lynxship/cli 0.1.19 → 0.1.21

package/dist/commands/project.js

@@ -0,0 +1,122 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { assert } from "@lynxship/contracts";
+import { detectLynxFramework } from "../frameworks.js";
+import { hasAndroidHost, isSupportedAndroidPlatform, } from "../android-build.js";
+import { initializeAndroidHost, suggestedAndroidApplicationId, } from "../android-host.js";
+import { initializeIosHost, suggestedIosBundleIdentifier, } from "../ios-host.js";
+import { hasIosHost } from "../ios-build.js";
+import { DEFAULT_CONFIG, resolveProfile, } from "../config.js";
+import { hasHarmonyHost } from "../harmony-build.js";
+import { hasWebConfiguration } from "../web-build.js";
+import { hasDesktopHost } from "../desktop-build.js";
+import { exists } from "../runtime/project.js";
+import { loadAppConfig } from "../app-config.js";
+export async function looksLikeLynxProject(context) {
+    const framework = await detectLynxFramework(context.root);
+    if (framework.framework !== "unknown")
+        return true;
+    const configFiles = [
+        "lynx.config.ts",
+        "lynx.config.js",
+        "lynx.config.mjs",
+        "lynx.config.cjs",
+        "app.config.ts",
+        "app.config.js",
+        "app.config.mjs",
+        "app.config.cjs",
+    ];
+    if (await Promise.any(configFiles.map((file) => exists(join(context.root, file)))))
+        return true;
+    try {
+        const packageJson = JSON.parse(await readFile(join(context.root, "package.json"), "utf8"));
+        const dependencies = {
+            ...packageJson.dependencies,
+            ...packageJson.devDependencies,
+        };
+        return (Object.keys(dependencies).some((name) => name.startsWith("@lynx-js/") || name === "vue-lynx") ||
+            Object.values(packageJson.scripts ?? {}).some((script) => script.includes("rspeedy")));
+    }
+    catch {
+        return false;
+    }
+}
+export async function initializeProject(context) {
+    const file = join(context.root, "lynxship.json");
+    if (await exists(file))
+        return file;
+    await mkdir(join(context.root, ".lynxship"), { recursive: true });
+    await writeFile(file, `${JSON.stringify({
+        ...DEFAULT_CONFIG,
+        projectId: context.flag("--project-id") ?? randomUUID(),
+    }, null, 2)}\n`);
+    return file;
+}
+export async function initializeBuildProject(context) {
+    if (await exists(join(context.root, "lynxship.json")))
+        return;
+    assert(await looksLikeLynxProject(context), "CLI_PROJECT_REQUIRED", "No LynxJS project was detected. Run this command from the project directory or provide `--project-dir`.");
+    context.ui.info("No lynxship.json found. Running lynxship init automatically…");
+    await initializeProject(context);
+    context.ui.success("Created lynxship.json");
+}
+export async function ensureNativeHostForBuild(context, platform, profile, config) {
+    if (platform === "android") {
+        assert(isSupportedAndroidPlatform(), "ANDROID_PLATFORM_UNSUPPORTED", "Android builds are supported on Windows, macOS, and Linux.");
+        if (await hasAndroidHost(context.root))
+            return;
+        assert(!(await exists(join(context.root, "android"))), "ANDROID_HOST_EXISTS", "An android/ directory exists but does not contain a usable Gradle host. LynxShip will not overwrite it; repair it or remove it deliberately, then rerun the build.");
+        const appConfig = await loadAppConfig(context.root);
+        const configuredApplicationId = appConfig?.config.platform?.android?.packageName;
+        const suggestedId = suggestedAndroidApplicationId(context.root);
+        const applicationId = context.flag("--application-id") ??
+            configuredApplicationId ??
+            (context.ui.interactive
+                ? await context.prompt("Android application ID", suggestedId)
+                : "");
+        assert(applicationId, "ANDROID_HOST_REQUIRED", `No Android Gradle host exists. Run \`lynxship android host init --application-id ${suggestedId}\` or pass --application-id <id> to build in non-interactive mode.`);
+        context.ui.info("No Android host found. Creating the official LynxShip host before the build…");
+        const result = await initializeAndroidHost(context.root, {
+            applicationId,
+            appName: appConfig?.config.appName ?? basename(context.root),
+        });
+        context.ui.success(`Android host created: ${result.directory}`);
+        return;
+    }
+    if (platform === "web") {
+        const resolvedProfile = resolveProfile(config, profile);
+        assert(hasWebConfiguration(context.root) || Boolean(resolvedProfile.web?.script), "WEB_CONFIGURATION_REQUIRED", "No Lynx Web configuration was detected. Add environments.web to lynx.config.* or configure build.<profile>.web.script.");
+        return;
+    }
+    if (platform === "harmony") {
+        assert(hasHarmonyHost(context.root), "HARMONY_HOST_REQUIRED", "No complete HarmonyOS host was found. Add an official Lynx Harmony host under harmony/ before building.");
+        return;
+    }
+    if (platform === "desktop") {
+        const resolvedProfile = resolveProfile(config, profile);
+        assert(await hasDesktopHost(context.root, resolvedProfile), "DESKTOP_HOST_REQUIRED", "No Lynxtron desktop host was found. Use the official Lynxtron template or configure a pack script before building.");
+        return;
+    }
+    assert(process.platform === "darwin", "IOS_MACOS_REQUIRED", "iOS hosts and IPA builds require macOS with Xcode. Run this build on macOS or a macOS CI worker.");
+    const resolvedProfile = resolveProfile(config, profile);
+    if (hasIosHost(context.root, resolvedProfile))
+        return;
+    assert(!(await exists(join(context.root, "ios"))), "IOS_HOST_EXISTS", "An ios/ directory exists but does not contain a usable Xcode host. LynxShip will not overwrite it; repair it deliberately, then rerun the build.");
+    const suggestedId = suggestedIosBundleIdentifier(context.root);
+    const appConfig = await loadAppConfig(context.root);
+    const configuredBundleIdentifier = appConfig?.config.platform?.ios?.bundleIdentifier;
+    const bundleIdentifier = context.flag("--bundle-identifier") ??
+        configuredBundleIdentifier ??
+        (context.ui.interactive
+            ? await context.prompt("iOS bundle identifier", suggestedId)
+            : "");
+    assert(bundleIdentifier, "IOS_HOST_REQUIRED", `No iOS host exists. Run \`lynxship ios host init --bundle-identifier ${suggestedId}\` or pass --bundle-identifier <id> to build in non-interactive mode.`);
+    context.ui.info("No iOS host found. Creating the official LynxShip host before the build…");
+    const result = await initializeIosHost(context.root, {
+        bundleIdentifier,
+        appName: appConfig?.config.appName ?? basename(context.root),
+        appIcon: context.flag("--icon") ?? appConfig?.config.appIcon ?? undefined,
+    });
+    context.ui.success(`iOS host created: ${result.directory}`);
+}

package/dist/commands/remote-build.d.ts

@@ -0,0 +1,35 @@
+import type { BuildJob, Platform } from "@lynxship/contracts";
+import type { BuildSourceReference } from "@lynxship/contracts";
+import type { LynxShipConfig } from "../config.js";
+import { type RemoteCliState } from "../remote.js";
+import { type CliState } from "../runtime/state.js";
+import type { LoadedCliState } from "../runtime/state.js";
+import type { BoxRow } from "../ui/components.js";
+export interface RemoteBuildOptions {
+    root: string;
+    config: LynxShipConfig;
+    state: CliState & RemoteCliState;
+    loaded: LoadedCliState;
+    platform: Platform;
+    profile: string;
+    wait: boolean;
+    source?: BuildSourceReference;
+    printValue: (value: unknown, view?: {
+        title: string;
+        rows: BoxRow[];
+        done: string;
+    }) => void;
+    ui: {
+        info(message: string): void;
+        progress(label: string): {
+            update(value?: number, label?: string): void;
+            event(message: string): void;
+            stop(): void;
+        };
+    };
+}
+export declare function executeRemoteBuild(options: RemoteBuildOptions): Promise<BuildJob>;
+export declare function prepareRemoteSource(root: string, config: LynxShipConfig, state: RemoteCliState, progress?: {
+    update(value?: number, label?: string): void;
+}): Promise<BuildSourceReference>;
+//# sourceMappingURL=remote-build.d.ts.map

package/dist/commands/remote-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-build.d.ts","sourceRoot":"","sources":["../../src/commands/remote-build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIlD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,QAAQ,GAAG,cAAc,CAAC;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,CACV,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KACnD,IAAI,CAAC;IACV,EAAE,EAAE;QACF,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG;YACvB,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YAC7B,IAAI,IAAI,IAAI,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,QAAQ,CAAC,CAkDnB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,QAAQ,CAAC,EAAE;IAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC1D,OAAO,CAAC,oBAAoB,CAAC,CAS/B"}

package/dist/commands/remote-build.js

@@ -0,0 +1,73 @@
+import { createSourceSnapshot } from "@lynxship/build-orchestrator";
+import { createRemoteBuild, uploadBuildSource, waitForRemoteBuild, } from "../remote.js";
+import { saveState } from "../runtime/state.js";
+const maxRemoteSourceBytes = 72 * 1024 * 1024;
+export async function executeRemoteBuild(options) {
+    const progress = options.ui.progress("Remote LynxShip build");
+    try {
+        const source = options.source ??
+            (await prepareRemoteSource(options.root, options.config, options.state, progress));
+        progress.update(undefined, "Queueing the remote build…");
+        const created = await createRemoteBuild(options.config, options.state, {
+            platform: options.platform,
+            profile: options.profile,
+            source,
+        });
+        rememberRemoteJob(options.loaded, created);
+        await saveState(options.state, options.loaded.repository, options.loaded.builds, options.loaded.submissions);
+        if (!options.wait) {
+            progress.update(100, "Remote build queued");
+            printRemoteBuild(options, created, source);
+            return created;
+        }
+        progress.update(undefined, `Waiting for remote build ${created.id}…`);
+        const result = await waitForRemoteBuild(options.config, created.id, {
+            pollMs: 2_000,
+        });
+        rememberRemoteJob(options.loaded, result);
+        await saveState(options.state, options.loaded.repository, options.loaded.builds, options.loaded.submissions);
+        progress.update(100, `Remote build ${result.state}`);
+        printRemoteBuild(options, result, source);
+        if (result.state === "failed" || result.state === "timed_out")
+            process.exitCode = 5;
+        return result;
+    }
+    finally {
+        progress.stop();
+    }
+}
+export async function prepareRemoteSource(root, config, state, progress) {
+    progress?.update(undefined, "Creating a reproducible source snapshot…");
+    const snapshot = await createSourceSnapshot(root);
+    if (snapshot.bytes.length > maxRemoteSourceBytes)
+        throw new Error(`Remote source snapshot is ${(snapshot.bytes.length / 1024 / 1024).toFixed(1)} MiB; the current JSON upload limit is ${maxRemoteSourceBytes / 1024 / 1024} MiB. Remove generated or unnecessary files and retry.`);
+    progress?.update(undefined, "Uploading the verified source snapshot…");
+    return uploadBuildSource(config, state, snapshot.bytes);
+}
+function rememberRemoteJob(loaded, job) {
+    loaded.builds.restore([
+        ...loaded.builds.list().filter((candidate) => candidate.id !== job.id),
+        job,
+    ]);
+}
+function printRemoteBuild(options, job, source) {
+    options.ui.info(`Remote build ${job.id}: ${job.state} · source ${source.hash.slice(0, 12)}… (${source.fileCount} files)`);
+    options.printValue({ ...job, source }, {
+        title: "Remote build result",
+        rows: [
+            { label: "Build ID", value: job.id, valueColor: "purple" },
+            { label: "Platform", value: job.platform, valueColor: "blue" },
+            { label: "Profile", value: job.profile, valueColor: "text" },
+            {
+                label: "Status",
+                value: job.state,
+                valueColor: job.state === "success" ? "green" : "yellow",
+            },
+        ],
+        done: job.state === "success"
+            ? "Remote build complete. Run lynxship submit --latest to publish it."
+            : job.state === "created" || job.state === "queued"
+                ? "Remote build queued. Run lynxship build status <id> to check it."
+                : "Remote build did not complete successfully. Review the worker logs and retry it.",
+    });
+}

package/dist/commands/submit.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/commands/submit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAGL,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;IAChE,UAAU,EAAE,CACV,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KACnD,IAAI,CAAC;IACV,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,GAAG,KAAK,CAAC;IAC1D,+BAA+B,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,mBAAmB,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IACxD,KAAK,EAAE,QAAQ,CAAC;IAChB,UAAU,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsH5E"}

package/dist/commands/submit.js

@@ -0,0 +1,92 @@
+import { assert } from "@lynxship/contracts";
+import { AppStoreConnectApiProvider, GooglePlayApiProvider, } from "@lynxship/submit";
+import { loadCredentials } from "../secure-store.js";
+import { loadConfig } from "../config.js";
+import { submitRealArtifact } from "../remote.js";
+import { saveState } from "../runtime/state.js";
+export async function runSubmit(context) {
+    const { root, args, ui, flag, printValue, requireOperationalConfiguration, configuredProjectId, mobilePlatformValue, state, repository, builds, submissions, } = context;
+    const config = await loadConfig(root);
+    const platform = mobilePlatformValue(flag("--platform", "android"));
+    await requireOperationalConfiguration(platform);
+    const credentials = await loadCredentials(root);
+    const localMode = args.includes("--local") || process.env.LYNXSHIP_SUBMIT_MODE === "mock";
+    const storeConfigured = platform === "android"
+        ? Boolean(credentials.googlePlay)
+        : Boolean(credentials.appStoreConnect);
+    assert(localMode || storeConfigured, "STORE_SUBMISSION_REQUIRED", platform === "android"
+        ? "Google Play is not configured. Run store configure --platform android."
+        : "App Store Connect is not configured. Run store configure --platform ios.");
+    const candidate = builds
+        .list()
+        .filter((job) => job.platform === platform && job.state === "success")
+        .at(-1);
+    assert(candidate, "BUILD_REQUIRED", "A successful build is required");
+    assert(localMode || candidate.artifact?.path, "STORE_ARTIFACT_REQUIRED", "A local signed artifact path is required for store submission");
+    const latest = args.includes("--latest");
+    const spinner = ui.spinner("Submitting artifact…");
+    try {
+        const controlPlaneSubmission = candidate.artifact?.path
+            ? await submitRealArtifact(config, state, candidate, latest)
+            : await submissions.submit({
+                projectId: configuredProjectId(config),
+                organizationId: "local_org",
+                platform,
+                artifact: candidate.artifact ?? { hash: `local-${candidate.id}` },
+                latest,
+                buildId: latest ? null : candidate.id,
+            });
+        const storeResult = !localMode && candidate.artifact?.path
+            ? platform === "android"
+                ? await new GooglePlayApiProvider(credentials.googlePlay).submit({
+                    platform,
+                    path: candidate.artifact.path,
+                    hash: candidate.artifact.hash,
+                })
+                : await new AppStoreConnectApiProvider(credentials.appStoreConnect).submit({
+                    platform,
+                    path: candidate.artifact.path,
+                    hash: candidate.artifact.hash,
+                })
+            : undefined;
+        const submission = storeResult
+            ? {
+                ...controlPlaneSubmission,
+                store: storeResult,
+            }
+            : controlPlaneSubmission;
+        const result = submission;
+        spinner.succeed(storeResult
+            ? "Artifact submitted to the configured app store"
+            : "Local submission job accepted");
+        await saveState(state, repository, builds, submissions);
+        printValue(submission, {
+            title: "Submission result",
+            rows: [
+                {
+                    label: "Submission ID",
+                    value: result.id ?? "remote",
+                    valueColor: "purple",
+                },
+                {
+                    label: "Platform",
+                    value: result.platform ?? platform,
+                    valueColor: "blue",
+                },
+                {
+                    label: "Status",
+                    value: result.status ?? "accepted",
+                    valueColor: "green",
+                },
+            ],
+            done: "App submitted to the configured provider.",
+        });
+        if (result.downloadUrl)
+            ui.downloadArtifact(result.downloadUrl, result.downloadExpiresAt);
+    }
+    catch (error) {
+        spinner.fail(error instanceof Error ? error.message : "Submission failed");
+        throw error;
+    }
+    return;
+}

package/dist/ecosystem.d.ts

@@ -0,0 +1,9 @@
+export interface EcosystemPackage {
+    readonly name: string;
+    readonly category: "tool" | "runtime" | "adapter";
+    readonly purpose: string;
+    readonly installed: boolean;
+    readonly version?: string;
+}
+export declare function inspectEcosystem(root: string): Promise<readonly EcosystemPackage[]>;
+//# sourceMappingURL=ecosystem.d.ts.map

package/dist/ecosystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem.d.ts","sourceRoot":"","sources":["../src/ecosystem.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AA0FD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAYtC"}

package/dist/ecosystem.js

@@ -0,0 +1,95 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+const CATALOG = [
+    [
+        "@lynxship/lynx-library-tools",
+        "tool",
+        "Validate Lynx library manifests and plan official Autolink codegen.",
+    ],
+    [
+        "@lynxship/asset-pipeline",
+        "tool",
+        "Discover, hash, and verify build assets.",
+    ],
+    [
+        "@lynxship/test-kit",
+        "tool",
+        "Plan declared tests without pretending to emulate native hosts.",
+    ],
+    [
+        "@lynxship/permissions",
+        "runtime",
+        "Request permissions through an explicit native host adapter.",
+    ],
+    [
+        "@lynxship/router",
+        "runtime",
+        "Resolve routes, history, and deep-link paths.",
+    ],
+    [
+        "@lynxship/framework",
+        "runtime",
+        "Coordinate host lifecycle, bundle mounting, capabilities, and first-screen readiness.",
+    ],
+    [
+        "@lynxship/navigation",
+        "runtime",
+        "Validate navigation targets and delegate transitions to an injected host adapter.",
+    ],
+    [
+        "@lynxship/bridge",
+        "runtime",
+        "Expose allow-listed, bounded JavaScript-to-native calls through an injected transport.",
+    ],
+    [
+        "@lynxship/performance",
+        "runtime",
+        "Collect bounded Lynx performance entries and export them through an explicit sink.",
+    ],
+    [
+        "@lynxship/device-storage",
+        "runtime",
+        "Use an async device-storage adapter with typed JSON values.",
+    ],
+    [
+        "@lynxship/i18n",
+        "runtime",
+        "Resolve locales and translations without global state.",
+    ],
+    [
+        "@lynxship/media",
+        "runtime",
+        "Expose declared camera, microphone, and picker capabilities.",
+    ],
+    [
+        "@lynxship/observability",
+        "runtime",
+        "Buffer bounded, redacted events into an explicit sink.",
+    ],
+    [
+        "@lynxship/lynxtron",
+        "adapter",
+        "Verify Desktop/Lynxtron artifacts before host loading.",
+    ],
+    [
+        "@lynxship/tailwind-lynx",
+        "tool",
+        "Validate and plan the official Tailwind ReactLynx preset.",
+    ],
+    [
+        "@lynxship/ui-tokens",
+        "tool",
+        "Validate and emit deterministic design-token CSS.",
+    ],
+];
+export async function inspectEcosystem(root) {
+    const manifest = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
+    const installed = { ...manifest.dependencies, ...manifest.devDependencies };
+    return CATALOG.map(([name, category, purpose]) => ({
+        name,
+        category,
+        purpose,
+        installed: Boolean(installed[name]),
+        ...(installed[name] ? { version: installed[name] } : {}),
+    }));
+}

package/dist/frameworks.d.ts.map

@@ -1 +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"}
+{"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,CAmG7B"}

package/dist/frameworks.js

@@ -30,6 +30,10 @@ export async function detectLynxFramework(root) {
         "lynx.config.js",
         "lynx.config.mjs",
         "lynx.config.cjs",
+        "app.config.ts",
+        "app.config.js",
+        "app.config.mjs",
+        "app.config.cjs",
         "octane.config.ts",
         "octane.config.js",
     ];
@@ -85,7 +89,7 @@ export async function detectLynxFramework(root) {
         };
     }
     if (names.has("@lynx-js/rspeedy") ||
-        /rspeedy|environments\\s*:/i.test(config + scripts)) {
+        /rspeedy|lynxConfig\s*:|environments\s*:/i.test(config + scripts)) {
         return {
             framework: "vanilla",
             label: "Vanilla Lynx",

package/dist/guidance/catalog.d.ts

@@ -0,0 +1,3 @@
+import type { CliGuidance } from "./types.js";
+export declare const guidance: Record<string, CliGuidance>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/guidance/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/guidance/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAqfhD,CAAC"}