quidproquo-cli 0.1.5

package/README.md

@@ -0,0 +1,3 @@
+# quidproquo-dev-server
+
+Not prod ready

package/docker/cdk-deployer/Dockerfile

@@ -0,0 +1,13 @@
+# Deploy runner for `qpq go:docker`. Containers deploy PRE-SYNTHESIZED
+# cloud assemblies (`cdk deploy --app /assembly <stack>`), so the image needs
+# only the CDK CLI — not the workspace, its npm-linked quidproquo packages, or
+# any platform-specific node_modules.
+#
+# CDK_VERSION is passed at build time to match the workspace's aws-cdk, so the
+# CLI can always read the assembly schema the host synthesized.
+FROM node:24-slim
+
+ARG CDK_VERSION=2
+RUN npm install -g aws-cdk@${CDK_VERSION}
+
+WORKDIR /work

package/docker/dev-server/Dockerfile

@@ -0,0 +1,48 @@
+# Runtime image for `qpq go` on the docker platform: the QPQ dev server
+# (a full local platform emulation — sqlite KVS, file storage, queues,
+# websockets) hosting every service of the app, plus the pre-built views.
+#
+# The server bundle externalizes bare packages (native modules like sqlite3
+# must load from a real install), so runtime deps are npm-installed in the
+# image, then the locally-built quidproquo packages are overlaid so the image
+# runs the same qpq code the bundle was built against.
+# trixie (glibc 2.41): sqlite3's prebuilt binaries are built against glibc
+# 2.38, which bookworm-based node:24-slim (glibc 2.36) can't load.
+FROM node:24-trixie-slim
+
+WORKDIR /app
+
+# Runtime deps (package.json is the consumer root's, with workspaces/scripts
+# stripped by the assemble step). Slow but correct: natives compile for linux.
+# vendor/ must be present before the install: consumers on file: refs have
+# their quidproquo deps rewritten to file:./vendor/<pkg> so npm can resolve
+# them (and their transitive deps) inside the context.
+COPY vendor/ ./vendor/
+COPY package.json ./
+RUN npm install --omit=dev
+
+# Overlay the locally-built quidproquo packages over the installed ones.
+# npm leaves file:./vendor deps as symlinks and registry deps as real
+# directories — rm+cp replaces either shape with the vendored code (a plain
+# COPY cannot write a directory over a symlink).
+RUN set -e; for d in ./vendor/*/; do \
+      [ -d "$d" ] || continue; \
+      pkg="$(basename "$d")"; \
+      rm -rf "./node_modules/$pkg"; \
+      cp -a "$d" "./node_modules/$pkg"; \
+    done
+
+COPY server/ ./server/
+COPY web/ ./web/
+
+ENV QPQ_WEB_ROOT=/app/web
+ENV NODE_ENV=production
+
+# api / websocket / file-storage secure urls
+EXPOSE 8080 8888 3001
+
+# Emulated platform state (sqlite + file storage) lives here — mount a volume
+# to persist it across container restarts.
+VOLUME /app/.qpq-runtime
+
+CMD ["node", "server/main.js"]

package/lib/commonjs/bin/qpq.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/lib/commonjs/bin/qpq.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("../cli");
+(0, cli_1.runCli)(process.argv.slice(2));
+//# sourceMappingURL=qpq.js.map

package/lib/commonjs/bin/qpq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qpq.js","sourceRoot":"","sources":["../../../src/bin/qpq.ts"],"names":[],"mappings":";;;AACA,gCAAgC;AAEhC,IAAA,YAAM,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { runCli } from '../cli';\n\nrunCli(process.argv.slice(2));\n"]}

package/lib/commonjs/bin/qpqCdkApp.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/commonjs/bin/qpqCdkApp.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// The CDK app command (`cdk ... --app "node -r ts-node/register/transpile-only <this file>"`).
+// Runs under ts-node hooks so per-app TS config fragments and service
+// infrastructure.ts files can be required directly.
+const quidproquo_deploy_awscdk_1 = require("quidproquo-deploy-awscdk");
+(0, quidproquo_deploy_awscdk_1.createWorkspaceQpqCdkApp)();
+//# sourceMappingURL=qpqCdkApp.js.map

package/lib/commonjs/bin/qpqCdkApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qpqCdkApp.js","sourceRoot":"","sources":["../../../src/bin/qpqCdkApp.ts"],"names":[],"mappings":";;AAAA,+FAA+F;AAC/F,sEAAsE;AACtE,oDAAoD;AACpD,uEAAoE;AAEpE,IAAA,mDAAwB,GAAE,CAAC","sourcesContent":["// The CDK app command (`cdk ... --app \"node -r ts-node/register/transpile-only <this file>\"`).\n// Runs under ts-node hooks so per-app TS config fragments and service\n// infrastructure.ts files can be required directly.\nimport { createWorkspaceQpqCdkApp } from 'quidproquo-deploy-awscdk';\n\ncreateWorkspaceQpqCdkApp();\n"]}

package/lib/commonjs/cli/index.d.ts

@@ -0,0 +1 @@
+export * from './runCli';

package/lib/commonjs/cli/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./runCli"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB","sourcesContent":["export * from './runCli';\n"]}

package/lib/commonjs/cli/runCli.d.ts

@@ -0,0 +1 @@
+export declare const runCli: (argv: string[]) => Promise<void>;

package/lib/commonjs/cli/runCli.js

@@ -0,0 +1,80 @@
+"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.runCli = void 0;
+const usage = `qpq — build, dev and deploy orchestration for QPQ apps
+
+Usage: qpq <command> [--app <name>] [--env <name>] [--platform <name>]
+
+Commands:
+  go               Deploy services (interactive; platform from deploy.config.json, default aws)
+  go:docker        Same as go, but deploys in parallel via docker
+  go:dev           Run the local dev server (hot reload)
+  go:dev:web       Run every views microfrontend dev server
+  teardown         Destroy web/api/inf stacks for selected services (interactive)
+  synth [service]  Synth QPQ configs to dist/apps/<app>/infrastructure
+  prep             Regenerate apps/<app>/tsconfig.federated.json
+  publish          Build + upload + deploy federated remotes
+  publish:build    Build federated remotes locally
+  publish:upload   Upload built version dirs (nothing goes live)
+  publish:deploy   Flip manifests to the uploaded versions
+  hooks <name>     Run qpq:<name> in every app that defines it
+`;
+// Service infrastructure.ts files (and app config fragments) are TypeScript —
+// register ts-node's transpile-only require hook so the CLI can require them
+// directly, using the consumer root's tsconfig.json ts-node settings.
+const registerTsNode = () => {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    require('ts-node').register({ transpileOnly: true });
+};
+const runCli = (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    const [command, ...commandArgv] = argv;
+    if (!command || command === 'help' || command === '--help') {
+        console.log(usage);
+        return;
+    }
+    registerTsNode();
+    // Commands are required lazily so a simple `qpq help` doesn't pay for the
+    // whole toolchain, and so ts-node is registered before any command module
+    // (or anything it requires) loads.
+    /* eslint-disable @typescript-eslint/no-require-imports */
+    const commands = {
+        go: (a) => require('../commands/go').goCommand(a),
+        'go:docker': (a) => require('../commands/goDocker').goDockerCommand(a),
+        'go:dev': (a) => require('../commands/goDev').goDevCommand(a),
+        'go:dev:web': (a) => require('../commands/goDevWeb').goDevWebCommand(a),
+        teardown: (a) => require('../commands/teardown').teardownCommand(a),
+        synth: (a) => require('../commands/synth').synthCommand(a),
+        prep: (a) => require('../commands/prep').prepCommand(a),
+        publish: (a) => require('../commands/publish').publishCommand(a),
+        'publish:build': (a) => require('../commands/publish').publishBuildCommand(a),
+        'publish:upload': (a) => require('../commands/publish').publishUploadCommand(a),
+        'publish:deploy': (a) => require('../commands/publish').publishDeployCommand(a),
+        hooks: (a) => require('../commands/hooks').hooksCommand(a),
+    };
+    /* eslint-enable @typescript-eslint/no-require-imports */
+    const run = commands[command];
+    if (!run) {
+        console.error(`Unknown command: ${command}`);
+        console.log(usage);
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        yield run(commandArgv);
+    }
+    catch (error) {
+        console.error(`qpq ${command} failed:`, error);
+        process.exitCode = 1;
+    }
+});
+exports.runCli = runCli;
+//# sourceMappingURL=runCli.js.map

package/lib/commonjs/cli/runCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCli.js","sourceRoot":"","sources":["../../../src/cli/runCli.ts"],"names":[],"mappings":"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","sourcesContent":["const usage = `qpq — build, dev and deploy orchestration for QPQ apps\n\nUsage: qpq <command> [--app <name>] [--env <name>] [--platform <name>]\n\nCommands:\n  go               Deploy services (interactive; platform from deploy.config.json, default aws)\n  go:docker        Same as go, but deploys in parallel via docker\n  go:dev           Run the local dev server (hot reload)\n  go:dev:web       Run every views microfrontend dev server\n  teardown         Destroy web/api/inf stacks for selected services (interactive)\n  synth [service]  Synth QPQ configs to dist/apps/<app>/infrastructure\n  prep             Regenerate apps/<app>/tsconfig.federated.json\n  publish          Build + upload + deploy federated remotes\n  publish:build    Build federated remotes locally\n  publish:upload   Upload built version dirs (nothing goes live)\n  publish:deploy   Flip manifests to the uploaded versions\n  hooks <name>     Run qpq:<name> in every app that defines it\n`;\n\n// Service infrastructure.ts files (and app config fragments) are TypeScript —\n// register ts-node's transpile-only require hook so the CLI can require them\n// directly, using the consumer root's tsconfig.json ts-node settings.\nconst registerTsNode = (): void => {\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  require('ts-node').register({ transpileOnly: true });\n};\n\nexport const runCli = async (argv: string[]): Promise<void> => {\n  const [command, ...commandArgv] = argv;\n\n  if (!command || command === 'help' || command === '--help') {\n    console.log(usage);\n    return;\n  }\n\n  registerTsNode();\n\n  // Commands are required lazily so a simple `qpq help` doesn't pay for the\n  // whole toolchain, and so ts-node is registered before any command module\n  // (or anything it requires) loads.\n  /* eslint-disable @typescript-eslint/no-require-imports */\n  const commands: Record<string, (commandArgv: string[]) => Promise<void>> = {\n    go: (a) => require('../commands/go').goCommand(a),\n    'go:docker': (a) => require('../commands/goDocker').goDockerCommand(a),\n    'go:dev': (a) => require('../commands/goDev').goDevCommand(a),\n    'go:dev:web': (a) => require('../commands/goDevWeb').goDevWebCommand(a),\n    teardown: (a) => require('../commands/teardown').teardownCommand(a),\n    synth: (a) => require('../commands/synth').synthCommand(a),\n    prep: (a) => require('../commands/prep').prepCommand(a),\n    publish: (a) => require('../commands/publish').publishCommand(a),\n    'publish:build': (a) => require('../commands/publish').publishBuildCommand(a),\n    'publish:upload': (a) => require('../commands/publish').publishUploadCommand(a),\n    'publish:deploy': (a) => require('../commands/publish').publishDeployCommand(a),\n    hooks: (a) => require('../commands/hooks').hooksCommand(a),\n  };\n  /* eslint-enable @typescript-eslint/no-require-imports */\n\n  const run = commands[command];\n\n  if (!run) {\n    console.error(`Unknown command: ${command}`);\n    console.log(usage);\n    process.exitCode = 1;\n    return;\n  }\n\n  try {\n    await run(commandArgv);\n  } catch (error) {\n    console.error(`qpq ${command} failed:`, error);\n    process.exitCode = 1;\n  }\n};\n"]}

package/lib/commonjs/commands/go.d.ts

@@ -0,0 +1 @@
+export declare const goCommand: (argv: string[]) => Promise<void>;

package/lib/commonjs/commands/go.js

@@ -0,0 +1,28 @@
+"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.goCommand = void 0;
+// `qpq go` — interactive deploy. Resolves the app + environment (which names
+// the deploy platform in apps/<app>/deploy.config.json, default aws), asks the
+// deploy plan, then hands off to the platform driver.
+const deployEnv_1 = require("../lib/deployEnv");
+const deployPrompts_1 = require("../lib/deployPrompts");
+const resolveAppSelection_1 = require("../lib/resolveAppSelection");
+const platforms_1 = require("../platforms");
+const goCommand = (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    const appName = yield (0, resolveAppSelection_1.resolveAppSelection)({ argv, envVar: 'DEPLOY_APP_NAME' });
+    const { platform } = yield (0, deployEnv_1.resolveDeployEnvironment)(argv, appName);
+    const driver = (0, platforms_1.getPlatformDriver)(platform);
+    const plan = yield (0, deployPrompts_1.promptDeployPlan)(appName);
+    yield driver.go(appName, plan);
+});
+exports.goCommand = goCommand;
+//# sourceMappingURL=go.js.map

package/lib/commonjs/commands/go.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"go.js","sourceRoot":"","sources":["../../../src/commands/go.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6EAA6E;AAC7E,+EAA+E;AAC/E,sDAAsD;AACtD,gDAA4D;AAC5D,wDAAwD;AACxD,oEAAiE;AACjE,4CAAiD;AAE1C,MAAM,SAAS,GAAG,CAAO,IAAc,EAAiB,EAAE;IAC/D,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAmB,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/E,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAA,oCAAwB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,IAAA,6BAAiB,EAAC,QAAQ,CAAC,CAAC;IAE3C,MAAM,IAAI,GAAG,MAAM,IAAA,gCAAgB,EAAC,OAAO,CAAC,CAAC;IAE7C,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC,CAAA,CAAC;AARW,QAAA,SAAS,aAQpB","sourcesContent":["// `qpq go` — interactive deploy. Resolves the app + environment (which names\n// the deploy platform in apps/<app>/deploy.config.json, default aws), asks the\n// deploy plan, then hands off to the platform driver.\nimport { resolveDeployEnvironment } from '../lib/deployEnv';\nimport { promptDeployPlan } from '../lib/deployPrompts';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { getPlatformDriver } from '../platforms';\n\nexport const goCommand = async (argv: string[]): Promise<void> => {\n  const appName = await resolveAppSelection({ argv, envVar: 'DEPLOY_APP_NAME' });\n  const { platform } = await resolveDeployEnvironment(argv, appName);\n  const driver = getPlatformDriver(platform);\n\n  const plan = await promptDeployPlan(appName);\n\n  await driver.go(appName, plan);\n};\n"]}

package/lib/commonjs/commands/goDev.d.ts

@@ -0,0 +1 @@
+export declare const goDevCommand: (argv: string[]) => Promise<void>;

package/lib/commonjs/commands/goDev.js

@@ -0,0 +1,143 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.goDevCommand = void 0;
+// `qpq go:dev` — boots the QPQ local dev server. Resolves the app, generates
+// the dev-server entry, builds the rspack config, then runs rspack in watch
+// mode, restarting the server process on every successful rebuild.
+//
+// The one thing NOT hot-reloaded is the qpq configs themselves: each service's
+// infrastructure.ts is evaluated once at launch and baked into the
+// `quidproquo-dynamic-loader` virtual module — config changes need a full
+// `go:dev` restart.
+const quidproquo_deploy_rspack_1 = require("quidproquo-deploy-rspack");
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const core_1 = require("@rspack/core");
+const deployEnv_1 = require("../lib/deployEnv");
+const devServerEntry_1 = require("../lib/devServerEntry");
+const discovery_1 = require("../lib/discovery");
+const resolveAppSelection_1 = require("../lib/resolveAppSelection");
+// 8080/8888 are set in the generated entry; 3001 is the quidproquo-dev-server
+// file-storage (secure URL) default port.
+const DEV_SERVER_PORTS = [8080, 8888, 3001];
+const DEV_SERVER_BUNDLE_PATH = path_1.default.join('dist', 'qpq', 'dev-server', 'main.js');
+// Pre-start sweep: a previous `go:dev` whose wrapper died without killing its
+// child (closed terminal, SIGKILL) leaves an orphaned server process holding
+// the dev ports, and the next launch dies with EADDRINUSE. Before starting,
+// kill any listener on those ports that is running the dev-server bundle.
+// Anything else on the ports is left alone and reported — it's not ours.
+const killStaleDevServers = () => {
+    for (const port of DEV_SERVER_PORTS) {
+        let pids = [];
+        try {
+            pids = (0, child_process_1.execSync)(`lsof -t -iTCP:${port} -sTCP:LISTEN`, {
+                stdio: ['ignore', 'pipe', 'ignore'],
+            })
+                .toString()
+                .split('\n')
+                .map((line) => Number(line.trim()))
+                .filter(Boolean);
+        }
+        catch (_a) {
+            continue; // lsof exits non-zero when nothing is listening
+        }
+        for (const pid of pids) {
+            let command = '';
+            try {
+                command = (0, child_process_1.execSync)(`ps -p ${pid} -o command=`).toString().trim();
+            }
+            catch (_b) {
+                continue; // already gone
+            }
+            if (command.includes(DEV_SERVER_BUNDLE_PATH)) {
+                console.log(`Killing stale dev server on port ${port} (pid ${pid})`);
+                process.kill(pid);
+            }
+            else {
+                console.warn(`Port ${port} is in use by an unrelated process (pid ${pid}: ${command}) — not killing it.`);
+            }
+        }
+    }
+};
+const goDevCommand = (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    const root = (0, discovery_1.getRoot)();
+    const appName = yield (0, resolveAppSelection_1.resolveAppSelection)({ argv, envVar: 'QPQ_DEV_APP' });
+    process.env.QPQ_DEV_APP = appName;
+    (0, deployEnv_1.primeDeployEnvFromConfig)(appName);
+    console.log(`Dev server for app [${appName}]`);
+    killStaleDevServers();
+    const qpqConfigs = (0, quidproquo_deploy_rspack_1.getAppServiceQpqConfigs)(root, appName);
+    const entry = (0, devServerEntry_1.writeDevServerEntry)(root, appName);
+    const rspackConfig = (0, quidproquo_deploy_rspack_1.getDevServerRspackConfig)({ root, entry, qpqConfigs });
+    const bundlePath = path_1.default.join(root, DEV_SERVER_BUNDLE_PATH);
+    const env = Object.assign(Object.assign({}, process.env), { QPQ_DEV_APP: appName });
+    // The long-lived server process (HTTP 8080 / WS 8888), restarted per rebuild.
+    let child = null;
+    let restartQueued = false;
+    const startServer = () => {
+        child = (0, child_process_1.spawn)('node', [bundlePath], { stdio: 'inherit', env });
+        child.on('exit', (code) => {
+            child = null;
+            if (!restartQueued) {
+                // Crashed (or exited) on its own — leave it down; the next successful
+                // rebuild (i.e. the next file save) brings it back up.
+                console.log(`Dev server exited with code ${code}. Save a file to restart it.`);
+            }
+        });
+    };
+    const restartServer = () => {
+        if (restartQueued)
+            return;
+        if (!child) {
+            startServer();
+            return;
+        }
+        restartQueued = true;
+        child.once('exit', () => {
+            restartQueued = false;
+            startServer();
+        });
+        child.kill();
+    };
+    console.log('Bundling dev server (watch mode)...');
+    let lastHash;
+    const compiler = (0, core_1.rspack)(rspackConfig);
+    compiler.watch({ aggregateTimeout: 200 }, (err, stats) => {
+        if (err) {
+            console.error(err);
+            return;
+        }
+        if (stats === null || stats === void 0 ? void 0 : stats.hasErrors()) {
+            console.error(stats.toString({ colors: true, chunks: false, modules: false }));
+            console.log('Build failed — dev server not restarted. Fix the error and save again.');
+            return;
+        }
+        // Skip no-op rebuilds (e.g. the virtual-module-triggered second compile at
+        // startup): only restart when the output actually changed.
+        if ((stats === null || stats === void 0 ? void 0 : stats.hash) === lastHash && child) {
+            return;
+        }
+        lastHash = stats === null || stats === void 0 ? void 0 : stats.hash;
+        console.log(child ? 'Rebuilt. Restarting dev server...' : 'Dev server bundled. Starting...');
+        restartServer();
+    });
+    process.on('SIGINT', () => {
+        restartQueued = true; // suppress the crash log / rebuild-restart on our own kill
+        child === null || child === void 0 ? void 0 : child.kill();
+        compiler.close(() => process.exit(0));
+    });
+});
+exports.goDevCommand = goDevCommand;
+//# sourceMappingURL=goDev.js.map

package/lib/commonjs/commands/goDev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goDev.js","sourceRoot":"","sources":["../../../src/commands/goDev.ts"],"names":[],"mappings":"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","sourcesContent":["// `qpq go:dev` — boots the QPQ local dev server. Resolves the app, generates\n// the dev-server entry, builds the rspack config, then runs rspack in watch\n// mode, restarting the server process on every successful rebuild.\n//\n// The one thing NOT hot-reloaded is the qpq configs themselves: each service's\n// infrastructure.ts is evaluated once at launch and baked into the\n// `quidproquo-dynamic-loader` virtual module — config changes need a full\n// `go:dev` restart.\nimport { getAppServiceQpqConfigs, getDevServerRspackConfig } from 'quidproquo-deploy-rspack';\n\nimport { ChildProcess, execSync, spawn } from 'child_process';\nimport fs from 'fs';\nimport path from 'path';\nimport { rspack } from '@rspack/core';\n\nimport { primeDeployEnvFromConfig } from '../lib/deployEnv';\nimport { writeDevServerEntry } from '../lib/devServerEntry';\nimport { getRoot } from '../lib/discovery';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\n\n// 8080/8888 are set in the generated entry; 3001 is the quidproquo-dev-server\n// file-storage (secure URL) default port.\nconst DEV_SERVER_PORTS = [8080, 8888, 3001];\nconst DEV_SERVER_BUNDLE_PATH = path.join('dist', 'qpq', 'dev-server', 'main.js');\n\n// Pre-start sweep: a previous `go:dev` whose wrapper died without killing its\n// child (closed terminal, SIGKILL) leaves an orphaned server process holding\n// the dev ports, and the next launch dies with EADDRINUSE. Before starting,\n// kill any listener on those ports that is running the dev-server bundle.\n// Anything else on the ports is left alone and reported — it's not ours.\nconst killStaleDevServers = (): void => {\n  for (const port of DEV_SERVER_PORTS) {\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      continue; // lsof exits non-zero when nothing is listening\n    }\n\n    for (const pid of pids) {\n      let command = '';\n      try {\n        command = execSync(`ps -p ${pid} -o command=`).toString().trim();\n      } catch {\n        continue; // already gone\n      }\n      if (command.includes(DEV_SERVER_BUNDLE_PATH)) {\n        console.log(`Killing stale dev server on port ${port} (pid ${pid})`);\n        process.kill(pid);\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\nexport const goDevCommand = async (argv: string[]): Promise<void> => {\n  const root = getRoot();\n  const appName = await resolveAppSelection({ argv, envVar: 'QPQ_DEV_APP' });\n  process.env.QPQ_DEV_APP = appName;\n  primeDeployEnvFromConfig(appName);\n  console.log(`Dev server for app [${appName}]`);\n\n  killStaleDevServers();\n\n  const qpqConfigs = getAppServiceQpqConfigs(root, appName);\n  const entry = writeDevServerEntry(root, appName);\n  const rspackConfig = getDevServerRspackConfig({ root, entry, qpqConfigs });\n  const bundlePath = path.join(root, DEV_SERVER_BUNDLE_PATH);\n  const env = { ...process.env, QPQ_DEV_APP: appName };\n\n  // The long-lived server process (HTTP 8080 / WS 8888), restarted per rebuild.\n  let child: ChildProcess | null = null;\n  let restartQueued = false;\n\n  const startServer = (): void => {\n    child = spawn('node', [bundlePath], { stdio: 'inherit', env });\n    child.on('exit', (code) => {\n      child = null;\n      if (!restartQueued) {\n        // Crashed (or exited) on its own — leave it down; the next successful\n        // rebuild (i.e. the next file save) brings it back up.\n        console.log(`Dev server exited with code ${code}. Save a file to restart it.`);\n      }\n    });\n  };\n\n  const restartServer = (): void => {\n    if (restartQueued) return;\n    if (!child) {\n      startServer();\n      return;\n    }\n    restartQueued = true;\n    child.once('exit', () => {\n      restartQueued = false;\n      startServer();\n    });\n    child.kill();\n  };\n\n  console.log('Bundling dev server (watch mode)...');\n  let lastHash: string | null | undefined;\n  const compiler = rspack(rspackConfig);\n  compiler.watch({ aggregateTimeout: 200 }, (err, stats) => {\n    if (err) {\n      console.error(err);\n      return;\n    }\n    if (stats?.hasErrors()) {\n      console.error(stats.toString({ colors: true, chunks: false, modules: false }));\n      console.log('Build failed — dev server not restarted. Fix the error and save again.');\n      return;\n    }\n    // Skip no-op rebuilds (e.g. the virtual-module-triggered second compile at\n    // startup): only restart when the output actually changed.\n    if (stats?.hash === lastHash && child) {\n      return;\n    }\n    lastHash = stats?.hash;\n    console.log(child ? 'Rebuilt. Restarting dev server...' : 'Dev server bundled. Starting...');\n    restartServer();\n  });\n\n  process.on('SIGINT', () => {\n    restartQueued = true; // suppress the crash log / rebuild-restart on our own kill\n    child?.kill();\n    compiler.close(() => process.exit(0));\n  });\n};\n"]}

package/lib/commonjs/commands/goDevWeb.d.ts

@@ -0,0 +1 @@
+export declare const goDevWebCommand: (argv: string[]) => Promise<void>;

package/lib/commonjs/commands/goDevWeb.js

@@ -0,0 +1,122 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.goDevWebCommand = void 0;
+// `qpq go:dev:web` — boots every views microfrontend's Rspack dev server
+// in-process (shell is the MF host app, plus all remotes on their own ports).
+// Everything is served dynamically; remotes resolve at runtime via
+// mf-manifest.json on localhost ports. Programmatic — no per-views
+// rspack.config.ts or npm serve script needed.
+//
+// Usage:
+//   qpq go:dev:web
+//   qpq go:dev:web --only shell,design
+//   qpq go:dev:web --app <name>
+const quidproquo_deploy_rspack_1 = require("quidproquo-deploy-rspack");
+const http_1 = __importDefault(require("http"));
+const core_1 = require("@rspack/core");
+const dev_server_1 = require("@rspack/dev-server");
+const args_1 = require("../lib/args");
+const deployEnv_1 = require("../lib/deployEnv");
+const discovery_1 = require("../lib/discovery");
+const resolveAppSelection_1 = require("../lib/resolveAppSelection");
+const goDevWebCommand = (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const root = (0, discovery_1.getRoot)();
+    const appName = yield (0, resolveAppSelection_1.resolveAppSelection)({ argv, envVar: 'QPQ_DEV_APP' });
+    process.env.LOCAL_DEV_SERVER = 'true';
+    process.env.NODE_ENV = 'development';
+    (0, deployEnv_1.primeDeployEnvFromConfig)(appName);
+    const only = (_a = (0, args_1.getArgValue)(argv, '--only')) === null || _a === void 0 ? void 0 : _a.split(',').map((s) => s.trim());
+    let views = (0, quidproquo_deploy_rspack_1.getAllViews)(root, appName);
+    if (only)
+        views = views.filter((v) => only.includes(v.service));
+    if (views.length === 0) {
+        console.error('No views projects found.');
+        process.exit(1);
+    }
+    // Every RspackDevServer.start() registers its own SIGINT/SIGTERM handler on
+    // process — with a dozen views servers in one process that trips node's
+    // default 10-listener warning. Size the limit to the fleet.
+    process.setMaxListeners(Math.max(process.getMaxListeners(), views.length * 2 + 10));
+    // Service names are padded to a common width so the "(started)" chips align.
+    const serviceColumnWidth = Math.max(...views.map((v) => v.service.length));
+    console.log(`Starting ${views.length} views dev servers for [${appName}]:`);
+    for (const v of views)
+        console.log(`  http://localhost:${v.port}  ${v.service.padEnd(serviceColumnWidth)}`);
+    const servers = [];
+    let shuttingDown = false;
+    const shutdown = (code) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        Promise.allSettled(servers.map((server) => server.stop())).then(() => process.exit(code));
+    };
+    // The URL list above gets a yellow "(started)" chip appended in place as
+    // each dev server begins answering HTTP. The in-place rewrite moves the
+    // cursor up past everything printed since the list, so every line printed
+    // below it MUST go through logBelowList to keep the offset accurate.
+    let linesBelowList = 0;
+    const logBelowList = (line) => {
+        console.log(line);
+        linesBelowList += 1;
+    };
+    const markStarted = (index) => {
+        const v = views[index];
+        if (!process.stdout.isTTY) {
+            logBelowList(`  ${v.service} started`);
+            return;
+        }
+        const line = `  http://localhost:${v.port}  ${v.service.padEnd(serviceColumnWidth)}  \x1b[33m(started)\x1b[0m`;
+        const up = linesBelowList + (views.length - index);
+        process.stdout.write(`\x1b[${up}F\x1b[2K${line}\x1b[${up}E`);
+    };
+    const pollUntilStarted = (index) => {
+        const attempt = () => {
+            if (shuttingDown)
+                return;
+            const req = http_1.default.get({
+                host: 'localhost',
+                port: views[index].port,
+                path: '/',
+                timeout: 1000,
+            }, (res) => {
+                res.resume();
+                markStarted(index);
+            });
+            req.on('error', () => setTimeout(attempt, 500));
+            req.on('timeout', () => req.destroy());
+        };
+        attempt();
+    };
+    for (const [index, view] of views.entries()) {
+        const config = (0, quidproquo_deploy_rspack_1.getViewsRspackConfig)(view.viewsDir);
+        const compiler = (0, core_1.rspack)(config);
+        const server = new dev_server_1.RspackDevServer(config.devServer || { port: view.port }, compiler);
+        servers.push(server);
+        try {
+            yield server.start();
+        }
+        catch (e) {
+            logBelowList(`  [${view.service}] failed to start: ${e.message} — shutting down all views servers.`);
+            shutdown(1);
+            return;
+        }
+        pollUntilStarted(index);
+    }
+    process.on('SIGINT', () => shutdown(0));
+    process.on('SIGTERM', () => shutdown(0));
+});
+exports.goDevWebCommand = goDevWebCommand;
+//# sourceMappingURL=goDevWeb.js.map

package/lib/commonjs/commands/goDevWeb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goDevWeb.js","sourceRoot":"","sources":["../../../src/commands/goDevWeb.ts"],"names":[],"mappings":"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","sourcesContent":["// `qpq go:dev:web` — boots every views microfrontend's Rspack dev server\n// in-process (shell is the MF host app, plus all remotes on their own ports).\n// Everything is served dynamically; remotes resolve at runtime via\n// mf-manifest.json on localhost ports. Programmatic — no per-views\n// rspack.config.ts or npm serve script needed.\n//\n// Usage:\n//   qpq go:dev:web\n//   qpq go:dev:web --only shell,design\n//   qpq go:dev:web --app <name>\nimport { getAllViews, getViewsRspackConfig } from 'quidproquo-deploy-rspack';\n\nimport http from 'http';\nimport { rspack } from '@rspack/core';\nimport { RspackDevServer } from '@rspack/dev-server';\n\nimport { getArgValue } from '../lib/args';\nimport { primeDeployEnvFromConfig } from '../lib/deployEnv';\nimport { getRoot } from '../lib/discovery';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\n\nexport const goDevWebCommand = async (argv: string[]): Promise<void> => {\n  const root = getRoot();\n  const appName = await resolveAppSelection({ argv, envVar: 'QPQ_DEV_APP' });\n\n  process.env.LOCAL_DEV_SERVER = 'true';\n  process.env.NODE_ENV = 'development';\n  primeDeployEnvFromConfig(appName);\n\n  const only = getArgValue(argv, '--only')\n    ?.split(',')\n    .map((s) => s.trim());\n\n  let views = getAllViews(root, appName);\n  if (only) views = views.filter((v) => only.includes(v.service));\n  if (views.length === 0) {\n    console.error('No views projects found.');\n    process.exit(1);\n  }\n\n  // Every RspackDevServer.start() registers its own SIGINT/SIGTERM handler on\n  // process — with a dozen views servers in one process that trips node's\n  // default 10-listener warning. Size the limit to the fleet.\n  process.setMaxListeners(Math.max(process.getMaxListeners(), views.length * 2 + 10));\n\n  // Service names are padded to a common width so the \"(started)\" chips align.\n  const serviceColumnWidth = Math.max(...views.map((v) => v.service.length));\n\n  console.log(`Starting ${views.length} views dev servers for [${appName}]:`);\n  for (const v of views) console.log(`  http://localhost:${v.port}  ${v.service.padEnd(serviceColumnWidth)}`);\n\n  const servers: RspackDevServer[] = [];\n  let shuttingDown = false;\n\n  const shutdown = (code: number): void => {\n    if (shuttingDown) return;\n    shuttingDown = true;\n    Promise.allSettled(servers.map((server) => server.stop())).then(() => process.exit(code));\n  };\n\n  // The URL list above gets a yellow \"(started)\" chip appended in place as\n  // each dev server begins answering HTTP. The in-place rewrite moves the\n  // cursor up past everything printed since the list, so every line printed\n  // below it MUST go through logBelowList to keep the offset accurate.\n  let linesBelowList = 0;\n\n  const logBelowList = (line: string): void => {\n    console.log(line);\n    linesBelowList += 1;\n  };\n\n  const markStarted = (index: number): void => {\n    const v = views[index];\n    if (!process.stdout.isTTY) {\n      logBelowList(`  ${v.service} started`);\n      return;\n    }\n    const line = `  http://localhost:${v.port}  ${v.service.padEnd(serviceColumnWidth)}  \\x1b[33m(started)\\x1b[0m`;\n    const up = linesBelowList + (views.length - index);\n    process.stdout.write(`\\x1b[${up}F\\x1b[2K${line}\\x1b[${up}E`);\n  };\n\n  const pollUntilStarted = (index: number): void => {\n    const attempt = (): void => {\n      if (shuttingDown) return;\n      const req = http.get(\n        {\n          host: 'localhost',\n          port: views[index].port,\n          path: '/',\n          timeout: 1000,\n        },\n        (res) => {\n          res.resume();\n          markStarted(index);\n        },\n      );\n      req.on('error', () => setTimeout(attempt, 500));\n      req.on('timeout', () => req.destroy());\n    };\n    attempt();\n  };\n\n  for (const [index, view] of views.entries()) {\n    const config = getViewsRspackConfig(view.viewsDir);\n    const compiler = rspack(config);\n    const server = new RspackDevServer(config.devServer || { port: view.port }, compiler);\n    servers.push(server);\n\n    try {\n      await server.start();\n    } catch (e) {\n      logBelowList(`  [${view.service}] failed to start: ${(e as Error).message} — shutting down all views servers.`);\n      shutdown(1);\n      return;\n    }\n\n    pollUntilStarted(index);\n  }\n\n  process.on('SIGINT', () => shutdown(0));\n  process.on('SIGTERM', () => shutdown(0));\n};\n"]}

package/lib/commonjs/commands/goDocker.d.ts

@@ -0,0 +1 @@
+export declare const goDockerCommand: (argv: string[]) => Promise<void>;

package/lib/commonjs/commands/goDocker.js

@@ -0,0 +1,32 @@
+"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.goDockerCommand = void 0;
+// `qpq go:docker` — asks the same questions as `qpq go`, then runs the
+// platform driver's parallel containerized deploy (drivers without a docker
+// strategy don't offer one).
+const deployEnv_1 = require("../lib/deployEnv");
+const deployPrompts_1 = require("../lib/deployPrompts");
+const resolveAppSelection_1 = require("../lib/resolveAppSelection");
+const platforms_1 = require("../platforms");
+const goDockerCommand = (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    const appName = yield (0, resolveAppSelection_1.resolveAppSelection)({ argv, envVar: 'DEPLOY_APP_NAME' });
+    const { platform } = yield (0, deployEnv_1.resolveDeployEnvironment)(argv, appName);
+    const driver = (0, platforms_1.getPlatformDriver)(platform);
+    if (!driver.goDocker) {
+        console.error(`Platform '${platform}' has no dockerized deploy — use qpq go instead.`);
+        process.exit(1);
+    }
+    const plan = yield (0, deployPrompts_1.promptDeployPlan)(appName);
+    yield driver.goDocker(appName, plan);
+});
+exports.goDockerCommand = goDockerCommand;
+//# sourceMappingURL=goDocker.js.map

package/lib/commonjs/commands/goDocker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goDocker.js","sourceRoot":"","sources":["../../../src/commands/goDocker.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,uEAAuE;AACvE,4EAA4E;AAC5E,6BAA6B;AAC7B,gDAA4D;AAC5D,wDAAwD;AACxD,oEAAiE;AACjE,4CAAiD;AAE1C,MAAM,eAAe,GAAG,CAAO,IAAc,EAAiB,EAAE;IACrE,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAmB,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/E,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAA,oCAAwB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,IAAA,6BAAiB,EAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,aAAa,QAAQ,kDAAkD,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAA,gCAAgB,EAAC,OAAO,CAAC,CAAC;IAE7C,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC,CAAA,CAAC;AAbW,QAAA,eAAe,mBAa1B","sourcesContent":["// `qpq go:docker` — asks the same questions as `qpq go`, then runs the\n// platform driver's parallel containerized deploy (drivers without a docker\n// strategy don't offer one).\nimport { resolveDeployEnvironment } from '../lib/deployEnv';\nimport { promptDeployPlan } from '../lib/deployPrompts';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { getPlatformDriver } from '../platforms';\n\nexport const goDockerCommand = async (argv: string[]): Promise<void> => {\n  const appName = await resolveAppSelection({ argv, envVar: 'DEPLOY_APP_NAME' });\n  const { platform } = await resolveDeployEnvironment(argv, appName);\n  const driver = getPlatformDriver(platform);\n\n  if (!driver.goDocker) {\n    console.error(`Platform '${platform}' has no dockerized deploy — use qpq go instead.`);\n    process.exit(1);\n  }\n\n  const plan = await promptDeployPlan(appName);\n\n  await driver.goDocker(appName, plan);\n};\n"]}

package/lib/commonjs/commands/hooks.d.ts

@@ -0,0 +1 @@
+export declare const hooksCommand: (argv: string[]) => Promise<void>;