@simplens/onboard 1.0.0

package/dist/config/constants.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Application configuration constants
+ */
+/**
+ * Service port mappings
+ */
+export declare const SERVICE_PORTS: {
+    readonly API: 3000;
+    readonly DASHBOARD: 3002;
+    readonly GRAFANA: 3001;
+    readonly KAFKA_UI: 8080;
+    readonly MONGO: 27017;
+    readonly KAFKA: 9092;
+    readonly REDIS: 6379;
+    readonly LOKI: 3100;
+};
+/**
+ * Health check configuration
+ */
+export declare const HEALTH_CHECK: {
+    readonly MAX_RETRIES: 30;
+    readonly RETRY_DELAY_MS: 2000;
+    readonly TIMEOUT_MS: 60000;
+};
+/**
+ * Docker command timeouts
+ */
+export declare const DOCKER_TIMEOUTS: {
+    readonly START_MS: 30000;
+    readonly STOP_MS: 15000;
+    readonly BUILD_MS: 300000;
+};
+/**
+ * Critical environment variables that always need user input
+ */
+export declare const CRITICAL_ENV_KEYS: string[];
+/**
+ * Validation constraints
+ */
+export declare const VALIDATION: {
+    readonly MIN_PASSWORD_LENGTH: 8;
+    readonly MIN_API_KEY_LENGTH: 8;
+    readonly PORT_MIN: 1;
+    readonly PORT_MAX: 65535;
+};
+/**
+ * File paths
+ */
+export declare const FILES: {
+    readonly DOCKER_COMPOSE_INFRA: "docker-compose.infra.yaml";
+    readonly DOCKER_COMPOSE_APP: "docker-compose.yaml";
+    readonly ENV_FILE: ".env";
+    readonly CONFIG_FILE: "simplens.config.yaml";
+    readonly ERROR_LOG: "onboard-error.log";
+};
+/**
+ * URL templates for service access
+ */
+export declare function getServiceURL(service: keyof typeof SERVICE_PORTS, host?: string): string;
+/**
+ * Docker compose file paths
+ */
+export declare const DOCKER_COMPOSE_COMMANDS: {
+    readonly UP: readonly ["up", "-d"];
+    readonly DOWN: readonly ["down"];
+    readonly LOGS: readonly ["logs", "-f"];
+    readonly PS: readonly ["ps"];
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/config/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;CAShB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,UAQ7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;;CAMR,CAAC;AAEX;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,OAAO,aAAa,EAAE,IAAI,GAAE,MAAoB,GAAG,MAAM,CAErG;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;CAK1B,CAAC"}

package/dist/config/constants.js

@@ -0,0 +1,79 @@
+/**
+ * Application configuration constants
+ */
+/**
+ * Service port mappings
+ */
+export const SERVICE_PORTS = {
+    API: 3000,
+    DASHBOARD: 3002,
+    GRAFANA: 3001,
+    KAFKA_UI: 8080,
+    MONGO: 27017,
+    KAFKA: 9092,
+    REDIS: 6379,
+    LOKI: 3100,
+};
+/**
+ * Health check configuration
+ */
+export const HEALTH_CHECK = {
+    MAX_RETRIES: 30,
+    RETRY_DELAY_MS: 2000,
+    TIMEOUT_MS: 60000,
+};
+/**
+ * Docker command timeouts
+ */
+export const DOCKER_TIMEOUTS = {
+    START_MS: 30000,
+    STOP_MS: 15000,
+    BUILD_MS: 300000,
+};
+/**
+ * Critical environment variables that always need user input
+ */
+export const CRITICAL_ENV_KEYS = [
+    'NS_API_KEY',
+    'MONGO_URI',
+    'BROKERS',
+    'REDIS_URL',
+    'AUTH_SECRET',
+    'ADMIN_PASSWORD',
+    'LOKI_URL',
+];
+/**
+ * Validation constraints
+ */
+export const VALIDATION = {
+    MIN_PASSWORD_LENGTH: 8,
+    MIN_API_KEY_LENGTH: 8,
+    PORT_MIN: 1,
+    PORT_MAX: 65535,
+};
+/**
+ * File paths
+ */
+export const FILES = {
+    DOCKER_COMPOSE_INFRA: 'docker-compose.infra.yaml',
+    DOCKER_COMPOSE_APP: 'docker-compose.yaml',
+    ENV_FILE: '.env',
+    CONFIG_FILE: 'simplens.config.yaml',
+    ERROR_LOG: 'onboard-error.log',
+};
+/**
+ * URL templates for service access
+ */
+export function getServiceURL(service, host = 'localhost') {
+    return `http://${host}:${SERVICE_PORTS[service]}`;
+}
+/**
+ * Docker compose file paths
+ */
+export const DOCKER_COMPOSE_COMMANDS = {
+    UP: ['up', '-d'],
+    DOWN: ['down'],
+    LOGS: ['logs', '-f'],
+    PS: ['ps'],
+};
+//# sourceMappingURL=constants.js.map

package/dist/config/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,GAAG,EAAE,IAAI;IACT,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;CACJ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,KAAK;CACX,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,MAAM;CACV,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,YAAY;IACZ,WAAW;IACX,SAAS;IACT,WAAW;IACX,aAAa;IACb,gBAAgB;IAChB,UAAU;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,mBAAmB,EAAE,CAAC;IACtB,kBAAkB,EAAE,CAAC;IACrB,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,KAAK;CACT,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACjB,oBAAoB,EAAE,2BAA2B;IACjD,kBAAkB,EAAE,qBAAqB;IACzC,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,sBAAsB;IACnC,SAAS,EAAE,mBAAmB;CACxB,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAmC,EAAE,OAAe,WAAW;IACzF,OAAO,UAAU,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC;IACpB,EAAE,EAAE,CAAC,IAAI,CAAC;CACJ,CAAC"}

package/dist/config/index.d.ts

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

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/config/index.js

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

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/env-config.d.ts

@@ -0,0 +1,33 @@
+import type { EnvVariable } from './types/domain.js';
+/**
+ * Load and parse .env.example from embedded template
+ */
+export declare function loadEnvExample(): Promise<EnvVariable[]>;
+/**
+ * Prompts user for environment variable values based on the selected mode.
+ *
+ * @param mode - 'default' prompts only for critical vars, 'interactive' prompts for all
+ * @param infraServices - List of selected infrastructure service IDs
+ * @param infraHost - Host for infrastructure services
+ * @returns Map of environment variable keys to values
+ *
+ * @remarks
+ * Critical variables (always prompted): NS_API_KEY, MONGO_URI, BROKERS, etc.
+ * Interactive mode prompts for all variables including optional ones.
+ *
+ * @example
+ * ```ts
+ * const envVars = await promptEnvVariables('default', ['mongo', 'kafka'], 'localhost');
+ * // Prompts only for critical variables
+ * ```
+ */
+export declare function promptEnvVariables(mode: 'default' | 'interactive', infraServices: string[], infraHost: string): Promise<Map<string, string>>;
+/**
+ * Generate .env file from variables
+ */
+export declare function generateEnvFile(targetDir: string, envVars: Map<string, string>): Promise<void>;
+/**
+ * Append plugin credentials to .env file
+ */
+export declare function appendPluginEnv(targetDir: string, pluginEnvVars: Map<string, string>): Promise<void>;
+//# sourceMappingURL=env-config.d.ts.map

package/dist/env-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-config.d.ts","sourceRoot":"","sources":["../src/env-config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAuG7D;AA0CD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CACpC,IAAI,EAAE,SAAS,GAAG,aAAa,EAC/B,aAAa,EAAE,MAAM,EAAE,EACvB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmF9B;AAkBD;;GAEG;AACH,wBAAsB,eAAe,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;GAEG;AACH,wBAAsB,eAAe,CACjC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/env-config.js

@@ -0,0 +1,285 @@
+import inquirer from 'inquirer';
+import { writeFile, appendFile, logInfo, logSuccess } from './utils.js';
+import path from 'path';
+import { CRITICAL_ENV_KEYS } from './config/constants.js';
+/**
+ * Load and parse .env.example from embedded template
+ */
+export async function loadEnvExample() {
+    // Embedded .env template - always available regardless of installation
+    const envTemplate = `
+# ============================================
+# INFRASTRUCTURE HOST CONFIGURATION
+# ============================================
+INFRA_HOST=host.docker.internal
+
+# ============================================
+# CONNECTION URLS
+# ============================================
+NODE_ENV=production
+# ============================================
+# API SERVER
+# ============================================
+NS_API_KEY=
+PORT=3000
+MAX_BATCH_REQ_LIMIT=1000
+
+# ============================================
+# DATABASE
+# ============================================
+MONGO_URI=
+
+# ============================================
+# KAFKA
+# ============================================
+BROKERS=
+
+# Kafka Topic Partitions (Core Topics)
+DELAYED_PARTITION=1
+NOTIFICATION_STATUS_PARTITION=1
+
+# ============================================
+# REDIS
+# ============================================
+REDIS_URL=
+
+# ============================================
+# PLUGIN SYSTEM
+# ============================================
+SIMPLENS_CONFIG_PATH=./simplens.config.yaml
+PROCESSOR_CHANNEL=all
+
+# ============================================
+# BACKGROUND WORKER
+# ============================================
+OUTBOX_POLL_INTERVAL_MS=5000
+OUTBOX_CLEANUP_INTERVAL_MS=60000
+OUTBOX_BATCH_SIZE=100
+OUTBOX_RETENTION_MS=300000
+OUTBOX_CLAIM_TIMEOUT_MS=30000
+
+# ============================================
+# RETRY & IDEMPOTENCY
+# ============================================
+IDEMPOTENCY_TTL_SECONDS=86400
+MAX_RETRY_COUNT=5
+PROCESSING_TTL_SECONDS=120
+
+# ============================================
+# DELAYED NOTIFICATIONS
+# ============================================
+DELAYED_POLL_INTERVAL_MS=1000
+DELAYED_BATCH_SIZE=10
+MAX_POLLER_RETRIES=3
+
+# ============================================
+# RECOVERY SERVICE
+# ============================================
+RECOVERY_POLL_INTERVAL_MS=60000
+PROCESSING_STUCK_THRESHOLD_MS=300000
+PENDING_STUCK_THRESHOLD_MS=300000
+RECOVERY_BATCH_SIZE=50
+RECOVERY_CLAIM_TIMEOUT_MS=60000
+
+# ============================================
+# CLEANUP
+# ============================================
+CLEANUP_RESOLVED_ALERTS_RETENTION_MS=86400000
+CLEANUP_PROCESSED_STATUS_OUTBOX_RETENTION_MS=86400000
+
+# ============================================
+# LOGGING
+# ============================================
+LOKI_URL=
+LOG_LEVEL=info
+LOG_TO_FILE=true
+
+# ============================================
+# ADMIN DASHBOARD
+# ============================================
+AUTH_SECRET=
+ADMIN_USERNAME=admin
+ADMIN_PASSWORD=
+AUTH_TRUST_HOST=true
+API_BASE_URL=http://api:3000
+WEBHOOK_HOST=dashboard
+WEBHOOK_PORT=3002
+DASHBOARD_PORT=3002
+`;
+    return parseEnvContent(envTemplate);
+}
+/**
+ * Parse .env content into structured format
+ */
+function parseEnvContent(content) {
+    const lines = content.split('\n');
+    const variables = [];
+    let currentComment = '';
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Capture comments as descriptions
+        if (trimmed.startsWith('#') && !trimmed.includes('====')) {
+            currentComment = trimmed.replace(/^#\s*/, '');
+            continue;
+        }
+        // Skip empty lines and section dividers
+        if (!trimmed || trimmed.includes('====')) {
+            currentComment = '';
+            continue;
+        }
+        // Parse key=value pairs
+        const match = trimmed.match(/^([A-Z_]+)=(.*)$/);
+        if (match) {
+            const [, key, value] = match;
+            variables.push({
+                key,
+                value: value || '',
+                description: currentComment || undefined,
+                required: CRITICAL_ENV_KEYS.includes(key) || !value,
+            });
+            currentComment = '';
+        }
+    }
+    return variables;
+}
+/**
+ * Prompts user for environment variable values based on the selected mode.
+ *
+ * @param mode - 'default' prompts only for critical vars, 'interactive' prompts for all
+ * @param infraServices - List of selected infrastructure service IDs
+ * @param infraHost - Host for infrastructure services
+ * @returns Map of environment variable keys to values
+ *
+ * @remarks
+ * Critical variables (always prompted): NS_API_KEY, MONGO_URI, BROKERS, etc.
+ * Interactive mode prompts for all variables including optional ones.
+ *
+ * @example
+ * ```ts
+ * const envVars = await promptEnvVariables('default', ['mongo', 'kafka'], 'localhost');
+ * // Prompts only for critical variables
+ * ```
+ */
+export async function promptEnvVariables(mode, infraServices, infraHost) {
+    logInfo('Configuring environment variables...');
+    const envVars = await loadEnvExample();
+    const result = new Map();
+    // Auto-fill infra connection URLs based on selected services and host
+    const autoInfraUrls = {
+        MONGO_URI: infraServices.includes('mongo')
+            ? (infraHost === "host.docker.internal" ? `mongodb://mongo:27017/simplens?replicaSet=rs0` : `mongodb://${infraHost}:27017/simplens?replicaSet=rs0`)
+            : '',
+        BROKERS: infraServices.includes('kafka')
+            ? (infraHost === "host.docker.internal" ? "kafka:9093" : `${infraHost}:9092`)
+            : '',
+        REDIS_URL: infraServices.includes('redis')
+            ? (infraHost === "host.docker.internal" ? "redis://redis:6379" : `redis://${infraHost}:6379`)
+            : '',
+        LOKI_URL: infraServices.includes('loki')
+            ? (infraHost === "host.docker.internal" ? "http://loki:3100" : `http://${infraHost}:3100`)
+            : '',
+    };
+    if (mode === 'default') {
+        // Use defaults, only prompt for critical values
+        for (const envVar of envVars) {
+            // Use auto-filled infra URLs
+            if (autoInfraUrls[envVar.key]) {
+                result.set(envVar.key, autoInfraUrls[envVar.key]);
+                continue;
+            }
+            // Use default value if available
+            if (envVar.value && !CRITICAL_ENV_KEYS.includes(envVar.key)) {
+                result.set(envVar.key, envVar.value);
+                continue;
+            }
+            // Prompt for critical values (only if not auto-filled)
+            if (CRITICAL_ENV_KEYS.includes(envVar.key)) {
+                const answer = await inquirer.prompt([
+                    {
+                        type: envVar.key.includes('PASSWORD') ? 'password' : 'input',
+                        name: 'value',
+                        message: `${envVar.key}${envVar.description ? ` (${envVar.description})` : ''}:`,
+                        default: getSuggestedValue(envVar.key),
+                        validate: (input) => {
+                            if (!input && envVar.required) {
+                                return `${envVar.key} is required`;
+                            }
+                            return true;
+                        },
+                    },
+                ]);
+                result.set(envVar.key, answer.value);
+            }
+        }
+    }
+    else {
+        // Interactive mode: prompt for everything
+        logInfo('Interactive mode: You will be prompted for each environment variable.');
+        for (const envVar of envVars) {
+            const defaultValue = autoInfraUrls[envVar.key] || envVar.value || getSuggestedValue(envVar.key);
+            const answer = await inquirer.prompt([
+                {
+                    type: envVar.key.includes('PASSWORD') ? 'password' : 'input',
+                    name: 'value',
+                    message: `${envVar.key}${envVar.description ? ` (${envVar.description})` : ''}:`,
+                    default: defaultValue,
+                    validate: (input) => {
+                        if (!input && envVar.required) {
+                            return `${envVar.key} is required`;
+                        }
+                        return true;
+                    },
+                },
+            ]);
+            result.set(envVar.key, answer.value);
+        }
+    }
+    logSuccess('Environment variables configured');
+    return result;
+}
+/**
+ * Get suggested value for specific keys
+ */
+function getSuggestedValue(key) {
+    if (key === 'NS_API_KEY' || key === 'AUTH_SECRET') {
+        return `Replace with: openssl rand -base64 32`;
+    }
+    if (key === 'NODE_ENV') {
+        return 'production';
+    }
+    if (key === 'ADMIN_USERNAME') {
+        return 'admin';
+    }
+    return '';
+}
+/**
+ * Generate .env file from variables
+ */
+export async function generateEnvFile(targetDir, envVars) {
+    const envPath = path.join(targetDir, '.env');
+    let content = '# SimpleNS Environment Configuration\n';
+    content += '# Generated by @simplens/onboard\n\n';
+    for (const [key, value] of envVars.entries()) {
+        content += `${key}=${value}\n`;
+    }
+    await writeFile(envPath, content);
+    logSuccess('Generated .env file');
+}
+/**
+ * Append plugin credentials to .env file
+ */
+export async function appendPluginEnv(targetDir, pluginEnvVars) {
+    // Only append if there are actually credentials to add
+    if (pluginEnvVars.size === 0) {
+        logInfo('No plugin credentials to add');
+        return;
+    }
+    const envPath = path.join(targetDir, '.env');
+    let content = '\n# Plugin Credentials\n';
+    for (const [key, value] of pluginEnvVars.entries()) {
+        content += `${key}=${value}\n`;
+    }
+    await appendFile(envPath, content);
+    logSuccess('Added plugin credentials to .env');
+}
+//# sourceMappingURL=env-config.js.map

package/dist/env-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-config.js","sourceRoot":"","sources":["../src/env-config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import path from 'path';
+import inquirer from 'inquirer';
+import { displayBanner, logSuccess, logInfo, initLogger, logDebug } from './utils.js';
+import { validatePrerequisites } from './validators.js';
+import { promptInfraServices, generateInfraCompose, writeAppCompose, } from './infra.js';
+import { promptEnvVariables, generateEnvFile, appendPluginEnv, } from './env-config.js';
+import { fetchAvailablePlugins, promptPluginSelection, generatePluginConfig, parseConfigCredentials, promptPluginCredentials, } from './plugins.js';
+import { promptStartServices, startInfraServices, waitForInfraHealth, startAppServices, displayServiceStatus, } from './services.js';
+const program = new Command();
+program
+    .name('@simplens/onboard')
+    .description('A CLI tool to setup a SimpleNS instance on your machine/server')
+    .version('1.0.0')
+    .option('--infra', 'Setup infrastructure services (MongoDB, Kafka, Redis, etc.)')
+    .option('--env <mode>', 'Environment setup mode: "default" or "interactive"')
+    .option('--dir <path>', 'Target directory for setup')
+    .parse(process.argv);
+const options = program.opts();
+/**
+ * Prompt for setup options if not provided via CLI args
+ */
+async function promptSetupOptions() {
+    const answers = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'infra',
+            message: 'Do you want to setup infrastructure services (MongoDB, Kafka, Redis, etc.)?',
+            default: true,
+            when: () => options.infra === undefined,
+        },
+        {
+            type: 'list',
+            name: 'envMode',
+            message: 'Select environment configuration mode:',
+            choices: [
+                { name: 'Default (use preset values, prompt only for critical)', value: 'default' },
+                { name: 'Interactive (prompt for all variables)', value: 'interactive' },
+            ],
+            default: 'default',
+            when: () => !options.env,
+        },
+        {
+            type: 'input',
+            name: 'targetDir',
+            message: 'Target directory for setup:',
+            default: process.cwd(),
+            when: () => !options.dir,
+        },
+    ]);
+    return {
+        infra: options.infra !== undefined ? options.infra : answers.infra,
+        envMode: options.env || answers.envMode || 'default',
+        targetDir: options.dir || answers.targetDir || process.cwd(),
+    };
+}
+/**
+ * Main onboarding workflow
+ */
+async function main() {
+    try {
+        // Display banner
+        displayBanner();
+        // Initialize logger based on CLI flags
+        const opts = program.opts();
+        initLogger({
+            verbose: opts.verbose || false,
+            debug: opts.debug || false,
+            logFile: opts.debug ? path.join(process.cwd(), 'onboard-debug.log') : undefined,
+        });
+        logDebug('Logger initialized');
+        logDebug(`CLI options: ${JSON.stringify(opts)}`);
+        // Prompt for setup options if not provided
+        const setupOptions = await promptSetupOptions();
+        // Get target directory
+        const targetDir = path.resolve(setupOptions.targetDir);
+        logInfo(`Target directory: ${targetDir}`);
+        logDebug(`Resolved target directory: ${targetDir}`);
+        // Step 1: Validate prerequisites
+        await validatePrerequisites();
+        // Step 2: Infrastructure setup (if --infra flag is provided)
+        let selectedInfraServices = [];
+        let infraHost = 'host.docker.internal';
+        if (setupOptions.infra) {
+            logInfo('\n🏗️  Infrastructure Setup\n');
+            selectedInfraServices = await promptInfraServices();
+            infraHost = await generateInfraCompose(targetDir, selectedInfraServices);
+        }
+        else {
+            logInfo('\n⏭️  Skipping infrastructure setup (use --infra to enable)');
+        }
+        // Always write app docker-compose
+        logInfo('\n📦 Application Services Setup\n');
+        await writeAppCompose(targetDir);
+        // Step 3: Environment configuration
+        logInfo('\n⚙️  Environment Configuration\n');
+        const envMode = setupOptions.envMode;
+        const envVars = await promptEnvVariables(envMode, selectedInfraServices, infraHost);
+        await generateEnvFile(targetDir, envVars);
+        // Step 4: Plugin installation
+        logInfo('\n🔌 Plugin Installation\n');
+        const availablePlugins = await fetchAvailablePlugins();
+        const selectedPlugins = await promptPluginSelection(availablePlugins);
+        if (selectedPlugins.length > 0) {
+            await generatePluginConfig(targetDir, selectedPlugins);
+            // Extract and prompt for plugin credentials
+            const configPath = path.join(targetDir, 'simplens.config.yaml');
+            const credentialKeys = await parseConfigCredentials(configPath);
+            if (credentialKeys.length > 0) {
+                const pluginCreds = await promptPluginCredentials(credentialKeys);
+                await appendPluginEnv(targetDir, pluginCreds);
+            }
+        }
+        // Step 5: Service orchestration
+        logInfo('\n🚀 Service Orchestration\n');
+        const shouldStart = await promptStartServices();
+        if (shouldStart) {
+            // Start infra services first (if --infra was used)
+            if (setupOptions.infra && selectedInfraServices.length > 0) {
+                await startInfraServices(targetDir);
+                await waitForInfraHealth(targetDir);
+            }
+            // Start app services
+            await startAppServices(targetDir);
+            // Display service status
+            await displayServiceStatus();
+        }
+        else {
+            logInfo('Services not started. You can start them later with:');
+            if (setupOptions.infra) {
+                console.log('  docker-compose -f docker-compose.infra.yaml up -d');
+            }
+            console.log('  docker-compose up -d\n');
+        }
+        // Final success message
+        logSuccess('\n🎉 SimpleNS onboarding completed successfully!\n');
+    }
+    catch (error) {
+        // Import at top of file
+        const { formatErrorForUser } = await import('./types/errors.js');
+        console.log('\n' + formatErrorForUser(error));
+        // Log full error to stderr for debugging
+        if (process.env.DEBUG) {
+            console.error('\nFull error details:');
+            console.error(error);
+        }
+        process.exit(1);
+    }
+}
+// Run main function
+main();
+//# sourceMappingURL=index.js.map