@contentful/experience-design-system-cli 2.34.5-dev-build-4985ea96.0 → 2.34.5-dev-build-98f09a97.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.34.5-dev-build-4985ea96.0",
+  "version": "2.34.5-dev-build-98f09a97.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

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

@@ -7,7 +7,7 @@ export type ExperiencesCredentials = {
     agentModel?: string;
     /** Feature 8: persisted custom prompt path for `generate components`. */
     generatePromptPath?: string;
-    /** Feature: default debug-mode (writes JSONL trace of every decision) for all commands. */
+    /** Write JSONL trace of every command decision to ~/.contentful/experience-design-system-cli/debug/. */
     debug?: boolean;
     /** Print plain text with no color; an exported NO_COLOR still wins. */
     noColor?: boolean;

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

@@ -17,7 +17,6 @@ export declare function buildGenerateTokensArgs(opts: {
     model?: string;
     bedrock?: boolean;
     noCache?: boolean;
-    promptOverrides?: string[];
 }): string[];
 export declare function buildMapTokensArgs(opts: {
     sessionId: string;
@@ -25,7 +24,6 @@ export declare function buildMapTokensArgs(opts: {
     model?: string;
     noCache?: boolean;
     skipAgent?: boolean;
-    promptOverrides?: string[];
     existingEntitiesPath?: string;
 }): string[];
 export declare function shouldRunMapTokens(opts: {
@@ -53,6 +51,7 @@ export type WizardAppProps = {
     bedrock?: boolean;
     initialProjectPath?: string;
     host?: string;
+    compositionMap?: string;
     promptOverrides?: string[];
     noCache?: boolean;
     livePreview?: boolean;
@@ -60,4 +59,4 @@ export type WizardAppProps = {
     skipMapTokens?: boolean;
     initialRawTokensPath?: string;
 };
-export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, promptOverrides, noCache, livePreview, generatePromptPath, skipMapTokens, initialRawTokensPath, }?: WizardAppProps): React.ReactElement;
+export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, compositionMap, promptOverrides, noCache, livePreview, generatePromptPath, skipMapTokens, initialRawTokensPath, }?: WizardAppProps): React.ReactElement;

package/dist/src/index.js

@@ -1184,17 +1184,6 @@ function initDebugLogger(opts) {
 function getDebugLogger() {
   return singleton ?? new NoopDebugLogger();
 }
-function resolveDebugMode(opts, configDebug) {
-  if (opts.debug !== void 0) return opts.debug;
-  const env = process.env["EDSI_DEBUG"];
-  if (env !== void 0 && env !== "") {
-    const v = env.toLowerCase();
-    if (v === "1" || v === "true" || v === "yes" || v === "on") return true;
-    if (v === "0" || v === "false" || v === "no" || v === "off") return false;
-  }
-  if (configDebug !== void 0) return configDebug;
-  return false;
-}
 function printDebugBanner(logger, phase) {
   if (!logger.enabled || !logger.path) return;
   const prefix = phase === "start" ? "\x1B[92m[debug]\x1B[0m " : "\x1B[92m[debug]\x1B[0m ";
@@ -4146,17 +4135,12 @@ var init_persistence = __esm({
 
 // packages/experience-design-system-cli/src/lib/agent-model-options.ts
 function addAgentModelOptions(cmd, config = {}) {
-  const {
-    agentDescription = AGENT_DESCRIPTION,
-    includeModel = true,
-    includeBedrock = true,
-    modelDescription = MODEL_DESCRIPTION
-  } = config;
+  const { agentDescription = AGENT_DESCRIPTION, includeModel = true, modelDescription = MODEL_DESCRIPTION } = config;
   cmd.option("--agent <name>", agentDescription);
   if (includeModel) {
     cmd.option("--model <name>", modelDescription);
   }
-  if (includeBedrock) cmd.option("--bedrock", BEDROCK_DESCRIPTION);
+  cmd.option("--bedrock", BEDROCK_DESCRIPTION);
   return cmd;
 }
 var AGENT_DESCRIPTION, MODEL_DESCRIPTION, BEDROCK_AGENTS, BEDROCK_DESCRIPTION;
@@ -4915,8 +4899,7 @@ async function runGenerateSkill(skill, opts, verbose = false) {
   const { overrides: promptOverrides, errors: promptErrors } = parsePromptOverrides(opts.prompt ?? []);
   if (promptErrors.length > 0) die(`Error: ${promptErrors.join("; ")}`);
   let generatePrompt;
-  const promptStage = skill === "tokens" ? "tokens" : "generate";
-  const generateOverride = promptOverrides.get(promptStage);
+  const generateOverride = promptOverrides.get("generate");
   if (generateOverride) {
     try {
       generatePrompt = await resolvePromptOverride(generateOverride);
@@ -5266,12 +5249,7 @@ function registerInternalGenerateCommand(program) {
   addAgentFlags(componentsCmd).action(async (opts) => {
     await runGenerateSkill("components", opts, opts.verbose ?? false);
   });
-  const tokensCmd = generate.command("tokens").description("Invoke a coding agent to produce tokens.json from raw token data").option("--raw-tokens <path>", "Path to raw token input file").option(
-    "--prompt <stage=value>",
-    "Override a stage prompt (repeatable). Used here for the tokens stage.",
-    (v, acc) => [...acc, v],
-    []
-  );
+  const tokensCmd = generate.command("tokens").description("Invoke a coding agent to produce tokens.json from raw token data").option("--raw-tokens <path>", "Path to raw token input file");
   addAgentFlags(tokensCmd).action(async (opts) => {
     await runGenerateSkill("tokens", opts, opts.verbose ?? false);
   });
@@ -8491,20 +8469,6 @@ async function runMapTokens(opts) {
     );
   }
   const resultAgent = configuredAgent ?? "skipped";
-  const { overrides: promptOverrides, errors: promptErrors } = parsePromptOverrides(opts.prompt ?? []);
-  if (promptErrors.length > 0) die(`Error: ${promptErrors.join("; ")}`);
-  const mapPromptOverride = promptOverrides.get("map-tokens");
-  let mapPromptText;
-  let mapPromptPath;
-  if (mapPromptOverride?.kind === "text") mapPromptText = mapPromptOverride.value;
-  if (mapPromptOverride?.kind === "path") {
-    mapPromptPath = resolve8(mapPromptOverride.value);
-    try {
-      await resolvePromptOverride(mapPromptOverride);
-    } catch (error) {
-      die(`Error: ${error instanceof Error ? error.message : String(error)}`);
-    }
-  }
   const db = openPipelineDb();
   try {
     const sessionId2 = opts.session ?? findLatestSessionForCommand(db, "generate components");
@@ -8614,9 +8578,7 @@ ${defaultDiagnostics.map((diagnostic) => `  ${diagnostic}`).join("\n")}
       tokenTree,
       componentSourceRefs,
       outDir: process.cwd(),
-      existingTokensInline,
-      ...mapPromptText !== void 0 ? { skillContentOverride: mapPromptText } : {},
-      ...mapPromptText === void 0 && mapPromptPath ? { skillPathOverride: mapPromptPath } : {}
+      existingTokensInline
     });
     if (opts.printPrompt) {
       const prompt2 = await buildMapPrompt();
@@ -8641,8 +8603,7 @@ ${defaultDiagnostics.map((diagnostic) => `  ${diagnostic}`).join("\n")}
       agent,
       model,
       void 0,
-      existingTokensInline ? [hashContent(existingTokensInline)] : [],
-      mapPromptText
+      existingTokensInline ? [hashContent(existingTokensInline)] : []
     );
     const inputHash = computeMapTokensInputHash(db, sessionId2, componentSourceRefs);
     if (!noCache) {
@@ -8690,12 +8651,7 @@ ${warnings.map((w) => `  ${w}`).join("\n")}
 }
 function registerMapTokensCommand(program) {
   const map = program.command("map", { hidden: true }).description("Suggest token restrictions for generated design-token props");
-  const tokensCmd = map.command("tokens").description("Invoke a coding agent to suggest $token.allowed for design-category token props").option("--session <id>", "Session ID from generate components (defaults to most recent)").option("--print-prompt", "Print the prompt without invoking the agent").option("--skip-agent", "Resolve token defaults without agentic $token.allowed inference").option("--no-cache", "Bypass the map-tokens cache and force a re-run").option(
-    "--prompt <stage=value>",
-    "Override a stage prompt (repeatable). Used here for the map-tokens stage.",
-    (v, acc) => [...acc, v],
-    []
-  ).option("--token-map <path>", "Path to token-name-map.json sidecar").option(
+  const tokensCmd = map.command("tokens").description("Invoke a coding agent to suggest $token.allowed for design-category token props").option("--session <id>", "Session ID from generate components (defaults to most recent)").option("--print-prompt", "Print the prompt without invoking the agent").option("--skip-agent", "Resolve token defaults without agentic $token.allowed inference").option("--no-cache", "Bypass the map-tokens cache and force a re-run").option("--token-map <path>", "Path to token-name-map.json sidecar").option(
     "--existing-entities-path <path>",
     "Path to the .existing-entities.json file written after CMA credentials are supplied. When present, the agent gets a list of the space's existing design tokens so it can prefer binding to them. Missing/malformed files are treated as no-op."
   );
@@ -8720,7 +8676,6 @@ var init_command4 = __esm({
     init_MapTokensView();
     init_resolve_defaults();
     init_cli_errors();
-    init_prompt_overrides();
     DEFAULT_TIMEOUT_MS2 = Number(process.env.EDS_AGENT_TIMEOUT_MS ?? 5 * 60 * 1e3);
   }
 });
@@ -8748,50 +8703,6 @@ var init_path_utils = __esm({
   }
 });
 
-// packages/experience-design-system-cli/src/import/agent-model-resolve.ts
-function parseAgentModel(value) {
-  if (!value?.trim()) return {};
-  const trimmed = value.trim();
-  const separator = trimmed.indexOf(":");
-  if (separator >= 0) {
-    return {
-      agent: trimmed.slice(0, separator).trim() || void 0,
-      model: trimmed.slice(separator + 1).trim() || void 0
-    };
-  }
-  const [agent, ...modelParts] = trimmed.split(/\s+/);
-  return { agent, ...modelParts.length > 0 ? { model: modelParts.join(" ") } : {} };
-}
-function resolveAgent(flagValue, storedValue) {
-  if (flagValue && flagValue.length > 0) return flagValue;
-  if (storedValue && storedValue.length > 0) return storedValue;
-  return DEFAULT_AGENT;
-}
-function resolveModel(flagValue, storedValue) {
-  if (flagValue && flagValue.length > 0) return flagValue;
-  if (storedValue && storedValue.length > 0) return storedValue;
-  return void 0;
-}
-var DEFAULT_AGENT;
-var init_agent_model_resolve = __esm({
-  "packages/experience-design-system-cli/src/import/agent-model-resolve.ts"() {
-    "use strict";
-    DEFAULT_AGENT = "claude";
-  }
-});
-
-// packages/experience-design-system-cli/src/import/composition-options.ts
-function buildCompositionForwardingOptions(options) {
-  return {
-    ...options.prompt && options.prompt.length > 0 ? { promptOverrides: options.prompt } : {}
-  };
-}
-var init_composition_options = __esm({
-  "packages/experience-design-system-cli/src/import/composition-options.ts"() {
-    "use strict";
-  }
-});
-
 // packages/experience-design-system-cli/src/analyze/select/tui/theme.ts
 var PALETTE;
 var init_theme = __esm({
@@ -26637,70 +26548,6 @@ var init_wizard_state_transitions = __esm({
   }
 });
 
-// packages/experience-design-system-cli/src/import/tui/run-selection-agent.ts
-async function runSelectionAgent(options) {
-  const db = openPipelineDb();
-  let components;
-  try {
-    components = loadRawComponents(db, options.sessionId);
-  } finally {
-    db.close();
-  }
-  if (components.length === 0) return;
-  const invoker2 = createLocalCliAgentInvoker({
-    onDebugEvent: (name, payload) => getDebugLogger().event("agent", name, payload)
-  });
-  const prompt = await buildPrompt({
-    skill: "select",
-    mode: "autonomous",
-    rawComponentsInline: JSON.stringify(components, null, 2),
-    outDir: process.cwd(),
-    ...options.promptText !== void 0 ? { skillContentOverride: options.promptText } : {},
-    ...options.promptText === void 0 && options.promptPath ? { skillPathOverride: options.promptPath } : {}
-  });
-  const { result } = await invokeAgentWithOutput(
-    invoker2,
-    { agent: options.agent, model: options.model, prompt, timeoutMs: DEFAULT_TIMEOUT_MS4 },
-    false
-  );
-  if (result.timedOut) throw new Error("selection agent timed out");
-  if (result.exitCode !== 0) throw new Error(`selection agent exited with code ${result.exitCode}`);
-  const { calls, warnings } = parseSelectToolCallLines(result.stdout);
-  for (const warning of warnings) process.stderr.write(`Warning: selection agent: ${warning}
-`);
-  const byName = new Map(calls.map((call) => [call.name, call]));
-  const writeDb = openPipelineDb();
-  try {
-    const update = writeDb.prepare(
-      `UPDATE raw_components SET status = ?, reject_reason = ? WHERE session_id = ? AND component_id = ?`
-    );
-    for (const component of components) {
-      const call = byName.get(component.name);
-      if (!call) continue;
-      const rejected = call.tool === "reject_component";
-      update.run(
-        rejected ? "rejected" : "accepted",
-        rejected ? call.reason ?? null : null,
-        options.sessionId,
-        component.component_id
-      );
-    }
-  } finally {
-    writeDb.close();
-  }
-}
-var DEFAULT_TIMEOUT_MS4;
-var init_run_selection_agent = __esm({
-  "packages/experience-design-system-cli/src/import/tui/run-selection-agent.ts"() {
-    "use strict";
-    init_src();
-    init_debug_logger();
-    init_agent_output();
-    init_db();
-    DEFAULT_TIMEOUT_MS4 = Number(process.env.EDS_AGENT_TIMEOUT_MS ?? 5 * 60 * 1e3);
-  }
-});
-
 // packages/experience-design-system-cli/src/import/tui/WizardApp.tsx
 var WizardApp_exports = {};
 __export(WizardApp_exports, {
@@ -26739,7 +26586,6 @@ function buildGenerateTokensArgs(opts) {
   if (opts.model) args.push("--model", opts.model);
   if (opts.bedrock) args.push("--bedrock");
   if (opts.noCache) args.push("--no-cache");
-  for (const prompt of opts.promptOverrides ?? []) args.push("--prompt", prompt);
   return args;
 }
 function buildMapTokensArgs(opts) {
@@ -26747,7 +26593,6 @@ function buildMapTokensArgs(opts) {
   if (opts.model) args.push("--model", opts.model);
   if (opts.noCache) args.push("--no-cache");
   if (opts.skipAgent) args.push("--skip-agent");
-  for (const prompt of opts.promptOverrides ?? []) args.push("--prompt", prompt);
   if (opts.existingEntitiesPath) args.push("--existing-entities-path", opts.existingEntitiesPath);
   return args;
 }
@@ -26823,6 +26668,7 @@ function WizardApp({
   bedrock = false,
   initialProjectPath,
   host,
+  compositionMap,
   promptOverrides,
   noCache = false,
   livePreview = true,
@@ -26992,8 +26838,7 @@ If you are using AWS Bedrock, run:
       agent: state.agent,
       ...state.agentModel ? { model: state.agentModel } : {},
       ...state.bedrock ? { bedrock: true } : {},
-      noCache: effectiveNoCache,
-      promptOverrides
+      noCache: effectiveNoCache
     });
     const result = await runSpawnedCli(tokenArgs);
     if (result.exitCode !== 0) {
@@ -27073,7 +26918,6 @@ If you are using AWS Bedrock, run:
       ...state.agentModel ? { model: state.agentModel } : {},
       noCache: effectiveNoCache,
       skipAgent: skipMapTokens,
-      promptOverrides,
       ...state.existingEntitiesPath ? { existingEntitiesPath: state.existingEntitiesPath } : {}
     });
     const result = await runCli(args);
@@ -27092,6 +26936,7 @@ If you are using AWS Bedrock, run:
     update({ step: "extracting", outDir, extractProgress: null, compositionPhase: null });
     const extractArgs = [findCliPath(), "__extract", "--project", projectPath];
     if (noCache) extractArgs.push("--composition-refresh");
+    if (compositionMap) extractArgs.push("--composition-map", compositionMap);
     for (const p of promptOverrides ?? []) extractArgs.push("--prompt", p);
     if (state.agent) extractArgs.push("--agent", state.agent);
     if (state.bedrock) extractArgs.push("--bedrock");
@@ -27156,34 +27001,6 @@ Make sure this path contains TypeScript/React/Vue component files (.tsx, .ts, .v
       });
       return;
     }
-    try {
-      const { overrides, errors } = parsePromptOverrides(promptOverrides ?? []);
-      if (errors.length > 0) throw new Error(errors.join("; "));
-      const selectOverride = overrides.get("select");
-      let promptText;
-      let promptPath;
-      if (selectOverride?.kind === "text") promptText = selectOverride.value;
-      if (selectOverride?.kind === "path") {
-        promptPath = resolve17(selectOverride.value);
-        await resolvePromptOverride(selectOverride);
-      }
-      if (state.agent) {
-        await runSelectionAgent({
-          sessionId: extractSessionId ?? "",
-          agent: state.agent,
-          ...state.agentModel ? { model: state.agentModel } : {},
-          ...promptText !== void 0 ? { promptText } : {},
-          ...promptPath ? { promptPath } : {}
-        });
-      }
-    } catch (error) {
-      update({
-        step: "error",
-        errorStep: "selection agent",
-        errorMessage: error instanceof Error ? error.message : String(error)
-      });
-      return;
-    }
     update({
       step: "scope-gate",
       extractSessionId
@@ -28430,27 +28247,15 @@ var init_WizardApp = __esm({
     init_fetch_and_persist_existing_contentful_entities();
     init_wizard_state_transitions();
     init_cli_path();
-    init_prompt_overrides();
-    init_run_selection_agent();
     WIZARD_LOG = join20(tmpdir(), "experiences-import-wizard.log");
   }
 });
 
 // packages/experience-design-system-cli/src/import/command.ts
 function registerImportCommand(program) {
-  const cmd = program.command("import").description("Run the full pipeline: analyze \u2192 select \u2192 generate \u2192 push").option("--project <path>", "Path to the project root to analyze", ".");
-  cmd.option(
-    "--tokens <path>",
-    "Path to a raw token source file (SCSS, CSS variables, JS/TS, Style Dictionary, etc.) to classify and import alongside components. Bypasses the interactive token prompt."
-  );
-  addAgentModelOptions(cmd, {
-    agentDescription: 'Agent and optional model as agent:model or "agent model" (overrides credentials.json; falls back to "claude")',
-    includeModel: false,
-    includeBedrock: false
-  });
-  cmd.option(
+  program.command("import").description("Run the full pipeline: analyze \u2192 select \u2192 generate \u2192 push").option("--project <path>", "Path to the project root to analyze", ".").option("--tokens <path>", "Path to a raw token source file to import alongside components").option("--agent <name>", 'Agent to use for generation (overrides credentials.json; falls back to "claude")').option(
     "--prompt <stage=value>",
-    "Override a composition, selection, token, generation, or token-mapping prompt (repeatable). value is a file path or literal text, e.g. --prompt select=./p.md",
+    "Override a stage prompt (repeatable). value is a file path or literal text, e.g. --prompt composition=./p.md",
     (v, acc) => [...acc, v],
     []
   ).option("--no-cache", "Re-run all steps even if output already exists").action(async (opts) => {
@@ -28476,9 +28281,8 @@ function registerImportCommand(program) {
       const { createElement: createElement6 } = await import("react");
       const { WizardApp: WizardApp2 } = await Promise.resolve().then(() => (init_WizardApp(), WizardApp_exports));
       const creds = await readExperiencesCredentials();
-      const parsedAgentModel = parseAgentModel(opts.agent);
-      const resolvedAgent = resolveAgent(parsedAgentModel.agent, creds.agent);
-      const resolvedModel = resolveModel(parsedAgentModel.model, creds.agentModel);
+      const resolvedAgent = opts.agent || creds.agent || "claude";
+      const resolvedModel = creds.agentModel || void 0;
       const { waitUntilExit } = render5(
         createElement6(WizardApp2, {
           initialSpaceId: creds.spaceId,
@@ -28488,9 +28292,8 @@ function registerImportCommand(program) {
           initialAgent: resolvedAgent,
           ...resolvedModel ? { initialModel: resolvedModel } : {},
           initialProjectPath: opts.project !== "." ? normalizePath(opts.project) : void 0,
-          ...buildCompositionForwardingOptions(opts),
+          ...opts.prompt && opts.prompt.length > 0 ? { promptOverrides: opts.prompt } : {},
           noCache: opts.cache === false,
-          skipMapTokens: false,
           livePreview: true,
           generatePromptPath: creds.generatePromptPath,
           ...opts.tokens ? { initialRawTokensPath: normalizePath(opts.tokens) } : {}
@@ -28505,11 +28308,8 @@ var init_command6 = __esm({
   "packages/experience-design-system-cli/src/import/command.ts"() {
     "use strict";
     init_path_utils();
-    init_agent_model_resolve();
-    init_agent_model_options();
     init_credentials_store();
     init_host_utils();
-    init_composition_options();
     init_terminal_capabilities();
   }
 });
@@ -30860,14 +30660,14 @@ var init_extract_command = __esm({
 });
 
 // packages/experience-design-system-cli/src/lib/debug-preamble.ts
-async function beginCommand(command, opts) {
+async function beginCommand(command) {
   let configDebug;
   try {
     const creds = await readExperiencesCredentials();
     configDebug = creds.debug;
   } catch {
   }
-  const enabled = resolveDebugMode(opts, configDebug);
+  const enabled = configDebug ?? false;
   const logger = initDebugLogger({ enabled, command });
   if (logger.enabled) {
     printDebugBanner(logger, "start");
@@ -30992,7 +30792,7 @@ function createProgram() {
     const { analyticsDisabled } = await readExperiencesCredentials();
     setPersistedAnalyticsDisabled(analyticsDisabled ?? false);
     noteCommandStart(commandChain);
-    await beginCommand(commandChain, {});
+    await beginCommand(commandChain);
   });
   program.hook("postAction", async () => {
     await completeActiveCommand();

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

@@ -4,12 +4,12 @@ export declare const MODEL_DESCRIPTION = "Model to use (defaults to a lightweigh
 export interface AgentModelOptionsConfig {
     agentDescription?: string;
     includeModel?: boolean;
-    includeBedrock?: boolean;
     modelDescription?: string;
 }
 /**
- * Register --agent plus optional --model and --bedrock flags with a Commander
- * command. The optional flags can be omitted for commands with a narrower
- * public surface.
+ * Register --agent, --bedrock, and optional --model flags with a Commander
+ * command. Pass includeModel: false to omit --model only — --bedrock is
+ * independent of model selection (it's a routing switch, not a model choice)
+ * and is always registered alongside --agent.
  */
 export declare function addAgentModelOptions(cmd: Command, config?: AgentModelOptionsConfig): Command;

package/dist/src/lib/debug-logger.d.ts

@@ -25,17 +25,6 @@ export declare function initDebugLogger(opts: InitDebugLoggerOptions): DebugLogg
 export declare function getDebugLogger(): DebugLogger;
 /** Test-only: reset the singleton. */
 export declare function __resetDebugLoggerForTest(): void;
-/**
- * Resolve effective debug-mode setting from three sources.
- *
- * Precedence (highest first):
- *   1. `EDSI_DEBUG` env var (truthy: 1, true, yes, on)
- *   2. Persisted `debug` field in credentials.json
- *   4. Default: OFF
- */
-export declare function resolveDebugMode(opts: {
-    debug?: boolean;
-}, configDebug?: boolean): boolean;
 /**
  * Emit the bright-green "debug logs at <path>" banner to stderr.
  * No-op when debug is disabled or stderr is not a TTY-friendly stream.

package/dist/src/lib/debug-preamble.d.ts

@@ -1,14 +1,6 @@
 import { type DebugLogger } from './debug-logger.js';
 /**
- * Preamble every top-level command action should call before doing work.
- *
- * Resolves the effective debug decision (flag > env > persisted config),
- * initializes the singleton, and prints the bright-green start banner.
- * Registers a process-exit handler that prints the end banner once.
- *
- * Returns the logger so the caller can emit events without a second import.
- * When debug is disabled, the returned logger is a no-op.
+ * Initialize the debug logger from persisted credentials.
+ * Debug mode can only be configured via setup preferences;
  */
-export declare function beginCommand(command: string, opts: {
-    debug?: boolean;
-}): Promise<DebugLogger>;
+export declare function beginCommand(command: string): Promise<DebugLogger>;

package/dist/src/program.d.ts

@@ -16,9 +16,9 @@ export declare function runBuild(opts: {
     exitCode: number;
 }>;
 /**
- * Walks `actionCommand` and its ancestors for a truthy `--bedrock`. --bedrock
- * is registered per-subcommand, so a
- * root-level or subcommand-level setting can each carry it.
+ * Walks `actionCommand` and its ancestors for a truthy `--bedrock`.
+ * --bedrock is registered per-subcommand, so a root-level or
+ * subcommand-level setting can each carry it.
  */
 export declare function resolveBedrockFromAncestors(actionCommand: Command): boolean;
 export declare function createProgram(): Command;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.34.5-dev-build-4985ea96.0",
+  "version": "2.34.5-dev-build-98f09a97.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -41,8 +41,8 @@
     "svelte": "^5.56.4",
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
-    "@contentful/experience-design-system-types": "2.34.5-dev-build-4985ea96.0",
-    "@contentful/experience-design-system-cli-v2": "2.34.5-dev-build-4985ea96.0"
+    "@contentful/experience-design-system-types": "2.34.5-dev-build-98f09a97.0",
+    "@contentful/experience-design-system-cli-v2": "2.34.5-dev-build-98f09a97.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
@@ -54,9 +54,9 @@
     "ink-testing-library": "^4.0.0",
     "typescript-eslint": "^8.67.0",
     "vitest": "^4.0.16",
-    "@contentful/experience-design-system-client": "2.34.5-dev-build-4985ea96.0",
-    "@contentful/experience-design-system-extraction": "2.34.5-dev-build-4985ea96.0",
-    "@contentful/experience-design-system-generation": "2.34.5-dev-build-4985ea96.0"
+    "@contentful/experience-design-system-client": "2.34.5-dev-build-98f09a97.0",
+    "@contentful/experience-design-system-extraction": "2.34.5-dev-build-98f09a97.0",
+    "@contentful/experience-design-system-generation": "2.34.5-dev-build-98f09a97.0"
   },
   "repository": {
     "type": "git",

package/dist/src/import/agent-model-resolve.d.ts

@@ -1,27 +0,0 @@
-/**
- * Resolution chain for the combined `--agent` override on `experiences import`.
- *
- * The wizard path previously hard-defaulted `--agent` to `'claude'` at the
- * commander layer, which (a) shadowed the stored `credentials.json` value when
- * the user passed no flag, and (b) made it impossible to distinguish "user
- * explicitly passed --agent claude" from "user passed nothing". The combined
- * flag accepts either `agent:model` or `agent model`.
- *
- * These helpers produce the resolved values to feed into `WizardApp` /
- * the import wizard:
- *
- *   1. CLI flag wins when provided.
- *   2. Otherwise, the value persisted in `credentials.json` (written by
- *      `experiences setup`) is used.
- *   3. Otherwise, the built-in default (currently `'claude'`) is used for
- *      the agent. Model has no default — agents pick a small/fast model
- *      themselves when no model is included in `--agent`.
- */
-/** Built-in fallback agent when neither a flag nor a stored preference is set. */
-export declare const DEFAULT_AGENT = "claude";
-export declare function parseAgentModel(value: string | undefined): {
-    agent?: string;
-    model?: string;
-};
-export declare function resolveAgent(flagValue: string | undefined, storedValue: string | undefined): string;
-export declare function resolveModel(flagValue: string | undefined, storedValue: string | undefined): string | undefined;

package/dist/src/import/tui/run-selection-agent.d.ts

@@ -1,8 +0,0 @@
-import { type AgentName } from '@contentful/experience-design-system-generation';
-export declare function runSelectionAgent(options: {
-    sessionId: string;
-    agent: AgentName;
-    model?: string;
-    promptText?: string;
-    promptPath?: string;
-}): Promise<void>;