@contentful/experience-design-system-cli 2.40.0 → 2.40.1-dev-build-b9f92429.0

package/dist/app.js

@@ -2484,7 +2484,7 @@ var init_cache_keys = __esm({
 });
 
 // packages/experience-design-system-cli/app.tsx
-import { useEffect as useEffect29, useState as useState39 } from "react";
+import { useEffect as useEffect31, useState as useState39 } from "react";
 
 // packages/experience-design-system-cli/src/tui/home/home.tsx
 import { useEffect as useEffect2, useState as useState2 } from "react";
@@ -3158,8 +3158,9 @@ function PreflightScreen({ onChoose, onQuit }) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/01-welcome/screen.tsx
-import { useState as useState5 } from "react";
+import { useEffect as useEffect5, useRef as useRef3, useState as useState5 } from "react";
 import { Box as Box10, Text as Text10 } from "ink";
+init_debug_store();
 
 // packages/experience-design-system-cli/src/tui/shared/components/ClearableTextInput.tsx
 import { useRef as useRef2 } from "react";
@@ -3216,12 +3217,46 @@ function useWelcomeControls(onQuit) {
 
 // packages/experience-design-system-cli/src/tui/import/steps/01-welcome/screen.tsx
 import { jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
-function WelcomeScreen({ onContinue, onQuit, initialPath = "" }) {
+function WelcomeScreen({ mode, onContinue, onQuit, initialPath = "" }) {
   const [projectPath, setProjectPath] = useState5(initialPath);
-  useWelcomeControls(onQuit);
+  const visit = useRef3({ emptySubmits: 0 }).current;
+  useEffect5(() => {
+    startDebugRun({
+      flow: "import/welcome",
+      step: "01-welcome",
+      menuOption: "Welcome",
+      inputs: { import_mode: mode, initial_path: initialPath }
+    });
+  }, []);
+  const quit = () => {
+    void finishDebugRun({
+      outputs: {
+        project_path: null,
+        typed_something: toProjectPath(projectPath) !== null,
+        empty_submits: visit.emptySubmits
+      },
+      status: "success",
+      exitMethod: "discarded"
+    });
+    onQuit();
+  };
+  useWelcomeControls(quit);
   const submit = (value) => {
     const path5 = toProjectPath(value);
-    if (path5) onContinue(path5);
+    if (!path5) {
+      visit.emptySubmits += 1;
+      return;
+    }
+    void finishDebugRun({
+      outputs: {
+        project_path: path5,
+        changed_from_initial: path5 !== initialPath.trim(),
+        empty_submits: visit.emptySubmits
+      },
+      status: "success",
+      exitMethod: "saved"
+    });
+    onContinue(path5);
   };
   return /* @__PURE__ */ jsxs10(Box10, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx11(StepHeader, { step: "setup" }),
@@ -3240,8 +3275,9 @@ function WelcomeScreen({ onContinue, onQuit, initialPath = "" }) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/02-token-input/screen.tsx
-import { useState as useState6 } from "react";
+import { useEffect as useEffect6, useRef as useRef4, useState as useState6 } from "react";
 import { Box as Box11, Text as Text11 } from "ink";
+init_debug_store();
 
 // packages/experience-design-system-cli/src/tui/import/steps/02-token-input/controls.ts
 import { useInput as useInput8 } from "ink";
@@ -3308,23 +3344,68 @@ function validateTokenPath(rawPath) {
 
 // packages/experience-design-system-cli/src/tui/import/steps/02-token-input/screen.tsx
 import { jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
-function TokenInputScreen({ onConfirm, onBack, initialPath = "" }) {
+var MAX_LOGGED_ATTEMPTS = 10;
+function TokenInputScreen({
+  mode,
+  onConfirm,
+  onBack,
+  initialPath = ""
+}) {
   const [tokenPath, setTokenPath] = useState6(initialPath);
   const [failure, setFailure] = useState6(null);
-  useTokenInputControls(onBack);
+  const rejected = useRef4([]).current;
+  useEffect6(() => {
+    startDebugRun({
+      flow: "import/token-input",
+      step: "02-token-input",
+      menuOption: "Token input",
+      inputs: { import_mode: mode, initial_path: initialPath }
+    });
+  }, []);
+  const back = () => {
+    void finishDebugRun({
+      outputs: { token_path: null, rejected_attempts: rejected, ...failure ? { error: failure.error } : {} },
+      status: failure ? "error" : "success",
+      exitMethod: "discarded"
+    });
+    onBack();
+  };
+  useTokenInputControls(back);
   const change = (value) => {
     setTokenPath(value);
     setFailure(null);
   };
+  const reject = (entered, rejection) => {
+    if (rejected.length < MAX_LOGGED_ATTEMPTS) {
+      rejected.push({
+        entered,
+        error: rejection.error,
+        ...rejection.resolvedPath ? { resolved_path: rejection.resolvedPath } : {}
+      });
+    }
+    setFailure(rejection);
+  };
   const submit = (value) => {
     const rawPath = toTokenPath(value);
     if (!rawPath) {
-      setFailure({ error: "Enter the path to your token file." });
+      reject("", { error: "Enter the path to your token file." });
       return;
     }
     const check = validateTokenPath(rawPath);
-    if (check.ok) onConfirm(check.path);
-    else setFailure({ error: check.error, resolvedPath: check.resolvedPath });
+    if (!check.ok) {
+      reject(rawPath, { error: check.error, resolvedPath: check.resolvedPath });
+      return;
+    }
+    void finishDebugRun({
+      outputs: {
+        token_path: check.path,
+        changed_from_initial: rawPath !== initialPath.trim(),
+        rejected_attempts: rejected
+      },
+      status: "success",
+      exitMethod: "saved"
+    });
+    onConfirm(check.path);
   };
   return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx12(StepHeader, { step: "setup" }),
@@ -3354,7 +3435,7 @@ function TokenInputScreen({ onConfirm, onBack, initialPath = "" }) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/03-path-validation/screen.tsx
-import { useEffect as useEffect5, useMemo, useState as useState7 } from "react";
+import { useEffect as useEffect7, useMemo, useState as useState7 } from "react";
 import { Box as Box12, Text as Text12 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/import/steps/03-path-validation/controls.ts
@@ -18011,7 +18092,7 @@ function PathValidationScreen({
 }) {
   const resolvedPath = useMemo(() => resolveUserPath(projectPath), [projectPath]);
   const [scan, setScan] = useState7();
-  useEffect5(() => {
+  useEffect7(() => {
     setScan(scanFiles(resolvedPath));
   }, [resolvedPath]);
   const phase = phaseOf(scan);
@@ -18038,7 +18119,7 @@ function PathValidationScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/04-credentials/screen.tsx
-import { useRef as useRef3, useState as useState9 } from "react";
+import { useRef as useRef5, useState as useState9 } from "react";
 import { Box as Box14, Text as Text14, useInput as useInput11 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/shared/components/FieldForm.tsx
@@ -18290,7 +18371,7 @@ function CredentialsScreen({
   validate: validate3 = validateCredentials,
   tokensOnly = false
 }) {
-  const initialValues = useRef3(
+  const initialValues = useRef5(
     normalize({
       spaceId: initial.spaceId ?? "",
       environmentId: initial.environmentId || "master",
@@ -18671,7 +18752,7 @@ function TokenReviewScreen({ tokensPath, onContinue, onQuit }) {
 init_config();
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/use-extraction.ts
-import { useEffect as useEffect6, useRef as useRef4, useState as useState11 } from "react";
+import { useEffect as useEffect8, useRef as useRef6, useState as useState11 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/run.ts
 import { mkdir as mkdir8 } from "node:fs/promises";
@@ -18927,8 +19008,8 @@ async function resolveSelectionPrompt(overrides) {
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/use-extraction.ts
 function useExtraction(input) {
   const [state2, setState] = useState11();
-  const current = useRef4();
-  useEffect6(() => {
+  const current = useRef6();
+  useEffect8(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -18954,7 +19035,7 @@ function useExtraction(input) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/use-tokens-only.ts
-import { useEffect as useEffect7, useRef as useRef5, useState as useState12 } from "react";
+import { useEffect as useEffect9, useRef as useRef7, useState as useState12 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/run-tokens-only.ts
 var TOKENS_SKILL_PATH2 = findSkillPath("generate-tokens.md");
@@ -18988,8 +19069,8 @@ async function runTokensOnly(input, deps = realDeps2) {
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/use-tokens-only.ts
 function useTokensOnly(input) {
   const [state2, setState] = useState12();
-  const current = useRef5();
-  useEffect7(() => {
+  const current = useRef7();
+  useEffect9(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -20119,7 +20200,7 @@ import React11 from "react";
 import { Box as Box23, Text as Text24 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/sidebar/hooks/useImmediateInput.ts
-import { useLayoutEffect, useRef as useRef6 } from "react";
+import { useLayoutEffect, useRef as useRef8 } from "react";
 import { useStdin } from "ink";
 function parseInput(data) {
   const isShiftTab = data === "\x1B[Z";
@@ -20182,7 +20263,7 @@ function registerInputHandler(stdin, setRawMode, handler) {
 }
 function useImmediateInput(handler, enabled = true) {
   const { stdin, setRawMode } = useStdin();
-  const handlerRef = useRef6(handler);
+  const handlerRef = useRef8(handler);
   handlerRef.current = handler;
   useLayoutEffect(() => {
     if (!enabled) return;
@@ -20193,7 +20274,7 @@ function useImmediateInput(handler, enabled = true) {
 
 // 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 useEffect8, useState as useState13 } from "react";
+import { useEffect as useEffect10, useState as useState13 } from "react";
 function readTerminalSize(stdout) {
   return {
     columns: stdout?.columns ?? 80,
@@ -20203,7 +20284,7 @@ function readTerminalSize(stdout) {
 function useTerminalSize() {
   const { stdout } = useStdout2();
   const [size, setSize] = useState13(() => readTerminalSize(stdout));
-  useEffect8(() => {
+  useEffect10(() => {
     const updateSize = () => setSize(readTerminalSize(stdout));
     stdout?.on("resize", updateSize);
     updateSize();
@@ -20386,7 +20467,7 @@ function createSidebarViewsHelpSection(includeBreaking) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/use-scope-gate.ts
-import { useEffect as useEffect9, useMemo as useMemo3, useRef as useRef7, useState as useState16 } from "react";
+import { useEffect as useEffect11, useMemo as useMemo3, useRef as useRef9, useState as useState16 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/columns.ts
 var TWO_COLUMN_MIN_WIDTH = 100;
@@ -21122,8 +21203,8 @@ function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }
     for (const p of cycleParticipants) seed.add(p);
     return seed;
   });
-  const seededGroupsRef = useRef7(closures.size > 0 || cycleParticipants.size > 0);
-  useEffect9(() => {
+  const seededGroupsRef = useRef9(closures.size > 0 || cycleParticipants.size > 0);
+  useEffect11(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && cycleParticipants.size === 0) return;
     seededGroupsRef.current = true;
@@ -21214,7 +21295,7 @@ function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }
     entryCount: 0
   });
   const panelLayout = useMemo3(() => computePanelLayout(visibleCount), [visibleCount]);
-  useEffect9(() => {
+  useEffect11(() => {
     setNav((prev) => {
       const maxIdx = Math.max(0, visibleRows.length - 1);
       const nextCursor = Math.min(prev.cursor, maxIdx);
@@ -21689,7 +21770,7 @@ function ScopeGateView({ components, tokensPath, onConfirm, onQuit }) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/use-scope-gate-flow.ts
-import { useEffect as useEffect10, useMemo as useMemo5, useRef as useRef8, useState as useState17 } from "react";
+import { useEffect as useEffect12, useMemo as useMemo5, useRef as useRef10, useState as useState17 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/cache-check.ts
 async function checkGenerationCache(input) {
@@ -21736,9 +21817,9 @@ var realDeps3 = { load: loadScopeGate, checkCache: checkGenerationCache };
 function useScopeGateFlow(input, deps = realDeps3) {
   const sessionId = input?.sessionId;
   const loaded = useMemo5(() => sessionId ? deps.load(sessionId) : void 0, [sessionId]);
-  const cacheCheck = useRef8(void 0);
+  const cacheCheck = useRef10(void 0);
   const [confirmed, setConfirmed] = useState17();
-  useEffect10(() => {
+  useEffect12(() => {
     if (!input || !loaded?.ok || cacheCheck.current) return;
     cacheCheck.current = deps.checkCache(input.cache);
   }, [input, loaded]);
@@ -21805,7 +21886,7 @@ function GenerationScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/08-generation/use-generation.ts
-import { useEffect as useEffect11, useRef as useRef9, useState as useState18 } from "react";
+import { useEffect as useEffect13, useRef as useRef11, useState as useState18 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/08-generation/run.ts
 import { resolve as resolve25 } from "node:path";
@@ -21970,8 +22051,8 @@ function applyProgressEvent2(event, previous, total) {
 // packages/experience-design-system-cli/src/tui/import/steps/08-generation/use-generation.ts
 function useGeneration(input) {
   const [state2, setState] = useState18();
-  const current = useRef9();
-  useEffect11(() => {
+  const current = useRef11();
+  useEffect13(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -22452,7 +22533,7 @@ function PreviewValidationErrorScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/generate-review-step.tsx
-import { useCallback as useCallback5, useEffect as useEffect18, useMemo as useMemo6, useRef as useRef14, useState as useState26 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect20, useMemo as useMemo6, useRef as useRef16, useState as useState26 } from "react";
 import figures8 from "figures";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/review-json-panel.ts
@@ -22713,7 +22794,7 @@ function enumerateCycleBreaks(cycle, components) {
 import { Box as Box32, Text as Text34 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/components/FieldEditor.tsx
-import React13, { useEffect as useEffect12, useLayoutEffect as useLayoutEffect2, useState as useState19 } from "react";
+import React13, { useEffect as useEffect14, useLayoutEffect as useLayoutEffect2, useState as useState19 } from "react";
 import figures6 from "figures";
 import { Box as Box26, measureElement, Text as Text27 } from "ink";
 
@@ -24271,7 +24352,7 @@ function FieldEditor({
     }
     return Math.max(start + 1, end2);
   };
-  useEffect12(() => {
+  useEffect14(() => {
     if (focusLevel === "field" || selectedRowIdx < 0) return;
     setListScrollStart((previous) => {
       if (initialFocusTarget && !initialFocusScrollApplied.current) {
@@ -25343,7 +25424,7 @@ function finalizeReviewSession(extractSessionId, components) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-session.ts
-import { useCallback as useCallback2, useEffect as useEffect14, useRef as useRef11, useState as useState21 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect16, useRef as useRef13, useState as useState21 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/history.ts
 var DEFAULT_MAX_DEPTH = 50;
@@ -25399,7 +25480,7 @@ function createHistoryStack(seed, maxDepth = DEFAULT_MAX_DEPTH) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-finalize-preview.ts
-import { useEffect as useEffect13, useRef as useRef10, useState as useState20 } from "react";
+import { useEffect as useEffect15, useRef as useRef12, useState as useState20 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/run-live-preview.ts
 var TimeoutError = class extends Error {
@@ -25557,9 +25638,9 @@ function useFinalizePreview(opts) {
   const [status, setStatus] = useState20("idle");
   const [removed, setRemoved] = useState20([]);
   const [scrollOffset, setScrollOffset] = useState20(0);
-  const generationRef = useRef10(0);
+  const generationRef = useRef12(0);
   const acceptedKey = [...acceptedKeys].sort().join("\0");
-  useEffect13(() => {
+  useEffect15(() => {
     if (!open) {
       setStatus("idle");
       setRemoved([]);
@@ -25622,7 +25703,7 @@ function useReviewSession({
     }));
     return { result, catalog };
   }, [loadSession, tokensPath]);
-  useEffect14(() => {
+  useEffect16(() => {
     let disposed = false;
     void (async () => {
       try {
@@ -25675,7 +25756,7 @@ function useReviewSession({
 function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
   const [reviewMetadata, setReviewMetadata] = useState21(null);
   const [componentRationale, setComponentRationale] = useState21(null);
-  useEffect14(() => {
+  useEffect16(() => {
     const current = components[selectedIdx];
     if (!current) {
       setReviewMetadata(null);
@@ -25705,9 +25786,9 @@ function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
   return { reviewMetadata, componentRationale };
 }
 function useReviewHistory({ loading, components, createSnapshot, applySnapshot }) {
-  const historyRef = useRef11(null);
-  const historySeededRef = useRef11(false);
-  useEffect14(() => {
+  const historyRef = useRef13(null);
+  const historySeededRef = useRef13(false);
+  useEffect16(() => {
     if (loading || historySeededRef.current) return;
     historySeededRef.current = true;
     historyRef.current = createHistoryStack(createSnapshot(components));
@@ -25758,7 +25839,7 @@ function useReviewFinalize({
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-editor.ts
-import { useEffect as useEffect15, useRef as useRef12, useState as useState22 } from "react";
+import { useEffect as useEffect17, useRef as useRef14, useState as useState22 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/token-suggestions.ts
 function collectTokenSuggestions(entry, availableTokens = []) {
@@ -25809,9 +25890,9 @@ function useReviewEditor({
   const [tokenReviewEditing, setTokenReviewEditing] = useState22(false);
   const [tokenReviewEditCursor, setTokenReviewEditCursor] = useState22(0);
   const [tokenReviewEditSelection, setTokenReviewEditSelection] = useState22(/* @__PURE__ */ new Set());
-  const tokenReviewSuggestedRef = useRef12(/* @__PURE__ */ new Map());
-  const pendingGRef = useRef12(false);
-  useEffect15(() => {
+  const tokenReviewSuggestedRef = useRef14(/* @__PURE__ */ new Map());
+  const pendingGRef = useRef14(false);
+  useEffect17(() => {
     setTokenReviewRow(0);
     setTokenReviewEditing(false);
     setTokenReviewEditCursor(0);
@@ -26223,7 +26304,7 @@ function handleJsonPanelInput(input, key, state2) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-preview.ts
-import { useCallback as useCallback4, useEffect as useEffect17, useState as useState25 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect19, useState as useState25 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/preview-annotations.ts
 function applyPreviewAnnotations(preview, localNames) {
@@ -26258,25 +26339,25 @@ function applyPreviewAnnotations(preview, localNames) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-live-preview.ts
-import { useCallback as useCallback3, useEffect as useEffect16, useRef as useRef13, useState as useState24 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect18, useRef as useRef15, useState as useState24 } from "react";
 var DEFAULT_DEBOUNCE_MS = 500;
 function useLivePreview(opts) {
   const debounceMs = opts.debounceMs ?? DEFAULT_DEBOUNCE_MS;
   const [status, setStatus] = useState24("idle");
   const [disabled, setDisabled] = useState24(false);
-  const timerRef = useRef13(null);
-  const generationRef = useRef13(0);
-  const latestRef = useRef13(0);
-  const inflightRef = useRef13(0);
-  const optsRef = useRef13(opts);
-  useEffect16(() => {
+  const timerRef = useRef15(null);
+  const generationRef = useRef15(0);
+  const latestRef = useRef15(0);
+  const inflightRef = useRef15(0);
+  const optsRef = useRef15(opts);
+  useEffect18(() => {
     optsRef.current = opts;
   });
-  const disabledRef = useRef13(disabled);
-  useEffect16(() => {
+  const disabledRef = useRef15(disabled);
+  useEffect18(() => {
     disabledRef.current = disabled;
   }, [disabled]);
-  useEffect16(() => {
+  useEffect18(() => {
     return () => {
       if (timerRef.current) {
         clearTimeout(timerRef.current);
@@ -26390,13 +26471,13 @@ function useReviewPreview({
     deleteAllComponents
   });
   const [spinnerTick, setSpinnerTick] = useState25(0);
-  useEffect17(() => {
+  useEffect19(() => {
     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];
-  useEffect17(() => {
+  useEffect19(() => {
     if (loading) return;
     if (!livePreview) return;
     if (components.length === 0) return;
@@ -26709,7 +26790,7 @@ function GenerateReviewStepView({
     setFinalizeError
   } = reviewSurface;
   const [removedBannerCollapsed, setRemovedBannerCollapsed] = useState26(false);
-  const removedBannerDefaultedRef = useRef14(false);
+  const removedBannerDefaultedRef = useRef16(false);
   const [cyclePanelScroll, setCyclePanelScroll] = useState26(0);
   const [cyclesCursor, setCyclesCursor] = useState26(0);
   const cyclePanel = useOverlayPanel({
@@ -26729,7 +26810,7 @@ function GenerateReviewStepView({
   const [breakCursor, setBreakCursor] = useState26(0);
   const [breakConfirm, setBreakConfirm] = useState26(false);
   const [expandedGroups, setExpandedGroups] = useState26(/* @__PURE__ */ new Set());
-  const seededGroupsRef = useRef14(false);
+  const seededGroupsRef = useRef16(false);
   const {
     searchOpen,
     setSearchOpen,
@@ -26753,7 +26834,7 @@ function GenerateReviewStepView({
   const [pendingEditorFocus, setPendingEditorFocus] = useState26(null);
   const [autoRejected, setAutoRejected] = useState26([]);
   const [undoSnapshot, setUndoSnapshot] = useState26(null);
-  const autoRejectFiredRef = useRef14(false);
+  const autoRejectFiredRef = useRef16(false);
   const [showReloadDialog, setShowReloadDialog] = useState26(false);
   const acceptedCountForPreview = components.filter((c2) => c2.status === "accepted").length;
   const { previewAnnotations, removedComponents, livePreviewHook, livePreviewSpinner } = useReviewPreview({
@@ -26816,7 +26897,7 @@ function GenerateReviewStepView({
     [components]
   );
   const closures = useMemo6(() => computeAllClosures(componentGraph), [componentGraph]);
-  useEffect18(() => {
+  useEffect20(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && slotCycles.length === 0) return;
     seededGroupsRef.current = true;
@@ -26843,7 +26924,7 @@ function GenerateReviewStepView({
       suggestedBreak: cycle.edges.length > 0 ? suggestCycleBreakEdge2(cycle, cycleView.pushBlocking) : null
     }));
   }, [slotCycles, cycleView]);
-  useEffect18(() => {
+  useEffect20(() => {
     const decision = computeAutoRejectDecision({
       loading,
       autoRejectFired: autoRejectFiredRef.current,
@@ -26886,8 +26967,8 @@ function GenerateReviewStepView({
     }),
     applySnapshot: applyHistorySnapshot
   });
-  const autoRejectPushedRef = useRef14(false);
-  useEffect18(() => {
+  const autoRejectPushedRef = useRef16(false);
+  useEffect20(() => {
     if (loading) return;
     if (!historySeededRef.current) return;
     if (!autoRejectFiredRef.current) return;
@@ -26971,7 +27052,7 @@ function GenerateReviewStepView({
   const panelHeight = leftPanelHeight + 2;
   const panelContentHeight = Math.max(1, panelHeight - 3);
   const cycleViewportHeight = Math.max(1, panelHeight - 4);
-  useEffect18(() => {
+  useEffect20(() => {
     if (selectableRowPositions.length === 0) return;
     const cursorInRange = selectableRowPositions.includes(cursorRowIdx);
     const maxScroll = Math.max(0, visibleRowsMemo.length - visibleCount);
@@ -27916,10 +27997,10 @@ function normalizePath(input) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/use-blinking-cursor.ts
-import { useEffect as useEffect19, useState as useState27 } from "react";
+import { useEffect as useEffect21, useState as useState27 } from "react";
 function useBlinkingCursor() {
   const [visible, setVisible] = useState27(true);
-  useEffect19(() => {
+  useEffect21(() => {
     const interval = setInterval(() => setVisible((current) => !current), 500);
     return () => clearInterval(interval);
   }, []);
@@ -28035,12 +28116,12 @@ function countedThings({ components, tokens }, counts = {}) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/use-timed-spinner.tsx
-import { useEffect as useEffect20, useState as useState29 } from "react";
+import { useEffect as useEffect22, 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);
-  useEffect20(() => {
+  useEffect22(() => {
     const timer = setInterval(() => setElapsedSeconds((current) => current + 1), 1e3);
     return () => {
       clearInterval(timer);
@@ -28098,7 +28179,7 @@ function PushingStep({ progress, produced, counts }) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/screens/WizardPreviewStep.tsx
-import { useEffect as useEffect21, useState as useState30, useMemo as useMemo7 } from "react";
+import { useEffect as useEffect23, useState as useState30, useMemo as useMemo7 } from "react";
 import { Box as Box44, Text as Text46 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/preview-diff.ts
@@ -28493,7 +28574,7 @@ function WizardPreviewStep({
   const activeLines = diffExpanded ? diffLines : summaryLines;
   const maxScroll = Math.max(0, activeLines.length - viewportHeight);
   const boundedScrollOffset = Math.min(scrollOffset, maxScroll);
-  useEffect21(() => {
+  useEffect23(() => {
     setScrollOffset((previous) => Math.min(previous, maxScroll));
   }, [maxScroll]);
   useImmediateInput((input, key) => {
@@ -28711,7 +28792,7 @@ function FlowScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts
-import { useEffect as useEffect22, useRef as useRef15, useSyncExternalStore } from "react";
+import { useEffect as useEffect24, useRef as useRef17, useSyncExternalStore } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/controller.ts
 import { appendFileSync, writeFileSync } from "node:fs";
@@ -29453,7 +29534,7 @@ function createFlowController(start, deps) {
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts
 function useFlow(start, options = {}) {
-  const controller = useRef15();
+  const controller = useRef17();
   if (start && !controller.current) {
     try {
       startWizardLog();
@@ -29470,14 +29551,14 @@ function useFlow(start, options = {}) {
     (listener) => current?.subscribe(listener) ?? (() => void 0),
     () => current?.getState()
   );
-  useEffect22(() => {
+  useEffect24(() => {
     if (!start) controller.current = void 0;
   }, [start]);
   return current && state2 ? { controller: current, state: state2 } : void 0;
 }
 
 // packages/experience-design-system-cli/src/tui/help/PageContainer.tsx
-import { useEffect as useEffect23, useState as useState31 } from "react";
+import { useEffect as useEffect25, useState as useState31 } from "react";
 import { Box as Box46, Text as Text47, useInput as useInput13 } from "ink";
 init_debug_store();
 
@@ -29551,7 +29632,7 @@ function Section({ title, rows }) {
 }
 function HelpScreen({ onDone }) {
   const [info, setInfo] = useState31();
-  useEffect23(() => {
+  useEffect25(() => {
     startDebugRun({ flow: "help", step: "01-help", menuOption: "Help", inputs: {} });
     void readHelpInfo().then(setInfo);
   }, []);
@@ -29648,7 +29729,7 @@ import { useState as useState36 } from "react";
 import { Box as Box51, Text as Text53, useInput as useInput17 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentsScreen.tsx
-import { useEffect as useEffect25, useRef as useRef16, useState as useState34 } from "react";
+import { useEffect as useEffect27, useRef as useRef18, useState as useState34 } from "react";
 import { Box as Box49, Text as Text51, useInput as useInput15 } from "ink";
 init_debug_store();
 
@@ -29977,7 +30058,7 @@ async function writeAgentConfig(config) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentDetail.tsx
-import { useEffect as useEffect24, useState as useState33 } from "react";
+import { useEffect as useEffect26, useState as useState33 } from "react";
 import { Box as Box48, Text as Text50 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentStatusBadge.tsx
@@ -30040,7 +30121,7 @@ function AgentDetail({
   const [testing, setTesting] = useState33(false);
   const [notice, setNotice] = useState33(null);
   const [checks, setChecks] = useState33(void 0);
-  useEffect24(() => {
+  useEffect26(() => {
     let active = true;
     setChecks(void 0);
     const timer = setTimeout(() => {
@@ -30125,7 +30206,7 @@ function AgentsScreen({ onDone }) {
   const [saving, setSaving] = useState34(false);
   const [loadError, setLoadError] = useState34(null);
   const [checks, setChecks] = useState34({});
-  const visit = useRef16({
+  const visit = useRef18({
     trail: createTrail(),
     before: void 0,
     environment: void 0,
@@ -30138,7 +30219,7 @@ function AgentsScreen({ onDone }) {
       );
     }
   };
-  useEffect25(() => {
+  useEffect27(() => {
     readAgentConfig().then((loaded) => {
       setConfig(loaded);
       inspectAll(loaded);
@@ -30315,7 +30396,7 @@ function AgentsScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/project/ProjectScreen.tsx
-import { useEffect as useEffect26, useRef as useRef17, useState as useState35 } from "react";
+import { useEffect as useEffect28, useRef as useRef19, useState as useState35 } from "react";
 import { Box as Box50, Text as Text52, useInput as useInput16 } from "ink";
 init_debug_store();
 
@@ -30373,14 +30454,14 @@ function ProjectScreen({ onDone }) {
   const [saving, setSaving] = useState35(false);
   const [notice, setNotice] = useState35(null);
   const [loadError, setLoadError] = useState35(null);
-  const visit = useRef17({
+  const visit = useRef19({
     trail: createTrail(),
     before: void 0,
     persisted: void 0,
     error: ""
   }).current;
   const scrub = (err) => scrubError(err, [config?.cmaToken ?? ""]);
-  useEffect26(() => {
+  useEffect28(() => {
     readCredentials().then((cfg) => {
       setConfig(cfg);
       visit.before = snapshotOf(cfg);
@@ -30532,7 +30613,7 @@ function ConfigurationScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { useEffect as useEffect27, useState as useState37 } from "react";
+import { useEffect as useEffect29, useState as useState37 } from "react";
 import { Box as Box52, Text as Text54, useInput as useInput18 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/analytics-store.ts
@@ -30556,7 +30637,7 @@ import { Fragment as Fragment20, jsx as jsx64, jsxs as jsxs52 } from "react/jsx-
 function OptInAnalyticsScreen({ onDone }) {
   const [loading, setLoading] = useState37(true);
   const [enabled, setEnabled] = useState37(true);
-  useEffect27(() => {
+  useEffect29(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -30610,7 +30691,7 @@ function OptInAnalyticsScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect28, useRef as useRef18, useState as useState38 } from "react";
+import { useEffect as useEffect30, useRef as useRef20, useState as useState38 } from "react";
 import { Box as Box53, Text as Text55, useInput as useInput19 } from "ink";
 init_debug_mode_store();
 init_debug_store();
@@ -30627,8 +30708,8 @@ function DebugModeScreen({ onDone }) {
     RETENTION_CHOICES[RETENTION_CHOICES.length - 1]
   );
   const [notice, setNotice] = useState38(null);
-  const visit = useRef18({ trail: createTrail(), before: void 0, error: "" }).current;
-  useEffect28(() => {
+  const visit = useRef20({ trail: createTrail(), before: void 0, error: "" }).current;
+  useEffect30(() => {
     readDebugModeSetting().then((loaded) => {
       setSetting(loaded);
       setPending(loaded.retentionDays);
@@ -30783,7 +30864,7 @@ function App({ importOptions, inkClear }) {
   const [flowStart, setFlowStart] = useState39();
   const flow = useFlow(flowStart, { beforeStepChange: inkClear });
   const [importDefaults, setImportDefaults] = useState39();
-  useEffect29(() => {
+  useEffect31(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -30856,7 +30937,7 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect29(() => {
+  useEffect31(() => {
     if (!tokensOnlyRun || tokensOnly?.status !== "done" || !tokensOnly.result.ok) return;
     const { credentialsSkipped, input, tokens } = tokensOnlyRun;
     const { tokensPath, tokenSessionId, tokenCount } = tokensOnly.result;
@@ -30878,12 +30959,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   }, [tokensOnly, tokensOnlyRun]);
-  useEffect29(() => {
+  useEffect31(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect29(() => {
+  useEffect31(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -30901,7 +30982,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect29(() => {
+  useEffect31(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -30984,6 +31065,7 @@ function App({ importOptions, inkClear }) {
               return /* @__PURE__ */ jsx66(
                 WelcomeScreen,
                 {
+                  mode: target,
                   onContinue: (projectPath) => answer({ projectPath }),
                   onQuit: () => goBackFrom("project"),
                   initialPath: importDefaults.componentDir
@@ -30993,6 +31075,7 @@ function App({ importOptions, inkClear }) {
               return /* @__PURE__ */ jsx66(
                 TokenInputScreen,
                 {
+                  mode: target,
                   initialPath: importDefaults.tokenFile,
                   onConfirm: (tokensPath) => answer({ tokensPath }),
                   onBack: () => goBackFrom("token-file")