@qpqjs/cli 0.0.0-stage → 0.2.0

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":["import { promptCommandFromMenu } from './commandMenu';\nimport { buildUsage, CliCommand, cliCommands } from './commandRegistry';\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.\n//\n// CONTRACT: JavaScript apps (create-qpq-app --language javascript) also lean\n// on this hook — their tsconfig.json ts-node block sets allowJs (so their\n// ESM-syntax infrastructure.js compiles at require time) and scope/scopeDir\n// (so the hook never touches quidproquo libs outside the app). Any\n// replacement for ts-node here must honour those consumer tsconfig options.\nconst registerTsNode = (): void => {\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  require('ts-node').register({ transpileOnly: true });\n};\n\n// Inquirer throws ExitPromptError on ctrl-c; treat that as a quiet exit\n// rather than a command failure.\nconst isPromptExit = (error: unknown): boolean => error instanceof Error && error.name === 'ExitPromptError';\n\n// Bare `qpq` on a terminal: drill through the command menu, gathering any\n// arguments the picked command needs. Returns null when the user bails out.\nconst resolveCommandInteractively = async (): Promise<{ command: CliCommand; commandArgv: string[] } | null> => {\n  try {\n    const command = await promptCommandFromMenu(cliCommands);\n    const commandArgv = command.promptArgs ? await command.promptArgs() : [];\n\n    return { command, commandArgv };\n  } catch (error) {\n    if (isPromptExit(error)) {\n      return null;\n    }\n\n    throw error;\n  }\n};\n\nexport const runCli = async (argv: string[]): Promise<void> => {\n  const [commandName, ...argvRest] = argv;\n\n  if (commandName === 'help' || commandName === '--help') {\n    console.log(buildUsage());\n    return;\n  }\n\n  let command: CliCommand | undefined;\n  let commandArgv: string[] = [];\n\n  if (!commandName) {\n    // Only prompt on a real terminal; piped/CI invocations get the usage text.\n    if (!process.stdin.isTTY || !process.stdout.isTTY) {\n      console.log(buildUsage());\n      return;\n    }\n\n    const resolved = await resolveCommandInteractively();\n\n    if (!resolved) {\n      return;\n    }\n\n    ({ command, commandArgv } = resolved);\n  } else {\n    command = cliCommands.find((c) => c.name === commandName);\n    commandArgv = argvRest;\n\n    if (!command) {\n      console.error(`Unknown command: ${commandName}`);\n      console.log(buildUsage());\n      process.exitCode = 1;\n      return;\n    }\n  }\n\n  registerTsNode();\n\n  try {\n    await command.run(commandArgv);\n  } catch (error) {\n    console.error(`qpq ${command.name} failed:`, error);\n    process.exitCode = 1;\n  }\n};\n"]}

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

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

package/lib/commonjs/commands/checkCircular.js

@@ -0,0 +1,70 @@
+"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.checkCircularCommand = void 0;
+// `qpq check:circular` — scan every workspace's src for circular imports (the
+// class of bug that TDZ-crashes ESM bundles and silently drops exports under
+// CJS). Cycles fail the command (exit 1) — they are never acceptable; --warn or
+// QPQ_CIRCULAR_DEPS_WARN=1 is a temporary escape hatch that reports without
+// failing while fixing.
+const circularImports_1 = require("../lib/circularImports");
+const discovery_1 = require("../lib/discovery");
+// madge reports every distinct loop path; one tangled module can produce dozens
+// of chains through the same files. Merge chains that share any file into one
+// group so the report shows each tangle once, with its full blast radius.
+const groupCycles = (cycles) => {
+    var _a;
+    const parent = new Map();
+    const find = (file) => {
+        var _a;
+        const found = (_a = parent.get(file)) !== null && _a !== void 0 ? _a : file;
+        if (found === file) {
+            return file;
+        }
+        const rootFile = find(found);
+        parent.set(file, rootFile);
+        return rootFile;
+    };
+    for (const cycle of cycles) {
+        for (const file of cycle) {
+            parent.set(find(file), find(cycle[0]));
+        }
+    }
+    const groups = new Map();
+    for (const cycle of cycles) {
+        const key = find(cycle[0]);
+        const group = (_a = groups.get(key)) !== null && _a !== void 0 ? _a : { files: [], chainCount: 0 };
+        group.chainCount += 1;
+        group.files = [...new Set([...group.files, ...cycle])];
+        groups.set(key, group);
+    }
+    return [...groups.values()];
+};
+const checkCircularCommand = (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    const warnOnly = argv.includes('--warn') || !!process.env.QPQ_CIRCULAR_DEPS_WARN;
+    const cycles = yield (0, circularImports_1.findWorkspaceImportCycles)((0, discovery_1.getRoot)());
+    if (cycles.length === 0) {
+        console.log('check:circular: no circular imports found');
+        return;
+    }
+    const groups = groupCycles(cycles);
+    const colour = warnOnly ? '\x1b[33m' : '\x1b[31m';
+    for (const group of groups) {
+        const chainNote = group.chainCount > 1 ? `, ${group.chainCount} distinct loops` : '';
+        console.warn(`${colour}Circular imports (${group.files.length} files${chainNote}):\n    ${group.files.join('\n    ')}\x1b[0m`);
+    }
+    console.warn(`${colour}check:circular: ${groups.length} circular import group(s) found (${cycles.length} loops)\x1b[0m`);
+    if (!warnOnly) {
+        process.exitCode = 1;
+    }
+});
+exports.checkCircularCommand = checkCircularCommand;
+//# sourceMappingURL=checkCircular.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkCircular.js","sourceRoot":"","sources":["../../../src/commands/checkCircular.ts"],"names":[],"mappings":"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","sourcesContent":["// `qpq check:circular` — scan every workspace's src for circular imports (the\n// class of bug that TDZ-crashes ESM bundles and silently drops exports under\n// CJS). Cycles fail the command (exit 1) — they are never acceptable; --warn or\n// QPQ_CIRCULAR_DEPS_WARN=1 is a temporary escape hatch that reports without\n// failing while fixing.\nimport { findWorkspaceImportCycles, ImportCycle } from '../lib/circularImports';\nimport { getRoot } from '../lib/discovery';\n\ntype CycleGroup = { files: string[]; chainCount: number };\n\n// madge reports every distinct loop path; one tangled module can produce dozens\n// of chains through the same files. Merge chains that share any file into one\n// group so the report shows each tangle once, with its full blast radius.\nconst groupCycles = (cycles: ImportCycle[]): CycleGroup[] => {\n  const parent = new Map<string, string>();\n\n  const find = (file: string): string => {\n    const found = parent.get(file) ?? file;\n    if (found === file) {\n      return file;\n    }\n    const rootFile = find(found);\n    parent.set(file, rootFile);\n    return rootFile;\n  };\n\n  for (const cycle of cycles) {\n    for (const file of cycle) {\n      parent.set(find(file), find(cycle[0]));\n    }\n  }\n\n  const groups = new Map<string, CycleGroup>();\n  for (const cycle of cycles) {\n    const key = find(cycle[0]);\n    const group = groups.get(key) ?? { files: [], chainCount: 0 };\n    group.chainCount += 1;\n    group.files = [...new Set([...group.files, ...cycle])];\n    groups.set(key, group);\n  }\n\n  return [...groups.values()];\n};\n\nexport const checkCircularCommand = async (argv: string[]): Promise<void> => {\n  const warnOnly = argv.includes('--warn') || !!process.env.QPQ_CIRCULAR_DEPS_WARN;\n\n  const cycles = await findWorkspaceImportCycles(getRoot());\n\n  if (cycles.length === 0) {\n    console.log('check:circular: no circular imports found');\n    return;\n  }\n\n  const groups = groupCycles(cycles);\n\n  const colour = warnOnly ? '\\x1b[33m' : '\\x1b[31m';\n  for (const group of groups) {\n    const chainNote = group.chainCount > 1 ? `, ${group.chainCount} distinct loops` : '';\n    console.warn(`${colour}Circular imports (${group.files.length} files${chainNote}):\\n    ${group.files.join('\\n    ')}\\x1b[0m`);\n  }\n  console.warn(`${colour}check:circular: ${groups.length} circular import group(s) found (${cycles.length} loops)\\x1b[0m`);\n\n  if (!warnOnly) {\n    process.exitCode = 1;\n  }\n};\n"]}

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

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

package/lib/commonjs/commands/clearResources.js

@@ -0,0 +1,36 @@
+"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.clearResourcesCommand = void 0;
+// `qpq clear-resources` — interactively EMPTY selected data resources (storage
+// drive buckets, key value store tables) without touching the stacks: the
+// "reset my data" counterpart to `qpq teardown`. Resolves the app +
+// deployment the same way as go/teardown, enumerates the app's owned
+// resources from its live qpq configs, multi-selects what to empty (with a
+// typed confirmation — this deletes stored data), then hands off to the
+// platform driver.
+const clearResourcesPlan_1 = require("../lib/clearResourcesPlan");
+const resolveAppSelection_1 = require("../lib/resolveAppSelection");
+const resolveDeployment_1 = require("../lib/resolveDeployment");
+const platforms_1 = require("../platforms");
+const clearResourcesCommand = (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    const appName = yield (0, resolveAppSelection_1.resolveAppSelection)({ argv, envVar: 'DEPLOY_APP_NAME' });
+    const { deployment } = yield (0, resolveDeployment_1.resolveDeployment)(argv, appName);
+    const driver = (0, platforms_1.getPlatformDriver)(deployment.platform);
+    if (!driver.clearResources) {
+        console.error(`The '${deployment.platform}' platform has no clear-resources strategy.`);
+        process.exit(1);
+    }
+    const plan = yield (0, clearResourcesPlan_1.promptClearResourcesPlan)(appName);
+    yield driver.clearResources(appName, plan);
+});
+exports.clearResourcesCommand = clearResourcesCommand;
+//# sourceMappingURL=clearResources.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clearResources.js","sourceRoot":"","sources":["../../../src/commands/clearResources.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+EAA+E;AAC/E,0EAA0E;AAC1E,oEAAoE;AACpE,qEAAqE;AACrE,2EAA2E;AAC3E,wEAAwE;AACxE,mBAAmB;AACnB,kEAAqE;AACrE,oEAAiE;AACjE,gEAA6D;AAC7D,4CAAiD;AAE1C,MAAM,qBAAqB,GAAG,CAAO,IAAc,EAAiB,EAAE;IAC3E,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAmB,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,qCAAiB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAA,6BAAiB,EAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEtD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,QAAQ,UAAU,CAAC,QAAQ,6CAA6C,CAAC,CAAC;QACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAA,6CAAwB,EAAC,OAAO,CAAC,CAAC;IAErD,MAAM,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAA,CAAC;AAbW,QAAA,qBAAqB,yBAahC","sourcesContent":["// `qpq clear-resources` — interactively EMPTY selected data resources (storage\n// drive buckets, key value store tables) without touching the stacks: the\n// \"reset my data\" counterpart to `qpq teardown`. Resolves the app +\n// deployment the same way as go/teardown, enumerates the app's owned\n// resources from its live qpq configs, multi-selects what to empty (with a\n// typed confirmation — this deletes stored data), then hands off to the\n// platform driver.\nimport { promptClearResourcesPlan } from '../lib/clearResourcesPlan';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { resolveDeployment } from '../lib/resolveDeployment';\nimport { getPlatformDriver } from '../platforms';\n\nexport const clearResourcesCommand = async (argv: string[]): Promise<void> => {\n  const appName = await resolveAppSelection({ argv, envVar: 'DEPLOY_APP_NAME' });\n  const { deployment } = await resolveDeployment(argv, appName);\n  const driver = getPlatformDriver(deployment.platform);\n\n  if (!driver.clearResources) {\n    console.error(`The '${deployment.platform}' platform has no clear-resources strategy.`);\n    process.exit(1);\n  }\n\n  const plan = await promptClearResourcesPlan(appName);\n\n  await driver.clearResources(appName, plan);\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,30 @@
+"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 + deployment (whose entry in
+// apps/<app>/deploy.config.json names the platform), asks the deploy plan, then
+// hands off to the platform driver.
+const deployPrompts_1 = require("../lib/deployPrompts");
+const resolveAppSelection_1 = require("../lib/resolveAppSelection");
+const resolveDeployment_1 = require("../lib/resolveDeployment");
+const platforms_1 = require("../platforms");
+const goCommand = (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const appName = yield (0, resolveAppSelection_1.resolveAppSelection)({ argv, envVar: 'DEPLOY_APP_NAME' });
+    const { deployment } = yield (0, resolveDeployment_1.resolveDeployment)(argv, appName);
+    const driver = (0, platforms_1.getPlatformDriver)(deployment.platform);
+    // Positional args (`qpq go all all`) run prompt-free; otherwise ask.
+    const plan = (_a = (0, deployPrompts_1.buildDeployPlanFromArgs)(appName, argv)) !== null && _a !== void 0 ? _a : (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,+EAA+E;AAC/E,gFAAgF;AAChF,oCAAoC;AACpC,wDAAiF;AACjF,oEAAiE;AACjE,gEAA6D;AAC7D,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,UAAU,EAAE,GAAG,MAAM,IAAA,qCAAiB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAA,6BAAiB,EAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEtD,qEAAqE;IACrE,MAAM,IAAI,GAAG,MAAA,IAAA,uCAAuB,EAAC,OAAO,EAAE,IAAI,CAAC,mCAAI,CAAC,MAAM,IAAA,gCAAgB,EAAC,OAAO,CAAC,CAAC,CAAC;IAEzF,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC,CAAA,CAAC;AATW,QAAA,SAAS,aASpB","sourcesContent":["// `qpq go` — interactive deploy. Resolves the app + deployment (whose entry in\n// apps/<app>/deploy.config.json names the platform), asks the deploy plan, then\n// hands off to the platform driver.\nimport { buildDeployPlanFromArgs, promptDeployPlan } from '../lib/deployPrompts';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { resolveDeployment } from '../lib/resolveDeployment';\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 { deployment } = await resolveDeployment(argv, appName);\n  const driver = getPlatformDriver(deployment.platform);\n\n  // Positional args (`qpq go all all`) run prompt-free; otherwise ask.\n  const plan = buildDeployPlanFromArgs(appName, argv) ?? (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,46 @@
+"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.goDevCommand = void 0;
+// `qpq go:dev` — the whole local dev stack in one process: the API dev server
+// (go:dev:api) plus every views dev server (go:dev:web), so a single ctrl+c
+// tears it all down. A background tsc watcher keeps workspace declaration
+// output fresh for the editor (--no-types to skip it). The app is resolved
+// once here and handed to both sub-commands via QPQ_DEV_APP, the deployment
+// likewise via DEPLOY_NAME, so neither asks again; their output shares the terminal.
+const deploy_rspack_1 = require("@qpqjs/deploy-rspack");
+const discovery_1 = require("../lib/discovery");
+const resolveAppSelection_1 = require("../lib/resolveAppSelection");
+const resolveDeployment_1 = require("../lib/resolveDeployment");
+const typeWatcher_1 = require("../lib/typeWatcher");
+const goDevApi_1 = require("./goDevApi");
+const goDevWeb_1 = require("./goDevWeb");
+const goDevCommand = (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    const appName = yield (0, resolveAppSelection_1.resolveAppSelection)({ argv, envVar: 'QPQ_DEV_APP' });
+    process.env.QPQ_DEV_APP = appName;
+    yield (0, resolveDeployment_1.resolveDeployment)(argv, appName);
+    // Editor/type freshness only: the rspack builds below bundle workspace
+    // source directly, so the dev loop itself never waits on tsc.
+    const typeWatcher = argv.includes('--no-types') ? null : (0, typeWatcher_1.startTypeWatcher)((0, discovery_1.getRoot)());
+    if (typeWatcher) {
+        process.on('exit', () => typeWatcher.kill());
+    }
+    // Kicks off the rspack watch and returns; the API server keeps running in
+    // the background of this process.
+    yield (0, goDevApi_1.goDevApiCommand)(argv);
+    if ((0, deploy_rspack_1.getAllViews)((0, discovery_1.getRoot)(), appName).length === 0) {
+        console.log('No views projects found. Running the API dev server only.');
+        return;
+    }
+    yield (0, goDevWeb_1.goDevWebCommand)(argv, { hideStartedStatus: true });
+});
+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":";;;;;;;;;;;;AAAA,8EAA8E;AAC9E,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,4EAA4E;AAC5E,qFAAqF;AACrF,wDAAmD;AAEnD,gDAA2C;AAC3C,oEAAiE;AACjE,gEAA6D;AAC7D,oDAAsD;AACtD,yCAA6C;AAC7C,yCAA6C;AAEtC,MAAM,YAAY,GAAG,CAAO,IAAc,EAAiB,EAAE;IAClE,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAmB,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;IAClC,MAAM,IAAA,qCAAiB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEvC,uEAAuE;IACvE,8DAA8D;IAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,8BAAgB,EAAC,IAAA,mBAAO,GAAE,CAAC,CAAC;IACrF,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,0EAA0E;IAC1E,kCAAkC;IAClC,MAAM,IAAA,0BAAe,EAAC,IAAI,CAAC,CAAC;IAE5B,IAAI,IAAA,2BAAW,EAAC,IAAA,mBAAO,GAAE,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO;IACT,CAAC;IAED,MAAM,IAAA,0BAAe,EAAC,IAAI,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC,CAAA,CAAC;AAtBW,QAAA,YAAY,gBAsBvB","sourcesContent":["// `qpq go:dev` — the whole local dev stack in one process: the API dev server\n// (go:dev:api) plus every views dev server (go:dev:web), so a single ctrl+c\n// tears it all down. A background tsc watcher keeps workspace declaration\n// output fresh for the editor (--no-types to skip it). The app is resolved\n// once here and handed to both sub-commands via QPQ_DEV_APP, the deployment\n// likewise via DEPLOY_NAME, so neither asks again; their output shares the terminal.\nimport { getAllViews } from '@qpqjs/deploy-rspack';\n\nimport { getRoot } from '../lib/discovery';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { resolveDeployment } from '../lib/resolveDeployment';\nimport { startTypeWatcher } from '../lib/typeWatcher';\nimport { goDevApiCommand } from './goDevApi';\nimport { goDevWebCommand } from './goDevWeb';\n\nexport const goDevCommand = async (argv: string[]): Promise<void> => {\n  const appName = await resolveAppSelection({ argv, envVar: 'QPQ_DEV_APP' });\n  process.env.QPQ_DEV_APP = appName;\n  await resolveDeployment(argv, appName);\n\n  // Editor/type freshness only: the rspack builds below bundle workspace\n  // source directly, so the dev loop itself never waits on tsc.\n  const typeWatcher = argv.includes('--no-types') ? null : startTypeWatcher(getRoot());\n  if (typeWatcher) {\n    process.on('exit', () => typeWatcher.kill());\n  }\n\n  // Kicks off the rspack watch and returns; the API server keeps running in\n  // the background of this process.\n  await goDevApiCommand(argv);\n\n  if (getAllViews(getRoot(), appName).length === 0) {\n    console.log('No views projects found. Running the API dev server only.');\n    return;\n  }\n\n  await goDevWebCommand(argv, { hideStartedStatus: true });\n};\n"]}

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

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

package/lib/commonjs/commands/goDevApi.js

@@ -0,0 +1,158 @@
+"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.goDevApiCommand = void 0;
+// `qpq go:dev:api` — 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.
+//
+// A restart is not instant: the server drains in-flight work and checkpoints
+// its stores on the way out (typically tens of ms, 5s worst case), and this
+// command waits for that before starting the replacement.
+//
+// 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:api` restart.
+const deploy_rspack_1 = require("@qpqjs/deploy-rspack");
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const core_1 = require("@rspack/core");
+const args_1 = require("../lib/args");
+const devServerEntry_1 = require("../lib/devServerEntry");
+const devServerPorts_1 = require("../lib/devServerPorts");
+const discovery_1 = require("../lib/discovery");
+const keepOtherDevServersFlag_1 = require("../lib/keepOtherDevServersFlag");
+const killChildWithEscalation_1 = require("../lib/killChildWithEscalation");
+const killStaleListeners_1 = require("../lib/killStaleListeners");
+const resolveAppSelection_1 = require("../lib/resolveAppSelection");
+const resolveDeployment_1 = require("../lib/resolveDeployment");
+// 8080/8888 are set in the generated entry; 3001 is the @qpqjs/dev-server
+// file-storage (secure URL) default port.
+const getDevServerPortList = (appName) => Object.values((0, devServerPorts_1.readDevServerPorts)(appName));
+const DEV_SERVER_BUNDLE_PATH = path_1.default.join('dist', 'qpq', 'dev-server', 'main.js');
+const goDevApiCommand = (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;
+    yield (0, resolveDeployment_1.resolveDeployment)(argv, appName);
+    console.log(`Dev server for app [${appName}]`);
+    // The sweep matches on a RELATIVE bundle path, so every checkout's dev
+    // server looks like ours and a sibling worktree gets taken down with it.
+    // Opting out spares it, at the cost of this one not starting: the ports are
+    // the same either way, so what you get instead is EADDRINUSE. Report who
+    // holds them, or that failure says nothing about the cause.
+    if ((0, args_1.hasArgFlag)(argv, keepOtherDevServersFlag_1.KEEP_OTHER_DEV_SERVERS_FLAG)) {
+        console.log(`${keepOtherDevServersFlag_1.KEEP_OTHER_DEV_SERVERS_FLAG}: leaving other dev servers alone.`);
+        (0, killStaleListeners_1.reportPortHolders)(getDevServerPortList(appName));
+    }
+    else {
+        // Catches a lingering watcher from a previous run even if its spawned
+        // child already exited (see killOtherQpqDevProcesses) — then the usual
+        // port-based sweep for anything else still bound to our ports.
+        (0, killStaleListeners_1.killOtherQpqDevProcesses)(root);
+        (0, killStaleListeners_1.killStaleListeners)(getDevServerPortList(appName), (command) => command.includes(DEV_SERVER_BUNDLE_PATH));
+    }
+    const qpqConfigs = (0, deploy_rspack_1.getAppServiceQpqConfigs)(root, appName);
+    const entry = (0, devServerEntry_1.writeDevServerEntry)(root, appName);
+    const userScriptChildEntry = (0, devServerEntry_1.writeUserScriptChildEntry)(root);
+    const rspackConfig = (0, deploy_rspack_1.getDevServerRspackConfig)({ root, entry, userScriptChildEntry, 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();
+        });
+        // Not a bare kill: the server drains in-flight work before it exits, so it
+        // needs asking properly and then a hard backstop if it wedges. Waiting for
+        // the exit is what keeps the ports free for the replacement.
+        void (0, killChildWithEscalation_1.killChildWithEscalation)(child);
+    };
+    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();
+    });
+    // Wait for the server to finish draining before tearing the watcher down and
+    // exiting: closing the compiler first would exit the parent while the child
+    // is still writing, which is the race this whole path exists to close.
+    //
+    // SIGTERM as well as SIGINT, and it is load-bearing rather than symmetry for
+    // its own sake. This process is a WRAPPER: the dev server that handles
+    // signals and drains its work is the child it spawned. Without a handler
+    // here, SIGTERM (what `docker stop` sends, and what any script stopping this
+    // programmatically sends) kills the wrapper outright on the default
+    // disposition, the child never gets asked to stop, and every guarantee the
+    // dev server's shutdown sequence makes is bypassed. go:dev:web already
+    // handles both.
+    let shuttingDown = false;
+    const handleShutdownSignal = () => __awaiter(void 0, void 0, void 0, function* () {
+        if (shuttingDown) {
+            return;
+        }
+        shuttingDown = true;
+        restartQueued = true; // suppress the crash log / rebuild-restart on our own kill
+        if (child) {
+            yield (0, killChildWithEscalation_1.killChildWithEscalation)(child);
+        }
+        compiler.close(() => process.exit(0));
+    });
+    process.on('SIGINT', () => {
+        void handleShutdownSignal();
+    });
+    process.on('SIGTERM', () => {
+        void handleShutdownSignal();
+    });
+});
+exports.goDevApiCommand = goDevApiCommand;
+//# sourceMappingURL=goDevApi.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goDevApi.js","sourceRoot":"","sources":["../../../src/commands/goDevApi.ts"],"names":[],"mappings":"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","sourcesContent":["// `qpq go:dev:api` — boots the QPQ local dev server. Resolves the app,\n// generates the dev-server entry, builds the rspack config, then runs rspack\n// in watch mode, restarting the server process on every successful rebuild.\n//\n// A restart is not instant: the server drains in-flight work and checkpoints\n// its stores on the way out (typically tens of ms, 5s worst case), and this\n// command waits for that before starting the replacement.\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:api` restart.\nimport { getAppServiceQpqConfigs, getDevServerRspackConfig } from '@qpqjs/deploy-rspack';\n\nimport { ChildProcess, spawn } from 'child_process';\nimport fs from 'fs';\nimport path from 'path';\nimport { rspack } from '@rspack/core';\n\nimport { hasArgFlag } from '../lib/args';\nimport { writeDevServerEntry, writeUserScriptChildEntry } from '../lib/devServerEntry';\nimport { readDevServerPorts } from '../lib/devServerPorts';\nimport { getRoot } from '../lib/discovery';\nimport { KEEP_OTHER_DEV_SERVERS_FLAG } from '../lib/keepOtherDevServersFlag';\nimport { killChildWithEscalation } from '../lib/killChildWithEscalation';\nimport { killOtherQpqDevProcesses, killStaleListeners, reportPortHolders } from '../lib/killStaleListeners';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { resolveDeployment } from '../lib/resolveDeployment';\n\n// 8080/8888 are set in the generated entry; 3001 is the @qpqjs/dev-server\n// file-storage (secure URL) default port.\nconst getDevServerPortList = (appName: string): number[] => Object.values(readDevServerPorts(appName));\nconst DEV_SERVER_BUNDLE_PATH = path.join('dist', 'qpq', 'dev-server', 'main.js');\n\nexport const goDevApiCommand = 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  await resolveDeployment(argv, appName);\n  console.log(`Dev server for app [${appName}]`);\n\n  // The sweep matches on a RELATIVE bundle path, so every checkout's dev\n  // server looks like ours and a sibling worktree gets taken down with it.\n  // Opting out spares it, at the cost of this one not starting: the ports are\n  // the same either way, so what you get instead is EADDRINUSE. Report who\n  // holds them, or that failure says nothing about the cause.\n  if (hasArgFlag(argv, KEEP_OTHER_DEV_SERVERS_FLAG)) {\n    console.log(`${KEEP_OTHER_DEV_SERVERS_FLAG}: leaving other dev servers alone.`);\n    reportPortHolders(getDevServerPortList(appName));\n  } else {\n    // Catches a lingering watcher from a previous run even if its spawned\n    // child already exited (see killOtherQpqDevProcesses) — then the usual\n    // port-based sweep for anything else still bound to our ports.\n    killOtherQpqDevProcesses(root);\n    killStaleListeners(getDevServerPortList(appName), (command) => command.includes(DEV_SERVER_BUNDLE_PATH));\n  }\n\n  const qpqConfigs = getAppServiceQpqConfigs(root, appName);\n  const entry = writeDevServerEntry(root, appName);\n  const userScriptChildEntry = writeUserScriptChildEntry(root);\n  const rspackConfig = getDevServerRspackConfig({ root, entry, userScriptChildEntry, 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\n    // Not a bare kill: the server drains in-flight work before it exits, so it\n    // needs asking properly and then a hard backstop if it wedges. Waiting for\n    // the exit is what keeps the ports free for the replacement.\n    void killChildWithEscalation(child);\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  // Wait for the server to finish draining before tearing the watcher down and\n  // exiting: closing the compiler first would exit the parent while the child\n  // is still writing, which is the race this whole path exists to close.\n  //\n  // SIGTERM as well as SIGINT, and it is load-bearing rather than symmetry for\n  // its own sake. This process is a WRAPPER: the dev server that handles\n  // signals and drains its work is the child it spawned. Without a handler\n  // here, SIGTERM (what `docker stop` sends, and what any script stopping this\n  // programmatically sends) kills the wrapper outright on the default\n  // disposition, the child never gets asked to stop, and every guarantee the\n  // dev server's shutdown sequence makes is bypassed. go:dev:web already\n  // handles both.\n  let shuttingDown = false;\n\n  const handleShutdownSignal = async (): Promise<void> => {\n    if (shuttingDown) {\n      return;\n    }\n    shuttingDown = true;\n\n    restartQueued = true; // suppress the crash log / rebuild-restart on our own kill\n\n    if (child) {\n      await killChildWithEscalation(child);\n    }\n\n    compiler.close(() => process.exit(0));\n  };\n\n  process.on('SIGINT', () => {\n    void handleShutdownSignal();\n  });\n\n  process.on('SIGTERM', () => {\n    void handleShutdownSignal();\n  });\n};\n"]}

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

@@ -0,0 +1,4 @@
+export type GoDevWebOptions = {
+    hideStartedStatus?: boolean;
+};
+export declare const goDevWebCommand: (argv: string[], options?: GoDevWebOptions) => Promise<void>;

package/lib/commonjs/commands/goDevWeb.js

@@ -0,0 +1,144 @@
+"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 deploy_rspack_1 = require("@qpqjs/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 args_2 = require("../lib/args");
+const devServerPorts_1 = require("../lib/devServerPorts");
+const discovery_1 = require("../lib/discovery");
+const keepOtherDevServersFlag_1 = require("../lib/keepOtherDevServersFlag");
+const killStaleListeners_1 = require("../lib/killStaleListeners");
+const resolveAppSelection_1 = require("../lib/resolveAppSelection");
+const resolveDeployment_1 = require("../lib/resolveDeployment");
+const webAddressingEnv_1 = require("../lib/webAddressingEnv");
+const goDevWebCommand = (argv_1, ...args_3) => __awaiter(void 0, [argv_1, ...args_3], void 0, function* (argv, options = {}) {
+    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';
+    yield (0, resolveDeployment_1.resolveDeployment)(argv, appName);
+    // Local pages address the api dev server and each other by port on localhost.
+    const devServerPorts = (0, devServerPorts_1.readDevServerPorts)(appName);
+    (0, webAddressingEnv_1.setWebAddressingEnv)((0, deploy_rspack_1.getAppServiceQpqConfigs)(root, appName), {
+        api: devServerPorts.api,
+        webSocket: devServerPorts.webSocket,
+        mapHostPort: (port) => port,
+    });
+    const only = (_a = (0, args_1.getArgValue)(argv, '--only')) === null || _a === void 0 ? void 0 : _a.split(',').map((s) => s.trim());
+    let views = (0, 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);
+    }
+    // See goDevApi for why this is opt-out rather than always-on.
+    if ((0, args_2.hasArgFlag)(argv, keepOtherDevServersFlag_1.KEEP_OTHER_DEV_SERVERS_FLAG)) {
+        (0, killStaleListeners_1.reportPortHolders)(views.map((v) => v.port));
+    }
+    else {
+        (0, killStaleListeners_1.killStaleListeners)(views.map((v) => v.port), killStaleListeners_1.isQpqCliCommand);
+    }
+    // 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, 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;
+        }
+        // markStarted is the only consumer of the ready signal, so there is
+        // nothing to poll for when the status is hidden.
+        if (!options.hideStartedStatus)
+            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, getAppServiceQpqConfigs, getViewsRspackConfig } from '@qpqjs/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 { hasArgFlag } from '../lib/args';\nimport { readDevServerPorts } from '../lib/devServerPorts';\nimport { getRoot } from '../lib/discovery';\nimport { KEEP_OTHER_DEV_SERVERS_FLAG } from '../lib/keepOtherDevServersFlag';\nimport { isQpqCliCommand, killStaleListeners, reportPortHolders } from '../lib/killStaleListeners';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { resolveDeployment } from '../lib/resolveDeployment';\nimport { setWebAddressingEnv } from '../lib/webAddressingEnv';\n\nexport type GoDevWebOptions = {\n  // The in-place \"(started)\" chip rewrite assumes this command owns the\n  // terminal; when stdout is shared with the API dev server (combined\n  // `qpq go:dev`) the cursor math breaks. The plain-line fallback is just a\n  // wall of \"  auth started\" noise interleaved with the API output, so drop\n  // the ready status altogether there.\n  hideStartedStatus?: boolean;\n};\n\nexport const goDevWebCommand = async (argv: string[], options: GoDevWebOptions = {}): 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  await resolveDeployment(argv, appName);\n\n  // Local pages address the api dev server and each other by port on localhost.\n  const devServerPorts = readDevServerPorts(appName);\n  setWebAddressingEnv(getAppServiceQpqConfigs(root, appName), {\n    api: devServerPorts.api,\n    webSocket: devServerPorts.webSocket,\n    mapHostPort: (port) => port,\n  });\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  // See goDevApi for why this is opt-out rather than always-on.\n  if (hasArgFlag(argv, KEEP_OTHER_DEV_SERVERS_FLAG)) {\n    reportPortHolders(views.map((v) => v.port));\n  } else {\n    killStaleListeners(\n      views.map((v) => v.port),\n      isQpqCliCommand,\n    );\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    // markStarted is the only consumer of the ready signal, so there is\n    // nothing to poll for when the status is hidden.\n    if (!options.hideStartedStatus) 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>;