@contentful/experience-design-system-cli 2.26.1-dev-build-a852362.0 → 2.26.1-dev-build-f03f014.0

package/dist/src/apply/command.js

@@ -1,845 +0,0 @@
-import { createElement, useState } from 'react';
-import { render, useInput } from 'ink';
-import { access, readFile, readdir, stat } from 'node:fs/promises';
-import { join } from 'node:path';
-import { validateCDF, flattenDTCG, validateDTCG, buildManifest, buildFilteredManifest, } from '@contentful/experience-design-system-types';
-import { ApiError, ImportApiClient } from './api-client.js';
-import { formatApiError, formatEdsiError } from '../lib/error-parser.js';
-import { openPipelineDb, loadCDFComponents } from '../session/db.js';
-import { findSlotCycles, suggestCycleBreakEdge, formatCyclePath } from '../analyze/cycle-detection.js';
-import { isEmptyPreview } from './preview-utils.js';
-import { ServerPreviewApp, ServerPreviewConfirm, ServerApplyProgress, ServerApplyDone } from './tui/ServerApplyView.js';
-import { SelectView, makeSelectKey } from './tui/SelectView.js';
-import { buildPostPushUrl } from '../lib/contentful-urls.js';
-import { resolveCompositionMode } from '../lib/composition-mode.js';
-import { addAllowDeletionsOption, addArtifactInputOptions, addCompositionOptions, addContentfulTargetOptions, addSelectionOptions, } from '../lib/command-options.js';
-import { stripAllowedComponents } from '../import/strip-allowed-components.js';
-import { readExperiencesCredentials } from '../credentials-store.js';
-import { getInteractiveTerminalSupport, requireInteractiveTerminal } from '../lib/terminal-capabilities.js';
-import { bindAnalyticsSessionId, exitWithAnalytics, failureFromApiError, recordApplyOutcome, recordContentfulContext, } from '../analytics/index.js';
-async function die(message, fields = {}) {
-    process.stderr.write(`${message}\n`);
-    return exitWithAnalytics(1, fields);
-}
-async function pathExists(p) {
-    return access(p)
-        .then(() => true)
-        .catch(() => false);
-}
-async function assertFileExists(flag, p) {
-    if (!(await pathExists(p)))
-        return await die(`Error: file not found: ${p} (from ${flag})`);
-}
-async function readJsonFile(flag, p) {
-    let text;
-    try {
-        text = await readFile(p, 'utf8');
-    }
-    catch {
-        return await die(`Error: file not found: ${p} (from ${flag})`);
-    }
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return await die(`Error: ${flag} is not valid JSON: ${p}`);
-    }
-}
-const IGNORE_TOKEN_DIRS = new Set(['node_modules', 'dist', 'build', '.next', '.nuxt', '.git']);
-async function collectJsonFiles(dir) {
-    const results = [];
-    async function walk(current) {
-        let entries;
-        try {
-            entries = await readdir(current);
-        }
-        catch {
-            return;
-        }
-        await Promise.all(entries.map(async (entry) => {
-            if (IGNORE_TOKEN_DIRS.has(entry))
-                return;
-            const full = join(current, entry);
-            let s;
-            try {
-                s = await stat(full);
-            }
-            catch {
-                return;
-            }
-            if (s.isDirectory()) {
-                await walk(full);
-            }
-            else if (entry.endsWith('.json')) {
-                results.push(full);
-            }
-        }));
-    }
-    await walk(dir);
-    return results;
-}
-export async function readTokensFromPath(flag, p) {
-    let s;
-    try {
-        s = await stat(p);
-    }
-    catch {
-        return await die(`Error: file not found: ${p} (from ${flag})`);
-    }
-    if (s.isDirectory()) {
-        const files = await collectJsonFiles(p);
-        if (files.length === 0)
-            return await die(`Error: no .json files found in directory: ${p} (from ${flag})`);
-        const merged = {};
-        for (const file of files.sort()) {
-            let text;
-            try {
-                text = await readFile(file, 'utf8');
-            }
-            catch {
-                continue;
-            }
-            let parsed;
-            try {
-                parsed = JSON.parse(text);
-            }
-            catch {
-                continue;
-            }
-            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
-                Object.assign(merged, parsed);
-            }
-        }
-        const { valid, errors } = validateDTCG(merged);
-        if (!valid)
-            return await die(`Error: ${flag} contains invalid token types:\n${errors.map((e) => `  ${e.path}: ${e.message}`).join('\n')}`);
-        return flattenDTCG(merged, '');
-    }
-    const raw = await readJsonFile(flag, p);
-    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
-        return await die(`Error: ${flag} is not valid JSON: expected an object`);
-    }
-    const { valid, errors } = validateDTCG(raw);
-    if (!valid)
-        return await die(`Error: ${flag} contains invalid token types:\n${errors.map((e) => `  ${e.path}: ${e.message}`).join('\n')}`);
-    return flattenDTCG(raw, '');
-}
-async function resolveSharedInputs(opts) {
-    if (!opts.components && !opts.tokens && !opts.session) {
-        return await die('Error: at least one of --components, --tokens, or --session is required');
-    }
-    if (opts.session && opts.components) {
-        return await die('Error: --session and --components are mutually exclusive');
-    }
-    const spaceId = opts.spaceId ?? process.env.CONTENTFUL_SPACE_ID;
-    const environmentId = opts.environmentId ?? process.env.CONTENTFUL_ENVIRONMENT_ID;
-    if (!spaceId)
-        return await die('Error: --space-id is required (or set CONTENTFUL_SPACE_ID)');
-    if (!environmentId)
-        return await die('Error: --environment-id is required (or set CONTENTFUL_ENVIRONMENT_ID)');
-    opts.spaceId = spaceId;
-    opts.environmentId = environmentId;
-    const cmaToken = opts.cmaToken ?? process.env.CONTENTFUL_MANAGEMENT_TOKEN;
-    if (!cmaToken) {
-        return await die('Error: CMA token is required. Pass --cma-token or set CONTENTFUL_MANAGEMENT_TOKEN');
-    }
-    if (opts.components)
-        await assertFileExists('--components', opts.components);
-    let components = [];
-    if (opts.session) {
-        const db = openPipelineDb();
-        try {
-            components = loadCDFComponents(db, opts.session);
-        }
-        finally {
-            db.close();
-        }
-        if (components.length === 0) {
-            return await die(`Error: session '${opts.session}' has no generated components. Run generate components first.`);
-        }
-    }
-    else if (opts.components) {
-        const raw = await readJsonFile('--components', opts.components);
-        const result = validateCDF(raw);
-        if (!result.valid) {
-            return await die(`Error: --components failed schema validation: ${result.errors.map((e) => e.message).join(', ')}`);
-        }
-        components = result.components;
-    }
-    // Atomic mode (spec T8/T12): strip embedded-component composition at the
-    // single serialization boundary, regardless of load path. Normalizing here
-    // (rather than only in loadCDFComponents) also covers hand-authored
-    // `--components` files. Starving `$allowedComponents` at this one point
-    // means slot-cycle detection downstream structurally returns zero.
-    let configMode;
-    try {
-        configMode = (await readExperiencesCredentials()).compositionMode;
-    }
-    catch {
-        // Missing credentials.json → resolver falls through to default (atomic).
-    }
-    if (resolveCompositionMode(opts, configMode) === 'atomic') {
-        components = stripAllowedComponents(components);
-    }
-    let tokens = [];
-    if (opts.tokens) {
-        tokens = await readTokensFromPath('--tokens', opts.tokens);
-    }
-    const client = new ImportApiClient({
-        host: opts.host,
-        cmaToken,
-        spaceId,
-        environmentId,
-    });
-    return { components, tokens, client };
-}
-export function detectSlotCycles(components) {
-    const cycleInput = components.map(({ key, entry }) => ({
-        name: key,
-        slots: Object.entries(entry.$slots ?? {}).map(([slotName, slotDef]) => ({
-            name: slotName,
-            allowedComponents: slotDef.$allowedComponents ?? [],
-        })),
-    }));
-    return findSlotCycles(cycleInput);
-}
-export function formatSlotCycleReport(cycles) {
-    const lines = [];
-    lines.push(`Error: manifest:components/slot-cycles — ${cycles.length} slot dependency cycle(s) detected. Push refused.`);
-    for (let i = 0; i < cycles.length; i += 1) {
-        const cycle = cycles[i];
-        lines.push(`  Cycle ${i + 1}: ${formatCyclePath(cycle)}`);
-        const suggested = suggestCycleBreakEdge(cycle, cycles);
-        lines.push(`    Fix: remove '${suggested.toComponent}' from ${suggested.fromComponent}.$slots.${suggested.slotName}.$allowedComponents`);
-    }
-    return lines;
-}
-export async function assertNoSlotCycles(components) {
-    const cycles = detectSlotCycles(components);
-    if (cycles.length === 0)
-        return;
-    process.stderr.write(formatSlotCycleReport(cycles).join('\n') + '\n');
-    await exitWithAnalytics(1);
-}
-export function extractComponentsFromManifest(manifest) {
-    const componentsManifest = manifest?.componentsManifest;
-    if (!componentsManifest)
-        return [];
-    const out = [];
-    for (const [key, value] of Object.entries(componentsManifest)) {
-        if (key === '$schema')
-            continue;
-        if (!value || typeof value !== 'object')
-            continue;
-        out.push({ key, entry: value });
-    }
-    return out;
-}
-export function hasBreakingChangesWithImpact(preview) {
-    const allChanged = [...preview.components.changed, ...preview.tokens.changed];
-    return allChanged.some((c) => c.changeClassification?.classification === 'breaking' &&
-        c.impact &&
-        (c.impact.affectedFragments > 0 || c.impact.affectedExperiences > 0));
-}
-function buildPreviewOutput(preview, spaceId, environmentId) {
-    return {
-        spaceId,
-        environmentId,
-        components: {
-            new: preview.components.new.length,
-            changed: preview.components.changed.length,
-            unchanged: preview.components.unchanged.length,
-            removed: preview.components.removed.length,
-            breaking: preview.components.changed.filter((c) => c.changeClassification?.classification === 'breaking').length,
-            draftOverwrites: preview.components.changed.filter((c) => c.hasPendingDraftChanges).length,
-        },
-        tokens: {
-            new: preview.tokens.new.length,
-            changed: preview.tokens.changed.length,
-            unchanged: preview.tokens.unchanged.length,
-            removed: preview.tokens.removed.length,
-            draftOverwrites: preview.tokens.changed.filter((c) => c.hasPendingDraftChanges).length,
-        },
-        taxonomies: {
-            new: preview.taxonomies.new.length,
-            changed: preview.taxonomies.changed.length,
-            unchanged: preview.taxonomies.unchanged.length,
-            removed: preview.taxonomies.removed.length,
-        },
-    };
-}
-function buildApplyOutput(operation, spaceId, environmentId, host) {
-    const items = operation.items ?? [];
-    const componentItems = items.filter((i) => i.entityType === 'ComponentType');
-    const tokenItems = items.filter((i) => i.entityType === 'DesignToken');
-    function countByAction(subset) {
-        return {
-            created: subset.filter((i) => i.action === 'create' && i.status === 'succeeded').length,
-            updated: subset.filter((i) => i.action === 'update' && i.status === 'succeeded').length,
-            failed: subset.filter((i) => i.status === 'failed').length,
-        };
-    }
-    return {
-        status: operation.sys.status,
-        operationId: operation.sys.id,
-        spaceId,
-        environmentId,
-        summary: operation.summary,
-        componentTypes: countByAction(componentItems),
-        designTokens: countByAction(tokenItems),
-        viewUrl: buildPostPushUrl({ host: host ?? 'api.contentful.com', spaceId, environmentId }),
-        tokensUrl: buildPostPushUrl({ host: host ?? 'api.contentful.com', spaceId, environmentId, view: 'design_tokens' }),
-        failures: items
-            .filter((item) => item.status === 'failed')
-            .map((item) => ({
-            entityType: item.entityType,
-            entityId: item.id,
-            error: formatEdsiError(item.error),
-        })),
-    };
-}
-function getSelectableEntities(preview) {
-    const entities = [];
-    for (const token of preview.tokens.new) {
-        entities.push({
-            id: token.path ?? token.id ?? '',
-            kind: 'token',
-            status: 'new',
-        });
-    }
-    for (const item of preview.tokens.changed) {
-        entities.push({ id: item.current.id, kind: 'token', status: 'changed' });
-    }
-    for (const comp of preview.components.new) {
-        entities.push({
-            id: comp.key ?? comp.id ?? '',
-            kind: 'component',
-            status: 'new',
-        });
-    }
-    for (const item of preview.components.changed) {
-        entities.push({
-            id: item.current.id,
-            kind: 'component',
-            status: 'changed',
-            isBreaking: item.changeClassification?.classification === 'breaking',
-        });
-    }
-    return entities;
-}
-function resolveNonInteractiveSelection(entities, opts) {
-    const allKeys = new Set(entities.map((e) => makeSelectKey(e.kind, e.id)));
-    if (opts.selectAll) {
-        if ((opts.select ?? []).length > 0 || (opts.deselect ?? []).length > 0) {
-            process.stderr.write('Warning: --select-all overrides --select and --deselect\n');
-        }
-        return allKeys;
-    }
-    const hasSelectPatterns = (opts.select ?? []).length > 0;
-    const selected = new Set();
-    if (!hasSelectPatterns) {
-        for (const key of allKeys)
-            selected.add(key);
-    }
-    else {
-        for (const pattern of opts.select ?? []) {
-            for (const key of allKeys) {
-                if (key.includes(pattern))
-                    selected.add(key);
-            }
-        }
-    }
-    for (const pattern of opts.deselect ?? []) {
-        for (const key of [...selected]) {
-            if (key.includes(pattern))
-                selected.delete(key);
-        }
-    }
-    return selected;
-}
-function SelectApp({ entities, spaceId, environmentId, onApply }) {
-    const allKeys = new Set(entities.map((e) => makeSelectKey(e.kind, e.id)));
-    const [selectedIndex, setSelectedIndex] = useState(0);
-    const [selected, setSelected] = useState(() => new Set(allKeys));
-    const [importing, setImporting] = useState(false);
-    useInput((input, key) => {
-        if (importing)
-            return;
-        if (key.upArrow) {
-            setSelectedIndex((prev) => Math.max(0, prev - 1));
-            return;
-        }
-        if (key.downArrow) {
-            setSelectedIndex((prev) => Math.min(entities.length - 1, prev + 1));
-            return;
-        }
-        if (input === ' ') {
-            const entity = entities[selectedIndex];
-            if (!entity)
-                return;
-            const k = makeSelectKey(entity.kind, entity.id);
-            setSelected((prev) => {
-                const next = new Set(prev);
-                if (next.has(k))
-                    next.delete(k);
-                else
-                    next.add(k);
-                return next;
-            });
-            return;
-        }
-        if (input === 'a' || input === 'A') {
-            setSelected(new Set(allKeys));
-            return;
-        }
-        if (input === 'n' || input === 'N') {
-            setSelected(new Set());
-            return;
-        }
-        if ((input === 'i' || input === 'I') && selected.size > 0) {
-            setImporting(true);
-            onApply(selected);
-            return;
-        }
-        if (input === 'q' || input === 'Q') {
-            process.exit(0);
-        }
-    });
-    return createElement(SelectView, {
-        entities,
-        spaceId,
-        environmentId,
-        selectedIndex,
-        selected,
-        importing,
-    });
-}
-export function registerApplyCommand(program) {
-    const applyCmd = program
-        .command('apply')
-        .description('Preview, select, or push design system entities to Contentful ExO');
-    const previewCmd = applyCmd.command('preview').description('Show a read-only diff of what apply push would do');
-    addArtifactInputOptions(previewCmd);
-    addContentfulTargetOptions(previewCmd);
-    addCompositionOptions(previewCmd);
-    previewCmd.action(async (opts) => {
-        let inputs;
-        try {
-            inputs = await resolveSharedInputs(opts);
-        }
-        catch (e) {
-            if (e instanceof ApiError)
-                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
-            throw e;
-        }
-        const { components, tokens, client } = inputs;
-        const spaceId = opts.spaceId;
-        const environmentId = opts.environmentId;
-        await bindAnalyticsSessionId(opts.session, {
-            space_key: spaceId,
-            environment_key: environmentId,
-        });
-        try {
-            await client.validateToken();
-        }
-        catch (e) {
-            if (e instanceof ApiError)
-                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
-            const cause = e instanceof Error && e.cause instanceof Error ? e.cause.message : '';
-            return await die(`Error: unable to connect to API host${cause ? `: ${cause}` : ''}`);
-        }
-        const manifest = buildManifest(components, tokens);
-        let preview;
-        try {
-            preview = await client.previewImport(manifest);
-        }
-        catch (e) {
-            if (e instanceof ApiError)
-                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
-            throw e;
-        }
-        recordContentfulContext(client, spaceId, environmentId);
-        if (getInteractiveTerminalSupport().supported) {
-            const { waitUntilExit } = render(createElement(ServerPreviewApp, {
-                preview,
-                spaceId,
-                environmentId,
-                allowDeletions: false,
-            }));
-            await waitUntilExit();
-        }
-        else {
-            process.stdout.write(JSON.stringify(buildPreviewOutput(preview, spaceId, environmentId), null, 2) + '\n');
-            await exitWithAnalytics(0);
-        }
-    });
-    const pushCmd = applyCmd.command('push').description('Write component types and design tokens to Contentful ExO');
-    addArtifactInputOptions(pushCmd);
-    addContentfulTargetOptions(pushCmd);
-    addCompositionOptions(pushCmd);
-    addAllowDeletionsOption(pushCmd);
-    pushCmd
-        .option('--yes', 'Skip interactive confirmation')
-        .option('--verbose', 'Show all entity progress including skipped/unchanged')
-        .option('--force', 'Skip confirmation for breaking changes (for CI)')
-        .option('--dry-run', 'Run preview only without applying')
-        .action(async (opts) => {
-        const isTTY = getInteractiveTerminalSupport().supported;
-        if (!isTTY && !opts.yes) {
-            process.stderr.write('Error: apply push requires --yes in non-interactive mode\n');
-            await exitWithAnalytics(1);
-        }
-        let inputs;
-        try {
-            inputs = await resolveSharedInputs(opts);
-        }
-        catch (e) {
-            if (e instanceof ApiError)
-                return await die(`Error: ${formatApiError(e, opts.verbose)}`, failureFromApiError(e));
-            throw e;
-        }
-        const { components, tokens, client } = inputs;
-        const spaceId = opts.spaceId;
-        const environmentId = opts.environmentId;
-        await bindAnalyticsSessionId(opts.session, {
-            space_key: spaceId,
-            environment_key: environmentId,
-        });
-        await assertNoSlotCycles(components);
-        try {
-            await client.validateToken();
-        }
-        catch (e) {
-            if (e instanceof ApiError)
-                return await die(`Error: ${formatApiError(e, opts.verbose)}`, failureFromApiError(e));
-            throw e;
-        }
-        const manifest = buildManifest(components, tokens);
-        let preview;
-        try {
-            preview = await client.previewImport(manifest, opts.allowDeletions === true);
-        }
-        catch (e) {
-            if (e instanceof ApiError)
-                return await die(`Error: ${formatApiError(e, opts.verbose)}`, failureFromApiError(e));
-            throw e;
-        }
-        recordContentfulContext(client, spaceId, environmentId);
-        if (opts.dryRun) {
-            if (isTTY) {
-                const { waitUntilExit } = render(createElement(ServerPreviewApp, {
-                    preview,
-                    spaceId,
-                    environmentId,
-                    allowDeletions: opts.allowDeletions === true,
-                }));
-                await waitUntilExit();
-            }
-            else {
-                process.stdout.write(JSON.stringify(buildPreviewOutput(preview, spaceId, environmentId), null, 2) + '\n');
-            }
-            await exitWithAnalytics(0);
-        }
-        if (isEmptyPreview(preview)) {
-            if (isTTY && !opts.yes) {
-                process.stderr.write('Nothing to change — design system is up to date.\n');
-            }
-            else {
-                process.stdout.write(JSON.stringify(buildPreviewOutput(preview, spaceId, environmentId), null, 2) + '\n');
-            }
-            await exitWithAnalytics(0);
-        }
-        const breakingWithImpact = hasBreakingChangesWithImpact(preview);
-        if (!isTTY || opts.yes) {
-            if (breakingWithImpact && !opts.force) {
-                process.stderr.write('Error: breaking changes with downstream impact detected. Use --force to acknowledge.\n');
-                process.stdout.write(JSON.stringify(buildPreviewOutput(preview, spaceId, environmentId), null, 2) + '\n');
-                await exitWithAnalytics(1);
-            }
-            const verbose = opts.verbose ?? false;
-            if (verbose) {
-                process.stderr.write(JSON.stringify(buildPreviewOutput(preview, spaceId, environmentId), null, 2) + '\n');
-            }
-            let operation;
-            try {
-                operation = await client.applyImport(manifest, {
-                    acknowledgeBreakingChanges: breakingWithImpact || opts.force === true,
-                    allowDeletions: opts.allowDeletions === true,
-                });
-            }
-            catch (e) {
-                if (e instanceof ApiError)
-                    return await die(`Error: ${formatApiError(e, opts.verbose)}`, failureFromApiError(e));
-                throw e;
-            }
-            process.stderr.write(`Apply operation started: ${operation.sys.id}\n`);
-            try {
-                operation = await client.pollOperation(operation.sys.id);
-            }
-            catch (e) {
-                if (e instanceof ApiError)
-                    return await die(`Error: ${formatApiError(e, opts.verbose)}`, failureFromApiError(e));
-                throw e;
-            }
-            const summary = buildApplyOutput(operation, spaceId, environmentId, opts.host);
-            recordApplyOutcome(client, spaceId, environmentId, operation);
-            process.stdout.write(JSON.stringify(summary, null, 2) + '\n');
-            const exitCode = operation.sys.status === 'succeeded' ? 0 : 1;
-            await exitWithAnalytics(exitCode);
-            return;
-        }
-        await new Promise((resolvePromise) => {
-            const runApply = async (acknowledge, applyDeletions) => {
-                instance.rerender(createElement(ServerApplyProgress, {
-                    spaceId,
-                    environmentId,
-                    status: 'applying',
-                }));
-                let operation;
-                try {
-                    operation = await client.applyImport(manifest, {
-                        acknowledgeBreakingChanges: acknowledge,
-                        allowDeletions: applyDeletions,
-                    });
-                }
-                catch (e) {
-                    if (e instanceof ApiError) {
-                        instance.rerender(createElement(ServerApplyProgress, {
-                            spaceId,
-                            environmentId,
-                            status: 'error',
-                            error: formatApiError(e, opts.verbose),
-                        }));
-                        return;
-                    }
-                    throw e;
-                }
-                instance.rerender(createElement(ServerApplyProgress, {
-                    spaceId,
-                    environmentId,
-                    status: 'polling',
-                    operationId: operation.sys.id,
-                }));
-                try {
-                    operation = await client.pollOperation(operation.sys.id);
-                }
-                catch (e) {
-                    if (e instanceof ApiError) {
-                        instance.rerender(createElement(ServerApplyProgress, {
-                            spaceId,
-                            environmentId,
-                            status: 'error',
-                            error: formatApiError(e, opts.verbose),
-                        }));
-                        return;
-                    }
-                    throw e;
-                }
-                recordApplyOutcome(client, spaceId, environmentId, operation);
-                instance.rerender(createElement(ServerApplyDone, {
-                    operation,
-                    spaceId,
-                    environmentId,
-                    host: opts.host,
-                }));
-                resolvePromise();
-            };
-            const instance = render(createElement(ServerPreviewConfirm, {
-                preview,
-                spaceId,
-                environmentId,
-                breakingWithImpact,
-                allowDeletions: opts.allowDeletions === true,
-                onConfirm: (acknowledge, applyDeletions) => {
-                    void runApply(acknowledge, applyDeletions);
-                },
-                onCancel: () => {
-                    void exitWithAnalytics(0);
-                },
-            }));
-            void instance.waitUntilExit().then(() => resolvePromise());
-        });
-    });
-    const selectCmd = applyCmd.command('select').description('Select a subset of entities and push to Contentful ExO');
-    addArtifactInputOptions(selectCmd);
-    addContentfulTargetOptions(selectCmd);
-    addCompositionOptions(selectCmd);
-    addSelectionOptions(selectCmd);
-    addAllowDeletionsOption(selectCmd);
-    selectCmd.option('--force', 'Skip confirmation for breaking changes').action(async (opts) => {
-        const nonInteractive = opts.selectAll || (opts.select ?? []).length > 0 || (opts.deselect ?? []).length > 0;
-        if (!nonInteractive) {
-            requireInteractiveTerminal({
-                alternative: 'pass `--select-all`, `--select`, or `--deselect`',
-            });
-        }
-        let inputs;
-        try {
-            inputs = await resolveSharedInputs(opts);
-        }
-        catch (e) {
-            if (e instanceof ApiError)
-                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
-            throw e;
-        }
-        const { components, tokens, client } = inputs;
-        await assertNoSlotCycles(components);
-        try {
-            await client.validateToken();
-        }
-        catch (e) {
-            if (e instanceof ApiError)
-                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
-            throw e;
-        }
-        const fullManifest = buildManifest(components, tokens);
-        let preview;
-        try {
-            preview = await client.previewImport(fullManifest, opts.allowDeletions === true);
-        }
-        catch (e) {
-            if (e instanceof ApiError)
-                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
-            throw e;
-        }
-        const spaceId = opts.spaceId;
-        const environmentId = opts.environmentId;
-        await bindAnalyticsSessionId(opts.session, {
-            space_key: spaceId,
-            environment_key: environmentId,
-        });
-        recordContentfulContext(client, spaceId, environmentId);
-        const entities = getSelectableEntities(preview);
-        if (entities.length === 0) {
-            process.stderr.write('Nothing to change — design system is up to date.\n');
-            await exitWithAnalytics(0);
-        }
-        if (nonInteractive) {
-            const selectedKeys = resolveNonInteractiveSelection(entities, opts);
-            if (selectedKeys.size === 0) {
-                process.stderr.write('No entities matched selection criteria.\n');
-                await exitWithAnalytics(0);
-            }
-            const selectedComponentKeys = new Set();
-            const selectedTokenPaths = new Set();
-            for (const key of selectedKeys) {
-                const [kind, ...idParts] = key.split(':');
-                const id = idParts.join(':');
-                if (kind === 'component')
-                    selectedComponentKeys.add(id);
-                else if (kind === 'token')
-                    selectedTokenPaths.add(id);
-            }
-            const filteredManifest = buildFilteredManifest(fullManifest, selectedComponentKeys, selectedTokenPaths);
-            const hasBreaking = entities.some((e) => e.isBreaking && selectedKeys.has(makeSelectKey(e.kind, e.id)));
-            if (hasBreaking && !opts.force) {
-                process.stderr.write('Error: selection includes breaking changes. Use --force to acknowledge.\n');
-                await exitWithAnalytics(1);
-            }
-            let operation;
-            try {
-                operation = await client.applyImport(filteredManifest, {
-                    acknowledgeBreakingChanges: hasBreaking || opts.force === true,
-                    allowDeletions: opts.allowDeletions === true,
-                });
-            }
-            catch (e) {
-                if (e instanceof ApiError)
-                    return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
-                throw e;
-            }
-            process.stderr.write(`Apply operation started: ${operation.sys.id}\n`);
-            try {
-                operation = await client.pollOperation(operation.sys.id);
-            }
-            catch (e) {
-                if (e instanceof ApiError)
-                    return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
-                throw e;
-            }
-            const summary = buildApplyOutput(operation, spaceId, environmentId, opts.host);
-            recordApplyOutcome(client, spaceId, environmentId, operation);
-            process.stdout.write(JSON.stringify(summary, null, 2) + '\n');
-            await exitWithAnalytics(operation.sys.status === 'succeeded' ? 0 : 1);
-            return;
-        }
-        await new Promise((resolvePromise) => {
-            const runSelectApply = async (selectedKeys) => {
-                const selectedComponentKeys = new Set();
-                const selectedTokenPaths = new Set();
-                for (const key of selectedKeys) {
-                    const [kind, ...idParts] = key.split(':');
-                    const id = idParts.join(':');
-                    if (kind === 'component')
-                        selectedComponentKeys.add(id);
-                    else if (kind === 'token')
-                        selectedTokenPaths.add(id);
-                }
-                const filteredManifest = buildFilteredManifest(fullManifest, selectedComponentKeys, selectedTokenPaths);
-                const hasBreaking = entities.some((e) => e.isBreaking && selectedKeys.has(makeSelectKey(e.kind, e.id)));
-                instance.rerender(createElement(ServerApplyProgress, {
-                    spaceId,
-                    environmentId,
-                    status: 'applying',
-                }));
-                let operation;
-                try {
-                    operation = await client.applyImport(filteredManifest, {
-                        acknowledgeBreakingChanges: hasBreaking,
-                        allowDeletions: opts.allowDeletions === true,
-                    });
-                }
-                catch (e) {
-                    if (e instanceof ApiError) {
-                        instance.rerender(createElement(ServerApplyProgress, {
-                            spaceId,
-                            environmentId,
-                            status: 'error',
-                            error: formatApiError(e),
-                        }));
-                        return;
-                    }
-                    throw e;
-                }
-                instance.rerender(createElement(ServerApplyProgress, {
-                    spaceId,
-                    environmentId,
-                    status: 'polling',
-                    operationId: operation.sys.id,
-                }));
-                try {
-                    operation = await client.pollOperation(operation.sys.id);
-                }
-                catch (e) {
-                    if (e instanceof ApiError) {
-                        instance.rerender(createElement(ServerApplyProgress, {
-                            spaceId,
-                            environmentId,
-                            status: 'error',
-                            error: formatApiError(e),
-                        }));
-                        return;
-                    }
-                    throw e;
-                }
-                recordApplyOutcome(client, spaceId, environmentId, operation);
-                instance.rerender(createElement(ServerApplyDone, {
-                    operation,
-                    spaceId,
-                    environmentId,
-                    host: opts.host,
-                }));
-                resolvePromise();
-            };
-            const instance = render(createElement(SelectApp, {
-                entities,
-                spaceId,
-                environmentId,
-                onApply: (selectedKeys) => {
-                    void runSelectApply(selectedKeys);
-                },
-            }));
-            void instance.waitUntilExit().then(() => resolvePromise());
-        });
-    });
-}