@karmaniverous/smoz 0.2.9 → 0.2.11

package/dist/cli/index.cjs

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 'use strict';
 
+var cliHost = require('@karmaniverous/get-dotenv/cliHost');
+var plugins = require('@karmaniverous/get-dotenv/plugins');
+var packageDirectory = require('package-directory');
 var fs = require('node:fs');
 var path = require('node:path');
-var commander = require('commander');
-var packageDirectory = require('package-directory');
 var chokidar = require('chokidar');
 var node_child_process = require('node:child_process');
-var os = require('node:os');
+var getDotenv = require('@karmaniverous/get-dotenv');
 var node_url = require('node:url');
 var node_process = require('node:process');
 var promises = require('node:readline/promises');
@@ -82,8 +83,8 @@ import { z } from 'zod';
 
 import { app, APP_ROOT_ABS } from '@/app/config/app.config';
 
-export const eventSchema = z.any();
-export const responseSchema = z.any();
+export const eventSchema = z.unknown();
+export const responseSchema = z.unknown();
 
 export const fn = app.defineFunction({
   eventType: '${token}',
@@ -153,8 +154,8 @@ import { z } from 'zod';
 
 import { app, APP_ROOT_ABS } from '@/app/config/app.config';
 
-export const eventSchema = z.any();
-export const responseSchema = z.any();
+export const eventSchema = z.unknown();
+export const responseSchema = z.unknown();
 
 export const fn = app.defineFunction({
   eventType: '${token}',
@@ -281,7 +282,7 @@ const launchOffline = async (root, opts) => {
         }
         return { cmd, args, shell };
     };
-    let child = spawnOffline(root, makeCmd(), opts.verbose);
+    let child = await spawnOffline(root, makeCmd(), opts.verbose);
     const close = async () => new Promise((resolve) => {
         if (child.killed) {
             resolve();
@@ -298,46 +299,23 @@ const launchOffline = async (root, opts) => {
     });
     const restart = async () => {
         await close();
-        child = spawnOffline(root, makeCmd(), opts.verbose);
+        child = await spawnOffline(root, makeCmd(), opts.verbose);
     };
     return { restart, close };
 };
-const spawnOffline = (root, cmd, verbose) => {
-    // Inherit the parent env, but ensure temp variables are present.
-    // Some toolchains (e.g., tsx/esbuild invoked under offline) interpolate TEMP/TMP,
-    // and if they are undefined, they may create literal "undefined\\temp\\..." paths
-    // relative to CWD. Use os.tmpdir() as a safe fallback.
+const spawnOffline = async (root, cmd, verbose) => {
+    // Normalize child environment via get-dotenv when available; safe fallback otherwise.
     const baseEnv = { ...process.env };
-    const tmp = os.tmpdir();
-    // Cross-platform default
-    if (!baseEnv.TMPDIR)
-        baseEnv.TMPDIR = tmp;
-    // Windows defaults
-    if (process.platform === 'win32') {
-        if (!baseEnv.TEMP)
-            baseEnv.TEMP = tmp;
-        if (!baseEnv.TMP)
-            baseEnv.TMP = tmp;
-        // Some nested toolchains derive cache roots from these when TMP/TEMP are absent
-        if (!baseEnv.LOCALAPPDATA)
-            baseEnv.LOCALAPPDATA = tmp;
-        if (!baseEnv.USERPROFILE)
-            baseEnv.USERPROFILE = tmp;
-    }
-    else {
-        // POSIX: some tools fall back to HOME for caches when TMPDIR isn't used
-        if (!baseEnv.HOME)
-            baseEnv.HOME = tmp;
-    }
+    const childEnv = getDotenv.buildSpawnEnv(baseEnv);
     // Optional diagnostics to verify the child sees sane temp-related envs
     if (verbose) {
         const snap = {
-            TMPDIR: baseEnv.TMPDIR,
-            TEMP: baseEnv.TEMP,
-            TMP: baseEnv.TMP,
-            HOME: baseEnv.HOME,
-            USERPROFILE: baseEnv.USERPROFILE,
-            LOCALAPPDATA: baseEnv.LOCALAPPDATA,
+            TMPDIR: childEnv.TMPDIR,
+            TEMP: childEnv.TEMP,
+            TMP: childEnv.TMP,
+            HOME: childEnv.HOME,
+            USERPROFILE: childEnv.USERPROFILE,
+            LOCALAPPDATA: childEnv.LOCALAPPDATA,
         };
         process.stdout.write(`[offline] env snapshot: ${JSON.stringify(snap)}\n`);
     }
@@ -345,7 +323,7 @@ const spawnOffline = (root, cmd, verbose) => {
         cwd: root,
         shell: cmd.shell,
         stdio: ['ignore', 'pipe', 'pipe'],
-        env: baseEnv,
+        env: childEnv,
     });
     const prefix = '[offline] ';
     let announced = false;
@@ -375,9 +353,12 @@ const spawnOffline = (root, cmd, verbose) => {
     return child;
 };
 
-/* OpenAPI one-shot runner: spawn the project-local OpenAPI script via tsx.
- * - Mirrors the npm script: tsx app/config/openapi && prettier (project-local script already formats).
- * - Keeps CLI responsibilities minimal; errors bubble via non-zero exit.
+/**
+ * @module OpenAPI one-shot runner.
+ *
+ * Spawns the project-local OpenAPI script via tsx, then formats the output
+ * with prettier. Owns the full generate-and-format cycle so consumers can
+ * use a single `smoz openapi` invocation.
  */
 const findTsxCli = (root) => {
     // Prefer invoking the JS entry to avoid shell .cmd quirks on Windows.
@@ -393,6 +374,17 @@ const findTsxCli = (root) => {
     const cmd = process.platform === 'win32' ? 'tsx.cmd' : 'tsx';
     return { cmd, args: ['app/config/openapi.ts'], shell: true };
 };
+const findPrettierCli = (root) => {
+    const js = path.resolve(root, 'node_modules', 'prettier', 'bin', 'prettier.cjs');
+    if (!fs.existsSync(js)) {
+        throw new Error(`prettier not found at ${js}. Install it as a devDependency.`);
+    }
+    return {
+        cmd: process.execPath,
+        args: [js, '--write', 'app/generated/openapi.json'],
+        shell: false,
+    };
+};
 const runOpenapi = async (root, opts) => {
     // Detect changes by comparing the pre/post content of app/generated/openapi.json.
     const outFile = path.resolve(root, 'app', 'generated', 'openapi.json');
@@ -405,18 +397,47 @@ const runOpenapi = async (root, opts) => {
         // ignore read errors; treat as absent
         before = undefined;
     }
-    const { cmd, args, shell } = findTsxCli(root);
+    // Build a normalized child env via get-dotenv (static import).
+    const env = getDotenv.buildSpawnEnv({});
+    // Step 1: generate the OpenAPI spec.
+    const tsx = findTsxCli(root);
     if (opts?.verbose) {
-        console.log(`[openapi] ${[cmd, ...args].join(' ')}`);
+        console.log(`[openapi] ${[tsx.cmd, ...tsx.args].join(' ')}`);
     }
-    const res = node_child_process.spawnSync(cmd, args, {
+    const genRes = node_child_process.spawnSync(tsx.cmd, tsx.args, {
         cwd: root,
         stdio: 'inherit',
-        shell,
+        shell: tsx.shell,
+        env,
     });
-    if (typeof res.status !== 'number' || res.status !== 0) {
-        const code = typeof res.status === 'number' ? String(res.status) : 'unknown';
-        throw new Error(`openapi failed (exit ${code})`);
+    if (typeof genRes.status !== 'number' || genRes.status !== 0) {
+        const code = typeof genRes.status === 'number' ? String(genRes.status) : 'unknown';
+        const detail = genRes.error
+            ? `: ${genRes.error.message}`
+            : genRes.signal
+                ? ` (signal ${genRes.signal})`
+                : '';
+        throw new Error(`openapi failed (exit ${code})${detail}`);
+    }
+    // Step 2: format the output with prettier.
+    const prettier = findPrettierCli(root);
+    if (opts?.verbose) {
+        console.log(`[openapi] ${[prettier.cmd, ...prettier.args].join(' ')}`);
+    }
+    const fmtRes = node_child_process.spawnSync(prettier.cmd, prettier.args, {
+        cwd: root,
+        stdio: 'inherit',
+        shell: prettier.shell,
+        env,
+    });
+    if (typeof fmtRes.status !== 'number' || fmtRes.status !== 0) {
+        const code = typeof fmtRes.status === 'number' ? String(fmtRes.status) : 'unknown';
+        const detail = fmtRes.error
+            ? `: ${fmtRes.error.message}`
+            : fmtRes.signal
+                ? ` (signal ${fmtRes.signal})`
+                : '';
+        throw new Error(`prettier format failed (exit ${code})${detail}`);
     }
     // Determine whether the file content changed
     try {
@@ -548,6 +569,50 @@ const inferDefaultStage = (root, verbose) => {
         console.log('[dev] inferring stage: dev (explicit --stage overrides)');
     return 'dev';
 };
+/**
+ * Resolve the effective stage for dev according to precedence:
+ * 1) CLI --stage
+ * 2) getdotenv.config.json -> plugins.smoz.stage (string)
+ * 3) process.env.STAGE
+ * 4) inferDefaultStage() fallback ("dev")
+ *
+ * Notes:
+ * - We intentionally read only the JSON variant to avoid adding YAML/TS loaders
+ *   to the CLI runtime. JS/TS config will be handled by the get-dotenv host
+ *   once the full plugin-first path is wired; this probe is a safe, minimal
+ *   bridge that preserves current behavior when the file is absent.
+ */
+const resolveStage = async (root, cliStage, verbose) => {
+    if (typeof cliStage === 'string' && cliStage.trim().length > 0) {
+        if (verbose)
+            console.log(`[dev] stage (cli): ${cliStage}`);
+        return cliStage;
+    }
+    // getdotenv.config.json → plugins.smoz.stage
+    try {
+        const cfgPath = path.resolve(root, 'getdotenv.config.json');
+        if (fs.existsSync(cfgPath)) {
+            const raw = fs.readFileSync(cfgPath, 'utf8');
+            const parsed = JSON.parse(raw);
+            const fromCfg = parsed.plugins?.smoz?.stage;
+            if (typeof fromCfg === 'string' && fromCfg.trim().length > 0) {
+                if (verbose)
+                    console.log(`[dev] stage (config): ${fromCfg}`);
+                return fromCfg.trim();
+            }
+        }
+    }
+    catch {
+        // best-effort; fall through
+    }
+    const envStage = typeof process.env.STAGE === 'string' ? process.env.STAGE : undefined;
+    if (envStage && envStage.trim().length > 0) {
+        if (verbose)
+            console.log(`[dev] stage (env): ${envStage}`);
+        return envStage.trim();
+    }
+    return inferDefaultStage(root, verbose);
+};
 const seedEnvForStage = async (root, stage, verbose) => {
     // Best effort: import the app config to read declared env keys and concrete values.
     // Preserve existing process.env values; only seed when unset.
@@ -653,21 +718,24 @@ const launchInline = async (root, opts) => {
     const { entry } = resolveInlineEntry(pkgRoot);
     const makeTsx = () => {
         const { cmd, args, shell } = resolveTsxCommand(root, entry);
-        return node_child_process.spawn(cmd, args, {
-            cwd: root,
-            stdio: 'inherit',
-            shell,
-            // Enable tsconfig paths for "@/..." during TS fallback.
-            env: {
+        return (async () => {
+            const env = getDotenv.buildSpawnEnv({
                 ...process.env,
+                // Enable tsconfig paths for "@/..." during TS fallback.
                 TSX_TSCONFIG_PATHS: '1',
                 SMOZ_STAGE: opts.stage,
                 SMOZ_PORT: String(opts.port),
                 SMOZ_VERBOSE: opts.verbose ? '1' : '',
-            },
-        });
+            });
+            return node_child_process.spawn(cmd, args, {
+                cwd: root,
+                stdio: 'inherit',
+                shell,
+                env,
+            });
+        })();
     };
-    let child = makeTsx();
+    let child = await makeTsx();
     const close = async () => new Promise((resolve) => {
         // If the process has already exited (exitCode set), resolve immediately.
         if (child.exitCode !== null) {
@@ -684,16 +752,14 @@ const launchInline = async (root, opts) => {
     });
     const restart = async () => {
         await close();
-        child = makeTsx();
+        child = await makeTsx();
     };
     return { close, restart };
 };
 
 const runDev = async (root, opts) => {
     const verbose = !!opts.verbose;
-    const stage = typeof opts.stage === 'string'
-        ? opts.stage
-        : inferDefaultStage(root, verbose);
+    const stage = await resolveStage(root, typeof opts.stage === 'string' ? opts.stage : undefined, verbose);
     // Seed env with concrete values for the selected stage.
     try {
         await seedEnvForStage(root, stage, verbose);
@@ -1268,226 +1334,144 @@ const runInit = async (root, template = 'default', opts) => {
 };
 
 /**
- * SMOZ CLI — version/signature + register/add
+ * SMOZ command plugin (get-dotenv plugin-first host).
  *
- * - Default: print project signature (version, Node, repo root, stanPath, config presence) * - register: one-shot — generate app/generated/register.*.ts from app/functions/**
- * - openapi: one-shot — run the project’s OpenAPI builder
- * - dev: watch loop orchestrator for register/openapi and optional local serving
- * - add: scaffold a new function skeleton under app/functions
+ * Registers init/add/register/openapi/dev on a GetDotenvCli instance and
+ * delegates to existing implementations. No business logic here.
  */
-const getRepoRoot = () => packageDirectory.packageDirectorySync() ?? process.cwd();
-const readPkg = (root) => {
-    try {
-        const raw = fs.readFileSync(path.join(root, 'package.json'), 'utf8');
-        return JSON.parse(raw);
-    }
-    catch {
-        return {};
-    }
-};
-const readSmozConfig = (root) => {
-    try {
-        const p = path.join(root, 'smoz.config.json');
-        if (!fs.existsSync(p))
-            return {};
-        const raw = fs.readFileSync(p, 'utf8');
-        const parsed = JSON.parse(raw);
-        if (parsed && typeof parsed === 'object') {
-            return parsed;
-        }
-        return {};
-    }
-    catch {
-        return {};
-    }
-};
-const detectPackageManager = () => {
-    const ua = process.env.npm_config_user_agent ?? '';
-    if (ua.includes('pnpm'))
-        return 'pnpm';
-    if (ua.includes('yarn'))
-        return 'yarn';
-    if (ua.includes('npm'))
-        return 'npm';
-    return ua || undefined;
-};
-const detectStanPath = (root) => {
-    // Keep this conservative; future: read stan.config.* if introduced.
-    const candidate = '.stan';
-    if (fs.existsSync(path.join(root, candidate, 'system', 'stan.system.md'))) {
-        return candidate;
-    }
-    return candidate; // default
-};
-const printSignature = () => {
-    const root = getRepoRoot();
-    const pkg = readPkg(root);
-    const name = pkg.name ?? 'smoz';
-    const version = pkg.version ?? '0.0.0';
-    const pm = detectPackageManager();
-    const stanPath = detectStanPath(root);
-    const hasAppConfig = fs.existsSync(path.join(root, 'app', 'config', 'app.config.ts'));
-    const hasSmozJson = fs.existsSync(path.join(root, 'smoz.config.json'));
-    const hasSmozYaml = fs.existsSync(path.join(root, 'smoz.config.yml')) ||
-        fs.existsSync(path.join(root, 'smoz.config.yaml'));
-    console.log(`${name} v${version}`);
-    console.log(`Node ${process.version}`);
-    console.log(`Repo: ${root}`);
-    console.log(`stanPath: ${stanPath}`);
-    console.log(`app/config/app.config.ts: ${hasAppConfig ? 'found' : 'missing'}`);
-    console.log(`smoz.config.*: ${hasSmozJson || hasSmozYaml ? 'found' : 'absent'}`);
-    if (pm)
-        console.log(`PM: ${pm}`);
-};
-const main = () => {
-    const root = getRepoRoot();
-    const pkg = readPkg(root);
-    const program = new commander.Command();
-    program
-        .name('smoz')
-        .description('SMOZ CLI')
-        // Add -v alias for version in addition to default --version behavior
-        .version(pkg.version ?? '0.0.0', '-v, --version', 'output the version');
-    program
-        .command('add')
-        .argument('<spec>', 'Add function: HTTP <eventType>/<segments...>/<method> or non-HTTP <eventType>/<segments...>')
-        .description('Scaffold a new function under app/functions')
-        .action(async (spec) => {
-        try {
-            const { created, skipped } = await runAdd(root, spec);
-            console.log(created.length
-                ? `Created:\n - ${created.join('\n - ')}${skipped.length
-                    ? `\nSkipped (exists):\n - ${skipped.join('\n - ')}`
-                    : ''}`
-                : 'Nothing created (files already exist).');
-        }
-        catch (e) {
-            console.error(e.message);
-            process.exitCode = 1;
-        }
-    });
-    program
-        .command('init')
-        .description('Scaffold a new SMOZ app from packaged templates (default: default)')
-        .option('-t, --template <nameOrPath>', 'Template name or directory path', 'default')
-        .option('-i, --install [pm]', 'Install dependencies (optionally specify pm: npm|pnpm|yarn|bun)')
-        .option('--no-install', 'Skip dependency installation (overrides -y)', false)
-        .option('-y, --yes', 'Skip prompts (non-interactive)', false)
-        .option('--dry-run', 'Show planned actions without writing', false)
-        .action(async (opts) => {
-        try {
-            const cfg = readSmozConfig(root).cliDefaults?.init ?? {};
-            // Resolve template: CLI > config > default
-            const tpl = typeof opts.template === 'string'
-                ? opts.template
-                : typeof cfg.template === 'string'
-                    ? cfg.template
-                    : 'default';
-            // Resolve install behavior: CLI > --no-install > config
-            let install = opts.install;
-            if (opts.noInstall === true) {
-                install = false;
-            }
-            else if (install === undefined) {
-                const d = cfg.install;
-                install =
-                    d === 'auto'
-                        ? true
-                        : d === 'none'
-                            ? false
-                            : typeof d === 'string'
-                                ? d
-                                : undefined;
-            }
-            const conflict = typeof opts.conflict === 'string' ? opts.conflict : cfg.onConflict;
-            const { created, skipped, examples, merged, installed } = await runInit(root, tpl, {
-                // Include only when defined to satisfy exactOptionalPropertyTypes
-                ...(install !== undefined ? { install } : {}),
-                ...(typeof conflict === 'string' ? { conflict } : {}),
-                yes: opts.yes === true,
-                noInstall: opts.noInstall === true,
-                dryRun: opts.dryRun === true,
+const repoRoot = () => packageDirectory.packageDirectorySync() ?? process.cwd();
+const smozPlugin = () => cliHost.definePlugin({
+    id: 'smoz',
+    setup(cli) {
+        // init
+        cli
+            .command('init')
+            .description('Scaffold a new SMOZ app from a template')
+            .option('-t, --template <name>', 'template name', 'default')
+            .option('-y, --yes', 'assume “example” on conflicts')
+            .option('--no-install', 'do not install dependencies')
+            .option('--install <pm>', 'explicit package manager (npm|pnpm|yarn|bun)')
+            .option('--conflict <policy>', 'overwrite|example|skip|ask')
+            .action(async (opts) => {
+            const root = repoRoot();
+            const template = typeof opts.template === 'string' ? opts.template : 'default';
+            const yes = Boolean(opts.yes);
+            const noInstall = opts.install === undefined &&
+                opts['noInstall'] !== undefined
+                ? Boolean(opts['noInstall'])
+                : Boolean(opts['noInstall']);
+            const pmRaw = opts.install ?? undefined;
+            const conflict = opts.conflict ?? undefined;
+            await runInit(root, template, {
+                ...(yes ? { yes } : {}),
+                ...(noInstall ? { noInstall } : {}),
+                ...(pmRaw ? { install: pmRaw } : {}),
+                ...(conflict ? { conflict } : {}),
             });
-            console.log([
-                created.length
-                    ? `Created:\n - ${created.join('\n - ')}`
-                    : 'Created: (none)',
-                examples.length
-                    ? `Examples (existing preserved):\n - ${examples.join('\n - ')}`
-                    : undefined,
-                skipped.length
-                    ? `Skipped (exists):\n - ${skipped.join('\n - ')}`
-                    : undefined,
-                merged.length
-                    ? `package.json (additive):\n - ${merged.join('\n - ')}`
-                    : undefined,
-                `Install: ${installed}`,
-            ]
-                .filter(Boolean)
-                .join('\n'));
-        }
-        catch (e) {
-            console.error(e.message);
-            process.exitCode = 1;
-        }
-    });
-    program
-        .command('register')
-        .description('Scan app/functions/** and generate app/generated/register.*.ts (one-shot)')
-        .action(async () => {
-        const { wrote } = await runRegister(root);
-        console.log(wrote.length ? `Updated:\n - ${wrote.join('\n - ')}` : 'No changes.');
-    });
-    program
-        .command('openapi')
-        .description('Generate app/generated/openapi.json (one-shot)')
-        .action(async () => {
-        try {
-            await runOpenapi(root, { verbose: true });
-        }
-        catch (e) {
-            console.error(e.message);
-            process.exitCode = 1;
-        }
-    });
-    program
-        .command('dev')
-        .description('Watch loop: keep registers/openapi fresh; optionally serve HTTP locally')
-        .option('-r, --register', 'Enable register step on change', true)
-        .option('-R, --no-register', 'Disable register step on change')
-        .option('-o, --openapi', 'Enable openapi step on change', true)
-        .option('-O, --no-openapi', 'Disable openapi step on change')
-        .option('-l, --local [mode]', 'Local server mode: inline|offline', 'inline')
-        .option('-s, --stage <name>', 'Stage name (default inferred)')
-        .option('-p, --port <n>', 'Port (0=random)', (v) => Number(v), 0)
-        .option('-V, --verbose', 'Verbose logging', false)
-        .action(async (opts) => {
-        try {
-            const cfg = readSmozConfig(root).cliDefaults?.dev ?? {};
-            // Resolve local mode default from config if not provided
-            const localResolved = typeof opts.local === 'string'
-                ? opts.local
-                : opts.local === false
+        });
+        // add
+        cli
+            .command('add')
+            .description('Scaffold a function under app/functions')
+            .argument('<spec>', 'spec: <eventType>/<segments...>/<method>')
+            .action(async (spec) => {
+            const root = repoRoot();
+            if (typeof spec !== 'string' || !spec.trim()) {
+                throw new Error('smoz add: missing <spec> (e.g., rest/foo/get)');
+            }
+            await runAdd(root, spec);
+        });
+        // register
+        cli
+            .command('register')
+            .description('Generate side-effect register files')
+            .action(async () => {
+            const root = repoRoot();
+            await runRegister(root);
+        });
+        // openapi
+        cli
+            .command('openapi')
+            .description('Generate OpenAPI document (app/generated/openapi.json)')
+            .option('-V, --verbose', 'verbose output')
+            .action(async (opts) => {
+            const root = repoRoot();
+            await runOpenapi(root, { verbose: !!opts.verbose });
+        });
+        // dev
+        cli
+            .command('dev')
+            .description('Dev loop: register/openapi + local backend (inline|offline)')
+            .option('-r, --register', 'run register step (default on)')
+            .option('-R, --no-register', 'disable register step')
+            .option('-o, --openapi', 'run openapi step (default on)')
+            .option('-O, --no-openapi', 'disable openapi step')
+            .option('-l, --local [mode]', 'local mode: inline | offline | false (default inline)')
+            .option('-s, --stage <name>', 'stage name')
+            .option('-p, --port <number>', 'port (0 = random free port)')
+            .option('-V, --verbose', 'verbose output')
+            .action(async (opts) => {
+            const root = repoRoot();
+            // register/openapi defaults (on); explicit negations take precedence.
+            const register = opts.register === true
+                ? true
+                : opts.noRegister
+                    ? false
+                    : true;
+            const openapi = opts.openapi === true
+                ? true
+                : opts.noOpenapi
                     ? false
-                    : (cfg.local ?? 'inline');
+                    : true;
+            // local mode parsing
+            const raw = opts.local;
+            let local = 'inline';
+            if (raw === 'inline' || raw === 'offline')
+                local = raw;
+            else if (raw === true)
+                local = 'inline';
+            else if (raw === 'false')
+                local = false;
+            const port = typeof opts.port === 'string'
+                ? Number(opts.port)
+                : typeof opts.port === 'number'
+                    ? opts.port
+                    : undefined;
             await runDev(root, {
-                register: opts.register !== false,
-                openapi: opts.openapi !== false,
-                local: localResolved,
+                register,
+                openapi,
+                local,
                 ...(typeof opts.stage === 'string' ? { stage: opts.stage } : {}),
-                port: opts.port ?? 0,
+                ...(typeof port === 'number' ? { port } : {}),
                 verbose: !!opts.verbose,
             });
-        }
-        catch (e) {
-            console.error(e.message);
-            process.exitCode = 1;
-        }
-    });
-    // Default action (no subcommand): print version + signature block
-    program.action(() => {
-        printSignature();
+        });
+    },
+});
+
+/**
+ * SMOZ CLI — plugin-first host built on get-dotenv.
+ *
+ * - Build a GetDotenvCli host, install included plugins (cmd/batch/aws),
+ *   and install the SMOZ command plugin (init/add/register/openapi/dev).
+ * - Resolve dotenv context once, then parse argv.
+ */
+const main = async () => {
+    const cli = new cliHost.GetDotenvCli('smoz');
+    await cli.brand({
+        importMetaUrl: (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)),
+        description: 'SMOZ CLI',
     });
-    program.parse(process.argv);
+    cli
+        .attachRootOptions()
+        .use(smozPlugin())
+        .use(plugins.awsPlugin())
+        .use(plugins.cmdPlugin({
+        asDefault: true,
+        optionAlias: '-c, --cmd <command...>',
+    }))
+        .use(plugins.batchPlugin())
+        .passOptions();
+    await cli.parseAsync();
 };
-main();
+void main();