@msn-control/liftoff 0.10.4 → 0.11.1

package/dist/application/upgrade/use-case.d.ts

@@ -0,0 +1,6 @@
+import type { ExecutionContext } from '../context.js';
+export interface UpgradeRequest {
+    mode: 'check' | 'apply';
+    json: boolean;
+}
+export declare function upgradeLiftoff(request: UpgradeRequest, context: ExecutionContext): Promise<number>;

package/dist/application/upgrade/use-case.js

@@ -0,0 +1,82 @@
+import { formatCommand } from '../../process-runner.js';
+import { runSelfUpgrade, selfUpgradeExitCode, selfUpgradeRemedy, selfUpgradeSummary } from '../../self-upgrade.js';
+import { liftoffVersion } from '../../version.js';
+function renderSelfUpgradeResult(value, presentation) {
+    const details = [
+        { label: 'Current CLI', value: value.currentVersion },
+        ...('targetVersion' in value && value.targetVersion
+            ? [{ label: 'Canonical target', value: value.targetVersion }]
+            : []),
+        ...('registryKind' in value && value.registryKind
+            ? [{ label: 'Delivery registry', value: value.registryKind }]
+            : [])
+    ];
+    presentation.definitions('CLI upgrade result', details);
+    switch (value.status) {
+        case 'current':
+            presentation.status('success', 'CLI is current', selfUpgradeSummary(value));
+            return;
+        case 'update-available':
+            presentation.status('warning', 'CLI update available', selfUpgradeSummary(value));
+            presentation.command('liftoff upgrade');
+            return;
+        case 'upgraded':
+            presentation.completion('Liftoff CLI upgraded', selfUpgradeSummary(value), [{ label: 'Installed version', value: value.targetVersion }], 'liftoff update --check');
+            return;
+        case 'blocked':
+        case 'failed': {
+            presentation.status(value.status === 'blocked' ? 'warning' : 'error', value.status === 'blocked' ? 'CLI upgrade blocked' : 'CLI upgrade failed', selfUpgradeSummary(value));
+            const remedy = selfUpgradeRemedy(value);
+            if (remedy) {
+                presentation.remedy(remedy);
+            }
+            return;
+        }
+        default: {
+            const exhaustive = value;
+            throw new Error(`Unhandled self-upgrade result: ${String(exhaustive)}`);
+        }
+    }
+}
+export async function upgradeLiftoff(request, context) {
+    const { mode, json } = request;
+    if (!json) {
+        context.presentation.commandIdentity('upgrade', 'Replace the supported global Liftoff CLI installation');
+    }
+    const execute = context.selfUpgrade ?? ((request) => runSelfUpgrade(request, {
+        environment: context.env ?? process.env
+    }));
+    let value;
+    try {
+        value = await execute({
+            mode,
+            currentVersion: liftoffVersion,
+            stdout: context.stdout,
+            stderr: context.stderr,
+            json,
+            ...(!json
+                ? {
+                    onStage: (stage, detail) => context.presentation.stage(stage, detail),
+                    onInstallCommand: (command) => context.presentation.command(formatCommand(command))
+                }
+                : {})
+        });
+    }
+    catch {
+        value = {
+            schemaVersion: 1,
+            mode,
+            status: 'failed',
+            currentVersion: liftoffVersion,
+            reasonCode: 'verification_failed'
+        };
+    }
+    if (json) {
+        context.presentation.rawStdout(`${JSON.stringify(value, null, 2)}\n`);
+    }
+    else {
+        renderSelfUpgradeResult(value, context.presentation);
+    }
+    return selfUpgradeExitCode(value);
+}
+//# sourceMappingURL=use-case.js.map

package/dist/application/upgrade/use-case.js.map

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

package/dist/args.d.ts

@@ -1,65 +1,5 @@
-import type { ParsedArgs } from './types.js';
-type FlagKind = 'boolean' | 'value';
-export type CommandGroup = 'Onboarding' | 'Maintenance' | 'Reference' | 'Operations';
-export type FlagGroup = 'Project' | 'Framework' | 'Consent' | 'Output' | 'General' | 'Command';
-export interface FlagDefinition {
-    kind: FlagKind;
-    negatable?: boolean;
-    description: string;
-    metavar?: string;
-    defaultValue?: string;
-    group: FlagGroup;
-}
-export interface CommandDefinition {
-    description: string;
-    usage: string;
-    group: CommandGroup;
-    flags: Readonly<Record<string, FlagDefinition>>;
-    arguments?: readonly ArgumentDefinition[];
-    subcommands?: readonly string[];
-    defaultMaxPositionals: number;
-    subcommandMaxPositionals?: Readonly<Record<string, number>>;
-}
-export interface ArgumentDefinition {
-    syntax: string;
-    description: string;
-}
-export interface HelpEntry {
-    syntax: string;
-    description: string;
-    defaultValue?: string;
-}
-export interface HelpGroup {
-    title: string;
-    entries: HelpEntry[];
-}
-export interface GeneralHelpModel {
-    version: string;
-    title: string;
-    subtitle: string;
-    usage: string;
-    globalOptions: HelpEntry[];
-    commandGroups: HelpGroup[];
-    hint: string;
-}
-export interface CommandHelpModel {
-    command: string;
-    description: string;
-    usage: string;
-    arguments: HelpEntry[];
-    subcommands: string[];
-    optionGroups: HelpGroup[];
-}
-export declare const commandDefinitions: Readonly<Record<string, CommandDefinition>>;
-export declare class UsageError extends Error {
-    constructor(message: string);
-}
-export declare function parseArgs(argv: string[]): ParsedArgs;
-export declare function getCommandHelp(command: string, subcommand?: string): CommandHelpModel;
-export declare function formatCommandHelp(command: string, subcommand?: string): string;
-export declare function getGeneralHelp(version: string): GeneralHelpModel;
-export declare function formatGeneralHelp(version: string): string;
-export declare function readStringFlag(flags: ParsedArgs['flags'], name: string): string | undefined;
-export declare function readBooleanFlag(flags: ParsedArgs['flags'], name: string): boolean | undefined;
-export declare function readListFlag(flags: ParsedArgs['flags'], name: string): string[] | undefined;
-export {};
+export type { ArgumentDefinition, CommandDefinition, CommandGroup, CommandHelpModel, FlagDefinition, FlagGroup, GeneralHelpModel, HelpEntry, HelpGroup } from './cli/args/contracts.js';
+export { commandDefinitions } from './cli/args/definitions.js';
+export { UsageError, parseArgs } from './cli/args/parser.js';
+export { formatCommandHelp, formatGeneralHelp, getCommandHelp, getGeneralHelp } from './cli/args/help.js';
+export { readBooleanFlag, readListFlag, readStringFlag } from './cli/args/readers.js';

package/dist/args.js

@@ -1,473 +1,5 @@
-import { canonicalDefaultEnvironmentIds } from './catalogs.js';
-const booleanFlag = (description, group, negatable = false, defaultValue) => ({ kind: 'boolean', description, group, negatable, ...(defaultValue ? { defaultValue } : {}) });
-const valueFlag = (description, group, metavar = 'value', defaultValue) => ({ kind: 'value', description, group, metavar, ...(defaultValue ? { defaultValue } : {}) });
-const helpFlag = { help: booleanFlag('Show command-specific help', 'General') };
-const projectFlags = {
-    project: valueFlag('Project name or project path', 'Project', 'path'),
-    type: valueFlag('Project workload type', 'Project', 'workload'),
-    genai: booleanFlag('Create a GenAI project; use --no-genai for a standard API', 'Project', true),
-    api: valueFlag('Backend API stack', 'Project', 'stack'),
-    pattern: valueFlag('GenAI application pattern', 'Project', 'pattern'),
-    cloud: valueFlag('Cloud provider', 'Project', 'provider', 'azure'),
-    region: valueFlag('Cloud deployment region', 'Project', 'region', 'eastus'),
-    frontend: booleanFlag('Include the Vue frontend starter', 'Project', true, 'false'),
-    environments: valueFlag('Comma-separated environments', 'Project', 'list', canonicalDefaultEnvironmentIds.join(',')),
-    spec: valueFlag('Spec-driven framework', 'Framework', 'framework', 'openspec'),
-    agents: valueFlag('Comma-separated AI coding agents', 'Framework', 'list', 'copilot'),
-    'default-agent': valueFlag('Primary agent for Spec Kit when multiple agents are selected', 'Framework', 'agent'),
-    governance: valueFlag('Repository-governance profile', 'Framework', 'profile', 'single-maintainer-gitflow'),
-    'code-apps-plugin': booleanFlag('Request the Microsoft Code Apps agent plugin (Preview)', 'Framework', true, 'false'),
-    'copilot-cloud': booleanFlag('Set up the GitHub-hosted Copilot coding agent for OpenSpec', 'Framework', true, 'false'),
-    'configure-openspec-profile': booleanFlag('Authorize the required global OpenSpec workflow profile', 'Consent'),
-    config: valueFlag('Load deterministic project options from JSON', 'Project', 'file')
-};
-export const commandDefinitions = {
-    help: {
-        description: 'Show general or command-specific help',
-        usage: '[command]',
-        group: 'Reference',
-        flags: helpFlag,
-        arguments: [{ syntax: 'command', description: 'Command to describe' }],
-        defaultMaxPositionals: 1
-    },
-    init: {
-        description: 'Initialize a project and prepare its workstation',
-        usage: '[project-name]',
-        group: 'Onboarding',
-        flags: {
-            ...projectFlags,
-            yes: booleanFlag('Accept project defaults and plan confirmation', 'Consent'),
-            force: booleanFlag('Authorize replacement of listed regular-file conflicts', 'Consent'),
-            'install-tools': booleanFlag('Authorize allowlisted workstation tool installation', 'Consent'),
-            'install-dependencies': booleanFlag('Authorize project-local dependency installation', 'Consent'),
-            ...helpFlag
-        },
-        arguments: [{ syntax: 'project-name', description: 'Project identity or child directory name' }],
-        defaultMaxPositionals: 1
-    },
-    plan: {
-        description: 'Preview generated artifacts',
-        usage: '',
-        group: 'Onboarding',
-        flags: { ...projectFlags, ...helpFlag },
-        defaultMaxPositionals: 0
-    },
-    patterns: {
-        description: 'List GenAI patterns',
-        usage: '',
-        group: 'Reference',
-        flags: helpFlag,
-        defaultMaxPositionals: 0
-    },
-    providers: {
-        description: 'List cloud providers',
-        usage: '',
-        group: 'Reference',
-        flags: helpFlag,
-        defaultMaxPositionals: 0
-    },
-    regions: {
-        description: 'List or search provider regions',
-        usage: '[search <query>]',
-        group: 'Reference',
-        flags: {
-            cloud: valueFlag('Cloud provider', 'Project', 'provider', 'azure'),
-            region: valueFlag('Exact region identifier', 'Project', 'region'),
-            ...helpFlag
-        },
-        subcommands: ['search'],
-        arguments: [{ syntax: 'query', description: 'Region name, slug, geography, or alias to search' }],
-        defaultMaxPositionals: 0,
-        subcommandMaxPositionals: { search: 1 }
-    },
-    validate: {
-        description: 'Validate a generated project manifest',
-        usage: '[project-path]',
-        group: 'Maintenance',
-        flags: {
-            project: valueFlag('Project path', 'Project', 'path'),
-            json: booleanFlag('Emit machine-readable JSON', 'Output'),
-            ...helpFlag
-        },
-        arguments: [{ syntax: 'project-path', description: 'Generated project to validate' }],
-        defaultMaxPositionals: 1
-    },
-    update: {
-        description: 'Reconcile Liftoff-managed core files in a project',
-        usage: '[project-path]',
-        group: 'Maintenance',
-        flags: {
-            project: valueFlag('Project path', 'Project', 'path'),
-            check: booleanFlag('Report drift without changing project files', 'Command'),
-            force: booleanFlag('Replace modified managed files', 'Consent'),
-            json: booleanFlag('Emit machine-readable JSON', 'Output'),
-            ...helpFlag
-        },
-        arguments: [{ syntax: 'project-path', description: 'Generated project to reconcile' }],
-        defaultMaxPositionals: 1
-    },
-    upgrade: {
-        description: 'Replace the supported global npm Liftoff CLI; project templates use update separately',
-        usage: '',
-        group: 'Maintenance',
-        flags: {
-            check: booleanFlag('Check for an installable stable CLI update without changing anything', 'Command'),
-            json: booleanFlag('Emit one machine-readable result object', 'Output'),
-            ...helpFlag
-        },
-        defaultMaxPositionals: 0
-    },
-    migrate: {
-        description: 'Adopt an existing project',
-        usage: '<source-path>',
-        group: 'Onboarding',
-        flags: {
-            ...projectFlags,
-            yes: booleanFlag('Accept project defaults and plan confirmation', 'Consent'),
-            force: booleanFlag('Retained for parity; never overrides the fresh migration target guard', 'Consent'),
-            'install-tools': booleanFlag('Authorize allowlisted workstation tool installation', 'Consent'),
-            'install-dependencies': booleanFlag('Authorize project-local dependency installation', 'Consent'),
-            ...helpFlag
-        },
-        arguments: [{ syntax: 'source-path', description: 'Existing application to migrate without modifying it' }],
-        defaultMaxPositionals: 1
-    },
-    doctor: {
-        description: 'Check local and project readiness',
-        usage: '',
-        group: 'Maintenance',
-        flags: {
-            cloud: valueFlag('Cloud provider to inspect', 'Project', 'provider', 'azure'),
-            json: booleanFlag('Emit machine-readable JSON', 'Output'),
-            ...helpFlag
-        },
-        defaultMaxPositionals: 0
-    },
-    governance: {
-        description: 'Inspect governance activation and assess policy alignment',
-        usage: '<status|plan|apply-next|resume|verify|assess> [project-path]',
-        group: 'Operations',
-        flags: {
-            project: valueFlag('Liftoff project path', 'Project', 'path'),
-            execute: booleanFlag('Execute the reviewed governance apply-next plan; required for any mutation', 'Consent'),
-            live: booleanFlag('Assess only: request bounded read-only GitHub/Azure metadata with existing permissions', 'Consent'),
-            json: booleanFlag('Emit machine-readable JSON', 'Output'),
-            ...helpFlag
-        },
-        subcommands: ['status', 'plan', 'apply-next', 'resume', 'verify', 'assess'],
-        arguments: [{ syntax: 'project-path', description: 'Liftoff project to inspect' }],
-        defaultMaxPositionals: 0,
-        subcommandMaxPositionals: {
-            status: 1,
-            plan: 1,
-            'apply-next': 1,
-            resume: 1,
-            verify: 1,
-            assess: 1
-        }
-    },
-    dev: {
-        description: 'Print Docker Compose helper commands',
-        usage: '[up|down|logs|reset]',
-        group: 'Operations',
-        flags: { profile: valueFlag('Docker Compose profile', 'Command', 'name'), ...helpFlag },
-        subcommands: ['up', 'down', 'logs', 'reset'],
-        defaultMaxPositionals: 0,
-        subcommandMaxPositionals: { up: 0, down: 0, logs: 0, reset: 0 }
-    },
-    infra: {
-        description: 'Print OpenTofu helper commands',
-        usage: '[init|plan|apply|output]',
-        group: 'Operations',
-        flags: { env: valueFlag('Target environment', 'Command', 'environment', 'dev'), ...helpFlag },
-        subcommands: ['init', 'plan', 'apply', 'output'],
-        defaultMaxPositionals: 0,
-        subcommandMaxPositionals: { init: 0, plan: 0, apply: 0, output: 0 }
-    }
-};
-export class UsageError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'UsageError';
-    }
-}
-function assignFlag(flags, name, value) {
-    if (Object.hasOwn(flags, name)) {
-        throw new UsageError(`Flag --${name} may be provided only once.`);
-    }
-    flags[name] = value;
-}
-function parseBooleanValue(name, value) {
-    if (value === 'true') {
-        return true;
-    }
-    if (value === 'false') {
-        return false;
-    }
-    throw new UsageError(`Flag --${name} expects true or false.`);
-}
-export function parseArgs(argv) {
-    if (argv.length === 0) {
-        return { positional: [], flags: {} };
-    }
-    if (argv[0] === '--help') {
-        return { command: 'help', positional: [], flags: {} };
-    }
-    if (argv[0] === '--version') {
-        return { command: 'version', positional: [], flags: {} };
-    }
-    const command = argv[0];
-    if (command.startsWith('-')) {
-        throw new UsageError(`Unknown option: ${command}. Run \`liftoff help\` for usage.`);
-    }
-    if (command === 'create') {
-        throw new UsageError('The `liftoff create` command was replaced by `liftoff init`. Run `liftoff init --help` for usage.');
-    }
-    const definition = commandDefinitions[command];
-    if (!definition) {
-        throw new UsageError(`Unknown command: ${command}. Run \`liftoff help\` for usage.`);
-    }
-    const tokens = argv.slice(1);
-    let subcommand;
-    if (definition.subcommands && tokens[0] && !tokens[0].startsWith('-')) {
-        const candidate = tokens.shift();
-        if (!definition.subcommands.includes(candidate)) {
-            throw new UsageError(`Unsupported ${command} subcommand: ${candidate}. Use one of: ${definition.subcommands.join(', ')}.`);
-        }
-        subcommand = candidate;
-    }
-    const positional = [];
-    const flags = {};
-    let positionalOnly = false;
-    for (let index = 0; index < tokens.length; index += 1) {
-        const token = tokens[index];
-        if (token === '--') {
-            positionalOnly = true;
-            continue;
-        }
-        if (positionalOnly || !token.startsWith('-')) {
-            positional.push(token);
-            continue;
-        }
-        if (!token.startsWith('--')) {
-            throw new UsageError(`Unknown option: ${token}. Liftoff options use --long-name syntax.`);
-        }
-        const withoutPrefix = token.slice(2);
-        const equalsIndex = withoutPrefix.indexOf('=');
-        const rawName = equalsIndex >= 0 ? withoutPrefix.slice(0, equalsIndex) : withoutPrefix;
-        const inlineValue = equalsIndex >= 0 ? withoutPrefix.slice(equalsIndex + 1) : undefined;
-        const negated = rawName.startsWith('no-');
-        const name = negated ? rawName.slice(3) : rawName;
-        const flagDefinition = definition.flags[name];
-        if (!flagDefinition) {
-            if (command === 'update' && name === 'apply') {
-                const legacyForceRequested = flags.force === true ||
-                    tokens.slice(index + 1).some((candidate) => candidate === '--force' || candidate === '--force=true');
-                throw new UsageError(legacyForceRequested
-                    ? 'Flag --apply was removed. Replace this command with `liftoff update --force`, ' +
-                        'or use `liftoff update --check` for a read-only managed-core check.'
-                    : 'Flag --apply was removed. Run `liftoff update` to apply safe managed-core changes or ' +
-                        '`liftoff update --check` for a read-only managed-core check.');
-            }
-            throw new UsageError(`Unknown flag for ${command}: --${rawName}.`);
-        }
-        if (negated) {
-            if (inlineValue !== undefined || flagDefinition.kind !== 'boolean' || !flagDefinition.negatable) {
-                throw new UsageError(`Flag --${name} does not support the --no-${name} form.`);
-            }
-            assignFlag(flags, name, false);
-            continue;
-        }
-        if (flagDefinition.kind === 'boolean') {
-            assignFlag(flags, name, inlineValue === undefined ? true : parseBooleanValue(name, inlineValue));
-            continue;
-        }
-        if (inlineValue !== undefined) {
-            if (inlineValue.length === 0) {
-                throw new UsageError(`Missing value for --${name}.`);
-            }
-            assignFlag(flags, name, inlineValue);
-            continue;
-        }
-        const next = tokens[index + 1];
-        if (!next || next.startsWith('-')) {
-            throw new UsageError(`Missing value for --${name}.`);
-        }
-        assignFlag(flags, name, next);
-        index += 1;
-    }
-    if (command === 'update' && flags.check === true && flags.force === true) {
-        throw new UsageError('Flags --check and --force cannot be combined. Run `liftoff update --check` ' +
-            'to inspect managed-core drift or `liftoff update --force` to overwrite core conflicts.');
-    }
-    if (command === 'governance') {
-        if (Object.hasOwn(flags, 'live') && subcommand !== 'assess') {
-            throw new UsageError('Flag --live is allowed only for `liftoff governance assess`.');
-        }
-        if (subcommand === 'assess') {
-            if (Object.hasOwn(flags, 'execute')) {
-                throw new UsageError('Flag --execute is not allowed for read-only `liftoff governance assess`.');
-            }
-            if (positional.length > 0 && Object.hasOwn(flags, 'project')) {
-                throw new UsageError('Provide the assessment project either positionally or with --project, not both.');
-            }
-        }
-    }
-    const maxPositionals = subcommand
-        ? definition.subcommandMaxPositionals?.[subcommand] ?? 0
-        : definition.defaultMaxPositionals;
-    if (positional.length > maxPositionals) {
-        throw new UsageError(`Too many positional arguments for ${command}${subcommand ? ` ${subcommand}` : ''}. ` +
-            `Usage: liftoff ${command}${definition.usage ? ` ${definition.usage}` : ''}`);
-    }
-    if (command === 'help' && positional[0] && !commandDefinitions[positional[0]]) {
-        throw new UsageError(`Unknown command for help: ${positional[0]}.`);
-    }
-    return { command, subcommand, positional, flags };
-}
-function flagSyntax(name, flag) {
-    const value = flag.kind === 'value' ? ` <${flag.metavar ?? 'value'}>` : '';
-    const negated = flag.negatable ? ` / --no-${name}` : '';
-    return `--${name}${value}${negated}`;
-}
-export function getCommandHelp(command, subcommand) {
-    const assessment = command === 'governance' && subcommand === 'assess';
-    const definition = assessment
-        ? {
-            description: 'Read-only comparison against the installed CLI policy, activation identity, and control catalog. Local-only by default: no network or credentials required. Exit 0: aligned or explicitly disabled (not-applicable); 2: partial coverage or differences, including approved exceptions; 1: invalid or unsafe input. This is not setup, an upgrade, or permission to remediate.',
-            usage: '[project-path] [--json] [--live]',
-            group: 'Operations',
-            flags: {
-                project: commandDefinitions.governance.flags.project,
-                live: booleanFlag('Opt into bounded repository/resource-scoped GitHub/Azure reads using existing permissions; denied or unavailable proof stays not-observed', 'Consent'),
-                json: booleanFlag('Emit the schema-v1 report with pinned target, findings, provenance, and coverage to stdout; never write state or evidence', 'Output'),
-                ...helpFlag
-            },
-            arguments: commandDefinitions.governance.arguments,
-            defaultMaxPositionals: 1
-        }
-        : commandDefinitions[command];
-    if (!definition) {
-        throw new UsageError(`Unknown command for help: ${command}.`);
-    }
-    const helpCommand = assessment ? 'governance assess' : command;
-    const groupedFlags = Object.entries(definition.flags).reduce((groups, entry) => {
-        const group = entry[1].group;
-        const entries = groups.get(group) ?? [];
-        entries.push(entry);
-        groups.set(group, entries);
-        return groups;
-    }, new Map());
-    return {
-        command: helpCommand,
-        description: definition.description,
-        usage: `liftoff ${helpCommand}${definition.usage ? ` ${definition.usage}` : ''}`,
-        arguments: (definition.arguments ?? []).map((argument) => ({
-            syntax: argument.syntax,
-            description: argument.description
-        })),
-        subcommands: [...(definition.subcommands ?? [])],
-        optionGroups: [...groupedFlags].map(([group, entries]) => ({
-            title: `${group} options`,
-            entries: entries.map(([name, flag]) => ({
-                syntax: flagSyntax(name, flag),
-                description: flag.description,
-                ...(flag.defaultValue ? { defaultValue: flag.defaultValue } : {})
-            }))
-        }))
-    };
-}
-export function formatCommandHelp(command, subcommand) {
-    const help = getCommandHelp(command, subcommand);
-    const lines = [
-        `${help.command} - ${help.description}`,
-        '',
-        `Usage: ${help.usage}`
-    ];
-    if (help.arguments.length > 0) {
-        lines.push('', 'Arguments:');
-        const width = Math.max(...help.arguments.map((argument) => argument.syntax.length));
-        for (const argument of help.arguments) {
-            lines.push(`  ${argument.syntax.padEnd(width)}  ${argument.description}`);
-        }
-    }
-    if (help.subcommands.length > 0) {
-        lines.push('', `Subcommands: ${help.subcommands.join(', ')}`);
-    }
-    for (const group of help.optionGroups) {
-        lines.push('', `${group.title}:`);
-        const width = Math.max(...group.entries.map((entry) => entry.syntax.length));
-        for (const entry of group.entries) {
-            const defaultValue = entry.defaultValue ? ` (default: ${entry.defaultValue})` : '';
-            lines.push(`  ${entry.syntax.padEnd(width)}  ${entry.description}${defaultValue}`);
-        }
-    }
-    return `${lines.join('\n')}\n`;
-}
-const commandGroupOrder = ['Onboarding', 'Maintenance', 'Reference', 'Operations'];
-export function getGeneralHelp(version) {
-    const commandGroups = commandGroupOrder.flatMap((group) => {
-        const entries = Object.entries(commandDefinitions)
-            .filter(([, definition]) => definition.group === group)
-            .map(([command, definition]) => ({
-            syntax: command,
-            description: definition.description
-        }));
-        return entries.length > 0 ? [{ title: group, entries }] : [];
-    });
-    return {
-        version,
-        title: `Mission Control Liftoff ${version}`,
-        subtitle: 'Initialize a governed application and prepare its local workstation.',
-        usage: 'liftoff <command> [options]',
-        globalOptions: [
-            { syntax: '--version', description: 'Show the installed Liftoff version' },
-            { syntax: '--help', description: 'Show general help' }
-        ],
-        commandGroups,
-        hint: 'Run `liftoff help <command>` for command-specific usage.'
-    };
-}
-export function formatGeneralHelp(version) {
-    const help = getGeneralHelp(version);
-    const lines = [
-        help.title,
-        help.subtitle,
-        '',
-        `Usage: ${help.usage}`,
-        '',
-        'Global options:'
-    ];
-    const globalWidth = Math.max(...help.globalOptions.map((option) => option.syntax.length));
-    for (const option of help.globalOptions) {
-        lines.push(`  ${option.syntax.padEnd(globalWidth)}  ${option.description}`);
-    }
-    for (const group of help.commandGroups) {
-        const width = Math.max(...group.entries.map((entry) => entry.syntax.length));
-        lines.push('', `${group.title}:`);
-        for (const entry of group.entries) {
-            lines.push(`  ${entry.syntax.padEnd(width)}  ${entry.description}`);
-        }
-    }
-    lines.push('', help.hint);
-    return `${lines.join('\n')}\n`;
-}
-export function readStringFlag(flags, name) {
-    const value = flags[name];
-    return typeof value === 'string' ? value : undefined;
-}
-export function readBooleanFlag(flags, name) {
-    const value = flags[name];
-    return typeof value === 'boolean' ? value : undefined;
-}
-export function readListFlag(flags, name) {
-    const value = flags[name];
-    if (typeof value === 'string') {
-        return value.split(',').map((item) => item.trim()).filter(Boolean);
-    }
-    if (Array.isArray(value)) {
-        return value;
-    }
-    return undefined;
-}
+export { commandDefinitions } from './cli/args/definitions.js';
+export { UsageError, parseArgs } from './cli/args/parser.js';
+export { formatCommandHelp, formatGeneralHelp, getCommandHelp, getGeneralHelp } from './cli/args/help.js';
+export { readBooleanFlag, readListFlag, readStringFlag } from './cli/args/readers.js';
 //# sourceMappingURL=args.js.map