@contentful/experience-design-system-cli 2.39.1 → 2.40.1-dev-build-08f065f9.0

package/dist/index.js

@@ -19407,6 +19407,325 @@ var init_PageContainer = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts
+function toRetentionDays(value) {
+  return RETENTION_CHOICES.find((choice) => choice === value) ?? DEFAULT_RETENTION_DAYS;
+}
+async function readDebugModeSetting() {
+  const { debugMode } = await readSettings2();
+  const saved = debugMode ?? {};
+  return {
+    enabled: typeof saved.enabled === "boolean" ? saved.enabled : true,
+    retentionDays: toRetentionDays(saved.retentionDays)
+  };
+}
+async function writeDebugModeSetting(change) {
+  await updateSettings2({ debugMode: { ...await readDebugModeSetting(), ...change } });
+}
+var RETENTION_CHOICES, DEFAULT_RETENTION_DAYS;
+var init_debug_mode_store = __esm({
+  "packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts"() {
+    "use strict";
+    init_config();
+    RETENTION_CHOICES = [7, 14, 30];
+    DEFAULT_RETENTION_DAYS = 30;
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/debug-prune.ts
+import { readdir as readdir2, rm, rmdir, stat as stat4 } from "node:fs/promises";
+import { dirname as dirname15, join as join18 } from "node:path";
+async function logFilesIn(dir) {
+  const entries = await readdir2(dir, { withFileTypes: true });
+  const nested = await Promise.all(
+    entries.map(async (entry) => {
+      const path5 = join18(dir, entry.name);
+      if (entry.isDirectory()) return logFilesIn(path5);
+      return entry.isFile() && entry.name.endsWith(".md") ? [path5] : [];
+    })
+  );
+  return nested.flat();
+}
+async function removeEmptyFolders(from, stop) {
+  let dir = from;
+  let removed = 0;
+  for (; ; ) {
+    try {
+      await rmdir(dir);
+    } catch {
+      return removed;
+    }
+    removed += 1;
+    if (dir === stop) return removed;
+    dir = dirname15(dir);
+  }
+}
+async function pruneExpiredLogs(base, retentionDays, now = Date.now()) {
+  const cutoff = now - retentionDays * DAY_MS;
+  const contentfulDir = join18(base, ".contentful");
+  const result = { logs: 0, folders: 0 };
+  try {
+    const sessions = (await readdir2(contentfulDir)).filter((name) => SESSION_FOLDER.test(name));
+    for (const session of sessions) {
+      const files = await logFilesIn(join18(contentfulDir, session, "debug")).catch(() => []);
+      for (const file of files) {
+        try {
+          if ((await stat4(file)).mtimeMs >= cutoff) continue;
+          await rm(file);
+          result.logs += 1;
+          result.folders += await removeEmptyFolders(dirname15(file), join18(contentfulDir, session));
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+  return result;
+}
+var DAY_MS, SESSION_FOLDER;
+var init_debug_prune = __esm({
+  "packages/experience-design-system-cli/src/tui/debug-prune.ts"() {
+    "use strict";
+    DAY_MS = 24 * 60 * 60 * 1e3;
+    SESSION_FOLDER = /^\d{2}-\d{2}-\d{4}-session-\d+$/;
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/debug-store.ts
+var debug_store_exports = {};
+__export(debug_store_exports, {
+  currentDebugSessionDir: () => currentDebugSessionDir,
+  currentSessionDir: () => currentSessionDir,
+  finishDebugRun: () => finishDebugRun,
+  startDebugRun: () => startDebugRun,
+  startDebugSessionIn: () => startDebugSessionIn,
+  startImportRun: () => startImportRun
+});
+import { mkdir as mkdir7, writeFile as writeFile7 } from "node:fs/promises";
+import { existsSync as existsSync9, readdirSync as readdirSync3 } from "node:fs";
+import { join as join19, resolve as resolve20 } from "node:path";
+function generateRunId() {
+  const now = /* @__PURE__ */ new Date();
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+}
+function datePrefix(now = /* @__PURE__ */ new Date()) {
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${pad(now.getMonth() + 1)}-${pad(now.getDate())}-${now.getFullYear()}`;
+}
+function slugify(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+async function readBaseDir() {
+  try {
+    const dir = (await readSettings2())["contentfulBaseDir"];
+    return typeof dir === "string" && dir !== "" ? resolve20(dir) : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function nextSessionId(contentfulDir) {
+  const today = datePrefix();
+  const existing = existsSync9(contentfulDir) ? readdirSync3(contentfulDir) : [];
+  const seqPattern = new RegExp(`^${today}-session-(\\d+)$`);
+  const maxSeq = existing.reduce((max, entry) => {
+    const match2 = seqPattern.exec(entry);
+    return match2 ? Math.max(max, Number(match2[1])) : max;
+  }, 0);
+  return `${today}-session-${maxSeq + 1}`;
+}
+function startSession(base, { replace }) {
+  const contentfulDir = join19(base, ".contentful");
+  if (replace || !sessionDir) sessionDir = join19(contentfulDir, nextSessionId(contentfulDir));
+  return sessionDir;
+}
+function currentDebugSessionDir() {
+  return sessionDir && join19(sessionDir, "debug");
+}
+function currentSessionDir() {
+  return sessionDir;
+}
+async function startDebugSessionIn(base, { replace = false } = {}) {
+  try {
+    if (!await isDebugModeEnabled()) return;
+    await mkdir7(join19(startSession(resolve20(base), { replace }), "debug"), { recursive: true });
+    await writeWaitingLogs();
+  } catch {
+  }
+}
+function nextImportRunDir(session) {
+  const existing = existsSync9(session) ? readdirSync3(session) : [];
+  const maxRun = existing.reduce((max, entry) => {
+    const match2 = /^dsi-import-(\d+)$/.exec(entry);
+    return match2 ? Math.max(max, Number(match2[1])) : max;
+  }, 0);
+  return join19(session, `dsi-import-${maxRun + 1}`);
+}
+async function startImportRun(projectPath) {
+  await startDebugSessionIn(projectPath);
+  if (!sessionDir) return join19(resolve20(projectPath), ".contentful");
+  const dir = nextImportRunDir(sessionDir);
+  await mkdir7(dir, { recursive: true });
+  return dir;
+}
+async function isDebugModeEnabled() {
+  try {
+    return (await readDebugModeSetting()).enabled;
+  } catch {
+    return true;
+  }
+}
+function redact(value) {
+  const clone = { ...value };
+  if ("cma_token" in clone) {
+    const raw = clone.cma_token;
+    clone.cma_token = typeof raw === "string" && raw.length > 0 ? `[present, ${raw.length} chars]` : "[not set]";
+  }
+  return clone;
+}
+function startDebugRun({
+  flow,
+  step,
+  menuOption,
+  inputs
+}) {
+  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 };
+  });
+}
+async function finishDebugRun({
+  outputs,
+  status,
+  exitMethod
+}) {
+  const run = pendingRun;
+  if (!run) return;
+  pendingRun = void 0;
+  const durationMs = Date.now() - run.startedAt;
+  const log = {
+    flow: run.flow,
+    menuOption: run.menuOption,
+    content: renderMarkdown(run, { outputs: redact(outputs), status, exitMethod, durationMs })
+  };
+  const root = currentDebugSessionDir();
+  if (!root) {
+    if (waiting.length < WAITING_LIMIT) waiting.push(log);
+    return;
+  }
+  await writeLog(root, log);
+}
+async function writeLog(root, log) {
+  const dir = join19(root, ...log.flow.split("/"));
+  await mkdir7(dir, { recursive: true });
+  const filename = nextAttemptFilename(dir, log.menuOption);
+  await writeFile7(join19(dir, filename), log.content, { mode: 384 });
+}
+async function writeWaitingLogs() {
+  const root = currentDebugSessionDir();
+  if (!root) return;
+  for (const log of waiting.splice(0)) {
+    try {
+      await writeLog(root, log);
+    } catch {
+    }
+  }
+}
+function nextAttemptFilename(dir, menuOption) {
+  const today = datePrefix();
+  const optionSlug = slugify(menuOption);
+  const existing = existsSync9(dir) ? readdirSync3(dir) : [];
+  const attemptPattern = new RegExp(`^${today}-${optionSlug}-attempt-(\\d+)\\.md$`);
+  const maxAttempt = existing.reduce((max, entry) => {
+    const match2 = attemptPattern.exec(entry);
+    return match2 ? Math.max(max, Number(match2[1])) : max;
+  }, 0);
+  return `${today}-${optionSlug}-attempt-${maxAttempt + 1}.md`;
+}
+function renderMarkdown(run, finish) {
+  const stepMatch = /^(\d+)-(.+)$/.exec(run.step);
+  const stepLabel = stepMatch ? `${stepMatch[1]} - ${stepMatch[2]}` : run.step;
+  const flowSlug = run.flow.split("/").join("-");
+  return `# Debug Log
+
+- Run ID: ${run.runId}
+- Flow: ${flowSlug}
+- Step: ${stepLabel}
+- Menu option: ${run.menuOption}
+- Date: ${(/* @__PURE__ */ new Date()).toISOString()}
+- CLI version: ${readPackageVersion()}
+- Platform: ${process.platform} / Node ${process.version}
+- Duration on screen: ${finish.durationMs}ms
+- Status: ${finish.status}
+- Exit method: ${finish.exitMethod}
+
+## Inputs
+\`\`\`json
+${JSON.stringify(run.inputs, null, 2)}
+\`\`\`
+
+## Outputs
+\`\`\`json
+${JSON.stringify(finish.outputs, null, 2)}
+\`\`\`
+`;
+}
+function handleCrash() {
+  return finishDebugRun({ outputs: {}, status: "error", exitMethod: "crashed" });
+}
+var pendingRun, sessionDir, WAITING_LIMIT, waiting;
+var init_debug_store = __esm({
+  "packages/experience-design-system-cli/src/tui/debug-store.ts"() {
+    "use strict";
+    init_config();
+    init_version();
+    init_debug_mode_store();
+    init_debug_prune();
+    void Promise.all([isDebugModeEnabled(), readBaseDir()]).then(async ([enabled, base]) => {
+      if (!base) return;
+      const retention = await readDebugModeSetting().catch(() => void 0);
+      const pruned = retention ? await pruneExpiredLogs(base, retention.retentionDays).catch(() => void 0) : void 0;
+      if (!enabled) return;
+      const debugDir = join19(startSession(base, { replace: false }), "debug");
+      await mkdir7(debugDir, { recursive: true });
+      await writeWaitingLogs();
+      if (retention && pruned && pruned.logs + pruned.folders > 0) {
+        await writeFile7(
+          join19(debugDir, `${datePrefix()}-cleanup-${generateRunId()}.md`),
+          `# Debug Log Cleanup
+
+- Date: ${(/* @__PURE__ */ new Date()).toISOString()}
+- Retention: ${retention.retentionDays} days
+- Logs deleted: ${pruned.logs}
+- Empty folders removed: ${pruned.folders}
+`,
+          { mode: 384 }
+        );
+      }
+    });
+    WAITING_LIMIT = 50;
+    waiting = [];
+    process.once("uncaughtException", (err) => {
+      void handleCrash().finally(() => {
+        throw err;
+      });
+    });
+    process.once("unhandledRejection", (reason) => {
+      void handleCrash().finally(() => {
+        throw reason;
+      });
+    });
+    process.once("SIGINT", () => {
+      void handleCrash().finally(() => {
+        process.exit(130);
+      });
+    });
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/import/steps/00-preflight/logic.ts
 function overviewFor(target) {
   return target === "tokens" ? TOKENS_ONLY_OVERVIEW : COMPONENTS_OVERVIEW;
@@ -19916,12 +20235,37 @@ var init_shared2 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/00-preflight/screen.tsx
-import { useState as useState4 } from "react";
+import { useEffect as useEffect4, useRef, useState as useState4 } from "react";
 import { Box as Box9, Text as Text9 } from "ink";
 import { jsx as jsx9, jsxs as jsxs9 } from "react/jsx-runtime";
 function PreflightScreen({ onChoose, onQuit }) {
   const [focus, setFocus] = useState4(0);
-  usePreflightControls({ focus, onFocus: setFocus, onChoose, onQuit });
+  const viewed = useRef([optionAt(0)]).current;
+  useEffect4(() => {
+    startDebugRun({
+      flow: "import/preflight",
+      step: "00-preflight",
+      menuOption: "Preflight",
+      inputs: { options: IMPORT_TARGET_OPTIONS.map((option) => option.target), initial_focus: optionAt(0) }
+    });
+  }, []);
+  const moveTo = (next) => {
+    setFocus(next);
+    if (viewed[viewed.length - 1] !== optionAt(next)) viewed.push(optionAt(next));
+  };
+  const choose = (target) => {
+    void finishDebugRun({
+      outputs: { chosen: target, viewed, steps_that_will_run: overviewFor(target).map((step) => step.description) },
+      status: "success",
+      exitMethod: "saved"
+    });
+    onChoose(target);
+  };
+  const quit = () => {
+    void finishDebugRun({ outputs: { chosen: null, viewed }, status: "success", exitMethod: "discarded" });
+    onQuit();
+  };
+  usePreflightControls({ focus, onFocus: moveTo, onChoose: choose, onQuit: quit });
   return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx9(StepHeader, { step: "setup" }),
     /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", gap: 1, paddingX: 2, paddingBottom: 1, children: [
@@ -19933,25 +20277,28 @@ function PreflightScreen({ onChoose, onQuit }) {
           /* @__PURE__ */ jsx9(Text9, { bold: focused, color: focused ? PALETTE.accent : void 0, children: option.label })
         ] }, option.target);
       }) }),
-      /* @__PURE__ */ jsx9(OverviewBox, { steps: overviewFor(IMPORT_TARGET_OPTIONS[focus].target) }),
+      /* @__PURE__ */ jsx9(OverviewBox, { steps: overviewFor(optionAt(focus)) }),
       /* @__PURE__ */ jsx9(ControlHints, { hints: PREFLIGHT_CONTROLS })
     ] })
   ] });
 }
+var optionAt;
 var init_screen = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/00-preflight/screen.tsx"() {
     "use strict";
     init_theme();
+    init_debug_store();
     init_controls();
     init_logic();
     init_shared2();
     init_ControlHints();
     init_StepHeader();
+    optionAt = (index) => IMPORT_TARGET_OPTIONS[index].target;
   }
 });
 
 // packages/experience-design-system-cli/src/tui/shared/components/ClearableTextInput.tsx
-import { useRef } from "react";
+import { useRef as useRef2 } from "react";
 import { useInput as useInput6 } from "ink";
 import TextInput from "ink-text-input";
 import { jsx as jsx10 } from "react/jsx-runtime";
@@ -19959,7 +20306,7 @@ function isClearKey(input, key) {
   return key.ctrl && input === "d";
 }
 function ClearableTextInput({ onChange, ...props }) {
-  const justCleared = useRef(false);
+  const justCleared = useRef2(false);
   useInput6((input, key) => {
     if (!isClearKey(input, key)) return;
     justCleared.current = true;
@@ -20019,15 +20366,49 @@ var init_controls4 = __esm({
 });
 
 // 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";
 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" }),
@@ -20048,6 +20429,7 @@ var init_screen2 = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/01-welcome/screen.tsx"() {
     "use strict";
     init_theme();
+    init_debug_store();
     init_ClearableTextInput();
     init_controls4();
     init_logic5();
@@ -20092,7 +20474,7 @@ var init_controls5 = __esm({
 
 // packages/experience-design-system-cli/src/tui/import/resolve-user-path.ts
 import { homedir as homedir3 } from "node:os";
-import { resolve as resolve20 } from "node:path";
+import { resolve as resolve21 } from "node:path";
 function stripQuotes(value) {
   const quoted = value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'");
   return value.length >= 2 && quoted ? value.slice(1, -1) : value;
@@ -20101,7 +20483,7 @@ function expandHome(value) {
   return value === "~" || value.startsWith("~/") || value.startsWith("~\\") ? homedir3() + value.slice(1) : value;
 }
 function resolveUserPath(raw) {
-  return resolve20(expandHome(stripQuotes(raw.trim())));
+  return resolve21(expandHome(stripQuotes(raw.trim())));
 }
 var init_resolve_user_path = __esm({
   "packages/experience-design-system-cli/src/tui/import/resolve-user-path.ts"() {
@@ -20333,7 +20715,7 @@ var init_scan_files = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/03-path-validation/screen.tsx
-import { useEffect as useEffect4, useMemo, useState as useState7 } from "react";
+import { useEffect as useEffect6, useMemo, useState as useState7 } from "react";
 import { Box as Box12, Text as Text12 } from "ink";
 import { jsx as jsx13, jsxs as jsxs12 } from "react/jsx-runtime";
 function Row({ row }) {
@@ -20389,7 +20771,7 @@ function PathValidationScreen({
 }) {
   const resolvedPath = useMemo(() => resolveUserPath(projectPath), [projectPath]);
   const [scan, setScan] = useState7();
-  useEffect4(() => {
+  useEffect6(() => {
     setScan(scanFiles(resolvedPath));
   }, [resolvedPath]);
   const phase = phaseOf(scan);
@@ -20686,7 +21068,7 @@ var init_validate4 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/04-credentials/screen.tsx
-import { useRef as useRef2, useState as useState9 } from "react";
+import { useRef as useRef4, 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({
@@ -20696,7 +21078,7 @@ function CredentialsScreen({
   validate: validate3 = validateCredentials,
   tokensOnly = false
 }) {
-  const initialValues = useRef2(
+  const initialValues = useRef4(
     normalize({
       spaceId: initial.spaceId ?? "",
       environmentId: initial.environmentId || "master",
@@ -21144,16 +21526,16 @@ var init_steps = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/find-skill-path.ts
-import { existsSync as existsSync9 } from "node:fs";
-import { dirname as dirname15, join as join18, resolve as resolve21 } from "node:path";
+import { existsSync as existsSync10 } 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) {
-  const thisDir = dirname15(fileURLToPath4(import.meta.url));
+  const thisDir = dirname16(fileURLToPath4(import.meta.url));
   let dir = thisDir;
   for (; ; ) {
-    const candidate = join18(dir, "skills", fileName);
-    if (existsSync9(candidate)) return candidate;
-    const parent = resolve21(dir, "..");
+    const candidate = join20(dir, "skills", fileName);
+    if (existsSync10(candidate)) return candidate;
+    const parent = resolve22(dir, "..");
     if (parent === dir) {
       throw new Error(`skill file not found (looked for skills/${fileName} from ${thisDir})`);
     }
@@ -21167,9 +21549,9 @@ var init_find_skill_path = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/selection.ts
-import { resolve as resolve22 } from "node:path";
+import { resolve as resolve23 } from "node:path";
 async function hashSelectPrompt(options) {
-  const promptHash = options.promptText ? hashContent(options.promptText) : options.promptPath ? await hashFile(resolve22(options.promptPath)) : await hashFile(SELECT_SKILL_PATH);
+  const promptHash = options.promptText ? hashContent(options.promptText) : options.promptPath ? await hashFile(resolve23(options.promptPath)) : await hashFile(SELECT_SKILL_PATH);
   return hashContent(`${promptHash}|${options.agent}|${options.model ?? ""}`);
 }
 async function runSelection(options) {
@@ -21263,10 +21645,10 @@ var init_selection2 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/run.ts
-import { mkdir as mkdir7 } from "node:fs/promises";
-import { join as join19, resolve as resolve23 } from "node:path";
+import { mkdir as mkdir8 } from "node:fs/promises";
+import { join as join21, resolve as resolve24 } from "node:path";
 async function runExtraction(input, onProgress, deps = realDeps) {
-  const outDir = input.outDir ?? join19(resolve23(input.projectPath), ".contentful");
+  const outDir = input.outDir ?? join21(resolve24(input.projectPath), ".contentful");
   let progress = initialProgress({
     hasCredentials: input.credentials !== null,
     hasRawTokens: input.rawTokensPath !== ""
@@ -21370,7 +21752,7 @@ async function runExtraction(input, onProgress, deps = realDeps) {
 }
 async function fetchEntities(credentials, outDir) {
   try {
-    await mkdir7(outDir, { recursive: true });
+    await mkdir8(outDir, { recursive: true });
     const result = await fetchAndPersistExistingContentfulEntities({
       spaceId: credentials.spaceId,
       environmentId: credentials.environmentId,
@@ -21390,7 +21772,7 @@ async function resolveSelectionPrompt(overrides) {
   if (select?.kind === "text") return { promptText: select.value };
   if (select?.kind === "path") {
     await resolvePromptOverride(select);
-    return { promptPath: resolve23(select.value) };
+    return { promptPath: resolve24(select.value) };
   }
   return {};
 }
@@ -21416,11 +21798,11 @@ var init_run = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/use-extraction.ts
-import { useEffect as useEffect5, useRef as useRef3, useState as useState11 } from "react";
+import { useEffect as useEffect7, useRef as useRef5, useState as useState11 } from "react";
 function useExtraction(input) {
   const [state2, setState] = useState11();
-  const current = useRef3();
-  useEffect5(() => {
+  const current = useRef5();
+  useEffect7(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -21491,11 +21873,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 useEffect6, useRef as useRef4, useState as useState12 } from "react";
+import { useEffect as useEffect8, useRef as useRef6, useState as useState12 } from "react";
 function useTokensOnly(input) {
   const [state2, setState] = useState12();
-  const current = useRef4();
-  useEffect6(() => {
+  const current = useRef6();
+  useEffect8(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -21792,6 +22174,7 @@ function GotoBanner({
       borderStyle: "single",
       borderColor: PALETTE.accent,
       paddingX: 1,
+      paddingBottom: 1,
       marginTop: width === void 0 ? 1 : 0,
       width,
       flexShrink: 0,
@@ -21803,7 +22186,7 @@ function GotoBanner({
           return renderRow(row, i, i === highlightIndex);
         }),
         moreBelow > 0 && /* @__PURE__ */ jsx24(Text21, { color: PALETTE.muted, children: `  \u25BC ${moreBelow} more` }),
-        footerHint !== void 0 && /* @__PURE__ */ jsx24(Text21, { color: PALETTE.muted, children: footerHint })
+        footerHint !== void 0 && /* @__PURE__ */ jsx24(Box21, { marginTop: 1, children: /* @__PURE__ */ jsx24(Text21, { color: PALETTE.muted, children: footerHint }) })
       ]
     }
   );
@@ -22318,11 +22701,11 @@ function buildVisibleRows(props) {
     if (!expanded) continue;
     const subtree = computeCycleMemberSubtree(key);
     const isLastAtDepthSubtree = (idx) => {
-      const own = subtree[idx].depth;
+      const own2 = subtree[idx].depth;
       for (let j = idx + 1; j < subtree.length; j++) {
         const d = subtree[j].depth;
-        if (d < own) return true;
-        if (d === own) return false;
+        if (d < own2) return true;
+        if (d === own2) return false;
       }
       return true;
     };
@@ -22442,11 +22825,11 @@ function buildVisibleRows(props) {
       injectedChildren.push({ name: c2.name, depth: c2.depth, isCycleChild: false });
     }
     const isLastAtDepth = (idx) => {
-      const own = injectedChildren[idx].depth;
+      const own2 = injectedChildren[idx].depth;
       for (let j = idx + 1; j < injectedChildren.length; j++) {
         const d = injectedChildren[j].depth;
-        if (d < own) return true;
-        if (d === own) return false;
+        if (d < own2) return true;
+        if (d === own2) return false;
       }
       return true;
     };
@@ -22691,7 +23074,7 @@ var init_GroupedSidebar = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/sidebar/hooks/useImmediateInput.ts
-import { useLayoutEffect, useRef as useRef5 } from "react";
+import { useLayoutEffect, useRef as useRef7 } from "react";
 import { useStdin } from "ink";
 function parseInput(data) {
   const isShiftTab = data === "\x1B[Z";
@@ -22753,7 +23136,7 @@ function registerInputHandler(stdin, setRawMode, handler) {
 }
 function useImmediateInput(handler, enabled = true) {
   const { stdin, setRawMode } = useStdin();
-  const handlerRef = useRef5(handler);
+  const handlerRef = useRef7(handler);
   handlerRef.current = handler;
   useLayoutEffect(() => {
     if (!enabled) return;
@@ -22771,7 +23154,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 useEffect7, useState as useState13 } from "react";
+import { useEffect as useEffect9, useState as useState13 } from "react";
 function readTerminalSize(stdout) {
   return {
     columns: stdout?.columns ?? 80,
@@ -22781,7 +23164,7 @@ function readTerminalSize(stdout) {
 function useTerminalSize() {
   const { stdout } = useStdout2();
   const [size, setSize] = useState13(() => readTerminalSize(stdout));
-  useEffect7(() => {
+  useEffect9(() => {
     const updateSize = () => setSize(readTerminalSize(stdout));
     stdout?.on("resize", updateSize);
     updateSize();
@@ -23783,7 +24166,7 @@ var init_state = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/use-scope-gate.ts
-import { useEffect as useEffect8, useMemo as useMemo3, useRef as useRef6, useState as useState16 } from "react";
+import { useEffect as useEffect10, useMemo as useMemo3, useRef as useRef8, useState as useState16 } from "react";
 function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }) {
   const { columns: totalWidth, rows: terminalRows } = useTerminalSize();
   const columnPlan = useMemo3(
@@ -23829,8 +24212,8 @@ function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }
     for (const p of cycleParticipants) seed.add(p);
     return seed;
   });
-  const seededGroupsRef = useRef6(closures.size > 0 || cycleParticipants.size > 0);
-  useEffect8(() => {
+  const seededGroupsRef = useRef8(closures.size > 0 || cycleParticipants.size > 0);
+  useEffect10(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && cycleParticipants.size === 0) return;
     seededGroupsRef.current = true;
@@ -23921,7 +24304,7 @@ function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }
     entryCount: 0
   });
   const panelLayout = useMemo3(() => computePanelLayout(visibleCount), [visibleCount]);
-  useEffect8(() => {
+  useEffect10(() => {
     setNav((prev) => {
       const maxIdx = Math.max(0, visibleRows.length - 1);
       const nextCursor = Math.min(prev.cursor, maxIdx);
@@ -24494,13 +24877,13 @@ var init_load2 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/use-scope-gate-flow.ts
-import { useEffect as useEffect9, useMemo as useMemo5, useRef as useRef7, useState as useState17 } from "react";
+import { useEffect as useEffect11, useMemo as useMemo5, useRef as useRef9, 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 = useRef7(void 0);
+  const cacheCheck = useRef9(void 0);
   const [confirmed, setConfirmed] = useState17();
-  useEffect9(() => {
+  useEffect11(() => {
     if (!input || !loaded?.ok || cacheCheck.current) return;
     cacheCheck.current = deps.checkCache(input.cache);
   }, [input, loaded]);
@@ -24535,7 +24918,7 @@ function formatAcceptanceSummary(counts) {
 function describeGeneration(input) {
   const agent = capitalize(input.agent);
   return `${formatAcceptanceSummary({ accepted: input.acceptedCount, autoRejected: 0 })}
-${agent} is reading each selected component and writing a Contentful component definition for it${input.hasTokens ? " Using your design tokens for prop resolution." : ""}`;
+${agent} is reading each selected component and writing a Contentful component definition for it.${input.hasTokens ? "\nUsing your design tokens for prop resolution." : ""}`;
 }
 function progressRows2(progress, agent) {
   const name = capitalize(agent);
@@ -24638,7 +25021,7 @@ var init_save_decisions = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/08-generation/run.ts
-import { resolve as resolve24 } from "node:path";
+import { resolve as resolve25 } from "node:path";
 async function runGeneration(input, onProgress, deps = realDeps4) {
   let progress = { components: null, mapTokens: "idle", mapTokensEligible: null };
   const update = (change) => {
@@ -24724,7 +25107,7 @@ async function buildMapTokensOptions(input) {
   if (mapOverride?.kind === "text") prompt.skillContentOverride = mapOverride.value;
   if (mapOverride?.kind === "path") {
     await resolvePromptOverride(mapOverride);
-    prompt.skillPathOverride = resolve24(mapOverride.value);
+    prompt.skillPathOverride = resolve25(mapOverride.value);
   }
   if (input.existingEntitiesPath) {
     const entities = await readExistingContentfulEntitiesFromSession({ path: input.existingEntitiesPath });
@@ -24771,11 +25154,11 @@ var init_run2 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/08-generation/use-generation.ts
-import { useEffect as useEffect10, useRef as useRef8, useState as useState18 } from "react";
+import { useEffect as useEffect12, useRef as useRef10, useState as useState18 } from "react";
 function useGeneration(input) {
   const [state2, setState] = useState18();
-  const current = useRef8();
-  useEffect10(() => {
+  const current = useRef10();
+  useEffect12(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -24802,7 +25185,7 @@ var init_use_generation = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/build-flow-start.ts
-import { join as join20 } from "node:path";
+import { join as join22 } from "node:path";
 function buildFlowStart(input) {
   const { extraction, handoff, saved, generatePromptPath, tokensOnly } = input;
   const credentials = extraction.credentials ?? {
@@ -24815,7 +25198,7 @@ function buildFlowStart(input) {
     handoff,
     agent: extraction.agent,
     projectPath: extraction.projectPath,
-    outDir: extraction.projectPath ? join20(extraction.projectPath, ".contentful") : "",
+    outDir: extraction.projectPath ? join22(extraction.projectPath, ".contentful") : "",
     rawTokensPath: extraction.rawTokensPath,
     credentials: {
       spaceId: credentials.spaceId,
@@ -25203,12 +25586,141 @@ var init_dtcg2 = __esm({
   }
 });
 
+// packages/experience-design-system-types/dist/src/property-contract/json-value.js
+var nodeTypes;
+var init_json_value = __esm({
+  "packages/experience-design-system-types/dist/src/property-contract/json-value.js"() {
+    "use strict";
+    nodeTypes = globalThis.process?.getBuiltinModule?.("node:util")?.types;
+  }
+});
+
+// packages/experience-design-system-types/dist/src/property-contract/date-time-value.js
+import * as z5 from "zod/mini";
+var dateTimeValueSchema;
+var init_date_time_value = __esm({
+  "packages/experience-design-system-types/dist/src/property-contract/date-time-value.js"() {
+    "use strict";
+    dateTimeValueSchema = z5.iso.datetime({ offset: true });
+  }
+});
+
+// packages/experience-design-system-types/dist/src/property-contract/discriminated-union.js
+var init_discriminated_union = __esm({
+  "packages/experience-design-system-types/dist/src/property-contract/discriminated-union.js"() {
+    "use strict";
+    init_json_value();
+  }
+});
+
+// packages/experience-design-system-types/dist/src/property-contract/target-definition.js
+var TARGET_PROPERTY_TYPES, SAME_SPACE_RESOURCE_SOURCE, targetDefinitionJsonSchema;
+var init_target_definition = __esm({
+  "packages/experience-design-system-types/dist/src/property-contract/target-definition.js"() {
+    "use strict";
+    init_json_value();
+    init_date_time_value();
+    init_discriminated_union();
+    TARGET_PROPERTY_TYPES = [
+      "String",
+      "Number",
+      "Boolean",
+      "Array",
+      "Record",
+      "Integer",
+      "DateTime",
+      "RichText",
+      "JSON",
+      "ResourceLink",
+      "Literal",
+      "DiscriminatedUnion"
+    ];
+    SAME_SPACE_RESOURCE_SOURCE = "crn:contentful:::content:spaces/$self/environments/$self";
+    targetDefinitionJsonSchema = {
+      $schema: "http://json-schema.org/draft-07/schema#",
+      $ref: "#/definitions/target",
+      definitions: {
+        target: {
+          type: "object",
+          required: ["type"],
+          properties: {
+            type: { enum: [...TARGET_PROPERTY_TYPES] },
+            id: { type: "string" },
+            name: { type: "string" },
+            description: { type: "string" },
+            required: { type: "boolean" },
+            values: { type: "array", minItems: 1 },
+            defaultValue: {},
+            items: { $ref: "#/definitions/target" },
+            fields: { type: "object", minProperties: 1, additionalProperties: { $ref: "#/definitions/target" } },
+            allowedResources: {
+              type: "array",
+              minItems: 1,
+              items: {
+                type: "object",
+                required: ["type", "source"],
+                properties: {
+                  type: { enum: ["Contentful:Entry", "Contentful:Asset"] },
+                  source: { const: SAME_SPACE_RESOURCE_SOURCE },
+                  allowedTypes: { type: "array", items: { type: "string" } }
+                },
+                allOf: [
+                  {
+                    if: { properties: { type: { const: "Contentful:Entry" } } },
+                    then: { required: ["allowedTypes"] },
+                    else: { not: { required: ["allowedTypes"] } }
+                  }
+                ],
+                additionalProperties: false
+              }
+            },
+            value: {},
+            valueType: { $ref: "#/definitions/target" },
+            discriminator: { type: "string", minLength: 1 },
+            members: {
+              type: "array",
+              minItems: 2,
+              uniqueItems: true,
+              items: {
+                allOf: [
+                  { $ref: "#/definitions/target" },
+                  { type: "object", properties: { type: { const: "Record" } }, required: ["type", "fields"] }
+                ]
+              }
+            }
+          },
+          allOf: [
+            {
+              if: { properties: { type: { const: "DiscriminatedUnion" } } },
+              then: { required: ["discriminator", "members"] },
+              else: { not: { anyOf: [{ required: ["discriminator"] }, { required: ["members"] }] } }
+            }
+          ],
+          additionalProperties: false
+        }
+      }
+    };
+  }
+});
+
+// packages/experience-design-system-types/dist/src/property-contract/index.js
+var init_property_contract = __esm({
+  "packages/experience-design-system-types/dist/src/property-contract/index.js"() {
+    "use strict";
+    init_json_value();
+    init_date_time_value();
+    init_discriminated_union();
+    init_target_definition();
+  }
+});
+
 // packages/experience-design-system-types/dist/src/index.js
 var init_src4 = __esm({
   "packages/experience-design-system-types/dist/src/index.js"() {
     "use strict";
     init_cdf2();
     init_dtcg2();
+    init_property_contract();
   }
 });
 
@@ -25348,14 +25860,14 @@ function computeRenderStatuses(closure, directIssues) {
   for (const node of closure.nodes) {
     nodesByName.set(node.name, { name: node.name, path: node.path });
   }
-  const own = /* @__PURE__ */ new Map();
+  const own2 = /* @__PURE__ */ new Map();
   for (const node of closure.nodes) {
     const s = directIssues.get(node.name);
-    if (s && s !== "ok") own.set(node.name, s);
+    if (s && s !== "ok") own2.set(node.name, s);
   }
   const inheritedSources = /* @__PURE__ */ new Map();
   for (const node of closure.nodes) {
-    const ownStatus = own.get(node.name);
+    const ownStatus = own2.get(node.name);
     if (!ownStatus) continue;
     for (let i = 0; i < node.path.length - 1; i++) {
       const ancestor = node.path[i];
@@ -25363,7 +25875,7 @@ function computeRenderStatuses(closure, directIssues) {
       inheritedSources.get(ancestor).set(node.name, ownStatus);
     }
   }
-  for (const [name, status] of own.entries()) {
+  for (const [name, status] of own2.entries()) {
     out.set(name, {
       status,
       isOwn: true,
@@ -25633,7 +26145,7 @@ var init_scroll_offset = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/components/FieldEditor.tsx
-import React13, { useEffect as useEffect11, useLayoutEffect as useLayoutEffect2, useState as useState19 } from "react";
+import React13, { useEffect as useEffect13, 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";
@@ -26400,6 +26912,7 @@ function FieldEditor({
   const [rationaleOpen, setRationaleOpen] = useState19(false);
   const [rationaleScrollOffset, setRationaleScrollOffset] = useState19(0);
   const [showHelp, setShowHelp] = useState19(false);
+  const [pendingDelete, setPendingDelete] = useState19(null);
   const props = editorState.props;
   const slots = editorState.slots;
   const contentPropIndexes = React13.useMemo(
@@ -26491,6 +27004,46 @@ function FieldEditor({
     setEditorState(next);
     onChange(serializeState(next, value));
   };
+  const deleteRow = (row) => {
+    if (row.kind === "prop") {
+      const nextProps = removeAt(editorState.props, row.idx);
+      commit({ ...editorState, props: nextProps });
+      setPropIdx(Math.max(0, Math.min(row.idx, nextProps.length - 1)));
+      const rowsAfter2 = selectableRows.filter((r) => !(r.kind === "prop" && r.idx === row.idx));
+      const neighbour2 = rowsAfter2[Math.max(0, selectableRows.findIndex((r) => r.kind === row.kind && r.idx === row.idx) - 1)];
+      if (!neighbour2) {
+        setInSlots(false);
+        setInComponentDesc(true);
+        setFocusLevel("componentDescription");
+      } else if (neighbour2.kind === "prop") {
+        setInSlots(false);
+        setPropIdx(neighbour2.idx > row.idx ? neighbour2.idx - 1 : neighbour2.idx);
+        setFocusLevel("prop");
+      } else {
+        setInSlots(true);
+        setSlotIdx(neighbour2.idx);
+        setFocusLevel("slot");
+      }
+      return;
+    }
+    const nextSlots = removeAt(editorState.slots, row.idx);
+    commit({ ...editorState, slots: nextSlots });
+    const rowsAfter = selectableRows.filter((r) => !(r.kind === "slot" && r.idx === row.idx));
+    const neighbour = rowsAfter[Math.max(0, selectableRows.findIndex((r) => r.kind === row.kind && r.idx === row.idx) - 1)];
+    if (!neighbour) {
+      setInSlots(false);
+      setInComponentDesc(true);
+      setFocusLevel("componentDescription");
+    } else if (neighbour.kind === "slot") {
+      setInSlots(true);
+      setSlotIdx(neighbour.idx > row.idx ? neighbour.idx - 1 : neighbour.idx);
+      setFocusLevel("slot");
+    } else {
+      setInSlots(false);
+      setPropIdx(neighbour.idx);
+      setFocusLevel("prop");
+    }
+  };
   const canonicalize = React13.useCallback((json) => {
     try {
       return JSON.stringify(JSON.parse(json));
@@ -26527,6 +27080,11 @@ function FieldEditor({
       onSave();
       return;
     }
+    if (pendingDelete) {
+      if (input === "y") deleteRow(pendingDelete);
+      setPendingDelete(null);
+      return;
+    }
     const inDescriptionTextEntryForHelp = focusLevel === "field" && editingField && activeField === "description";
     const inStringDefaultTextEntryForHelp = focusLevel === "field" && editingField && activeField === "default" && currentProp != null && (currentProp.type === "string" || currentProp.type === "token");
     const inValueListTextEntry = editingValue != null;
@@ -26726,6 +27284,11 @@ function FieldEditor({
         }
         return;
       }
+      if (input === "d" && !key.ctrl && !key.meta) {
+        if (focusLevel === "prop" && currentProp) setPendingDelete({ kind: "prop", idx: propIdx });
+        if (focusLevel === "slot" && currentSlot) setPendingDelete({ kind: "slot", idx: slotIdx });
+        return;
+      }
       if (focusLevel === "slot" && key.return && currentSlot) {
         setFocusLevel("field");
         setActiveField(SLOT_FIELDS[0] ?? null);
@@ -27032,6 +27595,10 @@ function FieldEditor({
   }
   const hasEmptyProperties = props.length === 0 && slots.length === 0;
   const modeLabel = (() => {
+    if (pendingDelete) {
+      const name = pendingDelete.kind === "prop" ? props[pendingDelete.idx]?.name : slots[pendingDelete.idx]?.name;
+      return `Delete ${pendingDelete.kind} "${name}"? [y] delete \xB7 any other key cancels`;
+    }
     if (editingValue) {
       return editingValue.mode === "add" ? "Enter to add \xB7 [Esc] to cancel" : "Enter to save edit \xB7 [Esc] to cancel";
     }
@@ -27053,7 +27620,7 @@ function FieldEditor({
     if (rationaleOpen) {
       return "[\u2191\u2193] scroll  [i/Esc] close rationale panel";
     }
-    return `[\u2191\u2193] navigate rows  [Enter] edit fields  [s] source  [${propRationaleKey}] prop rationale  [${componentRationaleKey}] component rationale  [h] help  [Esc] exit panel`;
+    return `[\u2191\u2193] navigate  [Enter] edit fields  [d] delete property  [h] help  [s] source  [Esc] exit panel`;
   })();
   const rows = [];
   rows.push({ kind: "component-description" });
@@ -27105,7 +27672,7 @@ function FieldEditor({
     }
     return Math.max(start + 1, end2);
   };
-  useEffect11(() => {
+  useEffect13(() => {
     if (focusLevel === "field" || selectedRowIdx < 0) return;
     setListScrollStart((previous) => {
       if (initialFocusTarget && !initialFocusScrollApplied.current) {
@@ -27319,6 +27886,7 @@ function FieldEditor({
           /* @__PURE__ */ jsx32(Text27, { bold: true, children: "Row navigation" }),
           /* @__PURE__ */ jsx32(Text27, { children: "  \u2191/\u2193               move between rows" }),
           /* @__PURE__ */ jsx32(Text27, { children: "  Enter            edit fields on the current row" }),
+          /* @__PURE__ */ jsx32(Text27, { children: "  d                delete the current prop or slot (asks to confirm)" }),
           /* @__PURE__ */ jsx32(Text27, { children: "  Esc              exit the panel" }),
           /* @__PURE__ */ jsx32(Text27, { children: " " }),
           /* @__PURE__ */ jsx32(Text27, { bold: true, children: "Field editing" }),
@@ -27342,7 +27910,7 @@ function FieldEditor({
           /* @__PURE__ */ jsx32(Text27, { color: PALETTE.muted, children: "press ? or Esc to close" })
         ] }),
         validationError && /* @__PURE__ */ jsx32(Text27, { color: PALETTE.error, children: "\u2717 " + validationError }),
-        /* @__PURE__ */ jsx32(Box26, { paddingTop: 1, children: /* @__PURE__ */ jsx32(Text27, { color: PALETTE.muted, children: modeLabel }) })
+        /* @__PURE__ */ jsx32(Box26, { paddingTop: 1, children: /* @__PURE__ */ jsx32(Text27, { color: pendingDelete ? PALETTE.text : PALETTE.muted, children: modeLabel }) })
       ]
     }
   );
@@ -27735,8 +28303,8 @@ function TokenReviewPanel({
         borderStyle: "single",
         borderColor: active ? PALETTE.text : void 0,
         children: [
-          /* @__PURE__ */ jsx39(Text32, { bold: true, color: active ? void 0 : PALETTE.muted, wrap: "truncate", children: `TOKEN REVIEW \u2014 ${componentName} \xB7 ${current.propName} (edit allowed)` }),
-          /* @__PURE__ */ jsx39(Text32, { color: PALETTE.muted, wrap: "truncate", children: `select which tokens are allowed (${rangeLabel})` }),
+          /* @__PURE__ */ jsx39(Text32, { bold: true, color: active ? void 0 : PALETTE.muted, wrap: "truncate", children: `Review mapped tokens \u2014 ${componentName} \xB7 ${current.propName}${current.kinds.length > 0 ? ` (${current.kinds.join(", ")})` : ""}` }),
+          /* @__PURE__ */ jsx39(Text32, { color: PALETTE.muted, wrap: "truncate", children: `Tick the tokens this property may use (${rangeLabel}).` }),
           /* @__PURE__ */ jsx39(Text32, { children: " " }),
           current.paths.length === 0 && /* @__PURE__ */ jsx39(Text32, { color: PALETTE.muted, children: "(no compatible tokens found for this token kind)" }),
           visiblePaths.map((path5, i) => {
@@ -27769,18 +28337,33 @@ function TokenReviewPanel({
       borderStyle: "single",
       borderColor: active ? PALETTE.text : void 0,
       children: [
-        /* @__PURE__ */ jsx39(Text32, { bold: true, color: active ? void 0 : PALETTE.muted, children: `TOKEN REVIEW \u2014 ${componentName}` }),
+        /* @__PURE__ */ jsx39(Text32, { bold: true, color: active ? void 0 : PALETTE.muted, children: `Review mapped tokens \u2014 ${componentName}` }),
+        /* @__PURE__ */ jsx39(Text32, { color: PALETTE.muted, wrap: "truncate", children: `${componentName} has ${suggestions.length} design ${suggestions.length === 1 ? "prop" : "props"} of type token. Select which tokens are allowed for each property.` }),
+        /* @__PURE__ */ jsx39(Text32, { color: PALETTE.muted, wrap: "truncate", children: "Suggested tokens come from the agent. Allowed tokens are what editors can pick in Contentful." }),
+        /* @__PURE__ */ jsx39(Text32, { children: " " }),
         suggestions.length === 0 && /* @__PURE__ */ jsx39(Text32, { color: PALETTE.muted, children: "(no token suggestions for this component)" }),
         suggestions.map((s, i) => {
           const focused = i === selectedRow;
           return /* @__PURE__ */ jsxs30(Box31, { flexDirection: "column", children: [
-            /* @__PURE__ */ jsx39(Box31, { children: /* @__PURE__ */ jsx39(Text32, { color: focused ? PALETTE.accent : active ? void 0 : PALETTE.muted, bold: focused, children: `${focused ? figures7.pointer : " "} ${s.propName}` }) }),
-            /* @__PURE__ */ jsx39(Text32, { color: PALETTE.muted, children: `  suggested: ${s.suggested.join(", ")}` }),
-            /* @__PURE__ */ jsx39(Text32, { color: PALETTE.muted, children: `  allowed: ${s.allowed.join(", ")}` })
+            /* @__PURE__ */ jsx39(Box31, { children: /* @__PURE__ */ jsx39(Text32, { color: focused ? PALETTE.accent : active ? void 0 : PALETTE.muted, bold: focused, children: `${focused ? figures7.pointer : " "} ${s.propName}${s.kinds.length > 0 ? ` (${s.kinds.join(", ")})` : ""}` }) }),
+            /* @__PURE__ */ jsx39(
+              Text32,
+              {
+                color: PALETTE.muted,
+                children: `  suggested: ${s.suggested.length > 0 ? s.suggested.join(", ") : "none"}`
+              }
+            ),
+            /* @__PURE__ */ jsx39(
+              Text32,
+              {
+                color: PALETTE.muted,
+                children: `  allowed: ${s.allowed.length > 0 ? s.allowed.join(", ") : "none (any token)"}`
+              }
+            ),
+            /* @__PURE__ */ jsx39(Text32, { children: " " })
           ] }, s.propName);
         }),
-        /* @__PURE__ */ jsx39(Text32, { children: " " }),
-        /* @__PURE__ */ jsx39(Text32, { children: "[\u2191/\u2193] move  [Enter] edit allowed  [Esc] close" })
+        /* @__PURE__ */ jsx39(Text32, { color: PALETTE.muted, children: "[\u2191/\u2193] move  [Enter] edit allowed tokens  [Esc] close" })
       ]
     }
   );
@@ -28054,15 +28637,9 @@ function ReviewFinalizeError({
 function ReviewPanelFooter({
   reviewEditor,
   sidebarFocused,
-  sidebarFooter,
-  livePreview,
-  livePreviewSpinner
+  sidebarFooter
 }) {
-  return /* @__PURE__ */ jsxs32(Fragment10, { children: [
-    reviewEditor.panelOpen === "token-review" ? "  [\u2191/\u2193] move  [Enter] edit allowed  [Esc] close" : sidebarFocused ? sidebarFooter : reviewEditor.showJson ? "  [\u2191\u2193] scroll  [Ctrl+u/d] half-page  [gg/G] top/bottom  [Tab] focus list" : "  [Tab] focus list  (edit fields)" + (reviewEditor.currentTokenSuggestions().length > 0 ? "  [t] token review" : ""),
-    livePreview.status === "running" && /* @__PURE__ */ jsx42(Text34, { children: `  ${livePreviewSpinner} live preview` }),
-    livePreview.disabled && /* @__PURE__ */ jsx42(Text34, { children: "  \xB7 live preview disabled" })
-  ] });
+  return /* @__PURE__ */ jsx42(Fragment10, { children: reviewEditor.panelOpen === "token-review" ? "" : sidebarFocused ? sidebarFooter : reviewEditor.showJson ? "  [\u2191\u2193] scroll  [Ctrl+u/d] half-page  [gg/G] top/bottom  [Tab] focus list" : "  [Tab] focus list  [Enter] edit fields" + (reviewEditor.currentTokenSuggestions().length > 0 ? "  [t] review mapped tokens" : "") });
 }
 function ReviewComponentTitle({
   selectedKey,
@@ -28096,9 +28673,7 @@ function ReviewComponentPanel({
   sidebarFocused,
   fieldEditor,
   saveError,
-  sidebarFooter,
-  livePreview,
-  livePreviewSpinner
+  sidebarFooter
 }) {
   const propCount = Object.keys(selectedEntry.$properties).length;
   const slotCount = selectedEntry.$slots ? Object.keys(selectedEntry.$slots).length : 0;
@@ -28135,9 +28710,7 @@ function ReviewComponentPanel({
       {
         reviewEditor,
         sidebarFocused,
-        sidebarFooter,
-        livePreview,
-        livePreviewSpinner
+        sidebarFooter
       }
     ) }) })
   ] }) });
@@ -28494,7 +29067,7 @@ var init_FinalizeDialog = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-finalize-preview.ts
-import { useEffect as useEffect12, useRef as useRef9, useState as useState20 } from "react";
+import { useEffect as useEffect14, useRef as useRef11, useState as useState20 } from "react";
 function useReviewFinalizePreview({
   components,
   ...options
@@ -28509,9 +29082,9 @@ function useFinalizePreview(opts) {
   const [status, setStatus] = useState20("idle");
   const [removed, setRemoved] = useState20([]);
   const [scrollOffset, setScrollOffset] = useState20(0);
-  const generationRef = useRef9(0);
+  const generationRef = useRef11(0);
   const acceptedKey = [...acceptedKeys].sort().join("\0");
-  useEffect12(() => {
+  useEffect14(() => {
     if (!open) {
       setStatus("idle");
       setRemoved([]);
@@ -28563,7 +29136,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 useEffect13, useRef as useRef10, useState as useState21 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect15, useRef as useRef12, useState as useState21 } from "react";
 function useReviewSession({
   loadSession,
   tokensPath,
@@ -28582,7 +29155,7 @@ function useReviewSession({
     }));
     return { result, catalog };
   }, [loadSession, tokensPath]);
-  useEffect13(() => {
+  useEffect15(() => {
     let disposed = false;
     void (async () => {
       try {
@@ -28635,7 +29208,7 @@ function useReviewSession({
 function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
   const [reviewMetadata, setReviewMetadata] = useState21(null);
   const [componentRationale, setComponentRationale] = useState21(null);
-  useEffect13(() => {
+  useEffect15(() => {
     const current = components[selectedIdx];
     if (!current) {
       setReviewMetadata(null);
@@ -28665,9 +29238,9 @@ function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
   return { reviewMetadata, componentRationale };
 }
 function useReviewHistory({ loading, components, createSnapshot, applySnapshot }) {
-  const historyRef = useRef10(null);
-  const historySeededRef = useRef10(false);
-  useEffect13(() => {
+  const historyRef = useRef12(null);
+  const historySeededRef = useRef12(false);
+  useEffect15(() => {
     if (loading || historySeededRef.current) return;
     historySeededRef.current = true;
     historyRef.current = createHistoryStack(createSnapshot(components));
@@ -28739,7 +29312,7 @@ function collectTokenSuggestions(entry, availableTokens = []) {
     const compatiblePaths = new Set(compatible);
     const allowed = availableTokens.length > 0 ? persistedAllowed.filter((path5) => compatiblePaths.has(path5)) : persistedAllowed;
     const paths = availableTokens.length > 0 ? compatible : allowed;
-    return { propName, paths, suggested: [...allowed], allowed };
+    return { propName, kinds, paths, suggested: [...allowed], allowed };
   });
 }
 var init_token_suggestions = __esm({
@@ -28749,7 +29322,7 @@ var init_token_suggestions = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-editor.ts
-import { useEffect as useEffect14, useRef as useRef11, useState as useState22 } from "react";
+import { useEffect as useEffect16, useRef as useRef13, useState as useState22 } from "react";
 function parseReviewEntry(draftValue) {
   const parsed = JSON.parse(draftValue);
   const keys = Object.keys(parsed);
@@ -28781,9 +29354,9 @@ function useReviewEditor({
   const [tokenReviewEditing, setTokenReviewEditing] = useState22(false);
   const [tokenReviewEditCursor, setTokenReviewEditCursor] = useState22(0);
   const [tokenReviewEditSelection, setTokenReviewEditSelection] = useState22(/* @__PURE__ */ new Set());
-  const tokenReviewSuggestedRef = useRef11(/* @__PURE__ */ new Map());
-  const pendingGRef = useRef11(false);
-  useEffect14(() => {
+  const tokenReviewSuggestedRef = useRef13(/* @__PURE__ */ new Map());
+  const pendingGRef = useRef13(false);
+  useEffect16(() => {
     setTokenReviewRow(0);
     setTokenReviewEditing(false);
     setTokenReviewEditCursor(0);
@@ -29265,24 +29838,24 @@ 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 useEffect15, useRef as useRef12, useState as useState24 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect17, useRef as useRef14, useState as useState24 } from "react";
 function useLivePreview(opts) {
   const debounceMs = opts.debounceMs ?? DEFAULT_DEBOUNCE_MS;
   const [status, setStatus] = useState24("idle");
   const [disabled, setDisabled] = useState24(false);
-  const timerRef = useRef12(null);
-  const generationRef = useRef12(0);
-  const latestRef = useRef12(0);
-  const inflightRef = useRef12(0);
-  const optsRef = useRef12(opts);
-  useEffect15(() => {
+  const timerRef = useRef14(null);
+  const generationRef = useRef14(0);
+  const latestRef = useRef14(0);
+  const inflightRef = useRef14(0);
+  const optsRef = useRef14(opts);
+  useEffect17(() => {
     optsRef.current = opts;
   });
-  const disabledRef = useRef12(disabled);
-  useEffect15(() => {
+  const disabledRef = useRef14(disabled);
+  useEffect17(() => {
     disabledRef.current = disabled;
   }, [disabled]);
-  useEffect15(() => {
+  useEffect17(() => {
     return () => {
       if (timerRef.current) {
         clearTimeout(timerRef.current);
@@ -29363,7 +29936,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 useEffect16, useState as useState25 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect18, useState as useState25 } from "react";
 function useReviewPreview({
   components,
   loading,
@@ -29405,13 +29978,13 @@ function useReviewPreview({
     deleteAllComponents
   });
   const [spinnerTick, setSpinnerTick] = useState25(0);
-  useEffect16(() => {
+  useEffect18(() => {
     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];
-  useEffect16(() => {
+  useEffect18(() => {
     if (loading) return;
     if (!livePreview) return;
     if (components.length === 0) return;
@@ -29468,7 +30041,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 useEffect17, useMemo as useMemo6, useRef as useRef13, useState as useState26 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect19, useMemo as useMemo6, useRef as useRef15, 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";
@@ -29682,7 +30255,7 @@ function GenerateReviewStepView({
     setFinalizeError
   } = reviewSurface;
   const [removedBannerCollapsed, setRemovedBannerCollapsed] = useState26(false);
-  const removedBannerDefaultedRef = useRef13(false);
+  const removedBannerDefaultedRef = useRef15(false);
   const [cyclePanelScroll, setCyclePanelScroll] = useState26(0);
   const [cyclesCursor, setCyclesCursor] = useState26(0);
   const cyclePanel = useOverlayPanel({
@@ -29702,7 +30275,7 @@ function GenerateReviewStepView({
   const [breakCursor, setBreakCursor] = useState26(0);
   const [breakConfirm, setBreakConfirm] = useState26(false);
   const [expandedGroups, setExpandedGroups] = useState26(/* @__PURE__ */ new Set());
-  const seededGroupsRef = useRef13(false);
+  const seededGroupsRef = useRef15(false);
   const {
     searchOpen,
     setSearchOpen,
@@ -29726,7 +30299,7 @@ function GenerateReviewStepView({
   const [pendingEditorFocus, setPendingEditorFocus] = useState26(null);
   const [autoRejected, setAutoRejected] = useState26([]);
   const [undoSnapshot, setUndoSnapshot] = useState26(null);
-  const autoRejectFiredRef = useRef13(false);
+  const autoRejectFiredRef = useRef15(false);
   const [showReloadDialog, setShowReloadDialog] = useState26(false);
   const acceptedCountForPreview = components.filter((c2) => c2.status === "accepted").length;
   const { previewAnnotations, removedComponents, livePreviewHook, livePreviewSpinner } = useReviewPreview({
@@ -29789,7 +30362,7 @@ function GenerateReviewStepView({
     [components]
   );
   const closures = useMemo6(() => computeAllClosures(componentGraph), [componentGraph]);
-  useEffect17(() => {
+  useEffect19(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && slotCycles.length === 0) return;
     seededGroupsRef.current = true;
@@ -29816,7 +30389,7 @@ function GenerateReviewStepView({
       suggestedBreak: cycle.edges.length > 0 ? suggestCycleBreakEdge2(cycle, cycleView.pushBlocking) : null
     }));
   }, [slotCycles, cycleView]);
-  useEffect17(() => {
+  useEffect19(() => {
     const decision = computeAutoRejectDecision({
       loading,
       autoRejectFired: autoRejectFiredRef.current,
@@ -29859,8 +30432,8 @@ function GenerateReviewStepView({
     }),
     applySnapshot: applyHistorySnapshot
   });
-  const autoRejectPushedRef = useRef13(false);
-  useEffect17(() => {
+  const autoRejectPushedRef = useRef15(false);
+  useEffect19(() => {
     if (loading) return;
     if (!historySeededRef.current) return;
     if (!autoRejectFiredRef.current) return;
@@ -29944,7 +30517,7 @@ function GenerateReviewStepView({
   const panelHeight = leftPanelHeight + 2;
   const panelContentHeight = Math.max(1, panelHeight - 3);
   const cycleViewportHeight = Math.max(1, panelHeight - 4);
-  useEffect17(() => {
+  useEffect19(() => {
     if (selectableRowPositions.length === 0) return;
     const cursorInRange = selectableRowPositions.includes(cursorRowIdx);
     const maxScroll = Math.max(0, visibleRowsMemo.length - visibleCount);
@@ -30690,9 +31263,7 @@ function GenerateReviewStepView({
               initialFocusTarget: pendingEditorFocus && pendingEditorFocus.componentName === selected.key ? pendingEditorFocus.target : { kind: "description" }
             }
           ),
-          saveError: reviewEditor.saveError,
-          livePreview: livePreviewHook,
-          livePreviewSpinner
+          saveError: reviewEditor.saveError
         }
       ) : /* @__PURE__ */ jsx48(ReviewNoSelection, {})
     ] }),
@@ -30724,7 +31295,7 @@ function GenerateReviewStepView({
         hidden: dialogOpen
       }
     ),
-    !dialogOpen && sidebarFocused && /* @__PURE__ */ jsx48(CompactControlBar, { hasGroupRoots, searchActive: searchOpen || searchQuery.length > 0 })
+    !dialogOpen && sidebarFocused && reviewEditor.panelOpen !== "token-review" && /* @__PURE__ */ jsx48(CompactControlBar, { hasGroupRoots, searchActive: searchOpen || searchQuery.length > 0 })
   ] });
 }
 var HELP_SECTIONS2;
@@ -30806,7 +31377,7 @@ var init_generate_review_step = __esm({
           { keys: "P", label: "Component rationale" },
           { keys: "s", label: "Source code snippet" },
           { keys: "J", label: "Toggle JSON" },
-          { keys: "t", label: "Token review" }
+          { keys: "t", label: "Review mapped tokens" }
         ]
       },
       {
@@ -31005,7 +31576,7 @@ var init_DoneStep = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/path-utils.ts
-import { resolve as resolve25 } from "node:path";
+import { resolve as resolve26 } from "node:path";
 import { homedir as homedir4 } from "node:os";
 function expandTilde(input) {
   if (input === "~" || input.startsWith("~/") || input.startsWith("~\\")) {
@@ -31019,7 +31590,7 @@ function normalizePath(input) {
     p = p.slice(1, -1);
   }
   p = expandTilde(p);
-  return resolve25(p);
+  return resolve26(p);
 }
 var init_path_utils = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/path-utils.ts"() {
@@ -31028,10 +31599,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 useEffect18, useState as useState27 } from "react";
+import { useEffect as useEffect20, useState as useState27 } from "react";
 function useBlinkingCursor() {
   const [visible, setVisible] = useState27(true);
-  useEffect18(() => {
+  useEffect20(() => {
     const interval = setInterval(() => setVisible((current) => !current), 500);
     return () => clearInterval(interval);
   }, []);
@@ -31046,29 +31617,29 @@ var init_use_blinking_cursor = __esm({
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/screens/PathPrompt.tsx
 import { useState as useState28 } from "react";
 import { Box as Box42, Text as Text44 } from "ink";
-import { readdirSync as readdirSync3 } from "node:fs";
-import { dirname as dirname16, basename as basename6, join as join21 } from "node:path";
+import { readdirSync as readdirSync4 } from "node:fs";
+import { dirname as dirname17, basename as basename6, join as join23 } from "node:path";
 import { jsx as jsx52, jsxs as jsxs42 } from "react/jsx-runtime";
 function autocomplete(partial) {
   if (!partial) return null;
   const normalized = normalizePath(partial);
-  const dir = dirname16(normalized);
+  const dir = dirname17(normalized);
   const base = basename6(normalized);
   let entries;
   try {
-    entries = readdirSync3(dir);
+    entries = readdirSync4(dir);
   } catch {
     return null;
   }
   const matches = entries.filter((e) => e.startsWith(base));
   if (matches.length === 0) return null;
-  if (matches.length === 1) return join21(dir, matches[0]);
+  if (matches.length === 1) return join23(dir, matches[0]);
   let prefix = matches[0];
   for (const m of matches) {
     while (!m.startsWith(prefix)) prefix = prefix.slice(0, -1);
     if (!prefix) break;
   }
-  return prefix.length > base.length ? join21(dir, prefix) : null;
+  return prefix.length > base.length ? join23(dir, prefix) : null;
 }
 function PathPrompt({
   defaultPath,
@@ -31168,12 +31739,12 @@ var init_produced = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/use-timed-spinner.tsx
-import { useEffect as useEffect19, useState as useState29 } from "react";
+import { useEffect as useEffect21, 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);
-  useEffect19(() => {
+  useEffect21(() => {
     const timer = setInterval(() => setElapsedSeconds((current) => current + 1), 1e3);
     return () => {
       clearInterval(timer);
@@ -31385,12 +31956,20 @@ function diffProperty(name, old, newDef) {
   diffs.push({ key: `${name}-new`, color: PALETTE.success, text: `+ ${name}: ${formatPropDef(newDef)}` });
   return diffs;
 }
+function formatDefault(value) {
+  const sys = value?.sys;
+  if (sys?.linkType === "Contentful:DesignToken" && typeof sys.urn === "string") {
+    const name = sys.urn.split("/designTokens/")[1];
+    if (name) return name;
+  }
+  return JSON.stringify(value);
+}
 function formatOldProp(prop) {
   const parts = [];
   if (prop.type) parts.push(prop.type);
   if (prop.category) parts.push(prop.category);
   parts.push(prop.required ? "required" : "optional");
-  if (prop.default !== void 0) parts.push(`default=${JSON.stringify(prop.default)}`);
+  if (prop.default !== void 0) parts.push(`default=${formatDefault(prop.default)}`);
   return parts.join(", ");
 }
 function formatPropDef(def) {
@@ -31399,7 +31978,7 @@ function formatPropDef(def) {
   if (def["$category"]) parts.push(def["$category"]);
   if (def["$required"] === true) parts.push("required");
   else parts.push("optional");
-  if (def["$default"] !== void 0) parts.push(`default=${JSON.stringify(def["$default"])}`);
+  if (def["$default"] !== void 0) parts.push(`default=${formatDefault(def["$default"])}`);
   return parts.join(", ");
 }
 var init_preview_diff = __esm({
@@ -31434,7 +32013,7 @@ var init_preview_confirmation_input = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/screens/WizardPreviewStep.tsx
-import { useEffect as useEffect20, useState as useState30, useMemo as useMemo7 } from "react";
+import { useEffect as useEffect22, 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) {
@@ -31644,7 +32223,7 @@ function WizardPreviewStep({
   const activeLines = diffExpanded ? diffLines : summaryLines;
   const maxScroll = Math.max(0, activeLines.length - viewportHeight);
   const boundedScrollOffset = Math.min(scrollOffset, maxScroll);
-  useEffect20(() => {
+  useEffect22(() => {
     setScrollOffset((previous) => Math.min(previous, maxScroll));
   }, [maxScroll]);
   useImmediateInput((input, key) => {
@@ -32280,8 +32859,8 @@ var init_run_print_files_helpers = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/save.ts
-import { writeFile as writeFile7 } from "node:fs/promises";
-import { join as join22 } from "node:path";
+import { writeFile as writeFile8 } from "node:fs/promises";
+import { join as join24 } from "node:path";
 function buildSavedCDF(components, tokens, opts = {}) {
   const cdf = buildCDF2(components, toCdfTokens(tokens), opts);
   if (!cdf) throw new Error("nothing to save \u2014 no components or tokens resolved");
@@ -32293,7 +32872,7 @@ function buildSavedCDF(components, tokens, opts = {}) {
 }
 async function runPrintFiles(input, deps, onPatch) {
   onPatch({ step: "printing" });
-  const componentsPath = join22(input.outDir, "components.json");
+  const componentsPath = join24(input.outDir, "components.json");
   try {
     const db = deps.openDb();
     let components = [];
@@ -32377,7 +32956,7 @@ var init_save = __esm({
     realSaveDeps = () => ({
       openDb: openPipelineDb,
       readTokens: (path5) => readTokensFromPath2({ flag: "tokens", path: path5 }),
-      writeFile: (path5, contents) => writeFile7(path5, contents),
+      writeFile: (path5, contents) => writeFile8(path5, contents),
       appendRun,
       buildSourceFingerprint,
       sleep: (ms) => new Promise((resolve29) => setTimeout(resolve29, ms)),
@@ -32400,9 +32979,9 @@ var init_types9 = __esm({
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/controller.ts
 import { appendFileSync, writeFileSync } from "node:fs";
-import { mkdir as mkdir8 } from "node:fs/promises";
+import { mkdir as mkdir9 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join as join23, resolve as resolve26 } from "node:path";
+import { join as join25, resolve as resolve27 } from "node:path";
 function appendWizardLog(entry) {
   appendFileSync(WIZARD_LOG, JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), ...entry }) + "\n");
 }
@@ -32425,7 +33004,7 @@ function realFlowDeps() {
       }
     },
     mkdir: async (path5) => {
-      await mkdir8(path5, { recursive: true });
+      await mkdir9(path5, { recursive: true });
     },
     detectSaveConflict,
     buildTimestampedSubdir,
@@ -32655,367 +33234,71 @@ function createFlowController(start, deps) {
     },
     async submitPath(submitted) {
       await deps.mkdir(submitted);
-      if (resolve26(submitted) !== resolve26(state2.outDir) && await deps.detectSaveConflict(submitted)) {
+      if (resolve27(submitted) !== resolve27(state2.outDir) && await deps.detectSaveConflict(submitted)) {
         const subdir = deps.buildTimestampedSubdir(submitted);
-        await deps.mkdir(subdir);
-        await proceedToWrite(subdir);
-        return;
-      }
-      await proceedToWrite(submitted);
-    },
-    confirmPreview: (acknowledge) => void push(acknowledge),
-    acknowledgeBreakingChanges: () => void push(true),
-    editDefinitions: () => update({ step: "final-review" }),
-    async skipValidationErrors() {
-      if (state2.extractSessionId) {
-        const names = namesToSkip(state2.previewValidationErrors);
-        if (names.length > 0) await deps.rejectComponentsByName(state2.extractSessionId, names);
-      }
-      await preview();
-    }
-  };
-}
-var WIZARD_LOG;
-var init_controller = __esm({
-  "packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/controller.ts"() {
-    "use strict";
-    init_src3();
-    init_slot_graph();
-    init_cycle_detection();
-    init_wizard_state_transitions();
-    init_preview2();
-    init_push();
-    init_save();
-    init_types9();
-    WIZARD_LOG = join23(tmpdir(), "experiences-import-wizard.log");
-  }
-});
-
-// packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts
-import { useEffect as useEffect21, useRef as useRef14, useSyncExternalStore } from "react";
-function useFlow(start, options = {}) {
-  const controller = useRef14();
-  if (start && !controller.current) {
-    try {
-      startWizardLog();
-    } catch {
-    }
-    const flowDeps = (options.deps ?? realFlowDeps)();
-    controller.current = createFlowController(start, {
-      ...flowDeps,
-      ...options.beforeStepChange ? { beforeStepChange: options.beforeStepChange } : {}
-    });
-  }
-  const current = controller.current;
-  const state2 = useSyncExternalStore(
-    (listener) => current?.subscribe(listener) ?? (() => void 0),
-    () => current?.getState()
-  );
-  useEffect21(() => {
-    if (!start) controller.current = void 0;
-  }, [start]);
-  return current && state2 ? { controller: current, state: state2 } : void 0;
-}
-var init_use_flow = __esm({
-  "packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts"() {
-    "use strict";
-    init_controller();
-  }
-});
-
-// packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts
-function toRetentionDays(value) {
-  return RETENTION_CHOICES.find((choice) => choice === value) ?? DEFAULT_RETENTION_DAYS;
-}
-async function readDebugModeSetting() {
-  const { debugMode } = await readSettings2();
-  const saved = debugMode ?? {};
-  return {
-    enabled: typeof saved.enabled === "boolean" ? saved.enabled : true,
-    retentionDays: toRetentionDays(saved.retentionDays)
-  };
-}
-async function writeDebugModeSetting(change) {
-  await updateSettings2({ debugMode: { ...await readDebugModeSetting(), ...change } });
-}
-var RETENTION_CHOICES, DEFAULT_RETENTION_DAYS;
-var init_debug_mode_store = __esm({
-  "packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts"() {
-    "use strict";
-    init_config();
-    RETENTION_CHOICES = [7, 14, 30];
-    DEFAULT_RETENTION_DAYS = 30;
-  }
-});
-
-// packages/experience-design-system-cli/src/tui/debug-prune.ts
-import { readdir as readdir2, rm, rmdir, stat as stat4 } from "node:fs/promises";
-import { dirname as dirname17, join as join24 } from "node:path";
-async function logFilesIn(dir) {
-  const entries = await readdir2(dir, { withFileTypes: true });
-  const nested = await Promise.all(
-    entries.map(async (entry) => {
-      const path5 = join24(dir, entry.name);
-      if (entry.isDirectory()) return logFilesIn(path5);
-      return entry.isFile() && entry.name.endsWith(".md") ? [path5] : [];
-    })
-  );
-  return nested.flat();
-}
-async function removeEmptyFolders(from, stop) {
-  let dir = from;
-  let removed = 0;
-  for (; ; ) {
-    try {
-      await rmdir(dir);
-    } catch {
-      return removed;
-    }
-    removed += 1;
-    if (dir === stop) return removed;
-    dir = dirname17(dir);
-  }
-}
-async function pruneExpiredLogs(base, retentionDays, now = Date.now()) {
-  const cutoff = now - retentionDays * DAY_MS;
-  const contentfulDir = join24(base, ".contentful");
-  const result = { logs: 0, folders: 0 };
-  try {
-    const sessions = (await readdir2(contentfulDir)).filter((name) => SESSION_FOLDER.test(name));
-    for (const session of sessions) {
-      const files = await logFilesIn(join24(contentfulDir, session, "debug")).catch(() => []);
-      for (const file of files) {
-        try {
-          if ((await stat4(file)).mtimeMs >= cutoff) continue;
-          await rm(file);
-          result.logs += 1;
-          result.folders += await removeEmptyFolders(dirname17(file), join24(contentfulDir, session));
-        } catch {
-        }
+        await deps.mkdir(subdir);
+        await proceedToWrite(subdir);
+        return;
+      }
+      await proceedToWrite(submitted);
+    },
+    confirmPreview: (acknowledge) => void push(acknowledge),
+    acknowledgeBreakingChanges: () => void push(true),
+    editDefinitions: () => update({ step: "final-review" }),
+    async skipValidationErrors() {
+      if (state2.extractSessionId) {
+        const names = namesToSkip(state2.previewValidationErrors);
+        if (names.length > 0) await deps.rejectComponentsByName(state2.extractSessionId, names);
       }
+      await preview();
     }
-  } catch {
-  }
-  return result;
+  };
 }
-var DAY_MS, SESSION_FOLDER;
-var init_debug_prune = __esm({
-  "packages/experience-design-system-cli/src/tui/debug-prune.ts"() {
+var WIZARD_LOG;
+var init_controller = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/controller.ts"() {
     "use strict";
-    DAY_MS = 24 * 60 * 60 * 1e3;
-    SESSION_FOLDER = /^\d{2}-\d{2}-\d{4}-session-\d+$/;
+    init_src3();
+    init_slot_graph();
+    init_cycle_detection();
+    init_wizard_state_transitions();
+    init_preview2();
+    init_push();
+    init_save();
+    init_types9();
+    WIZARD_LOG = join25(tmpdir(), "experiences-import-wizard.log");
   }
 });
 
-// packages/experience-design-system-cli/src/tui/debug-store.ts
-var debug_store_exports = {};
-__export(debug_store_exports, {
-  currentDebugSessionDir: () => currentDebugSessionDir,
-  currentSessionDir: () => currentSessionDir,
-  finishDebugRun: () => finishDebugRun,
-  startDebugRun: () => startDebugRun,
-  startDebugSessionIn: () => startDebugSessionIn,
-  startImportRun: () => startImportRun
-});
-import { mkdir as mkdir9, writeFile as writeFile8 } from "node:fs/promises";
-import { existsSync as existsSync10, readdirSync as readdirSync4 } from "node:fs";
-import { join as join25, resolve as resolve27 } from "node:path";
-function generateRunId() {
-  const now = /* @__PURE__ */ new Date();
-  const pad = (n) => String(n).padStart(2, "0");
-  return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
-}
-function datePrefix(now = /* @__PURE__ */ new Date()) {
-  const pad = (n) => String(n).padStart(2, "0");
-  return `${pad(now.getMonth() + 1)}-${pad(now.getDate())}-${now.getFullYear()}`;
-}
-function slugify(value) {
-  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-}
-async function readBaseDir() {
-  try {
-    const dir = (await readSettings2())["contentfulBaseDir"];
-    return typeof dir === "string" && dir !== "" ? resolve27(dir) : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function nextSessionId(contentfulDir) {
-  const today = datePrefix();
-  const existing = existsSync10(contentfulDir) ? readdirSync4(contentfulDir) : [];
-  const seqPattern = new RegExp(`^${today}-session-(\\d+)$`);
-  const maxSeq = existing.reduce((max, entry) => {
-    const match2 = seqPattern.exec(entry);
-    return match2 ? Math.max(max, Number(match2[1])) : max;
-  }, 0);
-  return `${today}-session-${maxSeq + 1}`;
-}
-function startSession(base, { replace }) {
-  const contentfulDir = join25(base, ".contentful");
-  if (replace || !sessionDir) sessionDir = join25(contentfulDir, nextSessionId(contentfulDir));
-  return sessionDir;
-}
-function currentDebugSessionDir() {
-  return sessionDir && join25(sessionDir, "debug");
-}
-function currentSessionDir() {
-  return sessionDir;
-}
-async function startDebugSessionIn(base, { replace = false } = {}) {
-  try {
-    if (!await isDebugModeEnabled()) return;
-    await mkdir9(join25(startSession(resolve27(base), { replace }), "debug"), { recursive: true });
-  } catch {
-  }
-}
-function nextImportRunDir(session) {
-  const existing = existsSync10(session) ? readdirSync4(session) : [];
-  const maxRun = existing.reduce((max, entry) => {
-    const match2 = /^dsi-import-(\d+)$/.exec(entry);
-    return match2 ? Math.max(max, Number(match2[1])) : max;
-  }, 0);
-  return join25(session, `dsi-import-${maxRun + 1}`);
-}
-async function startImportRun(projectPath) {
-  await startDebugSessionIn(projectPath);
-  if (!sessionDir) return join25(resolve27(projectPath), ".contentful");
-  const dir = nextImportRunDir(sessionDir);
-  await mkdir9(dir, { recursive: true });
-  return dir;
-}
-async function isDebugModeEnabled() {
-  try {
-    return (await readDebugModeSetting()).enabled;
-  } catch {
-    return true;
-  }
-}
-function redact(value) {
-  const clone = { ...value };
-  if ("cma_token" in clone) {
-    const raw = clone.cma_token;
-    clone.cma_token = typeof raw === "string" && raw.length > 0 ? `[present, ${raw.length} chars]` : "[not set]";
+// packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts
+import { useEffect as useEffect23, useRef as useRef16, useSyncExternalStore } from "react";
+function useFlow(start, options = {}) {
+  const controller = useRef16();
+  if (start && !controller.current) {
+    try {
+      startWizardLog();
+    } catch {
+    }
+    const flowDeps = (options.deps ?? realFlowDeps)();
+    controller.current = createFlowController(start, {
+      ...flowDeps,
+      ...options.beforeStepChange ? { beforeStepChange: options.beforeStepChange } : {}
+    });
   }
-  return clone;
-}
-function startDebugRun({
-  flow,
-  step,
-  menuOption,
-  inputs
-}) {
-  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 };
-  });
-}
-async function finishDebugRun({
-  outputs,
-  status,
-  exitMethod
-}) {
-  const run = pendingRun;
-  if (!run) return;
-  pendingRun = void 0;
-  const durationMs = Date.now() - run.startedAt;
-  const content = renderMarkdown(run, { outputs: redact(outputs), status, exitMethod, durationMs });
-  const root = currentDebugSessionDir();
-  if (!root) return;
-  const flowSegments = run.flow.split("/");
-  const dir = join25(root, ...flowSegments);
-  await mkdir9(dir, { recursive: true });
-  const filename = nextAttemptFilename(dir, run.menuOption);
-  await writeFile8(join25(dir, filename), content, { mode: 384 });
-}
-function nextAttemptFilename(dir, menuOption) {
-  const today = datePrefix();
-  const optionSlug = slugify(menuOption);
-  const existing = existsSync10(dir) ? readdirSync4(dir) : [];
-  const attemptPattern = new RegExp(`^${today}-${optionSlug}-attempt-(\\d+)\\.md$`);
-  const maxAttempt = existing.reduce((max, entry) => {
-    const match2 = attemptPattern.exec(entry);
-    return match2 ? Math.max(max, Number(match2[1])) : max;
-  }, 0);
-  return `${today}-${optionSlug}-attempt-${maxAttempt + 1}.md`;
-}
-function renderMarkdown(run, finish) {
-  const stepMatch = /^(\d+)-(.+)$/.exec(run.step);
-  const stepLabel = stepMatch ? `${stepMatch[1]} - ${stepMatch[2]}` : run.step;
-  const flowSlug = run.flow.split("/").join("-");
-  return `# Debug Log
-
-- Run ID: ${run.runId}
-- Flow: ${flowSlug}
-- Step: ${stepLabel}
-- Menu option: ${run.menuOption}
-- Date: ${(/* @__PURE__ */ new Date()).toISOString()}
-- CLI version: ${readPackageVersion()}
-- Platform: ${process.platform} / Node ${process.version}
-- Duration on screen: ${finish.durationMs}ms
-- Status: ${finish.status}
-- Exit method: ${finish.exitMethod}
-
-## Inputs
-\`\`\`json
-${JSON.stringify(run.inputs, null, 2)}
-\`\`\`
-
-## Outputs
-\`\`\`json
-${JSON.stringify(finish.outputs, null, 2)}
-\`\`\`
-`;
-}
-function handleCrash() {
-  return finishDebugRun({ outputs: {}, status: "error", exitMethod: "crashed" });
+  const current = controller.current;
+  const state2 = useSyncExternalStore(
+    (listener) => current?.subscribe(listener) ?? (() => void 0),
+    () => current?.getState()
+  );
+  useEffect23(() => {
+    if (!start) controller.current = void 0;
+  }, [start]);
+  return current && state2 ? { controller: current, state: state2 } : void 0;
 }
-var pendingRun, sessionDir;
-var init_debug_store = __esm({
-  "packages/experience-design-system-cli/src/tui/debug-store.ts"() {
+var init_use_flow = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts"() {
     "use strict";
-    init_config();
-    init_version();
-    init_debug_mode_store();
-    init_debug_prune();
-    void Promise.all([isDebugModeEnabled(), readBaseDir()]).then(async ([enabled, base]) => {
-      if (!base) return;
-      const retention = await readDebugModeSetting().catch(() => void 0);
-      const pruned = retention ? await pruneExpiredLogs(base, retention.retentionDays).catch(() => void 0) : void 0;
-      if (!enabled) return;
-      const debugDir = join25(startSession(base, { replace: false }), "debug");
-      await mkdir9(debugDir, { recursive: true });
-      if (retention && pruned && pruned.logs + pruned.folders > 0) {
-        await writeFile8(
-          join25(debugDir, `${datePrefix()}-cleanup-${generateRunId()}.md`),
-          `# Debug Log Cleanup
-
-- Date: ${(/* @__PURE__ */ new Date()).toISOString()}
-- Retention: ${retention.retentionDays} days
-- Logs deleted: ${pruned.logs}
-- Empty folders removed: ${pruned.folders}
-`,
-          { mode: 384 }
-        );
-      }
-    });
-    process.once("uncaughtException", (err) => {
-      void handleCrash().finally(() => {
-        throw err;
-      });
-    });
-    process.once("unhandledRejection", (reason) => {
-      void handleCrash().finally(() => {
-        throw reason;
-      });
-    });
-    process.once("SIGINT", () => {
-      void handleCrash().finally(() => {
-        process.exit(130);
-      });
-    });
+    init_controller();
   }
 });
 
@@ -33086,7 +33369,7 @@ var init_help_info = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/help/PageContainer.tsx
-import { useEffect as useEffect22, useState as useState31 } from "react";
+import { useEffect as useEffect24, 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 }) {
@@ -33100,7 +33383,7 @@ function Section({ title, rows }) {
 }
 function HelpScreen({ onDone }) {
   const [info, setInfo] = useState31();
-  useEffect22(() => {
+  useEffect24(() => {
     startDebugRun({ flow: "help", step: "01-help", menuOption: "Help", inputs: {} });
     void readHelpInfo().then(setInfo);
   }, []);
@@ -33521,7 +33804,7 @@ var init_AgentStatusBadge = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentDetail.tsx
-import { useEffect as useEffect23, useState as useState33 } from "react";
+import { useEffect as useEffect25, 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() {
@@ -33542,7 +33825,7 @@ function AgentDetail({
   const [testing, setTesting] = useState33(false);
   const [notice, setNotice] = useState33(null);
   const [checks, setChecks] = useState33(void 0);
-  useEffect23(() => {
+  useEffect25(() => {
     let active = true;
     setChecks(void 0);
     const timer = setTimeout(() => {
@@ -33634,7 +33917,7 @@ var init_AgentDetail = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentsScreen.tsx
-import { useEffect as useEffect24, useRef as useRef15, useState as useState34 } from "react";
+import { useEffect as useEffect26, useRef as useRef17, 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 }) {
@@ -33645,7 +33928,7 @@ function AgentsScreen({ onDone }) {
   const [saving, setSaving] = useState34(false);
   const [loadError, setLoadError] = useState34(null);
   const [checks, setChecks] = useState34({});
-  const visit = useRef15({
+  const visit = useRef17({
     trail: createTrail(),
     before: void 0,
     environment: void 0,
@@ -33658,7 +33941,7 @@ function AgentsScreen({ onDone }) {
       );
     }
   };
-  useEffect24(() => {
+  useEffect26(() => {
     readAgentConfig().then((loaded) => {
       setConfig(loaded);
       inspectAll(loaded);
@@ -33884,7 +34167,7 @@ var init_project_store = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/project/ProjectScreen.tsx
-import { useEffect as useEffect25, useRef as useRef16, useState as useState35 } from "react";
+import { useEffect as useEffect27, useRef as useRef18, 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) {
@@ -33903,14 +34186,14 @@ function ProjectScreen({ onDone }) {
   const [saving, setSaving] = useState35(false);
   const [notice, setNotice] = useState35(null);
   const [loadError, setLoadError] = useState35(null);
-  const visit = useRef16({
+  const visit = useRef18({
     trail: createTrail(),
     before: void 0,
     persisted: void 0,
     error: ""
   }).current;
   const scrub = (err) => scrubError(err, [config?.cmaToken ?? ""]);
-  useEffect25(() => {
+  useEffect27(() => {
     readCredentials().then((cfg) => {
       setConfig(cfg);
       visit.before = snapshotOf(cfg);
@@ -34097,13 +34380,13 @@ var init_ConfigurationScreen = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { useEffect as useEffect26, useState as useState37 } from "react";
+import { useEffect as useEffect28, 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);
-  useEffect26(() => {
+  useEffect28(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -34166,7 +34449,7 @@ var init_screen12 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect27, useRef as useRef17, useState as useState38 } from "react";
+import { useEffect as useEffect29, useRef as useRef19, 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 }) {
@@ -34176,8 +34459,8 @@ function DebugModeScreen({ onDone }) {
     RETENTION_CHOICES[RETENTION_CHOICES.length - 1]
   );
   const [notice, setNotice] = useState38(null);
-  const visit = useRef17({ trail: createTrail(), before: void 0, error: "" }).current;
-  useEffect27(() => {
+  const visit = useRef19({ trail: createTrail(), before: void 0, error: "" }).current;
+  useEffect29(() => {
     readDebugModeSetting().then((loaded) => {
       setSetting(loaded);
       setPending(loaded.retentionDays);
@@ -34318,7 +34601,7 @@ var app_exports = {};
 __export(app_exports, {
   runApp: () => runApp
 });
-import { useEffect as useEffect28, useState as useState39 } from "react";
+import { useEffect as useEffect30, 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");
@@ -34352,7 +34635,7 @@ function App({ importOptions, inkClear }) {
   const [flowStart, setFlowStart] = useState39();
   const flow = useFlow(flowStart, { beforeStepChange: inkClear });
   const [importDefaults, setImportDefaults] = useState39();
-  useEffect28(() => {
+  useEffect30(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -34425,7 +34708,7 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect28(() => {
+  useEffect30(() => {
     if (!tokensOnlyRun || tokensOnly?.status !== "done" || !tokensOnly.result.ok) return;
     const { credentialsSkipped, input, tokens } = tokensOnlyRun;
     const { tokensPath, tokenSessionId, tokenCount } = tokensOnly.result;
@@ -34447,12 +34730,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   }, [tokensOnly, tokensOnlyRun]);
-  useEffect28(() => {
+  useEffect30(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect28(() => {
+  useEffect30(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -34470,7 +34753,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect28(() => {
+  useEffect30(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -34553,6 +34836,7 @@ function App({ importOptions, inkClear }) {
               return /* @__PURE__ */ jsx66(
                 WelcomeScreen,
                 {
+                  mode: target,
                   onContinue: (projectPath) => answer({ projectPath }),
                   onQuit: () => goBackFrom("project"),
                   initialPath: importDefaults.componentDir