@mnci/cli 4.50.0 → 4.51.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));
@@ -10202,7 +10319,7 @@ async function runInteractive(program, prompter = createInquirerPrompter(), work
 
 // src/workspace-creation/adopt-directory.use-case.ts
 var import_node_fs40 = require("fs");
-var import_node_path49 = require("path");
+var import_node_path50 = require("path");
 var NEVER_COPIED = /* @__PURE__ */ new Set([".git", "node_modules"]);
 var AGENT_AND_CI_ENTRIES = [
   "AGENTS.md",
@@ -10239,7 +10356,7 @@ function assertAdoptableDirectory(target) {
   if (!(0, import_node_fs40.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_fs40.existsSync)((0, import_node_path50.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.`
@@ -10267,7 +10384,7 @@ ${additions.join("\n")}
 function adoptGeneratedWorkspace(generatedRoot, target) {
   const entries = (0, import_node_fs40.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_fs40.existsSync)((0, import_node_path50.join)(target, entry)) && !EXISTING_WINS.has(entry) && entry !== ".gitignore"
   );
   if (collisions.length > 0) {
     throw new Error(
@@ -10276,8 +10393,8 @@ 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);
+    const from = (0, import_node_path50.join)(generatedRoot, entry);
+    const to = (0, import_node_path50.join)(target, entry);
     if (entry === ".gitignore" && (0, import_node_fs40.existsSync)(to)) {
       result.mergedGitignore = mergeGitignore(from, to);
       result.kept.push(entry);
@@ -10297,7 +10414,7 @@ function adoptGeneratedWorkspace(generatedRoot, target) {
 // src/workspace-creation/create-workspace.use-case.ts
 var import_node_fs41 = require("fs");
 var import_node_os2 = require("os");
-var import_node_path50 = require("path");
+var import_node_path51 = require("path");
 function nxCloudProviderValue(ci) {
   return ci === "azure" ? "azure" : "github";
 }
@@ -10340,9 +10457,9 @@ 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_path51.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));
+  const workspaceName = name ?? (adoptTarget === void 0 ? await promptText("Workspace name") : (0, import_node_path51.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 +10472,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_fs41.mkdtempSync)((0, import_node_path51.join)((0, import_node_os2.tmpdir)(), "mnci-new-"));
+  let workspaceRoot = (0, import_node_path51.join)(stagingParent, workspaceName);
   try {
     logger.step(`Creating Nx workspace '${workspaceName}' (preset: ts)`);
     runNpx(
@@ -10389,8 +10506,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_fs41.rmSync)((0, import_node_path51.join)(workspaceRoot, "node_modules"), { recursive: true, force: true });
+  (0, import_node_fs41.rmSync)((0, import_node_path51.join)(workspaceRoot, "package-lock.json"), { force: true });
   logger.step("Installing the toolchain (commitlint + husky + linting/formatting)");
   const installStatus = runShell(
     "npm",
@@ -10454,6 +10571,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) => {