hatchkit 0.1.1

package/dist/scaffold/pkg-json.js

@@ -0,0 +1,113 @@
+/*
+ * package.json surgery helpers for scaffoldApp.
+ *
+ * Every helper here reads the root `package.json` from the scaffolded
+ * output directory, mutates one field, and writes back. Kept in one
+ * place so the read/parse/write cycle stays consistent and so it's
+ * easy to swap for a more atomic approach later (e.g. one read, batched
+ * edits, one write).
+ */
+import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+export function stripPackageJsonScripts(outputDir, names) {
+    const path = join(outputDir, "package.json");
+    if (!existsSync(path))
+        return;
+    const pkg = JSON.parse(readFileSync(path, "utf-8"));
+    if (!pkg.scripts)
+        return;
+    for (const name of names)
+        delete pkg.scripts[name];
+    writeFileSync(path, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+}
+export function stripPackageJsonDeps(outputDir, names) {
+    const path = join(outputDir, "package.json");
+    if (!existsSync(path))
+        return;
+    const pkg = JSON.parse(readFileSync(path, "utf-8"));
+    for (const name of names) {
+        if (pkg.dependencies)
+            delete pkg.dependencies[name];
+        if (pkg.devDependencies)
+            delete pkg.devDependencies[name];
+        if (pkg.optionalDependencies)
+            delete pkg.optionalDependencies[name];
+    }
+    writeFileSync(path, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+}
+export function stripPackageJsonBuildBlock(outputDir) {
+    const path = join(outputDir, "package.json");
+    if (!existsSync(path))
+        return;
+    const pkg = JSON.parse(readFileSync(path, "utf-8"));
+    delete pkg.build;
+    writeFileSync(path, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+}
+/** Drop the `pnpm typecheck:electron` segment from the root `typecheck`
+ *  script regardless of where it sits in the `&&` chain. Handles:
+ *    "A && pnpm typecheck:electron"   → "A"
+ *    "pnpm typecheck:electron && A"   → "A"
+ *    "pnpm typecheck:electron"        → <script deleted entirely>
+ */
+export function unchainTypecheckScript(outputDir) {
+    const path = join(outputDir, "package.json");
+    if (!existsSync(path))
+        return;
+    const pkg = JSON.parse(readFileSync(path, "utf-8"));
+    if (!pkg.scripts?.typecheck)
+        return;
+    const ELECTRON_SEG = /\s*pnpm\s+typecheck:electron\s*/;
+    let script = pkg.scripts.typecheck;
+    script = script
+        .replace(new RegExp(`&&${ELECTRON_SEG.source}`), "")
+        .replace(new RegExp(`${ELECTRON_SEG.source}&&`), "")
+        .replace(ELECTRON_SEG, "")
+        .trim();
+    if (script) {
+        pkg.scripts.typecheck = script;
+    }
+    else {
+        delete pkg.scripts.typecheck;
+    }
+    writeFileSync(path, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+}
+/** Set a specific script entry in the root `package.json`. Creates
+ *  `scripts` if missing. */
+export function setPackageJsonScript(outputDir, name, value) {
+    const path = join(outputDir, "package.json");
+    if (!existsSync(path))
+        return;
+    const pkg = JSON.parse(readFileSync(path, "utf-8"));
+    pkg.scripts = pkg.scripts ?? {};
+    pkg.scripts[name] = value;
+    writeFileSync(path, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+}
+/** Read the `name` field from a workspace package's package.json. */
+export function readPackageName(pkgDir) {
+    const path = join(pkgDir, "package.json");
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const pkg = JSON.parse(readFileSync(path, "utf-8"));
+        return typeof pkg.name === "string" ? pkg.name : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Return every workspace package's `name` field from its package.json.
+ *  Used to populate Next's `transpilePackages` dynamically instead of
+ *  hardcoding `@starter/*` names. */
+export function readWorkspacePackageNames(outputDir) {
+    const packagesDir = join(outputDir, "packages");
+    if (!existsSync(packagesDir))
+        return [];
+    const names = [];
+    for (const entry of readdirSync(packagesDir)) {
+        const name = readPackageName(join(packagesDir, entry));
+        if (name)
+            names.push(name);
+    }
+    return names;
+}
+//# sourceMappingURL=pkg-json.js.map

package/dist/scaffold/pkg-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkg-json.js","sourceRoot":"","sources":["../../src/scaffold/pkg-json.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/starter-files.d.ts

@@ -0,0 +1,40 @@
+import type { ProjectConfig } from "../prompts.js";
+import type { ProjectPorts } from "../utils/ports.js";
+/** Literal string replacement across a file. Safe for any content —
+ *  `replaceAll` is literal (no regex interpretation). */
+export declare function replaceInFile(filePath: string, search: string, replace: string): void;
+/** Rewrite a file via a pure transform. No-op if the file is missing. */
+export declare function rewriteFile(path: string, fn: (content: string) => string): void;
+export declare function removeIfExists(path: string): void;
+/** Rewrite a server or client .env.example to use production URLs for
+ *  the project's domain. Swaps in TRUSTED_ORIGINS for native clients
+ *  when desktop or mobile is selected. Idempotent on repeat runs. */
+export declare function updateEnvExample(outputDir: string, relPath: string, config: ProjectConfig): void;
+/** Strip the MobileBridgeLoader import + mount from the client layout
+ *  when mobile isn't selected. Leaves the rest of the layout alone. */
+export declare function stripMobileBridgeFromLayout(outputDir: string): void;
+/** Overwrite `packages/client/next.config.ts` with a known-good
+ *  static-export config. `transpilePackages` is populated from the
+ *  actual workspace package names so a starter rename doesn't break
+ *  the exported client build. */
+export declare function flipNextConfigToStaticExport(outputDir: string): void;
+/** Rewrite every file in the starter that hard-codes the old default
+ *  ports (3000/5000) so each scaffolded project has its own coherent
+ *  port set. Targets covered:
+ *    • packages/server/.env.development       (PORT + URLs)
+ *    • packages/server/.env.example           (PORT line added)
+ *    • packages/client/.env.development       (PORT + API + WS URLs)
+ *    • packages/client/.env.example           (PORT line added)
+ *    • packages/server/Dockerfile             (ENV PORT, EXPOSE)
+ *    • packages/client/Dockerfile             (ENV PORT, EXPOSE)
+ *    • docker-compose.yml                      (server PORT env)
+ *    • scripts/dev.mjs                         (fixed-mode defaults)
+ *    • electron/main.ts                        (DEV_URL fallback)
+ *    • scripts/android-dev.sh + ios-dev.sh    (NEXT_PORT default)
+ *    • package.json dev:desktop script        (Next port + wait-on)
+ */
+export declare function applyPorts(outputDir: string, ports: ProjectPorts, opts: {
+    wantsDesktop: boolean;
+    wantsMobile: boolean;
+}): void;
+//# sourceMappingURL=starter-files.d.ts.map

package/dist/scaffold/starter-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-files.d.ts","sourceRoot":"","sources":["../../src/scaffold/starter-files.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD;yDACyD;AACzD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIrF;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAI/E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED;;qEAEqE;AACrE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAoChG;AAED;uEACuE;AACvE,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAUnE;AAED;;;iCAGiC;AACjC,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAmBpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GACpD,IAAI,CAyGN"}

package/dist/scaffold/starter-files.js

@@ -0,0 +1,197 @@
+/*
+ * Per-file customization helpers for scaffoldApp.
+ *
+ * These edits run after the starter has been copied into the output
+ * directory. Each helper is a pure function over one file (or a small
+ * group of files), so they're easy to unit-test in isolation.
+ */
+import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { readPackageName, readWorkspacePackageNames, setPackageJsonScript } from "./pkg-json.js";
+/** Literal string replacement across a file. Safe for any content —
+ *  `replaceAll` is literal (no regex interpretation). */
+export function replaceInFile(filePath, search, replace) {
+    if (!existsSync(filePath))
+        return;
+    const content = readFileSync(filePath, "utf-8");
+    writeFileSync(filePath, content.replaceAll(search, replace), "utf-8");
+}
+/** Rewrite a file via a pure transform. No-op if the file is missing. */
+export function rewriteFile(path, fn) {
+    if (!existsSync(path))
+        return;
+    const content = readFileSync(path, "utf-8");
+    writeFileSync(path, fn(content), "utf-8");
+}
+export function removeIfExists(path) {
+    if (existsSync(path)) {
+        rmSync(path, { recursive: true, force: true });
+    }
+}
+/** Rewrite a server or client .env.example to use production URLs for
+ *  the project's domain. Swaps in TRUSTED_ORIGINS for native clients
+ *  when desktop or mobile is selected. Idempotent on repeat runs. */
+export function updateEnvExample(outputDir, relPath, config) {
+    const path = join(outputDir, relPath);
+    if (!existsSync(path))
+        return;
+    const { domain } = config;
+    const appUrl = `https://${domain}`;
+    const apiUrl = `https://api.${domain}`;
+    const wsUrl = `wss://api.${domain}`;
+    let content = readFileSync(path, "utf-8");
+    // Targeted line-level rewrites. Each regex anchors on `KEY=` so stray
+    // "localhost" mentions inside comments / other keys aren't affected.
+    const rewrites = [
+        [/^FRONTEND_URL=.*$/m, `FRONTEND_URL=${appUrl}`],
+        [/^BETTER_AUTH_URL=.*$/m, `BETTER_AUTH_URL=${apiUrl}`],
+        [/^NEXT_PUBLIC_API_URL=.*$/m, `NEXT_PUBLIC_API_URL=${apiUrl}`],
+        [/^NEXT_PUBLIC_WS_URL=.*$/m, `NEXT_PUBLIC_WS_URL=${wsUrl}`],
+    ];
+    for (const [re, replacement] of rewrites) {
+        content = content.replace(re, replacement);
+    }
+    // Pre-populate TRUSTED_ORIGINS for native clients so the commented
+    // guidance in the starter's .env.example is replaced with a working
+    // default the user only has to uncomment.
+    const wantsDesktop = config.features.includes("desktop");
+    const wantsMobile = config.features.includes("mobile");
+    if ((wantsDesktop || wantsMobile) && /^#\s*TRUSTED_ORIGINS=/m.test(content)) {
+        const origins = [];
+        if (wantsMobile)
+            origins.push("capacitor://localhost", "https://localhost");
+        if (wantsDesktop)
+            origins.push("app://-");
+        content = content.replace(/^#\s*TRUSTED_ORIGINS=.*$/m, `TRUSTED_ORIGINS=${origins.join(",")}`);
+    }
+    writeFileSync(path, content, "utf-8");
+}
+/** Strip the MobileBridgeLoader import + mount from the client layout
+ *  when mobile isn't selected. Leaves the rest of the layout alone. */
+export function stripMobileBridgeFromLayout(outputDir) {
+    const path = join(outputDir, "packages/client/src/app/layout.tsx");
+    if (!existsSync(path))
+        return;
+    let content = readFileSync(path, "utf-8");
+    content = content.replace(/import\s*\{\s*MobileBridgeLoader\s*\}\s*from\s*["']@\/mobile\/MobileBridgeLoader["'];\n/, "");
+    content = content.replace(/\s*<MobileBridgeLoader\s*\/>\n/, "\n");
+    writeFileSync(path, content, "utf-8");
+}
+/** Overwrite `packages/client/next.config.ts` with a known-good
+ *  static-export config. `transpilePackages` is populated from the
+ *  actual workspace package names so a starter rename doesn't break
+ *  the exported client build. */
+export function flipNextConfigToStaticExport(outputDir) {
+    const path = join(outputDir, "packages/client/next.config.ts");
+    if (!existsSync(path))
+        return;
+    const clientName = readPackageName(join(outputDir, "packages/client"));
+    const transpile = readWorkspacePackageNames(outputDir).filter((n) => n !== clientName);
+    const transpileList = transpile.map((n) => `"${n}"`).join(", ");
+    const staticExportConfig = `import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  output: "export",
+  assetPrefix: "./",
+  trailingSlash: true,
+  images: { unoptimized: true },
+  transpilePackages: [${transpileList}],
+};
+
+export default nextConfig;
+`;
+    writeFileSync(path, staticExportConfig, "utf-8");
+}
+/** Rewrite every file in the starter that hard-codes the old default
+ *  ports (3000/5000) so each scaffolded project has its own coherent
+ *  port set. Targets covered:
+ *    • packages/server/.env.development       (PORT + URLs)
+ *    • packages/server/.env.example           (PORT line added)
+ *    • packages/client/.env.development       (PORT + API + WS URLs)
+ *    • packages/client/.env.example           (PORT line added)
+ *    • packages/server/Dockerfile             (ENV PORT, EXPOSE)
+ *    • packages/client/Dockerfile             (ENV PORT, EXPOSE)
+ *    • docker-compose.yml                      (server PORT env)
+ *    • scripts/dev.mjs                         (fixed-mode defaults)
+ *    • electron/main.ts                        (DEV_URL fallback)
+ *    • scripts/android-dev.sh + ios-dev.sh    (NEXT_PORT default)
+ *    • package.json dev:desktop script        (Next port + wait-on)
+ */
+export function applyPorts(outputDir, ports, opts) {
+    const { server, client, nativeHmr } = ports;
+    // .env.development (server) — set PORT + update URLs pointing at localhost:5000
+    rewriteFile(join(outputDir, "packages/server/.env.development"), (c) => {
+        let out = c;
+        if (/^PORT=/m.test(out)) {
+            out = out.replace(/^PORT=.*$/m, `PORT=${server}`);
+        }
+        else {
+            out = `PORT=${server}\n${out}`;
+        }
+        out = out.replace(/localhost:5000/g, `localhost:${server}`);
+        return out;
+    });
+    // .env.development (client) — set PORT + API/WS URLs
+    rewriteFile(join(outputDir, "packages/client/.env.development"), (c) => {
+        let out = c;
+        if (/^PORT=/m.test(out)) {
+            out = out.replace(/^PORT=.*$/m, `PORT=${client}`);
+        }
+        else {
+            out = `PORT=${client}\n${out}`;
+        }
+        out = out.replace(/^NEXT_PUBLIC_API_URL=.*$/m, `NEXT_PUBLIC_API_URL=http://localhost:${server}`);
+        out = out.replace(/^NEXT_PUBLIC_WS_URL=.*$/m, `NEXT_PUBLIC_WS_URL=ws://localhost:${server}`);
+        return out;
+    });
+    // .env.example files: add PORT line if missing, else overwrite.
+    for (const [rel, port] of [
+        ["packages/server/.env.example", server],
+        ["packages/client/.env.example", client],
+    ]) {
+        rewriteFile(join(outputDir, rel), (c) => {
+            if (/^PORT=/m.test(c))
+                return c.replace(/^PORT=.*$/m, `PORT=${port}`);
+            return `PORT=${port}\n${c}`;
+        });
+    }
+    // Server + client Dockerfiles: port-bearing lines.
+    rewriteFile(join(outputDir, "packages/server/Dockerfile"), (c) => c
+        .replace(/ENV PORT=\d+/g, `ENV PORT=${server}`)
+        .replace(/EXPOSE \d+/g, `EXPOSE ${server}`)
+        .replace(/\|\|'\d+'\)/g, `||'${server}')`));
+    rewriteFile(join(outputDir, "packages/client/Dockerfile"), (c) => c
+        .replace(/ENV PORT=\d+/g, `ENV PORT=${client}`)
+        .replace(/EXPOSE \d+/g, `EXPOSE ${client}`)
+        .replace(/\|\|'\d+'\)/g, `||'${client}')`));
+    // docker-compose.yml: server PORT first (appears first in file),
+    // then the client PORT if present.
+    rewriteFile(join(outputDir, "docker-compose.yml"), (c) => {
+        let out = c.replace(/PORT:\s*"3000"/, `PORT: "${server}"`);
+        out = out.replace(/PORT:\s*"3000"/, `PORT: "${client}"`);
+        return out;
+    });
+    // scripts/dev.mjs: bump fixed-mode defaults + the comment header
+    // that documents the default ports.
+    rewriteFile(join(outputDir, "scripts/dev.mjs"), (c) => c
+        .replace(/clientPort = 3000/g, `clientPort = ${client}`)
+        .replace(/apiPort = 5000/g, `apiPort = ${server}`)
+        .replace(/client 3000, docs 4000, server 5000/g, `client ${client}, docs 4000, server ${server}`));
+    // Native HMR port — only wired when desktop or mobile is selected.
+    if (nativeHmr === undefined)
+        return;
+    rewriteFile(join(outputDir, "electron/main.ts"), (c) => c.replace(/const DEV_URL = process\.env\.ELECTRON_DEV_URL \|\| "http:\/\/localhost:\d+"/, `const DEV_URL = process.env.ELECTRON_DEV_URL || "http://localhost:${nativeHmr}"`));
+    for (const script of ["scripts/android-dev.sh", "scripts/ios-dev.sh"]) {
+        rewriteFile(join(outputDir, script), (c) => c.replace(/NEXT_PORT="\$\{NEXT_PORT:-\d+\}"/, `NEXT_PORT="\${NEXT_PORT:-${nativeHmr}}"`));
+    }
+    // Root package.json: dev:desktop needs PORT + wait-on retargeted at
+    // nativeHmr so web-dev and desktop-dev don't stomp each other.
+    if (opts.wantsDesktop) {
+        const clientPkgName = readPackageName(join(outputDir, "packages/client")) ?? "@starter/client";
+        setPackageJsonScript(outputDir, "dev:desktop", `concurrently -k -n next,electron -c blue,magenta ` +
+            `"PORT=${nativeHmr} pnpm --filter ${clientPkgName} dev" ` +
+            `"wait-on http://localhost:${nativeHmr} && pnpm electron:compile && ` +
+            `ELECTRON_DEV_URL=http://localhost:${nativeHmr} electron electron/main.js"`);
+    }
+}
+//# sourceMappingURL=starter-files.js.map

package/dist/scaffold/starter-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-files.js","sourceRoot":"","sources":["../../src/scaffold/starter-files.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/update.d.ts

@@ -0,0 +1,8 @@
+import type { Feature } from "../prompts.js";
+export interface UpdateResult {
+    added: Feature[];
+    skipped: Feature[];
+    removed: Feature[];
+}
+export declare function runUpdate(projectDir: string): Promise<UpdateResult>;
+//# sourceMappingURL=update.d.ts.map

package/dist/scaffold/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/scaffold/update.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAoB7C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAiGzE"}

package/dist/scaffold/update.js

@@ -0,0 +1,255 @@
+/*
+ * `hatchkit update` — add feature scaffolding to an already-scaffolded
+ * project.
+ *
+ * Scope of this MVP:
+ *   • Read the .hatchkit.json manifest in cwd.
+ *   • Prompt for a new feature set (defaulting to the current one).
+ *   • REFUSE to remove features — that risks deleting user code built
+ *     on top of them. Removal stays a manual operation.
+ *   • For each newly-added feature, copy the starter's feature files
+ *     into the project and merge package.json edits.
+ *   • Refresh the manifest.
+ *
+ * Currently supported additions: `desktop`, `mobile`.
+ * `websocket` / `stripe` / `analytics` / `s3` additions are flagged
+ * as "manual" — the scaffold-time strip for those is coarse-grained
+ * and re-adding them cleanly would need per-feature merge logic that
+ * doesn't exist yet. Users can cherry-pick files from the starter.
+ */
+import { cpSync, existsSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { checkbox, confirm } from "@inquirer/prompts";
+import chalk from "chalk";
+import { addUsedPorts, getUsedPorts } from "../config.js";
+import { PORT_RANGES, pickPort } from "../utils/ports.js";
+import { getCliVersion } from "../utils/version.js";
+import { MANIFEST_FILENAME, readManifest, writeManifest, } from "./manifest.js";
+import { setPackageJsonScript } from "./pkg-json.js";
+import { applyPorts, rewriteFile } from "./starter-files.js";
+// Same derivation as scaffold/app.ts — STARTER_ROOT lives next to the
+// monorepo root, two hops up from this file's compiled location.
+const MONOREPO_ROOT = resolve(join(import.meta.dirname, "..", "..", ".."));
+const STARTER_ROOT = join(MONOREPO_ROOT, "starter");
+/** Features that `update` knows how to layer onto an existing project. */
+const SUPPORTED_ADDITIONS = ["desktop", "mobile"];
+export async function runUpdate(projectDir) {
+    const manifest = readManifest(projectDir);
+    if (!manifest) {
+        throw new Error(`No ${MANIFEST_FILENAME} found in ${projectDir}. This directory wasn't scaffolded by hatchkit, or the manifest was deleted.`);
+    }
+    if (!existsSync(STARTER_ROOT)) {
+        throw new Error(`Starter template not found at ${STARTER_ROOT}. Run 'git submodule update --init' in the monorepo root.`);
+    }
+    console.log(chalk.bold(`\n  ── Update: ${manifest.name} ─────────────────────────────\n`));
+    console.log(chalk.dim(`  Current features: ${manifest.features.join(", ") || "(none)"}`));
+    console.log(chalk.dim(`  Supported additions: ${SUPPORTED_ADDITIONS.join(", ")}`));
+    const allOptions = ["websocket", "stripe", "analytics", "s3", "desktop", "mobile"];
+    const desired = await checkbox({
+        message: "Desired feature set (current pre-selected):",
+        choices: allOptions.map((f) => ({
+            name: SUPPORTED_ADDITIONS.includes(f) || manifest.features.includes(f)
+                ? f
+                : `${f} (manual add only — use the starter repo directly)`,
+            value: f,
+            checked: manifest.features.includes(f),
+            disabled: !manifest.features.includes(f) && !SUPPORTED_ADDITIONS.includes(f),
+        })),
+    });
+    const current = new Set(manifest.features);
+    const next = new Set(desired);
+    const added = [...next].filter((f) => !current.has(f));
+    const removed = [...current].filter((f) => !next.has(f));
+    if (removed.length > 0) {
+        console.log(chalk.yellow(`\n  Refusing to remove features: ${removed.join(", ")}. Removing features risks deleting user code. Remove manually + update the manifest.`));
+    }
+    if (added.length === 0) {
+        console.log(chalk.dim("\n  No new features to add."));
+        return { added: [], skipped: [], removed };
+    }
+    const ok = await confirm({
+        message: `Add ${added.join(", ")} to ${manifest.name}?`,
+        default: true,
+    });
+    if (!ok)
+        return { added: [], skipped: added, removed };
+    const resolvedStarter = realpathSync(STARTER_ROOT);
+    const updatedFeatures = new Set(manifest.features);
+    let updatedPorts = manifest.ports;
+    for (const feature of added) {
+        if (feature === "desktop") {
+            await addDesktop(projectDir, resolvedStarter, manifest);
+            updatedFeatures.add("desktop");
+        }
+        else if (feature === "mobile") {
+            await addMobile(projectDir, resolvedStarter, manifest);
+            updatedFeatures.add("mobile");
+        }
+    }
+    // Pick a nativeHmr port if the project didn't have one and now needs one.
+    const needsNative = updatedFeatures.has("desktop") || updatedFeatures.has("mobile");
+    if (needsNative && updatedPorts.nativeHmr === undefined) {
+        const used = new Set(getUsedPorts());
+        const nativeHmr = await pickPort(PORT_RANGES.nativeHmr[0], PORT_RANGES.nativeHmr[1], used);
+        addUsedPorts([nativeHmr]);
+        updatedPorts = { ...updatedPorts, nativeHmr };
+        // Wire the new port into the freshly-added native scaffolding.
+        applyPorts(projectDir, updatedPorts, {
+            wantsDesktop: updatedFeatures.has("desktop"),
+            wantsMobile: updatedFeatures.has("mobile"),
+        });
+        console.log(chalk.dim(`  Assigned native HMR port: ${nativeHmr}`));
+    }
+    // Refresh the manifest so subsequent `update` runs see the new state.
+    const updatedManifest = {
+        ...manifest,
+        version: manifest.version,
+        cliVersion: getCliVersion(),
+        scaffoldedAt: manifest.scaffoldedAt, // preserve original date
+        features: [...updatedFeatures],
+        ports: updatedPorts,
+    };
+    writeManifest(projectDir, updatedManifest);
+    return { added, skipped: [], removed };
+}
+/** Copy desktop scaffolding from the starter + apply project-name
+ *  substitutions. Assumes the feature isn't already present. */
+async function addDesktop(projectDir, resolvedStarter, manifest) {
+    console.log(chalk.dim("\n  Adding desktop (Electron)..."));
+    copyFromStarter(resolvedStarter, projectDir, "electron");
+    copyFromStarter(resolvedStarter, projectDir, "build");
+    copyFromStarter(resolvedStarter, projectDir, "packages/client/src/types/electron.d.ts");
+    copyFromStarter(resolvedStarter, projectDir, ".github/workflows/desktop-release.yml");
+    // Merge package.json: pick up desktop scripts + build block + deps.
+    const starterPkg = readJson(join(resolvedStarter, "package.json"));
+    const projectPkgPath = join(projectDir, "package.json");
+    const projectPkg = readJson(projectPkgPath);
+    const bundleId = manifest.name.replace(/[^a-z0-9]/gi, "").toLowerCase();
+    const DESKTOP_SCRIPTS = [
+        "dev:desktop",
+        "dev:electron",
+        "build:desktop",
+        "electron:compile",
+        "electron:build",
+        "electron:preview",
+        "typecheck:electron",
+        "icons:desktop",
+        "itch:push:mac",
+        "itch:push:win",
+        "itch:push:linux",
+    ];
+    const DESKTOP_DEPS = ["electron", "electron-builder", "electron-icon-builder", "wait-on"];
+    projectPkg.scripts = projectPkg.scripts ?? {};
+    for (const name of DESKTOP_SCRIPTS) {
+        if (starterPkg.scripts?.[name])
+            projectPkg.scripts[name] = starterPkg.scripts[name];
+    }
+    projectPkg.devDependencies = projectPkg.devDependencies ?? {};
+    for (const name of DESKTOP_DEPS) {
+        if (starterPkg.devDependencies?.[name]) {
+            projectPkg.devDependencies[name] = starterPkg.devDependencies[name];
+        }
+    }
+    // electron-builder `build` block — only adopt it if the project
+    // doesn't already have one the user may have edited.
+    if (!projectPkg.build && starterPkg.build) {
+        projectPkg.build = JSON.parse(JSON.stringify(starterPkg.build)
+            .replaceAll("{{bundleId}}", bundleId)
+            .replaceAll("{{projectName}}", manifest.name));
+    }
+    writeFileSync(projectPkgPath, JSON.stringify(projectPkg, null, 2) + "\n", "utf-8");
+    // Chain electron typecheck into the root `typecheck` if present
+    // and not already chained.
+    if (projectPkg.scripts.typecheck &&
+        !projectPkg.scripts.typecheck.includes("typecheck:electron")) {
+        setPackageJsonScript(projectDir, "typecheck", `${projectPkg.scripts.typecheck} && pnpm typecheck:electron`);
+    }
+}
+/** Copy mobile (Capacitor) scaffolding + wire MobileBridgeLoader
+ *  into the client layout. Assumes the feature isn't already present. */
+async function addMobile(projectDir, resolvedStarter, manifest) {
+    console.log(chalk.dim("\n  Adding mobile (Capacitor)..."));
+    copyFromStarter(resolvedStarter, projectDir, "capacitor.config.ts");
+    copyFromStarter(resolvedStarter, projectDir, "packages/client/src/mobile");
+    copyFromStarter(resolvedStarter, projectDir, "resources");
+    copyFromStarter(resolvedStarter, projectDir, "scripts/android-dev.sh");
+    copyFromStarter(resolvedStarter, projectDir, "scripts/android-env.sh");
+    copyFromStarter(resolvedStarter, projectDir, "scripts/ios-dev.sh");
+    copyFromStarter(resolvedStarter, projectDir, ".github/workflows/mobile-release.yml");
+    // Substitute project identifiers into capacitor.config.ts.
+    const capPath = join(projectDir, "capacitor.config.ts");
+    const bundleId = manifest.name.replace(/[^a-z0-9]/gi, "").toLowerCase();
+    rewriteFile(capPath, (c) => c.replaceAll("{{projectName}}", manifest.name).replaceAll("{{bundleId}}", bundleId));
+    // Merge package.json scripts + deps.
+    const starterPkg = readJson(join(resolvedStarter, "package.json"));
+    const projectPkgPath = join(projectDir, "package.json");
+    const projectPkg = readJson(projectPkgPath);
+    const MOBILE_SCRIPTS = [
+        "dev:android",
+        "dev:ios",
+        "build:mobile",
+        "cap:add:ios",
+        "cap:add:android",
+        "cap:sync",
+        "cap:run:ios",
+        "cap:run:android",
+        "build:ios:release",
+        "build:android:release",
+        "build:android:apk",
+        "mobile:assets",
+    ];
+    const MOBILE_DEPS = [
+        "@capacitor/core",
+        "@capacitor/cli",
+        "@capacitor/ios",
+        "@capacitor/android",
+        "@capacitor/splash-screen",
+        "@capacitor/status-bar",
+        "@capacitor/screen-orientation",
+        "@capacitor/preferences",
+        "@capacitor/app",
+        "@capacitor/assets",
+    ];
+    projectPkg.scripts = projectPkg.scripts ?? {};
+    for (const name of MOBILE_SCRIPTS) {
+        if (starterPkg.scripts?.[name])
+            projectPkg.scripts[name] = starterPkg.scripts[name];
+    }
+    projectPkg.dependencies = projectPkg.dependencies ?? {};
+    projectPkg.devDependencies = projectPkg.devDependencies ?? {};
+    for (const name of MOBILE_DEPS) {
+        if (starterPkg.dependencies?.[name]) {
+            projectPkg.dependencies[name] = starterPkg.dependencies[name];
+        }
+        else if (starterPkg.devDependencies?.[name]) {
+            projectPkg.devDependencies[name] = starterPkg.devDependencies[name];
+        }
+    }
+    writeFileSync(projectPkgPath, JSON.stringify(projectPkg, null, 2) + "\n", "utf-8");
+    // Wire MobileBridgeLoader into the client layout if not already there.
+    const layoutPath = join(projectDir, "packages/client/src/app/layout.tsx");
+    if (existsSync(layoutPath)) {
+        let content = readFileSync(layoutPath, "utf-8");
+        if (!content.includes("MobileBridgeLoader")) {
+            // Insert the import + mount in well-known positions.
+            content = content.replace(/(import[^\n]+"@\/styles\/globals\.css";\n)/, `$1import { MobileBridgeLoader } from "@/mobile/MobileBridgeLoader";\n`);
+            content = content.replace(/(<body[^>]*>)\s*/, `$1\n        <MobileBridgeLoader />\n        `);
+            writeFileSync(layoutPath, content, "utf-8");
+        }
+    }
+}
+function copyFromStarter(starter, outputDir, rel) {
+    const src = join(starter, rel);
+    const dst = join(outputDir, rel);
+    if (!existsSync(src))
+        return;
+    if (existsSync(dst)) {
+        // Already present — skip to avoid clobbering user edits.
+        return;
+    }
+    cpSync(src, dst, { recursive: true });
+}
+function readJson(path) {
+    return JSON.parse(readFileSync(path, "utf-8"));
+}
+//# sourceMappingURL=update.js.map