@contentful/experience-design-system-cli 2.18.1-dev-build-ebf672a.0 → 2.18.1-dev-build-2117d43.0

package/README.md

@@ -214,6 +214,7 @@ Pass `--select-prompt-path <path>` and/or `--generate-prompt-path <path>` to swa
 | `--host <url>`                    | `https://api.contentful.com`           | Override API base URL                                                                                        |
 | `--on-conflict <mode>`            | _(prompt via `<SaveConflictGate>`)_    | Headless conflict resolution when a file already exists at the save path: `overwrite`, `skip`, or `fail`. Bypasses the wizard's interactive save-conflict gate. Mutex with `--no-save`. |
 | `--print-prompt`                  | —                                      | Print the generate prompt to stdout and exit. Replaces the prompt-print semantics of `--dry-run`.            |
+| `--allow-deletions`               | off (non-destructive)                  | Allow the push to delete remote ComponentTypes/DesignTokens missing from the manifest. Default skips them instead of deleting. Forwarded to headless subprocess pushes and `--push-from-run`. |
 | `--dry-run`                       | _(deprecated)_                         | Deprecated alias for `--print-prompt`. Emits a stderr deprecation notice; prompt-print semantics will be removed in a future release. |
 
 ### Run-picker at wizard start
@@ -418,7 +419,7 @@ experiences apply select  --space-id <id> --environment-id <env> --session <id>
 experiences apply push    --space-id <id> --environment-id <env> --session <id> [--yes]
 ```
 
-Shared flags: `--components`, `--tokens`, `--session`, `--space-id`, `--environment-id`, `--cma-token`, `--host`, `--viewports`. `apply preview` adds `--include-unchanged`. `apply select` adds `--select-all`, `--select`, `--deselect`, `--force`. `apply push` adds `--yes`, `--verbose`, `--force`, `--dry-run`.
+Shared flags: `--components`, `--tokens`, `--session`, `--space-id`, `--environment-id`, `--cma-token`, `--host`, `--viewports`. `apply preview` adds `--include-unchanged`. `apply select` adds `--select-all`, `--select`, `--deselect`, `--force`, `--allow-deletions`. `apply push` adds `--yes`, `--verbose`, `--force`, `--dry-run`, `--allow-deletions`. By default, remote ComponentTypes and DesignTokens missing from the pushed manifest are skipped, not deleted; pass `--allow-deletions` to restore the prior delete behavior.
 
 Design tokens are written first (component types may reference token kinds). Each entity write is recorded in the session database atomically — interrupted pushes resume from where they left off.
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.18.1-dev-build-ebf672a.0",
+  "version": "2.18.1-dev-build-2117d43.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -56,7 +56,7 @@
     "eslint-plugin-prettier": "^5.5.4",
     "ink-testing-library": "^4.0.0",
     "typescript-eslint": "^8.52.0",
-    "vitest": "^4.1.10"
+    "vitest": "^4.0.16"
   },
   "repository": {
     "type": "git",

package/dist/src/apply/api-client.d.ts

@@ -51,7 +51,10 @@ export declare class ImportApiClient {
     private requestWithRetry;
     validateToken(): Promise<void>;
     previewImport(manifest: ManifestPayload): Promise<ServerPreviewResponse>;
-    applyImport(manifest: ManifestPayload, acknowledgeBreakingChanges: boolean): Promise<ApplyOperationResponse>;
+    applyImport(manifest: ManifestPayload, options: {
+        acknowledgeBreakingChanges: boolean;
+        allowDeletions?: boolean;
+    }): Promise<ApplyOperationResponse>;
     pollOperation(operationId: string, opts?: {
         intervalMs?: number;
         maxIntervalMs?: number;

package/dist/src/apply/api-client.js

@@ -296,12 +296,14 @@ export class ImportApiClient {
         debug.event('apply', 'preview.ok', { status: result.response.status, durationMs: Date.now() - startedAt });
         return sanitizePreviewResponse(parsed);
     }
-    async applyImport(manifest, acknowledgeBreakingChanges) {
+    async applyImport(manifest, options) {
+        const { acknowledgeBreakingChanges, allowDeletions = false } = options;
         const debug = getDebugLogger();
         const startedAt = Date.now();
         debug.event('apply', 'apply.request', {
             url: `${this.base()}/design_systems/imports/apply`,
             acknowledgeBreakingChanges,
+            allowDeletions,
         });
         let result;
         try {
@@ -309,7 +311,7 @@ export class ImportApiClient {
                 baseUrl: this.host,
                 headers: this.headers(),
                 path: { spaceId: this.spaceId, environmentId: this.environmentId },
-                body: { ...manifest, acknowledgeBreakingChanges },
+                body: { ...manifest, acknowledgeBreakingChanges, allowDeletions },
                 parseAs: 'json',
             });
         }

package/dist/src/apply/command.js

@@ -12,7 +12,7 @@ import { ServerPreviewApp, ServerPreviewConfirm, ServerApplyProgress, ServerAppl
 import { SelectView, makeSelectKey } from './tui/SelectView.js';
 import { buildPostPushUrl } from '../lib/contentful-urls.js';
 import { resolveCompositionMode } from '../lib/composition-mode.js';
-import { addArtifactInputOptions, addCompositionOptions, addContentfulTargetOptions, addSelectionOptions, } from '../lib/command-options.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';
@@ -457,6 +457,7 @@ export function registerApplyCommand(program) {
                 preview,
                 spaceId,
                 environmentId,
+                allowDeletions: false,
             }));
             await waitUntilExit();
         }
@@ -469,6 +470,7 @@ export function registerApplyCommand(program) {
     addArtifactInputOptions(pushCmd);
     addContentfulTargetOptions(pushCmd);
     addCompositionOptions(pushCmd);
+    addAllowDeletionsOption(pushCmd);
     pushCmd
         .option('--yes', 'Skip interactive confirmation')
         .option('--verbose', 'Show all entity progress including skipped/unchanged')
@@ -517,6 +519,7 @@ export function registerApplyCommand(program) {
                     preview,
                     spaceId,
                     environmentId,
+                    allowDeletions: opts.allowDeletions === true,
                 }));
                 await waitUntilExit();
             }
@@ -547,7 +550,10 @@ export function registerApplyCommand(program) {
             }
             let operation;
             try {
-                operation = await client.applyImport(manifest, breakingWithImpact || opts.force === true);
+                operation = await client.applyImport(manifest, {
+                    acknowledgeBreakingChanges: breakingWithImpact || opts.force === true,
+                    allowDeletions: opts.allowDeletions === true,
+                });
             }
             catch (e) {
                 if (e instanceof ApiError)
@@ -577,7 +583,10 @@ export function registerApplyCommand(program) {
                 }));
                 let operation;
                 try {
-                    operation = await client.applyImport(manifest, acknowledge);
+                    operation = await client.applyImport(manifest, {
+                        acknowledgeBreakingChanges: acknowledge,
+                        allowDeletions: opts.allowDeletions === true,
+                    });
                 }
                 catch (e) {
                     if (e instanceof ApiError) {
@@ -625,6 +634,7 @@ export function registerApplyCommand(program) {
                 spaceId,
                 environmentId,
                 breakingWithImpact,
+                allowDeletions: opts.allowDeletions === true,
                 onConfirm: (acknowledge) => {
                     void runApply(acknowledge);
                 },
@@ -640,6 +650,7 @@ export function registerApplyCommand(program) {
     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) {
@@ -707,7 +718,10 @@ export function registerApplyCommand(program) {
             }
             let operation;
             try {
-                operation = await client.applyImport(filteredManifest, hasBreaking || opts.force === true);
+                operation = await client.applyImport(filteredManifest, {
+                    acknowledgeBreakingChanges: hasBreaking || opts.force === true,
+                    allowDeletions: opts.allowDeletions === true,
+                });
             }
             catch (e) {
                 if (e instanceof ApiError)
@@ -749,7 +763,10 @@ export function registerApplyCommand(program) {
                 }));
                 let operation;
                 try {
-                    operation = await client.applyImport(filteredManifest, hasBreaking);
+                    operation = await client.applyImport(filteredManifest, {
+                        acknowledgeBreakingChanges: hasBreaking,
+                        allowDeletions: opts.allowDeletions === true,
+                    });
                 }
                 catch (e) {
                     if (e instanceof ApiError) {

package/dist/src/apply/tui/ServerApplyView.d.ts

@@ -5,16 +5,18 @@ interface ServerPreviewConfirmProps {
     spaceId: string;
     environmentId: string;
     breakingWithImpact: boolean;
+    allowDeletions: boolean;
     onConfirm: (acknowledge: boolean) => void;
     onCancel: () => void;
 }
-export declare function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, onConfirm, onCancel, }: ServerPreviewConfirmProps): React.ReactElement;
+export declare function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, allowDeletions, onConfirm, onCancel, }: ServerPreviewConfirmProps): React.ReactElement;
 interface ServerPreviewAppProps {
     preview: ServerPreviewResponse;
     spaceId: string;
     environmentId: string;
+    allowDeletions: boolean;
 }
-export declare function ServerPreviewApp({ preview, spaceId, environmentId }: ServerPreviewAppProps): React.ReactElement;
+export declare function ServerPreviewApp({ preview, spaceId, environmentId, allowDeletions, }: ServerPreviewAppProps): React.ReactElement;
 interface ServerApplyProgressProps {
     spaceId: string;
     environmentId: string;

package/dist/src/apply/tui/ServerApplyView.js

@@ -3,21 +3,22 @@ import { Box, Text, useInput } from 'ink';
 import { ServerPreviewView } from './ServerPreviewView.js';
 import { buildPostPushUrl } from '../../lib/contentful-urls.js';
 import { formatEdsiError } from '../../lib/error-parser.js';
-export function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, onConfirm, onCancel, }) {
+export function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, allowDeletions, onConfirm, onCancel, }) {
     useInput((input, key) => {
         if (key.return)
             onConfirm(breakingWithImpact);
         if (key.escape || input === 'q')
             onCancel();
     });
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ServerPreviewView, { preview: preview, spaceId: spaceId, environmentId: environmentId }), _jsxs(Box, { paddingX: 2, flexDirection: "column", children: [breakingWithImpact && (_jsxs(Text, { color: "red", bold: true, children: [' ', "\u26A0 Breaking changes will affect downstream entities. Press Enter to acknowledge and apply."] })), _jsxs(Text, { children: [' ', "Press ", _jsx(Text, { bold: true, children: "Enter" }), " to apply, ", _jsx(Text, { bold: true, children: "Esc" }), " to cancel"] })] })] }));
+    const removedCount = preview.components.removed.length + preview.tokens.removed.length;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ServerPreviewView, { preview: preview, spaceId: spaceId, environmentId: environmentId, allowDeletions: allowDeletions }), _jsxs(Box, { paddingX: 2, flexDirection: "column", children: [breakingWithImpact && (_jsxs(Text, { color: "red", bold: true, children: [' ', "\u26A0 Breaking changes will affect downstream entities. Press Enter to acknowledge and apply."] })), allowDeletions && removedCount > 0 && (_jsxs(Text, { color: "red", bold: true, children: [' ', "\u26A0 ", removedCount, " missing ", removedCount === 1 ? 'entity' : 'entities', " will be permanently deleted. Press Enter to confirm."] })), _jsxs(Text, { children: [' ', "Press ", _jsx(Text, { bold: true, children: "Enter" }), " to apply, ", _jsx(Text, { bold: true, children: "Esc" }), " to cancel"] })] })] }));
 }
-export function ServerPreviewApp({ preview, spaceId, environmentId }) {
+export function ServerPreviewApp({ preview, spaceId, environmentId, allowDeletions, }) {
     useInput((input, key) => {
         if (key.escape || input === 'q')
             process.exit(0);
     });
-    return _jsx(ServerPreviewView, { preview: preview, spaceId: spaceId, environmentId: environmentId });
+    return (_jsx(ServerPreviewView, { preview: preview, spaceId: spaceId, environmentId: environmentId, allowDeletions: allowDeletions }));
 }
 export function ServerApplyProgress({ spaceId, environmentId, status, operationId, error, }) {
     useInput((_input, key) => {

package/dist/src/apply/tui/ServerPreviewView.d.ts

@@ -4,6 +4,7 @@ interface ServerPreviewViewProps {
     preview: ServerPreviewResponse;
     spaceId: string;
     environmentId: string;
+    allowDeletions: boolean;
 }
-export declare function ServerPreviewView({ preview, spaceId, environmentId }: ServerPreviewViewProps): React.ReactElement;
+export declare function ServerPreviewView({ preview, spaceId, environmentId, allowDeletions, }: ServerPreviewViewProps): React.ReactElement;
 export {};

package/dist/src/apply/tui/ServerPreviewView.js

@@ -13,11 +13,11 @@ function DraftWarning({ hasDraft }) {
         return null;
     return _jsx(Text, { color: "yellow", children: " \u26A1 has pending draft changes" });
 }
-export function ServerPreviewView({ preview, spaceId, environmentId }) {
+export function ServerPreviewView({ preview, spaceId, environmentId, allowDeletions, }) {
     const { components, tokens } = preview;
     const totalComponents = components.new.length + components.changed.length + components.unchanged.length + components.removed.length;
     const totalTokens = tokens.new.length + tokens.changed.length + tokens.unchanged.length + tokens.removed.length;
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsxs(Text, { bold: true, children: ["Preview \u2014 ", environmentId, " @ ", spaceId] }), _jsx(Text, { children: " " }), totalComponents > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [" Component Types (", totalComponents, " total)"] }), _jsxs(Text, { color: "green", children: [" \u2746 ", components.new.length, " to create"] }), _jsxs(Text, { color: "yellow", children: [" ~ ", components.changed.length, " to update"] }), _jsxs(Text, { color: "red", children: [" \u2717 ", components.removed.length, " to remove"] }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", components.unchanged.length, " unchanged"] }), components.changed.map((item, i) => (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: "yellow", children: [" ~ ", item.current.name] }), _jsx(DraftWarning, { hasDraft: item.hasPendingDraftChanges })] }), _jsx(BreakingBadge, { item: item })] }, i))), _jsx(Text, { children: " " })] })), totalTokens > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [" Design Tokens (", totalTokens, " total)"] }), _jsxs(Text, { color: "green", children: [" \u2746 ", tokens.new.length, " to create"] }), _jsxs(Text, { color: "yellow", children: [" ~ ", tokens.changed.length, " to update"] }), _jsxs(Text, { color: "red", children: [" \u2717 ", tokens.removed.length, " to remove"] }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", tokens.unchanged.length, " unchanged"] }), tokens.changed
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsxs(Text, { bold: true, children: ["Preview \u2014 ", environmentId, " @ ", spaceId] }), _jsx(Text, { children: " " }), totalComponents > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [" Component Types (", totalComponents, " total)"] }), _jsxs(Text, { color: "green", children: [" \u2746 ", components.new.length, " to create"] }), _jsxs(Text, { color: "yellow", children: [" ~ ", components.changed.length, " to update"] }), _jsxs(Text, { color: allowDeletions ? 'red' : 'yellow', children: [' ', allowDeletions ? '✗' : '⊘', " ", components.removed.length, " to ", allowDeletions ? 'delete' : 'skip'] }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", components.unchanged.length, " unchanged"] }), components.changed.map((item, i) => (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: "yellow", children: [" ~ ", item.current.name] }), _jsx(DraftWarning, { hasDraft: item.hasPendingDraftChanges })] }), _jsx(BreakingBadge, { item: item })] }, i))), _jsx(Text, { children: " " })] })), totalTokens > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [" Design Tokens (", totalTokens, " total)"] }), _jsxs(Text, { color: "green", children: [" \u2746 ", tokens.new.length, " to create"] }), _jsxs(Text, { color: "yellow", children: [" ~ ", tokens.changed.length, " to update"] }), _jsxs(Text, { color: allowDeletions ? 'red' : 'yellow', children: [' ', allowDeletions ? '✗' : '⊘', " ", tokens.removed.length, " to ", allowDeletions ? 'delete' : 'skip'] }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", tokens.unchanged.length, " unchanged"] }), tokens.changed
                         .filter((t) => t.hasPendingDraftChanges)
                         .map((item, i) => (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: "yellow", children: [" ~ ", item.current.name] }), _jsx(DraftWarning, { hasDraft: true })] }, i))), _jsx(Text, { children: " " })] })), _jsx(Text, { dimColor: true, children: " Press Q to exit." })] }));
 }

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

@@ -418,6 +418,8 @@ 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,

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();
@@ -942,7 +942,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;
@@ -982,7 +982,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: {
@@ -1601,8 +1601,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, initialAllowDeletions: 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/steps/WizardPreviewStep.d.ts

@@ -12,10 +12,11 @@ type WizardPreviewStepProps = {
     environmentId: string;
     stepNumber: number;
     totalSteps: number;
-    onConfirm: (acknowledge: boolean) => void;
+    initialAllowDeletions?: 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, initialAllowDeletions, onConfirm, onEdit, onSaveFiles, onQuit, }: WizardPreviewStepProps): React.ReactElement;
 export {};

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

@@ -89,10 +89,11 @@ 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, initialAllowDeletions = false, onConfirm, onEdit, onSaveFiles, onQuit, }) {
     const breakingWithImpact = hasBreakingChangesWithImpact(preview);
     const [diffExpanded, setDiffExpanded] = useState(false);
     const [scrollOffset, setScrollOffset] = useState(0);
+    const [allowDeletions, setAllowDeletions] = useState(initialAllowDeletions);
     const { stdout } = useStdout();
     const terminalRows = stdout?.rows ?? 40;
     const viewportHeight = Math.max(terminalRows - 14, 10);
@@ -105,9 +106,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') && removedCount > 0) {
+            setAllowDeletions((prev) => !prev);
             return;
         }
         if (input === 'd' || input === 'D') {
@@ -156,5 +162,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." })), _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" }), removedCount > 0 && (_jsxs(Text, { dimColor: true, children: ["[x] ", allowDeletions ? '[✓]' : '[ ]', " Also delete ", removedCount, " ", removedCount === 1 ? 'entity' : 'entities'] })), _jsx(Text, { dimColor: true, children: "[q] Cancel" })] })] }));
 }

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)');
+}

package/dist/src/runs/modify-launcher.d.ts

@@ -26,5 +26,7 @@ export type ModifyLauncherInput = {
     initialHost?: string;
     /** Pre-fill CMA token (from credentials.json / env). */
     initialCmaToken?: string;
+    /** From `--allow-deletions` flag. Forwarded to wizard's push step. */
+    allowDeletions?: boolean;
 };
 export declare function launchModifyWizard(input: ModifyLauncherInput): Promise<void>;

package/dist/src/runs/modify-launcher.js

@@ -35,6 +35,8 @@ export async function launchModifyWizard(input) {
         props.initialHost = input.initialHost;
     if (input.initialCmaToken)
         props.initialCmaToken = input.initialCmaToken;
+    if (input.allowDeletions !== undefined)
+        props.allowDeletions = input.allowDeletions;
     const { waitUntilExit } = render(createElement(WizardApp, props));
     await waitUntilExit();
 }

package/dist/src/runs/push-helpers.d.ts

@@ -15,6 +15,7 @@ export type PushSessionOptions = {
     environmentId: string;
     cmaToken: string;
     host?: string;
+    allowDeletions?: boolean;
 };
 /**
  * Push a recorded pipeline.db session's components + tokens to Contentful by

package/dist/src/runs/push-helpers.js

@@ -60,6 +60,9 @@ export async function pushRunSession(opts) {
     if (opts.host) {
         args.push('--host', opts.host);
     }
+    if (opts.allowDeletions) {
+        args.push('--allow-deletions');
+    }
     const r = await runCli(args);
     if (r.exitCode === 0)
         return { ok: true };

package/dist/src/runs/replay-helpers.d.ts

@@ -16,6 +16,8 @@ export type ReplayRunOptions = {
     interactive?: boolean;
     /** When true, bypass the source/saved-file staleness check. */
     force?: boolean;
+    /** From `--allow-deletions` flag. Forwarded verbatim to the pushed session's apply request. */
+    allowDeletions?: boolean;
     /**
      * Test seam: replace the interactive prompt with a deterministic resolver.
      * The CLI surface never sets this; only used by tests.
@@ -57,6 +59,8 @@ export type ModifyRunOptions = {
     outDir?: string;
     /** When true, bypass the source/saved-file staleness check. */
     force?: boolean;
+    /** From `--allow-deletions` flag. Forwarded through the modify wizard's push step. */
+    allowDeletions?: boolean;
 };
 /**
  * Re-open the wizard with a prior run's extract/generate session pre-populated

package/dist/src/runs/replay-helpers.js

@@ -83,6 +83,7 @@ export async function replayRun(opts) {
         environmentId,
         cmaToken,
         ...(host ? { host } : {}),
+        ...(opts.allowDeletions ? { allowDeletions: true } : {}),
     });
     if (!result.ok) {
         throw new Error(result.error);
@@ -98,6 +99,7 @@ export async function replayRun(opts) {
             environmentId,
             cmaToken,
             ...(host ? { host } : {}),
+            ...(opts.allowDeletions ? { allowDeletions: true } : {}),
         });
         if (!tokenResult.ok) {
             throw new Error(tokenResult.error);
@@ -157,5 +159,6 @@ export async function modifyRun(opts) {
         ...(mergedEnvironmentId ? { initialEnvironmentId: mergedEnvironmentId } : {}),
         ...(mergedHost ? { initialHost: mergedHost } : {}),
         ...(mergedCmaToken ? { initialCmaToken: mergedCmaToken } : {}),
+        ...(opts.allowDeletions !== undefined ? { allowDeletions: opts.allowDeletions } : {}),
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.18.1-dev-build-ebf672a.0",
+  "version": "2.18.1-dev-build-2117d43.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -34,9 +34,9 @@
     "react": "^18.3.1",
     "react-devtools-core": "^4.19.1",
     "react-dom": "^18.3.1",
-    "@contentful/experience-design-system-client": "2.18.1-dev-build-ebf672a.0",
-    "@contentful/experience-design-system-extraction": "2.18.1-dev-build-ebf672a.0",
-    "@contentful/experience-design-system-types": "2.18.1-dev-build-ebf672a.0"
+    "@contentful/experience-design-system-client": "2.18.1-dev-build-2117d43.0",
+    "@contentful/experience-design-system-types": "2.18.1-dev-build-2117d43.0",
+    "@contentful/experience-design-system-extraction": "2.18.1-dev-build-2117d43.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.3",
@@ -47,7 +47,7 @@
     "eslint-plugin-prettier": "^5.5.4",
     "ink-testing-library": "^4.0.0",
     "typescript-eslint": "^8.52.0",
-    "vitest": "^4.1.10"
+    "vitest": "^4.0.16"
   },
   "repository": {
     "type": "git",