@contentful/experience-design-system-cli 2.24.1-dev-build-f3943ba.0 → 2.24.1-dev-build-5ff9f2f.0

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

@@ -11,6 +11,7 @@ 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;
@@ -27,7 +28,7 @@ function resolveBatchSize() {
         return DEFAULT_BATCH_SIZE;
     return Math.floor(n);
 }
-function resolveSessionId(sessionFlag) {
+async function resolveSessionId(sessionFlag) {
     if (sessionFlag)
         return sessionFlag;
     const db = openPipelineDb();
@@ -42,7 +43,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');
-            process.exit(1);
+            return await exitWithAnalytics(1);
         }
         return row.id;
     }
@@ -329,7 +330,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);
                 process.stderr.write(`Error: ${message}\n`);
-                process.exit(1);
+                await exitWithAnalytics(1);
                 return;
             }
         }
@@ -338,7 +339,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`);
-            process.exit(1);
+            await exitWithAnalytics(1);
             return;
         }
         const agent = agentName;
@@ -352,7 +353,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
                 .catch(() => false);
             if (!exists) {
                 process.stderr.write(`Error: custom prompt path not found: ${resolvedPath}\n`);
-                process.exit(1);
+                await exitWithAnalytics(1);
                 return;
             }
             if (!selectPromptPath.toLowerCase().endsWith('.md')) {
@@ -360,7 +361,8 @@ export function registerAnalyzeSelectAgentCommand(program) {
             }
             process.stderr.write(formatCustomPromptBanner('select', resolvedPath));
         }
-        const sessionId = resolveSessionId(opts.session);
+        const sessionId = await resolveSessionId(opts.session);
+        await bindAnalyticsSessionId(sessionId);
         const selectionRoot = resolveProjectRoot(sessionId, opts.projectRoot);
         const db = openPipelineDb();
         let rawComponents;
@@ -374,7 +376,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
         }
         if (rawComponents.length === 0) {
             process.stderr.write(`Error: session '${sessionId}' has no raw components. Run analyze extract first.\n`);
-            process.exit(1);
+            await exitWithAnalytics(1);
             return;
         }
         // Re-run validation (not persisted to DB, so always recompute).
@@ -399,7 +401,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');
-            process.exit(1);
+            await exitWithAnalytics(1);
             return;
         }
         const componentsForAgent = validatedComponents.filter((comp) => !shouldExcludeDueToValidation(comp));
@@ -426,7 +428,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');
-                process.exit(0);
+                await exitWithAnalytics(0);
                 return;
             }
             const first = selectionCandidates[0];
@@ -438,7 +440,7 @@ export function registerAnalyzeSelectAgentCommand(program) {
                 skillPathOverride: selectPromptPath ? resolve(selectPromptPath) : undefined,
             });
             process.stdout.write(prompt + '\n');
-            process.exit(0);
+            await exitWithAnalytics(0);
             return;
         }
         // --no-cache is the global kill-switch; --no-select-cache is the stage-
@@ -504,7 +506,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`);
-            process.exit(1);
+            await exitWithAnalytics(1);
             return;
         }
         const paths = await getRefineSessionPaths(sessionId, artifactsRoot);
@@ -550,6 +552,7 @@ 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,6 +45,9 @@ export declare class ImportApiClient {
     private spaceId;
     private environmentId;
     private retry;
+    private lastRequestId?;
+    getLastRequestId(): string | undefined;
+    private noteRequestId;
     constructor(opts: ApiClientOptions);
     private base;
     private headers;

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

@@ -180,6 +180,15 @@ 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;
@@ -237,8 +246,10 @@ export class ImportApiClient {
                 await this.retry.sleep(delayMs);
                 continue;
             }
-            if (!isTransientStatus(result.response.status))
+            if (!isTransientStatus(result.response.status)) {
+                this.noteRequestId(result.response);
                 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. ` +
@@ -273,6 +284,7 @@ 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());
         }
@@ -298,6 +310,7 @@ 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)

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;
-}>): void;
+}>): Promise<void>;
 export declare function extractComponentsFromManifest(manifest: {
     componentsManifest?: Record<string, unknown>;
 } | null | undefined): Array<{

package/dist/src/apply/command.js

@@ -16,9 +16,10 @@ import { addAllowDeletionsOption, addArtifactInputOptions, addCompositionOptions
 import { stripAllowedComponents } from '../import/strip-allowed-components.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
 import { getInteractiveTerminalSupport, requireInteractiveTerminal } from '../lib/terminal-capabilities.js';
-function die(message) {
+import { bindAnalyticsSessionId, exitWithAnalytics, failureFromApiError, recordApplyOutcome, recordContentfulContext, } from '../analytics/index.js';
+async function die(message, fields = {}) {
     process.stderr.write(`${message}\n`);
-    process.exit(1);
+    return exitWithAnalytics(1, fields);
 }
 async function pathExists(p) {
     return access(p)
@@ -27,7 +28,7 @@ async function pathExists(p) {
 }
 async function assertFileExists(flag, p) {
     if (!(await pathExists(p)))
-        die(`Error: file not found: ${p} (from ${flag})`);
+        return await die(`Error: file not found: ${p} (from ${flag})`);
 }
 async function readJsonFile(flag, p) {
     let text;
@@ -35,13 +36,13 @@ async function readJsonFile(flag, p) {
         text = await readFile(p, 'utf8');
     }
     catch {
-        die(`Error: file not found: ${p} (from ${flag})`);
+        return await die(`Error: file not found: ${p} (from ${flag})`);
     }
     try {
         return JSON.parse(text);
     }
     catch {
-        die(`Error: ${flag} is not valid JSON: ${p}`);
+        return await die(`Error: ${flag} is not valid JSON: ${p}`);
     }
 }
 const IGNORE_TOKEN_DIRS = new Set(['node_modules', 'dist', 'build', '.next', '.nuxt', '.git']);
@@ -83,12 +84,12 @@ export async function readTokensFromPath(flag, p) {
         s = await stat(p);
     }
     catch {
-        die(`Error: file not found: ${p} (from ${flag})`);
+        return await die(`Error: file not found: ${p} (from ${flag})`);
     }
     if (s.isDirectory()) {
         const files = await collectJsonFiles(p);
         if (files.length === 0)
-            die(`Error: no .json files found in directory: ${p} (from ${flag})`);
+            return await die(`Error: no .json files found in directory: ${p} (from ${flag})`);
         const merged = {};
         for (const file of files.sort()) {
             let text;
@@ -111,36 +112,36 @@ export async function readTokensFromPath(flag, p) {
         }
         const { valid, errors } = validateDTCG(merged);
         if (!valid)
-            die(`Error: ${flag} contains invalid token types:\n${errors.map((e) => `  ${e.path}: ${e.message}`).join('\n')}`);
+            return await die(`Error: ${flag} contains invalid token types:\n${errors.map((e) => `  ${e.path}: ${e.message}`).join('\n')}`);
         return flattenDTCG(merged, '');
     }
     const raw = await readJsonFile(flag, p);
     if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
-        die(`Error: ${flag} is not valid JSON: expected an object`);
+        return await die(`Error: ${flag} is not valid JSON: expected an object`);
     }
     const { valid, errors } = validateDTCG(raw);
     if (!valid)
-        die(`Error: ${flag} contains invalid token types:\n${errors.map((e) => `  ${e.path}: ${e.message}`).join('\n')}`);
+        return await die(`Error: ${flag} contains invalid token types:\n${errors.map((e) => `  ${e.path}: ${e.message}`).join('\n')}`);
     return flattenDTCG(raw, '');
 }
 async function resolveSharedInputs(opts) {
     if (!opts.components && !opts.tokens && !opts.session) {
-        die('Error: at least one of --components, --tokens, or --session is required');
+        return await die('Error: at least one of --components, --tokens, or --session is required');
     }
     if (opts.session && opts.components) {
-        die('Error: --session and --components are mutually exclusive');
+        return await die('Error: --session and --components are mutually exclusive');
     }
     const spaceId = opts.spaceId ?? process.env.CONTENTFUL_SPACE_ID;
     const environmentId = opts.environmentId ?? process.env.CONTENTFUL_ENVIRONMENT_ID;
     if (!spaceId)
-        die('Error: --space-id is required (or set CONTENTFUL_SPACE_ID)');
+        return await die('Error: --space-id is required (or set CONTENTFUL_SPACE_ID)');
     if (!environmentId)
-        die('Error: --environment-id is required (or set CONTENTFUL_ENVIRONMENT_ID)');
+        return await die('Error: --environment-id is required (or set CONTENTFUL_ENVIRONMENT_ID)');
     opts.spaceId = spaceId;
     opts.environmentId = environmentId;
     const cmaToken = opts.cmaToken ?? process.env.CONTENTFUL_MANAGEMENT_TOKEN;
     if (!cmaToken) {
-        die('Error: CMA token is required. Pass --cma-token or set CONTENTFUL_MANAGEMENT_TOKEN');
+        return await die('Error: CMA token is required. Pass --cma-token or set CONTENTFUL_MANAGEMENT_TOKEN');
     }
     if (opts.components)
         await assertFileExists('--components', opts.components);
@@ -154,14 +155,14 @@ async function resolveSharedInputs(opts) {
             db.close();
         }
         if (components.length === 0) {
-            die(`Error: session '${opts.session}' has no generated components. Run generate components first.`);
+            return await die(`Error: session '${opts.session}' has no generated components. Run generate components first.`);
         }
     }
     else if (opts.components) {
         const raw = await readJsonFile('--components', opts.components);
         const result = validateCDF(raw);
         if (!result.valid) {
-            die(`Error: --components failed schema validation: ${result.errors.map((e) => e.message).join(', ')}`);
+            return await die(`Error: --components failed schema validation: ${result.errors.map((e) => e.message).join(', ')}`);
         }
         components = result.components;
     }
@@ -213,12 +214,12 @@ export function formatSlotCycleReport(cycles) {
     }
     return lines;
 }
-export function assertNoSlotCycles(components) {
+export async function assertNoSlotCycles(components) {
     const cycles = detectSlotCycles(components);
     if (cycles.length === 0)
         return;
     process.stderr.write(formatSlotCycleReport(cycles).join('\n') + '\n');
-    process.exit(1);
+    await exitWithAnalytics(1);
 }
 export function extractComponentsFromManifest(manifest) {
     const componentsManifest = manifest?.componentsManifest;
@@ -287,6 +288,7 @@ function buildApplyOutput(operation, spaceId, environmentId, host) {
         componentTypes: countByAction(componentItems),
         designTokens: countByAction(tokenItems),
         viewUrl: buildPostPushUrl({ host: host ?? 'api.contentful.com', spaceId, environmentId }),
+        tokensUrl: buildPostPushUrl({ host: host ?? 'api.contentful.com', spaceId, environmentId, view: 'design_tokens' }),
         failures: items
             .filter((item) => item.status === 'failed')
             .map((item) => ({
@@ -427,18 +429,24 @@ export function registerApplyCommand(program) {
         }
         catch (e) {
             if (e instanceof ApiError)
-                die(`Error: ${formatApiError(e)}`);
+                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
             throw e;
         }
         const { components, tokens, client } = inputs;
+        const spaceId = opts.spaceId;
+        const environmentId = opts.environmentId;
+        await bindAnalyticsSessionId(opts.session, {
+            space_key: spaceId,
+            environment_key: environmentId,
+        });
         try {
             await client.validateToken();
         }
         catch (e) {
             if (e instanceof ApiError)
-                die(`Error: ${formatApiError(e)}`);
+                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
             const cause = e instanceof Error && e.cause instanceof Error ? e.cause.message : '';
-            die(`Error: unable to connect to API host${cause ? `: ${cause}` : ''}`);
+            return await die(`Error: unable to connect to API host${cause ? `: ${cause}` : ''}`);
         }
         const manifest = buildManifest(components, tokens);
         let preview;
@@ -447,11 +455,10 @@ export function registerApplyCommand(program) {
         }
         catch (e) {
             if (e instanceof ApiError)
-                die(`Error: ${formatApiError(e)}`);
+                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
             throw e;
         }
-        const spaceId = opts.spaceId;
-        const environmentId = opts.environmentId;
+        recordContentfulContext(client, spaceId, environmentId);
         if (getInteractiveTerminalSupport().supported) {
             const { waitUntilExit } = render(createElement(ServerPreviewApp, {
                 preview,
@@ -463,7 +470,7 @@ export function registerApplyCommand(program) {
         }
         else {
             process.stdout.write(JSON.stringify(buildPreviewOutput(preview, spaceId, environmentId), null, 2) + '\n');
-            process.exit(0);
+            await exitWithAnalytics(0);
         }
     });
     const pushCmd = applyCmd.command('push').description('Write component types and design tokens to Contentful ExO');
@@ -480,7 +487,7 @@ export function registerApplyCommand(program) {
         const isTTY = getInteractiveTerminalSupport().supported;
         if (!isTTY && !opts.yes) {
             process.stderr.write('Error: apply push requires --yes in non-interactive mode\n');
-            process.exit(1);
+            await exitWithAnalytics(1);
         }
         let inputs;
         try {
@@ -488,17 +495,23 @@ export function registerApplyCommand(program) {
         }
         catch (e) {
             if (e instanceof ApiError)
-                die(`Error: ${formatApiError(e, opts.verbose)}`);
+                return await die(`Error: ${formatApiError(e, opts.verbose)}`, failureFromApiError(e));
             throw e;
         }
         const { components, tokens, client } = inputs;
-        assertNoSlotCycles(components);
+        const spaceId = opts.spaceId;
+        const environmentId = opts.environmentId;
+        await bindAnalyticsSessionId(opts.session, {
+            space_key: spaceId,
+            environment_key: environmentId,
+        });
+        await assertNoSlotCycles(components);
         try {
             await client.validateToken();
         }
         catch (e) {
             if (e instanceof ApiError)
-                die(`Error: ${formatApiError(e, opts.verbose)}`);
+                return await die(`Error: ${formatApiError(e, opts.verbose)}`, failureFromApiError(e));
             throw e;
         }
         const manifest = buildManifest(components, tokens);
@@ -508,11 +521,10 @@ export function registerApplyCommand(program) {
         }
         catch (e) {
             if (e instanceof ApiError)
-                die(`Error: ${formatApiError(e, opts.verbose)}`);
+                return await die(`Error: ${formatApiError(e, opts.verbose)}`, failureFromApiError(e));
             throw e;
         }
-        const spaceId = opts.spaceId;
-        const environmentId = opts.environmentId;
+        recordContentfulContext(client, spaceId, environmentId);
         if (opts.dryRun) {
             if (isTTY) {
                 const { waitUntilExit } = render(createElement(ServerPreviewApp, {
@@ -526,7 +538,7 @@ export function registerApplyCommand(program) {
             else {
                 process.stdout.write(JSON.stringify(buildPreviewOutput(preview, spaceId, environmentId), null, 2) + '\n');
             }
-            process.exit(0);
+            await exitWithAnalytics(0);
         }
         if (isEmptyPreview(preview)) {
             if (isTTY && !opts.yes) {
@@ -535,14 +547,14 @@ export function registerApplyCommand(program) {
             else {
                 process.stdout.write(JSON.stringify(buildPreviewOutput(preview, spaceId, environmentId), null, 2) + '\n');
             }
-            process.exit(0);
+            await exitWithAnalytics(0);
         }
         const breakingWithImpact = hasBreakingChangesWithImpact(preview);
         if (!isTTY || opts.yes) {
             if (breakingWithImpact && !opts.force) {
                 process.stderr.write('Error: breaking changes with downstream impact detected. Use --force to acknowledge.\n');
                 process.stdout.write(JSON.stringify(buildPreviewOutput(preview, spaceId, environmentId), null, 2) + '\n');
-                process.exit(1);
+                await exitWithAnalytics(1);
             }
             const verbose = opts.verbose ?? false;
             if (verbose) {
@@ -557,7 +569,7 @@ export function registerApplyCommand(program) {
             }
             catch (e) {
                 if (e instanceof ApiError)
-                    die(`Error: ${formatApiError(e, opts.verbose)}`);
+                    return await die(`Error: ${formatApiError(e, opts.verbose)}`, failureFromApiError(e));
                 throw e;
             }
             process.stderr.write(`Apply operation started: ${operation.sys.id}\n`);
@@ -566,12 +578,14 @@ export function registerApplyCommand(program) {
             }
             catch (e) {
                 if (e instanceof ApiError)
-                    die(`Error: ${formatApiError(e, opts.verbose)}`);
+                    return await die(`Error: ${formatApiError(e, opts.verbose)}`, failureFromApiError(e));
                 throw e;
             }
             const summary = buildApplyOutput(operation, spaceId, environmentId, opts.host);
+            recordApplyOutcome(client, spaceId, environmentId, operation);
             process.stdout.write(JSON.stringify(summary, null, 2) + '\n');
-            process.exit(operation.sys.status === 'succeeded' ? 0 : 1);
+            const exitCode = operation.sys.status === 'succeeded' ? 0 : 1;
+            await exitWithAnalytics(exitCode);
             return;
         }
         await new Promise((resolvePromise) => {
@@ -621,6 +635,7 @@ export function registerApplyCommand(program) {
                     }
                     throw e;
                 }
+                recordApplyOutcome(client, spaceId, environmentId, operation);
                 instance.rerender(createElement(ServerApplyDone, {
                     operation,
                     spaceId,
@@ -639,7 +654,7 @@ export function registerApplyCommand(program) {
                     void runApply(acknowledge, applyDeletions);
                 },
                 onCancel: () => {
-                    process.exit(0);
+                    void exitWithAnalytics(0);
                 },
             }));
             void instance.waitUntilExit().then(() => resolvePromise());
@@ -664,17 +679,17 @@ export function registerApplyCommand(program) {
         }
         catch (e) {
             if (e instanceof ApiError)
-                die(`Error: ${formatApiError(e)}`);
+                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
             throw e;
         }
         const { components, tokens, client } = inputs;
-        assertNoSlotCycles(components);
+        await assertNoSlotCycles(components);
         try {
             await client.validateToken();
         }
         catch (e) {
             if (e instanceof ApiError)
-                die(`Error: ${formatApiError(e)}`);
+                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
             throw e;
         }
         const fullManifest = buildManifest(components, tokens);
@@ -684,21 +699,26 @@ export function registerApplyCommand(program) {
         }
         catch (e) {
             if (e instanceof ApiError)
-                die(`Error: ${formatApiError(e)}`);
+                return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
             throw e;
         }
         const spaceId = opts.spaceId;
         const environmentId = opts.environmentId;
+        await bindAnalyticsSessionId(opts.session, {
+            space_key: spaceId,
+            environment_key: environmentId,
+        });
+        recordContentfulContext(client, spaceId, environmentId);
         const entities = getSelectableEntities(preview);
         if (entities.length === 0) {
             process.stderr.write('Nothing to change — design system is up to date.\n');
-            process.exit(0);
+            await exitWithAnalytics(0);
         }
         if (nonInteractive) {
             const selectedKeys = resolveNonInteractiveSelection(entities, opts);
             if (selectedKeys.size === 0) {
                 process.stderr.write('No entities matched selection criteria.\n');
-                process.exit(0);
+                await exitWithAnalytics(0);
             }
             const selectedComponentKeys = new Set();
             const selectedTokenPaths = new Set();
@@ -714,7 +734,7 @@ export function registerApplyCommand(program) {
             const hasBreaking = entities.some((e) => e.isBreaking && selectedKeys.has(makeSelectKey(e.kind, e.id)));
             if (hasBreaking && !opts.force) {
                 process.stderr.write('Error: selection includes breaking changes. Use --force to acknowledge.\n');
-                process.exit(1);
+                await exitWithAnalytics(1);
             }
             let operation;
             try {
@@ -725,7 +745,7 @@ export function registerApplyCommand(program) {
             }
             catch (e) {
                 if (e instanceof ApiError)
-                    die(`Error: ${formatApiError(e)}`);
+                    return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
                 throw e;
             }
             process.stderr.write(`Apply operation started: ${operation.sys.id}\n`);
@@ -734,12 +754,13 @@ export function registerApplyCommand(program) {
             }
             catch (e) {
                 if (e instanceof ApiError)
-                    die(`Error: ${formatApiError(e)}`);
+                    return await die(`Error: ${formatApiError(e)}`, failureFromApiError(e));
                 throw e;
             }
             const summary = buildApplyOutput(operation, spaceId, environmentId, opts.host);
+            recordApplyOutcome(client, spaceId, environmentId, operation);
             process.stdout.write(JSON.stringify(summary, null, 2) + '\n');
-            process.exit(operation.sys.status === 'succeeded' ? 0 : 1);
+            await exitWithAnalytics(operation.sys.status === 'succeeded' ? 0 : 1);
             return;
         }
         await new Promise((resolvePromise) => {
@@ -801,6 +822,7 @@ export function registerApplyCommand(program) {
                     }
                     throw e;
                 }
+                recordApplyOutcome(client, spaceId, environmentId, operation);
                 instance.rerender(createElement(ServerApplyDone, {
                     operation,
                     spaceId,

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

@@ -42,7 +42,7 @@ export function ServerApplyDone({ operation, spaceId, environmentId, host }) {
         }
     });
     const failures = (operation.items ?? []).filter((item) => item.status === 'failed');
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsxs(Text, { bold: true, children: ["Import complete \u2014 ", environmentId, " @ ", spaceId] }), _jsx(Text, { children: " " }), _jsxs(Text, { color: "green", children: [" \u2713 ", operation.summary.succeeded, " succeeded"] }), operation.summary.failed > 0 && _jsxs(Text, { color: "red", children: [" \u2717 ", operation.summary.failed, " failed"] }), operation.summary.failed === 0 && _jsx(Text, { dimColor: true, children: " All entities imported successfully." }), failures.length > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: " Failures:" }), failures.map((item, i) => (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "red", children: [' ', "\u2717 ", item.entityType, ": ", item.id] }), item.error && _jsxs(Text, { dimColor: true, children: [" ", formatItemError(item.error)] })] }, i)))] })), operation.sys.status === 'succeeded' && operation.summary.succeeded > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: " View your design system:" }), _jsxs(Text, { color: "cyan", children: [" ", buildPostPushUrl({ host: host ?? 'api.contentful.com', spaceId, environmentId })] })] })), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: " Press Q to exit." })] }));
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsxs(Text, { bold: true, children: ["Import complete \u2014 ", environmentId, " @ ", spaceId] }), _jsx(Text, { children: " " }), _jsxs(Text, { color: "green", children: [" \u2713 ", operation.summary.succeeded, " succeeded"] }), operation.summary.failed > 0 && _jsxs(Text, { color: "red", children: [" \u2717 ", operation.summary.failed, " failed"] }), operation.summary.failed === 0 && _jsx(Text, { dimColor: true, children: " All entities imported successfully." }), failures.length > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: " Failures:" }), failures.map((item, i) => (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "red", children: [' ', "\u2717 ", item.entityType, ": ", item.id] }), item.error && _jsxs(Text, { dimColor: true, children: [" ", formatItemError(item.error)] })] }, i)))] })), operation.sys.status === 'succeeded' && operation.summary.succeeded > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: " View your design system:" }), _jsxs(Text, { color: "cyan", children: [" ", buildPostPushUrl({ host: host ?? 'api.contentful.com', spaceId, environmentId })] }), _jsx(Text, { dimColor: true, children: " View your design tokens:" }), _jsxs(Text, { color: "cyan", children: [' ', buildPostPushUrl({ host: host ?? 'api.contentful.com', spaceId, environmentId, view: 'design_tokens' })] })] })), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: " Press Q to exit." })] }));
 }
 function formatItemError(error) {
     return formatEdsiError(error);

package/dist/src/credentials-store.d.ts

@@ -13,6 +13,8 @@ export type ExperiencesCredentials = {
     autoFilter?: boolean;
     /** Feature: default debug-mode (writes JSONL trace of every decision) for all commands. */
     debug?: boolean;
+    /** Persisted opt-out for anonymous CLI usage analytics, set via `experiences setup`. */
+    analyticsDisabled?: boolean;
     /**
      * Feature (atomic mode): default composition mode. `atomic` (default) imports
      * flat components with no embedded-component hierarchy; `composite` opts into

package/dist/src/credentials-store.js

@@ -36,6 +36,7 @@ export async function readExperiencesCredentials() {
             ...(parsed.generatePromptPath ? { generatePromptPath: parsed.generatePromptPath } : {}),
             ...(typeof parsed.autoFilter === 'boolean' ? { autoFilter: parsed.autoFilter } : {}),
             ...(typeof parsed.debug === 'boolean' ? { debug: parsed.debug } : {}),
+            ...(typeof parsed.analyticsDisabled === 'boolean' ? { analyticsDisabled: parsed.analyticsDisabled } : {}),
             ...(typeof parsed.compositionMode === 'string' && isCompositionMode(parsed.compositionMode)
                 ? { compositionMode: parsed.compositionMode }
                 : {}),
@@ -52,7 +53,7 @@ export async function readExperiencesCredentials() {
     }
 }
 export async function writeExperiencesCredentials(creds) {
-    const { host: _host, agent, agentModel, selectPromptPath, generatePromptPath, autoFilter, debug, compositionMode, ...rest } = creds;
+    const { host: _host, agent, agentModel, selectPromptPath, generatePromptPath, autoFilter, debug, analyticsDisabled, compositionMode, ...rest } = creds;
     const host = toConfiguredHost(creds.host);
     await mkdir(CREDENTIALS_DIR, { recursive: true });
     await writeFile(CREDENTIALS_PATH, JSON.stringify({
@@ -64,6 +65,7 @@ export async function writeExperiencesCredentials(creds) {
         ...(generatePromptPath ? { generatePromptPath } : {}),
         ...(typeof autoFilter === 'boolean' ? { autoFilter } : {}),
         ...(typeof debug === 'boolean' ? { debug } : {}),
+        ...(typeof analyticsDisabled === 'boolean' ? { analyticsDisabled } : {}),
         ...(compositionMode && isCompositionMode(compositionMode) ? { compositionMode } : {}),
     }, null, 2) + '\n', { mode: 0o600 });
 }