@multiplatform.one/cli 7.10.0 → 7.15.0

package/src/commands/initApp.spec.ts

@@ -1,720 +0,0 @@
-import {
-  existsSync,
-  mkdtempSync,
-  readFileSync,
-  readdirSync,
-  rmSync,
-  statSync,
-  writeFileSync,
-} from "node:fs";
-import { tmpdir } from "node:os";
-import { extname, join } from "node:path";
-import { afterAll, beforeAll, describe, expect, it } from "vitest";
-import { initApp, mergeJsonValues, readProvenance } from "./initApp";
-
-const readJson = (path: string) => JSON.parse(readFileSync(path, "utf-8"));
-
-/** Collect dependency ranges by scope for leakage assertions. */
-function depRanges(pkg: {
-  dependencies?: Record<string, string>;
-  devDependencies?: Record<string, string>;
-}): Record<string, string> {
-  return { ...pkg.dependencies, ...pkg.devDependencies };
-}
-
-describe("initApp generator", () => {
-  let sandbox: string;
-  let previousCwd: string;
-
-  beforeAll(() => {
-    sandbox = mkdtempSync(join(tmpdir(), "mpo-initapp-spec-"));
-    previousCwd = process.cwd();
-    process.chdir(sandbox);
-  });
-
-  afterAll(() => {
-    process.chdir(previousCwd);
-    rmSync(sandbox, { recursive: true, force: true });
-  });
-
-  describe("universal template", () => {
-    const name = "uni-demo";
-    let root: string;
-
-    beforeAll(async () => {
-      await initApp(name, {
-        template: "universal",
-        skipInstall: true,
-        version: "6.1.0",
-        yes: true,
-      });
-      root = join(sandbox, name);
-    });
-
-    it("writes the workspace tree", () => {
-      for (const file of [
-        "package.json",
-        "pnpm-workspace.yaml",
-        "tsconfig.base.json",
-        "oxlintrc.json",
-        "AGENTS.md",
-        "README.md",
-        ".gitignore",
-        ".npmrc",
-        `apps/${name}/package.json`,
-        `apps/${name}/vite.config.ts`,
-        `apps/${name}/app.config.js`,
-        `apps/${name}/tamagui.css`,
-        `apps/${name}/types.d.ts`,
-        `apps/${name}/config/tamagui.config.ts`,
-        `apps/${name}/routes/_layout.tsx`,
-        `apps/${name}/routes/_layout.web.tsx`,
-        `apps/${name}/routes/index.tsx`,
-        `apps/${name}/routes/about.tsx`,
-        `apps/${name}/src/app.ts`,
-        `apps/${name}/polyfills.ts`,
-        `apps/${name}/polyfills.native.ts`,
-        `features/${name}/package.json`,
-        `features/${name}/vitest.config.mjs`,
-        `features/${name}/src/HomeScreen.tsx`,
-        `features/${name}/src/AboutScreen.tsx`,
-        `features/${name}/src/AppLayout.tsx`,
-        `features/${name}/src/ContactForm.tsx`,
-        `features/${name}/src/ContactForm.spec.tsx`,
-        "packages/config/package.json",
-        "packages/i18n/en/common.json",
-        "packages/i18n/es/common.json",
-        "packages/i18n/resources.ts",
-        "packages/themes/tamagui.config.ts",
-        "packages/themes/fonts.ts",
-        "packages/themes/base.ts",
-        "packages/themes/accent.ts",
-        "types/env.d.ts",
-      ]) {
-        expect(existsSync(join(root, file)), `missing ${file}`).toBe(true);
-      }
-    });
-
-    it("restores dotfile names stripped by npm pack", () => {
-      expect(readFileSync(join(root, ".npmrc"), "utf-8")).toContain("node-linker=hoisted");
-      expect(readFileSync(join(root, ".gitignore"), "utf-8")).toContain("node_modules");
-      expect(existsSync(join(root, "npmrc"))).toBe(false);
-      expect(existsSync(join(root, "gitignore"))).toBe(false);
-    });
-
-    it("pins @multiplatform.one/* to semver and locals to workspace:*", () => {
-      for (const pkgPath of [
-        `apps/${name}/package.json`,
-        `features/${name}/package.json`,
-        "packages/i18n/package.json",
-        "packages/themes/package.json",
-      ]) {
-        const ranges = depRanges(readJson(join(root, pkgPath)));
-        for (const [dep, range] of Object.entries(ranges)) {
-          if (dep.startsWith("@multiplatform.one/")) {
-            expect(range, `${pkgPath} ${dep}`).toBe("^6.1.0");
-          } else if (dep.startsWith("@features/") || dep.startsWith("@package/")) {
-            expect(range, `${pkgPath} ${dep}`).toBe("workspace:*");
-          } else {
-            expect(range, `${pkgPath} ${dep} leaked a workspace range`).not.toMatch(/^workspace:/u);
-          }
-        }
-      }
-    });
-
-    it("renders template vars (no placeholders left)", () => {
-      const appPkg = readJson(join(root, `apps/${name}/package.json`));
-      expect(appPkg.name).toBe(`@app/${name}`);
-      const rootPkg = readJson(join(root, "package.json"));
-      expect(rootPkg.name).toBe(name);
-      const appConfig = readFileSync(join(root, `apps/${name}/app.config.js`), "utf-8");
-      expect(appConfig).toContain('name: "UniDemo"');
-      expect(appConfig).toContain("com.unidemo.app");
-      const viteConfig = readFileSync(join(root, `apps/${name}/vite.config.ts`), "utf-8");
-      expect(viteConfig).toContain('key: "UniDemo"');
-      for (const file of [
-        "package.json",
-        "README.md",
-        `apps/${name}/app.config.js`,
-        `features/${name}/src/HomeScreen.tsx`,
-        "packages/i18n/en/common.json",
-      ]) {
-        expect(readFileSync(join(root, file), "utf-8")).not.toMatch(/__NAME(_PASCAL|_APPID)?__/u);
-      }
-    });
-
-    it("wires universal scripts", () => {
-      const rootPkg = readJson(join(root, "package.json"));
-      for (const script of [
-        "dev",
-        "build",
-        "native",
-        "ios",
-        "android",
-        "test",
-        "lint",
-        "typecheck",
-      ]) {
-        expect(rootPkg.scripts[script], `root script ${script}`).toBeDefined();
-      }
-      const appPkg = readJson(join(root, `apps/${name}/package.json`));
-      expect(appPkg.scripts.dev).toContain("one dev");
-      expect(appPkg.scripts.build).toBe("one build");
-      expect(appPkg.scripts["prebuild:native"]).toBe("one prebuild");
-    });
-  });
-
-  describe("app (web-only) template regression", () => {
-    const name = "web-demo";
-    let root: string;
-
-    beforeAll(async () => {
-      await initApp(name, {
-        template: "app",
-        skipInstall: true,
-        version: "6.1.0",
-        yes: true,
-      });
-      root = join(sandbox, name);
-    });
-
-    it("keeps the web-only tree (no universal extras)", () => {
-      for (const file of [
-        "package.json",
-        ".npmrc",
-        ".gitignore",
-        `apps/${name}/vite.config.ts`,
-        `apps/${name}/src/main.tsx`,
-        `features/${name}/src/HomeScreen.tsx`,
-        "packages/config/package.json",
-      ]) {
-        expect(existsSync(join(root, file)), `missing ${file}`).toBe(true);
-      }
-      expect(existsSync(join(root, "packages/i18n"))).toBe(false);
-      expect(existsSync(join(root, "packages/themes"))).toBe(false);
-      expect(existsSync(join(root, `apps/${name}/routes`))).toBe(false);
-    });
-
-    it("keeps semver deps and web scripts", () => {
-      const appPkg = readJson(join(root, `apps/${name}/package.json`));
-      expect(appPkg.dependencies["@multiplatform.one/components"]).toBe("^6.1.0");
-      expect(appPkg.dependencies[`@features/${name}`]).toBe("workspace:*");
-      expect(appPkg.scripts.dev).toBe("vite");
-    });
-  });
-
-  describe("pieces-only template (adopted-project baselines)", () => {
-    const name = "adopt-base";
-    let root: string;
-
-    beforeAll(async () => {
-      await initApp(name, {
-        template: "none",
-        skipInstall: true,
-        skipGit: true,
-        version: "6.6.0",
-        yes: true,
-        pieces: ["webext"],
-      });
-      root = join(sandbox, name);
-    });
-
-    it("overlays ONLY the piece fragments (no base template)", () => {
-      for (const file of [
-        `apps/${name}/vite.config.webext.ts`,
-        `apps/${name}/webext/manifest.ts`,
-        `apps/${name}/webext/background/main.ts`,
-        `apps/${name}/package.json`,
-        ".gitignore",
-        "README.md",
-        "package.json",
-      ]) {
-        expect(existsSync(join(root, file)), `missing ${file}`).toBe(true);
-      }
-      // Base-template content must NOT leak in.
-      for (const file of [
-        "pnpm-workspace.yaml",
-        "tsconfig.base.json",
-        `features/${name}`,
-        "packages/config",
-        `apps/${name}/routes`,
-        `apps/${name}/vite.config.ts`,
-      ]) {
-        expect(existsSync(join(root, file)), `unexpected ${file}`).toBe(false);
-      }
-    });
-
-    it("creates partial targets from the fragments alone", () => {
-      // Root package.json = the webext fragment only — no template fields.
-      const rootPkg = readJson(join(root, "package.json"));
-      expect(Object.keys(rootPkg)).toEqual(["scripts"]);
-      expect(rootPkg.scripts["build:webext"]).toBe(`pnpm --filter @app/${name} build:webext`);
-      const manifest = readFileSync(join(root, `apps/${name}/webext/manifest.ts`), "utf-8");
-      expect(manifest).toContain('const DISPLAY_NAME = "AdoptBase"');
-      expect(manifest).not.toMatch(/__NAME(_PASCAL|_APPID)?__/u);
-    });
-
-    it("records template none in provenance", () => {
-      const provenance = readJson(join(root, ".mpo.json"));
-      expect(provenance.template).toBe("none");
-      expect(provenance.pieces).toEqual(["webext"]);
-      expect("reconciled" in provenance).toBe(false);
-      expect(readProvenance(root)?.template).toBe("none");
-    });
-
-    it("refuses a pieces-only scaffold without pieces", async () => {
-      await expect(
-        initApp("no-pieces-base", {
-          template: "none",
-          skipInstall: true,
-          skipGit: true,
-          yes: true,
-        }),
-      ).rejects.toThrow(/at least one piece/u);
-    });
-  });
-
-  it("rejects invalid names", async () => {
-    await expect(
-      initApp("Bad Name", { template: "app", skipInstall: true, yes: true }),
-    ).rejects.toThrow(/Invalid project name/u);
-  });
-
-  it("refuses to scaffold into a non-empty directory", async () => {
-    await initApp("occupied", { template: "app", skipInstall: true, yes: true });
-    await expect(
-      initApp("occupied", { template: "app", skipInstall: true, yes: true }),
-    ).rejects.toThrow(/already exists and is not empty/u);
-  });
-
-  describe("composable pieces", () => {
-    describe("webext piece", () => {
-      const name = "ext-demo";
-      let root: string;
-
-      beforeAll(async () => {
-        await initApp(name, {
-          template: "universal",
-          skipInstall: true,
-          skipGit: true,
-          version: "6.1.0",
-          yes: true,
-          pieces: ["webext"],
-        });
-        root = join(sandbox, name);
-      });
-
-      it("overlays the webext target files", () => {
-        for (const file of [
-          `apps/${name}/vite.config.webext.ts`,
-          `apps/${name}/vite.config.webext-background.ts`,
-          `apps/${name}/webext/env.ts`,
-          `apps/${name}/webext/manifest.ts`,
-          `apps/${name}/webext/prepare.ts`,
-          `apps/${name}/webext/tamagui.css`,
-          `apps/${name}/webext/tsconfig.json`,
-          `apps/${name}/webext/background/main.ts`,
-          `apps/${name}/webext/components/ErrorBoundary.tsx`,
-          `apps/${name}/webext/views/popup/index.html`,
-          `apps/${name}/webext/views/popup/main.tsx`,
-          `apps/${name}/webext/assets/fonts/inter-400.woff2`,
-          `apps/${name}/webext/assets/fonts/inter-700.woff2`,
-          `apps/${name}/webext/static/assets/icon-512.png`,
-        ]) {
-          expect(existsSync(join(root, file)), `missing ${file}`).toBe(true);
-        }
-      });
-
-      it("renders template vars in fragment files", () => {
-        const manifest = readFileSync(join(root, `apps/${name}/webext/manifest.ts`), "utf-8");
-        expect(manifest).toContain('const DISPLAY_NAME = "ExtDemo"');
-        for (const file of [
-          `apps/${name}/vite.config.webext.ts`,
-          `apps/${name}/webext/manifest.ts`,
-          `apps/${name}/webext/views/popup/main.tsx`,
-        ]) {
-          expect(readFileSync(join(root, file), "utf-8")).not.toMatch(/__NAME(_PASCAL|_APPID)?__/u);
-        }
-        const popup = readFileSync(join(root, `apps/${name}/webext/views/popup/main.tsx`), "utf-8");
-        expect(popup).toContain(`from "@features/${name}"`);
-      });
-
-      it("deep-merges package.json.partial into the app manifest", () => {
-        const appPkg = readJson(join(root, `apps/${name}/package.json`));
-        // base scripts survive, fragment scripts append
-        expect(appPkg.scripts.dev).toContain("one dev");
-        expect(appPkg.scripts["build:webext"]).toContain("vite.config.webext.ts");
-        expect(appPkg.scripts["typecheck:webext"]).toBe("tsc --noEmit -p webext/tsconfig.json");
-        // fragment deps merge in with rendered versions; base deps survive
-        expect(appPkg.dependencies["webextension-polyfill"]).toBe("^0.12.0");
-        expect(appPkg.dependencies["@multiplatform.one/router"]).toBe("^6.1.0");
-        expect(appPkg.dependencies[`@features/${name}`]).toBe("workspace:*");
-        expect(appPkg.devDependencies["@multiplatform.one/vite-plugin-webext"]).toBe("^6.1.0");
-        // dependency maps stay sorted after the merge
-        for (const field of ["dependencies", "devDependencies"]) {
-          const keys = Object.keys(appPkg[field]);
-          expect(keys, `${field} sorted`).toEqual([...keys].sort());
-        }
-      });
-
-      it("unions tsconfig types and root scripts, appends gitignore", () => {
-        const tsconfig = readJson(join(root, `apps/${name}/tsconfig.json`));
-        expect(tsconfig.compilerOptions.types).toEqual(["vite/client", "node"]);
-        const rootPkg = readJson(join(root, "package.json"));
-        expect(rootPkg.scripts["build:webext"]).toBe(`pnpm --filter @app/${name} build:webext`);
-        const gitignore = readFileSync(join(root, ".gitignore"), "utf-8");
-        expect(gitignore).toContain("node_modules");
-        expect(gitignore).toContain("dist-webext");
-      });
-
-      it("records pieces in provenance", () => {
-        const provenance = readJson(join(root, ".mpo.json"));
-        expect(provenance.pieces).toEqual(["webext"]);
-        expect(readProvenance(root)?.pieces).toEqual(["webext"]);
-      });
-    });
-
-    describe("frappe + keycloak pieces", () => {
-      const name = "backend-demo";
-      let root: string;
-
-      beforeAll(async () => {
-        await initApp(name, {
-          template: "universal",
-          skipInstall: true,
-          skipGit: true,
-          version: "6.1.0",
-          yes: true,
-          // intentionally unsorted — provenance must sort
-          pieces: ["keycloak", "frappe"],
-        });
-        root = join(sandbox, name);
-      });
-
-      it("generates src/app.ts from the selected providers", () => {
-        const appTs = readFileSync(join(root, `apps/${name}/src/app.ts`), "utf-8");
-        expect(appTs).toContain('import { config } from "@multiplatform.one/platform"');
-        expect(appTs).toContain('frappe: { baseURL: config.get("FRAPPE_URL") }');
-        expect(appTs).toContain('keycloak: { baseUrl: config.get("KEYCLOAK_BASE_URL") }');
-        expect(appTs).toContain("theme: themeConfig");
-      });
-
-      it("accumulates public config keys across pieces", () => {
-        const config = readJson(join(root, "packages/config/config.json"));
-        expect(config.public).toEqual([
-          "BASE_URL",
-          "DEBUG",
-          "I18N_DEFAULT_LANGUAGE",
-          "FRAPPE_ENABLED",
-          "FRAPPE_URL",
-          "KEYCLOAK_ENABLED",
-          "KEYCLOAK_BASE_URL",
-          "KEYCLOAK_REALM",
-          "KEYCLOAK_CLIENT_ID",
-          "KEYCLOAK_PUBLIC_CLIENT_ID",
-        ]);
-        expect(config.private).toEqual(["SECRET"]);
-      });
-
-      it("writes env, docker, and README fragments", () => {
-        const env = readFileSync(join(root, ".env.example"), "utf-8");
-        expect(env).toContain("FRAPPE_ENABLED=1");
-        expect(env).toContain("KEYCLOAK_ENABLED=1");
-        expect(env).toContain(`KEYCLOAK_REALM=${name}`);
-        expect(existsSync(join(root, "docker/compose.frappe.yaml"))).toBe(true);
-        expect(existsSync(join(root, "docker/compose.keycloak.yaml"))).toBe(true);
-        const realm = readJson(join(root, "docker/keycloak/realm.json"));
-        expect(realm.realm).toBe(name);
-        expect(realm.clients[1].clientId).toBe(`${name}-public`);
-        const readme = readFileSync(join(root, "README.md"), "utf-8");
-        expect(readme).toContain("## Frappe backend");
-        expect(readme).toContain("## Keycloak auth");
-        // Fixtures are a supported way to run the generated app (MPO-228),
-        // so the README has to say how.
-        expect(readme).toContain("### Running against fixtures, with no bench");
-        expect(readme).toContain("frappe: { fixtures }");
-      });
-
-      // Two measured first-boot failures, both cheap to reintroduce. The
-      // keycloak image ships /opt/keycloak/data (keycloak-owned) and no
-      // h2/ subdirectory: a named volume mounted at data/h2 materializes
-      // root-owned, and Keycloak (uid 1000) dies with H2 90028 on a FRESH
-      // volume — it reads like corruption and survives `down -v`, because
-      // the wipe recreates the same root-owned mount point. And a
-      // hardcoded 8080 collides with whatever already owns the most
-      // contested dev port; a yaml !override in a second compose file is
-      // not a safe alternative (compose versions without the tag drop the
-      // whole ports list silently — container healthy, unreachable).
-      it("keeps the dev keycloak bootable: data/ volume, parameterized port", () => {
-        const compose = readFileSync(join(root, "docker/compose.keycloak.yaml"), "utf-8");
-        expect(compose).toContain('"${KEYCLOAK_HTTP_PORT:-8080}:8080"');
-        expect(
-          compose,
-          "volume mounts data/, which the image ships with keycloak ownership",
-        ).toMatch(/^\s*- keycloak:\/opt\/keycloak\/data$/mu);
-        expect(compose).not.toMatch(/^\s*- keycloak:\/opt\/keycloak\/data\/h2$/mu);
-      });
-
-      it("records pieces sorted in provenance", () => {
-        expect(readJson(join(root, ".mpo.json")).pieces).toEqual(["frappe", "keycloak"]);
-      });
-    });
-
-    describe("kitchen sink (all pieces)", () => {
-      const name = "full-demo";
-      let root: string;
-
-      beforeAll(async () => {
-        await initApp(name, {
-          template: "universal",
-          skipInstall: true,
-          skipGit: true,
-          version: "6.1.0",
-          yes: true,
-          pieces: ["frappe", "gnome", "keycloak", "tauri", "vscode", "webext"],
-        });
-        root = join(sandbox, name);
-      });
-
-      it("overlays every target", () => {
-        for (const file of [
-          `apps/${name}/vite.config.gnome.ts`,
-          `apps/${name}/gnome/main.tsx`,
-          `apps/${name}/gnome/polyfills.ts`,
-          `apps/${name}/gnome/anchor.tsx`,
-          `apps/${name}/gnome/tamagui-barrel.ts`,
-          `apps/${name}/gnome/shims/components.ts`,
-          `apps/${name}/gnome/shims/theme.ts`,
-          `apps/${name}/gnome/shims/forms.ts`,
-          `apps/${name}/gnome/shims/frappe-ui.ts`,
-          `apps/${name}/gnome/shims/one.ts`,
-          `apps/${name}/gnome/shims/empty-module.ts`,
-          `apps/${name}/vite.config.vscode.ts`,
-          `apps/${name}/vscode/extension/index.ts`,
-          `apps/${name}/vscode/webview/main.tsx`,
-          `apps/${name}/vscode/webview/router.tsx`,
-          `apps/${name}/vscode/package.json`,
-          `apps/${name}/vscode/manifest.ts`,
-          `apps/${name}/vite.config.webext.ts`,
-          `apps/${name}/webext/manifest.ts`,
-          `apps/${name}/src-tauri/tauri.conf.json`,
-          `apps/${name}/src-tauri/Cargo.toml`,
-          `apps/${name}/src-tauri/build.rs`,
-          `apps/${name}/src-tauri/src/main.rs`,
-          `apps/${name}/src-tauri/src/lib.rs`,
-          `apps/${name}/src-tauri/capabilities/default.json`,
-          `apps/${name}/src-tauri/icons/icon.icns`,
-          "docker/compose.frappe.yaml",
-          "docker/compose.keycloak.yaml",
-        ]) {
-          expect(existsSync(join(root, file)), `missing ${file}`).toBe(true);
-        }
-        const rootPkg = readJson(join(root, "package.json"));
-        for (const script of [
-          "gnome",
-          "gnome:capture",
-          "build:vscode",
-          "build:webext",
-          "tauri:dev",
-          "tauri:build",
-        ]) {
-          expect(rootPkg.scripts[script], `root script ${script}`).toBeDefined();
-        }
-      });
-
-      // Tauri and GNOME are peer desktop targets — the kitchen sink proves
-      // they co-select: one scaffold carries both the src-tauri webview
-      // shell and the GTK/GJS gnome target side by side.
-      it("keeps tauri and gnome as co-selected desktop targets", () => {
-        expect(existsSync(join(root, `apps/${name}/src-tauri/tauri.conf.json`))).toBe(true);
-        expect(existsSync(join(root, `apps/${name}/vite.config.gnome.ts`))).toBe(true);
-        const appPkg = readJson(join(root, `apps/${name}/package.json`));
-        expect(appPkg.scripts["tauri:dev"]).toBe("tauri dev");
-        expect(appPkg.devDependencies["@tauri-apps/cli"]).toBeDefined();
-        expect(appPkg.scripts.gnome).toBeDefined();
-      });
-
-      // The GNOME target is the only piece that rewires module resolution
-      // rather than just adding files, and both halves of that rewiring
-      // fail silently if they drift. A shim that imports the bare barrel
-      // it is aliased FROM resolves back to itself — an infinite alias
-      // loop that surfaces as an out-of-memory bundler, not an import
-      // error. And the react-gnome packages are the runtime: without them
-      // the entry resolves nothing at all.
-      it("wires the gnome target without aliasing a shim back to itself", () => {
-        const aliased = ["components", "theme", "forms", "frappe-ui"] as const;
-        for (const barrel of aliased) {
-          const shim = readFileSync(join(root, `apps/${name}/gnome/shims/${barrel}.ts`), "utf-8");
-          expect(shim, `${barrel} shim must deep-import, never the bare barrel`).not.toMatch(
-            new RegExp(String.raw`from "@multiplatform\.one/${barrel}"`, "u"),
-          );
-          expect(shim, `${barrel} shim reaches its subgraph`).toMatch(
-            new RegExp(String.raw`@multiplatform\.one/${barrel}/src/`, "u"),
-          );
-        }
-        const appPkg = readJson(join(root, `apps/${name}/package.json`));
-        for (const dep of [
-          "@react-gnome/renderer",
-          "@react-gnome/react-native",
-          "@react-gnome/animation",
-          "@react-gnome/tamagui",
-        ]) {
-          expect(appPkg.dependencies[dep], `runtime dep ${dep}`).toBeDefined();
-        }
-        expect(appPkg.devDependencies["@react-gnome/vite-plugin"]).toBeDefined();
-        expect(appPkg.devDependencies["@multiplatform.one/vite-plugin-gnome"]).toBeDefined();
-        // polyfills must be the FIRST import: the globals have to exist
-        // before any hoisted module initializer probes for them.
-        const entry = readFileSync(join(root, `apps/${name}/gnome/main.tsx`), "utf-8");
-        const firstImport = entry.split("\n").find((line) => line.startsWith("import "));
-        expect(firstImport).toBe(`import "./polyfills";`);
-      });
-
-      // The other half of that rewiring, and the half that fails most
-      // quietly. `@multiplatform.one/platform` ships its GNOME flags as
-      // `index.gnome.ts`, and the ONLY thing that selects that file is
-      // `.gnome.*` sitting ahead of react-gnome's `.native.*` in
-      // resolve.extensions. Drop the registration and a scaffolded project
-      // still builds, still runs, and reports `isGnome: false` forever.
-      it("registers .gnome.* ahead of .native.* so isGnome resolves", () => {
-        const config = readFileSync(join(root, `apps/${name}/vite.config.gnome.ts`), "utf-8");
-        expect(config, "gnomePlatformExtensions must be imported").toMatch(
-          /import\s*\{[^}]*\bgnomePlatformExtensions\b[^}]*\}\s*from\s*"@multiplatform\.one\/vite-plugin-gnome"/u,
-        );
-        expect(config, ".gnome.* must be registered ahead of .native.*").toMatch(
-          /extensions:\s*\[\s*\.\.\.gnomePlatformExtensions\s*,\s*\.\.\.gnomeExtensions\s*,?\s*\]/u,
-        );
-      });
-
-      // The @react-gnome aliases must not assume the scope sits in the
-      // app's OWN node_modules: the scaffold's .npmrc sets
-      // node-linker=hoisted, so every dependency hoists to the workspace
-      // root, the app-local dir never exists, and every alias points at a
-      // nonexistent path (measured — the build fails resolving the
-      // renderer). require.resolve cannot do the lookup either, because
-      // the @react-gnome export maps hide package.json; the config walks
-      // up to whichever node_modules holds the scope. And the registry
-      // tarballs ship dist ONLY (files: ["dist", …]), so the renderer
-      // alias needs a dist fallback when there is no src checkout.
-      it("finds @react-gnome by walking up, with a dist fallback for registry tarballs", () => {
-        const config = readFileSync(join(root, `apps/${name}/vite.config.gnome.ts`), "utf-8");
-        expect(config, "walk-up helper must exist").toContain("function reactGnomeScopeDir()");
-        expect(config, "aliases must use the walk-up, not the app-local dir").toMatch(
-          /gnomeLinkedAliases\(reactGnomeScopeDir\(\)\)/u,
-        );
-        expect(config, "renderer alias needs the dist fallback").toContain(
-          "renderer/dist/index.js",
-        );
-      });
-
-      it("leaves no template placeholders anywhere", () => {
-        const binary = new Set([".woff2", ".png", ".ico", ".icns"]);
-        const walk = (dir: string): string[] =>
-          readdirSync(dir).flatMap((entry) => {
-            const path = join(dir, entry);
-            if (statSync(path).isDirectory()) return walk(path);
-            return [path];
-          });
-        for (const file of walk(root)) {
-          if (binary.has(extname(file).toLowerCase())) continue;
-          expect(readFileSync(file, "utf-8"), `placeholder left in ${file}`).not.toMatch(
-            /__NAME(_PASCAL|_APPID)?__|__MPO_VERSION__|__YEAR__/u,
-          );
-        }
-      });
-
-      it("scaffolds deterministically (update baselines depend on it)", async () => {
-        // Same name in a different parent dir (paths and rendered content
-        // embed the project name); pieces passed in a different order.
-        const parent = mkdtempSync(join(tmpdir(), "mpo-again-"));
-        const cwd = process.cwd();
-        process.chdir(parent);
-        try {
-          await initApp(name, {
-            template: "universal",
-            skipInstall: true,
-            skipGit: true,
-            version: "6.1.0",
-            yes: true,
-            pieces: ["webext", "vscode", "tauri", "keycloak", "gnome", "frappe"],
-          });
-        } finally {
-          process.chdir(cwd);
-        }
-        const other = join(parent, name);
-        const rel = (dir: string, base: string): string[] =>
-          readdirSync(dir).flatMap((entry) => {
-            const path = join(dir, entry);
-            if (statSync(path).isDirectory()) return rel(path, base);
-            return [path.slice(base.length + 1)];
-          });
-        const ours = rel(root, root).sort();
-        expect(rel(other, other).sort()).toEqual(ours);
-        for (const file of ours) {
-          const a = readFileSync(join(root, file));
-          const b = readFileSync(join(other, file));
-          expect(b.equals(a), `content differs for ${file}`).toBe(true);
-        }
-        rmSync(parent, { recursive: true, force: true });
-      });
-    });
-
-    it("rejects pieces on the web-only template", async () => {
-      await expect(
-        initApp("web-pieces", {
-          template: "app",
-          skipInstall: true,
-          skipGit: true,
-          yes: true,
-          pieces: ["webext"],
-        }),
-      ).rejects.toThrow(/not available for the app template/u);
-    });
-
-    it("rejects unknown pieces", async () => {
-      await expect(
-        initApp("bogus-pieces", {
-          template: "universal",
-          skipInstall: true,
-          skipGit: true,
-          yes: true,
-          pieces: ["solana" as never],
-        }),
-      ).rejects.toThrow(/Unknown piece "solana"/u);
-    });
-
-    it("defaults provenance pieces to [] for pre-piece scaffolds", () => {
-      const legacy = mkdtempSync(join(tmpdir(), "mpo-legacy-prov-"));
-      writeFileSync(
-        join(legacy, ".mpo.json"),
-        JSON.stringify({
-          template: "universal",
-          cliVersion: "6.4.0",
-          name: "legacy",
-          mpoVersion: "^6.4.0",
-        }),
-      );
-      expect(readProvenance(legacy)?.pieces).toEqual([]);
-      rmSync(legacy, { recursive: true, force: true });
-    });
-  });
-
-  describe("mergeJsonValues", () => {
-    it("unions arrays preserving base order", () => {
-      expect(mergeJsonValues(["a", "b"], ["b", "c"])).toEqual(["a", "b", "c"]);
-    });
-
-    it("merges nested objects with fragment scalars winning", () => {
-      expect(
-        mergeJsonValues(
-          { scripts: { dev: "vite" }, private: true },
-          { scripts: { build: "vite build", dev: "vite --host" } },
-        ),
-      ).toEqual({ scripts: { dev: "vite --host", build: "vite build" }, private: true });
-    });
-
-    it("replaces on type mismatch", () => {
-      expect(mergeJsonValues({ a: 1 }, ["x"])).toEqual(["x"]);
-    });
-  });
-});