@contentful/experience-design-system-cli 2.37.1-dev-build-2582b468.0 → 2.37.1-dev-build-414ce827.0

package/dist/app.js

@@ -28565,68 +28565,44 @@ function SettingsScreen({
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/ConfigurationScreen.tsx
 import { useState as useState33 } from "react";
-import { Box as Box48, Text as Text51, useInput as useInput13 } from "ink";
+import { Box as Box48, Text as Text51, useInput as useInput14 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentsScreen.tsx
-import { useEffect as useEffect23, useState as useState31 } from "react";
+import { useEffect as useEffect23, useRef as useRef13, useState as useState31 } from "react";
 import { Box as Box46, Text as Text49, useInput as useInput12 } from "ink";
 init_debug_store();
 
-// packages/experience-design-system-cli/src/tui/settings/shared/v1-store.ts
+// packages/experience-design-system-cli/src/tui/settings/shared/debug-trail.ts
 init_config();
-var readV1Store = readSettings2;
-var writeV1Store = writeSettings2;
-
-// packages/experience-design-system-cli/src/tui/settings/configuration/agents/agent-store.ts
-var AGENT_LABELS = {
-  claude: "Claude Code",
-  codex: "OpenAI Codex",
-  opencode: "OpenCode",
-  cursor: "Cursor",
-  copilot: "GitHub Copilot"
-};
-var asString = (value) => typeof value === "string" ? value : "";
-function emptyAgents() {
-  return Object.fromEntries(AGENT_NAMES.map((name) => [name, { model: "", binary: "" }]));
+import { existsSync as existsSync10 } from "node:fs";
+function diffSnapshots(before, after) {
+  const names = [.../* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(after)])];
+  const changed_fields = names.filter((name) => before[name] !== after[name]);
+  return { changed: changed_fields.length > 0, changed_fields };
+}
+var DEFAULT_TRAIL_LIMIT = 30;
+function createTrail(limit = DEFAULT_TRAIL_LIMIT) {
+  const actions = [];
+  return {
+    record(action) {
+      actions.push(action);
+      if (actions.length > limit) actions.shift();
+    },
+    entries: () => [...actions]
+  };
 }
-async function readAgentConfig() {
-  const store = await readV1Store();
-  const stored = asString(store["agent"]);
-  const defaultChosen = isAgentName(stored);
-  const defaultAgent = defaultChosen ? stored : DEFAULT_AGENT_NAME;
-  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") {
-        const fields2 = entry;
-        agents[name] = { model: asString(fields2["model"]), binary: asString(fields2["binary"]) };
-      }
-    }
+var MIN_SECRET_LENGTH = 6;
+function scrubError(error, secrets) {
+  let message = error instanceof Error ? error.message : String(error);
+  for (const secret of secrets) {
+    if (secret.length < MIN_SECRET_LENGTH) continue;
+    for (const form of /* @__PURE__ */ new Set([secret, encodeURIComponent(secret)])) message = message.split(form).join("[redacted]");
   }
-  const legacyModel = asString(store["agentModel"]);
-  if (legacyModel && !agents[defaultAgent].model)
-    agents[defaultAgent] = { ...agents[defaultAgent], model: legacyModel };
-  return { defaultAgent, defaultChosen, agents };
+  return message;
 }
-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();
-    const binary = config.agents[name].binary.trim();
-    if (model || binary) agents[name] = { ...model ? { model } : {}, ...binary ? { binary } : {} };
-  }
-  const defaultModel = config.defaultChosen ? agents[config.defaultAgent]?.model : void 0;
-  if (config.defaultChosen) merged["agent"] = config.defaultAgent;
-  else delete merged["agent"];
-  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);
+function describeSettingsFile() {
+  const path5 = configFilePath2();
+  return { path: path5, eds_home_set: Boolean(process.env["EDS_HOME"]), exists: existsSync10(path5) };
 }
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/agent-status.ts
@@ -28832,6 +28808,94 @@ async function withBinaryEnv(name, binary, run) {
   }
 }
 
+// packages/experience-design-system-cli/src/tui/settings/configuration/agents/agent-debug.ts
+function agentSnapshot(config) {
+  const snapshot = { default_agent: config.defaultAgent };
+  for (const name of AGENT_NAMES) {
+    snapshot[`${name}.model`] = config.agents[name].model;
+    snapshot[`${name}.binary`] = config.agents[name].binary;
+  }
+  return snapshot;
+}
+function environmentFrom(checks, savedBinary, envValue) {
+  const path5 = checks.find((check) => check.step === "path");
+  const version = checks.find((check) => check.step === "version");
+  const overridden = envValue !== void 0 && envValue !== "" && envValue !== savedBinary.trim();
+  return {
+    found: path5?.ok === true,
+    resolved_path: path5?.ok ? path5.detail : "",
+    version: version?.ok ? version.detail : "",
+    env_override: overridden ? envValue : ""
+  };
+}
+async function describeAgents(config) {
+  const entries = await Promise.all(
+    AGENT_NAMES.map(async (name) => {
+      const saved = config.agents[name].binary;
+      const checks = await inspectAgent(name, saved);
+      return [name, environmentFrom(checks, saved, process.env[`EDS_AGENT_BINARY_${name.toUpperCase()}`])];
+    })
+  );
+  return Object.fromEntries(entries);
+}
+
+// packages/experience-design-system-cli/src/tui/settings/shared/v1-store.ts
+init_config();
+var readV1Store = readSettings2;
+var writeV1Store = writeSettings2;
+
+// packages/experience-design-system-cli/src/tui/settings/configuration/agents/agent-store.ts
+var AGENT_LABELS = {
+  claude: "Claude Code",
+  codex: "OpenAI Codex",
+  opencode: "OpenCode",
+  cursor: "Cursor",
+  copilot: "GitHub Copilot"
+};
+var asString = (value) => typeof value === "string" ? value : "";
+function emptyAgents() {
+  return Object.fromEntries(AGENT_NAMES.map((name) => [name, { model: "", binary: "" }]));
+}
+async function readAgentConfig() {
+  const store = await readV1Store();
+  const stored = asString(store["agent"]);
+  const defaultChosen = isAgentName(stored);
+  const defaultAgent = defaultChosen ? stored : DEFAULT_AGENT_NAME;
+  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") {
+        const fields2 = entry;
+        agents[name] = { model: asString(fields2["model"]), binary: asString(fields2["binary"]) };
+      }
+    }
+  }
+  const legacyModel = asString(store["agentModel"]);
+  if (legacyModel && !agents[defaultAgent].model)
+    agents[defaultAgent] = { ...agents[defaultAgent], model: legacyModel };
+  return { defaultAgent, defaultChosen, 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();
+    const binary = config.agents[name].binary.trim();
+    if (model || binary) agents[name] = { ...model ? { model } : {}, ...binary ? { binary } : {} };
+  }
+  const defaultModel = config.defaultChosen ? agents[config.defaultAgent]?.model : void 0;
+  if (config.defaultChosen) merged["agent"] = config.defaultAgent;
+  else delete merged["agent"];
+  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/configuration/agents/AgentDetail.tsx
 import { useEffect as useEffect22, useState as useState30 } from "react";
 import { Box as Box45, Text as Text48 } from "ink";
@@ -29033,7 +29097,8 @@ function AgentDetail({
   name,
   config,
   setConfig,
-  onBack
+  onBack,
+  record: record3
 }) {
   const settings = config.agents[name];
   const [saving, setSaving] = useState30(false);
@@ -29056,10 +29121,12 @@ function AgentDetail({
     setNotice(null);
     writeAgentConfig(config).then(() => {
       applyBinaryOverrides(config);
+      record3(`saved ${name}`);
       setNotice({ kind: "success", text: `Saved: ${AGENT_LABELS[name]} settings are written to config.json` });
-    }).catch(
-      (err) => setNotice({ kind: "error", text: `Not saved: ${err instanceof Error ? err.message : String(err)}` })
-    ).finally(() => setSaving(false));
+    }).catch((err) => {
+      record3(`saving ${name} failed`, err);
+      setNotice({ kind: "error", text: `Not saved: ${err instanceof Error ? err.message : String(err)}` });
+    }).finally(() => setSaving(false));
   };
   const runTest = () => {
     setTesting(true);
@@ -29067,12 +29134,15 @@ function AgentDetail({
     testAgent(name, settings.binary, settings.model).then((result) => {
       setChecks(result);
       const outcome = testOutcome(result);
+      if (!outcome || !outcome.ok)
+        record3(`test of ${name} failed: ${outcome?.text ?? "the agent could not be started"}`);
       setNotice(
         outcome ? { kind: outcome.ok ? "success" : "error", text: outcome.text } : { kind: "error", text: "Test not run: the agent could not be started (see Status)" }
       );
-    }).catch(
-      (err) => setNotice({ kind: "error", text: `Test could not run: ${err instanceof Error ? err.message : String(err)}` })
-    ).finally(() => setTesting(false));
+    }).catch((err) => {
+      record3(`test of ${name} could not run`, err);
+      setNotice({ kind: "error", text: `Test could not run: ${err instanceof Error ? err.message : String(err)}` });
+    }).finally(() => setTesting(false));
   };
   const action = {
     label: "Run test",
@@ -29093,6 +29163,7 @@ function AgentDetail({
       onChange: (key, value) => {
         setConfig({ ...config, agents: { ...config.agents, [name]: { ...settings, [key]: value } } });
         setNotice(null);
+        record3(`edited ${name}.${key}`);
       },
       onSave: save,
       onQuit: onBack,
@@ -29119,6 +29190,12 @@ function AgentsScreen({ onDone }) {
   const [saving, setSaving] = useState31(false);
   const [loadError, setLoadError] = useState31(null);
   const [checks, setChecks] = useState31({});
+  const visit = useRef13({
+    trail: createTrail(),
+    before: void 0,
+    environment: void 0,
+    error: ""
+  }).current;
   const inspectAll = (loaded) => {
     for (const name of AGENT_NAMES) {
       void inspectAgent(name, loaded.agents[name].binary).then(
@@ -29130,14 +29207,38 @@ function AgentsScreen({ onDone }) {
     readAgentConfig().then((loaded) => {
       setConfig(loaded);
       inspectAll(loaded);
+      visit.before = agentSnapshot(loaded);
       startDebugRun({
         flow: "settings/agents",
         step: "01-agents",
         menuOption: "Configuration > Agents",
-        inputs: { default_agent: loaded.defaultAgent }
+        inputs: { ...visit.before, default_chosen: loaded.defaultChosen ?? false }
       });
-    }).catch((err) => setLoadError(err instanceof Error ? err.message : String(err)));
+      void describeAgents(loaded).then((found) => {
+        visit.environment = found;
+      });
+    }).catch((err) => {
+      visit.error = scrubError(err, []);
+      startDebugRun({ flow: "settings/agents", step: "01-agents", menuOption: "Configuration > Agents", inputs: {} });
+      setLoadError(visit.error);
+    });
   }, []);
+  const endVisit = (current) => {
+    const after = current ? agentSnapshot(current) : void 0;
+    const change = visit.before && after ? diffSnapshots(visit.before, after) : { changed: false, changed_fields: [] };
+    void finishDebugRun({
+      outputs: {
+        ...after ?? {},
+        ...change,
+        actions: visit.trail.entries(),
+        // Missing only when the user left before the probes finished.
+        ...visit.environment ? { agents: visit.environment } : {},
+        ...visit.error ? { error: visit.error } : {}
+      },
+      status: visit.error ? "error" : "success",
+      exitMethod: change.changed ? "saved" : "discarded"
+    });
+  };
   const makeDefault = (name) => {
     if (!config || saving) return;
     if (name === config.defaultAgent) {
@@ -29149,15 +29250,16 @@ function AgentsScreen({ onDone }) {
     writeAgentConfig({ ...config, defaultAgent: name, defaultChosen: true }).then(() => {
       setConfig((current) => current ? { ...current, defaultAgent: name, defaultChosen: true } : current);
       setNotice({ kind: "success", text: `Default agent is now ${AGENT_LABELS[name]}` });
-    }).catch(
-      (err) => setNotice({
-        kind: "error",
-        text: `Default agent not changed: ${err instanceof Error ? err.message : String(err)}`
-      })
-    ).finally(() => setSaving(false));
+      visit.trail.record(`made ${name} the default`);
+    }).catch((err) => {
+      visit.error = scrubError(err, []);
+      visit.trail.record(`making ${name} the default failed`);
+      setNotice({ kind: "error", text: `Default agent not changed: ${visit.error}` });
+    }).finally(() => setSaving(false));
   };
   useInput12((input, key) => {
     if (loadError && (key.escape || input === "q")) {
+      endVisit(null);
       onDone();
       return;
     }
@@ -29182,7 +29284,7 @@ function AgentsScreen({ onDone }) {
       return;
     }
     if (key.escape || input === "q") {
-      void finishDebugRun({ outputs: { default_agent: config.defaultAgent }, status: "success", exitMethod: "saved" });
+      endVisit(config);
       onDone();
     }
   });
@@ -29207,6 +29309,10 @@ function AgentsScreen({ onDone }) {
         name: open,
         config,
         setConfig,
+        record: (action, error) => {
+          visit.trail.record(action);
+          if (error !== void 0) visit.error = scrubError(error, []);
+        },
         onBack: () => {
           setOpen(null);
           void readAgentConfig().then((saved) => {
@@ -29273,8 +29379,8 @@ function AgentsScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/project/ProjectScreen.tsx
-import { useEffect as useEffect24, useState as useState32 } from "react";
-import { Box as Box47, Text as Text50 } from "ink";
+import { useEffect as useEffect24, useRef as useRef14, useState as useState32 } from "react";
+import { Box as Box47, Text as Text50, useInput as useInput13 } from "ink";
 init_debug_store();
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/project/project-store.ts
@@ -29303,7 +29409,7 @@ async function writeCredentials(config) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/project/ProjectScreen.tsx
-import { jsx as jsx59, jsxs as jsxs48 } from "react/jsx-runtime";
+import { Fragment as Fragment19, jsx as jsx59, jsxs as jsxs48 } from "react/jsx-runtime";
 var FIELDS2 = [
   { key: "spaceId", label: "Space ID" },
   { key: "environmentId", label: "Environment ID" },
@@ -29324,45 +29430,94 @@ function debugFields(config) {
     contentful_base_dir: config?.contentfulBaseDir ?? ""
   };
 }
+var snapshotOf = (config) => Object.fromEntries(FIELDS2.map(({ key }) => [key, config[key] || ""]));
 var valuesOf = (config) => Object.fromEntries(FIELDS2.map(({ key }) => [key, config[key] || ""]));
 function ProjectScreen({ onDone }) {
   const [config, setConfig] = useState32(null);
   const [saving, setSaving] = useState32(false);
   const [notice, setNotice] = useState32(null);
-  const [lastSaved, setLastSaved] = useState32(null);
+  const [loadError, setLoadError] = useState32(null);
+  const visit = useRef14({
+    trail: createTrail(),
+    before: void 0,
+    persisted: void 0,
+    error: ""
+  }).current;
+  const scrub = (err) => scrubError(err, [config?.cmaToken ?? ""]);
   useEffect24(() => {
-    void readCredentials().then((cfg) => {
+    readCredentials().then((cfg) => {
       setConfig(cfg);
+      visit.before = snapshotOf(cfg);
+      visit.persisted = visit.before;
+      startDebugRun({
+        flow: "settings/contentful-configuration",
+        step: "01-configuration",
+        menuOption: "Configuration > Project",
+        inputs: { ...debugFields(cfg), settings_file: describeSettingsFile() }
+      });
+    }).catch((err) => {
+      visit.error = scrubError(err, []);
       startDebugRun({
         flow: "settings/contentful-configuration",
         step: "01-configuration",
         menuOption: "Configuration > Project",
-        inputs: debugFields(cfg)
+        inputs: { settings_file: describeSettingsFile() }
       });
+      setLoadError(visit.error);
     });
   }, []);
+  const endVisit = (current) => {
+    const onScreen = current ? snapshotOf(current) : void 0;
+    const change = visit.before && visit.persisted ? diffSnapshots(visit.before, visit.persisted) : { changed: false, changed_fields: [] };
+    const unsaved = visit.persisted && onScreen ? diffSnapshots(visit.persisted, onScreen) : { changed: false, changed_fields: [] };
+    void finishDebugRun({
+      outputs: {
+        ...debugFields(current),
+        ...change,
+        unsaved_edits: unsaved.changed_fields,
+        actions: visit.trail.entries(),
+        ...visit.error ? { error: visit.error } : {}
+      },
+      status: visit.error ? "error" : "success",
+      exitMethod: change.changed ? "saved" : "discarded"
+    });
+  };
+  useInput13((input, key) => {
+    if (!config && loadError && (key.escape || input === "q")) {
+      endVisit(null);
+      onDone();
+    }
+  });
   if (!config) {
     return /* @__PURE__ */ jsxs48(Box47, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
       /* @__PURE__ */ jsx59(Text50, { bold: true, children: "Project" }),
       /* @__PURE__ */ jsx59(Text50, { children: " " }),
-      /* @__PURE__ */ jsx59(Text50, { color: PALETTE.accent, children: "Loading..." })
+      loadError ? /* @__PURE__ */ jsxs48(Fragment19, { children: [
+        /* @__PURE__ */ jsxs48(Text50, { color: PALETTE.error, children: [
+          "\u2717 Could not read the settings: ",
+          loadError
+        ] }),
+        /* @__PURE__ */ jsx59(Text50, { children: " " }),
+        /* @__PURE__ */ jsx59(ControlHints, { hints: [{ keys: "Esc/q", label: "back" }] })
+      ] }) : /* @__PURE__ */ jsx59(Text50, { color: PALETTE.accent, children: "Loading..." })
     ] });
   }
   const save = () => {
     setSaving(true);
     setNotice(null);
     writeCredentials(config).then(() => {
-      setLastSaved(config);
+      visit.persisted = snapshotOf(config);
+      visit.trail.record("saved");
       if (config.contentfulBaseDir) void startDebugSessionIn(config.contentfulBaseDir, { replace: true });
       setNotice({ kind: "success", text: "Project settings saved" });
     }).catch((err) => {
+      visit.error = scrub(err);
+      visit.trail.record("save failed");
       setNotice({ kind: "error", text: err instanceof Error ? err.message : "Failed to save" });
     }).finally(() => setSaving(false));
   };
   const quit = () => {
-    void finishDebugRun(
-      lastSaved ? { outputs: debugFields(lastSaved), status: "success", exitMethod: "saved" } : { outputs: {}, status: "success", exitMethod: "discarded" }
-    );
+    endVisit(config);
     onDone();
   };
   return /* @__PURE__ */ jsx59(
@@ -29375,6 +29530,7 @@ function ProjectScreen({ onDone }) {
       onChange: (key, value) => {
         setConfig({ ...config, [key]: value });
         setNotice(null);
+        visit.trail.record(`edited ${key}`);
       },
       onSave: save,
       onQuit: quit,
@@ -29398,7 +29554,7 @@ function ConfigurationScreen({ onDone }) {
   const [focus, setFocus] = useState33(0);
   const [open, setOpen] = useState33(null);
   const close = () => setOpen(null);
-  useInput13((input, key) => {
+  useInput14((input, key) => {
     if (open) return;
     if (key.upArrow) {
       setFocus((i) => (i - 1 + SECTIONS.length) % SECTIONS.length);
@@ -29440,7 +29596,7 @@ function ConfigurationScreen({ onDone }) {
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
 import { useEffect as useEffect25, useState as useState34 } from "react";
-import { Box as Box49, Text as Text52, useInput as useInput14 } from "ink";
+import { Box as Box49, Text as Text52, useInput as useInput15 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/analytics-store.ts
 async function readAnalyticsSetting() {
@@ -29459,7 +29615,7 @@ async function writeAnalyticsSetting(setting) {
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
 init_debug_store();
-import { Fragment as Fragment19, jsx as jsx61, jsxs as jsxs50 } from "react/jsx-runtime";
+import { Fragment as Fragment20, jsx as jsx61, jsxs as jsxs50 } from "react/jsx-runtime";
 function OptInAnalyticsScreen({ onDone }) {
   const [loading, setLoading] = useState34(true);
   const [enabled, setEnabled] = useState34(true);
@@ -29475,7 +29631,7 @@ function OptInAnalyticsScreen({ onDone }) {
       });
     });
   }, []);
-  useInput14((input, key) => {
+  useInput15((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -29493,7 +29649,7 @@ function OptInAnalyticsScreen({ onDone }) {
   return /* @__PURE__ */ jsxs50(Box49, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
     /* @__PURE__ */ jsx61(Text52, { bold: true, children: "Settings \u203A Opt-in Analytics" }),
     /* @__PURE__ */ jsx61(Text52, { children: " " }),
-    loading ? /* @__PURE__ */ jsx61(Text52, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs50(Fragment19, { children: [
+    loading ? /* @__PURE__ */ jsx61(Text52, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs50(Fragment20, { children: [
       /* @__PURE__ */ jsxs50(Text52, { children: [
         "Share anonymous usage data:",
         " ",
@@ -29518,7 +29674,7 @@ function OptInAnalyticsScreen({ onDone }) {
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
 import { useEffect as useEffect26, useState as useState35 } from "react";
-import { Box as Box50, Text as Text53, useInput as useInput15 } from "ink";
+import { Box as Box50, Text as Text53, useInput as useInput16 } from "ink";
 init_debug_mode_store();
 init_debug_store();
 import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
@@ -29537,7 +29693,7 @@ function DebugModeScreen({ onDone }) {
       });
     });
   }, []);
-  useInput15((input, key) => {
+  useInput16((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -29574,7 +29730,7 @@ function DebugModeScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/app.tsx
-import { Fragment as Fragment20, jsx as jsx63 } from "react/jsx-runtime";
+import { Fragment as Fragment21, jsx as jsx63 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
   const [screen, setScreen] = useState36("start");
   const [importExitCode, setImportExitCode] = useState36();
@@ -29743,7 +29899,7 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment20, {});
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment21, {});
       if (projectPath === void 0) {
         return /* @__PURE__ */ jsx63(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
       }
@@ -29782,7 +29938,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment20, {});
+        return /* @__PURE__ */ jsx63(Fragment21, {});
       }
       if (scopeRun && scopeFlow) {
         if (scopeFlow.status === "failed") {
@@ -29819,7 +29975,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment20, {});
+        return /* @__PURE__ */ jsx63(Fragment21, {});
       }
       if (pendingLaunch?.cached) {
         return /* @__PURE__ */ jsx63(

package/dist/index.js

@@ -33084,6 +33084,45 @@ var init_PageContainer3 = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/settings/shared/debug-trail.ts
+import { existsSync as existsSync11 } from "node:fs";
+function diffSnapshots(before, after) {
+  const names = [.../* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(after)])];
+  const changed_fields = names.filter((name) => before[name] !== after[name]);
+  return { changed: changed_fields.length > 0, changed_fields };
+}
+function createTrail(limit = DEFAULT_TRAIL_LIMIT) {
+  const actions = [];
+  return {
+    record(action) {
+      actions.push(action);
+      if (actions.length > limit) actions.shift();
+    },
+    entries: () => [...actions]
+  };
+}
+function scrubError(error, secrets) {
+  let message = error instanceof Error ? error.message : String(error);
+  for (const secret of secrets) {
+    if (secret.length < MIN_SECRET_LENGTH) continue;
+    for (const form of /* @__PURE__ */ new Set([secret, encodeURIComponent(secret)])) message = message.split(form).join("[redacted]");
+  }
+  return message;
+}
+function describeSettingsFile() {
+  const path5 = configFilePath2();
+  return { path: path5, eds_home_set: Boolean(process.env["EDS_HOME"]), exists: existsSync11(path5) };
+}
+var DEFAULT_TRAIL_LIMIT, MIN_SECRET_LENGTH;
+var init_debug_trail = __esm({
+  "packages/experience-design-system-cli/src/tui/settings/shared/debug-trail.ts"() {
+    "use strict";
+    init_config();
+    DEFAULT_TRAIL_LIMIT = 30;
+    MIN_SECRET_LENGTH = 6;
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/agent-status.ts
 import { execFile as execFile2 } from "node:child_process";
 import { access as access6, constants } from "node:fs/promises";
@@ -33294,6 +33333,44 @@ var init_agent_status = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/settings/configuration/agents/agent-debug.ts
+function agentSnapshot(config) {
+  const snapshot = { default_agent: config.defaultAgent };
+  for (const name of AGENT_NAMES) {
+    snapshot[`${name}.model`] = config.agents[name].model;
+    snapshot[`${name}.binary`] = config.agents[name].binary;
+  }
+  return snapshot;
+}
+function environmentFrom(checks, savedBinary, envValue) {
+  const path5 = checks.find((check) => check.step === "path");
+  const version = checks.find((check) => check.step === "version");
+  const overridden = envValue !== void 0 && envValue !== "" && envValue !== savedBinary.trim();
+  return {
+    found: path5?.ok === true,
+    resolved_path: path5?.ok ? path5.detail : "",
+    version: version?.ok ? version.detail : "",
+    env_override: overridden ? envValue : ""
+  };
+}
+async function describeAgents(config) {
+  const entries = await Promise.all(
+    AGENT_NAMES.map(async (name) => {
+      const saved = config.agents[name].binary;
+      const checks = await inspectAgent(name, saved);
+      return [name, environmentFrom(checks, saved, process.env[`EDS_AGENT_BINARY_${name.toUpperCase()}`])];
+    })
+  );
+  return Object.fromEntries(entries);
+}
+var init_agent_debug = __esm({
+  "packages/experience-design-system-cli/src/tui/settings/configuration/agents/agent-debug.ts"() {
+    "use strict";
+    init_src4();
+    init_agent_status();
+  }
+});
+
 // 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";
@@ -33485,7 +33562,8 @@ function AgentDetail({
   name,
   config,
   setConfig,
-  onBack
+  onBack,
+  record: record3
 }) {
   const settings = config.agents[name];
   const [saving, setSaving] = useState30(false);
@@ -33508,10 +33586,12 @@ function AgentDetail({
     setNotice(null);
     writeAgentConfig(config).then(() => {
       applyBinaryOverrides(config);
+      record3(`saved ${name}`);
       setNotice({ kind: "success", text: `Saved: ${AGENT_LABELS[name]} settings are written to config.json` });
-    }).catch(
-      (err) => setNotice({ kind: "error", text: `Not saved: ${err instanceof Error ? err.message : String(err)}` })
-    ).finally(() => setSaving(false));
+    }).catch((err) => {
+      record3(`saving ${name} failed`, err);
+      setNotice({ kind: "error", text: `Not saved: ${err instanceof Error ? err.message : String(err)}` });
+    }).finally(() => setSaving(false));
   };
   const runTest = () => {
     setTesting(true);
@@ -33519,12 +33599,15 @@ function AgentDetail({
     testAgent(name, settings.binary, settings.model).then((result) => {
       setChecks(result);
       const outcome = testOutcome(result);
+      if (!outcome || !outcome.ok)
+        record3(`test of ${name} failed: ${outcome?.text ?? "the agent could not be started"}`);
       setNotice(
         outcome ? { kind: outcome.ok ? "success" : "error", text: outcome.text } : { kind: "error", text: "Test not run: the agent could not be started (see Status)" }
       );
-    }).catch(
-      (err) => setNotice({ kind: "error", text: `Test could not run: ${err instanceof Error ? err.message : String(err)}` })
-    ).finally(() => setTesting(false));
+    }).catch((err) => {
+      record3(`test of ${name} could not run`, err);
+      setNotice({ kind: "error", text: `Test could not run: ${err instanceof Error ? err.message : String(err)}` });
+    }).finally(() => setTesting(false));
   };
   const action = {
     label: "Run test",
@@ -33545,6 +33628,7 @@ function AgentDetail({
       onChange: (key, value) => {
         setConfig({ ...config, agents: { ...config.agents, [name]: { ...settings, [key]: value } } });
         setNotice(null);
+        record3(`edited ${name}.${key}`);
       },
       onSave: save,
       onQuit: onBack,
@@ -33578,7 +33662,7 @@ var init_AgentDetail = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentsScreen.tsx
-import { useEffect as useEffect23, useState as useState31 } from "react";
+import { useEffect as useEffect23, useRef as useRef13, useState as useState31 } from "react";
 import { Box as Box46, Text as Text49, useInput as useInput12 } from "ink";
 import { Fragment as Fragment18, jsx as jsx58, jsxs as jsxs47 } from "react/jsx-runtime";
 function AgentsScreen({ onDone }) {
@@ -33589,6 +33673,12 @@ function AgentsScreen({ onDone }) {
   const [saving, setSaving] = useState31(false);
   const [loadError, setLoadError] = useState31(null);
   const [checks, setChecks] = useState31({});
+  const visit = useRef13({
+    trail: createTrail(),
+    before: void 0,
+    environment: void 0,
+    error: ""
+  }).current;
   const inspectAll = (loaded) => {
     for (const name of AGENT_NAMES) {
       void inspectAgent(name, loaded.agents[name].binary).then(
@@ -33600,14 +33690,38 @@ function AgentsScreen({ onDone }) {
     readAgentConfig().then((loaded) => {
       setConfig(loaded);
       inspectAll(loaded);
+      visit.before = agentSnapshot(loaded);
       startDebugRun({
         flow: "settings/agents",
         step: "01-agents",
         menuOption: "Configuration > Agents",
-        inputs: { default_agent: loaded.defaultAgent }
+        inputs: { ...visit.before, default_chosen: loaded.defaultChosen ?? false }
+      });
+      void describeAgents(loaded).then((found) => {
+        visit.environment = found;
       });
-    }).catch((err) => setLoadError(err instanceof Error ? err.message : String(err)));
+    }).catch((err) => {
+      visit.error = scrubError(err, []);
+      startDebugRun({ flow: "settings/agents", step: "01-agents", menuOption: "Configuration > Agents", inputs: {} });
+      setLoadError(visit.error);
+    });
   }, []);
+  const endVisit = (current) => {
+    const after = current ? agentSnapshot(current) : void 0;
+    const change = visit.before && after ? diffSnapshots(visit.before, after) : { changed: false, changed_fields: [] };
+    void finishDebugRun({
+      outputs: {
+        ...after ?? {},
+        ...change,
+        actions: visit.trail.entries(),
+        // Missing only when the user left before the probes finished.
+        ...visit.environment ? { agents: visit.environment } : {},
+        ...visit.error ? { error: visit.error } : {}
+      },
+      status: visit.error ? "error" : "success",
+      exitMethod: change.changed ? "saved" : "discarded"
+    });
+  };
   const makeDefault = (name) => {
     if (!config || saving) return;
     if (name === config.defaultAgent) {
@@ -33619,15 +33733,16 @@ function AgentsScreen({ onDone }) {
     writeAgentConfig({ ...config, defaultAgent: name, defaultChosen: true }).then(() => {
       setConfig((current) => current ? { ...current, defaultAgent: name, defaultChosen: true } : current);
       setNotice({ kind: "success", text: `Default agent is now ${AGENT_LABELS[name]}` });
-    }).catch(
-      (err) => setNotice({
-        kind: "error",
-        text: `Default agent not changed: ${err instanceof Error ? err.message : String(err)}`
-      })
-    ).finally(() => setSaving(false));
+      visit.trail.record(`made ${name} the default`);
+    }).catch((err) => {
+      visit.error = scrubError(err, []);
+      visit.trail.record(`making ${name} the default failed`);
+      setNotice({ kind: "error", text: `Default agent not changed: ${visit.error}` });
+    }).finally(() => setSaving(false));
   };
   useInput12((input, key) => {
     if (loadError && (key.escape || input === "q")) {
+      endVisit(null);
       onDone();
       return;
     }
@@ -33652,7 +33767,7 @@ function AgentsScreen({ onDone }) {
       return;
     }
     if (key.escape || input === "q") {
-      void finishDebugRun({ outputs: { default_agent: config.defaultAgent }, status: "success", exitMethod: "saved" });
+      endVisit(config);
       onDone();
     }
   });
@@ -33677,6 +33792,10 @@ function AgentsScreen({ onDone }) {
         name: open,
         config,
         setConfig,
+        record: (action, error) => {
+          visit.trail.record(action);
+          if (error !== void 0) visit.error = scrubError(error, []);
+        },
         onBack: () => {
           setOpen(null);
           void readAgentConfig().then((saved) => {
@@ -33749,6 +33868,8 @@ var init_AgentsScreen = __esm({
     init_theme();
     init_control_hints();
     init_debug_store();
+    init_debug_trail();
+    init_agent_debug();
     init_agent_store();
     init_agent_status();
     init_AgentDetail();
@@ -33790,9 +33911,9 @@ var init_project_store = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/project/ProjectScreen.tsx
-import { useEffect as useEffect24, useState as useState32 } from "react";
-import { Box as Box47, Text as Text50 } from "ink";
-import { jsx as jsx59, jsxs as jsxs48 } from "react/jsx-runtime";
+import { useEffect as useEffect24, useRef as useRef14, useState as useState32 } from "react";
+import { Box as Box47, Text as Text50, useInput as useInput13 } from "ink";
+import { Fragment as Fragment19, jsx as jsx59, jsxs as jsxs48 } from "react/jsx-runtime";
 function debugFields(config) {
   return {
     space_id: config?.spaceId ?? "",
@@ -33808,40 +33929,88 @@ function ProjectScreen({ onDone }) {
   const [config, setConfig] = useState32(null);
   const [saving, setSaving] = useState32(false);
   const [notice, setNotice] = useState32(null);
-  const [lastSaved, setLastSaved] = useState32(null);
+  const [loadError, setLoadError] = useState32(null);
+  const visit = useRef14({
+    trail: createTrail(),
+    before: void 0,
+    persisted: void 0,
+    error: ""
+  }).current;
+  const scrub = (err) => scrubError(err, [config?.cmaToken ?? ""]);
   useEffect24(() => {
-    void readCredentials().then((cfg) => {
+    readCredentials().then((cfg) => {
       setConfig(cfg);
+      visit.before = snapshotOf(cfg);
+      visit.persisted = visit.before;
       startDebugRun({
         flow: "settings/contentful-configuration",
         step: "01-configuration",
         menuOption: "Configuration > Project",
-        inputs: debugFields(cfg)
+        inputs: { ...debugFields(cfg), settings_file: describeSettingsFile() }
       });
+    }).catch((err) => {
+      visit.error = scrubError(err, []);
+      startDebugRun({
+        flow: "settings/contentful-configuration",
+        step: "01-configuration",
+        menuOption: "Configuration > Project",
+        inputs: { settings_file: describeSettingsFile() }
+      });
+      setLoadError(visit.error);
     });
   }, []);
+  const endVisit = (current) => {
+    const onScreen = current ? snapshotOf(current) : void 0;
+    const change = visit.before && visit.persisted ? diffSnapshots(visit.before, visit.persisted) : { changed: false, changed_fields: [] };
+    const unsaved = visit.persisted && onScreen ? diffSnapshots(visit.persisted, onScreen) : { changed: false, changed_fields: [] };
+    void finishDebugRun({
+      outputs: {
+        ...debugFields(current),
+        ...change,
+        unsaved_edits: unsaved.changed_fields,
+        actions: visit.trail.entries(),
+        ...visit.error ? { error: visit.error } : {}
+      },
+      status: visit.error ? "error" : "success",
+      exitMethod: change.changed ? "saved" : "discarded"
+    });
+  };
+  useInput13((input, key) => {
+    if (!config && loadError && (key.escape || input === "q")) {
+      endVisit(null);
+      onDone();
+    }
+  });
   if (!config) {
     return /* @__PURE__ */ jsxs48(Box47, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
       /* @__PURE__ */ jsx59(Text50, { bold: true, children: "Project" }),
       /* @__PURE__ */ jsx59(Text50, { children: " " }),
-      /* @__PURE__ */ jsx59(Text50, { color: PALETTE.accent, children: "Loading..." })
+      loadError ? /* @__PURE__ */ jsxs48(Fragment19, { children: [
+        /* @__PURE__ */ jsxs48(Text50, { color: PALETTE.error, children: [
+          "\u2717 Could not read the settings: ",
+          loadError
+        ] }),
+        /* @__PURE__ */ jsx59(Text50, { children: " " }),
+        /* @__PURE__ */ jsx59(ControlHints, { hints: [{ keys: "Esc/q", label: "back" }] })
+      ] }) : /* @__PURE__ */ jsx59(Text50, { color: PALETTE.accent, children: "Loading..." })
     ] });
   }
   const save = () => {
     setSaving(true);
     setNotice(null);
     writeCredentials(config).then(() => {
-      setLastSaved(config);
+      visit.persisted = snapshotOf(config);
+      visit.trail.record("saved");
       if (config.contentfulBaseDir) void startDebugSessionIn(config.contentfulBaseDir, { replace: true });
       setNotice({ kind: "success", text: "Project settings saved" });
     }).catch((err) => {
+      visit.error = scrub(err);
+      visit.trail.record("save failed");
       setNotice({ kind: "error", text: err instanceof Error ? err.message : "Failed to save" });
     }).finally(() => setSaving(false));
   };
   const quit = () => {
-    void finishDebugRun(
-      lastSaved ? { outputs: debugFields(lastSaved), status: "success", exitMethod: "saved" } : { outputs: {}, status: "success", exitMethod: "discarded" }
-    );
+    endVisit(config);
     onDone();
   };
   return /* @__PURE__ */ jsx59(
@@ -33854,6 +34023,7 @@ function ProjectScreen({ onDone }) {
       onChange: (key, value) => {
         setConfig({ ...config, [key]: value });
         setNotice(null);
+        visit.trail.record(`edited ${key}`);
       },
       onSave: save,
       onQuit: quit,
@@ -33862,12 +34032,14 @@ function ProjectScreen({ onDone }) {
     }
   );
 }
-var FIELDS2, valuesOf;
+var FIELDS2, snapshotOf, valuesOf;
 var init_ProjectScreen = __esm({
   "packages/experience-design-system-cli/src/tui/settings/configuration/project/ProjectScreen.tsx"() {
     "use strict";
     init_theme();
+    init_control_hints();
     init_debug_store();
+    init_debug_trail();
     init_FieldForm();
     init_project_store();
     FIELDS2 = [
@@ -33879,19 +34051,20 @@ var init_ProjectScreen = __esm({
       { key: "defaultTokenFile", label: "Default token file" },
       { key: "contentfulBaseDir", label: "Root Project Directory", hint: "(where .contentful goes)" }
     ];
+    snapshotOf = (config) => Object.fromEntries(FIELDS2.map(({ key }) => [key, config[key] || ""]));
     valuesOf = (config) => Object.fromEntries(FIELDS2.map(({ key }) => [key, config[key] || ""]));
   }
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/ConfigurationScreen.tsx
 import { useState as useState33 } from "react";
-import { Box as Box48, Text as Text51, useInput as useInput13 } from "ink";
+import { Box as Box48, Text as Text51, useInput as useInput14 } from "ink";
 import { jsx as jsx60, jsxs as jsxs49 } from "react/jsx-runtime";
 function ConfigurationScreen({ onDone }) {
   const [focus, setFocus] = useState33(0);
   const [open, setOpen] = useState33(null);
   const close = () => setOpen(null);
-  useInput13((input, key) => {
+  useInput14((input, key) => {
     if (open) return;
     if (key.upArrow) {
       setFocus((i) => (i - 1 + SECTIONS.length) % SECTIONS.length);
@@ -33951,8 +34124,8 @@ var init_ConfigurationScreen = __esm({
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
 import { useEffect as useEffect25, useState as useState34 } from "react";
-import { Box as Box49, Text as Text52, useInput as useInput14 } from "ink";
-import { Fragment as Fragment19, jsx as jsx61, jsxs as jsxs50 } from "react/jsx-runtime";
+import { Box as Box49, Text as Text52, useInput as useInput15 } from "ink";
+import { Fragment as Fragment20, jsx as jsx61, jsxs as jsxs50 } from "react/jsx-runtime";
 function OptInAnalyticsScreen({ onDone }) {
   const [loading, setLoading] = useState34(true);
   const [enabled, setEnabled] = useState34(true);
@@ -33968,7 +34141,7 @@ function OptInAnalyticsScreen({ onDone }) {
       });
     });
   }, []);
-  useInput14((input, key) => {
+  useInput15((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -33986,7 +34159,7 @@ function OptInAnalyticsScreen({ onDone }) {
   return /* @__PURE__ */ jsxs50(Box49, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
     /* @__PURE__ */ jsx61(Text52, { bold: true, children: "Settings \u203A Opt-in Analytics" }),
     /* @__PURE__ */ jsx61(Text52, { children: " " }),
-    loading ? /* @__PURE__ */ jsx61(Text52, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs50(Fragment19, { children: [
+    loading ? /* @__PURE__ */ jsx61(Text52, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs50(Fragment20, { children: [
       /* @__PURE__ */ jsxs50(Text52, { children: [
         "Share anonymous usage data:",
         " ",
@@ -34020,7 +34193,7 @@ var init_screen11 = __esm({
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
 import { useEffect as useEffect26, useState as useState35 } from "react";
-import { Box as Box50, Text as Text53, useInput as useInput15 } from "ink";
+import { Box as Box50, Text as Text53, useInput as useInput16 } from "ink";
 import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
   const [loading, setLoading] = useState35(true);
@@ -34037,7 +34210,7 @@ function DebugModeScreen({ onDone }) {
       });
     });
   }, []);
-  useInput15((input, key) => {
+  useInput16((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -34089,7 +34262,7 @@ __export(app_exports, {
 });
 import { join as join27 } from "node:path";
 import { useEffect as useEffect27, useState as useState36 } from "react";
-import { Fragment as Fragment20, jsx as jsx63 } from "react/jsx-runtime";
+import { Fragment as Fragment21, jsx as jsx63 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
   const [screen, setScreen] = useState36("start");
   const [importExitCode, setImportExitCode] = useState36();
@@ -34258,7 +34431,7 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment20, {});
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment21, {});
       if (projectPath === void 0) {
         return /* @__PURE__ */ jsx63(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
       }
@@ -34297,7 +34470,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment20, {});
+        return /* @__PURE__ */ jsx63(Fragment21, {});
       }
       if (scopeRun && scopeFlow) {
         if (scopeFlow.status === "failed") {
@@ -34334,7 +34507,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment20, {});
+        return /* @__PURE__ */ jsx63(Fragment21, {});
       }
       if (pendingLaunch?.cached) {
         return /* @__PURE__ */ jsx63(
@@ -34514,7 +34687,7 @@ function createProgram() {
 // packages/experience-design-system-cli/src/config/migrate.ts
 init_config();
 init_package_root();
-import { existsSync as existsSync11 } from "node:fs";
+import { existsSync as existsSync12 } from "node:fs";
 import { mkdir as mkdir10, readFile as readFile19, rename as rename3, rmdir, unlink } from "node:fs/promises";
 import { dirname as dirname16, join as join29 } from "node:path";
 var PACKAGE_NAME3 = "@contentful/experience-design-system-cli";
@@ -34540,8 +34713,8 @@ async function migrateOldConfig() {
     if (debugMode) migrated["debugMode"] = debugMode;
     Object.assign(migrated, await readJson(oldCredentials));
     if (Object.keys(migrated).length > 0) await updateSettings2({ ...migrated, ...await readSettings2() });
-    if (existsSync11(oldRuns)) {
-      if (!existsSync11(runsFilePath2())) {
+    if (existsSync12(oldRuns)) {
+      if (!existsSync12(runsFilePath2())) {
         await mkdir10(dirname16(runsFilePath2()), { recursive: true });
         await rename3(oldRuns, runsFilePath2());
       } else {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-2582b468.0",
+  "version": "2.37.1-dev-build-414ce827.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/tui/settings/configuration/agents/AgentDetail.d.ts

@@ -5,9 +5,11 @@ import { type AgentConfig } from './agent-store.js';
  * One agent's screen: what was found for it, its two settings, and the test. Saving writes the whole agent config, so the
  * default agent and the other agents are kept. The test uses the values on screen, saved or not.
  */
-export declare function AgentDetail({ name, config, setConfig, onBack, }: {
+export declare function AgentDetail({ name, config, setConfig, onBack, record, }: {
     name: AgentName;
     config: AgentConfig;
     setConfig: (config: AgentConfig) => void;
     onBack: () => void;
+    /** Adds a line to the debug log of this visit. The Agents list owns the log, since it is the screen that is open. */
+    record: (action: string, error?: unknown) => void;
 }): React.ReactElement;

package/dist/src/tui/settings/configuration/agents/agent-debug.d.ts

@@ -0,0 +1,25 @@
+import { type AgentName } from '@contentful/experience-design-system-backend-pipeline';
+import type { Snapshot } from '../../shared/debug-trail.js';
+import type { AgentConfig } from './agent-store.js';
+/**
+ * The agent settings as flat text, for `diffSnapshots`: `default_agent`, then `<agent>.model` and `<agent>.binary` for
+ * every agent. Taken on entry and on exit, so the log shows what a visit changed.
+ */
+export declare function agentSnapshot(config: AgentConfig): Snapshot;
+export type AgentEnvironment = {
+    /** Whether the command was found, and the path it resolved to. */
+    found: boolean;
+    resolved_path: string;
+    version: string;
+    /**
+     * The `EDS_AGENT_BINARY_<AGENT>` variable when it points somewhere other than the saved path. Settings copies a saved
+     * path into that variable at startup, so a value equal to the saved path is not an override and is left out.
+     */
+    env_override: string;
+};
+/**
+ * What is true about each agent on this machine, so "my agent does not work" can be read from the log: found or not,
+ * where, its version, and whether a shell variable is overriding the saved path. Uses the quick checks only, so it never
+ * spends a prompt.
+ */
+export declare function describeAgents(config: AgentConfig): Promise<Record<AgentName, AgentEnvironment>>;

package/dist/src/tui/settings/shared/debug-trail.d.ts

@@ -0,0 +1,35 @@
+/** One screen's values, as flat text, taken when the screen opens and again when it closes. */
+export type Snapshot = Record<string, string>;
+export type Change = {
+    changed: boolean;
+    /** Field names that differ between the two snapshots, in the order the fields appear. Never the values. */
+    changed_fields: string[];
+};
+/**
+ * Compares the snapshot taken on entry with the one taken on exit. A field that exists in only one of them counts as
+ * changed. Only names are returned, so the result can be logged without repeating a secret.
+ */
+export declare function diffSnapshots(before: Snapshot, after: Snapshot): Change;
+export type Trail = {
+    /** Adds one action, such as `edited spaceId`, `saved`, or `made Codex the default`. Field names, never values. */
+    record(action: string): void;
+    /** The recorded actions in order, oldest first. Once the limit is passed the oldest are dropped. */
+    entries(): string[];
+};
+/** Keeps the last `limit` actions of a visit, so a long visit cannot make the log grow without bound. */
+export declare function createTrail(limit?: number): Trail;
+/**
+ * The message of a failed load or save, safe to log: any of `secrets` that appears in it is replaced. The CMA token is
+ * only redacted by key elsewhere, so an error that quotes it would otherwise get through. A secret is matched as it is
+ * and as it looks URL-encoded, which is how it appears in a request error.
+ */
+export declare function scrubError(error: unknown, secrets: readonly string[]): string;
+/**
+ * Where Project's settings live and what could be moving them: the settings file path, whether `EDS_HOME` relocated it,
+ * and whether the file exists. Facts for the log, with no values read from the file.
+ */
+export declare function describeSettingsFile(): {
+    path: string;
+    eds_home_set: boolean;
+    exists: boolean;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-2582b468.0",
+  "version": "2.37.1-dev-build-414ce827.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -45,8 +45,8 @@
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.6.5",
-    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-2582b468.0",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-2582b468.0"
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-414ce827.0",
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-414ce827.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",