@contentful/experience-design-system-cli 2.23.2-dev-build-753ceef.0 → 2.23.2-dev-build-e996ffb.0

package/dist/src/generate/command.js

@@ -14,7 +14,6 @@ import { hashPromptForSkill } from '../session/cache-keys.js';
 import { getRefineArtifactsRoot, getRefineSessionPaths } from '../analyze/select/persistence.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
 import { addAgentModelOptions } from '../lib/agent-model-options.js';
-import { bindAnalyticsSessionId, exitWithAnalytics } from '../analytics/index.js';
 const execFileAsync = promisify(execFile);
 const DEFAULT_TIMEOUT_MS = Number(process.env.EDS_AGENT_TIMEOUT_MS ?? 3 * 60 * 1000);
 const DEFAULT_COMPONENT_CONCURRENCY = 10;
@@ -24,8 +23,7 @@ const invoker = createLocalCliAgentInvoker({
 });
 function die(message) {
     process.stderr.write(`${message}\n`);
-    void exitWithAnalytics(1);
-    throw new Error('exit');
+    process.exit(1);
 }
 async function pathExists(p) {
     return access(p)
@@ -278,8 +276,7 @@ function resolveSessionId(sessionFlag) {
             .get();
         if (!row) {
             process.stderr.write('Error: no completed analyze extract session found. Run analyze extract first, or pass --session <id>.\n');
-            void exitWithAnalytics(1);
-            throw new Error('exit');
+            process.exit(1);
         }
         return row.id;
     }
@@ -343,7 +340,6 @@ async function runGenerateSkill(skill, opts, verbose = false) {
     let allComponents;
     if (skill === 'components') {
         sessionId = resolveSessionId(opts.session);
-        await bindAnalyticsSessionId(sessionId);
         const acceptedNames = await loadAcceptedNames(sessionId);
         const db = openPipelineDb();
         try {
@@ -400,7 +396,7 @@ async function runGenerateSkill(skill, opts, verbose = false) {
             skillPathOverride: generatePromptPath,
         });
         process.stdout.write(prompt + '\n');
-        await exitWithAnalytics(0);
+        process.exit(0);
     }
     const binary = resolveBinary(agent);
     if (!(await assertBinaryInPath(binary))) {
@@ -409,7 +405,7 @@ async function runGenerateSkill(skill, opts, verbose = false) {
             skill,
             sessionId: sessionId ?? '',
         });
-        await exitWithAnalytics(1);
+        process.exit(1);
     }
     if (skill === 'components' && allComponents && sessionId) {
         const db = openPipelineDb();
@@ -475,8 +471,6 @@ async function runGenerateSkill(skill, opts, verbose = false) {
                     resolvedSessionId = newId;
                 }
             }
-            sessionId = resolvedSessionId;
-            await bindAnalyticsSessionId(resolvedSessionId);
             const tokenPromptHash = await hashPromptForSkill('tokens');
             // Check cache before invoking agent
             if (!noCache) {
@@ -489,12 +483,12 @@ async function runGenerateSkill(skill, opts, verbose = false) {
                     // Skip agent invocation — jump to view
                     const viewResult = { skill, agent, sessionId: sessionId ?? '' };
                     if (process.stdout.isTTY) {
-                        const { waitUntilExit } = render(createElement(GenerateView, { result: viewResult, onExit: () => void exitWithAnalytics(0) }));
+                        const { waitUntilExit } = render(createElement(GenerateView, { result: viewResult, onExit: () => process.exit(0) }));
                         await waitUntilExit();
                     }
                     else {
                         process.stdout.write(`generate complete\nskill: ${skill}\nagent: ${agent}\nsession=${sessionId ?? ''}\n`);
-                        await exitWithAnalytics(0);
+                        process.exit(0);
                     }
                     return;
                 }
@@ -529,7 +523,7 @@ async function runGenerateSkill(skill, opts, verbose = false) {
                 process.stderr.write(`Error: agent produced no set_token calls.\n` +
                     `Run with --dry-run to inspect the prompt.\n\n` +
                     `Agent output:\n${result.stdout}\n`);
-                await exitWithAnalytics(1);
+                process.exit(1);
             }
             if (tokenWarnings.length > 0) {
                 process.stderr.write(`Warnings:\n${tokenWarnings.map((w) => `  ${w}`).join('\n')}\n`);
@@ -554,13 +548,13 @@ async function runGenerateSkill(skill, opts, verbose = false) {
     if (process.stdout.isTTY) {
         const { waitUntilExit } = render(createElement(GenerateView, {
             result: viewResult,
-            onExit: () => void exitWithAnalytics(0),
+            onExit: () => process.exit(0),
         }));
         await waitUntilExit();
     }
     else {
         process.stdout.write(`generate complete\nskill: ${skill}\nagent: ${agent}\nsession=${sessionId ?? ''}\n`);
-        await exitWithAnalytics(0);
+        process.exit(0);
     }
 }
 function addAgentFlags(cmd) {

package/dist/src/generate/edit/command.js

@@ -99,7 +99,6 @@ async function runNonInteractive(opts, skill) {
     process.stderr.write(`Accepted: ${accepted.length}  Rejected: ${rejected.length}\n`);
 }
 export function registerGenerateEditCommand(parent, skill) {
-    // TODO(analytics): bindAnalyticsSessionId when generate edit ships — tracked in schema as generate_edit.
     parent
         .command('edit')
         .description(`Review and correct generate ${skill} output before pushing`)

package/dist/src/import/command.js

@@ -4,7 +4,7 @@ import { resolveAutoFilter } from './auto-filter-resolve.js';
 import { resolveAgent, resolveModel } from './agent-model-resolve.js';
 import { addAgentModelOptions } from '../lib/agent-model-options.js';
 import { resolveCompositionMode } from '../lib/composition-mode.js';
-import { addCompositionOptions } from '../lib/command-options.js';
+import { addAllowDeletionsOption, addCompositionOptions } from '../lib/command-options.js';
 import { isConflictMode } from '../runs/save-path-resolver.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
 import { DEFAULT_CONFIGURED_HOST, toConfiguredHost } from '../host-utils.js';
@@ -46,6 +46,7 @@ export function registerImportCommand(program) {
         .option('--print-prompt', 'Print the generate components prompt without invoking the agent. Replaces the legacy --dry-run prompt-print behaviour on this command.')
         .option('--auto-accept-scope', 'Accept all extracted components without prompting (for scripted/non-TTY callers)');
     addCompositionOptions(cmd);
+    addAllowDeletionsOption(cmd);
     cmd
         .option('--composition-map <path>', 'Consume a hand-authored parent→children interchange map (implies --composite)')
         .option('--composition-agent', 'Opt into agentic mapping resolution when deterministic sources find no groups (implies --composite)')
@@ -136,6 +137,7 @@ export function registerImportCommand(program) {
                     ...(opts.host ? { host: opts.host } : {}),
                     interactive: interactiveTerminalSupported,
                     ...(opts.force ? { force: true } : {}),
+                    ...(opts.allowDeletions ? { allowDeletions: true } : {}),
                 });
                 return;
             }
@@ -166,6 +168,7 @@ export function registerImportCommand(program) {
                     ...(opts.saveAsNew ? { saveAsNew: true } : {}),
                     ...(opts.outDir ? { outDir: opts.outDir } : {}),
                     ...(opts.force ? { force: true } : {}),
+                    ...(opts.allowDeletions ? { allowDeletions: true } : {}),
                 });
                 return;
             }
@@ -297,6 +300,7 @@ export function registerImportCommand(program) {
                 selectPromptPath: opts.selectPromptPath ?? creds.selectPromptPath,
                 generatePromptPath: opts.generatePromptPath ?? creds.generatePromptPath,
                 ...(opts.rawTokens ? { initialRawTokensPath: resolve(opts.rawTokens) } : {}),
+                allowDeletions: opts.allowDeletions === true,
                 ...pickerProps,
             }));
             unmountInk = unmount;
@@ -357,6 +361,7 @@ export function registerImportCommand(program) {
             dryRun: dryRunForward,
             selectPromptPath: opts.selectPromptPath,
             autoRejectCycles: opts.autoRejectCycles ?? false,
+            allowDeletions: opts.allowDeletions ?? false,
             compositionMode: headlessCompositionMode,
             ...(opts.compositionMap ? { compositionMap: opts.compositionMap } : {}),
             ...(opts.compositionAgent ? { compositionAgent: true } : {}),

package/dist/src/import/orchestrator.d.ts

@@ -26,6 +26,7 @@ export interface PipelineOptions {
     selectPromptPath?: string;
     /** When true, auto-reject cycle participants and retry push instead of surfacing an error. */
     autoRejectCycles?: boolean;
+    allowDeletions?: boolean;
     compositionMode?: CompositionMode;
     compositionMap?: string;
     compositionAgent?: boolean;

package/dist/src/import/orchestrator.js

@@ -6,19 +6,17 @@ import { openPipelineDb, getOrCreateSession, createStep, updateStep, findLatestS
 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';
+import { getDebugLogger, debugEnvForSubprocess } from '../lib/debug-logger.js';
 function findCliPath() {
     return join(fileURLToPath(import.meta.url), '..', '..', '..', '..', 'bin', 'cli.js');
 }
-async function runStep(args, cliPath, analyticsSessionId, env = {}, streamStderr = false) {
+async function runStep(args, cliPath, 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),
+            env: debugEnvForSubprocess({ ...process.env, ...env }),
         });
         let stdout = '';
         let stderr = '';
@@ -110,10 +108,6 @@ export async function runPipeline(opts, progressWriter, cliPathOverride) {
         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}`);
@@ -165,7 +159,7 @@ export async function runPipeline(opts, progressWriter, cliPathOverride) {
             if (opts.agent)
                 analyzeArgs.push('--agent', opts.agent);
         }
-        const r = await runStep(analyzeArgs, cliPath, sessionId);
+        const r = await runStep(analyzeArgs, cliPath);
         const durationMs = Date.now() - t0;
         if (r.exitCode !== 0) {
             if (r.stderr)
@@ -237,7 +231,7 @@ export async function runPipeline(opts, progressWriter, cliPathOverride) {
                 editArgs.push('--select-all');
             }
         }
-        const rEdit = await runStep(editArgs, cliPath, sessionId, { FORCE_COLOR: '1' }, useAgentSelect);
+        const rEdit = await runStep(editArgs, cliPath, { FORCE_COLOR: '1' }, useAgentSelect);
         const editDurationMs = Date.now() - t0Edit;
         if (rEdit.exitCode !== 0) {
             if (rEdit.stderr && !useAgentSelect)
@@ -298,7 +292,7 @@ export async function runPipeline(opts, progressWriter, cliPathOverride) {
             extractSession: extractSessionId ?? '',
         });
         const t0 = Date.now();
-        const r = await runStep(generateArgs, cliPath, sessionId, { FORCE_COLOR: '1' }, true);
+        const r = await runStep(generateArgs, cliPath, { FORCE_COLOR: '1' }, true);
         const durationMs = Date.now() - t0;
         if (r.exitCode !== 0) {
             updateStep(db, stepId, 'failed', {}, r.stderr);
@@ -361,7 +355,7 @@ export async function runPipeline(opts, progressWriter, cliPathOverride) {
             out: componentsPath,
         });
         const t0 = Date.now();
-        const r = await runStep(printArgs, cliPath, sessionId);
+        const r = await runStep(printArgs, cliPath);
         const durationMs = Date.now() - t0;
         if (r.exitCode !== 0) {
             if (r.stderr)
@@ -424,12 +418,14 @@ export async function runPipeline(opts, progressWriter, cliPathOverride) {
             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);
+        let r = await runStep(pushArgs, cliPath, { FORCE_COLOR: '1' }, true);
         const excludedByRetry = [];
         let validationRetryCount = 0;
         while (validationRetryCount < MAX_VALIDATION_RETRIES && isPreviewValidationError(r) && extractSessionId) {
@@ -446,10 +442,10 @@ export async function runPipeline(opts, progressWriter, cliPathOverride) {
                 '--exclude-components',
                 offenders.join(','),
             ];
-            const rejectResult = await runStep(rejectArgs, cliPath, sessionId);
+            const rejectResult = await runStep(rejectArgs, cliPath);
             if (rejectResult.exitCode !== 0)
                 break;
-            r = await runStep(pushArgs, cliPath, sessionId, { FORCE_COLOR: '1' }, true);
+            r = await runStep(pushArgs, cliPath, { FORCE_COLOR: '1' }, true);
             validationRetryCount++;
         }
         const durationMs = Date.now() - t0;
@@ -484,10 +480,10 @@ export async function runPipeline(opts, progressWriter, cliPathOverride) {
                         '--exclude-components',
                         cycleNames.join(','),
                     ];
-                    const rejectResult = await runStep(rejectArgs, cliPath, sessionId);
+                    const rejectResult = await runStep(rejectArgs, cliPath);
                     if (rejectResult.exitCode === 0) {
                         const retryT0 = Date.now();
-                        const retryR = await runStep(pushArgs, cliPath, sessionId, { FORCE_COLOR: '1' }, true);
+                        const retryR = await runStep(pushArgs, cliPath, { FORCE_COLOR: '1' }, true);
                         const retryDurationMs = Date.now() - t0 + (Date.now() - retryT0);
                         if (isSlotCycleError(retryR)) {
                             const retryReport = extractCycleReport(retryR.stderr);

package/dist/src/import/tui/WizardApp.d.ts

@@ -66,5 +66,6 @@ export type WizardAppProps = {
     initialRawTokensPath?: string;
     initialRuns?: RunRecord[];
     onRunPicked?: (selection: RunPickerSelection) => void;
+    allowDeletions?: boolean;
 };
-export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, initialProjectPath, host, autoAcceptScope, autoRejectCycles, compositionMode, compositionMap, compositionAgent, compositionAgentMode, compositionRefresh, generateMap, promptOverrides, noCache, autoFilter, livePreview, noPush, noSave, outDirOverride, onConflictMode, selectPromptPath, generatePromptPath, seedExtractSessionId, seedGenerateSessionId, seedTokenSessionId, seedTokensPath, initialStep, initialRawTokensPath, initialRuns, onRunPicked, }?: WizardAppProps): React.ReactElement;
+export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, initialProjectPath, host, autoAcceptScope, autoRejectCycles, compositionMode, compositionMap, compositionAgent, compositionAgentMode, compositionRefresh, generateMap, promptOverrides, noCache, autoFilter, livePreview, noPush, noSave, outDirOverride, onConflictMode, selectPromptPath, generatePromptPath, seedExtractSessionId, seedGenerateSessionId, seedTokenSessionId, seedTokensPath, initialStep, initialRawTokensPath, initialRuns, onRunPicked, allowDeletions, }?: WizardAppProps): React.ReactElement;

package/dist/src/import/tui/WizardApp.js

@@ -138,7 +138,7 @@ function logStep(entry) {
     appendFileSync(WIZARD_LOG, line);
     getDebugLogger().event('wizard', 'step', entry);
 }
-export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master', initialCmaToken = '', initialHost, initialAgent, initialModel, initialProjectPath, host, autoAcceptScope = false, autoRejectCycles = false, compositionMode = 'atomic', compositionMap, compositionAgent = false, compositionAgentMode, compositionRefresh = false, generateMap, promptOverrides, noCache = false, autoFilter = true, livePreview = true, noPush = false, noSave = false, outDirOverride, onConflictMode, selectPromptPath, generatePromptPath, seedExtractSessionId, seedGenerateSessionId, seedTokenSessionId, seedTokensPath, initialStep, initialRawTokensPath, initialRuns, onRunPicked, } = {}) {
+export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master', initialCmaToken = '', initialHost, initialAgent, initialModel, initialProjectPath, host, autoAcceptScope = false, autoRejectCycles = false, compositionMode = 'atomic', compositionMap, compositionAgent = false, compositionAgentMode, compositionRefresh = false, generateMap, promptOverrides, noCache = false, autoFilter = true, livePreview = true, noPush = false, noSave = false, outDirOverride, onConflictMode, selectPromptPath, generatePromptPath, seedExtractSessionId, seedGenerateSessionId, seedTokenSessionId, seedTokensPath, initialStep, initialRawTokensPath, initialRuns, onRunPicked, allowDeletions = false, } = {}) {
     const defaultConfiguredHost = toConfiguredHost(host || process.env['EDS_HOST']) ?? DEFAULT_CONFIGURED_HOST;
     const resolveWizardHost = (hostValue) => hostValue || defaultConfiguredHost;
     const { stdout } = useStdout();
@@ -830,7 +830,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                 tokens = await readTokensFromPath('tokens', tokensPath);
             }
             let manifest = buildManifest(components, tokens, { deleteAllComponents: allowEmptyDeleteAllRef.current });
-            let preview = await client.previewImport(manifest);
+            let preview = await client.previewImport(manifest, allowDeletions);
             if (extractSessionId) {
                 let needsRepreview = false;
                 const db = openPipelineDb();
@@ -852,7 +852,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                     if (needsRepreview) {
                         components = loadCDFComponents(db, extractSessionId);
                         manifest = buildManifest(components, tokens, { deleteAllComponents: allowEmptyDeleteAllRef.current });
-                        preview = await client.previewImport(manifest);
+                        preview = await client.previewImport(manifest, allowDeletions);
                     }
                 }
                 finally {
@@ -946,7 +946,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
             });
         }
     };
-    const runPush = async (manifest, spaceId, environmentId, cmaToken, host, acknowledgeBreakingChanges, preview) => {
+    const runPush = async (manifest, spaceId, environmentId, cmaToken, host, acknowledgeBreakingChanges, allowDeletions, preview) => {
         if (shouldRefusePush(state)) {
             update(buildSkippedPushTransition());
             return;
@@ -986,7 +986,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                 environmentId,
                 host: resolvedHost,
             });
-            let operation = await client.applyImport(manifest, acknowledgeBreakingChanges);
+            let operation = await client.applyImport(manifest, { acknowledgeBreakingChanges, allowDeletions });
             try {
                 logStep({
                     applyResponse: {
@@ -1437,7 +1437,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                 return (_jsx(RunningStep, { stepNumber: stepNum, totalSteps: totalSteps, title: "Generating definitions", description: `${formatAcceptanceSummary({ accepted: state.acceptedCount, autoRejected: state.autoRejectedCount })} ${state.agent} is mapping your TypeScript types to Contentful's CDF format.${hasTokens ? ' Using your design tokens for prop resolution.' : ''}`, detail: progressDetail }));
             }
             case 'final-review': {
-                return (_jsx(FinalReviewHost, { extractSessionId: state.extractSessionId, generatedCount: state.generatedCount, autoAccept: autoAcceptScope, compositionMode: compositionMode, livePreview: livePreview, spaceId: state.spaceId, environmentId: state.environmentId, cmaToken: state.cmaToken, host: state.host, tokensPath: state.tokensPath, initialFinalizeError: state.finalizeErrorBanner, onFinalize: (accepted, rejected, unresolved) => {
+                return (_jsx(FinalReviewHost, { extractSessionId: state.extractSessionId, generatedCount: state.generatedCount, autoAccept: autoAcceptScope, compositionMode: compositionMode, livePreview: livePreview, spaceId: state.spaceId, environmentId: state.environmentId, cmaToken: state.cmaToken, host: state.host, tokensPath: state.tokensPath, initialFinalizeError: state.finalizeErrorBanner, allowDeletions: allowDeletions, onFinalize: (accepted, rejected, unresolved) => {
                         process.stderr.write(`Accepted: ${accepted}  Rejected: ${rejected}  Unresolved: ${unresolved}\n`);
                         let acceptedCount = accepted;
                         const detectAcceptedCycles = () => {
@@ -1605,8 +1605,8 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                 // present-but-empty (only $schema), so editing would dead-end on the
                 // "No generated definitions found" screen.
                 const editableComponentCount = Object.keys(state.manifest?.componentsManifest ?? {}).filter((k) => k !== '$schema').length;
-                return (_jsx(WizardPreviewStep, { preview: state.serverPreview, spaceId: state.spaceId, environmentId: state.environmentId, stepNumber: totalSteps, totalSteps: totalSteps, onConfirm: (acknowledge) => {
-                        void runPush(state.manifest, state.spaceId, state.environmentId, state.cmaToken, state.host, acknowledge, state.serverPreview);
+                return (_jsx(WizardPreviewStep, { preview: state.serverPreview, spaceId: state.spaceId, environmentId: state.environmentId, stepNumber: totalSteps, totalSteps: totalSteps, allowDeletions: allowDeletions, onConfirm: (acknowledge, deleteMissing) => {
+                        void runPush(state.manifest, state.spaceId, state.environmentId, state.cmaToken, state.host, acknowledge, deleteMissing, state.serverPreview);
                     }, ...(editableComponentCount > 0 ? { onEdit: () => void runEditFromPreview() } : {}), onSaveFiles: () => {
                         void startSaveFlow();
                     }, onQuit: () => process.exit(0) }));

package/dist/src/import/tui/final-review-host.d.ts

@@ -14,5 +14,6 @@ export type FinalReviewHostProps = {
     host?: string;
     tokensPath?: string;
     initialFinalizeError?: string | null;
+    allowDeletions?: boolean;
 };
-export declare function FinalReviewHost({ extractSessionId, generatedCount, autoAccept, compositionMode, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, }: FinalReviewHostProps): React.ReactElement;
+export declare function FinalReviewHost({ extractSessionId, generatedCount, autoAccept, compositionMode, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, allowDeletions, }: FinalReviewHostProps): React.ReactElement;

package/dist/src/import/tui/final-review-host.js

@@ -4,7 +4,7 @@ import { PALETTE } from '../../analyze/select/tui/theme.js';
 import React from 'react';
 import { GenerateReviewStep } from './steps/GenerateReviewStep.js';
 import { AtomicGenerateReviewStep } from './steps/AtomicGenerateReviewStep.js';
-export function FinalReviewHost({ extractSessionId, generatedCount, autoAccept, compositionMode = 'atomic', onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, }) {
+export function FinalReviewHost({ extractSessionId, generatedCount, autoAccept, compositionMode = 'atomic', onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, allowDeletions, }) {
     if (!extractSessionId) {
         return (_jsx(Box, { paddingX: 2, paddingY: 1, children: _jsx(Text, { color: PALETTE.error, children: "Error: no session ID \u2014 cannot load generated definitions." }) }));
     }
@@ -15,7 +15,7 @@ export function FinalReviewHost({ extractSessionId, generatedCount, autoAccept,
     // passes projectSlotGraph to FieldEditor and never walks closures/cycles, so
     // slot-composition editing and every hierarchy affordance stay absent.
     const StepComponent = compositionMode === 'atomic' ? AtomicGenerateReviewStep : GenerateReviewStep;
-    return (_jsx(StepComponent, { extractSessionId: extractSessionId, onFinalize: onFinalize, onQuit: onQuit, livePreview: livePreview, spaceId: spaceId, environmentId: environmentId, cmaToken: cmaToken, host: host, tokensPath: tokensPath, initialFinalizeError: initialFinalizeError }));
+    return (_jsx(StepComponent, { extractSessionId: extractSessionId, onFinalize: onFinalize, onQuit: onQuit, livePreview: livePreview, spaceId: spaceId, environmentId: environmentId, cmaToken: cmaToken, host: host, tokensPath: tokensPath, initialFinalizeError: initialFinalizeError, ...(compositionMode !== 'atomic' ? { allowDeletions } : {}) }));
 }
 function FinalReviewAutoAccept({ generatedCount, onFinalize, }) {
     React.useEffect(() => {

package/dist/src/import/tui/runLivePreview.d.ts

@@ -26,6 +26,9 @@ export type RunLivePreviewOptions = {
      *  full delete. Lets the Finalize dialog show exactly what the accepted push
      *  would delete, independent of the session's on-disk generated rows. */
     acceptedKeys?: ReadonlySet<string>;
+    /** Forwarded verbatim to `previewImport`. Governs whether the response
+     *  includes removed entities or a suppressed-count summary instead. */
+    allowDeletions?: boolean;
 };
 /**
  * Pure async helper used by `useLivePreview` to re-fire `previewImport` after a

package/dist/src/import/tui/runLivePreview.js

@@ -60,7 +60,10 @@ export async function runLivePreview(opts) {
         timeoutHandle = setTimeout(() => reject(new TimeoutError()), timeoutMs);
     });
     try {
-        const response = (await Promise.race([client.previewImport(manifest), timeoutPromise]));
+        const response = (await Promise.race([
+            client.previewImport(manifest, opts.allowDeletions === true),
+            timeoutPromise,
+        ]));
         if (process.env['EDS_VERBOSE']) {
             const durationMs = Date.now() - startedAt;
             try {

package/dist/src/import/tui/steps/GenerateReviewStep.d.ts

@@ -11,6 +11,7 @@ type GenerateReviewStepProps = {
     host?: string;
     tokensPath?: string;
     initialFinalizeError?: string | null;
+    allowDeletions?: boolean;
 };
 export declare function sortComponentsForSidebar<T extends {
     key: string;
@@ -33,4 +34,4 @@ export interface BreakingRow {
 }
 export declare function buildBreakingRows(breakingChanges: BreakingComponent[]): BreakingRow[];
 export declare function deriveBreakingChanges(response: ServerPreviewResponse): BreakingComponent[];
-export declare function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, }: GenerateReviewStepProps): React.ReactElement;
+export declare function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, allowDeletions, }: GenerateReviewStepProps): React.ReactElement;

package/dist/src/import/tui/steps/GenerateReviewStep.js

@@ -174,7 +174,7 @@ export function deriveBreakingChanges(response) {
     }
     return out;
 }
-export function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, livePreview = true, spaceId = '', environmentId = '', cmaToken = '', host = '', tokensPath = '', initialFinalizeError = null, }) {
+export function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, livePreview = true, spaceId = '', environmentId = '', cmaToken = '', host = '', tokensPath = '', initialFinalizeError = null, allowDeletions = false, }) {
     const { stdout } = useStdout();
     const terminalWidth = stdout?.columns ?? 80;
     const [components, setComponents] = useState([]);
@@ -271,9 +271,8 @@ export function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, liveP
         cmaToken,
         host,
         onResult: handleLivePreviewResult,
-        // With nothing accepted, preview the delete-all diff so the review UI shows
-        // which existing components a push would remove (instead of an empty preview).
         deleteAllComponents: acceptedCountForPreview === 0,
+        allowDeletions,
     });
     const SPINNER_FRAMES = '⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏';
     const [spinnerTick, setSpinnerTick] = useState(0);
@@ -352,6 +351,7 @@ export function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, liveP
         cmaToken,
         host,
         acceptedKeys: new Set(components.filter((c) => c.status === 'accepted').map((c) => c.key)),
+        allowDeletions,
     });
     const handleFinalizeConfirm = () => {
         const acceptedCount = components.filter((c) => c.status === 'accepted').length;

package/dist/src/import/tui/steps/WizardPreviewStep.d.ts

@@ -12,10 +12,14 @@ type WizardPreviewStepProps = {
     environmentId: string;
     stepNumber: number;
     totalSteps: number;
-    onConfirm: (acknowledge: boolean) => void;
+    /** The value the preview was actually fetched with — not a hint. When
+     *  `false`, the server never returned removed entities, so there is
+     *  nothing to render item-by-item or toggle over. */
+    allowDeletions?: boolean;
+    onConfirm: (acknowledge: boolean, allowDeletions: boolean) => void;
     onEdit?: () => void;
     onSaveFiles?: () => void;
     onQuit: () => void;
 };
-export declare function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber, totalSteps, onConfirm, onEdit, onSaveFiles, onQuit, }: WizardPreviewStepProps): React.ReactElement;
+export declare function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber, totalSteps, allowDeletions: fetchedAllowDeletions, onConfirm, onEdit, onSaveFiles, onQuit, }: WizardPreviewStepProps): React.ReactElement;
 export {};

package/dist/src/import/tui/steps/WizardPreviewStep.js

@@ -89,10 +89,14 @@ export function buildPreviewDiffLines(preview) {
     }
     return lines;
 }
-export function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber, totalSteps, onConfirm, onEdit, onSaveFiles, onQuit, }) {
+export function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber, totalSteps, allowDeletions: fetchedAllowDeletions = false, onConfirm, onEdit, onSaveFiles, onQuit, }) {
     const breakingWithImpact = hasBreakingChangesWithImpact(preview);
     const [diffExpanded, setDiffExpanded] = useState(false);
     const [scrollOffset, setScrollOffset] = useState(0);
+    // Local state exists only to let the user opt OUT of a deletion the fetch
+    // already surfaced — it can never turn true when the fetch used false,
+    // because there's nothing in `preview` to reveal in that case.
+    const [allowDeletions, setAllowDeletions] = useState(fetchedAllowDeletions);
     const { stdout } = useStdout();
     const terminalRows = stdout?.rows ?? 40;
     const viewportHeight = Math.max(terminalRows - 14, 10);
@@ -105,9 +109,14 @@ export function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber,
         }));
     }, [diffExpanded, preview]);
     const maxScroll = Math.max(0, allDiffLines.length - viewportHeight);
+    const removedCount = preview.components.removed.length + preview.tokens.removed.length;
     useImmediateInput((input, key) => {
         if (key.return) {
-            onConfirm(breakingWithImpact);
+            onConfirm(breakingWithImpact, allowDeletions);
+            return;
+        }
+        if ((input === 'x' || input === 'X') && fetchedAllowDeletions && removedCount > 0) {
+            setAllowDeletions((prev) => !prev);
             return;
         }
         if (input === 'd' || input === 'D') {
@@ -156,5 +165,5 @@ export function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber,
                                     })] })), components.changed.length > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.warning, children: " \uFF5E" }), _jsxs(Text, { children: [components.changed.length, " will be updated"] })] }), components.changed.map((item, i) => {
                                         const isBreaking = item.changeClassification?.classification === 'breaking';
                                         return (_jsxs(Text, { color: isBreaking ? PALETTE.error : PALETTE.warning, children: [' ', isBreaking ? '⚠' : '~', " ", item.current.name] }, `chg-${i}`));
-                                    })] })), components.removed.length > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.error, children: " \u2717" }), _jsxs(Text, { children: [components.removed.length, " will be removed"] })] }), components.removed.map((item, i) => (_jsxs(Text, { color: PALETTE.error, children: [' ', "\u2717 ", item.name] }, `rm-${i}`)))] })), components.unchanged.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: " \u00B7" }), _jsxs(Text, { dimColor: true, children: [components.unchanged.length, " unchanged"] })] }))] })), hasTokens && (_jsxs(Box, { flexDirection: "column", gap: 0, children: [_jsx(Box, { gap: 1, marginTop: 1, children: _jsx(Text, { bold: true, dimColor: true, children: "Design Tokens" }) }), tokens.new.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.success, children: " \uFF0B" }), _jsxs(Text, { children: [tokens.new.length, " will be created"] })] })), tokens.changed.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.warning, children: " \uFF5E" }), _jsxs(Text, { children: [tokens.changed.length, " will be updated"] })] })), tokens.removed.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.error, children: " \u2717" }), _jsxs(Text, { children: [tokens.removed.length, " will be removed"] })] })), tokens.unchanged.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: " \u00B7" }), _jsxs(Text, { dimColor: true, children: [tokens.unchanged.length, " unchanged"] })] }))] })), diffExpanded && allDiffLines.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { dimColor: true, children: '─'.repeat(40) }), _jsxs(Text, { dimColor: true, children: [' ', "Diff (", allDiffLines.length, " lines) \u2014 line ", scrollOffset + 1, "\u2013", Math.min(scrollOffset + viewportHeight, allDiffLines.length), " of ", allDiffLines.length] }), _jsx(Box, { flexDirection: "column", children: allDiffLines.slice(scrollOffset, scrollOffset + viewportHeight).map((line) => (_jsx(Box, { children: line.element }, line.key))) }), maxScroll > 0 && _jsx(Text, { dimColor: true, children: " \u2195 j/k to scroll, f/b to page" })] }))] })) : (_jsx(Text, { dimColor: true, children: "Nothing to push \u2014 everything is already up to date." })), _jsxs(Box, { gap: 1, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "Space:" }), _jsx(Text, { children: spaceId }), _jsx(Text, { dimColor: true, children: "/" }), _jsx(Text, { dimColor: true, children: "Environment:" }), _jsx(Text, { children: environmentId })] }), breakingWithImpact && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: PALETTE.error, bold: true, children: "\u26A0 Breaking changes will affect downstream entities. Press Enter to acknowledge and apply." }) })), _jsxs(Box, { gap: 3, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "[Enter] Push to Contentful" }), _jsxs(Text, { dimColor: true, children: ["[d] ", diffExpanded ? 'Hide' : 'Show', " diff"] }), diffExpanded && _jsx(Text, { dimColor: true, children: "[j/k] Scroll [f/b] Page" }), onEdit && _jsx(Text, { dimColor: true, children: "[e] Edit definitions" }), onSaveFiles && _jsx(Text, { dimColor: true, children: "[s] Save files instead" }), _jsx(Text, { dimColor: true, children: "[q] Cancel" })] })] }));
+                                    })] })), components.removed.length > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: allowDeletions ? PALETTE.error : PALETTE.warning, children: allowDeletions ? ' ✗' : ' ⊘' }), _jsxs(Text, { children: [components.removed.length, " will be ", allowDeletions ? 'deleted' : 'skipped'] })] }), components.removed.map((item, i) => (_jsxs(Text, { color: allowDeletions ? PALETTE.error : PALETTE.warning, dimColor: !allowDeletions, children: [' ', allowDeletions ? '✗' : '⊘', " ", item.name] }, `rm-${i}`)))] })), components.unchanged.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: " \u00B7" }), _jsxs(Text, { dimColor: true, children: [components.unchanged.length, " unchanged"] })] }))] })), hasTokens && (_jsxs(Box, { flexDirection: "column", gap: 0, children: [_jsx(Box, { gap: 1, marginTop: 1, children: _jsx(Text, { bold: true, dimColor: true, children: "Design Tokens" }) }), tokens.new.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.success, children: " \uFF0B" }), _jsxs(Text, { children: [tokens.new.length, " will be created"] })] })), tokens.changed.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.warning, children: " \uFF5E" }), _jsxs(Text, { children: [tokens.changed.length, " will be updated"] })] })), tokens.removed.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: allowDeletions ? PALETTE.error : PALETTE.warning, children: allowDeletions ? ' ✗' : ' ⊘' }), _jsxs(Text, { children: [tokens.removed.length, " will be ", allowDeletions ? 'deleted' : 'skipped'] })] })), tokens.unchanged.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: " \u00B7" }), _jsxs(Text, { dimColor: true, children: [tokens.unchanged.length, " unchanged"] })] }))] })), diffExpanded && allDiffLines.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { dimColor: true, children: '─'.repeat(40) }), _jsxs(Text, { dimColor: true, children: [' ', "Diff (", allDiffLines.length, " lines) \u2014 line ", scrollOffset + 1, "\u2013", Math.min(scrollOffset + viewportHeight, allDiffLines.length), " of ", allDiffLines.length] }), _jsx(Box, { flexDirection: "column", children: allDiffLines.slice(scrollOffset, scrollOffset + viewportHeight).map((line) => (_jsx(Box, { children: line.element }, line.key))) }), maxScroll > 0 && _jsx(Text, { dimColor: true, children: " \u2195 j/k to scroll, f/b to page" })] }))] })) : (_jsx(Text, { dimColor: true, children: "Nothing to push \u2014 everything is already up to date." })), !fetchedAllowDeletions && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.warning, children: " \u2298" }), _jsx(Text, { children: "Deletions are hidden by default \u2014 rerun with --allow-deletions to see them." })] })), _jsxs(Box, { gap: 1, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "Space:" }), _jsx(Text, { children: spaceId }), _jsx(Text, { dimColor: true, children: "/" }), _jsx(Text, { dimColor: true, children: "Environment:" }), _jsx(Text, { children: environmentId })] }), breakingWithImpact && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: PALETTE.error, bold: true, children: "\u26A0 Breaking changes will affect downstream entities. Press Enter to acknowledge and apply." }) })), allowDeletions && removedCount > 0 && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: PALETTE.error, bold: true, children: ["\u26A0 ", removedCount, " missing ", removedCount === 1 ? 'entity' : 'entities', " will be permanently deleted. Press Enter to confirm."] }) })), _jsxs(Box, { gap: 3, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "[Enter] Push to Contentful" }), _jsxs(Text, { dimColor: true, children: ["[d] ", diffExpanded ? 'Hide' : 'Show', " diff"] }), diffExpanded && _jsx(Text, { dimColor: true, children: "[j/k] Scroll [f/b] Page" }), onEdit && _jsx(Text, { dimColor: true, children: "[e] Edit definitions" }), onSaveFiles && _jsx(Text, { dimColor: true, children: "[s] Save files instead" }), fetchedAllowDeletions && removedCount > 0 && (_jsxs(Text, { dimColor: true, children: ["[x] ", allowDeletions ? '[✓]' : '[ ]', " Allow deletions"] })), _jsx(Text, { dimColor: true, children: "[q] Cancel" })] })] }));
 }

package/dist/src/import/tui/useFinalizePreview.d.ts

@@ -11,6 +11,8 @@ export type UseFinalizePreviewOptions = {
     host: string;
     /** Component keys the operator has accepted; drives the scoped preview. */
     acceptedKeys: ReadonlySet<string>;
+    /** Forwarded verbatim to `runLivePreview`/`previewImport`. */
+    allowDeletions?: boolean;
 };
 export type UseFinalizePreviewReturn = {
     status: FinalizePreviewStatus;

package/dist/src/import/tui/useLivePreview.d.ts

@@ -12,6 +12,8 @@ export type UseLivePreviewOptions = {
     /** Preview an empty-but-present manifest (delete-all diff) when nothing is
      *  accepted, so the final-review UI can show what a push would delete. */
     deleteAllComponents?: boolean;
+    /** Forwarded verbatim to `runLivePreview`/`previewImport`. */
+    allowDeletions?: boolean;
 };
 export type LivePreviewStatus = 'idle' | 'running';
 export type UseLivePreviewReturn = {

package/dist/src/import/tui/useLivePreview.js

@@ -82,6 +82,7 @@ export function useLivePreview(opts) {
                 host: current.host,
                 generation,
                 deleteAllComponents: current.deleteAllComponents === true,
+                allowDeletions: current.allowDeletions === true,
             });
             // Discard stale responses (generation tag).
             if (result.generation !== latestRef.current)

package/dist/src/index.js

@@ -1,12 +1,7 @@
 import { createProgram } from './program.js';
-import { failActiveCommand, flushAnalytics } from './analytics/index.js';
 createProgram()
     .parseAsync()
-    .catch(async (err) => {
-    await failActiveCommand({
-        error_name: err instanceof Error ? err.name : 'Error',
-    });
-    await flushAnalytics();
+    .catch((err) => {
     process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
     process.exit(1);
 });

package/dist/src/lib/command-options.d.ts

@@ -3,3 +3,4 @@ export declare function addArtifactInputOptions(cmd: Command): Command;
 export declare function addContentfulTargetOptions(cmd: Command): Command;
 export declare function addCompositionOptions(cmd: Command): Command;
 export declare function addSelectionOptions(cmd: Command): Command;
+export declare function addAllowDeletionsOption(cmd: Command): Command;

package/dist/src/lib/command-options.js

@@ -25,3 +25,6 @@ export function addSelectionOptions(cmd) {
         .option('--select <pattern>', 'Select entities by ID pattern (repeatable)', collectOptionValue, [])
         .option('--deselect <pattern>', 'Deselect entities by ID pattern (repeatable)', collectOptionValue, []);
 }
+export function addAllowDeletionsOption(cmd) {
+    return cmd.option('--allow-deletions', 'Allow the push to delete remote ComponentTypes/DesignTokens missing from the manifest (default: skip them)');
+}