quidproquo-cli 0.1.6 → 0.1.8

package/docker/dev-server/Dockerfile

@@ -1,13 +1,11 @@
 # Runtime image for `qpq go` on the docker platform: the QPQ dev server
-# (a full local platform emulation — sqlite KVS, file storage, queues,
+# (a full local platform emulation — JSON-file KVS, file storage, queues,
 # websockets) hosting every service of the app, plus the pre-built views.
 #
-# The server bundle externalizes bare packages (native modules like sqlite3
-# must load from a real install), so runtime deps are npm-installed in the
-# image, then the locally-built quidproquo packages are overlaid so the image
-# runs the same qpq code the bundle was built against.
-# trixie (glibc 2.41): sqlite3's prebuilt binaries are built against glibc
-# 2.38, which bookworm-based node:24-slim (glibc 2.36) can't load.
+# The server bundle externalizes bare packages (native modules must load from
+# a real install), so runtime deps are npm-installed in the image, then the
+# locally-built quidproquo packages are overlaid so the image runs the same
+# qpq code the bundle was built against.
 FROM node:24-trixie-slim
 
 WORKDIR /app
@@ -41,8 +39,8 @@ ENV NODE_ENV=production
 # api / websocket / file-storage secure urls
 EXPOSE 8080 8888 3001
 
-# Emulated platform state (sqlite + file storage) lives here — mount a volume
-# to persist it across container restarts.
+# Emulated platform state (KVS JSON files + file storage) lives here — mount
+# a volume to persist it across container restarts.
 VOLUME /app/.qpq-runtime
 
 CMD ["node", "server/main.js"]

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

@@ -0,0 +1,2 @@
+import { CliCommand } from './commandRegistry';
+export declare const promptCommandFromMenu: (commands: CliCommand[]) => Promise<CliCommand>;

package/lib/commonjs/cli/commandMenu.js

@@ -0,0 +1,81 @@
+"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.promptCommandFromMenu = void 0;
+// Interactive drill-down for a bare `qpq`: the colon-separated command names
+// form a tree (go, go:dev, go:dev:api, ...). Each menu level renders its
+// options as the full command line they resolve to (`qpq go:dev:api`) with
+// the command's summary alongside, groups shown as `qpq go:??`, and drilling
+// continues until the user picks a runnable leaf. Rows are deliberately left
+// unstyled so inquirer's active-item highlight colours the whole row.
+const prompts_1 = require("../lib/prompts");
+const lastSegment = (name) => name.split(':').slice(-1)[0];
+// The first path segment of `name` below `prefix` ('' means the tree root).
+const childSegment = (name, prefix) => name.slice(prefix ? prefix.length + 1 : 0).split(':')[0];
+const runRow = (command) => ({
+    label: `qpq ${command.name}`,
+    summary: command.summary,
+    value: { kind: 'run', command },
+});
+const buildRows = (commands, prefix) => {
+    var _a;
+    const exact = prefix ? commands.find((command) => command.name === prefix) : undefined;
+    const deeper = commands.filter((command) => command.name !== prefix && (!prefix || command.name.startsWith(`${prefix}:`)));
+    const segments = [...new Set(deeper.map((command) => childSegment(command.name, prefix)))];
+    const groupRows = [];
+    const leafRows = [];
+    for (const segment of segments) {
+        const segmentPrefix = prefix ? `${prefix}:${segment}` : segment;
+        const subtree = deeper.filter((command) => command.name === segmentPrefix || command.name.startsWith(`${segmentPrefix}:`));
+        if (subtree.length === 1 && subtree[0].name === segmentPrefix) {
+            leafRows.push(runRow(subtree[0]));
+        }
+        else {
+            // A group's summary is its own runnable command's summary when it has
+            // one, otherwise a listing of what's inside.
+            const groupSummary = (_a = subtree.find((command) => command.name === segmentPrefix)) === null || _a === void 0 ? void 0 : _a.summary;
+            groupRows.push({
+                label: `qpq ${segmentPrefix}:??`,
+                summary: groupSummary !== null && groupSummary !== void 0 ? groupSummary : subtree.map((command) => lastSegment(command.name)).join(', '),
+                value: { kind: 'drill', prefix: segmentPrefix },
+            });
+        }
+    }
+    // The current prefix's own command (run what this menu is named after)
+    // leads, then groups, then the remaining runnable commands.
+    const rows = [...(exact ? [runRow(exact)] : []), ...groupRows, ...leafRows];
+    if (prefix) {
+        rows.push({ label: '(back)', value: { kind: 'back' } });
+    }
+    return rows;
+};
+// Align the rows into two columns: the command line, then its summary.
+const toChoices = (rows) => {
+    const columnWidth = Math.max(...rows.map((row) => row.label.length)) + 2;
+    return rows.map((row) => ({
+        name: row.summary ? `${row.label.padEnd(columnWidth)}${row.summary}` : row.label,
+        value: row.value,
+        short: row.label,
+    }));
+};
+// Walk the menu until a runnable command is picked.
+const promptCommandFromMenu = (commands) => __awaiter(void 0, void 0, void 0, function* () {
+    let prefix = '';
+    for (;;) {
+        const picked = yield (0, prompts_1.promptSelectDetailed)('Run:', toChoices(buildRows(commands, prefix)));
+        if (picked.kind === 'run') {
+            return picked.command;
+        }
+        prefix = picked.kind === 'drill' ? picked.prefix : prefix.split(':').slice(0, -1).join(':');
+    }
+});
+exports.promptCommandFromMenu = promptCommandFromMenu;
+//# sourceMappingURL=commandMenu.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commandMenu.js","sourceRoot":"","sources":["../../../src/cli/commandMenu.ts"],"names":[],"mappings":"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","sourcesContent":["// Interactive drill-down for a bare `qpq`: the colon-separated command names\n// form a tree (go, go:dev, go:dev:api, ...). Each menu level renders its\n// options as the full command line they resolve to (`qpq go:dev:api`) with\n// the command's summary alongside, groups shown as `qpq go:??`, and drilling\n// continues until the user picks a runnable leaf. Rows are deliberately left\n// unstyled so inquirer's active-item highlight colours the whole row.\nimport { promptSelectDetailed } from '../lib/prompts';\nimport { CliCommand } from './commandRegistry';\n\ntype MenuChoice = { kind: 'run'; command: CliCommand } | { kind: 'drill'; prefix: string } | { kind: 'back' };\n\ntype MenuRow = { label: string; summary?: string; value: MenuChoice };\n\nconst lastSegment = (name: string): string => name.split(':').slice(-1)[0];\n\n// The first path segment of `name` below `prefix` ('' means the tree root).\nconst childSegment = (name: string, prefix: string): string => name.slice(prefix ? prefix.length + 1 : 0).split(':')[0];\n\nconst runRow = (command: CliCommand): MenuRow => ({\n  label: `qpq ${command.name}`,\n  summary: command.summary,\n  value: { kind: 'run', command },\n});\n\nconst buildRows = (commands: CliCommand[], prefix: string): MenuRow[] => {\n  const exact = prefix ? commands.find((command) => command.name === prefix) : undefined;\n  const deeper = commands.filter((command) => command.name !== prefix && (!prefix || command.name.startsWith(`${prefix}:`)));\n  const segments = [...new Set(deeper.map((command) => childSegment(command.name, prefix)))];\n\n  const groupRows: MenuRow[] = [];\n  const leafRows: MenuRow[] = [];\n\n  for (const segment of segments) {\n    const segmentPrefix = prefix ? `${prefix}:${segment}` : segment;\n    const subtree = deeper.filter((command) => command.name === segmentPrefix || command.name.startsWith(`${segmentPrefix}:`));\n\n    if (subtree.length === 1 && subtree[0].name === segmentPrefix) {\n      leafRows.push(runRow(subtree[0]));\n    } else {\n      // A group's summary is its own runnable command's summary when it has\n      // one, otherwise a listing of what's inside.\n      const groupSummary = subtree.find((command) => command.name === segmentPrefix)?.summary;\n      groupRows.push({\n        label: `qpq ${segmentPrefix}:??`,\n        summary: groupSummary ?? subtree.map((command) => lastSegment(command.name)).join(', '),\n        value: { kind: 'drill', prefix: segmentPrefix },\n      });\n    }\n  }\n\n  // The current prefix's own command (run what this menu is named after)\n  // leads, then groups, then the remaining runnable commands.\n  const rows = [...(exact ? [runRow(exact)] : []), ...groupRows, ...leafRows];\n\n  if (prefix) {\n    rows.push({ label: '(back)', value: { kind: 'back' } });\n  }\n\n  return rows;\n};\n\n// Align the rows into two columns: the command line, then its summary.\nconst toChoices = (rows: MenuRow[]): { name: string; value: MenuChoice; short?: string }[] => {\n  const columnWidth = Math.max(...rows.map((row) => row.label.length)) + 2;\n\n  return rows.map((row) => ({\n    name: row.summary ? `${row.label.padEnd(columnWidth)}${row.summary}` : row.label,\n    value: row.value,\n    short: row.label,\n  }));\n};\n\n// Walk the menu until a runnable command is picked.\nexport const promptCommandFromMenu = async (commands: CliCommand[]): Promise<CliCommand> => {\n  let prefix = '';\n\n  for (;;) {\n    const picked = await promptSelectDetailed<MenuChoice>('Run:', toChoices(buildRows(commands, prefix)));\n\n    if (picked.kind === 'run') {\n      return picked.command;\n    }\n\n    prefix = picked.kind === 'drill' ? picked.prefix : prefix.split(':').slice(0, -1).join(':');\n  }\n};\n"]}

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

@@ -0,0 +1,10 @@
+export type CliCommand = {
+    name: string;
+    usageArgs?: string;
+    summary: string;
+    usageExtra?: string[];
+    promptArgs?: () => Promise<string[]>;
+    run: (commandArgv: string[]) => Promise<void>;
+};
+export declare const cliCommands: CliCommand[];
+export declare const buildUsage: () => string;

package/lib/commonjs/cli/commandRegistry.js

@@ -0,0 +1,131 @@
+"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.buildUsage = exports.cliCommands = void 0;
+// 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.
+const prompts_1 = require("../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 = () => __awaiter(void 0, void 0, void 0, function* () {
+    return [
+        yield (0, prompts_1.promptText)('Hook name (runs qpq:<name>, or plain <name>, in every app/package that defines it):'),
+    ];
+});
+/* eslint-disable @typescript-eslint/no-require-imports */
+exports.cliCommands = [
+    {
+        name: 'go',
+        usageArgs: '[svc] [stack]',
+        summary: 'Deploy services (interactive; platform from deploy.config.json, default aws).',
+        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: 'go:docker',
+        summary: 'Same as go (incl. positional args), but deploys in parallel via docker',
+        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: '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: '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;
+const buildUsage = () => {
+    const commandLines = exports.cliCommands.flatMap((command) => {
+        var _a;
+        const nameAndArgs = command.usageArgs ? `${command.name} ${command.usageArgs}` : command.name;
+        const extraLines = ((_a = command.usageExtra) !== null && _a !== void 0 ? _a : []).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>] [--env <name>] [--platform <name>]',
+        '       qpq            (no command opens an interactive menu)',
+        '',
+        'Commands:',
+        ...commandLines,
+        '',
+    ].join('\n');
+};
+exports.buildUsage = buildUsage;
+//# sourceMappingURL=commandRegistry.js.map

package/lib/commonjs/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 deploy.config.json, default aws).',\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: 'go:docker',\n    summary: 'Same as go (incl. positional args), but deploys in parallel via docker',\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: '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: '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>] [--env <name>] [--platform <name>]',\n    '       qpq            (no command opens an interactive menu)',\n    '',\n    'Commands:',\n    ...commandLines,\n    '',\n  ].join('\\n');\n};\n"]}

package/lib/commonjs/cli/runCli.js

@@ -10,24 +10,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runCli = void 0;
-const usage = `qpq — build, dev and deploy orchestration for QPQ apps
-
-Usage: qpq <command> [--app <name>] [--env <name>] [--platform <name>]
-
-Commands:
-  go               Deploy services (interactive; platform from deploy.config.json, default aws)
-  go:docker        Same as go, but deploys in parallel via docker
-  go:dev           Run the local dev server (hot reload)
-  go:dev:web       Run every views microfrontend dev server
-  teardown         Destroy web/api/inf stacks for selected services (interactive)
-  synth [service]  Synth QPQ configs to dist/apps/<app>/infrastructure
-  prep             Regenerate apps/<app>/tsconfig.federated.json
-  publish          Build + upload + deploy federated remotes
-  publish:build    Build federated remotes locally
-  publish:upload   Upload built version dirs (nothing goes live)
-  publish:deploy   Flip manifests to the uploaded versions
-  hooks <name>     Run qpq:<name> in every app that defines it
-`;
+const commandMenu_1 = require("./commandMenu");
+const commandRegistry_1 = require("./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.
@@ -41,44 +25,60 @@ 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 = () => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        const command = yield (0, commandMenu_1.promptCommandFromMenu)(commandRegistry_1.cliCommands);
+        const commandArgv = command.promptArgs ? yield command.promptArgs() : [];
+        return { command, commandArgv };
+    }
+    catch (error) {
+        if (isPromptExit(error)) {
+            return null;
+        }
+        throw error;
+    }
+});
 const runCli = (argv) => __awaiter(void 0, void 0, void 0, function* () {
-    const [command, ...commandArgv] = argv;
-    if (!command || command === 'help' || command === '--help') {
-        console.log(usage);
+    const [commandName, ...argvRest] = argv;
+    if (commandName === 'help' || commandName === '--help') {
+        console.log((0, commandRegistry_1.buildUsage)());
         return;
     }
-    registerTsNode();
-    // Commands are required lazily so a simple `qpq help` doesn't pay for the
-    // whole toolchain, and so ts-node is registered before any command module
-    // (or anything it requires) loads.
-    /* eslint-disable @typescript-eslint/no-require-imports */
-    const commands = {
-        go: (a) => require('../commands/go').goCommand(a),
-        'go:docker': (a) => require('../commands/goDocker').goDockerCommand(a),
-        'go:dev': (a) => require('../commands/goDev').goDevCommand(a),
-        'go:dev:web': (a) => require('../commands/goDevWeb').goDevWebCommand(a),
-        teardown: (a) => require('../commands/teardown').teardownCommand(a),
-        synth: (a) => require('../commands/synth').synthCommand(a),
-        prep: (a) => require('../commands/prep').prepCommand(a),
-        publish: (a) => require('../commands/publish').publishCommand(a),
-        'publish:build': (a) => require('../commands/publish').publishBuildCommand(a),
-        'publish:upload': (a) => require('../commands/publish').publishUploadCommand(a),
-        'publish:deploy': (a) => require('../commands/publish').publishDeployCommand(a),
-        hooks: (a) => require('../commands/hooks').hooksCommand(a),
-    };
-    /* eslint-enable @typescript-eslint/no-require-imports */
-    const run = commands[command];
-    if (!run) {
-        console.error(`Unknown command: ${command}`);
-        console.log(usage);
-        process.exitCode = 1;
-        return;
+    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((0, commandRegistry_1.buildUsage)());
+            return;
+        }
+        const resolved = yield resolveCommandInteractively();
+        if (!resolved) {
+            return;
+        }
+        ({ command, commandArgv } = resolved);
     }
+    else {
+        command = commandRegistry_1.cliCommands.find((c) => c.name === commandName);
+        commandArgv = argvRest;
+        if (!command) {
+            console.error(`Unknown command: ${commandName}`);
+            console.log((0, commandRegistry_1.buildUsage)());
+            process.exitCode = 1;
+            return;
+        }
+    }
+    registerTsNode();
     try {
-        yield run(commandArgv);
+        yield command.run(commandArgv);
     }
     catch (error) {
-        console.error(`qpq ${command} failed:`, error);
+        console.error(`qpq ${command.name} failed:`, error);
         process.exitCode = 1;
     }
 });

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

@@ -1 +1 @@
-{"version":3,"file":"runCli.js","sourceRoot":"","sources":["../../../src/cli/runCli.ts"],"names":[],"mappings":"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","sourcesContent":["const usage = `qpq — build, dev and deploy orchestration for QPQ apps\n\nUsage: qpq <command> [--app <name>] [--env <name>] [--platform <name>]\n\nCommands:\n  go               Deploy services (interactive; platform from deploy.config.json, default aws)\n  go:docker        Same as go, but deploys in parallel via docker\n  go:dev           Run the local dev server (hot reload)\n  go:dev:web       Run every views microfrontend dev server\n  teardown         Destroy web/api/inf stacks for selected services (interactive)\n  synth [service]  Synth QPQ configs to dist/apps/<app>/infrastructure\n  prep             Regenerate apps/<app>/tsconfig.federated.json\n  publish          Build + upload + deploy federated remotes\n  publish:build    Build federated remotes locally\n  publish:upload   Upload built version dirs (nothing goes live)\n  publish:deploy   Flip manifests to the uploaded versions\n  hooks <name>     Run qpq:<name> in every app that defines it\n`;\n\n// Service infrastructure.ts files (and app config fragments) are TypeScript —\n// register ts-node's transpile-only require hook so the CLI can require them\n// directly, using the consumer root's tsconfig.json ts-node settings.\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\nexport const runCli = async (argv: string[]): Promise<void> => {\n  const [command, ...commandArgv] = argv;\n\n  if (!command || command === 'help' || command === '--help') {\n    console.log(usage);\n    return;\n  }\n\n  registerTsNode();\n\n  // Commands are required lazily so a simple `qpq help` doesn't pay for the\n  // whole toolchain, and so ts-node is registered before any command module\n  // (or anything it requires) loads.\n  /* eslint-disable @typescript-eslint/no-require-imports */\n  const commands: Record<string, (commandArgv: string[]) => Promise<void>> = {\n    go: (a) => require('../commands/go').goCommand(a),\n    'go:docker': (a) => require('../commands/goDocker').goDockerCommand(a),\n    'go:dev': (a) => require('../commands/goDev').goDevCommand(a),\n    'go:dev:web': (a) => require('../commands/goDevWeb').goDevWebCommand(a),\n    teardown: (a) => require('../commands/teardown').teardownCommand(a),\n    synth: (a) => require('../commands/synth').synthCommand(a),\n    prep: (a) => require('../commands/prep').prepCommand(a),\n    publish: (a) => require('../commands/publish').publishCommand(a),\n    'publish:build': (a) => require('../commands/publish').publishBuildCommand(a),\n    'publish:upload': (a) => require('../commands/publish').publishUploadCommand(a),\n    'publish:deploy': (a) => require('../commands/publish').publishDeployCommand(a),\n    hooks: (a) => require('../commands/hooks').hooksCommand(a),\n  };\n  /* eslint-enable @typescript-eslint/no-require-imports */\n\n  const run = commands[command];\n\n  if (!run) {\n    console.error(`Unknown command: ${command}`);\n    console.log(usage);\n    process.exitCode = 1;\n    return;\n  }\n\n  try {\n    await run(commandArgv);\n  } catch (error) {\n    console.error(`qpq ${command} failed:`, error);\n    process.exitCode = 1;\n  }\n};\n"]}
+{"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/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 +
+// environment 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 deployEnv_1 = require("../lib/deployEnv");
+const resolveAppSelection_1 = require("../lib/resolveAppSelection");
+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 { platform } = yield (0, deployEnv_1.resolveDeployEnvironment)(argv, appName);
+    const driver = (0, platforms_1.getPlatformDriver)(platform);
+    if (!driver.clearResources) {
+        console.error(`The '${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,sEAAsE;AACtE,2EAA2E;AAC3E,wEAAwE;AACxE,mBAAmB;AACnB,kEAAqE;AACrE,gDAA4D;AAC5D,oEAAiE;AACjE,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,QAAQ,EAAE,GAAG,MAAM,IAAA,oCAAwB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,IAAA,6BAAiB,EAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,QAAQ,QAAQ,6CAA6C,CAAC,CAAC;QAC7E,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// environment 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 { resolveDeployEnvironment } from '../lib/deployEnv';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\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 { platform } = await resolveDeployEnvironment(argv, appName);\n  const driver = getPlatformDriver(platform);\n\n  if (!driver.clearResources) {\n    console.error(`The '${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.js

@@ -18,10 +18,12 @@ const deployPrompts_1 = require("../lib/deployPrompts");
 const resolveAppSelection_1 = require("../lib/resolveAppSelection");
 const platforms_1 = require("../platforms");
 const goCommand = (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
     const appName = yield (0, resolveAppSelection_1.resolveAppSelection)({ argv, envVar: 'DEPLOY_APP_NAME' });
     const { platform } = yield (0, deployEnv_1.resolveDeployEnvironment)(argv, appName);
     const driver = (0, platforms_1.getPlatformDriver)(platform);
-    const plan = yield (0, deployPrompts_1.promptDeployPlan)(appName);
+    // 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;

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

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