@contentful/experience-design-system-cli 2.23.2-dev-build-753ceef.0 → 2.23.2-dev-build-e996ffb.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. Without this flag, preview responses suppress the removed-entity list and return a count instead; interactive confirm screens show an opt-out toggle (never opt-in) only when the flag is passed. 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.
 
@@ -450,29 +451,6 @@ Wizard run history is separate: `~/.config/experiences/runs.json`.
 
 ---
 
-## Usage data
-
-The CLI collects **anonymous usage data** to help us understand which commands are used and where the import workflow succeeds or fails. This data does **not** include your source code, file paths, credentials, prompts, or any content you author.
-
-What may be included:
-
-- Command name and duration
-- CLI, Node.js, and operating-system version
-- Anonymous session identifiers that link steps within a single import run
-- Structural counts (for example, how many components were extracted or accepted)
-- Space and environment IDs you pass on the command line
-- Contentful request IDs from API responses (to correlate failures with server logs)
-
-You can turn this off at any time:
-
-```bash
-DISABLE_ANALYTICS=1 experiences import --project ./my-app
-```
-
-Setting `DISABLE_ANALYTICS` to any value disables collection for that invocation.
-
----
-
 ## Development
 
 ```bash

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.23.2-dev-build-753ceef.0",
+  "version": "2.23.2-dev-build-e996ffb.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -41,7 +41,6 @@
     "@contentful/experience-design-system-extraction": "workspace:*",
     "@contentful/experience-design-system-generation": "workspace:*",
     "@contentful/experience-design-system-types": "workspace:*",
-    "@segment/analytics-node": "^3.0.0",
     "commander": "^13.1.0",
     "ink": "^4.4.1",
     "react": "^18.3.1",

package/dist/src/analyze/command.js

@@ -24,7 +24,6 @@ import { DEFAULT_AGENT_NAME, isAgentName, runAgent, } from '@contentful/experien
 import { readExperiencesCredentials } from '../credentials-store.js';
 import { buildAnalyzeViewRows, partitionGlobalWarnings } from './build-analyze-view-rows.js';
 import { getInteractiveTerminalSupport } from '../lib/terminal-capabilities.js';
-import { bindAnalyticsSessionId, emitSessionStarted, enrichCommandResult, exitWithAnalytics, isPipelineAnalyticsChild, } from '../analytics/index.js';
 import { getDebugLogger } from '../lib/debug-logger.js';
 const SCANNED_FILE_EXTENSIONS = new Set(['.astro', '.js', '.jsx', '.svelte', '.ts', '.tsx', '.vue']);
 /**
@@ -265,10 +264,6 @@ export function registerAnalyzeCommand(program) {
             inputPath: projectRoot,
             outDir,
         });
-        await bindAnalyticsSessionId(sessionId);
-        if (!isPipelineAnalyticsChild()) {
-            await emitSessionStarted('analyze_extract');
-        }
         const stepId = createStep(db, sessionId, 'analyze extract', {
             project: projectRoot,
         });
@@ -542,7 +537,6 @@ export function registerAnalyzeCommand(program) {
         storeSlotCycles(db, sessionId, withBreaks);
         storeScannedFiles(db, sessionId, sourceFiles.map((f) => relative(projectRoot, f)));
         updateStep(db, stepId, 'complete', { sessionId });
-        enrichCommandResult({ extracted_component_count: validatedComponents.length });
         db.close();
         const allWarnings = [...extraction.warnings, ...filterWarnings];
         const { rows: componentRows, totalErrors } = buildAnalyzeViewRows(filteredComponents, validatedComponents, allWarnings);
@@ -564,7 +558,7 @@ export function registerAnalyzeCommand(program) {
         if (getInteractiveTerminalSupport().supported) {
             const { waitUntilExit } = render(createElement(AnalyzeView, {
                 result: analyzeResult,
-                onExit: () => void exitWithAnalytics(0),
+                onExit: () => process.exit(0),
             }));
             await waitUntilExit();
         }
@@ -591,7 +585,7 @@ export function registerAnalyzeCommand(program) {
                 summaryLines.push('Warnings: none');
             }
             process.stderr.write(summaryLines.join('\n') + '\n');
-            await exitWithAnalytics(0);
+            process.exit(0);
         }
     });
     registerAnalyzeEditCommand(analyze);

package/dist/src/analyze/select/command.js

@@ -8,7 +8,6 @@ import { loadReviewInput } from './parser.js';
 import { App } from './tui/App.js';
 import { openPipelineDb, loadRawComponents, storeRawComponents, createStep, updateStep } from '../../session/db.js';
 import { validateExtractedComponents, shouldExcludeDueToValidation, formatExclusionWarning, } from '@contentful/experience-design-system-extraction';
-import { bindAnalyticsSessionId, enrichCommandResult, exitWithAnalytics } from '../../analytics/index.js';
 const SAFE_PATH_RE = /^[a-zA-Z0-9_.$[\]=]+$/;
 const PROTO_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
 function applyDotPath(obj, path, value) {
@@ -103,7 +102,6 @@ async function runNonInteractive(snapshot, opts, paths, sessionId) {
         }
         const accepted = snapshot.components.filter((c) => c.status === 'accepted').length;
         const rejected = snapshot.components.filter((c) => c.status === 'rejected').length + (names.length || 0);
-        enrichCommandResult({ accepted_component_count: accepted });
         process.stderr.write(`Accepted: ${accepted}  Rejected: ${rejected}\n`);
         return;
     }
@@ -132,7 +130,7 @@ async function runNonInteractive(snapshot, opts, paths, sessionId) {
             lines.push('');
             lines.push('Re-run with --exclude-invalid to auto-reject these components, or run analyze select interactively to fix them.');
             process.stderr.write(lines.join('\n') + '\n');
-            await exitWithAnalytics(1);
+            process.exit(1);
             return;
         }
     }
@@ -177,14 +175,14 @@ async function runNonInteractive(snapshot, opts, paths, sessionId) {
             const parsed = JSON.parse(raw);
             if (!Array.isArray(parsed)) {
                 process.stderr.write(`Error: --patch file must be a JSON array of patch operations: ${opts.patch}\n`);
-                await exitWithAnalytics(1);
+                process.exit(1);
                 return;
             }
             patchOps = parsed;
         }
         catch {
             process.stderr.write(`Error: cannot read or parse --patch file: ${opts.patch}\n`);
-            await exitWithAnalytics(1);
+            process.exit(1);
             return;
         }
         // Warn on unknown component names
@@ -231,7 +229,6 @@ async function runNonInteractive(snapshot, opts, paths, sessionId) {
             db.close();
         }
     }
-    enrichCommandResult({ accepted_component_count: accepted.length });
     process.stderr.write(`Accepted: ${accepted.length}  Rejected: ${rejected.length}\n`);
 }
 /**
@@ -348,7 +345,7 @@ export async function rejectComponentsByName(sessionId, names, opts = {}) {
     const components = snapshot.components.map((c) => (nameSet.has(c.name) ? { ...c, status: 'rejected' } : c));
     await saveReviewState(paths.statePath, { ...snapshot, components });
 }
-async function resolveSessionId(sessionFlag) {
+function resolveSessionId(sessionFlag) {
     if (sessionFlag)
         return sessionFlag;
     const db = openPipelineDb();
@@ -363,7 +360,7 @@ async 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');
-            return await exitWithAnalytics(1);
+            process.exit(1);
         }
         return row.id;
     }
@@ -387,8 +384,7 @@ export function registerAnalyzeEditCommand(program) {
         .option('--exclude-invalid', 'With --select-all: auto-reject components with validation errors instead of failing loud (opt-in bypass for the gate)')
         .option('--exclude-components <names>', 'Comma-separated component names to force-reject, regardless of other selection flags')
         .action(async ({ session: sessionFlag, projectRoot, acceptAll, selectAll, reject, deselect, select, patch, excludeInvalid, excludeComponents, }) => {
-        const sessionId = await resolveSessionId(sessionFlag);
-        await bindAnalyticsSessionId(sessionId);
+        const sessionId = resolveSessionId(sessionFlag);
         const db = openPipelineDb();
         let rawComponentCount = 0;
         try {
@@ -399,7 +395,7 @@ export function registerAnalyzeEditCommand(program) {
         }
         if (rawComponentCount === 0) {
             process.stderr.write(`Error: session '${sessionId}' has no raw components. Run analyze extract first.\n`);
-            await exitWithAnalytics(1);
+            process.exit(1);
             return;
         }
         const artifactsRoot = getRefineArtifactsRoot();
@@ -424,7 +420,7 @@ export function registerAnalyzeEditCommand(program) {
         }
         catch (error) {
             process.stderr.write(`Error: unable to initialize refine session.\n${error instanceof Error ? error.message : String(error)}\n`);
-            await exitWithAnalytics(1);
+            process.exit(1);
             return;
         }
         // Non-interactive path
@@ -469,7 +465,7 @@ export function registerAnalyzeEditCommand(program) {
         });
         if (process.stdout.columns !== undefined && process.stdout.columns < 60) {
             process.stderr.write(`Error: terminal too narrow (${process.stdout.columns} cols). Resize to 60+ columns.\n`);
-            await exitWithAnalytics(1);
+            process.exit(1);
         }
         const { waitUntilExit } = render(createElement(App, {
             sessionId,

package/dist/src/analyze/select/tui/App.js

@@ -80,7 +80,10 @@ export function App({ sessionId, artifactsRoot, reviewRoot }) {
             if (!manifest.componentsManifest)
                 manifest.componentsManifest = {};
             const client = new ImportApiClient({ cmaToken, spaceId, environmentId });
-            const preview = await client.previewImport(manifest);
+            // This preview is display-only (component-picker annotations); it never
+            // triggers an apply, so always request the full diff to keep the
+            // existing "removed" annotation working.
+            const preview = await client.previewImport(manifest, true);
             const annotations = {};
             for (const item of preview.components.new) {
                 const name = item.name ?? '';

package/dist/src/analyze/select-agent/command.js

@@ -11,7 +11,6 @@ import { buildRepoContextIndex, buildSelectionContext } from './context-builder.
 import { runShowRationale } from './show-rationale.js';
 import { isAbsolute, resolve } from 'node:path';
 import { getDebugLogger } from '../../lib/debug-logger.js';
-import { bindAnalyticsSessionId, enrichCommandResult, exitWithAnalytics } from '../../analytics/index.js';
 import { validateExtractedComponents, shouldExcludeDueToValidation, formatExclusionWarning, } from '@contentful/experience-design-system-extraction';
 const DEFAULT_TIMEOUT_MS = Number(process.env.EDS_AGENT_TIMEOUT_MS ?? 3 * 60 * 1000);
 export const DEFAULT_CONCURRENCY = 10;
@@ -28,7 +27,7 @@ function resolveBatchSize() {
         return DEFAULT_BATCH_SIZE;
     return Math.floor(n);
 }
-async function resolveSessionId(sessionFlag) {
+function resolveSessionId(sessionFlag) {
     if (sessionFlag)
         return sessionFlag;
     const db = openPipelineDb();
@@ -43,7 +42,7 @@ async 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');
-            return await exitWithAnalytics(1);
+            process.exit(1);
         }
         return row.id;
     }
@@ -330,7 +329,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);
                 process.stderr.write(`Error: ${message}\n`);
-                await exitWithAnalytics(1);
+                process.exit(1);
                 return;
             }
         }
@@ -339,7 +338,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
         const model = opts.model ?? savedCreds.agentModel;
         if (!agentName || !isAgentName(agentName)) {
             process.stderr.write(`Error: no agent configured. Pass --agent <name> or run experiences setup. Accepted values: ${AGENT_NAMES.join(', ')}\n`);
-            await exitWithAnalytics(1);
+            process.exit(1);
             return;
         }
         const agent = agentName;
@@ -353,7 +352,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
                 .catch(() => false);
             if (!exists) {
                 process.stderr.write(`Error: custom prompt path not found: ${resolvedPath}\n`);
-                await exitWithAnalytics(1);
+                process.exit(1);
                 return;
             }
             if (!selectPromptPath.toLowerCase().endsWith('.md')) {
@@ -361,8 +360,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
             }
             process.stderr.write(formatCustomPromptBanner('select', resolvedPath));
         }
-        const sessionId = await resolveSessionId(opts.session);
-        await bindAnalyticsSessionId(sessionId);
+        const sessionId = resolveSessionId(opts.session);
         const selectionRoot = resolveProjectRoot(sessionId, opts.projectRoot);
         const db = openPipelineDb();
         let rawComponents;
@@ -376,7 +374,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
         }
         if (rawComponents.length === 0) {
             process.stderr.write(`Error: session '${sessionId}' has no raw components. Run analyze extract first.\n`);
-            await exitWithAnalytics(1);
+            process.exit(1);
             return;
         }
         // Re-run validation (not persisted to DB, so always recompute).
@@ -401,7 +399,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
             lines.push('');
             lines.push('Re-run with --exclude-invalid to auto-reject these components, or fix them in source first.');
             process.stderr.write(lines.join('\n') + '\n');
-            await exitWithAnalytics(1);
+            process.exit(1);
             return;
         }
         const componentsForAgent = validatedComponents.filter((comp) => !shouldExcludeDueToValidation(comp));
@@ -428,7 +426,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
         if (opts.dryRun) {
             if (selectionCandidates.length === 0) {
                 process.stderr.write('No valid components to preview — all components were excluded due to validation errors.\n');
-                await exitWithAnalytics(0);
+                process.exit(0);
                 return;
             }
             const first = selectionCandidates[0];
@@ -440,7 +438,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
                 skillPathOverride: selectPromptPath ? resolve(selectPromptPath) : undefined,
             });
             process.stdout.write(prompt + '\n');
-            await exitWithAnalytics(0);
+            process.exit(0);
             return;
         }
         // --no-cache is the global kill-switch; --no-select-cache is the stage-
@@ -506,7 +504,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
         }
         catch (error) {
             process.stderr.write(`Error: unable to initialize select session.\n${error instanceof Error ? error.message : String(error)}\n`);
-            await exitWithAnalytics(1);
+            process.exit(1);
             return;
         }
         const paths = await getRefineSessionPaths(sessionId, artifactsRoot);
@@ -552,7 +550,6 @@ export function registerAnalyzeSelectAgentCommand(program) {
         finally {
             stepDb.close();
         }
-        enrichCommandResult({ accepted_component_count: accepted.length });
         process.stderr.write(`Accepted: ${accepted.length}  Rejected: ${rejected.length}  Needs review: ${unresolved.length}\n`);
     });
 }

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

@@ -45,17 +45,17 @@ export declare class ImportApiClient {
     private spaceId;
     private environmentId;
     private retry;
-    private lastRequestId?;
-    getLastRequestId(): string | undefined;
-    private noteRequestId;
     constructor(opts: ApiClientOptions);
     private base;
     private headers;
     private requestWithRetry;
     validateToken(): Promise<void>;
     checkPreflight(): Promise<void>;
-    previewImport(manifest: ManifestPayload): Promise<ServerPreviewResponse>;
-    applyImport(manifest: ManifestPayload, acknowledgeBreakingChanges: boolean): Promise<ApplyOperationResponse>;
+    previewImport(manifest: ManifestPayload, allowDeletions?: boolean): Promise<ServerPreviewResponse>;
+    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

@@ -180,15 +180,6 @@ export class ImportApiClient {
     spaceId;
     environmentId;
     retry;
-    lastRequestId;
-    getLastRequestId() {
-        return this.lastRequestId;
-    }
-    noteRequestId(response) {
-        const requestId = response.headers.get('x-contentful-request-id');
-        if (requestId)
-            this.lastRequestId = requestId;
-    }
     constructor(opts) {
         this.host = toApiHost(opts.host);
         this.token = opts.cmaToken;
@@ -246,10 +237,8 @@ export class ImportApiClient {
                 await this.retry.sleep(delayMs);
                 continue;
             }
-            if (!isTransientStatus(result.response.status)) {
-                this.noteRequestId(result.response);
+            if (!isTransientStatus(result.response.status))
                 return result;
-            }
             if (attempt === this.retry.maxAttempts) {
                 const body = stringifyError(result.error);
                 const guidance = `The ${phase} request failed after ${attempt} attempts because the service remained unavailable. ` +
@@ -284,7 +273,6 @@ export class ImportApiClient {
         // false positives that don't apply to the design-systems API authorization path.
         const url = `${this.host}/users/me`;
         const res = await request(url, { token: this.token });
-        this.noteRequestId(res);
         if (res.status === 401) {
             throw new ApiError('CMA token is invalid or revoked', res.status, await res.text());
         }
@@ -310,7 +298,6 @@ export class ImportApiClient {
         catch {
             return; // network error — don't block; the real call will surface it
         }
-        this.noteRequestId(res);
         if (res.ok)
             return;
         if (res.status >= 500)
@@ -320,19 +307,20 @@ export class ImportApiClient {
             return; // legacy backend without the endpoint
         throw new ApiError(`preflight failed: ${res.status}`, res.status, body);
     }
-    async previewImport(manifest) {
+    async previewImport(manifest, allowDeletions = false) {
         const debug = getDebugLogger();
         const startedAt = Date.now();
         debug.event('apply', 'preview.request', {
             url: `${this.base()}/design_systems/imports/preview`,
             componentCount: manifest.components?.length ?? 0,
             tokenCount: manifest.designTokens?.length ?? 0,
+            allowDeletions,
         });
         const result = await this.requestWithRetry('preview', PREVIEW_ERROR_PREFIX, () => designSystemImportSourcelessPreview({
             baseUrl: this.host,
             headers: this.headers(),
             path: { spaceId: this.spaceId, environmentId: this.environmentId },
-            body: manifest,
+            body: { ...manifest, allowDeletions },
             parseAs: 'json',
         }));
         if (!result.response.ok) {
@@ -348,12 +336,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 {
@@ -361,7 +351,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.d.ts

@@ -11,7 +11,7 @@ export declare function formatSlotCycleReport(cycles: ReturnType<typeof findSlot
 export declare function assertNoSlotCycles(components: Array<{
     key: string;
     entry: CDFComponentEntry;
-}>): Promise<void>;
+}>): void;
 export declare function extractComponentsFromManifest(manifest: {
     componentsManifest?: Record<string, unknown>;
 } | null | undefined): Array<{