@contentful/experience-design-system-cli 2.37.1-dev-build-2ed60464.0 → 2.37.1-dev-build-fc847476.0

package/dist/app.js

@@ -837,7 +837,7 @@ async function runAgent(options) {
     promptLen: prompt.length,
     promptHead: prompt.slice(0, 500)
   });
-  return new Promise((resolve27) => {
+  return new Promise((resolve28) => {
     const bedrockEnv = bedrock ? BEDROCK_ENV_BY_AGENT[agent] : void 0;
     const child = spawn(binary, args, {
       stdio: ["pipe", "pipe", "pipe"],
@@ -886,7 +886,7 @@ async function runAgent(options) {
         stderrLen: stderr.length,
         stderrTail: stderr.slice(-1e3)
       });
-      resolve27(result);
+      resolve28(result);
     });
   });
 }
@@ -908,7 +908,7 @@ async function checkAgentAuth(agent) {
     return "not-found";
   if (agent !== "claude")
     return "ok";
-  return new Promise((resolve27) => {
+  return new Promise((resolve28) => {
     const child = spawn2(binary, ["auth", "status", "--json"], { stdio: ["ignore", "pipe", "pipe"] });
     let stdout = "";
     let done = false;
@@ -917,7 +917,7 @@ async function checkAgentAuth(agent) {
         return;
       done = true;
       child.kill("SIGTERM");
-      resolve27("unauthenticated");
+      resolve28("unauthenticated");
     }, 5e3);
     child.stdout?.on("data", (chunk) => {
       stdout += chunk.toString();
@@ -928,14 +928,14 @@ async function checkAgentAuth(agent) {
       done = true;
       clearTimeout(timer);
       if (code !== 0) {
-        resolve27("unauthenticated");
+        resolve28("unauthenticated");
         return;
       }
       try {
         const status = JSON.parse(stdout);
-        resolve27(status.loggedIn ? "ok" : "unauthenticated");
+        resolve28(status.loggedIn ? "ok" : "unauthenticated");
       } catch {
-        resolve27("unauthenticated");
+        resolve28("unauthenticated");
       }
     });
   });
@@ -945,9 +945,9 @@ async function binaryIsOnPath(binary) {
     const fs = await import("node:fs/promises");
     return fs.access(binary).then(() => true, () => false);
   }
-  return new Promise((resolve27) => {
+  return new Promise((resolve28) => {
     const child = spawn2(process.platform === "win32" ? "where" : "which", [binary], { stdio: "ignore" });
-    child.on("close", (code) => resolve27(code === 0));
+    child.on("close", (code) => resolve28(code === 0));
   });
 }
 var init_check_agent_auth = __esm({
@@ -2329,8 +2329,8 @@ var init_debug_store = __esm({
 });
 
 // packages/experience-design-system-cli/app.tsx
-import { join as join25 } from "node:path";
-import { useEffect as useEffect26, useState as useState33 } from "react";
+import { join as join26 } from "node:path";
+import { useEffect as useEffect27, useState as useState36 } from "react";
 
 // packages/experience-design-system-cli/src/tui/home/home.tsx
 import { useEffect as useEffect2, useState as useState2 } from "react";
@@ -13824,7 +13824,7 @@ function errorMessage(error) {
   return error instanceof Error && error.message ? error.message : String(error);
 }
 function defaultSleep(delayMs) {
-  return new Promise((resolve27) => setTimeout(resolve27, delayMs));
+  return new Promise((resolve28) => setTimeout(resolve28, delayMs));
 }
 
 // packages/experience-design-system-backend-pipeline/dist/src/steps/apply/src/helpers/sanitize-preview.js
@@ -14065,7 +14065,7 @@ var ApiClient = class {
         const progress = maxAttempts > 1 ? attempt / (maxAttempts - 1) : 0;
         const baseDelay = intervalMs + (maxIntervalMs - intervalMs) * progress;
         const jitter = Math.random() * baseDelay * 0.15;
-        await new Promise((resolve27) => setTimeout(resolve27, baseDelay + jitter));
+        await new Promise((resolve28) => setTimeout(resolve28, baseDelay + jitter));
       }
     }
     throw new Error(`Operation ${operationId} timed out after ${maxAttempts} attempts`);
@@ -15165,6 +15165,35 @@ async function emitInvokedIfReady() {
   }, state.sessionId, { flush: true });
 }
 
+// packages/experience-design-system-backend-pipeline/dist/src/analytics/apply.js
+function countWriteResult(items, entityType) {
+  const subset = items.filter((item) => item.entityType === entityType);
+  return {
+    created_count: subset.filter((item) => item.action === "create" && item.status === "succeeded").length,
+    updated_count: subset.filter((item) => item.action === "update" && item.status === "succeeded").length,
+    failed_count: subset.filter((item) => item.status === "failed").length
+  };
+}
+function recordApplyOutcome(client2, spaceId, environmentId, operation) {
+  setCommandContext({
+    space_key: spaceId,
+    environment_key: environmentId,
+    x_contentful_request_id: client2.getLastRequestId()
+  });
+  enrichCommandResult({
+    dsi_operation_id: operation.sys.id,
+    component_type_result: countWriteResult(operation.items ?? [], "ComponentType"),
+    design_token_result: countWriteResult(operation.items ?? [], "DesignToken")
+  });
+}
+function recordContentfulContext(client2, spaceId, environmentId) {
+  setCommandContext({
+    space_key: spaceId,
+    environment_key: environmentId,
+    x_contentful_request_id: client2.getLastRequestId()
+  });
+}
+
 // packages/experience-design-system-backend-pipeline/dist/src/steps/generation/src/controller/map-tokens/run-map-tokens.js
 var DEFAULT_TIMEOUT_MS2 = 5 * 60 * 1e3;
 var MapTokensRunFailure = class _MapTokensRunFailure extends Error {
@@ -16345,7 +16374,7 @@ async function retryDatabaseWrite(operation, attempts = 8) {
       const message = error instanceof Error ? error.message : String(error);
       if (!/database is locked|database is busy/i.test(message) || attempt >= attempts)
         throw error;
-      await new Promise((resolve27) => setTimeout(resolve27, Math.min(250 * attempt, 2e3)));
+      await new Promise((resolve28) => setTimeout(resolve28, Math.min(250 * attempt, 2e3)));
     }
   }
 }
@@ -27672,6 +27701,7 @@ function clearedValidationErrorState() {
 }
 async function runPreview(input, deps) {
   if (shouldBypassPreview(input.state)) return buildSkippedPreviewTransition();
+  setCommandContext({ space_key: input.spaceId, environment_key: input.environmentId });
   try {
     const client2 = deps.createClient({
       cmaToken: input.cmaToken,
@@ -27720,6 +27750,7 @@ async function runPreview(input, deps) {
         db.close();
       }
     }
+    recordContentfulContext(client2, input.spaceId, input.environmentId);
     if (isEmptyPreview(preview)) {
       return {
         step: "done",
@@ -27885,6 +27916,7 @@ async function runPush(input, deps, onPatch) {
     } catch (logErr) {
       safeLog(deps, { pollLogError: String(logErr) });
     }
+    recordApplyOutcome(client2, input.spaceId, input.environmentId, operation);
     const pushResult = resultOf(operation, preview);
     const pushSucceeded = pushResult.componentTypes.failed === 0 && pushResult.designTokens.failed === 0 && operation.sys.status !== "failed";
     if (pushSucceeded && input.state.lastRunId) {
@@ -27999,7 +28031,7 @@ var realSaveDeps = () => ({
   writeFile: (path5, contents) => writeFile7(path5, contents),
   appendRun,
   buildSourceFingerprint,
-  sleep: (ms) => new Promise((resolve27) => setTimeout(resolve27, ms)),
+  sleep: (ms) => new Promise((resolve28) => setTimeout(resolve28, ms)),
   warn: (message) => process.stderr.write(message)
 });
 async function runPrintFiles(input, deps, onPatch) {
@@ -28389,12 +28421,44 @@ init_config();
 init_debug_store();
 init_debug_mode_store();
 init_version();
+
+// packages/experience-design-system-cli/src/tui/help/file-locations.ts
+import { join as join25, resolve as resolve27 } from "node:path";
+function describeFileLocations({
+  contentfulBaseDir,
+  debugModeEnabled,
+  currentSessionDir: currentSessionDir2
+}) {
+  if (!debugModeEnabled) {
+    return {
+      debugLogs: "none while Debug Mode is off",
+      importFiles: `${join25("<project>", ".contentful")}/ (tokens.json, components.json)`
+    };
+  }
+  const base = contentfulBaseDir ? resolve27(contentfulBaseDir) : "<project>";
+  const session = currentSessionDir2 ?? join25(base, ".contentful", "<date>-session-<n>");
+  return {
+    debugLogs: join25(session, "debug"),
+    importFiles: `${join25(session, "dsi-import-<n>")}/ (tokens.json, components.json)`
+  };
+}
+
+// packages/experience-design-system-cli/src/tui/help/help-info.ts
 async function readHelpInfo() {
-  const debugMode = await readDebugModeSetting();
+  const [debugMode, settings] = await Promise.all([readDebugModeSetting(), readSettings2()]);
+  const base = settings["contentfulBaseDir"];
+  const locations = describeFileLocations({
+    contentfulBaseDir: typeof base === "string" ? base : "",
+    debugModeEnabled: debugMode.enabled,
+    currentSessionDir: currentSessionDir()
+  });
   return {
     storage: [
       { label: "Config folder", value: configRoot2() },
-      { label: "Settings file", value: configFilePath2() }
+      { label: "Settings file", value: configFilePath2() },
+      { label: "Agent settings", value: `${configFilePath2()} (keys: agent, agentModel, agents)` },
+      { label: "Debug logs", value: locations.debugLogs },
+      { label: "Import files", value: locations.importFiles }
     ],
     troubleshooting: [
       { label: "CLI version", value: readPackageVersion() },
@@ -28415,7 +28479,7 @@ function Section({ title, rows }) {
   return /* @__PURE__ */ jsxs43(Box42, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx53(Text44, { bold: true, color: PALETTE.accent, children: title }),
     rows.map((row) => /* @__PURE__ */ jsxs43(Box42, { gap: 1, children: [
-      /* @__PURE__ */ jsx53(Box42, { width: 14, flexShrink: 0, children: /* @__PURE__ */ jsx53(Text44, { color: PALETTE.muted, children: row.label }) }),
+      /* @__PURE__ */ jsx53(Box42, { width: 16, flexShrink: 0, children: /* @__PURE__ */ jsx53(Text44, { color: PALETTE.muted, children: row.label }) }),
       /* @__PURE__ */ jsx53(Text44, { children: row.value })
     ] }, row.label))
   ] });
@@ -28515,15 +28579,338 @@ function SettingsScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
-import { useEffect as useEffect22, useState as useState29 } from "react";
+import { useState as useState32 } from "react";
+import { Box as Box47, Text as Text49, useInput as useInput13 } from "ink";
+
+// packages/experience-design-system-cli/src/tui/settings/agents/AgentScreens.tsx
+import { useEffect as useEffect22, useState as useState30 } from "react";
+import { Box as Box45, Text as Text47, useInput as useInput12 } from "ink";
+init_debug_store();
+
+// packages/experience-design-system-cli/src/tui/settings/shared/FieldForm.tsx
+import { useState as useState29 } from "react";
 import { Box as Box44, Text as Text46, useInput as useInput11 } from "ink";
 import TextInput4 from "ink-text-input";
+import { Fragment as Fragment17, jsx as jsx55, jsxs as jsxs45 } from "react/jsx-runtime";
+function FieldForm({
+  title,
+  subtitle,
+  fields,
+  values,
+  onChange,
+  onSave,
+  onQuit,
+  notice,
+  busy = false,
+  footer
+}) {
+  const [active, setActive] = useState29(0);
+  const [editing, setEditing] = useState29(false);
+  const [valueBeforeEdit, setValueBeforeEdit] = useState29("");
+  const labelWidth = Math.max(...fields.map((field) => field.label.length));
+  const current = fields[active];
+  useInput11((input, key) => {
+    if (busy) return;
+    if (editing) {
+      if (key.escape) {
+        onChange(current.key, valueBeforeEdit);
+        setEditing(false);
+      }
+      return;
+    }
+    if (key.escape || input === "q") {
+      onQuit();
+      return;
+    }
+    if (input === "s") {
+      onSave();
+      return;
+    }
+    if (input === "c") {
+      onChange(current.key, "");
+      return;
+    }
+    if (key.tab || key.downArrow) {
+      setActive((i) => (i + 1) % fields.length);
+      return;
+    }
+    if (key.upArrow) {
+      setActive((i) => (i - 1 + fields.length) % fields.length);
+      return;
+    }
+    if (key.return) {
+      setValueBeforeEdit(values[current.key]);
+      setEditing(true);
+    }
+  });
+  return /* @__PURE__ */ jsxs45(Box44, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx55(Text46, { bold: true, children: title }),
+    subtitle && /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: subtitle }),
+    /* @__PURE__ */ jsx55(Text46, { children: " " }),
+    /* @__PURE__ */ jsx55(Box44, { flexDirection: "column", children: fields.map((field, index) => {
+      const isActive = index === active;
+      const value = values[field.key];
+      const display = field.masked ? "\u2022".repeat(value.length) : value;
+      return /* @__PURE__ */ jsxs45(Box44, { gap: 1, children: [
+        /* @__PURE__ */ jsx55(Text46, { color: isActive ? PALETTE.accent : void 0, children: isActive ? "\u276F" : " " }),
+        /* @__PURE__ */ jsx55(Box44, { width: labelWidth, flexShrink: 0, children: /* @__PURE__ */ jsx55(Text46, { bold: isActive, color: isActive ? PALETTE.accent : PALETTE.muted, children: field.label }) }),
+        isActive && editing ? /* @__PURE__ */ jsx55(
+          TextInput4,
+          {
+            value,
+            onChange: (next) => onChange(field.key, next),
+            onSubmit: () => setEditing(false),
+            mask: field.masked ? "\u2022" : void 0
+          }
+        ) : /* @__PURE__ */ jsx55(Text46, { bold: !!display, children: display || (field.hint ? "" : /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: "(empty)" })) }),
+        field.hint && /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: field.hint })
+      ] }, field.key);
+    }) }),
+    notice && /* @__PURE__ */ jsxs45(Fragment17, { children: [
+      /* @__PURE__ */ jsx55(Text46, { children: " " }),
+      /* @__PURE__ */ jsxs45(Text46, { color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
+        notice.kind === "success" ? "\u2713" : "\u2717",
+        " ",
+        notice.text
+      ] })
+    ] }),
+    footer,
+    /* @__PURE__ */ jsx55(Text46, { children: " " }),
+    /* @__PURE__ */ jsx55(
+      ControlHints,
+      {
+        hints: editing ? [
+          { keys: "type", label: "edit" },
+          { keys: "\u2190/\u2192", label: "move cursor" },
+          { keys: "\u23CE", label: "done" },
+          { keys: "Esc", label: "cancel edit" }
+        ] : [
+          { keys: "\u2191/\u2193", label: "move" },
+          { keys: "\u23CE", label: "edit" },
+          { keys: "c", label: "clear" },
+          { keys: "s", label: "save" },
+          { keys: "Esc/q", label: "back without saving" }
+        ]
+      }
+    )
+  ] });
+}
 
 // packages/experience-design-system-cli/src/tui/settings/utils/v1-store.ts
 init_config();
 var readV1Store = readSettings2;
 var writeV1Store = writeSettings2;
 
+// packages/experience-design-system-cli/src/tui/settings/agents/agent-store.ts
+var DEFAULT_AGENT3 = "claude";
+var AGENT_LABELS = {
+  claude: "Claude Code",
+  codex: "OpenAI Codex",
+  opencode: "OpenCode",
+  cursor: "Cursor",
+  copilot: "GitHub Copilot"
+};
+var AGENT_HINTS = {
+  claude: "claude",
+  codex: "codex",
+  opencode: "opencode",
+  cursor: "cursor-agent",
+  copilot: "copilot"
+};
+var asString = (value) => typeof value === "string" ? value : "";
+function emptyAgents() {
+  return Object.fromEntries(AGENT_NAMES.map((name) => [name, { model: "" }]));
+}
+async function readAgentConfig() {
+  const store = await readV1Store();
+  const stored = asString(store["agent"]);
+  const defaultAgent = isAgentName(stored) ? stored : DEFAULT_AGENT3;
+  const agents = emptyAgents();
+  const saved = store["agents"];
+  if (saved && typeof saved === "object") {
+    for (const name of AGENT_NAMES) {
+      const entry = saved[name];
+      if (entry && typeof entry === "object")
+        agents[name] = { model: asString(entry["model"]) };
+    }
+  }
+  const legacyModel = asString(store["agentModel"]);
+  if (legacyModel && !agents[defaultAgent].model) agents[defaultAgent] = { model: legacyModel };
+  return { defaultAgent, agents };
+}
+async function writeAgentConfig(config) {
+  const existing = await readV1Store();
+  const merged = { ...existing };
+  const agents = {};
+  for (const name of AGENT_NAMES) {
+    const model = config.agents[name].model.trim();
+    if (model) agents[name] = { model };
+  }
+  merged["agent"] = config.defaultAgent;
+  const defaultModel = agents[config.defaultAgent]?.model;
+  if (defaultModel) merged["agentModel"] = defaultModel;
+  else delete merged["agentModel"];
+  if (Object.keys(agents).length > 0) merged["agents"] = agents;
+  else delete merged["agents"];
+  await writeV1Store(merged);
+}
+
+// packages/experience-design-system-cli/src/tui/settings/agents/AgentScreens.tsx
+import { Fragment as Fragment18, jsx as jsx56, jsxs as jsxs46 } from "react/jsx-runtime";
+var MODEL_FIELDS = [
+  { key: "model", label: "Model", hint: "(empty: the agent\u2019s own default)" }
+];
+var ROWS = [{ kind: "default" }, ...AGENT_NAMES.map((name) => ({ kind: "agent", name }))];
+function AgentForm({
+  name,
+  config,
+  setConfig,
+  onBack
+}) {
+  const [saving, setSaving] = useState30(false);
+  const [notice, setNotice] = useState30(null);
+  const save = () => {
+    setSaving(true);
+    setNotice(null);
+    writeAgentConfig(config).then(() => setNotice({ kind: "success", text: `${AGENT_LABELS[name]} settings saved` })).catch(
+      (err) => setNotice({ kind: "error", text: err instanceof Error ? err.message : "Failed to save" })
+    ).finally(() => setSaving(false));
+  };
+  return /* @__PURE__ */ jsx56(
+    FieldForm,
+    {
+      title: AGENT_LABELS[name],
+      subtitle: `Runs the \`${AGENT_HINTS[name]}\` command. ${config.defaultAgent === name ? "This is the default agent." : ""}`.trim(),
+      fields: MODEL_FIELDS,
+      values: { model: config.agents[name].model },
+      onChange: (_key, value) => {
+        setConfig({ ...config, agents: { ...config.agents, [name]: { model: value } } });
+        setNotice(null);
+      },
+      onSave: save,
+      onQuit: onBack,
+      notice,
+      busy: saving
+    }
+  );
+}
+function AgentsScreen({ onDone }) {
+  const [config, setConfig] = useState30(null);
+  const [focus, setFocus] = useState30(0);
+  const [open, setOpen] = useState30(null);
+  const [notice, setNotice] = useState30(null);
+  useEffect22(() => {
+    void readAgentConfig().then((loaded) => {
+      setConfig(loaded);
+      startDebugRun({
+        flow: "settings/agents",
+        step: "01-agents",
+        menuOption: "Configuration > Agents",
+        inputs: { default_agent: loaded.defaultAgent }
+      });
+    });
+  }, []);
+  const cycleDefault = (step) => {
+    if (!config) return;
+    const index = AGENT_NAMES.indexOf(config.defaultAgent);
+    const next = { ...config, defaultAgent: AGENT_NAMES[(index + step + AGENT_NAMES.length) % AGENT_NAMES.length] };
+    setConfig(next);
+    writeAgentConfig(next).then(() => setNotice({ kind: "success", text: `Default agent is now ${AGENT_LABELS[next.defaultAgent]}` })).catch(
+      (err) => setNotice({ kind: "error", text: err instanceof Error ? err.message : "Failed to save" })
+    );
+  };
+  useInput12((input, key) => {
+    if (!config || open) return;
+    const row = ROWS[focus];
+    if (key.upArrow) {
+      setFocus((i) => (i - 1 + ROWS.length) % ROWS.length);
+      return;
+    }
+    if (key.downArrow || key.tab) {
+      setFocus((i) => (i + 1) % ROWS.length);
+      return;
+    }
+    if (row.kind === "default" && key.leftArrow) {
+      cycleDefault(-1);
+      return;
+    }
+    if (row.kind === "default" && key.rightArrow) {
+      cycleDefault(1);
+      return;
+    }
+    if (key.return) {
+      if (row.kind === "default") cycleDefault(1);
+      else setOpen(row.name);
+      return;
+    }
+    if (key.escape || input === "q") {
+      void finishDebugRun({ outputs: { default_agent: config.defaultAgent }, status: "success", exitMethod: "saved" });
+      onDone();
+    }
+  });
+  if (!config) {
+    return /* @__PURE__ */ jsxs46(Box45, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+      /* @__PURE__ */ jsx56(Text47, { bold: true, children: "Agents" }),
+      /* @__PURE__ */ jsx56(Text47, { children: " " }),
+      /* @__PURE__ */ jsx56(Text47, { color: PALETTE.accent, children: "Loading..." })
+    ] });
+  }
+  if (open) {
+    return /* @__PURE__ */ jsx56(AgentForm, { name: open, config, setConfig, onBack: () => setOpen(null) });
+  }
+  return /* @__PURE__ */ jsxs46(Box45, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx56(Text47, { bold: true, children: "Agents" }),
+    /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: "The coding agent the CLI runs, and the settings for each one." }),
+    /* @__PURE__ */ jsx56(Text47, { children: " " }),
+    ROWS.map((row, index) => {
+      const isFocused = index === focus;
+      const pointer = /* @__PURE__ */ jsx56(Text47, { color: isFocused ? PALETTE.accent : void 0, children: isFocused ? "\u276F" : " " });
+      if (row.kind === "default") {
+        return /* @__PURE__ */ jsx56(Box45, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs46(Box45, { gap: 1, children: [
+          pointer,
+          /* @__PURE__ */ jsx56(Text47, { bold: isFocused, color: isFocused ? PALETTE.accent : PALETTE.muted, children: "Default agent" }),
+          /* @__PURE__ */ jsx56(Text47, { bold: true, children: `\u2039 ${AGENT_LABELS[config.defaultAgent]} \u203A` })
+        ] }) }, "default");
+      }
+      const model = config.agents[row.name].model;
+      return /* @__PURE__ */ jsxs46(Box45, { gap: 1, children: [
+        pointer,
+        /* @__PURE__ */ jsx56(Box45, { width: 16, flexShrink: 0, children: /* @__PURE__ */ jsx56(Text47, { bold: isFocused, color: isFocused ? PALETTE.accent : void 0, children: AGENT_LABELS[row.name] }) }),
+        /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: model ? `model: ${model}` : "model: default" }),
+        row.name === config.defaultAgent && /* @__PURE__ */ jsx56(Text47, { color: PALETTE.success, children: "(default)" })
+      ] }, row.name);
+    }),
+    notice && /* @__PURE__ */ jsxs46(Fragment18, { children: [
+      /* @__PURE__ */ jsx56(Text47, { children: " " }),
+      /* @__PURE__ */ jsxs46(Text47, { color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
+        notice.kind === "success" ? "\u2713" : "\u2717",
+        " ",
+        notice.text
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx56(Text47, { children: " " }),
+    /* @__PURE__ */ jsx56(
+      ControlHints,
+      {
+        hints: ROWS[focus].kind === "default" ? [
+          { keys: "\u2191/\u2193", label: "move" },
+          { keys: "\u2190/\u2192", label: "change default agent" },
+          { keys: "Esc/q", label: "back" }
+        ] : [
+          { keys: "\u2191/\u2193", label: "move" },
+          { keys: "\u23CE", label: "open" },
+          { keys: "Esc/q", label: "back" }
+        ]
+      }
+    )
+  ] });
+}
+
+// packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ProjectConfigScreen.tsx
+import { useEffect as useEffect23, useState as useState31 } from "react";
+import { Box as Box46, Text as Text48 } from "ink";
+init_debug_store();
+
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/config-store.ts
 async function readCredentials() {
   const store = await readV1Store();
@@ -28549,17 +28936,16 @@ async function writeCredentials(config) {
   await writeV1Store(merged);
 }
 
-// packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
-init_debug_store();
-import { Fragment as Fragment17, jsx as jsx55, jsxs as jsxs45 } from "react/jsx-runtime";
-var FIELD_ORDER = [
-  "spaceId",
-  "environmentId",
-  "cmaToken",
-  "host",
-  "defaultComponentDir",
-  "defaultTokenFile",
-  "contentfulBaseDir"
+// packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ProjectConfigScreen.tsx
+import { jsx as jsx57, jsxs as jsxs47 } from "react/jsx-runtime";
+var FIELDS2 = [
+  { key: "spaceId", label: "Space ID" },
+  { key: "environmentId", label: "Environment ID" },
+  { key: "cmaToken", label: "CMA Token", masked: true },
+  { key: "host", label: "API Host" },
+  { key: "defaultComponentDir", label: "Default component directory" },
+  { key: "defaultTokenFile", label: "Default token file" },
+  { key: "contentfulBaseDir", label: "Root Project Directory", hint: "(where .contentful goes)" }
 ];
 function debugFields(config) {
   return {
@@ -28572,156 +28958,114 @@ function debugFields(config) {
     contentful_base_dir: config?.contentfulBaseDir ?? ""
   };
 }
-var FIELD_LABELS = {
-  spaceId: "Space ID",
-  environmentId: "Environment ID",
-  cmaToken: "CMA Token",
-  host: "API Host",
-  defaultComponentDir: "Default component directory",
-  defaultTokenFile: "Default token file",
-  contentfulBaseDir: "Root Project Directory"
-};
-var FIELD_HINTS = {
-  contentfulBaseDir: "(where .contentful goes)"
-};
-var LABEL_WIDTH = Math.max(...Object.values(FIELD_LABELS).map((label) => label.length));
-function ConfigurationScreen({ onDone }) {
-  const [stage, setStage] = useState29("loading");
-  const [config, setConfig] = useState29(null);
-  const [activeField, setActiveField] = useState29("spaceId");
-  const [notice, setNotice] = useState29(null);
-  const [lastSaved, setLastSaved] = useState29(null);
-  const [editing, setEditing] = useState29(false);
-  const [valueBeforeEdit, setValueBeforeEdit] = useState29("");
-  useEffect22(() => {
-    readCredentials().then((cfg) => {
+var valuesOf = (config) => Object.fromEntries(FIELDS2.map(({ key }) => [key, config[key] || ""]));
+function ProjectConfigScreen({ onDone }) {
+  const [config, setConfig] = useState31(null);
+  const [saving, setSaving] = useState31(false);
+  const [notice, setNotice] = useState31(null);
+  const [lastSaved, setLastSaved] = useState31(null);
+  useEffect23(() => {
+    void readCredentials().then((cfg) => {
       setConfig(cfg);
-      setStage("form");
       startDebugRun({
         flow: "settings/contentful-configuration",
         step: "01-configuration",
-        menuOption: "Configuration",
+        menuOption: "Configuration > Project",
         inputs: debugFields(cfg)
       });
     });
   }, []);
-  function fieldValue(field) {
-    if (!config) return "";
-    return config[field] || "";
-  }
-  function setFieldValue(field, value) {
-    if (!config) return;
-    setConfig({ ...config, [field]: value });
-    setNotice(null);
+  if (!config) {
+    return /* @__PURE__ */ jsxs47(Box46, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+      /* @__PURE__ */ jsx57(Text48, { bold: true, children: "Project" }),
+      /* @__PURE__ */ jsx57(Text48, { children: " " }),
+      /* @__PURE__ */ jsx57(Text48, { color: PALETTE.accent, children: "Loading..." })
+    ] });
   }
-  function handleSave() {
-    if (!config) return;
-    setStage("saving");
+  const save = () => {
+    setSaving(true);
     setNotice(null);
     writeCredentials(config).then(() => {
       setLastSaved(config);
       if (config.contentfulBaseDir) void startDebugSessionIn(config.contentfulBaseDir, { replace: true });
-      setNotice({ kind: "success", text: "Configuration saved" });
-      setStage("form");
+      setNotice({ kind: "success", text: "Project settings saved" });
     }).catch((err) => {
       setNotice({ kind: "error", text: err instanceof Error ? err.message : "Failed to save" });
-      setStage("form");
-    });
-  }
-  function quit() {
+    }).finally(() => setSaving(false));
+  };
+  const quit = () => {
     void finishDebugRun(
       lastSaved ? { outputs: debugFields(lastSaved), status: "success", exitMethod: "saved" } : { outputs: {}, status: "success", exitMethod: "discarded" }
     );
     onDone();
-  }
-  useInput11((input, key) => {
-    if (stage === "loading" || stage === "saving") return;
-    if (editing) {
-      if (key.escape) {
-        setFieldValue(activeField, valueBeforeEdit);
-        setEditing(false);
-      }
-      return;
-    }
-    if (key.escape || input === "q") {
-      quit();
-      return;
-    }
-    if (input === "s") {
-      handleSave();
-      return;
-    }
-    if (input === "c") {
-      setFieldValue(activeField, "");
-      return;
+  };
+  return /* @__PURE__ */ jsx57(
+    FieldForm,
+    {
+      title: "Project",
+      subtitle: "The Contentful space and where the CLI keeps its files.",
+      fields: FIELDS2,
+      values: valuesOf(config),
+      onChange: (key, value) => {
+        setConfig({ ...config, [key]: value });
+        setNotice(null);
+      },
+      onSave: save,
+      onQuit: quit,
+      notice,
+      busy: saving
     }
-    if (key.tab || key.downArrow) {
-      const idx = FIELD_ORDER.indexOf(activeField);
-      setActiveField(FIELD_ORDER[(idx + 1) % FIELD_ORDER.length]);
+  );
+}
+
+// packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
+import { jsx as jsx58, jsxs as jsxs48 } from "react/jsx-runtime";
+var SECTIONS = [
+  {
+    id: "project",
+    label: "Project",
+    description: "Contentful space, credentials, defaults and where .contentful goes"
+  },
+  { id: "agents", label: "Agents", description: "Which coding agent the CLI uses, and each agent\u2019s settings" }
+];
+function ConfigurationScreen({ onDone }) {
+  const [focus, setFocus] = useState32(0);
+  const [open, setOpen] = useState32(null);
+  const close = () => setOpen(null);
+  useInput13((input, key) => {
+    if (open) return;
+    if (key.upArrow) {
+      setFocus((i) => (i - 1 + SECTIONS.length) % SECTIONS.length);
       return;
     }
-    if (key.upArrow) {
-      const idx = FIELD_ORDER.indexOf(activeField);
-      setActiveField(FIELD_ORDER[(idx - 1 + FIELD_ORDER.length) % FIELD_ORDER.length]);
+    if (key.downArrow || key.tab) {
+      setFocus((i) => (i + 1) % SECTIONS.length);
       return;
     }
     if (key.return) {
-      setValueBeforeEdit(fieldValue(activeField));
-      setEditing(true);
+      setOpen(SECTIONS[focus].id);
+      return;
     }
+    if (key.escape || input === "q") onDone();
   });
-  if (stage === "loading") {
-    return /* @__PURE__ */ jsxs45(Box44, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-      /* @__PURE__ */ jsx55(Text46, { bold: true, children: "Configuration" }),
-      /* @__PURE__ */ jsx55(Text46, { children: " " }),
-      /* @__PURE__ */ jsx55(Text46, { color: PALETTE.accent, children: "Loading..." })
-    ] });
-  }
-  return /* @__PURE__ */ jsxs45(Box44, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx55(Text46, { bold: true, children: "Configuration" }),
-    /* @__PURE__ */ jsx55(Text46, { children: " " }),
-    /* @__PURE__ */ jsx55(Box44, { flexDirection: "column", children: FIELD_ORDER.map((field) => {
-      const isActive = activeField === field;
-      const value = fieldValue(field);
-      const display = field === "cmaToken" ? "\u2022".repeat(value.length) : value;
-      return /* @__PURE__ */ jsxs45(Box44, { gap: 1, children: [
-        /* @__PURE__ */ jsx55(Text46, { color: isActive ? PALETTE.accent : void 0, children: isActive ? "\u276F" : " " }),
-        /* @__PURE__ */ jsx55(Box44, { width: LABEL_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx55(Text46, { bold: isActive, color: isActive ? PALETTE.accent : PALETTE.muted, children: FIELD_LABELS[field] }) }),
-        isActive && editing ? /* @__PURE__ */ jsx55(
-          TextInput4,
-          {
-            value,
-            onChange: (next) => setFieldValue(field, next),
-            onSubmit: () => setEditing(false),
-            mask: field === "cmaToken" ? "\u2022" : void 0
-          }
-        ) : /* @__PURE__ */ jsx55(Text46, { bold: !!display, children: display || (FIELD_HINTS[field] ? "" : /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: "(empty)" })) }),
-        FIELD_HINTS[field] && /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: FIELD_HINTS[field] })
-      ] }, field);
-    }) }),
-    notice && /* @__PURE__ */ jsxs45(Fragment17, { children: [
-      /* @__PURE__ */ jsx55(Text46, { children: " " }),
-      /* @__PURE__ */ jsxs45(Text46, { color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
-        notice.kind === "success" ? "\u2713" : "\u2717",
-        " ",
-        notice.text
-      ] })
-    ] }),
-    /* @__PURE__ */ jsx55(Text46, { children: " " }),
-    /* @__PURE__ */ jsx55(
+  if (open === "project") return /* @__PURE__ */ jsx58(ProjectConfigScreen, { onDone: close });
+  if (open === "agents") return /* @__PURE__ */ jsx58(AgentsScreen, { onDone: close });
+  return /* @__PURE__ */ jsxs48(Box47, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx58(Text49, { bold: true, children: "Configuration" }),
+    /* @__PURE__ */ jsx58(Text49, { children: " " }),
+    SECTIONS.map((section, index) => /* @__PURE__ */ jsxs48(Box47, { gap: 1, children: [
+      /* @__PURE__ */ jsx58(Text49, { color: index === focus ? PALETTE.accent : void 0, children: index === focus ? "\u276F" : " " }),
+      /* @__PURE__ */ jsx58(Box47, { width: 9, flexShrink: 0, children: /* @__PURE__ */ jsx58(Text49, { bold: index === focus, color: index === focus ? PALETTE.accent : void 0, children: section.label }) }),
+      /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: section.description })
+    ] }, section.id)),
+    /* @__PURE__ */ jsx58(Text49, { children: " " }),
+    /* @__PURE__ */ jsx58(
       ControlHints,
       {
-        hints: editing ? [
-          { keys: "type", label: "edit" },
-          { keys: "\u2190/\u2192", label: "move cursor" },
-          { keys: "\u23CE", label: "done" },
-          { keys: "Esc", label: "cancel edit" }
-        ] : [
+        hints: [
           { keys: "\u2191/\u2193", label: "move" },
-          { keys: "\u23CE", label: "edit" },
-          { keys: "c", label: "clear" },
-          { keys: "s", label: "save" },
-          { keys: "Esc/q", label: "quit without saving" }
+          { keys: "\u23CE", label: "open" },
+          { keys: "Esc/q", label: "back" }
         ]
       }
     )
@@ -28729,8 +29073,8 @@ function ConfigurationScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { useEffect as useEffect23, useState as useState30 } from "react";
-import { Box as Box45, Text as Text47, useInput as useInput12 } from "ink";
+import { useEffect as useEffect24, useState as useState33 } from "react";
+import { Box as Box48, Text as Text50, useInput as useInput14 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/analytics-store.ts
 async function readAnalyticsSetting() {
@@ -28749,11 +29093,11 @@ async function writeAnalyticsSetting(setting) {
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
 init_debug_store();
-import { Fragment as Fragment18, jsx as jsx56, jsxs as jsxs46 } from "react/jsx-runtime";
+import { Fragment as Fragment19, jsx as jsx59, jsxs as jsxs49 } from "react/jsx-runtime";
 function OptInAnalyticsScreen({ onDone }) {
-  const [loading, setLoading] = useState30(true);
-  const [enabled, setEnabled] = useState30(true);
-  useEffect23(() => {
+  const [loading, setLoading] = useState33(true);
+  const [enabled, setEnabled] = useState33(true);
+  useEffect24(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -28765,7 +29109,7 @@ function OptInAnalyticsScreen({ onDone }) {
       });
     });
   }, []);
-  useInput12((input, key) => {
+  useInput14((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -28780,21 +29124,21 @@ function OptInAnalyticsScreen({ onDone }) {
       onDone();
     }
   });
-  return /* @__PURE__ */ jsxs46(Box45, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx56(Text47, { bold: true, children: "Settings \u203A Opt-in Analytics" }),
-    /* @__PURE__ */ jsx56(Text47, { children: " " }),
-    loading ? /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs46(Fragment18, { children: [
-      /* @__PURE__ */ jsxs46(Text47, { children: [
+  return /* @__PURE__ */ jsxs49(Box48, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx59(Text50, { bold: true, children: "Settings \u203A Opt-in Analytics" }),
+    /* @__PURE__ */ jsx59(Text50, { children: " " }),
+    loading ? /* @__PURE__ */ jsx59(Text50, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs49(Fragment19, { children: [
+      /* @__PURE__ */ jsxs49(Text50, { children: [
         "Share anonymous usage data:",
         " ",
-        /* @__PURE__ */ jsx56(Text47, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
+        /* @__PURE__ */ jsx59(Text50, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
       ] }),
-      /* @__PURE__ */ jsx56(Text47, { children: " " }),
-      /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: "Shares which CLI commands are used and where imports succeed or fail." }),
-      /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: "Never includes source code, file paths, credentials, or authored content." })
+      /* @__PURE__ */ jsx59(Text50, { children: " " }),
+      /* @__PURE__ */ jsx59(Text50, { color: PALETTE.muted, children: "Shares which CLI commands are used and where imports succeed or fail." }),
+      /* @__PURE__ */ jsx59(Text50, { color: PALETTE.muted, children: "Never includes source code, file paths, credentials, or authored content." })
     ] }),
-    /* @__PURE__ */ jsx56(Text47, { children: " " }),
-    /* @__PURE__ */ jsx56(
+    /* @__PURE__ */ jsx59(Text50, { children: " " }),
+    /* @__PURE__ */ jsx59(
       ControlHints,
       {
         hints: [
@@ -28807,15 +29151,15 @@ function OptInAnalyticsScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/upgrade/PageContainer.tsx
-import { useEffect as useEffect24, useState as useState31 } from "react";
-import { Box as Box46, Text as Text48, useInput as useInput13 } from "ink";
+import { useEffect as useEffect25, useState as useState34 } from "react";
+import { Box as Box49, Text as Text51, useInput as useInput15 } from "ink";
 init_version();
 init_debug_store();
-import { jsx as jsx57, jsxs as jsxs47 } from "react/jsx-runtime";
+import { jsx as jsx60, jsxs as jsxs50 } from "react/jsx-runtime";
 var UPGRADE_COMMANDS = ["git pull", "pnpm install", "pnpm build"];
 function UpgradeScreen({ onDone }) {
-  const [upgradeCheck, setUpgradeCheck] = useState31();
-  useEffect24(() => {
+  const [upgradeCheck, setUpgradeCheck] = useState34();
+  useEffect25(() => {
     startDebugRun({
       flow: "upgrade",
       step: "01-upgrade",
@@ -28824,7 +29168,7 @@ function UpgradeScreen({ onDone }) {
     });
     checkForUpgrade().then(setUpgradeCheck).catch(() => setUpgradeCheck({ status: "error" }));
   }, []);
-  useInput13((_input, key) => {
+  useInput15((_input, key) => {
     if (key.return) {
       void finishDebugRun({
         outputs: upgradeCheck ?? {},
@@ -28835,12 +29179,12 @@ function UpgradeScreen({ onDone }) {
       return;
     }
   });
-  return /* @__PURE__ */ jsxs47(Box46, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx57(Text48, { bold: true, children: "Upgrade" }),
-    /* @__PURE__ */ jsx57(Text48, { children: " " }),
+  return /* @__PURE__ */ jsxs50(Box49, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx60(Text51, { bold: true, children: "Upgrade" }),
+    /* @__PURE__ */ jsx60(Text51, { children: " " }),
     renderBody(upgradeCheck),
-    /* @__PURE__ */ jsx57(Text48, { children: " " }),
-    /* @__PURE__ */ jsxs47(Text48, { bold: true, color: PALETTE.accent, children: [
+    /* @__PURE__ */ jsx60(Text51, { children: " " }),
+    /* @__PURE__ */ jsxs50(Text51, { bold: true, color: PALETTE.accent, children: [
       FOCUS_MARKER,
       " Go Back"
     ] })
@@ -28848,47 +29192,47 @@ function UpgradeScreen({ onDone }) {
 }
 function renderBody(upgradeCheck) {
   if (!upgradeCheck) {
-    return /* @__PURE__ */ jsx57(Text48, { color: PALETTE.muted, children: "Checking for updates\u2026" });
+    return /* @__PURE__ */ jsx60(Text51, { color: PALETTE.muted, children: "Checking for updates\u2026" });
   }
   if (upgradeCheck.status === "error") {
-    return /* @__PURE__ */ jsx57(Text48, { color: PALETTE.warning, children: "Couldn't check for updates \u2014 check your network connection and try again." });
+    return /* @__PURE__ */ jsx60(Text51, { color: PALETTE.warning, children: "Couldn't check for updates \u2014 check your network connection and try again." });
   }
   if (upgradeCheck.status === "up-to-date") {
-    return /* @__PURE__ */ jsxs47(Text48, { color: PALETTE.success, children: [
+    return /* @__PURE__ */ jsxs50(Text51, { color: PALETTE.success, children: [
       "You're already on the latest version (v",
       upgradeCheck.current,
       ")."
     ] });
   }
-  return /* @__PURE__ */ jsxs47(Box46, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs47(Text48, { color: PALETTE.muted, children: [
-      /* @__PURE__ */ jsxs47(Text48, { bold: true, color: PALETTE.success, children: [
+  return /* @__PURE__ */ jsxs50(Box49, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs50(Text51, { color: PALETTE.muted, children: [
+      /* @__PURE__ */ jsxs50(Text51, { bold: true, color: PALETTE.success, children: [
         "v",
         upgradeCheck.latest
       ] }),
       " ",
       "is available (you're on ",
-      /* @__PURE__ */ jsxs47(Text48, { bold: true, children: [
+      /* @__PURE__ */ jsxs50(Text51, { bold: true, children: [
         "v",
         upgradeCheck.current
       ] }),
       "). Exit this program, cd into the root of your local clone of contentful/experience-design-system-sdk-public, then run:"
     ] }),
-    /* @__PURE__ */ jsx57(Text48, { children: " " }),
-    /* @__PURE__ */ jsx57(Box46, { flexDirection: "column", borderStyle: "round", borderColor: PALETTE.border, paddingX: 1, children: UPGRADE_COMMANDS.map((cmd) => /* @__PURE__ */ jsx57(Text48, { bold: true, children: cmd }, cmd)) })
+    /* @__PURE__ */ jsx60(Text51, { children: " " }),
+    /* @__PURE__ */ jsx60(Box49, { flexDirection: "column", borderStyle: "round", borderColor: PALETTE.border, paddingX: 1, children: UPGRADE_COMMANDS.map((cmd) => /* @__PURE__ */ jsx60(Text51, { bold: true, children: cmd }, cmd)) })
   ] });
 }
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect25, useState as useState32 } from "react";
-import { Box as Box47, Text as Text49, useInput as useInput14 } from "ink";
+import { useEffect as useEffect26, useState as useState35 } from "react";
+import { Box as Box50, Text as Text52, useInput as useInput16 } from "ink";
 init_debug_mode_store();
 init_debug_store();
-import { jsx as jsx58, jsxs as jsxs48 } from "react/jsx-runtime";
+import { jsx as jsx61, jsxs as jsxs51 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
-  const [loading, setLoading] = useState32(true);
-  const [enabled, setEnabled] = useState32(true);
-  useEffect25(() => {
+  const [loading, setLoading] = useState35(true);
+  const [enabled, setEnabled] = useState35(true);
+  useEffect26(() => {
     readDebugModeSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -28900,7 +29244,7 @@ function DebugModeScreen({ onDone }) {
       });
     });
   }, []);
-  useInput14((input, key) => {
+  useInput16((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -28915,16 +29259,16 @@ function DebugModeScreen({ onDone }) {
       onDone();
     }
   });
-  return /* @__PURE__ */ jsxs48(Box47, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx58(Text49, { bold: true, children: "Settings \u203A Debug Mode" }),
-    /* @__PURE__ */ jsx58(Text49, { children: " " }),
-    loading ? /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs48(Text49, { children: [
+  return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx61(Text52, { bold: true, children: "Settings \u203A Debug Mode" }),
+    /* @__PURE__ */ jsx61(Text52, { children: " " }),
+    loading ? /* @__PURE__ */ jsx61(Text52, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs51(Text52, { children: [
       "Debug logging:",
       " ",
-      /* @__PURE__ */ jsx58(Text49, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
+      /* @__PURE__ */ jsx61(Text52, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
     ] }),
-    /* @__PURE__ */ jsx58(Text49, { children: " " }),
-    /* @__PURE__ */ jsx58(
+    /* @__PURE__ */ jsx61(Text52, { children: " " }),
+    /* @__PURE__ */ jsx61(
       ControlHints,
       {
         hints: [
@@ -28937,18 +29281,18 @@ function DebugModeScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/app.tsx
-import { Fragment as Fragment19, jsx as jsx59 } from "react/jsx-runtime";
+import { Fragment as Fragment20, jsx as jsx62 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
-  const [screen, setScreen] = useState33("start");
-  const [importExitCode, setImportExitCode] = useState33();
+  const [screen, setScreen] = useState36("start");
+  const [importExitCode, setImportExitCode] = useState36();
   const showImportResult = importExitCode !== void 0;
-  const [projectPath, setProjectPath] = useState33();
-  const [tokensPath, setTokensPath] = useState33();
-  const [scannedFiles, setScannedFiles] = useState33();
-  const [pendingLaunch, setPendingLaunch] = useState33();
-  const [extractionRun, setExtractionRun] = useState33();
+  const [projectPath, setProjectPath] = useState36();
+  const [tokensPath, setTokensPath] = useState36();
+  const [scannedFiles, setScannedFiles] = useState36();
+  const [pendingLaunch, setPendingLaunch] = useState36();
+  const [extractionRun, setExtractionRun] = useState36();
   const extraction = useExtraction(extractionRun?.input);
-  const [scopeRun, setScopeRun] = useState33();
+  const [scopeRun, setScopeRun] = useState36();
   const scopeFlow = useScopeGateFlow(
     scopeRun && {
       sessionId: scopeRun.extraction.sessionId,
@@ -28963,12 +29307,12 @@ function App({ importOptions, inkClear }) {
       }
     }
   );
-  const [generationInput, setGenerationInput] = useState33();
+  const [generationInput, setGenerationInput] = useState36();
   const generation = useGeneration(generationInput);
-  const [flowStart, setFlowStart] = useState33();
+  const [flowStart, setFlowStart] = useState36();
   const flow = useFlow(flowStart, { beforeStepChange: inkClear });
-  const [importDefaults, setImportDefaults] = useState33();
-  useEffect26(() => {
+  const [importDefaults, setImportDefaults] = useState36();
+  useEffect27(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -28986,7 +29330,7 @@ function App({ importOptions, inkClear }) {
     const launch = { projectPath: projectPath2, tokens, filePaths, ...importOptions };
     const state2 = await inspectTokens({
       rawTokensPath: tokens,
-      contentfulDir: join25(resolveUserPath(projectPath2), ".contentful"),
+      contentfulDir: join26(resolveUserPath(projectPath2), ".contentful"),
       cache: importOptions.cache
     });
     if (state2.kind === "cached") {
@@ -29028,12 +29372,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect26(() => {
+  useEffect27(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect26(() => {
+  useEffect27(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -29051,7 +29395,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect26(() => {
+  useEffect27(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, tokenStrategy, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -29094,9 +29438,9 @@ function App({ importOptions, inkClear }) {
   };
   switch (screen) {
     case "import":
-      if (showImportResult) return /* @__PURE__ */ jsx59(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
+      if (showImportResult) return /* @__PURE__ */ jsx62(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
       if (flow && flowStart) {
-        return /* @__PURE__ */ jsx59(
+        return /* @__PURE__ */ jsx62(
           FlowScreen,
           {
             state: flow.state,
@@ -29106,12 +29450,12 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx59(Fragment19, {});
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx62(Fragment20, {});
       if (projectPath === void 0) {
-        return /* @__PURE__ */ jsx59(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
+        return /* @__PURE__ */ jsx62(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
       }
       if (tokensPath === void 0) {
-        return /* @__PURE__ */ jsx59(
+        return /* @__PURE__ */ jsx62(
           TokenInputScreen,
           {
             initialPath: importDefaults.tokenFile,
@@ -29121,7 +29465,7 @@ function App({ importOptions, inkClear }) {
         );
       }
       if (scannedFiles === void 0) {
-        return /* @__PURE__ */ jsx59(
+        return /* @__PURE__ */ jsx62(
           PathValidationScreen,
           {
             projectPath,
@@ -29133,10 +29477,10 @@ function App({ importOptions, inkClear }) {
       }
       if (extractionRun) {
         if (extraction?.status === "done" && !extraction.result.ok) {
-          return /* @__PURE__ */ jsx59(ErrorStep, { stepName: extraction.result.step, message: extraction.result.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx62(ErrorStep, { stepName: extraction.result.step, message: extraction.result.message, onExit: leaveImport });
         }
         if (extraction?.status === "running") {
-          return /* @__PURE__ */ jsx59(
+          return /* @__PURE__ */ jsx62(
             ExtractionScreen,
             {
               progress: extraction.progress,
@@ -29145,14 +29489,14 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx59(Fragment19, {});
+        return /* @__PURE__ */ jsx62(Fragment20, {});
       }
       if (scopeRun && scopeFlow) {
         if (scopeFlow.status === "failed") {
-          return /* @__PURE__ */ jsx59(ErrorStep, { stepName: "scope gate", message: scopeFlow.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx62(ErrorStep, { stepName: "scope gate", message: scopeFlow.message, onExit: leaveImport });
         }
         if (scopeFlow.status === "deciding") {
-          return /* @__PURE__ */ jsx59(
+          return /* @__PURE__ */ jsx62(
             ScopeGateScreen,
             {
               components: scopeFlow.load.components,
@@ -29162,7 +29506,7 @@ function App({ importOptions, inkClear }) {
           );
         }
         if (generation?.status === "done" && !generation.result.ok) {
-          return /* @__PURE__ */ jsx59(ErrorStep, { stepName: generation.result.step, message: generation.result.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx62(ErrorStep, { stepName: generation.result.step, message: generation.result.message, onExit: leaveImport });
         }
         if (generation?.status === "running") {
           const hasRawTokens = scopeRun.input.rawTokensPath !== "";
@@ -29170,7 +29514,7 @@ function App({ importOptions, inkClear }) {
             hasRawTokens,
             mapTokensEligible: generation.progress.mapTokensEligible
           });
-          return /* @__PURE__ */ jsx59(
+          return /* @__PURE__ */ jsx62(
             GenerationScreen,
             {
               progress: generation.progress,
@@ -29182,10 +29526,10 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx59(Fragment19, {});
+        return /* @__PURE__ */ jsx62(Fragment20, {});
       }
       if (pendingLaunch?.cached) {
-        return /* @__PURE__ */ jsx59(
+        return /* @__PURE__ */ jsx62(
           TokenReuseScreen,
           {
             tokensPath: pendingLaunch.cached.tokensPath,
@@ -29196,7 +29540,7 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      return /* @__PURE__ */ jsx59(
+      return /* @__PURE__ */ jsx62(
         CredentialsScreen,
         {
           initial: importDefaults.credentials,
@@ -29205,19 +29549,19 @@ function App({ importOptions, inkClear }) {
         }
       );
     case "help":
-      return /* @__PURE__ */ jsx59(HelpScreen, { onDone: goToStart });
+      return /* @__PURE__ */ jsx62(HelpScreen, { onDone: goToStart });
     case "upgrade":
-      return /* @__PURE__ */ jsx59(UpgradeScreen, { onDone: goToStart });
+      return /* @__PURE__ */ jsx62(UpgradeScreen, { onDone: goToStart });
     case "settings":
-      return /* @__PURE__ */ jsx59(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
+      return /* @__PURE__ */ jsx62(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
     case "settings-configuration":
-      return /* @__PURE__ */ jsx59(ConfigurationScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx62(ConfigurationScreen, { onDone: goToSettings });
     case "settings-opt-in-analytics":
-      return /* @__PURE__ */ jsx59(OptInAnalyticsScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx62(OptInAnalyticsScreen, { onDone: goToSettings });
     case "settings-debug-mode":
-      return /* @__PURE__ */ jsx59(DebugModeScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx62(DebugModeScreen, { onDone: goToSettings });
     case "start":
-      return /* @__PURE__ */ jsx59(HomeScreen, { onNavigate: setScreen });
+      return /* @__PURE__ */ jsx62(HomeScreen, { onNavigate: setScreen });
   }
 }
 async function runApp(renderApp, importOptions) {
@@ -29225,7 +29569,7 @@ async function runApp(renderApp, importOptions) {
     instance.clear?.();
     process.stdout.write("\x1B[H\x1B[0J");
   };
-  const instance = renderApp(/* @__PURE__ */ jsx59(App, { importOptions, inkClear }));
+  const instance = renderApp(/* @__PURE__ */ jsx62(App, { importOptions, inkClear }));
   await instance.waitUntilExit();
 }
 export {