@contentful/experience-design-system-cli 2.40.1-dev-build-54dd0c33.0 → 2.40.1-dev-build-58bdf9b8.0

package/dist/index.js

@@ -21077,6 +21077,45 @@ var init_FieldForm = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/shared/debug-trail.ts
+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 };
+}
+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: existsSync10(path5) };
+}
+var DEFAULT_TRAIL_LIMIT, MIN_SECRET_LENGTH;
+var init_debug_trail = __esm({
+  "packages/experience-design-system-cli/src/tui/shared/debug-trail.ts"() {
+    "use strict";
+    init_config();
+    DEFAULT_TRAIL_LIMIT = 30;
+    MIN_SECRET_LENGTH = 6;
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/import/steps/04-credentials/logic.ts
 function credentialsPurpose(tokensOnly) {
   const use = tokensOnly ? "We use it to push your design tokens" : "We use it to check what components already exist and to push your import";
@@ -21090,17 +21129,42 @@ function normalize(values) {
     host: toConfiguredHost2(values.host) ?? DEFAULT_CONFIGURED_HOST
   };
 }
-function missingField(values) {
-  return values.spaceId === "" || values.environmentId === "" || values.cmaToken === "";
+function missingFields(values) {
+  return ["spaceId", "environmentId", "cmaToken"].filter((field) => values[field] === "");
 }
 function isUnchanged(current, initial) {
   return FIELDS.every((field) => current[field] === initial[field]);
 }
+function rejectedAttempt(reason, credentials) {
+  return { host: credentials.host, reason: scrubError(reason, [credentials.cmaToken]) };
+}
+function credentialsLog(credentials) {
+  return {
+    space_id: credentials.spaceId,
+    environment_id: credentials.environmentId,
+    host: credentials.host,
+    cma_token: credentials.cmaToken
+  };
+}
+function credentialsOutputs({
+  outcome,
+  credentials,
+  initial,
+  attempts
+}) {
+  return {
+    outcome,
+    ...credentialsLog(credentials),
+    changed_fields: diffSnapshots(initial, credentials).changed_fields,
+    rejected_attempts: attempts
+  };
+}
 var FIELDS;
 var init_logic8 = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/04-credentials/logic.ts"() {
     "use strict";
     init_src3();
+    init_debug_trail();
     FIELDS = ["spaceId", "environmentId", "cmaToken", "host"];
   }
 });
@@ -21153,10 +21217,11 @@ var init_validate4 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/04-credentials/screen.tsx
-import { useRef as useRef5, useState as useState9 } from "react";
+import { useEffect as useEffect8, useRef as useRef5, useState as useState9 } from "react";
 import { Box as Box14, Text as Text14, useInput as useInput11 } from "ink";
 import { Fragment as Fragment2, jsx as jsx15, jsxs as jsxs14 } from "react/jsx-runtime";
 function CredentialsScreen({
+  mode,
   onDone,
   onBack,
   initial = {},
@@ -21179,17 +21244,64 @@ function CredentialsScreen({
   const [focus, setFocus] = useState9(0);
   const [active, setActive] = useState9(0);
   const [beforeEdit, setBeforeEdit] = useState9(initialValues);
+  const visit = useRef5({ attempts: [], lastReason: "" }).current;
+  useEffect8(() => {
+    startDebugRun({
+      flow: "import/credentials",
+      step: "04-credentials",
+      menuOption: "Credentials",
+      inputs: { import_mode: mode, prefilled, ...credentialsLog(initialValues) }
+    });
+  }, []);
+  const reject = (attempt, text) => {
+    if (visit.attempts.length < MAX_LOGGED_ATTEMPTS2) visit.attempts.push(attempt);
+    visit.lastReason = attempt.reason;
+    setNotice({ kind: "error", text });
+  };
+  const leave = () => {
+    void finishDebugRun({
+      outputs: {
+        ...credentialsOutputs({
+          outcome: "back",
+          credentials: normalize(values),
+          initial: initialValues,
+          attempts: visit.attempts
+        }),
+        ...notice ? { error: visit.lastReason } : {}
+      },
+      status: notice ? "error" : "success",
+      exitMethod: "discarded"
+    });
+    onBack();
+  };
   const submit = async () => {
     const credentials = normalize(values);
-    if (missingField(credentials)) {
-      setNotice({ kind: "error", text: "Space ID, environment and CMA token are all required." });
+    const missing = missingFields(credentials);
+    if (missing.length > 0) {
+      reject(
+        rejectedAttempt(`Missing required fields: ${missing.join(", ")}`, credentials),
+        "Space ID, environment and CMA token are all required."
+      );
       return;
     }
     setValidating(true);
     const result = await validate3(credentials);
     setValidating(false);
-    if (result.ok) onDone({ skipped: false, credentials });
-    else setNotice({ kind: "error", text: result.error });
+    if (!result.ok) {
+      reject(rejectedAttempt(result.error, credentials), result.error);
+      return;
+    }
+    void finishDebugRun({
+      outputs: credentialsOutputs({
+        outcome: "validated",
+        credentials,
+        initial: initialValues,
+        attempts: visit.attempts
+      }),
+      status: "success",
+      exitMethod: "saved"
+    });
+    onDone({ skipped: false, credentials });
   };
   const choose = (choice) => {
     if (choice === "continue") void submit();
@@ -21198,7 +21310,7 @@ function CredentialsScreen({
       setBeforeEdit(values);
       setActive(0);
       setEditing(true);
-    } else onBack();
+    } else leave();
   };
   const stopEditing = () => {
     setEditing(false);
@@ -21208,7 +21320,7 @@ function CredentialsScreen({
     if (validating) return;
     if (editing) {
       if (key.escape) {
-        if (!prefilled) onBack();
+        if (!prefilled) leave();
         else {
           setValues(beforeEdit);
           setNotice(null);
@@ -21314,11 +21426,12 @@ function CredentialsScreen({
     ] })
   ] });
 }
-var FIELDS2, MENU;
+var FIELDS2, MENU, MAX_LOGGED_ATTEMPTS2;
 var init_screen5 = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/04-credentials/screen.tsx"() {
     "use strict";
     init_theme();
+    init_debug_store();
     init_FieldForm();
     init_ClearableTextInput();
     init_ControlHints();
@@ -21335,6 +21448,7 @@ var init_screen5 = __esm({
       { choice: "continue", label: "Continue", description: "Check the credentials and go on" },
       { choice: "edit", label: "Edit", description: "Change the credentials" }
     ];
+    MAX_LOGGED_ATTEMPTS2 = 10;
   }
 });
 
@@ -21611,7 +21725,7 @@ var init_steps = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/find-skill-path.ts
-import { existsSync as existsSync10 } from "node:fs";
+import { existsSync as existsSync11 } from "node:fs";
 import { dirname as dirname16, join as join20, resolve as resolve22 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 function findSkillPath(fileName) {
@@ -21619,7 +21733,7 @@ function findSkillPath(fileName) {
   let dir = thisDir;
   for (; ; ) {
     const candidate = join20(dir, "skills", fileName);
-    if (existsSync10(candidate)) return candidate;
+    if (existsSync11(candidate)) return candidate;
     const parent = resolve22(dir, "..");
     if (parent === dir) {
       throw new Error(`skill file not found (looked for skills/${fileName} from ${thisDir})`);
@@ -21883,11 +21997,11 @@ var init_run = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/use-extraction.ts
-import { useEffect as useEffect8, useRef as useRef6, useState as useState11 } from "react";
+import { useEffect as useEffect9, useRef as useRef6, useState as useState11 } from "react";
 function useExtraction(input) {
   const [state2, setState] = useState11();
   const current = useRef6();
-  useEffect8(() => {
+  useEffect9(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -21958,11 +22072,11 @@ var init_run_tokens_only = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/use-tokens-only.ts
-import { useEffect as useEffect9, useRef as useRef7, useState as useState12 } from "react";
+import { useEffect as useEffect10, useRef as useRef7, useState as useState12 } from "react";
 function useTokensOnly(input) {
   const [state2, setState] = useState12();
   const current = useRef7();
-  useEffect9(() => {
+  useEffect10(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -23239,7 +23353,7 @@ var init_useImmediateInput = __esm({
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/sidebar/hooks/use-terminal-size.ts
 import { useStdout as useStdout2 } from "ink";
-import { useEffect as useEffect10, useState as useState13 } from "react";
+import { useEffect as useEffect11, useState as useState13 } from "react";
 function readTerminalSize(stdout) {
   return {
     columns: stdout?.columns ?? 80,
@@ -23249,7 +23363,7 @@ function readTerminalSize(stdout) {
 function useTerminalSize() {
   const { stdout } = useStdout2();
   const [size, setSize] = useState13(() => readTerminalSize(stdout));
-  useEffect10(() => {
+  useEffect11(() => {
     const updateSize = () => setSize(readTerminalSize(stdout));
     stdout?.on("resize", updateSize);
     updateSize();
@@ -24251,7 +24365,7 @@ var init_state = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/use-scope-gate.ts
-import { useEffect as useEffect11, useMemo as useMemo3, useRef as useRef9, useState as useState16 } from "react";
+import { useEffect as useEffect12, useMemo as useMemo3, useRef as useRef9, useState as useState16 } from "react";
 function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }) {
   const { columns: totalWidth, rows: terminalRows } = useTerminalSize();
   const columnPlan = useMemo3(
@@ -24298,7 +24412,7 @@ function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }
     return seed;
   });
   const seededGroupsRef = useRef9(closures.size > 0 || cycleParticipants.size > 0);
-  useEffect11(() => {
+  useEffect12(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && cycleParticipants.size === 0) return;
     seededGroupsRef.current = true;
@@ -24389,7 +24503,7 @@ function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }
     entryCount: 0
   });
   const panelLayout = useMemo3(() => computePanelLayout(visibleCount), [visibleCount]);
-  useEffect11(() => {
+  useEffect12(() => {
     setNav((prev) => {
       const maxIdx = Math.max(0, visibleRows.length - 1);
       const nextCursor = Math.min(prev.cursor, maxIdx);
@@ -24962,13 +25076,13 @@ var init_load2 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/use-scope-gate-flow.ts
-import { useEffect as useEffect12, useMemo as useMemo5, useRef as useRef10, useState as useState17 } from "react";
+import { useEffect as useEffect13, useMemo as useMemo5, useRef as useRef10, useState as useState17 } from "react";
 function useScopeGateFlow(input, deps = realDeps3) {
   const sessionId = input?.sessionId;
   const loaded = useMemo5(() => sessionId ? deps.load(sessionId) : void 0, [sessionId]);
   const cacheCheck = useRef10(void 0);
   const [confirmed, setConfirmed] = useState17();
-  useEffect12(() => {
+  useEffect13(() => {
     if (!input || !loaded?.ok || cacheCheck.current) return;
     cacheCheck.current = deps.checkCache(input.cache);
   }, [input, loaded]);
@@ -25239,11 +25353,11 @@ var init_run2 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/08-generation/use-generation.ts
-import { useEffect as useEffect13, useRef as useRef11, useState as useState18 } from "react";
+import { useEffect as useEffect14, useRef as useRef11, useState as useState18 } from "react";
 function useGeneration(input) {
   const [state2, setState] = useState18();
   const current = useRef11();
-  useEffect13(() => {
+  useEffect14(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -26230,7 +26344,7 @@ var init_scroll_offset = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/components/FieldEditor.tsx
-import React13, { useEffect as useEffect14, useLayoutEffect as useLayoutEffect2, useState as useState19 } from "react";
+import React13, { useEffect as useEffect15, useLayoutEffect as useLayoutEffect2, useState as useState19 } from "react";
 import figures6 from "figures";
 import { Box as Box26, measureElement, Text as Text27 } from "ink";
 import { Fragment as Fragment6, jsx as jsx32, jsxs as jsxs26 } from "react/jsx-runtime";
@@ -27757,7 +27871,7 @@ function FieldEditor({
     }
     return Math.max(start + 1, end2);
   };
-  useEffect14(() => {
+  useEffect15(() => {
     if (focusLevel === "field" || selectedRowIdx < 0) return;
     setListScrollStart((previous) => {
       if (initialFocusTarget && !initialFocusScrollApplied.current) {
@@ -29152,7 +29266,7 @@ var init_FinalizeDialog = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-finalize-preview.ts
-import { useEffect as useEffect15, useRef as useRef12, useState as useState20 } from "react";
+import { useEffect as useEffect16, useRef as useRef12, useState as useState20 } from "react";
 function useReviewFinalizePreview({
   components,
   ...options
@@ -29169,7 +29283,7 @@ function useFinalizePreview(opts) {
   const [scrollOffset, setScrollOffset] = useState20(0);
   const generationRef = useRef12(0);
   const acceptedKey = [...acceptedKeys].sort().join("\0");
-  useEffect15(() => {
+  useEffect16(() => {
     if (!open) {
       setStatus("idle");
       setRemoved([]);
@@ -29221,7 +29335,7 @@ var init_use_finalize_preview = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-session.ts
-import { useCallback as useCallback2, useEffect as useEffect16, useRef as useRef13, useState as useState21 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect17, useRef as useRef13, useState as useState21 } from "react";
 function useReviewSession({
   loadSession,
   tokensPath,
@@ -29240,7 +29354,7 @@ function useReviewSession({
     }));
     return { result, catalog };
   }, [loadSession, tokensPath]);
-  useEffect16(() => {
+  useEffect17(() => {
     let disposed = false;
     void (async () => {
       try {
@@ -29293,7 +29407,7 @@ function useReviewSession({
 function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
   const [reviewMetadata, setReviewMetadata] = useState21(null);
   const [componentRationale, setComponentRationale] = useState21(null);
-  useEffect16(() => {
+  useEffect17(() => {
     const current = components[selectedIdx];
     if (!current) {
       setReviewMetadata(null);
@@ -29325,7 +29439,7 @@ function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
 function useReviewHistory({ loading, components, createSnapshot, applySnapshot }) {
   const historyRef = useRef13(null);
   const historySeededRef = useRef13(false);
-  useEffect16(() => {
+  useEffect17(() => {
     if (loading || historySeededRef.current) return;
     historySeededRef.current = true;
     historyRef.current = createHistoryStack(createSnapshot(components));
@@ -29407,7 +29521,7 @@ var init_token_suggestions = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-editor.ts
-import { useEffect as useEffect17, useRef as useRef14, useState as useState22 } from "react";
+import { useEffect as useEffect18, useRef as useRef14, useState as useState22 } from "react";
 function parseReviewEntry(draftValue) {
   const parsed = JSON.parse(draftValue);
   const keys = Object.keys(parsed);
@@ -29441,7 +29555,7 @@ function useReviewEditor({
   const [tokenReviewEditSelection, setTokenReviewEditSelection] = useState22(/* @__PURE__ */ new Set());
   const tokenReviewSuggestedRef = useRef14(/* @__PURE__ */ new Map());
   const pendingGRef = useRef14(false);
-  useEffect17(() => {
+  useEffect18(() => {
     setTokenReviewRow(0);
     setTokenReviewEditing(false);
     setTokenReviewEditCursor(0);
@@ -29923,7 +30037,7 @@ var init_preview_annotations = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-live-preview.ts
-import { useCallback as useCallback3, useEffect as useEffect18, useRef as useRef15, useState as useState24 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect19, useRef as useRef15, useState as useState24 } from "react";
 function useLivePreview(opts) {
   const debounceMs = opts.debounceMs ?? DEFAULT_DEBOUNCE_MS;
   const [status, setStatus] = useState24("idle");
@@ -29933,14 +30047,14 @@ function useLivePreview(opts) {
   const latestRef = useRef15(0);
   const inflightRef = useRef15(0);
   const optsRef = useRef15(opts);
-  useEffect18(() => {
+  useEffect19(() => {
     optsRef.current = opts;
   });
   const disabledRef = useRef15(disabled);
-  useEffect18(() => {
+  useEffect19(() => {
     disabledRef.current = disabled;
   }, [disabled]);
-  useEffect18(() => {
+  useEffect19(() => {
     return () => {
       if (timerRef.current) {
         clearTimeout(timerRef.current);
@@ -30021,7 +30135,7 @@ var init_use_live_preview = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-preview.ts
-import { useCallback as useCallback4, useEffect as useEffect19, useState as useState25 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect20, useState as useState25 } from "react";
 function useReviewPreview({
   components,
   loading,
@@ -30063,13 +30177,13 @@ function useReviewPreview({
     deleteAllComponents
   });
   const [spinnerTick, setSpinnerTick] = useState25(0);
-  useEffect19(() => {
+  useEffect20(() => {
     if (livePreviewHook.status !== "running") return;
     const id = setInterval(() => setSpinnerTick((tick) => tick + 1), 80);
     return () => clearInterval(id);
   }, [livePreviewHook.status]);
   const livePreviewSpinner = SPINNER_FRAMES[spinnerTick % SPINNER_FRAMES.length];
-  useEffect19(() => {
+  useEffect20(() => {
     if (loading) return;
     if (!livePreview) return;
     if (components.length === 0) return;
@@ -30126,7 +30240,7 @@ var init_LivePreviewSummary = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/generate-review-step.tsx
-import { useCallback as useCallback5, useEffect as useEffect20, useMemo as useMemo6, useRef as useRef16, useState as useState26 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect21, useMemo as useMemo6, useRef as useRef16, useState as useState26 } from "react";
 import figures8 from "figures";
 import { Box as Box38, Text as Text40 } from "ink";
 import { Fragment as Fragment14, jsx as jsx48, jsxs as jsxs38 } from "react/jsx-runtime";
@@ -30447,7 +30561,7 @@ function GenerateReviewStepView({
     [components]
   );
   const closures = useMemo6(() => computeAllClosures(componentGraph), [componentGraph]);
-  useEffect20(() => {
+  useEffect21(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && slotCycles.length === 0) return;
     seededGroupsRef.current = true;
@@ -30474,7 +30588,7 @@ function GenerateReviewStepView({
       suggestedBreak: cycle.edges.length > 0 ? suggestCycleBreakEdge2(cycle, cycleView.pushBlocking) : null
     }));
   }, [slotCycles, cycleView]);
-  useEffect20(() => {
+  useEffect21(() => {
     const decision = computeAutoRejectDecision({
       loading,
       autoRejectFired: autoRejectFiredRef.current,
@@ -30518,7 +30632,7 @@ function GenerateReviewStepView({
     applySnapshot: applyHistorySnapshot
   });
   const autoRejectPushedRef = useRef16(false);
-  useEffect20(() => {
+  useEffect21(() => {
     if (loading) return;
     if (!historySeededRef.current) return;
     if (!autoRejectFiredRef.current) return;
@@ -30602,7 +30716,7 @@ function GenerateReviewStepView({
   const panelHeight = leftPanelHeight + 2;
   const panelContentHeight = Math.max(1, panelHeight - 3);
   const cycleViewportHeight = Math.max(1, panelHeight - 4);
-  useEffect20(() => {
+  useEffect21(() => {
     if (selectableRowPositions.length === 0) return;
     const cursorInRange = selectableRowPositions.includes(cursorRowIdx);
     const maxScroll = Math.max(0, visibleRowsMemo.length - visibleCount);
@@ -31684,10 +31798,10 @@ var init_path_utils = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/use-blinking-cursor.ts
-import { useEffect as useEffect21, useState as useState27 } from "react";
+import { useEffect as useEffect22, useState as useState27 } from "react";
 function useBlinkingCursor() {
   const [visible, setVisible] = useState27(true);
-  useEffect21(() => {
+  useEffect22(() => {
     const interval = setInterval(() => setVisible((current) => !current), 500);
     return () => clearInterval(interval);
   }, []);
@@ -31824,12 +31938,12 @@ var init_produced = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/use-timed-spinner.tsx
-import { useEffect as useEffect22, useState as useState29 } from "react";
+import { useEffect as useEffect23, useState as useState29 } from "react";
 import { Spinner as Spinner2 } from "@inkjs/ui";
 import { jsx as jsx53 } from "react/jsx-runtime";
 function useTimedSpinner() {
   const [elapsedSeconds, setElapsedSeconds] = useState29(0);
-  useEffect22(() => {
+  useEffect23(() => {
     const timer = setInterval(() => setElapsedSeconds((current) => current + 1), 1e3);
     return () => {
       clearInterval(timer);
@@ -32098,7 +32212,7 @@ var init_preview_confirmation_input = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/screens/WizardPreviewStep.tsx
-import { useEffect as useEffect23, useState as useState30, useMemo as useMemo7 } from "react";
+import { useEffect as useEffect24, useState as useState30, useMemo as useMemo7 } from "react";
 import { Box as Box44, Text as Text46 } from "ink";
 import { Fragment as Fragment16, jsx as jsx55, jsxs as jsxs44 } from "react/jsx-runtime";
 function buildPreviewSummaryLines(preview) {
@@ -32308,7 +32422,7 @@ function WizardPreviewStep({
   const activeLines = diffExpanded ? diffLines : summaryLines;
   const maxScroll = Math.max(0, activeLines.length - viewportHeight);
   const boundedScrollOffset = Math.min(scrollOffset, maxScroll);
-  useEffect23(() => {
+  useEffect24(() => {
     setScrollOffset((previous) => Math.min(previous, maxScroll));
   }, [maxScroll]);
   useImmediateInput((input, key) => {
@@ -33356,7 +33470,7 @@ var init_controller = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts
-import { useEffect as useEffect24, useRef as useRef17, useSyncExternalStore } from "react";
+import { useEffect as useEffect25, useRef as useRef17, useSyncExternalStore } from "react";
 function useFlow(start, options = {}) {
   const controller = useRef17();
   if (start && !controller.current) {
@@ -33375,7 +33489,7 @@ function useFlow(start, options = {}) {
     (listener) => current?.subscribe(listener) ?? (() => void 0),
     () => current?.getState()
   );
-  useEffect24(() => {
+  useEffect25(() => {
     if (!start) controller.current = void 0;
   }, [start]);
   return current && state2 ? { controller: current, state: state2 } : void 0;
@@ -33454,7 +33568,7 @@ var init_help_info = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/help/PageContainer.tsx
-import { useEffect as useEffect25, useState as useState31 } from "react";
+import { useEffect as useEffect26, useState as useState31 } from "react";
 import { Box as Box46, Text as Text47, useInput as useInput13 } from "ink";
 import { Fragment as Fragment17, jsx as jsx57, jsxs as jsxs46 } from "react/jsx-runtime";
 function Section({ title, rows }) {
@@ -33468,7 +33582,7 @@ function Section({ title, rows }) {
 }
 function HelpScreen({ onDone }) {
   const [info, setInfo] = useState31();
-  useEffect25(() => {
+  useEffect26(() => {
     startDebugRun({ flow: "help", step: "01-help", menuOption: "Help", inputs: {} });
     void readHelpInfo().then(setInfo);
   }, []);
@@ -33576,45 +33690,6 @@ 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 access5, constants } from "node:fs/promises";
@@ -33889,7 +33964,7 @@ var init_AgentStatusBadge = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentDetail.tsx
-import { useEffect as useEffect26, useState as useState33 } from "react";
+import { useEffect as useEffect27, useState as useState33 } from "react";
 import { Box as Box48, Text as Text50 } from "ink";
 import { jsx as jsx60, jsxs as jsxs48 } from "react/jsx-runtime";
 function StatusHeading() {
@@ -33910,7 +33985,7 @@ function AgentDetail({
   const [testing, setTesting] = useState33(false);
   const [notice, setNotice] = useState33(null);
   const [checks, setChecks] = useState33(void 0);
-  useEffect26(() => {
+  useEffect27(() => {
     let active = true;
     setChecks(void 0);
     const timer = setTimeout(() => {
@@ -34002,7 +34077,7 @@ var init_AgentDetail = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentsScreen.tsx
-import { useEffect as useEffect27, useRef as useRef18, useState as useState34 } from "react";
+import { useEffect as useEffect28, useRef as useRef18, useState as useState34 } from "react";
 import { Box as Box49, Text as Text51, useInput as useInput15 } from "ink";
 import { Fragment as Fragment18, jsx as jsx61, jsxs as jsxs49 } from "react/jsx-runtime";
 function AgentsScreen({ onDone }) {
@@ -34026,7 +34101,7 @@ function AgentsScreen({ onDone }) {
       );
     }
   };
-  useEffect27(() => {
+  useEffect28(() => {
     readAgentConfig().then((loaded) => {
       setConfig(loaded);
       inspectAll(loaded);
@@ -34252,7 +34327,7 @@ var init_project_store = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/project/ProjectScreen.tsx
-import { useEffect as useEffect28, useRef as useRef19, useState as useState35 } from "react";
+import { useEffect as useEffect29, useRef as useRef19, useState as useState35 } from "react";
 import { Box as Box50, Text as Text52, useInput as useInput16 } from "ink";
 import { Fragment as Fragment19, jsx as jsx62, jsxs as jsxs50 } from "react/jsx-runtime";
 function debugFields(config) {
@@ -34278,7 +34353,7 @@ function ProjectScreen({ onDone }) {
     error: ""
   }).current;
   const scrub = (err) => scrubError(err, [config?.cmaToken ?? ""]);
-  useEffect28(() => {
+  useEffect29(() => {
     readCredentials().then((cfg) => {
       setConfig(cfg);
       visit.before = snapshotOf(cfg);
@@ -34465,13 +34540,13 @@ var init_ConfigurationScreen = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { useEffect as useEffect29, useState as useState37 } from "react";
+import { useEffect as useEffect30, useState as useState37 } from "react";
 import { Box as Box52, Text as Text54, useInput as useInput18 } from "ink";
 import { Fragment as Fragment20, jsx as jsx64, jsxs as jsxs52 } from "react/jsx-runtime";
 function OptInAnalyticsScreen({ onDone }) {
   const [loading, setLoading] = useState37(true);
   const [enabled, setEnabled] = useState37(true);
-  useEffect29(() => {
+  useEffect30(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -34534,7 +34609,7 @@ var init_screen12 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect30, useRef as useRef20, useState as useState38 } from "react";
+import { useEffect as useEffect31, useRef as useRef20, useState as useState38 } from "react";
 import { Box as Box53, Text as Text55, useInput as useInput19 } from "ink";
 import { Fragment as Fragment21, jsx as jsx65, jsxs as jsxs53 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
@@ -34545,7 +34620,7 @@ function DebugModeScreen({ onDone }) {
   );
   const [notice, setNotice] = useState38(null);
   const visit = useRef20({ trail: createTrail(), before: void 0, error: "" }).current;
-  useEffect30(() => {
+  useEffect31(() => {
     readDebugModeSetting().then((loaded) => {
       setSetting(loaded);
       setPending(loaded.retentionDays);
@@ -34686,7 +34761,7 @@ var app_exports = {};
 __export(app_exports, {
   runApp: () => runApp
 });
-import { useEffect as useEffect31, useState as useState39 } from "react";
+import { useEffect as useEffect32, useState as useState39 } from "react";
 import { Fragment as Fragment22, jsx as jsx66 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
   const [screen, setScreen] = useState39("start");
@@ -34720,7 +34795,7 @@ function App({ importOptions, inkClear }) {
   const [flowStart, setFlowStart] = useState39();
   const flow = useFlow(flowStart, { beforeStepChange: inkClear });
   const [importDefaults, setImportDefaults] = useState39();
-  useEffect31(() => {
+  useEffect32(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -34793,7 +34868,7 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect31(() => {
+  useEffect32(() => {
     if (!tokensOnlyRun || tokensOnly?.status !== "done" || !tokensOnly.result.ok) return;
     const { credentialsSkipped, input, tokens } = tokensOnlyRun;
     const { tokensPath, tokenSessionId, tokenCount } = tokensOnly.result;
@@ -34815,12 +34890,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   }, [tokensOnly, tokensOnlyRun]);
-  useEffect31(() => {
+  useEffect32(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect31(() => {
+  useEffect32(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -34838,7 +34913,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect31(() => {
+  useEffect32(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -35007,6 +35082,7 @@ function App({ importOptions, inkClear }) {
         return /* @__PURE__ */ jsx66(
           CredentialsScreen,
           {
+            mode: target,
             initial: importDefaults.credentials,
             tokensOnly: target === "tokens",
             onBack: () => goBackFrom("credentials"),