@qpqjs/cli 0.0.0-stage → 0.2.0

package/lib/esm/lib/killChildWithEscalation.js

@@ -0,0 +1,29 @@
+// Above the dev server's 5s worst-case shutdown budget, below docker's 10s
+// default stop grace, so a container stop still exits cleanly rather than
+// being SIGKILLed by docker mid-escalation.
+const DEFAULT_KILL_GRACE_MS = 6000;
+/**
+ * SIGTERM the child, resolve once it has actually exited, and SIGKILL it if it
+ * has not gone within the grace window.
+ *
+ * Resolves rather than rejects on escalation: the caller's next move is the
+ * same either way (start the replacement), and a rejection would only give
+ * every call site a catch to write.
+ */
+export const killChildWithEscalation = (child, graceMs = DEFAULT_KILL_GRACE_MS) => {
+    if (child.exitCode !== null || child.signalCode !== null) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            console.warn(`Dev server did not exit within ${graceMs}ms — sending SIGKILL.`);
+            child.kill('SIGKILL');
+        }, graceMs);
+        child.once('exit', () => {
+            clearTimeout(timer);
+            resolve();
+        });
+        child.kill('SIGTERM');
+    });
+};
+//# sourceMappingURL=killChildWithEscalation.js.map

package/lib/esm/lib/killChildWithEscalation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"killChildWithEscalation.js","sourceRoot":"","sources":["../../../src/lib/killChildWithEscalation.ts"],"names":[],"mappings":"AAWA,2EAA2E;AAC3E,0EAA0E;AAC1E,4CAA4C;AAC5C,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAmB,EAAE,OAAO,GAAG,qBAAqB,EAAiB,EAAE;IAC7G,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QACzD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,OAAO,CAAC,IAAI,CAAC,kCAAkC,OAAO,uBAAuB,CAAC,CAAC;YAC/E,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC,EAAE,OAAO,CAAC,CAAC;QAEZ,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACtB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["// Stopping the dev server child, with a hard backstop.\n//\n// The dev server now runs an ordered shutdown on SIGTERM (drain in-flight\n// work, then checkpoint the stores) instead of dying instantly. That is the\n// point - it is what stops a save-triggered restart eating a queue message\n// mid-story - but it means a bare `child.kill()` followed by waiting for exit\n// can now wait forever if a teardown wedges. Without escalation this would\n// trade a data-loss bug for a hung-restart bug, and the next launch would find\n// its ports still held.\nimport { ChildProcess } from 'child_process';\n\n// Above the dev server's 5s worst-case shutdown budget, below docker's 10s\n// default stop grace, so a container stop still exits cleanly rather than\n// being SIGKILLed by docker mid-escalation.\nconst DEFAULT_KILL_GRACE_MS = 6000;\n\n/**\n * SIGTERM the child, resolve once it has actually exited, and SIGKILL it if it\n * has not gone within the grace window.\n *\n * Resolves rather than rejects on escalation: the caller's next move is the\n * same either way (start the replacement), and a rejection would only give\n * every call site a catch to write.\n */\nexport const killChildWithEscalation = (child: ChildProcess, graceMs = DEFAULT_KILL_GRACE_MS): Promise<void> => {\n  if (child.exitCode !== null || child.signalCode !== null) {\n    return Promise.resolve();\n  }\n\n  return new Promise<void>((resolve) => {\n    const timer = setTimeout(() => {\n      console.warn(`Dev server did not exit within ${graceMs}ms — sending SIGKILL.`);\n      child.kill('SIGKILL');\n    }, graceMs);\n\n    child.once('exit', () => {\n      clearTimeout(timer);\n      resolve();\n    });\n\n    child.kill('SIGTERM');\n  });\n};\n"]}

package/lib/esm/lib/killStaleListeners.d.ts

@@ -0,0 +1,17 @@
+export declare const isQpqCliCommand: (command: string) => boolean;
+export declare const killOtherQpqDevProcesses: (root: string) => void;
+/**
+ * Say what is holding these ports, without touching it.
+ *
+ * The other half of --keep-other-dev-servers: sparing a sibling checkout's dev
+ * server means this one cannot bind, and an unexplained EADDRINUSE is a worse
+ * experience than the silent kill it replaces. Naming the pid and the command
+ * turns "it just died" into something you can act on.
+ *
+ * Worded as a prediction, not a fact, because it IS one: this runs before the
+ * bundle step, so by the time anything binds - seconds later - the holder may
+ * well have gone. Stating "port in use" and then starting cleanly reads like
+ * the warning was wrong.
+ */
+export declare const reportPortHolders: (ports: number[]) => void;
+export declare const killStaleListeners: (ports: number[], isOurs: (command: string) => boolean) => void;

package/lib/esm/lib/killStaleListeners.js

@@ -0,0 +1,210 @@
+// 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.
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+// 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
+// global `qpq` shebang script, etc. Checks each whitespace-separated token's
+// basename (extension stripped) rather than a fixed substring like
+// 'bin/qpq.js', which only matches the last of those forms.
+export const isQpqCliCommand = (command) => command
+    .trim()
+    .split(/\s+/)
+    .some((token) => {
+    const base = path.basename(token);
+    const withoutExt = base.endsWith('.js') ? base.slice(0, -3) : base;
+    return withoutExt === 'qpq';
+});
+// 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
+// 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
+// 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
+// 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.
+const waitForPidGone = (pid, timeoutMs = 8000) => {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            process.kill(pid, 0);
+        }
+        catch {
+            return true; // throws once the pid no longer exists
+        }
+        execSync('sleep 0.05');
+    }
+    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.`);
+    try {
+        process.kill(pid, 'SIGKILL');
+    }
+    catch {
+        return; // raced us and exited after all
+    }
+    waitForPidGone(pid, 2000);
+};
+// realpath'd: lsof reports the canonical path (e.g. /private/tmp on macOS,
+// where /tmp is a symlink), so comparing against a caller-supplied root
+// verbatim would false-negative whenever any component of the repo path is
+// itself a symlink (a symlinked home directory, an NFS mount, etc).
+const getProcessCwd = (pid) => {
+    try {
+        const line = execSync(`lsof -a -p ${pid} -d cwd -Fn`, { stdio: ['ignore', 'pipe', 'ignore'] })
+            .toString()
+            .split('\n')
+            .find((l) => l.startsWith('n'));
+        return line ? fs.realpathSync(line.slice(1)) : null;
+    }
+    catch {
+        return null; // pid gone, or we don't have permission to inspect it
+    }
+};
+// The sweep below must never target this process's own wrappers: launched as
+// `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
+// top and exclude the whole chain.
+const getOwnAncestorPids = () => {
+    const ancestors = new Set();
+    let pid = process.pid;
+    while (pid > 1 && !ancestors.has(pid)) {
+        ancestors.add(pid);
+        try {
+            pid = Number(execSync(`ps -o ppid= -p ${pid}`, { stdio: ['ignore', 'pipe', 'ignore'] })
+                .toString()
+                .trim());
+        }
+        catch {
+            break;
+        }
+    }
+    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
+// 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
+// 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
+// bound. SIGINT (not SIGTERM) so goDevApiCommand/goDevWebCommand's own
+// handler runs and tears down its child cleanly rather than orphaning it.
+export const killOtherQpqDevProcesses = (root) => {
+    const resolvedRoot = fs.realpathSync(root);
+    const ownPids = getOwnAncestorPids();
+    let lines = [];
+    try {
+        lines = execSync('ps -axo pid=,command=', { stdio: ['ignore', 'pipe', 'ignore'] })
+            .toString()
+            .split('\n');
+    }
+    catch {
+        return;
+    }
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const spaceIndex = trimmed.indexOf(' ');
+        if (spaceIndex === -1)
+            continue;
+        const pid = Number(trimmed.slice(0, spaceIndex));
+        const command = trimmed.slice(spaceIndex + 1).trim();
+        if (!pid || ownPids.has(pid) || !isQpqCliCommand(command))
+            continue;
+        if (getProcessCwd(pid) !== resolvedRoot)
+            continue;
+        console.log(`Killing other qpq dev process for this repo (pid ${pid}): ${command}`);
+        process.kill(pid, 'SIGINT');
+        if (!waitForPidGone(pid)) {
+            killPidHard(pid);
+        }
+    }
+};
+// Whatever is currently listening on a port, as pid + command line. Empty when
+// the port is free, or when lsof is unavailable.
+const getPortListeners = (port) => {
+    let pids = [];
+    try {
+        pids = execSync(`lsof -t -iTCP:${port} -sTCP:LISTEN`, {
+            stdio: ['ignore', 'pipe', 'ignore'],
+        })
+            .toString()
+            .split('\n')
+            .map((line) => Number(line.trim()))
+            .filter(Boolean);
+    }
+    catch {
+        return []; // lsof exits non-zero when nothing is listening
+    }
+    return pids.flatMap((pid) => {
+        try {
+            return [{ pid, command: execSync(`ps -p ${pid} -o command=`).toString().trim() }];
+        }
+        catch {
+            return []; // already gone
+        }
+    });
+};
+/**
+ * Say what is holding these ports, without touching it.
+ *
+ * The other half of --keep-other-dev-servers: sparing a sibling checkout's dev
+ * server means this one cannot bind, and an unexplained EADDRINUSE is a worse
+ * experience than the silent kill it replaces. Naming the pid and the command
+ * turns "it just died" into something you can act on.
+ *
+ * Worded as a prediction, not a fact, because it IS one: this runs before the
+ * bundle step, so by the time anything binds - seconds later - the holder may
+ * well have gone. Stating "port in use" and then starting cleanly reads like
+ * the warning was wrong.
+ */
+export 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.`);
+        }
+    }
+};
+export 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})`);
+                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.`);
+            }
+        }
+    }
+};
+//# sourceMappingURL=killStaleListeners.js.map

package/lib/esm/lib/killStaleListeners.js.map

@@ -0,0 +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,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,yEAAyE;AACzE,6EAA6E;AAC7E,yEAAyE;AACzE,6EAA6E;AAC7E,mEAAmE;AACnE,4DAA4D;AAC5D,MAAM,CAAC,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,IAAI,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;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,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,CAAC,uCAAuC;QACtD,CAAC;QACD,QAAQ,CAAC,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,MAAM,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,QAAQ,CAAC,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,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAAC,MAAM,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,QAAQ,CAAC,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,MAAM,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;AAC1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAY,EAAQ,EAAE;IAC7D,MAAM,YAAY,GAAG,EAAE,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,QAAQ,CAAC,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,MAAM,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,eAAe,CAAC,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;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,QAAQ,CAAC,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,MAAM,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,QAAQ,CAAC,SAAS,GAAG,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,eAAe;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,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;AAEF,MAAM,CAAC,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","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"]}

package/lib/esm/lib/packageRoot.d.ts

@@ -0,0 +1 @@
+export declare const getOwnPackageRoot: () => string;

package/lib/esm/lib/packageRoot.js

@@ -0,0 +1,14 @@
+import fs from 'fs';
+import path from 'path';
+// This package's root (works from src under ts-node and from lib/commonjs).
+export const getOwnPackageRoot = () => {
+    let dir = __dirname;
+    while (!fs.existsSync(path.join(dir, 'package.json'))) {
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            throw new Error('Could not locate the @qpqjs/cli package root');
+        dir = parent;
+    }
+    return dir;
+};
+//# sourceMappingURL=packageRoot.js.map

package/lib/esm/lib/packageRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageRoot.js","sourceRoot":"","sources":["../../../src/lib/packageRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE;IAC5C,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACpF,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\n// This package's root (works from src under ts-node and from lib/commonjs).\nexport const getOwnPackageRoot = (): string => {\n  let dir = __dirname;\n  while (!fs.existsSync(path.join(dir, 'package.json'))) {\n    const parent = path.dirname(dir);\n    if (parent === dir) throw new Error('Could not locate the @qpqjs/cli package root');\n    dir = parent;\n  }\n  return dir;\n};\n"]}

package/lib/esm/lib/prompts.d.ts

@@ -0,0 +1,15 @@
+export declare const promptSelect: (message: string, choices: string[], defaultChoice?: string) => Promise<string>;
+export declare const promptSelectDetailed: <T>(message: string, choices: {
+    name: string;
+    value: T;
+    short?: string;
+    description?: string;
+}[]) => Promise<T>;
+export declare const promptYesNo: (message: string) => Promise<boolean>;
+export declare const promptText: (message: string) => Promise<string>;
+export declare const promptCheckbox: <T>(message: string, choices: {
+    name: string;
+    value: T;
+    checked?: boolean;
+    description?: string;
+}[]) => Promise<T[]>;

package/lib/esm/lib/prompts.js

@@ -0,0 +1,28 @@
+// 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.
+export const promptSelect = async (message, choices, defaultChoice) => {
+    const { select } = await import('@inquirer/prompts');
+    return select({ message, choices, default: defaultChoice });
+};
+// A single-choice list prompt over labelled values; a choice's optional
+// `short` replaces its name in the answer line once picked, and its optional
+// `description` renders under the list while it is highlighted.
+export const promptSelectDetailed = async (message, choices) => {
+    const { select } = await import('@inquirer/prompts');
+    return select({ message, choices });
+};
+// A yes/no list prompt, returning true for "Yes".
+export const promptYesNo = async (message) => (await promptSelect(message, ['No', 'Yes'])) === 'Yes';
+// A free-text prompt — used where a y/n is too easy to fat-finger (destructive
+// confirmations that require typing the target name back).
+export const promptText = async (message) => {
+    const { input } = await import('@inquirer/prompts');
+    return input({ message });
+};
+// A multi-select checkbox prompt over labelled values; `checked` preselects a choice.
+export const promptCheckbox = async (message, choices) => {
+    const { checkbox } = await import('@inquirer/prompts');
+    return checkbox({ message, choices });
+};
+//# sourceMappingURL=prompts.js.map

package/lib/esm/lib/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/lib/prompts.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,wEAAwE;AACxE,sBAAsB;AACtB,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,OAAe,EAAE,OAAiB,EAAE,aAAsB,EAAmB,EAAE;IAChH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAC;AAEF,wEAAwE;AACxE,6EAA6E;AAC7E,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,OAAe,EACf,OAA2E,EAC/D,EAAE;IACd,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,kDAAkD;AAClD,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,OAAe,EAAoB,EAAE,CAAC,CAAC,MAAM,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC;AAE/H,+EAA+E;AAC/E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,OAAe,EAAmB,EAAE;IACnE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,OAAe,EACf,OAA8E,EAChE,EAAE;IAChB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACvD,OAAO,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC","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"]}

package/lib/esm/lib/qpqConfigs.d.ts

@@ -0,0 +1,4 @@
+import { type QPQConfig } from '@qpqjs/core';
+export declare const loadServiceQpqConfig: (appName: string, service: string) => QPQConfig;
+export declare const getAppPrefix: (appName: string) => string;
+export declare const getServiceNamesWithFederation: (appName: string, serviceNames: string[]) => string[];

package/lib/esm/lib/qpqConfigs.js

@@ -0,0 +1,21 @@
+import { qpqCoreUtils } from '@qpqjs/core';
+import { getWorkspaceServiceQpqConfig } from '@qpqjs/deploy-aws';
+import { getRoot, getServiceNames } from './discovery';
+// Loads a service's live infrastructure.ts (qpq runs with ts-node hooks
+// registered, so requiring TS works and `@scope/*` imports resolve through
+// workspace symlinks).
+export const loadServiceQpqConfig = (appName, service) => getWorkspaceServiceQpqConfig(getRoot(), appName, service);
+export const getAppPrefix = (appName) => {
+    const services = getServiceNames(appName);
+    if (services.length === 0)
+        throw new Error(`No services found for app ${appName}`);
+    return qpqCoreUtils.getApplicationName(loadServiceQpqConfig(appName, services[0]));
+};
+// 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
+// directory-only discovery module. Used by the deploy drivers to decide which
+// backends to publish federated remotes for after a deploy.
+export const getServiceNamesWithFederation = (appName, serviceNames) => serviceNames.filter((service) => !!qpqCoreUtils.getFederatedModuleStore(loadServiceQpqConfig(appName, service)));
+//# sourceMappingURL=qpqConfigs.js.map

package/lib/esm/lib/qpqConfigs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qpqConfigs.js","sourceRoot":"","sources":["../../../src/lib/qpqConfigs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvD,wEAAwE;AACxE,2EAA2E;AAC3E,uBAAuB;AACvB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAE,OAAe,EAAa,EAAE,CAAC,4BAA4B,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAE/I,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAU,EAAE;IACtD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IACnF,OAAO,YAAY,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrF,CAAC,CAAC;AAEF,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,4DAA4D;AAC5D,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,OAAe,EAAE,YAAsB,EAAY,EAAE,CACjG,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC","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"]}

package/lib/esm/lib/resolveAppSelection.d.ts

@@ -0,0 +1,6 @@
+export type ResolveAppOptions = {
+    argv: string[];
+    envVar?: string;
+    allowAll?: boolean;
+};
+export declare const resolveAppSelection: (options: ResolveAppOptions) => Promise<string>;

package/lib/esm/lib/resolveAppSelection.js

@@ -0,0 +1,45 @@
+// 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
+//   2. npm_config_app                             (npm run x --app foo, no --)
+//   3. an env var the command already honours     (QPQ_DEV_APP / DEPLOY_APP_NAME)
+//   4. exactly one app under apps/ -> auto-select
+//   5. interactive prompt (TTY only)
+//   6. otherwise: print the valid app list and exit non-zero
+// An unknown name (from any source) also prints the list and exits non-zero.
+// Commands that can meaningfully run for every app may pass allowAll to accept
+// `--app all` (returned as the literal 'all').
+import { getArgValue } from './args';
+import { getAvailableApps } from './discovery';
+import { promptSelect } from './prompts';
+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);
+};
+export const resolveAppSelection = async (options) => {
+    const availableApps = getAvailableApps();
+    if (availableApps.length === 0) {
+        console.error('No apps found under apps/.');
+        process.exit(1);
+    }
+    const requested = getArgValue(options.argv, '--app') || process.env.npm_config_app || (options.envVar ? process.env[options.envVar] : undefined);
+    if (requested) {
+        if (options.allowAll && requested === 'all')
+            return 'all';
+        if (!availableApps.includes(requested))
+            exitWithAppList(requested, availableApps);
+        return requested;
+    }
+    if (availableApps.length === 1) {
+        console.log(`Using app: ${availableApps[0]}`);
+        return availableApps[0];
+    }
+    if (process.stdin.isTTY) {
+        return promptSelect('Select app', options.allowAll ? [...availableApps, 'all'] : availableApps);
+    }
+    return exitWithAppList(undefined, availableApps);
+};
+//# sourceMappingURL=resolveAppSelection.js.map

package/lib/esm/lib/resolveAppSelection.js.map

@@ -0,0 +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,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;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;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,OAA0B,EAAmB,EAAE;IACvF,MAAM,aAAa,GAAG,gBAAgB,EAAE,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,WAAW,CAAC,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,YAAY,CAAC,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,CAAC","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"]}

package/lib/esm/lib/resolveDeployment.d.ts

@@ -0,0 +1,14 @@
+import { QpqAppDeployment } from '@qpqjs/core';
+export declare const DEPLOYMENT_FLAG = "--deployment";
+export type ResolvedDeployment = {
+    deploymentName: string;
+    deployment: QpqAppDeployment;
+};
+/**
+ * Selects an entry of the app's deploy.config.json and writes it into process.env
+ * (identity, environment, feature, settings) before any service config is loaded.
+ * The file is the source of truth: nothing in the shell overrides a value in it.
+ * The platform driver validates its own settings, so an aws entry missing its
+ * account or region fails here, not inside cdk.
+ */
+export declare const resolveDeployment: (argv: string[], appName: string) => Promise<ResolvedDeployment>;

package/lib/esm/lib/resolveDeployment.js

@@ -0,0 +1,45 @@
+import { getQpqAppDeployConfig, getQpqAppDeployConfigPath, primeDeploymentEnv } from '@qpqjs/config-aws';
+import { QpqDeployEnvVar } from '@qpqjs/core';
+import { getPlatformDriver } from '../platforms';
+import { getArgValue } from './args';
+import { getRoot } from './discovery';
+import { promptSelect } from './prompts';
+export const DEPLOYMENT_FLAG = '--deployment';
+// Which entry to use: the flag, then DEPLOY_NAME (set by a parent qpq command or CI: a
+// selector, never a value), then the sole entry, then a prompt. Headless with several
+// entries and no selection is an error rather than a guess.
+const selectDeploymentName = async (argv, appName, configuredNames) => {
+    const requested = getArgValue(argv, DEPLOYMENT_FLAG) || process.env[QpqDeployEnvVar.deployName];
+    if (requested) {
+        if (!configuredNames.includes(requested)) {
+            console.error(`Unknown deployment '${requested}' in ${getQpqAppDeployConfigPath(getRoot(), appName)}. Configured: ${configuredNames.join(', ')}`);
+            process.exit(1);
+        }
+        return requested;
+    }
+    if (configuredNames.length === 1) {
+        console.log(`Using deployment: ${configuredNames[0]}`);
+        return configuredNames[0];
+    }
+    if (process.stdin.isTTY) {
+        return promptSelect('Select deployment', configuredNames);
+    }
+    console.error(`No deployment selected. Pass ${DEPLOYMENT_FLAG} <name>. Configured: ${configuredNames.join(', ')}`);
+    return process.exit(1);
+};
+/**
+ * Selects an entry of the app's deploy.config.json and writes it into process.env
+ * (identity, environment, feature, settings) before any service config is loaded.
+ * The file is the source of truth: nothing in the shell overrides a value in it.
+ * The platform driver validates its own settings, so an aws entry missing its
+ * account or region fails here, not inside cdk.
+ */
+export const resolveDeployment = async (argv, appName) => {
+    const { deployments } = getQpqAppDeployConfig(getRoot(), appName);
+    const deploymentName = await selectDeploymentName(argv, appName, Object.keys(deployments));
+    const deployment = deployments[deploymentName];
+    primeDeploymentEnv(appName, deploymentName, deployment);
+    getPlatformDriver(deployment.platform).prepareDeployment(deploymentName, deployment);
+    return { deploymentName, deployment };
+};
+//# sourceMappingURL=resolveDeployment.js.map

package/lib/esm/lib/resolveDeployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveDeployment.js","sourceRoot":"","sources":["../../../src/lib/resolveDeployment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAoB,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAC;AAO9C,uFAAuF;AACvF,sFAAsF;AACtF,4DAA4D;AAC5D,MAAM,oBAAoB,GAAG,KAAK,EAAE,IAAc,EAAE,OAAe,EAAE,eAAyB,EAAmB,EAAE;IACjH,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IAEhG,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,uBAAuB,SAAS,QAAQ,yBAAyB,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,iBAAiB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClJ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,qBAAqB,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvD,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,YAAY,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,gCAAgC,eAAe,wBAAwB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,IAAc,EAAE,OAAe,EAA+B,EAAE;IACtG,MAAM,EAAE,WAAW,EAAE,GAAG,qBAAqB,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3F,MAAM,UAAU,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;IAE/C,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;IACxD,iBAAiB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAErF,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;AACxC,CAAC,CAAC","sourcesContent":["import { getQpqAppDeployConfig, getQpqAppDeployConfigPath, primeDeploymentEnv } from '@qpqjs/config-aws';\nimport { QpqAppDeployment, QpqDeployEnvVar } from '@qpqjs/core';\n\nimport { getPlatformDriver } from '../platforms';\nimport { getArgValue } from './args';\nimport { getRoot } from './discovery';\nimport { promptSelect } from './prompts';\n\nexport const DEPLOYMENT_FLAG = '--deployment';\n\nexport type ResolvedDeployment = {\n  deploymentName: string;\n  deployment: QpqAppDeployment;\n};\n\n// Which entry to use: the flag, then DEPLOY_NAME (set by a parent qpq command or CI: a\n// selector, never a value), then the sole entry, then a prompt. Headless with several\n// entries and no selection is an error rather than a guess.\nconst selectDeploymentName = async (argv: string[], appName: string, configuredNames: string[]): Promise<string> => {\n  const requested = getArgValue(argv, DEPLOYMENT_FLAG) || process.env[QpqDeployEnvVar.deployName];\n\n  if (requested) {\n    if (!configuredNames.includes(requested)) {\n      console.error(`Unknown deployment '${requested}' in ${getQpqAppDeployConfigPath(getRoot(), appName)}. Configured: ${configuredNames.join(', ')}`);\n      process.exit(1);\n    }\n    return requested;\n  }\n\n  if (configuredNames.length === 1) {\n    console.log(`Using deployment: ${configuredNames[0]}`);\n    return configuredNames[0];\n  }\n\n  if (process.stdin.isTTY) {\n    return promptSelect('Select deployment', configuredNames);\n  }\n\n  console.error(`No deployment selected. Pass ${DEPLOYMENT_FLAG} <name>. Configured: ${configuredNames.join(', ')}`);\n  return process.exit(1);\n};\n\n/**\n * Selects an entry of the app's deploy.config.json and writes it into process.env\n * (identity, environment, feature, settings) before any service config is loaded.\n * The file is the source of truth: nothing in the shell overrides a value in it.\n * The platform driver validates its own settings, so an aws entry missing its\n * account or region fails here, not inside cdk.\n */\nexport const resolveDeployment = async (argv: string[], appName: string): Promise<ResolvedDeployment> => {\n  const { deployments } = getQpqAppDeployConfig(getRoot(), appName);\n  const deploymentName = await selectDeploymentName(argv, appName, Object.keys(deployments));\n  const deployment = deployments[deploymentName];\n\n  primeDeploymentEnv(appName, deploymentName, deployment);\n  getPlatformDriver(deployment.platform).prepareDeployment(deploymentName, deployment);\n\n  return { deploymentName, deployment };\n};\n"]}

package/lib/esm/lib/runCommand.d.ts

@@ -0,0 +1,14 @@
+export type RunCommandOptions = {
+    env?: Record<string, string>;
+    cwd?: string;
+    logCommand?: boolean;
+};
+export declare const runCommand: (command: string, args: string[], options?: RunCommandOptions) => Promise<void>;
+export declare const runCommandBestEffort: (command: string, args: string[], options?: RunCommandOptions) => Promise<void>;
+export type RunCommandPrefixedOptions = {
+    env?: Record<string, string>;
+    cwd?: string;
+    color?: number;
+};
+export declare const nextPrefixColor: () => number;
+export declare const runCommandPrefixed: (label: string, command: string, args: string[], options?: RunCommandPrefixedOptions) => Promise<void>;