@qpqjs/cli 0.2.1 → 0.4.0

package/lib/commonjs/lib/killStaleListeners.js

@@ -4,15 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.killStaleListeners = exports.reportPortHolders = exports.killOtherQpqDevProcesses = exports.isQpqCliCommand = void 0;
-// Pre-start sweep shared by the dev-server commands: a previous run whose
-// wrapper died without killing its listener (closed terminal, SIGKILL) leaves
-// an orphaned process holding a dev port, and the next launch dies with
-// EADDRINUSE. Before starting, kill any listener on the given ports whose
-// command line matches `isOurs`. Anything else on the ports is left alone
-// and reported — it's not ours.
-const child_process_1 = require("child_process");
+const runCommand_1 = require("./runCommand");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const out_1 = require("./out");
+const out = (0, out_1.createOutput)('kill-stale-listeners');
 // Matches any invocation of the qpq CLI itself, regardless of how it was
 // launched: `node node_modules/.bin/qpq ...` (the npm-script shim, which has
 // no .js extension), a direct `node .../lib/commonjs/bin/qpq.js` call, a
@@ -28,22 +24,21 @@ const isQpqCliCommand = (command) => command
     return withoutExt === 'qpq';
 });
 exports.isQpqCliCommand = isQpqCliCommand;
-// SIGTERM only requests termination — the caller (about to bind this same
+// SIGTERM only requests termination, the caller (about to bind this same
 // process's ports itself) needs it actually gone first. A stale dev server
 // can be mid-startup when killed (still resolving config, not yet bound to
 // every port it eventually binds) and keep running for a bit past the
-// signal, going on to bind a LATER port — waiting for just the one port that
+// signal, going on to bind a LATER port, waiting for just the one port that
 // matched isn't enough; wait for the whole pid to disappear so it can't bind
 // anything else afterward. Poll synchronously (this whole sweep runs before
-// anything async starts) via `kill(pid, 0)` — reliable and fast here because
-// these are unrelated, previously-orphaned processes, not children of this
+// anything async starts) via `kill(pid, 0)`, reliable and fast here because
+// these are unrelated processes orphaned earlier, not children of this
 // one (a real child can sit as a zombie answering `kill(pid, 0)` until this
 // process's own event loop reaps it, which a tight sync loop would starve;
 // doesn't apply to a process we didn't spawn).
 //
 // The default covers the dev server's graceful shutdown (drain in-flight work,
-// then checkpoint the stores) with room to spare — it used to be 3s, which was
-// fine when the server died instantly and is not now. Returns whether the pid
+// then checkpoint the stores) with room to spare. Returns whether the pid
 // actually went, because a caller about to bind these ports has to escalate
 // rather than hope: giving up while the old server still holds 8080 is exactly
 // the EADDRINUSE this file exists to prevent.
@@ -56,13 +51,13 @@ const waitForPidGone = (pid, timeoutMs = 8000) => {
         catch (_a) {
             return true; // throws once the pid no longer exists
         }
-        (0, child_process_1.execSync)('sleep 0.05');
+        (0, runCommand_1.sleepSync)(50);
     }
     return false;
 };
 // Last resort for a process that ignored, or wedged during, its graceful stop.
 const killPidHard = (pid) => {
-    console.warn(`Process ${pid} did not exit gracefully — sending SIGKILL.`);
+    out.warn(`Process ${pid} did not exit gracefully — sending SIGKILL.`);
     try {
         process.kill(pid, 'SIGKILL');
     }
@@ -77,8 +72,7 @@ const killPidHard = (pid) => {
 // itself a symlink (a symlinked home directory, an NFS mount, etc).
 const getProcessCwd = (pid) => {
     try {
-        const line = (0, child_process_1.execSync)(`lsof -a -p ${pid} -d cwd -Fn`, { stdio: ['ignore', 'pipe', 'ignore'] })
-            .toString()
+        const line = (0, runCommand_1.runCommandCaptureSync)('lsof', ['-a', '-p', String(pid), '-d', 'cwd', '-Fn'])
             .split('\n')
             .find((l) => l.startsWith('n'));
         return line ? fs_1.default.realpathSync(line.slice(1)) : null;
@@ -91,7 +85,7 @@ const getProcessCwd = (pid) => {
 // `npx qpq go:dev:api` (or via any shell whose -c string names qpq), the
 // ancestor chain (`sh -c "npx ... qpq ..."`, `npm exec qpq ...`) matches
 // isQpqCliCommand and shares our cwd, so excluding just process.pid isn't
-// enough — SIGINTing an ancestor tears down our own tree. Walk ppid to the
+// enough, SIGINTing an ancestor tears down our own tree. Walk ppid to the
 // top and exclude the whole chain.
 const getOwnAncestorPids = () => {
     const ancestors = new Set();
@@ -99,9 +93,7 @@ const getOwnAncestorPids = () => {
     while (pid > 1 && !ancestors.has(pid)) {
         ancestors.add(pid);
         try {
-            pid = Number((0, child_process_1.execSync)(`ps -o ppid= -p ${pid}`, { stdio: ['ignore', 'pipe', 'ignore'] })
-                .toString()
-                .trim());
+            pid = Number((0, runCommand_1.runCommandCaptureSync)('ps', ['-o', 'ppid=', '-p', String(pid)]).trim());
         }
         catch (_a) {
             break;
@@ -110,11 +102,11 @@ const getOwnAncestorPids = () => {
     return ancestors;
 };
 // killStaleListeners only sees processes currently BOUND to one of the given
-// ports — it can't catch a still-running `qpq go:dev*` watcher whose spawned
+// ports, it can't catch a still-running `qpq go:dev*` watcher whose spawned
 // dev-server child already died (a crash, or us killing just the child):
 // the watcher itself holds no port at that moment, so it's invisible to a
-// port scan, yet it's still alive and can spawn a fresh child — and bind a
-// port — moments later, racing whatever we're about to start. Close that gap
+// port scan, yet it's still alive and can spawn a fresh child, and bind a
+// port, moments later, racing whatever we're about to start. Close that gap
 // by finding any OTHER qpq CLI process rooted in the same repo checkout
 // (matched by cwd, not by port or command-line args, which vary by how it
 // was invoked) and killing it outright, regardless of what it currently has
@@ -125,9 +117,7 @@ const killOtherQpqDevProcesses = (root) => {
     const ownPids = getOwnAncestorPids();
     let lines = [];
     try {
-        lines = (0, child_process_1.execSync)('ps -axo pid=,command=', { stdio: ['ignore', 'pipe', 'ignore'] })
-            .toString()
-            .split('\n');
+        lines = (0, runCommand_1.runCommandCaptureSync)('ps', ['-axo', 'pid=,command=']).split('\n');
     }
     catch (_a) {
         return;
@@ -145,7 +135,7 @@ const killOtherQpqDevProcesses = (root) => {
             continue;
         if (getProcessCwd(pid) !== resolvedRoot)
             continue;
-        console.log(`Killing other qpq dev process for this repo (pid ${pid}): ${command}`);
+        out.log(`Killing other qpq dev process for this repo (pid ${pid}): ${command}`);
         process.kill(pid, 'SIGINT');
         if (!waitForPidGone(pid)) {
             killPidHard(pid);
@@ -158,10 +148,7 @@ exports.killOtherQpqDevProcesses = killOtherQpqDevProcesses;
 const getPortListeners = (port) => {
     let pids = [];
     try {
-        pids = (0, child_process_1.execSync)(`lsof -t -iTCP:${port} -sTCP:LISTEN`, {
-            stdio: ['ignore', 'pipe', 'ignore'],
-        })
-            .toString()
+        pids = (0, runCommand_1.runCommandCaptureSync)('lsof', ['-t', `-iTCP:${port}`, '-sTCP:LISTEN'])
             .split('\n')
             .map((line) => Number(line.trim()))
             .filter(Boolean);
@@ -171,7 +158,7 @@ const getPortListeners = (port) => {
     }
     return pids.flatMap((pid) => {
         try {
-            return [{ pid, command: (0, child_process_1.execSync)(`ps -p ${pid} -o command=`).toString().trim() }];
+            return [{ pid, command: (0, runCommand_1.runCommandCaptureSync)('ps', ['-p', String(pid), '-o', 'command=']).trim() }];
         }
         catch (_a) {
             return []; // already gone
@@ -194,8 +181,8 @@ const getPortListeners = (port) => {
 const reportPortHolders = (ports) => {
     for (const port of ports) {
         for (const { pid, command } of getPortListeners(port)) {
-            console.warn(`Port ${port} is currently held by pid ${pid}: ${command}`);
-            console.warn(`  Starting anyway. If it still holds port ${port} once this server binds, startup will fail with EADDRINUSE.`);
+            out.warn(`Port ${port} is currently held by pid ${pid}: ${command}`);
+            out.warn(`  Starting anyway. If it still holds port ${port} once this server binds, startup will fail with EADDRINUSE.`);
         }
     }
 };
@@ -204,14 +191,14 @@ const killStaleListeners = (ports, isOurs) => {
     for (const port of ports) {
         for (const { pid, command } of getPortListeners(port)) {
             if (isOurs(command)) {
-                console.log(`Killing stale dev server on port ${port} (pid ${pid})`);
+                out.log(`Killing stale dev server on port ${port} (pid ${pid})`);
                 process.kill(pid);
                 if (!waitForPidGone(pid)) {
                     killPidHard(pid);
                 }
             }
             else {
-                console.warn(`Port ${port} is in use by an unrelated process (pid ${pid}: ${command}) — not killing it.`);
+                out.warn(`Port ${port} is in use by an unrelated process (pid ${pid}: ${command}) — not killing it.`);
             }
         }
     }

package/lib/commonjs/lib/killStaleListeners.js.map

@@ -1 +1 @@
-{"version":3,"file":"killStaleListeners.js","sourceRoot":"","sources":["../../../src/lib/killStaleListeners.ts"],"names":[],"mappings":";;;;;;AAAA,0EAA0E;AAC1E,8EAA8E;AAC9E,wEAAwE;AACxE,0EAA0E;AAC1E,0EAA0E;AAC1E,gCAAgC;AAChC,iDAAyC;AACzC,4CAAoB;AACpB,gDAAwB;AAExB,yEAAyE;AACzE,6EAA6E;AAC7E,yEAAyE;AACzE,6EAA6E;AAC7E,mEAAmE;AACnE,4DAA4D;AACrD,MAAM,eAAe,GAAG,CAAC,OAAe,EAAW,EAAE,CAC1D,OAAO;KACJ,IAAI,EAAE;KACN,KAAK,CAAC,KAAK,CAAC;KACZ,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;IACd,MAAM,IAAI,GAAG,cAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,OAAO,UAAU,KAAK,KAAK,CAAC;AAC9B,CAAC,CAAC,CAAC;AARM,QAAA,eAAe,mBAQrB;AAEP,0EAA0E;AAC1E,2EAA2E;AAC3E,2EAA2E;AAC3E,sEAAsE;AACtE,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,6EAA6E;AAC7E,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAC3E,+CAA+C;AAC/C,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,8CAA8C;AAC9C,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,SAAS,GAAG,IAAI,EAAW,EAAE;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACvB,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,IAAI,CAAC,CAAC,uCAAuC;QACtD,CAAC;QACD,IAAA,wBAAQ,EAAC,YAAY,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,WAAW,GAAG,CAAC,GAAW,EAAQ,EAAE;IACxC,OAAO,CAAC,IAAI,CAAC,WAAW,GAAG,6CAA6C,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,CAAC,gCAAgC;IAC1C,CAAC;IACD,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,2EAA2E;AAC3E,wEAAwE;AACxE,2EAA2E;AAC3E,oEAAoE;AACpE,MAAM,aAAa,GAAG,CAAC,GAAW,EAAiB,EAAE;IACnD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAA,wBAAQ,EAAC,cAAc,GAAG,aAAa,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;aAC3F,QAAQ,EAAE;aACV,KAAK,CAAC,IAAI,CAAC;aACX,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,CAAC,CAAC,YAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,sDAAsD;IACrE,CAAC;AACH,CAAC,CAAC;AAEF,6EAA6E;AAC7E,yEAAyE;AACzE,yEAAyE;AACzE,0EAA0E;AAC1E,2EAA2E;AAC3E,mCAAmC;AACnC,MAAM,kBAAkB,GAAG,GAAgB,EAAE;IAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACtB,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,CACV,IAAA,wBAAQ,EAAC,kBAAkB,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;iBACvE,QAAQ,EAAE;iBACV,IAAI,EAAE,CACV,CAAC;QACJ,CAAC;QAAC,WAAM,CAAC;YACP,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,6EAA6E;AAC7E,6EAA6E;AAC7E,yEAAyE;AACzE,0EAA0E;AAC1E,2EAA2E;AAC3E,6EAA6E;AAC7E,wEAAwE;AACxE,0EAA0E;AAC1E,4EAA4E;AAC5E,uEAAuE;AACvE,0EAA0E;AACnE,MAAM,wBAAwB,GAAG,CAAC,IAAY,EAAQ,EAAE;IAC7D,MAAM,YAAY,GAAG,YAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IAErC,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,KAAK,GAAG,IAAA,wBAAQ,EAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;aAC/E,QAAQ,EAAE;aACV,KAAK,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAAC,WAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,UAAU,KAAK,CAAC,CAAC;YAAE,SAAS;QAEhC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAErD,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAA,uBAAe,EAAC,OAAO,CAAC;YAAE,SAAS;QACpE,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,YAAY;YAAE,SAAS;QAElD,OAAO,CAAC,GAAG,CAAC,oDAAoD,GAAG,MAAM,OAAO,EAAE,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAhCW,QAAA,wBAAwB,4BAgCnC;AAEF,+EAA+E;AAC/E,iDAAiD;AACjD,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAsC,EAAE;IAC5E,IAAI,IAAI,GAAa,EAAE,CAAC;IACxB,IAAI,CAAC;QACH,IAAI,GAAG,IAAA,wBAAQ,EAAC,iBAAiB,IAAI,eAAe,EAAE;YACpD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC;aACC,QAAQ,EAAE;aACV,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;aAClC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,gDAAgD;IAC7D,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAA,wBAAQ,EAAC,SAAS,GAAG,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,eAAe;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACI,MAAM,iBAAiB,GAAG,CAAC,KAAe,EAAQ,EAAE;IACzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,6BAA6B,GAAG,KAAK,OAAO,EAAE,CAAC,CAAC;YACzE,OAAO,CAAC,IAAI,CAAC,6CAA6C,IAAI,6DAA6D,CAAC,CAAC;QAC/H,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAPW,QAAA,iBAAiB,qBAO5B;AAEK,MAAM,kBAAkB,GAAG,CAAC,KAAe,EAAE,MAAoC,EAAQ,EAAE;IAChG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,oCAAoC,IAAI,SAAS,GAAG,GAAG,CAAC,CAAC;gBACrE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAClB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;oBACzB,WAAW,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,2CAA2C,GAAG,KAAK,OAAO,qBAAqB,CAAC,CAAC;YAC5G,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAdW,QAAA,kBAAkB,sBAc7B","sourcesContent":["// Pre-start sweep shared by the dev-server commands: a previous run whose\n// wrapper died without killing its listener (closed terminal, SIGKILL) leaves\n// an orphaned process holding a dev port, and the next launch dies with\n// EADDRINUSE. Before starting, kill any listener on the given ports whose\n// command line matches `isOurs`. Anything else on the ports is left alone\n// and reported — it's not ours.\nimport { execSync } from 'child_process';\nimport fs from 'fs';\nimport path from 'path';\n\n// Matches any invocation of the qpq CLI itself, regardless of how it was\n// launched: `node node_modules/.bin/qpq ...` (the npm-script shim, which has\n// no .js extension), a direct `node .../lib/commonjs/bin/qpq.js` call, a\n// global `qpq` shebang script, etc. Checks each whitespace-separated token's\n// basename (extension stripped) rather than a fixed substring like\n// 'bin/qpq.js', which only matches the last of those forms.\nexport const isQpqCliCommand = (command: string): boolean =>\n  command\n    .trim()\n    .split(/\\s+/)\n    .some((token) => {\n      const base = path.basename(token);\n      const withoutExt = base.endsWith('.js') ? base.slice(0, -3) : base;\n      return withoutExt === 'qpq';\n    });\n\n// SIGTERM only requests termination — the caller (about to bind this same\n// process's ports itself) needs it actually gone first. A stale dev server\n// can be mid-startup when killed (still resolving config, not yet bound to\n// every port it eventually binds) and keep running for a bit past the\n// signal, going on to bind a LATER port — waiting for just the one port that\n// matched isn't enough; wait for the whole pid to disappear so it can't bind\n// anything else afterward. Poll synchronously (this whole sweep runs before\n// anything async starts) via `kill(pid, 0)` — reliable and fast here because\n// these are unrelated, previously-orphaned processes, not children of this\n// one (a real child can sit as a zombie answering `kill(pid, 0)` until this\n// process's own event loop reaps it, which a tight sync loop would starve;\n// doesn't apply to a process we didn't spawn).\n//\n// The default covers the dev server's graceful shutdown (drain in-flight work,\n// then checkpoint the stores) with room to spare — it used to be 3s, which was\n// fine when the server died instantly and is not now. Returns whether the pid\n// actually went, because a caller about to bind these ports has to escalate\n// rather than hope: giving up while the old server still holds 8080 is exactly\n// the EADDRINUSE this file exists to prevent.\nconst waitForPidGone = (pid: number, timeoutMs = 8000): boolean => {\n  const deadline = Date.now() + timeoutMs;\n  while (Date.now() < deadline) {\n    try {\n      process.kill(pid, 0);\n    } catch {\n      return true; // throws once the pid no longer exists\n    }\n    execSync('sleep 0.05');\n  }\n\n  return false;\n};\n\n// Last resort for a process that ignored, or wedged during, its graceful stop.\nconst killPidHard = (pid: number): void => {\n  console.warn(`Process ${pid} did not exit gracefully — sending SIGKILL.`);\n  try {\n    process.kill(pid, 'SIGKILL');\n  } catch {\n    return; // raced us and exited after all\n  }\n  waitForPidGone(pid, 2000);\n};\n\n// realpath'd: lsof reports the canonical path (e.g. /private/tmp on macOS,\n// where /tmp is a symlink), so comparing against a caller-supplied root\n// verbatim would false-negative whenever any component of the repo path is\n// itself a symlink (a symlinked home directory, an NFS mount, etc).\nconst getProcessCwd = (pid: number): string | null => {\n  try {\n    const line = execSync(`lsof -a -p ${pid} -d cwd -Fn`, { stdio: ['ignore', 'pipe', 'ignore'] })\n      .toString()\n      .split('\\n')\n      .find((l) => l.startsWith('n'));\n    return line ? fs.realpathSync(line.slice(1)) : null;\n  } catch {\n    return null; // pid gone, or we don't have permission to inspect it\n  }\n};\n\n// The sweep below must never target this process's own wrappers: launched as\n// `npx qpq go:dev:api` (or via any shell whose -c string names qpq), the\n// ancestor chain (`sh -c \"npx ... qpq ...\"`, `npm exec qpq ...`) matches\n// isQpqCliCommand and shares our cwd, so excluding just process.pid isn't\n// enough — SIGINTing an ancestor tears down our own tree. Walk ppid to the\n// top and exclude the whole chain.\nconst getOwnAncestorPids = (): Set<number> => {\n  const ancestors = new Set<number>();\n  let pid = process.pid;\n  while (pid > 1 && !ancestors.has(pid)) {\n    ancestors.add(pid);\n    try {\n      pid = Number(\n        execSync(`ps -o ppid= -p ${pid}`, { stdio: ['ignore', 'pipe', 'ignore'] })\n          .toString()\n          .trim(),\n      );\n    } catch {\n      break;\n    }\n  }\n  return ancestors;\n};\n\n// killStaleListeners only sees processes currently BOUND to one of the given\n// ports — it can't catch a still-running `qpq go:dev*` watcher whose spawned\n// dev-server child already died (a crash, or us killing just the child):\n// the watcher itself holds no port at that moment, so it's invisible to a\n// port scan, yet it's still alive and can spawn a fresh child — and bind a\n// port — moments later, racing whatever we're about to start. Close that gap\n// by finding any OTHER qpq CLI process rooted in the same repo checkout\n// (matched by cwd, not by port or command-line args, which vary by how it\n// was invoked) and killing it outright, regardless of what it currently has\n// bound. SIGINT (not SIGTERM) so goDevApiCommand/goDevWebCommand's own\n// handler runs and tears down its child cleanly rather than orphaning it.\nexport const killOtherQpqDevProcesses = (root: string): void => {\n  const resolvedRoot = fs.realpathSync(root);\n  const ownPids = getOwnAncestorPids();\n\n  let lines: string[] = [];\n  try {\n    lines = execSync('ps -axo pid=,command=', { stdio: ['ignore', 'pipe', 'ignore'] })\n      .toString()\n      .split('\\n');\n  } catch {\n    return;\n  }\n\n  for (const line of lines) {\n    const trimmed = line.trim();\n    if (!trimmed) continue;\n\n    const spaceIndex = trimmed.indexOf(' ');\n    if (spaceIndex === -1) continue;\n\n    const pid = Number(trimmed.slice(0, spaceIndex));\n    const command = trimmed.slice(spaceIndex + 1).trim();\n\n    if (!pid || ownPids.has(pid) || !isQpqCliCommand(command)) continue;\n    if (getProcessCwd(pid) !== resolvedRoot) continue;\n\n    console.log(`Killing other qpq dev process for this repo (pid ${pid}): ${command}`);\n    process.kill(pid, 'SIGINT');\n    if (!waitForPidGone(pid)) {\n      killPidHard(pid);\n    }\n  }\n};\n\n// Whatever is currently listening on a port, as pid + command line. Empty when\n// the port is free, or when lsof is unavailable.\nconst getPortListeners = (port: number): { pid: number; command: string }[] => {\n  let pids: number[] = [];\n  try {\n    pids = execSync(`lsof -t -iTCP:${port} -sTCP:LISTEN`, {\n      stdio: ['ignore', 'pipe', 'ignore'],\n    })\n      .toString()\n      .split('\\n')\n      .map((line) => Number(line.trim()))\n      .filter(Boolean);\n  } catch {\n    return []; // lsof exits non-zero when nothing is listening\n  }\n\n  return pids.flatMap((pid) => {\n    try {\n      return [{ pid, command: execSync(`ps -p ${pid} -o command=`).toString().trim() }];\n    } catch {\n      return []; // already gone\n    }\n  });\n};\n\n/**\n * Say what is holding these ports, without touching it.\n *\n * The other half of --keep-other-dev-servers: sparing a sibling checkout's dev\n * server means this one cannot bind, and an unexplained EADDRINUSE is a worse\n * experience than the silent kill it replaces. Naming the pid and the command\n * turns \"it just died\" into something you can act on.\n *\n * Worded as a prediction, not a fact, because it IS one: this runs before the\n * bundle step, so by the time anything binds - seconds later - the holder may\n * well have gone. Stating \"port in use\" and then starting cleanly reads like\n * the warning was wrong.\n */\nexport const reportPortHolders = (ports: number[]): void => {\n  for (const port of ports) {\n    for (const { pid, command } of getPortListeners(port)) {\n      console.warn(`Port ${port} is currently held by pid ${pid}: ${command}`);\n      console.warn(`  Starting anyway. If it still holds port ${port} once this server binds, startup will fail with EADDRINUSE.`);\n    }\n  }\n};\n\nexport const killStaleListeners = (ports: number[], isOurs: (command: string) => boolean): void => {\n  for (const port of ports) {\n    for (const { pid, command } of getPortListeners(port)) {\n      if (isOurs(command)) {\n        console.log(`Killing stale dev server on port ${port} (pid ${pid})`);\n        process.kill(pid);\n        if (!waitForPidGone(pid)) {\n          killPidHard(pid);\n        }\n      } else {\n        console.warn(`Port ${port} is in use by an unrelated process (pid ${pid}: ${command}) — not killing it.`);\n      }\n    }\n  }\n};\n"]}
+{"version":3,"file":"killStaleListeners.js","sourceRoot":"","sources":["../../../src/lib/killStaleListeners.ts"],"names":[],"mappings":"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","sourcesContent":["import { runCommandCaptureSync, sleepSync } from './runCommand';\n// Pre-start sweep shared by the dev-server commands: a previous run whose\n// wrapper died without killing its listener (closed terminal, SIGKILL) leaves\n// an orphaned process holding a dev port, and the next launch dies with\n// EADDRINUSE. Before starting, kill any listener on the given ports whose\n// command line matches `isOurs`. Anything else on the ports is left alone\n// and reported, it's not ours.\nimport { Nullable } from '@qpqjs/core';\n\nimport fs from 'fs';\nimport path from 'path';\nimport { createOutput } from './out';\n\nconst out = createOutput('kill-stale-listeners');\n\n// Matches any invocation of the qpq CLI itself, regardless of how it was\n// launched: `node node_modules/.bin/qpq ...` (the npm-script shim, which has\n// no .js extension), a direct `node .../lib/commonjs/bin/qpq.js` call, a\n// global `qpq` shebang script, etc. Checks each whitespace-separated token's\n// basename (extension stripped) rather than a fixed substring like\n// 'bin/qpq.js', which only matches the last of those forms.\nexport const isQpqCliCommand = (command: string): boolean =>\n  command\n    .trim()\n    .split(/\\s+/)\n    .some((token) => {\n      const base = path.basename(token);\n      const withoutExt = base.endsWith('.js') ? base.slice(0, -3) : base;\n      return withoutExt === 'qpq';\n    });\n\n// SIGTERM only requests termination, the caller (about to bind this same\n// process's ports itself) needs it actually gone first. A stale dev server\n// can be mid-startup when killed (still resolving config, not yet bound to\n// every port it eventually binds) and keep running for a bit past the\n// signal, going on to bind a LATER port, waiting for just the one port that\n// matched isn't enough; wait for the whole pid to disappear so it can't bind\n// anything else afterward. Poll synchronously (this whole sweep runs before\n// anything async starts) via `kill(pid, 0)`, reliable and fast here because\n// these are unrelated processes orphaned earlier, not children of this\n// one (a real child can sit as a zombie answering `kill(pid, 0)` until this\n// process's own event loop reaps it, which a tight sync loop would starve;\n// doesn't apply to a process we didn't spawn).\n//\n// The default covers the dev server's graceful shutdown (drain in-flight work,\n// then checkpoint the stores) with room to spare. Returns whether the pid\n// actually went, because a caller about to bind these ports has to escalate\n// rather than hope: giving up while the old server still holds 8080 is exactly\n// the EADDRINUSE this file exists to prevent.\nconst waitForPidGone = (pid: number, timeoutMs = 8000): boolean => {\n  const deadline = Date.now() + timeoutMs;\n  while (Date.now() < deadline) {\n    try {\n      process.kill(pid, 0);\n    } catch {\n      return true; // throws once the pid no longer exists\n    }\n    sleepSync(50);\n  }\n\n  return false;\n};\n\n// Last resort for a process that ignored, or wedged during, its graceful stop.\nconst killPidHard = (pid: number): void => {\n  out.warn(`Process ${pid} did not exit gracefully — sending SIGKILL.`);\n  try {\n    process.kill(pid, 'SIGKILL');\n  } catch {\n    return; // raced us and exited after all\n  }\n  waitForPidGone(pid, 2000);\n};\n\n// realpath'd: lsof reports the canonical path (e.g. /private/tmp on macOS,\n// where /tmp is a symlink), so comparing against a caller-supplied root\n// verbatim would false-negative whenever any component of the repo path is\n// itself a symlink (a symlinked home directory, an NFS mount, etc).\nconst getProcessCwd = (pid: number): Nullable<string> => {\n  try {\n    const line = runCommandCaptureSync('lsof', ['-a', '-p', String(pid), '-d', 'cwd', '-Fn'])\n      .split('\\n')\n      .find((l) => l.startsWith('n'));\n    return line ? fs.realpathSync(line.slice(1)) : null;\n  } catch {\n    return null; // pid gone, or we don't have permission to inspect it\n  }\n};\n\n// The sweep below must never target this process's own wrappers: launched as\n// `npx qpq go:dev:api` (or via any shell whose -c string names qpq), the\n// ancestor chain (`sh -c \"npx ... qpq ...\"`, `npm exec qpq ...`) matches\n// isQpqCliCommand and shares our cwd, so excluding just process.pid isn't\n// enough, SIGINTing an ancestor tears down our own tree. Walk ppid to the\n// top and exclude the whole chain.\nconst getOwnAncestorPids = (): Set<number> => {\n  const ancestors = new Set<number>();\n  let pid = process.pid;\n  while (pid > 1 && !ancestors.has(pid)) {\n    ancestors.add(pid);\n    try {\n      pid = Number(runCommandCaptureSync('ps', ['-o', 'ppid=', '-p', String(pid)]).trim());\n    } catch {\n      break;\n    }\n  }\n  return ancestors;\n};\n\n// killStaleListeners only sees processes currently BOUND to one of the given\n// ports, it can't catch a still-running `qpq go:dev*` watcher whose spawned\n// dev-server child already died (a crash, or us killing just the child):\n// the watcher itself holds no port at that moment, so it's invisible to a\n// port scan, yet it's still alive and can spawn a fresh child, and bind a\n// port, moments later, racing whatever we're about to start. Close that gap\n// by finding any OTHER qpq CLI process rooted in the same repo checkout\n// (matched by cwd, not by port or command-line args, which vary by how it\n// was invoked) and killing it outright, regardless of what it currently has\n// bound. SIGINT (not SIGTERM) so goDevApiCommand/goDevWebCommand's own\n// handler runs and tears down its child cleanly rather than orphaning it.\nexport const killOtherQpqDevProcesses = (root: string): void => {\n  const resolvedRoot = fs.realpathSync(root);\n  const ownPids = getOwnAncestorPids();\n\n  let lines: string[] = [];\n  try {\n    lines = runCommandCaptureSync('ps', ['-axo', 'pid=,command=']).split('\\n');\n  } catch {\n    return;\n  }\n\n  for (const line of lines) {\n    const trimmed = line.trim();\n    if (!trimmed) continue;\n\n    const spaceIndex = trimmed.indexOf(' ');\n    if (spaceIndex === -1) continue;\n\n    const pid = Number(trimmed.slice(0, spaceIndex));\n    const command = trimmed.slice(spaceIndex + 1).trim();\n\n    if (!pid || ownPids.has(pid) || !isQpqCliCommand(command)) continue;\n    if (getProcessCwd(pid) !== resolvedRoot) continue;\n\n    out.log(`Killing other qpq dev process for this repo (pid ${pid}): ${command}`);\n    process.kill(pid, 'SIGINT');\n    if (!waitForPidGone(pid)) {\n      killPidHard(pid);\n    }\n  }\n};\n\n// Whatever is currently listening on a port, as pid + command line. Empty when\n// the port is free, or when lsof is unavailable.\nconst getPortListeners = (port: number): { pid: number; command: string }[] => {\n  let pids: number[] = [];\n  try {\n    pids = runCommandCaptureSync('lsof', ['-t', `-iTCP:${port}`, '-sTCP:LISTEN'])\n      .split('\\n')\n      .map((line) => Number(line.trim()))\n      .filter(Boolean);\n  } catch {\n    return []; // lsof exits non-zero when nothing is listening\n  }\n\n  return pids.flatMap((pid) => {\n    try {\n      return [{ pid, command: runCommandCaptureSync('ps', ['-p', String(pid), '-o', 'command=']).trim() }];\n    } catch {\n      return []; // already gone\n    }\n  });\n};\n\n/**\n * Say what is holding these ports, without touching it.\n *\n * The other half of --keep-other-dev-servers: sparing a sibling checkout's dev\n * server means this one cannot bind, and an unexplained EADDRINUSE is a worse\n * experience than the silent kill it replaces. Naming the pid and the command\n * turns \"it just died\" into something you can act on.\n *\n * Worded as a prediction, not a fact, because it IS one: this runs before the\n * bundle step, so by the time anything binds - seconds later - the holder may\n * well have gone. Stating \"port in use\" and then starting cleanly reads like\n * the warning was wrong.\n */\nexport const reportPortHolders = (ports: number[]): void => {\n  for (const port of ports) {\n    for (const { pid, command } of getPortListeners(port)) {\n      out.warn(`Port ${port} is currently held by pid ${pid}: ${command}`);\n      out.warn(`  Starting anyway. If it still holds port ${port} once this server binds, startup will fail with EADDRINUSE.`);\n    }\n  }\n};\n\nexport const killStaleListeners = (ports: number[], isOurs: (command: string) => boolean): void => {\n  for (const port of ports) {\n    for (const { pid, command } of getPortListeners(port)) {\n      if (isOurs(command)) {\n        out.log(`Killing stale dev server on port ${port} (pid ${pid})`);\n        process.kill(pid);\n        if (!waitForPidGone(pid)) {\n          killPidHard(pid);\n        }\n      } else {\n        out.warn(`Port ${port} is in use by an unrelated process (pid ${pid}: ${command}) — not killing it.`);\n      }\n    }\n  }\n};\n"]}

package/lib/commonjs/lib/out.d.ts

@@ -0,0 +1,11 @@
+type Print = (...parts: unknown[]) => void;
+export type Output = {
+    log: Print;
+    info: Print;
+    warn: Print;
+    error: Print;
+    time: (label: string) => void;
+    timeEnd: (label: string) => void;
+};
+export declare const createOutput: (area: string) => Output;
+export {};

package/lib/commonjs/lib/out.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOutput = void 0;
+// Every line the cli prints carries `[qpq:<area>]`, so output from the concurrent and nested
+// commands reads as one program. This is the only place the cli touches the console.
+const createOutput = (area) => {
+    const prefix = `[qpq:${area}]`;
+    // A leading string is joined onto the prefix; anything else (an error, an object) is printed
+    // after it as its own argument so the console keeps formatting it. The console method is
+    // looked up per call, not captured, so a test can spy on it after this module loads.
+    const withPrefix = (method) => {
+        return (...parts) => {
+            const [first, ...rest] = parts;
+            if (typeof first === 'string') {
+                return console[method](`${prefix} ${first}`, ...rest);
+            }
+            return console[method](prefix, ...parts);
+        };
+    };
+    return {
+        log: withPrefix('log'),
+        info: withPrefix('info'),
+        warn: withPrefix('warn'),
+        error: withPrefix('error'),
+        time: (label) => console.time(`${prefix} ${label}`),
+        timeEnd: (label) => console.timeEnd(`${prefix} ${label}`),
+    };
+};
+exports.createOutput = createOutput;
+//# sourceMappingURL=out.js.map

package/lib/commonjs/lib/out.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"out.js","sourceRoot":"","sources":["../../../src/lib/out.ts"],"names":[],"mappings":";;;AAaA,6FAA6F;AAC7F,qFAAqF;AAC9E,MAAM,YAAY,GAAG,CAAC,IAAY,EAAU,EAAE;IACnD,MAAM,MAAM,GAAG,QAAQ,IAAI,GAAG,CAAC;IAE/B,6FAA6F;IAC7F,yFAAyF;IACzF,qFAAqF;IACrF,MAAM,UAAU,GAAG,CAAC,MAAyC,EAAS,EAAE;QACtE,OAAO,CAAC,GAAG,KAAK,EAAE,EAAE;YAClB,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;YAE/B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;YACxD,CAAC;YAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC;QACtB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC;QACxB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC;QACxB,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;QAC1B,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;QACnD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;KAC1D,CAAC;AACJ,CAAC,CAAC;AA1BW,QAAA,YAAY,gBA0BvB","sourcesContent":["/* eslint-disable no-console */\ntype Print = (...parts: unknown[]) => void;\n\nexport type Output = {\n  log: Print;\n  info: Print;\n  warn: Print;\n  error: Print;\n  // A named stopwatch, printed on end.\n  time: (label: string) => void;\n  timeEnd: (label: string) => void;\n};\n\n// Every line the cli prints carries `[qpq:<area>]`, so output from the concurrent and nested\n// commands reads as one program. This is the only place the cli touches the console.\nexport const createOutput = (area: string): Output => {\n  const prefix = `[qpq:${area}]`;\n\n  // A leading string is joined onto the prefix; anything else (an error, an object) is printed\n  // after it as its own argument so the console keeps formatting it. The console method is\n  // looked up per call, not captured, so a test can spy on it after this module loads.\n  const withPrefix = (method: 'log' | 'info' | 'warn' | 'error'): Print => {\n    return (...parts) => {\n      const [first, ...rest] = parts;\n\n      if (typeof first === 'string') {\n        return console[method](`${prefix} ${first}`, ...rest);\n      }\n\n      return console[method](prefix, ...parts);\n    };\n  };\n\n  return {\n    log: withPrefix('log'),\n    info: withPrefix('info'),\n    warn: withPrefix('warn'),\n    error: withPrefix('error'),\n    time: (label) => console.time(`${prefix} ${label}`),\n    timeEnd: (label) => console.timeEnd(`${prefix} ${label}`),\n  };\n};\n"]}

package/lib/commonjs/lib/prompts.d.ts

@@ -7,6 +7,7 @@ export declare const promptSelectDetailed: <T>(message: string, choices: {
 }[]) => Promise<T>;
 export declare const promptYesNo: (message: string) => Promise<boolean>;
 export declare const promptText: (message: string) => Promise<string>;
+export declare const promptTypedConfirmation: (target: string) => Promise<boolean>;
 export declare const promptCheckbox: <T>(message: string, choices: {
     name: string;
     value: T;

package/lib/commonjs/lib/prompts.js

@@ -42,7 +42,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.promptCheckbox = exports.promptText = exports.promptYesNo = exports.promptSelectDetailed = exports.promptSelect = void 0;
+exports.promptCheckbox = exports.promptTypedConfirmation = exports.promptText = exports.promptYesNo = exports.promptSelectDetailed = exports.promptSelect = void 0;
+const out_1 = require("./out");
+const out = (0, out_1.createOutput)('prompts');
 // Present a single-choice list prompt and return the selected value.
 // @inquirer/prompts is imported lazily so commands only pay for it when
 // actually prompting.
@@ -62,13 +64,24 @@ exports.promptSelectDetailed = promptSelectDetailed;
 // A yes/no list prompt, returning true for "Yes".
 const promptYesNo = (message) => __awaiter(void 0, void 0, void 0, function* () { return (yield (0, exports.promptSelect)(message, ['No', 'Yes'])) === 'Yes'; });
 exports.promptYesNo = promptYesNo;
-// A free-text prompt — used where a y/n is too easy to fat-finger (destructive
+// A free-text prompt, used where a y/n is too easy to fat-finger (destructive
 // confirmations that require typing the target name back).
 const promptText = (message) => __awaiter(void 0, void 0, void 0, function* () {
     const { input } = yield Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
     return input({ message });
 });
 exports.promptText = promptText;
+// The friction for destructive commands: the target has to be typed back exactly. Resolves
+// true when it was; prints why it stops otherwise, so callers only have to bail out.
+const promptTypedConfirmation = (target) => __awaiter(void 0, void 0, void 0, function* () {
+    const confirmation = yield (0, exports.promptText)(`Type '${target}' to confirm`);
+    if (confirmation !== target) {
+        out.log('Confirmation did not match. Exiting!');
+        return false;
+    }
+    return true;
+});
+exports.promptTypedConfirmation = promptTypedConfirmation;
 // A multi-select checkbox prompt over labelled values; `checked` preselects a choice.
 const promptCheckbox = (message, choices) => __awaiter(void 0, void 0, void 0, function* () {
     const { checkbox } = yield Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));

package/lib/commonjs/lib/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/lib/prompts.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qEAAqE;AACrE,wEAAwE;AACxE,sBAAsB;AACf,MAAM,YAAY,GAAG,CAAO,OAAe,EAAE,OAAiB,EAAE,aAAsB,EAAmB,EAAE;IAChH,MAAM,EAAE,MAAM,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IACrD,OAAO,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAA,CAAC;AAHW,QAAA,YAAY,gBAGvB;AAEF,wEAAwE;AACxE,6EAA6E;AAC7E,gEAAgE;AACzD,MAAM,oBAAoB,GAAG,CAClC,OAAe,EACf,OAA2E,EAC/D,EAAE;IACd,MAAM,EAAE,MAAM,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IACrD,OAAO,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACtC,CAAC,CAAA,CAAC;AANW,QAAA,oBAAoB,wBAM/B;AAEF,kDAAkD;AAC3C,MAAM,WAAW,GAAG,CAAO,OAAe,EAAoB,EAAE,kDAAC,OAAA,CAAC,MAAM,IAAA,oBAAY,EAAC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAA,GAAA,CAAC;AAAlH,QAAA,WAAW,eAAuG;AAE/H,+EAA+E;AAC/E,2DAA2D;AACpD,MAAM,UAAU,GAAG,CAAO,OAAe,EAAmB,EAAE;IACnE,MAAM,EAAE,KAAK,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IACpD,OAAO,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5B,CAAC,CAAA,CAAC;AAHW,QAAA,UAAU,cAGrB;AAEF,sFAAsF;AAC/E,MAAM,cAAc,GAAG,CAC5B,OAAe,EACf,OAA8E,EAChE,EAAE;IAChB,MAAM,EAAE,QAAQ,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IACvD,OAAO,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC,CAAA,CAAC;AANW,QAAA,cAAc,kBAMzB","sourcesContent":["// Present a single-choice list prompt and return the selected value.\n// @inquirer/prompts is imported lazily so commands only pay for it when\n// actually prompting.\nexport const promptSelect = async (message: string, choices: string[], defaultChoice?: string): Promise<string> => {\n  const { select } = await import('@inquirer/prompts');\n  return select({ message, choices, default: defaultChoice });\n};\n\n// A single-choice list prompt over labelled values; a choice's optional\n// `short` replaces its name in the answer line once picked, and its optional\n// `description` renders under the list while it is highlighted.\nexport const promptSelectDetailed = async <T>(\n  message: string,\n  choices: { name: string; value: T; short?: string; description?: string }[],\n): Promise<T> => {\n  const { select } = await import('@inquirer/prompts');\n  return select({ message, choices });\n};\n\n// A yes/no list prompt, returning true for \"Yes\".\nexport const promptYesNo = async (message: string): Promise<boolean> => (await promptSelect(message, ['No', 'Yes'])) === 'Yes';\n\n// A free-text prompt — used where a y/n is too easy to fat-finger (destructive\n// confirmations that require typing the target name back).\nexport const promptText = async (message: string): Promise<string> => {\n  const { input } = await import('@inquirer/prompts');\n  return input({ message });\n};\n\n// A multi-select checkbox prompt over labelled values; `checked` preselects a choice.\nexport const promptCheckbox = async <T>(\n  message: string,\n  choices: { name: string; value: T; checked?: boolean; description?: string }[],\n): Promise<T[]> => {\n  const { checkbox } = await import('@inquirer/prompts');\n  return checkbox({ message, choices });\n};\n"]}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/lib/prompts.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+BAAqC;AAErC,MAAM,GAAG,GAAG,IAAA,kBAAY,EAAC,SAAS,CAAC,CAAC;AACpC,qEAAqE;AACrE,wEAAwE;AACxE,sBAAsB;AACf,MAAM,YAAY,GAAG,CAAO,OAAe,EAAE,OAAiB,EAAE,aAAsB,EAAmB,EAAE;IAChH,MAAM,EAAE,MAAM,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IACrD,OAAO,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAA,CAAC;AAHW,QAAA,YAAY,gBAGvB;AAEF,wEAAwE;AACxE,6EAA6E;AAC7E,gEAAgE;AACzD,MAAM,oBAAoB,GAAG,CAClC,OAAe,EACf,OAA2E,EAC/D,EAAE;IACd,MAAM,EAAE,MAAM,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IACrD,OAAO,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACtC,CAAC,CAAA,CAAC;AANW,QAAA,oBAAoB,wBAM/B;AAEF,kDAAkD;AAC3C,MAAM,WAAW,GAAG,CAAO,OAAe,EAAoB,EAAE,kDAAC,OAAA,CAAC,MAAM,IAAA,oBAAY,EAAC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAA,GAAA,CAAC;AAAlH,QAAA,WAAW,eAAuG;AAE/H,8EAA8E;AAC9E,2DAA2D;AACpD,MAAM,UAAU,GAAG,CAAO,OAAe,EAAmB,EAAE;IACnE,MAAM,EAAE,KAAK,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IACpD,OAAO,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5B,CAAC,CAAA,CAAC;AAHW,QAAA,UAAU,cAGrB;AAEF,2FAA2F;AAC3F,qFAAqF;AAC9E,MAAM,uBAAuB,GAAG,CAAO,MAAc,EAAoB,EAAE;IAChF,MAAM,YAAY,GAAG,MAAM,IAAA,kBAAU,EAAC,SAAS,MAAM,cAAc,CAAC,CAAC;IAErE,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;QAC5B,GAAG,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAA,CAAC;AATW,QAAA,uBAAuB,2BASlC;AAEF,sFAAsF;AAC/E,MAAM,cAAc,GAAG,CAC5B,OAAe,EACf,OAA8E,EAChE,EAAE;IAChB,MAAM,EAAE,QAAQ,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IACvD,OAAO,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC,CAAA,CAAC;AANW,QAAA,cAAc,kBAMzB","sourcesContent":["import { createOutput } from './out';\n\nconst out = createOutput('prompts');\n// Present a single-choice list prompt and return the selected value.\n// @inquirer/prompts is imported lazily so commands only pay for it when\n// actually prompting.\nexport const promptSelect = async (message: string, choices: string[], defaultChoice?: string): Promise<string> => {\n  const { select } = await import('@inquirer/prompts');\n  return select({ message, choices, default: defaultChoice });\n};\n\n// A single-choice list prompt over labelled values; a choice's optional\n// `short` replaces its name in the answer line once picked, and its optional\n// `description` renders under the list while it is highlighted.\nexport const promptSelectDetailed = async <T>(\n  message: string,\n  choices: { name: string; value: T; short?: string; description?: string }[],\n): Promise<T> => {\n  const { select } = await import('@inquirer/prompts');\n  return select({ message, choices });\n};\n\n// A yes/no list prompt, returning true for \"Yes\".\nexport const promptYesNo = async (message: string): Promise<boolean> => (await promptSelect(message, ['No', 'Yes'])) === 'Yes';\n\n// A free-text prompt, used where a y/n is too easy to fat-finger (destructive\n// confirmations that require typing the target name back).\nexport const promptText = async (message: string): Promise<string> => {\n  const { input } = await import('@inquirer/prompts');\n  return input({ message });\n};\n\n// The friction for destructive commands: the target has to be typed back exactly. Resolves\n// true when it was; prints why it stops otherwise, so callers only have to bail out.\nexport const promptTypedConfirmation = async (target: string): Promise<boolean> => {\n  const confirmation = await promptText(`Type '${target}' to confirm`);\n\n  if (confirmation !== target) {\n    out.log('Confirmation did not match. Exiting!');\n    return false;\n  }\n\n  return true;\n};\n\n// A multi-select checkbox prompt over labelled values; `checked` preselects a choice.\nexport const promptCheckbox = async <T>(\n  message: string,\n  choices: { name: string; value: T; checked?: boolean; description?: string }[],\n): Promise<T[]> => {\n  const { checkbox } = await import('@inquirer/prompts');\n  return checkbox({ message, choices });\n};\n"]}

package/lib/commonjs/lib/qpqConfigs.js

@@ -10,16 +10,16 @@ const discovery_1 = require("./discovery");
 const loadServiceQpqConfig = (appName, service) => (0, deploy_aws_1.getWorkspaceServiceQpqConfig)((0, discovery_1.getRoot)(), appName, service);
 exports.loadServiceQpqConfig = loadServiceQpqConfig;
 const getAppPrefix = (appName) => {
-    const services = (0, discovery_1.getServiceNames)(appName);
-    if (services.length === 0)
+    const [firstService] = (0, discovery_1.getServiceNames)(appName);
+    if (firstService === undefined)
         throw new Error(`No services found for app ${appName}`);
-    return core_1.qpqCoreUtils.getApplicationName((0, exports.loadServiceQpqConfig)(appName, services[0]));
+    return core_1.qpqCoreUtils.getApplicationName((0, exports.loadServiceQpqConfig)(appName, firstService));
 };
 exports.getAppPrefix = getAppPrefix;
 // The subset of the given services that opt into module-federation publishing,
 // i.e. declare defineFederatedModuleStore(...). Federation is a config setting,
 // not a directory convention (unlike views/ backends), so detecting it means
-// loading each service's config — which is why this lives here and not in the
+// loading each service's config, which is why this lives here and not in the
 // directory-only discovery module. Used by the deploy drivers to decide which
 // backends to publish federated remotes for after a deploy.
 const getServiceNamesWithFederation = (appName, serviceNames) => serviceNames.filter((service) => !!core_1.qpqCoreUtils.getFederatedModuleStore((0, exports.loadServiceQpqConfig)(appName, service)));

package/lib/commonjs/lib/qpqConfigs.js.map

@@ -1 +1 @@
-{"version":3,"file":"qpqConfigs.js","sourceRoot":"","sources":["../../../src/lib/qpqConfigs.ts"],"names":[],"mappings":";;;AAAA,sCAA2D;AAC3D,kDAAiE;AAEjE,2CAAuD;AAEvD,wEAAwE;AACxE,2EAA2E;AAC3E,uBAAuB;AAChB,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAE,OAAe,EAAa,EAAE,CAAC,IAAA,yCAA4B,EAAC,IAAA,mBAAO,GAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAAlI,QAAA,oBAAoB,wBAA8G;AAExI,MAAM,YAAY,GAAG,CAAC,OAAe,EAAU,EAAE;IACtD,MAAM,QAAQ,GAAG,IAAA,2BAAe,EAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IACnF,OAAO,mBAAY,CAAC,kBAAkB,CAAC,IAAA,4BAAoB,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrF,CAAC,CAAC;AAJW,QAAA,YAAY,gBAIvB;AAEF,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,4DAA4D;AACrD,MAAM,6BAA6B,GAAG,CAAC,OAAe,EAAE,YAAsB,EAAY,EAAE,CACjG,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAY,CAAC,uBAAuB,CAAC,IAAA,4BAAoB,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AADtG,QAAA,6BAA6B,iCACyE","sourcesContent":["import { type QPQConfig, qpqCoreUtils } from '@qpqjs/core';\nimport { getWorkspaceServiceQpqConfig } from '@qpqjs/deploy-aws';\n\nimport { getRoot, getServiceNames } from './discovery';\n\n// Loads a service's live infrastructure.ts (qpq runs with ts-node hooks\n// registered, so requiring TS works and `@scope/*` imports resolve through\n// workspace symlinks).\nexport const loadServiceQpqConfig = (appName: string, service: string): QPQConfig => getWorkspaceServiceQpqConfig(getRoot(), appName, service);\n\nexport const getAppPrefix = (appName: string): string => {\n  const services = getServiceNames(appName);\n  if (services.length === 0) throw new Error(`No services found for app ${appName}`);\n  return qpqCoreUtils.getApplicationName(loadServiceQpqConfig(appName, services[0]));\n};\n\n// The subset of the given services that opt into module-federation publishing,\n// i.e. declare defineFederatedModuleStore(...). Federation is a config setting,\n// not a directory convention (unlike views/ backends), so detecting it means\n// loading each service's config — which is why this lives here and not in the\n// directory-only discovery module. Used by the deploy drivers to decide which\n// backends to publish federated remotes for after a deploy.\nexport const getServiceNamesWithFederation = (appName: string, serviceNames: string[]): string[] =>\n  serviceNames.filter((service) => !!qpqCoreUtils.getFederatedModuleStore(loadServiceQpqConfig(appName, service)));\n"]}
+{"version":3,"file":"qpqConfigs.js","sourceRoot":"","sources":["../../../src/lib/qpqConfigs.ts"],"names":[],"mappings":";;;AAAA,sCAA2D;AAC3D,kDAAiE;AAEjE,2CAAuD;AAEvD,wEAAwE;AACxE,2EAA2E;AAC3E,uBAAuB;AAChB,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAE,OAAe,EAAa,EAAE,CAAC,IAAA,yCAA4B,EAAC,IAAA,mBAAO,GAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAAlI,QAAA,oBAAoB,wBAA8G;AAExI,MAAM,YAAY,GAAG,CAAC,OAAe,EAAU,EAAE;IACtD,MAAM,CAAC,YAAY,CAAC,GAAG,IAAA,2BAAe,EAAC,OAAO,CAAC,CAAC;IAChD,IAAI,YAAY,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IACxF,OAAO,mBAAY,CAAC,kBAAkB,CAAC,IAAA,4BAAoB,EAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AACtF,CAAC,CAAC;AAJW,QAAA,YAAY,gBAIvB;AAEF,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,4DAA4D;AACrD,MAAM,6BAA6B,GAAG,CAAC,OAAe,EAAE,YAAsB,EAAY,EAAE,CACjG,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAY,CAAC,uBAAuB,CAAC,IAAA,4BAAoB,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AADtG,QAAA,6BAA6B,iCACyE","sourcesContent":["import { type QPQConfig, qpqCoreUtils } from '@qpqjs/core';\nimport { getWorkspaceServiceQpqConfig } from '@qpqjs/deploy-aws';\n\nimport { getRoot, getServiceNames } from './discovery';\n\n// Loads a service's live infrastructure.ts (qpq runs with ts-node hooks\n// registered, so requiring TS works and `@scope/*` imports resolve through\n// workspace symlinks).\nexport const loadServiceQpqConfig = (appName: string, service: string): QPQConfig => getWorkspaceServiceQpqConfig(getRoot(), appName, service);\n\nexport const getAppPrefix = (appName: string): string => {\n  const [firstService] = getServiceNames(appName);\n  if (firstService === undefined) throw new Error(`No services found for app ${appName}`);\n  return qpqCoreUtils.getApplicationName(loadServiceQpqConfig(appName, firstService));\n};\n\n// The subset of the given services that opt into module-federation publishing,\n// i.e. declare defineFederatedModuleStore(...). Federation is a config setting,\n// not a directory convention (unlike views/ backends), so detecting it means\n// loading each service's config, which is why this lives here and not in the\n// directory-only discovery module. Used by the deploy drivers to decide which\n// backends to publish federated remotes for after a deploy.\nexport const getServiceNamesWithFederation = (appName: string, serviceNames: string[]): string[] =>\n  serviceNames.filter((service) => !!qpqCoreUtils.getFederatedModuleStore(loadServiceQpqConfig(appName, service)));\n"]}

package/lib/commonjs/lib/requireDriverCapability.d.ts

@@ -0,0 +1,7 @@
+import { QpqPlatformDriver } from '../platforms';
+import { CommandContext } from './resolveCommandContext';
+type OptionalCapability = {
+    [K in keyof QpqPlatformDriver]-?: undefined extends QpqPlatformDriver[K] ? K : never;
+}[keyof QpqPlatformDriver];
+export declare const requireDriverCapability: <K extends OptionalCapability>(context: CommandContext, capability: K, hint?: string) => NonNullable<QpqPlatformDriver[K]>;
+export {};

package/lib/commonjs/lib/requireDriverCapability.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireDriverCapability = void 0;
+const CliError_1 = require("./CliError");
+const out_1 = require("./out");
+const out = (0, out_1.createOutput)('require-driver-capability');
+// Hands back a driver's optional capability, or stops the command with a message naming the
+// platform that lacks it. The capability name doubles as the strategy name in that message.
+const requireDriverCapability = (context, capability, hint = '') => {
+    const implementation = context.driver[capability];
+    if (!implementation) {
+        throw new CliError_1.CliError(`The '${context.deployment.platform}' platform has no ${capability} strategy.${hint ? ` ${hint}` : ''}`);
+    }
+    return implementation;
+};
+exports.requireDriverCapability = requireDriverCapability;
+//# sourceMappingURL=requireDriverCapability.js.map

package/lib/commonjs/lib/requireDriverCapability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requireDriverCapability.js","sourceRoot":"","sources":["../../../src/lib/requireDriverCapability.ts"],"names":[],"mappings":";;;AAEA,yCAAsC;AACtC,+BAAqC;AAErC,MAAM,GAAG,GAAG,IAAA,kBAAY,EAAC,2BAA2B,CAAC,CAAC;AAMtD,4FAA4F;AAC5F,4FAA4F;AACrF,MAAM,uBAAuB,GAAG,CACrC,OAAuB,EACvB,UAAa,EACb,OAAe,EAAE,EACkB,EAAE;IACrC,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAElD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,mBAAQ,CAAC,QAAQ,OAAO,CAAC,UAAU,CAAC,QAAQ,qBAAqB,UAAU,aAAa,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9H,CAAC;IAED,OAAO,cAAmD,CAAC;AAC7D,CAAC,CAAC;AAZW,QAAA,uBAAuB,2BAYlC","sourcesContent":["import { QpqPlatformDriver } from '../platforms';\nimport { CommandContext } from './resolveCommandContext';\nimport { CliError } from './CliError';\nimport { createOutput } from './out';\n\nconst out = createOutput('require-driver-capability');\n\ntype OptionalCapability = {\n  [K in keyof QpqPlatformDriver]-?: undefined extends QpqPlatformDriver[K] ? K : never;\n}[keyof QpqPlatformDriver];\n\n// Hands back a driver's optional capability, or stops the command with a message naming the\n// platform that lacks it. The capability name doubles as the strategy name in that message.\nexport const requireDriverCapability = <K extends OptionalCapability>(\n  context: CommandContext,\n  capability: K,\n  hint: string = '',\n): NonNullable<QpqPlatformDriver[K]> => {\n  const implementation = context.driver[capability];\n\n  if (!implementation) {\n    throw new CliError(`The '${context.deployment.platform}' platform has no ${capability} strategy.${hint ? ` ${hint}` : ''}`);\n  }\n\n  return implementation as NonNullable<QpqPlatformDriver[K]>;\n};\n"]}

package/lib/commonjs/lib/resolveAppSelection.d.ts

@@ -3,4 +3,5 @@ export type ResolveAppOptions = {
     envVar?: string;
     allowAll?: boolean;
 };
+export declare const getRequestedAppName: (argv: string[], envVar?: string) => string | undefined;
 export declare const resolveAppSelection: (options: ResolveAppOptions) => Promise<string>;

package/lib/commonjs/lib/resolveAppSelection.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveAppSelection = void 0;
+exports.resolveAppSelection = exports.getRequestedAppName = void 0;
 // One app-selection contract for every app-facing command (prep / synth / go /
 // go:dev / go:dev:api / go:dev:web / publish). Resolution order:
 //   1. --app <name> / --app=<name> on argv
@@ -24,20 +24,26 @@ exports.resolveAppSelection = void 0;
 const args_1 = require("./args");
 const discovery_1 = require("./discovery");
 const prompts_1 = require("./prompts");
+const CliError_1 = require("./CliError");
+const out_1 = require("./out");
+const out = (0, out_1.createOutput)('resolve-app-selection');
 const exitWithAppList = (requested, availableApps) => {
-    if (requested)
-        console.error(`Unknown app '${requested}'.`);
-    console.error(`Valid apps: ${availableApps.join(', ')}`);
-    console.error(`Pass one with --app <name> (e.g. qpq <command> --app ${availableApps[0]}).`);
-    process.exit(1);
+    throw new CliError_1.CliError([
+        ...(requested ? [`Unknown app '${requested}'.`] : []),
+        `Valid apps: ${availableApps.join(', ')}`,
+        `Pass one with --app <name> (e.g. qpq <command> --app ${availableApps[0]}).`,
+    ].join('\n'));
 };
+// The app a caller named, from the sources above the auto-select and the prompt (--app, the npm
+// config flag, the command's env var); undefined when none did.
+const getRequestedAppName = (argv, envVar) => (0, args_1.getArgValue)(argv, '--app') || process.env.npm_config_app || (envVar ? process.env[envVar] : undefined);
+exports.getRequestedAppName = getRequestedAppName;
 const resolveAppSelection = (options) => __awaiter(void 0, void 0, void 0, function* () {
     const availableApps = (0, discovery_1.getAvailableApps)();
     if (availableApps.length === 0) {
-        console.error('No apps found under apps/.');
-        process.exit(1);
+        throw new CliError_1.CliError('No apps found under apps/.');
     }
-    const requested = (0, args_1.getArgValue)(options.argv, '--app') || process.env.npm_config_app || (options.envVar ? process.env[options.envVar] : undefined);
+    const requested = (0, exports.getRequestedAppName)(options.argv, options.envVar);
     if (requested) {
         if (options.allowAll && requested === 'all')
             return 'all';
@@ -45,9 +51,10 @@ const resolveAppSelection = (options) => __awaiter(void 0, void 0, void 0, funct
             exitWithAppList(requested, availableApps);
         return requested;
     }
-    if (availableApps.length === 1) {
-        console.log(`Using app: ${availableApps[0]}`);
-        return availableApps[0];
+    const [onlyApp] = availableApps;
+    if (availableApps.length === 1 && onlyApp !== undefined) {
+        out.log(`Using app: ${onlyApp}`);
+        return onlyApp;
     }
     if (process.stdin.isTTY) {
         return (0, prompts_1.promptSelect)('Select app', options.allowAll ? [...availableApps, 'all'] : availableApps);

package/lib/commonjs/lib/resolveAppSelection.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveAppSelection.js","sourceRoot":"","sources":["../../../src/lib/resolveAppSelection.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+EAA+E;AAC/E,iEAAiE;AACjE,2CAA2C;AAC3C,+EAA+E;AAC/E,kFAAkF;AAClF,kDAAkD;AAClD,qCAAqC;AACrC,6DAA6D;AAC7D,6EAA6E;AAC7E,+EAA+E;AAC/E,+CAA+C;AAC/C,iCAAqC;AACrC,2CAA+C;AAC/C,uCAAyC;AAUzC,MAAM,eAAe,GAAG,CAAC,SAA6B,EAAE,aAAuB,EAAS,EAAE;IACxF,IAAI,SAAS;QAAE,OAAO,CAAC,KAAK,CAAC,gBAAgB,SAAS,IAAI,CAAC,CAAC;IAC5D,OAAO,CAAC,KAAK,CAAC,eAAe,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,KAAK,CAAC,wDAAwD,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEK,MAAM,mBAAmB,GAAG,CAAO,OAA0B,EAAmB,EAAE;IACvF,MAAM,aAAa,GAAG,IAAA,4BAAgB,GAAE,CAAC;IACzC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GACb,IAAA,kBAAW,EAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEjI,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,OAAO,CAAC,QAAQ,IAAI,SAAS,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QAC1D,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAClF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,cAAc,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9C,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,IAAA,sBAAY,EAAC,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAClG,CAAC;IAED,OAAO,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACnD,CAAC,CAAA,CAAC;AA1BW,QAAA,mBAAmB,uBA0B9B","sourcesContent":["// One app-selection contract for every app-facing command (prep / synth / go /\n// go:dev / go:dev:api / go:dev:web / publish). Resolution order:\n//   1. --app <name> / --app=<name> on argv\n//   2. npm_config_app                             (npm run x --app foo, no --)\n//   3. an env var the command already honours     (QPQ_DEV_APP / DEPLOY_APP_NAME)\n//   4. exactly one app under apps/ -> auto-select\n//   5. interactive prompt (TTY only)\n//   6. otherwise: print the valid app list and exit non-zero\n// An unknown name (from any source) also prints the list and exits non-zero.\n// Commands that can meaningfully run for every app may pass allowAll to accept\n// `--app all` (returned as the literal 'all').\nimport { getArgValue } from './args';\nimport { getAvailableApps } from './discovery';\nimport { promptSelect } from './prompts';\n\nexport type ResolveAppOptions = {\n  argv: string[];\n  // Env var this command historically honours (e.g. QPQ_DEV_APP, DEPLOY_APP_NAME).\n  envVar?: string;\n  // Accept `--app all` and return 'all'.\n  allowAll?: boolean;\n};\n\nconst exitWithAppList = (requested: string | undefined, availableApps: string[]): never => {\n  if (requested) console.error(`Unknown app '${requested}'.`);\n  console.error(`Valid apps: ${availableApps.join(', ')}`);\n  console.error(`Pass one with --app <name> (e.g. qpq <command> --app ${availableApps[0]}).`);\n  process.exit(1);\n};\n\nexport const resolveAppSelection = async (options: ResolveAppOptions): Promise<string> => {\n  const availableApps = getAvailableApps();\n  if (availableApps.length === 0) {\n    console.error('No apps found under apps/.');\n    process.exit(1);\n  }\n\n  const requested =\n    getArgValue(options.argv, '--app') || process.env.npm_config_app || (options.envVar ? process.env[options.envVar] : undefined);\n\n  if (requested) {\n    if (options.allowAll && requested === 'all') return 'all';\n    if (!availableApps.includes(requested)) exitWithAppList(requested, availableApps);\n    return requested;\n  }\n\n  if (availableApps.length === 1) {\n    console.log(`Using app: ${availableApps[0]}`);\n    return availableApps[0];\n  }\n\n  if (process.stdin.isTTY) {\n    return promptSelect('Select app', options.allowAll ? [...availableApps, 'all'] : availableApps);\n  }\n\n  return exitWithAppList(undefined, availableApps);\n};\n"]}
+{"version":3,"file":"resolveAppSelection.js","sourceRoot":"","sources":["../../../src/lib/resolveAppSelection.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+EAA+E;AAC/E,iEAAiE;AACjE,2CAA2C;AAC3C,+EAA+E;AAC/E,kFAAkF;AAClF,kDAAkD;AAClD,qCAAqC;AACrC,6DAA6D;AAC7D,6EAA6E;AAC7E,+EAA+E;AAC/E,+CAA+C;AAC/C,iCAAqC;AACrC,2CAA+C;AAC/C,uCAAyC;AACzC,yCAAsC;AACtC,+BAAqC;AAErC,MAAM,GAAG,GAAG,IAAA,kBAAY,EAAC,uBAAuB,CAAC,CAAC;AAUlD,MAAM,eAAe,GAAG,CAAC,SAA6B,EAAE,aAAuB,EAAS,EAAE;IACxF,MAAM,IAAI,mBAAQ,CAChB;QACE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,gBAAgB,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,eAAe,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACzC,wDAAwD,aAAa,CAAC,CAAC,CAAC,IAAI;KAC7E,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC,CAAC;AAEF,gGAAgG;AAChG,gEAAgE;AACzD,MAAM,mBAAmB,GAAG,CAAC,IAAc,EAAE,MAAe,EAAsB,EAAE,CACzF,IAAA,kBAAW,EAAC,IAAI,EAAE,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAD5F,QAAA,mBAAmB,uBACyE;AAElG,MAAM,mBAAmB,GAAG,CAAO,OAA0B,EAAmB,EAAE;IACvF,MAAM,aAAa,GAAG,IAAA,4BAAgB,GAAE,CAAC;IACzC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,mBAAQ,CAAC,4BAA4B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,SAAS,GAAG,IAAA,2BAAmB,EAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpE,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,OAAO,CAAC,QAAQ,IAAI,SAAS,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QAC1D,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAClF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC;IAChC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxD,GAAG,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,IAAA,sBAAY,EAAC,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAClG,CAAC;IAED,OAAO,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACnD,CAAC,CAAA,CAAC;AAzBW,QAAA,mBAAmB,uBAyB9B","sourcesContent":["// One app-selection contract for every app-facing command (prep / synth / go /\n// go:dev / go:dev:api / go:dev:web / publish). Resolution order:\n//   1. --app <name> / --app=<name> on argv\n//   2. npm_config_app                             (npm run x --app foo, no --)\n//   3. an env var the command already honours     (QPQ_DEV_APP / DEPLOY_APP_NAME)\n//   4. exactly one app under apps/ -> auto-select\n//   5. interactive prompt (TTY only)\n//   6. otherwise: print the valid app list and exit non-zero\n// An unknown name (from any source) also prints the list and exits non-zero.\n// Commands that can meaningfully run for every app may pass allowAll to accept\n// `--app all` (returned as the literal 'all').\nimport { getArgValue } from './args';\nimport { getAvailableApps } from './discovery';\nimport { promptSelect } from './prompts';\nimport { CliError } from './CliError';\nimport { createOutput } from './out';\n\nconst out = createOutput('resolve-app-selection');\n\nexport type ResolveAppOptions = {\n  argv: string[];\n  // Env var this command historically honours (e.g. QPQ_DEV_APP, DEPLOY_APP_NAME).\n  envVar?: string;\n  // Accept `--app all` and return 'all'.\n  allowAll?: boolean;\n};\n\nconst exitWithAppList = (requested: string | undefined, availableApps: string[]): never => {\n  throw new CliError(\n    [\n      ...(requested ? [`Unknown app '${requested}'.`] : []),\n      `Valid apps: ${availableApps.join(', ')}`,\n      `Pass one with --app <name> (e.g. qpq <command> --app ${availableApps[0]}).`,\n    ].join('\\n'),\n  );\n};\n\n// The app a caller named, from the sources above the auto-select and the prompt (--app, the npm\n// config flag, the command's env var); undefined when none did.\nexport const getRequestedAppName = (argv: string[], envVar?: string): string | undefined =>\n  getArgValue(argv, '--app') || process.env.npm_config_app || (envVar ? process.env[envVar] : undefined);\n\nexport const resolveAppSelection = async (options: ResolveAppOptions): Promise<string> => {\n  const availableApps = getAvailableApps();\n  if (availableApps.length === 0) {\n    throw new CliError('No apps found under apps/.');\n  }\n\n  const requested = getRequestedAppName(options.argv, options.envVar);\n\n  if (requested) {\n    if (options.allowAll && requested === 'all') return 'all';\n    if (!availableApps.includes(requested)) exitWithAppList(requested, availableApps);\n    return requested;\n  }\n\n  const [onlyApp] = availableApps;\n  if (availableApps.length === 1 && onlyApp !== undefined) {\n    out.log(`Using app: ${onlyApp}`);\n    return onlyApp;\n  }\n\n  if (process.stdin.isTTY) {\n    return promptSelect('Select app', options.allowAll ? [...availableApps, 'all'] : availableApps);\n  }\n\n  return exitWithAppList(undefined, availableApps);\n};\n"]}

package/lib/commonjs/lib/resolveCommandContext.d.ts

@@ -0,0 +1,12 @@
+import { QpqAppDeployment } from '@qpqjs/core';
+import { QpqPlatformDriver } from '../platforms';
+export type CommandContext = {
+    appName: string;
+    deploymentName: string;
+    deployment: QpqAppDeployment;
+    driver: QpqPlatformDriver;
+};
+export type ResolveCommandContextOptions = {
+    appEnvVar?: string;
+};
+export declare const resolveCommandContext: (argv: string[], options?: ResolveCommandContextOptions) => Promise<CommandContext>;

package/lib/commonjs/lib/resolveCommandContext.js

@@ -0,0 +1,26 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCommandContext = void 0;
+const core_1 = require("@qpqjs/core");
+const platforms_1 = require("../platforms");
+const resolveAppSelection_1 = require("./resolveAppSelection");
+const resolveDeployment_1 = require("./resolveDeployment");
+// The one preamble for every deploy-facing command: which app, which entry of its
+// deploy.config.json (primed into the environment), and the platform driver that entry names.
+const resolveCommandContext = (argv_1, ...args_1) => __awaiter(void 0, [argv_1, ...args_1], void 0, function* (argv, options = {}) {
+    var _a;
+    const appName = yield (0, resolveAppSelection_1.resolveAppSelection)({ argv, envVar: (_a = options.appEnvVar) !== null && _a !== void 0 ? _a : core_1.QpqDeployEnvVar.deployAppName });
+    const { deploymentName, deployment } = yield (0, resolveDeployment_1.resolveDeployment)(argv, appName);
+    return { appName, deploymentName, deployment, driver: (0, platforms_1.getPlatformDriver)(deployment.platform) };
+});
+exports.resolveCommandContext = resolveCommandContext;
+//# sourceMappingURL=resolveCommandContext.js.map

package/lib/commonjs/lib/resolveCommandContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveCommandContext.js","sourceRoot":"","sources":["../../../src/lib/resolveCommandContext.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,sCAAgE;AAEhE,4CAAoE;AACpE,+DAA4D;AAC5D,2DAAwD;AAcxD,kFAAkF;AAClF,8FAA8F;AACvF,MAAM,qBAAqB,GAAG,oBAA4F,EAAE,2DAAvF,IAAc,EAAE,UAAwC,EAAE;;IACpG,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAmB,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAA,OAAO,CAAC,SAAS,mCAAI,sBAAe,CAAC,aAAa,EAAE,CAAC,CAAC;IAChH,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,qCAAiB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE9E,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,IAAA,6BAAiB,EAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;AACjG,CAAC,CAAA,CAAC;AALW,QAAA,qBAAqB,yBAKhC","sourcesContent":["import { QpqAppDeployment, QpqDeployEnvVar } from '@qpqjs/core';\n\nimport { getPlatformDriver, QpqPlatformDriver } from '../platforms';\nimport { resolveAppSelection } from './resolveAppSelection';\nimport { resolveDeployment } from './resolveDeployment';\n\nexport type CommandContext = {\n  appName: string;\n  deploymentName: string;\n  deployment: QpqAppDeployment;\n  driver: QpqPlatformDriver;\n};\n\nexport type ResolveCommandContextOptions = {\n  // The env var the command honours for the app name when no --app is given.\n  appEnvVar?: string;\n};\n\n// The one preamble for every deploy-facing command: which app, which entry of its\n// deploy.config.json (primed into the environment), and the platform driver that entry names.\nexport const resolveCommandContext = async (argv: string[], options: ResolveCommandContextOptions = {}): Promise<CommandContext> => {\n  const appName = await resolveAppSelection({ argv, envVar: options.appEnvVar ?? QpqDeployEnvVar.deployAppName });\n  const { deploymentName, deployment } = await resolveDeployment(argv, appName);\n\n  return { appName, deploymentName, deployment, driver: getPlatformDriver(deployment.platform) };\n};\n"]}

package/lib/commonjs/lib/resolveDeployment.d.ts

@@ -1,5 +1,4 @@
 import { QpqAppDeployment } from '@qpqjs/core';
-export declare const DEPLOYMENT_FLAG = "--deployment";
 export type ResolvedDeployment = {
     deploymentName: string;
     deployment: QpqAppDeployment;