@contentful/experience-design-system-cli 2.16.2-dev-build-ec5957c.0 → 2.16.2-dev-build-a6d3bd1.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.16.2-dev-build-ec5957c.0",
+  "version": "2.16.2-dev-build-a6d3bd1.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/analyze/command.js

@@ -19,6 +19,7 @@ import { buildCompositionInputHash } from './composition/composition-cache-key.j
 import { runParserInSandbox } from './composition/agent-parser/sandbox.js';
 import { resolveViaAgentParser } from './composition/agent-parser/resolve-via-parser.js';
 import { parsePromptOverrides, resolvePromptOverride } from '../lib/prompt-overrides.js';
+import { DEFAULT_AGENT_NAME, isAgentName } from '../lib/agent-names.js';
 import { runAgent } from '../generate/agent-runner.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
 import { buildAnalyzeViewRows, partitionGlobalWarnings } from './build-analyze-view-rows.js';
@@ -132,13 +133,12 @@ export function componentsToInterchangeMap(components) {
 }
 /** Resolve which coding-agent runs mapping resolution: `--agent` flag > env > default. */
 function resolveCompositionAgentName(flagValue) {
-    const valid = ['claude', 'codex', 'opencode', 'cursor'];
-    if (flagValue && valid.includes(flagValue))
+    if (flagValue && isAgentName(flagValue))
         return flagValue;
     const env = process.env['EDS_COMPOSITION_AGENT'];
-    if (env && valid.includes(env))
+    if (env && isAgentName(env))
         return env;
-    return 'claude';
+    return DEFAULT_AGENT_NAME;
 }
 /**
  * Read the source files of the extracted components plus nearby mapping/meta

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

@@ -5,7 +5,7 @@ import { appendReviewEvent, getRefineArtifactsRoot, ensureRefineSession, getRefi
 import { loadReviewInput } from '../select/parser.js';
 import { buildPrompt } from '../../generate/prompt-builder.js';
 import { formatCustomPromptBanner } from '../../generate/command.js';
-import { parseSelectToolCallLines, runAgent } from '../../generate/agent-runner.js';
+import { AGENT_NAMES, isAgentName, parseSelectToolCallLines, runAgent } from '../../generate/agent-runner.js';
 import { access } from 'node:fs/promises';
 import { readExperiencesCredentials } from '../../credentials-store.js';
 import { OutputFormatter, c } from '../../output/format.js';
@@ -13,7 +13,6 @@ import { buildRepoContextIndex, buildSelectionContext } from './context-builder.
 import { runShowRationale } from './show-rationale.js';
 import { isAbsolute, resolve } from 'node:path';
 import { validateExtractedComponents, shouldExcludeDueToValidation, formatExclusionWarning, } from '@contentful/experience-design-system-extraction';
-const VALID_AGENTS = new Set(['claude', 'codex', 'opencode', 'cursor']);
 const DEFAULT_TIMEOUT_MS = Number(process.env.EDS_AGENT_TIMEOUT_MS ?? 3 * 60 * 1000);
 export const DEFAULT_CONCURRENCY = 10;
 export const DEFAULT_BATCH_SIZE = 5;
@@ -336,8 +335,8 @@ export function registerAnalyzeSelectAgentCommand(program) {
         const savedCreds = await readExperiencesCredentials();
         const agentName = opts.agent ?? savedCreds.agent;
         const model = opts.model ?? savedCreds.agentModel;
-        if (!agentName || !VALID_AGENTS.has(agentName)) {
-            process.stderr.write(`Error: no agent configured. Pass --agent <name> or run experiences setup. Accepted values: claude, codex, opencode, cursor\n`);
+        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);
             return;
         }

package/dist/src/apply/command.js

@@ -12,6 +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 { stripAllowedComponents } from '../import/strip-allowed-components.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
 import { getInteractiveTerminalSupport, requireInteractiveTerminal } from '../lib/terminal-capabilities.js';
@@ -411,26 +412,15 @@ function SelectApp({ entities, spaceId, environmentId, onApply }) {
         importing,
     });
 }
-function collect(val, prev) {
-    return [...prev, val];
-}
 export function registerApplyCommand(program) {
     const applyCmd = program
         .command('apply')
         .description('Preview, select, or push design system entities to Contentful ExO');
-    applyCmd
-        .command('preview')
-        .description('Show a read-only diff of what apply push would do')
-        .option('--components <path>', 'Path to components.json (CDF)')
-        .option('--tokens <path>', 'Path to tokens.json (DTCG)')
-        .option('--session <id>', 'Pipeline session ID to load generated components from')
-        .requiredOption('--space-id <id>', 'Contentful space ID')
-        .requiredOption('--environment-id <id>', 'Contentful environment ID')
-        .option('--cma-token <token>', 'CMA personal access token (or set CONTENTFUL_MANAGEMENT_TOKEN)')
-        .option('--host <url>', 'Override API base URL')
-        .option('--composite', 'Import embedded-component hierarchy (opt in; default is atomic)')
-        .option('--atomic', 'Import flat components with no embedded-component hierarchy (default)')
-        .action(async (opts) => {
+    const previewCmd = applyCmd.command('preview').description('Show a read-only diff of what apply push would do');
+    addArtifactInputOptions(previewCmd);
+    addContentfulTargetOptions(previewCmd);
+    addCompositionOptions(previewCmd);
+    previewCmd.action(async (opts) => {
         let inputs;
         try {
             inputs = await resolveSharedInputs(opts);
@@ -475,18 +465,11 @@ export function registerApplyCommand(program) {
             process.exit(0);
         }
     });
-    applyCmd
-        .command('push')
-        .description('Write component types and design tokens to Contentful ExO')
-        .option('--components <path>', 'Path to components.json (CDF)')
-        .option('--tokens <path>', 'Path to tokens.json (DTCG)')
-        .option('--session <id>', 'Pipeline session ID to load generated components from')
-        .requiredOption('--space-id <id>', 'Contentful space ID')
-        .requiredOption('--environment-id <id>', 'Contentful environment ID')
-        .option('--cma-token <token>', 'CMA personal access token (or set CONTENTFUL_MANAGEMENT_TOKEN)')
-        .option('--host <url>', 'Override API base URL')
-        .option('--composite', 'Import embedded-component hierarchy (opt in; default is atomic)')
-        .option('--atomic', 'Import flat components with no embedded-component hierarchy (default)')
+    const pushCmd = applyCmd.command('push').description('Write component types and design tokens to Contentful ExO');
+    addArtifactInputOptions(pushCmd);
+    addContentfulTargetOptions(pushCmd);
+    addCompositionOptions(pushCmd);
+    pushCmd
         .option('--yes', 'Skip interactive confirmation')
         .option('--verbose', 'Show all entity progress including skipped/unchanged')
         .option('--force', 'Skip confirmation for breaking changes (for CI)')
@@ -652,23 +635,12 @@ export function registerApplyCommand(program) {
             void instance.waitUntilExit().then(() => resolvePromise());
         });
     });
-    applyCmd
-        .command('select')
-        .description('Select a subset of entities and push to Contentful ExO')
-        .option('--components <path>', 'Path to components.json (CDF)')
-        .option('--tokens <path>', 'Path to tokens.json (DTCG)')
-        .option('--session <id>', 'Pipeline session ID to load generated components from')
-        .requiredOption('--space-id <id>', 'Contentful space ID')
-        .requiredOption('--environment-id <id>', 'Contentful environment ID')
-        .option('--cma-token <token>', 'CMA personal access token (or set CONTENTFUL_MANAGEMENT_TOKEN)')
-        .option('--host <url>', 'Override API base URL')
-        .option('--composite', 'Import embedded-component hierarchy (opt in; default is atomic)')
-        .option('--atomic', 'Import flat components with no embedded-component hierarchy (default)')
-        .option('--select-all', 'Select all entities without launching TUI')
-        .option('--select <pattern>', 'Select entities by ID pattern (repeatable)', collect, [])
-        .option('--deselect <pattern>', 'Deselect entities by ID pattern (repeatable)', collect, [])
-        .option('--force', 'Skip confirmation for breaking changes')
-        .action(async (opts) => {
+    const selectCmd = applyCmd.command('select').description('Select a subset of entities and push to Contentful ExO');
+    addArtifactInputOptions(selectCmd);
+    addContentfulTargetOptions(selectCmd);
+    addCompositionOptions(selectCmd);
+    addSelectionOptions(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) {
             requireInteractiveTerminal({

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

@@ -1,3 +1,4 @@
+import { type CompositionMode } from './lib/composition-mode.js';
 export type ExperiencesCredentials = {
     spaceId: string;
     environmentId: string;
@@ -17,7 +18,7 @@ export type ExperiencesCredentials = {
      * flat components with no embedded-component hierarchy; `composite` opts into
      * the slot-graph machinery. Resolved `flag > env > this > default`.
      */
-    compositionMode?: 'composite' | 'atomic';
+    compositionMode?: CompositionMode;
 };
 /**
  * Read persisted Contentful credentials.

package/dist/src/credentials-store.js

@@ -2,6 +2,7 @@ import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { toConfiguredHost } from './host-utils.js';
+import { isCompositionMode } from './lib/composition-mode.js';
 const CREDENTIALS_DIR = join(homedir(), '.config', 'experiences');
 const CREDENTIALS_PATH = join(CREDENTIALS_DIR, 'credentials.json');
 /**
@@ -35,7 +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 } : {}),
-            ...(parsed.compositionMode === 'composite' || parsed.compositionMode === 'atomic'
+            ...(typeof parsed.compositionMode === 'string' && isCompositionMode(parsed.compositionMode)
                 ? { compositionMode: parsed.compositionMode }
                 : {}),
         };
@@ -63,7 +64,7 @@ export async function writeExperiencesCredentials(creds) {
         ...(generatePromptPath ? { generatePromptPath } : {}),
         ...(typeof autoFilter === 'boolean' ? { autoFilter } : {}),
         ...(typeof debug === 'boolean' ? { debug } : {}),
-        ...(compositionMode === 'composite' || compositionMode === 'atomic' ? { compositionMode } : {}),
+        ...(compositionMode && isCompositionMode(compositionMode) ? { compositionMode } : {}),
     }, null, 2) + '\n', { mode: 0o600 });
 }
 export function experiencesCredentialsPath() {

package/dist/src/generate/agent-runner.d.ts

@@ -1,4 +1,5 @@
-export type AgentName = 'claude' | 'codex' | 'opencode' | 'cursor';
+import type { AgentName } from '../lib/agent-names.js';
+export { AGENT_NAMES, isAgentName, type AgentName } from '../lib/agent-names.js';
 export interface AgentRunResult {
     exitCode: number;
     stdout: string;

package/dist/src/generate/agent-runner.js

@@ -1,5 +1,6 @@
 import { spawn } from 'node:child_process';
 import { getDebugLogger } from '../lib/debug-logger.js';
+export { AGENT_NAMES, isAgentName } from '../lib/agent-names.js';
 const VALID_SELECT_TOOL_NAMES = new Set(['select_component', 'reject_component']);
 export function parseSelectToolCallLines(stdout) {
     const calls = [];

package/dist/src/generate/command.js

@@ -4,7 +4,7 @@ import { access, readFile, readdir, stat } from 'node:fs/promises';
 import { join, resolve } from 'node:path';
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
-import { describeAgentFailure, parseToolCallLines, parseTokenToolCallLines, resolveBinary, runAgent, } from './agent-runner.js';
+import { AGENT_NAMES, describeAgentFailure, isAgentName, parseToolCallLines, parseTokenToolCallLines, resolveBinary, runAgent, } from './agent-runner.js';
 import { OutputFormatter, c } from '../output/format.js';
 import { formatGenerateProgressLine } from './progress.js';
 import { buildPrompt, resolveSkillPath } from './prompt-builder.js';
@@ -16,7 +16,6 @@ import { getRefineArtifactsRoot, getRefineSessionPaths } from '../analyze/select
 import { readExperiencesCredentials } from '../credentials-store.js';
 import { addAgentModelOptions } from '../lib/agent-model-options.js';
 const execFileAsync = promisify(execFile);
-const VALID_AGENTS = new Set(['claude', 'codex', 'opencode', 'cursor']);
 const DEFAULT_TIMEOUT_MS = Number(process.env.EDS_AGENT_TIMEOUT_MS ?? 3 * 60 * 1000);
 const DEFAULT_COMPONENT_CONCURRENCY = 10;
 const RETRY_BACKOFF_MS = Number(process.env.EDS_RETRY_BACKOFF_MS ?? 5_000);
@@ -313,8 +312,8 @@ async function runGenerateSkill(skill, opts, verbose = false) {
     const savedCreds = await readExperiencesCredentials();
     const agentName = opts.agent ?? savedCreds.agent;
     const model = opts.model ?? savedCreds.agentModel;
-    if (!agentName || !VALID_AGENTS.has(agentName)) {
-        die(`Error: no agent configured. Pass --agent <name> or run experiences setup. Accepted values: claude, codex, opencode, cursor`);
+    if (!agentName || !isAgentName(agentName)) {
+        die(`Error: no agent configured. Pass --agent <name> or run experiences setup. Accepted values: ${AGENT_NAMES.join(', ')}`);
     }
     const agent = agentName;
     // Feature 8: resolve custom-prompt path for `components` (flag wins over

package/dist/src/import/command.js

@@ -4,6 +4,8 @@ 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 { isConflictMode } from '../runs/save-path-resolver.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
 import { DEFAULT_CONFIGURED_HOST, toConfiguredHost } from '../host-utils.js';
 import { replayRun, modifyRun } from '../runs/replay-helpers.js';
@@ -42,9 +44,9 @@ export function registerImportCommand(program) {
         .option('--host <url>', 'Override API base URL (passed to apply push)')
         .option('--dry-run', "(deprecated, will change semantics in a future release) Print generate components prompt without invoking the agent. Use --print-prompt for the same behaviour explicitly, or '--dry-run --no-push' for the upcoming manifest-preview semantics.")
         .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)')
-        .option('--composite', 'Import embedded-component hierarchy (opt in; default is atomic)')
-        .option('--atomic', 'Import flat components with no embedded-component hierarchy (default)')
+        .option('--auto-accept-scope', 'Accept all extracted components without prompting (for scripted/non-TTY callers)');
+    addCompositionOptions(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)')
         .option('--composition-refresh', 'Bypass the composition cache and re-resolve from scratch, forcing the agent to run (implies --composite)')
@@ -59,7 +61,7 @@ export function registerImportCommand(program) {
         .option('--no-save', 'Push without writing components.json / tokens.json to disk (default: save AND push)')
         .option('--out-dir <path>', 'Save components.json / tokens.json to this directory; bypasses the inline save-path prompt')
         .option('--on-conflict <mode>', "How to handle existing components.json / tokens.json at the save path: 'overwrite' replaces files, 'skip' writes to a timestamped subdirectory, 'fail' exits non-zero. Skips the wizard's interactive conflict gate when set.", (value) => {
-        if (value !== 'overwrite' && value !== 'skip' && value !== 'fail') {
+        if (!isConflictMode(value)) {
             process.stderr.write(`Error: invalid --on-conflict value '${value}'. Use one of: overwrite, skip, fail.\n`);
             process.exit(1);
         }

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

@@ -1,7 +1,7 @@
 import React from 'react';
 import { type RunPickerSelection } from '../../runs/run-picker.js';
 import type { RunRecord } from '../../runs/store.js';
-import { type OnConflictMode } from '../../runs/save-path-resolver.js';
+import { type ConflictMode } from '../../runs/save-path-resolver.js';
 import type { CompositionMode } from '../../lib/composition-mode.js';
 export declare function buildSelectAgentArgs(opts: {
     sessionId: string;
@@ -55,7 +55,7 @@ export type WizardAppProps = {
     noPush?: boolean;
     noSave?: boolean;
     outDirOverride?: string;
-    onConflictMode?: OnConflictMode;
+    onConflictMode?: ConflictMode;
     selectPromptPath?: string;
     generatePromptPath?: string;
     seedExtractSessionId?: string;

package/dist/src/import/tui/wizard-save-flow.d.ts

@@ -1,5 +1,5 @@
 import { type RunRecord } from '../../runs/store.js';
-import { type OnConflictMode } from '../../runs/save-path-resolver.js';
+import { type ConflictMode } from '../../runs/save-path-resolver.js';
 /**
  * Wizard save-flow orchestration helpers (Task 4 / spec part 1+2).
  *
@@ -17,7 +17,7 @@ export type PlanSaveFlowInput = {
      * path interactively. When provided alongside an override, the conflict
      * gate is bypassed and the mode is applied via `resolveSavePath`.
      */
-    onConflict?: OnConflictMode | undefined;
+    onConflict?: ConflictMode | undefined;
 };
 export type PlanSaveFlowOutput = {
     kind: 'write';

package/dist/src/lib/agent-model-options.d.ts

@@ -1,5 +1,5 @@
 import type { Command } from 'commander';
-export declare const AGENT_DESCRIPTION = "Agent to use: claude, codex, opencode, cursor (defaults to value saved by experiences setup)";
+export declare const AGENT_DESCRIPTION: string;
 export declare const MODEL_DESCRIPTION = "Model to use (defaults to a lightweight per-agent model; override with EDS_AGENT_MODEL_<AGENT>)";
 export interface AgentModelOptionsConfig {
     agentDescription?: string;

package/dist/src/lib/agent-model-options.js

@@ -1,4 +1,5 @@
-export const AGENT_DESCRIPTION = 'Agent to use: claude, codex, opencode, cursor (defaults to value saved by experiences setup)';
+import { AGENT_NAMES } from './agent-names.js';
+export const AGENT_DESCRIPTION = `Agent to use: ${AGENT_NAMES.join(', ')} (defaults to value saved by experiences setup)`;
 export const MODEL_DESCRIPTION = 'Model to use (defaults to a lightweight per-agent model; override with EDS_AGENT_MODEL_<AGENT>)';
 /**
  * Register --agent and optionally --model flags to a Commander command, with customizable descriptions.

package/dist/src/lib/agent-names.d.ts

@@ -0,0 +1,4 @@
+export declare const AGENT_NAMES: readonly ["claude", "codex", "opencode", "cursor"];
+export type AgentName = (typeof AGENT_NAMES)[number];
+export declare const DEFAULT_AGENT_NAME: AgentName;
+export declare function isAgentName(value: string): value is AgentName;

package/dist/src/lib/agent-names.js

@@ -0,0 +1,5 @@
+export const AGENT_NAMES = ['claude', 'codex', 'opencode', 'cursor'];
+export const DEFAULT_AGENT_NAME = 'claude';
+export function isAgentName(value) {
+    return AGENT_NAMES.includes(value);
+}

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

@@ -0,0 +1,5 @@
+import type { Command } from 'commander';
+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;

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

@@ -0,0 +1,27 @@
+export function addArtifactInputOptions(cmd) {
+    return cmd
+        .option('--components <path>', 'Path to components.json (CDF)')
+        .option('--tokens <path>', 'Path to tokens.json (DTCG)')
+        .option('--session <id>', 'Pipeline session ID to load generated components from');
+}
+export function addContentfulTargetOptions(cmd) {
+    return cmd
+        .requiredOption('--space-id <id>', 'Contentful space ID')
+        .requiredOption('--environment-id <id>', 'Contentful environment ID')
+        .option('--cma-token <token>', 'CMA personal access token (or set CONTENTFUL_MANAGEMENT_TOKEN)')
+        .option('--host <url>', 'Override API base URL');
+}
+export function addCompositionOptions(cmd) {
+    return cmd
+        .option('--composite', 'Import embedded-component hierarchy (opt in; default is atomic)')
+        .option('--atomic', 'Import flat components with no embedded-component hierarchy (default)');
+}
+function collectOptionValue(value, previous) {
+    return [...previous, value];
+}
+export function addSelectionOptions(cmd) {
+    return cmd
+        .option('--select-all', 'Select all entities without launching TUI')
+        .option('--select <pattern>', 'Select entities by ID pattern (repeatable)', collectOptionValue, [])
+        .option('--deselect <pattern>', 'Deselect entities by ID pattern (repeatable)', collectOptionValue, []);
+}

package/dist/src/lib/composition-mode.d.ts

@@ -1,4 +1,6 @@
-export type CompositionMode = 'composite' | 'atomic';
+export declare const COMPOSITION_MODES: readonly ["composite", "atomic"];
+export type CompositionMode = (typeof COMPOSITION_MODES)[number];
+export declare function isCompositionMode(value: string): value is CompositionMode;
 /**
  * Options that, when present, IMPLY composite mode — passing any of them is a
  * clear opt-in, so requiring an explicit `--composite` alongside is redundant.

package/dist/src/lib/composition-mode.js

@@ -1,3 +1,7 @@
+export const COMPOSITION_MODES = ['composite', 'atomic'];
+export function isCompositionMode(value) {
+    return COMPOSITION_MODES.includes(value);
+}
 function hasCompositionSource(opts) {
     return !!opts.compositionMap || !!opts.compositionAgent || !!opts.compositionRefresh || !!opts.generateMap;
 }
@@ -26,12 +30,10 @@ export function resolveCompositionMode(opts, configMode) {
     const env = process.env['EXPERIENCES_COMPOSITION_MODE'];
     if (env !== undefined && env !== '') {
         const v = env.toLowerCase();
-        if (v === 'composite')
-            return 'composite';
-        if (v === 'atomic')
-            return 'atomic';
+        if (isCompositionMode(v))
+            return v;
     }
-    if (configMode === 'composite' || configMode === 'atomic')
+    if (configMode && isCompositionMode(configMode))
         return configMode;
     return 'atomic';
 }

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

@@ -2,6 +2,7 @@
  * Thin indirection so `runModifyCommand` can be unit-tested without spinning
  * up the real Ink wizard. The production implementation lives here.
  */
+import type { CompositionMode } from '../lib/composition-mode.js';
 export type ModifyLauncherInput = {
     extractSessionId: string;
     generateSessionId: string | null;
@@ -15,7 +16,7 @@ export type ModifyLauncherInput = {
     saveMode: 'overwrite' | 'new' | 'prompt';
     /** Composition mode from the run record, so the modify wizard resumes in the
      *  same mode. Omitted → the wizard's default (`atomic`). */
-    compositionMode?: 'composite' | 'atomic';
+    compositionMode?: CompositionMode;
     outDirOverride?: string;
     /** Pre-fill space id (from the run record's pushedTo). */
     initialSpaceId?: string;

package/dist/src/runs/save-path-resolver.d.ts

@@ -1,3 +1,6 @@
+export declare const CONFLICT_MODES: readonly ["overwrite", "skip", "fail"];
+export type ConflictMode = (typeof CONFLICT_MODES)[number];
+export declare function isConflictMode(value: string): value is ConflictMode;
 /**
  * Returns true if `components.json` or `tokens.json` already exists at `path`.
  * Used by the wizard to decide whether to render the save-conflict gate before
@@ -16,10 +19,9 @@ export declare function buildTimestampedSubdir(base: string, now?: Date): string
  * - `skip`      — write to a timestamped subdir under the requested path.
  * - `fail`      — refuse to write; surface the conflicting filenames.
  */
-export type OnConflictMode = 'overwrite' | 'skip' | 'fail';
 export type ResolveSavePathOptions = {
     /** When provided, applies the chosen mode automatically (no interactive gate). */
-    onConflict?: OnConflictMode;
+    onConflict?: ConflictMode;
     /** Injected for deterministic tests; falls back to `new Date()`. */
     now?: Date;
 };

package/dist/src/runs/save-path-resolver.js

@@ -1,5 +1,9 @@
 import { access } from 'node:fs/promises';
 import { join } from 'node:path';
+export const CONFLICT_MODES = ['overwrite', 'skip', 'fail'];
+export function isConflictMode(value) {
+    return CONFLICT_MODES.includes(value);
+}
 /**
  * The set of files the wizard / CLI may overwrite in the save directory.
  * Centralised so conflict detection and conflict reporting stay in lock-step.

package/dist/src/runs/store.d.ts

@@ -1,3 +1,4 @@
+import type { CompositionMode } from '../lib/composition-mode.js';
 export declare const RUNS_FILE_VERSION: 3;
 export declare const RUNS_FILE_CAP = 200;
 /** Versions this CLI can read. v1 / v2 files are auto-migrated in memory;
@@ -58,7 +59,7 @@ export type RunRecord = {
     /** Composition mode the run was produced in, so modify/replay resumes in the
      *  same mode (`composite` vs `atomic`). Absent on records written before this
      *  field existed; callers treat a missing value as `atomic` (the default). */
-    compositionMode?: 'composite' | 'atomic';
+    compositionMode?: CompositionMode;
     notes?: string;
 };
 export type RunsFile = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.16.2-dev-build-ec5957c.0",
+  "version": "2.16.2-dev-build-a6d3bd1.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -34,8 +34,8 @@
     "react": "^18.3.1",
     "react-devtools-core": "^4.19.1",
     "react-dom": "^18.3.1",
-    "@contentful/experience-design-system-extraction": "2.16.2-dev-build-ec5957c.0",
-    "@contentful/experience-design-system-types": "2.16.2-dev-build-ec5957c.0"
+    "@contentful/experience-design-system-extraction": "2.16.2-dev-build-a6d3bd1.0",
+    "@contentful/experience-design-system-types": "2.16.2-dev-build-a6d3bd1.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.3",