@mnci/cli 4.50.0 → 4.52.0

package/dist/cli.js

@@ -8239,14 +8239,130 @@ function runKinds(options) {
   }
 }
 
-// src/workspace-diagnostics/check-invariants.use-case.ts
+// src/dev-servers/run-dev.use-case.ts
+var import_prompts4 = require("@inquirer/prompts");
+
+// src/dev-servers/spawn-project.client.ts
 var import_node_child_process = require("child_process");
+var import_node_readline = require("readline");
+var import_cross_spawn3 = __toESM(require("cross-spawn"));
+function spawnProject(workspaceRoot, project, target, onLine) {
+  const windows = process.platform === "win32";
+  const child = (0, import_cross_spawn3.default)("npx", ["nx", "run", `${project}:${target}`], { cwd: workspaceRoot, stdio: ["ignore", "pipe", "pipe"], detached: !windows });
+  for (const stream of [child.stdout, child.stderr]) {
+    if (stream !== null) {
+      (0, import_node_readline.createInterface)({ input: stream }).on("line", onLine);
+    }
+  }
+  const exited = new Promise((resolve2) => {
+    child.on("error", () => {
+      resolve2(1);
+    });
+    child.on("close", (code) => {
+      resolve2(code ?? 1);
+    });
+  });
+  const stop = () => {
+    if (child.pid === void 0 || child.exitCode !== null) {
+      return;
+    }
+    if (windows) {
+      (0, import_node_child_process.spawnSync)("taskkill", ["/pid", String(child.pid), "/T", "/F"], { stdio: "ignore" });
+    } else {
+      try {
+        process.kill(-child.pid, "SIGTERM");
+      } catch {
+        child.kill("SIGTERM");
+      }
+    }
+  };
+  return { stop, exited };
+}
+
+// src/dev-servers/startable-projects.use-case.ts
+var import_node_path36 = require("path");
+var START_SUFFIX = ":start";
+var NX_RUN = /\bnx run [^\s:]+:(\S+)/;
+function listStartableProjects(workspaceRoot) {
+  const manifestPath = (0, import_node_path36.join)(workspaceRoot, "package.json");
+  if (!fileExists(manifestPath)) {
+    return [];
+  }
+  const scripts = readJson(manifestPath).scripts ?? {};
+  return Object.entries(scripts).filter(([script]) => script.endsWith(START_SUFFIX)).map(([script, command]) => ({ project: script.slice(0, -START_SUFFIX.length), target: NX_RUN.exec(command)?.[1] ?? "start" })).toSorted((a, b) => a.project.localeCompare(b.project));
+}
+
+// src/dev-servers/run-dev.use-case.ts
+async function chooseProjects(available) {
+  return await (0, import_prompts4.checkbox)({
+    message: "Which projects should start together?",
+    choices: available.map((name) => ({ name, value: name })),
+    required: true
+  });
+}
+async function selectProjects(available, named, options, dependencies) {
+  const names = available.map((entry) => entry.project);
+  const unknown = named.filter((name) => !names.includes(name));
+  if (unknown.length > 0) {
+    throw new Error(`Cannot start ${unknown.join(", ")}: not a project with a start command. Startable: ${names.join(", ")}.`);
+  }
+  let chosen = named;
+  if (chosen.length === 0) {
+    if (options.all === true) {
+      chosen = names;
+    } else if (dependencies.interactive ?? process.stdin.isTTY) {
+      chosen = await (dependencies.choose ?? chooseProjects)(names);
+    } else {
+      throw new Error(`Name the projects to start, or pass --all. Startable: ${names.join(", ")}.`);
+    }
+  }
+  return available.filter((entry) => chosen.includes(entry.project));
+}
+async function runDev(workspaceRoot, named, options = {}, dependencies = {}) {
+  const available = listStartableProjects(workspaceRoot);
+  if (available.length === 0) {
+    throw new Error("No project here has a start command. Add an app (`mnci add`) first; libraries are not started.");
+  }
+  const selected = await selectProjects(available, named, options, dependencies);
+  for (const { project, target } of selected) {
+    logger.info(`${project}: nx run ${project}:${target}`);
+  }
+  if (options.dryRun === true) {
+    return;
+  }
+  const start = dependencies.start ?? ((project, target, onLine) => spawnProject(workspaceRoot, project, target, onLine));
+  const print = dependencies.print ?? ((line) => {
+    console.log(line);
+  });
+  const running = selected.map(({ project, target }) => start(project, target, (line) => {
+    print(`[${project}] ${line}`);
+  }));
+  const stopAll = () => {
+    for (const each of running) {
+      each.stop();
+    }
+  };
+  process.once("SIGINT", stopAll);
+  process.once("SIGTERM", stopAll);
+  const first = await Promise.race(running.map(async (each, index) => ({ index, status: await each.exited })));
+  stopAll();
+  await Promise.all(running.map(async (each) => await each.exited));
+  process.removeListener("SIGINT", stopAll);
+  process.removeListener("SIGTERM", stopAll);
+  logger.info(`${selected[first.index].project} stopped (${first.status}), so the rest were stopped too.`);
+  if (first.status !== 0) {
+    process.exitCode = first.status;
+  }
+}
+
+// src/workspace-diagnostics/check-invariants.use-case.ts
+var import_node_child_process2 = require("child_process");
 var import_node_fs32 = require("fs");
-var import_node_path37 = require("path");
+var import_node_path38 = require("path");
 
 // src/workspace-diagnostics/locate-stranded-release-tags.use-case.ts
 var import_node_fs31 = require("fs");
-var import_node_path36 = require("path");
+var import_node_path37 = require("path");
 
 // src/workspace-diagnostics/stranded-release-tags.algorithm.ts
 function compareVersions2(left, right) {
@@ -8283,7 +8399,7 @@ function locateStrandedReleaseTags(workspaceRoot, tagPattern) {
   if (listed.status !== 0) {
     return [];
   }
-  const projects = (0, import_node_fs31.globSync)("{apps,libs,packages}/*/package.json", { cwd: workspaceRoot }).map((path) => readJson((0, import_node_path36.join)(workspaceRoot, path))).filter((manifest) => manifest.private !== true && manifest.name !== void 0).map((manifest) => manifest.name);
+  const projects = (0, import_node_fs31.globSync)("{apps,libs,packages}/*/package.json", { cwd: workspaceRoot }).map((path) => readJson((0, import_node_path37.join)(workspaceRoot, path))).filter((manifest) => manifest.private !== true && manifest.name !== void 0).map((manifest) => manifest.name);
   return findStrandedReleaseTags(projects, listed.stdout.split(/\r?\n/).filter(Boolean));
 }
 
@@ -8314,9 +8430,9 @@ function checkEslintConfigs(workspaceRoot) {
   ];
 }
 function checkEslintEntryPointReachesTheRules(workspaceRoot) {
-  const rules = (0, import_node_path37.join)(workspaceRoot, ESLINT_MNCI_FILENAME);
+  const rules = (0, import_node_path38.join)(workspaceRoot, ESLINT_MNCI_FILENAME);
   if (!(0, import_node_fs32.existsSync)(rules)) return [];
-  const entryPoint = (0, import_node_path37.join)(workspaceRoot, ESLINT_USER_FILENAME);
+  const entryPoint = (0, import_node_path38.join)(workspaceRoot, ESLINT_USER_FILENAME);
   const source = (0, import_node_fs32.existsSync)(entryPoint) ? (0, import_node_fs32.readFileSync)(entryPoint, "utf8") : "";
   return [
     {
@@ -8330,7 +8446,7 @@ function checkEslintEntryPointReachesTheRules(workspaceRoot) {
 function declaredDevDependencies(workspaceRoot) {
   try {
     const manifest = readJson(
-      (0, import_node_path37.join)(workspaceRoot, "package.json")
+      (0, import_node_path38.join)(workspaceRoot, "package.json")
     );
     return manifest.devDependencies ?? {};
   } catch {
@@ -8338,7 +8454,7 @@ function declaredDevDependencies(workspaceRoot) {
   }
 }
 function checkNoRetiredFormatter(workspaceRoot) {
-  const files = RETIRED_FORMATTER_FILES.filter((file) => fileExists((0, import_node_path37.join)(workspaceRoot, file)));
+  const files = RETIRED_FORMATTER_FILES.filter((file) => fileExists((0, import_node_path38.join)(workspaceRoot, file)));
   const declared = ["prettier", "eslint-config-prettier", "oxlint", "oxfmt", "@mnci/oxlint-config"].filter((name) => declaredDevDependencies(workspaceRoot)[name] !== void 0);
   const stale = [...files, ...declared];
   if (stale.length === 0) {
@@ -8364,7 +8480,7 @@ function checkEslintPlugin(nxJson) {
   };
 }
 function checkResolvedEslint(workspaceRoot) {
-  const manifestPath = (0, import_node_path37.join)(workspaceRoot, "node_modules/eslint/package.json");
+  const manifestPath = (0, import_node_path38.join)(workspaceRoot, "node_modules/eslint/package.json");
   if (!fileExists(manifestPath)) {
     return void 0;
   }
@@ -8382,7 +8498,7 @@ function checkResolvedEslint(workspaceRoot) {
   }
 }
 function checkNpmrc(workspaceRoot, registry, scope) {
-  const npmrcPath = (0, import_node_path37.join)(workspaceRoot, ".npmrc");
+  const npmrcPath = (0, import_node_path38.join)(workspaceRoot, ".npmrc");
   if (!registry || !fileExists(npmrcPath)) {
     return void 0;
   }
@@ -8403,7 +8519,7 @@ function checkNpmrc(workspaceRoot, registry, scope) {
   };
 }
 function checkNpmrcCredentialResolves(workspaceRoot, environment = process.env) {
-  const npmrcPath = (0, import_node_path37.join)(workspaceRoot, ".npmrc");
+  const npmrcPath = (0, import_node_path38.join)(workspaceRoot, ".npmrc");
   if (!fileExists(npmrcPath)) {
     return void 0;
   }
@@ -8431,8 +8547,8 @@ function checkNpmrcCredentialResolves(workspaceRoot, environment = process.env)
   };
 }
 function checkNpmAuthMatchesPipeline(workspaceRoot, registry) {
-  const npmrcPath = (0, import_node_path37.join)(workspaceRoot, ".npmrc");
-  const pipelinePath = (0, import_node_path37.join)(workspaceRoot, "azure-pipelines.yml");
+  const npmrcPath = (0, import_node_path38.join)(workspaceRoot, ".npmrc");
+  const pipelinePath = (0, import_node_path38.join)(workspaceRoot, "azure-pipelines.yml");
   if (registry?.kind !== "azure-artifacts" || !fileExists(npmrcPath) || !fileExists(pipelinePath)) {
     return void 0;
   }
@@ -8488,7 +8604,7 @@ function checkVersionActions(workspaceRoot) {
   ].map((manifest) => toPosix2(manifest));
   return candidates.flatMap((manifest) => {
     const projectRoot = manifest.slice(0, manifest.lastIndexOf("/"));
-    const projectJsonPath = (0, import_node_path37.join)(workspaceRoot, projectRoot, "project.json");
+    const projectJsonPath = (0, import_node_path38.join)(workspaceRoot, projectRoot, "project.json");
     let hasOverride = false;
     try {
       const projectJson = readJson(projectJsonPath);
@@ -8517,7 +8633,7 @@ function declaredTargets(workspaceRoot, projectRoot) {
   ]) {
     try {
       const targets = extract(
-        readJson((0, import_node_path37.join)(workspaceRoot, projectRoot, file))
+        readJson((0, import_node_path38.join)(workspaceRoot, projectRoot, file))
       );
       if (targets && typeof targets === "object") {
         sources.push({
@@ -8549,7 +8665,7 @@ function checkOneTargetsFiles(workspaceRoot, source, targetName, target) {
   return TARGET_FILE_OPTIONS.flatMap((option) => {
     const value = target?.options?.[option];
     const checkable = typeof value === "string" && !value.includes("{");
-    if (!checkable || fileExists((0, import_node_path37.join)(workspaceRoot, value))) {
+    if (!checkable || fileExists((0, import_node_path38.join)(workspaceRoot, value))) {
       return [];
     }
     return [
@@ -8574,7 +8690,7 @@ ${result.stdout.trim()}` : ""}`,
 }
 function hasCCompiler() {
   const candidates = [process.env.CC?.split(" ", 1)[0], "gcc", "clang", "cc"];
-  return candidates.some((command) => command !== void 0 && command !== "" && (0, import_node_child_process.spawnSync)(command, ["--version"], { stdio: "ignore" }).status === 0);
+  return candidates.some((command) => command !== void 0 && command !== "" && (0, import_node_child_process2.spawnSync)(command, ["--version"], { stdio: "ignore" }).status === 0);
 }
 function checkGoPluginRegistered(workspaceRoot) {
   if (!hasGoProject(workspaceRoot)) {
@@ -8588,7 +8704,7 @@ function checkGoPluginRegistered(workspaceRoot) {
   };
 }
 function checkGoWorkInSync(workspaceRoot) {
-  const goWorkPath = (0, import_node_path37.join)(workspaceRoot, "go.work");
+  const goWorkPath = (0, import_node_path38.join)(workspaceRoot, "go.work");
   if (!fileExists(goWorkPath)) {
     return void 0;
   }
@@ -8596,7 +8712,7 @@ function checkGoWorkInSync(workspaceRoot) {
   const blockEntries = Array.from(contents.matchAll(/(?:^|\n)\s*use\s+\(([^)]*)\)/g), (match) => match[1].split("\n")).flat();
   const singleEntries = Array.from(contents.matchAll(/(?:^|\n)\s*use\s+(\.\S+)/g), (match) => match[1]);
   const uses = [...blockEntries, ...singleEntries].map((entry) => entry.trim()).filter(Boolean);
-  const stale = uses.filter((entry) => !(0, import_node_fs32.existsSync)((0, import_node_path37.join)(workspaceRoot, entry, "go.mod")));
+  const stale = uses.filter((entry) => !(0, import_node_fs32.existsSync)((0, import_node_path38.join)(workspaceRoot, entry, "go.mod")));
   return {
     check: "every go.work `use` entry points to a module that still exists",
     ok: stale.length === 0,
@@ -8612,9 +8728,9 @@ function checkNativeApps(workspaceRoot) {
     { file: ".github/workflows/ci.yml", marker: "native (${{ matrix.os }})" },
     { file: "azure-pipelines.yml", marker: "- job: native" }
   ];
-  const findings = pipelines.filter(({ file }) => fileExists((0, import_node_path37.join)(workspaceRoot, file))).map(({ file, marker }) => ({
+  const findings = pipelines.filter(({ file }) => fileExists((0, import_node_path38.join)(workspaceRoot, file))).map(({ file, marker }) => ({
     check: `${file} builds the native apps on every OS`,
-    ok: (0, import_node_fs32.readFileSync)((0, import_node_path37.join)(workspaceRoot, file), "utf8").includes(marker),
+    ok: (0, import_node_fs32.readFileSync)((0, import_node_path38.join)(workspaceRoot, file), "utf8").includes(marker),
     detail: `${file} has no native job: CI would verify a cgo app on the one agent that cannot build it`,
     remedy: "run `mnci upgrade`"
   }));
@@ -8627,7 +8743,7 @@ function checkNativeApps(workspaceRoot) {
   return findings;
 }
 function checkNoRootRuntimeDependencies(workspaceRoot) {
-  const manifestPath = (0, import_node_path37.join)(workspaceRoot, "package.json");
+  const manifestPath = (0, import_node_path38.join)(workspaceRoot, "package.json");
   if (!fileExists(manifestPath)) {
     return void 0;
   }
@@ -8651,7 +8767,7 @@ function checkRollupSourceMaps(workspaceRoot) {
     cwd: workspaceRoot
   }).map((config) => toPosix2(config));
   return configs.flatMap((relativePath) => {
-    const configPath = (0, import_node_path37.join)(workspaceRoot, relativePath);
+    const configPath = (0, import_node_path38.join)(workspaceRoot, relativePath);
     let config;
     try {
       config = (0, import_node_fs32.readFileSync)(configPath, "utf8");
@@ -8673,7 +8789,7 @@ function checkDeclarationSpecifiers(workspaceRoot) {
     cwd: workspaceRoot
   }).map((config) => toPosix2(config));
   return configs.flatMap((relativePath) => {
-    const configPath = (0, import_node_path37.join)(workspaceRoot, relativePath);
+    const configPath = (0, import_node_path38.join)(workspaceRoot, relativePath);
     if (!fileExists(configPath)) {
       return [];
     }
@@ -8704,8 +8820,8 @@ function checkDeclarationSpecifiers(workspaceRoot) {
 }
 function checkPipelinePhases(workspaceRoot) {
   const files = ["azure-pipelines.yml", ".github/workflows/ci.yml"];
-  return files.filter((file) => fileExists((0, import_node_path37.join)(workspaceRoot, file))).flatMap((file) => {
-    const { verifyActive, switchedOff } = inspectPipeline((0, import_node_fs32.readFileSync)((0, import_node_path37.join)(workspaceRoot, file), "utf8"));
+  return files.filter((file) => fileExists((0, import_node_path38.join)(workspaceRoot, file))).flatMap((file) => {
+    const { verifyActive, switchedOff } = inspectPipeline((0, import_node_fs32.readFileSync)((0, import_node_path38.join)(workspaceRoot, file), "utf8"));
     const verify = {
       check: `${file} runs the enforced verify phase`,
       ok: verifyActive,
@@ -8746,7 +8862,7 @@ function checkDependencyRangesNotPreserved(nxJson) {
   };
 }
 function checkLockfileHasNoLocalRegistry(workspaceRoot) {
-  if (!fileExists((0, import_node_path37.join)(workspaceRoot, "package-lock.json"))) {
+  if (!fileExists((0, import_node_path38.join)(workspaceRoot, "package-lock.json"))) {
     return void 0;
   }
   return {
@@ -8766,7 +8882,7 @@ function checkReleaseTagsResolve(workspaceRoot, nxJson) {
   };
 }
 function collectFindings(workspaceRoot) {
-  const nxJsonPath = (0, import_node_path37.join)(workspaceRoot, "nx.json");
+  const nxJsonPath = (0, import_node_path38.join)(workspaceRoot, "nx.json");
   if (!fileExists(nxJsonPath)) {
     throw new Error(
       `No nx.json found in ${workspaceRoot} \u2014 run 'mnci doctor' from the workspace root.`
@@ -8832,7 +8948,7 @@ function runDoctor(workspaceRoot, options = {}) {
 
 // src/repository-adoption/adopt-dependencies.use-case.ts
 var import_node_fs33 = require("fs");
-var import_node_path38 = require("path");
+var import_node_path39 = require("path");
 
 // src/repository-adoption/clean-working-tree.validator.ts
 function requireCleanWorkingTree(repositoryRoot, capture = runCapture) {
@@ -8903,7 +9019,7 @@ var SOURCE_FILE = /\.(?:[cm]?[jt]s|[jt]sx)$/;
 var TEST_FILE = /\.(?:spec|test)\.[^.]+$|[\\/](?:__tests__|tests?|e2e)[\\/]/;
 var SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set(["node_modules", "dist", "build", "coverage", "out", ".git", ".nx", "tmp"]);
 function sourceFiles(directory, relative = "") {
-  const entries = (0, import_node_fs33.readdirSync)((0, import_node_path38.join)(directory, relative), { withFileTypes: true });
+  const entries = (0, import_node_fs33.readdirSync)((0, import_node_path39.join)(directory, relative), { withFileTypes: true });
   const found = [];
   for (const entry of entries) {
     const path = relative === "" ? entry.name : `${relative}/${entry.name}`;
@@ -8930,7 +9046,7 @@ function importsOfProject(projectDirectory, wanted) {
   const tested = /* @__PURE__ */ new Set();
   const files = sourceFiles(projectDirectory);
   for (const file of files) {
-    const names = wantedImportsOf((0, import_node_path38.join)(projectDirectory, file), wanted);
+    const names = wantedImportsOf((0, import_node_path39.join)(projectDirectory, file), wanted);
     const target = TEST_FILE.test(file) ? tested : shipped;
     for (const name of names) {
       target.add(name);
@@ -8942,7 +9058,7 @@ function importsOfProject(projectDirectory, wanted) {
 function findUsage(repositoryRoot, projectDirectories, wanted) {
   const usage = {};
   for (const dir of projectDirectories) {
-    const { shipped, testsOnly } = importsOfProject((0, import_node_path38.join)(repositoryRoot, dir), wanted);
+    const { shipped, testsOnly } = importsOfProject((0, import_node_path39.join)(repositoryRoot, dir), wanted);
     for (const name of shipped) {
       usage[name] ??= { runtime: [], testsOnly: [] };
       usage[name].runtime.push(dir);
@@ -8957,7 +9073,7 @@ function findUsage(repositoryRoot, projectDirectories, wanted) {
 function adoptDependencies(repositoryRoot, dependencies = {}) {
   const run = dependencies.run ?? runShell;
   requireCleanWorkingTree(repositoryRoot, dependencies.capture ?? runCapture);
-  const rootPath = (0, import_node_path38.join)(repositoryRoot, "package.json");
+  const rootPath = (0, import_node_path39.join)(repositoryRoot, "package.json");
   if (!fileExists(rootPath)) {
     throw new Error("No package.json at the repository root.");
   }
@@ -8993,7 +9109,7 @@ function adoptDependencies(repositoryRoot, dependencies = {}) {
 
 // src/repository-adoption/adopt-kinds.use-case.ts
 var import_node_fs34 = require("fs");
-var import_node_path39 = require("path");
+var import_node_path40 = require("path");
 
 // src/repository-adoption/infer-project-kind.algorithm.ts
 var SERVER_FRAMEWORKS = ["express", "koa", "fastify", "@nestjs/core"];
@@ -9094,32 +9210,32 @@ function inferProjectKind(evidence) {
 // src/repository-adoption/adopt-kinds.use-case.ts
 var TYPE_TAG = "type:";
 function readEvidence(repositoryRoot, location) {
-  const directory = (0, import_node_path39.join)(repositoryRoot, location.dir);
+  const directory = (0, import_node_path40.join)(repositoryRoot, location.dir);
   const files = (0, import_node_fs34.readdirSync)(directory);
   const manifest = location.ecosystem === "npm" ? readJson(location.manifestPath) : {};
   const text = location.ecosystem === "npm" ? "" : (0, import_node_fs34.readFileSync)(location.manifestPath, "utf8");
   let hasProgram = false;
   if (location.ecosystem === "go") {
-    hasProgram = files.filter((file) => file.endsWith(".go")).some((file) => /^package main\b/m.test((0, import_node_fs34.readFileSync)((0, import_node_path39.join)(directory, file), "utf8")));
+    hasProgram = files.filter((file) => file.endsWith(".go")).some((file) => /^package main\b/m.test((0, import_node_fs34.readFileSync)((0, import_node_path40.join)(directory, file), "utf8")));
   } else if (location.ecosystem === "pub") {
-    hasProgram = (0, import_node_fs34.existsSync)((0, import_node_path39.join)(directory, "lib", "main.dart"));
+    hasProgram = (0, import_node_fs34.existsSync)((0, import_node_path40.join)(directory, "lib", "main.dart"));
   }
   return { ecosystem: location.ecosystem, manifest, text, files, hasProgram };
 }
 function existingKind(directory) {
   const sources = [];
-  if (fileExists((0, import_node_path39.join)(directory, "project.json"))) {
-    sources.push(readJson((0, import_node_path39.join)(directory, "project.json")).tags ?? []);
+  if (fileExists((0, import_node_path40.join)(directory, "project.json"))) {
+    sources.push(readJson((0, import_node_path40.join)(directory, "project.json")).tags ?? []);
   }
-  if (fileExists((0, import_node_path39.join)(directory, "package.json"))) {
-    sources.push(readJson((0, import_node_path39.join)(directory, "package.json")).nx?.tags ?? []);
+  if (fileExists((0, import_node_path40.join)(directory, "package.json"))) {
+    sources.push(readJson((0, import_node_path40.join)(directory, "package.json")).nx?.tags ?? []);
   }
   return sources.flat().find((tag) => tag.startsWith(TYPE_TAG))?.slice(TYPE_TAG.length);
 }
 function writeKindTag(directory, name, kind) {
   const tag = `${TYPE_TAG}${kind}`;
-  const projectJson = (0, import_node_path39.join)(directory, "project.json");
-  const packageJson = (0, import_node_path39.join)(directory, "package.json");
+  const projectJson = (0, import_node_path40.join)(directory, "project.json");
+  const packageJson = (0, import_node_path40.join)(directory, "package.json");
   if (fileExists(projectJson)) {
     const project = readJson(projectJson);
     writeFileEnsured(projectJson, toJson({ ...project, tags: [...project.tags ?? [], tag] }));
@@ -9143,7 +9259,7 @@ function adoptKinds(repositoryRoot, overrides = {}, dependencies = {}) {
     }
   }
   return locations.map((location) => {
-    const directory = (0, import_node_path39.join)(repositoryRoot, location.dir);
+    const directory = (0, import_node_path40.join)(repositoryRoot, location.dir);
     const present = existingKind(directory);
     if (present !== void 0) {
       return { dir: location.dir, outcome: "already", kind: present, reason: PROJECT_KINDS.includes(present) ? "it already has a type tag" : "it already has a type tag of its own, which is not an mnci kind name; left as it is" };
@@ -9160,11 +9276,11 @@ function adoptKinds(repositoryRoot, overrides = {}, dependencies = {}) {
 
 // src/repository-adoption/adopt-overlay.use-case.ts
 var import_node_fs36 = require("fs");
-var import_node_path41 = require("path");
+var import_node_path42 = require("path");
 
 // src/workspace-upgrade/upgrade-workspace.use-case.ts
 var import_node_fs35 = require("fs");
-var import_node_path40 = require("path");
+var import_node_path41 = require("path");
 function resolveRegistry(options, persisted) {
   if (options.registry === "azure-artifacts" || options.organization && options.artifactsFeed) {
     const persistedAzure = persisted?.kind === "azure-artifacts" ? persisted : void 0;
@@ -9201,11 +9317,11 @@ function resolveWorkspaceName(workspaceRoot, persisted) {
     }
   } catch {
   }
-  return (0, import_node_path40.basename)(workspaceRoot);
+  return (0, import_node_path41.basename)(workspaceRoot);
 }
 function detectNpmAuth(workspaceRoot) {
   try {
-    return (0, import_node_fs35.readFileSync)((0, import_node_path40.join)(workspaceRoot, "azure-pipelines.yml"), "utf8").includes("npmAuthenticate@0") ? "build-identity" : void 0;
+    return (0, import_node_fs35.readFileSync)((0, import_node_path41.join)(workspaceRoot, "azure-pipelines.yml"), "utf8").includes("npmAuthenticate@0") ? "build-identity" : void 0;
   } catch {
     return void 0;
   }
@@ -9252,7 +9368,7 @@ function resolveOverlayOptions(workspaceRoot, options, persisted) {
   };
 }
 function runUpgrade(workspaceRoot, options) {
-  if (!fileExists((0, import_node_path40.join)(workspaceRoot, "nx.json"))) {
+  if (!fileExists((0, import_node_path41.join)(workspaceRoot, "nx.json"))) {
     throw new Error(
       `No nx.json found in ${workspaceRoot} \u2014 this does not look like an Nx workspace. Run 'mnci upgrade' from the workspace root.`
     );
@@ -9330,7 +9446,7 @@ function runUpgrade(workspaceRoot, options) {
     "Formatting the workspace (eslint --fix) \u2014 the slowest step, minutes on a large workspace"
   );
   runFormatter(workspaceRoot);
-  const nxJson = readJson((0, import_node_path40.join)(workspaceRoot, "nx.json"));
+  const nxJson = readJson((0, import_node_path41.join)(workspaceRoot, "nx.json"));
   const stranded = locateStrandedReleaseTags(workspaceRoot, nxJson.release?.releaseTag?.pattern);
   for (const entry of stranded) {
     logger.warn(`${entry.project} has release tags only under ${entry.oldTag}: nx release would restart it from its disk version. Run \`mnci adopt --tags\` before the next release to create ${entry.newTag} locally (\`mnci doctor\` lists them all).`);
@@ -9341,8 +9457,8 @@ function runUpgrade(workspaceRoot, options) {
 
 // src/repository-adoption/adopt-overlay.use-case.ts
 function detectCiProvider(repositoryRoot) {
-  const azure = (0, import_node_fs36.existsSync)((0, import_node_path41.join)(repositoryRoot, "azure-pipelines.yml"));
-  const workflows = (0, import_node_path41.join)(repositoryRoot, ".github", "workflows");
+  const azure = (0, import_node_fs36.existsSync)((0, import_node_path42.join)(repositoryRoot, "azure-pipelines.yml"));
+  const workflows = (0, import_node_path42.join)(repositoryRoot, ".github", "workflows");
   const github = (0, import_node_fs36.existsSync)(workflows) && (0, import_node_fs36.readdirSync)(workflows).some((file) => /\.ya?ml$/.test(file));
   if (azure && github) {
     return "both";
@@ -9353,7 +9469,7 @@ function detectCiProvider(repositoryRoot) {
   return github ? "github" : void 0;
 }
 function detectTestRunner(repositoryRoot) {
-  const manifestPath = (0, import_node_path41.join)(repositoryRoot, "package.json");
+  const manifestPath = (0, import_node_path42.join)(repositoryRoot, "package.json");
   if (!fileExists(manifestPath)) {
     return void 0;
   }
@@ -9366,7 +9482,7 @@ function detectTestRunner(repositoryRoot) {
 }
 function adoptOverlay(repositoryRoot, options, dependencies = {}) {
   requireCleanWorkingTree(repositoryRoot, dependencies.capture ?? runCapture);
-  if (!fileExists((0, import_node_path41.join)(repositoryRoot, "nx.json"))) {
+  if (!fileExists((0, import_node_path42.join)(repositoryRoot, "nx.json"))) {
     throw new Error("There is no nx.json, so Nx is not set up here. Set it up first (`npx nx@latest init`); adopt does not install Nx yet.");
   }
   const persisted = readMnciConfig(repositoryRoot);
@@ -9379,7 +9495,7 @@ function adoptOverlay(repositoryRoot, options, dependencies = {}) {
 }
 
 // src/repository-adoption/adopt-toolchain.use-case.ts
-var import_node_path43 = require("path");
+var import_node_path44 = require("path");
 
 // src/repository-adoption/align-nx-family.algorithm.ts
 var VERSION = /^[\^~]?(\d+)\.(\d+)\.(\d+)$/;
@@ -9418,23 +9534,23 @@ function alignNxFamily(dependencies, version) {
 
 // src/repository-adoption/retire-tooling.use-case.ts
 var import_node_fs37 = require("fs");
-var import_node_path42 = require("path");
+var import_node_path43 = require("path");
 var RETIRED_COMMAND = /\b(?:prettier|oxfmt|oxlint)\b/;
 function retireTooling(repositoryRoot) {
   const removed = [];
   for (const file of RETIRED_FORMATTER_FILES) {
-    if (!fileExists((0, import_node_path42.join)(repositoryRoot, file))) {
+    if (!fileExists((0, import_node_path43.join)(repositoryRoot, file))) {
       continue;
     }
-    (0, import_node_fs37.rmSync)((0, import_node_path42.join)(repositoryRoot, file), { force: true });
+    (0, import_node_fs37.rmSync)((0, import_node_path43.join)(repositoryRoot, file), { force: true });
     removed.push(file);
   }
-  const hadRegistry = fileExists((0, import_node_path42.join)(repositoryRoot, ".verdaccio"));
+  const hadRegistry = fileExists((0, import_node_path43.join)(repositoryRoot, ".verdaccio"));
   removeLocalRegistryScaffolding(repositoryRoot);
   if (hadRegistry) {
     removed.push(".verdaccio, its dependency and the local-registry target");
   }
-  const manifestPath = (0, import_node_path42.join)(repositoryRoot, "package.json");
+  const manifestPath = (0, import_node_path43.join)(repositoryRoot, "package.json");
   if (!fileExists(manifestPath)) {
     return removed;
   }
@@ -9481,7 +9597,7 @@ function adoptToolchain(repositoryRoot, options = {}, dependencies = {}) {
     console.log(message);
   });
   requireCleanWorkingTree(repositoryRoot, capture);
-  const manifestPath = (0, import_node_path43.join)(repositoryRoot, "package.json");
+  const manifestPath = (0, import_node_path44.join)(repositoryRoot, "package.json");
   if (!fileExists(manifestPath)) {
     throw new Error("No package.json at the repository root.");
   }
@@ -9532,7 +9648,7 @@ function createBaselineTags(repositoryRoot, stranded) {
 
 // src/repository-adoption/inspect-repository.use-case.ts
 var import_node_fs38 = require("fs");
-var import_node_path44 = require("path");
+var import_node_path45 = require("path");
 var LOCKFILES = [
   ["package-lock.json", "npm"],
   ["pnpm-lock.yaml", "pnpm"],
@@ -9553,22 +9669,22 @@ function inspectRepository(repositoryRoot) {
   const isGitRepo = inside.status === 0 && inside.stdout.trim() === "true";
   const dirty = isGitRepo && runCapture("git", ["status", "--porcelain"], repositoryRoot).stdout.trim() !== "";
   const tags = isGitRepo ? runCapture("git", ["tag", "--list"], repositoryRoot).stdout.split(/\r?\n/).filter(Boolean) : [];
-  const manifestPath = (0, import_node_path44.join)(repositoryRoot, "package.json");
+  const manifestPath = (0, import_node_path45.join)(repositoryRoot, "package.json");
   const manifest = fileExists(manifestPath) ? readJson(manifestPath) : {};
-  const nxJsonPath = (0, import_node_path44.join)(repositoryRoot, "nx.json");
+  const nxJsonPath = (0, import_node_path45.join)(repositoryRoot, "nx.json");
   const nxJson = fileExists(nxJsonPath) ? readJson(nxJsonPath) : {};
   const ci = [];
   const pipelines = [];
-  if ((0, import_node_fs38.existsSync)((0, import_node_path44.join)(repositoryRoot, "azure-pipelines.yml"))) {
+  if ((0, import_node_fs38.existsSync)((0, import_node_path45.join)(repositoryRoot, "azure-pipelines.yml"))) {
     ci.push("azure");
-    pipelines.push((0, import_node_path44.join)(repositoryRoot, "azure-pipelines.yml"));
+    pipelines.push((0, import_node_path45.join)(repositoryRoot, "azure-pipelines.yml"));
   }
-  const workflows = (0, import_node_path44.join)(repositoryRoot, ".github", "workflows");
+  const workflows = (0, import_node_path45.join)(repositoryRoot, ".github", "workflows");
   if ((0, import_node_fs38.existsSync)(workflows)) {
     const files = (0, import_node_fs38.readdirSync)(workflows).filter((file) => /\.ya?ml$/.test(file));
     if (files.length > 0) {
       ci.push("github");
-      pipelines.push(...files.map((file) => (0, import_node_path44.join)(workflows, file)));
+      pipelines.push(...files.map((file) => (0, import_node_path45.join)(workflows, file)));
     }
   }
   const rootFiles = (0, import_node_fs38.readdirSync)(repositoryRoot);
@@ -9815,6 +9931,7 @@ var COMMAND_GROUPS = {
   doctor: "workspace",
   adopt: "inspect",
   add: "projects",
+  dev: "projects",
   install: "dependencies",
   sync: "dependencies",
   up: "dependencies",
@@ -9879,13 +9996,13 @@ function runCommands(program, options) {
 }
 
 // src/workspace-info/list-projects.use-case.ts
-var import_node_path45 = require("path");
+var import_node_path46 = require("path");
 var TYPE_TAG_PREFIX = "type:";
 function listProjects(workspaceRoot) {
   return locateProjects(workspaceRoot).map((location) => {
-    const projectJsonPath = (0, import_node_path45.join)(workspaceRoot, location.dir, "project.json");
+    const projectJsonPath = (0, import_node_path46.join)(workspaceRoot, location.dir, "project.json");
     const project = fileExists(projectJsonPath) ? readJson(projectJsonPath) : {};
-    const manifestPath = (0, import_node_path45.join)(workspaceRoot, location.dir, "package.json");
+    const manifestPath = (0, import_node_path46.join)(workspaceRoot, location.dir, "package.json");
     const manifestTags = fileExists(manifestPath) ? readJson(manifestPath).nx?.tags ?? [] : [];
     const typeTag = [...project.tags ?? [], ...manifestTags].find((tag) => tag.startsWith(TYPE_TAG_PREFIX));
     return {
@@ -9898,7 +10015,7 @@ function listProjects(workspaceRoot) {
   }).toSorted((a, b) => a.dir.localeCompare(b.dir));
 }
 function runProjects(workspaceRoot, options) {
-  if (!fileExists((0, import_node_path45.join)(workspaceRoot, "nx.json"))) {
+  if (!fileExists((0, import_node_path46.join)(workspaceRoot, "nx.json"))) {
     throw new Error("No nx.json found here. Run `projects` from the workspace root.");
   }
   const projects = listProjects(workspaceRoot);
@@ -9912,12 +10029,12 @@ function runProjects(workspaceRoot, options) {
 }
 
 // src/workspace-info/read-workspace-info.use-case.ts
-var import_node_path47 = require("path");
+var import_node_path48 = require("path");
 
 // src/cli-version/check-for-update.use-case.ts
 var import_node_fs39 = require("fs");
-var import_node_path46 = require("path");
-var import_cross_spawn3 = __toESM(require("cross-spawn"));
+var import_node_path47 = require("path");
+var import_cross_spawn4 = __toESM(require("cross-spawn"));
 var PACKAGE_NAME2 = "@mnci/cli";
 var REGISTRY_TIMEOUT_MS = 2e3;
 function checkForUpdate(currentVersion2) {
@@ -9935,7 +10052,7 @@ function checkForUpdate(currentVersion2) {
   }
 }
 function fetchLatestVersion() {
-  const result = import_cross_spawn3.default.sync("npm", ["view", PACKAGE_NAME2, "version"], {
+  const result = import_cross_spawn4.default.sync("npm", ["view", PACKAGE_NAME2, "version"], {
     encoding: "utf8",
     timeout: REGISTRY_TIMEOUT_MS,
     stdio: ["ignore", "pipe", "ignore"]
@@ -9975,7 +10092,7 @@ function releaseTriple(version) {
 }
 function readCliVersion(packageDirectory) {
   try {
-    const manifestPath = (0, import_node_path46.join)(packageDirectory, "..", "package.json");
+    const manifestPath = (0, import_node_path47.join)(packageDirectory, "..", "package.json");
     const manifest = JSON.parse((0, import_node_fs39.readFileSync)(manifestPath, "utf8"));
     return manifest.version ?? "0.0.0";
   } catch {
@@ -9986,7 +10103,7 @@ function readCliVersion(packageDirectory) {
 // src/workspace-info/read-workspace-info.use-case.ts
 function readWorkspaceInfo(workspaceRoot, cliVersion) {
   const latest = fetchLatestVersion() ?? null;
-  const isWorkspace = fileExists((0, import_node_path47.join)(workspaceRoot, "nx.json"));
+  const isWorkspace = fileExists((0, import_node_path48.join)(workspaceRoot, "nx.json"));
   return {
     cli: {
       version: cliVersion,
@@ -10007,7 +10124,7 @@ function runInfo(workspaceRoot, cliVersion, options) {
 }
 
 // src/interactive-wizard/interactive-wizard.use-case.ts
-var import_node_path48 = require("path");
+var import_node_path49 = require("path");
 
 // src/interactive-wizard/adopt-steps.config.ts
 var ADOPT_GLOBAL_OPTIONS = ["json"];
@@ -10143,14 +10260,14 @@ function formatCommandLine(argv) {
 }
 
 // src/interactive-wizard/inquirer-prompter.client.ts
-var import_prompts4 = require("@inquirer/prompts");
+var import_prompts5 = require("@inquirer/prompts");
 function toRows(choices) {
   const rows = [];
   let current;
   for (const choice of choices) {
     if (choice.group !== void 0 && choice.group !== current) {
       current = choice.group;
-      rows.push(new import_prompts4.Separator(`-- ${choice.group} --`));
+      rows.push(new import_prompts5.Separator(`-- ${choice.group} --`));
     }
     rows.push({ name: choice.name, value: choice.value, description: choice.description });
   }
@@ -10158,10 +10275,10 @@ function toRows(choices) {
 }
 function createInquirerPrompter() {
   return {
-    select: async (message, choices) => await (0, import_prompts4.select)({ message, choices: toRows(choices), pageSize: 18 }),
-    checkbox: async (message, choices) => await (0, import_prompts4.checkbox)({ message, choices: toRows(choices), pageSize: 18 }),
-    input: async (message, required) => await (0, import_prompts4.input)({ message, validate: (value) => !required || value.trim().length > 0 || "A value is required" }),
-    confirm: async (message, fallback) => await (0, import_prompts4.confirm)({ message, default: fallback })
+    select: async (message, choices) => await (0, import_prompts5.select)({ message, choices: toRows(choices), pageSize: 18 }),
+    checkbox: async (message, choices) => await (0, import_prompts5.checkbox)({ message, choices: toRows(choices), pageSize: 18 }),
+    input: async (message, required) => await (0, import_prompts5.input)({ message, validate: (value) => !required || value.trim().length > 0 || "A value is required" }),
+    confirm: async (message, fallback) => await (0, import_prompts5.confirm)({ message, default: fallback })
   };
 }
 
@@ -10188,7 +10305,7 @@ function wizardMenu(commands, inWorkspace) {
 }
 async function runInteractive(program, prompter = createInquirerPrompter(), workingDirectory = process.cwd()) {
   const commands = describeCommands(program);
-  const inWorkspace = fileExists((0, import_node_path48.join)(workingDirectory, "nx.json"));
+  const inWorkspace = fileExists((0, import_node_path49.join)(workingDirectory, "nx.json"));
   const name = await prompter.select("What would you like to do?", wizardMenu(commands, inWorkspace));
   const command = commands.find((candidate) => candidate.name === name);
   const argv = buildArgv(command, await askCommand(command, prompter));
@@ -10200,9 +10317,281 @@ async function runInteractive(program, prompter = createInquirerPrompter(), work
   }
 }
 
-// src/workspace-creation/adopt-directory.use-case.ts
+// src/workspace-presets/preset-catalog.config.ts
+var PRESETS = [
+  {
+    id: "web-api",
+    summary: "a React frontend and an Express API that share one internal library: the web asks the API, the API answers with the shared greeting, and `mnci dev web api` starts both",
+    projects: [
+      { kind: "internal-lib", name: "shared", options: {} },
+      { kind: "node-app", name: "api", options: { framework: "express" } },
+      { kind: "react-app", name: "web", options: {} }
+    ]
+  }
+];
+var PRESET_IDS = PRESETS.map((preset) => preset.id);
+
+// src/workspace-presets/wire-web-api.use-case.ts
 var import_node_fs40 = require("fs");
-var import_node_path49 = require("path");
+var import_node_path50 = require("path");
+
+// src/workspace-presets/web-api-wiring.algorithm.ts
+function apiHandler(shared) {
+  return `import { greet } from '${shared}'
+import type { Request, Response } from 'express'
+
+export function helloHandler (request: Request, response: Response): void {
+  const name = typeof request.query.name === 'string' ? request.query.name : 'world'
+  response.send(greet(name))
+}
+`;
+}
+function apiHandlerSpec(shared) {
+  return String.raw`import { greet } from '${shared}'
+import type { Request, Response } from 'express'
+import { helloHandler } from './hello.handler'
+
+/** A response that keeps what it was sent, so the spec needs no mock library and runs under Jest or Vitest. */
+function recordingResponse (): { response: Response, sent: unknown[] } {
+  const sent: unknown[] = []
+
+  return { sent, response: { send: (value: unknown) => { sent.push(value) } } as unknown as Response }
+}
+
+describe('helloHandler', () => {
+  it('answers with the shared library\'s greeting for the name asked', () => {
+    const { response, sent } = recordingResponse()
+
+    helloHandler({ query: { name: 'web' } } as unknown as Request, response)
+
+    expect(sent).toEqual([greet('web')])
+  })
+
+  it('greets the world when no name is asked', () => {
+    const { response, sent } = recordingResponse()
+
+    helloHandler({ query: {} } as unknown as Request, response)
+
+    expect(sent).toEqual([greet('world')])
+  })
+})
+`;
+}
+function apiBarrel() {
+  return "export * from './hello.handler'\n";
+}
+function webGreetingClient(shared) {
+  return `import type { Greeting } from '${shared}'
+
+export async function fetchGreeting (name: string, request: typeof fetch = fetch): Promise<Greeting> {
+  const response = await request('/api/greeting?name=' + encodeURIComponent(name))
+
+  return await response.json() as Greeting
+}
+`;
+}
+function webGreetingClientSpec() {
+  return String.raw`import { fetchGreeting } from './greeting.client'
+
+describe('fetchGreeting', () => {
+  it('asks the API\'s greeting route for the name and returns the answer', async () => {
+    const requested: string[] = []
+    const answering = (async (input: string) => {
+      requested.push(input)
+
+      return { json: async () => ({ message: 'Hello, web!' }) } as Response
+    }) as unknown as typeof fetch
+
+    expect(await fetchGreeting('web', answering)).toEqual({ message: 'Hello, web!' })
+    expect(requested).toEqual(['/api/greeting?name=web'])
+  })
+})
+`;
+}
+function webGreetingComponent(shared) {
+  return `import { useEffect, useState } from 'react'
+import type { Greeting } from '${shared}'
+import { fetchGreeting } from './greeting.client'
+
+export interface GreetingViewProps {
+  readonly name: string
+  readonly load?: (name: string) => Promise<Greeting>
+}
+
+export function GreetingView ({ name, load = fetchGreeting }: GreetingViewProps) {
+  const [greeting, setGreeting] = useState<Greeting | undefined>()
+  const [failed, setFailed] = useState(false)
+
+  useEffect(() => {
+    void (async () => {
+      try {
+        setGreeting(await load(name))
+      } catch {
+        setFailed(true)
+      }
+    })()
+  }, [name, load])
+
+  if (failed) {
+    return <p>Could not reach the API.</p>
+  }
+
+  return <p>{greeting?.message ?? 'Loading...'}</p>
+}
+`;
+}
+function webGreetingSpec() {
+  return `import { render } from '@testing-library/react'
+
+import { GreetingView } from './greeting.component'
+
+async function answering (name: string): Promise<{ message: string }> {
+  return { message: 'Hello, ' + name + '!' }
+}
+
+async function offline (): Promise<never> {
+  throw new Error('offline')
+}
+
+describe('GreetingView', () => {
+  it('shows the greeting its loader returns for its name', async () => {
+    const { findByText } = render(<GreetingView name='world' load={answering} />)
+
+    expect(await findByText('Hello, world!')).toBeTruthy()
+  })
+
+  it('says so when the API cannot be reached', async () => {
+    const { findByText } = render(<GreetingView name='world' load={offline} />)
+
+    expect(await findByText('Could not reach the API.')).toBeTruthy()
+  })
+})
+`;
+}
+function webGreetingBarrel() {
+  return "export * from './greeting.client'\nexport * from './greeting.component'\n";
+}
+function webAppSpec() {
+  return `import { render } from '@testing-library/react'
+
+import App from './app.component'
+
+describe('App', () => {
+  it('renders, and shows that it is loading the greeting', () => {
+    const { getByText } = render(<App />)
+
+    expect(getByText('Loading...')).toBeTruthy()
+  })
+})
+`;
+}
+function withApiProxy(config, target) {
+  const start = config.indexOf("server:");
+  const end = start === -1 ? -1 : config.indexOf("},", start);
+  if (end === -1 || config.includes("proxy:")) {
+    return config;
+  }
+  const block = config.slice(start, end).trimEnd();
+  return `${config.slice(0, start)}${block}
+    proxy: { '/api': '${target}' },
+  ${config.slice(end)}`;
+}
+
+// src/workspace-presets/wire-web-api.use-case.ts
+var API_ORIGIN = "http://localhost:3000";
+function declareDependency(manifestPath, name) {
+  const manifest = readJson(manifestPath);
+  writeFileEnsured(manifestPath, toJson({ ...manifest, dependencies: { ...manifest.dependencies, [name]: "*" } }));
+}
+function removeFiles(slice, files) {
+  for (const file of files) {
+    (0, import_node_fs40.rmSync)((0, import_node_path50.join)(slice, file), { force: true });
+  }
+}
+function replaceOnce(path, anchor, replacement) {
+  const text = (0, import_node_fs40.readFileSync)(path, "utf8");
+  if (!text.includes(anchor)) {
+    throw new Error(`${path} has no ${anchor}; the generator's output changed, so the preset cannot wire it.`);
+  }
+  writeFileEnsured(path, text.replace(anchor, () => replacement));
+}
+function proxyApi(viteConfigPath) {
+  const text = (0, import_node_fs40.readFileSync)(viteConfigPath, "utf8");
+  const proxied = withApiProxy(text, API_ORIGIN);
+  if (proxied === text && !text.includes("proxy:")) {
+    throw new Error(`${viteConfigPath} has no server block to add the /api proxy to; the generator's output changed, so the preset cannot wire it.`);
+  }
+  writeFileEnsured(viteConfigPath, proxied);
+}
+function wireWebApi(workspaceRoot, projects) {
+  const sharedManifest = (0, import_node_path50.join)(workspaceRoot, "libs", projects.shared, "package.json");
+  if (!fileExists(sharedManifest)) {
+    throw new Error(`The shared library was not added at libs/${projects.shared}, so there is nothing to wire the API and the frontend to.`);
+  }
+  const shared = readJson(sharedManifest).name;
+  const api = (0, import_node_path50.join)(workspaceRoot, "apps", projects.api);
+  declareDependency((0, import_node_path50.join)(api, "package.json"), shared);
+  const hello = (0, import_node_path50.join)(api, "src", "hello");
+  writeFileEnsured((0, import_node_path50.join)(hello, "hello.handler.ts"), apiHandler(shared));
+  writeFileEnsured((0, import_node_path50.join)(hello, "hello.handler.spec.ts"), apiHandlerSpec(shared));
+  writeFileEnsured((0, import_node_path50.join)(hello, "index.ts"), apiBarrel());
+  removeFiles(hello, ["greet.use-case.ts", "greet.use-case.spec.ts", "greeting.contract.ts"]);
+  replaceOnce((0, import_node_path50.join)(api, "src", "main.ts"), "app.get('/', helloHandler)", "app.get('/api/greeting', helloHandler)");
+  const web = (0, import_node_path50.join)(workspaceRoot, "apps", projects.web);
+  declareDependency((0, import_node_path50.join)(web, "package.json"), shared);
+  const greeting = (0, import_node_path50.join)(web, "src", "greeting");
+  writeFileEnsured((0, import_node_path50.join)(greeting, "greeting.client.ts"), webGreetingClient(shared));
+  writeFileEnsured((0, import_node_path50.join)(greeting, "greeting.client.spec.ts"), webGreetingClientSpec());
+  writeFileEnsured((0, import_node_path50.join)(greeting, "greeting.component.tsx"), webGreetingComponent(shared));
+  writeFileEnsured((0, import_node_path50.join)(greeting, "greeting.component.spec.tsx"), webGreetingSpec());
+  writeFileEnsured((0, import_node_path50.join)(greeting, "index.ts"), webGreetingBarrel());
+  removeFiles(greeting, ["greet.use-case.ts", "greet.use-case.spec.ts", "greeting.contract.ts"]);
+  writeFileEnsured((0, import_node_path50.join)(web, "src", "app", "app.component.spec.tsx"), webAppSpec());
+  proxyApi((0, import_node_path50.join)(web, "vite.config.mts"));
+}
+
+// src/workspace-presets/apply-preset.use-case.ts
+function findPreset(id) {
+  const preset = PRESETS.find((candidate) => candidate.id === id);
+  if (preset === void 0) {
+    throw new Error(`Unknown preset '${id}'. Presets: ${PRESET_IDS.join(", ")}.`);
+  }
+  return preset;
+}
+function nameOf(preset, kind) {
+  const project = preset.projects.find((candidate) => candidate.kind === kind);
+  if (project === void 0) {
+    throw new Error(`The ${preset.id} preset has no ${kind}.`);
+  }
+  return project.name;
+}
+async function applyPreset(workspaceRoot, presetId, dependencies = {}) {
+  const preset = findPreset(presetId);
+  const add = dependencies.add ?? runAdd;
+  const install = dependencies.install ?? ((root) => runShell("npm", ["install", "--ignore-scripts", "--no-audit", "--no-fund"], root));
+  const sync = dependencies.sync ?? syncProjectReferences;
+  const format = dependencies.format ?? runFormatter;
+  logger.step(`Adding the ${preset.id} preset: ${preset.projects.map((project) => project.name).join(", ")}`);
+  const previous = process.cwd();
+  process.chdir(workspaceRoot);
+  try {
+    for (const project of preset.projects) {
+      await add(project.kind, project.name, project.options);
+    }
+  } finally {
+    process.chdir(previous);
+  }
+  wireWebApi(workspaceRoot, { shared: nameOf(preset, "internal-lib"), api: nameOf(preset, "node-app"), web: nameOf(preset, "react-app") });
+  if (install(workspaceRoot) !== 0) {
+    throw new Error("npm install failed after wiring the preset. Run `npm install` and read its error; the projects themselves were added.");
+  }
+  sync(workspaceRoot);
+  format(workspaceRoot);
+}
+
+// src/workspace-creation/adopt-directory.use-case.ts
+var import_node_fs41 = require("fs");
+var import_node_path51 = require("path");
 var NEVER_COPIED = /* @__PURE__ */ new Set([".git", "node_modules"]);
 var AGENT_AND_CI_ENTRIES = [
   "AGENTS.md",
@@ -10233,13 +10622,13 @@ var PREFLIGHT_BLOCKERS = [
   "packages"
 ];
 function assertAdoptableDirectory(target) {
-  if (!(0, import_node_fs40.existsSync)(target)) {
+  if (!(0, import_node_fs41.existsSync)(target)) {
     throw new Error(`--into '${target}' does not exist. Create or clone it first.`);
   }
-  if (!(0, import_node_fs40.statSync)(target).isDirectory()) {
+  if (!(0, import_node_fs41.statSync)(target).isDirectory()) {
     throw new Error(`--into '${target}' is not a directory.`);
   }
-  const blockers = PREFLIGHT_BLOCKERS.filter((entry) => (0, import_node_fs40.existsSync)((0, import_node_path49.join)(target, entry)));
+  const blockers = PREFLIGHT_BLOCKERS.filter((entry) => (0, import_node_fs41.existsSync)((0, import_node_path51.join)(target, entry)));
   if (blockers.length > 0) {
     throw new Error(
       `--into '${target}' already holds ${blockers.join(", ")}, so it is a project already. Use \`mnci upgrade\` to re-apply the overlay to an existing workspace, or point --into at an empty checkout.`
@@ -10247,15 +10636,15 @@ function assertAdoptableDirectory(target) {
   }
 }
 function mergeGitignore(generatedFile, targetFile) {
-  const existing = (0, import_node_fs40.readFileSync)(targetFile, "utf8");
+  const existing = (0, import_node_fs41.readFileSync)(targetFile, "utf8");
   const present = new Set(existing.split("\n").map((line) => line.trim()));
-  const additions = (0, import_node_fs40.readFileSync)(generatedFile, "utf8").split("\n").map((line) => line.trimEnd()).filter((line) => {
+  const additions = (0, import_node_fs41.readFileSync)(generatedFile, "utf8").split("\n").map((line) => line.trimEnd()).filter((line) => {
     const trimmed = line.trim();
     return trimmed !== "" && !trimmed.startsWith("#") && !present.has(trimmed);
   });
   if (additions.length === 0) return false;
   const separator = existing.endsWith("\n") ? "" : "\n";
-  (0, import_node_fs40.writeFileSync)(
+  (0, import_node_fs41.writeFileSync)(
     targetFile,
     `${existing}${separator}
 # Added by mnci (Nx workspace)
@@ -10265,9 +10654,9 @@ ${additions.join("\n")}
   return true;
 }
 function adoptGeneratedWorkspace(generatedRoot, target) {
-  const entries = (0, import_node_fs40.readdirSync)(generatedRoot).filter((entry) => !NEVER_COPIED.has(entry));
+  const entries = (0, import_node_fs41.readdirSync)(generatedRoot).filter((entry) => !NEVER_COPIED.has(entry));
   const collisions = entries.filter(
-    (entry) => (0, import_node_fs40.existsSync)((0, import_node_path49.join)(target, entry)) && !EXISTING_WINS.has(entry) && entry !== ".gitignore"
+    (entry) => (0, import_node_fs41.existsSync)((0, import_node_path51.join)(target, entry)) && !EXISTING_WINS.has(entry) && entry !== ".gitignore"
   );
   if (collisions.length > 0) {
     throw new Error(
@@ -10276,28 +10665,28 @@ function adoptGeneratedWorkspace(generatedRoot, target) {
   }
   const result = { copied: [], kept: [], mergedGitignore: false };
   for (const entry of entries) {
-    const from = (0, import_node_path49.join)(generatedRoot, entry);
-    const to = (0, import_node_path49.join)(target, entry);
-    if (entry === ".gitignore" && (0, import_node_fs40.existsSync)(to)) {
+    const from = (0, import_node_path51.join)(generatedRoot, entry);
+    const to = (0, import_node_path51.join)(target, entry);
+    if (entry === ".gitignore" && (0, import_node_fs41.existsSync)(to)) {
       result.mergedGitignore = mergeGitignore(from, to);
       result.kept.push(entry);
       continue;
     }
-    if ((0, import_node_fs40.existsSync)(to)) {
+    if ((0, import_node_fs41.existsSync)(to)) {
       result.kept.push(entry);
       continue;
     }
-    (0, import_node_fs40.cpSync)(from, to, { recursive: true });
+    (0, import_node_fs41.cpSync)(from, to, { recursive: true });
     result.copied.push(entry);
   }
-  (0, import_node_fs40.rmSync)(generatedRoot, { recursive: true, force: true });
+  (0, import_node_fs41.rmSync)(generatedRoot, { recursive: true, force: true });
   return result;
 }
 
 // src/workspace-creation/create-workspace.use-case.ts
-var import_node_fs41 = require("fs");
+var import_node_fs42 = require("fs");
 var import_node_os2 = require("os");
-var import_node_path50 = require("path");
+var import_node_path52 = require("path");
 function nxCloudProviderValue(ci) {
   return ci === "azure" ? "azure" : "github";
 }
@@ -10340,9 +10729,10 @@ async function resolveRegistry2(options) {
   return await promptRegistry();
 }
 async function runNew(name, options) {
-  const adoptTarget = options.into === void 0 ? void 0 : (0, import_node_path50.resolve)(process.cwd(), options.into);
+  const adoptTarget = options.into === void 0 ? void 0 : (0, import_node_path52.resolve)(process.cwd(), options.into);
   if (adoptTarget !== void 0) assertAdoptableDirectory(adoptTarget);
-  const workspaceName = name ?? (adoptTarget === void 0 ? await promptText("Workspace name") : (0, import_node_path50.basename)(adoptTarget));
+  if (options.preset !== void 0) findPreset(options.preset);
+  const workspaceName = name ?? (adoptTarget === void 0 ? await promptText("Workspace name") : (0, import_node_path52.basename)(adoptTarget));
   assertValidProjectName(workspaceName, "Workspace name");
   const scope = options.scope ?? (options.yes ? `@${workspaceName}` : await promptText("npm scope for publishable packages", `@${workspaceName}`));
   const registry = await resolveRegistry2(options);
@@ -10355,8 +10745,8 @@ async function runNew(name, options) {
   const npmAuth = resolveNpmAuth(options.npmAuth, registry, ci);
   const stack = await resolveStack(options);
   const nxCloud = options.nxCloud ?? (options.yes ? false : await promptNxCloud());
-  const stagingParent = adoptTarget === void 0 ? process.cwd() : (0, import_node_fs41.mkdtempSync)((0, import_node_path50.join)((0, import_node_os2.tmpdir)(), "mnci-new-"));
-  let workspaceRoot = (0, import_node_path50.join)(stagingParent, workspaceName);
+  const stagingParent = adoptTarget === void 0 ? process.cwd() : (0, import_node_fs42.mkdtempSync)((0, import_node_path52.join)((0, import_node_os2.tmpdir)(), "mnci-new-"));
+  let workspaceRoot = (0, import_node_path52.join)(stagingParent, workspaceName);
   try {
     logger.step(`Creating Nx workspace '${workspaceName}' (preset: ts)`);
     runNpx(
@@ -10379,7 +10769,7 @@ async function runNew(name, options) {
       workspaceRoot = adoptTarget;
     }
   } finally {
-    if (adoptTarget !== void 0) (0, import_node_fs41.rmSync)(stagingParent, { recursive: true, force: true });
+    if (adoptTarget !== void 0) (0, import_node_fs42.rmSync)(stagingParent, { recursive: true, force: true });
   }
   logger.step(
     "Applying MoNecromanCI overlay (VS Code workspace, release config, .npmrc, commitlint, pipeline, stack)"
@@ -10389,8 +10779,8 @@ async function runNew(name, options) {
     { workspaceName, scope, registry, agent, variableGroup, ci, stack, ...npmAuth && { npmAuth } },
     logger.detail
   );
-  (0, import_node_fs41.rmSync)((0, import_node_path50.join)(workspaceRoot, "node_modules"), { recursive: true, force: true });
-  (0, import_node_fs41.rmSync)((0, import_node_path50.join)(workspaceRoot, "package-lock.json"), { force: true });
+  (0, import_node_fs42.rmSync)((0, import_node_path52.join)(workspaceRoot, "node_modules"), { recursive: true, force: true });
+  (0, import_node_fs42.rmSync)((0, import_node_path52.join)(workspaceRoot, "package-lock.json"), { force: true });
   logger.step("Installing the toolchain (commitlint + husky + linting/formatting)");
   const installStatus = runShell(
     "npm",
@@ -10403,6 +10793,9 @@ async function runNew(name, options) {
   runShell("npx", ["husky"], workspaceRoot);
   logger.step("Formatting the workspace (eslint --fix, JavaScript Standard Style)");
   runFormatter(workspaceRoot);
+  if (options.preset !== void 0) {
+    await applyPreset(workspaceRoot, options.preset);
+  }
   logger.success("Done. Next steps:");
   if (adoptTarget === void 0) logger.info(`  cd ${workspaceName}`);
   for (const line of projectKindHintLines()) {
@@ -10440,6 +10833,8 @@ function buildProgram(cliVersion) {
   ).addOption(new import_commander.Option("--ci <provider>", "CI provider").choices(["azure", "github", "both"])).option("--test-runner <runner>", "unit-test runner: jest | vitest").option("--nx-cloud", "connect the workspace to Nx Cloud (remote caching + CI insights)").option(
     "--into <dir>",
     "bootstrap into an existing directory (a fresh clone holding only .git); the directory name is the workspace name unless one is given"
+  ).addOption(
+    new import_commander.Option("--preset <preset>", "also scaffold a whole shape of workspace, its projects wired together (web-api: a React frontend and an Express API sharing one library)").choices(PRESET_IDS)
   ).action(async (name, options) => {
     await runNew(name, options);
   });
@@ -10454,6 +10849,9 @@ function buildProgram(cliVersion) {
   ).action((options) => {
     runUpgrade(process.cwd(), options);
   });
+  program.command("dev").argument("[projects...]", "the projects to start (those with a start command)").description("Start several projects together, such as a frontend and the API it calls: runs their start targets as one Nx command, so Ctrl+C stops them all. Name the projects, pass --all, or pick from a list").option("--all", "start every project that has a start command").option("--dry-run", "print the Nx command and start nothing").action(async (projects, options) => {
+    await runDev(process.cwd(), projects, options);
+  });
   program.command("doctor").description(
     "Check this workspace against the invariants mnci maintains (one ESLint config, no stray .prettierrc, the eslint plugin registered, the resolved eslint major, .npmrc vs the recorded registry, versionActions overrides, nx sync) \u2014 read-only; exits non-zero if anything failed"
   ).option("--json", "print the findings as one JSON document, each with its remedy").action((options) => {