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

package/dist/src/import/orchestrator.js

@@ -1,603 +0,0 @@
-import { mkdir } from 'node:fs/promises';
-import { join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { execFile } from 'node:child_process';
-import { openPipelineDb, getOrCreateSession, createStep, updateStep, findLatestSessionForCommand, loadCDFComponents, } from '../session/db.js';
-import { detectSlotCycles, formatSlotCycleReport } from '../apply/command.js';
-import { PREVIEW_ERROR_PREFIX, VALIDATION_FAILED_CODE, parsePreviewValidationErrors } from '../apply/api-client.js';
-import { buildPostPushUrl } from '../lib/contentful-urls.js';
-import { getDebugLogger } from '../lib/debug-logger.js';
-import { bindAnalyticsSession, emitSessionStarted } from '../analytics/index.js';
-import { pipelineSubprocessEnv } from '../analytics/env.js';
-function findCliPath() {
-    return join(fileURLToPath(import.meta.url), '..', '..', '..', '..', 'bin', 'cli.js');
-}
-async function runStep(args, cliPath, analyticsSessionId, env = {}, streamStderr = false) {
-    const debug = getDebugLogger();
-    const startedAt = Date.now();
-    debug.event('import', 'subprocess.spawn', { cliPath, args });
-    return new Promise((res) => {
-        const child = execFile('node', [cliPath, ...args], {
-            env: pipelineSubprocessEnv({ ...process.env, ...env }, analyticsSessionId),
-        });
-        let stdout = '';
-        let stderr = '';
-        child.stdout?.on('data', (chunk) => {
-            stdout += chunk.toString();
-        });
-        child.stderr?.on('data', (chunk) => {
-            const text = chunk.toString();
-            stderr += text;
-            if (streamStderr)
-                process.stderr.write(text);
-        });
-        child.on('close', (code) => {
-            const exitCode = code ?? 0;
-            debug.event('import', 'subprocess.exit', {
-                args,
-                exitCode,
-                durationMs: Date.now() - startedAt,
-                stdoutLen: stdout.length,
-                stderrLen: stderr.length,
-                stderrTail: stderr.slice(-1000),
-            });
-            res({ exitCode, stdout, stderr });
-        });
-    });
-}
-const MAX_VALIDATION_RETRIES = Number(process.env['EDS_MAX_VALIDATION_RETRIES'] ?? 2);
-export const SLOT_CYCLE_MARKER = 'manifest:components/slot-cycles';
-export function isSlotCycleError(result) {
-    return result.exitCode !== 0 && result.stderr.includes(SLOT_CYCLE_MARKER);
-}
-export function extractCycleReport(stderr) {
-    return stderr.split('\n').filter((line) => line.trim());
-}
-export function parseCycleComponentNames(report) {
-    const names = [];
-    for (const line of report) {
-        const m = line.match(/Fix: remove '([^']+)' from /);
-        if (m)
-            names.push(m[1]);
-    }
-    return [...new Set(names)];
-}
-export function isPreviewValidationError(result) {
-    if (result.exitCode === 0 || !result.stderr.includes(`${PREVIEW_ERROR_PREFIX} 422`))
-        return false;
-    return result.stderr.includes(VALIDATION_FAILED_CODE) || result.stderr.includes('[ValidationFailed]');
-}
-export function parseOffendingComponentNames(output) {
-    const jsonStart = output.indexOf('{');
-    if (jsonStart !== -1) {
-        const errors = parsePreviewValidationErrors(output.slice(jsonStart));
-        const names = [...new Set(errors.map((error) => error.componentName))];
-        if (names.length > 0)
-            return names;
-    }
-    const names = [...output.matchAll(/Component:\s*([^;\n)]+)/g)].map((match) => match[1].trim()).filter(Boolean);
-    return [...new Set(names)];
-}
-export function buildPushStepResult(args) {
-    const { created, updated, failed, durationMs, stderr, excludedByRetry, totalFailure } = args;
-    const excludedDetail = excludedByRetry.length > 0 ? { excludedByValidationRetry: excludedByRetry } : {};
-    if (totalFailure) {
-        const detail = excludedByRetry.length > 0 ? { ...excludedDetail } : undefined;
-        return {
-            step: 'apply push',
-            status: 'failed',
-            durationMs,
-            error: stderr,
-            ...(detail ? { detail } : {}),
-        };
-    }
-    const status = failed > 0 ? 'failed' : 'complete';
-    return {
-        step: 'apply push',
-        status,
-        durationMs,
-        detail: { created, updated, failed, ...excludedDetail },
-    };
-}
-export async function runPipeline(opts, progressWriter, cliPathOverride) {
-    const projectRoot = resolve(opts.project);
-    const outDir = resolve(opts.out);
-    const componentsPath = join(outDir, 'components.json');
-    const cliPath = cliPathOverride ?? findCliPath();
-    const db = openPipelineDb();
-    const { sessionId } = getOrCreateSession(db, undefined, undefined, {
-        command: 'import',
-        inputPath: projectRoot,
-        outDir,
-    });
-    await bindAnalyticsSession(sessionId, {
-        ...(opts.spaceId ? { space_key: opts.spaceId, environment_key: opts.environmentId } : {}),
-    });
-    await emitSessionStarted('import');
-    progressWriter(`Experience Design System CLI — Pipeline Import`);
-    progressWriter(`Project:     ${projectRoot}`);
-    progressWriter(`Output:      ${outDir}`);
-    if (opts.spaceId)
-        progressWriter(`Space:       ${opts.spaceId} (${opts.environmentId})`);
-    progressWriter(`Session:     ${sessionId}`);
-    progressWriter('');
-    await mkdir(outDir, { recursive: true });
-    const steps = [];
-    let stepNum = 0;
-    const totalSteps = 4 + (opts.print ? 1 : 0);
-    function stepLabel(name) {
-        stepNum++;
-        return `  Step ${stepNum}/${totalSteps}  ${name}  `;
-    }
-    const analyzeLabel = stepLabel('Statically analyzing project');
-    const analyzeSkipped = !opts.noCache && opts.skipAnalyze;
-    let extractSessionId = null;
-    if (analyzeSkipped) {
-        progressWriter(`${analyzeLabel}–  skipped (--skip-analyze)`);
-        steps.push({
-            step: 'analyze extract',
-            status: 'skipped',
-            reason: '--skip-analyze',
-        });
-        const prior = findLatestSessionForCommand(db, 'analyze extract');
-        extractSessionId = prior ?? null;
-    }
-    else {
-        const stepId = createStep(db, sessionId, 'analyze extract', {
-            project: projectRoot,
-        });
-        const t0 = Date.now();
-        const analyzeArgs = ['analyze', 'extract', '--project', projectRoot];
-        if (opts.compositionMode === 'composite') {
-            analyzeArgs.push('--composite');
-            if (opts.compositionMap)
-                analyzeArgs.push('--composition-map', opts.compositionMap);
-            if (opts.compositionAgent)
-                analyzeArgs.push('--composition-agent');
-            if (opts.compositionAgentMode)
-                analyzeArgs.push('--composition-agent-mode', opts.compositionAgentMode);
-            if (opts.compositionRefresh)
-                analyzeArgs.push('--composition-refresh');
-            if (opts.generateMap)
-                analyzeArgs.push('--generate-map', opts.generateMap);
-            for (const p of opts.promptOverrides ?? [])
-                analyzeArgs.push('--prompt', p);
-            if (opts.agent)
-                analyzeArgs.push('--agent', opts.agent);
-        }
-        const r = await runStep(analyzeArgs, cliPath, sessionId);
-        const durationMs = Date.now() - t0;
-        if (r.exitCode !== 0) {
-            if (r.stderr)
-                process.stderr.write(r.stderr);
-            updateStep(db, stepId, 'failed', {}, r.stderr);
-            progressWriter(`${analyzeLabel}✗  failed (${(durationMs / 1000).toFixed(1)}s)`);
-            steps.push({
-                step: 'analyze extract',
-                status: 'failed',
-                durationMs,
-                error: r.stderr,
-            });
-            db.close();
-            return { session: sessionId, project: projectRoot, steps };
-        }
-        extractSessionId = findLatestSessionForCommand(db, 'analyze extract') ?? null;
-        const componentMatch = /Extracted (\d+) component/.exec(r.stderr);
-        const componentCount = componentMatch ? Number(componentMatch[1]) : 0;
-        updateStep(db, stepId, 'complete', {
-            extractSessionId: extractSessionId ?? '',
-        });
-        progressWriter(`${analyzeLabel}✓  ${componentCount} component${componentCount === 1 ? '' : 's'} found  (${(durationMs / 1000).toFixed(1)}s)`);
-        steps.push({
-            step: 'analyze extract',
-            status: 'complete',
-            durationMs,
-            detail: { components: componentCount },
-        });
-    }
-    const editLabel = stepLabel('Filtering components');
-    if (analyzeSkipped) {
-        progressWriter(`${editLabel}–  skipped (--skip-analyze)`);
-        steps.push({
-            step: 'analyze select',
-            status: 'skipped',
-            reason: '--skip-analyze',
-        });
-    }
-    else if (extractSessionId) {
-        const editStepId = createStep(db, sessionId, 'analyze select', {
-            extractSession: extractSessionId,
-        });
-        const t0Edit = Date.now();
-        const useAgentSelect = !opts.selectAll && (!opts.select || opts.select.length === 0) && (!opts.deselect || opts.deselect.length === 0);
-        let editArgs;
-        if (useAgentSelect) {
-            editArgs = ['analyze', 'select-agent', '--session', extractSessionId, '--agent', opts.agent];
-            if (opts.model)
-                editArgs.push('--model', opts.model);
-            if (opts.excludeInvalid)
-                editArgs.push('--exclude-invalid');
-            if (opts.noCache)
-                editArgs.push('--no-cache');
-            if (opts.selectPromptPath)
-                editArgs.push('--select-prompt-path', opts.selectPromptPath);
-        }
-        else {
-            editArgs = ['analyze', 'select', '--session', extractSessionId];
-            if (opts.select && opts.select.length > 0) {
-                for (const p of opts.select)
-                    editArgs.push('--select', p);
-            }
-            else if (opts.deselect && opts.deselect.length > 0) {
-                for (const p of opts.deselect)
-                    editArgs.push('--deselect', p);
-                editArgs.push('--select-all');
-            }
-            else {
-                editArgs.push('--select-all');
-            }
-        }
-        const rEdit = await runStep(editArgs, cliPath, sessionId, { FORCE_COLOR: '1' }, useAgentSelect);
-        const editDurationMs = Date.now() - t0Edit;
-        if (rEdit.exitCode !== 0) {
-            if (rEdit.stderr && !useAgentSelect)
-                process.stderr.write(rEdit.stderr);
-            updateStep(db, editStepId, 'failed', {}, rEdit.stderr);
-            progressWriter(`${editLabel}✗  failed (${(editDurationMs / 1000).toFixed(1)}s)`);
-            steps.push({
-                step: 'analyze select',
-                status: 'failed',
-                durationMs: editDurationMs,
-                error: rEdit.stderr,
-            });
-            db.close();
-            return { session: sessionId, project: projectRoot, steps };
-        }
-        const acceptedMatch = /Accepted: (\d+)/.exec(rEdit.stderr);
-        const acceptedCount = acceptedMatch ? Number(acceptedMatch[1]) : 0;
-        updateStep(db, editStepId, 'complete', {
-            extractSession: extractSessionId,
-        });
-        progressWriter(`${editLabel}✓  ${acceptedCount} accepted  (${(editDurationMs / 1000).toFixed(1)}s)`);
-        steps.push({
-            step: 'analyze select',
-            status: 'complete',
-            durationMs: editDurationMs,
-            detail: { accepted: acceptedCount },
-        });
-    }
-    else {
-        progressWriter(`${editLabel}–  skipped (no extract session)`);
-        steps.push({
-            step: 'analyze select',
-            status: 'skipped',
-            reason: 'no extract session',
-        });
-    }
-    if (opts.skipGenerate) {
-        const generateLabel = stepLabel('Categorizing component props');
-        progressWriter(`${generateLabel}–  skipped (--skip-generate)`);
-        steps.push({
-            step: 'generate components',
-            status: 'skipped',
-            reason: '--skip-generate',
-        });
-    }
-    else {
-        const generateLabel = stepLabel('Categorizing component props');
-        const generateArgs = ['generate', 'components', '--agent', opts.agent];
-        if (opts.model)
-            generateArgs.push('--model', opts.model);
-        if (extractSessionId)
-            generateArgs.push('--session', extractSessionId);
-        if (opts.dryRun)
-            generateArgs.push('--dry-run');
-        if (opts.verbose)
-            generateArgs.push('--verbose');
-        const stepId = createStep(db, sessionId, 'generate components', {
-            extractSession: extractSessionId ?? '',
-        });
-        const t0 = Date.now();
-        const r = await runStep(generateArgs, cliPath, sessionId, { FORCE_COLOR: '1' }, true);
-        const durationMs = Date.now() - t0;
-        if (r.exitCode !== 0) {
-            updateStep(db, stepId, 'failed', {}, r.stderr);
-            progressWriter(`${generateLabel}✗  failed (${(durationMs / 1000).toFixed(1)}s)`);
-            steps.push({
-                step: 'generate components',
-                status: 'failed',
-                durationMs,
-                error: r.stderr,
-            });
-            db.close();
-            return { session: sessionId, project: projectRoot, steps };
-        }
-        if (opts.dryRun) {
-            updateStep(db, stepId, 'complete', { dryRun: 'true' });
-            progressWriter(`${generateLabel}✓  prompt printed  (${(durationMs / 1000).toFixed(1)}s)`);
-            steps.push({
-                step: 'generate components',
-                status: 'complete',
-                durationMs,
-            });
-            db.close();
-            return { session: sessionId, project: projectRoot, steps };
-        }
-        updateStep(db, stepId, 'complete', {
-            extractSession: extractSessionId ?? '',
-        });
-        progressWriter(`${generateLabel}✓  components stored locally  (${(durationMs / 1000).toFixed(1)}s)`);
-        steps.push({ step: 'generate components', status: 'complete', durationMs });
-    }
-    // Block save or push when the accepted set still contains a slot cycle.
-    // Skipped under --auto-reject-cycles, which delegates to the push-path
-    // retry loop below (reject cycle members, then retry) instead of blocking.
-    if (extractSessionId && !opts.autoRejectCycles) {
-        const acceptedCycles = (() => {
-            try {
-                return detectSlotCycles(loadCDFComponents(db, extractSessionId));
-            }
-            catch {
-                return [];
-            }
-        })();
-        if (acceptedCycles.length > 0) {
-            const report = formatSlotCycleReport(acceptedCycles);
-            process.stderr.write(report.join('\n') + '\n');
-            progressWriter('Slot cycle detected. The accepted components contain circular slot references — refusing to save or push.');
-            for (const line of report)
-                progressWriter(line);
-            steps.push({ step: 'cycle gate', status: 'failed', error: report.join('\n') });
-            db.close();
-            return { session: sessionId, project: projectRoot, steps, cycleError: { report } };
-        }
-    }
-    if (opts.print) {
-        const printLabel = stepLabel('Writing components.json');
-        const printArgs = ['print', 'components', '--out', componentsPath];
-        if (extractSessionId)
-            printArgs.push('--session', extractSessionId);
-        const stepId = createStep(db, sessionId, 'print components', {
-            out: componentsPath,
-        });
-        const t0 = Date.now();
-        const r = await runStep(printArgs, cliPath, sessionId);
-        const durationMs = Date.now() - t0;
-        if (r.exitCode !== 0) {
-            if (r.stderr)
-                process.stderr.write(r.stderr);
-            updateStep(db, stepId, 'failed', {}, r.stderr);
-            progressWriter(`${printLabel}✗  failed (${(durationMs / 1000).toFixed(1)}s)`);
-            steps.push({
-                step: 'print components',
-                status: 'failed',
-                durationMs,
-                error: r.stderr,
-            });
-            db.close();
-            return { session: sessionId, project: projectRoot, steps };
-        }
-        updateStep(db, stepId, 'complete', { components: componentsPath });
-        progressWriter(`${printLabel}✓  components.json written  (${(durationMs / 1000).toFixed(1)}s)`);
-        steps.push({ step: 'print components', status: 'complete', durationMs });
-    }
-    const applyLabelText = opts.spaceId && opts.environmentId
-        ? `Applying changes to Space: ${opts.spaceId} Environment: ${opts.environmentId}`
-        : 'Applying changes to Contentful';
-    if (opts.skipApply) {
-        const pushLabel = stepLabel(applyLabelText);
-        progressWriter(`${pushLabel}–  skipped (--skip-apply)`);
-        steps.push({
-            step: 'apply push',
-            status: 'skipped',
-            reason: '--skip-apply',
-        });
-    }
-    else {
-        const pushLabel = stepLabel(applyLabelText);
-        if (!opts.spaceId || !opts.environmentId || !opts.cmaToken) {
-            process.stderr.write('Error: --space-id, --environment-id, and --cma-token are required for apply push. Use --skip-apply to skip.\n');
-            db.close();
-            process.exit(1);
-        }
-        const pushArgs = [
-            'apply',
-            'push',
-            '--space-id',
-            opts.spaceId,
-            '--environment-id',
-            opts.environmentId,
-            '--cma-token',
-            opts.cmaToken,
-        ];
-        if (extractSessionId) {
-            pushArgs.push('--session', extractSessionId);
-        }
-        else {
-            pushArgs.push('--components', componentsPath);
-        }
-        if (opts.tokens)
-            pushArgs.push('--tokens', opts.tokens);
-        if (opts.viewports)
-            pushArgs.push('--viewports', opts.viewports);
-        if (opts.host)
-            pushArgs.push('--host', opts.host);
-        if (opts.verbose)
-            pushArgs.push('--verbose');
-        if (opts.allowDeletions)
-            pushArgs.push('--allow-deletions');
-        pushArgs.push('--yes');
-        const pushStepId = createStep(db, sessionId, 'apply push', {
-            components: componentsPath,
-        });
-        const t0 = Date.now();
-        let r = await runStep(pushArgs, cliPath, sessionId, { FORCE_COLOR: '1' }, true);
-        const excludedByRetry = [];
-        let validationRetryCount = 0;
-        while (validationRetryCount < MAX_VALIDATION_RETRIES && isPreviewValidationError(r) && extractSessionId) {
-            const offenders = parseOffendingComponentNames(r.stderr + r.stdout);
-            if (offenders.length === 0)
-                break;
-            process.stderr.write(`[retry ${validationRetryCount + 1}/${MAX_VALIDATION_RETRIES}] Preview validation failed — excluding ${offenders.join(', ')} and retrying\n`);
-            excludedByRetry.push(...offenders);
-            const rejectArgs = [
-                'analyze',
-                'select',
-                '--session',
-                extractSessionId,
-                '--exclude-components',
-                offenders.join(','),
-            ];
-            const rejectResult = await runStep(rejectArgs, cliPath, sessionId);
-            if (rejectResult.exitCode !== 0)
-                break;
-            r = await runStep(pushArgs, cliPath, sessionId, { FORCE_COLOR: '1' }, true);
-            validationRetryCount++;
-        }
-        const durationMs = Date.now() - t0;
-        let pushResult = null;
-        try {
-            pushResult = JSON.parse(r.stdout);
-        }
-        catch {
-            // stdout wasn't JSON — fall back to regex parsing
-        }
-        const created = pushResult
-            ? (pushResult.componentTypes?.created ?? 0) + (pushResult.designTokens?.created ?? 0)
-            : Number(/(\d+) created/.exec(r.stdout + r.stderr)?.[1] ?? 0);
-        const updated = pushResult
-            ? (pushResult.componentTypes?.updated ?? 0) + (pushResult.designTokens?.updated ?? 0)
-            : Number(/(\d+) updated/.exec(r.stdout + r.stderr)?.[1] ?? 0);
-        const failed = pushResult
-            ? (pushResult.componentTypes?.failed ?? 0) + (pushResult.designTokens?.failed ?? 0)
-            : Number(/(\d+) failed/.exec(r.stdout + r.stderr)?.[1] ?? 0);
-        const totalPushed = created + updated + failed;
-        if (isSlotCycleError(r)) {
-            const report = extractCycleReport(r.stderr);
-            if (opts.autoRejectCycles && extractSessionId) {
-                const cycleNames = parseCycleComponentNames(report);
-                if (cycleNames.length > 0) {
-                    process.stderr.write(`[cycle-retry] Slot cycle detected — excluding ${cycleNames.join(', ')} and retrying\n`);
-                    const rejectArgs = [
-                        'analyze',
-                        'select',
-                        '--session',
-                        extractSessionId,
-                        '--exclude-components',
-                        cycleNames.join(','),
-                    ];
-                    const rejectResult = await runStep(rejectArgs, cliPath, sessionId);
-                    if (rejectResult.exitCode === 0) {
-                        const retryT0 = Date.now();
-                        const retryR = await runStep(pushArgs, cliPath, sessionId, { FORCE_COLOR: '1' }, true);
-                        const retryDurationMs = Date.now() - t0 + (Date.now() - retryT0);
-                        if (isSlotCycleError(retryR)) {
-                            const retryReport = extractCycleReport(retryR.stderr);
-                            updateStep(db, pushStepId, 'failed', {}, retryR.stderr);
-                            progressWriter(`${pushLabel}✗  failed (${(retryDurationMs / 1000).toFixed(1)}s)`);
-                            progressWriter('Slot cycle detected after auto-reject retry. The manifest still contains circular slot references.');
-                            for (const line of retryReport)
-                                progressWriter(line);
-                            steps.push(buildPushStepResult({
-                                created,
-                                updated,
-                                failed,
-                                durationMs: retryDurationMs,
-                                stderr: retryR.stderr,
-                                excludedByRetry: [...excludedByRetry, ...cycleNames],
-                                totalFailure: true,
-                            }));
-                            db.close();
-                            return { session: sessionId, project: projectRoot, steps, cycleError: { report: retryReport } };
-                        }
-                        if (retryR.exitCode !== 0) {
-                            updateStep(db, pushStepId, 'failed', {}, retryR.stderr);
-                            progressWriter(`${pushLabel}✗  failed (${(retryDurationMs / 1000).toFixed(1)}s)`);
-                            steps.push(buildPushStepResult({
-                                created,
-                                updated,
-                                failed,
-                                durationMs: retryDurationMs,
-                                stderr: retryR.stderr,
-                                excludedByRetry: [...excludedByRetry, ...cycleNames],
-                                totalFailure: true,
-                            }));
-                            db.close();
-                            return { session: sessionId, project: projectRoot, steps };
-                        }
-                        excludedByRetry.push(...cycleNames);
-                        r = retryR;
-                    }
-                }
-            }
-            if (isSlotCycleError(r)) {
-                updateStep(db, pushStepId, 'failed', {}, r.stderr);
-                progressWriter(`${pushLabel}✗  failed (${(durationMs / 1000).toFixed(1)}s)`);
-                progressWriter('Slot cycle detected. The manifest contains circular slot references that would block the push.');
-                for (const line of report)
-                    progressWriter(line);
-                steps.push(buildPushStepResult({
-                    created,
-                    updated,
-                    failed,
-                    durationMs,
-                    stderr: r.stderr,
-                    excludedByRetry,
-                    totalFailure: true,
-                }));
-                db.close();
-                return { session: sessionId, project: projectRoot, steps, cycleError: { report } };
-            }
-        }
-        if (r.exitCode !== 0 && (totalPushed === 0 || failed === totalPushed)) {
-            // Total failure — nothing was pushed
-            updateStep(db, pushStepId, 'failed', {}, r.stderr);
-            progressWriter(`${pushLabel}✗  failed (${(durationMs / 1000).toFixed(1)}s)`);
-            steps.push(buildPushStepResult({
-                created,
-                updated,
-                failed,
-                durationMs,
-                stderr: r.stderr,
-                excludedByRetry,
-                totalFailure: true,
-            }));
-            db.close();
-            return { session: sessionId, project: projectRoot, steps };
-        }
-        const stepResult = buildPushStepResult({
-            created,
-            updated,
-            failed,
-            durationMs,
-            stderr: r.stderr,
-            excludedByRetry,
-        });
-        updateStep(db, pushStepId, stepResult.status === 'complete' ? 'complete' : 'failed', {
-            components: componentsPath,
-        });
-        const statusIcon = failed > 0 ? '⚠' : '✓';
-        progressWriter(`${pushLabel}${statusIcon}  ${created} created, ${updated} updated, ${failed} failed  (${(durationMs / 1000).toFixed(1)}s)`);
-        steps.push(stepResult);
-    }
-    progressWriter('');
-    progressWriter(`Pipeline complete. Session: ${sessionId}`);
-    if (opts.spaceId && opts.environmentId && !opts.skipApply) {
-        const viewUrl = buildPostPushUrl({
-            host: opts.host ?? 'api.contentful.com',
-            spaceId: opts.spaceId,
-            environmentId: opts.environmentId,
-        });
-        const tokensUrl = buildPostPushUrl({
-            host: opts.host ?? 'api.contentful.com',
-            spaceId: opts.spaceId,
-            environmentId: opts.environmentId,
-            view: 'design_tokens',
-        });
-        progressWriter('');
-        progressWriter(`View your design system:  ${viewUrl}`);
-        progressWriter(`View your design tokens:  ${tokensUrl}`);
-    }
-    db.close();
-    return { session: sessionId, project: projectRoot, steps };
-}

package/dist/src/import/path-utils.js

@@ -1,30 +0,0 @@
-import { resolve } from 'node:path';
-import { homedir } from 'node:os';
-/**
- * Expands a leading `~` to the user's home directory.
- * Exported separately so it can be unit-tested and reused.
- */
-export function expandTilde(input) {
-    if (input === '~' || input.startsWith('~/') || input.startsWith('~\\')) {
-        return homedir() + input.slice(1);
-    }
-    return input;
-}
-/**
- * Normalizes a user-entered path to an absolute path, handling all common
- * terminal path styles:
- *   - surrounding quotes ("~/path" or '~/path')  → stripped
- *   - tilde prefix (~/projects/mylib)             → expanded to $HOME
- *   - relative paths (../mylib, ./src, mylib)     → resolved against CWD
- *   - absolute paths (/Users/ryun/projects/mylib) → passed through
- *   - trailing slashes, repeated slashes          → normalized by path.resolve
- */
-export function normalizePath(input) {
-    let p = input.trim();
-    // strip surrounding single or double quotes
-    if (p.length >= 2 && ((p.startsWith('"') && p.endsWith('"')) || (p.startsWith("'") && p.endsWith("'")))) {
-        p = p.slice(1, -1);
-    }
-    p = expandTilde(p);
-    return resolve(p);
-}

package/dist/src/import/picker-dispatch.js

@@ -1,44 +0,0 @@
-// Route a resolved RunPickerSelection into replayRun / modifyRun / picker-push.
-// Extracted from command.ts so the dispatch decision is testable without an
-// Ink runtime and so the picker callback in command.ts is a simple
-// state-capture (no process.exit shenanigans that would kill the process
-// before dispatch runs).
-export async function dispatchPickerSelection(selection, opts, deps) {
-    if (selection.action === 'push' && selection.runId) {
-        // Interactive TTY → mount the wizard's preview + push UX. Non-interactive
-        // (CI / scripted / non-TTY) → keep the headless shell-out via replayRun
-        // that `experiences import --push-from-run <id>` relies on.
-        if (opts.interactive !== false && deps.pickerPushRun) {
-            await deps.pickerPushRun({
-                runIdOrPath: selection.runId,
-                ...(opts.spaceId ? { spaceId: opts.spaceId } : {}),
-                ...(opts.environmentId ? { environmentId: opts.environmentId } : {}),
-                ...(opts.cmaToken ? { cmaToken: opts.cmaToken } : {}),
-                ...(opts.host ? { host: opts.host } : {}),
-                ...(opts.force ? { force: true } : {}),
-            });
-            return;
-        }
-        await deps.replayRun({
-            runIdOrPath: selection.runId,
-            ...(opts.spaceId ? { spaceId: opts.spaceId } : {}),
-            ...(opts.environmentId ? { environmentId: opts.environmentId } : {}),
-            ...(opts.cmaToken ? { cmaToken: opts.cmaToken } : {}),
-            ...(opts.host ? { host: opts.host } : {}),
-            ...(opts.interactive !== undefined ? { interactive: opts.interactive } : {}),
-            ...(opts.force ? { force: true } : {}),
-        });
-        return;
-    }
-    if (selection.action === 'modify' && selection.runId) {
-        await deps.modifyRun({
-            runIdOrPath: selection.runId,
-            ...(opts.outDir ? { outDir: opts.outDir } : {}),
-            ...(opts.overwrite ? { overwrite: true } : {}),
-            ...(opts.saveAsNew ? { saveAsNew: true } : {}),
-            ...(opts.force ? { force: true } : {}),
-        });
-        return;
-    }
-    // action === 'new' → no-op; the wizard already advanced past the picker.
-}