@aopslabs/aops 0.2.0 → 0.3.0

package/dist/commands/community-setup.js

@@ -6,15 +6,7 @@ import { runCommunitySetupServerEnv, runCommunitySetupServerEnvConnectionTest, }
 import { createSetupOfficialCatalogProviderV1 } from '../lib/setup-official-catalog-bridge.js';
 import { createSetupAgentAssetsProvider } from '../lib/setup-agent-assets-bridge.js';
 import { buildAopsInstallAgentPrompt, loadAopsInstallSkill, } from '../lib/setup-install-guide.js';
-import { promptSelect } from '../utils/prompts.js';
-const COMMUNITY_SETUP_HOME = `AOPS Setup — choose how to begin
-  Install interactively    aops setup init
-  Set up with an AI agent  aops setup ai
-  Inspect readiness        aops setup init --yes --json
-  Agent install skill      aops setup guide
-  Configure PostgreSQL     aops setup server-env
-Help: aops setup --help
-`;
+import { applyDockerServerSetup, inspectDockerServerSetupPreview, inspectDockerServerSetupStatus, runDockerServerLifecycle, } from '../lib/setup-docker-server.js';
 export function runCommunitySetupGuide(options = {}) {
     if (options.json && options.path)
         throw new Error('setup_guide_selector_conflict:choose_--json_or_--path');
@@ -61,7 +53,7 @@ export function runCommunitySetupAi(options = {}) {
     }
     banner('AOPS Setup with AI');
     logInfo('Copy the prompt below to Codex, Claude, or another terminal AI agent.');
-    logInfo('Enter database secrets only in AOPS masked prompts; never paste them into chat.');
+    logInfo('Pass database secrets only through documented environment variables or private files; never paste them into chat.');
     process.stdout.write(`\n--- copy from here ---\n${prompt}\n--- end prompt ---\n`);
 }
 export async function runCommunitySetupInit(options = {}) {
@@ -71,49 +63,66 @@ export async function runCommunitySetupInit(options = {}) {
         officialCatalog: createSetupOfficialCatalogProviderV1(),
     });
 }
-export async function runCommunitySetupMenu() {
-    if (!process.stdin.isTTY || !process.stdout.isTTY) {
-        process.stdout.write(COMMUNITY_SETUP_HOME);
-        return;
-    }
-    banner('AOPS Setup');
-    logInfo('Install here, or hand a safe setup prompt to any terminal AI agent.');
-    logInfo('Enter database secrets only in masked AOPS prompts; never paste them into chat.');
-    while (true) {
-        const action = await promptSelect({
-            message: 'How do you want to continue?',
-            type: process.env.AOPS_CLI_MENU_STYLE?.toLowerCase() === 'rawlist' ? 'rawlist' : 'select',
-            pageSize: 6,
-            choices: [
-                { name: 'Install AOPS interactively', value: 'install' },
-                { name: 'Set up with an AI agent', value: 'ai' },
-                { name: 'Inspect setup readiness', value: 'inspect' },
-                { name: 'Configure PostgreSQL connection', value: 'server-env' },
-                { name: 'Show packaged agent installation skill', value: 'guide' },
-                { name: 'Exit', value: 'exit' },
-            ],
-        });
-        if (action === 'exit')
+export async function runCommunityDockerSetupPreview(options = {}) {
+    const selectedActions = [options.apply, options.status, Boolean(options.lifecycle)].filter(Boolean).length;
+    if (selectedActions > 1)
+        throw new Error('setup_docker_action_conflict:choose_one_action');
+    if (options.status) {
+        const result = await inspectDockerServerSetupStatus(options);
+        if (options.json) {
+            process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
             return;
-        if (action === 'ai') {
-            runCommunitySetupAi();
-            continue;
         }
-        if (action === 'inspect') {
-            await runCommunitySetupInit({ yes: true });
-            continue;
+        banner('AOPS Docker Settings');
+        logInfo(`AOPS: ${result.components.server.state} · Database: ${result.components.database.state}`);
+        logInfo(`Address: ${result.origin}`);
+        logInfo(`Settings: ${result.environmentPath}`);
+        if (result.nextAction)
+            logInfo(result.nextAction);
+        return;
+    }
+    if (options.lifecycle) {
+        const actions = ['start', 'stop', 'restart', 'open-cockpit', 'repair'];
+        if (!actions.includes(options.lifecycle)) {
+            throw new Error('setup_docker_lifecycle_invalid:use_start_stop_restart_open-cockpit_or_repair');
         }
-        if (action === 'server-env') {
-            await runCommunitySetupServerEnv({});
-            continue;
+        if (!options.yes)
+            throw new Error('setup_docker_lifecycle_confirmation_required:use_--yes');
+        const result = await runDockerServerLifecycle(options.lifecycle, options);
+        if (options.json) {
+            process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+            return;
         }
-        if (action === 'guide') {
-            runCommunitySetupGuide();
-            continue;
+        banner('AOPS Docker Settings');
+        logInfo(`${result.action} completed · ${result.origin}`);
+        return;
+    }
+    if (options.apply) {
+        if (!options.yes)
+            throw new Error('setup_docker_apply_confirmation_required:use_--yes');
+        const result = await applyDockerServerSetup(options);
+        if (options.json) {
+            process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+            return;
         }
-        await runCommunitySetupInit({ skipBanner: true });
+        banner('AOPS Docker Setup');
+        logInfo(`Installed · ${result.origin}`);
+        logInfo('PostgreSQL migrations and AOPS Server health completed.');
         return;
     }
+    const preview = await inspectDockerServerSetupPreview(options);
+    if (options.json) {
+        process.stdout.write(`${JSON.stringify(preview, null, 2)}\n`);
+        return;
+    }
+    banner('AOPS Docker Setup');
+    logInfo(`${preview.method.title}: ${preview.method.description}`);
+    logInfo(`Image: ${preview.generated.image}`);
+    logInfo(`Address: ${preview.generated.origin}`);
+    for (const check of preview.checks) {
+        logInfo(`${check.status === 'pass' ? 'OK' : 'ACTION'} · ${check.summary}`);
+    }
+    logInfo('This preview made no changes. Guided Apply will be enabled in the next setup slice.');
 }
 function addSetupInitOptions(command) {
     return command
@@ -142,7 +151,7 @@ function addSetupInitOptions(command) {
         .option('--catalog-release <path>', 'Explicit verified-release override (normally resolved from the Community install)')
         .option('--catalog-idempotency-key <key>', 'Explicit official catalog reconcile replay key')
         .option('--plan-id <sha256>', 'Apply only if the current mutation-free installer plan still has this exact identity')
-        .option('--apply', 'Apply the selected path in non-interactive or scripted use (interactive setup applies directly)')
+        .option('--apply', 'Apply the selected explicit path')
         .option('--resume', 'Resume the same idempotent setup orchestration')
         .option('--timeout-ms <ms>', 'Read-only host probe timeout', (value) => Number.parseInt(String(value), 10))
         .option('--yes', 'Non-interactive; report missing selections as actions')
@@ -156,8 +165,8 @@ Agent bootstrap:
   aops setup ai             Print a copy-ready prompt for any terminal AI agent
   aops setup guide          Print the packaged agent-readable installation skill
   aops setup guide --json   Return the same guide in a structured envelope
-`)
-        .action(async () => runCommunitySetupMenu());
+`);
+    command.action(() => command.outputHelp());
     command.addCommand(makeOfficialCatalogSetupCommand());
     command.command('ai')
         .description('Print a safe, copy-ready AOPS installation prompt for a terminal AI agent')
@@ -165,7 +174,8 @@ Agent bootstrap:
         .addHelpText('after', `
 This read-only handoff works with Codex, Claude, or another terminal agent. The
 prompt directs the agent to the packaged install skill and keeps database
-credentials in AOPS masked terminal prompts rather than chat or command argv.
+credentials in documented environment variables or private files rather than
+chat or command argv.
 `)
         .action((options) => runCommunitySetupAi(options));
     command.command('guide')
@@ -178,8 +188,28 @@ It explains PostgreSQL ownership, setup paths, explicit Gateway activation,
 server health verification, and Cockpit handoff. It performs no setup itself.
 `)
         .action((options) => runCommunitySetupGuide(options));
+    command.command('docker')
+        .description('Preview or apply the recommended Docker-hosted AOPS Server setup')
+        .option('--instance <name>', 'Local AOPS instance name (default: default)')
+        .option('--image <reference>', 'Exact local AOPS Server image reference')
+        .option('--pull-image <reference>', 'Image source used only when the exact local image is missing')
+        .option('--port <port>', 'Loopback AOPS Server port (default: 5900)', (value) => Number.parseInt(String(value), 10))
+        .option('--status', 'Read the installed Docker AOPS and PostgreSQL state without changing it')
+        .option('--lifecycle <action>', 'Settings action: start | stop | restart | open-cockpit | repair')
+        .option('--apply', 'Create the reviewed Docker resources and wait for migrations and health')
+        .option('--yes', 'Required with --apply in non-interactive use')
+        .option('--json', 'Output one redacted preview or Apply result')
+        .addHelpText('after', `
+This first guided-setup slice only inspects Docker, the exact server-only image,
+loopback port, resource names, and private environment-file location. It does
+not create files, containers, networks, or volumes, and it does not accept an
+apply flag unless both --apply and --yes are provided. Apply creates only the
+displayed namespaced resources and rolls back resources created by a failed
+first attempt.
+`)
+        .action((options) => runCommunityDockerSetupPreview(options));
     addSetupInitOptions(command.command('init')
-        .description('Interactively install AOPS, or inspect/apply an explicit path for automation'))
+        .description('Inspect or apply an explicit AOPS installation path'))
         .addHelpText('after', `
 Examples:
   aops setup ai
@@ -199,28 +229,21 @@ Path 1 uses an existing PostgreSQL connection from \`~/.aops/aops.server.env\` b
 the selected env file. \`--postgres-config\` remains an explicit override.
 Path 2 uses the same npm server and standard port, while AOPS creates a
 loopback-only PostgreSQL 17 container on a collision-free Docker-assigned port.
-Its password is generated securely by default; the interactive wizard also
-allows a masked, confirmed custom password without placing it in shell history.
+Its password is generated securely by default.
 All PostgreSQL paths plan, apply when needed, and verify database migrations
-before the server is reported ready. Interactive terminals show animated
-progress and apply directly after required private inputs are collected; there
-is no redundant continue confirmation. \`--json\` remains free
-of spinner output. Path 1 asks for the masked PostgreSQL URL first, then tests
-the connection with TLS \`require\` by default. A TLS-policy prompt is shown only
-when that encrypted connection cannot be established. Choose \`verify-full\`
-when a trusted CA file is available, or explicitly choose \`disable\` when
-accepting an unencrypted PostgreSQL connection. Long-running setup reports its
-runtime, connection, migration-plan, migration-apply, server-start, and health
-stages without exposing database credentials.
+before the server is reported ready. \`--json\` remains machine-clean. Path 1
+reads the private PostgreSQL URL from the saved env or \`AOPS_PG_URL\`, then
+tests TLS \`require\` by default. Pass \`--postgres-tls verify-full\` when a
+trusted CA file is available, or explicitly pass \`disable\` when accepting an
+unencrypted PostgreSQL connection.
 Local Community setup is always \`trusted-local\` with \`loopback\`. Paid or
 multi-user identity uses a separate HTTPS \`remote-session\` target through path
 4; it is not installed into the Community server. The legacy
 \`authv2-jwt-session\` target name is accepted only as a one-release alias.
-Path 3 detects PostgreSQL on this computer, securely asks for an existing
-administrator role/password, and creates a new dedicated AOPS role and database
+Path 3 detects PostgreSQL on this computer and creates a new dedicated AOPS role and database
 before running the same migration verification. Administrator credentials are
-never stored. For non-interactive path 3, provide the password through the
-private \`AOPS_LOCAL_POSTGRES_ADMIN_PASSWORD\` environment variable; use
+never stored. Provide the password through the private
+\`AOPS_LOCAL_POSTGRES_ADMIN_PASSWORD\` environment variable; use
 \`--local-postgres-admin-no-password\` only when local PostgreSQL trust auth is
 already configured. When PostgreSQL is missing or stopped, readiness returns
 platform-appropriate Windows, macOS, or Linux installation/start guidance.
@@ -234,7 +257,7 @@ Source and npm setup import only the inert signed official catalog bundled with
 the verified Community release by default.
   The optional application image reuses the exact npm CLI/server lifecycle
   inside a container; it remains a distribution surface rather than another
-  interactive setup path.
+  setup path.
 The CLI first resolves the canonical signed release bundled with the official
 npm package, selected source, or installed Community runtime;
 \`--catalog-release\` is only an explicit override.

package/dist/commands/init.js

@@ -2,9 +2,8 @@ import fs from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import path from 'node:path';
 import { Command } from 'commander';
-import { banner, logError, logInfo, logSuccess, logWarn } from '@aopslabs/xf-cli-ui';
+import { logError, logInfo, logSuccess, logWarn } from '@aopslabs/xf-cli-ui';
 import { findWorkspaceRoot } from '../utils/workspace-root.js';
-import { promptConfirm, promptInput } from '../utils/prompts.js';
 import { buildAopsRepoConfig } from '../utils/repo-config.js';
 function nonEmpty(value) {
     if (typeof value !== 'string')
@@ -50,26 +49,15 @@ export async function runInit(options = {}) {
     const startDir = process.cwd();
     const rootDir = options.root ? path.resolve(startDir, options.root) : findWorkspaceRoot(startDir);
     const configPath = path.join(rootDir, '.aops', 'aops.config.json');
-    const interactive = options.yes !== true && options.json !== true;
     const existingConfig = existsSync(configPath) ? await readJsonFile(configPath) : null;
-    if (interactive)
-        banner('AOPS Community Init');
     if (existsSync(configPath) && options.force !== true) {
-        const overwrite = interactive
-            ? await promptConfirm({ message: `${configPath} exists. Overwrite?`, default: false })
-            : false;
-        if (!overwrite) {
-            logError('aops.config.json already exists. Use --force to overwrite.');
-            process.exitCode = 1;
-            return;
-        }
+        logError('aops.config.json already exists. Use --force to overwrite.');
+        process.exitCode = 1;
+        return;
     }
     const existingRepoName = nonEmpty(existingConfig?.repo?.name);
     let repoName = nonEmpty(options.repoName);
     const fallbackRepoName = path.basename(rootDir);
-    if (!repoName && interactive) {
-        repoName = nonEmpty(await promptInput({ message: 'Repository name:', default: existingRepoName ?? fallbackRepoName }));
-    }
     repoName ??= existingRepoName ?? fallbackRepoName;
     if (!repoName) {
         logError('Repository name is required.');
@@ -111,7 +99,7 @@ export function makeInitCommand() {
         .option('--project-id <id>', 'Project id')
         .option('--force', 'Overwrite existing aops.config.json')
         .option('--no-agents-md', 'Skip AGENTS.md #INIT update')
-        .option('--yes', 'Use defaults and skip prompts')
+        .option('--yes', 'Compatibility flag; the CLI never prompts')
         .option('--json', 'Output JSON only')
         .action(async (options) => runInit(options));
     return command;

package/dist/commands/start.js

@@ -3,7 +3,6 @@ import path from 'node:path';
 import { createHash } from 'node:crypto';
 import { Command } from 'commander';
 import { logInfo, logSuccess, logWarn } from '@aopslabs/xf-cli-ui';
-import { promptInput, promptSelect } from '../utils/prompts.js';
 import { loadAopsRepoConfigReadOnly } from '../utils/repo-config.js';
 import { resolveRepoFirstProjectmanPaths } from '../utils/repo-first-projectman.js';
 import { readSessionStateNudges } from '../utils/session-state.js';
@@ -949,70 +948,6 @@ async function loadStartMissionResumePack(options, answers, activeProject) {
 function missingQuestions(answers, questions) {
     return questions.filter((question) => question.required && normalize(answers[question.key]) === undefined);
 }
-async function promptForAnswersInteractively(answers, boards) {
-    if (normalize(answers.mode) === undefined) {
-        answers.mode = await promptSelect({
-            message: 'Session mode?',
-            choices: START_MODES.map((mode) => ({ name: mode, value: mode })),
-            default: 'solo',
-        });
-    }
-    if (normalize(answers.board) === undefined) {
-        if (boards.length > 0) {
-            const OTHER = '__other__';
-            const picked = await promptSelect({
-                message: 'PM board?',
-                choices: [
-                    ...boards.map((board) => ({ name: board.name ? `${board.slug} (${board.name})` : board.slug, value: board.slug })),
-                    { name: 'other (type a slug or new:<Title>)', value: OTHER },
-                ],
-            });
-            answers.board =
-                picked === OTHER
-                    ? await promptInput({
-                        message: 'Board slug or new:<Title>:',
-                        validate: (v) => (v.trim().length > 0 ? true : 'Board is required'),
-                    })
-                    : picked;
-        }
-        else {
-            answers.board = await promptInput({
-                message: 'Board slug or new:<Title>:',
-                validate: (v) => (v.trim().length > 0 ? true : 'Board is required'),
-            });
-        }
-    }
-    if (normalize(answers.task) === undefined) {
-        answers.task = await promptInput({
-            message: 'Initial task (optional, empty = set up and wait):',
-            default: '',
-        });
-    }
-    if (isMultiAgentMode(normalize(answers.mode))) {
-        const board = normalize(answers.board);
-        const roomSlugDefault = board && !board.startsWith('new:') ? `${board}-room` : undefined;
-        if (normalize(answers.roomSlug) === undefined) {
-            answers.roomSlug = await promptInput({
-                message: 'Chat room slug:',
-                default: roomSlugDefault,
-                validate: (v) => (v.trim().length > 0 ? true : 'Room slug is required in multi-agent modes'),
-            });
-        }
-        if (normalize(answers.roomTitle) === undefined) {
-            answers.roomTitle = await promptInput({
-                message: 'Chat room title:',
-                default: normalize(answers.roomSlug),
-                validate: (v) => (v.trim().length > 0 ? true : 'Room title is required in multi-agent modes'),
-            });
-        }
-        if (normalize(answers.roles) === undefined) {
-            answers.roles = await promptInput({
-                message: 'Participants and roles (e.g. "claude=implementer, codex=reviewer, mzs=operator"):',
-                validate: (v) => (v.trim().length > 0 ? true : 'Roles are operator-assigned and required in multi-agent modes'),
-            });
-        }
-    }
-}
 export async function composeStart(options = {}) {
     assertSupportedMode(normalize(options.mode));
     assertCompatibleDisciplineAliases({
@@ -1028,10 +963,6 @@ export async function composeStart(options = {}) {
     const boards = await listLocalBoards(rootDir, activeProject?.localRoot);
     const sessionStateNudges = await readSessionStateNudges({ repoRoot: rootDir, localRoot: activeProject?.localRoot });
     const answers = collectAnswers(options);
-    const interactiveAllowed = options.interactive !== false && process.stdin.isTTY === true && process.stdout.isTTY === true;
-    if (interactiveAllowed && missingQuestions(answers, buildStartQuestions(answers, boards)).length > 0) {
-        await promptForAnswersInteractively(answers, boards);
-    }
     const questions = buildStartQuestions(answers, boards);
     const missing = missingQuestions(answers, questions);
     const base = {
@@ -1227,7 +1158,6 @@ function serializableStartReminderResult(result) {
     };
 }
 export async function runStart(options = {}) {
-    const interactive = options.json === true ? false : options.interactive;
     if (options.reminder === true) {
         const result = await composeStartReminder({ ...options, interactive: false });
         if (options.json) {
@@ -1238,7 +1168,7 @@ export async function runStart(options = {}) {
         console.log(JSON.stringify(result.sessionGuidance, null, 2));
         return;
     }
-    const result = await composeStart({ ...options, interactive });
+    const result = await composeStart({ ...options, interactive: false });
     if (options.json) {
         const compact = options.fullOutput === true ? false : true;
         console.log(JSON.stringify({ command: 'start', result: serializableStartResult(result, { compact }) }, null, 2));
@@ -1246,7 +1176,7 @@ export async function runStart(options = {}) {
     }
     result.warnings.forEach((warning) => logWarn(warning));
     if (result.status === 'needs-input') {
-        logWarn('Missing answers — re-run with the flags below (or answer interactively in a TTY):');
+        logWarn('Missing answers — re-run with the flags below:');
         for (const question of result.missing) {
             const hints = [];
             if (question.default)
@@ -1266,7 +1196,7 @@ export async function runStart(options = {}) {
 }
 export function makeStartCommand() {
     const cmd = new Command('start')
-        .description('Compose the AOPS Collaborative Startup kickoff prompt (interactive or flag-driven)')
+        .description('Compose the AOPS Collaborative Startup kickoff prompt from explicit flags')
         .option('--mode <mode>', `Session mode: ${START_MODES.join(' | ')}`)
         .option('--task <text>', 'Initial task definition (optional; empty = set up and wait)')
         .option('--board <slug>', 'PM board slug or new:<title>')
@@ -1297,7 +1227,7 @@ export function makeStartCommand() {
         .option('--root <path>', 'Workspace root override (default: nearest repo config ancestor)')
         .option('--out <file>', 'Write the composed prompt to a file')
         .option('--no-memory-brief', 'Do not build/embed the read-only local memory cache brief')
-        .option('--no-interactive', 'Never prompt on a TTY; report missing answers instead')
+        .option('--no-interactive', 'Compatibility flag; the CLI never prompts')
         .option('--json', 'Output JSON only (implies --no-interactive)')
         .action(async (options) => {
         await runStart(options);
@@ -1310,8 +1240,7 @@ read-only local memory cache brief pack for startup context unless
 --no-memory-brief is set.
 
 Examples:
-  aops-cli start                                   # interactive (operator at a TTY)
-  aops-cli start --json                            # agent interview: questions + missing answers
+  aops-cli start --json                            # questions + missing explicit flags
   aops-cli start --mode solo --board ops --json    # compact JSON; read result.promptRef
   aops-cli start --mode solo --board ops --out tmp/start.md --json
   aops-cli start --mode solo --board ops --full-output --json

package/dist/lib/community-setup-server-env.js

@@ -1,7 +1,6 @@
 import { statSync } from 'node:fs';
-import { banner, logInfo, logSuccess } from '@aopslabs/xf-cli-ui';
+import { logInfo, logSuccess } from '@aopslabs/xf-cli-ui';
 import { readAopsServerEnvFileContent, writeAopsServerEnvFileContent, } from '@aopslabs/aops-runtime-config';
-import { promptPassword } from '../utils/prompts.js';
 import { buildServerBootstrapEnvMap, buildServerBootstrapPreset, parseDotEnvAssignments, upsertServerBootstrapBlock, validateServerBootstrapEnv, } from './server-bootstrap.js';
 import { ExternalPostgresProbeError, probeExternalPostgresConnection, } from './setup-external-postgres.js';
 const MAX_POSTGRES_URL_BYTES = 4_096;
@@ -24,9 +23,6 @@ function resolveServerEnvAuthProvider(requested, existing) {
     }
     return 'trusted-local';
 }
-export function resolvePromptedPostgresUrl(promptedValue, savedValue) {
-    return normalizeNonEmpty(promptedValue) ?? savedValue;
-}
 function validatePostgresUrl(value) {
     if (/\0|\r|\n/.test(value) || Buffer.byteLength(value, 'utf8') > MAX_POSTGRES_URL_BYTES) {
         throw new Error('setup_server_env_postgres_url_invalid');
@@ -131,30 +127,8 @@ export async function runCommunitySetupServerEnv(options = {}) {
     const environmentUrl = normalizeNonEmpty(process.env.AOPS_PG_URL)
         ?? normalizeNonEmpty(process.env.AOPS_REPO_URL);
     let repoUrl = normalizeNonEmpty(options.repoUrl) ?? environmentUrl ?? existingUrl;
-    if (!options.repoUrl && !options.yes && !options.json) {
-        if (!options.skipBanner)
-            banner('AOPS Community Server Environment');
-        const savedUrl = repoUrl;
-        const promptedUrl = await promptPassword({
-            message: existingUrl || environmentUrl
-                ? 'External PostgreSQL URL [saved: ********] (press Enter to keep):'
-                : 'External PostgreSQL URL:',
-            validate: (value) => {
-                if (!value.trim() && savedUrl)
-                    return true;
-                try {
-                    validatePostgresUrl(value.trim());
-                    return true;
-                }
-                catch {
-                    return 'A PostgreSQL URL is required.';
-                }
-            },
-        });
-        repoUrl = resolvePromptedPostgresUrl(promptedUrl, savedUrl);
-    }
     if (!repoUrl) {
-        throw new Error('setup_server_env_postgres_url_required:use_interactive_prompt_or_AOPS_PG_URL');
+        throw new Error('setup_server_env_postgres_url_required:set_AOPS_PG_URL');
     }
     repoUrl = validatePostgresUrl(repoUrl);
     const authProvider = resolveServerEnvAuthProvider(options.auth, existing);