@contentful/experience-design-system-cli 2.41.1-dev-build-699ca2d9.0 → 2.41.1-dev-build-06624ee7.0

package/dist/index.js

@@ -1986,12 +1986,9 @@ var init_schema = __esm({
             $required: { type: "boolean" },
             $default: {},
             $values: { type: "array", items: { type: "string" } },
-            "$token.kind": { type: "string", minLength: 1 },
+            "$token.kind": { type: "string" },
             "$token.allowed": { type: "array", items: { type: "string" } }
           },
-          // The API rejects a token property that does not say which kind of token it takes.
-          if: { type: "object", properties: { $type: { const: "token" } }, required: ["$type"] },
-          then: { type: "object", required: ["$token.kind"] },
           additionalProperties: false
         },
         slot: {
@@ -15183,8 +15180,8 @@ function retryAfterMs(response) {
   const value = response.headers?.get("retry-after")?.trim();
   if (!value)
     return void 0;
-  const seconds = Number(value);
-  const delayMs = Number.isFinite(seconds) ? seconds * 1e3 : Date.parse(value) - Date.now();
+  const seconds2 = Number(value);
+  const delayMs = Number.isFinite(seconds2) ? seconds2 * 1e3 : Date.parse(value) - Date.now();
   if (!Number.isFinite(delayMs) || delayMs < 0 || delayMs > MAX_RETRY_AFTER_MS)
     return void 0;
   return Math.round(delayMs);
@@ -18056,10 +18053,10 @@ var init_read_candidate_files = __esm({
 async function selectCompositionPromptFiles(components, sourceFiles) {
   const allFiles = await readCandidateFiles(components, sourceFiles);
   const selectedCandidates = selectCandidateFiles(allFiles).map((c2) => ({ path: c2.path, content: c2.content }));
-  const capped = capCandidatesToPromptBudget(selectedCandidates);
-  const promptFiles = capped.kept;
+  const capped3 = capCandidatesToPromptBudget(selectedCandidates);
+  const promptFiles = capped3.kept;
   const runtimeFiles = allFiles.map((c2) => ({ path: c2.path, content: c2.content }));
-  const droppedWarning = capped.dropped.length > 0 ? `composition \u2014 ${capped.dropped.length} candidate file(s) omitted from the agent prompt to fit the context budget; resolution runs on the ${promptFiles.length} highest-value files.` : void 0;
+  const droppedWarning = capped3.dropped.length > 0 ? `composition \u2014 ${capped3.dropped.length} candidate file(s) omitted from the agent prompt to fit the context budget; resolution runs on the ${promptFiles.length} highest-value files.` : void 0;
   return { promptFiles, runtimeFiles, droppedWarning };
 }
 var init_select_composition_prompt_files = __esm({
@@ -19500,6 +19497,7 @@ __export(debug_store_exports, {
   currentDebugSessionDir: () => currentDebugSessionDir,
   currentSessionDir: () => currentSessionDir,
   finishDebugRun: () => finishDebugRun,
+  setDebugRunProgress: () => setDebugRunProgress,
   startDebugRun: () => startDebugRun,
   startDebugSessionIn: () => startDebugSessionIn,
   startImportRun: () => startImportRun
@@ -19595,11 +19593,15 @@ function startDebugRun({
   const runId = generateRunId();
   const startedAt = Date.now();
   const redactedInputs = redact(inputs);
-  isDebugModeEnabled().then((enabled) => {
-    if (!enabled) return;
-    pendingRun = { flow, step, runId, menuOption, inputs: redactedInputs, startedAt };
+  const run = { flow, step, runId, menuOption, inputs: redactedInputs, startedAt };
+  pendingRun = run;
+  void isDebugModeEnabled().then((enabled) => {
+    if (!enabled && pendingRun === run) pendingRun = void 0;
   });
 }
+function setDebugRunProgress(outputs) {
+  if (pendingRun) pendingRun.progress = outputs;
+}
 async function finishDebugRun({
   outputs,
   status,
@@ -19608,9 +19610,10 @@ async function finishDebugRun({
   const run = pendingRun;
   if (!run) return;
   pendingRun = void 0;
+  if (!await isDebugModeEnabled()) return;
   const durationMs = Date.now() - run.startedAt;
   const log = {
-    flow: run.flow,
+    flow: logFolder(run.flow, run.step),
     menuOption: run.menuOption,
     content: renderMarkdown(run, { outputs: redact(outputs), status, exitMethod, durationMs })
   };
@@ -19621,6 +19624,9 @@ async function finishDebugRun({
   }
   await writeLog(root, log);
 }
+function logFolder(flow, step) {
+  return flow.startsWith("import/") && /^\d+-/.test(step) ? `import/${step}` : flow;
+}
 async function writeLog(root, log) {
   const dir = join19(root, ...log.flow.split("/"));
   await mkdir7(dir, { recursive: true });
@@ -19677,7 +19683,7 @@ ${JSON.stringify(finish.outputs, null, 2)}
 `;
 }
 function handleCrash() {
-  return finishDebugRun({ outputs: {}, status: "error", exitMethod: "crashed" });
+  return finishDebugRun({ outputs: pendingRun?.progress ?? {}, status: "error", exitMethod: "crashed" });
 }
 var pendingRun, sessionDir, WAITING_LIMIT, waiting;
 var init_debug_store = __esm({
@@ -19721,11 +19727,17 @@ var init_debug_store = __esm({
         throw reason;
       });
     });
-    process.once("SIGINT", () => {
-      void handleCrash().finally(() => {
-        process.exit(130);
+    for (const [signal, exitCode] of [
+      ["SIGINT", 130],
+      ["SIGTERM", 143],
+      ["SIGHUP", 129]
+    ]) {
+      process.once(signal, () => {
+        void handleCrash().finally(() => {
+          process.exit(exitCode);
+        });
       });
-    });
+    }
   }
 });
 
@@ -20129,8 +20141,8 @@ function progressPercent(progress) {
 }
 function formatElapsed(totalSeconds) {
   const minutes = Math.floor(totalSeconds / 60);
-  const seconds = totalSeconds % 60;
-  return minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
+  const seconds2 = totalSeconds % 60;
+  return minutes > 0 ? `${minutes}m ${seconds2}s` : `${seconds2}s`;
 }
 var init_logic4 = __esm({
   "packages/experience-design-system-cli/src/tui/import/shared/running-step/logic.ts"() {
@@ -20160,12 +20172,12 @@ var init_theme2 = __esm({
 // packages/experience-design-system-cli/src/tui/import/shared/running-step/use-elapsed.ts
 import { useEffect as useEffect3, useState as useState3 } from "react";
 function useElapsed() {
-  const [seconds, setSeconds] = useState3(0);
+  const [seconds2, setSeconds] = useState3(0);
   useEffect3(() => {
     const timer = setInterval(() => setSeconds((current) => current + 1), 1e3);
     return () => clearInterval(timer);
   }, []);
-  return formatElapsed(seconds);
+  return formatElapsed(seconds2);
 }
 var init_use_elapsed = __esm({
   "packages/experience-design-system-cli/src/tui/import/shared/running-step/use-elapsed.ts"() {
@@ -21080,6 +21092,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";
@@ -21093,17 +21144,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"];
   }
 });
@@ -21156,10 +21232,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 = {},
@@ -21182,17 +21259,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();
@@ -21201,7 +21325,7 @@ function CredentialsScreen({
       setBeforeEdit(values);
       setActive(0);
       setEditing(true);
-    } else onBack();
+    } else leave();
   };
   const stopEditing = () => {
     setEditing(false);
@@ -21211,7 +21335,7 @@ function CredentialsScreen({
     if (validating) return;
     if (editing) {
       if (key.escape) {
-        if (!prefilled) onBack();
+        if (!prefilled) leave();
         else {
           setValues(beforeEdit);
           setNotice(null);
@@ -21317,11 +21441,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();
@@ -21338,10 +21463,52 @@ 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;
   }
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/logic.ts
+function extractionLogInputs(input) {
+  const { credentials } = input;
+  return {
+    project_path: input.projectPath,
+    out_dir: input.outDir ?? "",
+    files_to_scan: input.filePaths.length,
+    raw_tokens_path: input.rawTokensPath,
+    agent: input.agent,
+    agent_model: input.agentModel ?? "",
+    prompt_overrides: input.promptOverrides,
+    cache: !input.noCache,
+    has_credentials: credentials !== null,
+    space_id: credentials?.spaceId ?? "",
+    environment_id: credentials?.environmentId ?? "",
+    host: credentials?.host ?? "",
+    cma_token: credentials?.cmaToken ?? ""
+  };
+}
+function extractionLogOutputs(result, progress, cmaToken) {
+  const last = progress ? { final_progress: progress } : {};
+  if (!result.ok) {
+    return {
+      outputs: { result: "failed", failed_step: result.step, error: scrubError(result.message, [cmaToken]), ...last },
+      status: "error"
+    };
+  }
+  const { extraction } = result;
+  return {
+    outputs: {
+      result: "done",
+      session_id: extraction.sessionId,
+      out_dir: extraction.outDir,
+      tokens_path: extraction.tokensPath,
+      token_count: extraction.tokenCount,
+      existing_entities_status: extraction.existingEntitiesStatus,
+      composition_phase: extraction.compositionPhase,
+      ...last
+    },
+    status: "success"
+  };
+}
 function initialProgress(input) {
   return {
     scan: null,
@@ -21425,6 +21592,7 @@ var init_logic9 = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/06-extraction/logic.ts"() {
     "use strict";
     init_src3();
+    init_debug_trail();
   }
 });
 
@@ -21512,7 +21680,7 @@ var init_load = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/05-token-review/screen.tsx
-import { useMemo as useMemo2, useState as useState10 } from "react";
+import { useEffect as useEffect9, useMemo as useMemo2, useState as useState10 } from "react";
 import { Box as Box15, Text as Text15, useInput as useInput12 } from "ink";
 import { jsx as jsx17, jsxs as jsxs15 } from "react/jsx-runtime";
 function TokenReviewScreen({ tokensPath, onContinue, onQuit }) {
@@ -21520,12 +21688,31 @@ function TokenReviewScreen({ tokensPath, onContinue, onQuit }) {
   const rows = loaded.ok ? loaded.rows : [];
   const columns = useTerminalWidth();
   const [selected, setSelected] = useState10(0);
+  useEffect9(() => {
+    startDebugRun({
+      flow: "import/token-review",
+      step: "05-token-review",
+      menuOption: "Token review",
+      inputs: { import_mode: "tokens", tokens_path: tokensPath }
+    });
+  }, []);
+  const finish = (outcome) => {
+    void finishDebugRun({
+      outputs: { outcome, ...loaded.ok ? { tokens: rows.length } : { load_error: loaded.message } },
+      status: loaded.ok ? "success" : "error",
+      exitMethod: outcome === "continued" ? "saved" : "discarded"
+    });
+  };
   const move = (to) => setSelected(Math.max(0, Math.min(to, rows.length - 1)));
   const { start, end } = computeColumnWindow(rows.length, selected, VISIBLE_ROWS);
   useInput12((_input, key) => {
-    if (key.return) onContinue();
-    else if (key.escape) onQuit();
-    else if (key.upArrow) move(selected - 1);
+    if (key.return) {
+      finish("continued");
+      onContinue();
+    } else if (key.escape) {
+      finish("back");
+      onQuit();
+    } else if (key.upArrow) move(selected - 1);
     else if (key.downArrow) move(selected + 1);
     else if (key.pageUp) move(selected - VISIBLE_ROWS);
     else if (key.pageDown) move(selected + VISIBLE_ROWS);
@@ -21589,6 +21776,7 @@ var init_screen7 = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/05-token-review/screen.tsx"() {
     "use strict";
     init_theme();
+    init_debug_store();
     init_ControlHints();
     init_StepHeader();
     init_use_terminal_width();
@@ -21614,7 +21802,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) {
@@ -21622,7 +21810,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})`);
@@ -21886,11 +22074,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 useEffect10, useRef as useRef6, useState as useState11 } from "react";
 function useExtraction(input) {
   const [state2, setState] = useState11();
   const current = useRef6();
-  useEffect8(() => {
+  useEffect10(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -21903,10 +22091,23 @@ function useExtraction(input) {
         hasRawTokens: input.rawTokensPath !== ""
       })
     });
+    let lastProgress;
+    startDebugRun({
+      flow: "import/extraction",
+      step: "06-extraction",
+      menuOption: "Extraction",
+      inputs: extractionLogInputs(input)
+    });
     void runExtraction(input, (progress) => {
+      lastProgress = progress;
       if (current.current === input) setState({ status: "running", progress });
     }).then((result) => {
-      if (current.current === input) setState({ status: "done", result });
+      if (current.current !== input) return;
+      void finishDebugRun({
+        ...extractionLogOutputs(result, lastProgress, input.credentials?.cmaToken ?? ""),
+        exitMethod: result.ok ? "saved" : "discarded"
+      });
+      setState({ status: "done", result });
     });
     return () => {
       if (current.current === input) current.current = void 0;
@@ -21917,6 +22118,7 @@ function useExtraction(input) {
 var init_use_extraction = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/06-extraction/use-extraction.ts"() {
     "use strict";
+    init_debug_store();
     init_logic9();
     init_run();
   }
@@ -21961,11 +22163,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 useEffect11, useRef as useRef7, useState as useState12 } from "react";
 function useTokensOnly(input) {
   const [state2, setState] = useState12();
   const current = useRef7();
-  useEffect9(() => {
+  useEffect11(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -21988,6 +22190,39 @@ var init_use_tokens_only = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/log.ts
+function scopeGateLogInputs(components, tokenCount) {
+  const ai = { accepted: 0, rejected: 0, failed: 0, none: 0 };
+  for (const component of components) ai[component.aiDecision ?? "none"] += 1;
+  return {
+    components_found: components.length,
+    ai_suggestions: ai,
+    needs_review: components.filter((component) => component.needsReview === true).length,
+    tokens: tokenCount
+  };
+}
+function scopeGateLogOutputs(components, decisions) {
+  const suggested = new Map(components.map((component) => [component.name, component.aiDecision]));
+  return {
+    outcome: "continued",
+    accepted: new Set(decisions.accepted).size,
+    rejected: new Set(decisions.rejected).size,
+    accepted_although_ai_rejected: capped(decisions.accepted.filter((name) => suggested.get(name) === "rejected")),
+    not_accepted_although_ai_accepted: capped(decisions.rejected.filter((name) => suggested.get(name) === "accepted"))
+  };
+}
+var MAX_NAMES, capped;
+var init_log = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/log.ts"() {
+    "use strict";
+    MAX_NAMES = 20;
+    capped = (names) => {
+      const unique = [...new Set(names)];
+      return { count: unique.length, names: unique.slice(0, MAX_NAMES) };
+    };
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/sidebar/components/windowed-panel.tsx
 import { Box as Box16, Text as Text16 } from "ink";
 import { jsx as jsx18, jsxs as jsxs16 } from "react/jsx-runtime";
@@ -23242,7 +23477,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 useEffect12, useState as useState13 } from "react";
 function readTerminalSize(stdout) {
   return {
     columns: stdout?.columns ?? 80,
@@ -23252,7 +23487,7 @@ function readTerminalSize(stdout) {
 function useTerminalSize() {
   const { stdout } = useStdout2();
   const [size, setSize] = useState13(() => readTerminalSize(stdout));
-  useEffect10(() => {
+  useEffect12(() => {
     const updateSize = () => setSize(readTerminalSize(stdout));
     stdout?.on("resize", updateSize);
     updateSize();
@@ -24254,7 +24489,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 useEffect13, 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(
@@ -24301,7 +24536,7 @@ function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }
     return seed;
   });
   const seededGroupsRef = useRef9(closures.size > 0 || cycleParticipants.size > 0);
-  useEffect11(() => {
+  useEffect13(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && cycleParticipants.size === 0) return;
     seededGroupsRef.current = true;
@@ -24392,7 +24627,7 @@ function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }
     entryCount: 0
   });
   const panelLayout = useMemo3(() => computePanelLayout(visibleCount), [visibleCount]);
-  useEffect11(() => {
+  useEffect13(() => {
     setNav((prev) => {
       const maxIdx = Math.max(0, visibleRows.length - 1);
       const nextCursor = Math.min(prev.cursor, maxIdx);
@@ -24737,27 +24972,59 @@ var init_use_scope_gate = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/screen.tsx
-import { useMemo as useMemo4 } from "react";
+import { useEffect as useEffect14, useMemo as useMemo4 } from "react";
 import { Box as Box25, Text as Text26 } from "ink";
 import { Fragment as Fragment5, jsx as jsx29, jsxs as jsxs25 } from "react/jsx-runtime";
 function ScopeGateScreen(props) {
-  if (props.components.length === 0) {
-    return /* @__PURE__ */ jsx29(Box25, { paddingX: 2, paddingY: 1, children: /* @__PURE__ */ jsx29(Text26, { color: PALETTE.error, children: "Error: no components found for this session \u2014 please re-run analyze extract." }) });
-  }
+  if (props.components.length === 0) return /* @__PURE__ */ jsx29(NoComponents, {});
   return /* @__PURE__ */ jsx29(ScopeGateView, { ...props });
 }
+function NoComponents() {
+  useEffect14(() => {
+    startDebugRun({
+      flow: "import/scope-gate",
+      step: "07-scope-gate",
+      menuOption: "Scope gate",
+      inputs: scopeGateLogInputs([], 0)
+    });
+    void finishDebugRun({
+      outputs: { outcome: "nothing to decide", error: "No components were found for this session." },
+      status: "error",
+      exitMethod: "discarded"
+    });
+  }, []);
+  return /* @__PURE__ */ jsx29(Box25, { paddingX: 2, paddingY: 1, children: /* @__PURE__ */ jsx29(Text26, { color: PALETTE.error, children: "Error: no components found for this session \u2014 please re-run analyze extract." }) });
+}
 function ScopeGateView({ components, tokensPath, onConfirm, onQuit }) {
   const tokens = useMemo4(() => {
     const loaded = tokensPath ? loadTokenRows(tokensPath) : void 0;
     return loaded?.ok ? loaded.rows : [];
   }, [tokensPath]);
   const longest = useMemo4(() => longestEntries(tokens), [tokens]);
+  useEffect14(() => {
+    startDebugRun({
+      flow: "import/scope-gate",
+      step: "07-scope-gate",
+      menuOption: "Scope gate",
+      inputs: scopeGateLogInputs(components, tokens.length)
+    });
+  }, []);
   const gate = useScopeGate({
     components,
     tokenCount: tokens.length,
     tokensWidth: longest.path + longest.value + 10,
-    onConfirm,
-    onQuit
+    onConfirm: (decisions) => {
+      void finishDebugRun({
+        outputs: scopeGateLogOutputs(components, decisions),
+        status: "success",
+        exitMethod: "saved"
+      });
+      onConfirm(decisions);
+    },
+    onQuit: () => {
+      void finishDebugRun({ outputs: { outcome: "quit" }, status: "success", exitMethod: "discarded" });
+      onQuit();
+    }
   });
   const { search, graph, columnPlan, panelLayout, counters } = gate;
   if (gate.showHelp) {
@@ -24857,7 +25124,9 @@ var HELP_SECTIONS;
 var init_screen8 = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/screen.tsx"() {
     "use strict";
+    init_debug_store();
     init_StepHeader();
+    init_log();
     init_tokens_column();
     init_load();
     init_logic10();
@@ -24965,13 +25234,27 @@ 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 useEffect15, 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(() => {
+  useEffect15(() => {
+    if (!sessionId || !loaded || loaded.ok) return;
+    startDebugRun({
+      flow: "import/scope-gate",
+      step: "07-scope-gate",
+      menuOption: "Scope gate",
+      inputs: { session_id: sessionId }
+    });
+    void finishDebugRun({
+      outputs: { outcome: "could not load the components", error: loaded.message },
+      status: "error",
+      exitMethod: "discarded"
+    });
+  }, [sessionId, loaded]);
+  useEffect15(() => {
     if (!input || !loaded?.ok || cacheCheck.current) return;
     cacheCheck.current = deps.checkCache(input.cache);
   }, [input, loaded]);
@@ -24985,6 +25268,7 @@ var realDeps3;
 var init_use_scope_gate_flow = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/use-scope-gate-flow.ts"() {
     "use strict";
+    init_debug_store();
     init_cache_check();
     init_load2();
     realDeps3 = { load: loadScopeGate, checkCache: checkGenerationCache };
@@ -24992,6 +25276,41 @@ var init_use_scope_gate_flow = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/08-generation/logic.ts
+function generationLogInputs(input) {
+  return {
+    session_id: input.sessionId,
+    accepted: input.decisions.accepted.length,
+    rejected: input.decisions.rejected.length,
+    tokens_path: input.tokensPath,
+    token_session_id: input.tokenSessionId,
+    existing_entities_path: input.existingEntitiesPath,
+    agent: input.agent,
+    agent_model: input.agentModel ?? "",
+    prompt_overrides: input.promptOverrides,
+    generate_prompt_path: input.generatePromptPath ?? "",
+    cache: !input.noCache,
+    has_tokens: input.hasTokens
+  };
+}
+function generationLogOutputs(result, progress) {
+  const last = progress ? { final_progress: progress } : {};
+  if (!result.ok) {
+    return { outputs: { result: "failed", failed_step: result.step, error: result.message, ...last }, status: "error" };
+  }
+  const { generation } = result;
+  return {
+    outputs: generation.route === "review" ? {
+      result: "done",
+      route: generation.route,
+      session_id: generation.sessionId,
+      accepted: generation.acceptedCount,
+      generated: generation.generatedCount,
+      map_tokens_eligible: generation.mapTokensEligible,
+      ...last
+    } : { result: "done", route: generation.route, accepted: generation.acceptedCount, ...last },
+    status: "success"
+  };
+}
 function initialProgress2() {
   return { components: null, mapTokens: "idle", mapTokensEligible: null };
 }
@@ -25242,21 +25561,34 @@ 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 useEffect16, useRef as useRef11, useState as useState18 } from "react";
 function useGeneration(input) {
   const [state2, setState] = useState18();
   const current = useRef11();
-  useEffect13(() => {
+  useEffect16(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
       return;
     }
     setState({ status: "running", progress: initialProgress2() });
+    let lastProgress;
+    startDebugRun({
+      flow: "import/generation",
+      step: "08-generation",
+      menuOption: "Generation",
+      inputs: generationLogInputs(input)
+    });
     void runGeneration(input, (progress) => {
+      lastProgress = progress;
       if (current.current === input) setState({ status: "running", progress });
     }).then((result) => {
-      if (current.current === input) setState({ status: "done", result });
+      if (current.current !== input) return;
+      void finishDebugRun({
+        ...generationLogOutputs(result, lastProgress),
+        exitMethod: result.ok ? "saved" : "discarded"
+      });
+      setState({ status: "done", result });
     });
     return () => {
       if (current.current === input) current.current = void 0;
@@ -25267,6 +25599,7 @@ function useGeneration(input) {
 var init_use_generation = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/08-generation/use-generation.ts"() {
     "use strict";
+    init_debug_store();
     init_logic11();
     init_run2();
   }
@@ -25396,12 +25729,9 @@ var init_schema2 = __esm({
             $required: { type: "boolean" },
             $default: {},
             $values: { type: "array", items: { type: "string" } },
-            "$token.kind": { type: "string", minLength: 1 },
+            "$token.kind": { type: "string" },
             "$token.allowed": { type: "array", items: { type: "string" } }
           },
-          // The API rejects a token property that does not say which kind of token it takes.
-          if: { type: "object", properties: { $type: { const: "token" } }, required: ["$type"] },
-          then: { type: "object", required: ["$token.kind"] },
           additionalProperties: false
         },
         slot: {
@@ -25460,40 +25790,14 @@ function parseCDFComponents(obj, prefix = "") {
   }
   return { components, tokens };
 }
-function entryValidator(name) {
-  const check = ajv2.getSchema(`${CDF_SCHEMA_URL2}#/definitions/${name}`);
-  if (!check)
-    throw new Error(`the CDF schema has no "${name}" definition`);
-  return check;
-}
-function toValidationErrors(errors, prefix = "") {
-  return (errors ?? []).filter((err) => err.keyword !== "if").map((err) => ({
-    path: `${prefix}${err.instancePath}` || "/",
-    message: err.message ?? "Unknown validation error",
-    expected: err.params ? JSON.stringify(err.params) : void 0
-  }));
-}
-function entryErrors(node, prefix) {
-  const errors = [];
-  for (const [key, value] of Object.entries(node)) {
-    if (key.startsWith("$") || typeof value !== "object" || value === null)
-      continue;
-    const path5 = `${prefix}/${key}`;
-    const type = value["$type"];
-    const check = type === "component" ? validateComponentEntry : TOKEN_TYPE_SET3.has(type) ? validateTokenEntry : void 0;
-    if (!check) {
-      errors.push(...entryErrors(value, path5));
-    } else if (!check(value)) {
-      errors.push(...toValidationErrors(check.errors, path5));
-    }
-  }
-  return errors;
-}
 function validateCDF2(input) {
   const valid = validate2(input);
   if (!valid) {
-    const focused = typeof input === "object" && input !== null ? entryErrors(input, "") : [];
-    const errors = focused.length > 0 ? focused : toValidationErrors(validate2.errors);
+    const errors = (validate2.errors ?? []).map((err) => ({
+      path: err.instancePath || "/",
+      message: err.message ?? "Unknown validation error",
+      expected: err.params ? JSON.stringify(err.params) : void 0
+    }));
     return { valid: false, errors, components: [], tokens: [] };
   }
   const file = input;
@@ -25515,7 +25819,7 @@ function validateCDF2(input) {
   const { components, tokens } = parseCDFComponents(file);
   return { valid: true, errors: [], components, tokens };
 }
-var ajv2, validate2, TOKEN_TYPE_SET3, validateComponentEntry, validateTokenEntry;
+var ajv2, validate2, TOKEN_TYPE_SET3;
 var init_validate5 = __esm({
   "packages/experience-design-system-types/dist/src/cdf/validate.js"() {
     "use strict";
@@ -25524,8 +25828,6 @@ var init_validate5 = __esm({
     ajv2 = new Ajv2({ allErrors: true });
     validate2 = ajv2.compile(cdfJsonSchema2);
     TOKEN_TYPE_SET3 = new Set(DESIGN_TOKEN_TYPES2);
-    validateComponentEntry = entryValidator("component");
-    validateTokenEntry = entryValidator("token");
   }
 });
 
@@ -25566,51 +25868,6 @@ var init_types7 = __esm({
   }
 });
 
-// packages/experience-design-system-types/dist/src/cdf/repair-token-kinds.js
-function inferTokenKind(propName, prop, tokens) {
-  const bound = typeof prop.$default === "string" ? tokens.find(({ path: path5 }) => path5 === prop.$default) : void 0;
-  if (bound)
-    return bound.entry.$type;
-  const name = propName.toLowerCase();
-  const kinds = new Set(tokens.filter(({ path: path5 }) => path5.toLowerCase().split(".").includes(name)).map(({ entry }) => entry.$type));
-  return kinds.size === 1 ? [...kinds][0] : void 0;
-}
-function withoutWarning(prop) {
-  if (prop.$description === void 0)
-    return prop;
-  const description = prop.$description.replace(UNRESOLVED_WARNING, "").trim();
-  const { $description: _stale, ...rest } = prop;
-  return description ? { ...rest, $description: description } : rest;
-}
-function repairTokenKinds(entry, componentKey, tokens, note) {
-  const properties = { ...entry.$properties };
-  let repaired = false;
-  for (const [name, prop] of Object.entries(entry.$properties)) {
-    if (prop.$type !== "token" || prop["$token.kind"])
-      continue;
-    repaired = true;
-    const kind = inferTokenKind(name, prop, tokens);
-    if (kind) {
-      properties[name] = { ...withoutWarning(prop), "$token.kind": kind };
-      note?.(`${componentKey}.${name} had no token kind, so "${kind}" was taken from the token file`);
-    } else {
-      const plain = { ...withoutWarning(prop), $type: "string" };
-      delete plain["$token.allowed"];
-      delete plain.$default;
-      properties[name] = plain;
-      note?.(`${componentKey}.${name} had no token kind and none could be told, so it was saved as a string property`);
-    }
-  }
-  return repaired ? { ...entry, $properties: properties } : entry;
-}
-var UNRESOLVED_WARNING;
-var init_repair_token_kinds = __esm({
-  "packages/experience-design-system-types/dist/src/cdf/repair-token-kinds.js"() {
-    "use strict";
-    UNRESOLVED_WARNING = /\s*WARNING: token_kind unknown[^\n]*/;
-  }
-});
-
 // packages/experience-design-system-types/dist/src/cdf/build.js
 function stripUnsupportedSlotFields(entry) {
   if (!entry.$slots)
@@ -25646,7 +25903,7 @@ function buildCDF2(components, tokens, opts = {}) {
     return void 0;
   const doc = { $schema: CDF_SCHEMA_URL2 };
   for (const { key, entry } of components) {
-    setAtPath(doc, key, stripUnsupportedSlotFields(repairTokenKinds(entry, key, tokens, opts.onRepair)));
+    setAtPath(doc, key, stripUnsupportedSlotFields(entry));
   }
   for (const { path: path5, entry } of resolveTokenPathCollisions(tokens)) {
     setAtPath(doc, path5, entry);
@@ -25688,7 +25945,6 @@ var COLLISION_LEAF_KEY;
 var init_build2 = __esm({
   "packages/experience-design-system-types/dist/src/cdf/build.js"() {
     "use strict";
-    init_repair_token_kinds();
     init_schema2();
     COLLISION_LEAF_KEY = "default";
   }
@@ -26310,7 +26566,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 useEffect17, 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";
@@ -27837,7 +28093,7 @@ function FieldEditor({
     }
     return Math.max(start + 1, end2);
   };
-  useEffect14(() => {
+  useEffect17(() => {
     if (focusLevel === "field" || selectedRowIdx < 0) return;
     setListScrollStart((previous) => {
       if (initialFocusTarget && !initialFocusScrollApplied.current) {
@@ -29232,7 +29488,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 useEffect18, useRef as useRef12, useState as useState20 } from "react";
 function useReviewFinalizePreview({
   components,
   ...options
@@ -29249,7 +29505,7 @@ function useFinalizePreview(opts) {
   const [scrollOffset, setScrollOffset] = useState20(0);
   const generationRef = useRef12(0);
   const acceptedKey = [...acceptedKeys].sort().join("\0");
-  useEffect15(() => {
+  useEffect18(() => {
     if (!open) {
       setStatus("idle");
       setRemoved([]);
@@ -29301,7 +29557,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 useEffect19, useRef as useRef13, useState as useState21 } from "react";
 function useReviewSession({
   loadSession,
   tokensPath,
@@ -29320,7 +29576,7 @@ function useReviewSession({
     }));
     return { result, catalog };
   }, [loadSession, tokensPath]);
-  useEffect16(() => {
+  useEffect19(() => {
     let disposed = false;
     void (async () => {
       try {
@@ -29373,7 +29629,7 @@ function useReviewSession({
 function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
   const [reviewMetadata, setReviewMetadata] = useState21(null);
   const [componentRationale, setComponentRationale] = useState21(null);
-  useEffect16(() => {
+  useEffect19(() => {
     const current = components[selectedIdx];
     if (!current) {
       setReviewMetadata(null);
@@ -29402,10 +29658,16 @@ function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
   }, [components, extractSessionId, selectedIdx]);
   return { reviewMetadata, componentRationale };
 }
-function useReviewHistory({ loading, components, createSnapshot, applySnapshot }) {
+function useReviewHistory({
+  loading,
+  components,
+  createSnapshot,
+  applySnapshot,
+  onAction
+}) {
   const historyRef = useRef13(null);
   const historySeededRef = useRef13(false);
-  useEffect16(() => {
+  useEffect19(() => {
     if (loading || historySeededRef.current) return;
     historySeededRef.current = true;
     historyRef.current = createHistoryStack(createSnapshot(components));
@@ -29413,14 +29675,19 @@ function useReviewHistory({ loading, components, createSnapshot, applySnapshot }
   const pushHistorySnapshot = (entries, label) => {
     if (!historyRef.current) return;
     historyRef.current.push(createSnapshot(entries), label);
+    onAction?.(label);
   };
   const handleUndo = () => {
     const snapshot = historyRef.current?.undo();
-    if (snapshot) applySnapshot(snapshot);
+    if (!snapshot) return;
+    applySnapshot(snapshot);
+    onAction?.("undo");
   };
   const handleRedo = () => {
     const snapshot = historyRef.current?.redo();
-    if (snapshot) applySnapshot(snapshot);
+    if (!snapshot) return;
+    applySnapshot(snapshot);
+    onAction?.("redo");
   };
   const resetHistory = (snapshot) => {
     historyRef.current?.reset(snapshot);
@@ -29487,7 +29754,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 useEffect20, useRef as useRef14, useState as useState22 } from "react";
 function parseReviewEntry(draftValue) {
   const parsed = JSON.parse(draftValue);
   const keys = Object.keys(parsed);
@@ -29521,7 +29788,7 @@ function useReviewEditor({
   const [tokenReviewEditSelection, setTokenReviewEditSelection] = useState22(/* @__PURE__ */ new Set());
   const tokenReviewSuggestedRef = useRef14(/* @__PURE__ */ new Map());
   const pendingGRef = useRef14(false);
-  useEffect17(() => {
+  useEffect20(() => {
     setTokenReviewRow(0);
     setTokenReviewEditing(false);
     setTokenReviewEditCursor(0);
@@ -30003,7 +30270,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 useEffect21, useRef as useRef15, useState as useState24 } from "react";
 function useLivePreview(opts) {
   const debounceMs = opts.debounceMs ?? DEFAULT_DEBOUNCE_MS;
   const [status, setStatus] = useState24("idle");
@@ -30013,14 +30280,14 @@ function useLivePreview(opts) {
   const latestRef = useRef15(0);
   const inflightRef = useRef15(0);
   const optsRef = useRef15(opts);
-  useEffect18(() => {
+  useEffect21(() => {
     optsRef.current = opts;
   });
   const disabledRef = useRef15(disabled);
-  useEffect18(() => {
+  useEffect21(() => {
     disabledRef.current = disabled;
   }, [disabled]);
-  useEffect18(() => {
+  useEffect21(() => {
     return () => {
       if (timerRef.current) {
         clearTimeout(timerRef.current);
@@ -30101,7 +30368,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 useEffect22, useState as useState25 } from "react";
 function useReviewPreview({
   components,
   loading,
@@ -30143,13 +30410,13 @@ function useReviewPreview({
     deleteAllComponents
   });
   const [spinnerTick, setSpinnerTick] = useState25(0);
-  useEffect19(() => {
+  useEffect22(() => {
     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(() => {
+  useEffect22(() => {
     if (loading) return;
     if (!livePreview) return;
     if (components.length === 0) return;
@@ -30167,6 +30434,127 @@ var init_use_review_preview = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/import/steps/09-review/review-log.ts
+function reviewInputs(components) {
+  return { components: components.length, by_status: countStatuses(components) };
+}
+function openReviewTrail(components, now) {
+  return {
+    startedAt: now,
+    start: new Map(components.map((component) => [component.key, component.status])),
+    actions: [],
+    kinds: {}
+  };
+}
+function recordReviewAction(trail, label) {
+  const kind = label.split(":")[0] ?? label;
+  trail.kinds[kind] = (trail.kinds[kind] ?? 0) + 1;
+  if (trail.actions.length < MAX_ACTIONS) trail.actions.push(label);
+}
+function render(trail, components, now, outcome) {
+  const acceptedByUser = [];
+  const rejectedByUser = [];
+  for (const { key, status } of components) {
+    const was = trail.start.get(key);
+    if (was === status) continue;
+    if (status === "accepted") acceptedByUser.push(key);
+    if (status === "rejected") rejectedByUser.push(key);
+  }
+  const total = Object.values(trail.kinds).reduce((sum, count) => sum + count, 0);
+  return {
+    outcome,
+    seconds: Math.round((now - trail.startedAt) / 100) / 10,
+    edits: { total, by_kind: trail.kinds, in_order: trail.actions },
+    now: countStatuses(components),
+    accepted_by_user: capped2(acceptedByUser),
+    rejected_by_user: capped2(rejectedByUser)
+  };
+}
+function reviewProgress(trail, components, now) {
+  return render(trail, components, now, "interrupted");
+}
+function reviewFinish(trail, components, now, final) {
+  const outcome = final ? `finalized: ${final.accepted} accepted, ${final.rejected} rejected, ${final.unresolved} unresolved` : "left the review without finishing";
+  return {
+    outputs: render(trail, components, now, outcome),
+    status: "success",
+    exitMethod: final ? "saved" : "discarded"
+  };
+}
+var REVIEW_RUN, MAX_ACTIONS, MAX_NAMES2, countStatuses, capped2;
+var init_review_log = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/09-review/review-log.ts"() {
+    "use strict";
+    REVIEW_RUN = { flow: "import/review", step: "09-review", menuOption: "Review" };
+    MAX_ACTIONS = 30;
+    MAX_NAMES2 = 20;
+    countStatuses = (components) => {
+      const counts = {};
+      for (const { status } of components) counts[status] = (counts[status] ?? 0) + 1;
+      return counts;
+    };
+    capped2 = (keys) => ({
+      count: keys.length,
+      keys: keys.slice(0, MAX_NAMES2)
+    });
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-log.ts
+import { useEffect as useEffect23, useRef as useRef16 } from "react";
+function useReviewLog({
+  loading,
+  loadError,
+  components
+}) {
+  const trail = useRef16(void 0);
+  const started = useRef16(false);
+  const latest = useRef16(components);
+  latest.current = components;
+  useEffect23(() => {
+    if (loading || started.current) return;
+    started.current = true;
+    startDebugRun({ ...REVIEW_RUN, inputs: reviewInputs(components) });
+    if (loadError) {
+      void finishDebugRun({
+        outputs: { outcome: "could not load the components", error: loadError },
+        status: "error",
+        exitMethod: "discarded"
+      });
+      return;
+    }
+    trail.current = openReviewTrail(components, Date.now());
+    setDebugRunProgress(reviewProgress(trail.current, components, Date.now()));
+  }, [loading, loadError, components]);
+  useEffect23(
+    () => () => {
+      const open = trail.current;
+      trail.current = void 0;
+      if (open) void finishDebugRun(reviewFinish(open, latest.current, Date.now(), void 0));
+    },
+    []
+  );
+  return {
+    record: (label) => {
+      if (!trail.current) return;
+      recordReviewAction(trail.current, label);
+      setDebugRunProgress(reviewProgress(trail.current, latest.current, Date.now()));
+    },
+    finish: (counts) => {
+      const open = trail.current;
+      trail.current = void 0;
+      if (open) void finishDebugRun(reviewFinish(open, latest.current, Date.now(), counts));
+    }
+  };
+}
+var init_use_review_log = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-log.ts"() {
+    "use strict";
+    init_debug_store();
+    init_review_log();
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/components/LivePreviewSummary.tsx
 import { Box as Box37, Text as Text39 } from "ink";
 import { jsx as jsx47, jsxs as jsxs37 } from "react/jsx-runtime";
@@ -30206,7 +30594,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 useEffect24, useMemo as useMemo6, useRef as useRef17, 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";
@@ -30403,6 +30791,7 @@ function GenerateReviewStepView({
     tokensPath,
     onExtraLoaded: setLoadedSlotCycles
   });
+  const reviewLog = useReviewLog({ loading, loadError, components });
   const [nav, setNav] = useState26({
     cursorRowIdx: 0,
     sidebarScrollOffset: 0
@@ -30420,7 +30809,7 @@ function GenerateReviewStepView({
     setFinalizeError
   } = reviewSurface;
   const [removedBannerCollapsed, setRemovedBannerCollapsed] = useState26(false);
-  const removedBannerDefaultedRef = useRef16(false);
+  const removedBannerDefaultedRef = useRef17(false);
   const [cyclePanelScroll, setCyclePanelScroll] = useState26(0);
   const [cyclesCursor, setCyclesCursor] = useState26(0);
   const cyclePanel = useOverlayPanel({
@@ -30440,7 +30829,7 @@ function GenerateReviewStepView({
   const [breakCursor, setBreakCursor] = useState26(0);
   const [breakConfirm, setBreakConfirm] = useState26(false);
   const [expandedGroups, setExpandedGroups] = useState26(/* @__PURE__ */ new Set());
-  const seededGroupsRef = useRef16(false);
+  const seededGroupsRef = useRef17(false);
   const {
     searchOpen,
     setSearchOpen,
@@ -30464,7 +30853,7 @@ function GenerateReviewStepView({
   const [pendingEditorFocus, setPendingEditorFocus] = useState26(null);
   const [autoRejected, setAutoRejected] = useState26([]);
   const [undoSnapshot, setUndoSnapshot] = useState26(null);
-  const autoRejectFiredRef = useRef16(false);
+  const autoRejectFiredRef = useRef17(false);
   const [showReloadDialog, setShowReloadDialog] = useState26(false);
   const acceptedCountForPreview = components.filter((c2) => c2.status === "accepted").length;
   const { previewAnnotations, removedComponents, livePreviewHook, livePreviewSpinner } = useReviewPreview({
@@ -30496,7 +30885,10 @@ function GenerateReviewStepView({
     cmaToken,
     host,
     components,
-    onFinalize
+    onFinalize: (accepted, rejected, unresolved) => {
+      reviewLog.finish({ accepted, rejected, unresolved });
+      onFinalize(accepted, rejected, unresolved);
+    }
   });
   const recomputeCycles = (currentComponents) => {
     try {
@@ -30527,7 +30919,7 @@ function GenerateReviewStepView({
     [components]
   );
   const closures = useMemo6(() => computeAllClosures(componentGraph), [componentGraph]);
-  useEffect20(() => {
+  useEffect24(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && slotCycles.length === 0) return;
     seededGroupsRef.current = true;
@@ -30554,7 +30946,7 @@ function GenerateReviewStepView({
       suggestedBreak: cycle.edges.length > 0 ? suggestCycleBreakEdge2(cycle, cycleView.pushBlocking) : null
     }));
   }, [slotCycles, cycleView]);
-  useEffect20(() => {
+  useEffect24(() => {
     const decision = computeAutoRejectDecision({
       loading,
       autoRejectFired: autoRejectFiredRef.current,
@@ -30595,10 +30987,11 @@ function GenerateReviewStepView({
       autoRejected,
       undoSnapshot
     }),
-    applySnapshot: applyHistorySnapshot
+    applySnapshot: applyHistorySnapshot,
+    onAction: reviewLog.record
   });
-  const autoRejectPushedRef = useRef16(false);
-  useEffect20(() => {
+  const autoRejectPushedRef = useRef17(false);
+  useEffect24(() => {
     if (loading) return;
     if (!historySeededRef.current) return;
     if (!autoRejectFiredRef.current) return;
@@ -30682,7 +31075,7 @@ function GenerateReviewStepView({
   const panelHeight = leftPanelHeight + 2;
   const panelContentHeight = Math.max(1, panelHeight - 3);
   const cycleViewportHeight = Math.max(1, panelHeight - 4);
-  useEffect20(() => {
+  useEffect24(() => {
     if (selectableRowPositions.length === 0) return;
     const cursorInRange = selectableRowPositions.includes(cursorRowIdx);
     const maxScroll = Math.max(0, visibleRowsMemo.length - visibleCount);
@@ -31511,6 +31904,7 @@ var init_generate_review_step = __esm({
     init_ReviewDialogs();
     init_review_input();
     init_use_review_preview();
+    init_use_review_log();
     init_LivePreviewSummary();
     HELP_SECTIONS2 = [
       {
@@ -31764,10 +32158,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 useEffect25, useState as useState27 } from "react";
 function useBlinkingCursor() {
   const [visible, setVisible] = useState27(true);
-  useEffect21(() => {
+  useEffect25(() => {
     const interval = setInterval(() => setVisible((current) => !current), 500);
     return () => clearInterval(interval);
   }, []);
@@ -31904,12 +32298,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 useEffect26, 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(() => {
+  useEffect26(() => {
     const timer = setInterval(() => setElapsedSeconds((current) => current + 1), 1e3);
     return () => {
       clearInterval(timer);
@@ -32178,7 +32572,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 useEffect27, 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) {
@@ -32388,7 +32782,7 @@ function WizardPreviewStep({
   const activeLines = diffExpanded ? diffLines : summaryLines;
   const maxScroll = Math.max(0, activeLines.length - viewportHeight);
   const boundedScrollOffset = Math.min(scrollOffset, maxScroll);
-  useEffect23(() => {
+  useEffect27(() => {
     setScrollOffset((previous) => Math.min(previous, maxScroll));
   }, [maxScroll]);
   useImmediateInput((input, key) => {
@@ -32498,6 +32892,205 @@ var init_run_teaser = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/flow-log.ts
+function previewSummary(preview) {
+  const counts = (group) => ({
+    new: group.new.length,
+    changed: group.changed.length,
+    removed: group.removed.length
+  });
+  return {
+    components: counts(preview.components),
+    tokens: counts(preview.tokens),
+    breaking_components: preview.components.changed.filter(
+      (entry) => entry.changeClassification?.classification === "breaking"
+    ).length
+  };
+}
+function pushSummary(result, state2) {
+  const failures = result.failures ?? [];
+  return {
+    component_types: result.componentTypes,
+    design_tokens: result.designTokens,
+    ...result.summary ? { summary: result.summary } : {},
+    ...failures.length > 0 ? {
+      failure_count: failures.length,
+      failures: failures.slice(0, MAX_LOGGED).map((failure) => ({
+        entity_type: failure.entityType,
+        entity_id: failure.entityId,
+        message: scrub(failure.message, state2)
+      }))
+    } : {}
+  };
+}
+function flowContext(state2) {
+  return {
+    agent: state2.agent,
+    space_id: state2.spaceId,
+    environment_id: state2.environmentId,
+    host: state2.host,
+    credentials_skipped: state2.credentialsSkipped,
+    components_generated: state2.generatedCount,
+    components_accepted: state2.generatedAcceptedCount,
+    tokens: state2.tokenCount,
+    cma_token: state2.cmaToken
+  };
+}
+function arrive(trail, state2) {
+  const next = { ...trail, at: state2.step };
+  if (state2.step === "error") {
+    next.failure = { step: state2.errorStep, message: scrub(state2.errorMessage, state2) };
+  }
+  if (state2.step === "preview-validation-error") {
+    next.validation = {
+      count: state2.previewValidationErrors.length,
+      errors: state2.previewValidationErrors.slice(0, MAX_LOGGED).map((error) => ({
+        component: error.componentName,
+        path: error.path,
+        message: scrub(error.message, state2)
+      })),
+      missing_names: state2.previewValidationMissingNames.slice(0, MAX_LOGGED * 2)
+    };
+  }
+  return next;
+}
+function openTrail(state2, now) {
+  return arrive({ startedAt: now, stageStartedAt: now, at: state2.step, stages: [] }, state2);
+}
+function advance(trail, from, to, now) {
+  const next = { ...trail, stages: [...trail.stages], stageStartedAt: now };
+  const failed = to.step === "error" || to.step === "preview-validation-error" || from.step === "pushing" && pushHasFailures(to.pushResult);
+  if (WORK.includes(from.step)) {
+    next.stages.push(`${LABELS[from.step]}: ${failed ? "failed" : "ok"} (${seconds(now - trail.stageStartedAt)}s)`);
+  }
+  if (from.step === "previewing" && to.serverPreview) next.preview = previewSummary(to.serverPreview);
+  if (from.step === "pushing") {
+    next.push = pushSummary(to.pushResult, to);
+    next.pushFailed = pushHasFailures(to.pushResult);
+  }
+  if (from.step === "printing" && !failed) next.saved = { path: to.componentsPath, run_id: to.lastRunId };
+  return arrive(next, to);
+}
+function render2(trail, now, outcome) {
+  return {
+    outcome,
+    total_seconds: seconds(now - trail.startedAt),
+    stages: trail.stages,
+    ...trail.preview ? { preview: trail.preview } : {},
+    ...trail.push ? { push: trail.push } : {},
+    ...trail.saved ? { saved: trail.saved } : {},
+    ...trail.failure ? { error: trail.failure } : {},
+    ...trail.validation ? { preview_validation: trail.validation } : {}
+  };
+}
+function flowProgress(trail, now) {
+  return render2(trail, now, `interrupted at ${LABELS[trail.at]}`);
+}
+function flowFinish(trail, final, now) {
+  if (!final) {
+    const midWork = WORK.includes(trail.at);
+    const outcome2 = `left the import ${midWork ? "while" : "at"} ${LABELS[trail.at]}${midWork ? " was running" : ""}`;
+    return { outputs: render2(trail, now, outcome2), status: midWork ? "error" : "success", exitMethod: "discarded" };
+  }
+  if (final.step === "final-review") {
+    return {
+      outputs: render2(trail, now, "went back to edit the definitions"),
+      status: "success",
+      exitMethod: "discarded"
+    };
+  }
+  let outcome;
+  let failed = true;
+  if (trail.validation) {
+    outcome = `blocked by ${String(trail.validation["count"])} preview validation error(s)`;
+  } else if (trail.failure) {
+    outcome = `failed at ${trail.failure.step}: ${trail.failure.message.slice(0, MAX_OUTCOME)}`;
+  } else if (trail.pushFailed) {
+    outcome = "pushed, but some entities failed";
+  } else {
+    failed = false;
+    outcome = final.credentialsSkipped ? "saved without pushing (credentials skipped)" : "published";
+  }
+  return {
+    outputs: render2(trail, now, outcome),
+    status: failed ? "error" : "success",
+    exitMethod: failed ? "discarded" : "saved"
+  };
+}
+var FLOW_RUN, LABELS, WORK, FINISHED, MAX_LOGGED, MAX_OUTCOME, scrub, seconds, pushHasFailures, isFlowFinished;
+var init_flow_log = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/flow-log.ts"() {
+    "use strict";
+    init_debug_trail();
+    FLOW_RUN = { flow: "import/publish", step: "10-publish", menuOption: "Publish" };
+    LABELS = {
+      "final-review": "Final review",
+      "path-prompt": "Save path",
+      printing: "Save files",
+      previewing: "Preview",
+      "preview-gate": "Preview confirmation",
+      pushing: "Push",
+      "print-gate": "Files saved",
+      done: "Done",
+      error: "Error",
+      "preview-validation-error": "Preview validation"
+    };
+    WORK = ["printing", "previewing", "pushing"];
+    FINISHED = ["done", "error", "preview-validation-error", "final-review"];
+    MAX_LOGGED = 10;
+    MAX_OUTCOME = 200;
+    scrub = (text, state2) => scrubError(text, [state2.cmaToken]);
+    seconds = (ms) => Math.round(ms / 100) / 10;
+    pushHasFailures = (result) => result.componentTypes.failed + result.designTokens.failed > 0 || (result.failures?.length ?? 0) > 0 || (result.summary?.failed ?? 0) > 0;
+    isFlowFinished = (step) => FINISHED.includes(step);
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow-log.ts
+import { useEffect as useEffect28, useRef as useRef18 } from "react";
+function useFlowLog(state2) {
+  const trail = useRef18(void 0);
+  const previous = useRef18(void 0);
+  useEffect28(() => {
+    const before = previous.current;
+    previous.current = state2;
+    const moved = before !== void 0 && before.step !== state2.step;
+    const now = Date.now();
+    let open = trail.current;
+    if (!open) {
+      if (state2.step === "final-review" || before && !moved) return;
+      open = openTrail(state2, now);
+      startDebugRun({ ...FLOW_RUN, inputs: flowContext(state2) });
+    } else if (before && moved) {
+      open = advance(open, before, state2, now);
+    } else {
+      return;
+    }
+    if (isFlowFinished(state2.step)) {
+      trail.current = void 0;
+      void finishDebugRun(flowFinish(open, state2, now));
+      return;
+    }
+    trail.current = open;
+    setDebugRunProgress(flowProgress(open, now));
+  }, [state2]);
+  useEffect28(
+    () => () => {
+      const open = trail.current;
+      trail.current = void 0;
+      if (open) void finishDebugRun(flowFinish(open, void 0, Date.now()));
+    },
+    []
+  );
+}
+var init_use_flow_log = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow-log.ts"() {
+    "use strict";
+    init_debug_store();
+    init_flow_log();
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/screen.tsx
 import { Box as Box45 } from "ink";
 import { jsx as jsx56, jsxs as jsxs45 } from "react/jsx-runtime";
@@ -32512,6 +33105,7 @@ function FlowScreen({
   generatePromptPath,
   onExit
 }) {
+  useFlowLog(state2);
   const produced = producedOf(state2);
   const counts = { components: state2.generatedAcceptedCount, tokens: state2.tokenCount };
   const things = countedThings(produced, counts);
@@ -32639,6 +33233,7 @@ var init_screen11 = __esm({
     init_WizardPreviewStep();
     init_produced();
     init_run_teaser();
+    init_use_flow_log();
   }
 });
 
@@ -33031,7 +33626,7 @@ function buildSavedCDF(components, tokens, opts = {}) {
   if (!cdf) throw new Error("nothing to save \u2014 no components or tokens resolved");
   const validation = validateCDF2(cdf);
   if (!validation.valid) {
-    throw new Error(`generated CDF failed validation: ${validation.errors.map(describeCdfError).join("; ")}`);
+    throw new Error(`generated CDF failed validation: ${validation.errors.map((error) => error.message).join(", ")}`);
   }
   return cdf;
 }
@@ -33049,11 +33644,7 @@ async function runPrintFiles(input, deps, onPatch) {
       db.close();
     }
     if (!input.tokenSessionId && input.tokensPath) tokens = await deps.readTokens(input.tokensPath);
-    const cdf = buildSavedCDF(components, tokens, {
-      deleteAll: input.allowEmpty,
-      onRepair: (message) => deps.warn(`${message}
-`)
-    });
+    const cdf = buildSavedCDF(components, tokens, { deleteAll: input.allowEmpty });
     await deps.writeFile(componentsPath, `${JSON.stringify(cdf, null, 2)}
 `);
     deps.warn(
@@ -33114,7 +33705,7 @@ async function recordRun(input, deps) {
     return null;
   }
 }
-var SAVE_CONFIRMATION_DELAY_MS, describeCdfError, realSaveDeps;
+var SAVE_CONFIRMATION_DELAY_MS, realSaveDeps;
 var init_save = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/save.ts"() {
     "use strict";
@@ -33122,7 +33713,6 @@ var init_save = __esm({
     init_src4();
     init_run_print_files_helpers();
     SAVE_CONFIRMATION_DELAY_MS = 1e3;
-    describeCdfError = (error) => `${error.path.replace(/^\//, "").replace("/$properties/", ".").replaceAll("/", ".")}: ${error.message}`;
     realSaveDeps = () => ({
       openDb: openPipelineDb,
       readTokens: (path5) => readTokensFromPath2({ flag: "tokens", path: path5 }),
@@ -33441,9 +34031,9 @@ 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 useEffect29, useRef as useRef19, useSyncExternalStore } from "react";
 function useFlow(start, options = {}) {
-  const controller = useRef17();
+  const controller = useRef19();
   if (start && !controller.current) {
     try {
       startWizardLog();
@@ -33460,7 +34050,7 @@ function useFlow(start, options = {}) {
     (listener) => current?.subscribe(listener) ?? (() => void 0),
     () => current?.getState()
   );
-  useEffect24(() => {
+  useEffect29(() => {
     if (!start) controller.current = void 0;
   }, [start]);
   return current && state2 ? { controller: current, state: state2 } : void 0;
@@ -33539,7 +34129,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 useEffect30, 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 }) {
@@ -33553,7 +34143,7 @@ function Section({ title, rows }) {
 }
 function HelpScreen({ onDone }) {
   const [info, setInfo] = useState31();
-  useEffect25(() => {
+  useEffect30(() => {
     startDebugRun({ flow: "help", step: "01-help", menuOption: "Help", inputs: {} });
     void readHelpInfo().then(setInfo);
   }, []);
@@ -33661,45 +34251,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";
@@ -33765,7 +34316,7 @@ async function testAgent(name, binary, model) {
       timeoutMs: PROMPT_TIMEOUT_MS
     })
   );
-  const seconds = ((Date.now() - started) / 1e3).toFixed(1);
+  const seconds2 = ((Date.now() - started) / 1e3).toFixed(1);
   if (result.timedOut) {
     return [...checks, { ...fail3("prompt", `no answer within ${PROMPT_TIMEOUT_MS / 1e3}s`), timedOut: true }];
   }
@@ -33773,7 +34324,7 @@ async function testAgent(name, binary, model) {
     const reason = result.stderr.trim().split("\n").pop()?.slice(0, 160) || `exited with code ${result.exitCode}`;
     return [...checks, fail3("prompt", reason)];
   }
-  return [...checks, pass("prompt", `answered in ${seconds}s`)];
+  return [...checks, pass("prompt", `answered in ${seconds2}s`)];
 }
 function statusFromChecks(name, checks, savedBinary) {
   if (checks.length === 0) return "checking";
@@ -33974,7 +34525,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 useEffect31, 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() {
@@ -33995,7 +34546,7 @@ function AgentDetail({
   const [testing, setTesting] = useState33(false);
   const [notice, setNotice] = useState33(null);
   const [checks, setChecks] = useState33(void 0);
-  useEffect26(() => {
+  useEffect31(() => {
     let active = true;
     setChecks(void 0);
     const timer = setTimeout(() => {
@@ -34087,7 +34638,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 useEffect32, useRef as useRef20, 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 }) {
@@ -34098,7 +34649,7 @@ function AgentsScreen({ onDone }) {
   const [saving, setSaving] = useState34(false);
   const [loadError, setLoadError] = useState34(null);
   const [checks, setChecks] = useState34({});
-  const visit = useRef18({
+  const visit = useRef20({
     trail: createTrail(),
     before: void 0,
     environment: void 0,
@@ -34111,7 +34662,7 @@ function AgentsScreen({ onDone }) {
       );
     }
   };
-  useEffect27(() => {
+  useEffect32(() => {
     readAgentConfig().then((loaded) => {
       setConfig(loaded);
       inspectAll(loaded);
@@ -34337,7 +34888,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 useEffect33, useRef as useRef21, 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) {
@@ -34356,14 +34907,14 @@ function ProjectScreen({ onDone }) {
   const [saving, setSaving] = useState35(false);
   const [notice, setNotice] = useState35(null);
   const [loadError, setLoadError] = useState35(null);
-  const visit = useRef19({
+  const visit = useRef21({
     trail: createTrail(),
     before: void 0,
     persisted: void 0,
     error: ""
   }).current;
-  const scrub = (err) => scrubError(err, [config?.cmaToken ?? ""]);
-  useEffect28(() => {
+  const scrub2 = (err) => scrubError(err, [config?.cmaToken ?? ""]);
+  useEffect33(() => {
     readCredentials().then((cfg) => {
       setConfig(cfg);
       visit.before = snapshotOf(cfg);
@@ -34430,7 +34981,7 @@ function ProjectScreen({ onDone }) {
       if (config.contentfulBaseDir) void startDebugSessionIn(config.contentfulBaseDir, { replace: true });
       setNotice({ kind: "success", text: "Project settings saved" });
     }).catch((err) => {
-      visit.error = scrub(err);
+      visit.error = scrub2(err);
       visit.trail.record("save failed");
       setNotice({ kind: "error", text: err instanceof Error ? err.message : "Failed to save" });
     }).finally(() => setSaving(false));
@@ -34550,13 +35101,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 useEffect34, 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(() => {
+  useEffect34(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -34619,7 +35170,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 useEffect35, useRef as useRef22, 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 }) {
@@ -34629,8 +35180,8 @@ function DebugModeScreen({ onDone }) {
     RETENTION_CHOICES[RETENTION_CHOICES.length - 1]
   );
   const [notice, setNotice] = useState38(null);
-  const visit = useRef20({ trail: createTrail(), before: void 0, error: "" }).current;
-  useEffect30(() => {
+  const visit = useRef22({ trail: createTrail(), before: void 0, error: "" }).current;
+  useEffect35(() => {
     readDebugModeSetting().then((loaded) => {
       setSetting(loaded);
       setPending(loaded.retentionDays);
@@ -34771,7 +35322,7 @@ var app_exports = {};
 __export(app_exports, {
   runApp: () => runApp
 });
-import { useEffect as useEffect31, useState as useState39 } from "react";
+import { useEffect as useEffect36, 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");
@@ -34805,7 +35356,7 @@ function App({ importOptions, inkClear }) {
   const [flowStart, setFlowStart] = useState39();
   const flow = useFlow(flowStart, { beforeStepChange: inkClear });
   const [importDefaults, setImportDefaults] = useState39();
-  useEffect31(() => {
+  useEffect36(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -34878,7 +35429,7 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect31(() => {
+  useEffect36(() => {
     if (!tokensOnlyRun || tokensOnly?.status !== "done" || !tokensOnly.result.ok) return;
     const { credentialsSkipped, input, tokens } = tokensOnlyRun;
     const { tokensPath, tokenSessionId, tokenCount } = tokensOnly.result;
@@ -34900,12 +35451,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   }, [tokensOnly, tokensOnlyRun]);
-  useEffect31(() => {
+  useEffect36(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect31(() => {
+  useEffect36(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -34923,7 +35474,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect31(() => {
+  useEffect36(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -35092,6 +35643,7 @@ function App({ importOptions, inkClear }) {
         return /* @__PURE__ */ jsx66(
           CredentialsScreen,
           {
+            mode: target,
             initial: importDefaults.credentials,
             tokensOnly: target === "tokens",
             onBack: () => goBackFrom("credentials"),
@@ -35229,9 +35781,9 @@ var pkg = JSON.parse(
 function createProgram() {
   const program = new Command().name("experiences").description("Contentful Experiences design system import CLI").version(pkg.version, "--version", "Print version number");
   registerImportCommand(program, async (options) => {
-    const { render } = await import("ink");
+    const { render: render3 } = await import("ink");
     const { runApp: runApp2 } = await Promise.resolve().then(() => (init_app(), app_exports));
-    await runApp2(render, options);
+    await runApp2(render3, options);
   });
   program.hook("preAction", async (_thisCommand, actionCommand) => {
     const chain = [];