@qpqjs/cli 0.0.0-stage → 0.2.1

package/lib/esm/cli/commandRegistry.js

@@ -0,0 +1,161 @@
+// Single source of truth for every qpq command: its name, the one-line
+// summary (shared by `qpq help` and the interactive menu) and a runner.
+//
+// Command modules are required lazily inside each runner so a simple
+// `qpq help` doesn't pay for the whole toolchain, and so ts-node can be
+// registered before any command module (or anything it requires) loads.
+import { promptText } from '../lib/prompts';
+// `qpq hooks` needs a hook name; when launched from the menu there is no
+// argv to pass it in, so ask.
+const promptHookName = async () => [
+    await promptText('Hook name (runs qpq:<name>, or plain <name>, in every app/package that defines it):'),
+];
+/* eslint-disable @typescript-eslint/no-require-imports */
+export const cliCommands = [
+    {
+        name: 'go',
+        usageArgs: '[svc] [stack]',
+        summary: 'Deploy services (interactive; platform from the deployment in deploy.config.json).',
+        usageExtra: [
+            'Pass positional args to skip prompts, e.g. qpq go all all — svc is',
+            "'all' | comma-list | account | domain | bootstrap; stack is all|inf|api|web|views.",
+            "A full 'all all' (or 'all api') deploy also publishes federated backends.",
+        ],
+        run: (a) => require('../commands/go').goCommand(a),
+    },
+    {
+        name: 'setup',
+        summary: 'Take a cloud environment from empty to deployed: checked steps, run in order (interactive)',
+        usageExtra: ["--check prints each step's status; --yes runs them all; --only <ids> runs a subset."],
+        run: (a) => require('../commands/setup').setupCommand(a),
+    },
+    {
+        name: 'go:docker',
+        usageArgs: '[svc] [stack]',
+        summary: 'Same as go (incl. positional args), but deploys in parallel via docker',
+        usageExtra: [
+            '--build-only builds and saves everything a deploy needs (no docker needed);',
+            '--from-build deploys the chosen stack from that saved build without rebuilding',
+            '(an api deploy also publishes the federated remote). One CI job per service and phase.',
+        ],
+        run: (a) => require('../commands/goDocker').goDockerCommand(a),
+    },
+    {
+        name: 'go:dev',
+        summary: 'Run the full local dev stack (api + web) in one process',
+        run: (a) => require('../commands/goDev').goDevCommand(a),
+    },
+    {
+        name: 'go:dev:api',
+        summary: 'Run the local API dev server (hot reload)',
+        run: (a) => require('../commands/goDevApi').goDevApiCommand(a),
+    },
+    {
+        name: 'go:dev:web',
+        summary: 'Run every views microfrontend dev server',
+        run: (a) => require('../commands/goDevWeb').goDevWebCommand(a),
+    },
+    {
+        name: 'migrate',
+        usageArgs: '[app]',
+        summary: 'Run pending migrations against the LOCAL dev store, once, then exit.',
+        usageExtra: [
+            'Deployed, migrations run on a stack update; nothing local ever deploys, so',
+            'this is how you exercise one before shipping it. Records what it runs, so a',
+            'second call is a no-op.',
+        ],
+        run: (a) => require('../commands/migrate').migrateCommand(a),
+    },
+    {
+        name: 'teardown',
+        summary: 'Destroy web/api/inf stacks for selected services (interactive)',
+        run: (a) => require('../commands/teardown').teardownCommand(a),
+    },
+    {
+        name: 'clear-resources',
+        summary: 'Empty selected buckets/tables (data only, stacks untouched; interactive)',
+        run: (a) => require('../commands/clearResources').clearResourcesCommand(a),
+    },
+    {
+        name: 'synth',
+        usageArgs: '[service]',
+        summary: 'Synth QPQ configs to dist/apps/<app>/infrastructure',
+        run: (a) => require('../commands/synth').synthCommand(a),
+    },
+    {
+        name: 'prep',
+        summary: 'Regenerate apps/<app>/tsconfig.federated.json',
+        run: (a) => require('../commands/prep').prepCommand(a),
+    },
+    {
+        name: 'publish',
+        summary: 'Build + upload + deploy federated remotes',
+        run: (a) => require('../commands/publish').publishCommand(a),
+    },
+    {
+        name: 'publish:build',
+        summary: 'Build federated remotes locally',
+        run: (a) => require('../commands/publish').publishBuildCommand(a),
+    },
+    {
+        name: 'publish:upload',
+        summary: 'Upload built version dirs (nothing goes live)',
+        run: (a) => require('../commands/publish').publishUploadCommand(a),
+    },
+    {
+        name: 'publish:deploy',
+        summary: 'Flip manifests to the uploaded versions',
+        run: (a) => require('../commands/publish').publishDeployCommand(a),
+    },
+    {
+        name: 'script:new',
+        usageArgs: '<dir>',
+        summary: 'Write a user-script template project (src/main.ts exporting functions) into a new directory',
+        run: (a) => require('../commands/scriptNew').scriptNewCommand(a),
+    },
+    {
+        name: 'script:build',
+        usageArgs: '<dir> [--out <dir>] [--source-map]',
+        summary: 'Bundle a user-script project into one main.js that askUserScriptExecute loads from a drive (--source-map embeds the map in it)',
+        run: (a) => require('../commands/scriptBuild').scriptBuildCommand(a),
+    },
+    {
+        name: 'script:builder-layer',
+        usageArgs: '[--arch arm64|x86_64]',
+        summary: 'Install rspack for the lambda architecture (default arm64) into the user-script builder layer, for services that build user scripts',
+        run: (a) => require('../commands/scriptBuilderLayer').scriptBuilderLayerCommand(a),
+    },
+    {
+        name: 'check:circular',
+        summary: 'Scan workspace sources for circular imports (fails on cycles; --warn to only report)',
+        run: (a) => require('../commands/checkCircular').checkCircularCommand(a),
+    },
+    {
+        name: 'hooks',
+        usageArgs: '<name>',
+        summary: 'Run qpq:<name> (or plain <name>) in every app/package that defines it (dependency ordered, parallel; --jobs=N)',
+        promptArgs: promptHookName,
+        run: (a) => require('../commands/hooks').hooksCommand(a),
+    },
+];
+/* eslint-enable @typescript-eslint/no-require-imports */
+// Width of the "name [args]" column in the usage text.
+const usageColumnWidth = 17;
+export const buildUsage = () => {
+    const commandLines = cliCommands.flatMap((command) => {
+        const nameAndArgs = command.usageArgs ? `${command.name} ${command.usageArgs}` : command.name;
+        const extraLines = (command.usageExtra ?? []).map((line) => `  ${''.padEnd(usageColumnWidth)}${line}`);
+        return [`  ${nameAndArgs.padEnd(usageColumnWidth)}${command.summary}`, ...extraLines];
+    });
+    return [
+        'qpq — build, dev and deploy orchestration for QPQ apps',
+        '',
+        'Usage: qpq <command> [--app <name>] [--deployment <name>]',
+        '       qpq            (no command opens an interactive menu)',
+        '',
+        'Commands:',
+        ...commandLines,
+        '',
+    ].join('\n');
+};
+//# sourceMappingURL=commandRegistry.js.map

package/lib/esm/cli/commandRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandRegistry.js","sourceRoot":"","sources":["../../../src/cli/commandRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["// Single source of truth for every qpq command: its name, the one-line\n// summary (shared by `qpq help` and the interactive menu) and a runner.\n//\n// Command modules are required lazily inside each runner so a simple\n// `qpq help` doesn't pay for the whole toolchain, and so ts-node can be\n// registered before any command module (or anything it requires) loads.\nimport { promptText } from '../lib/prompts';\n\nexport type CliCommand = {\n  name: string;\n  // Argument hint shown in the usage text, e.g. '[svc] [stack]'.\n  usageArgs?: string;\n  summary: string;\n  // Extra usage-only detail lines, indented under the summary.\n  usageExtra?: string[];\n  // Menu-only: commands that need a positional argument (which the menu has\n  // no argv to carry) gather it here before running.\n  promptArgs?: () => Promise<string[]>;\n  run: (commandArgv: string[]) => Promise<void>;\n};\n\n// `qpq hooks` needs a hook name; when launched from the menu there is no\n// argv to pass it in, so ask.\nconst promptHookName = async (): Promise<string[]> => [\n  await promptText('Hook name (runs qpq:<name>, or plain <name>, in every app/package that defines it):'),\n];\n\n/* eslint-disable @typescript-eslint/no-require-imports */\nexport const cliCommands: CliCommand[] = [\n  {\n    name: 'go',\n    usageArgs: '[svc] [stack]',\n    summary: 'Deploy services (interactive; platform from the deployment in deploy.config.json).',\n    usageExtra: [\n      'Pass positional args to skip prompts, e.g. qpq go all all — svc is',\n      \"'all' | comma-list | account | domain | bootstrap; stack is all|inf|api|web|views.\",\n      \"A full 'all all' (or 'all api') deploy also publishes federated backends.\",\n    ],\n    run: (a) => require('../commands/go').goCommand(a),\n  },\n  {\n    name: 'setup',\n    summary: 'Take a cloud environment from empty to deployed: checked steps, run in order (interactive)',\n    usageExtra: [\"--check prints each step's status; --yes runs them all; --only <ids> runs a subset.\"],\n    run: (a) => require('../commands/setup').setupCommand(a),\n  },\n  {\n    name: 'go:docker',\n    usageArgs: '[svc] [stack]',\n    summary: 'Same as go (incl. positional args), but deploys in parallel via docker',\n    usageExtra: [\n      '--build-only builds and saves everything a deploy needs (no docker needed);',\n      '--from-build deploys the chosen stack from that saved build without rebuilding',\n      '(an api deploy also publishes the federated remote). One CI job per service and phase.',\n    ],\n    run: (a) => require('../commands/goDocker').goDockerCommand(a),\n  },\n  {\n    name: 'go:dev',\n    summary: 'Run the full local dev stack (api + web) in one process',\n    run: (a) => require('../commands/goDev').goDevCommand(a),\n  },\n  {\n    name: 'go:dev:api',\n    summary: 'Run the local API dev server (hot reload)',\n    run: (a) => require('../commands/goDevApi').goDevApiCommand(a),\n  },\n  {\n    name: 'go:dev:web',\n    summary: 'Run every views microfrontend dev server',\n    run: (a) => require('../commands/goDevWeb').goDevWebCommand(a),\n  },\n  {\n    name: 'migrate',\n    usageArgs: '[app]',\n    summary: 'Run pending migrations against the LOCAL dev store, once, then exit.',\n    usageExtra: [\n      'Deployed, migrations run on a stack update; nothing local ever deploys, so',\n      'this is how you exercise one before shipping it. Records what it runs, so a',\n      'second call is a no-op.',\n    ],\n    run: (a) => require('../commands/migrate').migrateCommand(a),\n  },\n  {\n    name: 'teardown',\n    summary: 'Destroy web/api/inf stacks for selected services (interactive)',\n    run: (a) => require('../commands/teardown').teardownCommand(a),\n  },\n  {\n    name: 'clear-resources',\n    summary: 'Empty selected buckets/tables (data only, stacks untouched; interactive)',\n    run: (a) => require('../commands/clearResources').clearResourcesCommand(a),\n  },\n  {\n    name: 'synth',\n    usageArgs: '[service]',\n    summary: 'Synth QPQ configs to dist/apps/<app>/infrastructure',\n    run: (a) => require('../commands/synth').synthCommand(a),\n  },\n  {\n    name: 'prep',\n    summary: 'Regenerate apps/<app>/tsconfig.federated.json',\n    run: (a) => require('../commands/prep').prepCommand(a),\n  },\n  {\n    name: 'publish',\n    summary: 'Build + upload + deploy federated remotes',\n    run: (a) => require('../commands/publish').publishCommand(a),\n  },\n  {\n    name: 'publish:build',\n    summary: 'Build federated remotes locally',\n    run: (a) => require('../commands/publish').publishBuildCommand(a),\n  },\n  {\n    name: 'publish:upload',\n    summary: 'Upload built version dirs (nothing goes live)',\n    run: (a) => require('../commands/publish').publishUploadCommand(a),\n  },\n  {\n    name: 'publish:deploy',\n    summary: 'Flip manifests to the uploaded versions',\n    run: (a) => require('../commands/publish').publishDeployCommand(a),\n  },\n  {\n    name: 'script:new',\n    usageArgs: '<dir>',\n    summary: 'Write a user-script template project (src/main.ts exporting functions) into a new directory',\n    run: (a) => require('../commands/scriptNew').scriptNewCommand(a),\n  },\n  {\n    name: 'script:build',\n    usageArgs: '<dir> [--out <dir>] [--source-map]',\n    summary: 'Bundle a user-script project into one main.js that askUserScriptExecute loads from a drive (--source-map embeds the map in it)',\n    run: (a) => require('../commands/scriptBuild').scriptBuildCommand(a),\n  },\n  {\n    name: 'script:builder-layer',\n    usageArgs: '[--arch arm64|x86_64]',\n    summary: 'Install rspack for the lambda architecture (default arm64) into the user-script builder layer, for services that build user scripts',\n    run: (a) => require('../commands/scriptBuilderLayer').scriptBuilderLayerCommand(a),\n  },\n  {\n    name: 'check:circular',\n    summary: 'Scan workspace sources for circular imports (fails on cycles; --warn to only report)',\n    run: (a) => require('../commands/checkCircular').checkCircularCommand(a),\n  },\n  {\n    name: 'hooks',\n    usageArgs: '<name>',\n    summary: 'Run qpq:<name> (or plain <name>) in every app/package that defines it (dependency ordered, parallel; --jobs=N)',\n    promptArgs: promptHookName,\n    run: (a) => require('../commands/hooks').hooksCommand(a),\n  },\n];\n/* eslint-enable @typescript-eslint/no-require-imports */\n\n// Width of the \"name [args]\" column in the usage text.\nconst usageColumnWidth = 17;\n\nexport const buildUsage = (): string => {\n  const commandLines = cliCommands.flatMap((command) => {\n    const nameAndArgs = command.usageArgs ? `${command.name} ${command.usageArgs}` : command.name;\n    const extraLines = (command.usageExtra ?? []).map((line) => `  ${''.padEnd(usageColumnWidth)}${line}`);\n    return [`  ${nameAndArgs.padEnd(usageColumnWidth)}${command.summary}`, ...extraLines];\n  });\n\n  return [\n    'qpq — build, dev and deploy orchestration for QPQ apps',\n    '',\n    'Usage: qpq <command> [--app <name>] [--deployment <name>]',\n    '       qpq            (no command opens an interactive menu)',\n    '',\n    'Commands:',\n    ...commandLines,\n    '',\n  ].join('\\n');\n};\n"]}

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

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

package/lib/esm/cli/index.js

@@ -0,0 +1,2 @@
+export * from './runCli';
+//# sourceMappingURL=index.js.map

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

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

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

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

package/lib/esm/cli/runCli.js

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

package/lib/esm/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/esm/commands/checkCircular.d.ts

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

package/lib/esm/commands/checkCircular.js

@@ -0,0 +1,55 @@
+// `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.
+import { findWorkspaceImportCycles } from '../lib/circularImports';
+import { getRoot } from '../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) => {
+    const parent = new Map();
+    const find = (file) => {
+        const found = parent.get(file) ?? 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 = groups.get(key) ?? { files: [], chainCount: 0 };
+        group.chainCount += 1;
+        group.files = [...new Set([...group.files, ...cycle])];
+        groups.set(key, group);
+    }
+    return [...groups.values()];
+};
+export const checkCircularCommand = async (argv) => {
+    const warnOnly = argv.includes('--warn') || !!process.env.QPQ_CIRCULAR_DEPS_WARN;
+    const cycles = await findWorkspaceImportCycles(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;
+    }
+};
+//# sourceMappingURL=checkCircular.js.map

package/lib/esm/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/esm/commands/clearResources.d.ts

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

package/lib/esm/commands/clearResources.js

@@ -0,0 +1,23 @@
+// `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.
+import { promptClearResourcesPlan } from '../lib/clearResourcesPlan';
+import { resolveAppSelection } from '../lib/resolveAppSelection';
+import { resolveDeployment } from '../lib/resolveDeployment';
+import { getPlatformDriver } from '../platforms';
+export const clearResourcesCommand = async (argv) => {
+    const appName = await resolveAppSelection({ argv, envVar: 'DEPLOY_APP_NAME' });
+    const { deployment } = await resolveDeployment(argv, appName);
+    const driver = getPlatformDriver(deployment.platform);
+    if (!driver.clearResources) {
+        console.error(`The '${deployment.platform}' platform has no clear-resources strategy.`);
+        process.exit(1);
+    }
+    const plan = await promptClearResourcesPlan(appName);
+    await driver.clearResources(appName, plan);
+};
+//# sourceMappingURL=clearResources.js.map

package/lib/esm/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,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IAC3E,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,iBAAiB,CAAC,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,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAErD,MAAM,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC","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/esm/commands/go.d.ts

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

package/lib/esm/commands/go.js

@@ -0,0 +1,16 @@
+// `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.
+import { buildDeployPlanFromArgs, promptDeployPlan } from '../lib/deployPrompts';
+import { resolveAppSelection } from '../lib/resolveAppSelection';
+import { resolveDeployment } from '../lib/resolveDeployment';
+import { getPlatformDriver } from '../platforms';
+export const goCommand = async (argv) => {
+    const appName = await resolveAppSelection({ argv, envVar: 'DEPLOY_APP_NAME' });
+    const { deployment } = await resolveDeployment(argv, appName);
+    const driver = getPlatformDriver(deployment.platform);
+    // Positional args (`qpq go all all`) run prompt-free; otherwise ask.
+    const plan = buildDeployPlanFromArgs(appName, argv) ?? (await promptDeployPlan(appName));
+    await driver.go(appName, plan);
+};
+//# sourceMappingURL=go.js.map

package/lib/esm/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,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IAC/D,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEtD,qEAAqE;IACrE,MAAM,IAAI,GAAG,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzF,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC,CAAC","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/esm/commands/goDev.d.ts

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

package/lib/esm/commands/goDev.js

@@ -0,0 +1,33 @@
+// `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.
+import { getAllViews } from '@qpqjs/deploy-rspack';
+import { getRoot } from '../lib/discovery';
+import { resolveAppSelection } from '../lib/resolveAppSelection';
+import { resolveDeployment } from '../lib/resolveDeployment';
+import { startTypeWatcher } from '../lib/typeWatcher';
+import { goDevApiCommand } from './goDevApi';
+import { goDevWebCommand } from './goDevWeb';
+export const goDevCommand = async (argv) => {
+    const appName = await resolveAppSelection({ argv, envVar: 'QPQ_DEV_APP' });
+    process.env.QPQ_DEV_APP = appName;
+    await 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 : startTypeWatcher(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.
+    await goDevApiCommand(argv);
+    if (getAllViews(getRoot(), appName).length === 0) {
+        console.log('No views projects found. Running the API dev server only.');
+        return;
+    }
+    await goDevWebCommand(argv, { hideStartedStatus: true });
+};
+//# sourceMappingURL=goDev.js.map

package/lib/esm/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,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IAClE,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;IAClC,MAAM,iBAAiB,CAAC,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,gBAAgB,CAAC,OAAO,EAAE,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,eAAe,CAAC,IAAI,CAAC,CAAC;IAE5B,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO;IACT,CAAC;IAED,MAAM,eAAe,CAAC,IAAI,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC,CAAC","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/esm/commands/goDevApi.d.ts

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

package/lib/esm/commands/goDevApi.js

@@ -0,0 +1,142 @@
+// `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.
+import { getAppServiceQpqConfigs, getDevServerRspackConfig } from '@qpqjs/deploy-rspack';
+import { spawn } from 'child_process';
+import path from 'path';
+import { rspack } from '@rspack/core';
+import { hasArgFlag } from '../lib/args';
+import { writeDevServerEntry, writeUserScriptChildEntry } from '../lib/devServerEntry';
+import { readDevServerPorts } from '../lib/devServerPorts';
+import { getRoot } from '../lib/discovery';
+import { KEEP_OTHER_DEV_SERVERS_FLAG } from '../lib/keepOtherDevServersFlag';
+import { killChildWithEscalation } from '../lib/killChildWithEscalation';
+import { killOtherQpqDevProcesses, killStaleListeners, reportPortHolders } from '../lib/killStaleListeners';
+import { resolveAppSelection } from '../lib/resolveAppSelection';
+import { resolveDeployment } from '../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(readDevServerPorts(appName));
+const DEV_SERVER_BUNDLE_PATH = path.join('dist', 'qpq', 'dev-server', 'main.js');
+export const goDevApiCommand = async (argv) => {
+    const root = getRoot();
+    const appName = await resolveAppSelection({ argv, envVar: 'QPQ_DEV_APP' });
+    process.env.QPQ_DEV_APP = appName;
+    await 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 (hasArgFlag(argv, KEEP_OTHER_DEV_SERVERS_FLAG)) {
+        console.log(`${KEEP_OTHER_DEV_SERVERS_FLAG}: leaving other dev servers alone.`);
+        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.
+        killOtherQpqDevProcesses(root);
+        killStaleListeners(getDevServerPortList(appName), (command) => command.includes(DEV_SERVER_BUNDLE_PATH));
+    }
+    const qpqConfigs = getAppServiceQpqConfigs(root, appName);
+    const entry = writeDevServerEntry(root, appName);
+    const userScriptChildEntry = writeUserScriptChildEntry(root);
+    const rspackConfig = getDevServerRspackConfig({ root, entry, userScriptChildEntry, qpqConfigs });
+    const bundlePath = path.join(root, DEV_SERVER_BUNDLE_PATH);
+    const env = { ...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 = 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 killChildWithEscalation(child);
+    };
+    console.log('Bundling dev server (watch mode)...');
+    let lastHash;
+    const compiler = rspack(rspackConfig);
+    compiler.watch({ aggregateTimeout: 200 }, (err, stats) => {
+        if (err) {
+            console.error(err);
+            return;
+        }
+        if (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?.hash === lastHash && child) {
+            return;
+        }
+        lastHash = 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 = async () => {
+        if (shuttingDown) {
+            return;
+        }
+        shuttingDown = true;
+        restartQueued = true; // suppress the crash log / rebuild-restart on our own kill
+        if (child) {
+            await killChildWithEscalation(child);
+        }
+        compiler.close(() => process.exit(0));
+    };
+    process.on('SIGINT', () => {
+        void handleShutdownSignal();
+    });
+    process.on('SIGTERM', () => {
+        void handleShutdownSignal();
+    });
+};
+//# sourceMappingURL=goDevApi.js.map