@contentful/experience-design-system-cli 2.37.1-dev-build-2ec208d2.0 → 2.37.1-dev-build-f22bf3b7.0

package/dist/app.js

@@ -32,7 +32,7 @@ var init_package_root = __esm({
   }
 });
 
-// packages/experience-design-system-cli/src/tui/upgrade/version.ts
+// packages/experience-design-system-cli/src/tui/home/version.ts
 import { readFileSync as readFileSync2 } from "node:fs";
 import { join as join2 } from "node:path";
 import semver from "semver";
@@ -65,7 +65,7 @@ async function checkForUpgrade() {
 }
 var PACKAGE_NAME, TAGS_URL;
 var init_version = __esm({
-  "packages/experience-design-system-cli/src/tui/upgrade/version.ts"() {
+  "packages/experience-design-system-cli/src/tui/home/version.ts"() {
     "use strict";
     init_package_root();
     PACKAGE_NAME = "@contentful/experience-design-system-cli";
@@ -2330,7 +2330,7 @@ var init_debug_store = __esm({
 
 // packages/experience-design-system-cli/app.tsx
 import { join as join26 } from "node:path";
-import { useEffect as useEffect28, useState as useState37 } from "react";
+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";
@@ -2431,18 +2431,14 @@ var SUBTITLE = "Let's import your design system into Contentful";
 var MIN_TERMINAL_WIDTH = 164;
 var START_ITEMS = [
   { label: "Import", screen: "import" },
-  { label: "Upgrade Version", screen: "upgrade" },
   { label: "Settings", screen: "settings" },
   { label: "Help", screen: "help" }
 ];
-function upgradeItemDisplay(upgradeCheck) {
+function versionStatus(upgradeCheck) {
   if (upgradeCheck?.status === "update-available") {
-    return { label: `Upgrade Version (v${upgradeCheck.latest} available)`, color: PALETTE.warning };
-  }
-  if (upgradeCheck?.status === "up-to-date") {
-    return { label: "Upgrade Version (up to date)", color: PALETTE.muted };
+    return { text: ` (upgrade available v${upgradeCheck.latest})`, color: PALETTE.success };
   }
-  return { label: "Upgrade Version" };
+  return void 0;
 }
 function HomeScreen({ onNavigate }) {
   const [focusIdx, setFocusIdx] = useState2(0);
@@ -2450,7 +2446,7 @@ function HomeScreen({ onNavigate }) {
   const { exit } = useApp();
   const terminalWidth = useTerminalWidth();
   const tooNarrow = terminalWidth < MIN_TERMINAL_WIDTH;
-  const upgradeDisabled = upgradeCheck?.status === "up-to-date";
+  const status = versionStatus(upgradeCheck);
   useEffect2(() => {
     checkForUpgrade().then(setUpgradeCheck).catch(() => setUpgradeCheck({ status: "error" }));
   }, []);
@@ -2470,7 +2466,6 @@ function HomeScreen({ onNavigate }) {
     }
     if (key.return) {
       const item = START_ITEMS[focusIdx];
-      if (item.screen === "upgrade" && upgradeDisabled) return;
       onNavigate(item.screen);
       return;
     }
@@ -2488,26 +2483,16 @@ function HomeScreen({ onNavigate }) {
       /* @__PURE__ */ jsx2(Text2, { color: PALETTE.muted, children: SUBTITLE }),
       /* @__PURE__ */ jsxs(Text2, { color: PALETTE.muted, children: [
         "v",
-        VERSION
+        VERSION,
+        status && /* @__PURE__ */ jsx2(Text2, { color: status.color, children: status.text })
       ] })
     ] }),
     /* @__PURE__ */ jsx2(Box, { marginTop: 1, justifyContent: "center", children: /* @__PURE__ */ jsx2(Box, { flexDirection: "column", children: START_ITEMS.map((item, i) => {
       const focused = i === focusIdx;
-      const isUpgradeItem = item.screen === "upgrade";
-      const display = isUpgradeItem ? upgradeItemDisplay(upgradeCheck) : { label: item.label };
-      const dimmed = isUpgradeItem && upgradeDisabled;
-      return /* @__PURE__ */ jsxs(
-        Text2,
-        {
-          bold: focused && !dimmed,
-          color: dimmed ? PALETTE.muted : focused ? PALETTE.accent : display.color,
-          children: [
-            focused ? `${FOCUS_MARKER} ` : "  ",
-            display.label
-          ]
-        },
+      return /* @__PURE__ */ jsxs(Text2, { bold: focused, color: focused ? PALETTE.accent : void 0, children: [
+        focused ? `${FOCUS_MARKER} ` : "  ",
         item.label
-      );
+      ] }, item.label);
     }) }) }),
     /* @__PURE__ */ jsx2(Box, { marginTop: 1, justifyContent: "center", children: /* @__PURE__ */ jsx2(
       ControlHints,
@@ -28580,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
@@ -28847,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";
@@ -29048,7 +29097,8 @@ function AgentDetail({
   name,
   config,
   setConfig,
-  onBack
+  onBack,
+  record: record3
 }) {
   const settings = config.agents[name];
   const [saving, setSaving] = useState30(false);
@@ -29071,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);
@@ -29082,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",
@@ -29108,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,
@@ -29134,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(
@@ -29145,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 }
+      });
+      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) {
@@ -29164,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;
     }
@@ -29197,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();
     }
   });
@@ -29222,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) => {
@@ -29288,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
@@ -29318,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" },
@@ -29339,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)
+        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(
@@ -29390,6 +29530,7 @@ function ProjectScreen({ onDone }) {
       onChange: (key, value) => {
         setConfig({ ...config, [key]: value });
         setNotice(null);
+        visit.trail.record(`edited ${key}`);
       },
       onSave: save,
       onQuit: quit,
@@ -29413,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);
@@ -29455,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() {
@@ -29474,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);
@@ -29490,7 +29631,7 @@ function OptInAnalyticsScreen({ onDone }) {
       });
     });
   }, []);
-  useInput14((input, key) => {
+  useInput15((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -29508,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:",
         " ",
@@ -29531,89 +29672,16 @@ function OptInAnalyticsScreen({ onDone }) {
   ] });
 }
 
-// packages/experience-design-system-cli/src/tui/upgrade/PageContainer.tsx
-import { useEffect as useEffect26, useState as useState35 } from "react";
-import { Box as Box50, Text as Text53, useInput as useInput15 } from "ink";
-init_version();
-init_debug_store();
-import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
-var UPGRADE_COMMANDS = ["git pull", "pnpm install", "pnpm build"];
-function UpgradeScreen({ onDone }) {
-  const [upgradeCheck, setUpgradeCheck] = useState35();
-  useEffect26(() => {
-    startDebugRun({
-      flow: "upgrade",
-      step: "01-upgrade",
-      menuOption: "Upgrade",
-      inputs: { currentVersion: readPackageVersion() }
-    });
-    checkForUpgrade().then(setUpgradeCheck).catch(() => setUpgradeCheck({ status: "error" }));
-  }, []);
-  useInput15((_input, key) => {
-    if (key.return) {
-      void finishDebugRun({
-        outputs: upgradeCheck ?? {},
-        status: upgradeCheck?.status === "error" ? "error" : "success",
-        exitMethod: "saved"
-      });
-      onDone();
-      return;
-    }
-  });
-  return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx62(Text53, { bold: true, children: "Upgrade" }),
-    /* @__PURE__ */ jsx62(Text53, { children: " " }),
-    renderBody(upgradeCheck),
-    /* @__PURE__ */ jsx62(Text53, { children: " " }),
-    /* @__PURE__ */ jsxs51(Text53, { bold: true, color: PALETTE.accent, children: [
-      FOCUS_MARKER,
-      " Go Back"
-    ] })
-  ] });
-}
-function renderBody(upgradeCheck) {
-  if (!upgradeCheck) {
-    return /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Checking for updates\u2026" });
-  }
-  if (upgradeCheck.status === "error") {
-    return /* @__PURE__ */ jsx62(Text53, { 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__ */ jsxs51(Text53, { color: PALETTE.success, children: [
-      "You're already on the latest version (v",
-      upgradeCheck.current,
-      ")."
-    ] });
-  }
-  return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs51(Text53, { color: PALETTE.muted, children: [
-      /* @__PURE__ */ jsxs51(Text53, { bold: true, color: PALETTE.success, children: [
-        "v",
-        upgradeCheck.latest
-      ] }),
-      " ",
-      "is available (you're on ",
-      /* @__PURE__ */ jsxs51(Text53, { 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__ */ jsx62(Text53, { children: " " }),
-    /* @__PURE__ */ jsx62(Box50, { flexDirection: "column", borderStyle: "round", borderColor: PALETTE.border, paddingX: 1, children: UPGRADE_COMMANDS.map((cmd) => /* @__PURE__ */ jsx62(Text53, { bold: true, children: cmd }, cmd)) })
-  ] });
-}
-
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect27, useState as useState36 } from "react";
-import { Box as Box51, Text as Text54, useInput as useInput16 } from "ink";
+import { useEffect as useEffect26, useState as useState35 } from "react";
+import { Box as Box50, Text as Text53, useInput as useInput16 } from "ink";
 init_debug_mode_store();
 init_debug_store();
-import { jsx as jsx63, jsxs as jsxs52 } from "react/jsx-runtime";
+import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
-  const [loading, setLoading] = useState36(true);
-  const [enabled, setEnabled] = useState36(true);
-  useEffect27(() => {
+  const [loading, setLoading] = useState35(true);
+  const [enabled, setEnabled] = useState35(true);
+  useEffect26(() => {
     readDebugModeSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -29640,16 +29708,16 @@ function DebugModeScreen({ onDone }) {
       onDone();
     }
   });
-  return /* @__PURE__ */ jsxs52(Box51, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx63(Text54, { bold: true, children: "Settings \u203A Debug Mode" }),
-    /* @__PURE__ */ jsx63(Text54, { children: " " }),
-    loading ? /* @__PURE__ */ jsx63(Text54, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs52(Text54, { children: [
+  return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx62(Text53, { bold: true, children: "Settings \u203A Debug Mode" }),
+    /* @__PURE__ */ jsx62(Text53, { children: " " }),
+    loading ? /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs51(Text53, { children: [
       "Debug logging:",
       " ",
-      /* @__PURE__ */ jsx63(Text54, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
+      /* @__PURE__ */ jsx62(Text53, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
     ] }),
-    /* @__PURE__ */ jsx63(Text54, { children: " " }),
-    /* @__PURE__ */ jsx63(
+    /* @__PURE__ */ jsx62(Text53, { children: " " }),
+    /* @__PURE__ */ jsx62(
       ControlHints,
       {
         hints: [
@@ -29662,18 +29730,18 @@ function DebugModeScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/app.tsx
-import { Fragment as Fragment20, jsx as jsx64 } from "react/jsx-runtime";
+import { Fragment as Fragment21, jsx as jsx63 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
-  const [screen, setScreen] = useState37("start");
-  const [importExitCode, setImportExitCode] = useState37();
+  const [screen, setScreen] = useState36("start");
+  const [importExitCode, setImportExitCode] = useState36();
   const showImportResult = importExitCode !== void 0;
-  const [projectPath, setProjectPath] = useState37();
-  const [tokensPath, setTokensPath] = useState37();
-  const [scannedFiles, setScannedFiles] = useState37();
-  const [pendingLaunch, setPendingLaunch] = useState37();
-  const [extractionRun, setExtractionRun] = useState37();
+  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] = useState37();
+  const [scopeRun, setScopeRun] = useState36();
   const scopeFlow = useScopeGateFlow(
     scopeRun && {
       sessionId: scopeRun.extraction.sessionId,
@@ -29688,12 +29756,12 @@ function App({ importOptions, inkClear }) {
       }
     }
   );
-  const [generationInput, setGenerationInput] = useState37();
+  const [generationInput, setGenerationInput] = useState36();
   const generation = useGeneration(generationInput);
-  const [flowStart, setFlowStart] = useState37();
+  const [flowStart, setFlowStart] = useState36();
   const flow = useFlow(flowStart, { beforeStepChange: inkClear });
-  const [importDefaults, setImportDefaults] = useState37();
-  useEffect28(() => {
+  const [importDefaults, setImportDefaults] = useState36();
+  useEffect27(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -29753,12 +29821,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect28(() => {
+  useEffect27(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect28(() => {
+  useEffect27(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -29776,7 +29844,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect28(() => {
+  useEffect27(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, tokenStrategy, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -29819,9 +29887,9 @@ function App({ importOptions, inkClear }) {
   };
   switch (screen) {
     case "import":
-      if (showImportResult) return /* @__PURE__ */ jsx64(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
+      if (showImportResult) return /* @__PURE__ */ jsx63(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
       if (flow && flowStart) {
-        return /* @__PURE__ */ jsx64(
+        return /* @__PURE__ */ jsx63(
           FlowScreen,
           {
             state: flow.state,
@@ -29831,12 +29899,12 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx64(Fragment20, {});
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment21, {});
       if (projectPath === void 0) {
-        return /* @__PURE__ */ jsx64(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
+        return /* @__PURE__ */ jsx63(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
       }
       if (tokensPath === void 0) {
-        return /* @__PURE__ */ jsx64(
+        return /* @__PURE__ */ jsx63(
           TokenInputScreen,
           {
             initialPath: importDefaults.tokenFile,
@@ -29846,7 +29914,7 @@ function App({ importOptions, inkClear }) {
         );
       }
       if (scannedFiles === void 0) {
-        return /* @__PURE__ */ jsx64(
+        return /* @__PURE__ */ jsx63(
           PathValidationScreen,
           {
             projectPath,
@@ -29858,10 +29926,10 @@ function App({ importOptions, inkClear }) {
       }
       if (extractionRun) {
         if (extraction?.status === "done" && !extraction.result.ok) {
-          return /* @__PURE__ */ jsx64(ErrorStep, { stepName: extraction.result.step, message: extraction.result.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx63(ErrorStep, { stepName: extraction.result.step, message: extraction.result.message, onExit: leaveImport });
         }
         if (extraction?.status === "running") {
-          return /* @__PURE__ */ jsx64(
+          return /* @__PURE__ */ jsx63(
             ExtractionScreen,
             {
               progress: extraction.progress,
@@ -29870,14 +29938,14 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx64(Fragment20, {});
+        return /* @__PURE__ */ jsx63(Fragment21, {});
       }
       if (scopeRun && scopeFlow) {
         if (scopeFlow.status === "failed") {
-          return /* @__PURE__ */ jsx64(ErrorStep, { stepName: "scope gate", message: scopeFlow.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx63(ErrorStep, { stepName: "scope gate", message: scopeFlow.message, onExit: leaveImport });
         }
         if (scopeFlow.status === "deciding") {
-          return /* @__PURE__ */ jsx64(
+          return /* @__PURE__ */ jsx63(
             ScopeGateScreen,
             {
               components: scopeFlow.load.components,
@@ -29887,7 +29955,7 @@ function App({ importOptions, inkClear }) {
           );
         }
         if (generation?.status === "done" && !generation.result.ok) {
-          return /* @__PURE__ */ jsx64(ErrorStep, { stepName: generation.result.step, message: generation.result.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx63(ErrorStep, { stepName: generation.result.step, message: generation.result.message, onExit: leaveImport });
         }
         if (generation?.status === "running") {
           const hasRawTokens = scopeRun.input.rawTokensPath !== "";
@@ -29895,7 +29963,7 @@ function App({ importOptions, inkClear }) {
             hasRawTokens,
             mapTokensEligible: generation.progress.mapTokensEligible
           });
-          return /* @__PURE__ */ jsx64(
+          return /* @__PURE__ */ jsx63(
             GenerationScreen,
             {
               progress: generation.progress,
@@ -29907,10 +29975,10 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx64(Fragment20, {});
+        return /* @__PURE__ */ jsx63(Fragment21, {});
       }
       if (pendingLaunch?.cached) {
-        return /* @__PURE__ */ jsx64(
+        return /* @__PURE__ */ jsx63(
           TokenReuseScreen,
           {
             tokensPath: pendingLaunch.cached.tokensPath,
@@ -29921,7 +29989,7 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      return /* @__PURE__ */ jsx64(
+      return /* @__PURE__ */ jsx63(
         CredentialsScreen,
         {
           initial: importDefaults.credentials,
@@ -29930,19 +29998,17 @@ function App({ importOptions, inkClear }) {
         }
       );
     case "help":
-      return /* @__PURE__ */ jsx64(HelpScreen, { onDone: goToStart });
-    case "upgrade":
-      return /* @__PURE__ */ jsx64(UpgradeScreen, { onDone: goToStart });
+      return /* @__PURE__ */ jsx63(HelpScreen, { onDone: goToStart });
     case "settings":
-      return /* @__PURE__ */ jsx64(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
+      return /* @__PURE__ */ jsx63(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
     case "settings-configuration":
-      return /* @__PURE__ */ jsx64(ConfigurationScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx63(ConfigurationScreen, { onDone: goToSettings });
     case "settings-opt-in-analytics":
-      return /* @__PURE__ */ jsx64(OptInAnalyticsScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx63(OptInAnalyticsScreen, { onDone: goToSettings });
     case "settings-debug-mode":
-      return /* @__PURE__ */ jsx64(DebugModeScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx63(DebugModeScreen, { onDone: goToSettings });
     case "start":
-      return /* @__PURE__ */ jsx64(HomeScreen, { onNavigate: setScreen });
+      return /* @__PURE__ */ jsx63(HomeScreen, { onNavigate: setScreen });
   }
 }
 async function runApp(renderApp, importOptions) {
@@ -29950,7 +30016,7 @@ async function runApp(renderApp, importOptions) {
     instance.clear?.();
     process.stdout.write("\x1B[H\x1B[0J");
   };
-  const instance = renderApp(/* @__PURE__ */ jsx64(App, { importOptions, inkClear }));
+  const instance = renderApp(/* @__PURE__ */ jsx63(App, { importOptions, inkClear }));
   await instance.waitUntilExit();
 }
 export {