@msn-control/liftoff 0.10.4 → 0.11.2

package/dist/cli/args/contracts.d.ts

@@ -0,0 +1,51 @@
+export 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[];
+}

package/dist/cli/args/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/cli/args/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/cli/args/contracts.ts"],"names":[],"mappings":""}

package/dist/cli/args/definitions.d.ts

@@ -0,0 +1,6 @@
+import type { CommandDefinition, FlagDefinition, FlagGroup } from './contracts.js';
+export declare const booleanFlag: (description: string, group: FlagGroup, negatable?: boolean, defaultValue?: string) => FlagDefinition;
+export declare const helpFlag: {
+    help: FlagDefinition;
+};
+export declare const commandDefinitions: Readonly<Record<string, CommandDefinition>>;

package/dist/cli/args/definitions.js

@@ -0,0 +1,188 @@
+import { canonicalDefaultEnvironmentIds } from '../../application/project/catalog.js';
+export 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 } : {}) });
+export 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'),
+    '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: 'Preview and explicitly approve scoped project updates',
+        usage: '[project-path]',
+        group: 'Maintenance',
+        flags: {
+            project: valueFlag('Project path', 'Project', 'path'),
+            check: booleanFlag('Preview normal and eligible forced plans without project writes; save an external preview receipt', 'Command'),
+            force: booleanFlag('Select the separately previewed forced plan for exact owned-core conflicts and retired aliases; still requires approval', 'Consent'),
+            'approve-plan': valueFlag('Approve the exact effective plan from check using its full lowercase 64-hex SHA-256 fingerprint', 'Consent', 'fingerprint'),
+            json: booleanFlag('Emit one schema-3 result on stdout; interactive approval uses stderr and still defaults to no', '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 }
+    }
+};
+//# sourceMappingURL=definitions.js.map

package/dist/cli/args/definitions.js.map

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

package/dist/cli/args/help.d.ts

@@ -0,0 +1,5 @@
+import type { CommandHelpModel, GeneralHelpModel } from './contracts.js';
+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;

package/dist/cli/args/help.js

@@ -0,0 +1,142 @@
+import { booleanFlag, commandDefinitions, helpFlag } from './definitions.js';
+import { UsageError } from './parser.js';
+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
+        }
+        : command === 'update'
+            ? {
+                ...commandDefinitions.update,
+                description: 'Start with `liftoff update --check`, then run `liftoff update` to approve the matching ' +
+                    'effective plan (default: no). Check leaves project bytes unchanged and saves a project-bound ' +
+                    'receipt in user-local liftoff/update-previews storage outside the repository; the receipt ' +
+                    'is not approval. Apply needs the same checkout and receipt store. Noninteractive apply ' +
+                    'requires --approve-plan; force and JSON are not consent. Production files, history, and ' +
+                    'provisioning collisions remain protected; force cannot bypass compatibility. ' +
+                    'Exit 0: clean or approved scope completed; 2: drift or committed migration with incomplete ' +
+                    'revalidation; 1: rejected or failed operation.'
+            }
+            : 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`;
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/args/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/cli/args/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,SAAS,UAAU,CAAC,IAAY,EAAE,IAAoB;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,OAAO,KAAK,IAAI,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,UAAmB;IACjE,MAAM,UAAU,GAAG,OAAO,KAAK,YAAY,IAAI,UAAU,KAAK,QAAQ,CAAC;IACvE,MAAM,UAAU,GAAkC,UAAU;QAC1D,CAAC,CAAC;YACE,WAAW,EAAE,gXAAgX;YAC7X,KAAK,EAAE,kCAAkC;YACzC,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE;gBACL,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO;gBACpD,IAAI,EAAE,WAAW,CAAC,2IAA2I,EAAE,SAAS,CAAC;gBACzK,IAAI,EAAE,WAAW,CAAC,2HAA2H,EAAE,QAAQ,CAAC;gBACxJ,GAAG,QAAQ;aACZ;YACD,SAAS,EAAE,kBAAkB,CAAC,UAAU,CAAC,SAAS;YAClD,qBAAqB,EAAE,CAAC;SACzB;QACH,CAAC,CAAC,OAAO,KAAK,QAAQ;YACpB,CAAC,CAAC;gBACE,GAAG,kBAAkB,CAAC,MAAM;gBAC5B,WAAW,EACT,yFAAyF;oBACzF,+FAA+F;oBAC/F,4FAA4F;oBAC5F,yFAAyF;oBACzF,0FAA0F;oBAC1F,+EAA+E;oBAC/E,6FAA6F;oBAC7F,gDAAgD;aACnD;YACH,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,UAAU,CAAC,6BAA6B,OAAO,GAAG,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/D,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC7E,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,IAAI,GAAG,EAA8C,CAAC,CAAC;IAC1D,OAAO;QACL,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,KAAK,EAAE,WAAW,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QAChF,SAAS,EAAE,CAAC,UAAU,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACzD,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,WAAW,EAAE,QAAQ,CAAC,WAAW;SAClC,CAAC,CAAC;QACH,WAAW,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAChD,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YACzD,KAAK,EAAE,GAAG,KAAK,UAAU;YACzB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtC,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC;gBAC9B,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClE,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,UAAmB;IACpE,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG;QACZ,GAAG,IAAI,CAAC,OAAO,MAAM,IAAI,CAAC,WAAW,EAAE;QACvC,EAAE;QACF,UAAU,IAAI,CAAC,KAAK,EAAE;KACvB,CAAC;IACF,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACpF,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7E,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,WAAW,GAAG,YAAY,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,iBAAiB,GAAmB,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AAEnG,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,aAAa,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAe,EAAE;QACrE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC;aAC/C,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,KAAK,KAAK,CAAC;aACtD,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,MAAM,EAAE,OAAO;YACf,WAAW,EAAE,UAAU,CAAC,WAAW;SACpC,CAAC,CAAC,CAAC;QACN,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;IACH,OAAO;QACL,OAAO;QACP,KAAK,EAAE,2BAA2B,OAAO,EAAE;QAC3C,QAAQ,EAAE,sEAAsE;QAChF,KAAK,EAAE,6BAA6B;QACpC,aAAa,EAAE;YACb,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC1E,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;SACvD;QACD,aAAa;QACb,IAAI,EAAE,0DAA0D;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG;QACZ,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,QAAQ;QACb,EAAE;QACF,UAAU,IAAI,CAAC,KAAK,EAAE;QACtB,EAAE;QACF,iBAAiB;KAClB,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1F,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}

package/dist/cli/args/parser.d.ts

@@ -0,0 +1,5 @@
+import type { ParsedArgs } from '../../domain/project/contracts.js';
+export declare class UsageError extends Error {
+    constructor(message: string);
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;

package/dist/cli/args/parser.js

@@ -0,0 +1,160 @@
+import { isUpdatePlanFingerprint } from '../../application/update/approval.js';
+import { commandDefinitions } from './definitions.js';
+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 (name === 'code-apps-plugin') {
+                throw new UsageError(`Flag --${rawName} was removed because Power Apps code apps are retired and unsupported.`);
+            }
+            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. Run `liftoff update --check` first to review the separate ' +
+                        'forced plan and save its external receipt, then explicitly approve it with ' +
+                        '`liftoff update --force`. Force does not bypass preview or approval.'
+                    : 'Flag --apply was removed. Run `liftoff update --check` first to preview changes and ' +
+                        'save an external receipt, then run `liftoff update` to explicitly approve the matching plan.');
+            }
+            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') {
+        if (Object.hasOwn(flags, 'approve-plan')) {
+            if (!isUpdatePlanFingerprint(flags['approve-plan'])) {
+                throw new UsageError('Flag --approve-plan expects the complete fingerprint from `liftoff update --check`: ' +
+                    'exactly 64 lowercase hexadecimal characters.');
+            }
+            if (flags.check === true) {
+                throw new UsageError('Flags --check and --approve-plan cannot be combined. Run `liftoff update --check` first, ' +
+                    'then approve its exact effective plan with `liftoff update --approve-plan <fingerprint>`.');
+            }
+        }
+        if (flags.check === true && flags.force === true) {
+            throw new UsageError('Flags --check and --force cannot be combined. Run `liftoff update --check` ' +
+                'to review the normal and eligible forced plans, then explicitly approve the matching ' +
+                'forced plan with `liftoff update --force`.');
+        }
+    }
+    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 };
+}
+//# sourceMappingURL=parser.js.map

package/dist/cli/args/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/cli/args/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,SAAS,UAAU,CACjB,KAA0B,EAC1B,IAAY,EACZ,KAAuB;IAEvB,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,UAAU,CAAC,UAAU,IAAI,6BAA6B,CAAC,CAAC;IACpE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;AACtB,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,KAAa;IACpD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,UAAU,CAAC,UAAU,IAAI,yBAAyB,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IACD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAAC,mBAAmB,OAAO,mCAAmC,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,IAAI,UAAU,CAAC,mGAAmG,CAAC,CAAC;IAC5H,CAAC;IACD,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,UAAU,CAAC,oBAAoB,OAAO,mCAAmC,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,UAA8B,CAAC;IACnC,IAAI,UAAU,CAAC,WAAW,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,EAAG,CAAC;QAClC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,UAAU,CAClB,eAAe,OAAO,gBAAgB,SAAS,iBAAiB,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrG,CAAC;QACJ,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,cAAc,GAAG,IAAI,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,cAAc,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,UAAU,CAAC,mBAAmB,KAAK,2CAA2C,CAAC,CAAC;QAC5F,CAAC;QAED,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QACvF,MAAM,WAAW,GAAG,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAClD,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAChC,MAAM,IAAI,UAAU,CAClB,UAAU,OAAO,wEAAwE,CAC1F,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC7C,MAAM,oBAAoB,GACxB,KAAK,CAAC,KAAK,KAAK,IAAI;oBACpB,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CACzC,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,cAAc,CACxD,CAAC;gBACJ,MAAM,IAAI,UAAU,CAClB,oBAAoB;oBAClB,CAAC,CAAC,sFAAsF;wBACtF,6EAA6E;wBAC7E,sEAAsE;oBACxE,CAAC,CAAC,sFAAsF;wBACtF,8FAA8F,CACnG,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,UAAU,CAAC,oBAAoB,OAAO,OAAO,OAAO,GAAG,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,WAAW,KAAK,SAAS,IAAI,cAAc,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;gBAChG,MAAM,IAAI,UAAU,CAAC,UAAU,IAAI,8BAA8B,IAAI,QAAQ,CAAC,CAAC;YACjF,CAAC;YACD,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,IAAI,cAAc,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACtC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;YACjG,SAAS;QACX,CAAC;QAED,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,UAAU,CAAC,uBAAuB,IAAI,GAAG,CAAC,CAAC;YACvD,CAAC;YACD,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;YACrC,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,UAAU,CAAC,uBAAuB,IAAI,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,UAAU,CAClB,sFAAsF;oBACpF,8CAA8C,CACjD,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACzB,MAAM,IAAI,UAAU,CAClB,2FAA2F;oBACzF,2FAA2F,CAC9F,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACjD,MAAM,IAAI,UAAU,CAClB,6EAA6E;gBAC3E,uFAAuF;gBACvF,4CAA4C,CAC/C,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC5D,MAAM,IAAI,UAAU,CAAC,8DAA8D,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,UAAU,CAAC,0EAA0E,CAAC,CAAC;YACnG,CAAC;YACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,UAAU,CAAC,iFAAiF,CAAC,CAAC;YAC1G,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,UAAU;QAC/B,CAAC,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QACxD,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC;IACrC,IAAI,UAAU,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAClB,qCAAqC,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI;YACnF,kBAAkB,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/E,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,UAAU,CAAC,6BAA6B,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACpD,CAAC"}

package/dist/cli/args/readers.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedArgs } from '../../domain/project/contracts.js';
+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;

package/dist/cli/args/readers.js

@@ -0,0 +1,19 @@
+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;
+}
+//# sourceMappingURL=readers.js.map

package/dist/cli/args/readers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readers.js","sourceRoot":"","sources":["../../../src/cli/args/readers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,KAA0B,EAAE,IAAY;IACrE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAA0B,EAAE,IAAY;IACtE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA0B,EAAE,IAAY;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}